@buoy-gg/zustand 7.0.33 → 7.0.34

package/lib/typescript/zustand/sync/zustandSyncAdapter.d.ts

@@ -6,17 +6,18 @@ import type { ZustandStateChange } from "../types";
  */
 export declare const STATE_ON_DEVICE: Readonly<{
     __buoyStateOnDevice: true;
-    note: "State trees stay on the device — fetched on demand via getChangeDetail / getStoreState.";
+} & {
+    note: string;
 }>;
 /** Wire-form sentinel for an oversized `partial` (replace can carry a whole tree). */
 export declare const PAYLOAD_ON_DEVICE: Readonly<{
     __buoyPayloadOnDevice: true;
-    note: "Partial stays on the device — fetched on demand via getChangeDetail.";
+} & {
+    note: string;
 }>;
 /**
  * Sync adapter for the zustand tool, consumed by @buoy-gg/external-sync's
- * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
- * this package doesn't need a dependency on it).
+ * `useExternalSync`.
  *
  * State changes are captured by the middleware (watchStores/buoyDevTools),
  * independent of whether a dashboard is watching — subscribing here only
@@ -31,123 +32,108 @@ export declare const PAYLOAD_ON_DEVICE: Readonly<{
  *
  * The `setState` action powers remote time-travel/reset from the dashboard.
  */
-export declare const zustandSyncAdapter: {
-    version: number;
-    getSnapshot: () => {
-        changes: ZustandStateChange[];
-        stores: {
+export declare const zustandSyncAdapter: import("@buoy-gg/shared-ui").SyncAdapter<{
+    changes: ZustandStateChange[];
+    stores: {
+        currentState: unknown;
+        name: string;
+        stateChangeCount: number;
+        isPersisted: boolean;
+        persistName?: string;
+        canRehydrate?: boolean;
+        color: string;
+    }[];
+}, {
+    clearEvents: () => void;
+    /**
+     * On-demand detail: one change's real prevState/nextState/partial.
+     * The per-snapshot stream stays tree-free; this is the explicit,
+     * size-guarded channel for the detail pane.
+     */
+    getChangeDetail: (params?: unknown) => import("@buoy-gg/shared-ui").DetailResult<{
+        prevState: unknown;
+        nextState: unknown;
+        partial: unknown;
+    }>;
+    /**
+     * On-demand current state for one store. Wire-form snapshots replace
+     * oversized / unserializable `currentState` with STATE_ON_DEVICE.
+     */
+    getStoreState: (params?: unknown) => {
+        found: false;
+        reason: string;
+        storeName?: undefined;
+        currentState?: undefined;
+    } | {
+        found: true;
+        storeName: string;
+        currentState: unknown;
+        reason?: undefined;
+    };
+    /**
+     * Compact current-state reader for a remote driver (MCP/LLM): the registered
+     * stores with light metadata; each store's full `currentState` object stays
+     * on the device unless `includeValues` is set (compact view returns just the
+     * top-level `keys` so the shape is visible cheaply).
+     */
+    listStores: (params?: unknown) => {
+        stores: ({
             currentState: unknown;
             name: string;
-            stateChangeCount: number;
+            changes: number;
             isPersisted: boolean;
-            persistName?: string;
-            canRehydrate?: boolean;
-            color: string;
-        }[];
-    };
-    subscribe: (onChange: () => void) => () => void;
-    actions: {
-        clearEvents: () => void;
-        /**
-         * On-demand detail: one change's real prevState/nextState/partial.
-         * The per-snapshot stream stays tree-free; this is the explicit,
-         * size-guarded channel for the detail pane.
-         */
-        getChangeDetail: (params?: unknown) => {
-            found: false;
-            reason: string;
-            id?: undefined;
-            prevState?: undefined;
-            nextState?: undefined;
-            partial?: undefined;
-        } | {
-            found: true;
-            id: string;
-            prevState: unknown;
-            nextState: unknown;
-            partial: unknown;
-            reason?: undefined;
-        };
-        /**
-         * On-demand current state for one store. Wire-form snapshots replace
-         * oversized / unserializable `currentState` with STATE_ON_DEVICE.
-         */
-        getStoreState: (params?: unknown) => {
-            found: false;
-            reason: string;
-            storeName?: undefined;
-            currentState?: undefined;
-        } | {
-            found: true;
-            storeName: string;
-            currentState: unknown;
-            reason?: undefined;
-        };
-        /**
-         * Compact current-state reader for a remote driver (MCP/LLM): the registered
-         * stores with light metadata; each store's full `currentState` object stays
-         * on the device unless `includeValues` is set (compact view returns just the
-         * top-level `keys` so the shape is visible cheaply).
-         */
-        listStores: (params?: unknown) => {
-            stores: ({
-                currentState: unknown;
-                name: string;
-                changes: number;
-                isPersisted: boolean;
-                persistName: string | undefined;
-                canRehydrate: boolean | undefined;
-            } | {
-                keys: string[] | undefined;
-                name: string;
-                changes: number;
-                isPersisted: boolean;
-                persistName: string | undefined;
-                canRehydrate: boolean | undefined;
-            })[];
-            total: number;
-            returned: number;
-            includedValues: boolean;
-        };
-        setState: (params?: unknown) => {
-            ok: boolean;
-            error: string;
-        } | {
-            ok: boolean;
-            error?: undefined;
-        };
-        /**
-         * Re-read a persisted store's saved value and merge it into the live store.
-         *
-         * This is what makes editing a store's storage key mean anything. The app
-         * reads that key once at startup and then holds the state in memory, so an
-         * outside write — the Storage tool, a scenario, an agent — changes the disk
-         * and nothing else, and the next time the store saves it writes its own
-         * copy straight back over the edit.
-         *
-         * `persist.rehydrate()` is plain zustand, not a devtools hook, so unlike
-         * reloading the app this also works in a release build. It merges the saved
-         * value OVER current state (zustand's default merge is
-         * `{...current, ...persisted}`), so the store's action functions survive,
-         * and it does not write back to storage unless a version migration ran —
-         * the edit stays exactly as it was typed.
-         *
-         * Two honest limits, both inherent to persist rather than to this action:
-         * a key the store's `partialize` excludes is not in the saved value and so
-         * cannot be applied, and because the merge is shallow, DELETING a top-level
-         * key from the saved JSON does not remove it from the live store.
-         */
-        rehydrate: (params?: unknown) => Promise<{
-            ok: boolean;
-            error: string;
-            storeName?: undefined;
-            persistName?: undefined;
+            persistName: string | undefined;
+            canRehydrate: boolean | undefined;
         } | {
-            ok: boolean;
-            storeName: string;
+            keys: string[] | undefined;
+            name: string;
+            changes: number;
+            isPersisted: boolean;
             persistName: string | undefined;
-            error?: undefined;
-        }>;
+            canRehydrate: boolean | undefined;
+        })[];
+        total: number;
+        returned: number;
+        includedValues: boolean;
     };
-};
+    setState: (params?: unknown) => {
+        ok: boolean;
+        error: string;
+    } | {
+        ok: boolean;
+        error?: undefined;
+    };
+    /**
+     * Re-read a persisted store's saved value and merge it into the live store.
+     *
+     * This is what makes editing a store's storage key mean anything. The app
+     * reads that key once at startup and then holds the state in memory, so an
+     * outside write — the Storage tool, a scenario, an agent — changes the disk
+     * and nothing else, and the next time the store saves it writes its own
+     * copy straight back over the edit.
+     *
+     * `persist.rehydrate()` is plain zustand, not a devtools hook, so unlike
+     * reloading the app this also works in a release build. It merges the saved
+     * value OVER current state (zustand's default merge is
+     * `{...current, ...persisted}`), so the store's action functions survive,
+     * and it does not write back to storage unless a version migration ran —
+     * the edit stays exactly as it was typed.
+     *
+     * Two honest limits, both inherent to persist rather than to this action:
+     * a key the store's `partialize` excludes is not in the saved value and so
+     * cannot be applied, and because the merge is shallow, DELETING a top-level
+     * key from the saved JSON does not remove it from the live store.
+     */
+    rehydrate: (params?: unknown) => Promise<{
+        ok: boolean;
+        error: string;
+        storeName?: undefined;
+        persistName?: undefined;
+    } | {
+        ok: boolean;
+        storeName: string;
+        persistName: string | undefined;
+        error?: undefined;
+    }>;
+}>;
 //# sourceMappingURL=zustandSyncAdapter.d.ts.map

package/lib/typescript/zustand/sync/zustandSyncAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zustandSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/zustand/sync/zustandSyncAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;EAG1B,CAAC;AAEH,sFAAsF;AACtF,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC;AA2DH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;0BASP,MAAM,IAAI;;;QAY9B;;;;WAIG;mCACwB,OAAO;;;;;;;;;;;;;;;QAmBlC;;;WAGG;iCACsB,OAAO;;;;;;;;;;;QA2BhC;;;;;WAKG;8BACmB,OAAO;;;;;;;;;;;;;;;;;;;;4BAuBT,OAAO;;;;;;;QAQ3B;;;;;;;;;;;;;;;;;;;;WAoBG;6BACwB,OAAO;;;;;;;;;;;;CAqBrC,CAAC"}
+{"version":3,"file":"zustandSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/zustand/sync/zustandSyncAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAenD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;EAG3B,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,iBAAiB;;;;EAG7B,CAAC;AAsCF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;IAiB3B;;;;OAIG;;;;;;IASH;;;OAGG;6BACsB,OAAO;;;;;;;;;;;IAsBhC;;;;;OAKG;0BACmB,OAAO;;;;;;;;;;;;;;;;;;;;wBAsBT,OAAO;;;;;;;IAQ3B;;;;;;;;;;;;;;;;;;;;OAoBG;yBACwB,OAAO;;;;;;;;;;;EAqBV,CAAC"}

package/lib/typescript/zustand/utils/zustandStateStore.d.ts

@@ -1,19 +1,16 @@
 /**
  * Zustand state store - captures and stores Zustand state changes
  *
- * Mirrors the architecture of reduxActionStore.ts from @buoy-gg/redux
+ * The generic event-log half (ring buffer, listeners, clear-forwarding for
+ * the desktop mirror, pause/suppress flags, hydrate-by-id) is the shared
+ * `ChangeLog`; this file owns the zustand-specific half — the store registry,
+ * snapshots, mirror rebuild, filters and stats.
  */
+import { ChangeLog } from "@buoy-gg/shared-ui";
 import type { ZustandStateChange, ZustandStoreInfo, ZustandStoreSnapshot, ZustandFilter, StateChangeCategory } from "../types";
-declare class ZustandStateStore {
-    private stateChanges;
+declare class ZustandStateStore extends ChangeLog<ZustandStateChange> {
     private stores;
-    private listeners;
     private storeListeners;
-    private clearListeners;
-    private maxChanges;
-    private idCounter;
-    private isEnabled;
-    private captureSuppressed;
     private remoteSetStateHandler;
     addStateChange(params: {
         storeName: string;
@@ -28,11 +25,6 @@ declare class ZustandStateStore {
     getStateChanges(): ZustandStateChange[];
     getStateChangeById(id: string): ZustandStateChange | undefined;
     clearStateChanges(): void;
-    /**
-     * Listen for clearStateChanges() calls. Used in remote mirror mode to
-     * forward a clear performed in the dashboard UI to the synced device.
-     */
-    onClear(listener: () => void): () => void;
     /**
      * Replace the change log without touching the store registry. Used when a
      * host keeps real registered stores (JUMP / RESET stay wired) but needs to
@@ -41,14 +33,6 @@ declare class ZustandStateStore {
      * flag so the UI's pause button freezes the reseed.
      */
     replaceStateChanges(changes: ZustandStateChange[]): void;
-    /**
-     * Permanently suppress local capture. Use when this store acts as a mirror
-     * of a remote device's state changes (e.g. the desktop dashboard): data
-     * arrives via replaceFromSnapshot() and local middleware must never record.
-     */
-    disableCapture(): void;
-    /** Whether the store is in remote mirror mode (capture suppressed). */
-    isCaptureSuppressed(): boolean;
     /**
      * Serializable snapshot of the tracked stores (registry metadata plus each
      * store's current state). Used by the sync adapter on the device side —
@@ -95,12 +79,8 @@ declare class ZustandStateStore {
         averageDuration: number;
     };
     getUniqueStoreNames(): string[];
-    setEnabled(enabled: boolean): void;
-    getEnabled(): boolean;
     setMaxChanges(max: number): void;
-    subscribe(listener: (changes: ZustandStateChange[]) => void): () => void;
     subscribeToStores(listener: (stores: ZustandStoreInfo[]) => void): () => void;
-    private notifyListeners;
     private notifyStoreListeners;
 }
 export declare const zustandStateStore: ZustandStateStore;

package/lib/typescript/zustand/utils/zustandStateStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zustandStateStore.d.ts","sourceRoot":"","sources":["../../../../src/zustand/utils/zustandStateStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"zustandStateStore.d.ts","sourceRoot":"","sources":["../../../../src/zustand/utils/zustandStateStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EAIV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAyClB,cAAM,iBAAkB,SAAQ,SAAS,CAAC,kBAAkB,CAAC;IAC3D,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,cAAc,CACV;IACZ,OAAO,CAAC,qBAAqB,CAEb;IAIhB,cAAc,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;QAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,IAAI;IA2DR,eAAe,IAAI,kBAAkB,EAAE;IAIvC,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI9D,iBAAiB,IAAI,IAAI;IAUzB;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAgBxD;;;;OAIG;IACH,iBAAiB,IAAI,oBAAoB,EAAE;IAwB3C;;;OAGG;IACH,wBAAwB,CACtB,OAAO,EACH,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC,GAClE,IAAI,GACP,IAAI;IAIP;;;;;OAKG;IACH,mBAAmB,CACjB,OAAO,EAAE,kBAAkB,EAAE,EAC7B,cAAc,EAAE,oBAAoB,EAAE,GACrC,IAAI;IA0EP;;;OAGG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAInE;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI;IAejE,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAC5B,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KACxC,GACA,IAAI;IAiBP,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKnC,SAAS,IAAI,gBAAgB,EAAE;IAI/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMnC,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,EAAE;IA4B/D,QAAQ;;;;;;;IAsBR,mBAAmB,IAAI,MAAM,EAAE;IAM/B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMhC,iBAAiB,CACf,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,IAAI,GAC7C,MAAM,IAAI;IAOb,OAAO,CAAC,oBAAoB;CAI7B;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/zustand",
-  "version": "7.0.33",
+  "version": "7.0.34",
   "description": "Zustand devtools inside your React Native app — state diffs, jump-to-state & one-tap store reset, no middleware. Part of Buoy devtools.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -29,8 +29,8 @@
     "**/snapshotProvider.ts"
   ],
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.33",
-    "@buoy-gg/license": "^7.0.33"
+    "@buoy-gg/license": "^7.0.34",
+    "@buoy-gg/shared-ui": "^7.0.34"
   },
   "peerDependencies": {
     "react": "*",