@buoy-gg/jotai 7.0.40 → 7.0.42

package/lib/commonjs/jotai/hooks/useJotaiAtomChanges.js

@@ -1,69 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useJotaiAtomChanges = useJotaiAtomChanges;
-var _react = require("react");
-var _sharedUi = require("@buoy-gg/shared-ui");
-var _jotaiStateStore = require("../utils/jotaiStateStore");
-/**
- * Hook for consuming Jotai atom changes from the store
- *
- * The subscribe / filter / pause / clear plumbing is shared `useChangeLog`;
- * this file owns the jotai-specific filter, stats and atom registry.
- */
-
-function filterChanges(changes, filter) {
-  let filtered = changes;
-  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;
-}
-const readAtoms = () => _jotaiStateStore.jotaiStateStore.getAtoms();
-const subscribeToAtoms = listener => _jotaiStateStore.jotaiStateStore.subscribeToAtoms(listener);
-function useJotaiAtomChanges() {
-  const log = (0, _sharedUi.useChangeLog)(_jotaiStateStore.jotaiStateStore, {
-    filterItems: filterChanges
-  });
-  const atoms = (0, _sharedUi.useSubscribedValue)(readAtoms, subscribeToAtoms);
-  const stats = (0, _react.useMemo)(() => {
-    const total = log.items.length;
-    const withChanges = log.items.filter(c => c.hasValueChange).length;
-    return {
-      totalChanges: total,
-      changesWithValueChange: withChanges,
-      changesWithoutValueChange: total - withChanges,
-      atomCount: atoms.length
-    };
-  }, [log.items, atoms]);
-  const atomLabels = (0, _react.useMemo)(() => {
-    return _jotaiStateStore.jotaiStateStore.getUniqueAtomLabels();
-  }, [atoms]);
-  const getChangeById = (0, _react.useCallback)(id => {
-    return _jotaiStateStore.jotaiStateStore.getAtomChangeById(id);
-  }, []);
-  return {
-    atomChanges: log.items,
-    filteredChanges: log.filteredItems,
-    filter: log.filter,
-    setFilter: log.setFilter,
-    stats,
-    atoms,
-    // Not the shared log.clear: the store also owns each atom's change
-    // count, and only clearAtomChanges resets those with the list.
-    clearChanges: _jotaiStateStore.jotaiStateStore.clearAtomChanges.bind(_jotaiStateStore.jotaiStateStore),
-    isEnabled: log.isEnabled,
-    toggleCapture: log.toggleCapture,
-    atomLabels,
-    getChangeById
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useJotaiAtomChanges=useJotaiAtomChanges;var _react=require("react");var _sharedUi=require("@buoy-gg/shared-ui");var _jotaiStateStore=require("../utils/jotaiStateStore");function filterChanges(e,t){let a=e;if(t.searchText){const s=t.searchText.toLowerCase();a=a.filter(r=>r.atomLabel.toLowerCase().includes(s)||r.valuePreview.toLowerCase().includes(s)||r.changedKeys.some(o=>o.toLowerCase().includes(s)))}if(t.atomLabels&&t.atomLabels.length>0){a=a.filter(s=>t.atomLabels.includes(s.atomLabel))}if(t.onlyWithChanges){a=a.filter(s=>s.hasValueChange)}return a}const readAtoms=()=>_jotaiStateStore.jotaiStateStore.getAtoms();const subscribeToAtoms=e=>_jotaiStateStore.jotaiStateStore.subscribeToAtoms(e);function useJotaiAtomChanges(){const e=(0,_sharedUi.useChangeLog)(_jotaiStateStore.jotaiStateStore,{filterItems:filterChanges});const t=(0,_sharedUi.useSubscribedValue)(readAtoms,subscribeToAtoms);const a=(0,_react.useMemo)(()=>{const o=e.items.length;const n=e.items.filter(i=>i.hasValueChange).length;return{totalChanges:o,changesWithValueChange:n,changesWithoutValueChange:o-n,atomCount:t.length}},[e.items,t]);const s=(0,_react.useMemo)(()=>{return _jotaiStateStore.jotaiStateStore.getUniqueAtomLabels()},[t]);const r=(0,_react.useCallback)(o=>{return _jotaiStateStore.jotaiStateStore.getAtomChangeById(o)},[]);return{atomChanges:e.items,filteredChanges:e.filteredItems,filter:e.filter,setFilter:e.setFilter,stats:a,atoms:t,clearChanges:_jotaiStateStore.jotaiStateStore.clearAtomChanges.bind(_jotaiStateStore.jotaiStateStore),isEnabled:e.isEnabled,toggleCapture:e.toggleCapture,atomLabels:s,getChangeById:r}}

package/lib/commonjs/jotai/sync/jotaiSyncAdapter.js

@@ -1,306 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.jotaiSyncAdapter = exports.VALUE_ON_DEVICE = void 0;
-var _jotaiStateStore = require("../utils/jotaiStateStore");
-var _sharedUi = require("@buoy-gg/shared-ui");
-/**
- * Sentinel used in WIRE-FORM snapshots in place of raw prevValue/nextValue.
- * Same hazard as redux/zustand: up to 200 changes × 2 values on every
- * snapshot. Dashboards fetch values via `getChangeDetail`.
- */
-const VALUE_ON_DEVICE = exports.VALUE_ON_DEVICE = (0, _sharedUi.onDeviceMarker)("Value", "Atom values stay on the device — fetched on demand via getChangeDetail / getAtomValue.");
-const isPlainObj = v => !!v && typeof v === "object" && !Array.isArray(v);
-
-/**
- * Merge a patch into an atom's value.
- *
- * An atom is not always an object — plenty hold a number, a string or a list —
- * so a merge only means anything when BOTH sides are plain objects. Anything
- * else replaces, which is what a caller asking to merge a scalar can only have
- * meant. Arrays replace too: the id-addressed form has already been expanded to
- * a whole array by the time this runs, so merging element-wise here would undo
- * the deletion half of that expansion.
- */
-function deepMergeInto(base, patch) {
-  if (!isPlainObj(base) || !isPlainObj(patch)) return patch;
-  const out = {
-    ...base
-  };
-  for (const [k, v] of Object.entries(patch)) out[k] = k in base ? deepMergeInto(base[k], v) : v;
-  return out;
-}
-
-/**
- * Does this patch write into the list at `path`? Only then is an
- * unchecked-shape warning about that list worth saying.
- */
-function touchesList(patch, path) {
-  let cur = patch;
-  for (const seg of path.split(".")) {
-    if (!isPlainObj(cur)) return false;
-    if (!(seg in cur)) return false;
-    cur = cur[seg];
-  }
-  return Array.isArray(cur) ? cur.length > 0 : !!cur && typeof cur === "object";
-}
-
-/**
- * Per-change wire cache — the store prepends and never mutates a recorded
- * change, so identity is a correct, self-invalidating key.
- */
-const toWireChange = (0, _sharedUi.memoByIdentity)(change => ({
-  ...change,
-  prevValue: VALUE_ON_DEVICE,
-  nextValue: VALUE_ON_DEVICE
-}));
-const toWireValue = value => (0, _sharedUi.toWire)(value, VALUE_ON_DEVICE);
-
-/**
- * Sync adapter for the jotai tool, consumed by @buoy-gg/external-sync's
- * `useExternalSync`.
- *
- * Atom changes are captured by watchAtoms(), independent of whether a
- * dashboard is watching — subscribing here only streams what the store
- * already records. The snapshot carries both the change timeline and the
- * atom registry (with each atom's current value) so the dashboard can render
- * the atom browser.
- *
- * v2: change-log prevValue/nextValue are replaced with on-device markers.
- * Dashboards fetch values via `getChangeDetail`. Oversized / unserializable
- * `atoms[].currentValue` uses the same marker and is fetched via `getAtomValue`.
- */
-const jotaiSyncAdapter = exports.jotaiSyncAdapter = (0, _sharedUi.createSyncAdapter)({
-  version: 2,
-  getSnapshot: () => ({
-    changes: _jotaiStateStore.jotaiStateStore.getAtomChanges().map(toWireChange),
-    atoms: _jotaiStateStore.jotaiStateStore.getAtomSnapshots().map(atom => ({
-      ...atom,
-      currentValue: toWireValue(atom.currentValue)
-    }))
-  }),
-  subscribe: [onChange => _jotaiStateStore.jotaiStateStore.subscribe(onChange), onChange => _jotaiStateStore.jotaiStateStore.subscribeToAtoms(onChange)],
-  actions: {
-    clearEvents: () => {
-      _jotaiStateStore.jotaiStateStore.clearAtomChanges();
-    },
-    /**
-     * On-demand detail: one change's real prevValue/nextValue.
-     * The per-snapshot stream stays value-free; this is the explicit,
-     * size-guarded channel for the detail pane.
-     */
-    getChangeDetail: (0, _sharedUi.detailByIdAction)(id => _jotaiStateStore.jotaiStateStore.getAtomChangeById(id), (change, cap) => ({
-      prevValue: cap(change.prevValue),
-      nextValue: cap(change.nextValue)
-    })),
-    /**
-     * On-demand current value for one atom. Wire-form snapshots replace
-     * oversized / unserializable `currentValue` with VALUE_ON_DEVICE.
-     */
-    getAtomValue: params => {
-      const {
-        label,
-        path
-      } = (0, _sharedUi.readParams)(params);
-      if (!label) return {
-        found: false,
-        reason: "missing label"
-      };
-      const atom = _jotaiStateStore.jotaiStateStore.getAtom(label);
-      if (!atom) return {
-        found: false,
-        reason: "unknown label"
-      };
-      let currentValue;
-      try {
-        currentValue = atom.getValue();
-      } catch {
-        currentValue = undefined;
-      }
-      try {
-        JSON.stringify(currentValue);
-      } catch {
-        return {
-          found: true,
-          label,
-          currentValue: VALUE_ON_DEVICE
-        };
-      }
-      // One slice instead of the whole atom, when asked. The reason to want it
-      // is the engine's 24,000-character result cap: a caller that never saw the
-      // field it means to edit is left inventing a shape.
-      if (path) {
-        const at = (0, _sharedUi.readPath)(currentValue, path);
-        if (!at.ok) return {
-          found: false,
-          reason: at.error
-        };
-        return {
-          found: true,
-          label,
-          path,
-          shape: (0, _sharedUi.shapeSummary)(at.value),
-          currentValue: at.value
-        };
-      }
-      // `shape` BEFORE `currentValue`: a result is truncated by slicing the
-      // encoded string, so what is serialised first is what survives the cut,
-      // and the sketch does not grow with the data.
-      return {
-        found: true,
-        label,
-        ...((0, _sharedUi.shapeSummary)(currentValue) ? {
-          shape: (0, _sharedUi.shapeSummary)(currentValue)
-        } : {}),
-        currentValue: (0, _sharedUi.capDetail)(currentValue, _sharedUi.WIRE_DETAIL_LIMIT_BYTES)
-      };
-    },
-    /**
-     * Compact current-value reader for a remote driver (MCP/LLM): registered
-     * atoms with light metadata; each atom's `currentValue` stays on the device
-     * unless `includeValues` is set. `writable` tells the caller which atoms
-     * can be set via `setAtom`.
-     */
-    listAtoms: params => {
-      const {
-        includeValues = false,
-        limit
-      } = (0, _sharedUi.readParams)(params);
-      const all = _jotaiStateStore.jotaiStateStore.getAtoms();
-      const capped = typeof limit === "number" && limit > 0 ? all.slice(0, limit) : all;
-      const atoms = capped.map(a => {
-        let value;
-        if (includeValues) {
-          try {
-            value = a.getValue();
-          } catch {
-            value = undefined;
-          }
-        }
-        // The compact view is what a caller reaches for precisely because it
-        // does not want the data; the item shape of a list is the one thing it
-        // cannot infer without it, and it costs a line.
-        let shape;
-        try {
-          shape = (0, _sharedUi.shapeSummary)(a.getValue());
-        } catch {
-          shape = undefined;
-        }
-        return {
-          label: a.label,
-          changes: a.changeCount,
-          writable: typeof a.setValue === "function",
-          ...(shape ? {
-            shape
-          } : {}),
-          ...(includeValues ? {
-            currentValue: value
-          } : {})
-        };
-      });
-      return {
-        atoms,
-        total: all.length,
-        returned: atoms.length,
-        includedValues: includeValues
-      };
-    },
-    /**
-     * Write to a writable atom (throws for unknown/read-only atoms).
-     *
-     * THIS USED TO BE FOUR LINES WITH NO GUARD. `setAtom` took whatever it was
-     * given and wrote it: a string over a number, `null` over a list the screen
-     * maps, a one-item array over a fifty-item one — every failure mode the
-     * zustand and react-query adapters refuse, jotai accepted silently. It was
-     * the only writable state tool with no protection at all, and it had never
-     * had an eval case, so nothing had ever measured it.
-     *
-     * It now takes the same three forms as `zustand.setState`, backed by the
-     * same shared implementations:
-     *   { value }                    replace (guarded unless force)
-     *   { value, merge: true }       merge a patch, id-addressed lists allowed
-     *   { path, value }              set one value; no depth to get wrong
-     */
-    setAtom: params => {
-      const {
-        label,
-        value,
-        merge,
-        path,
-        force
-      } = (0, _sharedUi.readParams)(params);
-      if (!label) throw new Error("setAtom requires a `label`");
-      const atom = _jotaiStateStore.jotaiStateStore.getAtom(label);
-      let current;
-      try {
-        current = atom?.getValue();
-      } catch {
-        current = undefined;
-      }
-
-      // A replace with no guard is the old behaviour; keep it reachable via
-      // `force`, and keep it the ONLY way to get it.
-      let effective = value;
-      let keyedNotes = [];
-      let unchecked = [];
-      const merging = merge === true || path !== undefined;
-      if (path !== undefined) {
-        if (value === undefined) {
-          return {
-            ok: false,
-            error: `Refused: sent \`path\` without \`value\`. Say what to set "${path}" to.`
-          };
-        }
-        const built = (0, _sharedUi.patchFromPath)(current, path, value);
-        if (!built.ok) return {
-          ok: false,
-          error: `Refused: ${built.error}`
-        };
-        effective = built.patch;
-      }
-      if (!force && merging && current !== undefined) {
-        const expanded = (0, _sharedUi.expandKeyedArrays)(current, effective);
-        // See keyedArrays.ts: an added item whose id disagrees with the key it
-        // was sent under is ambiguous, and only this layer can say so.
-        if (expanded.error) {
-          return {
-            ok: false,
-            error: `Refused: ${expanded.error}`
-          };
-        }
-        effective = expanded.patch;
-        keyedNotes = expanded.notes;
-        unchecked = (0, _sharedUi.unshapedLists)(current).filter(p => touchesList(effective, p));
-        const violations = (0, _sharedUi.typedEditViolations)(current, effective, {
-          noun: "atom"
-        });
-        if (violations.length) {
-          const suggestion = (0, _sharedUi.suggestedPatch)(effective, violations);
-          return {
-            ok: false,
-            error: (0, _sharedUi.refusalText)(violations, "atom", suggestion),
-            violations,
-            ...(suggestion ? {
-              suggestedValue: suggestion
-            } : {})
-          };
-        }
-      }
-      _jotaiStateStore.jotaiStateStore.setAtomValue(label, merging ? deepMergeInto(current, effective) : effective);
-      return {
-        ok: true,
-        ...(path !== undefined ? {
-          path
-        } : {}),
-        ...(keyedNotes.length ? {
-          keyed: keyedNotes
-        } : {}),
-        ...(unchecked.length ? {
-          unchecked: unchecked.map(p => `\`${p}\` was empty, so nothing knows what its items look like and the shape of what you added was NOT checked.`)
-        } : {})
-      };
-    }
-  }
-});
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.jotaiSyncAdapter=exports.VALUE_ON_DEVICE=void 0;var _jotaiStateStore=require("../utils/jotaiStateStore");var _sharedUi=require("@buoy-gg/shared-ui");const VALUE_ON_DEVICE=exports.VALUE_ON_DEVICE=(0,_sharedUi.onDeviceMarker)("Value","Atom values stay on the device \u2014 fetched on demand via getChangeDetail / getAtomValue.");const isPlainObj=e=>!!e&&typeof e==="object"&&!Array.isArray(e);function deepMergeInto(e,r){if(!isPlainObj(e)||!isPlainObj(r))return r;const t={...e};for(const[o,a]of Object.entries(r))t[o]=o in e?deepMergeInto(e[o],a):a;return t}function touchesList(e,r){let t=e;for(const o of r.split(".")){if(!isPlainObj(t))return false;if(!(o in t))return false;t=t[o]}return Array.isArray(t)?t.length>0:!!t&&typeof t==="object"}const toWireChange=(0,_sharedUi.memoByIdentity)(e=>({...e,prevValue:VALUE_ON_DEVICE,nextValue:VALUE_ON_DEVICE}));const toWireValue=e=>(0,_sharedUi.toWire)(e,VALUE_ON_DEVICE);const jotaiSyncAdapter=exports.jotaiSyncAdapter=(0,_sharedUi.createSyncAdapter)({version:2,getSnapshot:()=>({changes:_jotaiStateStore.jotaiStateStore.getAtomChanges().map(toWireChange),atoms:_jotaiStateStore.jotaiStateStore.getAtomSnapshots().map(e=>({...e,currentValue:toWireValue(e.currentValue)}))}),subscribe:[e=>_jotaiStateStore.jotaiStateStore.subscribe(e),e=>_jotaiStateStore.jotaiStateStore.subscribeToAtoms(e)],actions:{clearEvents:()=>{_jotaiStateStore.jotaiStateStore.clearAtomChanges()},getChangeDetail:(0,_sharedUi.detailByIdAction)(e=>_jotaiStateStore.jotaiStateStore.getAtomChangeById(e),(e,r)=>({prevValue:r(e.prevValue),nextValue:r(e.nextValue)})),getAtomValue:e=>{const{label:r,path:t}=(0,_sharedUi.readParams)(e);if(!r)return{found:false,reason:"missing label"};const o=_jotaiStateStore.jotaiStateStore.getAtom(r);if(!o)return{found:false,reason:"unknown label"};let a;try{a=o.getValue()}catch{a=void 0}try{JSON.stringify(a)}catch{return{found:true,label:r,currentValue:VALUE_ON_DEVICE}}if(t){const i=(0,_sharedUi.readPath)(a,t);if(!i.ok)return{found:false,reason:i.error};return{found:true,label:r,path:t,shape:(0,_sharedUi.shapeSummary)(i.value),currentValue:i.value}}return{found:true,label:r,...(0,_sharedUi.shapeSummary)(a)?{shape:(0,_sharedUi.shapeSummary)(a)}:{},currentValue:(0,_sharedUi.capDetail)(a,_sharedUi.WIRE_DETAIL_LIMIT_BYTES)}},listAtoms:e=>{const{includeValues:r=false,limit:t}=(0,_sharedUi.readParams)(e);const o=_jotaiStateStore.jotaiStateStore.getAtoms();const a=typeof t==="number"&&t>0?o.slice(0,t):o;const i=a.map(l=>{let s;if(r){try{s=l.getValue()}catch{s=void 0}}let n;try{n=(0,_sharedUi.shapeSummary)(l.getValue())}catch{n=void 0}return{label:l.label,changes:l.changeCount,writable:typeof l.setValue==="function",...n?{shape:n}:{},...r?{currentValue:s}:{}}});return{atoms:i,total:o.length,returned:i.length,includedValues:r}},setAtom:e=>{const{label:r,value:t,merge:o,path:a,force:i}=(0,_sharedUi.readParams)(e);if(!r)throw new Error("setAtom requires a `label`");const l=_jotaiStateStore.jotaiStateStore.getAtom(r);let s;try{s=l?.getValue()}catch{s=void 0}let n=t;let f=[];let h=[];const m=o===true||a!==void 0;if(a!==void 0){if(t===void 0){return{ok:false,error:`Refused: sent \`path\` without \`value\`. Say what to set "${a}" to.`}}const u=(0,_sharedUi.patchFromPath)(s,a,t);if(!u.ok)return{ok:false,error:`Refused: ${u.error}`};n=u.patch}if(!i&&m&&s!==void 0){const u=(0,_sharedUi.expandKeyedArrays)(s,n);if(u.error){return{ok:false,error:`Refused: ${u.error}`}}n=u.patch;f=u.notes;h=(0,_sharedUi.unshapedLists)(s).filter(c=>touchesList(n,c));const d=(0,_sharedUi.typedEditViolations)(s,n,{noun:"atom"});if(d.length){const c=(0,_sharedUi.suggestedPatch)(n,d);return{ok:false,error:(0,_sharedUi.refusalText)(d,"atom",c),violations:d,...c?{suggestedValue:c}:{}}}}_jotaiStateStore.jotaiStateStore.setAtomValue(r,m?deepMergeInto(s,n):n);return{ok:true,...a!==void 0?{path:a}:{},...f.length?{keyed:f}:{},...h.length?{unchecked:h.map(u=>`\`${u}\` was empty, so nothing knows what its items look like and the shape of what you added was NOT checked.`)}:{}}}}});

package/lib/commonjs/jotai/types/index.js

@@ -1 +1 @@
-"use strict";
+"use strict";