@hlw-uni-mp/use 1.0.4 → 1.1.0

package/dist/index.d.mts

@@ -1,10 +1,11 @@
 import * as pinia from 'pinia';
+import { PiniaPluginContext } from 'pinia';
 import { App, Ref, ComputedRef } from 'vue';
 
 /**
  * 具有消息提示属性的响应体对象
  */
-interface ToastResponseLike {
+interface ToastRes {
     /** 提示文案 */
     msg?: string;
     /** 是否为模态弹窗 */
@@ -23,7 +24,7 @@ type ToastCallback = (confirm: boolean) => void;
  */
 interface HlwMsg {
     /** 显示轻提示或模态确认框 (支持回调与 Promise) */
-    toast(opts: UniApp.ShowToastOptions | ToastResponseLike | string, callback?: ToastCallback): Promise<boolean>;
+    toast(opts: UniApp.ShowToastOptions | ToastRes | string, callback?: ToastCallback): Promise<boolean>;
     /** 成功提示框 */
     success(msg: string): void;
     /** 失败提示框 */
@@ -62,6 +63,28 @@ declare const hlw: {
 };
 type HlwInstance = typeof hlw;
 
+/**
+ * 持久化配置项
+ */
+interface PersistOptions {
+    /** 自定义本地存储键名，默认为 store.$id */
+    key?: string;
+    /** 持久化白名单字段列表，默认持久化全部 state */
+    paths?: string[];
+}
+
+declare module "pinia" {
+    interface DefineStoreOptionsBase<S, Store> {
+        /** 本地持久化配置 */
+        unistorage?: boolean | PersistOptions;
+    }
+}
+
+/**
+ * 创建 Pinia 本地持久化存储插件
+ */
+declare function storage(): (context: PiniaPluginContext) => void;
+
 /**
  * 外观模式型
  */
@@ -249,4 +272,4 @@ interface UseRefsReturn<T = unknown> {
  */
 declare function useRefs<T = unknown>(): UseRefsReturn<T>;
 
-export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type HlwInstance, type HlwMsg, type InitThemeOptions, type ShareConfig, type ShareHandlers, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type ToastCallback, type ToastResponseLike, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, hlw, initTheme, showShareMenu, useMsg, useRefs, useShare, useTheme, useThemeStore };
+export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type HlwInstance, type HlwMsg, type InitThemeOptions, type PersistOptions, type ShareConfig, type ShareHandlers, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type ToastCallback, type ToastRes, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, hlw, initTheme, showShareMenu, storage, useMsg, useRefs, useShare, useTheme, useThemeStore };

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 import * as pinia from 'pinia';
+import { PiniaPluginContext } from 'pinia';
 import { App, Ref, ComputedRef } from 'vue';
 
 /**
  * 具有消息提示属性的响应体对象
  */
-interface ToastResponseLike {
+interface ToastRes {
     /** 提示文案 */
     msg?: string;
     /** 是否为模态弹窗 */
@@ -23,7 +24,7 @@ type ToastCallback = (confirm: boolean) => void;
  */
 interface HlwMsg {
     /** 显示轻提示或模态确认框 (支持回调与 Promise) */
-    toast(opts: UniApp.ShowToastOptions | ToastResponseLike | string, callback?: ToastCallback): Promise<boolean>;
+    toast(opts: UniApp.ShowToastOptions | ToastRes | string, callback?: ToastCallback): Promise<boolean>;
     /** 成功提示框 */
     success(msg: string): void;
     /** 失败提示框 */
@@ -62,6 +63,28 @@ declare const hlw: {
 };
 type HlwInstance = typeof hlw;
 
+/**
+ * 持久化配置项
+ */
+interface PersistOptions {
+    /** 自定义本地存储键名，默认为 store.$id */
+    key?: string;
+    /** 持久化白名单字段列表，默认持久化全部 state */
+    paths?: string[];
+}
+
+declare module "pinia" {
+    interface DefineStoreOptionsBase<S, Store> {
+        /** 本地持久化配置 */
+        unistorage?: boolean | PersistOptions;
+    }
+}
+
+/**
+ * 创建 Pinia 本地持久化存储插件
+ */
+declare function storage(): (context: PiniaPluginContext) => void;
+
 /**
  * 外观模式型
  */
@@ -249,4 +272,4 @@ interface UseRefsReturn<T = unknown> {
  */
 declare function useRefs<T = unknown>(): UseRefsReturn<T>;
 
-export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type HlwInstance, type HlwMsg, type InitThemeOptions, type ShareConfig, type ShareHandlers, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type ToastCallback, type ToastResponseLike, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, hlw, initTheme, showShareMenu, useMsg, useRefs, useShare, useTheme, useThemeStore };
+export { DEFAULT_THEME, type FontFamily, type FontFamilyPreset, type FontSize, type FontSizePreset, type HlwInstance, type HlwMsg, type InitThemeOptions, type PersistOptions, type ShareConfig, type ShareHandlers, THEME_COLORS, type ThemeColor, type ThemeMode, type ThemeState, type ToastCallback, type ToastRes, type UseRefsReturn, applyTheme, fontFamilyPresets, fontSizePresets, getTheme, hlw, initTheme, showShareMenu, storage, useMsg, useRefs, useShare, useTheme, useThemeStore };

package/dist/index.js

@@ -29,6 +29,7 @@ __export(index_exports, {
   hlw: () => hlw,
   initTheme: () => initTheme,
   showShareMenu: () => showShareMenu,
+  storage: () => storage,
   useMsg: () => useMsg,
   useRefs: () => useRefs,
   useShare: () => useShare,
@@ -145,8 +146,51 @@ var hlw = {
 var import_vue = require("vue");
 
 // src/theme/store.ts
+var import_pinia2 = require("pinia");
+
+// src/storage/types.d.ts
 var import_pinia = require("pinia");
-var import_pinia_plugin_storage = require("@hlw-uni-mp/pinia-plugin-storage");
+
+// src/storage/index.ts
+function storage() {
+  return (context) => {
+    const { store, options } = context;
+    const config = options.unistorage;
+    if (!config) return;
+    const storageKey = typeof config === "object" && config?.key || store.$id;
+    const paths = typeof config === "object" ? config?.paths : void 0;
+    try {
+      const cached = uni.getStorageSync(storageKey);
+      if (cached) {
+        const data = typeof cached === "string" ? JSON.parse(cached) : cached;
+        if (typeof data === "object" && data !== null) {
+          store.$patch(data);
+        }
+      }
+    } catch (error) {
+      console.error(`[Storage] \u6062\u590D ${store.$id} \u5931\u8D25:`, error);
+    }
+    store.$subscribe(
+      (_, state) => {
+        try {
+          let toSave = state;
+          if (paths && Array.isArray(paths)) {
+            toSave = paths.reduce((acc, key) => {
+              if (key in state) acc[key] = state[key];
+              return acc;
+            }, {});
+          }
+          uni.setStorageSync(storageKey, toSave);
+        } catch (error) {
+          console.error(`[Storage] \u4FDD\u5B58 ${store.$id} \u5931\u8D25:`, error);
+        }
+      },
+      { detached: true }
+    );
+  };
+}
+
+// src/theme/store.ts
 var fontSizePresets = [
   {
     id: "small",
@@ -191,7 +235,7 @@ var fontFamilyPresets = [
     class: "font-family-kaiti"
   }
 ];
-var useThemeStore = (0, import_pinia.defineStore)("theme", {
+var useThemeStore = (0, import_pinia2.defineStore)("theme", {
   state: () => ({
     mode: "light",
     color: "#08c060",
@@ -352,6 +396,7 @@ function useRefs() {
   hlw,
   initTheme,
   showShareMenu,
+  storage,
   useMsg,
   useRefs,
   useShare,

package/dist/index.mjs

@@ -107,7 +107,50 @@ import { computed, toRef } from "vue";
 
 // src/theme/store.ts
 import { defineStore } from "pinia";
-import "@hlw-uni-mp/pinia-plugin-storage";
+
+// src/storage/types.d.ts
+import "pinia";
+
+// src/storage/index.ts
+function storage() {
+  return (context) => {
+    const { store, options } = context;
+    const config = options.unistorage;
+    if (!config) return;
+    const storageKey = typeof config === "object" && config?.key || store.$id;
+    const paths = typeof config === "object" ? config?.paths : void 0;
+    try {
+      const cached = uni.getStorageSync(storageKey);
+      if (cached) {
+        const data = typeof cached === "string" ? JSON.parse(cached) : cached;
+        if (typeof data === "object" && data !== null) {
+          store.$patch(data);
+        }
+      }
+    } catch (error) {
+      console.error(`[Storage] \u6062\u590D ${store.$id} \u5931\u8D25:`, error);
+    }
+    store.$subscribe(
+      (_, state) => {
+        try {
+          let toSave = state;
+          if (paths && Array.isArray(paths)) {
+            toSave = paths.reduce((acc, key) => {
+              if (key in state) acc[key] = state[key];
+              return acc;
+            }, {});
+          }
+          uni.setStorageSync(storageKey, toSave);
+        } catch (error) {
+          console.error(`[Storage] \u4FDD\u5B58 ${store.$id} \u5931\u8D25:`, error);
+        }
+      },
+      { detached: true }
+    );
+  };
+}
+
+// src/theme/store.ts
 var fontSizePresets = [
   {
     id: "small",
@@ -312,6 +355,7 @@ export {
   hlw,
   initTheme,
   showShareMenu,
+  storage,
   useMsg,
   useRefs,
   useShare,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hlw-uni-mp/use",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Universal Uni-App Vue 3 stateful composables library",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -32,9 +32,6 @@
       "optional": true
     }
   },
-  "dependencies": {
-    "@hlw-uni-mp/pinia-plugin-storage": "^1.0.1"
-  },
   "devDependencies": {
     "@dcloudio/types": "^3.4.30",
     "@dcloudio/uni-app": "3.0.0-5000720260410001",