@buoy-gg/jotai 7.0.16 → 7.0.17

package/lib/commonjs/index.js

@@ -93,6 +93,7 @@ Object.defineProperty(exports, "watchDefaultStoreAtoms", {
     return _watchAtoms.watchDefaultStoreAtoms;
   }
 });
+require("./jotai/utils/snapshotProvider");
 var _preset = require("./preset");
 var _watchAtoms = require("./jotai/utils/watchAtoms");
 var _useJotaiAtomChanges = require("./jotai/hooks/useJotaiAtomChanges");

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

@@ -0,0 +1,124 @@
+"use strict";
+
+var _sharedUi = require("@buoy-gg/shared-ui");
+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) {
+  const snapshot = data;
+  const result = {
+    ok: true,
+    applied: 0,
+    skipped: [],
+    warnings: []
+  };
+  if (!snapshot?.atoms) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [],
+      warnings: ["empty jotai snapshot"]
+    };
+  }
+  let derived = 0;
+  for (const [label, entry] of Object.entries(snapshot.atoms)) {
+    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`);
+  }
+  return result;
+}
+(0, _sharedUi.registerStateSnapshotProvider)({
+  id: "jotai",
+  label: "Jotai",
+  status,
+  capture,
+  restore
+});

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

@@ -61,9 +61,11 @@ function watchAtoms(store, atoms, options) {
     }
 
     // Register the atom for the browser view. A setter is captured only when
-    // the store supports `set` (writable atoms); read-only/derived atoms throw
-    // at set time and are reported as read-only.
-    const setter = store.set ? value => {
+    // the store supports `set` AND the atom itself is writable (has a `write`
+    // function — primitive atoms get a default one, read-only derived atoms
+    // have none). Deriveds used to get a setter that threw inside jotai at
+    // set time; now they're correctly reported as read-only up front.
+    const setter = store.set && typeof atom.write === "function" ? value => {
       store.set(atom, value);
     } : undefined;
     _jotaiStateStore.jotaiStateStore.registerAtom(label, () => {

package/lib/module/index.js

@@ -32,6 +32,9 @@
  * ```
  */
 
+// Side-effect: registers the Time Machine snapshot provider
+import "./jotai/utils/snapshotProvider";
+
 // =============================================================================
 // PRESET (Primary entry point for FloatingDevTools)
 // =============================================================================

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

@@ -0,0 +1,123 @@
+"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 { registerStateSnapshotProvider } from "@buoy-gg/shared-ui";
+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) {
+  const snapshot = data;
+  const result = {
+    ok: true,
+    applied: 0,
+    skipped: [],
+    warnings: []
+  };
+  if (!snapshot?.atoms) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [],
+      warnings: ["empty jotai snapshot"]
+    };
+  }
+  let derived = 0;
+  for (const [label, entry] of Object.entries(snapshot.atoms)) {
+    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`);
+  }
+  return result;
+}
+registerStateSnapshotProvider({
+  id: "jotai",
+  label: "Jotai",
+  status,
+  capture,
+  restore
+});

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

@@ -56,9 +56,11 @@ export function watchAtoms(store, atoms, options) {
     }
 
     // Register the atom for the browser view. A setter is captured only when
-    // the store supports `set` (writable atoms); read-only/derived atoms throw
-    // at set time and are reported as read-only.
-    const setter = store.set ? value => {
+    // the store supports `set` AND the atom itself is writable (has a `write`
+    // function — primitive atoms get a default one, read-only derived atoms
+    // have none). Deriveds used to get a setter that threw inside jotai at
+    // set time; now they're correctly reported as read-only up front.
+    const setter = store.set && typeof atom.write === "function" ? value => {
       store.set(atom, value);
     } : undefined;
     jotaiStateStore.registerAtom(label, () => {

package/lib/typescript/index.d.ts

@@ -29,6 +29,7 @@
  * watchAtoms(myStore, { countAtom, authAtom });
  * ```
  */
+import "./jotai/utils/snapshotProvider";
 export { jotaiToolPreset, createJotaiTool } from "./preset";
 export { watchAtoms } from "./jotai/utils/watchAtoms";
 export { watchDefaultStoreAtoms } from "./jotai/utils/watchAtoms";

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAK5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAKlE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAOnF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAK3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAKvB,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,gCAAgC,CAAC;AAKxC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAK5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAKlE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAOnF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAK3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAKvB,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/lib/typescript/jotai/utils/snapshotProvider.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshotProvider.d.ts.map

package/lib/typescript/jotai/utils/snapshotProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotProvider.d.ts","sourceRoot":"","sources":["../../../../src/jotai/utils/snapshotProvider.ts"],"names":[],"mappings":""}

package/lib/typescript/jotai/utils/watchAtoms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watchAtoms.d.ts","sourceRoot":"","sources":["../../../../src/jotai/utils/watchAtoms.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,+DAA+D;AAC/D,KAAK,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;AAE7B,mFAAmF;AACnF,UAAU,aAAa;IACrB,GAAG,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;IACzC,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACzD,mFAAmF;IACnF,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CACtD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,IAAI,CAwEZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,IAAI,CA2BZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,YAAY,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"watchAtoms.d.ts","sourceRoot":"","sources":["../../../../src/jotai/utils/watchAtoms.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,+DAA+D;AAC/D,KAAK,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;AAE7B,mFAAmF;AACnF,UAAU,aAAa;IACrB,GAAG,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;IACzC,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACzD,mFAAmF;IACnF,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;CACtD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,IAAI,CA2EZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,IAAI,CA2BZ;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/jotai",
-  "version": "7.0.16",
+  "version": "7.0.17",
   "description": "Jotai devtools inside your React Native app — every atom write shows prev → next, with per-atom history & live values. Part of Buoy devtools.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -24,10 +24,13 @@
   "files": [
     "lib"
   ],
-  "sideEffects": false,
+  "sideEffects": [
+    "**/snapshotProvider.js",
+    "**/snapshotProvider.ts"
+  ],
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.16",
-    "@buoy-gg/license": "^7.0.16"
+    "@buoy-gg/license": "^7.0.17",
+    "@buoy-gg/shared-ui": "^7.0.17"
   },
   "peerDependencies": {
     "jotai": ">=2.0.0",