@hlw-uni/mp-vue 1.2.28 → 2.0.0

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

@@ -0,0 +1,8 @@
+import { Ref } from 'vue';
+/**
+ * 管理动态 ref 集合，适合 v-for 场景。
+ */
+export declare function useRefs(): {
+    refs: Ref<Record<string, any>, Record<string, any>>;
+    setRefs: (key: string) => (el: any) => void;
+};

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

@@ -0,0 +1,67 @@
+export interface ShareAppMessageContent {
+    /** 分享标题 */
+    title?: string;
+    /** 分享路径，必须是以 / 开头的完整路径 */
+    path?: string;
+    /** 自定义图片路径 */
+    imageUrl?: string;
+}
+export interface ShareTimelineContent {
+    /** 朋友圈分享标题 */
+    title?: string;
+    /** 页面携带的 query 参数 */
+    query?: string;
+    /** 自定义图片路径 */
+    imageUrl?: string;
+}
+export interface ShareConfig extends ShareAppMessageContent {
+    /** 朋友圈专属配置，不填则复用朋友分享配置 */
+    timeline?: ShareTimelineContent;
+}
+/**
+ * 分享来源。
+ * - `button` 页面内转发按钮
+ * - `menu` 右上角菜单
+ */
+export type ShareFrom = 'button' | 'menu';
+export type ShareConfigResolver = (from: ShareFrom) => ShareConfig;
+/**
+ * 注册小程序分享钩子。
+ */
+export declare function useShare(config: ShareConfig | ShareConfigResolver): void;
+/** 单页分享配置 */
+export interface PageShareItem {
+    title: string;
+    image: string;
+}
+/** 后端返回的页面 key → 配置映射 */
+export type ShareConfigMap = Record<string, PageShareItem>;
+/** Adapter 注入接口 */
+export interface ShareConfigAdapter {
+    /** 拉取分享配置；返回 null 表示拉失败 */
+    getConfig: () => Promise<ShareConfigMap | null>;
+}
+/** 页面声明的兜底文案 / 跳转路径 */
+export interface PageShareFallback {
+    /** 后端 title 为空时用 */
+    title: string;
+    /** 分享跳转路径（必须 / 开头）；path 不走后端，由页面自定义 */
+    path: string;
+    /** 后端 image 为空时用；通常留空让微信自动截图 */
+    image?: string;
+}
+/** 分享 payload —— 同时喂给 onShareAppMessage / onShareTimeline */
+export interface SharePayload {
+    title: string;
+    path: string;
+    imageUrl?: string;
+}
+/**
+ * 注入业务回调（应用启动时调用一次；不调用则始终用 fallback）。
+ */
+export declare function configShare(a: ShareConfigAdapter): void;
+/**
+ * 业务级分享配置 helper —— 返回 resolver，可直接喂 onShareAppMessage / onShareTimeline。
+ * 后端配置异步加载，加载完成前先用 fallback、加载完后自动切到后端值。
+ */
+export declare function useShareConfig(pageKey: string, fallback: PageShareFallback): () => SharePayload;

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

@@ -0,0 +1,16 @@
+/// <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/theme/font.d.ts

@@ -1,4 +1,4 @@
-export type FontScale = "small" | "normal" | "large" | "xlarge";
+export type FontScale = "small" | "compact" | "normal" | "medium" | "large" | "xlarge" | "xxlarge";
 export interface FontPreset {
     label: string;
     vars: Record<string, string>;

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

@@ -1,4 +1,8 @@
-import { Ref } from 'vue';
+import { ComputedRef } from 'vue';
+/**
+ * @deprecated 历史事件名；现已改用 pinia store 响应式驱动，emit 不再有效。
+ * 保留 export 仅为不破坏外部 import（不影响功能）。
+ */
 export declare const THEME_CHANGE_EVENT = "hlw:theme-change";
 /**
  * 只注入会随主题变化的变量（字号档位、主题色、外观模式）。
@@ -8,8 +12,17 @@ export declare const THEME_CHANGE_EVENT = "hlw:theme-change";
  * 让业务侧可以自由 override，不被运行时注入覆盖。
  */
 export declare function buildThemeStyle(): string;
+/**
+ * 获取主题样式字符串，用于注入 <page-meta :page-style>。
+ *
+ * 实现走 pinia store 响应式：store.scale / primaryColor / appearance 任一变化
+ * → computed 重算 → page-meta 自动 setData。
+ *
+ * 注：早期版本用 uni.$emit + onMounted+uni.$on 事件总线驱动，在 vue3 + 小程序部分
+ * 基础库下 emit 后 ref 不响应（导致字号 / 主题色 / 外观切换不生效）。已改成响应式驱动。
+ */
 export declare function useThemePageStyle(): {
-    themePageStyle: Ref<string, string>;
+    themePageStyle: ComputedRef<string>;
 };
 export type { FontScale, FontPreset } from './font';
 export { FONT_SCALE_KEY, FONT_PRESETS, getCurrentFontScale, getCurrentFontVars } from './font';

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

@@ -0,0 +1,39 @@
+/**
+ * 小程序通用工具。
+ */
+export interface DownloadFileOptions {
+    /** 下载地址 */
+    url: string;
+    /** 文件保存路径，可选 */
+    filePath?: string;
+    /** HTTP 请求头，可选 */
+    header?: Record<string, string>;
+    /** 下载进度回调，可选 */
+    onProgress?: (progress: number, totalBytesWritten: number, totalBytesExpectedToWrite: number) => void;
+}
+export interface DownloadFileResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 临时文件路径 */
+    tempFilePath?: string;
+    /** 状态码 */
+    statusCode?: number;
+    /** 错误信息 */
+    errMsg?: string;
+}
+export type TapEvent = {
+    currentTarget?: {
+        dataset?: Record<string, any>;
+    };
+};
+/**
+ * 剪贴板、下载与相册保存工具集合。
+ */
+export declare function useUtils(): {
+    copy: (data: string, showToast?: boolean) => Promise<boolean>;
+    copyFromEvent: (event: TapEvent) => void;
+    paste: () => Promise<string>;
+    saveImage: (filePath: string) => Promise<boolean>;
+    downloadFile: (options: DownloadFileOptions) => Promise<DownloadFileResult>;
+    downloadAndSaveImage: (url: string, onProgress?: ((progress: number) => void) | undefined) => Promise<boolean>;
+};

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

@@ -0,0 +1,12 @@
+/**
+ * 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/directives/copy.d.ts

@@ -0,0 +1,3 @@
+import { Directive } from 'vue';
+
+export declare const vCopy: Directive;

package/dist/directives/index.d.ts

@@ -0,0 +1 @@
+export { vCopy } from './copy';

package/dist/hlw.d.ts

@@ -0,0 +1,14 @@
+import { useMsg } from './composables/msg';
+import { DeviceInfo } from './composables/device';
+import { http } from './composables/http';
+import { useUtils } from './composables/utils';
+import { useColor } from './composables/color';
+
+export interface HlwInstance {
+    $msg: ReturnType<typeof useMsg>;
+    $device: DeviceInfo;
+    $http: typeof http;
+    $utils: ReturnType<typeof useUtils>;
+    $color: ReturnType<typeof useColor>;
+}
+export declare const hlw: HlwInstance;

package/dist/index.d.ts

@@ -1,13 +1,16 @@
 /**
- * @hlw-uni/mp-vue package root exports
+ * @hlw-uni/mp-vue 统一导出
  *
- * Note:
- * Components are resolved through easycom using `@hlw-uni/mp-vue/src/components/...`.
- * The package root only exports plain TS modules so uni-app does not try to bundle
- * compiled SFC runtime helpers from the library entry.
+ * 2.0 起合并了原 @hlw-uni/mp-core 全部内容。
+ * 业务方一处 import，无需再分包：
+ *   import { useAd, useMsg, useColor, useThemePageStyle, ... } from "@hlw-uni/mp-vue";
+ *
+ * UI 组件（hlw-page / hlw-button / hlw-ad 等）走 easycom 自动注册，不在这里 export。
  */
-export type { FontScale, FontPreset, ThemeColor } from './composables/theme';
+export * from './composables';
 export type { HlwMenuItem } from './components/hlw-menu/types';
 export type { HlwPagingRef, HlwPagingInstance } from './components/hlw-paging/types';
-export { FONT_PRESETS, FONT_SCALE_KEY, DEFAULT_THEMES, THEME_COLOR_KEY, THEME_SEMANTIC_COLORS, THEME_CHANGE_EVENT, getCurrentFontScale, getCurrentFontVars, getCurrentThemeColor, getCurrentThemeVars, buildThemeStyle, useThemePageStyle, } from './composables/theme';
 export { useThemeStore } from './stores/theme';
+export { useApp, setupDefaultInterceptors } from './app';
+export { hlw, type HlwInstance } from './hlw';
+export { vCopy } from './directives';