@buoy-gg/zustand 7.0.41 → 7.0.43

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`${ZUSTAND_TEST_ID}-row-${slugForTestID(e)}-${t}`}export function storeRowTestID(e){return`${ZUSTAND_TEST_ID}-store-${slugForTestID(e)}`}export function buildChangeRowTestIDs(e){const t=new Map;const n=new Map;for(const o of e){const r=(t.get(o.storeName)??0)+1;t.set(o.storeName,r);n.set(o.id,changeRowTestID(o.storeName,r))}return n}

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

@@ -1,375 +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();
-    // The browser keeps its store list in React state and only re-reads it
-    // on a store notification — `clear()` above only tells the change-log
-    // listeners, so without this the cards kept their old counts after Clear.
-    this.notifyStoreListeners();
-  }
-
-  // ---- 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 as v,entityColor as L,formatValuePreview as w,shallowDiffSummary as x}from"@buoy-gg/shared-ui";const N={counter:"#10B981",auth:"#8B5CF6",user:"#3B82F6",cart:"#EC4899",app:"#6366F1",ui:"#F59E0B",settings:"#14B8A6",theme:"#06B6D4",navigation:"#F97316",form:"#EF4444"};function d(c){return L(c,N)}function b(c,t=40){return w(c,{maxLength:t,undefinedLabel:"",functionLabel:"(updater fn)"})}class P extends v{stores=new Map;storeListeners=new Set;remoteSetStateHandler=null;addStateChange(t){if(!this.canRecord())return;const{storeName:s,partial:r,replace:a,prevState:o,nextState:e,duration:n,category:i,isPersisted:h=false}=t;const u=o!==e;const{summary:g,changedKeys:l,changedCount:f}=x(o,e);const m=b(r);const C=(n??0)>16;const y=i??(a?"replace":"setState");const p={id:this.nextId(),storeName:s,timestamp:Date.now(),prevState:o,nextState:e,partial:r,duration:n,hasStateChange:u,replace:a,category:y,changedKeys:l,changedKeysCount:f,diffSummary:g,partialPreview:m,isSlowUpdate:C,isPersisted:h};this.push(p);const S=this.stores.get(s);if(S){S.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 r of this.stores.values()){r.stateChangeCount=0}const s=t.slice(0,this.max);for(const r of s){const a=this.stores.get(r.storeName);if(a)a.stateChangeCount++}this.setItems(s);this.notifyStoreListeners()}getStoreSnapshots(){return Array.from(this.stores.values()).map(t=>{let s;try{s=t.api.getState()}catch{s=void 0}return{name:t.name,stateChangeCount:t.stateChangeCount,isPersisted:t.isPersisted,persistName:t.persistName,canRehydrate:typeof t.rehydrate==="function",color:t.color,currentState:s}})}setRemoteSetStateHandler(t){this.remoteSetStateHandler=t}replaceFromSnapshot(t,s){if(!this.getEnabled())return;const r=new Map;for(const e of this.items){const n=e.prevState;if(!n||n.__buoyStateOnDevice!==true){r.set(e.id,e)}}const a=t.slice(0,this.max).map(e=>{const n=r.get(e.id);const i=e.prevState;return n&&i?.__buoyStateOnDevice===true?{...e,prevState:n.prevState,nextState:n.nextState,partial:n.partial}:e});const o=new Map;for(const[e,n]of this.stores){try{const i=n.api.getState();const h=i;if(!h||h.__buoyStateOnDevice!==true){o.set(e,i)}}catch{}}this.stores=new Map(s.map(e=>{const n=e.currentState;const i=o.get(e.name);const h=i!==void 0&&n?.__buoyStateOnDevice===true?i:e.currentState;return[e.name,{name:e.name,api:{getState:()=>h,setState:(u,g)=>{this.remoteSetStateHandler?.(e.name,u,g)},subscribe:()=>()=>{}},stateChangeCount:e.stateChangeCount,isPersisted:e.isPersisted,persistName:e.persistName,color:e.color}]}));this.setItems(a);this.notifyStoreListeners()}hydrateChange(t,s){this.hydrateById(t,s)}hydrateStoreState(t,s){const r=this.stores.get(t);if(!r)return;this.stores.set(t,{...r,api:{...r.api,getState:()=>s}});this.notifyStoreListeners()}registerStore(t,s,r){if(this.stores.has(t))return;const a={name:t,api:s,stateChangeCount:0,isPersisted:r?.isPersisted??false,persistName:r?.persistName,rehydrate:r?.rehydrate,color:d(t)};this.stores.set(t,a);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??d(t)}filterStateChanges(t){let s=this.getAll();if(t.searchText){const r=t.searchText.toLowerCase();s=s.filter(a=>a.storeName.toLowerCase().includes(r)||a.partialPreview.toLowerCase().includes(r)||a.changedKeys.some(o=>o.toLowerCase().includes(r)))}if(t.storeNames&&t.storeNames.length>0){s=s.filter(r=>t.storeNames.includes(r.storeName))}if(t.onlyWithChanges){s=s.filter(r=>r.hasStateChange)}return s}getStats(){const t=this.items.length;const s=this.items.filter(e=>e.hasStateChange).length;const r=this.stores.size;const a=this.items.filter(e=>e.duration!==void 0).map(e=>e.duration);const o=a.length>0?a.reduce((e,n)=>e+n,0)/a.length:0;return{totalChanges:t,changesWithStateChange:s,changesWithoutStateChange:t-s,storeCount:r,averageDuration:Math.round(o*100)/100}}getUniqueStoreNames(){return Array.from(this.stores.keys()).sort()}setMaxChanges(t){this.setMax(t)}subscribeToStores(t){this.storeListeners.add(t);return()=>{this.storeListeners.delete(t)}}notifyStoreListeners(){const t=this.getStores();this.storeListeners.forEach(s=>s(t))}}export const zustandStateStore=new P;