@voidhash/mimic-react 0.0.1-alpha.7 → 0.0.1-alpha.8

package/.turbo/turbo-build.log

@@ -1,19 +1,35 @@
 
-> @voidhash/mimic-react@0.0.1-alpha.7 build /home/runner/work/mimic/mimic/packages/mimic-react
+> @voidhash/mimic-react@0.0.1-alpha.8 build /home/runner/work/mimic/mimic/packages/mimic-react
 > tsdown
 
 ℹ tsdown v0.18.2 powered by rolldown v1.0.0-beta.55
 ℹ config file: /home/runner/work/mimic/mimic/packages/mimic-react/tsdown.config.ts 
-ℹ entry: src/index.ts
+ℹ entry: src/index.ts, src/zustand/index.ts, src/zustand-commander/index.ts
 ℹ target: es2017
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ [CJS] dist/index.cjs  0.00 kB │ gzip: 0.02 kB
-ℹ [CJS] 1 files, total: 0.00 kB
-ℹ [ESM] dist/index.mjs    0.01 kB │ gzip: 0.03 kB
-ℹ [ESM] dist/index.d.mts  0.01 kB │ gzip: 0.03 kB
-ℹ [ESM] 2 files, total: 0.02 kB
-✔ Build complete in 3109ms
-ℹ [CJS] dist/index.d.cts  0.01 kB │ gzip: 0.03 kB
-ℹ [CJS] 1 files, total: 0.01 kB
-✔ Build complete in 3111ms
+ℹ [CJS] dist/zustand-commander/index.cjs  10.57 kB │ gzip: 2.75 kB
+ℹ [CJS] dist/zustand/index.cjs             3.02 kB │ gzip: 1.09 kB
+ℹ [CJS] dist/index.cjs                     0.00 kB │ gzip: 0.02 kB
+ℹ [CJS] dist/objectSpread2-CIP_6jda.cjs    2.23 kB │ gzip: 0.80 kB
+ℹ [CJS] 4 files, total: 15.81 kB
+ℹ [CJS] dist/zustand-commander/index.d.cts.map   5.67 kB │ gzip: 2.28 kB
+ℹ [CJS] dist/zustand/index.d.cts.map             1.86 kB │ gzip: 0.82 kB
+ℹ [CJS] dist/zustand-commander/index.d.cts      11.59 kB │ gzip: 3.11 kB
+ℹ [CJS] dist/zustand/index.d.cts                 5.01 kB │ gzip: 1.46 kB
+ℹ [CJS] dist/index.d.cts                         0.01 kB │ gzip: 0.03 kB
+ℹ [CJS] 5 files, total: 24.14 kB
+✔ Build complete in 5884ms
+ℹ [ESM] dist/zustand-commander/index.mjs         9.95 kB │ gzip: 2.71 kB
+ℹ [ESM] dist/zustand/index.mjs                   2.96 kB │ gzip: 1.11 kB
+ℹ [ESM] dist/index.mjs                           0.01 kB │ gzip: 0.03 kB
+ℹ [ESM] dist/zustand-commander/index.mjs.map    34.69 kB │ gzip: 7.63 kB
+ℹ [ESM] dist/zustand/index.mjs.map               6.71 kB │ gzip: 2.09 kB
+ℹ [ESM] dist/zustand-commander/index.d.mts.map   5.67 kB │ gzip: 2.28 kB
+ℹ [ESM] dist/objectSpread2-CxTyNSYl.mjs          2.13 kB │ gzip: 0.77 kB
+ℹ [ESM] dist/zustand/index.d.mts.map             1.86 kB │ gzip: 0.82 kB
+ℹ [ESM] dist/zustand-commander/index.d.mts      11.59 kB │ gzip: 3.11 kB
+ℹ [ESM] dist/zustand/index.d.mts                 5.01 kB │ gzip: 1.46 kB
+ℹ [ESM] dist/index.d.mts                         0.01 kB │ gzip: 0.03 kB
+ℹ [ESM] 11 files, total: 80.59 kB
+✔ Build complete in 5895ms

package/dist/objectSpread2-CIP_6jda.cjs

@@ -0,0 +1,73 @@
+
+//#region \0@oxc-project+runtime@0.103.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
+		return typeof o$1;
+	} : function(o$1) {
+		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r$1) {
+			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
+			_defineProperty(e, r$1, t[r$1]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
+			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
+		});
+	}
+	return e;
+}
+
+//#endregion
+Object.defineProperty(exports, '_objectSpread2', {
+  enumerable: true,
+  get: function () {
+    return _objectSpread2;
+  }
+});

package/dist/objectSpread2-CxTyNSYl.mjs

@@ -0,0 +1,67 @@
+//#region \0@oxc-project+runtime@0.103.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
+		return typeof o$1;
+	} : function(o$1) {
+		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.103.0/helpers/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r$1) {
+			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
+			_defineProperty(e, r$1, t[r$1]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
+			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
+		});
+	}
+	return e;
+}
+
+//#endregion
+export { _objectSpread2 as t };

package/dist/zustand/index.cjs

@@ -0,0 +1,95 @@
+const require_objectSpread2 = require('../objectSpread2-CIP_6jda.cjs');
+
+//#region src/zustand/middleware.ts
+/**
+* Creates a MimicObject from the current document state.
+*/
+const createMimicObject = (document) => {
+	const presence = document.presence ? {
+		selfId: document.presence.selfId(),
+		self: document.presence.self(),
+		others: new Map(document.presence.others()),
+		all: new Map(document.presence.all())
+	} : void 0;
+	return {
+		document,
+		snapshot: document.root.toSnapshot(),
+		presence,
+		isConnected: document.isConnected(),
+		isReady: document.isReady(),
+		pendingCount: document.getPendingCount(),
+		hasPendingChanges: document.hasPendingChanges()
+	};
+};
+/**
+* Implementation of the mimic middleware.
+*/
+const mimicImpl = (document, config, options = {}) => {
+	const { autoSubscribe = true, autoConnect = true } = options;
+	return (set, get, api) => {
+		const initialMimic = createMimicObject(document);
+		const updateMimicState = () => {
+			const newMimic = createMimicObject(document);
+			set((state) => require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, state), {}, { mimic: newMimic }), false);
+		};
+		if (autoSubscribe) {
+			var _document$presence;
+			document.subscribe({
+				onStateChange: () => {
+					updateMimicState();
+				},
+				onConnectionChange: () => {
+					updateMimicState();
+				},
+				onReady: () => {
+					updateMimicState();
+				}
+			});
+			(_document$presence = document.presence) === null || _document$presence === void 0 || _document$presence.subscribe({ onPresenceChange: () => {
+				updateMimicState();
+			} });
+		}
+		if (autoConnect) document.connect();
+		return require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, config(set, get, api)), {}, { mimic: initialMimic });
+	};
+};
+/**
+* Zustand middleware that integrates a ClientDocument.
+* 
+* Adds a `mimic` object to the store containing:
+* - `document`: The ClientDocument instance for performing transactions
+* - `snapshot`: Read-only snapshot of the document state (reactive)
+* - `presence`: Reactive presence snapshot (self + others). Undefined if presence is not enabled on the ClientDocument.
+* - `isConnected`: Connection status
+* - `isReady`: Ready status
+* - `pendingCount`: Number of pending transactions
+* - `hasPendingChanges`: Whether there are pending changes
+* 
+* @example
+* ```ts
+* import { create } from 'zustand'
+* import { mimic } from '@voidhash/mimic-react/zustand'
+* 
+* const useStore = create(
+*   mimic(clientDocument, (set, get) => ({
+*     // Your additional store state
+*   }))
+* )
+* 
+* // Read snapshot (reactive)
+* const snapshot = useStore(state => state.mimic.snapshot)
+* 
+* // Read presence (reactive, if enabled)
+* const myPresence = useStore(state => state.mimic.presence?.self)
+* const othersPresence = useStore(state => state.mimic.presence?.others)
+* 
+* // Write via document
+* store.getState().mimic.document.transaction(root => {
+*   root.name.set("New Name")
+* })
+* ```
+*/
+const mimic = mimicImpl;
+
+//#endregion
+exports.mimic = mimic;

package/dist/zustand/index.d.cts

@@ -0,0 +1,115 @@
+import { StateCreator, StoreMutatorIdentifier } from "zustand";
+import { ClientDocument } from "@voidhash/mimic/client";
+import { Presence, Primitive } from "@voidhash/mimic";
+
+//#region src/zustand/types.d.ts
+
+/**
+ * Presence data exposed on the zustand store (reactive snapshot).
+ */
+interface MimicPresence<TPresence extends Presence.AnyPresence> {
+  /**
+   * This client's connection ID (set after receiving presence snapshot).
+   * Undefined before the snapshot is received.
+   */
+  readonly selfId: string | undefined;
+  /**
+   * This client's current presence data.
+   * Undefined if not set.
+   */
+  readonly self: Presence.Infer<TPresence> | undefined;
+  /**
+   * Other clients' presence entries (connectionId -> entry).
+   */
+  readonly others: ReadonlyMap<string, Presence.PresenceEntry<Presence.Infer<TPresence>>>;
+  /**
+   * All presence entries including self (connectionId -> entry).
+   */
+  readonly all: ReadonlyMap<string, Presence.PresenceEntry<Presence.Infer<TPresence>>>;
+}
+/**
+ * The mimic object containing the document and client state.
+ * This is added to the zustand store by the middleware.
+ */
+interface MimicObject<TSchema extends Primitive.AnyPrimitive, TPresence extends Presence.AnyPresence | undefined = undefined> {
+  /** The ClientDocument instance for performing transactions */
+  readonly document: ClientDocument.ClientDocument<TSchema, TPresence>;
+  /** Read-only snapshot of the document state */
+  readonly snapshot: Primitive.InferSnapshot<TSchema>;
+  /**
+   * Reactive presence snapshot (self + others).
+   * Undefined when the ClientDocument was created without a presence schema.
+   */
+  readonly presence: TPresence extends Presence.AnyPresence ? MimicPresence<TPresence> : undefined;
+  /** Whether the client is connected to the server */
+  readonly isConnected: boolean;
+  /** Whether the client is fully initialized and ready */
+  readonly isReady: boolean;
+  /** Number of pending transactions */
+  readonly pendingCount: number;
+  /** Whether there are pending changes */
+  readonly hasPendingChanges: boolean;
+}
+/**
+ * The state slice added by the mimic middleware.
+ */
+interface MimicSlice<TSchema extends Primitive.AnyPrimitive, TPresence extends Presence.AnyPresence | undefined = undefined> {
+  /** The mimic object containing document and state */
+  readonly mimic: MimicObject<TSchema, TPresence>;
+}
+/**
+ * Type for state creator with mimic slice merged.
+ */
+type MimicStateCreator<TSchema extends Primitive.AnyPrimitive, TPresence extends Presence.AnyPresence | undefined, T, Mps extends [StoreMutatorIdentifier, unknown][] = [], Mcs extends [StoreMutatorIdentifier, unknown][] = []> = StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T>;
+/**
+ * Options for the mimic middleware.
+ */
+interface MimicMiddlewareOptions {
+  /** If true, automatically subscribe when store is created (default: true) */
+  readonly autoSubscribe?: boolean;
+  /** If true, automatically attempt to connect the document to the remote server */
+  readonly autoConnect?: boolean;
+}
+//#endregion
+//#region src/zustand/middleware.d.ts
+type MimicMiddleware = <TSchema extends Primitive.AnyPrimitive, TPresence extends Presence.AnyPresence | undefined = undefined, T extends object = object, Mps extends [StoreMutatorIdentifier, unknown][] = [], Mcs extends [StoreMutatorIdentifier, unknown][] = []>(document: ClientDocument.ClientDocument<TSchema, TPresence>, config: StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T>, options?: MimicMiddlewareOptions) => StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T & MimicSlice<TSchema, TPresence>>;
+/**
+ * Zustand middleware that integrates a ClientDocument.
+ *
+ * Adds a `mimic` object to the store containing:
+ * - `document`: The ClientDocument instance for performing transactions
+ * - `snapshot`: Read-only snapshot of the document state (reactive)
+ * - `presence`: Reactive presence snapshot (self + others). Undefined if presence is not enabled on the ClientDocument.
+ * - `isConnected`: Connection status
+ * - `isReady`: Ready status
+ * - `pendingCount`: Number of pending transactions
+ * - `hasPendingChanges`: Whether there are pending changes
+ *
+ * @example
+ * ```ts
+ * import { create } from 'zustand'
+ * import { mimic } from '@voidhash/mimic-react/zustand'
+ *
+ * const useStore = create(
+ *   mimic(clientDocument, (set, get) => ({
+ *     // Your additional store state
+ *   }))
+ * )
+ *
+ * // Read snapshot (reactive)
+ * const snapshot = useStore(state => state.mimic.snapshot)
+ *
+ * // Read presence (reactive, if enabled)
+ * const myPresence = useStore(state => state.mimic.presence?.self)
+ * const othersPresence = useStore(state => state.mimic.presence?.others)
+ *
+ * // Write via document
+ * store.getState().mimic.document.transaction(root => {
+ *   root.name.set("New Name")
+ * })
+ * ```
+ */
+declare const mimic: MimicMiddleware;
+//#endregion
+export { type MimicMiddlewareOptions, type MimicObject, type MimicSlice, type MimicStateCreator, mimic };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/zustand/types.ts","../../src/zustand/middleware.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;;;;;ACzDZ,KD+Ef,iBC/Ee,CAAA,gBDgFT,SAAA,CAAU,YChFD,EAAA,kBDiFP,QAAA,CAAS,WCjFF,GAAA,SAAA,EAAA,CAAA,EAAA,YAAA,CDmFZ,sBCnFY,EAAA,OAAA,CAAA,EAAA,GAAA,EAAA,EAAA,YAAA,CDoFZ,sBCpFY,EAAA,OAAA,CAAA,EAAA,GAAA,EAAA,CAAA,GDqFvB,YCrFuB,CDqFV,CCrFU,GDqFN,UCrFM,CDqFK,OCrFL,EDqFc,SCrFd,CAAA,EDqF0B,GCrF1B,EDqF+B,GCrF/B,EDqFoC,CCrFpC,CAAA;;;;AAAjB,UD0FO,sBAAA,CC1FP;EACE;EACM,SAAA,aAAA,CAAA,EAAA,OAAA;EAAe;EAAS,SAAA,WAAA,CAAA,EAAA,OAAA;;;;KAVrC,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;ADZxF;;;;;;;;;;;;;AAkCA;;;;;;;;;;;;;AA4BA;;;;;;;AA2BA;;;AAIe,cCkEF,KDlEE,ECkE8B,eDlE9B"}

package/dist/zustand/index.d.mts

@@ -0,0 +1,115 @@
+import { StateCreator, StoreMutatorIdentifier } from "zustand";
+import { ClientDocument } from "@voidhash/mimic/client";
+import { Presence, Primitive } from "@voidhash/mimic";
+
+//#region src/zustand/types.d.ts
+
+/**
+ * Presence data exposed on the zustand store (reactive snapshot).
+ */
+interface MimicPresence<TPresence extends Presence.AnyPresence> {
+  /**
+   * This client's connection ID (set after receiving presence snapshot).
+   * Undefined before the snapshot is received.
+   */
+  readonly selfId: string | undefined;
+  /**
+   * This client's current presence data.
+   * Undefined if not set.
+   */
+  readonly self: Presence.Infer<TPresence> | undefined;
+  /**
+   * Other clients' presence entries (connectionId -> entry).
+   */
+  readonly others: ReadonlyMap<string, Presence.PresenceEntry<Presence.Infer<TPresence>>>;
+  /**
+   * All presence entries including self (connectionId -> entry).
+   */
+  readonly all: ReadonlyMap<string, Presence.PresenceEntry<Presence.Infer<TPresence>>>;
+}
+/**
+ * The mimic object containing the document and client state.
+ * This is added to the zustand store by the middleware.
+ */
+interface MimicObject<TSchema extends Primitive.AnyPrimitive, TPresence extends Presence.AnyPresence | undefined = undefined> {
+  /** The ClientDocument instance for performing transactions */
+  readonly document: ClientDocument.ClientDocument<TSchema, TPresence>;
+  /** Read-only snapshot of the document state */
+  readonly snapshot: Primitive.InferSnapshot<TSchema>;
+  /**
+   * Reactive presence snapshot (self + others).
+   * Undefined when the ClientDocument was created without a presence schema.
+   */
+  readonly presence: TPresence extends Presence.AnyPresence ? MimicPresence<TPresence> : undefined;
+  /** Whether the client is connected to the server */
+  readonly isConnected: boolean;
+  /** Whether the client is fully initialized and ready */
+  readonly isReady: boolean;
+  /** Number of pending transactions */
+  readonly pendingCount: number;
+  /** Whether there are pending changes */
+  readonly hasPendingChanges: boolean;
+}
+/**
+ * The state slice added by the mimic middleware.
+ */
+interface MimicSlice<TSchema extends Primitive.AnyPrimitive, TPresence extends Presence.AnyPresence | undefined = undefined> {
+  /** The mimic object containing document and state */
+  readonly mimic: MimicObject<TSchema, TPresence>;
+}
+/**
+ * Type for state creator with mimic slice merged.
+ */
+type MimicStateCreator<TSchema extends Primitive.AnyPrimitive, TPresence extends Presence.AnyPresence | undefined, T, Mps extends [StoreMutatorIdentifier, unknown][] = [], Mcs extends [StoreMutatorIdentifier, unknown][] = []> = StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T>;
+/**
+ * Options for the mimic middleware.
+ */
+interface MimicMiddlewareOptions {
+  /** If true, automatically subscribe when store is created (default: true) */
+  readonly autoSubscribe?: boolean;
+  /** If true, automatically attempt to connect the document to the remote server */
+  readonly autoConnect?: boolean;
+}
+//#endregion
+//#region src/zustand/middleware.d.ts
+type MimicMiddleware = <TSchema extends Primitive.AnyPrimitive, TPresence extends Presence.AnyPresence | undefined = undefined, T extends object = object, Mps extends [StoreMutatorIdentifier, unknown][] = [], Mcs extends [StoreMutatorIdentifier, unknown][] = []>(document: ClientDocument.ClientDocument<TSchema, TPresence>, config: StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T>, options?: MimicMiddlewareOptions) => StateCreator<T & MimicSlice<TSchema, TPresence>, Mps, Mcs, T & MimicSlice<TSchema, TPresence>>;
+/**
+ * Zustand middleware that integrates a ClientDocument.
+ *
+ * Adds a `mimic` object to the store containing:
+ * - `document`: The ClientDocument instance for performing transactions
+ * - `snapshot`: Read-only snapshot of the document state (reactive)
+ * - `presence`: Reactive presence snapshot (self + others). Undefined if presence is not enabled on the ClientDocument.
+ * - `isConnected`: Connection status
+ * - `isReady`: Ready status
+ * - `pendingCount`: Number of pending transactions
+ * - `hasPendingChanges`: Whether there are pending changes
+ *
+ * @example
+ * ```ts
+ * import { create } from 'zustand'
+ * import { mimic } from '@voidhash/mimic-react/zustand'
+ *
+ * const useStore = create(
+ *   mimic(clientDocument, (set, get) => ({
+ *     // Your additional store state
+ *   }))
+ * )
+ *
+ * // Read snapshot (reactive)
+ * const snapshot = useStore(state => state.mimic.snapshot)
+ *
+ * // Read presence (reactive, if enabled)
+ * const myPresence = useStore(state => state.mimic.presence?.self)
+ * const othersPresence = useStore(state => state.mimic.presence?.others)
+ *
+ * // Write via document
+ * store.getState().mimic.document.transaction(root => {
+ *   root.name.set("New Name")
+ * })
+ * ```
+ */
+declare const mimic: MimicMiddleware;
+//#endregion
+export { type MimicMiddlewareOptions, type MimicObject, type MimicSlice, type MimicStateCreator, mimic };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/zustand/types.ts","../../src/zustand/middleware.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;;;;;ACzDZ,KD+Ef,iBC/Ee,CAAA,gBDgFT,SAAA,CAAU,YChFD,EAAA,kBDiFP,QAAA,CAAS,WCjFF,GAAA,SAAA,EAAA,CAAA,EAAA,YAAA,CDmFZ,sBCnFY,EAAA,OAAA,CAAA,EAAA,GAAA,EAAA,EAAA,YAAA,CDoFZ,sBCpFY,EAAA,OAAA,CAAA,EAAA,GAAA,EAAA,CAAA,GDqFvB,YCrFuB,CDqFV,CCrFU,GDqFN,UCrFM,CDqFK,OCrFL,EDqFc,SCrFd,CAAA,EDqF0B,GCrF1B,EDqF+B,GCrF/B,EDqFoC,CCrFpC,CAAA;;;;AAAjB,UD0FO,sBAAA,CC1FP;EACE;EACM,SAAA,aAAA,CAAA,EAAA,OAAA;EAAe;EAAS,SAAA,WAAA,CAAA,EAAA,OAAA;;;;KAVrC,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;ADZxF;;;;;;;;;;;;;AAkCA;;;;;;;;;;;;;AA4BA;;;;;;;AA2BA;;;AAIe,cCkEF,KDlEE,ECkE8B,eDlE9B"}

package/dist/zustand/index.mjs

@@ -0,0 +1,96 @@
+import { t as _objectSpread2 } from "../objectSpread2-CxTyNSYl.mjs";
+
+//#region src/zustand/middleware.ts
+/**
+* Creates a MimicObject from the current document state.
+*/
+const createMimicObject = (document) => {
+	const presence = document.presence ? {
+		selfId: document.presence.selfId(),
+		self: document.presence.self(),
+		others: new Map(document.presence.others()),
+		all: new Map(document.presence.all())
+	} : void 0;
+	return {
+		document,
+		snapshot: document.root.toSnapshot(),
+		presence,
+		isConnected: document.isConnected(),
+		isReady: document.isReady(),
+		pendingCount: document.getPendingCount(),
+		hasPendingChanges: document.hasPendingChanges()
+	};
+};
+/**
+* Implementation of the mimic middleware.
+*/
+const mimicImpl = (document, config, options = {}) => {
+	const { autoSubscribe = true, autoConnect = true } = options;
+	return (set, get, api) => {
+		const initialMimic = createMimicObject(document);
+		const updateMimicState = () => {
+			const newMimic = createMimicObject(document);
+			set((state) => _objectSpread2(_objectSpread2({}, state), {}, { mimic: newMimic }), false);
+		};
+		if (autoSubscribe) {
+			var _document$presence;
+			document.subscribe({
+				onStateChange: () => {
+					updateMimicState();
+				},
+				onConnectionChange: () => {
+					updateMimicState();
+				},
+				onReady: () => {
+					updateMimicState();
+				}
+			});
+			(_document$presence = document.presence) === null || _document$presence === void 0 || _document$presence.subscribe({ onPresenceChange: () => {
+				updateMimicState();
+			} });
+		}
+		if (autoConnect) document.connect();
+		return _objectSpread2(_objectSpread2({}, config(set, get, api)), {}, { mimic: initialMimic });
+	};
+};
+/**
+* Zustand middleware that integrates a ClientDocument.
+* 
+* Adds a `mimic` object to the store containing:
+* - `document`: The ClientDocument instance for performing transactions
+* - `snapshot`: Read-only snapshot of the document state (reactive)
+* - `presence`: Reactive presence snapshot (self + others). Undefined if presence is not enabled on the ClientDocument.
+* - `isConnected`: Connection status
+* - `isReady`: Ready status
+* - `pendingCount`: Number of pending transactions
+* - `hasPendingChanges`: Whether there are pending changes
+* 
+* @example
+* ```ts
+* import { create } from 'zustand'
+* import { mimic } from '@voidhash/mimic-react/zustand'
+* 
+* const useStore = create(
+*   mimic(clientDocument, (set, get) => ({
+*     // Your additional store state
+*   }))
+* )
+* 
+* // Read snapshot (reactive)
+* const snapshot = useStore(state => state.mimic.snapshot)
+* 
+* // Read presence (reactive, if enabled)
+* const myPresence = useStore(state => state.mimic.presence?.self)
+* const othersPresence = useStore(state => state.mimic.presence?.others)
+* 
+* // Write via document
+* store.getState().mimic.document.transaction(root => {
+*   root.name.set("New Name")
+* })
+* ```
+*/
+const mimic = mimicImpl;
+
+//#endregion
+export { mimic };
+//# sourceMappingURL=index.mjs.map

package/dist/zustand/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.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.js\";\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"}