@buoy-gg/jotai 7.0.41 → 7.0.43

package/lib/module/jotai/utils/jotaiStateStore.js

@@ -1,317 +1 @@
-"use strict";
-
-/**
- * Jotai state store — captures and stores Jotai atom changes
- *
- * Mirrors the architecture of zustandStateStore.ts from @buoy-gg/zustand
- */
-
-import { ChangeLog, entityColor, formatValuePreview as sharedFormatValuePreview, shallowDiffSummary } from "@buoy-gg/shared-ui";
-// ============================================
-// Atom Color Palette
-// ============================================
-
-const ATOM_COLORS = {
-  count: "#10B981",
-  // emerald
-  auth: "#8B5CF6",
-  // purple
-  user: "#3B82F6",
-  // blue
-  cart: "#EC4899",
-  // pink
-  app: "#6366F1",
-  // indigo
-  ui: "#F59E0B",
-  // amber
-  settings: "#14B8A6",
-  // teal
-  theme: "#06B6D4",
-  // cyan
-  nav: "#F97316",
-  // orange
-  form: "#EF4444",
-  // red
-  modal: "#A855F7",
-  // violet
-  filter: "#84CC16" // lime
-};
-function getAtomColor(label) {
-  return entityColor(label, ATOM_COLORS);
-}
-
-// ============================================
-// Helper Functions
-// ============================================
-
-function formatValuePreview(value, maxLength = 40) {
-  return sharedFormatValuePreview(value, {
-    maxLength,
-    functionLabel: "(fn)"
-  });
-}
-const getValueDiffSummary = shallowDiffSummary;
-
-// ============================================
-// Jotai State Store
-// ============================================
-
-class JotaiStateStore extends ChangeLog {
-  atoms = new Map();
-  atomListeners = new Set();
-
-  // ---- Change Tracking ----
-
-  addAtomChange(params) {
-    if (!this.canRecord()) return;
-    const {
-      atomLabel,
-      prevValue,
-      nextValue,
-      category = "write"
-    } = params;
-    const hasValueChange = prevValue !== nextValue;
-    const {
-      summary,
-      changedKeys,
-      changedCount
-    } = getValueDiffSummary(prevValue, nextValue);
-    const valuePreview = formatValuePreview(nextValue);
-    const change = {
-      id: this.nextId(),
-      atomLabel,
-      timestamp: Date.now(),
-      prevValue,
-      nextValue,
-      hasValueChange,
-      category,
-      changedKeys,
-      changedKeysCount: changedCount,
-      diffSummary: summary,
-      valuePreview,
-      isSlowUpdate: false
-    };
-    this.push(change);
-    const atomInfo = this.atoms.get(atomLabel);
-    if (atomInfo) {
-      atomInfo.changeCount++;
-    }
-    this.notifyListeners();
-    this.notifyAtomListeners();
-  }
-  getAtomChanges() {
-    return this.getAll();
-  }
-  getAtomChangeById(id) {
-    return this.getById(id);
-  }
-  clearAtomChanges() {
-    for (const atom of this.atoms.values()) {
-      atom.changeCount = 0;
-    }
-    this.clear();
-    this.notifyAtomListeners();
-  }
-
-  // ---- Remote Mirror Mode ----
-
-  /**
-   * Serializable snapshot of the tracked atoms (registry metadata plus each
-   * atom's current value). Used by the sync adapter on the device side —
-   * the live `getValue` handles can't go over the wire.
-   */
-  getAtomSnapshots() {
-    return Array.from(this.atoms.values()).map(atom => {
-      let currentValue;
-      try {
-        currentValue = atom.getValue();
-      } catch {
-        currentValue = undefined;
-      }
-      return {
-        label: atom.label,
-        changeCount: atom.changeCount,
-        color: atom.color,
-        currentValue,
-        writeKind: atom.writeKind
-      };
-    });
-  }
-
-  /**
-   * Replace the entire mirror contents from a synced device snapshot. The
-   * rebuilt registry entries get stub `getValue` handles serving the
-   * snapshotted value. Respects the enabled flag so the UI's pause button
-   * freezes the mirror.
-   */
-  replaceFromSnapshot(changes, atomSnapshots) {
-    if (!this.getEnabled()) return;
-
-    // Preserve values 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.prevValue;
-      if (!prev || prev.__buoyValueOnDevice !== true) {
-        hydrated.set(existing.id, existing);
-      }
-    }
-    const merged = changes.slice(0, this.max).map(change => {
-      const kept = hydrated.get(change.id);
-      const incoming = change.prevValue;
-      return kept && incoming?.__buoyValueOnDevice === true ? {
-        ...change,
-        prevValue: kept.prevValue,
-        nextValue: kept.nextValue
-      } : change;
-    });
-
-    // Preserve currentValue a remote mirror already hydrated — oversized
-    // atoms arrive as VALUE_ON_DEVICE markers on every snapshot.
-    const hydratedAtoms = new Map();
-    for (const [label, atom] of this.atoms) {
-      try {
-        const value = atom.getValue();
-        const marker = value;
-        if (!marker || marker.__buoyValueOnDevice !== true) {
-          hydratedAtoms.set(label, value);
-        }
-      } catch {
-        // ignore
-      }
-    }
-    this.atoms = new Map(atomSnapshots.map(snapshot => {
-      const incoming = snapshot.currentValue;
-      const kept = hydratedAtoms.get(snapshot.label);
-      const currentValue = kept !== undefined && incoming?.__buoyValueOnDevice === true ? kept : snapshot.currentValue;
-      return [snapshot.label, {
-        label: snapshot.label,
-        changeCount: snapshot.changeCount,
-        color: snapshot.color,
-        getValue: () => currentValue,
-        // No setValue: the mirror has no wire back to the device from
-        // this entry (yet) — the detail screen renders read-only there.
-        writeKind: snapshot.writeKind
-      }];
-    }));
-    this.setItems(merged);
-    this.notifyAtomListeners();
-  }
-
-  /**
-   * Hydrate one mirrored change with real values 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 atom's currentValue fetched on demand from the
-   * device via the adapter's `getAtomValue`. Remote-mirror (desktop) only.
-   */
-  hydrateAtomValue(label, currentValue) {
-    const atom = this.atoms.get(label);
-    if (!atom) return;
-    this.atoms.set(label, {
-      ...atom,
-      getValue: () => currentValue
-    });
-    this.notifyAtomListeners();
-  }
-
-  // ---- Atom Registry ----
-
-  registerAtom(label, getValue, setValue, writeKind) {
-    if (this.atoms.has(label)) return;
-    const atomInfo = {
-      label,
-      changeCount: 0,
-      color: getAtomColor(label),
-      getValue,
-      setValue,
-      writeKind
-    };
-    this.atoms.set(label, atomInfo);
-    this.notifyAtomListeners();
-  }
-
-  /**
-   * Write a value to a registered atom (remote write from the dashboard/MCP).
-   * Throws if the atom is unknown or read-only (derived atoms have no setter).
-   */
-  setAtomValue(label, value) {
-    const atom = this.atoms.get(label);
-    if (!atom) {
-      throw new Error(`Atom "${label}" is not registered`);
-    }
-    if (!atom.setValue) {
-      throw new Error(`Atom "${label}" is read-only (derived) — cannot set`);
-    }
-    atom.setValue(value);
-  }
-  unregisterAtom(label) {
-    this.atoms.delete(label);
-    this.notifyAtomListeners();
-  }
-  getAtoms() {
-    return Array.from(this.atoms.values());
-  }
-  getAtom(label) {
-    return this.atoms.get(label);
-  }
-  getAtomColor(label) {
-    return this.atoms.get(label)?.color ?? getAtomColor(label);
-  }
-
-  // ---- Filtering ----
-
-  filterAtomChanges(filter) {
-    let filtered = this.getAll();
-    if (filter.searchText) {
-      const search = filter.searchText.toLowerCase();
-      filtered = filtered.filter(c => c.atomLabel.toLowerCase().includes(search) || c.valuePreview.toLowerCase().includes(search) || c.changedKeys.some(k => k.toLowerCase().includes(search)));
-    }
-    if (filter.atomLabels && filter.atomLabels.length > 0) {
-      filtered = filtered.filter(c => filter.atomLabels.includes(c.atomLabel));
-    }
-    if (filter.onlyWithChanges) {
-      filtered = filtered.filter(c => c.hasValueChange);
-    }
-    return filtered;
-  }
-
-  // ---- Stats ----
-
-  getStats() {
-    const total = this.items.length;
-    const withChanges = this.items.filter(c => c.hasValueChange).length;
-    return {
-      totalChanges: total,
-      changesWithValueChange: withChanges,
-      changesWithoutValueChange: total - withChanges,
-      atomCount: this.atoms.size
-    };
-  }
-  getUniqueAtomLabels() {
-    return Array.from(this.atoms.keys()).sort();
-  }
-
-  // ---- Enable / Disable ----
-
-  setMaxChanges(max) {
-    this.setMax(max);
-  }
-
-  // ---- Subscriptions ----
-
-  subscribeToAtoms(listener) {
-    this.atomListeners.add(listener);
-    return () => this.atomListeners.delete(listener);
-  }
-  notifyAtomListeners() {
-    const atoms = this.getAtoms();
-    this.atomListeners.forEach(listener => listener(atoms));
-  }
-}
-export const jotaiStateStore = new JotaiStateStore();
+"use strict";import{ChangeLog as f,entityColor as d,formatValuePreview as C,shallowDiffSummary as y}from"@buoy-gg/shared-ui";const A={count:"#10B981",auth:"#8B5CF6",user:"#3B82F6",cart:"#EC4899",app:"#6366F1",ui:"#F59E0B",settings:"#14B8A6",theme:"#06B6D4",nav:"#F97316",form:"#EF4444",modal:"#A855F7",filter:"#84CC16"};function l(h){return d(h,A)}function V(h,t=40){return C(h,{maxLength:t,functionLabel:"(fn)"})}const w=y;class L extends f{atoms=new Map;atomListeners=new Set;addAtomChange(t){if(!this.canRecord())return;const{atomLabel:e,prevValue:s,nextValue:a,category:i="write"}=t;const o=s!==a;const{summary:n,changedKeys:r,changedCount:u}=w(s,a);const c=V(a);const g={id:this.nextId(),atomLabel:e,timestamp:Date.now(),prevValue:s,nextValue:a,hasValueChange:o,category:i,changedKeys:r,changedKeysCount:u,diffSummary:n,valuePreview:c,isSlowUpdate:false};this.push(g);const m=this.atoms.get(e);if(m){m.changeCount++}this.notifyListeners();this.notifyAtomListeners()}getAtomChanges(){return this.getAll()}getAtomChangeById(t){return this.getById(t)}clearAtomChanges(){for(const t of this.atoms.values()){t.changeCount=0}this.clear();this.notifyAtomListeners()}getAtomSnapshots(){return Array.from(this.atoms.values()).map(t=>{let e;try{e=t.getValue()}catch{e=void 0}return{label:t.label,changeCount:t.changeCount,color:t.color,currentValue:e,writeKind:t.writeKind}})}replaceFromSnapshot(t,e){if(!this.getEnabled())return;const s=new Map;for(const o of this.items){const n=o.prevValue;if(!n||n.__buoyValueOnDevice!==true){s.set(o.id,o)}}const a=t.slice(0,this.max).map(o=>{const n=s.get(o.id);const r=o.prevValue;return n&&r?.__buoyValueOnDevice===true?{...o,prevValue:n.prevValue,nextValue:n.nextValue}:o});const i=new Map;for(const[o,n]of this.atoms){try{const r=n.getValue();const u=r;if(!u||u.__buoyValueOnDevice!==true){i.set(o,r)}}catch{}}this.atoms=new Map(e.map(o=>{const n=o.currentValue;const r=i.get(o.label);const u=r!==void 0&&n?.__buoyValueOnDevice===true?r:o.currentValue;return[o.label,{label:o.label,changeCount:o.changeCount,color:o.color,getValue:()=>u,writeKind:o.writeKind}]}));this.setItems(a);this.notifyAtomListeners()}hydrateChange(t,e){this.hydrateById(t,e)}hydrateAtomValue(t,e){const s=this.atoms.get(t);if(!s)return;this.atoms.set(t,{...s,getValue:()=>e});this.notifyAtomListeners()}registerAtom(t,e,s,a){if(this.atoms.has(t))return;const i={label:t,changeCount:0,color:l(t),getValue:e,setValue:s,writeKind:a};this.atoms.set(t,i);this.notifyAtomListeners()}setAtomValue(t,e){const s=this.atoms.get(t);if(!s){throw new Error(`Atom "${t}" is not registered`)}if(!s.setValue){throw new Error(`Atom "${t}" is read-only (derived) \u2014 cannot set`)}s.setValue(e)}unregisterAtom(t){this.atoms.delete(t);this.notifyAtomListeners()}getAtoms(){return Array.from(this.atoms.values())}getAtom(t){return this.atoms.get(t)}getAtomColor(t){return this.atoms.get(t)?.color??l(t)}filterAtomChanges(t){let e=this.getAll();if(t.searchText){const s=t.searchText.toLowerCase();e=e.filter(a=>a.atomLabel.toLowerCase().includes(s)||a.valuePreview.toLowerCase().includes(s)||a.changedKeys.some(i=>i.toLowerCase().includes(s)))}if(t.atomLabels&&t.atomLabels.length>0){e=e.filter(s=>t.atomLabels.includes(s.atomLabel))}if(t.onlyWithChanges){e=e.filter(s=>s.hasValueChange)}return e}getStats(){const t=this.items.length;const e=this.items.filter(s=>s.hasValueChange).length;return{totalChanges:t,changesWithValueChange:e,changesWithoutValueChange:t-e,atomCount:this.atoms.size}}getUniqueAtomLabels(){return Array.from(this.atoms.keys()).sort()}setMaxChanges(t){this.setMax(t)}subscribeToAtoms(t){this.atomListeners.add(t);return()=>this.atomListeners.delete(t)}notifyAtomListeners(){const t=this.getAtoms();this.atomListeners.forEach(e=>e(t))}}export const jotaiStateStore=new L;

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

@@ -1,214 +1 @@
-"use strict";
-
-/**
- * Time Machine snapshot provider for Jotai.
- *
- * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
- * consumed by @buoy-gg/time-machine.
- *
- * Coverage is opt-in by nature: only atoms the app passed to `watchAtoms` /
- * `watchDefaultStoreAtoms` are visible. Derived (read-only) atoms are captured
- * for inspection but never restored — they recompute from their sources.
- * Caveat (documented): atoms with custom write functions (`atomWithReducer`)
- * receive ACTIONS through `store.set`, so restoring a raw value can misbehave;
- * nothing in the registry distinguishes them from plain atoms.
- */
-import { createRestoreScope, emptyRestoreResult, failedRestore, registerStateSnapshotProvider, unionKeys } from "@buoy-gg/shared-ui";
-import { boundedDeepEqual } from "@buoy-gg/shared-ui/dataViewer";
-import { jotaiStateStore } from "./jotaiStateStore";
-function status() {
-  const atoms = jotaiStateStore.getAtoms();
-  if (atoms.length === 0) {
-    return {
-      canCapture: false,
-      canRestore: false,
-      detail: "No Jotai atoms registered — pass your atoms to watchAtoms() / watchDefaultStoreAtoms()"
-    };
-  }
-  const writable = atoms.filter(a => a.setValue).length;
-  return {
-    canCapture: true,
-    canRestore: writable > 0,
-    detail: writable < atoms.length ? `${atoms.length - writable} derived atom(s) recompute automatically and are not restored` : undefined
-  };
-}
-async function capture() {
-  const warnings = [];
-  const atoms = {};
-  let derived = 0;
-  for (const info of jotaiStateStore.getAtoms()) {
-    try {
-      const value = info.getValue();
-      if (typeof value === "function") {
-        warnings.push(`atom "${info.label}": function value not capturable`);
-        continue;
-      }
-      if (!info.setValue) derived += 1;
-      atoms[info.label] = {
-        value,
-        writable: Boolean(info.setValue)
-      };
-    } catch (e) {
-      warnings.push(`atom "${info.label}": capture failed (${String(e)})`);
-    }
-  }
-  if (derived > 0) {
-    warnings.push(`${derived} derived atom(s) captured for inspection only (recompute on restore)`);
-  }
-  return {
-    data: {
-      atoms
-    },
-    warnings
-  };
-}
-async function restore(data, options) {
-  const snapshot = data;
-  const scope = createRestoreScope(options);
-  const result = emptyRestoreResult();
-  if (!snapshot?.atoms) {
-    return failedRestore("empty jotai snapshot");
-  }
-  let derived = 0;
-  for (const [label, entry] of Object.entries(snapshot.atoms)) {
-    if (!scope.allows(label)) continue;
-    if (!entry.writable) {
-      derived += 1;
-      continue;
-    }
-    const info = jotaiStateStore.getAtom(label);
-    if (!info) {
-      result.skipped.push({
-        id: label,
-        reason: "atom not registered (renamed, or unwatched since snapshot?)"
-      });
-      continue;
-    }
-    if (!info.setValue) {
-      result.skipped.push({
-        id: label,
-        reason: "atom is now read-only (derived)"
-      });
-      continue;
-    }
-    try {
-      info.setValue(entry.value);
-      result.applied += 1;
-    } catch (e) {
-      result.skipped.push({
-        id: label,
-        reason: String(e)
-      });
-      result.ok = false;
-    }
-  }
-  if (derived > 0) {
-    result.warnings.push(`${derived} derived atom(s) left to recompute`);
-  }
-  const excludedWarning = scope.excludedWarning("atom(s)");
-  if (excludedWarning) result.warnings.push(excludedWarning);
-  return result;
-}
-
-/** Per-atom restore preview. `base` omitted = compare against live atoms. */
-async function previewItems(target, base) {
-  const targetAtoms = target?.atoms ?? {};
-  const liveMode = base === undefined;
-  const baseAtoms = {};
-  if (liveMode) {
-    for (const info of jotaiStateStore.getAtoms()) {
-      try {
-        baseAtoms[info.label] = {
-          value: info.getValue(),
-          writable: Boolean(info.setValue)
-        };
-      } catch {
-        // unreadable atom — treated as absent
-      }
-    }
-  } else {
-    Object.assign(baseAtoms, base?.atoms ?? {});
-  }
-  const items = [];
-  const notes = [];
-  for (const label of unionKeys(baseAtoms, targetAtoms)) {
-    const inTarget = label in targetAtoms;
-    if (!inTarget) {
-      if (liveMode) notes.push(`atom "${label}" not in snapshot — untouched`);else items.push({
-        key: label,
-        label,
-        verdict: "removed",
-        oldValue: baseAtoms[label]?.value
-      });
-      continue;
-    }
-    const entry = targetAtoms[label];
-    const equal = label in baseAtoms && boundedDeepEqual(baseAtoms[label].value, entry.value);
-    if (!entry.writable) {
-      items.push({
-        key: label,
-        label,
-        verdict: equal ? "unchanged" : "recomputes",
-        reason: equal ? undefined : "derived atom — recomputes from its sources",
-        oldValue: baseAtoms[label]?.value,
-        newValue: entry.value
-      });
-      continue;
-    }
-    if (liveMode) {
-      const info = jotaiStateStore.getAtom(label);
-      if (!info) {
-        items.push({
-          key: label,
-          label,
-          verdict: "wont-apply",
-          reason: "atom not registered (renamed, or unwatched since snapshot?)"
-        });
-        continue;
-      }
-      if (!info.setValue) {
-        items.push({
-          key: label,
-          label,
-          verdict: "wont-apply",
-          reason: "atom is now read-only (derived)"
-        });
-        continue;
-      }
-    }
-    if (!(label in baseAtoms)) {
-      items.push({
-        key: label,
-        label,
-        verdict: "added",
-        newValue: entry.value
-      });
-    } else if (equal) {
-      items.push({
-        key: label,
-        label,
-        verdict: "unchanged"
-      });
-    } else {
-      items.push({
-        key: label,
-        label,
-        verdict: "changed",
-        oldValue: baseAtoms[label].value,
-        newValue: entry.value
-      });
-    }
-  }
-  return {
-    items,
-    notes
-  };
-}
-registerStateSnapshotProvider({
-  id: "jotai",
-  label: "Jotai",
-  status,
-  capture,
-  restore,
-  previewItems
-});
+"use strict";import{createRestoreScope as f,emptyRestoreResult as m,failedRestore as h,registerStateSnapshotProvider as v,unionKeys as g}from"@buoy-gg/shared-ui";import{boundedDeepEqual as y}from"@buoy-gg/shared-ui/dataViewer";import{jotaiStateStore as c}from"./jotaiStateStore";function w(){const o=c.getAtoms();if(o.length===0){return{canCapture:false,canRestore:false,detail:"No Jotai atoms registered \u2014 pass your atoms to watchAtoms() / watchDefaultStoreAtoms()"}}const i=o.filter(a=>a.setValue).length;return{canCapture:true,canRestore:i>0,detail:i<o.length?`${o.length-i} derived atom(s) recompute automatically and are not restored`:void 0}}async function b(){const o=[];const i={};let a=0;for(const n of c.getAtoms()){try{const t=n.getValue();if(typeof t==="function"){o.push(`atom "${n.label}": function value not capturable`);continue}if(!n.setValue)a+=1;i[n.label]={value:t,writable:Boolean(n.setValue)}}catch(t){o.push(`atom "${n.label}": capture failed (${String(t)})`)}}if(a>0){o.push(`${a} derived atom(s) captured for inspection only (recompute on restore)`)}return{data:{atoms:i},warnings:o}}async function V(o,i){const a=o;const n=f(i);const t=m();if(!a?.atoms){return h("empty jotai snapshot")}let s=0;for(const[e,d]of Object.entries(a.atoms)){if(!n.allows(e))continue;if(!d.writable){s+=1;continue}const r=c.getAtom(e);if(!r){t.skipped.push({id:e,reason:"atom not registered (renamed, or unwatched since snapshot?)"});continue}if(!r.setValue){t.skipped.push({id:e,reason:"atom is now read-only (derived)"});continue}try{r.setValue(d.value);t.applied+=1}catch(l){t.skipped.push({id:e,reason:String(l)});t.ok=false}}if(s>0){t.warnings.push(`${s} derived atom(s) left to recompute`)}const u=n.excludedWarning("atom(s)");if(u)t.warnings.push(u);return t}async function k(o,i){const a=o?.atoms??{};const n=i===void 0;const t={};if(n){for(const e of c.getAtoms()){try{t[e.label]={value:e.getValue(),writable:Boolean(e.setValue)}}catch{}}}else{Object.assign(t,i?.atoms??{})}const s=[];const u=[];for(const e of g(t,a)){const d=e in a;if(!d){if(n)u.push(`atom "${e}" not in snapshot \u2014 untouched`);else s.push({key:e,label:e,verdict:"removed",oldValue:t[e]?.value});continue}const r=a[e];const l=e in t&&y(t[e].value,r.value);if(!r.writable){s.push({key:e,label:e,verdict:l?"unchanged":"recomputes",reason:l?void 0:"derived atom \u2014 recomputes from its sources",oldValue:t[e]?.value,newValue:r.value});continue}if(n){const p=c.getAtom(e);if(!p){s.push({key:e,label:e,verdict:"wont-apply",reason:"atom not registered (renamed, or unwatched since snapshot?)"});continue}if(!p.setValue){s.push({key:e,label:e,verdict:"wont-apply",reason:"atom is now read-only (derived)"});continue}}if(!(e in t)){s.push({key:e,label:e,verdict:"added",newValue:r.value})}else if(l){s.push({key:e,label:e,verdict:"unchanged"})}else{s.push({key:e,label:e,verdict:"changed",oldValue:t[e].value,newValue:r.value})}}return{items:s,notes:u}}v({id:"jotai",label:"Jotai",status:w,capture:b,restore:V,previewItems:k});

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

@@ -1,82 +1 @@
-"use strict";
-
-/**
- * Jotai tool test handles.
- *
- * Every tappable and every value the e2e suite reads back is addressed
- * `buoy-jotai-<thing>`. Two rules need explaining, and the second is the one
- * this tool does not share with any other.
- *
- * **A change row's handle carries an ORDINAL, and it counts per ATOM.** Same
- * reason as the Zustand tool: an atom a screen writes to fifty times produces
- * fifty separate, equally real rows, and addressing them by label alone would
- * give fifty views one handle — Detox fails a *matcher* that hits more than
- * one element, so the suite would break on `toExist()` before any assertion,
- * with an error that says nothing about duplicate changes. The handle is
- * `buoy-jotai-row-<slug(atomLabel)>-<n>`, n counting back from the newest row
- * for that atom (1 = newest). Deliberately relative: an atom change has no
- * identity a host could know in advance, and what a test CAN know is "the
- * write I just fired is the newest change to that atom". Read and tap in one
- * beat — a row's ordinal moves the instant another change lands.
- *
- * **The ordinal is per ATOM, and one write can move several atoms.** This is
- * where jotai differs from every store-shaped tool. Atoms form a dependency
- * graph, and this tool watches NODES: a single `set` on a primitive atom
- * notifies every mounted derived atom whose value actually moved, so one
- * press can add a row under three different labels — and add nothing at all
- * under a fourth whose recomputed value happened to be unchanged. Counting
- * ordinals across the whole list would make a row's handle depend on how many
- * *other* atoms the write happened to touch, which is exactly the thing a
- * test of a graph must not assume.
- *
- * **An atom row's handle does NOT carry an ordinal.** An atom is registered
- * once under a label that is unique by construction
- * (`jotaiStateStore.registerAtom` returns early on a label it already holds,
- * and `watchAtoms` marks the atom with a per-label symbol), so
- * `buoy-jotai-atom-<slug(label)>` is as stable as the registration 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/
- * jotaiBench.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 JOTAI_TEST_ID = "buoy-jotai";
-
-/** `jbenchCount` → `jbenchcount`. 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-jotai-row-jbenchcount-1`.
- *
- * `ordinal` is 1-based and counts back from the newest row for this atom.
- */
-export function changeRowTestID(atomLabel, ordinal) {
-  return `${JOTAI_TEST_ID}-row-${slugForTestID(atomLabel)}-${ordinal}`;
-}
-
-/** Handle for one atom row in the browser: `buoy-jotai-atom-jbenchcount`. */
-export function atomRowTestID(atomLabel) {
-  return `${JOTAI_TEST_ID}-atom-${slugForTestID(atomLabel)}`;
-}
-
-/**
- * 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.atomLabel) ?? 0) + 1;
-    seen.set(change.atomLabel, ordinal);
-    handles.set(change.id, changeRowTestID(change.atomLabel, ordinal));
-  }
-  return handles;
-}
+"use strict";export const JOTAI_TEST_ID="buoy-jotai";export function slugForTestID(t){return String(t??"").toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}export function changeRowTestID(t,e){return`${JOTAI_TEST_ID}-row-${slugForTestID(t)}-${e}`}export function atomRowTestID(t){return`${JOTAI_TEST_ID}-atom-${slugForTestID(t)}`}export function buildChangeRowTestIDs(t){const e=new Map;const n=new Map;for(const o of t){const r=(e.get(o.atomLabel)??0)+1;e.set(o.atomLabel,r);n.set(o.id,changeRowTestID(o.atomLabel,r))}return n}