@composy/store-vue 0.0.1

package/es/composables/useStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStore.js","names":[],"sources":["../../src/composables/useStore.ts"],"sourcesContent":["/**\n * useStore Composable\n *\n * 提供在组件中使用 Store 的便捷方法\n * @module composables/useStore\n */\n\nimport type { StoreGeneric } from 'pinia'\nimport type { Ref } from 'vue'\nimport { storeToRefs } from 'pinia'\nimport { computed, ref, watch } from 'vue'\n\n/**\n * useStore 选项\n */\nexport interface UseStoreOptions {\n  /** 是否立即同步状态 */\n  immediate?: boolean\n  /** 是否深度监听 */\n  deep?: boolean\n}\n\n/**\n * 通用 Store Hook\n *\n * 提供对 Pinia Store 的便捷访问\n *\n * @template T - Store 类型\n * @param useStoreHook - Pinia useStore hook\n * @param _options - 选项\n * @returns Store 包装对象\n *\n * @example\n * ```typescript\n * // 定义 Store\n * const useCounterStore = defineStore('counter', {\n *   state: () => ({ count: 0 }),\n *   actions: {\n *     increment() { this.count++ }\n *   }\n * })\n *\n * // 在组件中使用\n * const { store, refs, reset } = useStore(useCounterStore)\n *\n * // 访问响应式状态\n * console.log(refs.count.value)\n *\n * // 调用 action\n * store.increment()\n * ```\n */\nexport function useStore<T extends StoreGeneric>(\n  useStoreHook: () => T,\n  _options: UseStoreOptions = {},\n): {\n  store: T\n  refs: ReturnType<typeof storeToRefs<T>>\n  reset: () => void\n  patch: (partial: Partial<T> | ((state: T) => void)) => void\n} {\n  const store = useStoreHook()\n\n  // 获取响应式 refs\n  const refs = storeToRefs(store)\n\n  // 重置函数\n  const reset = (): void => {\n    if ('$reset' in store && typeof store.$reset === 'function') {\n      (store.$reset as () => void)()\n    }\n  }\n\n  // 批量更新函数\n  const patch = (partial: Partial<T> | ((state: T) => void)): void => {\n    if ('$patch' in store && typeof store.$patch === 'function') {\n      (store.$patch as (partial: unknown) => void)(partial)\n    }\n  }\n\n  return {\n    store,\n    refs,\n    reset,\n    patch,\n  }\n}\n\n/**\n * 创建简单的响应式 Store\n *\n * 不依赖 Pinia，适用于简单场景\n *\n * @template S - 状态类型\n * @param initialState - 初始状态\n * @returns 响应式 Store\n *\n * @example\n * ```typescript\n * const { state, setState, reset } = useSimpleStore({\n *   count: 0,\n *   name: 'test'\n * })\n *\n * // 更新状态\n * setState({ count: 1 })\n *\n * // 重置\n * reset()\n * ```\n */\nexport function useSimpleStore<S extends Record<string, unknown>>(\n  initialState: S,\n): {\n  state: Ref<S>\n  setState: (partial: Partial<S>) => void\n  reset: () => void\n  subscribe: (callback: (state: S) => void) => () => void\n} {\n  const state = ref({ ...initialState }) as Ref<S>\n  const initialStateCopy = { ...initialState }\n\n  const setState = (partial: Partial<S>): void => {\n    Object.assign(state.value, partial)\n  }\n\n  const reset = (): void => {\n    state.value = { ...initialStateCopy } as S\n  }\n\n  const subscribe = (callback: (state: S) => void): (() => void) => {\n    const stop = watch(\n      state,\n      (newState) => {\n        callback(newState)\n      },\n      { deep: true },\n    )\n    return stop\n  }\n\n  return {\n    state,\n    setState,\n    reset,\n    subscribe,\n  }\n}\n\n/**\n * 创建计算属性 Store\n *\n * @template S - 状态类型\n * @template G - Getters 类型\n * @param state - 状态\n * @param getters - 计算属性\n * @returns 带计算属性的 Store\n */\nexport function useComputedStore<\n  S extends Record<string, unknown>,\n  G extends Record<string, (state: S) => unknown>,\n>(\n  state: Ref<S>,\n  getters: G,\n): {\n  state: Ref<S>\n  getters: { [K in keyof G]: ReturnType<G[K]> }\n} {\n  const computedGetters = {} as { [K in keyof G]: ReturnType<G[K]> }\n\n  for (const key in getters) {\n    (computedGetters as Record<string, unknown>)[key] = computed(() =>\n      getters[key](state.value),\n    )\n  }\n\n  return {\n    state,\n    getters: computedGetters,\n  }\n}\n\n"],"mappings":";;;;;;;;;;;;AAoDO,SAAS,SACd,cACA,WAA4B,CAAC,GAM7B;CACA,MAAM,QAAQ,aAAa;CAG3B,MAAM,OAAO,YAAY,KAAK;CAG9B,MAAM,cAAoB;EACxB,IAAI,YAAY,SAAS,OAAO,MAAM,WAAW,YAC9C,MAAM,OAAsB;CAEjC;CAGA,MAAM,SAAS,YAAqD;EAClE,IAAI,YAAY,SAAS,OAAO,MAAM,WAAW,YAC9C,MAAM,OAAsC,OAAO;CAExD;CAEA,OAAO;EACL;EACA;EACA;EACA;CACF;AACF;AAyBO,SAAS,eACd,cAMA;CACA,MAAM,QAAQ,IAAI,EAAE,GAAG,aAAa,CAAC;CACrC,MAAM,mBAAmB,EAAE,GAAG,aAAa;CAE3C,MAAM,YAAY,YAA8B;EAC9C,OAAO,OAAO,MAAM,OAAO,OAAO;CACpC;CAEA,MAAM,cAAoB;EACxB,MAAM,QAAQ,EAAE,GAAG,iBAAiB;CACtC;CAEA,MAAM,aAAa,aAA+C;EAQhE,OAPa,MACX,QACC,aAAa;GACZ,SAAS,QAAQ;EACnB,GACA,EAAE,MAAM,KAAK,CAER;CACT;CAEA,OAAO;EACL;EACA;EACA;EACA;CACF;AACF;AAWO,SAAS,iBAId,OACA,SAIA;CACA,MAAM,kBAAkB,CAAC;CAEzB,KAAA,MAAW,OAAO,SACf,gBAA4C,OAAO,eAClD,QAAQ,IAAG,CAAE,MAAM,KAAK,CAC1B;CAGF,OAAO;EACL;EACA,SAAS;CACX;AACF"}

package/es/composables/useStoreDevtools.d.ts

@@ -0,0 +1,31 @@
+import type { Ref } from 'vue';
+export interface StoreInfo {
+    id: string;
+    state: Record<string, unknown>;
+    active: boolean;
+}
+export interface EventLogEntry {
+    type: string;
+    payload: unknown;
+    timestamp: number;
+    time: string;
+}
+export interface UseStoreDevtoolsReturn {
+    stores: Ref<StoreInfo[]>;
+    eventLog: Ref<EventLogEntry[]>;
+    isMonitoring: Ref<boolean>;
+    startMonitoring: () => void;
+    stopMonitoring: () => void;
+    clearLog: () => void;
+    refreshStores: () => void;
+    getStoreState: (id: string) => Record<string, unknown> | null;
+    resetStore: (id: string) => boolean;
+    resetAllStores: () => void;
+}
+export declare function useStoreDevtools(options?: {
+    /**
+     * 最多保留多少条事件日志。
+     */
+    maxLogEntries?: number;
+}): UseStoreDevtoolsReturn;
+//# sourceMappingURL=useStoreDevtools.d.ts.map

package/es/composables/useStoreDevtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreDevtools.d.ts","sourceRoot":"","sources":["../../src/composables/useStoreDevtools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAe9B,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAA;IACxB,QAAQ,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC,CAAA;IAC9B,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IAC1B,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC7D,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAA;IACnC,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B;AAwBD,wBAAgB,gBAAgB,CAAC,OAAO,GAAE;IACxC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,sBAAsB,CAkH9B"}

package/es/composables/useStoreDevtools.js

@@ -0,0 +1,112 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { getActivePinia } from "pinia";
+import { onUnmounted, ref } from "vue";
+import { deepClone, globalEventBus } from "@composy/store-core";
+//#region src/composables/useStoreDevtools.ts
+const STORE_REFRESH_EVENTS = /* @__PURE__ */ new Set([
+	"store:created",
+	"store:disposed",
+	"state:changed"
+]);
+function formatTime(timestamp) {
+	const date = new Date(timestamp);
+	return `${date.getHours().toString().padStart(2, "0")}:${date.getMinutes().toString().padStart(2, "0")}:${date.getSeconds().toString().padStart(2, "0")}.${date.getMilliseconds().toString().padStart(3, "0")}`;
+}
+function getPinia() {
+	return getActivePinia() ?? null;
+}
+function snapshotStore(store, id) {
+	return {
+		id,
+		state: deepClone(store.$state),
+		active: true
+	};
+}
+function useStoreDevtools(options = {}) {
+	const { maxLogEntries = 200 } = options;
+	const stores = ref([]);
+	const eventLog = ref([]);
+	const isMonitoring = ref(false);
+	let unsubscribe = null;
+	function refreshStores() {
+		const pinia = getPinia();
+		if (!pinia?._s) {
+			stores.value = [];
+			return;
+		}
+		stores.value = Array.from(pinia._s.entries(), ([id, store]) => {
+			return snapshotStore(store, id);
+		});
+	}
+	function startMonitoring() {
+		if (isMonitoring.value) return;
+		isMonitoring.value = true;
+		unsubscribe = globalEventBus.on("*", (data) => {
+			const entry = {
+				type: data.type,
+				payload: data.payload,
+				timestamp: data.timestamp,
+				time: formatTime(data.timestamp)
+			};
+			eventLog.value = [entry, ...eventLog.value].slice(0, maxLogEntries);
+			if (STORE_REFRESH_EVENTS.has(data.type)) refreshStores();
+		});
+	}
+	function stopMonitoring() {
+		if (!isMonitoring.value) return;
+		isMonitoring.value = false;
+		unsubscribe?.();
+		unsubscribe = null;
+	}
+	function clearLog() {
+		eventLog.value = [];
+	}
+	function getStoreState(id) {
+		const store = getPinia()?._s?.get(id);
+		if (!store) return null;
+		return deepClone(store.$state);
+	}
+	function resetStore(id) {
+		const store = getPinia()?._s?.get(id);
+		if (!store || typeof store.$reset !== "function") return false;
+		store.$reset();
+		refreshStores();
+		return true;
+	}
+	function resetAllStores() {
+		const pinia = getPinia();
+		if (!pinia?._s) return;
+		pinia._s.forEach((store) => {
+			if (typeof store.$reset === "function") store.$reset();
+		});
+		refreshStores();
+	}
+	refreshStores();
+	onUnmounted(() => {
+		stopMonitoring();
+	});
+	return {
+		stores,
+		eventLog,
+		isMonitoring,
+		startMonitoring,
+		stopMonitoring,
+		clearLog,
+		refreshStores,
+		getStoreState,
+		resetStore,
+		resetAllStores
+	};
+}
+//#endregion
+export { useStoreDevtools };
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=useStoreDevtools.js.map

package/es/composables/useStoreDevtools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreDevtools.js","names":[],"sources":["../../src/composables/useStoreDevtools.ts"],"sourcesContent":["import type { EventData } from '@composy/store-core'\nimport type { Pinia, StoreGeneric } from 'pinia'\nimport type { Ref } from 'vue'\nimport { deepClone, globalEventBus } from '@composy/store-core'\nimport { getActivePinia } from 'pinia'\nimport { onUnmounted, ref } from 'vue'\n\nconst STORE_REFRESH_EVENTS = new Set([\n  'store:created',\n  'store:disposed',\n  'state:changed',\n])\n\ntype PiniaWithStores = Pinia & {\n  _s?: Map<string, StoreGeneric>\n}\n\nexport interface StoreInfo {\n  id: string\n  state: Record<string, unknown>\n  active: boolean\n}\n\nexport interface EventLogEntry {\n  type: string\n  payload: unknown\n  timestamp: number\n  time: string\n}\n\nexport interface UseStoreDevtoolsReturn {\n  stores: Ref<StoreInfo[]>\n  eventLog: Ref<EventLogEntry[]>\n  isMonitoring: Ref<boolean>\n  startMonitoring: () => void\n  stopMonitoring: () => void\n  clearLog: () => void\n  refreshStores: () => void\n  getStoreState: (id: string) => Record<string, unknown> | null\n  resetStore: (id: string) => boolean\n  resetAllStores: () => void\n}\n\nfunction formatTime(timestamp: number): string {\n  const date = new Date(timestamp)\n  const hours = date.getHours().toString().padStart(2, '0')\n  const minutes = date.getMinutes().toString().padStart(2, '0')\n  const seconds = date.getSeconds().toString().padStart(2, '0')\n  const milliseconds = date.getMilliseconds().toString().padStart(3, '0')\n\n  return `${hours}:${minutes}:${seconds}.${milliseconds}`\n}\n\nfunction getPinia(): PiniaWithStores | null {\n  return (getActivePinia() ?? null) as PiniaWithStores | null\n}\n\nfunction snapshotStore(store: StoreGeneric, id: string): StoreInfo {\n  return {\n    id,\n    state: deepClone(store.$state),\n    active: true,\n  }\n}\n\nexport function useStoreDevtools(options: {\n  /**\n   * 最多保留多少条事件日志。\n   */\n  maxLogEntries?: number\n} = {}): UseStoreDevtoolsReturn {\n  const { maxLogEntries = 200 } = options\n\n  const stores = ref<StoreInfo[]>([])\n  const eventLog = ref<EventLogEntry[]>([])\n  const isMonitoring = ref(false)\n\n  let unsubscribe: (() => void) | null = null\n\n  function refreshStores(): void {\n    const pinia = getPinia()\n    if (!pinia?._s) {\n      stores.value = []\n      return\n    }\n\n    stores.value = Array.from(pinia._s.entries(), ([id, store]) => {\n      return snapshotStore(store, id)\n    })\n  }\n\n  function startMonitoring(): void {\n    if (isMonitoring.value) {\n      return\n    }\n\n    isMonitoring.value = true\n    unsubscribe = globalEventBus.on('*', (data: EventData) => {\n      const entry: EventLogEntry = {\n        type: data.type,\n        payload: data.payload,\n        timestamp: data.timestamp,\n        time: formatTime(data.timestamp),\n      }\n\n      eventLog.value = [entry, ...eventLog.value].slice(0, maxLogEntries)\n\n      if (STORE_REFRESH_EVENTS.has(data.type)) {\n        refreshStores()\n      }\n    })\n  }\n\n  function stopMonitoring(): void {\n    if (!isMonitoring.value) {\n      return\n    }\n\n    isMonitoring.value = false\n    unsubscribe?.()\n    unsubscribe = null\n  }\n\n  function clearLog(): void {\n    eventLog.value = []\n  }\n\n  function getStoreState(id: string): Record<string, unknown> | null {\n    const pinia = getPinia()\n    const store = pinia?._s?.get(id)\n\n    if (!store) {\n      return null\n    }\n\n    return deepClone(store.$state)\n  }\n\n  function resetStore(id: string): boolean {\n    const pinia = getPinia()\n    const store = pinia?._s?.get(id)\n\n    if (!store || typeof store.$reset !== 'function') {\n      return false\n    }\n\n    store.$reset()\n    refreshStores()\n    return true\n  }\n\n  function resetAllStores(): void {\n    const pinia = getPinia()\n    if (!pinia?._s) {\n      return\n    }\n\n    pinia._s.forEach((store) => {\n      if (typeof store.$reset === 'function') {\n        store.$reset()\n      }\n    })\n\n    refreshStores()\n  }\n\n  refreshStores()\n\n  onUnmounted(() => {\n    stopMonitoring()\n  })\n\n  return {\n    stores,\n    eventLog,\n    isMonitoring,\n    startMonitoring,\n    stopMonitoring,\n    clearLog,\n    refreshStores,\n    getStoreState,\n    resetStore,\n    resetAllStores,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAOA,MAAM,uCAAuB,IAAI,IAAI;CACnC;CACA;CACA;AACF,CAAC;AAgCD,SAAS,WAAW,WAA2B;CAC7C,MAAM,OAAO,IAAI,KAAK,SAAS;CAM/B,OAAO,GALO,KAAK,SAAS,CAAA,CAAE,SAAS,CAAA,CAAE,SAAS,GAAG,GAK3C,EAAK,GAJC,KAAK,WAAW,CAAA,CAAE,SAAS,CAAA,CAAE,SAAS,GAAG,GAItC,EAAO,GAHV,KAAK,WAAW,CAAA,CAAE,SAAS,CAAA,CAAE,SAAS,GAAG,GAG3B,EAAO,GAFhB,KAAK,gBAAgB,CAAA,CAAE,SAAS,CAAA,CAAE,SAAS,GAAG,GAE1B;AAC3C;AAEA,SAAS,WAAmC;CAC1C,OAAQ,eAAe,KAAK;AAC9B;AAEA,SAAS,cAAc,OAAqB,IAAuB;CACjE,OAAO;EACL;EACA,OAAO,UAAU,MAAM,MAAM;EAC7B,QAAQ;CACV;AACF;AAEO,SAAS,iBAAiB,UAK7B,CAAC,GAA2B;CAC9B,MAAM,EAAE,gBAAgB,QAAQ;CAEhC,MAAM,SAAS,IAAiB,CAAC,CAAC;CAClC,MAAM,WAAW,IAAqB,CAAC,CAAC;CACxC,MAAM,eAAe,IAAI,KAAK;CAE9B,IAAI,cAAmC;CAEvC,SAAS,gBAAsB;EAC7B,MAAM,QAAQ,SAAS;EACvB,IAAI,CAAC,OAAO,IAAI;GACd,OAAO,QAAQ,CAAC;GAChB;EACF;EAEA,OAAO,QAAQ,MAAM,KAAK,MAAM,GAAG,QAAQ,IAAI,CAAC,IAAI,WAAW;GAC7D,OAAO,cAAc,OAAO,EAAE;EAChC,CAAC;CACH;CAEA,SAAS,kBAAwB;EAC/B,IAAI,aAAa,OACf;EAGF,aAAa,QAAQ;EACrB,cAAc,eAAe,GAAG,MAAM,SAAoB;GACxD,MAAM,QAAuB;IAC3B,MAAM,KAAK;IACX,SAAS,KAAK;IACd,WAAW,KAAK;IAChB,MAAM,WAAW,KAAK,SAAS;GACjC;GAEA,SAAS,QAAQ,CAAC,OAAO,GAAG,SAAS,KAAK,CAAA,CAAE,MAAM,GAAG,aAAa;GAElE,IAAI,qBAAqB,IAAI,KAAK,IAAI,GACpC,cAAc;EAElB,CAAC;CACH;CAEA,SAAS,iBAAuB;EAC9B,IAAI,CAAC,aAAa,OAChB;EAGF,aAAa,QAAQ;EACrB,cAAc;EACd,cAAc;CAChB;CAEA,SAAS,WAAiB;EACxB,SAAS,QAAQ,CAAC;CACpB;CAEA,SAAS,cAAc,IAA4C;EAEjE,MAAM,QADQ,SACA,CAAA,EAAO,IAAI,IAAI,EAAE;EAE/B,IAAI,CAAC,OACH,OAAO;EAGT,OAAO,UAAU,MAAM,MAAM;CAC/B;CAEA,SAAS,WAAW,IAAqB;EAEvC,MAAM,QADQ,SACA,CAAA,EAAO,IAAI,IAAI,EAAE;EAE/B,IAAI,CAAC,SAAS,OAAO,MAAM,WAAW,YACpC,OAAO;EAGT,MAAM,OAAO;EACb,cAAc;EACd,OAAO;CACT;CAEA,SAAS,iBAAuB;EAC9B,MAAM,QAAQ,SAAS;EACvB,IAAI,CAAC,OAAO,IACV;EAGF,MAAM,GAAG,SAAS,UAAU;GAC1B,IAAI,OAAO,MAAM,WAAW,YAC1B,MAAM,OAAO;EAEjB,CAAC;EAED,cAAc;CAChB;CAEA,cAAc;CAEd,kBAAkB;EAChB,eAAe;CACjB,CAAC;CAED,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/es/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/es/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/es/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/es/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":"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"}

package/es/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/es/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"}