@composy/store-vue 0.0.1

package/esm/composables/useStoreSnapshot.d.ts

@@ -0,0 +1,122 @@
+/**
+ * useStoreSnapshot - Store 状态快照工具
+ *
+ * 提供状态快照、历史记录和调试功能
+ * @module composables/useStoreSnapshot
+ */
+import type { ComputedRef, Ref } from 'vue';
+/**
+ * 状态快照
+ */
+export interface StateSnapshot<S = unknown> {
+    /** 快照 ID */
+    id: string;
+    /** 状态数据 */
+    state: S;
+    /** 时间戳 */
+    timestamp: number;
+    /** 快照标签 */
+    label?: string;
+    /** 元数据 */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 状态差异
+ */
+export interface StateDiff {
+    /** 差异路径 */
+    path: string;
+    /** 旧值 */
+    oldValue: unknown;
+    /** 新值 */
+    newValue: unknown;
+    /** 差异类型 */
+    type: 'add' | 'remove' | 'change';
+}
+/**
+ * useStoreSnapshot 选项
+ */
+export interface UseStoreSnapshotOptions {
+    /** 最大快照数量 */
+    maxSnapshots?: number;
+    /** 是否自动记录 */
+    autoRecord?: boolean;
+    /** 自动记录防抖延迟（毫秒） */
+    debounceMs?: number;
+    /** 是否深度监听 */
+    deep?: boolean;
+}
+/**
+ * useStoreSnapshot 返回值
+ */
+export interface UseStoreSnapshotReturn<S> {
+    /** 快照列表 */
+    snapshots: Ref<Array<StateSnapshot<S>>>;
+    /** 当前快照索引 */
+    currentIndex: Ref<number>;
+    /** 是否可以撤销 */
+    canUndo: ComputedRef<boolean>;
+    /** 是否可以重做 */
+    canRedo: ComputedRef<boolean>;
+    /** 创建快照 */
+    takeSnapshot: (label?: string, meta?: Record<string, unknown>) => StateSnapshot<S>;
+    /** 恢复快照 */
+    restoreSnapshot: (id: string) => boolean;
+    /** 撤销 */
+    undo: () => boolean;
+    /** 重做 */
+    redo: () => boolean;
+    /** 跳转到指定快照 */
+    goto: (index: number) => boolean;
+    /** 清空快照 */
+    clearSnapshots: () => void;
+    /** 获取状态差异 */
+    getDiff: (snapshotId1: string, snapshotId2: string) => StateDiff[];
+    /** 导出快照 */
+    exportSnapshots: () => string;
+    /** 导入快照 */
+    importSnapshots: (data: string) => boolean;
+}
+/**
+ * Store 状态快照 Hook
+ *
+ * 提供状态快照、撤销/重做和调试功能
+ *
+ * @template S - 状态类型
+ * @param state - 响应式状态
+ * @param setState - 状态设置函数
+ * @param options - 配置选项
+ * @returns 快照操作对象
+ *
+ * @example
+ * ```typescript
+ * const store = useCounterStore()
+ *
+ * const {
+ *   snapshots,
+ *   canUndo,
+ *   canRedo,
+ *   takeSnapshot,
+ *   undo,
+ *   redo,
+ *   getDiff
+ * } = useStoreSnapshot(
+ *   () => store.$state,
+ *   (state) => store.$patch(state),
+ *   { maxSnapshots: 50, autoRecord: true }
+ * )
+ *
+ * // 手动创建快照
+ * takeSnapshot('保存点 1')
+ *
+ * // 撤销操作
+ * if (canUndo.value) {
+ *   undo()
+ * }
+ *
+ * // 获取状态差异
+ * const diff = getDiff(snapshots.value[0].id, snapshots.value[1].id)
+ * ```
+ */
+export declare function useStoreSnapshot<S>(state: Ref<S> | (() => S), setState: (state: S) => void, options?: UseStoreSnapshotOptions): UseStoreSnapshotReturn<S>;
+//# sourceMappingURL=useStoreSnapshot.d.ts.map

package/esm/composables/useStoreSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreSnapshot.d.ts","sourceRoot":"","sources":["../../src/composables/useStoreSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAE,GAAG,EAAC,MAAM,KAAK,CAAC;AAI1C;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,YAAY;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,WAAW;IACX,KAAK,EAAE,CAAC,CAAA;IACR,UAAU;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU;IACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS;IACT,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS;IACT,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW;IACX,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,aAAa;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,WAAW;IACX,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,aAAa;IACb,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACzB,aAAa;IACb,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC7B,aAAa;IACb,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IAC7B,WAAW;IACX,YAAY,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAAA;IAClF,WAAW;IACX,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IACxC,SAAS;IACT,IAAI,EAAE,MAAM,OAAO,CAAA;IACnB,SAAS;IACT,IAAI,EAAE,MAAM,OAAO,CAAA;IACnB,cAAc;IACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IAChC,WAAW;IACX,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,aAAa;IACb,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,SAAS,EAAE,CAAA;IAClE,WAAW;IACX,eAAe,EAAE,MAAM,MAAM,CAAA;IAC7B,WAAW;IACX,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAC3C;AAmHD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC5B,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAAC,CAAC,CAAC,CAuO3B"}

package/esm/composables/useStoreSnapshot.js

@@ -0,0 +1,209 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { computed, onUnmounted, ref, watch } from "vue";
+import { deepClone, deepEqual } from "@composy/store-core";
+//#region src/composables/useStoreSnapshot.ts
+function generateId() {
+	return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+function computeDiff(oldObj, newObj, path = "") {
+	const diffs = [];
+	if (typeof oldObj !== typeof newObj) {
+		diffs.push({
+			path: path || ".",
+			oldValue: oldObj,
+			newValue: newObj,
+			type: "change"
+		});
+		return diffs;
+	}
+	if (typeof oldObj !== "object" || oldObj === null || newObj === null) {
+		if (!Object.is(oldObj, newObj)) diffs.push({
+			path: path || ".",
+			oldValue: oldObj,
+			newValue: newObj,
+			type: "change"
+		});
+		return diffs;
+	}
+	if (Array.isArray(oldObj) && Array.isArray(newObj)) {
+		const maxLen = Math.max(oldObj.length, newObj.length);
+		for (let i = 0; i < maxLen; i++) {
+			const itemPath = path ? `${path}[${i}]` : `[${i}]`;
+			if (i >= oldObj.length) diffs.push({
+				path: itemPath,
+				oldValue: void 0,
+				newValue: newObj[i],
+				type: "add"
+			});
+			else if (i >= newObj.length) diffs.push({
+				path: itemPath,
+				oldValue: oldObj[i],
+				newValue: void 0,
+				type: "remove"
+			});
+			else diffs.push(...computeDiff(oldObj[i], newObj[i], itemPath));
+		}
+		return diffs;
+	}
+	const oldKeys = new Set(Object.keys(oldObj));
+	const newKeys = new Set(Object.keys(newObj));
+	for (const key of newKeys) if (!oldKeys.has(key)) diffs.push({
+		path: path ? `${path}.${key}` : key,
+		oldValue: void 0,
+		newValue: newObj[key],
+		type: "add"
+	});
+	for (const key of oldKeys) if (!newKeys.has(key)) diffs.push({
+		path: path ? `${path}.${key}` : key,
+		oldValue: oldObj[key],
+		newValue: void 0,
+		type: "remove"
+	});
+	for (const key of oldKeys) if (newKeys.has(key)) diffs.push(...computeDiff(oldObj[key], newObj[key], path ? `${path}.${key}` : key));
+	return diffs;
+}
+function useStoreSnapshot(state, setState, options = {}) {
+	const { maxSnapshots = 100, autoRecord = false, debounceMs = 300, deep = true } = options;
+	const snapshots = ref([]);
+	const currentIndex = ref(-1);
+	let debounceTimer;
+	let isRestoring = false;
+	const getState = () => {
+		return typeof state === "function" ? state() : state.value;
+	};
+	const canUndo = computed(() => currentIndex.value > 0);
+	const canRedo = computed(() => currentIndex.value < snapshots.value.length - 1);
+	const takeSnapshot = (label, meta) => {
+		const currentState = getState();
+		const snapshot = {
+			id: generateId(),
+			state: deepClone(currentState),
+			timestamp: Date.now(),
+			label,
+			meta
+		};
+		if (currentIndex.value < snapshots.value.length - 1) snapshots.value = snapshots.value.slice(0, currentIndex.value + 1);
+		snapshots.value.push(snapshot);
+		currentIndex.value = snapshots.value.length - 1;
+		if (snapshots.value.length > maxSnapshots) {
+			snapshots.value.shift();
+			currentIndex.value--;
+		}
+		return snapshot;
+	};
+	const restoreSnapshot = (id) => {
+		const index = snapshots.value.findIndex((s) => s.id === id);
+		if (index === -1) return false;
+		isRestoring = true;
+		try {
+			setState(deepClone(snapshots.value[index].state));
+			currentIndex.value = index;
+			return true;
+		} finally {
+			isRestoring = false;
+		}
+	};
+	const undo = () => {
+		if (!canUndo.value) return false;
+		currentIndex.value--;
+		isRestoring = true;
+		try {
+			setState(deepClone(snapshots.value[currentIndex.value].state));
+			return true;
+		} finally {
+			isRestoring = false;
+		}
+	};
+	const redo = () => {
+		if (!canRedo.value) return false;
+		currentIndex.value++;
+		isRestoring = true;
+		try {
+			setState(deepClone(snapshots.value[currentIndex.value].state));
+			return true;
+		} finally {
+			isRestoring = false;
+		}
+	};
+	const goto = (index) => {
+		if (index < 0 || index >= snapshots.value.length) return false;
+		currentIndex.value = index;
+		isRestoring = true;
+		try {
+			setState(deepClone(snapshots.value[index].state));
+			return true;
+		} finally {
+			isRestoring = false;
+		}
+	};
+	const clearSnapshots = () => {
+		snapshots.value = [];
+		currentIndex.value = -1;
+	};
+	const getDiff = (snapshotId1, snapshotId2) => {
+		const snapshot1 = snapshots.value.find((s) => s.id === snapshotId1);
+		const snapshot2 = snapshots.value.find((s) => s.id === snapshotId2);
+		if (!snapshot1 || !snapshot2) return [];
+		return computeDiff(snapshot1.state, snapshot2.state);
+	};
+	const exportSnapshots = () => {
+		return JSON.stringify({
+			snapshots: snapshots.value,
+			currentIndex: currentIndex.value,
+			exportedAt: Date.now()
+		});
+	};
+	const importSnapshots = (data) => {
+		try {
+			const parsed = JSON.parse(data);
+			if (!Array.isArray(parsed.snapshots)) return false;
+			snapshots.value = parsed.snapshots;
+			currentIndex.value = Math.min(parsed.currentIndex ?? snapshots.value.length - 1, snapshots.value.length - 1);
+			return true;
+		} catch {
+			return false;
+		}
+	};
+	if (autoRecord) {
+		const stopWatch = watch(typeof state === "function" ? computed(state) : state, (newState, oldState) => {
+			if (isRestoring) return;
+			if (deepEqual(newState, oldState)) return;
+			if (debounceTimer) clearTimeout(debounceTimer);
+			debounceTimer = setTimeout(() => {
+				takeSnapshot();
+			}, debounceMs);
+		}, { deep });
+		takeSnapshot("初始状态");
+		onUnmounted(() => {
+			stopWatch();
+			if (debounceTimer) clearTimeout(debounceTimer);
+		});
+	}
+	return {
+		snapshots,
+		currentIndex,
+		canUndo,
+		canRedo,
+		takeSnapshot,
+		restoreSnapshot,
+		undo,
+		redo,
+		goto,
+		clearSnapshots,
+		getDiff,
+		exportSnapshots,
+		importSnapshots
+	};
+}
+//#endregion
+export { useStoreSnapshot };
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=useStoreSnapshot.js.map

package/esm/composables/useStoreSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreSnapshot.js","names":[],"sources":["../../src/composables/useStoreSnapshot.ts"],"sourcesContent":["/**\n * useStoreSnapshot - Store 状态快照工具\n *\n * 提供状态快照、历史记录和调试功能\n * @module composables/useStoreSnapshot\n */\n\nimport type {ComputedRef, Ref} from 'vue';\nimport { deepClone, deepEqual } from '@composy/store-core'\nimport { computed,  onUnmounted, ref,  watch } from 'vue'\n\n/**\n * 状态快照\n */\nexport interface StateSnapshot<S = unknown> {\n  /** 快照 ID */\n  id: string\n  /** 状态数据 */\n  state: S\n  /** 时间戳 */\n  timestamp: number\n  /** 快照标签 */\n  label?: string\n  /** 元数据 */\n  meta?: Record<string, unknown>\n}\n\n/**\n * 状态差异\n */\nexport interface StateDiff {\n  /** 差异路径 */\n  path: string\n  /** 旧值 */\n  oldValue: unknown\n  /** 新值 */\n  newValue: unknown\n  /** 差异类型 */\n  type: 'add' | 'remove' | 'change'\n}\n\n/**\n * useStoreSnapshot 选项\n */\nexport interface UseStoreSnapshotOptions {\n  /** 最大快照数量 */\n  maxSnapshots?: number\n  /** 是否自动记录 */\n  autoRecord?: boolean\n  /** 自动记录防抖延迟（毫秒） */\n  debounceMs?: number\n  /** 是否深度监听 */\n  deep?: boolean\n}\n\n/**\n * useStoreSnapshot 返回值\n */\nexport interface UseStoreSnapshotReturn<S> {\n  /** 快照列表 */\n  snapshots: Ref<Array<StateSnapshot<S>>>\n  /** 当前快照索引 */\n  currentIndex: Ref<number>\n  /** 是否可以撤销 */\n  canUndo: ComputedRef<boolean>\n  /** 是否可以重做 */\n  canRedo: ComputedRef<boolean>\n  /** 创建快照 */\n  takeSnapshot: (label?: string, meta?: Record<string, unknown>) => StateSnapshot<S>\n  /** 恢复快照 */\n  restoreSnapshot: (id: string) => boolean\n  /** 撤销 */\n  undo: () => boolean\n  /** 重做 */\n  redo: () => boolean\n  /** 跳转到指定快照 */\n  goto: (index: number) => boolean\n  /** 清空快照 */\n  clearSnapshots: () => void\n  /** 获取状态差异 */\n  getDiff: (snapshotId1: string, snapshotId2: string) => StateDiff[]\n  /** 导出快照 */\n  exportSnapshots: () => string\n  /** 导入快照 */\n  importSnapshots: (data: string) => boolean\n}\n\n/**\n * 生成唯一 ID\n */\nfunction generateId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`\n}\n\n/**\n * 计算两个对象的差异\n */\nfunction computeDiff(\n  oldObj: unknown,\n  newObj: unknown,\n  path = '',\n): StateDiff[] {\n  const diffs: StateDiff[] = []\n\n  // 类型不同\n  if (typeof oldObj !== typeof newObj) {\n    diffs.push({\n      path: path || '.',\n      oldValue: oldObj,\n      newValue: newObj,\n      type: 'change',\n    })\n    return diffs\n  }\n\n  // 基础类型比较\n  if (typeof oldObj !== 'object' || oldObj === null || newObj === null) {\n    if (!Object.is(oldObj, newObj)) {\n      diffs.push({\n        path: path || '.',\n        oldValue: oldObj,\n        newValue: newObj,\n        type: 'change',\n      })\n    }\n    return diffs\n  }\n\n  // 数组比较\n  if (Array.isArray(oldObj) && Array.isArray(newObj)) {\n    const maxLen = Math.max(oldObj.length, newObj.length)\n    for (let i = 0; i < maxLen; i++) {\n      const itemPath = path ? `${path}[${i}]` : `[${i}]`\n      if (i >= oldObj.length) {\n        diffs.push({\n          path: itemPath,\n          oldValue: undefined,\n          newValue: newObj[i],\n          type: 'add',\n        })\n      }\n      else if (i >= newObj.length) {\n        diffs.push({\n          path: itemPath,\n          oldValue: oldObj[i],\n          newValue: undefined,\n          type: 'remove',\n        })\n      }\n      else {\n        diffs.push(...computeDiff(oldObj[i], newObj[i], itemPath))\n      }\n    }\n    return diffs\n  }\n\n  // 对象比较\n  const oldKeys = new Set(Object.keys(oldObj as Record<string, unknown>))\n  const newKeys = new Set(Object.keys(newObj as Record<string, unknown>))\n\n  // 检查新增的键\n  for (const key of newKeys) {\n    if (!oldKeys.has(key)) {\n      diffs.push({\n        path: path ? `${path}.${key}` : key,\n        oldValue: undefined,\n        newValue: (newObj as Record<string, unknown>)[key],\n        type: 'add',\n      })\n    }\n  }\n\n  // 检查删除的键\n  for (const key of oldKeys) {\n    if (!newKeys.has(key)) {\n      diffs.push({\n        path: path ? `${path}.${key}` : key,\n        oldValue: (oldObj as Record<string, unknown>)[key],\n        newValue: undefined,\n        type: 'remove',\n      })\n    }\n  }\n\n  // 检查修改的键\n  for (const key of oldKeys) {\n    if (newKeys.has(key)) {\n      diffs.push(\n        ...computeDiff(\n          (oldObj as Record<string, unknown>)[key],\n          (newObj as Record<string, unknown>)[key],\n          path ? `${path}.${key}` : key,\n        ),\n      )\n    }\n  }\n\n  return diffs\n}\n\n/**\n * Store 状态快照 Hook\n *\n * 提供状态快照、撤销/重做和调试功能\n *\n * @template S - 状态类型\n * @param state - 响应式状态\n * @param setState - 状态设置函数\n * @param options - 配置选项\n * @returns 快照操作对象\n *\n * @example\n * ```typescript\n * const store = useCounterStore()\n *\n * const {\n *   snapshots,\n *   canUndo,\n *   canRedo,\n *   takeSnapshot,\n *   undo,\n *   redo,\n *   getDiff\n * } = useStoreSnapshot(\n *   () => store.$state,\n *   (state) => store.$patch(state),\n *   { maxSnapshots: 50, autoRecord: true }\n * )\n *\n * // 手动创建快照\n * takeSnapshot('保存点 1')\n *\n * // 撤销操作\n * if (canUndo.value) {\n *   undo()\n * }\n *\n * // 获取状态差异\n * const diff = getDiff(snapshots.value[0].id, snapshots.value[1].id)\n * ```\n */\nexport function useStoreSnapshot<S>(\n  state: Ref<S> | (() => S),\n  setState: (state: S) => void,\n  options: UseStoreSnapshotOptions = {},\n): UseStoreSnapshotReturn<S> {\n  const {\n    maxSnapshots = 100,\n    autoRecord = false,\n    debounceMs = 300,\n    deep = true,\n  } = options\n\n  const snapshots = ref<Array<StateSnapshot<S>>>([]) as Ref<Array<StateSnapshot<S>>>\n  const currentIndex = ref(-1)\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n  let isRestoring = false\n\n  // 获取当前状态\n  const getState = (): S => {\n    return typeof state === 'function' ? state() : state.value\n  }\n\n  // 是否可以撤销\n  const canUndo = computed(() => currentIndex.value > 0)\n\n  // 是否可以重做\n  const canRedo = computed(() => currentIndex.value < snapshots.value.length - 1)\n\n  /**\n   * 创建快照\n   */\n  const takeSnapshot = (label?: string, meta?: Record<string, unknown>): StateSnapshot<S> => {\n    const currentState = getState()\n    const snapshot: StateSnapshot<S> = {\n      id: generateId(),\n      state: deepClone(currentState),\n      timestamp: Date.now(),\n      label,\n      meta,\n    }\n\n    // 如果当前不在最新位置，删除后面的快照\n    if (currentIndex.value < snapshots.value.length - 1) {\n      snapshots.value = snapshots.value.slice(0, currentIndex.value + 1)\n    }\n\n    // 添加新快照\n    snapshots.value.push(snapshot)\n    currentIndex.value = snapshots.value.length - 1\n\n    // 限制快照数量\n    if (snapshots.value.length > maxSnapshots) {\n      snapshots.value.shift()\n      currentIndex.value--\n    }\n\n    return snapshot\n  }\n\n  /**\n   * 恢复快照\n   */\n  const restoreSnapshot = (id: string): boolean => {\n    const index = snapshots.value.findIndex(s => s.id === id)\n    if (index === -1) return false\n\n    isRestoring = true\n    try {\n      setState(deepClone(snapshots.value[index].state))\n      currentIndex.value = index\n      return true\n    }\n    finally {\n      isRestoring = false\n    }\n  }\n\n  /**\n   * 撤销\n   */\n  const undo = (): boolean => {\n    if (!canUndo.value) return false\n\n    currentIndex.value--\n    isRestoring = true\n    try {\n      setState(deepClone(snapshots.value[currentIndex.value].state))\n      return true\n    }\n    finally {\n      isRestoring = false\n    }\n  }\n\n  /**\n   * 重做\n   */\n  const redo = (): boolean => {\n    if (!canRedo.value) return false\n\n    currentIndex.value++\n    isRestoring = true\n    try {\n      setState(deepClone(snapshots.value[currentIndex.value].state))\n      return true\n    }\n    finally {\n      isRestoring = false\n    }\n  }\n\n  /**\n   * 跳转到指定快照\n   */\n  const goto = (index: number): boolean => {\n    if (index < 0 || index >= snapshots.value.length) return false\n\n    currentIndex.value = index\n    isRestoring = true\n    try {\n      setState(deepClone(snapshots.value[index].state))\n      return true\n    }\n    finally {\n      isRestoring = false\n    }\n  }\n\n  /**\n   * 清空快照\n   */\n  const clearSnapshots = (): void => {\n    snapshots.value = []\n    currentIndex.value = -1\n  }\n\n  /**\n   * 获取状态差异\n   */\n  const getDiff = (snapshotId1: string, snapshotId2: string): StateDiff[] => {\n    const snapshot1 = snapshots.value.find(s => s.id === snapshotId1)\n    const snapshot2 = snapshots.value.find(s => s.id === snapshotId2)\n\n    if (!snapshot1 || !snapshot2) return []\n\n    return computeDiff(snapshot1.state, snapshot2.state)\n  }\n\n  /**\n   * 导出快照\n   */\n  const exportSnapshots = (): string => {\n    return JSON.stringify({\n      snapshots: snapshots.value,\n      currentIndex: currentIndex.value,\n      exportedAt: Date.now(),\n    })\n  }\n\n  /**\n   * 导入快照\n   */\n  const importSnapshots = (data: string): boolean => {\n    try {\n      const parsed = JSON.parse(data) as {\n        snapshots: Array<StateSnapshot<S>>\n        currentIndex: number\n      }\n\n      if (!Array.isArray(parsed.snapshots)) return false\n\n      snapshots.value = parsed.snapshots\n      currentIndex.value = Math.min(\n        parsed.currentIndex ?? snapshots.value.length - 1,\n        snapshots.value.length - 1,\n      )\n\n      return true\n    }\n    catch {\n      return false\n    }\n  }\n\n  // 自动记录\n  if (autoRecord) {\n    const stateRef = typeof state === 'function' ? computed(state) : state\n\n    const stopWatch = watch(\n      stateRef,\n      (newState, oldState) => {\n        // 如果是恢复操作，不记录\n        if (isRestoring) return\n\n        // 如果状态未变化，不记录\n        if (deepEqual(newState, oldState)) return\n\n        // 防抖记录\n        if (debounceTimer) {\n          clearTimeout(debounceTimer)\n        }\n\n        debounceTimer = setTimeout(() => {\n          takeSnapshot()\n        }, debounceMs)\n      },\n      { deep },\n    )\n\n    // 初始快照\n    takeSnapshot('初始状态')\n\n    onUnmounted(() => {\n      stopWatch()\n      if (debounceTimer) {\n        clearTimeout(debounceTimer)\n      }\n    })\n  }\n\n  return {\n    snapshots,\n    currentIndex,\n    canUndo,\n    canRedo,\n    takeSnapshot,\n    restoreSnapshot,\n    undo,\n    redo,\n    goto,\n    clearSnapshots,\n    getDiff,\n    exportSnapshots,\n    importSnapshots,\n  }\n}\n\n"],"mappings":";;;;;;;;;;;;AA0FA,SAAS,aAAqB;CAC5B,OAAO,GAAG,KAAK,IAAI,EAAC,GAAI,KAAK,OAAO,CAAA,CAAE,SAAS,EAAE,CAAA,CAAE,OAAO,GAAG,CAAC;AAChE;AAKA,SAAS,YACP,QACA,QACA,OAAO,IACM;CACb,MAAM,QAAqB,CAAC;CAG5B,IAAI,OAAO,WAAW,OAAO,QAAQ;EACnC,MAAM,KAAK;GACT,MAAM,QAAQ;GACd,UAAU;GACV,UAAU;GACV,MAAM;EACR,CAAC;EACD,OAAO;CACT;CAGA,IAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,WAAW,MAAM;EACpE,IAAI,CAAC,OAAO,GAAG,QAAQ,MAAM,GAC3B,MAAM,KAAK;GACT,MAAM,QAAQ;GACd,UAAU;GACV,UAAU;GACV,MAAM;EACR,CAAC;EAEH,OAAO;CACT;CAGA,IAAI,MAAM,QAAQ,MAAM,KAAK,MAAM,QAAQ,MAAM,GAAG;EAClD,MAAM,SAAS,KAAK,IAAI,OAAO,QAAQ,OAAO,MAAM;EACpD,KAAA,IAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;GAC/B,MAAM,WAAW,OAAO,GAAG,KAAI,GAAI,EAAC,KAAM,IAAI,EAAC;GAC/C,IAAI,KAAK,OAAO,QACd,MAAM,KAAK;IACT,MAAM;IACN,UAAU,KAAA;IACV,UAAU,OAAO;IACjB,MAAM;GACR,CAAC;QACH,IACS,KAAK,OAAO,QACnB,MAAM,KAAK;IACT,MAAM;IACN,UAAU,OAAO;IACjB,UAAU,KAAA;IACV,MAAM;GACR,CAAC;QAGD,MAAM,KAAK,GAAG,YAAY,OAAO,IAAI,OAAO,IAAI,QAAQ,CAAC;EAE7D;EACA,OAAO;CACT;CAGA,MAAM,UAAU,IAAI,IAAI,OAAO,KAAK,MAAiC,CAAC;CACtE,MAAM,UAAU,IAAI,IAAI,OAAO,KAAK,MAAiC,CAAC;CAGtE,KAAA,MAAW,OAAO,SAChB,IAAI,CAAC,QAAQ,IAAI,GAAG,GAClB,MAAM,KAAK;EACT,MAAM,OAAO,GAAG,KAAI,GAAI,QAAQ;EAChC,UAAU,KAAA;EACV,UAAW,OAAmC;EAC9C,MAAM;CACR,CAAC;CAKL,KAAA,MAAW,OAAO,SAChB,IAAI,CAAC,QAAQ,IAAI,GAAG,GAClB,MAAM,KAAK;EACT,MAAM,OAAO,GAAG,KAAI,GAAI,QAAQ;EAChC,UAAW,OAAmC;EAC9C,UAAU,KAAA;EACV,MAAM;CACR,CAAC;CAKL,KAAA,MAAW,OAAO,SAChB,IAAI,QAAQ,IAAI,GAAG,GACjB,MAAM,KACJ,GAAG,YACA,OAAmC,MACnC,OAAmC,MACpC,OAAO,GAAG,KAAI,GAAI,QAAQ,GAC5B,CACF;CAIJ,OAAO;AACT;AA2CO,SAAS,iBACd,OACA,UACA,UAAmC,CAAC,GACT;CAC3B,MAAM,EACJ,eAAe,KACf,aAAa,OACb,aAAa,KACb,OAAO,SACL;CAEJ,MAAM,YAAY,IAA6B,CAAC,CAAC;CACjD,MAAM,eAAe,IAAI,EAAE;CAC3B,IAAI;CACJ,IAAI,cAAc;CAGlB,MAAM,iBAAoB;EACxB,OAAO,OAAO,UAAU,aAAa,MAAM,IAAI,MAAM;CACvD;CAGA,MAAM,UAAU,eAAe,aAAa,QAAQ,CAAC;CAGrD,MAAM,UAAU,eAAe,aAAa,QAAQ,UAAU,MAAM,SAAS,CAAC;CAK9E,MAAM,gBAAgB,OAAgB,SAAqD;EACzF,MAAM,eAAe,SAAS;EAC9B,MAAM,WAA6B;GACjC,IAAI,WAAW;GACf,OAAO,UAAU,YAAY;GAC7B,WAAW,KAAK,IAAI;GACpB;GACA;EACF;EAGA,IAAI,aAAa,QAAQ,UAAU,MAAM,SAAS,GAChD,UAAU,QAAQ,UAAU,MAAM,MAAM,GAAG,aAAa,QAAQ,CAAC;EAInE,UAAU,MAAM,KAAK,QAAQ;EAC7B,aAAa,QAAQ,UAAU,MAAM,SAAS;EAG9C,IAAI,UAAU,MAAM,SAAS,cAAc;GACzC,UAAU,MAAM,MAAM;GACtB,aAAa;EACf;EAEA,OAAO;CACT;CAKA,MAAM,mBAAmB,OAAwB;EAC/C,MAAM,QAAQ,UAAU,MAAM,WAAU,MAAK,EAAE,OAAO,EAAE;EACxD,IAAI,UAAU,IAAI,OAAO;EAEzB,cAAc;EACd,IAAI;GACF,SAAS,UAAU,UAAU,MAAM,MAAK,CAAE,KAAK,CAAC;GAChD,aAAa,QAAQ;GACrB,OAAO;EACT,UACA;GACE,cAAc;EAChB;CACF;CAKA,MAAM,aAAsB;EAC1B,IAAI,CAAC,QAAQ,OAAO,OAAO;EAE3B,aAAa;EACb,cAAc;EACd,IAAI;GACF,SAAS,UAAU,UAAU,MAAM,aAAa,MAAK,CAAE,KAAK,CAAC;GAC7D,OAAO;EACT,UACA;GACE,cAAc;EAChB;CACF;CAKA,MAAM,aAAsB;EAC1B,IAAI,CAAC,QAAQ,OAAO,OAAO;EAE3B,aAAa;EACb,cAAc;EACd,IAAI;GACF,SAAS,UAAU,UAAU,MAAM,aAAa,MAAK,CAAE,KAAK,CAAC;GAC7D,OAAO;EACT,UACA;GACE,cAAc;EAChB;CACF;CAKA,MAAM,QAAQ,UAA2B;EACvC,IAAI,QAAQ,KAAK,SAAS,UAAU,MAAM,QAAQ,OAAO;EAEzD,aAAa,QAAQ;EACrB,cAAc;EACd,IAAI;GACF,SAAS,UAAU,UAAU,MAAM,MAAK,CAAE,KAAK,CAAC;GAChD,OAAO;EACT,UACA;GACE,cAAc;EAChB;CACF;CAKA,MAAM,uBAA6B;EACjC,UAAU,QAAQ,CAAC;EACnB,aAAa,QAAQ;CACvB;CAKA,MAAM,WAAW,aAAqB,gBAAqC;EACzE,MAAM,YAAY,UAAU,MAAM,MAAK,MAAK,EAAE,OAAO,WAAW;EAChE,MAAM,YAAY,UAAU,MAAM,MAAK,MAAK,EAAE,OAAO,WAAW;EAEhE,IAAI,CAAC,aAAa,CAAC,WAAW,OAAO,CAAC;EAEtC,OAAO,YAAY,UAAU,OAAO,UAAU,KAAK;CACrD;CAKA,MAAM,wBAAgC;EACpC,OAAO,KAAK,UAAU;GACpB,WAAW,UAAU;GACrB,cAAc,aAAa;GAC3B,YAAY,KAAK,IAAI;EACvB,CAAC;CACH;CAKA,MAAM,mBAAmB,SAA0B;EACjD,IAAI;GACF,MAAM,SAAS,KAAK,MAAM,IAAI;GAK9B,IAAI,CAAC,MAAM,QAAQ,OAAO,SAAS,GAAG,OAAO;GAE7C,UAAU,QAAQ,OAAO;GACzB,aAAa,QAAQ,KAAK,IACxB,OAAO,gBAAgB,UAAU,MAAM,SAAS,GAChD,UAAU,MAAM,SAAS,CAC3B;GAEA,OAAO;EACT,QACM;GACJ,OAAO;EACT;CACF;CAGA,IAAI,YAAY;EAGd,MAAM,YAAY,MAFD,OAAO,UAAU,aAAa,SAAS,KAAK,IAAI,QAI9D,UAAU,aAAa;GAEtB,IAAI,aAAa;GAGjB,IAAI,UAAU,UAAU,QAAQ,GAAG;GAGnC,IAAI,eACF,aAAa,aAAa;GAG5B,gBAAgB,iBAAiB;IAC/B,aAAa;GACf,GAAG,UAAU;EACf,GACA,EAAE,KAAK,CACT;EAGA,aAAa,MAAM;EAEnB,kBAAkB;GAChB,UAAU;GACV,IAAI,eACF,aAAa,aAAa;EAE9B,CAAC;CACH;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/esm/composables/useSubscribe.d.ts

@@ -0,0 +1,90 @@
+/**
+ * useSubscribe Composable
+ *
+ * 提供 Store 订阅功能
+ * @module composables/useSubscribe
+ */
+import type { Ref, WatchStopHandle } from 'vue';
+import type { MutationInfo, SubscribeOptions } from '../types';
+/**
+ * 订阅 Store 状态变化
+ *
+ * @template S - 状态类型
+ * @param store - Pinia Store 实例
+ * @param callback - 回调函数
+ * @param options - 订阅选项
+ * @returns 取消订阅函数
+ *
+ * @example
+ * ```typescript
+ * const store = useCounterStore()
+ *
+ * // 订阅状态变化
+ * const unsubscribe = useSubscribe(store, (mutation, state) => {
+ *   console.log('State changed:', mutation.type, state)
+ * })
+ *
+ * // 取消订阅
+ * unsubscribe()
+ * ```
+ */
+export declare function useSubscribe<S extends Record<string, unknown>>(store: S & {
+    $subscribe?: (callback: (mutation: MutationInfo<S>, state: S) => void, options?: {
+        detached?: boolean;
+    }) => () => void;
+}, callback: (mutation: MutationInfo<S>, state: S) => void, options?: SubscribeOptions): () => void;
+/**
+ * 订阅 Store Action 调用
+ *
+ * @template S - Store 类型
+ * @param store - Pinia Store 实例
+ * @param callback - 回调函数
+ * @returns 取消订阅函数
+ *
+ * @example
+ * ```typescript
+ * const store = useCounterStore()
+ *
+ * // 订阅 Action 调用
+ * useOnAction(store, ({ name, args, after, onError }) => {
+ *   console.log(`Action ${name} called with:`, args)
+ *
+ *   after((result) => {
+ *     console.log(`Action ${name} finished with:`, result)
+ *   })
+ *
+ *   onError((error) => {
+ *     console.error(`Action ${name} failed:`, error)
+ *   })
+ * })
+ * ```
+ */
+export declare function useOnAction<S extends Record<string, unknown>>(store: S & {
+    $onAction?: (callback: (context: ActionContext) => void, detached?: boolean) => () => void;
+}, callback: (context: ActionContext) => void, detached?: boolean): () => void;
+/**
+ * Action 上下文
+ */
+export interface ActionContext {
+    /** Action 名称 */
+    name: string;
+    /** Store 实例 */
+    store: unknown;
+    /** Action 参数 */
+    args: unknown[];
+    /** Action 完成后回调 */
+    after: (callback: (result: unknown) => void) => void;
+    /** Action 错误回调 */
+    onError: (callback: (error: unknown) => void) => void;
+}
+/**
+ * 监听 ref 变化
+ *
+ * @template T - 值类型
+ * @param source - 监听源
+ * @param callback - 回调函数
+ * @param options - 监听选项
+ * @returns 停止监听函数
+ */
+export declare function useWatch<T>(source: Ref<T>, callback: (newValue: T, oldValue: T | undefined) => void, options?: SubscribeOptions): WatchStopHandle;
+//# sourceMappingURL=useSubscribe.d.ts.map

package/esm/composables/useSubscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscribe.d.ts","sourceRoot":"","sources":["../../src/composables/useSubscribe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,KAAK,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAG9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,KAAK,EAAE,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,IAAI,CAAA;CAAE,EACrI,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,EACvD,OAAO,GAAE,gBAAqB,GAC7B,MAAM,IAAI,CAyBZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,KAAK,EAAE,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,MAAM,IAAI,CAAA;CAAE,EACzG,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,EAC1C,QAAQ,UAAQ,GACf,MAAM,IAAI,CAeZ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe;IACf,KAAK,EAAE,OAAO,CAAA;IACd,gBAAgB;IAChB,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,mBAAmB;IACnB,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAA;IACpD,kBAAkB;IAClB,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAA;CACtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACxD,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAkBjB"}

package/esm/composables/useSubscribe.js

@@ -0,0 +1,53 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { onUnmounted, watch } from "vue";
+//#region src/composables/useSubscribe.ts
+function useSubscribe(store, callback, options = {}) {
+	const { detached = false } = options;
+	if (store.$subscribe) {
+		const unsubscribe = store.$subscribe((mutation, state) => {
+			callback(mutation, state);
+		}, { detached });
+		if (!detached) onUnmounted(() => {
+			unsubscribe();
+		});
+		return unsubscribe;
+	}
+	console.warn("[useSubscribe] Store 不支持 $subscribe 方法");
+	return () => {};
+}
+function useOnAction(store, callback, detached = false) {
+	if (store.$onAction) {
+		const unsubscribe = store.$onAction(callback, detached);
+		if (!detached) onUnmounted(() => {
+			unsubscribe();
+		});
+		return unsubscribe;
+	}
+	console.warn("[useOnAction] Store 不支持 $onAction 方法");
+	return () => {};
+}
+function useWatch(source, callback, options = {}) {
+	const { immediate = false, deep = false, detached = false } = options;
+	const stop = watch(source, (newValue, oldValue) => {
+		callback(newValue, oldValue);
+	}, {
+		immediate,
+		deep
+	});
+	if (!detached) onUnmounted(() => {
+		stop();
+	});
+	return stop;
+}
+//#endregion
+export { useOnAction, useSubscribe, useWatch };
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=useSubscribe.js.map

package/esm/composables/useSubscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSubscribe.js","names":[],"sources":["../../src/composables/useSubscribe.ts"],"sourcesContent":["/**\n * useSubscribe Composable\n *\n * 提供 Store 订阅功能\n * @module composables/useSubscribe\n */\n\nimport type { Ref, WatchStopHandle } from 'vue'\nimport type { MutationInfo, SubscribeOptions } from '../types'\nimport { onUnmounted, watch } from 'vue'\n\n/**\n * 订阅 Store 状态变化\n *\n * @template S - 状态类型\n * @param store - Pinia Store 实例\n * @param callback - 回调函数\n * @param options - 订阅选项\n * @returns 取消订阅函数\n *\n * @example\n * ```typescript\n * const store = useCounterStore()\n *\n * // 订阅状态变化\n * const unsubscribe = useSubscribe(store, (mutation, state) => {\n *   console.log('State changed:', mutation.type, state)\n * })\n *\n * // 取消订阅\n * unsubscribe()\n * ```\n */\nexport function useSubscribe<S extends Record<string, unknown>>(\n  store: S & { $subscribe?: (callback: (mutation: MutationInfo<S>, state: S) => void, options?: { detached?: boolean }) => () => void },\n  callback: (mutation: MutationInfo<S>, state: S) => void,\n  options: SubscribeOptions = {},\n): () => void {\n  const { detached = false } = options\n\n  // 使用 Pinia 的 $subscribe\n  if (store.$subscribe) {\n    const unsubscribe = store.$subscribe(\n      (mutation, state) => {\n        callback(mutation as MutationInfo<S>, state as S)\n      },\n      { detached },\n    )\n\n    // 组件卸载时自动取消订阅\n    if (!detached) {\n      onUnmounted(() => {\n        unsubscribe()\n      })\n    }\n\n    return unsubscribe\n  }\n\n  // 如果不是 Pinia Store，返回空函数\n  console.warn('[useSubscribe] Store 不支持 $subscribe 方法')\n  return () => {}\n}\n\n/**\n * 订阅 Store Action 调用\n *\n * @template S - Store 类型\n * @param store - Pinia Store 实例\n * @param callback - 回调函数\n * @returns 取消订阅函数\n *\n * @example\n * ```typescript\n * const store = useCounterStore()\n *\n * // 订阅 Action 调用\n * useOnAction(store, ({ name, args, after, onError }) => {\n *   console.log(`Action ${name} called with:`, args)\n *\n *   after((result) => {\n *     console.log(`Action ${name} finished with:`, result)\n *   })\n *\n *   onError((error) => {\n *     console.error(`Action ${name} failed:`, error)\n *   })\n * })\n * ```\n */\nexport function useOnAction<S extends Record<string, unknown>>(\n  store: S & { $onAction?: (callback: (context: ActionContext) => void, detached?: boolean) => () => void },\n  callback: (context: ActionContext) => void,\n  detached = false,\n): () => void {\n  if (store.$onAction) {\n    const unsubscribe = store.$onAction(callback, detached)\n\n    if (!detached) {\n      onUnmounted(() => {\n        unsubscribe()\n      })\n    }\n\n    return unsubscribe\n  }\n\n  console.warn('[useOnAction] Store 不支持 $onAction 方法')\n  return () => {}\n}\n\n/**\n * Action 上下文\n */\nexport interface ActionContext {\n  /** Action 名称 */\n  name: string\n  /** Store 实例 */\n  store: unknown\n  /** Action 参数 */\n  args: unknown[]\n  /** Action 完成后回调 */\n  after: (callback: (result: unknown) => void) => void\n  /** Action 错误回调 */\n  onError: (callback: (error: unknown) => void) => void\n}\n\n/**\n * 监听 ref 变化\n *\n * @template T - 值类型\n * @param source - 监听源\n * @param callback - 回调函数\n * @param options - 监听选项\n * @returns 停止监听函数\n */\nexport function useWatch<T>(\n  source: Ref<T>,\n  callback: (newValue: T, oldValue: T | undefined) => void,\n  options: SubscribeOptions = {},\n): WatchStopHandle {\n  const { immediate = false, deep = false, detached = false } = options\n\n  const stop = watch(\n    source,\n    (newValue, oldValue) => {\n      callback(newValue, oldValue)\n    },\n    { immediate, deep },\n  )\n\n  if (!detached) {\n    onUnmounted(() => {\n      stop()\n    })\n  }\n\n  return stop\n}\n\n"],"mappings":";;;;;;;;;;;AAiCO,SAAS,aACd,OACA,UACA,UAA4B,CAAC,GACjB;CACZ,MAAM,EAAE,WAAW,UAAU;CAG7B,IAAI,MAAM,YAAY;EACpB,MAAM,cAAc,MAAM,YACvB,UAAU,UAAU;GACnB,SAAS,UAA6B,KAAU;EAClD,GACA,EAAE,SAAS,CACb;EAGA,IAAI,CAAC,UACH,kBAAkB;GAChB,YAAY;EACd,CAAC;EAGH,OAAO;CACT;CAGA,QAAQ,KAAK,wCAAwC;CACrD,aAAa,CAAC;AAChB;AA4BO,SAAS,YACd,OACA,UACA,WAAW,OACC;CACZ,IAAI,MAAM,WAAW;EACnB,MAAM,cAAc,MAAM,UAAU,UAAU,QAAQ;EAEtD,IAAI,CAAC,UACH,kBAAkB;GAChB,YAAY;EACd,CAAC;EAGH,OAAO;CACT;CAEA,QAAQ,KAAK,sCAAsC;CACnD,aAAa,CAAC;AAChB;AA2BO,SAAS,SACd,QACA,UACA,UAA4B,CAAC,GACZ;CACjB,MAAM,EAAE,YAAY,OAAO,OAAO,OAAO,WAAW,UAAU;CAE9D,MAAM,OAAO,MACX,SACC,UAAU,aAAa;EACtB,SAAS,UAAU,QAAQ;CAC7B,GACA;EAAE;EAAW;CAAK,CACpB;CAEA,IAAI,CAAC,UACH,kBAAkB;EAChB,KAAK;CACP,CAAC;CAGH,OAAO;AACT"}

package/esm/context/injection-keys.d.ts

@@ -0,0 +1,8 @@
+import type { Pinia } from 'pinia';
+import type { InjectionKey } from 'vue';
+import type { StoreRuntime } from '../runtime/store-runtime';
+import type { GlobalStoreAPI } from '../types';
+export declare const STORE_API_SYMBOL: InjectionKey<GlobalStoreAPI>;
+export declare const STORE_PINIA_SYMBOL: InjectionKey<Pinia>;
+export declare const STORE_RUNTIME_SYMBOL: InjectionKey<StoreRuntime>;
+//# sourceMappingURL=injection-keys.d.ts.map

package/esm/context/injection-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-keys.d.ts","sourceRoot":"","sources":["../../src/context/injection-keys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAElC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,CAAA;AAEvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAG9C,eAAO,MAAM,gBAAgB,EAAkC,YAAY,CAAC,cAAc,CAAC,CAAA;AAE3F,eAAO,MAAM,kBAAkB,EAAoC,YAAY,CAAC,KAAK,CAAC,CAAA;AAEtF,eAAO,MAAM,oBAAoB,EAAsC,YAAY,CAAC,YAAY,CAAC,CAAA"}

package/esm/context/injection-keys.js

@@ -0,0 +1,17 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+//#region src/context/injection-keys.ts
+const STORE_API_SYMBOL = /* @__PURE__ */ Symbol("ldesign-store-api");
+const STORE_PINIA_SYMBOL = /* @__PURE__ */ Symbol("ldesign-store-pinia");
+const STORE_RUNTIME_SYMBOL = /* @__PURE__ */ Symbol("ldesign-store-runtime");
+//#endregion
+export { STORE_API_SYMBOL, STORE_PINIA_SYMBOL, STORE_RUNTIME_SYMBOL };
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=injection-keys.js.map

package/esm/context/injection-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-keys.js","names":[],"sources":["../../src/context/injection-keys.ts"],"sourcesContent":["// 从 pinia 导入 Pinia 类型\nimport type { Pinia } from 'pinia'\n// 从 vue 导入 InjectionKey 类型，用于类型安全的依赖注入\nimport type { InjectionKey } from 'vue'\n// 导入 StoreRuntime 类型，表示 store 运行时实例\nimport type { StoreRuntime } from '../runtime/store-runtime'\n// 导入 GlobalStoreAPI 类型，表示全局 store API 接口\nimport type { GlobalStoreAPI } from '../types'\n\n// store 全局 API 的注入键符号，用于 provide/inject 传递 GlobalStoreAPI 实例\nexport const STORE_API_SYMBOL = Symbol('ldesign-store-api') as InjectionKey<GlobalStoreAPI>\n// store Pinia 实例的注入键符号，用于 provide/inject 传递 Pinia 实例\nexport const STORE_PINIA_SYMBOL = Symbol('ldesign-store-pinia') as InjectionKey<Pinia>\n// store 运行时实例的注入键符号，用于 provide/inject 传递 StoreRuntime 实例\nexport const STORE_RUNTIME_SYMBOL = Symbol('ldesign-store-runtime') as InjectionKey<StoreRuntime>\n"],"mappings":";;;;;;;;;;AAUO,MAAM,mBAAmB,uBAAO,mBAAmB;AAEnD,MAAM,qBAAqB,uBAAO,qBAAqB;AAEvD,MAAM,uBAAuB,uBAAO,uBAAuB"}

package/esm/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @composy/store-vue - Vue 3 状态管理适配器
+ *
+ * 基于 Pinia 的增强版状态管理解决方案
+ *
+ * 主要功能：
+ * - Pinia 集成与增强
+ * - 状态持久化
+ * - Engine 插件集成
+ * - 丰富的 Composables
+ *
+ * @module @composy/store-vue
+ */
+export { createStoreGetters, createStoreState, defineSetupStore, email, maxLength, minLength, numberRange, pattern, required, useComputedStore, useFormStore, useOnAction, useOptimistic, usePersist, usePersistedRef, usePersistedRefWithTTL, usePersistedState, useSharedState, useSimpleStore, useStore, useStoreDevtools, useStoreSnapshot, useSubscribe, useWatch, } from './composables';
+export type { ActionContext, EventLogEntry, FormFieldRules, FormFieldState, FormValidator, OptimisticEntry, PersistedStateOptions, PersistedStateReturn, StateDiff, StateSnapshot, StoreInfo, UseFormStoreOptions, UseFormStoreReturn, UseOptimisticReturn, UseSharedStateOptions, UseSharedStateReturn, UseStoreDevtoolsReturn, UseStoreSnapshotOptions, UseStoreSnapshotReturn, } from './composables';
+export { cleanupEnhancedPersist, createEnhancedPersistPlugin, createPersistPlugin, createStoreEnginePlugin, createStoreRegistryPlugin, createStoreVuePlugin, getGlobalStoreAPI, getStoreRegistry, } from './plugins';
+export type { EnhancedPersistOptions, EnhancedPersistPluginOptions, PersistPluginOptions, StoreVuePluginOptions, } from './plugins';
+export type { GlobalStoreAPI, MutationInfo, PersistOptions, StoreEnginePluginOptions, StoreOptions, StoreProviderProps, SubscribeOptions, UsePersistOptions, UsePersistReturn, UseStoreReturn, } from './types';
+export { batch, combineSelectors, composePlugins, createAsyncAction, createBatchManager, createEventBus, createLoggerMiddleware, createMiddlewareManager, createPluginFactory, createPubSub, createPubSubWithValue, createSelector, createTimeTravelMiddleware, createValidationMiddleware, deepClone, deepMerge, defineStorePlugin, globalEventBus, } from '@composy/store-core';
+export { createPinia, defineStore, getActivePinia, mapActions, mapGetters, mapState, mapStores, mapWritableState, setActivePinia, storeToRefs, } from 'pinia';
+export type { Pinia, PiniaPlugin, PiniaPluginContext, StateTree, Store, StoreDefinition, StoreGeneric, StoreGetters, StoreState, } from 'pinia';
+export declare const version = "1.0.0";
+export declare const name = "@composy/store-vue";
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAEhB,gBAAgB,EAChB,KAAK,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EAEP,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,eAAe,CAAA;AAEtB,YAAY,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,SAAS,EACT,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,WAAW,CAAA;AAGlB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EAEL,KAAK,EAEL,gBAAgB,EAEhB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EAEd,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,0BAA0B,EAC1B,0BAA0B,EAC1B,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,UAAU,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,OAAO,CAAA;AAEd,YAAY,EACV,KAAK,EACL,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,KAAK,EACL,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,OAAO,CAAA;AAGd,eAAO,MAAM,OAAO,UAAU,CAAA;AAC9B,eAAO,MAAM,IAAI,uBAAuB,CAAA"}

package/esm/index.js

@@ -0,0 +1,34 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { createStoreGetters, createStoreState, defineSetupStore } from "./composables/defineSetupStore.js";
+import { email, maxLength, minLength, numberRange, pattern, required, useFormStore } from "./composables/useFormStore.js";
+import { useOptimistic } from "./composables/useOptimistic.js";
+import { usePersist, usePersistedRef, usePersistedRefWithTTL } from "./composables/usePersist.js";
+import { usePersistedState } from "./composables/usePersistedState.js";
+import { useSharedState } from "./composables/useSharedState.js";
+import { useComputedStore, useSimpleStore, useStore } from "./composables/useStore.js";
+import { useStoreDevtools } from "./composables/useStoreDevtools.js";
+import { useStoreSnapshot } from "./composables/useStoreSnapshot.js";
+import { useOnAction, useSubscribe, useWatch } from "./composables/useSubscribe.js";
+import "./composables/index.js";
+import { cleanupEnhancedPersist, createEnhancedPersistPlugin, createPersistPlugin } from "./plugins/pinia-plugin.js";
+import { createStoreRegistryPlugin, getStoreRegistry } from "./runtime/store-registry.js";
+import { createStoreEnginePlugin, getGlobalStoreAPI } from "./plugins/engine-plugin.js";
+import { createStoreVuePlugin } from "./plugins/vue-plugin.js";
+import "./plugins/index.js";
+import { createPinia, defineStore, getActivePinia, mapActions, mapGetters, mapState, mapStores, mapWritableState, setActivePinia, storeToRefs } from "pinia";
+import { batch, combineSelectors, composePlugins, createAsyncAction, createBatchManager, createEventBus, createLoggerMiddleware, createMiddlewareManager, createPluginFactory, createPubSub, createPubSubWithValue, createSelector, createTimeTravelMiddleware, createValidationMiddleware, deepClone, deepMerge, defineStorePlugin, globalEventBus } from "@composy/store-core";
+//#region src/index.ts
+const version = "1.0.0";
+const name = "@composy/store-vue";
+//#endregion
+export { batch, cleanupEnhancedPersist, combineSelectors, composePlugins, createAsyncAction, createBatchManager, createEnhancedPersistPlugin, createEventBus, createLoggerMiddleware, createMiddlewareManager, createPersistPlugin, createPinia, createPluginFactory, createPubSub, createPubSubWithValue, createSelector, createStoreEnginePlugin, createStoreGetters, createStoreRegistryPlugin, createStoreState, createStoreVuePlugin, createTimeTravelMiddleware, createValidationMiddleware, deepClone, deepMerge, defineSetupStore, defineStore, defineStorePlugin, email, getActivePinia, getGlobalStoreAPI, getStoreRegistry, globalEventBus, mapActions, mapGetters, mapState, mapStores, mapWritableState, maxLength, minLength, name, numberRange, pattern, required, setActivePinia, storeToRefs, useComputedStore, useFormStore, useOnAction, useOptimistic, usePersist, usePersistedRef, usePersistedRefWithTTL, usePersistedState, useSharedState, useSimpleStore, useStore, useStoreDevtools, useStoreSnapshot, useSubscribe, useWatch, version };
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @composy/store-vue - Vue 3 状态管理适配器\n *\n * 基于 Pinia 的增强版状态管理解决方案\n *\n * 主要功能：\n * - Pinia 集成与增强\n * - 状态持久化\n * - Engine 插件集成\n * - 丰富的 Composables\n *\n * @module @composy/store-vue\n */\n\n// === Composables ===\nexport {\n  createStoreGetters,\n  createStoreState,\n  // Setup Store 助手\n  defineSetupStore,\n  email,\n  maxLength,\n  minLength,\n  numberRange,\n  pattern,\n  // 验证规则工具\n  required,\n  useComputedStore,\n  useFormStore,\n  useOnAction,\n  useOptimistic,\n  usePersist,\n  usePersistedRef,\n  usePersistedRefWithTTL,\n  usePersistedState,\n  useSharedState,\n  useSimpleStore,\n  useStore,\n  useStoreDevtools,\n  useStoreSnapshot,\n  useSubscribe,\n  useWatch,\n} from './composables'\n\nexport type {\n  ActionContext,\n  EventLogEntry,\n  FormFieldRules,\n  FormFieldState,\n  FormValidator,\n  OptimisticEntry,\n  PersistedStateOptions,\n  PersistedStateReturn,\n  StateDiff,\n  StateSnapshot,\n  StoreInfo,\n  UseFormStoreOptions,\n  UseFormStoreReturn,\n  UseOptimisticReturn,\n  UseSharedStateOptions,\n  UseSharedStateReturn,\n  UseStoreDevtoolsReturn,\n  UseStoreSnapshotOptions,\n  UseStoreSnapshotReturn,\n} from './composables'\n\n// === 插件 ===\nexport {\n  cleanupEnhancedPersist,\n  createEnhancedPersistPlugin,\n  createPersistPlugin,\n  createStoreEnginePlugin,\n  createStoreRegistryPlugin,\n  createStoreVuePlugin,\n  getGlobalStoreAPI,\n  getStoreRegistry,\n} from './plugins'\n\nexport type {\n  EnhancedPersistOptions,\n  EnhancedPersistPluginOptions,\n  PersistPluginOptions,\n  StoreVuePluginOptions,\n} from './plugins'\n\n// === 类型 ===\nexport type {\n  GlobalStoreAPI,\n  MutationInfo,\n  PersistOptions,\n  StoreEnginePluginOptions,\n  StoreOptions,\n  StoreProviderProps,\n  SubscribeOptions,\n  UsePersistOptions,\n  UsePersistReturn,\n  UseStoreReturn,\n} from './types'\n\n// === 从 @composy/store-core 重新导出常用功能 ===\nexport {\n  // 核心\n  batch,\n  // 工具\n  combineSelectors,\n  // 插件\n  composePlugins,\n  createAsyncAction,\n  createBatchManager,\n  createEventBus,\n  // 中间件\n  createLoggerMiddleware,\n  createMiddlewareManager,\n  createPluginFactory,\n  createPubSub,\n  createPubSubWithValue,\n  createSelector,\n  createTimeTravelMiddleware,\n  createValidationMiddleware,\n  deepClone,\n  deepMerge,\n  defineStorePlugin,\n  globalEventBus,\n} from '@composy/store-core'\n\n// === 从 Pinia 重新导出 ===\nexport {\n  createPinia,\n  defineStore,\n  getActivePinia,\n  mapActions,\n  mapGetters,\n  mapState,\n  mapStores,\n  mapWritableState,\n  setActivePinia,\n  storeToRefs,\n} from 'pinia'\n\nexport type {\n  Pinia,\n  PiniaPlugin,\n  PiniaPluginContext,\n  StateTree,\n  Store,\n  StoreDefinition,\n  StoreGeneric,\n  StoreGetters,\n  StoreState,\n} from 'pinia'\n\n// === 版本信息 ===\nexport const version = '1.0.0'\nexport const name = '@composy/store-vue'\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwJO,MAAM,UAAU;AAChB,MAAM,OAAO"}