/**
 * useMsg - 消息提示 composable
 * 封装并统一小程序原生的 Toast、Loading 与模态弹窗 API。
 */
/** Toast 支持的图标类型 */
export type ToastIcon = "success" | "loading" | "error" | "none" | "fail" | "exception";
/** Toast 持续时间的预设档位 */
export type ToastDuration = "short" | "long";
/**
 * Toast 轻提示配置项。
 */
export interface ToastOptions {
    /** 提示的消息内容 */
    message: string;
    /** 显示的图标类型，默认为 'none' */
    icon?: ToastIcon;
    /** 自定义图标的本地/网络图片路径（如传入，将忽略 icon 属性） */
    image?: string;
    /** 持续时间，单位毫秒，默认 2000ms */
    duration?: number;
    /** 是否显示透明蒙层防止穿透点击，默认 false */
    mask?: boolean;
    /** 提示框的悬浮位置，仅在某些平台下生效 */
    position?: "top" | "center" | "bottom";
}
/**
 * 模态确认对话框配置项。
 */
export interface ModalOptions {
    /** 弹窗标题，默认 '提示' */
    title?: string;
    /** 弹窗内容 */
    content: string;
    /** 确认按钮的文字，默认 '确定' */
    confirmText?: string;
    /** 取消按钮的文字，默认 '取消' */
    cancelText?: string;
    /** 确认按钮的文字颜色，默认使用主题蓝色 */
    confirmColor?: string;
    /** 取消按钮的文字颜色，默认灰色 */
    cancelColor?: string;
    /** 是否显示取消按钮，若为 false 则只有确认按钮，默认 true */
    showCancel?: boolean;
}
/**
 * useMsg 返回的方法与接口实例。
 */
export interface HlwMsg {
    /** 显示普通 Toast 轻提示，支持配置对象或纯文本 */
    toast(opts: ToastOptions | string): void;
    /** 显示成功提示 (含成功图标) */
    success(message: string): void;
    /** 显示失败提示 (含错误图标) */
    error(message: string): void;
    /** 显示失败提示 (含错误图标) —— error 方法的别名 */
    fail(message: string): void;
    /** 显示全局模态 Loading 状态，默认显示 "加载中..." */
    showLoading(message?: string): void;
    /** 关闭全局 Loading 状态 */
    hideLoading(): void;
    /** 弹出确认模态框，返回 Promise<boolean> 代表用户是否点击了“确认” */
    confirm(opts: ModalOptions): Promise<boolean>;
    /** 弹出确认模态框 —— confirm 方法的别名 */
    modal(opts: ModalOptions): Promise<boolean>;
    /** 利用手机端导航栏标题动态展现一个文本模拟的进度条 */
    setLoadingBar(progress: number): void;
}
/**
 * 统一的消息提示与弹窗能力 hook。
 *
 * @example
 * ```ts
 * const msg = useMsg();
 * msg.toast('操作成功');
 * msg.showLoading('保存中...');
 * const ok = await msg.confirm({ content: '确定删除吗？' });
 * ```
 */
export declare function useMsg(): HlwMsg;