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

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @voidhash/mimic-react@1.0.0-beta.12 build /home/runner/work/mimic/mimic/packages/mimic-react
+> @voidhash/mimic-react@1.0.0-beta.13 build /home/runner/work/mimic/mimic/packages/mimic-react
 > tsdown
 
 ℹ tsdown v0.18.2 powered by rolldown v1.0.0-beta.55
@@ -9,47 +9,53 @@
 ℹ tsconfig: tsconfig.json
 ℹ Build start
 ℹ [CJS] dist/zustand-commander/index.cjs                                        0.78 kB │ gzip: 0.24 kB
-ℹ [CJS] dist/zustand/index.cjs                                                  0.10 kB │ gzip: 0.08 kB
+ℹ [CJS] dist/zustand/index.cjs                                                  0.20 kB │ gzip: 0.11 kB
 ℹ [CJS] dist/index.cjs                                                          0.00 kB │ gzip: 0.02 kB
 ℹ [CJS] dist/zustand-commander/commander.cjs                                    5.39 kB │ gzip: 1.54 kB
 ℹ [CJS] dist/zustand-commander/hooks.cjs                                        4.18 kB │ gzip: 1.46 kB
-ℹ [CJS] dist/zustand/middleware.cjs                                             3.06 kB │ gzip: 1.12 kB
+ℹ [CJS] dist/zustand/middleware.cjs                                             3.17 kB │ gzip: 1.14 kB
+ℹ [CJS] dist/zustand/useDraft.cjs                                               1.85 kB │ gzip: 0.64 kB
 ℹ [CJS] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/objectSpread2.cjs   0.95 kB │ gzip: 0.43 kB
 ℹ [CJS] dist/zustand-commander/types.cjs                                        0.91 kB │ gzip: 0.34 kB
 ℹ [CJS] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/typeof.cjs          0.53 kB │ gzip: 0.29 kB
 ℹ [CJS] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/toPrimitive.cjs     0.52 kB │ gzip: 0.32 kB
 ℹ [CJS] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/defineProperty.cjs  0.40 kB │ gzip: 0.24 kB
 ℹ [CJS] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/toPropertyKey.cjs   0.37 kB │ gzip: 0.23 kB
-ℹ [CJS] 12 files, total: 17.16 kB
+ℹ [CJS] 13 files, total: 19.23 kB
 ℹ [CJS] dist/zustand-commander/types.d.cts.map      2.75 kB │ gzip: 1.17 kB
 ℹ [CJS] dist/zustand/types.d.cts.map                1.24 kB │ gzip: 0.59 kB
+ℹ [CJS] dist/zustand/useDraft.d.cts.map             0.60 kB │ gzip: 0.30 kB
 ℹ [CJS] dist/zustand-commander/hooks.d.cts.map      0.48 kB │ gzip: 0.30 kB
 ℹ [CJS] dist/zustand/middleware.d.cts.map           0.38 kB │ gzip: 0.23 kB
 ℹ [CJS] dist/zustand-commander/commander.d.cts.map  0.30 kB │ gzip: 0.20 kB
 ℹ [CJS] dist/zustand-commander/index.d.cts          1.14 kB │ gzip: 0.36 kB
-ℹ [CJS] dist/zustand/index.d.cts                    0.24 kB │ gzip: 0.14 kB
+ℹ [CJS] dist/zustand/index.d.cts                    0.34 kB │ gzip: 0.17 kB
 ℹ [CJS] dist/index.d.cts                            0.01 kB │ gzip: 0.03 kB
 ℹ [CJS] dist/zustand-commander/types.d.cts          7.04 kB │ gzip: 2.06 kB
-ℹ [CJS] dist/zustand/types.d.cts                    3.15 kB │ gzip: 1.02 kB
+ℹ [CJS] dist/zustand/types.d.cts                    3.23 kB │ gzip: 1.04 kB
 ℹ [CJS] dist/zustand-commander/hooks.d.cts          2.52 kB │ gzip: 0.89 kB
 ℹ [CJS] dist/zustand/middleware.d.cts               2.13 kB │ gzip: 0.85 kB
 ℹ [CJS] dist/zustand-commander/commander.d.cts      1.63 kB │ gzip: 0.64 kB
-ℹ [CJS] 13 files, total: 23.02 kB
-✔ Build complete in 3873ms
+ℹ [CJS] dist/zustand/useDraft.d.cts                 1.45 kB │ gzip: 0.61 kB
+ℹ [CJS] 15 files, total: 25.23 kB
+✔ Build complete in 3602ms
 ℹ [ESM] dist/zustand-commander/index.mjs                                         0.47 kB │ gzip: 0.20 kB
-ℹ [ESM] dist/zustand/index.mjs                                                   0.06 kB │ gzip: 0.07 kB
+ℹ [ESM] dist/zustand/index.mjs                                                   0.11 kB │ gzip: 0.09 kB
 ℹ [ESM] dist/index.mjs                                                           0.01 kB │ gzip: 0.03 kB
 ℹ [ESM] dist/zustand-commander/commander.mjs.map                                11.46 kB │ gzip: 3.07 kB
 ℹ [ESM] dist/zustand-commander/types.mjs.map                                    10.16 kB │ gzip: 2.60 kB
 ℹ [ESM] dist/zustand-commander/hooks.mjs.map                                     9.15 kB │ gzip: 2.82 kB
-ℹ [ESM] dist/zustand/middleware.mjs.map                                          6.71 kB │ gzip: 2.08 kB
+ℹ [ESM] dist/zustand/middleware.mjs.map                                          6.89 kB │ gzip: 2.11 kB
 ℹ [ESM] dist/zustand-commander/commander.mjs                                     5.05 kB │ gzip: 1.54 kB
+ℹ [ESM] dist/zustand/useDraft.mjs.map                                            4.58 kB │ gzip: 1.56 kB
 ℹ [ESM] dist/zustand-commander/hooks.mjs                                         3.95 kB │ gzip: 1.46 kB
-ℹ [ESM] dist/zustand/middleware.mjs                                              3.00 kB │ gzip: 1.13 kB
+ℹ [ESM] dist/zustand/middleware.mjs                                              3.10 kB │ gzip: 1.15 kB
 ℹ [ESM] dist/zustand-commander/types.d.mts.map                                   2.75 kB │ gzip: 1.17 kB
+ℹ [ESM] dist/zustand/useDraft.mjs                                                1.81 kB │ gzip: 0.66 kB
 ℹ [ESM] dist/zustand/types.d.mts.map                                             1.24 kB │ gzip: 0.59 kB
 ℹ [ESM] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/objectSpread2.mjs    0.90 kB │ gzip: 0.42 kB
 ℹ [ESM] dist/zustand-commander/types.mjs                                         0.84 kB │ gzip: 0.35 kB
+ℹ [ESM] dist/zustand/useDraft.d.mts.map                                          0.60 kB │ gzip: 0.30 kB
 ℹ [ESM] dist/zustand-commander/hooks.d.mts.map                                   0.48 kB │ gzip: 0.30 kB
 ℹ [ESM] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/toPrimitive.mjs      0.47 kB │ gzip: 0.30 kB
 ℹ [ESM] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/typeof.mjs           0.43 kB │ gzip: 0.24 kB
@@ -58,12 +64,13 @@
 ℹ [ESM] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/toPropertyKey.mjs    0.30 kB │ gzip: 0.21 kB
 ℹ [ESM] dist/zustand-commander/commander.d.mts.map                               0.30 kB │ gzip: 0.20 kB
 ℹ [ESM] dist/zustand-commander/index.d.mts                                       1.14 kB │ gzip: 0.36 kB
-ℹ [ESM] dist/zustand/index.d.mts                                                 0.24 kB │ gzip: 0.14 kB
+ℹ [ESM] dist/zustand/index.d.mts                                                 0.34 kB │ gzip: 0.17 kB
 ℹ [ESM] dist/index.d.mts                                                         0.01 kB │ gzip: 0.03 kB
 ℹ [ESM] dist/zustand-commander/types.d.mts                                       7.04 kB │ gzip: 2.06 kB
-ℹ [ESM] dist/zustand/types.d.mts                                                 3.15 kB │ gzip: 1.02 kB
+ℹ [ESM] dist/zustand/types.d.mts                                                 3.23 kB │ gzip: 1.04 kB
 ℹ [ESM] dist/zustand-commander/hooks.d.mts                                       2.52 kB │ gzip: 0.89 kB
 ℹ [ESM] dist/zustand/middleware.d.mts                                            2.13 kB │ gzip: 0.85 kB
 ℹ [ESM] dist/zustand-commander/commander.d.mts                                   1.63 kB │ gzip: 0.64 kB
-ℹ [ESM] 29 files, total: 76.36 kB
-✔ Build complete in 3878ms
+ℹ [ESM] dist/zustand/useDraft.d.mts                                              1.45 kB │ gzip: 0.61 kB
+ℹ [ESM] 33 files, total: 85.29 kB
+✔ Build complete in 3628ms

package/dist/zustand/index.cjs

@@ -1,3 +1,5 @@
 const require_middleware = require('./middleware.cjs');
+const require_useDraft = require('./useDraft.cjs');
 
-exports.mimic = require_middleware.mimic;
+exports.mimic = require_middleware.mimic;
+exports.useDraft = require_useDraft.useDraft;

package/dist/zustand/index.d.cts

@@ -1,3 +1,4 @@
 import { MimicMiddlewareOptions, MimicObject, MimicSlice, MimicStateCreator } from "./types.cjs";
 import { mimic } from "./middleware.cjs";
-export { type MimicMiddlewareOptions, type MimicObject, type MimicSlice, type MimicStateCreator, mimic };
+import { UseDraftReturn, useDraft } from "./useDraft.cjs";
+export { type MimicMiddlewareOptions, type MimicObject, type MimicSlice, type MimicStateCreator, type UseDraftReturn, mimic, useDraft };

package/dist/zustand/index.d.mts

@@ -1,3 +1,4 @@
 import { MimicMiddlewareOptions, MimicObject, MimicSlice, MimicStateCreator } from "./types.mjs";
 import { mimic } from "./middleware.mjs";
-export { type MimicMiddlewareOptions, type MimicObject, type MimicSlice, type MimicStateCreator, mimic };
+import { UseDraftReturn, useDraft } from "./useDraft.mjs";
+export { type MimicMiddlewareOptions, type MimicObject, type MimicSlice, type MimicStateCreator, type UseDraftReturn, mimic, useDraft };

package/dist/zustand/index.mjs

@@ -1,3 +1,4 @@
 import { mimic } from "./middleware.mjs";
+import { useDraft } from "./useDraft.mjs";
 
-export { mimic };
+export { mimic, useDraft };

package/dist/zustand/middleware.cjs

@@ -18,7 +18,8 @@ const createMimicObject = (document) => {
 		isConnected: document.isConnected(),
 		isReady: document.isReady(),
 		pendingCount: document.getPendingCount(),
-		hasPendingChanges: document.hasPendingChanges()
+		hasPendingChanges: document.hasPendingChanges(),
+		activeDraftIds: document.getActiveDraftIds()
 	};
 };
 /**
@@ -43,6 +44,9 @@ const mimicImpl = (document, config, options = {}) => {
 				},
 				onReady: () => {
 					updateMimicState();
+				},
+				onDraftChange: () => {
+					updateMimicState();
 				}
 			});
 			(_document$presence = document.presence) === null || _document$presence === void 0 || _document$presence.subscribe({ onPresenceChange: () => {

package/dist/zustand/middleware.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.cts","names":[],"sources":["../../src/zustand/middleware.ts"],"sourcesContent":[],"mappings":";;;;;;KAaK,eAAA,oBACa,SAAA,CAAU,gCACR,QAAA,CAAS,6EAEd,sDACA,mDAEH,cAAA,CAAe,eAAe,SAAS,oBACzC,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK,cACzD,2BACP,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK,IAAI,WAAW,SAAS;;AAhBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmKjB;;;;;;cAAa,OAAgC"}
+{"version":3,"file":"middleware.d.cts","names":[],"sources":["../../src/zustand/middleware.ts"],"sourcesContent":[],"mappings":";;;;;;KAaK,eAAA,oBACa,SAAA,CAAU,gCACR,QAAA,CAAS,6EAEd,sDACA,mDAEH,cAAA,CAAe,eAAe,SAAS,oBACzC,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK,cACzD,2BACP,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK,IAAI,WAAW,SAAS;;AAhBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuKjB;;;;;;cAAa,OAAgC"}

package/dist/zustand/middleware.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.mts","names":[],"sources":["../../src/zustand/middleware.ts"],"sourcesContent":[],"mappings":";;;;;;KAaK,eAAA,oBACa,SAAA,CAAU,gCACR,QAAA,CAAS,6EAEd,sDACA,mDAEH,cAAA,CAAe,eAAe,SAAS,oBACzC,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK,cACzD,2BACP,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK,IAAI,WAAW,SAAS;;AAhBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmKjB;;;;;;cAAa,OAAgC"}
+{"version":3,"file":"middleware.d.mts","names":[],"sources":["../../src/zustand/middleware.ts"],"sourcesContent":[],"mappings":";;;;;;KAaK,eAAA,oBACa,SAAA,CAAU,gCACR,QAAA,CAAS,6EAEd,sDACA,mDAEH,cAAA,CAAe,eAAe,SAAS,oBACzC,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK,cACzD,2BACP,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK,IAAI,WAAW,SAAS;;AAhBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuKjB;;;;;;cAAa,OAAgC"}

package/dist/zustand/middleware.mjs

@@ -18,7 +18,8 @@ const createMimicObject = (document) => {
 		isConnected: document.isConnected(),
 		isReady: document.isReady(),
 		pendingCount: document.getPendingCount(),
-		hasPendingChanges: document.hasPendingChanges()
+		hasPendingChanges: document.hasPendingChanges(),
+		activeDraftIds: document.getActiveDraftIds()
 	};
 };
 /**
@@ -43,6 +44,9 @@ const mimicImpl = (document, config, options = {}) => {
 				},
 				onReady: () => {
 					updateMimicState();
+				},
+				onDraftChange: () => {
+					updateMimicState();
 				}
 			});
 			(_document$presence = document.presence) === null || _document$presence === void 0 || _document$presence.subscribe({ onPresenceChange: () => {

package/dist/zustand/middleware.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.mjs","names":["mimicImpl: MimicMiddlewareImpl"],"sources":["../../src/zustand/middleware.ts"],"sourcesContent":["import type { StateCreator, StoreMutatorIdentifier } from \"zustand\";\nimport type { ClientDocument } from \"@voidhash/mimic/client\";\nimport type { Primitive, Presence } from \"@voidhash/mimic\";\nimport type {\n  MimicSlice,\n  MimicObject,\n  MimicMiddlewareOptions,\n} from \"./types\";\n\n// =============================================================================\n// Middleware Implementation\n// =============================================================================\n\ntype MimicMiddleware = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends Presence.AnyPresence | undefined = undefined,\n  T extends object = object,\n  Mps extends [StoreMutatorIdentifier, unknown][] = [],\n  Mcs extends [StoreMutatorIdentifier, unknown][] = [],\n>(\n  document: ClientDocument.ClientDocument<TSchema, TPresence>,\n  config: StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T>,\n  options?: MimicMiddlewareOptions\n) => StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T & MimicSlice<TSchema, TPresence>>;\n\ntype MimicMiddlewareImpl = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends Presence.AnyPresence | undefined = undefined,\n  T extends object = object,\n>(\n  document: ClientDocument.ClientDocument<TSchema, TPresence>,\n  config: StateCreator<T & MimicSlice<TSchema, TPresence>, [], [], T>,\n  options?: MimicMiddlewareOptions\n) => StateCreator<T & MimicSlice<TSchema, TPresence>, [], [], T & MimicSlice<TSchema, TPresence>>;\n\n/**\n * Creates a MimicObject from the current document state.\n */\nconst createMimicObject = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends Presence.AnyPresence | undefined = undefined\n>(\n  document: ClientDocument.ClientDocument<TSchema, TPresence>\n): MimicObject<TSchema, TPresence> => {\n  const presence = document.presence\n    ? {\n        selfId: document.presence.selfId(),\n        self: document.presence.self(),\n        // Important: clone Maps to ensure zustand selectors re-render\n        // when presence changes (the underlying ClientDocument mutates Maps in-place).\n        others: new Map(document.presence.others()),\n        all: new Map(document.presence.all()),\n      }\n    : undefined;\n\n  return {\n    document,\n    snapshot: document.root.toSnapshot() as Primitive.InferSnapshot<TSchema>,\n    presence: presence as MimicObject<TSchema, TPresence>[\"presence\"],\n    isConnected: document.isConnected(),\n    isReady: document.isReady(),\n    pendingCount: document.getPendingCount(),\n    hasPendingChanges: document.hasPendingChanges(),\n  };\n};\n\n/**\n * Implementation of the mimic middleware.\n */\nconst mimicImpl: MimicMiddlewareImpl = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends Presence.AnyPresence | undefined = undefined,\n  _T extends object = object\n>(\n  document: ClientDocument.ClientDocument<TSchema, TPresence>,\n  config: any,\n  options: MimicMiddlewareOptions = {}\n) => {\n  const { autoSubscribe = true, autoConnect = true } = options;\n\n  return (set: any, get: any, api: any) => {\n    // Create initial mimic slice\n    const initialMimic = createMimicObject(document);\n\n    // Helper to update mimic state\n    const updateMimicState = () => {\n      const newMimic = createMimicObject(document);\n      set(\n        (state: any) => ({\n          ...state,\n          mimic: newMimic,\n        }),\n        false\n      );\n    };\n\n    // Subscribe to document changes\n    if (autoSubscribe) {\n      document.subscribe({\n        onStateChange: () => {\n          updateMimicState();\n        },\n        onConnectionChange: () => {\n          updateMimicState();\n        },\n        onReady: () => {\n          updateMimicState();\n        },\n      });\n\n      // Subscribe to presence changes (if presence schema is enabled)\n      document.presence?.subscribe({\n        onPresenceChange: () => {\n          updateMimicState();\n        },\n      });\n    }\n\n    if (autoConnect) {\n      document.connect();\n    }\n\n    // Get user's state - pass through set/get/api directly\n    // The user's set calls won't affect mimic state since we update it separately\n    const userState = config(set, get, api);\n\n    // Combine user state with mimic slice\n    return {\n      ...userState,\n      mimic: initialMimic,\n    };\n  };\n};\n\n/**\n * Zustand middleware that integrates a ClientDocument.\n * \n * Adds a `mimic` object to the store containing:\n * - `document`: The ClientDocument instance for performing transactions\n * - `snapshot`: Read-only snapshot of the document state (reactive)\n * - `presence`: Reactive presence snapshot (self + others). Undefined if presence is not enabled on the ClientDocument.\n * - `isConnected`: Connection status\n * - `isReady`: Ready status\n * - `pendingCount`: Number of pending transactions\n * - `hasPendingChanges`: Whether there are pending changes\n * \n * @example\n * ```ts\n * import { create } from 'zustand'\n * import { mimic } from '@voidhash/mimic-react/zustand'\n * \n * const useStore = create(\n *   mimic(clientDocument, (set, get) => ({\n *     // Your additional store state\n *   }))\n * )\n * \n * // Read snapshot (reactive)\n * const snapshot = useStore(state => state.mimic.snapshot)\n * \n * // Read presence (reactive, if enabled)\n * const myPresence = useStore(state => state.mimic.presence?.self)\n * const othersPresence = useStore(state => state.mimic.presence?.others)\n * \n * // Write via document\n * store.getState().mimic.document.transaction(root => {\n *   root.name.set(\"New Name\")\n * })\n * ```\n */\nexport const mimic = mimicImpl as unknown as MimicMiddleware;\n"],"mappings":";;;;;;AAsCA,MAAM,qBAIJ,aACoC;CACpC,MAAM,WAAW,SAAS,WACtB;EACE,QAAQ,SAAS,SAAS,QAAQ;EAClC,MAAM,SAAS,SAAS,MAAM;EAG9B,QAAQ,IAAI,IAAI,SAAS,SAAS,QAAQ,CAAC;EAC3C,KAAK,IAAI,IAAI,SAAS,SAAS,KAAK,CAAC;EACtC,GACD;AAEJ,QAAO;EACL;EACA,UAAU,SAAS,KAAK,YAAY;EAC1B;EACV,aAAa,SAAS,aAAa;EACnC,SAAS,SAAS,SAAS;EAC3B,cAAc,SAAS,iBAAiB;EACxC,mBAAmB,SAAS,mBAAmB;EAChD;;;;;AAMH,MAAMA,aAKJ,UACA,QACA,UAAkC,EAAE,KACjC;CACH,MAAM,EAAE,gBAAgB,MAAM,cAAc,SAAS;AAErD,SAAQ,KAAU,KAAU,QAAa;EAEvC,MAAM,eAAe,kBAAkB,SAAS;EAGhD,MAAM,yBAAyB;GAC7B,MAAM,WAAW,kBAAkB,SAAS;AAC5C,QACG,4CACI,cACH,OAAO,aAET,MACD;;AAIH,MAAI,eAAe;;AACjB,YAAS,UAAU;IACjB,qBAAqB;AACnB,uBAAkB;;IAEpB,0BAA0B;AACxB,uBAAkB;;IAEpB,eAAe;AACb,uBAAkB;;IAErB,CAAC;AAGF,kCAAS,0EAAU,UAAU,EAC3B,wBAAwB;AACtB,sBAAkB;MAErB,CAAC;;AAGJ,MAAI,YACF,UAAS,SAAS;AAQpB,2CAHkB,OAAO,KAAK,KAAK,IAAI,SAKrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCb,MAAa,QAAQ"}
+{"version":3,"file":"middleware.mjs","names":["mimicImpl: MimicMiddlewareImpl"],"sources":["../../src/zustand/middleware.ts"],"sourcesContent":["import type { StateCreator, StoreMutatorIdentifier } from \"zustand\";\nimport type { ClientDocument } from \"@voidhash/mimic/client\";\nimport type { Primitive, Presence } from \"@voidhash/mimic\";\nimport type {\n  MimicSlice,\n  MimicObject,\n  MimicMiddlewareOptions,\n} from \"./types\";\n\n// =============================================================================\n// Middleware Implementation\n// =============================================================================\n\ntype MimicMiddleware = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends Presence.AnyPresence | undefined = undefined,\n  T extends object = object,\n  Mps extends [StoreMutatorIdentifier, unknown][] = [],\n  Mcs extends [StoreMutatorIdentifier, unknown][] = [],\n>(\n  document: ClientDocument.ClientDocument<TSchema, TPresence>,\n  config: StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T>,\n  options?: MimicMiddlewareOptions\n) => StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T & MimicSlice<TSchema, TPresence>>;\n\ntype MimicMiddlewareImpl = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends Presence.AnyPresence | undefined = undefined,\n  T extends object = object,\n>(\n  document: ClientDocument.ClientDocument<TSchema, TPresence>,\n  config: StateCreator<T & MimicSlice<TSchema, TPresence>, [], [], T>,\n  options?: MimicMiddlewareOptions\n) => StateCreator<T & MimicSlice<TSchema, TPresence>, [], [], T & MimicSlice<TSchema, TPresence>>;\n\n/**\n * Creates a MimicObject from the current document state.\n */\nconst createMimicObject = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends Presence.AnyPresence | undefined = undefined\n>(\n  document: ClientDocument.ClientDocument<TSchema, TPresence>\n): MimicObject<TSchema, TPresence> => {\n  const presence = document.presence\n    ? {\n        selfId: document.presence.selfId(),\n        self: document.presence.self(),\n        // Important: clone Maps to ensure zustand selectors re-render\n        // when presence changes (the underlying ClientDocument mutates Maps in-place).\n        others: new Map(document.presence.others()),\n        all: new Map(document.presence.all()),\n      }\n    : undefined;\n\n  return {\n    document,\n    snapshot: document.root.toSnapshot() as Primitive.InferSnapshot<TSchema>,\n    presence: presence as MimicObject<TSchema, TPresence>[\"presence\"],\n    isConnected: document.isConnected(),\n    isReady: document.isReady(),\n    pendingCount: document.getPendingCount(),\n    hasPendingChanges: document.hasPendingChanges(),\n    activeDraftIds: document.getActiveDraftIds(),\n  };\n};\n\n/**\n * Implementation of the mimic middleware.\n */\nconst mimicImpl: MimicMiddlewareImpl = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends Presence.AnyPresence | undefined = undefined,\n  _T extends object = object\n>(\n  document: ClientDocument.ClientDocument<TSchema, TPresence>,\n  config: any,\n  options: MimicMiddlewareOptions = {}\n) => {\n  const { autoSubscribe = true, autoConnect = true } = options;\n\n  return (set: any, get: any, api: any) => {\n    // Create initial mimic slice\n    const initialMimic = createMimicObject(document);\n\n    // Helper to update mimic state\n    const updateMimicState = () => {\n      const newMimic = createMimicObject(document);\n      set(\n        (state: any) => ({\n          ...state,\n          mimic: newMimic,\n        }),\n        false\n      );\n    };\n\n    // Subscribe to document changes\n    if (autoSubscribe) {\n      document.subscribe({\n        onStateChange: () => {\n          updateMimicState();\n        },\n        onConnectionChange: () => {\n          updateMimicState();\n        },\n        onReady: () => {\n          updateMimicState();\n        },\n        onDraftChange: () => {\n          updateMimicState();\n        },\n      });\n\n      // Subscribe to presence changes (if presence schema is enabled)\n      document.presence?.subscribe({\n        onPresenceChange: () => {\n          updateMimicState();\n        },\n      });\n    }\n\n    if (autoConnect) {\n      document.connect();\n    }\n\n    // Get user's state - pass through set/get/api directly\n    // The user's set calls won't affect mimic state since we update it separately\n    const userState = config(set, get, api);\n\n    // Combine user state with mimic slice\n    return {\n      ...userState,\n      mimic: initialMimic,\n    };\n  };\n};\n\n/**\n * Zustand middleware that integrates a ClientDocument.\n * \n * Adds a `mimic` object to the store containing:\n * - `document`: The ClientDocument instance for performing transactions\n * - `snapshot`: Read-only snapshot of the document state (reactive)\n * - `presence`: Reactive presence snapshot (self + others). Undefined if presence is not enabled on the ClientDocument.\n * - `isConnected`: Connection status\n * - `isReady`: Ready status\n * - `pendingCount`: Number of pending transactions\n * - `hasPendingChanges`: Whether there are pending changes\n * \n * @example\n * ```ts\n * import { create } from 'zustand'\n * import { mimic } from '@voidhash/mimic-react/zustand'\n * \n * const useStore = create(\n *   mimic(clientDocument, (set, get) => ({\n *     // Your additional store state\n *   }))\n * )\n * \n * // Read snapshot (reactive)\n * const snapshot = useStore(state => state.mimic.snapshot)\n * \n * // Read presence (reactive, if enabled)\n * const myPresence = useStore(state => state.mimic.presence?.self)\n * const othersPresence = useStore(state => state.mimic.presence?.others)\n * \n * // Write via document\n * store.getState().mimic.document.transaction(root => {\n *   root.name.set(\"New Name\")\n * })\n * ```\n */\nexport const mimic = mimicImpl as unknown as MimicMiddleware;\n"],"mappings":";;;;;;AAsCA,MAAM,qBAIJ,aACoC;CACpC,MAAM,WAAW,SAAS,WACtB;EACE,QAAQ,SAAS,SAAS,QAAQ;EAClC,MAAM,SAAS,SAAS,MAAM;EAG9B,QAAQ,IAAI,IAAI,SAAS,SAAS,QAAQ,CAAC;EAC3C,KAAK,IAAI,IAAI,SAAS,SAAS,KAAK,CAAC;EACtC,GACD;AAEJ,QAAO;EACL;EACA,UAAU,SAAS,KAAK,YAAY;EAC1B;EACV,aAAa,SAAS,aAAa;EACnC,SAAS,SAAS,SAAS;EAC3B,cAAc,SAAS,iBAAiB;EACxC,mBAAmB,SAAS,mBAAmB;EAC/C,gBAAgB,SAAS,mBAAmB;EAC7C;;;;;AAMH,MAAMA,aAKJ,UACA,QACA,UAAkC,EAAE,KACjC;CACH,MAAM,EAAE,gBAAgB,MAAM,cAAc,SAAS;AAErD,SAAQ,KAAU,KAAU,QAAa;EAEvC,MAAM,eAAe,kBAAkB,SAAS;EAGhD,MAAM,yBAAyB;GAC7B,MAAM,WAAW,kBAAkB,SAAS;AAC5C,QACG,4CACI,cACH,OAAO,aAET,MACD;;AAIH,MAAI,eAAe;;AACjB,YAAS,UAAU;IACjB,qBAAqB;AACnB,uBAAkB;;IAEpB,0BAA0B;AACxB,uBAAkB;;IAEpB,eAAe;AACb,uBAAkB;;IAEpB,qBAAqB;AACnB,uBAAkB;;IAErB,CAAC;AAGF,kCAAS,0EAAU,UAAU,EAC3B,wBAAwB;AACtB,sBAAkB;MAErB,CAAC;;AAGJ,MAAI,YACF,UAAS,SAAS;AAQpB,2CAHkB,OAAO,KAAK,KAAK,IAAI,SAKrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCb,MAAa,QAAQ"}

package/dist/zustand/types.d.cts

@@ -49,6 +49,8 @@ interface MimicObject<TSchema extends Primitive.AnyPrimitive, TPresence extends
   readonly pendingCount: number;
   /** Whether there are pending changes */
   readonly hasPendingChanges: boolean;
+  /** Set of active draft IDs */
+  readonly activeDraftIds: ReadonlySet<string>;
 }
 /**
  * The state slice added by the mimic middleware.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/zustand/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAWA;AAAiD,UAAhC,aAAyC,CAAA,kBAAT,QAAA,CAAS,WAAA,CAAA,CAAA;EAW1B;;;;EAO5B,SAAS,MAAA,EAAA,MAAA,GAAA,SAAA;EAFM;;;;EAQH,SAAA,IAAA,EAbC,QAAA,CAAS,KAaV,CAbgB,SAahB,CAAA,GAAA,SAAA;EAAW;AAU3B;;EAEoB,SAAS,MAAA,EApBV,WAoBU,CAAA,MAAA,EAlBzB,QAAA,CAAS,aAkBgB,CAlBF,QAAA,CAAS,KAkBP,CAlBa,SAkBb,CAAA,CAAA,CAAA;EAGsB;;;EAEN,SAAA,GAAA,EAjB7B,WAiB6B,CAAA,MAAA,EAfzC,QAAA,CAAS,aAegC,CAflB,QAAA,CAAS,KAeS,CAfH,SAeG,CAAA,CAAA,CAAA;;;;;;AAM1B,UAbF,WAaE,CAAA,gBAZD,SAAA,CAAU,YAYT,EAAA,kBAXC,QAAA,CAAS,WAWV,GAAA,SAAA,GAAA,SAAA,CAAA,CAAA;EAeF;EACC,SAAU,QAAA,EAxBP,cAAA,CAAe,cAwBR,CAxBuB,OAwBvB,EAxBgC,SAwBhC,CAAA;EACR;EAGU,SAAA,QAAA,EA1BT,SAAA,CAAU,aA0BD,CA1Be,OA0Bf,CAAA;EAAS;;;AAsBvC;EACkB,SAAU,QAAA,EA5CP,SA4CO,SA5CW,QAAA,CAAS,WA4CpB,GA3CtB,aA2CsB,CA3CR,SA2CQ,CAAA,GAAA,SAAA;EACR;EAEL,SAAA,WAAA,EAAA,OAAA;EACA;EACE,SAAA,OAAA,EAAA,OAAA;EAAe;EAAS,SAAA,YAAA,EAAA,MAAA;EAApB;EAAgC,SAAA,iBAAA,EAAA,OAAA;;;;;AAKpC,UAtCA,UAsCA,CAAA,gBArCC,SAAA,CAAU,YAqCW,EAAA,kBApCnB,QAAA,CAAS,WAoCU,GAAA,SAAA,GAAA,SAAA,CAAA,CAAA;;kBAjCrB,YAAY,SAAS;;;;;KAsB3B,kCACM,SAAA,CAAU,gCACR,QAAA,CAAS,yCAEd,sDACA,2CACX,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK;;;;UAK9C,sBAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/zustand/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAWA;AAAiD,UAAhC,aAAyC,CAAA,kBAAT,QAAA,CAAS,WAAA,CAAA,CAAA;EAW1B;;;;EAO5B,SAAS,MAAA,EAAA,MAAA,GAAA,SAAA;EAFM;;;;EAQH,SAAA,IAAA,EAbC,QAAA,CAAS,KAaV,CAbgB,SAahB,CAAA,GAAA,SAAA;EAAW;AAU3B;;EAEoB,SAAS,MAAA,EApBV,WAoBU,CAAA,MAAA,EAlBzB,QAAA,CAAS,aAkBgB,CAlBF,QAAA,CAAS,KAkBP,CAlBa,SAkBb,CAAA,CAAA,CAAA;EAGsB;;;EAEN,SAAA,GAAA,EAjB7B,WAiB6B,CAAA,MAAA,EAfzC,QAAA,CAAS,aAegC,CAflB,QAAA,CAAS,KAeS,CAfH,SAeG,CAAA,CAAA,CAAA;;;;;;AAiBlB,UAxBV,WAwBU,CAAA,gBAvBT,SAAA,CAAU,YAuBD,EAAA,kBAtBP,QAAA,CAAS,WAsBF,GAAA,SAAA,GAAA,SAAA,CAAA,CAAA;EAAW;EAMrB,SAAA,QAAU,EAzBN,cAAA,CAAe,cAyBT,CAzBwB,OAyBxB,EAzBiC,SAyBjC,CAAA;EACT;EACE,SAAS,QAAA,EAzBR,SAAA,CAAU,aAyBF,CAzBgB,OAyBhB,CAAA;EAGC;;;;EAsBlB,SAAA,QAAA,EA7CS,SA6CQ,SA7CU,QAAA,CAAS,WA6CnB,GA5CvB,aA4CuB,CA5CT,SA4CS,CAAA,GAAA,SAAA;EACX;EACE,SAAS,WAAA,EAAA,OAAA;EAEd;EACA,SAAA,OAAA,EAAA,OAAA;EACE;EAAe,SAAA,YAAA,EAAA,MAAA;EAAS;EAApB,SAAA,iBAAA,EAAA,OAAA;EAAgC;EAAK,SAAA,cAAA,EAvC/B,WAuC+B,CAAA,MAAA,CAAA;;;;AAK1D;UAtCiB,2BACC,SAAA,CAAU,gCACR,QAAA,CAAS;;kBAGX,YAAY,SAAS;;;;;KAsB3B,kCACM,SAAA,CAAU,gCACR,QAAA,CAAS,yCAEd,sDACA,2CACX,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK;;;;UAK9C,sBAAA"}

package/dist/zustand/types.d.mts

@@ -49,6 +49,8 @@ interface MimicObject<TSchema extends Primitive.AnyPrimitive, TPresence extends
   readonly pendingCount: number;
   /** Whether there are pending changes */
   readonly hasPendingChanges: boolean;
+  /** Set of active draft IDs */
+  readonly activeDraftIds: ReadonlySet<string>;
 }
 /**
  * The state slice added by the mimic middleware.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/zustand/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAWA;AAAiD,UAAhC,aAAyC,CAAA,kBAAT,QAAA,CAAS,WAAA,CAAA,CAAA;EAW1B;;;;EAO5B,SAAS,MAAA,EAAA,MAAA,GAAA,SAAA;EAFM;;;;EAQH,SAAA,IAAA,EAbC,QAAA,CAAS,KAaV,CAbgB,SAahB,CAAA,GAAA,SAAA;EAAW;AAU3B;;EAEoB,SAAS,MAAA,EApBV,WAoBU,CAAA,MAAA,EAlBzB,QAAA,CAAS,aAkBgB,CAlBF,QAAA,CAAS,KAkBP,CAlBa,SAkBb,CAAA,CAAA,CAAA;EAGsB;;;EAEN,SAAA,GAAA,EAjB7B,WAiB6B,CAAA,MAAA,EAfzC,QAAA,CAAS,aAegC,CAflB,QAAA,CAAS,KAeS,CAfH,SAeG,CAAA,CAAA,CAAA;;;;;;AAM1B,UAbF,WAaE,CAAA,gBAZD,SAAA,CAAU,YAYT,EAAA,kBAXC,QAAA,CAAS,WAWV,GAAA,SAAA,GAAA,SAAA,CAAA,CAAA;EAeF;EACC,SAAU,QAAA,EAxBP,cAAA,CAAe,cAwBR,CAxBuB,OAwBvB,EAxBgC,SAwBhC,CAAA;EACR;EAGU,SAAA,QAAA,EA1BT,SAAA,CAAU,aA0BD,CA1Be,OA0Bf,CAAA;EAAS;;;AAsBvC;EACkB,SAAU,QAAA,EA5CP,SA4CO,SA5CW,QAAA,CAAS,WA4CpB,GA3CtB,aA2CsB,CA3CR,SA2CQ,CAAA,GAAA,SAAA;EACR;EAEL,SAAA,WAAA,EAAA,OAAA;EACA;EACE,SAAA,OAAA,EAAA,OAAA;EAAe;EAAS,SAAA,YAAA,EAAA,MAAA;EAApB;EAAgC,SAAA,iBAAA,EAAA,OAAA;;;;;AAKpC,UAtCA,UAsCA,CAAA,gBArCC,SAAA,CAAU,YAqCW,EAAA,kBApCnB,QAAA,CAAS,WAoCU,GAAA,SAAA,GAAA,SAAA,CAAA,CAAA;;kBAjCrB,YAAY,SAAS;;;;;KAsB3B,kCACM,SAAA,CAAU,gCACR,QAAA,CAAS,yCAEd,sDACA,2CACX,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK;;;;UAK9C,sBAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/zustand/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAWA;AAAiD,UAAhC,aAAyC,CAAA,kBAAT,QAAA,CAAS,WAAA,CAAA,CAAA;EAW1B;;;;EAO5B,SAAS,MAAA,EAAA,MAAA,GAAA,SAAA;EAFM;;;;EAQH,SAAA,IAAA,EAbC,QAAA,CAAS,KAaV,CAbgB,SAahB,CAAA,GAAA,SAAA;EAAW;AAU3B;;EAEoB,SAAS,MAAA,EApBV,WAoBU,CAAA,MAAA,EAlBzB,QAAA,CAAS,aAkBgB,CAlBF,QAAA,CAAS,KAkBP,CAlBa,SAkBb,CAAA,CAAA,CAAA;EAGsB;;;EAEN,SAAA,GAAA,EAjB7B,WAiB6B,CAAA,MAAA,EAfzC,QAAA,CAAS,aAegC,CAflB,QAAA,CAAS,KAeS,CAfH,SAeG,CAAA,CAAA,CAAA;;;;;;AAiBlB,UAxBV,WAwBU,CAAA,gBAvBT,SAAA,CAAU,YAuBD,EAAA,kBAtBP,QAAA,CAAS,WAsBF,GAAA,SAAA,GAAA,SAAA,CAAA,CAAA;EAAW;EAMrB,SAAA,QAAU,EAzBN,cAAA,CAAe,cAyBT,CAzBwB,OAyBxB,EAzBiC,SAyBjC,CAAA;EACT;EACE,SAAS,QAAA,EAzBR,SAAA,CAAU,aAyBF,CAzBgB,OAyBhB,CAAA;EAGC;;;;EAsBlB,SAAA,QAAA,EA7CS,SA6CQ,SA7CU,QAAA,CAAS,WA6CnB,GA5CvB,aA4CuB,CA5CT,SA4CS,CAAA,GAAA,SAAA;EACX;EACE,SAAS,WAAA,EAAA,OAAA;EAEd;EACA,SAAA,OAAA,EAAA,OAAA;EACE;EAAe,SAAA,YAAA,EAAA,MAAA;EAAS;EAApB,SAAA,iBAAA,EAAA,OAAA;EAAgC;EAAK,SAAA,cAAA,EAvC/B,WAuC+B,CAAA,MAAA,CAAA;;;;AAK1D;UAtCiB,2BACC,SAAA,CAAU,gCACR,QAAA,CAAS;;kBAGX,YAAY,SAAS;;;;;KAsB3B,kCACM,SAAA,CAAU,gCACR,QAAA,CAAS,yCAEd,sDACA,2CACX,aAAa,IAAI,WAAW,SAAS,YAAY,KAAK,KAAK;;;;UAK9C,sBAAA"}

package/dist/zustand/useDraft.cjs

@@ -0,0 +1,64 @@
+let react = require("react");
+
+//#region src/zustand/useDraft.ts
+/**
+* React hook for managing a draft lifecycle with auto-cleanup on unmount.
+*
+* @param store - The zustand store containing the mimic slice
+* @returns Draft control methods
+*/
+const useDraft = (store) => {
+	const draftRef = (0, react.useRef)(null);
+	const versionRef = (0, react.useRef)(0);
+	const subscribe = (0, react.useCallback)((onStoreChange) => {
+		return store.subscribe(onStoreChange);
+	}, [store]);
+	const getSnapshot = (0, react.useCallback)(() => {
+		return versionRef.current;
+	}, []);
+	(0, react.useSyncExternalStore)(subscribe, getSnapshot, getSnapshot);
+	const bumpVersion = (0, react.useCallback)(() => {
+		versionRef.current++;
+	}, []);
+	const begin = (0, react.useCallback)(() => {
+		if (draftRef.current !== null) throw new Error("A draft is already active. Commit or discard it first.");
+		draftRef.current = store.getState().mimic.document.createDraft();
+		bumpVersion();
+	}, [store, bumpVersion]);
+	const commit = (0, react.useCallback)(() => {
+		if (draftRef.current === null) return;
+		draftRef.current.commit();
+		draftRef.current = null;
+		bumpVersion();
+	}, [bumpVersion]);
+	const discard = (0, react.useCallback)(() => {
+		if (draftRef.current === null) return;
+		draftRef.current.discard();
+		draftRef.current = null;
+		bumpVersion();
+	}, [bumpVersion]);
+	const update = (0, react.useCallback)((fn) => {
+		if (draftRef.current === null) throw new Error("No active draft. Call begin() first.");
+		draftRef.current.update(fn);
+	}, []);
+	(0, react.useEffect)(() => {
+		return () => {
+			if (draftRef.current !== null) {
+				try {
+					draftRef.current.discard();
+				} catch (_unused) {}
+				draftRef.current = null;
+			}
+		};
+	}, []);
+	return {
+		draft: draftRef.current,
+		begin,
+		commit,
+		discard,
+		update
+	};
+};
+
+//#endregion
+exports.useDraft = useDraft;

package/dist/zustand/useDraft.d.cts

@@ -0,0 +1,32 @@
+import { MimicSlice } from "./types.cjs";
+import { StoreApi } from "zustand";
+import { ClientDocument } from "@voidhash/mimic/client";
+import * as _voidhash_mimic0 from "@voidhash/mimic";
+import { Primitive } from "@voidhash/mimic";
+
+//#region src/zustand/useDraft.d.ts
+/**
+ * Return type of the useDraft hook.
+ */
+interface UseDraftReturn<TSchema extends Primitive.AnyPrimitive> {
+  /** The active draft handle, or null if no draft is active */
+  readonly draft: ClientDocument.DraftHandle<TSchema> | null;
+  /** Creates a new draft. Throws if a draft is already active. */
+  readonly begin: () => void;
+  /** Commits the active draft. No-op if no draft is active. */
+  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.
+ *
+ * @param store - The zustand store containing the mimic slice
+ * @returns Draft control methods
+ */
+declare const useDraft: <TSchema extends Primitive.AnyPrimitive, TPresence extends _voidhash_mimic0.Presence.AnyPresence | undefined = undefined>(store: StoreApi<MimicSlice<TSchema, TPresence>>) => UseDraftReturn<TSchema>;
+//#endregion
+export { UseDraftReturn, useDraft };
+//# sourceMappingURL=useDraft.d.cts.map

package/dist/zustand/useDraft.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDraft.d.cts","names":[],"sources":["../../src/zustand/useDraft.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAUiB,UAAA,cAAc,CAAA,gBAAiB,SAAA,CAAU,YAA3B,CAAA,CAAA;EAAiB;EAEH,SAAA,KAAA,EAA3B,cAAA,CAAe,WAAY,CAAA,OAAA,CAAA,GAAA,IAAA;EAA3B;EAQkC,SAAA,KAAA,EAAA,GAAA,GAAA,IAAA;EAArB;EAAoB,SAAA,MAAA,EAAA,GAAA,GAAA,IAAA;EAStC;EACK,SAAU,OAAA,EAAA,GAAA,GAAA,IAAA;EACkB;EAEjB,SAAA,MAAA,EAAA,CAAA,EAAA,EAAA,CAAA,IAAA,EAbE,SAAA,CAAU,UAaZ,CAbuB,OAavB,CAAA,EAAA,GAAA,IAAA,EAAA,GAAA,IAAA;;;;;;;;cAJhB,2BACK,SAAA,CAAU,gCACkB,gBAAA,CAAA,QAAA,CAAS,WAAA,iCAE9C,SAAS,WAAW,SAAS,gBACnC,eAAe"}

package/dist/zustand/useDraft.d.mts

@@ -0,0 +1,32 @@
+import { MimicSlice } from "./types.mjs";
+import { StoreApi } from "zustand";
+import { ClientDocument } from "@voidhash/mimic/client";
+import * as _voidhash_mimic0 from "@voidhash/mimic";
+import { Primitive } from "@voidhash/mimic";
+
+//#region src/zustand/useDraft.d.ts
+/**
+ * Return type of the useDraft hook.
+ */
+interface UseDraftReturn<TSchema extends Primitive.AnyPrimitive> {
+  /** The active draft handle, or null if no draft is active */
+  readonly draft: ClientDocument.DraftHandle<TSchema> | null;
+  /** Creates a new draft. Throws if a draft is already active. */
+  readonly begin: () => void;
+  /** Commits the active draft. No-op if no draft is active. */
+  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.
+ *
+ * @param store - The zustand store containing the mimic slice
+ * @returns Draft control methods
+ */
+declare const useDraft: <TSchema extends Primitive.AnyPrimitive, TPresence extends _voidhash_mimic0.Presence.AnyPresence | undefined = undefined>(store: StoreApi<MimicSlice<TSchema, TPresence>>) => UseDraftReturn<TSchema>;
+//#endregion
+export { UseDraftReturn, useDraft };
+//# sourceMappingURL=useDraft.d.mts.map

package/dist/zustand/useDraft.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDraft.d.mts","names":[],"sources":["../../src/zustand/useDraft.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAUiB,UAAA,cAAc,CAAA,gBAAiB,SAAA,CAAU,YAA3B,CAAA,CAAA;EAAiB;EAEH,SAAA,KAAA,EAA3B,cAAA,CAAe,WAAY,CAAA,OAAA,CAAA,GAAA,IAAA;EAA3B;EAQkC,SAAA,KAAA,EAAA,GAAA,GAAA,IAAA;EAArB;EAAoB,SAAA,MAAA,EAAA,GAAA,GAAA,IAAA;EAStC;EACK,SAAU,OAAA,EAAA,GAAA,GAAA,IAAA;EACkB;EAEjB,SAAA,MAAA,EAAA,CAAA,EAAA,EAAA,CAAA,IAAA,EAbE,SAAA,CAAU,UAaZ,CAbuB,OAavB,CAAA,EAAA,GAAA,IAAA,EAAA,GAAA,IAAA;;;;;;;;cAJhB,2BACK,SAAA,CAAU,gCACkB,gBAAA,CAAA,QAAA,CAAS,WAAA,iCAE9C,SAAS,WAAW,SAAS,gBACnC,eAAe"}

package/dist/zustand/useDraft.mjs

@@ -0,0 +1,65 @@
+import { useCallback, useEffect, useRef, useSyncExternalStore } from "react";
+
+//#region src/zustand/useDraft.ts
+/**
+* React hook for managing a draft lifecycle with auto-cleanup on unmount.
+*
+* @param store - The zustand store containing the mimic slice
+* @returns Draft control methods
+*/
+const useDraft = (store) => {
+	const draftRef = useRef(null);
+	const versionRef = useRef(0);
+	const subscribe = useCallback((onStoreChange) => {
+		return store.subscribe(onStoreChange);
+	}, [store]);
+	const getSnapshot = useCallback(() => {
+		return versionRef.current;
+	}, []);
+	useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+	const bumpVersion = useCallback(() => {
+		versionRef.current++;
+	}, []);
+	const begin = useCallback(() => {
+		if (draftRef.current !== null) throw new Error("A draft is already active. Commit or discard it first.");
+		draftRef.current = store.getState().mimic.document.createDraft();
+		bumpVersion();
+	}, [store, bumpVersion]);
+	const commit = useCallback(() => {
+		if (draftRef.current === null) return;
+		draftRef.current.commit();
+		draftRef.current = null;
+		bumpVersion();
+	}, [bumpVersion]);
+	const discard = useCallback(() => {
+		if (draftRef.current === null) return;
+		draftRef.current.discard();
+		draftRef.current = null;
+		bumpVersion();
+	}, [bumpVersion]);
+	const update = useCallback((fn) => {
+		if (draftRef.current === null) throw new Error("No active draft. Call begin() first.");
+		draftRef.current.update(fn);
+	}, []);
+	useEffect(() => {
+		return () => {
+			if (draftRef.current !== null) {
+				try {
+					draftRef.current.discard();
+				} catch (_unused) {}
+				draftRef.current = null;
+			}
+		};
+	}, []);
+	return {
+		draft: draftRef.current,
+		begin,
+		commit,
+		discard,
+		update
+	};
+};
+
+//#endregion
+export { useDraft };
+//# sourceMappingURL=useDraft.mjs.map

package/dist/zustand/useDraft.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDraft.mjs","names":[],"sources":["../../src/zustand/useDraft.ts"],"sourcesContent":["import { useRef, useCallback, useEffect } from \"react\";\nimport { useSyncExternalStore } from \"react\";\nimport type { StoreApi } from \"zustand\";\nimport type { ClientDocument } from \"@voidhash/mimic/client\";\nimport type { Primitive } from \"@voidhash/mimic\";\nimport type { MimicSlice } from \"./types\";\n\n/**\n * Return type of the useDraft hook.\n */\nexport interface UseDraftReturn<TSchema extends Primitive.AnyPrimitive> {\n  /** The active draft handle, or null if no draft is active */\n  readonly draft: ClientDocument.DraftHandle<TSchema> | null;\n  /** Creates a new draft. Throws if a draft is already active. */\n  readonly begin: () => void;\n  /** Commits the active draft. No-op if no draft is active. */\n  readonly commit: () => void;\n  /** Discards the active draft. No-op if no draft is active. */\n  readonly discard: () => void;\n  /** Runs an update on the active draft. Throws if no draft is active. */\n  readonly update: (fn: (root: Primitive.InferProxy<TSchema>) => void) => void;\n}\n\n/**\n * React hook for managing a draft lifecycle with auto-cleanup on unmount.\n *\n * @param store - The zustand store containing the mimic slice\n * @returns Draft control methods\n */\nexport const useDraft = <\n  TSchema extends Primitive.AnyPrimitive,\n  TPresence extends import(\"@voidhash/mimic\").Presence.AnyPresence | undefined = undefined,\n>(\n  store: StoreApi<MimicSlice<TSchema, TPresence>>\n): UseDraftReturn<TSchema> => {\n  const draftRef = useRef<ClientDocument.DraftHandle<TSchema> | null>(null);\n  // Use a counter to force re-renders when draft state changes\n  const versionRef = useRef(0);\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      // We piggyback on the zustand store subscription to know when drafts change\n      return store.subscribe(onStoreChange);\n    },\n    [store]\n  );\n\n  const getSnapshot = useCallback(() => {\n    return versionRef.current;\n  }, []);\n\n  useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n  const bumpVersion = useCallback(() => {\n    versionRef.current++;\n  }, []);\n\n  const begin = useCallback(() => {\n    if (draftRef.current !== null) {\n      throw new Error(\"A draft is already active. Commit or discard it first.\");\n    }\n    const document = store.getState().mimic.document;\n    draftRef.current = document.createDraft();\n    bumpVersion();\n  }, [store, bumpVersion]);\n\n  const commit = useCallback(() => {\n    if (draftRef.current === null) return;\n    draftRef.current.commit();\n    draftRef.current = null;\n    bumpVersion();\n  }, [bumpVersion]);\n\n  const discard = useCallback(() => {\n    if (draftRef.current === null) return;\n    draftRef.current.discard();\n    draftRef.current = null;\n    bumpVersion();\n  }, [bumpVersion]);\n\n  const update = useCallback(\n    (fn: (root: Primitive.InferProxy<TSchema>) => void) => {\n      if (draftRef.current === null) {\n        throw new Error(\"No active draft. Call begin() first.\");\n      }\n      draftRef.current.update(fn);\n    },\n    []\n  );\n\n  // Auto-discard on unmount\n  useEffect(() => {\n    return () => {\n      if (draftRef.current !== null) {\n        try {\n          draftRef.current.discard();\n        } catch {\n          // Draft may already be consumed\n        }\n        draftRef.current = null;\n      }\n    };\n  }, []);\n\n  return {\n    draft: draftRef.current,\n    begin,\n    commit,\n    discard,\n    update,\n  };\n};\n"],"mappings":";;;;;;;;;AA6BA,MAAa,YAIX,UAC4B;CAC5B,MAAM,WAAW,OAAmD,KAAK;CAEzE,MAAM,aAAa,OAAO,EAAE;CAE5B,MAAM,YAAY,aACf,kBAA8B;AAE7B,SAAO,MAAM,UAAU,cAAc;IAEvC,CAAC,MAAM,CACR;CAED,MAAM,cAAc,kBAAkB;AACpC,SAAO,WAAW;IACjB,EAAE,CAAC;AAEN,sBAAqB,WAAW,aAAa,YAAY;CAEzD,MAAM,cAAc,kBAAkB;AACpC,aAAW;IACV,EAAE,CAAC;CAEN,MAAM,QAAQ,kBAAkB;AAC9B,MAAI,SAAS,YAAY,KACvB,OAAM,IAAI,MAAM,yDAAyD;AAG3E,WAAS,UADQ,MAAM,UAAU,CAAC,MAAM,SACZ,aAAa;AACzC,eAAa;IACZ,CAAC,OAAO,YAAY,CAAC;CAExB,MAAM,SAAS,kBAAkB;AAC/B,MAAI,SAAS,YAAY,KAAM;AAC/B,WAAS,QAAQ,QAAQ;AACzB,WAAS,UAAU;AACnB,eAAa;IACZ,CAAC,YAAY,CAAC;CAEjB,MAAM,UAAU,kBAAkB;AAChC,MAAI,SAAS,YAAY,KAAM;AAC/B,WAAS,QAAQ,SAAS;AAC1B,WAAS,UAAU;AACnB,eAAa;IACZ,CAAC,YAAY,CAAC;CAEjB,MAAM,SAAS,aACZ,OAAsD;AACrD,MAAI,SAAS,YAAY,KACvB,OAAM,IAAI,MAAM,uCAAuC;AAEzD,WAAS,QAAQ,OAAO,GAAG;IAE7B,EAAE,CACH;AAGD,iBAAgB;AACd,eAAa;AACX,OAAI,SAAS,YAAY,MAAM;AAC7B,QAAI;AACF,cAAS,QAAQ,SAAS;sBACpB;AAGR,aAAS,UAAU;;;IAGtB,EAAE,CAAC;AAEN,QAAO;EACL,OAAO,SAAS;EAChB;EACA;EACA;EACA;EACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidhash/mimic-react",
-  "version": "1.0.0-beta.12",
+  "version": "1.0.0-beta.13",
   "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.12"
+    "@voidhash/tsconfig": "1.0.0-beta.13"
   },
   "peerDependencies": {
     "effect": "^3.16.0",
     "react": "^18.0.0 || ^19.0.0",
-    "@voidhash/mimic": "1.0.0-beta.12"
+    "@voidhash/mimic": "1.0.0-beta.13"
   },
   "scripts": {
     "build": "tsdown",

package/src/zustand/index.ts

@@ -11,6 +11,7 @@
 // =============================================================================
 
 export { mimic } from "./middleware";
+export { useDraft } from "./useDraft";
 
 // =============================================================================
 // Types
@@ -22,3 +23,5 @@ export type {
   MimicMiddlewareOptions,
   MimicStateCreator,
 } from "./types";
+
+export type { UseDraftReturn } from "./useDraft";

package/src/zustand/middleware.ts

@@ -61,6 +61,7 @@ const createMimicObject = <
     isReady: document.isReady(),
     pendingCount: document.getPendingCount(),
     hasPendingChanges: document.hasPendingChanges(),
+    activeDraftIds: document.getActiveDraftIds(),
   };
 };
 
@@ -106,6 +107,9 @@ const mimicImpl: MimicMiddlewareImpl = <
         onReady: () => {
           updateMimicState();
         },
+        onDraftChange: () => {
+          updateMimicState();
+        },
       });
 
       // Subscribe to presence changes (if presence schema is enabled)

package/src/zustand/types.ts

@@ -66,6 +66,8 @@ export interface MimicObject<
   readonly pendingCount: number;
   /** Whether there are pending changes */
   readonly hasPendingChanges: boolean;
+  /** Set of active draft IDs */
+  readonly activeDraftIds: ReadonlySet<string>;
 }
 
 /**

package/src/zustand/useDraft.ts

@@ -0,0 +1,112 @@
+import { useRef, useCallback, useEffect } from "react";
+import { useSyncExternalStore } from "react";
+import type { StoreApi } from "zustand";
+import type { ClientDocument } from "@voidhash/mimic/client";
+import type { Primitive } from "@voidhash/mimic";
+import type { MimicSlice } from "./types";
+
+/**
+ * Return type of the useDraft hook.
+ */
+export interface UseDraftReturn<TSchema extends Primitive.AnyPrimitive> {
+  /** The active draft handle, or null if no draft is active */
+  readonly draft: ClientDocument.DraftHandle<TSchema> | null;
+  /** Creates a new draft. Throws if a draft is already active. */
+  readonly begin: () => void;
+  /** Commits the active draft. No-op if no draft is active. */
+  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.
+ *
+ * @param store - The zustand store containing the mimic 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>>
+): UseDraftReturn<TSchema> => {
+  const draftRef = useRef<ClientDocument.DraftHandle<TSchema> | null>(null);
+  // Use a counter to force re-renders when draft state changes
+  const versionRef = useRef(0);
+
+  const subscribe = useCallback(
+    (onStoreChange: () => void) => {
+      // We piggyback on the zustand store subscription to know when drafts change
+      return store.subscribe(onStoreChange);
+    },
+    [store]
+  );
+
+  const getSnapshot = useCallback(() => {
+    return versionRef.current;
+  }, []);
+
+  useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+
+  const bumpVersion = useCallback(() => {
+    versionRef.current++;
+  }, []);
+
+  const begin = useCallback(() => {
+    if (draftRef.current !== null) {
+      throw new Error("A draft is already active. Commit or discard it first.");
+    }
+    const document = store.getState().mimic.document;
+    draftRef.current = document.createDraft();
+    bumpVersion();
+  }, [store, bumpVersion]);
+
+  const commit = useCallback(() => {
+    if (draftRef.current === null) return;
+    draftRef.current.commit();
+    draftRef.current = null;
+    bumpVersion();
+  }, [bumpVersion]);
+
+  const discard = useCallback(() => {
+    if (draftRef.current === null) return;
+    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);
+    },
+    []
+  );
+
+  // Auto-discard on unmount
+  useEffect(() => {
+    return () => {
+      if (draftRef.current !== null) {
+        try {
+          draftRef.current.discard();
+        } catch {
+          // Draft may already be consumed
+        }
+        draftRef.current = null;
+      }
+    };
+  }, []);
+
+  return {
+    draft: draftRef.current,
+    begin,
+    commit,
+    discard,
+    update,
+  };
+};

package/tests/zustand/middleware.test.ts

@@ -79,6 +79,10 @@ const createMockClientDocument = (
     isReady: () => state.isReady,
     getPendingCount: () => state.pendingCount,
     hasPendingChanges: () => state.hasPendingChanges,
+    getActiveDraftIds: () => new Set<string>(),
+    createDraft: () => {
+      throw new Error("Not implemented in mock");
+    },
     connect: () => {
       // Mock connect - does nothing in tests
     },