@hlw-uni-mp/use 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,233 @@
+import { ApiRes } from '@hlw-uni-mp/request';
+import * as pinia from 'pinia';
+import { App, Ref, ComputedRef } from 'vue';
+
+/**
+ * 提示回调函数类型 (confirm 为 true 表示确定，false 为取消)
+ */
+type ToastCallback = (confirm: boolean) => void;
+
+/**
+ * 消息门面体
+ */
+interface HlwMsg {
+    /** 显示轻提示或模态确认框 (支持回调与 Promise) */
+    toast<T = unknown>(opts: UniApp.ShowToastOptions | ApiRes<T> | string, callback?: ToastCallback): Promise<boolean>;
+    /** 成功提示框 */
+    success(msg: string): void;
+    /** 失败提示框 */
+    error(msg: string): void;
+    /** 显全局加载 */
+    showLoading(msg?: string): void;
+    /** 隐全局加载 */
+    hideLoading(): void;
+    /** 弹出确认框 */
+    modal(opts?: UniApp.ShowModalOptions): Promise<boolean>;
+    /** 标题进度条 */
+    setLoadingBar(progress: number): void;
+}
+
+/**
+ * 统一的消息提示与弹窗能力 hook。
+ *
+ * @example
+ * ```ts
+ * const msg = useMsg();
+ * msg.toast('操作成功');
+ * msg.toast(res, (confirm) => {
+ *     if (confirm) console.log('点击确定');
+ *     else console.log('点击取消');
+ * });
+ * const ok = await msg.modal({ content: '确定删除吗？' });
+ * ```
+ */
+declare function useMsg(): HlwMsg;
+
+/**
+ * 外观模式型
+ */
+type ThemeMode = "light" | "dark" | "system";
+
+/**
+ * 字体大小型
+ */
+type FontSize = "small" | "standard" | "large" | "extra-large";
+
+/**
+ * 字体样式型
+ */
+type FontFamily = "system" | "sans" | "serif" | "kaiti";
+
+/**
+ * 主题色彩项
+ */
+interface ThemeColor {
+    name: string;
+    value: string;
+}
+
+/**
+ * 主题状态表
+ */
+interface ThemeState {
+    mode: ThemeMode;
+    color: string;
+    fontSize: FontSize;
+    fontFamily: FontFamily;
+}
+
+/**
+ * 初始配置项
+ */
+interface InitThemeOptions {
+    sync?: boolean;
+    defaultTheme?: Partial<ThemeState>;
+}
+
+/**
+ * 字体大小项
+ */
+interface FontSizePreset {
+    id: string;
+    name: string;
+    class: string;
+}
+
+/**
+ * 字体样式项
+ */
+interface FontFamilyPreset {
+    id: string;
+    name: string;
+    class: string;
+}
+
+/**
+ * 字体大小表
+ */
+declare const fontSizePresets: FontSizePreset[];
+/**
+ * 字体样式表
+ */
+declare const fontFamilyPresets: FontFamilyPreset[];
+/**
+ * 主题状态库
+ */
+declare const useThemeStore: pinia.StoreDefinition<"theme", {
+    mode: string;
+    color: string;
+    fontSize: string;
+    fontFamily: string;
+}, {}, {}>;
+
+/**
+ * 默认主题配置
+ */
+declare const DEFAULT_THEME: ThemeState;
+/**
+ * 预设色彩库
+ */
+declare const THEME_COLORS: ThemeColor[];
+/**
+ * 获取存储配置
+ */
+declare function getTheme(): ThemeState;
+/**
+ * 应用主题状态
+ */
+declare function applyTheme(themeState: Partial<ThemeState>): void;
+/**
+ * 注册主题器
+ */
+declare function initTheme(app: App, options?: InitThemeOptions): void;
+/**
+ * 主题组合钩子
+ */
+declare function useTheme(): {
+    mode: Ref<ThemeMode, ThemeMode>;
+    color: Ref<string, string>;
+    fontSize: Ref<string, string>;
+    fontSizeClass: ComputedRef<string>;
+    fontFamily: Ref<string, string>;
+    fontFamilyClass: ComputedRef<string>;
+    colors: ThemeColor[];
+    fontSizePresets: FontSizePreset[];
+    fontFamilyPresets: FontFamilyPreset[];
+    setMode: (targetMode: ThemeMode) => void;
+    setColor: (hexColor: string) => void;
+    setFontSize: (targetSize: string) => void;
+    setFontFamily: (targetFont: string) => void;
+    resetTheme: () => void;
+    applyTheme: typeof applyTheme;
+    getTheme: typeof getTheme;
+    initTheme: typeof initTheme;
+    store: pinia.Store<"theme", {
+        mode: string;
+        color: string;
+        fontSize: string;
+        fontFamily: string;
+    }, {}, {}>;
+};
+
+/**
+ * 分享卡片配置项
+ */
+interface ShareConfig {
+    /** 分享标题 */
+    title?: string;
+    /** 分享页面路径 */
+    path?: string;
+    /** 分享卡片封面图 */
+    imageUrl?: string;
+}
+
+/**
+ * 分享操作句柄
+ */
+interface ShareHandlers {
+    /** 显式调起分享菜单 */
+    showShareMenu: () => void;
+}
+
+/**
+ * 显式调起分享菜单
+ */
+declare function showShareMenu(): void;
+/**
+ * 分享组合式函数
+ */
+declare function useShare(config?: ShareConfig): ShareHandlers;
+
+/**
+ * useRefs - 模板 Ref 批量管理
+ *
+ * 主要用于在 v-for 循环场景下，动态收集一组子元素或子组件的引用实例。
+ * 规避了 Vue3 在 v-for 中绑定 ref 时需要手动处理数组收集和清理的冗余逻辑。
+ */
+
+interface UseRefsReturn<T = unknown> {
+    /** 存放动态收集到的所有组件或 DOM 实例的 Key-Value 映射对象 */
+    refs: Ref<Record<string, T>>;
+    /** 按 key 生成一个 ref 绑定回调函数 */
+    setRefs: (key: string) => (element: T | null) => void;
+}
+/**
+ * 管理动态 ref 集合的 hook，尤其适合 v-for 列表场景。
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <view v-for="item in list" :key="item.id" :ref="setRefs(item.id)">
+ *     {{ item.name }}
+ *   </view>
+ * </template>
+ *
+ * <script setup>
+ * const { refs, setRefs } = useRefs();
+ * // 访问特定子项的 DOM/实例: refs.value[itemId]
+ * </script>
+ * ```
+ */
+declare function useRefs<T = unknown>(): UseRefsReturn<T>;
+
+export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type HlwMsg, type InitThemeOptions, type ShareConfig, type ShareHandlers, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type ToastCallback, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, initTheme, showShareMenu, useMsg, useRefs, useShare, useTheme, useThemeStore };

package/dist/index.d.ts

@@ -0,0 +1,233 @@
+import { ApiRes } from '@hlw-uni-mp/request';
+import * as pinia from 'pinia';
+import { App, Ref, ComputedRef } from 'vue';
+
+/**
+ * 提示回调函数类型 (confirm 为 true 表示确定，false 为取消)
+ */
+type ToastCallback = (confirm: boolean) => void;
+
+/**
+ * 消息门面体
+ */
+interface HlwMsg {
+    /** 显示轻提示或模态确认框 (支持回调与 Promise) */
+    toast<T = unknown>(opts: UniApp.ShowToastOptions | ApiRes<T> | string, callback?: ToastCallback): Promise<boolean>;
+    /** 成功提示框 */
+    success(msg: string): void;
+    /** 失败提示框 */
+    error(msg: string): void;
+    /** 显全局加载 */
+    showLoading(msg?: string): void;
+    /** 隐全局加载 */
+    hideLoading(): void;
+    /** 弹出确认框 */
+    modal(opts?: UniApp.ShowModalOptions): Promise<boolean>;
+    /** 标题进度条 */
+    setLoadingBar(progress: number): void;
+}
+
+/**
+ * 统一的消息提示与弹窗能力 hook。
+ *
+ * @example
+ * ```ts
+ * const msg = useMsg();
+ * msg.toast('操作成功');
+ * msg.toast(res, (confirm) => {
+ *     if (confirm) console.log('点击确定');
+ *     else console.log('点击取消');
+ * });
+ * const ok = await msg.modal({ content: '确定删除吗？' });
+ * ```
+ */
+declare function useMsg(): HlwMsg;
+
+/**
+ * 外观模式型
+ */
+type ThemeMode = "light" | "dark" | "system";
+
+/**
+ * 字体大小型
+ */
+type FontSize = "small" | "standard" | "large" | "extra-large";
+
+/**
+ * 字体样式型
+ */
+type FontFamily = "system" | "sans" | "serif" | "kaiti";
+
+/**
+ * 主题色彩项
+ */
+interface ThemeColor {
+    name: string;
+    value: string;
+}
+
+/**
+ * 主题状态表
+ */
+interface ThemeState {
+    mode: ThemeMode;
+    color: string;
+    fontSize: FontSize;
+    fontFamily: FontFamily;
+}
+
+/**
+ * 初始配置项
+ */
+interface InitThemeOptions {
+    sync?: boolean;
+    defaultTheme?: Partial<ThemeState>;
+}
+
+/**
+ * 字体大小项
+ */
+interface FontSizePreset {
+    id: string;
+    name: string;
+    class: string;
+}
+
+/**
+ * 字体样式项
+ */
+interface FontFamilyPreset {
+    id: string;
+    name: string;
+    class: string;
+}
+
+/**
+ * 字体大小表
+ */
+declare const fontSizePresets: FontSizePreset[];
+/**
+ * 字体样式表
+ */
+declare const fontFamilyPresets: FontFamilyPreset[];
+/**
+ * 主题状态库
+ */
+declare const useThemeStore: pinia.StoreDefinition<"theme", {
+    mode: string;
+    color: string;
+    fontSize: string;
+    fontFamily: string;
+}, {}, {}>;
+
+/**
+ * 默认主题配置
+ */
+declare const DEFAULT_THEME: ThemeState;
+/**
+ * 预设色彩库
+ */
+declare const THEME_COLORS: ThemeColor[];
+/**
+ * 获取存储配置
+ */
+declare function getTheme(): ThemeState;
+/**
+ * 应用主题状态
+ */
+declare function applyTheme(themeState: Partial<ThemeState>): void;
+/**
+ * 注册主题器
+ */
+declare function initTheme(app: App, options?: InitThemeOptions): void;
+/**
+ * 主题组合钩子
+ */
+declare function useTheme(): {
+    mode: Ref<ThemeMode, ThemeMode>;
+    color: Ref<string, string>;
+    fontSize: Ref<string, string>;
+    fontSizeClass: ComputedRef<string>;
+    fontFamily: Ref<string, string>;
+    fontFamilyClass: ComputedRef<string>;
+    colors: ThemeColor[];
+    fontSizePresets: FontSizePreset[];
+    fontFamilyPresets: FontFamilyPreset[];
+    setMode: (targetMode: ThemeMode) => void;
+    setColor: (hexColor: string) => void;
+    setFontSize: (targetSize: string) => void;
+    setFontFamily: (targetFont: string) => void;
+    resetTheme: () => void;
+    applyTheme: typeof applyTheme;
+    getTheme: typeof getTheme;
+    initTheme: typeof initTheme;
+    store: pinia.Store<"theme", {
+        mode: string;
+        color: string;
+        fontSize: string;
+        fontFamily: string;
+    }, {}, {}>;
+};
+
+/**
+ * 分享卡片配置项
+ */
+interface ShareConfig {
+    /** 分享标题 */
+    title?: string;
+    /** 分享页面路径 */
+    path?: string;
+    /** 分享卡片封面图 */
+    imageUrl?: string;
+}
+
+/**
+ * 分享操作句柄
+ */
+interface ShareHandlers {
+    /** 显式调起分享菜单 */
+    showShareMenu: () => void;
+}
+
+/**
+ * 显式调起分享菜单
+ */
+declare function showShareMenu(): void;
+/**
+ * 分享组合式函数
+ */
+declare function useShare(config?: ShareConfig): ShareHandlers;
+
+/**
+ * useRefs - 模板 Ref 批量管理
+ *
+ * 主要用于在 v-for 循环场景下，动态收集一组子元素或子组件的引用实例。
+ * 规避了 Vue3 在 v-for 中绑定 ref 时需要手动处理数组收集和清理的冗余逻辑。
+ */
+
+interface UseRefsReturn<T = unknown> {
+    /** 存放动态收集到的所有组件或 DOM 实例的 Key-Value 映射对象 */
+    refs: Ref<Record<string, T>>;
+    /** 按 key 生成一个 ref 绑定回调函数 */
+    setRefs: (key: string) => (element: T | null) => void;
+}
+/**
+ * 管理动态 ref 集合的 hook，尤其适合 v-for 列表场景。
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <view v-for="item in list" :key="item.id" :ref="setRefs(item.id)">
+ *     {{ item.name }}
+ *   </view>
+ * </template>
+ *
+ * <script setup>
+ * const { refs, setRefs } = useRefs();
+ * // 访问特定子项的 DOM/实例: refs.value[itemId]
+ * </script>
+ * ```
+ */
+declare function useRefs<T = unknown>(): UseRefsReturn<T>;
+
+export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type HlwMsg, type InitThemeOptions, type ShareConfig, type ShareHandlers, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type ToastCallback, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, initTheme, showShareMenu, useMsg, useRefs, useShare, useTheme, useThemeStore };

package/dist/index.js

@@ -0,0 +1,351 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_THEME: () => DEFAULT_THEME,
+  THEME_COLORS: () => THEME_COLORS,
+  applyTheme: () => applyTheme,
+  fontFamilyPresets: () => fontFamilyPresets,
+  fontSizePresets: () => fontSizePresets,
+  getTheme: () => getTheme,
+  initTheme: () => initTheme,
+  showShareMenu: () => showShareMenu,
+  useMsg: () => useMsg,
+  useRefs: () => useRefs,
+  useShare: () => useShare,
+  useTheme: () => useTheme,
+  useThemeStore: () => useThemeStore
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/msg/index.ts
+function useMsg() {
+  function toast(opts, callback) {
+    let msg = "";
+    let isModal = false;
+    let modalOptions;
+    let toastOptions;
+    if (typeof opts === "string") {
+      msg = opts;
+    } else if ("msg" in opts) {
+      msg = opts.msg || "";
+      isModal = !!opts.modal;
+      modalOptions = opts.modalOptions;
+    } else if ("title" in opts) {
+      msg = opts.title || "";
+      toastOptions = opts;
+    }
+    if (!msg) {
+      callback?.(true);
+      return Promise.resolve(true);
+    }
+    if (isModal) {
+      return modal({
+        ...modalOptions,
+        content: msg
+      }).then((confirm) => {
+        callback?.(confirm);
+        return confirm;
+      });
+    }
+    uni.showToast({
+      title: msg,
+      icon: toastOptions?.icon || "none",
+      image: toastOptions?.image,
+      duration: toastOptions?.duration || 2e3,
+      mask: toastOptions?.mask || false,
+      position: toastOptions?.position || "center"
+    });
+    callback?.(true);
+    return Promise.resolve(true);
+  }
+  function success(msg) {
+    if (!msg) return;
+    uni.showToast({ title: msg, icon: "success", duration: 2e3 });
+  }
+  function error(msg) {
+    if (!msg) return;
+    uni.showToast({ title: msg, icon: "error", duration: 2e3 });
+  }
+  function showLoading(msg = "\u52A0\u8F7D\u4E2D...") {
+    uni.showLoading({ title: msg, mask: true });
+  }
+  function hideLoading() {
+    uni.hideLoading();
+  }
+  function modal(opts = {}) {
+    return new Promise((resolve) => {
+      const {
+        title = "\u63D0\u793A",
+        content,
+        confirmText = "\u786E\u5B9A",
+        cancelText = "\u53D6\u6D88",
+        confirmColor = "#3b82f6",
+        cancelColor = "#999999",
+        showCancel = true
+      } = opts || {};
+      uni.showModal({
+        title,
+        content,
+        confirmText,
+        cancelText,
+        confirmColor,
+        cancelColor,
+        showCancel,
+        success: (res) => resolve(res.confirm),
+        fail: () => resolve(false)
+      });
+    });
+  }
+  function setLoadingBar(progress) {
+    const clamped = Math.max(0, Math.min(100, progress));
+    const filled = Math.round(clamped / 2);
+    uni.setNavigationBarTitle({
+      title: `${"\u25A0".repeat(filled)}${"\u25A1".repeat(50 - filled)} ${clamped}%`
+    });
+  }
+  return {
+    toast,
+    success,
+    error,
+    showLoading,
+    hideLoading,
+    modal,
+    setLoadingBar
+  };
+}
+
+// src/theme/index.ts
+var import_vue = require("vue");
+
+// src/theme/store.ts
+var import_pinia = require("pinia");
+var import_pinia_plugin_storage = require("@hlw-uni-mp/pinia-plugin-storage");
+var fontSizePresets = [
+  {
+    id: "small",
+    name: "\u8F83\u5C0F",
+    class: "font-size-small"
+  },
+  {
+    id: "standard",
+    name: "\u6807\u51C6",
+    class: "font-size-standard"
+  },
+  {
+    id: "large",
+    name: "\u8F83\u5927",
+    class: "font-size-large"
+  },
+  {
+    id: "extra-large",
+    name: "\u8D85\u5927",
+    class: "font-size-extra-large"
+  }
+];
+var fontFamilyPresets = [
+  {
+    id: "system",
+    name: "\u7CFB\u7EDF\u9ED8\u8BA4",
+    class: "font-family-system"
+  },
+  {
+    id: "sans",
+    name: "\u73B0\u4EE3\u9ED1\u4F53",
+    class: "font-family-sans"
+  },
+  {
+    id: "serif",
+    name: "\u7ECF\u5178\u5B8B\u4F53",
+    class: "font-family-serif"
+  },
+  {
+    id: "kaiti",
+    name: "\u4F18\u96C5\u6977\u4F53",
+    class: "font-family-kaiti"
+  }
+];
+var useThemeStore = (0, import_pinia.defineStore)("theme", {
+  state: () => ({
+    mode: "light",
+    color: "#08c060",
+    fontSize: "standard",
+    fontFamily: "system"
+  }),
+  unistorage: true
+});
+
+// src/theme/index.ts
+var DEFAULT_THEME = {
+  mode: "light",
+  color: "#08c060",
+  fontSize: "standard",
+  fontFamily: "system"
+};
+var THEME_COLORS = [
+  { name: "\u9ED8\u8BA4\u7EFF", value: "#08c060" },
+  { name: "\u79D1\u6280\u84DD", value: "#3b82f6" },
+  { name: "\u7FE1\u7FE0\u7EFF", value: "#10b981" },
+  { name: "\u68A6\u5E7B\u7D2B", value: "#8b5cf6" },
+  { name: "\u6D3B\u529B\u6A59", value: "#f97316" },
+  { name: "\u70ED\u60C5\u7EA2", value: "#ef4444" },
+  { name: "\u9752\u84DD", value: "#06b6d4" },
+  { name: "\u7ECF\u5178\u9ED1", value: "#334155" },
+  { name: "\u8537\u8587\u7C89", value: "#ec4899" }
+];
+function getTheme() {
+  const store = useThemeStore();
+  return {
+    mode: store.mode || DEFAULT_THEME.mode,
+    color: store.color || DEFAULT_THEME.color,
+    fontSize: store.fontSize || DEFAULT_THEME.fontSize,
+    fontFamily: store.fontFamily || DEFAULT_THEME.fontFamily
+  };
+}
+function applyTheme(themeState) {
+  const store = useThemeStore();
+  if (themeState.mode) store.mode = themeState.mode;
+  if (themeState.color) store.color = themeState.color;
+  if (themeState.fontSize && ["small", "standard", "large", "extra-large"].includes(themeState.fontSize)) {
+    store.fontSize = themeState.fontSize;
+  }
+  if (themeState.fontFamily && ["system", "sans", "serif", "kaiti"].includes(themeState.fontFamily)) {
+    store.fontFamily = themeState.fontFamily;
+  }
+}
+function initTheme(app, options = {}) {
+  const { sync = true, defaultTheme } = options;
+  app.config.globalProperties.$theme = useTheme();
+  app.provide("theme", useTheme());
+  if (sync) {
+    applyTheme({ ...getTheme(), ...defaultTheme });
+  }
+}
+function useTheme() {
+  const store = useThemeStore();
+  const mode = (0, import_vue.toRef)(store, "mode");
+  const color = (0, import_vue.toRef)(store, "color");
+  const fontSize = (0, import_vue.toRef)(store, "fontSize");
+  const fontFamily = (0, import_vue.toRef)(store, "fontFamily");
+  const fontSizeClass = (0, import_vue.computed)(() => {
+    return fontSizePresets.find((item) => item.id === store.fontSize)?.class || "font-size-standard";
+  });
+  const fontFamilyClass = (0, import_vue.computed)(() => {
+    return fontFamilyPresets.find((item) => item.id === store.fontFamily)?.class || "font-family-system";
+  });
+  function setMode(targetMode) {
+    store.mode = targetMode;
+  }
+  function setColor(hexColor) {
+    store.color = hexColor;
+  }
+  function setFontSize(targetSize) {
+    if (["small", "standard", "large", "extra-large"].includes(targetSize)) {
+      store.fontSize = targetSize;
+    }
+  }
+  function setFontFamily(targetFont) {
+    if (["system", "sans", "serif", "kaiti"].includes(targetFont)) {
+      store.fontFamily = targetFont;
+    }
+  }
+  function resetTheme() {
+    store.mode = DEFAULT_THEME.mode;
+    store.color = DEFAULT_THEME.color;
+    store.fontSize = DEFAULT_THEME.fontSize;
+    store.fontFamily = DEFAULT_THEME.fontFamily;
+  }
+  return {
+    mode,
+    color,
+    fontSize,
+    fontSizeClass,
+    fontFamily,
+    fontFamilyClass,
+    colors: THEME_COLORS,
+    fontSizePresets,
+    fontFamilyPresets,
+    setMode,
+    setColor,
+    setFontSize,
+    setFontFamily,
+    resetTheme,
+    applyTheme,
+    getTheme,
+    initTheme,
+    store
+  };
+}
+
+// src/share/index.ts
+var import_uni_app = require("@dcloudio/uni-app");
+function showShareMenu() {
+  uni.showShareMenu({
+    withShareTicket: true,
+    menus: ["shareAppMessage", "shareTimeline"]
+  });
+}
+function useShare(config = {}) {
+  showShareMenu();
+  (0, import_uni_app.onShareAppMessage)(() => ({ ...config }));
+  (0, import_uni_app.onShareTimeline)(() => {
+    return {
+      title: config.title,
+      query: config.path?.split("?")[1],
+      imageUrl: config.imageUrl
+    };
+  });
+  return {
+    showShareMenu
+  };
+}
+
+// src/refs/index.ts
+var import_vue2 = require("vue");
+function useRefs() {
+  const refs = (0, import_vue2.ref)({});
+  (0, import_vue2.onBeforeUpdate)(() => {
+    refs.value = {};
+  });
+  (0, import_vue2.onUnmounted)(() => {
+    refs.value = {};
+  });
+  const setRefs = (key) => (element) => {
+    if (element) refs.value[key] = element;
+  };
+  return { refs, setRefs };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_THEME,
+  THEME_COLORS,
+  applyTheme,
+  fontFamilyPresets,
+  fontSizePresets,
+  getTheme,
+  initTheme,
+  showShareMenu,
+  useMsg,
+  useRefs,
+  useShare,
+  useTheme,
+  useThemeStore
+});

package/dist/index.mjs

@@ -0,0 +1,312 @@
+// src/msg/index.ts
+function useMsg() {
+  function toast(opts, callback) {
+    let msg = "";
+    let isModal = false;
+    let modalOptions;
+    let toastOptions;
+    if (typeof opts === "string") {
+      msg = opts;
+    } else if ("msg" in opts) {
+      msg = opts.msg || "";
+      isModal = !!opts.modal;
+      modalOptions = opts.modalOptions;
+    } else if ("title" in opts) {
+      msg = opts.title || "";
+      toastOptions = opts;
+    }
+    if (!msg) {
+      callback?.(true);
+      return Promise.resolve(true);
+    }
+    if (isModal) {
+      return modal({
+        ...modalOptions,
+        content: msg
+      }).then((confirm) => {
+        callback?.(confirm);
+        return confirm;
+      });
+    }
+    uni.showToast({
+      title: msg,
+      icon: toastOptions?.icon || "none",
+      image: toastOptions?.image,
+      duration: toastOptions?.duration || 2e3,
+      mask: toastOptions?.mask || false,
+      position: toastOptions?.position || "center"
+    });
+    callback?.(true);
+    return Promise.resolve(true);
+  }
+  function success(msg) {
+    if (!msg) return;
+    uni.showToast({ title: msg, icon: "success", duration: 2e3 });
+  }
+  function error(msg) {
+    if (!msg) return;
+    uni.showToast({ title: msg, icon: "error", duration: 2e3 });
+  }
+  function showLoading(msg = "\u52A0\u8F7D\u4E2D...") {
+    uni.showLoading({ title: msg, mask: true });
+  }
+  function hideLoading() {
+    uni.hideLoading();
+  }
+  function modal(opts = {}) {
+    return new Promise((resolve) => {
+      const {
+        title = "\u63D0\u793A",
+        content,
+        confirmText = "\u786E\u5B9A",
+        cancelText = "\u53D6\u6D88",
+        confirmColor = "#3b82f6",
+        cancelColor = "#999999",
+        showCancel = true
+      } = opts || {};
+      uni.showModal({
+        title,
+        content,
+        confirmText,
+        cancelText,
+        confirmColor,
+        cancelColor,
+        showCancel,
+        success: (res) => resolve(res.confirm),
+        fail: () => resolve(false)
+      });
+    });
+  }
+  function setLoadingBar(progress) {
+    const clamped = Math.max(0, Math.min(100, progress));
+    const filled = Math.round(clamped / 2);
+    uni.setNavigationBarTitle({
+      title: `${"\u25A0".repeat(filled)}${"\u25A1".repeat(50 - filled)} ${clamped}%`
+    });
+  }
+  return {
+    toast,
+    success,
+    error,
+    showLoading,
+    hideLoading,
+    modal,
+    setLoadingBar
+  };
+}
+
+// src/theme/index.ts
+import { computed, toRef } from "vue";
+
+// src/theme/store.ts
+import { defineStore } from "pinia";
+import "@hlw-uni-mp/pinia-plugin-storage";
+var fontSizePresets = [
+  {
+    id: "small",
+    name: "\u8F83\u5C0F",
+    class: "font-size-small"
+  },
+  {
+    id: "standard",
+    name: "\u6807\u51C6",
+    class: "font-size-standard"
+  },
+  {
+    id: "large",
+    name: "\u8F83\u5927",
+    class: "font-size-large"
+  },
+  {
+    id: "extra-large",
+    name: "\u8D85\u5927",
+    class: "font-size-extra-large"
+  }
+];
+var fontFamilyPresets = [
+  {
+    id: "system",
+    name: "\u7CFB\u7EDF\u9ED8\u8BA4",
+    class: "font-family-system"
+  },
+  {
+    id: "sans",
+    name: "\u73B0\u4EE3\u9ED1\u4F53",
+    class: "font-family-sans"
+  },
+  {
+    id: "serif",
+    name: "\u7ECF\u5178\u5B8B\u4F53",
+    class: "font-family-serif"
+  },
+  {
+    id: "kaiti",
+    name: "\u4F18\u96C5\u6977\u4F53",
+    class: "font-family-kaiti"
+  }
+];
+var useThemeStore = defineStore("theme", {
+  state: () => ({
+    mode: "light",
+    color: "#08c060",
+    fontSize: "standard",
+    fontFamily: "system"
+  }),
+  unistorage: true
+});
+
+// src/theme/index.ts
+var DEFAULT_THEME = {
+  mode: "light",
+  color: "#08c060",
+  fontSize: "standard",
+  fontFamily: "system"
+};
+var THEME_COLORS = [
+  { name: "\u9ED8\u8BA4\u7EFF", value: "#08c060" },
+  { name: "\u79D1\u6280\u84DD", value: "#3b82f6" },
+  { name: "\u7FE1\u7FE0\u7EFF", value: "#10b981" },
+  { name: "\u68A6\u5E7B\u7D2B", value: "#8b5cf6" },
+  { name: "\u6D3B\u529B\u6A59", value: "#f97316" },
+  { name: "\u70ED\u60C5\u7EA2", value: "#ef4444" },
+  { name: "\u9752\u84DD", value: "#06b6d4" },
+  { name: "\u7ECF\u5178\u9ED1", value: "#334155" },
+  { name: "\u8537\u8587\u7C89", value: "#ec4899" }
+];
+function getTheme() {
+  const store = useThemeStore();
+  return {
+    mode: store.mode || DEFAULT_THEME.mode,
+    color: store.color || DEFAULT_THEME.color,
+    fontSize: store.fontSize || DEFAULT_THEME.fontSize,
+    fontFamily: store.fontFamily || DEFAULT_THEME.fontFamily
+  };
+}
+function applyTheme(themeState) {
+  const store = useThemeStore();
+  if (themeState.mode) store.mode = themeState.mode;
+  if (themeState.color) store.color = themeState.color;
+  if (themeState.fontSize && ["small", "standard", "large", "extra-large"].includes(themeState.fontSize)) {
+    store.fontSize = themeState.fontSize;
+  }
+  if (themeState.fontFamily && ["system", "sans", "serif", "kaiti"].includes(themeState.fontFamily)) {
+    store.fontFamily = themeState.fontFamily;
+  }
+}
+function initTheme(app, options = {}) {
+  const { sync = true, defaultTheme } = options;
+  app.config.globalProperties.$theme = useTheme();
+  app.provide("theme", useTheme());
+  if (sync) {
+    applyTheme({ ...getTheme(), ...defaultTheme });
+  }
+}
+function useTheme() {
+  const store = useThemeStore();
+  const mode = toRef(store, "mode");
+  const color = toRef(store, "color");
+  const fontSize = toRef(store, "fontSize");
+  const fontFamily = toRef(store, "fontFamily");
+  const fontSizeClass = computed(() => {
+    return fontSizePresets.find((item) => item.id === store.fontSize)?.class || "font-size-standard";
+  });
+  const fontFamilyClass = computed(() => {
+    return fontFamilyPresets.find((item) => item.id === store.fontFamily)?.class || "font-family-system";
+  });
+  function setMode(targetMode) {
+    store.mode = targetMode;
+  }
+  function setColor(hexColor) {
+    store.color = hexColor;
+  }
+  function setFontSize(targetSize) {
+    if (["small", "standard", "large", "extra-large"].includes(targetSize)) {
+      store.fontSize = targetSize;
+    }
+  }
+  function setFontFamily(targetFont) {
+    if (["system", "sans", "serif", "kaiti"].includes(targetFont)) {
+      store.fontFamily = targetFont;
+    }
+  }
+  function resetTheme() {
+    store.mode = DEFAULT_THEME.mode;
+    store.color = DEFAULT_THEME.color;
+    store.fontSize = DEFAULT_THEME.fontSize;
+    store.fontFamily = DEFAULT_THEME.fontFamily;
+  }
+  return {
+    mode,
+    color,
+    fontSize,
+    fontSizeClass,
+    fontFamily,
+    fontFamilyClass,
+    colors: THEME_COLORS,
+    fontSizePresets,
+    fontFamilyPresets,
+    setMode,
+    setColor,
+    setFontSize,
+    setFontFamily,
+    resetTheme,
+    applyTheme,
+    getTheme,
+    initTheme,
+    store
+  };
+}
+
+// src/share/index.ts
+import { onShareAppMessage, onShareTimeline } from "@dcloudio/uni-app";
+function showShareMenu() {
+  uni.showShareMenu({
+    withShareTicket: true,
+    menus: ["shareAppMessage", "shareTimeline"]
+  });
+}
+function useShare(config = {}) {
+  showShareMenu();
+  onShareAppMessage(() => ({ ...config }));
+  onShareTimeline(() => {
+    return {
+      title: config.title,
+      query: config.path?.split("?")[1],
+      imageUrl: config.imageUrl
+    };
+  });
+  return {
+    showShareMenu
+  };
+}
+
+// src/refs/index.ts
+import { ref, onBeforeUpdate, onUnmounted } from "vue";
+function useRefs() {
+  const refs = ref({});
+  onBeforeUpdate(() => {
+    refs.value = {};
+  });
+  onUnmounted(() => {
+    refs.value = {};
+  });
+  const setRefs = (key) => (element) => {
+    if (element) refs.value[key] = element;
+  };
+  return { refs, setRefs };
+}
+export {
+  DEFAULT_THEME,
+  THEME_COLORS,
+  applyTheme,
+  fontFamilyPresets,
+  fontSizePresets,
+  getTheme,
+  initTheme,
+  showShareMenu,
+  useMsg,
+  useRefs,
+  useShare,
+  useTheme,
+  useThemeStore
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@hlw-uni-mp/use",
+  "version": "1.0.0",
+  "description": "Universal Uni-App Vue 3 stateful composables library",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@dcloudio/uni-app": ">=3.0.0",
+    "pinia": ">=2.0.0",
+    "vue": ">=3.4.0"
+  },
+  "peerDependenciesMeta": {
+    "@dcloudio/uni-app": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@hlw-uni-mp/pinia-plugin-storage": "^1.0.1",
+    "@hlw-uni-mp/request": "^1.0.5"
+  },
+  "devDependencies": {
+    "@dcloudio/types": "^3.4.30",
+    "@dcloudio/uni-app": "3.0.0-5000720260410001",
+    "pinia": "^2.3.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vue": "^3.5.34"
+  }
+}