@hlw-uni/mp-vue 2.1.52 → 2.1.54

package/src/index.ts

@@ -3,14 +3,13 @@
  *
  * 2.0 起合并了原 @hlw-uni/mp-core 全部内容。
  * 业务方一处 import，无需再分包：
- *   import { useAd, useMsg, useColor, useThemePageStyle, ... } from "@hlw-uni/mp-vue";
+ *   import { useMsg, useThemePageStyle, ... } from "@hlw-uni/mp-vue";
  *
  * UI 组件（hlw-page / hlw-button / hlw-ad 等）走 easycom 自动注册，不在这里 export。
  */
 
 // Composables / 工具 / Theme
 export * from "./composables";
-export { getErrorMessage } from "./error";
 
 // 类型
 export type { HlwMenuItem } from "./components/hlw-menu/types";
@@ -20,7 +19,7 @@ export type { HlwPagingRef, HlwPagingInstance } from "./components/hlw-paging/ty
 export { useThemeStore } from "./stores/theme";
 
 // App 根上下文
-export { useApp, setupInterceptors } from "./app";
+export { useApp } from "./app";
 
 // hlw 全局命名空间
 export { hlw, type HlwInstance } from "./hlw";

package/dist/composables/_internal/unwrap.d.ts

@@ -1,15 +0,0 @@
-/**
- * Adapter 返回值解包：兼容业务方传「已解包 T」或「ThinkAdmin envelope { code, data }」。
- *
- * 业务方写法：
- *   setConfigAd({ getConfig: getAdConfig })            // 直接传 envelope-returning 函数
- *   setConfigAd({ getConfig: async () => myUnwrapped })  // 也支持已解包
- *
- * 鸭子类型识别：raw 是对象且有 number 类型的 code 字段 → 当 envelope 处理。
- */
-export type AdapterPayload<T> = T | null | {
-    code: number;
-    data?: T;
-    info?: string;
-};
-export declare function unwrapPayload<T>(raw: AdapterPayload<T>): T | null;

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

@@ -1,78 +0,0 @@
-import { AdapterPayload } from '../_internal/unwrap';
-import { ComputedRef, Ref } from 'vue';
-
-/** 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;
-    /** VIP 屏蔽展示型广告（reward 除外）：0=否，1=屏蔽 banner/grid/custom/video/popup */
-    vip_no_ad?: 0 | 1;
-}
-/** 广告错误对象（onError 回调参数） */
-export interface AdError {
-    errCode: number;
-    errMsg: string;
-}
-/**
- * 业务回调注入接口 —— setConfigAd 时由项目提供。
- *
- * getConfig 支持两种返回：
- *   - 已解包：直接返回 AdConfig 或 null
- *   - ThinkAdmin envelope：返回 { code, data } 对象，库自动按 code===1 解包
- *
- * 业务方可以直接传 envelope-returning 的接口函数引用：
- *   setConfigAd({ getConfig: getAdConfig })
- */
-export interface AdAdapter {
-    getConfig: () => Promise<AdapterPayload<AdConfig>>;
-    /** 是否已登录；不传 = 不校验（showReward 调用前会问一次） */
-    isAuth?: () => boolean;
-    /** 是否 VIP；配合 config.vip_no_ad=1 时屏蔽展示型广告（reward 不受影响） */
-    isVip?: () => boolean;
-    /**
-     * 用户级强制屏蔽：返回 true 直接屏蔽展示型广告（reward 不受影响），
-     * 优先级高于 mp.vip_no_ad + isVip 的联合判断；不传 = 不强制。
-     */
-    userNoAd?: () => boolean;
-}
-/** 激励视频关闭回调返回 */
-export interface AdCloseResult {
-    /** 用户是否完整观看 */
-    isEnded: boolean;
-}
-/**
- * 注入业务回调，应用启动时调用一次。
- * 不调用也不会崩，但 loadConfig / showReward 会无效。
- */
-export declare function setConfigAd(a: AdAdapter): void;
-export declare function useAd(): {
-    config: ComputedRef<AdConfig>;
-    loaded: Ref<boolean, boolean>;
-    loadConfig: (force?: boolean) => Promise<void>;
-    getUnitId: (type: AdType) => string;
-    showReward: (onClose?: ((res: AdCloseResult) => void | Promise<void>) | undefined) => Promise<void>;
-    showPopup: (delayMs?: number) => Promise<boolean>;
-    confirm: typeof confirmModal;
-};
-/**
- * 激励视频中途关闭挽留弹窗 —— 通过 useAd().confirm 暴露给业务方：
- *
- *   const { showReward, confirm } = useAd();
- *   showReward(async ({ isEnded }) => {
- *       if (!isEnded) return { ok: false, retry: await confirm() };
- *       const r = await claimAdReward();
- *       return r.code === 1 ? { ok: true, reward: r.data?.reward } : { ok: false, msg: r.info };
- *   });
- *
- * @returns true=用户选「继续观看」 / false=放弃
- */
-declare function confirmModal(): Promise<boolean>;
-/** 销毁全部广告实例并清空缓存（业务一般不用，hot reload 时调） */
-export declare function destroyAds(): void;
-export {};

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

@@ -1,7 +0,0 @@
-/**
- * 算法集：把通用算法包成 useXxx composable，业务侧统一从这里取。
- *
- * 已有：
- *   - useUuid  RFC 4122 v4，32 字符 hex
- */
-export { useUuid } from './uuid';

package/dist/composables/algo/uuid.d.ts

@@ -1,17 +0,0 @@
-/**
- * UUID v4 生成器（RFC 4122 v4 算法），返回 32 字符 hex（无连字符）。
- *
- * 用途：当 nonce、idempotency key、临时唯一标识用。
- *
- * 算法：
- *   1. 生成 16 字节随机源
- *   2. byte 6 高 4 位置成 0100 标版本号 v4
- *   3. byte 8 高 2 位置成 10 标变体（RFC 4122）
- *   4. 16 字节转 hex 拼成 32 字符串
- *
- * 注意：随机源用 Math.random（小程序兼容兜底），加密强度有限，
- * 不能用于密钥派生 / token 签发，只能挡重放。
- */
-export declare function useUuid(): {
-    v4: () => string;
-};

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

@@ -1,8 +0,0 @@
-/**
- * 颜色处理工具。
- */
-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

@@ -1,32 +0,0 @@
-import { AdapterPayload } from '../_internal/unwrap';
-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 注入接口 —— getConfig 支持「已解包」或「ThinkAdmin envelope」两种返回。
- * 业务方可以直接传 envelope-returning 接口：setConfigContact({ getConfig: getContactConfig })
- */
-export interface ContactAdapter {
-    getConfig: () => Promise<AdapterPayload<ContactConfig>>;
-}
-/** v-bind 到 button 的 camelCase props（微信原生属性约定） */
-export interface ContactBindProps {
-    sendMessageTitle: string;
-    sendMessagePath: string;
-    sendMessageImg: string;
-    showMessageCard: boolean;
-}
-/**
- * 注入业务回调（应用启动时调用一次；不调用则 useContact 始终返回空字段）。
- */
-export declare function setConfigContact(a: ContactAdapter): void;
-/**
- * 返回 v-bind 友好的客服配置 computed（首次调用会异步拉一次配置）。
- */
-export declare function useContact(): ComputedRef<ContactBindProps>;

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

@@ -1,9 +0,0 @@
-/**
- * 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/client.d.ts

@@ -1,66 +0,0 @@
-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

@@ -1,8 +0,0 @@
-/**
- * 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/loading/index.d.ts

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

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

@@ -1,18 +0,0 @@
-/**
- * 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;
-};

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

@@ -1,16 +0,0 @@
-/// <reference types="@dcloudio/types" />
-/// <reference types="@dcloudio/types" />
-/**
- * useStorage - 本地存储 composable
- */
-export interface StorageInstance {
-    get: <T = unknown>(key: string) => T | null;
-    set: <T>(key: string, value: T) => boolean;
-    remove: (key: string) => boolean;
-    clear: () => boolean;
-    info: () => UniApp.GetStorageInfoSuccess | null;
-}
-/**
- * 本地存储读写工具。
- */
-export declare function useStorage(): StorageInstance;

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

@@ -1,12 +0,0 @@
-/**
- * useValidate - 校验工具 composable
- */
-export declare function useValidate(): {
-    phone: (value: string) => boolean;
-    email: (value: string) => boolean;
-    url: (value: string) => boolean;
-    idCard: (value: string) => boolean;
-    carNumber: (value: string) => boolean;
-    password: (value: string) => boolean;
-    empty: (value: unknown) => boolean;
-};

package/dist/error.d.ts

@@ -1 +0,0 @@
-export declare function getErrorMessage(error: unknown): string;

package/src/composables/_internal/unwrap.ts

@@ -1,19 +0,0 @@
-/**
- * Adapter 返回值解包：兼容业务方传「已解包 T」或「ThinkAdmin envelope { code, data }」。
- *
- * 业务方写法：
- *   setConfigAd({ getConfig: getAdConfig })            // 直接传 envelope-returning 函数
- *   setConfigAd({ getConfig: async () => myUnwrapped })  // 也支持已解包
- *
- * 鸭子类型识别：raw 是对象且有 number 类型的 code 字段 → 当 envelope 处理。
- */
-export type AdapterPayload<T> = T | null | { code: number; data?: T; info?: string };
-
-export function unwrapPayload<T>(raw: AdapterPayload<T>): T | null {
-    if (raw == null) return null;
-    if (typeof raw === "object" && "code" in raw && typeof (raw as { code: unknown }).code === "number") {
-        const env = raw as { code: number; data?: T };
-        return env.code === 1 && env.data ? env.data : null;
-    }
-    return raw as T;
-}