@composy/store-core 0.0.1 → 0.0.2

package/lib/core/base-store.cjs

@@ -2,7 +2,7 @@
 * ***********************************
 * @composy/store-core v0.0.1      *
 * Built with rollup               *
-* Build time: 2024-08-17 11:27:33 *
+* Build time: 2024-10-12 17:23:58 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************
@@ -10,8 +10,20 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_pub_sub = require("./pub-sub.cjs");
+const require_middleware_manager = require("../middleware/middleware-manager.cjs");
+const require_plugin_manager = require("../plugins/plugin-manager.cjs");
+const require_deep_clone = require("../utils/deep-clone.cjs");
+const require_batch_manager = require("./batch-manager.cjs");
 const require_event_bus = require("./event-bus.cjs");
 //#region src/core/base-store.ts
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 function isPromiseLike(value) {
 	return !!value && typeof value.then === "function";
 }
@@ -19,123 +31,208 @@ async function runCallbacks(callbacks, value) {
 	for (const callback of callbacks) await callback(value);
 }
 var BaseStore = class {
-	/**
-	* 构造函数
-	*
-	* @param definition - Store 定义
-	* @param _options - Store 配置选项
-	*/
-	constructor(definition, _options = {}) {
-		/** 状态订阅管理器 */
-		this.stateSubscribers = require_pub_sub.createPubSub();
-		/** Action 订阅管理器 */
-		this.actionSubscribers = require_pub_sub.createPubSub();
-		/** 是否已销毁 */
-		this.disposed = false;
+	constructor(definition, options = {}) {
+		__publicField(this, "$id");
+		__publicField(this, "getters");
+		__publicField(this, "actions");
+		__publicField(this, "stateSubscribers", require_pub_sub.createPubSub());
+		__publicField(this, "actionSubscribers", require_pub_sub.createPubSub());
+		__publicField(this, "initialStateFactory");
+		__publicField(this, "middlewareManager");
+		__publicField(this, "pluginManager");
+		__publicField(this, "batchManager");
+		__publicField(this, "pendingBatchMutation", null);
+		__publicField(this, "stopBatchFlush");
+		__publicField(this, "mutationQueue", Promise.resolve());
+		__publicField(this, "pendingMutations", 0);
+		__publicField(this, "_state");
+		__publicField(this, "disposed", false);
 		this.$id = definition.id;
 		this.initialStateFactory = definition.state;
 		this._state = definition.state();
+		this.middlewareManager = options.middleware ?? require_middleware_manager.getGlobalMiddlewareManager();
+		this.pluginManager = options.plugins ?? require_plugin_manager.getGlobalPluginManager();
+		this.batchManager = options.batch ?? require_batch_manager.getGlobalBatchManager();
 		this.getters = this.createGetters(definition.getters || {});
 		this.actions = this.createActions(definition.actions || {});
+		this.stopBatchFlush = this.batchManager.onFlush?.((storeIds) => {
+			if (!storeIds.has(this.$id) || !this.pendingBatchMutation) return;
+			const mutation = this.pendingBatchMutation;
+			this.pendingBatchMutation = null;
+			this.publishStateChange(mutation);
+		});
 		require_event_bus.globalEventBus.emit("store:created", { storeId: this.$id });
+		this.notifyPluginStoreCreated();
 	}
-	/**
-	* 获取当前状态
-	*/
 	get $state() {
 		return this._state;
 	}
-	/**
-	* 设置状态
-	*/
 	set $state(newState) {
-		this._state = newState;
+		this.checkDisposed();
+		const nextState = require_deep_clone.deepClone(newState);
+		const operation = () => this.runStateMutation(nextState, newState);
+		this.scheduleMutation(operation).catch((error) => {
+			console.error(`[Store] Failed to replace state for "${this.$id}":`, error);
+		});
 	}
-	/**
-	* 重置状态到初始值
-	*/
 	$reset() {
 		this.checkDisposed();
-		const oldState = { ...this._state };
-		this._state = this.initialStateFactory();
-		this.notifyStateChange({
-			type: "direct",
-			storeId: this.$id,
-			oldState
+		this.scheduleMutation(() => this.runStateMutation()).catch((error) => {
+			console.error(`[Store] Failed to reset "${this.$id}":`, error);
 		});
 	}
-	/**
-	* 批量更新状态
-	*/
 	$patch(partialState) {
 		this.checkDisposed();
-		const oldState = { ...this._state };
-		if (typeof partialState === "function") {
-			partialState(this._state);
-			this.notifyStateChange({
-				type: "patch function",
-				storeId: this.$id,
-				oldState
-			});
-		} else {
-			Object.assign(this._state, partialState);
-			this.notifyStateChange({
-				type: "patch object",
-				storeId: this.$id,
-				oldState,
-				events: Object.keys(partialState)
-			});
-		}
+		const patch = typeof partialState === "function" ? partialState : require_deep_clone.deepClone(partialState);
+		this.scheduleMutation(() => this.runPatchMutation(patch)).catch((error) => {
+			console.error(`[Store] Failed to patch "${this.$id}":`, error);
+		});
+	}
+	async $patchAsync(partialState) {
+		this.checkDisposed();
+		const patch = typeof partialState === "function" ? partialState : require_deep_clone.deepClone(partialState);
+		await this.scheduleMutation(() => this.runPatchMutation(patch));
 	}
-	/**
-	* 订阅状态变化
-	*/
 	$subscribe(callback, options = {}) {
 		this.checkDisposed();
-		return this.stateSubscribers.subscribe(({ mutation, state }) => callback(mutation, state), { immediate: options.immediate });
+		const unsubscribe = this.stateSubscribers.subscribe(({ mutation, state }) => callback(mutation, state), { immediate: options.immediate });
+		if (options.immediate) try {
+			callback({
+				type: "direct",
+				storeId: this.$id
+			}, require_deep_clone.deepClone(this._state));
+		} catch (error) {
+			console.error("[Store] immediate subscriber failed:", error);
+		}
+		return unsubscribe;
 	}
-	/**
-	* 订阅 Action 调用
-	*/
 	$onAction(callback) {
 		this.checkDisposed();
 		return this.actionSubscribers.subscribe(callback);
 	}
-	/**
-	* 销毁 Store
-	*/
 	$dispose() {
 		if (this.disposed) return;
 		this.disposed = true;
+		this.stopBatchFlush?.();
+		this.stopBatchFlush = void 0;
+		this.mutationQueue = Promise.resolve();
+		this.pendingMutations = 0;
 		this.stateSubscribers.clear();
 		this.actionSubscribers.clear();
+		this.notifyPluginStoreDisposed();
 		require_event_bus.globalEventBus.emit("store:disposed", { storeId: this.$id });
 	}
-	/**
-	* 通知状态变化
-	*/
 	notifyStateChange(mutation) {
+		this.publishStateChange(mutation);
+	}
+	publishStateChange(mutation) {
+		const stateSnapshot = require_deep_clone.deepClone(this._state);
 		this.stateSubscribers.publish({
 			mutation,
-			state: this._state
+			state: stateSnapshot
 		});
 		require_event_bus.globalEventBus.emit("state:changed", {
 			storeId: this.$id,
-			state: this._state,
+			state: stateSnapshot,
 			mutation
 		});
 	}
-	/**
-	* 通知 Action 调用
-	*/
-	notifyAction(context) {
-		this.actionSubscribers.publish(context);
+	async runMutation(candidate, mutation, payload, previousState) {
+		this.checkDisposed();
+		let committed = false;
+		const commit = () => {
+			if (committed || this.disposed) return;
+			committed = true;
+			this._state = candidate;
+			this.notifyPluginStateChange(candidate, previousState);
+			if (this.batchManager.isBatching() && this.batchManager.onFlush) {
+				this.pendingBatchMutation = this.pendingBatchMutation ? {
+					...mutation,
+					oldState: this.pendingBatchMutation.oldState
+				} : mutation;
+				this.batchManager.markDirty(this.$id);
+			} else this.publishStateChange(mutation);
+		};
+		if (this.middlewareManager.getAll().length === 0) {
+			commit();
+			return;
+		}
+		await this.middlewareManager.execute({
+			storeId: this.$id,
+			state: candidate,
+			type: mutation.type === "direct" ? "state:reset" : "state:patch",
+			payload,
+			meta: {
+				candidateState: candidate,
+				previousState,
+				commit
+			}
+		});
+		commit();
+	}
+	runStateMutation(nextState, payload) {
+		this.checkDisposed();
+		const previousState = require_deep_clone.deepClone(this._state);
+		const mutation = {
+			type: "direct",
+			storeId: this.$id,
+			oldState: previousState
+		};
+		return this.runMutation(require_deep_clone.deepClone(nextState ?? this.initialStateFactory()), mutation, payload, previousState);
+	}
+	runPatchMutation(partialState) {
+		this.checkDisposed();
+		const previousState = require_deep_clone.deepClone(this._state);
+		const candidate = require_deep_clone.deepClone(this._state);
+		const mutation = typeof partialState === "function" ? {
+			type: "patch function",
+			storeId: this.$id,
+			oldState: previousState
+		} : {
+			type: "patch object",
+			storeId: this.$id,
+			oldState: previousState,
+			events: Object.keys(partialState)
+		};
+		if (typeof partialState === "function") partialState(candidate);
+		else Object.assign(candidate, partialState);
+		return this.runMutation(candidate, mutation, partialState, previousState);
+	}
+	scheduleMutation(operation) {
+		if (this.pendingMutations === 0 && this.middlewareManager.getAll().length === 0) return operation();
+		this.pendingMutations += 1;
+		const queuedOperation = this.mutationQueue.then(operation);
+		this.mutationQueue = queuedOperation.catch(() => void 0);
+		queuedOperation.then(() => {
+			this.pendingMutations -= 1;
+		}, () => {
+			this.pendingMutations -= 1;
+		});
+		return queuedOperation;
+	}
+	notifyPluginStoreCreated() {
+		if (this.pluginManager.notifyStoreCreated) {
+			this.pluginManager.notifyStoreCreated(this);
+			return;
+		}
+		this.pluginManager.getAll().forEach((plugin) => plugin.onStoreCreated?.(this));
+	}
+	notifyPluginStoreDisposed() {
+		if (this.pluginManager.notifyStoreDisposed) {
+			this.pluginManager.notifyStoreDisposed(this);
+			return;
+		}
+		this.pluginManager.getAll().forEach((plugin) => plugin.onStoreDisposed?.(this));
+	}
+	notifyPluginStateChange(state, previousState) {
+		if (this.pluginManager.notifyStateChange) {
+			this.pluginManager.notifyStateChange(this.$id, require_deep_clone.deepClone(state), require_deep_clone.deepClone(previousState));
+			return;
+		}
+		this.pluginManager.getAll().forEach((plugin) => plugin.onStateChange?.(this.$id, require_deep_clone.deepClone(state), require_deep_clone.deepClone(previousState)));
 	}
-	/**
-	* 检查是否已销毁
-	*/
 	checkDisposed() {
-		if (this.disposed) throw new Error(`[Store] Store "${this.$id}" \u5DF2\u88AB\u9500\u6BC1`);
+		if (this.disposed) throw new Error(`[Store] Store "${this.$id}" has been disposed`);
 	}
 	createGetters(gettersDefinition) {
 		const getterCache = {};
@@ -180,6 +277,9 @@ var BaseStore = class {
 		}
 		return actionCache;
 	}
+	notifyAction(context) {
+		this.actionSubscribers.publish(context);
+	}
 };
 //#endregion
 exports.BaseStore = BaseStore;

package/lib/core/base-store.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"base-store.cjs","names":[],"sources":["../../src/core/base-store.ts"],"sourcesContent":["/**\n * 基础 Store 抽象类\n *\n * 提供框架无关的 Store 基础实现\n * @module core/base-store\n */\n\nimport type {\n  ActionContext,\n  ActionSubscriber,\n  StateMutation,\n  StateSubscriber,\n  StateTree,\n  StoreActions,\n  StoreDefinition,\n  StoreGetters,\n  StoreId,\n  StoreInstance,\n  StoreOptions,\n  SubscribeOptions,\n  Unsubscribe,\n} from '../types'\nimport { globalEventBus } from './event-bus'\nimport { createPubSub } from './pub-sub'\n\ntype ActionCallback = (value: unknown) => void | Promise<void>\n\nfunction isPromiseLike(value: unknown): value is Promise<unknown> {\n  return !!value && typeof (value as { then?: unknown }).then === 'function'\n}\n\nasync function runCallbacks(callbacks: ActionCallback[], value: unknown): Promise<void> {\n  for (const callback of callbacks) {\n    await callback(value)\n  }\n}\n\n/**\n * 基础 Store 类\n *\n * @template Id - Store ID 类型\n * @template S - 状态类型\n * @template G - Getters 类型\n * @template A - Actions 类型\n */\nexport class BaseStore<\n  Id extends StoreId = StoreId,\n  S extends StateTree = StateTree,\n  G extends StoreGetters<S> = StoreGetters<S>,\n  A extends StoreActions = StoreActions,\n> implements StoreInstance<Id, S, G, A> {\n  /** Store ID */\n  readonly $id: Id\n\n  /** Getter 计算结果 */\n  readonly getters: { [K in keyof G]: ReturnType<G[K]> }\n\n  /** Action 方法集合 */\n  readonly actions: A\n\n  /** 状态订阅管理器 */\n  private stateSubscribers = createPubSub<{ mutation: StateMutation<S>, state: S }>()\n\n  /** Action 订阅管理器 */\n  private actionSubscribers = createPubSub<ActionContext<A>>()\n\n  /** 初始状态工厂 */\n  private initialStateFactory: () => S\n\n  /** 当前状态 */\n  private _state: S\n\n  /** 是否已销毁 */\n  private disposed = false\n\n  /**\n   * 构造函数\n   *\n   * @param definition - Store 定义\n   * @param _options - Store 配置选项\n   */\n  constructor(\n    definition: StoreDefinition<Id, S, G, A>,\n    _options: StoreOptions = {},\n  ) {\n    this.$id = definition.id\n    this.initialStateFactory = definition.state\n    this._state = definition.state()\n    this.getters = this.createGetters((definition.getters || {}) as G)\n    this.actions = this.createActions((definition.actions || {}) as A)\n\n    // 发送 Store 创建事件\n    globalEventBus.emit('store:created', { storeId: this.$id })\n  }\n\n  /**\n   * 获取当前状态\n   */\n  get $state(): S {\n    return this._state\n  }\n\n  /**\n   * 设置状态\n   */\n  set $state(newState: S) {\n    this._state = newState\n  }\n\n  /**\n   * 重置状态到初始值\n   */\n  $reset(): void {\n    this.checkDisposed()\n    const oldState = { ...this._state }\n    this._state = this.initialStateFactory()\n\n    this.notifyStateChange({\n      type: 'direct',\n      storeId: this.$id,\n      oldState,\n    })\n  }\n\n  /**\n   * 批量更新状态\n   */\n  $patch(partialState: Partial<S> | ((state: S) => void)): void {\n    this.checkDisposed()\n    const oldState = { ...this._state }\n\n    if (typeof partialState === 'function') {\n      partialState(this._state)\n      this.notifyStateChange({\n        type: 'patch function',\n        storeId: this.$id,\n        oldState,\n      })\n    }\n    else {\n      Object.assign(this._state, partialState)\n      this.notifyStateChange({\n        type: 'patch object',\n        storeId: this.$id,\n        oldState,\n        events: Object.keys(partialState),\n      })\n    }\n  }\n\n  /**\n   * 订阅状态变化\n   */\n  $subscribe(\n    callback: StateSubscriber<S>,\n    options: SubscribeOptions = {},\n  ): Unsubscribe {\n    this.checkDisposed()\n\n    return this.stateSubscribers.subscribe(\n      ({ mutation, state }) => callback(mutation, state),\n      { immediate: options.immediate },\n    )\n  }\n\n  /**\n   * 订阅 Action 调用\n   */\n  $onAction(callback: ActionSubscriber<A>): Unsubscribe {\n    this.checkDisposed()\n\n    return this.actionSubscribers.subscribe(callback)\n  }\n\n  /**\n   * 销毁 Store\n   */\n  $dispose(): void {\n    if (this.disposed) return\n\n    this.disposed = true\n    this.stateSubscribers.clear()\n    this.actionSubscribers.clear()\n\n    globalEventBus.emit('store:disposed', { storeId: this.$id })\n  }\n\n  /**\n   * 通知状态变化\n   */\n  protected notifyStateChange(mutation: StateMutation<S>): void {\n    this.stateSubscribers.publish({ mutation, state: this._state })\n    globalEventBus.emit('state:changed', {\n      storeId: this.$id,\n      state: this._state,\n      mutation,\n    })\n  }\n\n  /**\n   * 通知 Action 调用\n   */\n  protected notifyAction(context: ActionContext<A>): void {\n    this.actionSubscribers.publish(context)\n  }\n\n  /**\n   * 检查是否已销毁\n   */\n  private checkDisposed(): void {\n    if (this.disposed) {\n      throw new Error(`[Store] Store \"${this.$id}\" 已被销毁`)\n    }\n  }\n\n  private createGetters(\n    gettersDefinition: G,\n  ): { [K in keyof G]: ReturnType<G[K]> } {\n    const getterCache = {} as { [K in keyof G]: ReturnType<G[K]> }\n\n    for (const key of Object.keys(gettersDefinition) as Array<keyof G>) {\n      Object.defineProperty(getterCache, key, {\n        enumerable: true,\n        get: () => gettersDefinition[key](this._state),\n      })\n    }\n\n    return getterCache\n  }\n\n  private createActions(actionsDefinition: A): A {\n    const actionCache = {} as A\n\n    for (const key of Object.keys(actionsDefinition) as Array<keyof A>) {\n      const action = actionsDefinition[key]\n      actionCache[key] = ((...args: unknown[]) => {\n        this.checkDisposed()\n\n        const afterCallbacks: ActionCallback[] = []\n        const errorCallbacks: ActionCallback[] = []\n        const context: ActionContext<A> = {\n          after: callback => afterCallbacks.push(callback),\n          args,\n          name: key,\n          onError: callback => errorCallbacks.push(callback),\n          storeId: this.$id,\n        }\n\n        this.notifyAction(context)\n\n        try {\n          const result = action.apply(this, args)\n\n          if (isPromiseLike(result)) {\n            return result\n              .then(async (resolvedResult) => {\n                await runCallbacks(afterCallbacks, resolvedResult)\n                return resolvedResult\n              })\n              .catch(async (error: unknown) => {\n                await runCallbacks(errorCallbacks, error)\n                throw error\n              }) as ReturnType<A[typeof key]>\n          }\n\n          void runCallbacks(afterCallbacks, result)\n          return result\n        }\n        catch (error) {\n          void runCallbacks(errorCallbacks, error)\n          throw error\n        }\n      }) as A[typeof key]\n    }\n\n    return actionCache\n  }\n}\n\n"],"mappings":"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"}
+{"version":3,"file":"base-store.cjs","names":[],"sources":["../../src/core/base-store.ts"],"sourcesContent":["/** Framework-independent Store runtime. */\n\nimport type {\n  ActionContext,\n  ActionSubscriber,\n  BatchManager,\n  MiddlewareManager,\n  PluginManager,\n  StateMutation,\n  StateSubscriber,\n  StateTree,\n  StoreActions,\n  StoreDefinition,\n  StoreGetters,\n  StoreId,\n  StoreInstance,\n  StoreOptions,\n  SubscribeOptions,\n  Unsubscribe,\n} from '../types'\nimport { getGlobalMiddlewareManager } from '../middleware/middleware-manager'\nimport { getGlobalPluginManager } from '../plugins/plugin-manager'\nimport { deepClone } from '../utils'\nimport { getGlobalBatchManager } from './batch-manager'\nimport { globalEventBus } from './event-bus'\nimport { createPubSub } from './pub-sub'\n\ntype ActionCallback = (value: unknown) => void | Promise<void>\n\nfunction isPromiseLike(value: unknown): value is Promise<unknown> {\n  return !!value && typeof (value as { then?: unknown }).then === 'function'\n}\n\nasync function runCallbacks(\n  callbacks: ActionCallback[],\n  value: unknown\n): Promise<void> {\n  for (const callback of callbacks) {\n    await callback(value)\n  }\n}\n\n/**\n * Base Store implementation.\n *\n * State changes are built on a candidate state. Middleware can reject the\n * candidate before it is committed, while stores without middleware retain\n * synchronous patch semantics.\n */\nexport class BaseStore<\n  Id extends StoreId = StoreId,\n  S extends StateTree = StateTree,\n  G extends StoreGetters<S> = StoreGetters<S>,\n  A extends StoreActions = StoreActions,\n> implements StoreInstance<Id, S, G, A> {\n  readonly $id: Id\n  readonly getters: { [K in keyof G]: ReturnType<G[K]> }\n  readonly actions: A\n\n  private readonly stateSubscribers = createPubSub<{\n    mutation: StateMutation<S>\n    state: S\n  }>()\n  private readonly actionSubscribers = createPubSub<ActionContext<A>>()\n  private readonly initialStateFactory: () => S\n  private readonly middlewareManager: MiddlewareManager\n  private readonly pluginManager: PluginManager\n  private readonly batchManager: BatchManager\n  private pendingBatchMutation: StateMutation<S> | null = null\n  private stopBatchFlush: Unsubscribe | undefined\n  private mutationQueue: Promise<void> = Promise.resolve()\n  private pendingMutations = 0\n  private _state: S\n  private disposed = false\n\n  constructor(\n    definition: StoreDefinition<Id, S, G, A>,\n    options: StoreOptions = {}\n  ) {\n    this.$id = definition.id\n    this.initialStateFactory = definition.state\n    this._state = definition.state()\n    this.middlewareManager = options.middleware ?? getGlobalMiddlewareManager()\n    this.pluginManager = options.plugins ?? getGlobalPluginManager()\n    this.batchManager = options.batch ?? getGlobalBatchManager()\n    this.getters = this.createGetters((definition.getters || {}) as G)\n    this.actions = this.createActions((definition.actions || {}) as A)\n\n    this.stopBatchFlush = this.batchManager.onFlush?.(storeIds => {\n      if (!storeIds.has(this.$id) || !this.pendingBatchMutation) {\n        return\n      }\n\n      const mutation = this.pendingBatchMutation\n      this.pendingBatchMutation = null\n      this.publishStateChange(mutation)\n    })\n\n    globalEventBus.emit('store:created', { storeId: this.$id })\n    this.notifyPluginStoreCreated()\n  }\n\n  get $state(): S {\n    return this._state\n  }\n\n  set $state(newState: S) {\n    this.checkDisposed()\n    const nextState = deepClone(newState)\n    const operation = () => this.runStateMutation(nextState, newState)\n    void this.scheduleMutation(operation).catch((error: unknown) => {\n      console.error(`[Store] Failed to replace state for \"${this.$id}\":`, error)\n    })\n  }\n\n  $reset(): void {\n    this.checkDisposed()\n    void this.scheduleMutation(() => this.runStateMutation()).catch(\n      (error: unknown) => {\n        console.error(`[Store] Failed to reset \"${this.$id}\":`, error)\n      }\n    )\n  }\n\n  $patch(partialState: Partial<S> | ((state: S) => void)): void {\n    this.checkDisposed()\n    const patch =\n      typeof partialState === 'function'\n        ? partialState\n        : deepClone(partialState)\n    void this.scheduleMutation(() => this.runPatchMutation(patch)).catch(\n      (error: unknown) => {\n        console.error(`[Store] Failed to patch \"${this.$id}\":`, error)\n      }\n    )\n  }\n\n  async $patchAsync(\n    partialState: Partial<S> | ((state: S) => void)\n  ): Promise<void> {\n    this.checkDisposed()\n    const patch =\n      typeof partialState === 'function'\n        ? partialState\n        : deepClone(partialState)\n    await this.scheduleMutation(() => this.runPatchMutation(patch))\n  }\n\n  $subscribe(\n    callback: StateSubscriber<S>,\n    options: SubscribeOptions = {}\n  ): Unsubscribe {\n    this.checkDisposed()\n    const unsubscribe = this.stateSubscribers.subscribe(\n      ({ mutation, state }) => callback(mutation, state),\n      { immediate: options.immediate }\n    )\n\n    if (options.immediate) {\n      try {\n        callback({ type: 'direct', storeId: this.$id }, deepClone(this._state))\n      } catch (error) {\n        console.error('[Store] immediate subscriber failed:', error)\n      }\n    }\n\n    return unsubscribe\n  }\n\n  $onAction(callback: ActionSubscriber<A>): Unsubscribe {\n    this.checkDisposed()\n    return this.actionSubscribers.subscribe(callback)\n  }\n\n  $dispose(): void {\n    if (this.disposed) return\n\n    this.disposed = true\n    this.stopBatchFlush?.()\n    this.stopBatchFlush = undefined\n    this.mutationQueue = Promise.resolve()\n    this.pendingMutations = 0\n    this.stateSubscribers.clear()\n    this.actionSubscribers.clear()\n    this.notifyPluginStoreDisposed()\n    globalEventBus.emit('store:disposed', { storeId: this.$id })\n  }\n\n  protected notifyStateChange(mutation: StateMutation<S>): void {\n    this.publishStateChange(mutation)\n  }\n\n  private publishStateChange(mutation: StateMutation<S>): void {\n    const stateSnapshot = deepClone(this._state)\n    this.stateSubscribers.publish({ mutation, state: stateSnapshot })\n    globalEventBus.emit('state:changed', {\n      storeId: this.$id,\n      state: stateSnapshot,\n      mutation,\n    })\n  }\n\n  private async runMutation(\n    candidate: S,\n    mutation: StateMutation<S>,\n    payload: unknown,\n    previousState: S\n  ): Promise<void> {\n    this.checkDisposed()\n    let committed = false\n    const commit = (): void => {\n      if (committed || this.disposed) return\n\n      committed = true\n      this._state = candidate\n      this.notifyPluginStateChange(candidate, previousState)\n\n      if (this.batchManager.isBatching() && this.batchManager.onFlush) {\n        this.pendingBatchMutation = this.pendingBatchMutation\n          ? { ...mutation, oldState: this.pendingBatchMutation.oldState }\n          : mutation\n        this.batchManager.markDirty(this.$id)\n      } else {\n        this.publishStateChange(mutation)\n      }\n    }\n\n    const middlewares = this.middlewareManager.getAll()\n    if (middlewares.length === 0) {\n      commit()\n      return\n    }\n\n    await this.middlewareManager.execute({\n      storeId: this.$id,\n      state: candidate,\n      type: mutation.type === 'direct' ? 'state:reset' : 'state:patch',\n      payload,\n      meta: {\n        candidateState: candidate,\n        previousState,\n        commit,\n      },\n    })\n    commit()\n  }\n\n  private runStateMutation(nextState?: S, payload?: unknown): Promise<void> {\n    this.checkDisposed()\n    const previousState = deepClone(this._state)\n    const mutation: StateMutation<S> = {\n      type: 'direct',\n      storeId: this.$id,\n      oldState: previousState,\n    }\n    return this.runMutation(\n      deepClone(nextState ?? this.initialStateFactory()),\n      mutation,\n      payload,\n      previousState\n    )\n  }\n\n  private runPatchMutation(\n    partialState: Partial<S> | ((state: S) => void)\n  ): Promise<void> {\n    this.checkDisposed()\n    const previousState = deepClone(this._state)\n    const candidate = deepClone(this._state)\n    const mutation: StateMutation<S> =\n      typeof partialState === 'function'\n        ? { type: 'patch function', storeId: this.$id, oldState: previousState }\n        : {\n            type: 'patch object',\n            storeId: this.$id,\n            oldState: previousState,\n            events: Object.keys(partialState),\n          }\n\n    if (typeof partialState === 'function') {\n      partialState(candidate)\n    } else {\n      Object.assign(candidate, partialState)\n    }\n\n    return this.runMutation(candidate, mutation, partialState, previousState)\n  }\n\n  private scheduleMutation(operation: () => Promise<void>): Promise<void> {\n    if (\n      this.pendingMutations === 0 &&\n      this.middlewareManager.getAll().length === 0\n    ) {\n      return operation()\n    }\n\n    this.pendingMutations += 1\n    const queuedOperation = this.mutationQueue.then(operation)\n    this.mutationQueue = queuedOperation.catch(() => undefined)\n    void queuedOperation.then(\n      () => {\n        this.pendingMutations -= 1\n      },\n      () => {\n        this.pendingMutations -= 1\n      }\n    )\n    return queuedOperation\n  }\n\n  private notifyPluginStoreCreated(): void {\n    if (this.pluginManager.notifyStoreCreated) {\n      this.pluginManager.notifyStoreCreated(this)\n      return\n    }\n    this.pluginManager.getAll().forEach(plugin => plugin.onStoreCreated?.(this))\n  }\n\n  private notifyPluginStoreDisposed(): void {\n    if (this.pluginManager.notifyStoreDisposed) {\n      this.pluginManager.notifyStoreDisposed(this)\n      return\n    }\n    this.pluginManager\n      .getAll()\n      .forEach(plugin => plugin.onStoreDisposed?.(this))\n  }\n\n  private notifyPluginStateChange(state: S, previousState: S): void {\n    if (this.pluginManager.notifyStateChange) {\n      this.pluginManager.notifyStateChange(\n        this.$id,\n        deepClone(state),\n        deepClone(previousState)\n      )\n      return\n    }\n    this.pluginManager\n      .getAll()\n      .forEach(plugin =>\n        plugin.onStateChange?.(\n          this.$id,\n          deepClone(state),\n          deepClone(previousState)\n        )\n      )\n  }\n\n  private checkDisposed(): void {\n    if (this.disposed) {\n      throw new Error(`[Store] Store \"${this.$id}\" has been disposed`)\n    }\n  }\n\n  private createGetters(gettersDefinition: G): {\n    [K in keyof G]: ReturnType<G[K]>\n  } {\n    const getterCache = {} as { [K in keyof G]: ReturnType<G[K]> }\n\n    for (const key of Object.keys(gettersDefinition) as Array<keyof G>) {\n      Object.defineProperty(getterCache, key, {\n        enumerable: true,\n        get: () => gettersDefinition[key](this._state),\n      })\n    }\n\n    return getterCache\n  }\n\n  private createActions(actionsDefinition: A): A {\n    const actionCache = {} as A\n\n    for (const key of Object.keys(actionsDefinition) as Array<keyof A>) {\n      const action = actionsDefinition[key]\n      actionCache[key] = ((...args: unknown[]) => {\n        this.checkDisposed()\n\n        const afterCallbacks: ActionCallback[] = []\n        const errorCallbacks: ActionCallback[] = []\n        const context: ActionContext<A> = {\n          after: callback => afterCallbacks.push(callback),\n          args,\n          name: key,\n          onError: callback => errorCallbacks.push(callback),\n          storeId: this.$id,\n        }\n\n        this.notifyAction(context)\n\n        try {\n          const result = action.apply(this, args)\n          if (isPromiseLike(result)) {\n            return result\n              .then(async resolvedResult => {\n                await runCallbacks(afterCallbacks, resolvedResult)\n                return resolvedResult\n              })\n              .catch(async (error: unknown) => {\n                await runCallbacks(errorCallbacks, error)\n                throw error\n              }) as ReturnType<A[typeof key]>\n          }\n\n          void runCallbacks(afterCallbacks, result)\n          return result\n        } catch (error) {\n          void runCallbacks(errorCallbacks, error)\n          throw error\n        }\n      }) as A[typeof key]\n    }\n\n    return actionCache\n  }\n\n  private notifyAction(context: ActionContext<A>): void {\n    this.actionSubscribers.publish(context)\n  }\n}\n"],"mappings":"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"}

package/lib/core/base-store.d.cts

@@ -0,0 +1,50 @@
+/** Framework-independent Store runtime. */
+import type { ActionSubscriber, StateMutation, StateSubscriber, StateTree, StoreActions, StoreDefinition, StoreGetters, StoreId, StoreInstance, StoreOptions, SubscribeOptions, Unsubscribe } from '../types';
+/**
+ * Base Store implementation.
+ *
+ * State changes are built on a candidate state. Middleware can reject the
+ * candidate before it is committed, while stores without middleware retain
+ * synchronous patch semantics.
+ */
+export declare class BaseStore<Id extends StoreId = StoreId, S extends StateTree = StateTree, G extends StoreGetters<S> = StoreGetters<S>, A extends StoreActions = StoreActions> implements StoreInstance<Id, S, G, A> {
+    readonly $id: Id;
+    readonly getters: {
+        [K in keyof G]: ReturnType<G[K]>;
+    };
+    readonly actions: A;
+    private readonly stateSubscribers;
+    private readonly actionSubscribers;
+    private readonly initialStateFactory;
+    private readonly middlewareManager;
+    private readonly pluginManager;
+    private readonly batchManager;
+    private pendingBatchMutation;
+    private stopBatchFlush;
+    private mutationQueue;
+    private pendingMutations;
+    private _state;
+    private disposed;
+    constructor(definition: StoreDefinition<Id, S, G, A>, options?: StoreOptions);
+    get $state(): S;
+    set $state(newState: S);
+    $reset(): void;
+    $patch(partialState: Partial<S> | ((state: S) => void)): void;
+    $patchAsync(partialState: Partial<S> | ((state: S) => void)): Promise<void>;
+    $subscribe(callback: StateSubscriber<S>, options?: SubscribeOptions): Unsubscribe;
+    $onAction(callback: ActionSubscriber<A>): Unsubscribe;
+    $dispose(): void;
+    protected notifyStateChange(mutation: StateMutation<S>): void;
+    private publishStateChange;
+    private runMutation;
+    private runStateMutation;
+    private runPatchMutation;
+    private scheduleMutation;
+    private notifyPluginStoreCreated;
+    private notifyPluginStoreDisposed;
+    private notifyPluginStateChange;
+    private checkDisposed;
+    private createGetters;
+    private createActions;
+    private notifyAction;
+}

package/lib/core/batch-manager.cjs

@@ -2,7 +2,7 @@
 * ***********************************
 * @composy/store-core v0.0.1      *
 * Built with rollup               *
-* Build time: 2024-08-17 11:27:33 *
+* Build time: 2024-10-12 17:23:58 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************
@@ -12,12 +12,20 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/core/batch-manager.ts
 function createBatchManager(onFlush) {
 	let batchDepth = 0;
+	const flushListeners = /* @__PURE__ */ new Set();
 	const pendingStores = /* @__PURE__ */ new Set();
 	const flush = () => {
 		if (pendingStores.size > 0) {
 			const stores = new Set(pendingStores);
 			pendingStores.clear();
 			onFlush?.(stores);
+			flushListeners.forEach((listener) => {
+				try {
+					listener(stores);
+				} catch (error) {
+					console.error("[Batch] flush listener failed:", error);
+				}
+			});
 		}
 	};
 	const start = () => {
@@ -41,12 +49,17 @@ function createBatchManager(onFlush) {
 		}
 	};
 	const isBatching = () => batchDepth > 0;
+	const onFlushListener = (listener) => {
+		flushListeners.add(listener);
+		return () => flushListeners.delete(listener);
+	};
 	return {
 		start,
 		end,
 		markDirty,
 		batch: batch2,
-		isBatching
+		isBatching,
+		onFlush: onFlushListener
 	};
 }
 let globalBatchManager = null;

package/lib/core/batch-manager.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"batch-manager.cjs","names":["batch"],"sources":["../../src/core/batch-manager.ts"],"sourcesContent":["/**\n * 批量更新管理器\n *\n * 用于优化多个状态更新的性能\n * @module core/batch-manager\n */\n\nimport type { BatchManager, StoreId } from '../types'\n\n/**\n * 创建批量更新管理器\n *\n * @param onFlush - 刷新回调，接收所有待更新的 Store ID\n * @returns 批量更新管理器实例\n *\n * @example\n * ```typescript\n * const batchManager = createBatchManager((storeIds) => {\n *   storeIds.forEach(id => {\n *     // 通知订阅者更新\n *     notifySubscribers(id)\n *   })\n * })\n *\n * // 批量更新\n * batchManager.batch(() => {\n *   store1.count++\n *   store2.name = 'new name'\n * })\n * ```\n */\nexport function createBatchManager(\n  onFlush?: (storeIds: Set<StoreId>) => void,\n): BatchManager {\n  /** 批处理嵌套深度，0 表示不在批处理上下文。 */\n  let batchDepth = 0\n\n  /** 待更新的 Store ID 集合 */\n  const pendingStores = new Set<StoreId>()\n\n  /**\n   * 刷新待更新的 Store\n   */\n  const flush = (): void => {\n    if (pendingStores.size > 0) {\n      const stores = new Set(pendingStores)\n      pendingStores.clear()\n      onFlush?.(stores)\n    }\n  }\n\n  /**\n   * 开始批量更新\n   */\n  const start = (): void => {\n    batchDepth++\n  }\n\n  /**\n   * 结束批量更新\n   */\n  const end = (): void => {\n    if (batchDepth === 0) {\n      return\n    }\n\n    batchDepth--\n    if (batchDepth === 0) {\n      flush()\n    }\n  }\n\n  /**\n   * 标记 Store 需要更新\n   */\n  const markDirty = (storeId: StoreId): void => {\n    pendingStores.add(storeId)\n\n    // 如果不在批量更新中，立即刷新\n    if (batchDepth === 0) {\n      flush()\n    }\n  }\n\n  /**\n   * 在批量上下文中执行\n   */\n  const batch = <T>(fn: () => T): T => {\n    start()\n    try {\n      return fn()\n    }\n    finally {\n      end()\n    }\n  }\n\n  /**\n   * 是否正在批量更新\n   */\n  const isBatching = (): boolean => batchDepth > 0\n\n  return {\n    start,\n    end,\n    markDirty,\n    batch,\n    isBatching,\n  }\n}\n\n/**\n * 全局批量更新管理器\n */\nlet globalBatchManager: BatchManager | null = null\n\n/**\n * 获取全局批量更新管理器\n */\nexport function getGlobalBatchManager(): BatchManager {\n  if (!globalBatchManager) {\n    globalBatchManager = createBatchManager()\n  }\n  return globalBatchManager\n}\n\n/**\n * 设置全局批量更新管理器\n */\nexport function setGlobalBatchManager(manager: BatchManager): void {\n  globalBatchManager = manager\n}\n\n/**\n * 批量更新辅助函数\n *\n * @param fn - 执行函数\n * @returns 执行结果\n */\nexport function batch<T>(fn: () => T): T {\n  return getGlobalBatchManager().batch(fn)\n}\n\n"],"mappings":";;;;;;;;;;;;AA+BO,SAAS,mBACd,SACc;CAEd,IAAI,aAAa;CAGjB,MAAM,gCAAgB,IAAI,IAAa;CAKvC,MAAM,cAAoB;EACxB,IAAI,cAAc,OAAO,GAAG;GAC1B,MAAM,SAAS,IAAI,IAAI,aAAa;GACpC,cAAc,MAAM;GACpB,UAAU,MAAM;EAClB;CACF;CAKA,MAAM,cAAoB;EACxB;CACF;CAKA,MAAM,YAAkB;EACtB,IAAI,eAAe,GACjB;EAGF;EACA,IAAI,eAAe,GACjB,MAAM;CAEV;CAKA,MAAM,aAAa,YAA2B;EAC5C,cAAc,IAAI,OAAO;EAGzB,IAAI,eAAe,GACjB,MAAM;CAEV;CAKA,MAAMA,UAAY,OAAmB;EACnC,MAAM;EACN,IAAI;GACF,OAAO,GAAG;EACZ,UACA;GACE,IAAI;EACN;CACF;CAKA,MAAM,mBAA4B,aAAa;CAE/C,OAAO;EACL;EACA;EACA;EACA,OAAAA;EACA;CACF;AACF;AAKA,IAAI,qBAA0C;AAKvC,SAAS,wBAAsC;CACpD,IAAI,CAAC,oBACH,qBAAqB,mBAAmB;CAE1C,OAAO;AACT;AAKO,SAAS,sBAAsB,SAA6B;CACjE,qBAAqB;AACvB;AAQO,SAAS,MAAS,IAAgB;CACvC,OAAO,sBAAsB,CAAA,CAAE,MAAM,EAAE;AACzC"}
+{"version":3,"file":"batch-manager.cjs","names":["batch"],"sources":["../../src/core/batch-manager.ts"],"sourcesContent":["/**\r\n * 批量更新管理器\r\n *\r\n * 用于优化多个状态更新的性能\r\n * @module core/batch-manager\r\n */\r\n\r\nimport type { BatchManager, StoreId, Unsubscribe } from '../types'\r\n\r\n/**\r\n * 创建批量更新管理器\r\n *\r\n * @param onFlush - 刷新回调，接收所有待更新的 Store ID\r\n * @returns 批量更新管理器实例\r\n *\r\n * @example\r\n * ```typescript\r\n * const batchManager = createBatchManager((storeIds) => {\r\n *   storeIds.forEach(id => {\r\n *     // 通知订阅者更新\r\n *     notifySubscribers(id)\r\n *   })\r\n * })\r\n *\r\n * // 批量更新\r\n * batchManager.batch(() => {\r\n *   store1.count++\r\n *   store2.name = 'new name'\r\n * })\r\n * ```\r\n */\r\nexport function createBatchManager(\r\n  onFlush?: (storeIds: Set<StoreId>) => void\r\n): BatchManager {\r\n  /** 批处理嵌套深度，0 表示不在批处理上下文。 */\r\n  let batchDepth = 0\r\n\r\n  /** 批处理完成监听器，允许 Store Runtime 延迟一次通知 */\r\n  const flushListeners = new Set<(storeIds: Set<StoreId>) => void>()\r\n\r\n  /** 待更新的 Store ID 集合 */\r\n  const pendingStores = new Set<StoreId>()\r\n\r\n  /**\r\n   * 刷新待更新的 Store\r\n   */\r\n  const flush = (): void => {\r\n    if (pendingStores.size > 0) {\r\n      const stores = new Set(pendingStores)\r\n      pendingStores.clear()\r\n      onFlush?.(stores)\r\n      flushListeners.forEach(listener => {\r\n        try {\r\n          listener(stores)\r\n        } catch (error) {\r\n          console.error('[Batch] flush listener failed:', error)\r\n        }\r\n      })\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 开始批量更新\r\n   */\r\n  const start = (): void => {\r\n    batchDepth++\r\n  }\r\n\r\n  /**\r\n   * 结束批量更新\r\n   */\r\n  const end = (): void => {\r\n    if (batchDepth === 0) {\r\n      return\r\n    }\r\n\r\n    batchDepth--\r\n    if (batchDepth === 0) {\r\n      flush()\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 标记 Store 需要更新\r\n   */\r\n  const markDirty = (storeId: StoreId): void => {\r\n    pendingStores.add(storeId)\r\n\r\n    // 如果不在批量更新中，立即刷新\r\n    if (batchDepth === 0) {\r\n      flush()\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 在批量上下文中执行\r\n   */\r\n  const batch = <T>(fn: () => T): T => {\r\n    start()\r\n    try {\r\n      return fn()\r\n    } finally {\r\n      end()\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 是否正在批量更新\r\n   */\r\n  const isBatching = (): boolean => batchDepth > 0\r\n\r\n  const onFlushListener = (\r\n    listener: (storeIds: Set<StoreId>) => void\r\n  ): Unsubscribe => {\r\n    flushListeners.add(listener)\r\n    return () => flushListeners.delete(listener)\r\n  }\r\n\r\n  return {\r\n    start,\r\n    end,\r\n    markDirty,\r\n    batch,\r\n    isBatching,\r\n    onFlush: onFlushListener,\r\n  }\r\n}\r\n\r\n/**\r\n * 全局批量更新管理器\r\n */\r\nlet globalBatchManager: BatchManager | null = null\r\n\r\n/**\r\n * 获取全局批量更新管理器\r\n */\r\nexport function getGlobalBatchManager(): BatchManager {\r\n  if (!globalBatchManager) {\r\n    globalBatchManager = createBatchManager()\r\n  }\r\n  return globalBatchManager\r\n}\r\n\r\n/**\r\n * 设置全局批量更新管理器\r\n */\r\nexport function setGlobalBatchManager(manager: BatchManager): void {\r\n  globalBatchManager = manager\r\n}\r\n\r\n/**\r\n * 批量更新辅助函数\r\n *\r\n * @param fn - 执行函数\r\n * @returns 执行结果\r\n */\r\nexport function batch<T>(fn: () => T): T {\r\n  return getGlobalBatchManager().batch(fn)\r\n}\r\n"],"mappings":";;;;;;;;;;;;AA+BO,SAAS,mBACd,SACc;CAEd,IAAI,aAAa;CAGjB,MAAM,iCAAiB,IAAI,IAAsC;CAGjE,MAAM,gCAAgB,IAAI,IAAa;CAKvC,MAAM,cAAoB;EACxB,IAAI,cAAc,OAAO,GAAG;GAC1B,MAAM,SAAS,IAAI,IAAI,aAAa;GACpC,cAAc,MAAM;GACpB,UAAU,MAAM;GAChB,eAAe,SAAQ,aAAY;IACjC,IAAI;KACF,SAAS,MAAM;IACjB,SAAS,OAAO;KACd,QAAQ,MAAM,kCAAkC,KAAK;IACvD;GACF,CAAC;EACH;CACF;CAKA,MAAM,cAAoB;EACxB;CACF;CAKA,MAAM,YAAkB;EACtB,IAAI,eAAe,GACjB;EAGF;EACA,IAAI,eAAe,GACjB,MAAM;CAEV;CAKA,MAAM,aAAa,YAA2B;EAC5C,cAAc,IAAI,OAAO;EAGzB,IAAI,eAAe,GACjB,MAAM;CAEV;CAKA,MAAMA,UAAY,OAAmB;EACnC,MAAM;EACN,IAAI;GACF,OAAO,GAAG;EACZ,UAAE;GACA,IAAI;EACN;CACF;CAKA,MAAM,mBAA4B,aAAa;CAE/C,MAAM,mBACJ,aACgB;EAChB,eAAe,IAAI,QAAQ;EAC3B,aAAa,eAAe,OAAO,QAAQ;CAC7C;CAEA,OAAO;EACL;EACA;EACA;EACA,OAAAA;EACA;EACA,SAAS;CACX;AACF;AAKA,IAAI,qBAA0C;AAKvC,SAAS,wBAAsC;CACpD,IAAI,CAAC,oBACH,qBAAqB,mBAAmB;CAE1C,OAAO;AACT;AAKO,SAAS,sBAAsB,SAA6B;CACjE,qBAAqB;AACvB;AAQO,SAAS,MAAS,IAAgB;CACvC,OAAO,sBAAsB,CAAA,CAAE,MAAM,EAAE;AACzC"}

package/{esm/core/batch-manager.d.ts → lib/core/batch-manager.d.cts}

@@ -43,4 +43,3 @@ export declare function setGlobalBatchManager(manager: BatchManager): void;
  * @returns 执行结果
  */
 export declare function batch<T>(fn: () => T): T;
-//# sourceMappingURL=batch-manager.d.ts.map

package/lib/core/create-store.cjs

@@ -2,7 +2,7 @@
 * ***********************************
 * @composy/store-core v0.0.1      *
 * Built with rollup               *
-* Build time: 2024-08-17 11:27:33 *
+* Build time: 2024-10-12 17:23:58 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************
@@ -11,11 +11,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_base_store = require("./base-store.cjs");
 //#region src/core/create-store.ts
-function createStore(definition) {
+function createStore(definition, options = {}) {
 	let instance = null;
 	return () => {
 		if (instance) return instance;
-		const store = new require_base_store.BaseStore(definition);
+		const store = new require_base_store.BaseStore(definition, options);
 		const originalDispose = store.$dispose.bind(store);
 		store.$dispose = () => {
 			originalDispose();

package/lib/core/create-store.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-store.cjs","names":[],"sources":["../../src/core/create-store.ts"],"sourcesContent":["/**\n * @module store/core/create-store\n *\n * Store 工厂函数，用于创建单例 Store 的惰性初始化函数。\n * 基于 BaseStore 实现，返回的工厂函数在首次调用时创建 Store 实例，\n * 后续调用返回同一实例，直到调用 $dispose() 后重置。\n */\n\nimport type {\n  ActionSubscriber,\n  StateMutation,\n  StateSubscriber,\n  StateTree,\n  StoreId,\n  Unsubscribe,\n} from '../types'\nimport { BaseStore } from './base-store'\n\n/**\n * Store 定义描述接口\n *\n * @typeParam Id - Store 唯一标识符类型\n * @typeParam S - 状态树类型\n * @typeParam G - 计算属性定义类型\n * @typeParam A - Action 定义类型\n */\nexport interface CreateStoreDefinition<\n  Id extends StoreId,\n  S extends StateTree,\n  G extends Record<string, (state: S) => unknown>,\n  A extends Record<string, (this: StoreAPI<Id, S, G, A>, ...args: unknown[]) => unknown>,\n> {\n  id: Id\n  state: () => S\n  getters?: G\n  actions?: A\n}\n\n/**\n * Store 实例的公共 API 接口\n *\n * 提供状态读取、订阅、补丁、重置、Action 监听和生命周期管理等能力。\n *\n * @typeParam Id - Store 唯一标识符类型\n * @typeParam S - 状态树类型\n * @typeParam G - 计算属性定义类型\n * @typeParam A - Action 定义类型\n */\nexport interface StoreAPI<\n  Id extends StoreId = StoreId,\n  S extends StateTree = StateTree,\n  G extends Record<string, (state: S) => unknown> = Record<string, never>,\n  A extends Record<string, (...args: unknown[]) => unknown> = Record<string, never>,\n> {\n  readonly $id: Id\n  readonly $state: S\n  $reset: () => void\n  $patch: (partial: Partial<S> | ((state: S) => void)) => void\n  $subscribe: (callback: StateSubscriber<S>, options?: { immediate?: boolean }) => Unsubscribe\n  $onAction: (callback: ActionSubscriber<A>) => Unsubscribe\n  $dispose: () => void\n  readonly getters: { [K in keyof G]: ReturnType<G[K]> }\n  readonly actions: { [K in keyof A]: A[K] }\n}\n\n/**\n * 创建 Store 的工厂函数\n *\n * 返回一个惰性初始化的工厂函数。首次调用时基于定义创建 Store 实例，\n * 后续调用返回缓存的单例，直到 $dispose() 被调用后重置。\n *\n * @typeParam Id - Store 唯一标识符类型\n * @typeParam S - 状态树类型\n * @typeParam G - 计算属性定义类型\n * @typeParam A - Action 定义类型\n * @param definition - Store 定义，包含 id、state 工厂、getters 和 actions\n * @returns 惰性初始化的 Store 工厂函数，调用后返回 StoreAPI 实例\n */\nexport function createStore<\n  Id extends StoreId,\n  S extends StateTree,\n  G extends Record<string, (state: S) => unknown> = Record<string, never>,\n  A extends Record<string, (this: StoreAPI<Id, S, G, A>, ...args: unknown[]) => unknown> = Record<string, never>,\n>(\n  definition: CreateStoreDefinition<Id, S, G, A>,\n): () => StoreAPI<Id, S, G, A> {\n  let instance: StoreAPI<Id, S, G, A> | null = null\n\n  return (): StoreAPI<Id, S, G, A> => {\n    if (instance) {\n      return instance\n    }\n\n    const store = new BaseStore<Id, S, G, A>(definition)\n    const originalDispose = store.$dispose.bind(store)\n    store.$dispose = (): void => {\n      originalDispose()\n      instance = null\n    }\n\n    instance = store as unknown as StoreAPI<Id, S, G, A>\n\n    return store\n  }\n}\n\n/** 状态变更类型，支持部分更新或通过函数直接修改状态 */\nexport type { StateMutation }\n"],"mappings":";;;;;;;;;;;;;AA8EO,SAAS,YAMd,YAC6B;CAC7B,IAAI,WAAyC;CAE7C,aAAoC;EAClC,IAAI,UACF,OAAO;EAGT,MAAM,QAAQ,IAAI,mBAAA,UAAuB,UAAU;EACnD,MAAM,kBAAkB,MAAM,SAAS,KAAK,KAAK;EACjD,MAAM,iBAAuB;GAC3B,gBAAgB;GAChB,WAAW;EACb;EAEA,WAAW;EAEX,OAAO;CACT;AACF"}
+{"version":3,"file":"create-store.cjs","names":[],"sources":["../../src/core/create-store.ts"],"sourcesContent":["/**\r\n * @module store/core/create-store\r\n *\r\n * Store 工厂函数，用于创建单例 Store 的惰性初始化函数。\r\n * 基于 BaseStore 实现，返回的工厂函数在首次调用时创建 Store 实例，\r\n * 后续调用返回同一实例，直到调用 $dispose() 后重置。\r\n */\r\n\r\nimport type {\r\n  ActionSubscriber,\r\n  StateMutation,\r\n  StateSubscriber,\r\n  StateTree,\r\n  StoreId,\r\n  StoreOptions,\r\n  Unsubscribe,\r\n} from '../types'\r\nimport { BaseStore } from './base-store'\r\n\r\n/**\r\n * Store 定义描述接口\r\n *\r\n * @typeParam Id - Store 唯一标识符类型\r\n * @typeParam S - 状态树类型\r\n * @typeParam G - 计算属性定义类型\r\n * @typeParam A - Action 定义类型\r\n */\r\nexport interface CreateStoreDefinition<\r\n  Id extends StoreId,\r\n  S extends StateTree,\r\n  G extends Record<string, (state: S) => unknown>,\r\n  A extends Record<\r\n    string,\r\n    (this: StoreAPI<Id, S, G, A>, ...args: unknown[]) => unknown\r\n  >,\r\n> {\r\n  id: Id\r\n  state: () => S\r\n  getters?: G\r\n  actions?: A\r\n}\r\n\r\n/**\r\n * Store 实例的公共 API 接口\r\n *\r\n * 提供状态读取、订阅、补丁、重置、Action 监听和生命周期管理等能力。\r\n *\r\n * @typeParam Id - Store 唯一标识符类型\r\n * @typeParam S - 状态树类型\r\n * @typeParam G - 计算属性定义类型\r\n * @typeParam A - Action 定义类型\r\n */\r\nexport interface StoreAPI<\r\n  Id extends StoreId = StoreId,\r\n  S extends StateTree = StateTree,\r\n  G extends Record<string, (state: S) => unknown> = Record<string, never>,\r\n  A extends Record<string, (...args: unknown[]) => unknown> = Record<\r\n    string,\r\n    never\r\n  >,\r\n> {\r\n  readonly $id: Id\r\n  readonly $state: S\r\n  $reset: () => void\r\n  $patch: (partial: Partial<S> | ((state: S) => void)) => void\r\n  $patchAsync: (partial: Partial<S> | ((state: S) => void)) => Promise<void>\r\n  $subscribe: (\r\n    callback: StateSubscriber<S>,\r\n    options?: { immediate?: boolean }\r\n  ) => Unsubscribe\r\n  $onAction: (callback: ActionSubscriber<A>) => Unsubscribe\r\n  $dispose: () => void\r\n  readonly getters: { [K in keyof G]: ReturnType<G[K]> }\r\n  readonly actions: { [K in keyof A]: A[K] }\r\n}\r\n\r\n/**\r\n * 创建 Store 的工厂函数\r\n *\r\n * 返回一个惰性初始化的工厂函数。首次调用时基于定义创建 Store 实例，\r\n * 后续调用返回缓存的单例，直到 $dispose() 被调用后重置。\r\n *\r\n * @typeParam Id - Store 唯一标识符类型\r\n * @typeParam S - 状态树类型\r\n * @typeParam G - 计算属性定义类型\r\n * @typeParam A - Action 定义类型\r\n * @param definition - Store 定义，包含 id、state 工厂、getters 和 actions\r\n * @returns 惰性初始化的 Store 工厂函数，调用后返回 StoreAPI 实例\r\n */\r\nexport function createStore<\r\n  Id extends StoreId,\r\n  S extends StateTree,\r\n  G extends Record<string, (state: S) => unknown> = Record<string, never>,\r\n  A extends Record<\r\n    string,\r\n    (this: StoreAPI<Id, S, G, A>, ...args: unknown[]) => unknown\r\n  > = Record<string, never>,\r\n>(\r\n  definition: CreateStoreDefinition<Id, S, G, A>,\r\n  options: StoreOptions = {}\r\n): () => StoreAPI<Id, S, G, A> {\r\n  let instance: StoreAPI<Id, S, G, A> | null = null\r\n\r\n  return (): StoreAPI<Id, S, G, A> => {\r\n    if (instance) {\r\n      return instance\r\n    }\r\n\r\n    const store = new BaseStore<Id, S, G, A>(definition, options)\r\n    const originalDispose = store.$dispose.bind(store)\r\n    store.$dispose = (): void => {\r\n      originalDispose()\r\n      instance = null\r\n    }\r\n\r\n    instance = store as unknown as StoreAPI<Id, S, G, A>\r\n\r\n    return store\r\n  }\r\n}\r\n\r\n/** 状态变更类型，支持部分更新或通过函数直接修改状态 */\r\nexport type { StateMutation }\r\n"],"mappings":";;;;;;;;;;;;;AAyFO,SAAS,YASd,YACA,UAAwB,CAAC,GACI;CAC7B,IAAI,WAAyC;CAE7C,aAAoC;EAClC,IAAI,UACF,OAAO;EAGT,MAAM,QAAQ,IAAI,mBAAA,UAAuB,YAAY,OAAO;EAC5D,MAAM,kBAAkB,MAAM,SAAS,KAAK,KAAK;EACjD,MAAM,iBAAuB;GAC3B,gBAAgB;GAChB,WAAW;EACb;EAEA,WAAW;EAEX,OAAO;CACT;AACF"}

package/lib/core/{create-store.d.ts → create-store.d.cts}

@@ -5,7 +5,7 @@
  * 基于 BaseStore 实现，返回的工厂函数在首次调用时创建 Store 实例，
  * 后续调用返回同一实例，直到调用 $dispose() 后重置。
  */
-import type { ActionSubscriber, StateMutation, StateSubscriber, StateTree, StoreId, Unsubscribe } from '../types';
+import type { ActionSubscriber, StateMutation, StateSubscriber, StateTree, StoreId, StoreOptions, Unsubscribe } from '../types';
 /**
  * Store 定义描述接口
  *
@@ -35,6 +35,7 @@ export interface StoreAPI<Id extends StoreId = StoreId, S extends StateTree = St
     readonly $state: S;
     $reset: () => void;
     $patch: (partial: Partial<S> | ((state: S) => void)) => void;
+    $patchAsync: (partial: Partial<S> | ((state: S) => void)) => Promise<void>;
     $subscribe: (callback: StateSubscriber<S>, options?: {
         immediate?: boolean;
     }) => Unsubscribe;
@@ -60,7 +61,6 @@ export interface StoreAPI<Id extends StoreId = StoreId, S extends StateTree = St
  * @param definition - Store 定义，包含 id、state 工厂、getters 和 actions
  * @returns 惰性初始化的 Store 工厂函数，调用后返回 StoreAPI 实例
  */
-export declare function createStore<Id extends StoreId, S extends StateTree, G extends Record<string, (state: S) => unknown> = Record<string, never>, A extends Record<string, (this: StoreAPI<Id, S, G, A>, ...args: unknown[]) => unknown> = Record<string, never>>(definition: CreateStoreDefinition<Id, S, G, A>): () => StoreAPI<Id, S, G, A>;
+export declare function createStore<Id extends StoreId, S extends StateTree, G extends Record<string, (state: S) => unknown> = Record<string, never>, A extends Record<string, (this: StoreAPI<Id, S, G, A>, ...args: unknown[]) => unknown> = Record<string, never>>(definition: CreateStoreDefinition<Id, S, G, A>, options?: StoreOptions): () => StoreAPI<Id, S, G, A>;
 /** 状态变更类型，支持部分更新或通过函数直接修改状态 */
 export type { StateMutation };
-//# sourceMappingURL=create-store.d.ts.map

package/lib/core/event-bus.cjs

@@ -2,7 +2,7 @@
 * ***********************************
 * @composy/store-core v0.0.1      *
 * Built with rollup               *
-* Build time: 2024-08-17 11:27:33 *
+* Build time: 2024-10-12 17:23:58 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************

package/lib/core/event-bus.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.cjs","names":[],"sources":["../../src/core/event-bus.ts"],"sourcesContent":["/**\n * 事件总线实现\n *\n * 提供事件的发布/订阅功能\n * @module core/event-bus\n */\n\nimport type { EventBus, EventData, EventListener, EventType, Unsubscribe } from '../types'\n\n/**\n * 创建事件总线\n *\n * @returns 事件总线实例\n *\n * @example\n * ```typescript\n * const bus = createEventBus()\n *\n * // 监听事件\n * const unsubscribe = bus.on('state:changed', (data) => {\n *   console.log('状态变化:', data)\n * })\n *\n * // 发送事件\n * bus.emit('state:changed', { storeId: 'counter', newValue: 1 })\n *\n * // 取消监听\n * unsubscribe()\n * ```\n */\nexport function createEventBus(): EventBus {\n  /** 事件监听器映射 */\n  const listeners = new Map<EventType | '*', Set<EventListener>>()\n\n  /**\n   * 获取或创建监听器集合\n   */\n  const getListeners = (type: EventType | '*'): Set<EventListener> => {\n    let set = listeners.get(type)\n    if (!set) {\n      set = new Set()\n      listeners.set(type, set)\n    }\n    return set\n  }\n\n  /**\n   * 监听事件\n   */\n  const on = (type: EventType | '*', listener: EventListener): Unsubscribe => {\n    const set = getListeners(type)\n    set.add(listener)\n\n    return () => {\n      set.delete(listener)\n      if (set.size === 0) {\n        listeners.delete(type)\n      }\n    }\n  }\n\n  /**\n   * 取消监听\n   */\n  const off = (type: EventType | '*', listener?: EventListener): void => {\n    if (listener) {\n      const set = listeners.get(type)\n      if (set) {\n        set.delete(listener)\n        if (set.size === 0) {\n          listeners.delete(type)\n        }\n      }\n    }\n    else {\n      listeners.delete(type)\n    }\n  }\n\n  /**\n   * 监听一次\n   */\n  const once = (type: EventType, listener: EventListener): Unsubscribe => {\n    const wrappedListener: EventListener = (data) => {\n      listener(data)\n      off(type, wrappedListener)\n    }\n    return on(type, wrappedListener)\n  }\n\n  /**\n   * 发送事件\n   */\n  const emit = (type: EventType, payload?: unknown): void => {\n    const data: EventData = {\n      type,\n      payload,\n      timestamp: Date.now(),\n    }\n\n    // 触发特定类型的监听器\n    const typeListeners = listeners.get(type)\n    if (typeListeners) {\n      typeListeners.forEach(listener => listener(data))\n    }\n\n    // 触发通配符监听器\n    const wildcardListeners = listeners.get('*')\n    if (wildcardListeners) {\n      wildcardListeners.forEach(listener => listener(data))\n    }\n  }\n\n  /**\n   * 清空所有监听器\n   */\n  const clear = (): void => {\n    listeners.clear()\n  }\n\n  return {\n    on,\n    once,\n    off,\n    emit,\n    clear,\n  }\n}\n\n/**\n * 全局事件总线实例\n */\nexport const globalEventBus = createEventBus()\n\n"],"mappings":";;;;;;;;;;;;AA8BO,SAAS,iBAA2B;CAEzC,MAAM,4BAAY,IAAI,IAAyC;CAK/D,MAAM,gBAAgB,SAA8C;EAClE,IAAI,MAAM,UAAU,IAAI,IAAI;EAC5B,IAAI,CAAC,KAAK;GACR,sBAAM,IAAI,IAAI;GACd,UAAU,IAAI,MAAM,GAAG;EACzB;EACA,OAAO;CACT;CAKA,MAAM,MAAM,MAAuB,aAAyC;EAC1E,MAAM,MAAM,aAAa,IAAI;EAC7B,IAAI,IAAI,QAAQ;EAEhB,aAAa;GACX,IAAI,OAAO,QAAQ;GACnB,IAAI,IAAI,SAAS,GACf,UAAU,OAAO,IAAI;EAEzB;CACF;CAKA,MAAM,OAAO,MAAuB,aAAmC;EACrE,IAAI,UAAU;GACZ,MAAM,MAAM,UAAU,IAAI,IAAI;GAC9B,IAAI,KAAK;IACP,IAAI,OAAO,QAAQ;IACnB,IAAI,IAAI,SAAS,GACf,UAAU,OAAO,IAAI;GAEzB;EACF,OAEE,UAAU,OAAO,IAAI;CAEzB;CAKA,MAAM,QAAQ,MAAiB,aAAyC;EACtE,MAAM,mBAAkC,SAAS;GAC/C,SAAS,IAAI;GACb,IAAI,MAAM,eAAe;EAC3B;EACA,OAAO,GAAG,MAAM,eAAe;CACjC;CAKA,MAAM,QAAQ,MAAiB,YAA4B;EACzD,MAAM,OAAkB;GACtB;GACA;GACA,WAAW,KAAK,IAAI;EACtB;EAGA,MAAM,gBAAgB,UAAU,IAAI,IAAI;EACxC,IAAI,eACF,cAAc,SAAQ,aAAY,SAAS,IAAI,CAAC;EAIlD,MAAM,oBAAoB,UAAU,IAAI,GAAG;EAC3C,IAAI,mBACF,kBAAkB,SAAQ,aAAY,SAAS,IAAI,CAAC;CAExD;CAKA,MAAM,cAAoB;EACxB,UAAU,MAAM;CAClB;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;AACF;AAKO,MAAM,iBAAiB,eAAe"}
+{"version":3,"file":"event-bus.cjs","names":[],"sources":["../../src/core/event-bus.ts"],"sourcesContent":["/**\r\n * 事件总线实现\r\n *\r\n * 提供事件的发布/订阅功能\r\n * @module core/event-bus\r\n */\r\n\r\nimport type {\r\n  EventBus,\r\n  EventData,\r\n  EventListener,\r\n  EventType,\r\n  Unsubscribe,\r\n} from '../types'\r\n\r\n/**\r\n * 创建事件总线\r\n *\r\n * @returns 事件总线实例\r\n *\r\n * @example\r\n * ```typescript\r\n * const bus = createEventBus()\r\n *\r\n * // 监听事件\r\n * const unsubscribe = bus.on('state:changed', (data) => {\r\n *   console.log('状态变化:', data)\r\n * })\r\n *\r\n * // 发送事件\r\n * bus.emit('state:changed', { storeId: 'counter', newValue: 1 })\r\n *\r\n * // 取消监听\r\n * unsubscribe()\r\n * ```\r\n */\r\nexport function createEventBus(): EventBus {\r\n  /** 事件监听器映射 */\r\n  const listeners = new Map<EventType | '*', Set<EventListener>>()\r\n\r\n  /**\r\n   * 获取或创建监听器集合\r\n   */\r\n  const getListeners = (type: EventType | '*'): Set<EventListener> => {\r\n    let set = listeners.get(type)\r\n    if (!set) {\r\n      set = new Set()\r\n      listeners.set(type, set)\r\n    }\r\n    return set\r\n  }\r\n\r\n  /**\r\n   * 监听事件\r\n   */\r\n  const on = (type: EventType | '*', listener: EventListener): Unsubscribe => {\r\n    const set = getListeners(type)\r\n    set.add(listener)\r\n\r\n    return () => {\r\n      set.delete(listener)\r\n      if (set.size === 0) {\r\n        listeners.delete(type)\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 取消监听\r\n   */\r\n  const off = (type: EventType | '*', listener?: EventListener): void => {\r\n    if (listener) {\r\n      const set = listeners.get(type)\r\n      if (set) {\r\n        set.delete(listener)\r\n        if (set.size === 0) {\r\n          listeners.delete(type)\r\n        }\r\n      }\r\n    } else {\r\n      listeners.delete(type)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 监听一次\r\n   */\r\n  const once = (type: EventType, listener: EventListener): Unsubscribe => {\r\n    const wrappedListener: EventListener = data => {\r\n      listener(data)\r\n      off(type, wrappedListener)\r\n    }\r\n    return on(type, wrappedListener)\r\n  }\r\n\r\n  /**\r\n   * 发送事件\r\n   */\r\n  const emit = (type: EventType, payload?: unknown): void => {\r\n    const data: EventData = {\r\n      type,\r\n      payload,\r\n      timestamp: Date.now(),\r\n    }\r\n\r\n    // 触发特定类型的监听器\r\n    const typeListeners = listeners.get(type)\r\n    if (typeListeners) {\r\n      typeListeners.forEach(listener => listener(data))\r\n    }\r\n\r\n    // 触发通配符监听器\r\n    const wildcardListeners = listeners.get('*')\r\n    if (wildcardListeners) {\r\n      wildcardListeners.forEach(listener => listener(data))\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 清空所有监听器\r\n   */\r\n  const clear = (): void => {\r\n    listeners.clear()\r\n  }\r\n\r\n  return {\r\n    on,\r\n    once,\r\n    off,\r\n    emit,\r\n    clear,\r\n  }\r\n}\r\n\r\n/**\r\n * 全局事件总线实例\r\n */\r\nexport const globalEventBus = createEventBus()\r\n"],"mappings":";;;;;;;;;;;;AAoCO,SAAS,iBAA2B;CAEzC,MAAM,4BAAY,IAAI,IAAyC;CAK/D,MAAM,gBAAgB,SAA8C;EAClE,IAAI,MAAM,UAAU,IAAI,IAAI;EAC5B,IAAI,CAAC,KAAK;GACR,sBAAM,IAAI,IAAI;GACd,UAAU,IAAI,MAAM,GAAG;EACzB;EACA,OAAO;CACT;CAKA,MAAM,MAAM,MAAuB,aAAyC;EAC1E,MAAM,MAAM,aAAa,IAAI;EAC7B,IAAI,IAAI,QAAQ;EAEhB,aAAa;GACX,IAAI,OAAO,QAAQ;GACnB,IAAI,IAAI,SAAS,GACf,UAAU,OAAO,IAAI;EAEzB;CACF;CAKA,MAAM,OAAO,MAAuB,aAAmC;EACrE,IAAI,UAAU;GACZ,MAAM,MAAM,UAAU,IAAI,IAAI;GAC9B,IAAI,KAAK;IACP,IAAI,OAAO,QAAQ;IACnB,IAAI,IAAI,SAAS,GACf,UAAU,OAAO,IAAI;GAEzB;EACF,OACE,UAAU,OAAO,IAAI;CAEzB;CAKA,MAAM,QAAQ,MAAiB,aAAyC;EACtE,MAAM,mBAAiC,SAAQ;GAC7C,SAAS,IAAI;GACb,IAAI,MAAM,eAAe;EAC3B;EACA,OAAO,GAAG,MAAM,eAAe;CACjC;CAKA,MAAM,QAAQ,MAAiB,YAA4B;EACzD,MAAM,OAAkB;GACtB;GACA;GACA,WAAW,KAAK,IAAI;EACtB;EAGA,MAAM,gBAAgB,UAAU,IAAI,IAAI;EACxC,IAAI,eACF,cAAc,SAAQ,aAAY,SAAS,IAAI,CAAC;EAIlD,MAAM,oBAAoB,UAAU,IAAI,GAAG;EAC3C,IAAI,mBACF,kBAAkB,SAAQ,aAAY,SAAS,IAAI,CAAC;CAExD;CAKA,MAAM,cAAoB;EACxB,UAAU,MAAM;CAClB;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;AACF;AAKO,MAAM,iBAAiB,eAAe"}

package/lib/core/{event-bus.d.ts → event-bus.d.cts}

@@ -31,4 +31,3 @@ export declare function createEventBus(): EventBus;
  * 全局事件总线实例
  */
 export declare const globalEventBus: EventBus;
-//# sourceMappingURL=event-bus.d.ts.map