@composy/store-vue 0.0.1

package/lib/plugins/engine-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-plugin.cjs","names":[],"sources":["../../src/plugins/engine-plugin.ts"],"sourcesContent":["/* ============================================================\n * engine-plugin.ts\n * Store Engine 插件（Vue 适配层）\n * 将 core 层的 createStoreEngineBridge 包装为 Vue 友好的插件接口\n * 负责创建 bridge、管理运行时生命周期、连接 Vue App\n * ============================================================ */\n\n/* 从 core/engine 导入 bridge 相关类型 */\nimport type {\n  StoreEngineBridge,                    /* 引擎桥接实例接口 */\n  StoreEngineLike,                      /* 引擎抽象接口 */\n  StoreEnginePluginContextLike,         /* 插件上下文接口 */\n} from '@composy/store-core/engine'\n/* Vue App 类型 */\nimport type { App } from 'vue'\n/* 本地 store 运行时类型 */\nimport type { StoreRuntime } from '../runtime/store-runtime'\n/* 全局 Store API 和插件选项类型 */\nimport type { GlobalStoreAPI, StoreEnginePluginOptions } from '../types'\n/* 从 core/engine 导入 bridge 创建函数 */\nimport { createStoreEngineBridge } from '@composy/store-core/engine'\n/* 导入 Vue App 运行时安装相关函数 */\nimport { getInstalledStoreRuntime, installStoreRuntime } from '../runtime/install-store-app'\n/* 导入运行时创建函数和全局 API 获取函数 */\nimport { createStoreRuntime, getGlobalStoreAPI as getActiveStoreAPI } from '../runtime/store-runtime'\n\n/**\n * Store Engine 插件接口\n * 定义了插件的元信息和生命周期方法\n * @property dependencies - 依赖的其他插件名称列表\n * @property name - 插件名称\n * @property version - 插件版本\n * @property install - 安装到引擎上下文（异步）\n * @property installVue - 安装到 Vue App\n * @property uninstall - 从引擎上下文卸载（异步）\n */\nexport interface StoreEnginePlugin {\n  dependencies: string[]\n  name: string\n  version: string\n  install: (context: StoreEnginePluginContextLike) => Promise<void>\n  installVue: (app: App) => void\n  uninstall: (context?: StoreEnginePluginContextLike) => Promise<void>\n}\n\n/**\n * 类型守卫：判断值是否为 Vue App 实例\n * 通过检查是否有 use 方法来识别\n */\nfunction isVueApp(value: unknown): value is App {\n  return !!value && typeof (value as App).use === 'function'\n}\n\n/**\n * 从各种可能的来源解析 Vue App 实例\n * 按优先级尝试：payload.app → payload.framework.app → engine.getApp() → context.framework.app\n *\n * @param engine - Store 引擎实例\n * @param context - 插件上下文\n * @param payload - 安装时传入的额外数据\n * @returns 解析到的 Vue App 或 undefined\n */\nfunction resolveVueApp(\n  engine: StoreEngineLike,\n  context: StoreEnginePluginContextLike,\n  payload?: unknown,\n): App | undefined {\n  /* 将 payload 宽松转为可能包含 app 字段的对象 */\n  const appPayload = payload as { app?: unknown; framework?: { app?: unknown } } | undefined\n  /* 按优先级尝试多个来源获取 app */\n  const app = appPayload?.app\n    ?? appPayload?.framework?.app\n    ?? engine.getApp?.()\n    ?? context.framework?.app\n\n  /* 使用类型守卫验证是否为 Vue App */\n  return isVueApp(app) ? app : undefined\n}\n\n/**\n * 获取当前活跃的全局 Store API\n * @returns 全局 Store API 或 null（未初始化时）\n */\nexport function getGlobalStoreAPI(): GlobalStoreAPI | null {\n  return getActiveStoreAPI()\n}\n\n/**\n * 创建 Store Engine 插件工厂函数\n * 这是 Vue 适配层的核心入口，将 core 层的 bridge 包装为 Vue 友好的插件\n *\n * @param options - 插件配置选项\n * @returns StoreEnginePlugin 插件实例\n */\nexport function createStoreEnginePlugin(options: StoreEnginePluginOptions = {}): StoreEnginePlugin {\n  /* 解构配置选项，设置默认值 */\n  const {\n    debug = false,         /* 是否开启调试日志 */\n    dependencies = [],     /* 依赖的插件列表 */\n    name = 'store',        /* 插件名称 */\n    version = '1.0.0',     /* 插件版本 */\n  } = options\n\n  /* 延迟创建的 bridge 实例引用 */\n  let bridge: StoreEngineBridge | null = null\n\n  /**\n   * 创建 bridge 的工厂函数\n   * 内部调用 core 层的 createStoreEngineBridge，并传入 Vue 特定的实现\n   */\n  const createBridge = (): StoreEngineBridge => {\n    const activeBridge = createStoreEngineBridge<StoreRuntime>({\n      name,        /* 插件名称 */\n      version,     /* 插件版本 */\n      debug,       /* 调试模式 */\n\n      /* 创建运行时：传入所有 Vue 相关配置 */\n      createRuntime: () => createStoreRuntime({\n        pinia: options.pinia,             /* 可选的外部 Pinia 实例 */\n        persist: options.persist,         /* 是否启用持久化 */\n        persistOptions: options.persistOptions, /* 持久化选项 */\n        globalProperties: options.globalProperties, /* 是否挂载到全局属性 */\n        provide: options.provide,         /* 是否通过 provide 注入 */\n        debug,\n      }),\n\n      /* 将运行时安装到 Vue App */\n      attachToApp: (app, runtime) => installStoreRuntime(app as App, runtime),\n\n      /* 从 Vue App 获取已安装的运行时 */\n      getRuntimeFromApp: app => getInstalledStoreRuntime(app as App),\n\n      /* Vue App 类型守卫 */\n      isApp: isVueApp,\n\n      /* Vue App 解析函数 */\n      resolveApp: resolveVueApp,\n    })\n\n    bridge = activeBridge\n    return activeBridge\n  }\n\n  /**\n   * 获取 bridge 实例（懒创建）\n   * 首次调用时自动创建\n   */\n  const getBridge = (): StoreEngineBridge => {\n    return bridge ?? createBridge()\n  }\n\n  /* ── 返回插件对象 ── */\n  return {\n    name,          /* 插件名称 */\n    version,       /* 插件版本 */\n    dependencies,  /* 插件依赖 */\n\n    /**\n     * 安装到引擎上下文（异步）\n     * 通过 bridge 将 store 能力注册到引擎\n     */\n    async install(context: StoreEnginePluginContextLike): Promise<void> {\n      await getBridge().install(context)\n    },\n\n    /**\n     * 安装到 Vue App\n     * 将 store 运行时连接到 Vue 应用实例\n     */\n    installVue(app: App): void {\n      getBridge().attachToApp(app)\n    },\n\n    /**\n     * 从引擎上下文卸载（异步）\n     * 清理 bridge 引用\n     */\n    async uninstall(context?: StoreEnginePluginContextLike): Promise<void> {\n      await getBridge().uninstall(context)\n      bridge = null /* 释放 bridge 引用，允许垃圾回收 */\n    },\n  }\n}\n\n/* 默认导出工厂函数 */\nexport default createStoreEnginePlugin\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiDA,SAAS,SAAS,OAA8B;CAC9C,OAAO,CAAC,CAAC,SAAS,OAAQ,MAAc,QAAQ;AAClD;AAWA,SAAS,cACP,QACA,SACA,SACiB;CAEjB,MAAM,aAAa;CAEnB,MAAM,MAAM,YAAY,OACnB,YAAY,WAAW,OACvB,OAAO,SAAS,KAChB,QAAQ,WAAW;CAGxB,OAAO,SAAS,GAAG,IAAI,MAAM,KAAA;AAC/B;AAMO,SAAS,oBAA2C;CACzD,OAAO,sBAAA,kBAAkB;AAC3B;AASO,SAAS,wBAAwB,UAAoC,CAAC,GAAsB;CAEjG,MAAM,EACJ,QAAQ,OACR,eAAe,CAAC,GAChB,OAAO,SACP,UAAU,YACR;CAGJ,IAAI,SAAmC;CAMvC,MAAM,qBAAwC;EAC5C,MAAM,gBAAA,GAAA,2BAAA,wBAAA,CAAqD;GACzD;GACA;GACA;GAGA,qBAAqB,sBAAA,mBAAmB;IACtC,OAAO,QAAQ;IACf,SAAS,QAAQ;IACjB,gBAAgB,QAAQ;IACxB,kBAAkB,QAAQ;IAC1B,SAAS,QAAQ;IACjB;GACF,CAAC;GAGD,cAAc,KAAK,YAAY,0BAAA,oBAAoB,KAAY,OAAO;GAGtE,oBAAmB,QAAO,0BAAA,yBAAyB,GAAU;GAG7D,OAAO;GAGP,YAAY;EACd,CAAC;EAED,SAAS;EACT,OAAO;CACT;CAMA,MAAM,kBAAqC;EACzC,OAAO,UAAU,aAAa;CAChC;CAGA,OAAO;EACL;EACA;EACA;;;;;EAMA,MAAM,QAAQ,SAAsD;GAClE,MAAM,UAAU,CAAA,CAAE,QAAQ,OAAO;EACnC;;;;;EAMA,WAAW,KAAgB;GACzB,UAAU,CAAA,CAAE,YAAY,GAAG;EAC7B;;;;;EAMA,MAAM,UAAU,SAAuD;GACrE,MAAM,UAAU,CAAA,CAAE,UAAU,OAAO;GACnC,SAAS;EACX;CACF;AACF"}

package/lib/plugins/engine-plugin.d.ts

@@ -0,0 +1,36 @@
+import type { /* 引擎抽象接口 */ StoreEnginePluginContextLike } from '@composy/store-core/engine';
+import type { App } from 'vue';
+import type { GlobalStoreAPI, StoreEnginePluginOptions } from '../types';
+/**
+ * Store Engine 插件接口
+ * 定义了插件的元信息和生命周期方法
+ * @property dependencies - 依赖的其他插件名称列表
+ * @property name - 插件名称
+ * @property version - 插件版本
+ * @property install - 安装到引擎上下文（异步）
+ * @property installVue - 安装到 Vue App
+ * @property uninstall - 从引擎上下文卸载（异步）
+ */
+export interface StoreEnginePlugin {
+    dependencies: string[];
+    name: string;
+    version: string;
+    install: (context: StoreEnginePluginContextLike) => Promise<void>;
+    installVue: (app: App) => void;
+    uninstall: (context?: StoreEnginePluginContextLike) => Promise<void>;
+}
+/**
+ * 获取当前活跃的全局 Store API
+ * @returns 全局 Store API 或 null（未初始化时）
+ */
+export declare function getGlobalStoreAPI(): GlobalStoreAPI | null;
+/**
+ * 创建 Store Engine 插件工厂函数
+ * 这是 Vue 适配层的核心入口，将 core 层的 bridge 包装为 Vue 友好的插件
+ *
+ * @param options - 插件配置选项
+ * @returns StoreEnginePlugin 插件实例
+ */
+export declare function createStoreEnginePlugin(options?: StoreEnginePluginOptions): StoreEnginePlugin;
+export default createStoreEnginePlugin;
+//# sourceMappingURL=engine-plugin.d.ts.map

package/lib/plugins/enhanced-persist-plugin.cjs

@@ -0,0 +1,15 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_pinia_plugin = require("./pinia-plugin.cjs");
+exports.cleanupEnhancedPersist = require_pinia_plugin.cleanupEnhancedPersist;
+exports.createEnhancedPersistPlugin = require_pinia_plugin.createEnhancedPersistPlugin;
+/*! End of @composy/store-vue | Powered by @composy/builder */

package/lib/plugins/enhanced-persist-plugin.d.ts

@@ -0,0 +1,3 @@
+export { cleanupEnhancedPersist, createEnhancedPersistPlugin, } from './pinia-plugin';
+export type { EnhancedPersistOptions, EnhancedPersistPluginOptions, } from './pinia-plugin';
+//# sourceMappingURL=enhanced-persist-plugin.d.ts.map

package/lib/plugins/index.cjs

@@ -0,0 +1,28 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_pinia_plugin = require("./pinia-plugin.cjs");
+const require_store_registry = require("../runtime/store-registry.cjs");
+const require_engine_plugin = require("./engine-plugin.cjs");
+const require_vue_plugin = require("./vue-plugin.cjs");
+exports.cleanupEnhancedPersist = require_pinia_plugin.cleanupEnhancedPersist;
+exports.createEnhancedPersistPlugin = require_pinia_plugin.createEnhancedPersistPlugin;
+exports.createPersistPlugin = require_pinia_plugin.createPersistPlugin;
+exports.createPersistPluginController = require_pinia_plugin.createPersistPluginController;
+exports.createRegistryMethods = require_store_registry.createRegistryMethods;
+exports.createStoreEnginePlugin = require_engine_plugin.createStoreEnginePlugin;
+exports.createStoreRegistry = require_store_registry.createStoreRegistry;
+exports.createStoreRegistryPlugin = require_store_registry.createStoreRegistryPlugin;
+exports.createStoreVuePlugin = require_vue_plugin.createStoreVuePlugin;
+exports.getGlobalStoreAPI = require_engine_plugin.getGlobalStoreAPI;
+exports.getStoreRegistry = require_store_registry.getStoreRegistry;
+exports.setGlobalStoreRegistry = require_store_registry.setGlobalStoreRegistry;
+/*! End of @composy/store-vue | Powered by @composy/builder */

package/lib/plugins/index.d.ts

@@ -0,0 +1,7 @@
+export { createStoreEnginePlugin, getGlobalStoreAPI, } from './engine-plugin';
+export { cleanupEnhancedPersist, createEnhancedPersistPlugin, createPersistPlugin, createPersistPluginController, } from './pinia-plugin';
+export type { EnhancedPersistOptions, EnhancedPersistPluginOptions, PersistPluginOptions, } from './pinia-plugin';
+export { createRegistryMethods, createStoreRegistry, createStoreRegistryPlugin, getStoreRegistry, setGlobalStoreRegistry, } from './registry-plugin';
+export { createStoreVuePlugin, } from './vue-plugin';
+export type { StoreVuePluginOptions } from './vue-plugin';
+//# sourceMappingURL=index.d.ts.map

package/lib/plugins/pinia-plugin.cjs

@@ -0,0 +1,177 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _composy_store_core = require("@composy/store-core");
+//#region src/plugins/pinia-plugin.ts
+const STORE_PERSIST_DISPOSE_KEY = /* @__PURE__ */ Symbol("ldesign-store-persist-dispose");
+const activePersistControllers = /* @__PURE__ */ new Set();
+function getStorage(type) {
+	if (typeof window === "undefined") return null;
+	return type === "localStorage" ? window.localStorage : window.sessionStorage;
+}
+function normalizePersistConfig(value) {
+	if (!value) return null;
+	return typeof value === "boolean" ? {} : value;
+}
+function filterState(state, includePaths, excludePaths) {
+	if (includePaths?.length) {
+		const pickedState = {};
+		includePaths.forEach((path) => {
+			const value = (0, _composy_store_core.getByPath)(state, path);
+			if (value !== void 0) (0, _composy_store_core.setByPath)(pickedState, path, (0, _composy_store_core.deepClone)(value));
+		});
+		return pickedState;
+	}
+	if (excludePaths?.length) {
+		const nextState = (0, _composy_store_core.deepClone)(state);
+		excludePaths.forEach((path) => {
+			(0, _composy_store_core.deleteByPath)(nextState, path);
+		});
+		return nextState;
+	}
+	return (0, _composy_store_core.deepClone)(state);
+}
+function restoreStoreState(store, nextState) {
+	store.$patch((state) => {
+		(0, _composy_store_core.deepMerge)(state, nextState);
+	});
+}
+function patchPersistDispose(store, cleanup) {
+	const restorePatchedDispose = store[STORE_PERSIST_DISPOSE_KEY];
+	if (restorePatchedDispose) restorePatchedDispose();
+	const originalDispose = store.$dispose;
+	store.$dispose = function patchedDispose() {
+		cleanup();
+		return originalDispose.call(this);
+	};
+	store[STORE_PERSIST_DISPOSE_KEY] = () => {
+		store.$dispose = originalDispose;
+		delete store[STORE_PERSIST_DISPOSE_KEY];
+	};
+}
+function createPersistPluginController(options = {}) {
+	const { storage: defaultStorage = "localStorage", keyPrefix = "ldesign-store:", debounce: debounceDelay = 100, debug = false, syncTabs: defaultSyncTabs = false, defaultTTL } = options;
+	const cleanupMap = /* @__PURE__ */ new Map();
+	const dispose = () => {
+		cleanupMap.forEach((cleanup) => cleanup());
+		cleanupMap.clear();
+		activePersistControllers.delete(dispose);
+	};
+	activePersistControllers.add(dispose);
+	const plugin = (context) => {
+		const { store, options: storeOptions } = context;
+		const config = normalizePersistConfig(storeOptions.persist);
+		if (!config) return;
+		const storage = getStorage(config.storage === "sessionStorage" ? "sessionStorage" : defaultStorage);
+		const serializer = config.serializer?.serialize ?? JSON.stringify;
+		const deserialize = config.serializer?.deserialize ?? JSON.parse;
+		const syncTabs = config.syncTabs ?? defaultSyncTabs;
+		const ttl = config.ttl ?? defaultTTL;
+		const key = `${keyPrefix}${config.key || store.$id}`;
+		if (!storage) {
+			if (debug) console.warn(`[PersistPlugin] Storage \u4E0D\u53EF\u7528 (${store.$id})`);
+			return;
+		}
+		let isRestoring = false;
+		const applyPersistedValue = (rawState) => {
+			const nextState = deserialize(rawState);
+			isRestoring = true;
+			try {
+				config.beforeRestore?.({ store });
+				restoreStoreState(store, nextState);
+				config.afterRestore?.({ store });
+			} finally {
+				isRestoring = false;
+			}
+		};
+		const restoreState = () => {
+			try {
+				const stored = storage.getItem(key);
+				if (!stored) return;
+				const storageItem = JSON.parse(stored);
+				if (storageItem.expiresAt && Date.now() > storageItem.expiresAt) {
+					storage.removeItem(key);
+					return;
+				}
+				applyPersistedValue(storageItem.state);
+				if (debug) console.info(`[PersistPlugin] \u5DF2\u6062\u590D\u72B6\u6001 (${store.$id})`);
+			} catch (error) {
+				console.error(`[PersistPlugin] \u6062\u590D\u72B6\u6001\u5931\u8D25 (${store.$id}):`, error);
+			}
+		};
+		const persistState = () => {
+			if (isRestoring) return;
+			try {
+				const filteredState = filterState(store.$state, config.paths, config.excludePaths);
+				const payload = {
+					state: serializer(filteredState),
+					timestamp: Date.now(),
+					expiresAt: ttl ? Date.now() + ttl : void 0,
+					version: 1
+				};
+				storage.setItem(key, JSON.stringify(payload));
+				if (debug) console.info(`[PersistPlugin] \u5DF2\u4FDD\u5B58\u72B6\u6001 (${store.$id})`);
+			} catch (error) {
+				console.error(`[PersistPlugin] \u4FDD\u5B58\u72B6\u6001\u5931\u8D25 (${store.$id}):`, error);
+			}
+		};
+		const saveState = (0, _composy_store_core.debounce)(persistState, config.debounce ?? debounceDelay);
+		const stopSubscribe = store.$subscribe(() => {
+			if (!isRestoring) saveState();
+		});
+		let stopStorageSync = () => {};
+		if (syncTabs && typeof window !== "undefined") {
+			const handleStorage = (event) => {
+				if (event.key !== key || !event.newValue) return;
+				try {
+					const storageItem = JSON.parse(event.newValue);
+					if (storageItem.expiresAt && Date.now() > storageItem.expiresAt) return;
+					applyPersistedValue(storageItem.state);
+				} catch (error) {
+					console.error(`[PersistPlugin] \u540C\u6B65\u72B6\u6001\u5931\u8D25 (${store.$id}):`, error);
+				}
+			};
+			window.addEventListener("storage", handleStorage);
+			stopStorageSync = () => {
+				window.removeEventListener("storage", handleStorage);
+			};
+		}
+		const cleanup = () => {
+			saveState.cancel();
+			stopSubscribe();
+			stopStorageSync();
+			cleanupMap.delete(key);
+		};
+		cleanupMap.set(key, cleanup);
+		patchPersistDispose(store, cleanup);
+		restoreState();
+	};
+	return {
+		plugin,
+		dispose
+	};
+}
+function createPersistPlugin(options = {}) {
+	return createPersistPluginController(options).plugin;
+}
+function createEnhancedPersistPlugin(options = {}) {
+	return createPersistPluginController(options).plugin;
+}
+function cleanupEnhancedPersist() {
+	Array.from(activePersistControllers).forEach((dispose) => dispose());
+}
+//#endregion
+exports.cleanupEnhancedPersist = cleanupEnhancedPersist;
+exports.createEnhancedPersistPlugin = createEnhancedPersistPlugin;
+exports.createPersistPlugin = createPersistPlugin;
+exports.createPersistPluginController = createPersistPluginController;
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=pinia-plugin.cjs.map

package/lib/plugins/pinia-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinia-plugin.cjs","names":[],"sources":["../../src/plugins/pinia-plugin.ts"],"sourcesContent":["/* ============================================================\n * pinia-plugin.ts\n * Pinia 持久化插件\n * 提供将 Pinia Store 状态自动持久化到浏览器存储的能力\n * 支持 TTL 过期、跨标签页同步、include/exclude 路径过滤、\n * 防抖保存、$dispose 生命周期钩子等特性\n * ============================================================ */\n\n/* 从 Pinia 导入插件相关类型 */\nimport type { PiniaPlugin, PiniaPluginContext, StoreGeneric } from 'pinia'\n/* 从本地类型文件导入持久化选项 */\nimport type { PersistOptions } from '../types'\n/* 从 store-core 导入工具函数 */\nimport { debounce, deepClone, deepMerge, deleteByPath, getByPath, setByPath } from '@composy/store-core'\n\n/* 用于标记 store 的 $dispose 是否已被 patch 的 Symbol 键 */\nconst STORE_PERSIST_DISPOSE_KEY = Symbol('ldesign-store-persist-dispose')\n\n/* 浏览器存储类型 */\ntype BrowserStorage = 'localStorage' | 'sessionStorage'\n\n/* 可被 patch $dispose 的 Store 扩展类型 */\ntype DisposableStore = StoreGeneric & {\n  [STORE_PERSIST_DISPOSE_KEY]?: () => void /* 恢复原始 $dispose 的函数 */\n}\n\n/**\n * 持久化存储项的内部格式接口\n * 包含序列化的状态、时间戳、过期时间和版本号\n */\ninterface PersistedStorageItem {\n  state: string    /* 序列化后的状态字符串 */\n  timestamp: number /* 保存时间戳 */\n  expiresAt?: number /* 过期时间戳（可选） */\n  version: number   /* 数据格式版本号 */\n}\n\n/**\n * 持久化插件控制器接口\n * @property plugin - Pinia 插件函数\n * @property dispose - 清理函数，用于移除所有持久化订阅\n */\ninterface PersistPluginController {\n  plugin: PiniaPlugin\n  dispose: () => void\n}\n\n/**\n * 持久化插件全局配置选项\n * @property storage - 默认存储类型\n * @property keyPrefix - 存储键名前缀\n * @property debounce - 防抖延迟（毫秒）\n * @property debug - 是否开启调试日志\n * @property syncTabs - 是否默认启用跨标签页同步\n * @property defaultTTL - 默认过期时间（毫秒）\n */\nexport interface PersistPluginOptions {\n  storage?: BrowserStorage\n  keyPrefix?: string\n  debounce?: number\n  debug?: boolean\n  syncTabs?: boolean\n  defaultTTL?: number\n}\n\n/* 增强版持久化插件选项（与基础版相同，预留扩展） */\nexport interface EnhancedPersistPluginOptions extends PersistPluginOptions {}\n\n/**\n * 增强版持久化选项（Store 级别配置）\n * 在基础 PersistOptions 上增加 excludePaths、syncTabs、ttl\n */\nexport interface EnhancedPersistOptions extends PersistOptions {\n  syncTabs?: boolean\n  ttl?: number\n  excludePaths?: string[]\n}\n\n/* 活跃的持久化控制器集合，用于全局清理 */\nconst activePersistControllers = new Set<() => void>()\n\n/**\n * 获取浏览器存储对象\n * 在 SSR 环境下返回 null\n */\nfunction getStorage(type: BrowserStorage): Storage | null {\n  if (typeof window === 'undefined') {\n    return null\n  }\n\n  return type === 'localStorage' ? window.localStorage : window.sessionStorage\n}\n\n/**\n * 规范化 Store 的 persist 配置\n * 将 boolean/对象/undefined 统一为 EnhancedPersistOptions | null\n */\nfunction normalizePersistConfig(\n  value: boolean | PersistOptions | EnhancedPersistOptions | undefined,\n): EnhancedPersistOptions | null {\n  if (!value) {\n    return null /* 未配置持久化 */\n  }\n\n  /* boolean true 表示使用默认配置的空对象 */\n  return typeof value === 'boolean' ? {} : value\n}\n\n/**\n * 根据 include/exclude 路径过滤状态\n * 优先使用 includePaths（白名单），其次使用 excludePaths（黑名单）\n *\n * @param state - 完整状态对象\n * @param includePaths - 包含路径列表（白名单模式）\n * @param excludePaths - 排除路径列表（黑名单模式）\n * @returns 过滤后的状态对象\n */\nfunction filterState(\n  state: Record<string, unknown>,\n  includePaths?: string[],\n  excludePaths?: string[],\n): Record<string, unknown> {\n  /* 白名单模式：只保留指定路径 */\n  if (includePaths?.length) {\n    const pickedState: Record<string, unknown> = {}\n    includePaths.forEach((path) => {\n      const value = getByPath(state, path)\n      if (value !== undefined) {\n        setByPath(pickedState, path, deepClone(value))\n      }\n    })\n    return pickedState\n  }\n\n  /* 黑名单模式：排除指定路径 */\n  if (excludePaths?.length) {\n    const nextState = deepClone(state)\n    excludePaths.forEach((path) => {\n      deleteByPath(nextState, path)\n    })\n    return nextState\n  }\n\n  /* 无过滤：返回状态的深拷贝 */\n  return deepClone(state)\n}\n\n/**\n * 将持久化的状态恢复到 Store\n * 使用 $patch + deepMerge 避免覆盖整个 state 引用\n */\nfunction restoreStoreState(\n  store: StoreGeneric,\n  nextState: Record<string, unknown>,\n): void {\n  store.$patch((state) => {\n    deepMerge(state as Record<string, unknown>, nextState)\n  })\n}\n\n/**\n * 为 Store 的 $dispose 方法打补丁\n * 在 Store 被销毁时自动执行清理逻辑（取消订阅、移除事件监听等）\n *\n * @param store - 目标 Store\n * @param cleanup - 清理回调函数\n */\nfunction patchPersistDispose(store: DisposableStore, cleanup: () => void): void {\n  /* 如果之前已有补丁，先恢复原始方法 */\n  const restorePatchedDispose = store[STORE_PERSIST_DISPOSE_KEY]\n  if (restorePatchedDispose) {\n    restorePatchedDispose()\n  }\n\n  /* 保存原始 $dispose 方法 */\n  const originalDispose = store.$dispose\n  /* 替换为带清理逻辑的版本 */\n  store.$dispose = function patchedDispose() {\n    cleanup() /* 先执行清理 */\n    return originalDispose.call(this) /* 再调用原始 dispose */\n  }\n\n  /* 保存恢复函数，供后续补丁使用 */\n  store[STORE_PERSIST_DISPOSE_KEY] = () => {\n    store.$dispose = originalDispose\n    delete store[STORE_PERSIST_DISPOSE_KEY]\n  }\n}\n\n/**\n * 创建持久化插件控制器\n * 返回一个 Pinia 插件函数和对应的 dispose 清理函数\n *\n * @param options - 插件全局配置\n * @returns 控制器对象（包含 plugin 和 dispose）\n */\nexport function createPersistPluginController(\n  options: PersistPluginOptions = {},\n): PersistPluginController {\n  /* 解构配置选项，设置默认值 */\n  const {\n    storage: defaultStorage = 'localStorage', /* 默认存储类型 */\n    keyPrefix = 'ldesign-store:',              /* 存储键前缀 */\n    debounce: debounceDelay = 100,             /* 默认 100ms 防抖 */\n    debug = false,                             /* 调试模式 */\n    syncTabs: defaultSyncTabs = false,         /* 默认不跨标签页同步 */\n    defaultTTL,                                /* 默认 TTL */\n  } = options\n\n  /* 清理函数映射表（key → cleanup） */\n  const cleanupMap = new Map<string, () => void>()\n\n  /**\n   * 全局 dispose 函数\n   * 清理所有 Store 的持久化订阅\n   */\n  const dispose = (): void => {\n    cleanupMap.forEach(cleanup => cleanup())\n    cleanupMap.clear()\n    activePersistControllers.delete(dispose)\n  }\n\n  /* 注册到活跃控制器集合 */\n  activePersistControllers.add(dispose)\n\n  /**\n   * Pinia 插件函数\n   * 每当创建/使用一个 Pinia Store 时自动调用\n   */\n  const plugin: PiniaPlugin = (context: PiniaPluginContext): void => {\n    const { store, options: storeOptions } = context\n    /* 规范化该 Store 的持久化配置 */\n    const config = normalizePersistConfig(\n      (storeOptions as { persist?: boolean | PersistOptions | EnhancedPersistOptions }).persist,\n    )\n\n    /* 该 Store 未配置持久化则跳过 */\n    if (!config) {\n      return\n    }\n\n    /* 解析该 Store 的存储配置（Store 级别配置优先于全局配置） */\n    const storageType = config.storage === 'sessionStorage' ? 'sessionStorage' : defaultStorage\n    const storage = getStorage(storageType)\n    const serializer = config.serializer?.serialize ?? JSON.stringify    /* 序列化函数 */\n    const deserialize = config.serializer?.deserialize ?? JSON.parse     /* 反序列化函数 */\n    const syncTabs = config.syncTabs ?? defaultSyncTabs                 /* 跨标签页同步 */\n    const ttl = config.ttl ?? defaultTTL                                /* 过期时间 */\n    const key = `${keyPrefix}${config.key || store.$id}`                /* 存储键名 */\n\n    /* 存储不可用则跳过 */\n    if (!storage) {\n      if (debug) {\n        console.warn(`[PersistPlugin] Storage 不可用 (${store.$id})`)\n      }\n      return\n    }\n\n    /* 标记：是否正在从存储恢复状态（防止恢复过程中触发保存） */\n    let isRestoring = false\n\n    /**\n     * 将持久化的原始状态字符串应用到 Store\n     * 反序列化 → beforeRestore 钩子 → 恢复状态 → afterRestore 钩子\n     */\n    const applyPersistedValue = (rawState: string): void => {\n      const nextState = deserialize(rawState) as Record<string, unknown>\n      isRestoring = true /* 标记恢复中 */\n      try {\n        config.beforeRestore?.({ store })                  /* 恢复前钩子 */\n        restoreStoreState(store, nextState)                 /* 恢复状态 */\n        config.afterRestore?.({ store })                    /* 恢复后钩子 */\n      }\n      finally {\n        isRestoring = false /* 恢复结束 */\n      }\n    }\n\n    /**\n     * 从存储恢复 Store 状态\n     * 检查过期 → 反序列化 → 应用到 Store\n     */\n    const restoreState = (): void => {\n      try {\n        const stored = storage.getItem(key)\n        if (!stored) {\n          return /* 无持久化数据 */\n        }\n\n        const storageItem = JSON.parse(stored) as PersistedStorageItem\n        /* 检查是否过期 */\n        if (storageItem.expiresAt && Date.now() > storageItem.expiresAt) {\n          storage.removeItem(key) /* 过期则清除 */\n          return\n        }\n\n        /* 应用持久化值 */\n        applyPersistedValue(storageItem.state)\n\n        if (debug) {\n          console.info(`[PersistPlugin] 已恢复状态 (${store.$id})`)\n        }\n      }\n      catch (error) {\n        console.error(`[PersistPlugin] 恢复状态失败 (${store.$id}):`, error)\n      }\n    }\n\n    /**\n     * 将当前 Store 状态持久化到存储\n     * 过滤状态 → 序列化 → 包装为存储项 → 写入存储\n     */\n    const persistState = (): void => {\n      /* 正在恢复时跳过保存，避免循环 */\n      if (isRestoring) {\n        return\n      }\n\n      try {\n        /* 根据 include/exclude 路径过滤状态 */\n        const filteredState = filterState(\n          store.$state as Record<string, unknown>,\n          config.paths,\n          config.excludePaths,\n        )\n\n        /* 构建存储项 */\n        const payload: PersistedStorageItem = {\n          state: serializer(filteredState),           /* 序列化过滤后的状态 */\n          timestamp: Date.now(),                       /* 保存时间 */\n          expiresAt: ttl ? Date.now() + ttl : undefined, /* 过期时间 */\n          version: 1,                                  /* 数据版本号 */\n        }\n\n        /* 写入存储 */\n        storage.setItem(key, JSON.stringify(payload))\n\n        if (debug) {\n          console.info(`[PersistPlugin] 已保存状态 (${store.$id})`)\n        }\n      }\n      catch (error) {\n        console.error(`[PersistPlugin] 保存状态失败 (${store.$id}):`, error)\n      }\n    }\n\n    /* 创建防抖版的保存函数 */\n    const saveState = debounce(persistState, config.debounce ?? debounceDelay)\n\n    /* 订阅 Store 状态变化，自动触发保存 */\n    const stopSubscribe = store.$subscribe(() => {\n      /* 恢复中不保存 */\n      if (!isRestoring) {\n        saveState()\n      }\n    })\n\n    /* ── 跨标签页同步 ── */\n    let stopStorageSync = (): void => {} /* 清理函数占位 */\n    if (syncTabs && typeof window !== 'undefined') {\n      /* 监听 storage 事件，同步其他标签页的状态变化 */\n      const handleStorage = (event: StorageEvent): void => {\n        /* 只关注目标 key 且有新值 */\n        if (event.key !== key || !event.newValue) {\n          return\n        }\n\n        try {\n          const storageItem = JSON.parse(event.newValue) as PersistedStorageItem\n          /* 跳过过期数据 */\n          if (storageItem.expiresAt && Date.now() > storageItem.expiresAt) {\n            return\n          }\n\n          /* 应用其他标签页的状态 */\n          applyPersistedValue(storageItem.state)\n        }\n        catch (error) {\n          console.error(`[PersistPlugin] 同步状态失败 (${store.$id}):`, error)\n        }\n      }\n\n      window.addEventListener('storage', handleStorage)\n      /* 保存清理函数 */\n      stopStorageSync = () => {\n        window.removeEventListener('storage', handleStorage)\n      }\n    }\n\n    /**\n     * 该 Store 的清理函数\n     * 取消防抖、停止订阅、移除事件监听\n     */\n    const cleanup = (): void => {\n      saveState.cancel()     /* 取消待执行的防抖保存 */\n      stopSubscribe()        /* 取消状态订阅 */\n      stopStorageSync()      /* 移除跨标签页同步监听 */\n      cleanupMap.delete(key) /* 从清理映射中移除 */\n    }\n\n    /* 注册清理函数 */\n    cleanupMap.set(key, cleanup)\n    /* 为 Store 的 $dispose 打补丁，确保销毁时自动清理 */\n    patchPersistDispose(store as DisposableStore, cleanup)\n    /* 立即尝试从存储恢复状态 */\n    restoreState()\n  }\n\n  return {\n    plugin,  /* Pinia 插件函数 */\n    dispose, /* 全局清理函数 */\n  }\n}\n\n/**\n * 创建基础版持久化插件\n * @param options - 插件配置\n * @returns Pinia 插件函数\n */\nexport function createPersistPlugin(options: PersistPluginOptions = {}): PiniaPlugin {\n  return createPersistPluginController(options).plugin\n}\n\n/**\n * 创建增强版持久化插件\n * 与基础版功能相同，类型签名保留扩展空间\n * @param options - 插件配置\n * @returns Pinia 插件函数\n */\nexport function createEnhancedPersistPlugin(\n  options: EnhancedPersistPluginOptions = {},\n): PiniaPlugin {\n  return createPersistPluginController(options).plugin\n}\n\n/**\n * 全局清理所有活跃的持久化控制器\n * 通常在应用卸载或测试中调用\n */\nexport function cleanupEnhancedPersist(): void {\n  Array.from(activePersistControllers).forEach(dispose => dispose())\n}\n"],"mappings":"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"}

package/lib/plugins/pinia-plugin.d.ts

@@ -0,0 +1,68 @@
+import type { PiniaPlugin } from 'pinia';
+import type { PersistOptions } from '../types';
+type BrowserStorage = 'localStorage' | 'sessionStorage';
+/**
+ * 持久化插件控制器接口
+ * @property plugin - Pinia 插件函数
+ * @property dispose - 清理函数，用于移除所有持久化订阅
+ */
+interface PersistPluginController {
+    plugin: PiniaPlugin;
+    dispose: () => void;
+}
+/**
+ * 持久化插件全局配置选项
+ * @property storage - 默认存储类型
+ * @property keyPrefix - 存储键名前缀
+ * @property debounce - 防抖延迟（毫秒）
+ * @property debug - 是否开启调试日志
+ * @property syncTabs - 是否默认启用跨标签页同步
+ * @property defaultTTL - 默认过期时间（毫秒）
+ */
+export interface PersistPluginOptions {
+    storage?: BrowserStorage;
+    keyPrefix?: string;
+    debounce?: number;
+    debug?: boolean;
+    syncTabs?: boolean;
+    defaultTTL?: number;
+}
+export interface EnhancedPersistPluginOptions extends PersistPluginOptions {
+}
+/**
+ * 增强版持久化选项（Store 级别配置）
+ * 在基础 PersistOptions 上增加 excludePaths、syncTabs、ttl
+ */
+export interface EnhancedPersistOptions extends PersistOptions {
+    syncTabs?: boolean;
+    ttl?: number;
+    excludePaths?: string[];
+}
+/**
+ * 创建持久化插件控制器
+ * 返回一个 Pinia 插件函数和对应的 dispose 清理函数
+ *
+ * @param options - 插件全局配置
+ * @returns 控制器对象（包含 plugin 和 dispose）
+ */
+export declare function createPersistPluginController(options?: PersistPluginOptions): PersistPluginController;
+/**
+ * 创建基础版持久化插件
+ * @param options - 插件配置
+ * @returns Pinia 插件函数
+ */
+export declare function createPersistPlugin(options?: PersistPluginOptions): PiniaPlugin;
+/**
+ * 创建增强版持久化插件
+ * 与基础版功能相同，类型签名保留扩展空间
+ * @param options - 插件配置
+ * @returns Pinia 插件函数
+ */
+export declare function createEnhancedPersistPlugin(options?: EnhancedPersistPluginOptions): PiniaPlugin;
+/**
+ * 全局清理所有活跃的持久化控制器
+ * 通常在应用卸载或测试中调用
+ */
+export declare function cleanupEnhancedPersist(): void;
+export {};
+//# sourceMappingURL=pinia-plugin.d.ts.map

package/lib/plugins/registry-plugin.cjs

@@ -0,0 +1,18 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_store_registry = require("../runtime/store-registry.cjs");
+exports.createRegistryMethods = require_store_registry.createRegistryMethods;
+exports.createStoreRegistry = require_store_registry.createStoreRegistry;
+exports.createStoreRegistryPlugin = require_store_registry.createStoreRegistryPlugin;
+exports.getStoreRegistry = require_store_registry.getStoreRegistry;
+exports.setGlobalStoreRegistry = require_store_registry.setGlobalStoreRegistry;
+/*! End of @composy/store-vue | Powered by @composy/builder */

package/lib/plugins/registry-plugin.d.ts

@@ -0,0 +1,2 @@
+export { createRegistryMethods, createStoreRegistry, createStoreRegistryPlugin, getStoreRegistry, setGlobalStoreRegistry, } from '../runtime/store-registry';
+//# sourceMappingURL=registry-plugin.d.ts.map

package/lib/plugins/vue-plugin.cjs

@@ -0,0 +1,26 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_store_runtime = require("../runtime/store-runtime.cjs");
+const require_install_store_app = require("../runtime/install-store-app.cjs");
+//#region src/plugins/vue-plugin.ts
+function createStoreVuePlugin(options = {}) {
+	return { install(app) {
+		const runtime = require_store_runtime.createStoreRuntime(options);
+		const installedRuntime = require_install_store_app.installStoreRuntime(app, runtime);
+		if (installedRuntime !== runtime) runtime.dispose();
+		if (installedRuntime.options.debug) console.info("[StoreVuePlugin] installed");
+	} };
+}
+//#endregion
+exports.createStoreVuePlugin = createStoreVuePlugin;
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=vue-plugin.cjs.map

package/lib/plugins/vue-plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-plugin.cjs","names":[],"sources":["../../src/plugins/vue-plugin.ts"],"sourcesContent":["// 从 vue 导入 App 和 Plugin 类型\nimport type { App, Plugin } from 'vue'\n// 导入 store Vue 插件选项类型\nimport type { StoreVuePluginOptions } from '../runtime/store-plugin-options'\n// 导入安装 store 运行时的函数\nimport { installStoreRuntime } from '../runtime/install-store-app'\n// 导入创建 store 运行时的函数\nimport { createStoreRuntime } from '../runtime/store-runtime'\n\n// 重新导出 store Vue 插件选项类型\nexport type { StoreVuePluginOptions } from '../runtime/store-plugin-options'\n\n/**\n * 创建 store Vue 插件\n * @param options - store Vue 插件配置选项\n * @returns 返回 Vue Plugin 对象，可通过 app.use() 安装\n */\nexport function createStoreVuePlugin(options: StoreVuePluginOptions = {}): Plugin {\n  return {\n    // 安装插件到 Vue 应用\n    install(app: App): void {\n      // 创建 store 运行时实例\n      const runtime = createStoreRuntime(options)\n      // 将运行时安装到 Vue 应用，如果已安装则返回已有的运行时\n      const installedRuntime = installStoreRuntime(app, runtime)\n\n      // 如果安装的运行时不是新创建的，则销毁新建的运行时以避免内存泄漏\n      if (installedRuntime !== runtime) {\n        runtime.dispose()\n      }\n\n      // 如果开启了调试模式，输出安装成功日志\n      if (installedRuntime.options.debug) {\n        console.info('[StoreVuePlugin] installed')\n      }\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAiBO,SAAS,qBAAqB,UAAiC,CAAC,GAAW;CAChF,OAAO,EAEL,QAAQ,KAAgB;EAEtB,MAAM,UAAU,sBAAA,mBAAmB,OAAO;EAE1C,MAAM,mBAAmB,0BAAA,oBAAoB,KAAK,OAAO;EAGzD,IAAI,qBAAqB,SACvB,QAAQ,QAAQ;EAIlB,IAAI,iBAAiB,QAAQ,OAC3B,QAAQ,KAAK,4BAA4B;CAE7C,EACF;AACF"}

package/lib/plugins/vue-plugin.d.ts

@@ -0,0 +1,10 @@
+import type { Plugin } from 'vue';
+import type { StoreVuePluginOptions } from '../runtime/store-plugin-options';
+export type { StoreVuePluginOptions } from '../runtime/store-plugin-options';
+/**
+ * 创建 store Vue 插件
+ * @param options - store Vue 插件配置选项
+ * @returns 返回 Vue Plugin 对象，可通过 app.use() 安装
+ */
+export declare function createStoreVuePlugin(options?: StoreVuePluginOptions): Plugin;
+//# sourceMappingURL=vue-plugin.d.ts.map

package/lib/runtime/install-store-app.cjs

@@ -0,0 +1,57 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_injection_keys = require("../context/injection-keys.cjs");
+const require_store_runtime = require("./store-runtime.cjs");
+//#region src/runtime/install-store-app.ts
+const STORE_APP_RUNTIME_KEY = /* @__PURE__ */ Symbol("ldesign-store-app-runtime");
+function isPiniaInstalled(app, runtime) {
+	return app.config.globalProperties.$pinia === runtime.pinia;
+}
+function patchUnmount(app, runtime) {
+	const originalUnmount = app.unmount;
+	app.unmount = function patchedUnmount() {
+		if (app[STORE_APP_RUNTIME_KEY] === runtime) {
+			delete app[STORE_APP_RUNTIME_KEY];
+			runtime.dispose();
+		}
+		return originalUnmount.call(this);
+	};
+}
+function getInstalledStoreRuntime(app) {
+	return app[STORE_APP_RUNTIME_KEY];
+}
+function installStoreRuntime(app, runtime) {
+	const storeApp = app;
+	const installedRuntime = storeApp[STORE_APP_RUNTIME_KEY];
+	if (installedRuntime) {
+		require_store_runtime.setGlobalStoreRuntime(installedRuntime);
+		return installedRuntime;
+	}
+	if (!isPiniaInstalled(app, runtime)) app.use(runtime.pinia);
+	storeApp[STORE_APP_RUNTIME_KEY] = runtime;
+	if (runtime.options.provide) {
+		app.provide(require_injection_keys.STORE_RUNTIME_SYMBOL, runtime);
+		app.provide(require_injection_keys.STORE_API_SYMBOL, runtime.storeAPI);
+		app.provide(require_injection_keys.STORE_PINIA_SYMBOL, runtime.pinia);
+		app.provide("store", runtime.storeAPI);
+		app.provide("pinia", runtime.pinia);
+	}
+	if (runtime.options.globalProperties) app.config.globalProperties.$store = runtime.storeAPI;
+	patchUnmount(storeApp, runtime);
+	require_store_runtime.setGlobalStoreRuntime(runtime);
+	return runtime;
+}
+//#endregion
+exports.getInstalledStoreRuntime = getInstalledStoreRuntime;
+exports.installStoreRuntime = installStoreRuntime;
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=install-store-app.cjs.map

package/lib/runtime/install-store-app.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-store-app.cjs","names":[],"sources":["../../src/runtime/install-store-app.ts"],"sourcesContent":["/* ============================================================\n * install-store-app.ts\n * Store 运行时安装到 Vue App 的模块\n * 负责将 StoreRuntime 安装到 Vue 应用实例，管理 Pinia 注入、\n * provide/globalProperties 注入和 unmount 生命周期清理\n * ============================================================ */\n\n/* Vue App 类型 */\nimport type { App } from 'vue'\n/* Store 运行时类型 */\nimport type { StoreRuntime } from './store-runtime'\n/* 从注入键模块导入 Symbol 常量 */\nimport {\n  STORE_API_SYMBOL,       /* Store API 的注入键 */\n  STORE_PINIA_SYMBOL,     /* Pinia 实例的注入键 */\n  STORE_RUNTIME_SYMBOL,   /* 运行时的注入键 */\n} from '../context/injection-keys'\n/* 导入全局运行时设置函数 */\nimport { setGlobalStoreRuntime } from './store-runtime'\n\n/* 用于标记 App 上已安装的运行时的 Symbol 键 */\nconst STORE_APP_RUNTIME_KEY = Symbol('ldesign-store-app-runtime')\n\n/* 扩展 Vue App 类型，添加运行时引用 */\ntype StoreApp = App & {\n  [STORE_APP_RUNTIME_KEY]?: StoreRuntime\n}\n\n/**\n * 检查 Pinia 是否已安装到 Vue App\n * 通过比较 app.config.globalProperties.$pinia 与 runtime 的 pinia 实例\n *\n * @param app - Vue 应用实例\n * @param runtime - Store 运行时\n * @returns Pinia 是否已安装\n */\nfunction isPiniaInstalled(app: App, runtime: StoreRuntime): boolean {\n  return app.config.globalProperties.$pinia === runtime.pinia\n}\n\n/**\n * 为 Vue App 的 unmount 方法打补丁\n * 在应用卸载时自动清理 Store 运行时（dispose）\n * 确保资源不会泄漏\n *\n * @param app - Vue 应用实例\n * @param runtime - Store 运行时\n */\nfunction patchUnmount(app: StoreApp, runtime: StoreRuntime): void {\n  /* 保存原始 unmount 方法 */\n  const originalUnmount = app.unmount\n\n  /* 替换为带清理逻辑的版本 */\n  app.unmount = function patchedUnmount() {\n    /* 检查当前运行时是否仍是这个 runtime（防止被后续安装覆盖） */\n    const activeRuntime = app[STORE_APP_RUNTIME_KEY]\n    if (activeRuntime === runtime) {\n      /* 清除 App 上的运行时引用 */\n      delete app[STORE_APP_RUNTIME_KEY]\n      /* 执行运行时的 dispose（清理持久化、注册表等） */\n      runtime.dispose()\n    }\n\n    /* 调用原始 unmount 方法 */\n    return originalUnmount.call(this)\n  }\n}\n\n/**\n * 获取 Vue App 上已安装的 Store 运行时\n * @param app - Vue 应用实例\n * @returns 已安装的运行时或 undefined\n */\nexport function getInstalledStoreRuntime(app: App): StoreRuntime | undefined {\n  return (app as StoreApp)[STORE_APP_RUNTIME_KEY]\n}\n\n/**\n * 将 Store 运行时安装到 Vue App\n * 这是 Vue 适配层的核心安装入口，负责：\n * 1. 安装 Pinia 插件\n * 2. 通过 provide 注入 Store 能力\n * 3. 挂载到 globalProperties\n * 4. 打 unmount 补丁进行生命周期管理\n * 5. 设置全局运行时引用\n *\n * @param app - Vue 应用实例\n * @param runtime - Store 运行时实例\n * @returns 安装的运行时（如果已安装则返回已有的）\n */\nexport function installStoreRuntime(\n  app: App,\n  runtime: StoreRuntime,\n): StoreRuntime {\n  const storeApp = app as StoreApp\n  /* 检查是否已安装（幂等性） */\n  const installedRuntime = storeApp[STORE_APP_RUNTIME_KEY]\n\n  if (installedRuntime) {\n    /* 已安装则设置全局引用并返回已有的运行时 */\n    setGlobalStoreRuntime(installedRuntime)\n    return installedRuntime\n  }\n\n  /* 如果 Pinia 尚未安装，使用 app.use() 安装 */\n  if (!isPiniaInstalled(app, runtime)) {\n    app.use(runtime.pinia)\n  }\n\n  /* 在 App 上保存运行时引用（标记已安装） */\n  storeApp[STORE_APP_RUNTIME_KEY] = runtime\n\n  /* 如果配置了 provide 注入，通过 Vue 的 provide/inject 注入 Store 能力 */\n  if (runtime.options.provide) {\n    app.provide(STORE_RUNTIME_SYMBOL, runtime)        /* 注入运行时 */\n    app.provide(STORE_API_SYMBOL, runtime.storeAPI)   /* 注入 Store API */\n    app.provide(STORE_PINIA_SYMBOL, runtime.pinia)    /* 注入 Pinia 实例 */\n    app.provide('store', runtime.storeAPI)            /* 简写键 'store' */\n    app.provide('pinia', runtime.pinia)               /* 简写键 'pinia' */\n  }\n\n  /* 如果配置了 globalProperties，挂载到全局属性上 */\n  if (runtime.options.globalProperties) {\n    app.config.globalProperties.$store = runtime.storeAPI\n  }\n\n  /* 打 unmount 补丁，确保卸载时自动清理 */\n  patchUnmount(storeApp, runtime)\n  /* 设置为全局运行时引用 */\n  setGlobalStoreRuntime(runtime)\n\n  return runtime\n}\n"],"mappings":";;;;;;;;;;;;;;AAqBA,MAAM,wBAAwB,uBAAO,2BAA2B;AAehE,SAAS,iBAAiB,KAAU,SAAgC;CAClE,OAAO,IAAI,OAAO,iBAAiB,WAAW,QAAQ;AACxD;AAUA,SAAS,aAAa,KAAe,SAA6B;CAEhE,MAAM,kBAAkB,IAAI;CAG5B,IAAI,UAAU,SAAS,iBAAiB;EAGtC,IADsB,IAAI,2BACJ,SAAS;GAE7B,OAAO,IAAI;GAEX,QAAQ,QAAQ;EAClB;EAGA,OAAO,gBAAgB,KAAK,IAAI;CAClC;AACF;AAOO,SAAS,yBAAyB,KAAoC;CAC3E,OAAQ,IAAiB;AAC3B;AAeO,SAAS,oBACd,KACA,SACc;CACd,MAAM,WAAW;CAEjB,MAAM,mBAAmB,SAAS;CAElC,IAAI,kBAAkB;EAEpB,sBAAA,sBAAsB,gBAAgB;EACtC,OAAO;CACT;CAGA,IAAI,CAAC,iBAAiB,KAAK,OAAO,GAChC,IAAI,IAAI,QAAQ,KAAK;CAIvB,SAAS,yBAAyB;CAGlC,IAAI,QAAQ,QAAQ,SAAS;EAC3B,IAAI,QAAQ,uBAAA,sBAAsB,OAAO;EACzC,IAAI,QAAQ,uBAAA,kBAAkB,QAAQ,QAAQ;EAC9C,IAAI,QAAQ,uBAAA,oBAAoB,QAAQ,KAAK;EAC7C,IAAI,QAAQ,SAAS,QAAQ,QAAQ;EACrC,IAAI,QAAQ,SAAS,QAAQ,KAAK;CACpC;CAGA,IAAI,QAAQ,QAAQ,kBAClB,IAAI,OAAO,iBAAiB,SAAS,QAAQ;CAI/C,aAAa,UAAU,OAAO;CAE9B,sBAAA,sBAAsB,OAAO;CAE7B,OAAO;AACT"}

package/lib/runtime/install-store-app.d.ts

@@ -0,0 +1,23 @@
+import type { App } from 'vue';
+import type { StoreRuntime } from './store-runtime';
+/**
+ * 获取 Vue App 上已安装的 Store 运行时
+ * @param app - Vue 应用实例
+ * @returns 已安装的运行时或 undefined
+ */
+export declare function getInstalledStoreRuntime(app: App): StoreRuntime | undefined;
+/**
+ * 将 Store 运行时安装到 Vue App
+ * 这是 Vue 适配层的核心安装入口，负责：
+ * 1. 安装 Pinia 插件
+ * 2. 通过 provide 注入 Store 能力
+ * 3. 挂载到 globalProperties
+ * 4. 打 unmount 补丁进行生命周期管理
+ * 5. 设置全局运行时引用
+ *
+ * @param app - Vue 应用实例
+ * @param runtime - Store 运行时实例
+ * @returns 安装的运行时（如果已安装则返回已有的）
+ */
+export declare function installStoreRuntime(app: App, runtime: StoreRuntime): StoreRuntime;
+//# sourceMappingURL=install-store-app.d.ts.map

package/lib/runtime/store-plugin-options.cjs

@@ -0,0 +1,26 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/runtime/store-plugin-options.ts
+function normalizeStoreRuntimeOptions(options = {}) {
+	return {
+		pinia: options.pinia,
+		persist: options.persist ?? false,
+		persistOptions: options.persistOptions ?? {},
+		globalProperties: options.globalProperties ?? true,
+		provide: options.provide ?? true,
+		debug: options.debug ?? false
+	};
+}
+//#endregion
+exports.normalizeStoreRuntimeOptions = normalizeStoreRuntimeOptions;
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=store-plugin-options.cjs.map

package/lib/runtime/store-plugin-options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-plugin-options.cjs","names":[],"sources":["../../src/runtime/store-plugin-options.ts"],"sourcesContent":["// 从 pinia 导入 Pinia 类型\nimport type { Pinia } from 'pinia'\n// 导入增强持久化插件选项类型\nimport type { EnhancedPersistPluginOptions } from '../plugins/pinia-plugin'\n\n/**\n * store 运行时配置选项接口\n * 用于配置 store 运行时的行为\n */\nexport interface StoreRuntimeOptions {\n  // 可选的 Pinia 实例，如果不提供则自动创建\n  pinia?: Pinia\n  // 是否启用持久化功能\n  persist?: boolean\n  // 持久化插件的详细配置选项\n  persistOptions?: EnhancedPersistPluginOptions\n  // 是否将 store API 注册到 Vue 全局属性\n  globalProperties?: boolean\n  // 是否通过 provide/inject 提供 store 实例\n  provide?: boolean\n  // 是否开启调试模式\n  debug?: boolean\n}\n\n/**\n * store Vue 插件选项接口\n * 继承自 StoreRuntimeOptions，当前无额外扩展\n */\nexport interface StoreVuePluginOptions extends StoreRuntimeOptions {}\n\n/**\n * 解析后的 store 运行时选项接口\n * 所有字段均已填充默认值，不再包含可选标记\n */\nexport interface ResolvedStoreRuntimeOptions {\n  // Pinia 实例\n  pinia?: Pinia\n  // 是否启用持久化\n  persist: boolean\n  // 持久化插件配置\n  persistOptions: EnhancedPersistPluginOptions\n  // 是否注册全局属性\n  globalProperties: boolean\n  // 是否通过 provide 提供\n  provide: boolean\n  // 是否开启调试\n  debug: boolean\n}\n\n/**\n * 将用户传入的 store 运行时选项规范化为完整配置\n * 为每个可选字段填充默认值\n * @param options - 用户传入的配置选项\n * @returns 规范化后的完整配置对象\n */\nexport function normalizeStoreRuntimeOptions(\n  options: StoreRuntimeOptions = {},\n): ResolvedStoreRuntimeOptions {\n  return {\n    pinia: options.pinia, // 透传 Pinia 实例\n    persist: options.persist ?? false, // 默认不启用持久化\n    persistOptions: options.persistOptions ?? {}, // 默认空持久化配置\n    globalProperties: options.globalProperties ?? true, // 默认注册全局属性\n    provide: options.provide ?? true, // 默认通过 provide 提供\n    debug: options.debug ?? false, // 默认关闭调试\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAuDO,SAAS,6BACd,UAA+B,CAAC,GACH;CAC7B,OAAO;EACL,OAAO,QAAQ;EACf,SAAS,QAAQ,WAAW;EAC5B,gBAAgB,QAAQ,kBAAkB,CAAC;EAC3C,kBAAkB,QAAQ,oBAAoB;EAC9C,SAAS,QAAQ,WAAW;EAC5B,OAAO,QAAQ,SAAS;CAC1B;AACF"}