@buoy-gg/jotai 7.0.40 → 7.0.42

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

@@ -1,321 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.jotaiStateStore = void 0;
-var _sharedUi = require("@buoy-gg/shared-ui");
-/**
- * Jotai state store — captures and stores Jotai atom changes
- *
- * Mirrors the architecture of zustandStateStore.ts from @buoy-gg/zustand
- */
-
-// ============================================
-// 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 (0, _sharedUi.entityColor)(label, ATOM_COLORS);
-}
-
-// ============================================
-// Helper Functions
-// ============================================
-
-function formatValuePreview(value, maxLength = 40) {
-  return (0, _sharedUi.formatValuePreview)(value, {
-    maxLength,
-    functionLabel: "(fn)"
-  });
-}
-const getValueDiffSummary = _sharedUi.shallowDiffSummary;
-
-// ============================================
-// Jotai State Store
-// ============================================
-
-class JotaiStateStore extends _sharedUi.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));
-  }
-}
-const jotaiStateStore = exports.jotaiStateStore = new JotaiStateStore();
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.jotaiStateStore=void 0;var _sharedUi=require("@buoy-gg/shared-ui");const ATOM_COLORS={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 getAtomColor(h){return(0,_sharedUi.entityColor)(h,ATOM_COLORS)}function formatValuePreview(h,t=40){return(0,_sharedUi.formatValuePreview)(h,{maxLength:t,functionLabel:"(fn)"})}const getValueDiffSummary=_sharedUi.shallowDiffSummary;class JotaiStateStore extends _sharedUi.ChangeLog{atoms=new Map;atomListeners=new Set;addAtomChange(t){if(!this.canRecord())return;const{atomLabel:e,prevValue:o,nextValue:a,category:i="write"}=t;const s=o!==a;const{summary:r,changedKeys:n,changedCount:u}=getValueDiffSummary(o,a);const l=formatValuePreview(a);const c={id:this.nextId(),atomLabel:e,timestamp:Date.now(),prevValue:o,nextValue:a,hasValueChange:s,category:i,changedKeys:n,changedKeysCount:u,diffSummary:r,valuePreview:l,isSlowUpdate:false};this.push(c);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 o=new Map;for(const s of this.items){const r=s.prevValue;if(!r||r.__buoyValueOnDevice!==true){o.set(s.id,s)}}const a=t.slice(0,this.max).map(s=>{const r=o.get(s.id);const n=s.prevValue;return r&&n?.__buoyValueOnDevice===true?{...s,prevValue:r.prevValue,nextValue:r.nextValue}:s});const i=new Map;for(const[s,r]of this.atoms){try{const n=r.getValue();const u=n;if(!u||u.__buoyValueOnDevice!==true){i.set(s,n)}}catch{}}this.atoms=new Map(e.map(s=>{const r=s.currentValue;const n=i.get(s.label);const u=n!==void 0&&r?.__buoyValueOnDevice===true?n:s.currentValue;return[s.label,{label:s.label,changeCount:s.changeCount,color:s.color,getValue:()=>u,writeKind:s.writeKind}]}));this.setItems(a);this.notifyAtomListeners()}hydrateChange(t,e){this.hydrateById(t,e)}hydrateAtomValue(t,e){const o=this.atoms.get(t);if(!o)return;this.atoms.set(t,{...o,getValue:()=>e});this.notifyAtomListeners()}registerAtom(t,e,o,a){if(this.atoms.has(t))return;const i={label:t,changeCount:0,color:getAtomColor(t),getValue:e,setValue:o,writeKind:a};this.atoms.set(t,i);this.notifyAtomListeners()}setAtomValue(t,e){const o=this.atoms.get(t);if(!o){throw new Error(`Atom "${t}" is not registered`)}if(!o.setValue){throw new Error(`Atom "${t}" is read-only (derived) \u2014 cannot set`)}o.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??getAtomColor(t)}filterAtomChanges(t){let e=this.getAll();if(t.searchText){const o=t.searchText.toLowerCase();e=e.filter(a=>a.atomLabel.toLowerCase().includes(o)||a.valuePreview.toLowerCase().includes(o)||a.changedKeys.some(i=>i.toLowerCase().includes(o)))}if(t.atomLabels&&t.atomLabels.length>0){e=e.filter(o=>t.atomLabels.includes(o.atomLabel))}if(t.onlyWithChanges){e=e.filter(o=>o.hasValueChange)}return e}getStats(){const t=this.items.length;const e=this.items.filter(o=>o.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))}}const jotaiStateStore=exports.jotaiStateStore=new JotaiStateStore;

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

@@ -1,215 +1 @@
-"use strict";
-
-var _sharedUi = require("@buoy-gg/shared-ui");
-var _dataViewer = require("@buoy-gg/shared-ui/dataViewer");
-var _jotaiStateStore = require("./jotaiStateStore");
-/**
- * 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.
- */
-
-function status() {
-  const atoms = _jotaiStateStore.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.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 = (0, _sharedUi.createRestoreScope)(options);
-  const result = (0, _sharedUi.emptyRestoreResult)();
-  if (!snapshot?.atoms) {
-    return (0, _sharedUi.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.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.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 (0, _sharedUi.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 && (0, _dataViewer.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.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
-  };
-}
-(0, _sharedUi.registerStateSnapshotProvider)({
-  id: "jotai",
-  label: "Jotai",
-  status,
-  capture,
-  restore,
-  previewItems
-});
+"use strict";var _sharedUi=require("@buoy-gg/shared-ui");var _dataViewer=require("@buoy-gg/shared-ui/dataViewer");var _jotaiStateStore=require("./jotaiStateStore");function status(){const o=_jotaiStateStore.jotaiStateStore.getAtoms();if(o.length===0){return{canCapture:false,canRestore:false,detail:"No Jotai atoms registered \u2014 pass your atoms to watchAtoms() / watchDefaultStoreAtoms()"}}const r=o.filter(n=>n.setValue).length;return{canCapture:true,canRestore:r>0,detail:r<o.length?`${o.length-r} derived atom(s) recompute automatically and are not restored`:void 0}}async function capture(){const o=[];const r={};let n=0;for(const a of _jotaiStateStore.jotaiStateStore.getAtoms()){try{const t=a.getValue();if(typeof t==="function"){o.push(`atom "${a.label}": function value not capturable`);continue}if(!a.setValue)n+=1;r[a.label]={value:t,writable:Boolean(a.setValue)}}catch(t){o.push(`atom "${a.label}": capture failed (${String(t)})`)}}if(n>0){o.push(`${n} derived atom(s) captured for inspection only (recompute on restore)`)}return{data:{atoms:r},warnings:o}}async function restore(o,r){const n=o;const a=(0,_sharedUi.createRestoreScope)(r);const t=(0,_sharedUi.emptyRestoreResult)();if(!n?.atoms){return(0,_sharedUi.failedRestore)("empty jotai snapshot")}let s=0;for(const[e,c]of Object.entries(n.atoms)){if(!a.allows(e))continue;if(!c.writable){s+=1;continue}const i=_jotaiStateStore.jotaiStateStore.getAtom(e);if(!i){t.skipped.push({id:e,reason:"atom not registered (renamed, or unwatched since snapshot?)"});continue}if(!i.setValue){t.skipped.push({id:e,reason:"atom is now read-only (derived)"});continue}try{i.setValue(c.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=a.excludedWarning("atom(s)");if(u)t.warnings.push(u);return t}async function previewItems(o,r){const n=o?.atoms??{};const a=r===void 0;const t={};if(a){for(const e of _jotaiStateStore.jotaiStateStore.getAtoms()){try{t[e.label]={value:e.getValue(),writable:Boolean(e.setValue)}}catch{}}}else{Object.assign(t,r?.atoms??{})}const s=[];const u=[];for(const e of(0,_sharedUi.unionKeys)(t,n)){const c=e in n;if(!c){if(a)u.push(`atom "${e}" not in snapshot \u2014 untouched`);else s.push({key:e,label:e,verdict:"removed",oldValue:t[e]?.value});continue}const i=n[e];const l=e in t&&(0,_dataViewer.boundedDeepEqual)(t[e].value,i.value);if(!i.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:i.value});continue}if(a){const d=_jotaiStateStore.jotaiStateStore.getAtom(e);if(!d){s.push({key:e,label:e,verdict:"wont-apply",reason:"atom not registered (renamed, or unwatched since snapshot?)"});continue}if(!d.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:i.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:i.value})}}return{items:s,notes:u}}(0,_sharedUi.registerStateSnapshotProvider)({id:"jotai",label:"Jotai",status,capture,restore,previewItems});

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

@@ -1,90 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.JOTAI_TEST_ID = void 0;
-exports.atomRowTestID = atomRowTestID;
-exports.buildChangeRowTestIDs = buildChangeRowTestIDs;
-exports.changeRowTestID = changeRowTestID;
-exports.slugForTestID = slugForTestID;
-/**
- * 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. */
-const JOTAI_TEST_ID = exports.JOTAI_TEST_ID = "buoy-jotai";
-
-/** `jbenchCount` → `jbenchcount`. Shared with every Buoy tool. */
-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.
- */
-function changeRowTestID(atomLabel, ordinal) {
-  return `${JOTAI_TEST_ID}-row-${slugForTestID(atomLabel)}-${ordinal}`;
-}
-
-/** Handle for one atom row in the browser: `buoy-jotai-atom-jbenchcount`. */
-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.
- */
-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";Object.defineProperty(exports,"__esModule",{value:true});exports.JOTAI_TEST_ID=void 0;exports.atomRowTestID=atomRowTestID;exports.buildChangeRowTestIDs=buildChangeRowTestIDs;exports.changeRowTestID=changeRowTestID;exports.slugForTestID=slugForTestID;const JOTAI_TEST_ID=exports.JOTAI_TEST_ID="buoy-jotai";function slugForTestID(e){return String(e??"").toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function changeRowTestID(e,t){return`${JOTAI_TEST_ID}-row-${slugForTestID(e)}-${t}`}function atomRowTestID(e){return`${JOTAI_TEST_ID}-atom-${slugForTestID(e)}`}function buildChangeRowTestIDs(e){const t=new Map;const n=new Map;for(const o of e){const s=(t.get(o.atomLabel)??0)+1;t.set(o.atomLabel,s);n.set(o.id,changeRowTestID(o.atomLabel,s))}return n}