@buoy-gg/zustand 7.0.35 → 7.0.38

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

@@ -1,209 +1 @@
-"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 { classifyPreviewItem, createRestoreScope, emptyRestoreResult, failedRestore, registerStateSnapshotProvider, unionKeys } from "@buoy-gg/shared-ui";
-import { zustandStateStore } from "./zustandStateStore";
-import { isPlainObjectLike, stripFunctions, STRIP_MAX_DEPTH } from "./editableState";
-
-// The function-stripping walk is shared with the store editor (editableState
-// .ts) — capture and editing must agree on what a store's "data" is.
-const MAX_DEPTH = STRIP_MAX_DEPTH;
-/**
- * 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 scope = createRestoreScope(options);
-  const result = emptyRestoreResult();
-  if (!snapshot?.stores) {
-    return failedRestore("empty zustand snapshot");
-  }
-  for (const [name, envelope] of Object.entries(snapshot.stores)) {
-    if (!scope.allows(name)) 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;
-    }
-  }
-  const excludedWarning = scope.excludedWarning("store(s)");
-  if (excludedWarning) result.warnings.push(excludedWarning);
-  return result;
-}
-
-/**
- * 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;
-  for (const name of unionKeys(baseStores, targetStores)) {
-    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;
-    }
-    items.push(classifyPreviewItem({
-      key: name,
-      label: name,
-      oldValue: baseStores[name]?.state,
-      newValue: targetStores[name].state,
-      inOld: inBase,
-      inNew: true
-    }, {
-      tooLargeReason: "store too large to render a diff — restore still applies it"
-    }));
-  }
-  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
-});
+"use strict";import{classifyPreviewItem,createRestoreScope,emptyRestoreResult,failedRestore,registerStateSnapshotProvider,unionKeys}from"@buoy-gg/shared-ui";import{zustandStateStore}from"./zustandStateStore";import{isPlainObjectLike,stripFunctions,STRIP_MAX_DEPTH}from"./editableState";const MAX_DEPTH=STRIP_MAX_DEPTH;function graftFunctions(t,e,s,n){if(isPlainObjectLike(e)&&isPlainObjectLike(t)&&!(n>=MAX_DEPTH||s.has(e))){s.add(e);for(const[o,r]of Object.entries(e))if("function"==typeof r)t[o]=r;else if(isPlainObjectLike(r)){if(!isPlainObjectLike(t[o])){if(!containsFunction(r,new WeakSet,n+1))continue;t[o]={}}graftFunctions(t[o],r,s,n+1)}}}function containsFunction(t,e,s){if(s>=MAX_DEPTH||e.has(t))return!1;e.add(t);for(const n of Object.values(t)){if("function"==typeof n)return!0;if(isPlainObjectLike(n)&&containsFunction(n,e,s+1))return!0}return!1}function status(){return 0===zustandStateStore.getStores().length?{canCapture:!1,canRestore:!1,detail:"No Zustand stores registered — pass `zustandStores` to FloatingDevTools or add the buoyDevTools middleware"}:{canCapture:!0,canRestore:!0}}async function capture(){const t=[],e={};for(const s of zustandStateStore.getStores()){const n=[];let o;try{o=stripFunctions(s.api.getState(),"",n,new WeakSet,0)}catch(e){t.push(`store "${s.name}": capture failed (${String(e)})`);continue}e[s.name]={state:o,fnPaths:n}}return{data:{stores:e},warnings:t}}async function restore(t,e){const s=t,n=createRestoreScope(e),o=emptyRestoreResult();if(!s?.stores)return failedRestore("empty zustand snapshot");for(const[t,e]of Object.entries(s.stores)){if(!n.allows(t))continue;const s=zustandStateStore.getStore(t);if(s)try{const n=e.state;graftFunctions(n,s.api.getState(),new WeakSet,0),s.api.setState(n,!0),s.api.getState()===n?o.applied+=1:(o.warnings.push(`store "${t}": setState did not take effect`),o.ok=!1)}catch(e){o.skipped.push({id:t,reason:String(e)}),o.ok=!1}else o.skipped.push({id:t,reason:"store not registered (renamed, or created after snapshot?)"})}const r=n.excludedWarning("store(s)");return r&&o.warnings.push(r),o}async function previewItems(t,e){const s=t?.stores??{},n=void 0===e,o={};if(n)for(const t of zustandStateStore.getStores()){const e=[];try{o[t.name]={state:stripFunctions(t.api.getState(),"",e,new WeakSet,0),fnPaths:e}}catch{}}else Object.assign(o,e?.stores??{});const r=[],a=[];let i=0;for(const t of unionKeys(o,s)){const e=t in o;t in s?(i+=s[t].fnPaths?.length??0,!n||zustandStateStore.getStore(t)?r.push(classifyPreviewItem({key:t,label:t,oldValue:o[t]?.state,newValue:s[t].state,inOld:e,inNew:!0},{tooLargeReason:"store too large to render a diff — restore still applies it"})):r.push({key:t,label:t,verdict:"wont-apply",reason:"store not registered (renamed, or created after snapshot?)"})):n?a.push(`store "${t}" not in snapshot — untouched`):r.push({key:t,label:t,verdict:"removed",oldValue:o[t].state})}return i>0&&a.push(`${i} store action function${1===i?"":"s"} preserved on restore (not diffed)`),{items:r,notes:a}}registerStateSnapshotProvider({id:"zustand",label:"Zustand",status:status,capture:capture,restore:restore,previewItems:previewItems});

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

@@ -1,74 +1 @@
-"use strict";
-
-/**
- * Zustand tool test handles.
- *
- * Every tappable and every value the e2e suite reads back is addressed
- * `buoy-zustand-<thing>`. Two rules in here need explaining.
- *
- * **A change row's handle carries an ORDINAL, and it counts per STORE.** The
- * Events tool can address a row by what it is about, because an event is a
- * thing that happened to a named subject — one key, one URL, one atom. A
- * zustand state change is not: a store that a screen writes to fifty times
- * produces fifty separate, equally real rows. Addressing them by store name
- * alone would give fifty views one handle, and Detox fails a *matcher* that
- * hits more than one element — so a suite would break on `toExist()`, before
- * any assertion, with an error that says nothing about duplicate changes.
- *
- * So the handle is `buoy-zustand-row-<slug(storeName)>-<n>`, where n counts
- * back from the newest row of that store (1 = newest). Deliberately relative:
- * a state change has no identity a host could know in advance — `id` is a
- * timestamp plus a per-process counter whose value depends on how many
- * changes the app happened to make before the test looked. What a test CAN
- * know is "the set I just fired is the newest change to that store". Read and
- * tap in one beat: a row's ordinal moves the instant another change lands.
- *
- * **A store row's handle does NOT.** A store is registered once under a name
- * that is unique by construction (`zustandStateStore.registerStore` returns
- * early on a name it already holds), so `buoy-zustand-store-<slug(name)>` is
- * as stable as the store itself — and unlike a change, it is a thing the host
- * knows the name of before the app has booted.
- *
- * The suite mirrors these rules in CommonJS (`example-dev-build/utils/
- * zustandBench.js`) and asserts the two agree — Detox runs in Node on the host
- * and cannot import TypeScript.
- */
-
-/** Prefix every handle in this tool shares. */
-export const ZUSTAND_TEST_ID = "buoy-zustand";
-
-/** `zbenchWatch` → `zbenchwatch`. Shared with every Buoy tool. */
-export function slugForTestID(value) {
-  return String(value ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "unknown";
-}
-
-/**
- * Handle for one change row: `buoy-zustand-row-zbenchwatch-1`.
- *
- * `ordinal` is 1-based and counts back from the newest row of this store.
- */
-export function changeRowTestID(storeName, ordinal) {
-  return `${ZUSTAND_TEST_ID}-row-${slugForTestID(storeName)}-${ordinal}`;
-}
-
-/** Handle for one store row in the browser: `buoy-zustand-store-zbenchwatch`. */
-export function storeRowTestID(storeName) {
-  return `${ZUSTAND_TEST_ID}-store-${slugForTestID(storeName)}`;
-}
-
-/**
- * Row handle per change id for one rendered list, newest-first.
- *
- * Built once for the whole list rather than per row, because an ordinal is a
- * fact about the list and a row cannot compute its own.
- */
-export function buildChangeRowTestIDs(changes) {
-  const seen = new Map();
-  const handles = new Map();
-  for (const change of changes) {
-    const ordinal = (seen.get(change.storeName) ?? 0) + 1;
-    seen.set(change.storeName, ordinal);
-    handles.set(change.id, changeRowTestID(change.storeName, ordinal));
-  }
-  return handles;
-}
+"use strict";export const ZUSTAND_TEST_ID="buoy-zustand";export function slugForTestID(e){return String(e??"").toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}export function changeRowTestID(e,t){return`buoy-zustand-row-${slugForTestID(e)}-${t}`}export function storeRowTestID(e){return`buoy-zustand-store-${slugForTestID(e)}`}export function buildChangeRowTestIDs(e){const t=new Map,o=new Map;for(const n of e){const e=(t.get(n.storeName)??0)+1;t.set(n.storeName,e),o.set(n.id,changeRowTestID(n.storeName,e))}return o}

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

@@ -1,371 +1 @@
-"use strict";
-
-/**
- * Zustand state store - captures and stores Zustand state changes
- *
- * 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, entityColor, formatValuePreview, shallowDiffSummary } from "@buoy-gg/shared-ui";
-// ============================================
-// Store Color Palette
-// ============================================
-
-const STORE_COLORS = {
-  counter: "#10B981",
-  // emerald
-  auth: "#8B5CF6",
-  // purple
-  user: "#3B82F6",
-  // blue
-  cart: "#EC4899",
-  // pink
-  app: "#6366F1",
-  // indigo
-  ui: "#F59E0B",
-  // amber
-  settings: "#14B8A6",
-  // teal
-  theme: "#06B6D4",
-  // cyan
-  navigation: "#F97316",
-  // orange
-  form: "#EF4444" // red
-};
-
-/**
- * Get consistent color for a store based on its name
- */
-function getStoreColor(storeName) {
-  return entityColor(storeName, STORE_COLORS);
-}
-
-/**
- * Format payload preview for display
- */
-function formatPartialPreview(partial, maxLength = 40) {
-  return formatValuePreview(partial, {
-    maxLength,
-    undefinedLabel: "",
-    functionLabel: "(updater fn)"
-  });
-}
-
-// ============================================
-// Zustand State Store
-// ============================================
-
-class ZustandStateStore extends ChangeLog {
-  stores = new Map();
-  storeListeners = new Set();
-  remoteSetStateHandler = null;
-
-  // ---- State Change Tracking ----
-
-  addStateChange(params) {
-    if (!this.canRecord()) return;
-    const {
-      storeName,
-      partial,
-      replace,
-      prevState,
-      nextState,
-      duration,
-      category,
-      isPersisted = false
-    } = params;
-    const hasStateChange = prevState !== nextState;
-    // `changedCount` counts the keys in `changedKeys` and nothing else, so the
-    // row's "N keys changed" and the detail page's CHANGED KEYS card agree —
-    // including the persist-rehydrate case where the object is replaced
-    // without any top-level value moving.
-    const {
-      summary,
-      changedKeys,
-      changedCount
-    } = shallowDiffSummary(prevState, nextState);
-    const partialPreview = formatPartialPreview(partial);
-    const isSlowUpdate = (duration ?? 0) > 16;
-    const resolvedCategory = category ?? (replace ? "replace" : "setState");
-    const stateChange = {
-      id: this.nextId(),
-      storeName,
-      timestamp: Date.now(),
-      prevState,
-      nextState,
-      partial,
-      duration,
-      hasStateChange,
-      replace,
-      category: resolvedCategory,
-      changedKeys,
-      changedKeysCount: changedCount,
-      diffSummary: summary,
-      partialPreview,
-      isSlowUpdate,
-      isPersisted
-    };
-    this.push(stateChange);
-
-    // Update store change count
-    const storeInfo = this.stores.get(storeName);
-    if (storeInfo) {
-      storeInfo.stateChangeCount++;
-    }
-    this.notifyListeners();
-  }
-  getStateChanges() {
-    return this.getAll();
-  }
-  getStateChangeById(id) {
-    return this.getById(id);
-  }
-  clearStateChanges() {
-    // Reset counts
-    for (const store of this.stores.values()) {
-      store.stateChangeCount = 0;
-    }
-    this.clear();
-  }
-
-  // ---- 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.getEnabled()) return;
-    for (const store of this.stores.values()) {
-      store.stateChangeCount = 0;
-    }
-    const kept = changes.slice(0, this.max);
-    for (const change of kept) {
-      const store = this.stores.get(change.storeName);
-      if (store) store.stateChangeCount++;
-    }
-    this.setItems(kept);
-    this.notifyStoreListeners();
-  }
-
-  /**
-   * Serializable snapshot of the tracked stores (registry metadata plus each
-   * store's current state). Used by the sync adapter on the device side —
-   * the live `api` handles can't go over the wire.
-   */
-  getStoreSnapshots() {
-    return Array.from(this.stores.values()).map(store => {
-      let currentState;
-      try {
-        currentState = store.api.getState();
-      } catch {
-        currentState = undefined;
-      }
-      return {
-        name: store.name,
-        stateChangeCount: store.stateChangeCount,
-        isPersisted: store.isPersisted,
-        persistName: store.persistName,
-        // Persisted is not the same as re-readable: a store registered before
-        // its persist middleware attached has a name but no handle. The
-        // Storage tool needs the difference to decide between offering "apply"
-        // and telling the user to restart.
-        canRehydrate: typeof store.rehydrate === "function",
-        color: store.color,
-        currentState
-      };
-    });
-  }
-
-  /**
-   * Handler invoked when the UI calls setState on a mirrored store (e.g.
-   * time-travel from the dashboard). Forward it to the synced device.
-   */
-  setRemoteSetStateHandler(handler) {
-    this.remoteSetStateHandler = handler;
-  }
-
-  /**
-   * Replace the entire mirror contents from a synced device snapshot. The
-   * rebuilt registry entries get stub `api` handles: getState() serves the
-   * snapshotted state, setState() forwards to the remote handler. Respects
-   * the enabled flag so the UI's pause button freezes the mirror.
-   */
-  replaceFromSnapshot(changes, storeSnapshots) {
-    if (!this.getEnabled()) return;
-
-    // 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.items) {
-      const prev = existing.prevState;
-      if (!prev || prev.__buoyStateOnDevice !== true) {
-        hydrated.set(existing.id, existing);
-      }
-    }
-    const merged = changes.slice(0, this.max).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: () => () => {}
-        },
-        stateChangeCount: snapshot.stateChangeCount,
-        isPersisted: snapshot.isPersisted,
-        persistName: snapshot.persistName,
-        color: snapshot.color
-      }];
-    }));
-    this.setItems(merged);
-    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) {
-    this.hydrateById(id, patch);
-  }
-
-  /**
-   * 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();
-  }
-
-  // ---- Store Registry ----
-
-  registerStore(name, api, options) {
-    if (this.stores.has(name)) return;
-    const storeInfo = {
-      name,
-      api,
-      stateChangeCount: 0,
-      isPersisted: options?.isPersisted ?? false,
-      persistName: options?.persistName,
-      rehydrate: options?.rehydrate,
-      color: getStoreColor(name)
-    };
-    this.stores.set(name, storeInfo);
-    this.notifyStoreListeners();
-  }
-  unregisterStore(name) {
-    this.stores.delete(name);
-    this.notifyStoreListeners();
-  }
-  getStores() {
-    return Array.from(this.stores.values());
-  }
-  getStore(name) {
-    return this.stores.get(name);
-  }
-  getStoreColor(name) {
-    return this.stores.get(name)?.color ?? getStoreColor(name);
-  }
-
-  // ---- Filtering ----
-
-  filterStateChanges(filter) {
-    let filtered = this.getAll();
-    if (filter.searchText) {
-      const search = filter.searchText.toLowerCase();
-      filtered = filtered.filter(c => c.storeName.toLowerCase().includes(search) || c.partialPreview.toLowerCase().includes(search) || c.changedKeys.some(k => k.toLowerCase().includes(search)));
-    }
-    if (filter.storeNames && filter.storeNames.length > 0) {
-      filtered = filtered.filter(c => filter.storeNames.includes(c.storeName));
-    }
-    if (filter.onlyWithChanges) {
-      filtered = filtered.filter(c => c.hasStateChange);
-    }
-    return filtered;
-  }
-
-  // ---- Stats ----
-
-  getStats() {
-    const total = this.items.length;
-    const withChanges = this.items.filter(c => c.hasStateChange).length;
-    const storeCount = this.stores.size;
-    const durations = this.items.filter(c => c.duration !== undefined).map(c => c.duration);
-    const avgDuration = durations.length > 0 ? durations.reduce((sum, d) => sum + d, 0) / durations.length : 0;
-    return {
-      totalChanges: total,
-      changesWithStateChange: withChanges,
-      changesWithoutStateChange: total - withChanges,
-      storeCount,
-      averageDuration: Math.round(avgDuration * 100) / 100
-    };
-  }
-  getUniqueStoreNames() {
-    return Array.from(this.stores.keys()).sort();
-  }
-
-  // ---- Enable / Disable ----
-
-  setMaxChanges(max) {
-    this.setMax(max);
-  }
-
-  // ---- Subscriptions ----
-
-  subscribeToStores(listener) {
-    this.storeListeners.add(listener);
-    return () => {
-      this.storeListeners.delete(listener);
-    };
-  }
-  notifyStoreListeners() {
-    const stores = this.getStores();
-    this.storeListeners.forEach(listener => listener(stores));
-  }
-}
-export const zustandStateStore = new ZustandStateStore();
+"use strict";import{ChangeLog,entityColor,formatValuePreview,shallowDiffSummary}from"@buoy-gg/shared-ui";const STORE_COLORS={counter:"#10B981",auth:"#8B5CF6",user:"#3B82F6",cart:"#EC4899",app:"#6366F1",ui:"#F59E0B",settings:"#14B8A6",theme:"#06B6D4",navigation:"#F97316",form:"#EF4444"};function getStoreColor(t){return entityColor(t,STORE_COLORS)}function formatPartialPreview(t,e=40){return formatValuePreview(t,{maxLength:e,undefinedLabel:"",functionLabel:"(updater fn)"})}class ZustandStateStore extends ChangeLog{stores=new Map;storeListeners=new Set;remoteSetStateHandler=null;addStateChange(t){if(!this.canRecord())return;const{storeName:e,partial:s,replace:r,prevState:a,nextState:o,duration:n,category:i,isPersisted:h=!1}=t,u=a!==o,{summary:S,changedKeys:c,changedCount:g}=shallowDiffSummary(a,o),l=formatPartialPreview(s),d=(n??0)>16,m=i??(r?"replace":"setState"),f={id:this.nextId(),storeName:e,timestamp:Date.now(),prevState:a,nextState:o,partial:s,duration:n,hasStateChange:u,replace:r,category:m,changedKeys:c,changedKeysCount:g,diffSummary:S,partialPreview:l,isSlowUpdate:d,isPersisted:h};this.push(f);const C=this.stores.get(e);C&&C.stateChangeCount++,this.notifyListeners()}getStateChanges(){return this.getAll()}getStateChangeById(t){return this.getById(t)}clearStateChanges(){for(const t of this.stores.values())t.stateChangeCount=0;this.clear(),this.notifyStoreListeners()}replaceStateChanges(t){if(!this.getEnabled())return;for(const t of this.stores.values())t.stateChangeCount=0;const e=t.slice(0,this.max);for(const t of e){const e=this.stores.get(t.storeName);e&&e.stateChangeCount++}this.setItems(e),this.notifyStoreListeners()}getStoreSnapshots(){return Array.from(this.stores.values()).map(t=>{let e;try{e=t.api.getState()}catch{e=void 0}return{name:t.name,stateChangeCount:t.stateChangeCount,isPersisted:t.isPersisted,persistName:t.persistName,canRehydrate:"function"==typeof t.rehydrate,color:t.color,currentState:e}})}setRemoteSetStateHandler(t){this.remoteSetStateHandler=t}replaceFromSnapshot(t,e){if(!this.getEnabled())return;const s=new Map;for(const t of this.items){const e=t.prevState;e&&!0===e.__buoyStateOnDevice||s.set(t.id,t)}const r=t.slice(0,this.max).map(t=>{const e=s.get(t.id),r=t.prevState;return e&&!0===r?.__buoyStateOnDevice?{...t,prevState:e.prevState,nextState:e.nextState,partial:e.partial}:t}),a=new Map;for(const[t,e]of this.stores)try{const s=e.api.getState();s&&!0===s.__buoyStateOnDevice||a.set(t,s)}catch{}this.stores=new Map(e.map(t=>{const e=t.currentState,s=a.get(t.name),r=void 0!==s&&!0===e?.__buoyStateOnDevice?s:t.currentState;return[t.name,{name:t.name,api:{getState:()=>r,setState:(e,s)=>{this.remoteSetStateHandler?.(t.name,e,s)},subscribe:()=>()=>{}},stateChangeCount:t.stateChangeCount,isPersisted:t.isPersisted,persistName:t.persistName,color:t.color}]})),this.setItems(r),this.notifyStoreListeners()}hydrateChange(t,e){this.hydrateById(t,e)}hydrateStoreState(t,e){const s=this.stores.get(t);s&&(this.stores.set(t,{...s,api:{...s.api,getState:()=>e}}),this.notifyStoreListeners())}registerStore(t,e,s){if(this.stores.has(t))return;const r={name:t,api:e,stateChangeCount:0,isPersisted:s?.isPersisted??!1,persistName:s?.persistName,rehydrate:s?.rehydrate,color:getStoreColor(t)};this.stores.set(t,r),this.notifyStoreListeners()}unregisterStore(t){this.stores.delete(t),this.notifyStoreListeners()}getStores(){return Array.from(this.stores.values())}getStore(t){return this.stores.get(t)}getStoreColor(t){return this.stores.get(t)?.color??getStoreColor(t)}filterStateChanges(t){let e=this.getAll();if(t.searchText){const s=t.searchText.toLowerCase();e=e.filter(t=>t.storeName.toLowerCase().includes(s)||t.partialPreview.toLowerCase().includes(s)||t.changedKeys.some(t=>t.toLowerCase().includes(s)))}return t.storeNames&&t.storeNames.length>0&&(e=e.filter(e=>t.storeNames.includes(e.storeName))),t.onlyWithChanges&&(e=e.filter(t=>t.hasStateChange)),e}getStats(){const t=this.items.length,e=this.items.filter(t=>t.hasStateChange).length,s=this.stores.size,r=this.items.filter(t=>void 0!==t.duration).map(t=>t.duration),a=r.length>0?r.reduce((t,e)=>t+e,0)/r.length:0;return{totalChanges:t,changesWithStateChange:e,changesWithoutStateChange:t-e,storeCount:s,averageDuration:Math.round(100*a)/100}}getUniqueStoreNames(){return Array.from(this.stores.keys()).sort()}setMaxChanges(t){this.setMax(t)}subscribeToStores(t){return this.storeListeners.add(t),()=>{this.storeListeners.delete(t)}}notifyStoreListeners(){const t=this.getStores();this.storeListeners.forEach(e=>e(t))}}export const zustandStateStore=new ZustandStateStore;