/**
 * 分享卡片配置项。
 */
export interface ShareConfig {
    /** 分享的标题，默认使用小程序名称 */
    title?: string;
    /** 分享的页面路径，支持携带 query 参数，如 '/pages/index/index?id=123' */
    path?: string;
    /** 分享卡片的展示图 URL 或本地路径 */
    imageUrl?: string;
}
/**
 * 支持静态配置或动态解析器函数。
 */
export type ShareConfigResolver = ShareConfig | (() => ShareConfig);
/**
 * 分享操作句柄接口。
 */
export interface ShareHandlers {
    /**
     * 手动触发分享好友设置。
     * @param config 可选的额外覆盖分享配置
     */
    onShareAppMessage: (config?: ShareConfigResolver) => void;
    /**
     * 手动触发分享朋友圈设置。
     * @param config 可选的额外覆盖分享配置
     */
    onShareTimeline: (config?: ShareConfigResolver) => void;
    /**
     * 显示分享菜单项，启用小程序右上角分享。
     */
    showShareMenu: () => void;
}
/**
 * 小程序页面分享 Hook。
 * 自动调用并监听当前页面的 `onShareAppMessage` 与 `onShareTimeline` 原生事件。
 *
 * @param config 默认的分享配置或配置函数
 * @returns 包含手动触发或配置的方法句柄
 *
 * @example
 * ```ts
 * useShare({
 *   title: '欢迎体验我的小程序',
 *   path: '/pages/index/index'
 * });
 * ```
 */
export declare function useShare(config?: ShareConfigResolver): ShareHandlers;