@buoy-gg/zustand 7.0.17 → 7.0.19

package/lib/module/zustand/components/ZustandStoreBrowser.js

@@ -22,6 +22,9 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 function getKeysPreview(store) {
   try {
     const state = store.api.getState();
+    if (state && typeof state === "object" && state.__buoyStateOnDevice === true) {
+      return "on device";
+    }
     if (state && typeof state === "object") {
       const keys = Object.keys(state);
       const dataKeys = keys.filter(k => {
@@ -142,7 +145,8 @@ export function ZustandStoreBrowser({
   stores,
   searchQuery,
   onViewHistory,
-  isLoading = false
+  isLoading = false,
+  onStoreExpand
 }) {
   const [expandedStore, setExpandedStore] = useState(null);
 
@@ -153,8 +157,12 @@ export function ZustandStoreBrowser({
     return stores.filter(s => s.name.toLowerCase().includes(search) || s.persistName && s.persistName.toLowerCase().includes(search));
   }, [stores, searchQuery]);
   const handleStorePress = useCallback(store => {
-    setExpandedStore(prev => prev === store.name ? null : store.name);
-  }, []);
+    setExpandedStore(prev => {
+      const next = prev === store.name ? null : store.name;
+      if (next) onStoreExpand?.(store.name);
+      return next;
+    });
+  }, [onStoreExpand]);
   if (filteredStores.length === 0 && !searchQuery) {
     return isLoading ? /*#__PURE__*/_jsx(LoadingBrowserState, {}) : /*#__PURE__*/_jsx(EmptyBrowserState, {});
   }

package/lib/module/zustand/sync/zustandSyncAdapter.js

@@ -1,11 +1,56 @@
 "use strict";
 
 import { zustandStateStore } from "../utils/zustandStateStore";
+import { isJsonSerializable, isOverWireBudget } from "@buoy-gg/shared-ui";
+
+/**
+ * Sentinel used in WIRE-FORM snapshots in place of raw prevState/nextState.
+ * Same hazard as redux: up to 200 changes × 2 full trees on every snapshot
+ * freeze/OOM-killed large apps. Dashboards fetch trees via `getChangeDetail`.
+ */
+export const STATE_ON_DEVICE = Object.freeze({
+  __buoyStateOnDevice: true,
+  note: "State trees stay on the device — fetched on demand via getChangeDetail / getStoreState."
+});
+
+/** Wire-form sentinel for an oversized `partial` (replace can carry a whole tree). */
+export const PAYLOAD_ON_DEVICE = Object.freeze({
+  __buoyPayloadOnDevice: true,
+  note: "Partial stays on the device — fetched on demand via getChangeDetail."
+});
+const MAX_CHANGE_DETAIL_BYTES = 8 * 1024 * 1024;
+const MAX_WIRE_PAYLOAD_BYTES = 16 * 1024;
 /** Top-level keys of an object state, for the compact (no-values) view. */
 function topLevelKeys(state) {
   return state && typeof state === "object" && !Array.isArray(state) ? Object.keys(state) : undefined;
 }
 
+/**
+ * Per-change wire cache. The store prepends and never mutates a recorded
+ * change, so keying on identity is correct and self-invalidating — without it
+ * every `partial` in the list is re-measured on all ~5 snapshots per second.
+ */
+const changeCache = new WeakMap();
+function toWireChange(change) {
+  const cached = changeCache.get(change);
+  if (cached) return cached;
+  const wire = {
+    ...change,
+    prevState: STATE_ON_DEVICE,
+    nextState: STATE_ON_DEVICE,
+    partial: toWirePartial(change.partial)
+  };
+  changeCache.set(change, wire);
+  return wire;
+}
+function toWirePartial(value) {
+  if (value === undefined) return value;
+  return isOverWireBudget(value, MAX_WIRE_PAYLOAD_BYTES) ? PAYLOAD_ON_DEVICE : value;
+}
+function toWireState(value) {
+  return isOverWireBudget(value, MAX_WIRE_PAYLOAD_BYTES) ? STATE_ON_DEVICE : value;
+}
+
 /**
  * Sync adapter for the zustand tool, consumed by @buoy-gg/external-sync's
  * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
@@ -17,13 +62,21 @@ function topLevelKeys(state) {
  * change timeline and the store registry (with each store's current state)
  * so the dashboard can render the store browser.
  *
+ * v2: change-log prevState/nextState are replaced with on-device markers
+ * (see STATE_ON_DEVICE). Dashboards fetch trees via `getChangeDetail`.
+ * Oversized / unserializable `stores[].currentState` uses the same marker
+ * and is fetched via `getStoreState`.
+ *
  * The `setState` action powers remote time-travel/reset from the dashboard.
  */
 export const zustandSyncAdapter = {
-  version: 1,
+  version: 2,
   getSnapshot: () => ({
-    changes: zustandStateStore.getStateChanges(),
-    stores: zustandStateStore.getStoreSnapshots()
+    changes: zustandStateStore.getStateChanges().map(toWireChange),
+    stores: zustandStateStore.getStoreSnapshots().map(store => ({
+      ...store,
+      currentState: toWireState(store.currentState)
+    }))
   }),
   subscribe: onChange => {
     const unsubscribeChanges = zustandStateStore.subscribe(onChange);
@@ -37,6 +90,77 @@ export const zustandSyncAdapter = {
     clearEvents: () => {
       zustandStateStore.clearStateChanges();
     },
+    /**
+     * 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 => {
+      const {
+        id
+      } = params ?? {};
+      if (!id) return {
+        found: false,
+        reason: "missing id"
+      };
+      const change = zustandStateStore.getStateChangeById(id);
+      if (!change) return {
+        found: false,
+        reason: "unknown id"
+      };
+      const cappedNote = {
+        __buoyTruncated: true,
+        note: `Exceeds the ${MAX_CHANGE_DETAIL_BYTES / (1024 * 1024)}MB detail limit — inspect it on-device.`
+      };
+      const cap = value => isOverWireBudget(value, MAX_CHANGE_DETAIL_BYTES) ? cappedNote : value;
+      return {
+        found: true,
+        id,
+        prevState: cap(change.prevState),
+        nextState: cap(change.nextState),
+        partial: cap(change.partial)
+      };
+    },
+    /**
+     * On-demand current state for one store. Wire-form snapshots replace
+     * oversized / unserializable `currentState` with STATE_ON_DEVICE.
+     */
+    getStoreState: params => {
+      const {
+        storeName
+      } = params ?? {};
+      if (!storeName) return {
+        found: false,
+        reason: "missing storeName"
+      };
+      const store = zustandStateStore.getStore(storeName);
+      if (!store) return {
+        found: false,
+        reason: "unknown storeName"
+      };
+      let currentState;
+      try {
+        currentState = store.api.getState();
+      } catch {
+        currentState = undefined;
+      }
+      const cappedNote = {
+        __buoyTruncated: true,
+        note: `Exceeds the ${MAX_CHANGE_DETAIL_BYTES / (1024 * 1024)}MB detail limit — inspect it on-device.`
+      };
+      if (!isOverWireBudget(currentState, MAX_CHANGE_DETAIL_BYTES)) {
+        return {
+          found: true,
+          storeName,
+          currentState
+        };
+      }
+      return {
+        found: true,
+        storeName,
+        currentState: isJsonSerializable(currentState) ? cappedNote : STATE_ON_DEVICE
+      };
+    },
     /**
      * Compact current-state reader for a remote driver (MCP/LLM): the registered
      * stores with light metadata; each store's full `currentState` object stays
@@ -73,8 +197,20 @@ export const zustandSyncAdapter = {
         storeName,
         state,
         replace
-      } = params;
-      zustandStateStore.getStore(storeName)?.api.setState(state, replace ?? true);
+      } = params ?? {};
+      if (!storeName) return {
+        ok: false,
+        error: "Missing storeName."
+      };
+      const store = zustandStateStore.getStore(storeName);
+      if (!store) return {
+        ok: false,
+        error: `No store named "${storeName}".`
+      };
+      store.api.setState(state, replace ?? true);
+      return {
+        ok: true
+      };
     }
   }
 };

package/lib/module/zustand/utils/snapshotProvider.js

@@ -14,6 +14,7 @@
  * LIVE store's functions onto the snapshot before replacing.
  */
 import { registerStateSnapshotProvider } from "@buoy-gg/shared-ui";
+import { boundedDeepEqual, jsonLikelyLargerThan } from "@buoy-gg/shared-ui/dataViewer";
 import { zustandStateStore } from "./zustandStateStore";
 const MAX_DEPTH = 8;
 function isPlainObjectLike(v) {
@@ -116,8 +117,12 @@ async function capture() {
     warnings
   };
 }
-async function restore(data) {
+async function restore(data, options) {
   const snapshot = data;
+  const excludedSet = new Set(options?.excludeKeys ?? []);
+  const includedSet = options?.includeKeys ? new Set(options.includeKeys) : null;
+  const touch = key => !excludedSet.has(key) && (!includedSet || includedSet.has(key));
+  let excludedHits = 0;
   const result = {
     ok: true,
     applied: 0,
@@ -133,6 +138,10 @@ async function restore(data) {
     };
   }
   for (const [name, envelope] of Object.entries(snapshot.stores)) {
+    if (!touch(name)) {
+      excludedHits += 1;
+      continue;
+    }
     const info = zustandStateStore.getStore(name);
     if (!info) {
       result.skipped.push({
@@ -159,12 +168,111 @@ async function restore(data) {
       result.ok = false;
     }
   }
+  if (excludedHits > 0) {
+    result.warnings.push(`${excludedHits} store(s) excluded by you`);
+  }
   return result;
 }
+const ITEM_RENDER_BYTE_LIMIT = 256 * 1024;
+
+/**
+ * Per-store restore preview. Both sides are function-stripped through the
+ * SAME depth-8 normalizer as capture — diffing snapshot-vs-RAW-live would
+ * report every stripped function and every beyond-depth subtree as removed.
+ */
+async function previewItems(target, base) {
+  const targetStores = target?.stores ?? {};
+  const liveMode = base === undefined;
+  const baseStores = {};
+  if (liveMode) {
+    for (const info of zustandStateStore.getStores()) {
+      const fnPaths = [];
+      try {
+        baseStores[info.name] = {
+          state: stripFunctions(info.api.getState(), "", fnPaths, new WeakSet(), 0),
+          fnPaths
+        };
+      } catch {
+        // unreadable live store — treated as absent
+      }
+    }
+  } else {
+    Object.assign(baseStores, base?.stores ?? {});
+  }
+  const items = [];
+  const notes = [];
+  let preservedFns = 0;
+  const names = new Set([...Object.keys(baseStores), ...Object.keys(targetStores)]);
+  for (const name of names) {
+    const inTarget = name in targetStores;
+    const inBase = name in baseStores;
+    if (!inTarget) {
+      // Restore never touches stores the snapshot doesn't know about.
+      if (liveMode) notes.push(`store "${name}" not in snapshot — untouched`);else items.push({
+        key: name,
+        label: name,
+        verdict: "removed",
+        oldValue: baseStores[name].state
+      });
+      continue;
+    }
+    preservedFns += targetStores[name].fnPaths?.length ?? 0;
+    if (liveMode && !zustandStateStore.getStore(name)) {
+      items.push({
+        key: name,
+        label: name,
+        verdict: "wont-apply",
+        reason: "store not registered (renamed, or created after snapshot?)"
+      });
+      continue;
+    }
+    if (!inBase) {
+      items.push({
+        key: name,
+        label: name,
+        verdict: "added",
+        newValue: targetStores[name].state
+      });
+      continue;
+    }
+    const oldState = baseStores[name].state;
+    const newState = targetStores[name].state;
+    if (boundedDeepEqual(oldState, newState)) {
+      items.push({
+        key: name,
+        label: name,
+        verdict: "unchanged"
+      });
+    } else if (jsonLikelyLargerThan(oldState, ITEM_RENDER_BYTE_LIMIT) || jsonLikelyLargerThan(newState, ITEM_RENDER_BYTE_LIMIT)) {
+      items.push({
+        key: name,
+        label: name,
+        verdict: "too-large",
+        reason: "store too large to render a diff — restore still applies it"
+      });
+    } else {
+      items.push({
+        key: name,
+        label: name,
+        verdict: "changed",
+        oldValue: oldState,
+        newValue: newState
+      });
+    }
+  }
+  if (preservedFns > 0) {
+    notes.push(`${preservedFns} store action function${preservedFns === 1 ? "" : "s"} preserved on restore (not diffed)`);
+  }
+  return {
+    items,
+    notes
+  };
+}
 registerStateSnapshotProvider({
   id: "zustand",
   label: "Zustand",
   status,
   capture,
-  restore
+  restore,
+  previewItems
 });

package/lib/module/zustand/utils/zustandStateStore.js

@@ -272,6 +272,27 @@ class ZustandStateStore {
 
   // ---- Remote Mirror Mode ----
 
+  /**
+   * Replace the change log without touching the store registry. Used when a
+   * host keeps real registered stores (JUMP / RESET stay wired) but needs to
+   * reseed the event list — the docs live tour, or any mirror that already
+   * called `registerStore`. Does not fire `onClear`. Respects the enabled
+   * flag so the UI's pause button freezes the reseed.
+   */
+  replaceStateChanges(changes) {
+    if (!this.isEnabled) return;
+    this.stateChanges = changes.slice(0, this.maxChanges);
+    for (const store of this.stores.values()) {
+      store.stateChangeCount = 0;
+    }
+    for (const change of this.stateChanges) {
+      const store = this.stores.get(change.storeName);
+      if (store) store.stateChangeCount++;
+    }
+    this.notifyListeners();
+    this.notifyStoreListeners();
+  }
+
   /**
    * 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
@@ -326,22 +347,92 @@ class ZustandStateStore {
    */
   replaceFromSnapshot(changes, storeSnapshots) {
     if (!this.isEnabled) return;
-    this.stateChanges = changes.slice(0, this.maxChanges);
-    this.stores = new Map(storeSnapshots.map(snapshot => [snapshot.name, {
-      name: snapshot.name,
-      api: {
-        getState: () => snapshot.currentState,
-        setState: (partial, replace) => {
-          this.remoteSetStateHandler?.(snapshot.name, partial, replace);
+
+    // Preserve trees a remote mirror already hydrated — wire-form snapshots
+    // always carry markers, and a later snapshot must not blank the detail pane.
+    const hydrated = new Map();
+    for (const existing of this.stateChanges) {
+      const prev = existing.prevState;
+      if (!prev || prev.__buoyStateOnDevice !== true) {
+        hydrated.set(existing.id, existing);
+      }
+    }
+    this.stateChanges = changes.slice(0, this.maxChanges).map(change => {
+      const kept = hydrated.get(change.id);
+      const incoming = change.prevState;
+      return kept && incoming?.__buoyStateOnDevice === true ? {
+        ...change,
+        prevState: kept.prevState,
+        nextState: kept.nextState,
+        partial: kept.partial
+      } : change;
+    });
+
+    // Preserve currentState a remote mirror already hydrated — oversized
+    // stores arrive as STATE_ON_DEVICE markers on every snapshot.
+    const hydratedStores = new Map();
+    for (const [name, store] of this.stores) {
+      try {
+        const state = store.api.getState();
+        const marker = state;
+        if (!marker || marker.__buoyStateOnDevice !== true) {
+          hydratedStores.set(name, state);
+        }
+      } catch {
+        // ignore
+      }
+    }
+    this.stores = new Map(storeSnapshots.map(snapshot => {
+      const incoming = snapshot.currentState;
+      const kept = hydratedStores.get(snapshot.name);
+      const currentState = kept !== undefined && incoming?.__buoyStateOnDevice === true ? kept : snapshot.currentState;
+      return [snapshot.name, {
+        name: snapshot.name,
+        api: {
+          getState: () => currentState,
+          setState: (partial, replace) => {
+            this.remoteSetStateHandler?.(snapshot.name, partial, replace);
+          },
+          subscribe: () => () => {}
         },
-        subscribe: () => () => {}
-      },
-      stateChangeCount: snapshot.stateChangeCount,
-      isPersisted: snapshot.isPersisted,
-      persistName: snapshot.persistName,
-      color: snapshot.color
-    }]));
+        stateChangeCount: snapshot.stateChangeCount,
+        isPersisted: snapshot.isPersisted,
+        persistName: snapshot.persistName,
+        color: snapshot.color
+      }];
+    }));
+    this.notifyListeners();
+    this.notifyStoreListeners();
+  }
+
+  /**
+   * Hydrate one mirrored change with real trees fetched on demand from the
+   * device via the adapter's `getChangeDetail`. Remote-mirror (desktop) only.
+   */
+  hydrateChange(id, patch) {
+    const index = this.stateChanges.findIndex(c => c.id === id);
+    if (index === -1) return;
+    this.stateChanges = [...this.stateChanges.slice(0, index), {
+      ...this.stateChanges[index],
+      ...patch
+    }, ...this.stateChanges.slice(index + 1)];
     this.notifyListeners();
+  }
+
+  /**
+   * Hydrate one mirrored store's currentState fetched on demand from the
+   * device via the adapter's `getStoreState`. Remote-mirror (desktop) only.
+   */
+  hydrateStoreState(storeName, currentState) {
+    const store = this.stores.get(storeName);
+    if (!store) return;
+    this.stores.set(storeName, {
+      ...store,
+      api: {
+        ...store.api,
+        getState: () => currentState
+      }
+    });
     this.notifyStoreListeners();
   }
 

package/lib/typescript/zustand/components/ZustandModal.d.ts

@@ -6,7 +6,7 @@
  * - Events tab: Live state change monitoring with diffs
  */
 import type { ZustandModalProps } from "../types";
-export declare function ZustandModal({ visible, onClose, onBack, onMinimize, enableSharedModalDimensions, inline, storesLoading, }: ZustandModalProps): import("react").JSX.Element | null;
+export declare function ZustandModal({ visible, onClose, onBack, onMinimize, enableSharedModalDimensions, inline, storesLoading, initialTab, initialSelectedChangeId, initialDetailView, onChangeSelect, onStoreExpand, }: ZustandModalProps): import("react").JSX.Element | null;
 /**
  * The same Zustand tool as `ZustandModal`, rendered INLINE for hosts that
  * place tools in a panel rather than a modal. Exists so there is exactly one

package/lib/typescript/zustand/components/ZustandModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZustandModal.d.ts","sourceRoot":"","sources":["../../../../src/zustand/components/ZustandModal.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2CH,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,UAAU,CAAC;AAqBtE,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,EACnC,MAAc,EACd,aAAqB,GACtB,EAAE,iBAAiB,sCAwjBnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,GAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAM,+BAGtE"}
+{"version":3,"file":"ZustandModal.d.ts","sourceRoot":"","sources":["../../../../src/zustand/components/ZustandModal.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2CH,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,UAAU,CAAC;AAqBtE,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,EACnC,MAAc,EACd,aAAqB,EACrB,UAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,EAAE,iBAAiB,sCAklBnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,GAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAM,+BAGtE"}

package/lib/typescript/zustand/components/ZustandStateDetailContent.d.ts

@@ -9,14 +9,17 @@
  * Mirrors ReduxActionDetailContent.tsx
  */
 import type { ZustandStateChange } from "../types";
+import { type ZustandDetailViewMode } from "./ZustandDetailViewToggle";
 interface ZustandStateDetailContentProps {
     change: ZustandStateChange;
     changes: ZustandStateChange[];
     selectedIndex: number;
     onIndexChange: (index: number) => void;
     disableInternalFooter?: boolean;
+    /** Seed the CHANGE / STATE / DIFF toggle once; taps own it afterwards. */
+    initialView?: ZustandDetailViewMode;
 }
-export declare function ZustandStateDetailContent({ change, changes, selectedIndex, onIndexChange, disableInternalFooter, }: ZustandStateDetailContentProps): import("react").JSX.Element;
+export declare function ZustandStateDetailContent({ change, changes, selectedIndex, onIndexChange, disableInternalFooter, initialView, }: ZustandStateDetailContentProps): import("react").JSX.Element;
 /**
  * External footer component for modal use
  */

package/lib/typescript/zustand/components/ZustandStateDetailContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZustandStateDetailContent.d.ts","sourceRoot":"","sources":["../../../../src/zustand/components/ZustandStateDetailContent.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AASnD,UAAU,8BAA8B;IACtC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAyCD,wBAAgB,yBAAyB,CAAC,EACxC,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,EACb,qBAA6B,GAC9B,EAAE,8BAA8B,+BA6LhC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,GACd,EAAE;IACD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,sCAmBA"}
+{"version":3,"file":"ZustandStateDetailContent.d.ts","sourceRoot":"","sources":["../../../../src/zustand/components/ZustandStateDetailContent.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,2BAA2B,CAAC;AAKnC,UAAU,8BAA8B;IACtC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAyCD,wBAAgB,yBAAyB,CAAC,EACxC,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,EACb,qBAA6B,EAC7B,WAAsB,GACvB,EAAE,8BAA8B,+BA6LhC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,GACd,EAAE;IACD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,sCAmBA"}

package/lib/typescript/zustand/components/ZustandStoreBrowser.d.ts

@@ -19,7 +19,9 @@ interface ZustandStoreBrowserProps {
      * watch handshake).
      */
     isLoading?: boolean;
+    /** Fired when a store row is expanded (not when collapsed). */
+    onStoreExpand?: (storeName: string) => void;
 }
-export declare function ZustandStoreBrowser({ stores, searchQuery, onViewHistory, isLoading, }: ZustandStoreBrowserProps): import("react").JSX.Element;
+export declare function ZustandStoreBrowser({ stores, searchQuery, onViewHistory, isLoading, onStoreExpand, }: ZustandStoreBrowserProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=ZustandStoreBrowser.d.ts.map

package/lib/typescript/zustand/components/ZustandStoreBrowser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZustandStoreBrowser.d.ts","sourceRoot":"","sources":["../../../../src/zustand/components/ZustandStoreBrowser.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,UAAU,wBAAwB;IAChC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAkHD,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,WAAW,EACX,aAAa,EACb,SAAiB,GAClB,EAAE,wBAAwB,+BA4F1B"}
+{"version":3,"file":"ZustandStoreBrowser.d.ts","sourceRoot":"","sources":["../../../../src/zustand/components/ZustandStoreBrowser.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,UAAU,wBAAwB;IAChC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAyHD,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,WAAW,EACX,aAAa,EACb,SAAiB,EACjB,aAAa,GACd,EAAE,wBAAwB,+BA8F1B"}

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

@@ -1,3 +1,18 @@
+import type { ZustandStateChange } from "../types";
+/**
+ * Sentinel used in WIRE-FORM snapshots in place of raw prevState/nextState.
+ * Same hazard as redux: up to 200 changes × 2 full trees on every snapshot
+ * freeze/OOM-killed large apps. Dashboards fetch trees via `getChangeDetail`.
+ */
+export declare const STATE_ON_DEVICE: Readonly<{
+    __buoyStateOnDevice: true;
+    note: "State trees stay on the device — fetched on demand via getChangeDetail / getStoreState.";
+}>;
+/** 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.";
+}>;
 /**
  * Sync adapter for the zustand tool, consumed by @buoy-gg/external-sync's
  * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
@@ -9,24 +24,71 @@
  * change timeline and the store registry (with each store's current state)
  * so the dashboard can render the store browser.
  *
+ * v2: change-log prevState/nextState are replaced with on-device markers
+ * (see STATE_ON_DEVICE). Dashboards fetch trees via `getChangeDetail`.
+ * Oversized / unserializable `stores[].currentState` uses the same marker
+ * and is fetched via `getStoreState`.
+ *
  * The `setState` action powers remote time-travel/reset from the dashboard.
  */
 export declare const zustandSyncAdapter: {
     version: number;
     getSnapshot: () => {
-        changes: import("../types").ZustandStateChange[];
-        stores: import("../types").ZustandStoreSnapshot[];
+        changes: ZustandStateChange[];
+        stores: {
+            currentState: unknown;
+            name: string;
+            stateChangeCount: number;
+            isPersisted: boolean;
+            persistName?: string;
+            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) => {
+        listStores: (params?: unknown) => {
             stores: ({
                 currentState: unknown;
                 name: string;
@@ -44,7 +106,13 @@ export declare const zustandSyncAdapter: {
             returned: number;
             includedValues: boolean;
         };
-        setState: (params: unknown) => void;
+        setState: (params?: unknown) => {
+            ok: boolean;
+            error: string;
+        } | {
+            ok: boolean;
+            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":"AAsBA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB;;;;;;0BAMP,MAAM,IAAI;;;QAY9B;;;;;WAKG;6BACkB,OAAO;;;;;;;;;;;;;;;;;;2BAsBT,OAAO;;CAQ7B,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;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;;;;;;;;;;;;;;;;;;4BAsBT,OAAO;;;;;;;;CAS9B,CAAC"}