@hlw-uni-mp/use 1.1.7 → 1.1.9

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import * as vue from 'vue';
-import { App, Ref } from 'vue';
 import * as pinia from 'pinia';
+import * as vue from 'vue';
+import { Ref } from 'vue';
 
 declare module "pinia" {
     interface DefineStoreOptionsBase<S, Store> {
@@ -33,13 +33,13 @@ interface InitThemeOptions {
 }
 /** 字体大小预设项 */
 interface FontSizePreset {
-    id: string;
+    id: FontSize;
     name: string;
     class: string;
 }
 /** 字体样式预设项 */
 interface FontFamilyPreset {
-    id: string;
+    id: FontFamily;
     name: string;
     class: string;
 }
@@ -52,13 +52,21 @@ declare const fontSizePresets: FontSizePreset[];
 /** 字体样式预设表 */
 declare const fontFamilyPresets: FontFamilyPreset[];
 /** 主题状态 Store */
-declare const useThemeStore: pinia.StoreDefinition<"theme", ThemeState, {}, {}>;
+declare const useThemeStore: pinia.StoreDefinition<"theme", ThemeState, {}, {
+    setMode(targetMode: ThemeMode): void;
+    setColor(hexColor: string): void;
+    setFontSize(targetSize: string): void;
+    setFontFamily(targetFont: string): void;
+    resetTheme(): void;
+    applyTheme(themeState: Partial<ThemeState>): void;
+}>;
+
 /** 获取存储配置 */
 declare function getTheme(): ThemeState;
 /** 应用主题状态 */
 declare function applyTheme(themeState: Partial<ThemeState>): void;
 /** 初始化主题系统 */
-declare function initTheme(app: App, options?: InitThemeOptions): void;
+declare function initTheme(app: any, options?: InitThemeOptions): void;
 /** 主题组合式函数 */
 declare function useTheme(): {
     mode: vue.Ref<ThemeMode, ThemeMode>;
@@ -78,7 +86,14 @@ declare function useTheme(): {
     applyTheme: typeof applyTheme;
     getTheme: typeof getTheme;
     initTheme: typeof initTheme;
-    store: pinia.Store<"theme", ThemeState, {}, {}>;
+    store: pinia.Store<"theme", ThemeState, {}, {
+        setMode(targetMode: ThemeMode): void;
+        setColor(hexColor: string): void;
+        setFontSize(targetSize: string): void;
+        setFontFamily(targetFont: string): void;
+        resetTheme(): void;
+        applyTheme(themeState: Partial<ThemeState>): void;
+    }>;
 };
 
 /**
@@ -113,4 +128,77 @@ interface UseRefsReturn<T = unknown> {
  */
 declare function useRefs<T = unknown>(): UseRefsReturn<T>;
 
-export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type InitThemeOptions, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, initTheme, useRefs, useTheme, useThemeStore };
+/**
+ * 分享信息配置
+ */
+interface ShareInfo {
+    /** 转发标题 */
+    title?: string;
+    /** 转发页面路径（可带 query 参数） */
+    path?: string;
+    /** 自定义分享封面图 URL 或本地路径 */
+    imageUrl?: string;
+    /** 分享到朋友圈的 query 参数（默认自动从 path 中提取） */
+    query?: string;
+}
+/** 分享配置解析器（支持对象或返回对象的函数） */
+type ShareResolver = ShareInfo | (() => ShareInfo);
+/**
+ * 通用小程序分享 Hook
+ * 自动激活小程序转发与朋友圈菜单，并统一接管分享标题与路径生成
+ *
+ * @param resolver 静态分享配置或动态计算函数
+ * @param onTrigger 触发分享时的动作回调（如打点统计，入参 from 代表触发源：menu 或 button）
+ */
+declare function useShare(resolver?: ShareResolver, onTrigger?: (from: string) => void): {
+    onShareAppMessage: (custom?: ShareInfo) => void;
+    onShareTimeline: (custom?: ShareInfo) => void;
+};
+
+/**
+ * 分页数据接口返回格式
+ */
+type PagingResult<T> = {
+    list: T[];
+    total?: number;
+} | T[];
+/**
+ * 分页请求函数
+ */
+type PagingFetcher<T> = (page: number, limit: number) => Promise<PagingResult<T>>;
+/**
+ * 分页配置选项
+ */
+interface PagingOptions {
+    /** 每页条数（默认 20） */
+    limit?: number;
+    /** 组件挂载时是否立即发起首次请求（默认 true） */
+    immediate?: boolean;
+    /** 是否自动接管页面级下拉刷新与触底加载（默认 true） */
+    autoLifecycle?: boolean;
+}
+/**
+ * 分页返回值接口
+ */
+interface UsePagingReturn<T> {
+    list: Ref<T[]>;
+    page: Ref<number>;
+    limit: Ref<number>;
+    total: Ref<number>;
+    loading: Ref<boolean>;
+    loadingMore: Ref<boolean>;
+    hasMore: Ref<boolean>;
+    refresh: () => Promise<void>;
+    loadMore: () => Promise<void>;
+    reset: () => void;
+}
+/**
+ * 通用分页数据流 Hook
+ * 自动接管分页页码递增、下拉刷新、触底加载与加载状态维护
+ *
+ * @param fetcher 数据请求函数
+ * @param options 配置参数
+ */
+declare function usePaging<T>(fetcher: PagingFetcher<T>, options?: PagingOptions): UsePagingReturn<T>;
+
+export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type InitThemeOptions, type PagingFetcher, type PagingOptions, type PagingResult, type ShareInfo, type ShareResolver, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type UsePagingReturn, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, initTheme, usePaging, useRefs, useShare, useTheme, useThemeStore };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import * as vue from 'vue';
-import { App, Ref } from 'vue';
 import * as pinia from 'pinia';
+import * as vue from 'vue';
+import { Ref } from 'vue';
 
 declare module "pinia" {
     interface DefineStoreOptionsBase<S, Store> {
@@ -33,13 +33,13 @@ interface InitThemeOptions {
 }
 /** 字体大小预设项 */
 interface FontSizePreset {
-    id: string;
+    id: FontSize;
     name: string;
     class: string;
 }
 /** 字体样式预设项 */
 interface FontFamilyPreset {
-    id: string;
+    id: FontFamily;
     name: string;
     class: string;
 }
@@ -52,13 +52,21 @@ declare const fontSizePresets: FontSizePreset[];
 /** 字体样式预设表 */
 declare const fontFamilyPresets: FontFamilyPreset[];
 /** 主题状态 Store */
-declare const useThemeStore: pinia.StoreDefinition<"theme", ThemeState, {}, {}>;
+declare const useThemeStore: pinia.StoreDefinition<"theme", ThemeState, {}, {
+    setMode(targetMode: ThemeMode): void;
+    setColor(hexColor: string): void;
+    setFontSize(targetSize: string): void;
+    setFontFamily(targetFont: string): void;
+    resetTheme(): void;
+    applyTheme(themeState: Partial<ThemeState>): void;
+}>;
+
 /** 获取存储配置 */
 declare function getTheme(): ThemeState;
 /** 应用主题状态 */
 declare function applyTheme(themeState: Partial<ThemeState>): void;
 /** 初始化主题系统 */
-declare function initTheme(app: App, options?: InitThemeOptions): void;
+declare function initTheme(app: any, options?: InitThemeOptions): void;
 /** 主题组合式函数 */
 declare function useTheme(): {
     mode: vue.Ref<ThemeMode, ThemeMode>;
@@ -78,7 +86,14 @@ declare function useTheme(): {
     applyTheme: typeof applyTheme;
     getTheme: typeof getTheme;
     initTheme: typeof initTheme;
-    store: pinia.Store<"theme", ThemeState, {}, {}>;
+    store: pinia.Store<"theme", ThemeState, {}, {
+        setMode(targetMode: ThemeMode): void;
+        setColor(hexColor: string): void;
+        setFontSize(targetSize: string): void;
+        setFontFamily(targetFont: string): void;
+        resetTheme(): void;
+        applyTheme(themeState: Partial<ThemeState>): void;
+    }>;
 };
 
 /**
@@ -113,4 +128,77 @@ interface UseRefsReturn<T = unknown> {
  */
 declare function useRefs<T = unknown>(): UseRefsReturn<T>;
 
-export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type InitThemeOptions, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, initTheme, useRefs, useTheme, useThemeStore };
+/**
+ * 分享信息配置
+ */
+interface ShareInfo {
+    /** 转发标题 */
+    title?: string;
+    /** 转发页面路径（可带 query 参数） */
+    path?: string;
+    /** 自定义分享封面图 URL 或本地路径 */
+    imageUrl?: string;
+    /** 分享到朋友圈的 query 参数（默认自动从 path 中提取） */
+    query?: string;
+}
+/** 分享配置解析器（支持对象或返回对象的函数） */
+type ShareResolver = ShareInfo | (() => ShareInfo);
+/**
+ * 通用小程序分享 Hook
+ * 自动激活小程序转发与朋友圈菜单，并统一接管分享标题与路径生成
+ *
+ * @param resolver 静态分享配置或动态计算函数
+ * @param onTrigger 触发分享时的动作回调（如打点统计，入参 from 代表触发源：menu 或 button）
+ */
+declare function useShare(resolver?: ShareResolver, onTrigger?: (from: string) => void): {
+    onShareAppMessage: (custom?: ShareInfo) => void;
+    onShareTimeline: (custom?: ShareInfo) => void;
+};
+
+/**
+ * 分页数据接口返回格式
+ */
+type PagingResult<T> = {
+    list: T[];
+    total?: number;
+} | T[];
+/**
+ * 分页请求函数
+ */
+type PagingFetcher<T> = (page: number, limit: number) => Promise<PagingResult<T>>;
+/**
+ * 分页配置选项
+ */
+interface PagingOptions {
+    /** 每页条数（默认 20） */
+    limit?: number;
+    /** 组件挂载时是否立即发起首次请求（默认 true） */
+    immediate?: boolean;
+    /** 是否自动接管页面级下拉刷新与触底加载（默认 true） */
+    autoLifecycle?: boolean;
+}
+/**
+ * 分页返回值接口
+ */
+interface UsePagingReturn<T> {
+    list: Ref<T[]>;
+    page: Ref<number>;
+    limit: Ref<number>;
+    total: Ref<number>;
+    loading: Ref<boolean>;
+    loadingMore: Ref<boolean>;
+    hasMore: Ref<boolean>;
+    refresh: () => Promise<void>;
+    loadMore: () => Promise<void>;
+    reset: () => void;
+}
+/**
+ * 通用分页数据流 Hook
+ * 自动接管分页页码递增、下拉刷新、触底加载与加载状态维护
+ *
+ * @param fetcher 数据请求函数
+ * @param options 配置参数
+ */
+declare function usePaging<T>(fetcher: PagingFetcher<T>, options?: PagingOptions): UsePagingReturn<T>;
+
+export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type InitThemeOptions, type PagingFetcher, type PagingOptions, type PagingResult, type ShareInfo, type ShareResolver, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type UsePagingReturn, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, initTheme, usePaging, useRefs, useShare, useTheme, useThemeStore };

package/dist/index.js

@@ -27,7 +27,9 @@ __export(index_exports, {
   fontSizePresets: () => fontSizePresets,
   getTheme: () => getTheme,
   initTheme: () => initTheme,
+  usePaging: () => usePaging,
   useRefs: () => useRefs,
+  useShare: () => useShare,
   useTheme: () => useTheme,
   useThemeStore: () => useThemeStore
 });
@@ -35,6 +37,9 @@ module.exports = __toCommonJS(index_exports);
 
 // src/theme/index.ts
 var import_vue = require("vue");
+var import_pinia2 = require("pinia");
+
+// src/theme/store.ts
 var import_pinia = require("pinia");
 var DEFAULT_THEME = {
   mode: "light",
@@ -72,8 +77,45 @@ var useThemeStore = (0, import_pinia.defineStore)("theme", {
     fontSize: "standard",
     fontFamily: "system"
   }),
+  actions: {
+    setMode(targetMode) {
+      this.mode = targetMode;
+    },
+    setColor(hexColor) {
+      this.color = hexColor;
+    },
+    setFontSize(targetSize) {
+      if (["small", "standard", "large", "extra-large"].includes(targetSize)) {
+        this.fontSize = targetSize;
+      }
+    },
+    setFontFamily(targetFont) {
+      if (["system", "sans", "serif", "kaiti"].includes(targetFont)) {
+        this.fontFamily = targetFont;
+      }
+    },
+    resetTheme() {
+      Object.assign(this, DEFAULT_THEME);
+    },
+    applyTheme(themeState) {
+      if (themeState.mode) {
+        this.mode = themeState.mode;
+      }
+      if (themeState.color) {
+        this.color = themeState.color;
+      }
+      if (themeState.fontSize && ["small", "standard", "large", "extra-large"].includes(themeState.fontSize)) {
+        this.fontSize = themeState.fontSize;
+      }
+      if (themeState.fontFamily && ["system", "sans", "serif", "kaiti"].includes(themeState.fontFamily)) {
+        this.fontFamily = themeState.fontFamily;
+      }
+    }
+  },
   unistorage: true
 });
+
+// src/theme/index.ts
 function getTheme() {
   const store = useThemeStore();
   return {
@@ -85,18 +127,7 @@ function getTheme() {
 }
 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;
-  }
+  store.applyTheme(themeState);
 }
 function initTheme(app, options = {}) {
   const { sync = true, defaultTheme } = options;
@@ -108,32 +139,13 @@ function initTheme(app, options = {}) {
 }
 function useTheme() {
   const store = useThemeStore();
-  const { mode, color, fontSize, fontFamily } = (0, import_pinia.storeToRefs)(store);
+  const { mode, color, fontSize, fontFamily } = (0, import_pinia2.storeToRefs)(store);
   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() {
-    Object.assign(store, DEFAULT_THEME);
-  }
   return {
     mode,
     color,
@@ -144,11 +156,11 @@ function useTheme() {
     colors: THEME_COLORS,
     fontSizePresets,
     fontFamilyPresets,
-    setMode,
-    setColor,
-    setFontSize,
-    setFontFamily,
-    resetTheme,
+    setMode: (targetMode) => store.setMode(targetMode),
+    setColor: (hexColor) => store.setColor(hexColor),
+    setFontSize: (targetSize) => store.setFontSize(targetSize),
+    setFontFamily: (targetFont) => store.setFontFamily(targetFont),
+    resetTheme: () => store.resetTheme(),
     applyTheme,
     getTheme,
     initTheme,
@@ -171,6 +183,144 @@ function useRefs() {
   };
   return { refs, setRefs };
 }
+
+// src/share/index.ts
+var import_uni_app = require("@dcloudio/uni-app");
+function useShare(resolver, onTrigger) {
+  function resolveOptions(custom) {
+    const base = typeof resolver === "function" ? resolver() : resolver || {};
+    return {
+      title: custom?.title || base.title,
+      path: custom?.path || base.path,
+      imageUrl: custom?.imageUrl || base.imageUrl,
+      query: custom?.query || base.query
+    };
+  }
+  function shareApp(custom) {
+    (0, import_uni_app.onShareAppMessage)((res) => {
+      onTrigger?.(String(res?.from || "menu"));
+      const opts = resolveOptions(custom);
+      return {
+        ...opts.title ? { title: opts.title } : {},
+        ...opts.path ? { path: opts.path } : {},
+        ...opts.imageUrl ? { imageUrl: opts.imageUrl } : {}
+      };
+    });
+  }
+  function shareTime(custom) {
+    (0, import_uni_app.onShareTimeline)(() => {
+      const opts = resolveOptions(custom);
+      const queryFromPath = opts.path?.includes("?") ? opts.path.split("?")[1] : void 0;
+      return {
+        ...opts.title ? { title: opts.title } : {},
+        ...opts.imageUrl ? { imageUrl: opts.imageUrl } : {},
+        query: opts.query || queryFromPath
+      };
+    });
+  }
+  if (typeof uni !== "undefined" && typeof uni.showShareMenu === "function") {
+    uni.showShareMenu({
+      withShareTicket: true,
+      menus: ["shareAppMessage", "shareTimeline"]
+    });
+  }
+  return {
+    onShareAppMessage: shareApp,
+    onShareTimeline: shareTime
+  };
+}
+
+// src/paging/index.ts
+var import_vue3 = require("vue");
+var import_uni_app2 = require("@dcloudio/uni-app");
+function usePaging(fetcher, options = {}) {
+  const limitNum = options.limit || 20;
+  const immediate = options.immediate !== false;
+  const autoLifecycle = options.autoLifecycle !== false;
+  const list = (0, import_vue3.ref)([]);
+  const page = (0, import_vue3.ref)(1);
+  const limit = (0, import_vue3.ref)(limitNum);
+  const total = (0, import_vue3.ref)(0);
+  const loading = (0, import_vue3.ref)(false);
+  const loadingMore = (0, import_vue3.ref)(false);
+  const hasMore = (0, import_vue3.ref)(true);
+  async function loadData(isInit = false) {
+    if (isInit) {
+      loading.value = true;
+      page.value = 1;
+      hasMore.value = true;
+    } else {
+      loadingMore.value = true;
+    }
+    try {
+      const res = await fetcher(page.value, limit.value);
+      const items = Array.isArray(res) ? res : res.list || [];
+      const resTotal = !Array.isArray(res) && typeof res.total === "number" ? res.total : 0;
+      if (isInit) {
+        list.value = items;
+      } else {
+        list.value = [...list.value, ...items];
+      }
+      total.value = resTotal || list.value.length;
+      hasMore.value = items.length >= limit.value;
+    } finally {
+      if (isInit) {
+        loading.value = false;
+      } else {
+        loadingMore.value = false;
+      }
+    }
+  }
+  async function refresh() {
+    await loadData(true);
+  }
+  async function loadMore() {
+    if (!hasMore.value || loading.value || loadingMore.value) {
+      return;
+    }
+    page.value += 1;
+    await loadData(false);
+  }
+  function reset() {
+    list.value = [];
+    page.value = 1;
+    total.value = 0;
+    loading.value = false;
+    loadingMore.value = false;
+    hasMore.value = true;
+  }
+  if (autoLifecycle) {
+    (0, import_uni_app2.onPullDownRefresh)(async () => {
+      try {
+        await refresh();
+      } finally {
+        if (typeof uni !== "undefined" && typeof uni.stopPullDownRefresh === "function") {
+          uni.stopPullDownRefresh();
+        }
+      }
+    });
+    (0, import_uni_app2.onReachBottom)(() => {
+      loadMore();
+    });
+  }
+  if (immediate) {
+    (0, import_vue3.onMounted)(() => {
+      loadData(true);
+    });
+  }
+  return {
+    list,
+    page,
+    limit,
+    total,
+    loading,
+    loadingMore,
+    hasMore,
+    refresh,
+    loadMore,
+    reset
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_THEME,
@@ -180,7 +330,9 @@ function useRefs() {
   fontSizePresets,
   getTheme,
   initTheme,
+  usePaging,
   useRefs,
+  useShare,
   useTheme,
   useThemeStore
 });

package/dist/index.mjs

@@ -1,6 +1,9 @@
 // src/theme/index.ts
 import { computed } from "vue";
-import { defineStore, storeToRefs } from "pinia";
+import { storeToRefs } from "pinia";
+
+// src/theme/store.ts
+import { defineStore } from "pinia";
 var DEFAULT_THEME = {
   mode: "light",
   color: "#08c060",
@@ -37,8 +40,45 @@ var useThemeStore = defineStore("theme", {
     fontSize: "standard",
     fontFamily: "system"
   }),
+  actions: {
+    setMode(targetMode) {
+      this.mode = targetMode;
+    },
+    setColor(hexColor) {
+      this.color = hexColor;
+    },
+    setFontSize(targetSize) {
+      if (["small", "standard", "large", "extra-large"].includes(targetSize)) {
+        this.fontSize = targetSize;
+      }
+    },
+    setFontFamily(targetFont) {
+      if (["system", "sans", "serif", "kaiti"].includes(targetFont)) {
+        this.fontFamily = targetFont;
+      }
+    },
+    resetTheme() {
+      Object.assign(this, DEFAULT_THEME);
+    },
+    applyTheme(themeState) {
+      if (themeState.mode) {
+        this.mode = themeState.mode;
+      }
+      if (themeState.color) {
+        this.color = themeState.color;
+      }
+      if (themeState.fontSize && ["small", "standard", "large", "extra-large"].includes(themeState.fontSize)) {
+        this.fontSize = themeState.fontSize;
+      }
+      if (themeState.fontFamily && ["system", "sans", "serif", "kaiti"].includes(themeState.fontFamily)) {
+        this.fontFamily = themeState.fontFamily;
+      }
+    }
+  },
   unistorage: true
 });
+
+// src/theme/index.ts
 function getTheme() {
   const store = useThemeStore();
   return {
@@ -50,18 +90,7 @@ function getTheme() {
 }
 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;
-  }
+  store.applyTheme(themeState);
 }
 function initTheme(app, options = {}) {
   const { sync = true, defaultTheme } = options;
@@ -80,25 +109,6 @@ function useTheme() {
   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() {
-    Object.assign(store, DEFAULT_THEME);
-  }
   return {
     mode,
     color,
@@ -109,11 +119,11 @@ function useTheme() {
     colors: THEME_COLORS,
     fontSizePresets,
     fontFamilyPresets,
-    setMode,
-    setColor,
-    setFontSize,
-    setFontFamily,
-    resetTheme,
+    setMode: (targetMode) => store.setMode(targetMode),
+    setColor: (hexColor) => store.setColor(hexColor),
+    setFontSize: (targetSize) => store.setFontSize(targetSize),
+    setFontFamily: (targetFont) => store.setFontFamily(targetFont),
+    resetTheme: () => store.resetTheme(),
     applyTheme,
     getTheme,
     initTheme,
@@ -136,6 +146,144 @@ function useRefs() {
   };
   return { refs, setRefs };
 }
+
+// src/share/index.ts
+import { onShareAppMessage, onShareTimeline } from "@dcloudio/uni-app";
+function useShare(resolver, onTrigger) {
+  function resolveOptions(custom) {
+    const base = typeof resolver === "function" ? resolver() : resolver || {};
+    return {
+      title: custom?.title || base.title,
+      path: custom?.path || base.path,
+      imageUrl: custom?.imageUrl || base.imageUrl,
+      query: custom?.query || base.query
+    };
+  }
+  function shareApp(custom) {
+    onShareAppMessage((res) => {
+      onTrigger?.(String(res?.from || "menu"));
+      const opts = resolveOptions(custom);
+      return {
+        ...opts.title ? { title: opts.title } : {},
+        ...opts.path ? { path: opts.path } : {},
+        ...opts.imageUrl ? { imageUrl: opts.imageUrl } : {}
+      };
+    });
+  }
+  function shareTime(custom) {
+    onShareTimeline(() => {
+      const opts = resolveOptions(custom);
+      const queryFromPath = opts.path?.includes("?") ? opts.path.split("?")[1] : void 0;
+      return {
+        ...opts.title ? { title: opts.title } : {},
+        ...opts.imageUrl ? { imageUrl: opts.imageUrl } : {},
+        query: opts.query || queryFromPath
+      };
+    });
+  }
+  if (typeof uni !== "undefined" && typeof uni.showShareMenu === "function") {
+    uni.showShareMenu({
+      withShareTicket: true,
+      menus: ["shareAppMessage", "shareTimeline"]
+    });
+  }
+  return {
+    onShareAppMessage: shareApp,
+    onShareTimeline: shareTime
+  };
+}
+
+// src/paging/index.ts
+import { ref as ref2, onMounted } from "vue";
+import { onPullDownRefresh, onReachBottom } from "@dcloudio/uni-app";
+function usePaging(fetcher, options = {}) {
+  const limitNum = options.limit || 20;
+  const immediate = options.immediate !== false;
+  const autoLifecycle = options.autoLifecycle !== false;
+  const list = ref2([]);
+  const page = ref2(1);
+  const limit = ref2(limitNum);
+  const total = ref2(0);
+  const loading = ref2(false);
+  const loadingMore = ref2(false);
+  const hasMore = ref2(true);
+  async function loadData(isInit = false) {
+    if (isInit) {
+      loading.value = true;
+      page.value = 1;
+      hasMore.value = true;
+    } else {
+      loadingMore.value = true;
+    }
+    try {
+      const res = await fetcher(page.value, limit.value);
+      const items = Array.isArray(res) ? res : res.list || [];
+      const resTotal = !Array.isArray(res) && typeof res.total === "number" ? res.total : 0;
+      if (isInit) {
+        list.value = items;
+      } else {
+        list.value = [...list.value, ...items];
+      }
+      total.value = resTotal || list.value.length;
+      hasMore.value = items.length >= limit.value;
+    } finally {
+      if (isInit) {
+        loading.value = false;
+      } else {
+        loadingMore.value = false;
+      }
+    }
+  }
+  async function refresh() {
+    await loadData(true);
+  }
+  async function loadMore() {
+    if (!hasMore.value || loading.value || loadingMore.value) {
+      return;
+    }
+    page.value += 1;
+    await loadData(false);
+  }
+  function reset() {
+    list.value = [];
+    page.value = 1;
+    total.value = 0;
+    loading.value = false;
+    loadingMore.value = false;
+    hasMore.value = true;
+  }
+  if (autoLifecycle) {
+    onPullDownRefresh(async () => {
+      try {
+        await refresh();
+      } finally {
+        if (typeof uni !== "undefined" && typeof uni.stopPullDownRefresh === "function") {
+          uni.stopPullDownRefresh();
+        }
+      }
+    });
+    onReachBottom(() => {
+      loadMore();
+    });
+  }
+  if (immediate) {
+    onMounted(() => {
+      loadData(true);
+    });
+  }
+  return {
+    list,
+    page,
+    limit,
+    total,
+    loading,
+    loadingMore,
+    hasMore,
+    refresh,
+    loadMore,
+    reset
+  };
+}
 export {
   DEFAULT_THEME,
   THEME_COLORS,
@@ -144,7 +292,9 @@ export {
   fontSizePresets,
   getTheme,
   initTheme,
+  usePaging,
   useRefs,
+  useShare,
   useTheme,
   useThemeStore
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hlw-uni-mp/use",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "Universal Uni-App Vue 3 stateful composables library",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -15,10 +15,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -39,5 +35,9 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vue": "^3.5.34"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
   }
-}
+}