@buoy-gg/zustand 7.0.16 → 7.0.18

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

@@ -0,0 +1,278 @@
+"use strict";
+
+/**
+ * Time Machine snapshot provider for Zustand.
+ *
+ * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
+ * consumed by @buoy-gg/time-machine. Neither package imports the other.
+ *
+ * The Zustand-specific hazard: stores conventionally keep their action
+ * functions IN state (`increment: () => ...`). Functions don't survive
+ * serialization, and a full `setState(snapshot, true)` replace would wipe
+ * them, breaking every `useStore(s => s.increment)` call site. So capture
+ * strips functions (recording where they were), and restore re-grafts the
+ * 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) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+
+/** Clone `value` without functions, recording their paths. */
+function stripFunctions(value, path, fnPaths, seen, depth) {
+  if (typeof value === "function") {
+    fnPaths.push(path);
+    return undefined;
+  }
+  if (typeof value !== "object" || value === null || depth >= MAX_DEPTH) {
+    return value;
+  }
+  if (seen.has(value)) return undefined; // cycle — drop the back-reference
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.map((item, i) => typeof item === "function" ? (fnPaths.push(`${path}[${i}]`), null) : stripFunctions(item, `${path}[${i}]`, fnPaths, seen, depth + 1));
+  }
+  if (!isPlainObjectLike(value)) return value; // Date/Map/Set/etc. — superjson handles
+  const out = {};
+  for (const [k, v] of Object.entries(value)) {
+    if (typeof v === "function") {
+      fnPaths.push(path ? `${path}.${k}` : k);
+      continue;
+    }
+    out[k] = stripFunctions(v, path ? `${path}.${k}` : k, fnPaths, seen, depth + 1);
+  }
+  return out;
+}
+
+/**
+ * Copy every function-valued property from the LIVE state onto the restored
+ * snapshot (creating containers as needed), so store actions keep working
+ * after a full replace.
+ */
+function graftFunctions(target, live, seen, depth) {
+  if (!isPlainObjectLike(live) || !isPlainObjectLike(target)) return;
+  if (depth >= MAX_DEPTH || seen.has(live)) return;
+  seen.add(live);
+  for (const [k, v] of Object.entries(live)) {
+    if (typeof v === "function") {
+      target[k] = v;
+    } else if (isPlainObjectLike(v)) {
+      if (!isPlainObjectLike(target[k])) {
+        // Branch missing from the snapshot — only recreate it if it holds
+        // functions somewhere; otherwise the snapshot's absence wins.
+        if (!containsFunction(v, new WeakSet(), depth + 1)) continue;
+        target[k] = {};
+      }
+      graftFunctions(target[k], v, seen, depth + 1);
+    }
+  }
+}
+function containsFunction(value, seen, depth) {
+  if (depth >= MAX_DEPTH || seen.has(value)) return false;
+  seen.add(value);
+  for (const v of Object.values(value)) {
+    if (typeof v === "function") return true;
+    if (isPlainObjectLike(v) && containsFunction(v, seen, depth + 1)) return true;
+  }
+  return false;
+}
+function status() {
+  const count = zustandStateStore.getStores().length;
+  if (count === 0) {
+    return {
+      canCapture: false,
+      canRestore: false,
+      detail: "No Zustand stores registered — pass `zustandStores` to FloatingDevTools or add the buoyDevTools middleware"
+    };
+  }
+  return {
+    canCapture: true,
+    canRestore: true
+  };
+}
+async function capture() {
+  const warnings = [];
+  const stores = {};
+  for (const info of zustandStateStore.getStores()) {
+    const fnPaths = [];
+    let state;
+    try {
+      state = stripFunctions(info.api.getState(), "", fnPaths, new WeakSet(), 0);
+    } catch (e) {
+      warnings.push(`store "${info.name}": capture failed (${String(e)})`);
+      continue;
+    }
+    stores[info.name] = {
+      state,
+      fnPaths
+    };
+  }
+  return {
+    data: {
+      stores
+    },
+    warnings
+  };
+}
+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,
+    skipped: [],
+    warnings: []
+  };
+  if (!snapshot?.stores) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [],
+      warnings: ["empty zustand snapshot"]
+    };
+  }
+  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({
+        id: name,
+        reason: "store not registered (renamed, or created after snapshot?)"
+      });
+      continue;
+    }
+    try {
+      const next = envelope.state;
+      graftFunctions(next, info.api.getState(), new WeakSet(), 0);
+      info.api.setState(next, true);
+      if (info.api.getState() === next) {
+        result.applied += 1;
+      } else {
+        result.warnings.push(`store "${name}": setState did not take effect`);
+        result.ok = false;
+      }
+    } catch (e) {
+      result.skipped.push({
+        id: name,
+        reason: String(e)
+      });
+      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,
+  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/index.d.ts

@@ -34,6 +34,7 @@
  * );
  * ```
  */
+import "./zustand/utils/snapshotProvider";
 export { zustandToolPreset, createZustandTool } from "./preset";
 export { watchStores } from "./zustand/utils/buoyZustandMiddleware";
 export { buoyDevTools } from "./zustand/utils/buoyZustandMiddleware";

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAKH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAKpE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAKrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAK5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,YAAY,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAO3F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAKnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAKzB,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,kCAAkC,CAAC;AAK1C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAKpE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAKrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAK5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,YAAY,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAO3F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAKnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAKzB,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}

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,17 +24,64 @@
  * 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
@@ -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;AAEnD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;EAG1B,CAAC;AAEH,sFAAsF;AACtF,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC;AAwFH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;0BASP,MAAM,IAAI;;;QAY9B;;;;WAIG;kCACuB,OAAO;;;;;;;;;;;;;;;QA2BjC;;;WAGG;gCACqB,OAAO;;;;;;;;;;;QAiC/B;;;;;WAKG;6BACkB,OAAO;;;;;;;;;;;;;;;;;;2BAsBT,OAAO;;;;;;;;CAS7B,CAAC"}

package/lib/typescript/zustand/types/index.d.ts

@@ -81,6 +81,32 @@ export interface ZustandModalProps {
      * that genuinely has stores reads as empty for the first second or two.
      */
     storesLoading?: boolean;
+    /**
+     * Open on this tab. Used by hosts that deep-link into the tool (docs live
+     * tour). Defaults to `"stores"`.
+     */
+    initialTab?: "stores" | "events";
+    /**
+     * Open straight into this change's detail view, by change id. Applied once
+     * the id appears in the visible list, then left alone — Back closes the
+     * detail and it stays closed. Null/undefined means "don't touch selection".
+     */
+    initialSelectedChangeId?: string | null;
+    /**
+     * Which detail view that deep-link opens on (`change` | `state` | `diff`).
+     */
+    initialDetailView?: "change" | "state" | "diff";
+    /**
+     * Fired when the user selects a change (opens its detail view). Remote
+     * mirrors (Buoy Desktop) use this to fetch the change's real state trees
+     * on demand — wire-form snapshots carry markers instead of trees.
+     */
+    onChangeSelect?: (change: ZustandStateChange) => void;
+    /**
+     * Fired when the user expands a store in the browser. Remote mirrors use
+     * this to fetch oversized `currentState` via `getStoreState`.
+     */
+    onStoreExpand?: (storeName: string) => void;
     visible: boolean;
     onClose: () => void;
     onBack?: () => void;

package/lib/typescript/zustand/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/zustand/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE;QACH,QAAQ,EAAE,MAAM,OAAO,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC;QAChC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;QACxD,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;KACnF,CAAC;IACF,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/zustand/types/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshotProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotProvider.d.ts","sourceRoot":"","sources":["../../../../src/zustand/utils/snapshotProvider.ts"],"names":[],"mappings":""}