@hlw-uni/mp-vue 1.2.26 → 2.0.0

package/dist/app.d.ts

@@ -0,0 +1,33 @@
+import { App, Component } from 'vue';
+import { HlwInstance } from './hlw';
+import { HttpClient } from './composables/http';
+
+export interface InterceptorOptions {
+    /** API 基础地址 */
+    baseURL?: string;
+    /** 自动注入 Token 的 header 键名 */
+    tokenHeader?: string;
+    /** Token 来源函数 */
+    getToken?: () => string;
+    /** 登录失效时的处理函数 */
+    onUnauthorized?: () => void;
+    /** 接口业务错误码是否自动 toast */
+    autoToastError?: boolean;
+}
+/**
+ * 创建 uni-app 应用入口工具。
+ */
+export declare function useApp(): {
+    install: (AppComponent: Component) => () => {
+        app: App<Element>;
+    };
+    use: (pluginOrInstaller: any) => void;
+    hlw: HlwInstance;
+    http: HttpClient;
+};
+/**
+ * 注册默认请求、响应和错误拦截器。
+ */
+export declare function setupDefaultInterceptors(options?: InterceptorOptions & {
+    sigSecret?: string;
+}): void;

package/dist/composables/ad/index.d.ts

@@ -0,0 +1,134 @@
+import { Ref } from 'vue';
+/**
+ * useAd —— 完整的广告业务封装
+ *
+ * 内置了：
+ *   - 6 个 unit_id 配置（store 缓存，调 getConfig 拉一次）
+ *   - 激励视频：广告加载 loading → onShown 自动关闭 → 中途关闭挽留 modal → 看完调业务方的 claim 发奖
+ *   - 插屏：一行调用
+ *   - 底层 SDK 适配（onLoad / offClose / show 兜底 / 实例缓存）
+ *
+ * 业务侧使用方式：
+ *
+ *   1. 在 App.vue 注入「全局」回调（拿配置 + 校验登录）：
+ *
+ *      import { configAd } from "@hlw-uni/mp-vue";
+ *      import { getAdConfig } from "@/api/ad";
+ *      import { useUserStore } from "@/store";
+ *
+ *      configAd({
+ *          getConfig: async () => {
+ *              const res = await getAdConfig();
+ *              return res.code === 1 && res.data ? res.data : null;
+ *          },
+ *          isAuth: () => !!useUserStore().token,
+ *      });
+ *
+ *   2. 任意页面拉配置 / 用 unit_id 渲染：
+ *
+ *      const { config, loadConfig, showPopup } = useAd();
+ *      await loadConfig();
+ *      <hlw-ad type="banner" :unit-id="config.banner" />
+ *
+ *   3. 看广告领奖励（业务方按场景传不同的 claim 接口）：
+ *
+ *      const ok = await showReward(async () => {
+ *          const res = await claimAdReward();
+ *          return res.code === 1
+ *              ? { ok: true, reward: res.data?.reward }
+ *              : { ok: false, msg: res.info };
+ *      });
+ *
+ *      // 不传 claim 就是纯展示，看完即返回 true
+ *      const ok = await showReward();
+ */
+/** 6 种广告类型 */
+export type AdType = "banner" | "grid" | "custom" | "video" | "reward" | "popup";
+/** 广告配置 —— 字段名跟后端表列名对齐（plugin_qz_mp.{type}_unit_id） */
+export interface AdConfig {
+    banner_unit_id: string;
+    grid_unit_id: string;
+    custom_unit_id: string;
+    video_unit_id: string;
+    reward_unit_id: string;
+    popup_unit_id: string;
+}
+/** 广告错误对象（onError 回调参数） */
+export interface AdError {
+    errCode: number;
+    errMsg: string;
+}
+/** 业务回调注入接口 —— configAd 时由项目提供 */
+export interface AdAdapter {
+    /** 拉取广告配置；返回 null 表示拉失败，store 不更新 */
+    getConfig: () => Promise<AdConfig | null>;
+    /** 是否已登录；不传 = 不校验（showReward 调用前会问一次） */
+    isAuth?: () => boolean;
+}
+/** 激励视频关闭回调返回 */
+export interface AdCloseResult {
+    /** 用户是否完整观看 */
+    isEnded: boolean;
+}
+/** showReward 的 claim 回调返回契约 */
+export interface AdClaimResult {
+    /** 本次结果：true=成功 / false=失败 */
+    ok: boolean;
+    /** 奖励数（用于 toast 显示 +N 积分；无则不 toast） */
+    reward?: number;
+    /** 失败提示语；不传不弹 toast */
+    msg?: string;
+    /** 仅 isEnded=false 时常用：true 让 mp-core 重新 show 一次（业务方挽留确认后用） */
+    retry?: boolean;
+}
+/**
+ * showReward 的 claim 回调签名 —— 业务方按场景实现（领积分、解锁、抽奖等）。
+ * 每次广告关闭后被调用一次（无论是否完整看完），业务方根据 closeRes.isEnded 决定怎么走：
+ *   - isEnded=true  → 调发奖接口 → return { ok: true, reward: N }
+ *   - isEnded=false → 业务自己决定挽留：return { ok: false, retry: true } 让重新 show
+ */
+export type AdClaimFn = (closeRes: AdCloseResult) => Promise<AdClaimResult>;
+/**
+ * 注入业务回调，应用启动时调用一次。
+ * 不调用也不会崩，但 loadConfig / showReward 会无效。
+ */
+export declare function configAd(a: AdAdapter): void;
+export declare function useAd(): {
+    config: Ref<{
+        banner_unit_id: string;
+        grid_unit_id: string;
+        custom_unit_id: string;
+        video_unit_id: string;
+        reward_unit_id: string;
+        popup_unit_id: string;
+    }, AdConfig | {
+        banner_unit_id: string;
+        grid_unit_id: string;
+        custom_unit_id: string;
+        video_unit_id: string;
+        reward_unit_id: string;
+        popup_unit_id: string;
+    }>;
+    loaded: Ref<boolean, boolean>;
+    loadConfig: (force?: boolean) => Promise<void>;
+    getUnitId: (type: AdType) => string;
+    showReward: (claim?: AdClaimFn) => Promise<boolean>;
+    showPopup: () => Promise<boolean>;
+};
+/**
+ * 激励视频中途关闭挽留弹窗 —— 业务方在 claim 回调里也可以复用：
+ *
+ *   showReward(async (closeRes) => {
+ *       if (!closeRes.isEnded) {
+ *           const goon = await confirmReward();
+ *           return { ok: false, retry: goon };
+ *       }
+ *       const r = await claimAdReward();
+ *       return r.code === 1 ? { ok: true, reward: r.data?.reward } : { ok: false, msg: r.info };
+ *   });
+ *
+ * @returns true=用户选「继续观看」 / false=放弃
+ */
+export declare function confirmReward(): Promise<boolean>;
+/** 销毁全部广告实例并清空缓存（业务一般不用，hot reload 时调） */
+export declare function destroyAds(): void;

package/dist/composables/color/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 颜色处理工具。
+ */
+export declare function useColor(): {
+    varsToStyle: (vars: Record<string, string>) => string;
+    hexToRgba: (hex: string, alpha: number) => string;
+    darkenHex: (hex: string, amount?: number) => string;
+};

package/dist/composables/contact/index.d.ts

@@ -0,0 +1,28 @@
+import { ComputedRef } from 'vue';
+/** 后端返回的客服配置（按 button open-type=contact 标准属性命名） */
+export interface ContactConfig {
+    send_message_title: string;
+    send_message_path: string;
+    send_message_img: string;
+    show_message_card: boolean;
+}
+/** Adapter 注入接口 */
+export interface ContactAdapter {
+    /** 拉取客服配置；返回 null 表示拉失败，store 不更新 */
+    getConfig: () => Promise<ContactConfig | null>;
+}
+/** v-bind 到 button 的 camelCase props（微信原生属性约定） */
+export interface ContactBindProps {
+    sendMessageTitle: string;
+    sendMessagePath: string;
+    sendMessageImg: string;
+    showMessageCard: boolean;
+}
+/**
+ * 注入业务回调（应用启动时调用一次；不调用则 useContact 始终返回空字段）。
+ */
+export declare function configContact(a: ContactAdapter): void;
+/**
+ * 返回 v-bind 友好的客服配置 computed（首次调用会异步拉一次配置）。
+ */
+export declare function useContact(): ComputedRef<ContactBindProps>;

package/dist/composables/device/index.d.ts

@@ -0,0 +1,129 @@
+import { Ref } from 'vue';
+export interface DeviceInfo {
+    /** 小程序 appId */
+    appid: string;
+    /** 应用名称 */
+    app_name: string;
+    /** 小程序版本号（版本名称） */
+    app_version: string;
+    /** 小程序版本号（版本号） */
+    app_version_code: string;
+    /** 小程序来源渠道 */
+    app_channel: string;
+    /** 设备品牌。如：apple、huawei */
+    device_brand: string;
+    /** 设备型号 */
+    device_model: string;
+    /** 设备 ID */
+    device_id: string;
+    /** 设备类型：phone/pad/pc */
+    device_type: string;
+    /** 设备方向：portrait/landscape */
+    device_orientation: "portrait" | "landscape";
+    /** 手机品牌。H5 不支持 */
+    brand: string;
+    /** 手机型号 */
+    model: string;
+    /** 操作系统版本 */
+    system: string;
+    /** 操作系统版本（简写） */
+    os: string;
+    /** 设备像素比 */
+    pixel_ratio: number;
+    /** 屏幕宽度 (px) */
+    screen_width: number;
+    /** 屏幕高度 (px) */
+    screen_height: number;
+    /** 可用窗口宽度 (px) */
+    window_width: number;
+    /** 可用窗口高度 (px) */
+    window_height: number;
+    /** 状态栏高度 (px) */
+    status_bar_height: number;
+    /** 微信基础库版本 */
+    sdk_version: string;
+    /** 宿主名称。如：WeChat、alipay */
+    host_name: string;
+    /** 宿主版本。如：微信版本号 */
+    host_version: string;
+    /** 宿主语言 */
+    host_language: string;
+    /** 宿主主题：light/dark */
+    host_theme: string;
+    /** 平台类型 weapp/toutiao/h5 */
+    platform: string;
+    /** 客户端语言 */
+    language: string;
+    /** 客户端版本号 */
+    version: string;
+}
+/**
+ * 获取单例缓存的设备信息。
+ */
+export declare function useDevice(): Ref<{
+    appid: string;
+    app_name: string;
+    app_version: string;
+    app_version_code: string;
+    app_channel: string;
+    device_brand: string;
+    device_model: string;
+    device_id: string;
+    device_type: string;
+    device_orientation: "portrait" | "landscape";
+    brand: string;
+    model: string;
+    system: string;
+    os: string;
+    pixel_ratio: number;
+    screen_width: number;
+    screen_height: number;
+    window_width: number;
+    window_height: number;
+    status_bar_height: number;
+    sdk_version: string;
+    host_name: string;
+    host_version: string;
+    host_language: string;
+    host_theme: string;
+    platform: string;
+    language: string;
+    version: string;
+} | null, DeviceInfo | {
+    appid: string;
+    app_name: string;
+    app_version: string;
+    app_version_code: string;
+    app_channel: string;
+    device_brand: string;
+    device_model: string;
+    device_id: string;
+    device_type: string;
+    device_orientation: "portrait" | "landscape";
+    brand: string;
+    model: string;
+    system: string;
+    os: string;
+    pixel_ratio: number;
+    screen_width: number;
+    screen_height: number;
+    window_width: number;
+    window_height: number;
+    status_bar_height: number;
+    sdk_version: string;
+    host_name: string;
+    host_version: string;
+    host_language: string;
+    host_theme: string;
+    platform: string;
+    language: string;
+    version: string;
+} | null>;
+/**
+ * 把 deviceInfo 对象转成 URL query string（不含前导 ?）
+ */
+export declare function deviceToQuery(): string;
+/**
+ * 手动清除缓存（切换账号等场景可能需要）
+ */
+export declare function clearDeviceCache(): void;

package/dist/composables/format/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * useFormat — 格式化工具 composable
+ */
+export declare function useFormat(): {
+    date: (date: Date | number | string, format?: string) => string;
+    fileSize: (bytes: number) => string;
+    phone: (value: string) => string;
+    money: (amount: number, decimals?: number, decPoint?: string, thousandsSep?: string) => string;
+};

package/dist/composables/http/adapters/alist.d.ts

@@ -0,0 +1,3 @@
+import { UploadAdapter } from './base';
+
+export declare const alistAdapter: UploadAdapter;

package/dist/composables/http/adapters/base.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 云存储上传适配器 - 上传上下文
+ */
+/** 上传上下文。 */
+export interface UploadContext {
+    filePath: string;
+    fileName: string;
+    /** 云存储密钥凭证 */
+    credentials?: Record<string, string>;
+    /** 额外表单数据 */
+    extraData?: Record<string, string>;
+}
+/** 云存储适配器接口。 */
+export interface UploadAdapter {
+    /** 适配器名称 */
+    name: string;
+    /** 根据上下文构建表单数据 */
+    buildFormData(ctx: UploadContext): Record<string, string | number>;
+}

package/dist/composables/http/adapters/cos.d.ts

@@ -0,0 +1,3 @@
+import { UploadAdapter } from './base';
+
+export declare const cosAdapter: UploadAdapter;

package/dist/composables/http/adapters/index.d.ts

@@ -0,0 +1,15 @@
+import { UploadAdapter } from './base';
+/**
+ * 云存储上传适配器统一导出
+ */
+export { cosAdapter } from './cos';
+export { ossAdapter } from './oss';
+export { qiniuAdapter } from './qiniu';
+export { alistAdapter } from './alist';
+export type { UploadAdapter, UploadContext } from './base';
+/** 所有已注册的上传适配器。 */
+export declare const adapters: Record<string, UploadAdapter>;
+/**
+ * 按名称获取上传适配器，不存在时抛错。
+ */
+export declare function getAdapter(name: string): UploadAdapter;

package/dist/composables/http/adapters/oss.d.ts

@@ -0,0 +1,3 @@
+import { UploadAdapter } from './base';
+
+export declare const ossAdapter: UploadAdapter;

package/dist/composables/http/adapters/qiniu.d.ts

@@ -0,0 +1,3 @@
+import { UploadAdapter } from './base';
+
+export declare const qiniuAdapter: UploadAdapter;

package/dist/composables/http/client.d.ts

@@ -0,0 +1,66 @@
+import { ref } from 'vue';
+import { ApiResponse, RequestConfig, RequestInterceptor, ResponseInterceptor, ErrorInterceptor, UploadConfig, UploadResult } from './types';
+
+/** 组件内请求返回的状态对象。 */
+export interface UseRequestReturn<T = unknown> {
+    loading: ReturnType<typeof ref<boolean>>;
+    data: ReturnType<typeof ref<T | null>>;
+    error: ReturnType<typeof ref<Error | null>>;
+    run: (config: RequestConfig) => Promise<ApiResponse<T>>;
+    get: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
+    post: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
+    put: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
+    del: (url: string, data?: unknown) => Promise<ApiResponse<T>>;
+}
+export declare class HttpClient {
+    private _reqInterceptors;
+    private _resInterceptors;
+    private _errInterceptors;
+    private _baseURL;
+    private _defaultHeaders;
+    private _noCache;
+    /**
+     * 创建 HttpClient 实例并初始化默认配置。
+     */
+    constructor(options?: {
+        baseURL?: string;
+        headers?: Record<string, string>;
+        noCache?: boolean;
+    });
+    /** 运行时设置 baseURL。 */
+    setBaseURL(url: string): void;
+    /** 注册请求拦截器，并返回注销函数。 */
+    onRequest(fn: RequestInterceptor): () => void;
+    /** 注册响应拦截器，并返回注销函数。 */
+    onResponse<T = unknown>(fn: ResponseInterceptor<T>): () => void;
+    /** 注册错误拦截器，并返回注销函数。 */
+    onError(fn: ErrorInterceptor): () => void;
+    /**
+     * 执行一次全局请求，自动串联请求与响应拦截器。
+     */
+    request<T = unknown>(config: RequestConfig): Promise<ApiResponse<T>>;
+    /**
+     * 创建组件内可复用的请求状态对象。
+     */
+    useRequest<T = unknown>(): UseRequestReturn<T>;
+    /**
+     * 根据上传类型选择适配器并执行文件上传。
+     */
+    upload(config: UploadConfig): Promise<UploadResult>;
+    /**
+     * 拼接 baseURL，并在开启防缓存时追加时间戳参数。
+     */
+    private _buildUrl;
+    /**
+     * 调用 uni.request 发起底层网络请求。
+     */
+    private _doRequest;
+    /**
+     * 顺序执行已注册的错误拦截器。
+     */
+    private _applyErrorInterceptors;
+}
+/**
+ * 全局 HTTP 实例。
+ */
+export declare const http: HttpClient;

package/dist/composables/http/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HTTP 模块统一导出
+ */
+export { http, HttpClient } from './client';
+export { useRequest, useUpload } from './useRequest';
+export type { ApiResponse, PageResult, RequestConfig, RequestInterceptor, ResponseInterceptor, ErrorInterceptor, UploadConfig, UploadResult } from './types';
+export type { UseRequestReturn } from './client';
+export * from './adapters';

package/dist/composables/http/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * HTTP 类型定义
+ */
+/** API 统一响应格式 */
+export interface ApiResponse<T = unknown> {
+    code: number;
+    data: T;
+    info: string;
+}
+/** 分页数据 */
+export interface PageResult<T = unknown> {
+    list: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+/** 请求配置 */
+export interface RequestConfig {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE";
+    data?: unknown;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/** 拦截器类型 */
+export type RequestInterceptor = (config: RequestConfig) => RequestConfig | Promise<RequestConfig>;
+export type ResponseInterceptor<T = unknown> = (res: ApiResponse<T>) => ApiResponse<T> | void | Promise<ApiResponse<T> | void>;
+export type ErrorInterceptor = (err: Error) => void | Error | Promise<void | Error>;
+/** 上传配置 */
+export interface UploadConfig {
+    /** 上传接口地址 */
+    server: string;
+    /** 文件路径 */
+    filePath: string;
+    /** 文件名，可选，默认取 filePath */
+    fileName?: string;
+    /** 上传类型，支持 cos | oss | qiniu | alist | local */
+    type: string;
+    /** 云存储密钥凭证 */
+    credentials?: Record<string, string>;
+    /** 自定义请求头 */
+    header?: Record<string, string>;
+    /** 上传类型为 local 时，作为最终 server */
+    url?: string;
+}
+/** 上传结果 */
+export interface UploadResult {
+    code: number;
+    msg: string;
+    data: string;
+}

package/dist/composables/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Composables 统一导出
+ */
+export * from './http';
+export { useLoading } from './loading';
+export { useMsg, type HlwMsg, type ToastOptions, type ModalOptions, type ToastIcon } from './msg';
+export { useDevice, deviceToQuery, clearDeviceCache, type DeviceInfo } from './device';
+export { useRefs } from './refs';
+export { usePageMeta } from './page-meta';
+export { useStorage, type StorageInstance } from './storage';
+export { useValidate } from './validate';
+export { useFormat } from './format';
+export { useAd, configAd, destroyAds, confirmReward, type AdType, type AdConfig, type AdError, type AdAdapter, type AdCloseResult, type AdClaimResult, type AdClaimFn, } from './ad';
+export { useShare, useShareConfig, configShare, type ShareConfig, type ShareConfigResolver, type ShareFrom, type ShareAppMessageContent, type ShareTimelineContent, type ShareConfigMap, type ShareConfigAdapter, type PageShareItem, type PageShareFallback, type SharePayload, } from './share';
+export { useContact, configContact, type ContactConfig, type ContactAdapter, type ContactBindProps, } from './contact';
+export { useUtils, type DownloadFileOptions, type DownloadFileResult, type TapEvent } from './utils';
+export { useColor } from './color';
+export { useRouter, type NavigateType, type NavigateOptions } from './navigator';
+export type { FontScale, FontPreset } from './theme';
+export { FONT_SCALE_KEY, FONT_PRESETS, getCurrentFontScale, getCurrentFontVars, THEME_CHANGE_EVENT, buildThemeStyle, useThemePageStyle, } from './theme';
+export type { ThemeColor } from './theme';
+export { THEME_COLOR_KEY, THEME_SEMANTIC_COLORS, DEFAULT_THEMES, getCurrentThemeColor, getCurrentThemeVars, } from './theme';
+export type { Appearance, AppearanceMode, AppearancePreset } from './theme';
+export { APPEARANCE_KEY, APPEARANCE_PRESETS, APPEARANCE_VAR_MAP, getCurrentAppearance, getCurrentAppearanceMode, getCurrentAppearanceVars, resolveAppearance, } from './theme';
+export type { TypographyRole } from './theme';
+export { TYPOGRAPHY_ROLES, getCurrentTypographyVars } from './theme';

package/dist/composables/loading/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * useLoading - 全局 Loading 状态
+ */
+export declare function useLoading(): {
+    showLoading: (message?: string) => void;
+    hideLoading: () => void;
+};

package/dist/composables/msg/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * useMsg - 消息提示 composable
+ */
+export type ToastIcon = "success" | "fail" | "exception" | "none";
+export type ToastDuration = "short" | "long";
+export interface ToastOptions {
+    message: string;
+    icon?: ToastIcon;
+    image?: string;
+    duration?: number;
+    mask?: boolean;
+    position?: "top" | "center" | "bottom";
+}
+export interface ModalOptions {
+    title?: string;
+    content: string;
+    confirmText?: string;
+    cancelText?: string;
+    confirmColor?: string;
+    cancelColor?: string;
+}
+export interface HlwMsg {
+    toast(opts: ToastOptions | string): void;
+    success(message: string): void;
+    error(message: string): void;
+    fail(message: string): void;
+    showLoading(message?: string): void;
+    hideLoading(): void;
+    confirm(opts: ModalOptions): Promise<boolean>;
+    modal(opts: ModalOptions): Promise<boolean>;
+    setLoadingBar(progress: number): void;
+}
+/**
+ * 统一的消息提示与弹窗能力。
+ */
+export declare function useMsg(): HlwMsg;

package/dist/composables/navigator/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 路由/跳转能力 —— 包装 uni-app 各类 jump API 为一个统一对象
+ *
+ * 使用：
+ *   const { navigate } = useRouter();
+ *   navigate(tool.jump_type, tool.jump_value);
+ *
+ * 未装 vue-router 也能用；命名风格对齐 Vue Router，熟悉的 push/replace/back
+ * 会在后续迭代中补齐。
+ */
+/** 已知的跳转类型；保留 `(string & {})` 允许任意自定义值向下兼容 */
+export type NavigateType = "navigateTo" | "redirectTo" | "switchTab" | "reLaunch" | "webview" | "miniprogram" | (string & {});
+export interface NavigateOptions {
+    /** 失败回调，收到 uni 返回的错误信息 */
+    onFail?: (errMsg: string) => void;
+    /** 是否禁用默认的 Toast 错误提示，默认 false */
+    silent?: boolean;
+    /** 仅 miniprogram：目标小程序的页面路径（如 pages/index/index?id=1），留空则打开首页 */
+    path?: string;
+    /** 仅 miniprogram：目标小程序版本，默认 release */
+    envVersion?: "develop" | "trial" | "release";
+    /** 仅 miniprogram：传给目标小程序的额外数据，对方从 onLaunch/onShow 读取 */
+    extraData?: Record<string, unknown>;
+}
+/**
+ * 根据 type + value 调用对应的 uni API，屏蔽参数差异。
+ *
+ * 对应关系：
+ * - `navigateTo`（默认） → uni.navigateTo
+ * - `redirectTo`          → uni.redirectTo
+ * - `switchTab`           → uni.switchTab（value 必须是 tabBar 页）
+ * - `reLaunch`            → uni.reLaunch
+ * - `webview`             → 默认 Toast 提示，上层需接入 web-view 承载页
+ * - `miniprogram`         → uni.navigateToMiniProgram，value 格式 `appid:path`
+ */
+declare function doNavigate(type: NavigateType, value: string, options?: NavigateOptions): void;
+/**
+ * 路由 composable：返回跳转方法集合。
+ *
+ * @example
+ *   const { navigate } = useRouter();
+ *   navigate("switchTab", "/pages/index/index");
+ */
+export declare function useRouter(): {
+    navigate: typeof doNavigate;
+};
+export {};

package/dist/composables/page-meta/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * usePageMeta - 页面元信息 composable
+ */
+export interface PageMeta {
+    title?: string;
+    navigationBarTitleText?: string;
+    navigationBarBackgroundColor?: string;
+    navigationBarTextStyle?: "white" | "black";
+    backgroundColor?: string;
+    enablePullDownRefresh?: boolean;
+}
+/**
+ * 页面导航栏与背景元信息工具。
+ */
+export declare function usePageMeta(): {
+    setTitle: (title: string) => void;
+    setOptions: (options: PageMeta) => void;
+};