@composy/store-vue 0.0.1

package/lib/runtime/store-plugin-options.d.ts

@@ -0,0 +1,40 @@
+import type { Pinia } from 'pinia';
+import type { EnhancedPersistPluginOptions } from '../plugins/pinia-plugin';
+/**
+ * store 运行时配置选项接口
+ * 用于配置 store 运行时的行为
+ */
+export interface StoreRuntimeOptions {
+    pinia?: Pinia;
+    persist?: boolean;
+    persistOptions?: EnhancedPersistPluginOptions;
+    globalProperties?: boolean;
+    provide?: boolean;
+    debug?: boolean;
+}
+/**
+ * store Vue 插件选项接口
+ * 继承自 StoreRuntimeOptions，当前无额外扩展
+ */
+export interface StoreVuePluginOptions extends StoreRuntimeOptions {
+}
+/**
+ * 解析后的 store 运行时选项接口
+ * 所有字段均已填充默认值，不再包含可选标记
+ */
+export interface ResolvedStoreRuntimeOptions {
+    pinia?: Pinia;
+    persist: boolean;
+    persistOptions: EnhancedPersistPluginOptions;
+    globalProperties: boolean;
+    provide: boolean;
+    debug: boolean;
+}
+/**
+ * 将用户传入的 store 运行时选项规范化为完整配置
+ * 为每个可选字段填充默认值
+ * @param options - 用户传入的配置选项
+ * @returns 规范化后的完整配置对象
+ */
+export declare function normalizeStoreRuntimeOptions(options?: StoreRuntimeOptions): ResolvedStoreRuntimeOptions;
+//# sourceMappingURL=store-plugin-options.d.ts.map

package/lib/runtime/store-registry.cjs

@@ -0,0 +1,108 @@
+/*!
+* ***********************************
+* @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-registry.ts
+const STORE_DISPOSE_PATCH_KEY = /* @__PURE__ */ Symbol("ldesign-store-registry-dispose");
+function patchStoreDispose(store, unregister) {
+	const restorePatchedDispose = store[STORE_DISPOSE_PATCH_KEY];
+	if (restorePatchedDispose) restorePatchedDispose();
+	const originalDispose = store.$dispose;
+	store.$dispose = function patchedDispose() {
+		unregister(store.$id);
+		return originalDispose.call(this);
+	};
+	store[STORE_DISPOSE_PATCH_KEY] = () => {
+		store.$dispose = originalDispose;
+		delete store[STORE_DISPOSE_PATCH_KEY];
+	};
+}
+function createStoreRegistry() {
+	const stores = /* @__PURE__ */ new Map();
+	const unregister = (storeId) => {
+		stores.delete(storeId);
+	};
+	const register = (store) => {
+		stores.set(store.$id, store);
+		patchStoreDispose(store, unregister);
+	};
+	const hasStore = (storeId) => {
+		return stores.has(storeId);
+	};
+	const getStore = (storeId) => {
+		return stores.get(storeId);
+	};
+	const getStoreIds = () => {
+		return Array.from(stores.keys());
+	};
+	const resetAll = () => {
+		stores.forEach((store) => {
+			if (typeof store.$reset !== "function") return;
+			try {
+				store.$reset();
+			} catch {}
+		});
+	};
+	const clear = () => {
+		stores.clear();
+	};
+	const registerExistingStores = (pinia) => {
+		pinia._s?.forEach((store) => register(store));
+	};
+	const createStoreAPI = (pinia) => {
+		return {
+			pinia,
+			getStore,
+			hasStore,
+			getStoreIds,
+			resetAll
+		};
+	};
+	return {
+		stores,
+		register,
+		unregister,
+		hasStore,
+		getStore,
+		getStoreIds,
+		resetAll,
+		clear,
+		registerExistingStores,
+		createStoreAPI
+	};
+}
+let globalRegistry = createStoreRegistry();
+function setGlobalStoreRegistry(registry) {
+	globalRegistry = registry ?? createStoreRegistry();
+}
+function getStoreRegistry() {
+	return globalRegistry.stores;
+}
+function createRegistryMethods(registry = globalRegistry) {
+	return {
+		getStore: registry.getStore,
+		hasStore: registry.hasStore,
+		getStoreIds: registry.getStoreIds,
+		resetAll: registry.resetAll
+	};
+}
+function createStoreRegistryPlugin(registry = globalRegistry) {
+	return ({ store }) => {
+		registry.register(store);
+	};
+}
+//#endregion
+exports.createRegistryMethods = createRegistryMethods;
+exports.createStoreRegistry = createStoreRegistry;
+exports.createStoreRegistryPlugin = createStoreRegistryPlugin;
+exports.getStoreRegistry = getStoreRegistry;
+exports.setGlobalStoreRegistry = setGlobalStoreRegistry;
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=store-registry.cjs.map

package/lib/runtime/store-registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-registry.cjs","names":[],"sources":["../../src/runtime/store-registry.ts"],"sourcesContent":["/* ============================================================\n * store-registry.ts\n * Store 注册表模块\n * 管理所有活跃的 Pinia Store 实例，提供注册/注销/查询/重置能力\n * 通过 patch $dispose 方法实现 Store 销毁时自动注销\n * ============================================================ */\n\n/* 从 Pinia 导入类型 */\nimport type { Pinia, PiniaPluginContext, StoreGeneric } from 'pinia'\n/* 导入全局 Store API 类型 */\nimport type { GlobalStoreAPI } from '../types'\n\n/* 用于标记 store 的 $dispose 是否已被 patch 的 Symbol 键 */\nconst STORE_DISPOSE_PATCH_KEY = Symbol('ldesign-store-registry-dispose')\n\n/* 可被 patch $dispose 的 Store 扩展类型 */\ntype DisposableStore = StoreGeneric & {\n  [STORE_DISPOSE_PATCH_KEY]?: () => void /* 恢复原始 $dispose 的函数 */\n}\n\n/* 扩展 Pinia 类型，访问内部的 _s（Store 实例映射） */\ntype PiniaWithStores = Pinia & {\n  _s?: Map<string, StoreGeneric>\n}\n\n/**\n * Store 注册表接口\n * 提供对所有活跃 Store 的集中管理能力\n * @property stores - Store 实例映射（storeId → Store）\n * @property register - 注册一个 Store\n * @property unregister - 注销一个 Store\n * @property hasStore - 检查 Store 是否已注册\n * @property getStore - 获取指定 ID 的 Store\n * @property getStoreIds - 获取所有已注册的 Store ID\n * @property resetAll - 重置所有 Store 到初始状态\n * @property clear - 清空注册表（不重置 Store）\n * @property registerExistingStores - 从 Pinia 实例中批量注册已有的 Store\n * @property createStoreAPI - 创建全局 Store API 对象\n */\nexport interface StoreRegistry {\n  readonly stores: Map<string, StoreGeneric>\n  register: (store: StoreGeneric) => void\n  unregister: (storeId: string) => void\n  hasStore: (storeId: string) => boolean\n  getStore: <T = unknown>(storeId: string) => T | undefined\n  getStoreIds: () => string[]\n  resetAll: () => void\n  clear: () => void\n  registerExistingStores: (pinia: Pinia) => void\n  createStoreAPI: (pinia: Pinia) => GlobalStoreAPI\n}\n\n/**\n * 为 Store 的 $dispose 方法打补丁\n * 在 Store 被销毁时自动从注册表中注销\n * 确保注册表中的 Store 引用不会过期\n *\n * @param store - 目标 Store\n * @param unregister - 注销回调函数\n */\nfunction patchStoreDispose(store: DisposableStore, unregister: (storeId: string) => void): void {\n  /* 如果之前已有补丁，先恢复原始方法 */\n  const restorePatchedDispose = store[STORE_DISPOSE_PATCH_KEY]\n  if (restorePatchedDispose) {\n    restorePatchedDispose()\n  }\n\n  /* 保存原始 $dispose 方法 */\n  const originalDispose = store.$dispose\n  /* 替换为带注销逻辑的版本 */\n  store.$dispose = function patchedDispose() {\n    unregister(store.$id) /* 从注册表注销 */\n    return originalDispose.call(this) /* 调用原始 dispose */\n  }\n\n  /* 保存恢复函数，供后续补丁使用 */\n  store[STORE_DISPOSE_PATCH_KEY] = () => {\n    store.$dispose = originalDispose\n    delete store[STORE_DISPOSE_PATCH_KEY]\n  }\n}\n\n/**\n * 创建 Store 注册表实例\n * @returns StoreRegistry 注册表对象\n */\nexport function createStoreRegistry(): StoreRegistry {\n  /* Store 实例映射（storeId → Store） */\n  const stores = new Map<string, StoreGeneric>()\n\n  /**\n   * 注销指定 ID 的 Store\n   * @param storeId - Store ID\n   */\n  const unregister = (storeId: string): void => {\n    stores.delete(storeId)\n  }\n\n  /**\n   * 注册一个 Store\n   * 同时为 $dispose 打补丁，确保销毁时自动注销\n   * @param store - 要注册的 Store 实例\n   */\n  const register = (store: StoreGeneric): void => {\n    stores.set(store.$id, store)\n    patchStoreDispose(store as DisposableStore, unregister)\n  }\n\n  /**\n   * 检查 Store 是否已注册\n   * @param storeId - Store ID\n   * @returns 是否已注册\n   */\n  const hasStore = (storeId: string): boolean => {\n    return stores.has(storeId)\n  }\n\n  /**\n   * 获取指定 ID 的 Store\n   * @param storeId - Store ID\n   * @returns Store 实例或 undefined\n   */\n  const getStore = <T = unknown>(storeId: string): T | undefined => {\n    return stores.get(storeId) as T | undefined\n  }\n\n  /**\n   * 获取所有已注册的 Store ID 列表\n   * @returns Store ID 数组\n   */\n  const getStoreIds = (): string[] => {\n    return Array.from(stores.keys())\n  }\n\n  /**\n   * 重置所有 Store 到初始状态\n   * 调用每个 Store 的 $reset() 方法\n   * 注意：Setup stores 可能不支持 $reset\n   */\n  const resetAll = (): void => {\n    stores.forEach((store) => {\n      /* 检查是否有 $reset 方法 */\n      if (typeof store.$reset !== 'function') {\n        return\n      }\n\n      try {\n        store.$reset()\n      }\n      catch {\n        /* Setup stores 可能暴露了 $reset 但实际拒绝直接重置 */\n      }\n    })\n  }\n\n  /**\n   * 清空注册表\n   * 只清除映射，不重置 Store\n   */\n  const clear = (): void => {\n    stores.clear()\n  }\n\n  /**\n   * 从 Pinia 实例中批量注册已有的 Store\n   * 访问 Pinia 内部的 _s 映射（所有已创建的 Store）\n   * @param pinia - Pinia 实例\n   */\n  const registerExistingStores = (pinia: Pinia): void => {\n    const typedPinia = pinia as PiniaWithStores\n    typedPinia._s?.forEach(store => register(store))\n  }\n\n  /**\n   * 创建全局 Store API 对象\n   * 提供只读的 Store 查询和管理能力\n   * @param pinia - Pinia 实例\n   * @returns GlobalStoreAPI 对象\n   */\n  const createStoreAPI = (pinia: Pinia): GlobalStoreAPI => {\n    return {\n      pinia,         /* Pinia 实例引用 */\n      getStore,      /* 获取 Store */\n      hasStore,      /* 检查 Store 是否存在 */\n      getStoreIds,   /* 获取所有 Store ID */\n      resetAll,      /* 重置所有 Store */\n    }\n  }\n\n  /* 返回完整的注册表对象 */\n  return {\n    stores,\n    register,\n    unregister,\n    hasStore,\n    getStore,\n    getStoreIds,\n    resetAll,\n    clear,\n    registerExistingStores,\n    createStoreAPI,\n  }\n}\n\n/* ── 全局注册表单例 ── */\n\n/* 全局注册表实例（模块级单例） */\nlet globalRegistry = createStoreRegistry()\n\n/**\n * 设置全局注册表\n * 传 null 则创建新的空注册表\n * @param registry - 新的注册表或 null\n */\nexport function setGlobalStoreRegistry(registry: StoreRegistry | null): void {\n  globalRegistry = registry ?? createStoreRegistry()\n}\n\n/**\n * 获取全局 Store 映射（兼容旧接口）\n * @returns Store 映射（类型擦除版）\n */\nexport function getStoreRegistry(): Map<string, unknown> {\n  return globalRegistry.stores as Map<string, unknown>\n}\n\n/**\n * 创建注册表方法集合\n * 从注册表中提取常用的查询方法\n * @param registry - 注册表实例，默认使用全局注册表\n * @returns 方法集合对象\n */\nexport function createRegistryMethods(registry: StoreRegistry = globalRegistry) {\n  return {\n    getStore: registry.getStore,\n    hasStore: registry.hasStore,\n    getStoreIds: registry.getStoreIds,\n    resetAll: registry.resetAll,\n  }\n}\n\n/**\n * 创建注册表 Pinia 插件\n * 当 Store 被创建/使用时自动注册到注册表\n * @param registry - 注册表实例，默认使用全局注册表\n * @returns Pinia 插件函数\n */\nexport function createStoreRegistryPlugin(registry: StoreRegistry = globalRegistry) {\n  return ({ store }: PiniaPluginContext): void => {\n    registry.register(store)\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAaA,MAAM,0BAA0B,uBAAO,gCAAgC;AA+CvE,SAAS,kBAAkB,OAAwB,YAA6C;CAE9F,MAAM,wBAAwB,MAAM;CACpC,IAAI,uBACF,sBAAsB;CAIxB,MAAM,kBAAkB,MAAM;CAE9B,MAAM,WAAW,SAAS,iBAAiB;EACzC,WAAW,MAAM,GAAG;EACpB,OAAO,gBAAgB,KAAK,IAAI;CAClC;CAGA,MAAM,iCAAiC;EACrC,MAAM,WAAW;EACjB,OAAO,MAAM;CACf;AACF;AAMO,SAAS,sBAAqC;CAEnD,MAAM,yBAAS,IAAI,IAA0B;CAM7C,MAAM,cAAc,YAA0B;EAC5C,OAAO,OAAO,OAAO;CACvB;CAOA,MAAM,YAAY,UAA8B;EAC9C,OAAO,IAAI,MAAM,KAAK,KAAK;EAC3B,kBAAkB,OAA0B,UAAU;CACxD;CAOA,MAAM,YAAY,YAA6B;EAC7C,OAAO,OAAO,IAAI,OAAO;CAC3B;CAOA,MAAM,YAAyB,YAAmC;EAChE,OAAO,OAAO,IAAI,OAAO;CAC3B;CAMA,MAAM,oBAA8B;EAClC,OAAO,MAAM,KAAK,OAAO,KAAK,CAAC;CACjC;CAOA,MAAM,iBAAuB;EAC3B,OAAO,SAAS,UAAU;GAExB,IAAI,OAAO,MAAM,WAAW,YAC1B;GAGF,IAAI;IACF,MAAM,OAAO;GACf,QACM,CAEN;EACF,CAAC;CACH;CAMA,MAAM,cAAoB;EACxB,OAAO,MAAM;CACf;CAOA,MAAM,0BAA0B,UAAuB;EAErD,MAAW,IAAI,SAAQ,UAAS,SAAS,KAAK,CAAC;CACjD;CAQA,MAAM,kBAAkB,UAAiC;EACvD,OAAO;GACL;GACA;GACA;GACA;GACA;EACF;CACF;CAGA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;AAKA,IAAI,iBAAiB,oBAAoB;AAOlC,SAAS,uBAAuB,UAAsC;CAC3E,iBAAiB,YAAY,oBAAoB;AACnD;AAMO,SAAS,mBAAyC;CACvD,OAAO,eAAe;AACxB;AAQO,SAAS,sBAAsB,WAA0B,gBAAgB;CAC9E,OAAO;EACL,UAAU,SAAS;EACnB,UAAU,SAAS;EACnB,aAAa,SAAS;EACtB,UAAU,SAAS;CACrB;AACF;AAQO,SAAS,0BAA0B,WAA0B,gBAAgB;CAClF,QAAQ,EAAE,YAAsC;EAC9C,SAAS,SAAS,KAAK;CACzB;AACF"}

package/lib/runtime/store-registry.d.ts

@@ -0,0 +1,64 @@
+import type { Pinia, PiniaPluginContext, StoreGeneric } from 'pinia';
+import type { GlobalStoreAPI } from '../types';
+/**
+ * Store 注册表接口
+ * 提供对所有活跃 Store 的集中管理能力
+ * @property stores - Store 实例映射（storeId → Store）
+ * @property register - 注册一个 Store
+ * @property unregister - 注销一个 Store
+ * @property hasStore - 检查 Store 是否已注册
+ * @property getStore - 获取指定 ID 的 Store
+ * @property getStoreIds - 获取所有已注册的 Store ID
+ * @property resetAll - 重置所有 Store 到初始状态
+ * @property clear - 清空注册表（不重置 Store）
+ * @property registerExistingStores - 从 Pinia 实例中批量注册已有的 Store
+ * @property createStoreAPI - 创建全局 Store API 对象
+ */
+export interface StoreRegistry {
+    readonly stores: Map<string, StoreGeneric>;
+    register: (store: StoreGeneric) => void;
+    unregister: (storeId: string) => void;
+    hasStore: (storeId: string) => boolean;
+    getStore: <T = unknown>(storeId: string) => T | undefined;
+    getStoreIds: () => string[];
+    resetAll: () => void;
+    clear: () => void;
+    registerExistingStores: (pinia: Pinia) => void;
+    createStoreAPI: (pinia: Pinia) => GlobalStoreAPI;
+}
+/**
+ * 创建 Store 注册表实例
+ * @returns StoreRegistry 注册表对象
+ */
+export declare function createStoreRegistry(): StoreRegistry;
+/**
+ * 设置全局注册表
+ * 传 null 则创建新的空注册表
+ * @param registry - 新的注册表或 null
+ */
+export declare function setGlobalStoreRegistry(registry: StoreRegistry | null): void;
+/**
+ * 获取全局 Store 映射（兼容旧接口）
+ * @returns Store 映射（类型擦除版）
+ */
+export declare function getStoreRegistry(): Map<string, unknown>;
+/**
+ * 创建注册表方法集合
+ * 从注册表中提取常用的查询方法
+ * @param registry - 注册表实例，默认使用全局注册表
+ * @returns 方法集合对象
+ */
+export declare function createRegistryMethods(registry?: StoreRegistry): {
+    getStore: <T = unknown>(storeId: string) => T | undefined;
+    hasStore: (storeId: string) => boolean;
+    getStoreIds: () => string[];
+    resetAll: () => void;
+};
+/**
+ * 创建注册表 Pinia 插件
+ * 当 Store 被创建/使用时自动注册到注册表
+ * @param registry - 注册表实例，默认使用全局注册表
+ * @returns Pinia 插件函数
+ */
+export declare function createStoreRegistryPlugin(registry?: StoreRegistry): ({ store }: PiniaPluginContext) => void;
+//# sourceMappingURL=store-registry.d.ts.map

package/lib/runtime/store-runtime.cjs

@@ -0,0 +1,62 @@
+/*!
+* ***********************************
+* @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("../plugins/pinia-plugin.cjs");
+const require_store_plugin_options = require("./store-plugin-options.cjs");
+const require_store_registry = require("./store-registry.cjs");
+let pinia = require("pinia");
+//#region src/runtime/store-runtime.ts
+const STORE_RUNTIME_KEY = /* @__PURE__ */ Symbol("ldesign-store-runtime");
+let globalStoreRuntime = null;
+function getGlobalStoreAPI() {
+	return globalStoreRuntime?.storeAPI ?? null;
+}
+function setGlobalStoreRuntime(runtime) {
+	globalStoreRuntime = runtime;
+	require_store_registry.setGlobalStoreRegistry(runtime?.registry ?? null);
+}
+function createStoreRuntime(options = {}) {
+	const resolvedOptions = require_store_plugin_options.normalizeStoreRuntimeOptions(options);
+	const pinia$1 = resolvedOptions.pinia ?? (0, pinia.createPinia)();
+	if (pinia$1[STORE_RUNTIME_KEY]) return pinia$1[STORE_RUNTIME_KEY];
+	const registry = require_store_registry.createStoreRegistry();
+	const persistController = resolvedOptions.persist ? require_pinia_plugin.createPersistPluginController({
+		...resolvedOptions.persistOptions,
+		debug: resolvedOptions.debug || resolvedOptions.persistOptions.debug
+	}) : null;
+	pinia$1.use(require_store_registry.createStoreRegistryPlugin(registry));
+	persistController && pinia$1.use(persistController.plugin);
+	registry.registerExistingStores(pinia$1);
+	const runtime = {
+		pinia: pinia$1,
+		registry,
+		storeAPI: registry.createStoreAPI(pinia$1),
+		options: resolvedOptions,
+		/**
+		* 清理函数
+		* 释放所有资源：清除运行时标记、持久化插件、注册表
+		*/
+		dispose: () => {
+			if (pinia$1[STORE_RUNTIME_KEY] === runtime) delete pinia$1[STORE_RUNTIME_KEY];
+			persistController?.dispose();
+			registry.clear();
+			if (globalStoreRuntime === runtime) setGlobalStoreRuntime(null);
+		}
+	};
+	pinia$1[STORE_RUNTIME_KEY] = runtime;
+	return runtime;
+}
+//#endregion
+exports.createStoreRuntime = createStoreRuntime;
+exports.getGlobalStoreAPI = getGlobalStoreAPI;
+exports.setGlobalStoreRuntime = setGlobalStoreRuntime;
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=store-runtime.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-runtime.cjs","names":[],"sources":["../../src/runtime/store-runtime.ts"],"sourcesContent":["/* ============================================================\n * store-runtime.ts\n * Store 运行时模块\n * 负责创建和管理 Store 运行时实例，包括 Pinia 创建、\n * 注册表初始化、持久化插件配置和生命周期管理\n * ============================================================ */\n\n/* 从 Pinia 导入类型 */\nimport type { Pinia, StoreGeneric } from 'pinia'\n/* 全局 Store API 类型 */\nimport type { GlobalStoreAPI } from '../types'\n/* 运行时选项类型 */\nimport type {\n  ResolvedStoreRuntimeOptions,   /* 解析后的运行时选项 */\n  StoreRuntimeOptions,           /* 原始运行时选项 */\n} from './store-plugin-options'\n/* 注册表类型 */\nimport type { StoreRegistry } from './store-registry'\n/* 从 Pinia 导入创建实例函数 */\nimport { createPinia } from 'pinia'\n/* 导入持久化插件控制器 */\nimport { createPersistPluginController } from '../plugins/pinia-plugin'\n/* 导入选项规范化函数 */\nimport {\n  normalizeStoreRuntimeOptions,\n} from './store-plugin-options'\n/* 导入注册表相关函数 */\nimport {\n  createStoreRegistry,\n  createStoreRegistryPlugin,\n  setGlobalStoreRegistry,\n} from './store-registry'\n\n/* 用于标记 Pinia 实例上已绑定的运行时的 Symbol 键 */\nconst STORE_RUNTIME_KEY = Symbol('ldesign-store-runtime')\n\n/* 扩展 Pinia 类型，添加运行时和 Store 映射引用 */\ntype PiniaWithRuntime = Pinia & {\n  _s?: Map<string, StoreGeneric>          /* Pinia 内部的 Store 实例映射 */\n  [STORE_RUNTIME_KEY]?: StoreRuntime      /* 绑定的运行时 */\n}\n\n/**\n * Store 运行时接口\n * 封装了 Pinia、注册表、API 和生命周期管理\n * @property pinia - Pinia 实例\n * @property registry - Store 注册表\n * @property storeAPI - 全局 Store API\n * @property options - 解析后的运行时选项\n * @property dispose - 清理函数，释放所有资源\n */\nexport interface StoreRuntime {\n  pinia: Pinia\n  registry: StoreRegistry\n  storeAPI: GlobalStoreAPI\n  options: ResolvedStoreRuntimeOptions\n  dispose: () => void\n}\n\n/* 全局运行时实例（模块级单例） */\nlet globalStoreRuntime: StoreRuntime | null = null\n\n/**\n * 获取全局 Store API\n * @returns 全局 Store API 或 null（运行时未初始化时）\n */\nexport function getGlobalStoreAPI(): GlobalStoreAPI | null {\n  return globalStoreRuntime?.storeAPI ?? null\n}\n\n/**\n * 设置全局运行时\n * 同步更新全局注册表引用\n * @param runtime - 新的运行时实例或 null\n */\nexport function setGlobalStoreRuntime(runtime: StoreRuntime | null): void {\n  globalStoreRuntime = runtime\n  /* 同步更新全局注册表 */\n  setGlobalStoreRegistry(runtime?.registry ?? null)\n}\n\n/**\n * 创建 Store 运行时实例\n * 这是 Store 系统的核心工厂函数，负责：\n * 1. 规范化配置选项\n * 2. 创建或复用 Pinia 实例\n * 3. 创建 Store 注册表\n * 4. 配置持久化插件\n * 5. 注册 Pinia 插件\n * 6. 组装运行时对象\n *\n * @param options - 运行时配置选项\n * @returns StoreRuntime 实例\n */\nexport function createStoreRuntime(\n  options: StoreRuntimeOptions = {},\n): StoreRuntime {\n  /* 规范化配置选项（填充默认值） */\n  const resolvedOptions = normalizeStoreRuntimeOptions(options)\n  /* 创建或复用 Pinia 实例，扩展为带运行时标记的类型 */\n  const pinia = (resolvedOptions.pinia ?? createPinia()) as PiniaWithRuntime\n\n  /* 如果 Pinia 实例上已有运行时，直接复用（防止重复创建） */\n  if (pinia[STORE_RUNTIME_KEY]) {\n    return pinia[STORE_RUNTIME_KEY]\n  }\n\n  /* 创建 Store 注册表 */\n  const registry = createStoreRegistry()\n\n  /* 如果启用了持久化，创建持久化插件控制器 */\n  const persistController = resolvedOptions.persist\n    ? createPersistPluginController({\n        ...resolvedOptions.persistOptions,                                      /* 透传持久化选项 */\n        debug: resolvedOptions.debug || resolvedOptions.persistOptions.debug,   /* 调试模式 */\n      })\n    : null\n\n  /* 注册注册表插件（自动注册新创建的 Store） */\n  pinia.use(createStoreRegistryPlugin(registry))\n  /* 如果有持久化插件，也注册到 Pinia */\n  persistController && pinia.use(persistController.plugin)\n  /* 批量注册 Pinia 中已有的 Store */\n  registry.registerExistingStores(pinia)\n\n  /* 组装运行时对象 */\n  const runtime: StoreRuntime = {\n    pinia,                                                     /* Pinia 实例 */\n    registry,                                                  /* Store 注册表 */\n    storeAPI: registry.createStoreAPI(pinia),                  /* 全局 Store API */\n    options: resolvedOptions,                                  /* 解析后的选项 */\n\n    /**\n     * 清理函数\n     * 释放所有资源：清除运行时标记、持久化插件、注册表\n     */\n    dispose: () => {\n      /* 清除 Pinia 上的运行时标记 */\n      if (pinia[STORE_RUNTIME_KEY] === runtime) {\n        delete pinia[STORE_RUNTIME_KEY]\n      }\n\n      /* 销毁持久化插件（取消订阅、移除事件监听等） */\n      persistController?.dispose()\n      /* 清空注册表 */\n      registry.clear()\n\n      /* 如果当前是全局运行时，也清除全局引用 */\n      if (globalStoreRuntime === runtime) {\n        setGlobalStoreRuntime(null)\n      }\n    },\n  }\n\n  /* 在 Pinia 实例上保存运行时引用（防止重复创建） */\n  pinia[STORE_RUNTIME_KEY] = runtime\n  return runtime\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkCA,MAAM,oBAAoB,uBAAO,uBAAuB;AA0BxD,IAAI,qBAA0C;AAMvC,SAAS,oBAA2C;CACzD,OAAO,oBAAoB,YAAY;AACzC;AAOO,SAAS,sBAAsB,SAAoC;CACxE,qBAAqB;CAErB,uBAAA,uBAAuB,SAAS,YAAY,IAAI;AAClD;AAeO,SAAS,mBACd,UAA+B,CAAC,GAClB;CAEd,MAAM,kBAAkB,6BAAA,6BAA6B,OAAO;CAE5D,MAAM,UAAS,gBAAgB,UAAA,GAAA,MAAA,YAAA,CAAqB;CAGpD,IAAI,QAAM,oBACR,OAAO,QAAM;CAIf,MAAM,WAAW,uBAAA,oBAAoB;CAGrC,MAAM,oBAAoB,gBAAgB,UACtC,qBAAA,8BAA8B;EAC5B,GAAG,gBAAgB;EACnB,OAAO,gBAAgB,SAAS,gBAAgB,eAAe;CACjE,CAAC,IACD;CAGJ,QAAM,IAAI,uBAAA,0BAA0B,QAAQ,CAAC;CAE7C,qBAAqB,QAAM,IAAI,kBAAkB,MAAM;CAEvD,SAAS,uBAAuB,OAAK;CAGrC,MAAM,UAAwB;EAC5B,OAAA;EACA;EACA,UAAU,SAAS,eAAe,OAAK;EACvC,SAAS;;;;;EAMT,eAAe;GAEb,IAAI,QAAM,uBAAuB,SAC/B,OAAO,QAAM;GAIf,mBAAmB,QAAQ;GAE3B,SAAS,MAAM;GAGf,IAAI,uBAAuB,SACzB,sBAAsB,IAAI;EAE9B;CACF;CAGA,QAAM,qBAAqB;CAC3B,OAAO;AACT"}

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

@@ -0,0 +1,46 @@
+import type { Pinia } from 'pinia';
+import type { GlobalStoreAPI } from '../types';
+import type { ResolvedStoreRuntimeOptions, /* 解析后的运行时选项 */ StoreRuntimeOptions } from './store-plugin-options';
+import type { StoreRegistry } from './store-registry';
+/**
+ * Store 运行时接口
+ * 封装了 Pinia、注册表、API 和生命周期管理
+ * @property pinia - Pinia 实例
+ * @property registry - Store 注册表
+ * @property storeAPI - 全局 Store API
+ * @property options - 解析后的运行时选项
+ * @property dispose - 清理函数，释放所有资源
+ */
+export interface StoreRuntime {
+    pinia: Pinia;
+    registry: StoreRegistry;
+    storeAPI: GlobalStoreAPI;
+    options: ResolvedStoreRuntimeOptions;
+    dispose: () => void;
+}
+/**
+ * 获取全局 Store API
+ * @returns 全局 Store API 或 null（运行时未初始化时）
+ */
+export declare function getGlobalStoreAPI(): GlobalStoreAPI | null;
+/**
+ * 设置全局运行时
+ * 同步更新全局注册表引用
+ * @param runtime - 新的运行时实例或 null
+ */
+export declare function setGlobalStoreRuntime(runtime: StoreRuntime | null): void;
+/**
+ * 创建 Store 运行时实例
+ * 这是 Store 系统的核心工厂函数，负责：
+ * 1. 规范化配置选项
+ * 2. 创建或复用 Pinia 实例
+ * 3. 创建 Store 注册表
+ * 4. 配置持久化插件
+ * 5. 注册 Pinia 插件
+ * 6. 组装运行时对象
+ *
+ * @param options - 运行时配置选项
+ * @returns StoreRuntime 实例
+ */
+export declare function createStoreRuntime(options?: StoreRuntimeOptions): StoreRuntime;
+//# sourceMappingURL=store-runtime.d.ts.map

package/lib/types.cjs

@@ -0,0 +1,12 @@
+/*!
+* ***********************************
+* @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" });
+/*! End of @composy/store-vue | Powered by @composy/builder */

package/lib/types.d.ts

@@ -0,0 +1,167 @@
+import type { Pinia } from 'pinia';
+import type { Ref } from 'vue';
+/**
+ * Store 基础配置选项
+ * @property persist - 持久化配置，true 使用默认配置，或传入 PersistOptions 对象
+ * @property devtools - 是否启用 Vue DevTools 支持
+ * @property strict - 是否启用严格模式（如 Pinia 的 $patch 严格检查）
+ */
+export interface StoreOptions {
+    persist?: boolean | PersistOptions;
+    devtools?: boolean;
+    strict?: boolean;
+}
+/**
+ * 持久化配置选项
+ * 控制 Pinia Store 状态如何被保存到浏览器存储
+ * @property key - 自定义存储键名（默认使用 store.$id）
+ * @property storage - 存储类型：'localStorage' 或 'sessionStorage'
+ * @property paths - 只持久化指定路径的状态（白名单模式）
+ * @property excludePaths - 排除指定路径不持久化（黑名单模式）
+ * @property debounce - 防抖延迟（毫秒），避免频繁写入
+ * @property syncTabs - 是否跨标签页同步状态
+ * @property ttl - 存活时间（毫秒），过期后自动清除
+ * @property serializer - 自定义序列化/反序列化函数
+ * @property beforeRestore - 恢复前钩子
+ * @property afterRestore - 恢复后钩子
+ */
+export interface PersistOptions {
+    key?: string;
+    storage?: 'localStorage' | 'sessionStorage';
+    paths?: string[];
+    excludePaths?: string[];
+    debounce?: number;
+    syncTabs?: boolean;
+    ttl?: number;
+    serializer?: {
+        serialize: (value: unknown) => string;
+        deserialize: (value: string) => unknown;
+    };
+    beforeRestore?: (context: {
+        store: unknown;
+    }) => void;
+    afterRestore?: (context: {
+        store: unknown;
+    }) => void;
+}
+/**
+ * Store Engine 插件配置选项
+ * 控制 Store 引擎插件的行为
+ * @property name - 插件名称
+ * @property version - 插件版本
+ * @property dependencies - 依赖的其他插件列表
+ * @property persist - 是否启用持久化
+ * @property persistOptions - 持久化配置选项
+ * @property devtools - 是否启用 DevTools
+ * @property debug - 是否开启调试日志
+ * @property globalProperties - 是否挂载到 app.config.globalProperties
+ * @property provide - 是否通过 Vue provide/inject 注入
+ * @property pinia - 外部传入的 Pinia 实例（可选，不传则自动创建）
+ */
+export interface StoreEnginePluginOptions {
+    name?: string;
+    version?: string;
+    dependencies?: string[];
+    persist?: boolean;
+    persistOptions?: PersistOptions;
+    devtools?: boolean;
+    debug?: boolean;
+    globalProperties?: boolean;
+    provide?: boolean;
+    pinia?: Pinia;
+}
+/**
+ * useStore 返回值接口
+ * 提供响应式状态和常用操作方法
+ * @property state - 响应式状态引用
+ * @property reset - 重置状态到初始值
+ * @property patch - 部分更新状态（支持对象或函数）
+ * @property store - 底层 Pinia Store 实例
+ */
+export interface UseStoreReturn<S = unknown> {
+    state: Ref<S>;
+    reset: () => void;
+    patch: (partial: Partial<S> | ((state: S) => void)) => void;
+    store: unknown;
+}
+/**
+ * usePersist 配置选项
+ * 简化版的持久化选项，用于 composable 场景
+ * @property key - 存储键名
+ * @property storage - 存储类型
+ * @property defaultValue - 默认值
+ * @property serialize - 自定义序列化函数
+ * @property deserialize - 自定义反序列化函数
+ */
+export interface UsePersistOptions {
+    key: string;
+    storage?: 'localStorage' | 'sessionStorage';
+    defaultValue?: unknown;
+    serialize?: (value: unknown) => string;
+    deserialize?: (value: string) => unknown;
+}
+/**
+ * usePersist 返回值接口
+ * @property value - 持久化的响应式引用
+ * @property save - 手动保存
+ * @property restore - 从存储恢复
+ * @property clear - 清除存储
+ */
+export interface UsePersistReturn<T> {
+    value: Ref<T>;
+    save: () => void;
+    restore: () => void;
+    clear: () => void;
+}
+/**
+ * 订阅选项接口
+ * 控制 Store 订阅行为
+ * @property immediate - 是否立即触发一次回调
+ * @property deep - 是否深度监听
+ * @property detached - 是否脱离当前组件生命周期（组件卸载后继续监听）
+ */
+export interface SubscribeOptions {
+    immediate?: boolean;
+    deep?: boolean;
+    detached?: boolean;
+}
+/**
+ * 变更信息接口
+ * 描述 Store 状态变更的详细信息
+ * @property type - 变更类型：'direct'（直接赋值）、'patch object'（对象补丁）、'patch function'（函数补丁）
+ * @property storeId - Store ID
+ * @property events - 触发的事件列表
+ * @property oldState - 变更前的状态（部分）
+ */
+export interface MutationInfo<S = unknown> {
+    type: 'direct' | 'patch object' | 'patch function';
+    storeId: string;
+    events?: string[];
+    oldState?: Partial<S>;
+}
+/**
+ * Store Provider 组件 Props
+ * @property pinia - Pinia 实例
+ * @property children - 子组件（React 风格，Vue 中较少使用）
+ */
+export interface StoreProviderProps {
+    pinia?: Pinia;
+    children?: unknown;
+}
+/**
+ * 全局 Store API 接口
+ * 提供只读的 Store 查询和管理能力
+ * @property pinia - Pinia 实例引用
+ * @property getStore - 获取指定 ID 的 Store
+ * @property hasStore - 检查 Store 是否存在
+ * @property getStoreIds - 获取所有已注册的 Store ID
+ * @property resetAll - 重置所有 Store 到初始状态
+ */
+export interface GlobalStoreAPI {
+    pinia: Pinia;
+    getStore: <T>(id: string) => T | undefined;
+    hasStore: (id: string) => boolean;
+    getStoreIds: () => string[];
+    resetAll: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@composy/store-vue",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "Vue 3 状态管理适配器 - 基于 Pinia 的增强版状态管理解决方案",
+  "author": "ldesign",
+  "license": "MIT",
+  "keywords": [
+    "vue3",
+    "pinia",
+    "state-management",
+    "store",
+    "typescript",
+    "composables",
+    "reactive"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./es/index.d.ts",
+      "import": "./es/index.js",
+      "require": "./lib/index.cjs",
+      "default": "./es/index.js"
+    },
+    "./composables": {
+      "types": "./es/composables/index.d.ts",
+      "import": "./es/composables/index.js",
+      "require": "./lib/composables/index.cjs",
+      "default": "./es/composables/index.js"
+    },
+    "./composables/*": {
+      "types": "./es/composables/*.d.ts",
+      "import": "./es/composables/*.js",
+      "require": "./lib/composables/*.cjs",
+      "default": "./es/composables/*.js"
+    },
+    "./context/*": {
+      "types": "./es/context/*.d.ts",
+      "import": "./es/context/*.js",
+      "require": "./lib/context/*.cjs",
+      "default": "./es/context/*.js"
+    },
+    "./plugins": {
+      "types": "./es/plugins/index.d.ts",
+      "import": "./es/plugins/index.js",
+      "require": "./lib/plugins/index.cjs",
+      "default": "./es/plugins/index.js"
+    },
+    "./plugins/*": {
+      "types": "./es/plugins/*.d.ts",
+      "import": "./es/plugins/*.js",
+      "require": "./lib/plugins/*.cjs",
+      "default": "./es/plugins/*.js"
+    },
+    "./runtime/*": {
+      "types": "./es/runtime/*.d.ts",
+      "import": "./es/runtime/*.js",
+      "require": "./lib/runtime/*.cjs",
+      "default": "./es/runtime/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./lib/index.cjs",
+  "module": "./es/index.js",
+  "unpkg": "./dist/index.min.js",
+  "jsdelivr": "./dist/index.min.js",
+  "types": "./es/index.d.ts",
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "dist",
+    "es",
+    "esm",
+    "lib"
+  ],
+  "scripts": {
+    "build": "ldesign-builder build",
+    "build:watch": "ldesign-builder build --watch",
+    "clean": "rimraf es esm lib dist",
+    "dev": "ldesign-builder build --watch",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "test": "ltesting run:unit",
+    "test:run": "ltesting run:unit",
+    "type-check": "vue-tsc -p tsconfig.typecheck.json --noEmit",
+    "test:watch": "ltesting run:unit --watch",
+    "test:coverage": "ltesting run:unit --coverage",
+    "test:changed": "ltesting run:unit --changed",
+    "test:failed": "ltesting run:unit --failed",
+    "test:ui": "ltesting dashboard"
+  },
+  "peerDependencies": {
+    "pinia": "^2.1.0",
+    "vue": "^3.5.32"
+  },
+  "dependencies": {
+    "@composy/store-core": "^0.0.1",
+    "pinia": "^3.0.4"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "9.1.0",
+    "@composy/builder": "^0.0.1",
+    "@composy/testing": "^0.0.1",
+    "@types/node": "26.1.1",
+    "@vue/test-utils": "^2.4.11",
+    "eslint": "10.7.0",
+    "typescript": "5.9.3",
+    "vue": "3.5.39",
+    "vue-tsc": "^3.3.7"
+  },
+  "typings": "./es/index.d.ts",
+  "browser": "./dist/index.js"
+}