@voidhash/mimic-react 1.0.0-beta.13 → 1.0.0-beta.15

package/dist/zustand-commander/types.d.cts

@@ -1,4 +1,6 @@
 import { StoreApi, UseBoundStore } from "zustand";
+import { Primitive } from "@voidhash/mimic";
+import { ClientDocument } from "@voidhash/mimic/client";
 
 //#region src/zustand-commander/types.d.ts
 
@@ -14,7 +16,7 @@ declare const UNDOABLE_COMMAND_SYMBOL: unique symbol;
  * Context provided to command functions.
  * Gives access to store state and dispatch capabilities.
  */
-interface CommandContext<TStore> {
+interface CommandContext<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
   /**
    * Get the current store state.
    */
@@ -30,32 +32,37 @@ interface CommandContext<TStore> {
    * @example
    * dispatch(otherCommand)({ param: "value" });
    */
-  readonly dispatch: CommandDispatch<TStore>;
+  readonly dispatch: CommandDispatch<TStore, TSchema>;
+  /**
+   * Run a transaction on the document.
+   * Routes to the active draft if one is linked, otherwise to the document directly.
+   */
+  readonly transaction: (fn: (root: Primitive.InferProxy<TSchema>) => void) => void;
 }
 /**
  * The function signature for a command handler.
  */
-type CommandFn<TStore, TParams, TReturn> = (ctx: CommandContext<TStore>, params: TParams) => TReturn;
+type CommandFn<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = (ctx: CommandContext<TStore, TSchema>, params: TParams) => TReturn;
 /**
  * The function signature for an undoable command's revert handler.
  * Receives the original params and the result from the forward execution.
  */
-type RevertFn<TStore, TParams, TReturn> = (ctx: CommandContext<TStore>, params: TParams, result: TReturn) => void;
+type RevertFn<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = (ctx: CommandContext<TStore, TSchema>, params: TParams, result: TReturn) => void;
 /**
  * A command that can be dispatched to modify store state.
  * Regular commands do not support undo/redo.
  */
-interface Command<TStore, TParams, TReturn> {
+interface Command<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
   readonly [COMMAND_SYMBOL]: true;
-  readonly fn: CommandFn<TStore, TParams, TReturn>;
+  readonly fn: CommandFn<TStore, TParams, TReturn, TSchema>;
 }
 /**
  * An undoable command that supports undo/redo.
  * Must provide a revert function that knows how to undo the change.
  */
-interface UndoableCommand<TStore, TParams, TReturn> extends Command<TStore, TParams, TReturn> {
+interface UndoableCommand<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> extends Command<TStore, TParams, TReturn, TSchema> {
   readonly [UNDOABLE_COMMAND_SYMBOL]: true;
-  readonly revert: RevertFn<TStore, TParams, TReturn>;
+  readonly revert: RevertFn<TStore, TParams, TReturn, TSchema>;
 }
 /**
  * Any command type (regular or undoable).
@@ -72,7 +79,7 @@ type AnyUndoableCommand = UndoableCommand<any, any, any>;
  * @example
  * const result = dispatch(myCommand)({ param: "value" });
  */
-type CommandDispatch<TStore> = <TParams, TReturn>(command: Command<TStore, TParams, TReturn>) => (params: TParams) => TReturn;
+type CommandDispatch<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = <TParams, TReturn>(command: Command<TStore, TParams, TReturn, TSchema>) => (params: TParams) => TReturn;
 /**
  * An entry in the undo/redo stack.
  * Contains all information needed to revert or redo a command.
@@ -96,6 +103,8 @@ interface CommanderSlice {
     readonly undoStack: ReadonlyArray<UndoEntry>;
     /** Stack of commands that can be redone */
     readonly redoStack: ReadonlyArray<UndoEntry>;
+    /** Active draft handle, if any. When set, transactions route through the draft and undo is disabled. */
+    readonly activeDraft: ClientDocument.DraftHandle<any> | null;
   };
 }
 /**
@@ -112,7 +121,7 @@ interface CommanderOptions {
  * A commander instance bound to a specific store type.
  * Used to create commands and the middleware.
  */
-interface Commander<TStore> {
+interface Commander<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
   /**
    * Create a regular command (no undo support).
    *
@@ -130,8 +139,8 @@ interface Commander<TStore> {
    * });
    */
   readonly action: {
-    <TParams, TReturn = void>(fn: CommandFn<TStore, TParams, TReturn>): Command<TStore, TParams, TReturn>;
-    <TReturn = void>(fn: CommandFn<TStore, void, TReturn>): Command<TStore, void, TReturn>;
+    <TParams, TReturn = void>(fn: CommandFn<TStore, TParams, TReturn, TSchema>): Command<TStore, TParams, TReturn, TSchema>;
+    <TReturn = void>(fn: CommandFn<TStore, void, TReturn, TSchema>): Command<TStore, void, TReturn, TSchema>;
   };
   /**
    * Create an undoable command with undo/redo support.
@@ -151,8 +160,8 @@ interface Commander<TStore> {
    * );
    */
   readonly undoableAction: {
-    <TParams, TReturn>(fn: CommandFn<TStore, TParams, TReturn>, revert: RevertFn<TStore, TParams, TReturn>): UndoableCommand<TStore, TParams, TReturn>;
-    <TReturn>(fn: CommandFn<TStore, void, TReturn>, revert: RevertFn<TStore, void, TReturn>): UndoableCommand<TStore, void, TReturn>;
+    <TParams, TReturn>(fn: CommandFn<TStore, TParams, TReturn, TSchema>, revert: RevertFn<TStore, TParams, TReturn, TSchema>): UndoableCommand<TStore, TParams, TReturn, TSchema>;
+    <TReturn>(fn: CommandFn<TStore, void, TReturn, TSchema>, revert: RevertFn<TStore, void, TReturn, TSchema>): UndoableCommand<TStore, void, TReturn, TSchema>;
   };
   /**
    * Zustand middleware that adds commander functionality.

package/dist/zustand-commander/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/zustand-commander/types.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/zustand-commander/types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/zustand-commander/types.d.mts

@@ -1,4 +1,6 @@
 import { StoreApi, UseBoundStore } from "zustand";
+import { Primitive } from "@voidhash/mimic";
+import { ClientDocument } from "@voidhash/mimic/client";
 
 //#region src/zustand-commander/types.d.ts
 
@@ -14,7 +16,7 @@ declare const UNDOABLE_COMMAND_SYMBOL: unique symbol;
  * Context provided to command functions.
  * Gives access to store state and dispatch capabilities.
  */
-interface CommandContext<TStore> {
+interface CommandContext<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
   /**
    * Get the current store state.
    */
@@ -30,32 +32,37 @@ interface CommandContext<TStore> {
    * @example
    * dispatch(otherCommand)({ param: "value" });
    */
-  readonly dispatch: CommandDispatch<TStore>;
+  readonly dispatch: CommandDispatch<TStore, TSchema>;
+  /**
+   * Run a transaction on the document.
+   * Routes to the active draft if one is linked, otherwise to the document directly.
+   */
+  readonly transaction: (fn: (root: Primitive.InferProxy<TSchema>) => void) => void;
 }
 /**
  * The function signature for a command handler.
  */
-type CommandFn<TStore, TParams, TReturn> = (ctx: CommandContext<TStore>, params: TParams) => TReturn;
+type CommandFn<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = (ctx: CommandContext<TStore, TSchema>, params: TParams) => TReturn;
 /**
  * The function signature for an undoable command's revert handler.
  * Receives the original params and the result from the forward execution.
  */
-type RevertFn<TStore, TParams, TReturn> = (ctx: CommandContext<TStore>, params: TParams, result: TReturn) => void;
+type RevertFn<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = (ctx: CommandContext<TStore, TSchema>, params: TParams, result: TReturn) => void;
 /**
  * A command that can be dispatched to modify store state.
  * Regular commands do not support undo/redo.
  */
-interface Command<TStore, TParams, TReturn> {
+interface Command<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
   readonly [COMMAND_SYMBOL]: true;
-  readonly fn: CommandFn<TStore, TParams, TReturn>;
+  readonly fn: CommandFn<TStore, TParams, TReturn, TSchema>;
 }
 /**
  * An undoable command that supports undo/redo.
  * Must provide a revert function that knows how to undo the change.
  */
-interface UndoableCommand<TStore, TParams, TReturn> extends Command<TStore, TParams, TReturn> {
+interface UndoableCommand<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> extends Command<TStore, TParams, TReturn, TSchema> {
   readonly [UNDOABLE_COMMAND_SYMBOL]: true;
-  readonly revert: RevertFn<TStore, TParams, TReturn>;
+  readonly revert: RevertFn<TStore, TParams, TReturn, TSchema>;
 }
 /**
  * Any command type (regular or undoable).
@@ -72,7 +79,7 @@ type AnyUndoableCommand = UndoableCommand<any, any, any>;
  * @example
  * const result = dispatch(myCommand)({ param: "value" });
  */
-type CommandDispatch<TStore> = <TParams, TReturn>(command: Command<TStore, TParams, TReturn>) => (params: TParams) => TReturn;
+type CommandDispatch<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = <TParams, TReturn>(command: Command<TStore, TParams, TReturn, TSchema>) => (params: TParams) => TReturn;
 /**
  * An entry in the undo/redo stack.
  * Contains all information needed to revert or redo a command.
@@ -96,6 +103,8 @@ interface CommanderSlice {
     readonly undoStack: ReadonlyArray<UndoEntry>;
     /** Stack of commands that can be redone */
     readonly redoStack: ReadonlyArray<UndoEntry>;
+    /** Active draft handle, if any. When set, transactions route through the draft and undo is disabled. */
+    readonly activeDraft: ClientDocument.DraftHandle<any> | null;
   };
 }
 /**
@@ -112,7 +121,7 @@ interface CommanderOptions {
  * A commander instance bound to a specific store type.
  * Used to create commands and the middleware.
  */
-interface Commander<TStore> {
+interface Commander<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
   /**
    * Create a regular command (no undo support).
    *
@@ -130,8 +139,8 @@ interface Commander<TStore> {
    * });
    */
   readonly action: {
-    <TParams, TReturn = void>(fn: CommandFn<TStore, TParams, TReturn>): Command<TStore, TParams, TReturn>;
-    <TReturn = void>(fn: CommandFn<TStore, void, TReturn>): Command<TStore, void, TReturn>;
+    <TParams, TReturn = void>(fn: CommandFn<TStore, TParams, TReturn, TSchema>): Command<TStore, TParams, TReturn, TSchema>;
+    <TReturn = void>(fn: CommandFn<TStore, void, TReturn, TSchema>): Command<TStore, void, TReturn, TSchema>;
   };
   /**
    * Create an undoable command with undo/redo support.
@@ -151,8 +160,8 @@ interface Commander<TStore> {
    * );
    */
   readonly undoableAction: {
-    <TParams, TReturn>(fn: CommandFn<TStore, TParams, TReturn>, revert: RevertFn<TStore, TParams, TReturn>): UndoableCommand<TStore, TParams, TReturn>;
-    <TReturn>(fn: CommandFn<TStore, void, TReturn>, revert: RevertFn<TStore, void, TReturn>): UndoableCommand<TStore, void, TReturn>;
+    <TParams, TReturn>(fn: CommandFn<TStore, TParams, TReturn, TSchema>, revert: RevertFn<TStore, TParams, TReturn, TSchema>): UndoableCommand<TStore, TParams, TReturn, TSchema>;
+    <TReturn>(fn: CommandFn<TStore, void, TReturn, TSchema>, revert: RevertFn<TStore, void, TReturn, TSchema>): UndoableCommand<TStore, void, TReturn, TSchema>;
   };
   /**
    * Zustand middleware that adds commander functionality.

package/dist/zustand-commander/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/zustand-commander/types.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/zustand-commander/types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/zustand-commander/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../src/zustand-commander/types.ts"],"sourcesContent":["/**\n * @voidhash/mimic-react/zustand-commander\n *\n * Type definitions for the zustand-commander package.\n *\n * @since 0.0.1\n */\n\nimport type { StoreApi, UseBoundStore } from \"zustand\";\n\n// =============================================================================\n// Command Symbol & Type Guard\n// =============================================================================\n\n/**\n * Symbol used to identify Command objects at runtime.\n */\nexport const COMMAND_SYMBOL = Symbol.for(\"zustand-commander/command\");\n\n/**\n * Symbol used to identify UndoableCommand objects at runtime.\n */\nexport const UNDOABLE_COMMAND_SYMBOL = Symbol.for(\n  \"zustand-commander/undoable-command\"\n);\n\n// =============================================================================\n// Command Context\n// =============================================================================\n\n/**\n * Context provided to command functions.\n * Gives access to store state and dispatch capabilities.\n */\nexport interface CommandContext<TStore> {\n  /**\n   * Get the current store state.\n   */\n  readonly getState: () => TStore;\n\n  /**\n   * Set partial store state (for local/browser state updates).\n   */\n  readonly setState: (partial: Partial<TStore>) => void;\n\n  /**\n   * Dispatch another command.\n   * Returns the result of the dispatched command.\n   *\n   * @example\n   * dispatch(otherCommand)({ param: \"value\" });\n   */\n  readonly dispatch: CommandDispatch<TStore>;\n}\n\n// =============================================================================\n// Command Function Types\n// =============================================================================\n\n/**\n * The function signature for a command handler.\n */\nexport type CommandFn<TStore, TParams, TReturn> = (\n  ctx: CommandContext<TStore>,\n  params: TParams\n) => TReturn;\n\n/**\n * The function signature for an undoable command's revert handler.\n * Receives the original params and the result from the forward execution.\n */\nexport type RevertFn<TStore, TParams, TReturn> = (\n  ctx: CommandContext<TStore>,\n  params: TParams,\n  result: TReturn\n) => void;\n\n// =============================================================================\n// Command Types\n// =============================================================================\n\n/**\n * A command that can be dispatched to modify store state.\n * Regular commands do not support undo/redo.\n */\nexport interface Command<TStore, TParams, TReturn> {\n  readonly [COMMAND_SYMBOL]: true;\n  readonly fn: CommandFn<TStore, TParams, TReturn>;\n}\n\n/**\n * An undoable command that supports undo/redo.\n * Must provide a revert function that knows how to undo the change.\n */\nexport interface UndoableCommand<TStore, TParams, TReturn>\n  extends Command<TStore, TParams, TReturn> {\n  readonly [UNDOABLE_COMMAND_SYMBOL]: true;\n  readonly revert: RevertFn<TStore, TParams, TReturn>;\n}\n\n/**\n * Any command type (regular or undoable).\n */\nexport type AnyCommand = Command<any, any, any>;\n\n/**\n * Any undoable command type.\n */\nexport type AnyUndoableCommand = UndoableCommand<any, any, any>;\n\n// =============================================================================\n// Command Dispatch\n// =============================================================================\n\n/**\n * Dispatch function that accepts commands and returns a function to call with params.\n * Returns the result of the command execution.\n *\n * @example\n * const result = dispatch(myCommand)({ param: \"value\" });\n */\nexport type CommandDispatch<TStore> = <TParams, TReturn>(\n  command: Command<TStore, TParams, TReturn>\n) => (params: TParams) => TReturn;\n\n// =============================================================================\n// Undo/Redo Stack Types\n// =============================================================================\n\n/**\n * An entry in the undo/redo stack.\n * Contains all information needed to revert or redo a command.\n */\nexport interface UndoEntry<TParams = unknown, TReturn = unknown> {\n  /** The undoable command that was executed */\n  readonly command: AnyUndoableCommand;\n  /** The parameters that were passed to the command */\n  readonly params: TParams;\n  /** The result returned by the command (passed to revert) */\n  readonly result: TReturn;\n  /** Timestamp when the command was executed */\n  readonly timestamp: number;\n}\n\n/**\n * State slice for undo/redo functionality.\n */\nexport interface CommanderSlice {\n  readonly _commander: {\n    /** Stack of commands that can be undone */\n    readonly undoStack: ReadonlyArray<UndoEntry>;\n    /** Stack of commands that can be redone */\n    readonly redoStack: ReadonlyArray<UndoEntry>;\n  };\n}\n\n// =============================================================================\n// Commander Types\n// =============================================================================\n\n/**\n * Options for creating a commander.\n */\nexport interface CommanderOptions {\n  /**\n   * Maximum number of undo entries to keep.\n   * @default 100\n   */\n  readonly maxUndoStackSize?: number;\n}\n\n/**\n * A commander instance bound to a specific store type.\n * Used to create commands and the middleware.\n */\nexport interface Commander<TStore> {\n  /**\n   * Create a regular command (no undo support).\n   *\n   * @example\n   * // With params\n   * const addItem = commander.action<{ name: string }>(\n   *   (ctx, params) => {\n   *     // modify state using params.name\n   *   }\n   * );\n   *\n   * // Without params\n   * const clearAll = commander.action((ctx) => {\n   *   // modify state\n   * });\n   */\n  readonly action: {\n    // With params (explicit type parameter)\n    <TParams, TReturn = void>(\n      fn: CommandFn<TStore, TParams, TReturn>\n    ): Command<TStore, TParams, TReturn>;\n\n    // Without params (void) - inferred when no type param provided\n    <TReturn = void>(\n      fn: CommandFn<TStore, void, TReturn>\n    ): Command<TStore, void, TReturn>;\n  };\n\n  /**\n   * Create an undoable command with undo/redo support.\n   * The revert function is called when undoing the command.\n   *\n   * @example\n   * const moveItem = commander.undoableAction<{ id: string; toIndex: number }, { fromIndex: number }>(\n   *   (ctx, params) => {\n   *     const fromIndex = // get current index\n   *     // perform move\n   *     return { fromIndex }; // return data needed for revert\n   *   },\n   *   (ctx, params, result) => {\n   *     // revert: move back to original position\n   *     ctx.dispatch(moveItem)({ id: params.id, toIndex: result.fromIndex });\n   *   }\n   * );\n   */\n  readonly undoableAction: {\n    // With params (explicit type parameter)\n    <TParams, TReturn>(\n      fn: CommandFn<TStore, TParams, TReturn>,\n      revert: RevertFn<TStore, TParams, TReturn>\n    ): UndoableCommand<TStore, TParams, TReturn>;\n\n    // Without params (void)\n    <TReturn>(\n      fn: CommandFn<TStore, void, TReturn>,\n      revert: RevertFn<TStore, void, TReturn>\n    ): UndoableCommand<TStore, void, TReturn>;\n  };\n\n  /**\n   * Zustand middleware that adds commander functionality.\n   * Adds undo/redo stacks to the store state.\n   */\n  readonly middleware: CommanderMiddleware<TStore>;\n}\n\n/**\n * Type for the commander middleware.\n * Note: TStore is intentionally unused here to match the Commander interface signature.\n * The middleware is generic over T (the inner store type) and adds CommanderSlice.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport type CommanderMiddleware<_TStore> = <T extends object>(\n  config: (\n    set: StoreApi<T & CommanderSlice>[\"setState\"],\n    get: StoreApi<T & CommanderSlice>[\"getState\"],\n    api: StoreApi<T & CommanderSlice>\n  ) => T\n) => (\n  set: StoreApi<T & CommanderSlice>[\"setState\"],\n  get: StoreApi<T & CommanderSlice>[\"getState\"],\n  api: StoreApi<T & CommanderSlice>\n) => T & CommanderSlice;\n\n// =============================================================================\n// Type Helpers\n// =============================================================================\n\n/**\n * Extract the params type from a command.\n */\nexport type CommandParams<T> = T extends Command<any, infer P, any> ? P : never;\n\n/**\n * Extract the return type from a command.\n */\nexport type CommandReturn<T> = T extends Command<any, any, infer R>\n  ? R\n  : undefined;\n\n/**\n * Extract the store type from a command.\n */\nexport type CommandStore<T> = T extends Command<infer S, any, any> ? S : never;\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Type guard to check if a value is a Command.\n */\nexport function isCommand(value: unknown): value is AnyCommand {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    COMMAND_SYMBOL in value &&\n    value[COMMAND_SYMBOL] === true\n  );\n}\n\n/**\n * Type guard to check if a command is undoable.\n */\nexport function isUndoableCommand(\n  value: unknown\n): value is AnyUndoableCommand {\n  return (\n    isCommand(value) &&\n    UNDOABLE_COMMAND_SYMBOL in value &&\n    value[UNDOABLE_COMMAND_SYMBOL] === true\n  );\n}\n\n// =============================================================================\n// Store Type Helper\n// =============================================================================\n\n/**\n * Helper type to extract the state type from a zustand store.\n */\nexport type ExtractState<TStore> = TStore extends UseBoundStore<\n  StoreApi<infer S>\n>\n  ? S\n  : TStore extends StoreApi<infer S>\n    ? S\n    : never;\n\n"],"mappings":";;;;AAiBA,MAAa,iBAAiB,OAAO,IAAI,4BAA4B;;;;AAKrE,MAAa,0BAA0B,OAAO,IAC5C,qCACD;;;;AAwQD,SAAgB,UAAU,OAAqC;AAC7D,QACE,OAAO,UAAU,YACjB,UAAU,QACV,kBAAkB,SAClB,MAAM,oBAAoB;;;;;AAO9B,SAAgB,kBACd,OAC6B;AAC7B,QACE,UAAU,MAAM,IAChB,2BAA2B,SAC3B,MAAM,6BAA6B"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/zustand-commander/types.ts"],"sourcesContent":["/**\n * @voidhash/mimic-react/zustand-commander\n *\n * Type definitions for the zustand-commander package.\n *\n * @since 0.0.1\n */\n\nimport type { StoreApi, UseBoundStore } from \"zustand\";\nimport type { Primitive } from \"@voidhash/mimic\";\nimport type { ClientDocument } from \"@voidhash/mimic/client\";\n\n// =============================================================================\n// Command Symbol & Type Guard\n// =============================================================================\n\n/**\n * Symbol used to identify Command objects at runtime.\n */\nexport const COMMAND_SYMBOL = Symbol.for(\"zustand-commander/command\");\n\n/**\n * Symbol used to identify UndoableCommand objects at runtime.\n */\nexport const UNDOABLE_COMMAND_SYMBOL = Symbol.for(\n  \"zustand-commander/undoable-command\"\n);\n\n// =============================================================================\n// Command Context\n// =============================================================================\n\n/**\n * Context provided to command functions.\n * Gives access to store state and dispatch capabilities.\n */\nexport interface CommandContext<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {\n  /**\n   * Get the current store state.\n   */\n  readonly getState: () => TStore;\n\n  /**\n   * Set partial store state (for local/browser state updates).\n   */\n  readonly setState: (partial: Partial<TStore>) => void;\n\n  /**\n   * Dispatch another command.\n   * Returns the result of the dispatched command.\n   *\n   * @example\n   * dispatch(otherCommand)({ param: \"value\" });\n   */\n  readonly dispatch: CommandDispatch<TStore, TSchema>;\n\n  /**\n   * Run a transaction on the document.\n   * Routes to the active draft if one is linked, otherwise to the document directly.\n   */\n  readonly transaction: (fn: (root: Primitive.InferProxy<TSchema>) => void) => void;\n}\n\n// =============================================================================\n// Command Function Types\n// =============================================================================\n\n/**\n * The function signature for a command handler.\n */\nexport type CommandFn<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = (\n  ctx: CommandContext<TStore, TSchema>,\n  params: TParams\n) => TReturn;\n\n/**\n * The function signature for an undoable command's revert handler.\n * Receives the original params and the result from the forward execution.\n */\nexport type RevertFn<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = (\n  ctx: CommandContext<TStore, TSchema>,\n  params: TParams,\n  result: TReturn\n) => void;\n\n// =============================================================================\n// Command Types\n// =============================================================================\n\n/**\n * A command that can be dispatched to modify store state.\n * Regular commands do not support undo/redo.\n */\nexport interface Command<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {\n  readonly [COMMAND_SYMBOL]: true;\n  readonly fn: CommandFn<TStore, TParams, TReturn, TSchema>;\n}\n\n/**\n * An undoable command that supports undo/redo.\n * Must provide a revert function that knows how to undo the change.\n */\nexport interface UndoableCommand<TStore, TParams, TReturn, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive>\n  extends Command<TStore, TParams, TReturn, TSchema> {\n  readonly [UNDOABLE_COMMAND_SYMBOL]: true;\n  readonly revert: RevertFn<TStore, TParams, TReturn, TSchema>;\n}\n\n/**\n * Any command type (regular or undoable).\n */\nexport type AnyCommand = Command<any, any, any>;\n\n/**\n * Any undoable command type.\n */\nexport type AnyUndoableCommand = UndoableCommand<any, any, any>;\n\n// =============================================================================\n// Command Dispatch\n// =============================================================================\n\n/**\n * Dispatch function that accepts commands and returns a function to call with params.\n * Returns the result of the command execution.\n *\n * @example\n * const result = dispatch(myCommand)({ param: \"value\" });\n */\nexport type CommandDispatch<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> = <TParams, TReturn>(\n  command: Command<TStore, TParams, TReturn, TSchema>\n) => (params: TParams) => TReturn;\n\n// =============================================================================\n// Undo/Redo Stack Types\n// =============================================================================\n\n/**\n * An entry in the undo/redo stack.\n * Contains all information needed to revert or redo a command.\n */\nexport interface UndoEntry<TParams = unknown, TReturn = unknown> {\n  /** The undoable command that was executed */\n  readonly command: AnyUndoableCommand;\n  /** The parameters that were passed to the command */\n  readonly params: TParams;\n  /** The result returned by the command (passed to revert) */\n  readonly result: TReturn;\n  /** Timestamp when the command was executed */\n  readonly timestamp: number;\n}\n\n/**\n * State slice for undo/redo functionality.\n */\nexport interface CommanderSlice {\n  readonly _commander: {\n    /** Stack of commands that can be undone */\n    readonly undoStack: ReadonlyArray<UndoEntry>;\n    /** Stack of commands that can be redone */\n    readonly redoStack: ReadonlyArray<UndoEntry>;\n    /** Active draft handle, if any. When set, transactions route through the draft and undo is disabled. */\n    readonly activeDraft: ClientDocument.DraftHandle<any> | null;\n  };\n}\n\n// =============================================================================\n// Commander Types\n// =============================================================================\n\n/**\n * Options for creating a commander.\n */\nexport interface CommanderOptions {\n  /**\n   * Maximum number of undo entries to keep.\n   * @default 100\n   */\n  readonly maxUndoStackSize?: number;\n}\n\n/**\n * A commander instance bound to a specific store type.\n * Used to create commands and the middleware.\n */\nexport interface Commander<TStore, TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {\n  /**\n   * Create a regular command (no undo support).\n   *\n   * @example\n   * // With params\n   * const addItem = commander.action<{ name: string }>(\n   *   (ctx, params) => {\n   *     // modify state using params.name\n   *   }\n   * );\n   *\n   * // Without params\n   * const clearAll = commander.action((ctx) => {\n   *   // modify state\n   * });\n   */\n  readonly action: {\n    // With params (explicit type parameter)\n    <TParams, TReturn = void>(\n      fn: CommandFn<TStore, TParams, TReturn, TSchema>\n    ): Command<TStore, TParams, TReturn, TSchema>;\n\n    // Without params (void) - inferred when no type param provided\n    <TReturn = void>(\n      fn: CommandFn<TStore, void, TReturn, TSchema>\n    ): Command<TStore, void, TReturn, TSchema>;\n  };\n\n  /**\n   * Create an undoable command with undo/redo support.\n   * The revert function is called when undoing the command.\n   *\n   * @example\n   * const moveItem = commander.undoableAction<{ id: string; toIndex: number }, { fromIndex: number }>(\n   *   (ctx, params) => {\n   *     const fromIndex = // get current index\n   *     // perform move\n   *     return { fromIndex }; // return data needed for revert\n   *   },\n   *   (ctx, params, result) => {\n   *     // revert: move back to original position\n   *     ctx.dispatch(moveItem)({ id: params.id, toIndex: result.fromIndex });\n   *   }\n   * );\n   */\n  readonly undoableAction: {\n    // With params (explicit type parameter)\n    <TParams, TReturn>(\n      fn: CommandFn<TStore, TParams, TReturn, TSchema>,\n      revert: RevertFn<TStore, TParams, TReturn, TSchema>\n    ): UndoableCommand<TStore, TParams, TReturn, TSchema>;\n\n    // Without params (void)\n    <TReturn>(\n      fn: CommandFn<TStore, void, TReturn, TSchema>,\n      revert: RevertFn<TStore, void, TReturn, TSchema>\n    ): UndoableCommand<TStore, void, TReturn, TSchema>;\n  };\n\n  /**\n   * Zustand middleware that adds commander functionality.\n   * Adds undo/redo stacks to the store state.\n   */\n  readonly middleware: CommanderMiddleware<TStore>;\n}\n\n/**\n * Type for the commander middleware.\n * Note: TStore is intentionally unused here to match the Commander interface signature.\n * The middleware is generic over T (the inner store type) and adds CommanderSlice.\n */\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport type CommanderMiddleware<_TStore> = <T extends object>(\n  config: (\n    set: StoreApi<T & CommanderSlice>[\"setState\"],\n    get: StoreApi<T & CommanderSlice>[\"getState\"],\n    api: StoreApi<T & CommanderSlice>\n  ) => T\n) => (\n  set: StoreApi<T & CommanderSlice>[\"setState\"],\n  get: StoreApi<T & CommanderSlice>[\"getState\"],\n  api: StoreApi<T & CommanderSlice>\n) => T & CommanderSlice;\n\n// =============================================================================\n// Type Helpers\n// =============================================================================\n\n/**\n * Extract the params type from a command.\n */\nexport type CommandParams<T> = T extends Command<any, infer P, any> ? P : never;\n\n/**\n * Extract the return type from a command.\n */\nexport type CommandReturn<T> = T extends Command<any, any, infer R>\n  ? R\n  : undefined;\n\n/**\n * Extract the store type from a command.\n */\nexport type CommandStore<T> = T extends Command<infer S, any, any> ? S : never;\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Type guard to check if a value is a Command.\n */\nexport function isCommand(value: unknown): value is AnyCommand {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    COMMAND_SYMBOL in value &&\n    value[COMMAND_SYMBOL] === true\n  );\n}\n\n/**\n * Type guard to check if a command is undoable.\n */\nexport function isUndoableCommand(\n  value: unknown\n): value is AnyUndoableCommand {\n  return (\n    isCommand(value) &&\n    UNDOABLE_COMMAND_SYMBOL in value &&\n    value[UNDOABLE_COMMAND_SYMBOL] === true\n  );\n}\n\n// =============================================================================\n// Store Type Helper\n// =============================================================================\n\n/**\n * Helper type to extract the state type from a zustand store.\n */\nexport type ExtractState<TStore> = TStore extends UseBoundStore<\n  StoreApi<infer S>\n>\n  ? S\n  : TStore extends StoreApi<infer S>\n    ? S\n    : never;\n\n"],"mappings":";;;;AAmBA,MAAa,iBAAiB,OAAO,IAAI,4BAA4B;;;;AAKrE,MAAa,0BAA0B,OAAO,IAC5C,qCACD;;;;AAgRD,SAAgB,UAAU,OAAqC;AAC7D,QACE,OAAO,UAAU,YACjB,UAAU,QACV,kBAAkB,SAClB,MAAM,oBAAoB;;;;;AAO9B,SAAgB,kBACd,OAC6B;AAC7B,QACE,UAAU,MAAM,IAChB,2BAA2B,SAC3B,MAAM,6BAA6B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidhash/mimic-react",
-  "version": "1.0.0-beta.13",
+  "version": "1.0.0-beta.15",
   "type": "module",
   "repository": {
     "type": "git",
@@ -37,12 +37,12 @@
     "typescript": "5.8.3",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4",
-    "@voidhash/tsconfig": "1.0.0-beta.13"
+    "@voidhash/tsconfig": "1.0.0-beta.15"
   },
   "peerDependencies": {
     "effect": "^3.16.0",
     "react": "^18.0.0 || ^19.0.0",
-    "@voidhash/mimic": "1.0.0-beta.13"
+    "@voidhash/mimic": "1.0.0-beta.15"
   },
   "scripts": {
     "build": "tsdown",

package/src/zustand/useDraft.ts

@@ -4,6 +4,8 @@ import type { StoreApi } from "zustand";
 import type { ClientDocument } from "@voidhash/mimic/client";
 import type { Primitive } from "@voidhash/mimic";
 import type { MimicSlice } from "./types";
+import type { CommanderSlice } from "../zustand-commander/types";
+import { setActiveDraft, clearActiveDraft } from "../zustand-commander/commander";
 
 /**
  * Return type of the useDraft hook.
@@ -17,21 +19,21 @@ export interface UseDraftReturn<TSchema extends Primitive.AnyPrimitive> {
   readonly commit: () => void;
   /** Discards the active draft. No-op if no draft is active. */
   readonly discard: () => void;
-  /** Runs an update on the active draft. Throws if no draft is active. */
-  readonly update: (fn: (root: Primitive.InferProxy<TSchema>) => void) => void;
 }
 
 /**
  * React hook for managing a draft lifecycle with auto-cleanup on unmount.
+ * Links the draft to the commander so that `ctx.transaction()` routes through the draft
+ * and undo/redo is disabled while the draft is active.
  *
- * @param store - The zustand store containing the mimic slice
+ * @param store - The zustand store containing the mimic slice and commander slice
  * @returns Draft control methods
  */
 export const useDraft = <
   TSchema extends Primitive.AnyPrimitive,
   TPresence extends import("@voidhash/mimic").Presence.AnyPresence | undefined = undefined,
 >(
-  store: StoreApi<MimicSlice<TSchema, TPresence>>
+  store: StoreApi<MimicSlice<TSchema, TPresence> & CommanderSlice>
 ): UseDraftReturn<TSchema> => {
   const draftRef = useRef<ClientDocument.DraftHandle<TSchema> | null>(null);
   // Use a counter to force re-renders when draft state changes
@@ -60,39 +62,34 @@ export const useDraft = <
       throw new Error("A draft is already active. Commit or discard it first.");
     }
     const document = store.getState().mimic.document;
-    draftRef.current = document.createDraft();
+    const draft = document.createDraft();
+    draftRef.current = draft;
+    setActiveDraft(store, draft);
     bumpVersion();
   }, [store, bumpVersion]);
 
   const commit = useCallback(() => {
     if (draftRef.current === null) return;
+    clearActiveDraft(store);
     draftRef.current.commit();
     draftRef.current = null;
     bumpVersion();
-  }, [bumpVersion]);
+  }, [store, bumpVersion]);
 
   const discard = useCallback(() => {
     if (draftRef.current === null) return;
+    clearActiveDraft(store);
     draftRef.current.discard();
     draftRef.current = null;
     bumpVersion();
-  }, [bumpVersion]);
-
-  const update = useCallback(
-    (fn: (root: Primitive.InferProxy<TSchema>) => void) => {
-      if (draftRef.current === null) {
-        throw new Error("No active draft. Call begin() first.");
-      }
-      draftRef.current.update(fn);
-    },
-    []
-  );
+  }, [store, bumpVersion]);
 
   // Auto-discard on unmount
   useEffect(() => {
     return () => {
       if (draftRef.current !== null) {
         try {
+          clearActiveDraft(store);
           draftRef.current.discard();
         } catch {
           // Draft may already be consumed
@@ -100,13 +97,12 @@ export const useDraft = <
         draftRef.current = null;
       }
     };
-  }, []);
+  }, [store]);
 
   return {
     draft: draftRef.current,
     begin,
     commit,
     discard,
-    update,
   };
 };