@buoy-gg/jotai 2.1.15 → 3.0.0

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

@@ -0,0 +1,35 @@
+"use strict";
+
+import { jotaiStateStore } from "../utils/jotaiStateStore";
+
+/**
+ * Sync adapter for the jotai tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it).
+ *
+ * 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.
+ */
+export const jotaiSyncAdapter = {
+  version: 1,
+  getSnapshot: () => ({
+    changes: jotaiStateStore.getAtomChanges(),
+    atoms: jotaiStateStore.getAtomSnapshots()
+  }),
+  subscribe: onChange => {
+    const unsubscribeChanges = jotaiStateStore.subscribe(onChange);
+    const unsubscribeAtoms = jotaiStateStore.subscribeToAtoms(onChange);
+    return () => {
+      unsubscribeChanges();
+      unsubscribeAtoms();
+    };
+  },
+  actions: {
+    clearEvents: () => {
+      jotaiStateStore.clearAtomChanges();
+    }
+  }
+};

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

@@ -1 +1,395 @@
-"use strict";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(t){const e=t.toLowerCase();if(ATOM_COLORS[e])return ATOM_COLORS[e];for(const[t,s]of Object.entries(ATOM_COLORS))if(e.includes(t))return s;const s=137*t.split("").reduce((t,e)=>t+e.charCodeAt(0),0)%360,n=.7*(1-Math.abs(1.2-1)),a=n*(1-Math.abs(s/60%2-1)),o=.6-n/2;let r=0,i=0,h=0;s<60?(r=n,i=a):s<120?(r=a,i=n):s<180?(i=n,h=a):s<240?(i=a,h=n):s<300?(r=a,h=n):(r=n,h=a);const l=t=>Math.round(255*(t+o)).toString(16).padStart(2,"0");return`#${l(r)}${l(i)}${l(h)}`}function formatValuePreview(t,e=40){if(void 0===t)return"undefined";if(null===t)return"null";try{if("function"==typeof t)return"(fn)";if("string"==typeof t)return t.length>e?`"${t.slice(0,e-3)}..."`:`"${t}"`;if("number"==typeof t||"boolean"==typeof t)return String(t);if(Array.isArray(t)){if(0===t.length)return"[]";const s=JSON.stringify(t);return s.length>e?`[${t.length} items]`:s}if("object"==typeof t){const s=Object.keys(t);if(0===s.length)return"{}";const n=JSON.stringify(t);return n.length<=e?n:`{ ${s.length} keys }`}return String(t).slice(0,e)}catch{return"[complex]"}}function getValueDiffSummary(t,e){if(t===e)return{summary:"no change",changedKeys:[],changedCount:0};if("object"!=typeof t||"object"!=typeof e||null===t||null===e)return{summary:"changed",changedKeys:[],changedCount:0};const s=Object.keys(t),n=Object.keys(e),a=n.filter(t=>!s.includes(t)),o=s.filter(t=>!n.includes(t)),r=[];for(const a of s)n.includes(a)&&t[a]!==e[a]&&r.push(a);const i=[...a,...o,...r],h=[];a.length>0&&h.push(`+${a.length}`),o.length>0&&h.push(`-${o.length}`),r.length>0&&h.push(`~${r.length}`);const l=i.length;return 0===h.length?{summary:"nested change",changedKeys:[],changedCount:0}:{summary:`${h.join(" ")} ${1===l?"key":"keys"}`,changedKeys:i,changedCount:l}}class JotaiStateStore{atomChanges=[];atoms=new Map;listeners=new Set;atomListeners=new Set;maxChanges=200;idCounter=0;isEnabled=!0;addAtomChange(t){if(!this.isEnabled)return;const{atomLabel:e,prevValue:s,nextValue:n,category:a="write"}=t,o=s!==n,{summary:r,changedKeys:i,changedCount:h}=getValueDiffSummary(s,n),l=formatValuePreview(n),u={id:`${Date.now()}-${++this.idCounter}`,atomLabel:e,timestamp:Date.now(),prevValue:s,nextValue:n,hasValueChange:o,category:a,changedKeys:i,changedKeysCount:h,diffSummary:r,valuePreview:l,isSlowUpdate:!1};this.atomChanges=[u,...this.atomChanges].slice(0,this.maxChanges);const g=this.atoms.get(e);g&&g.changeCount++,this.notifyListeners(),this.notifyAtomListeners()}getAtomChanges(){return[...this.atomChanges]}getAtomChangeById(t){return this.atomChanges.find(e=>e.id===t)}clearAtomChanges(){this.atomChanges=[];for(const t of this.atoms.values())t.changeCount=0;this.notifyListeners(),this.notifyAtomListeners()}registerAtom(t,e){if(this.atoms.has(t))return;const s={label:t,changeCount:0,color:getAtomColor(t),getValue:e};this.atoms.set(t,s),this.notifyAtomListeners()}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.atomChanges];if(t.searchText){const s=t.searchText.toLowerCase();e=e.filter(t=>t.atomLabel.toLowerCase().includes(s)||t.valuePreview.toLowerCase().includes(s)||t.changedKeys.some(t=>t.toLowerCase().includes(s)))}return t.atomLabels&&t.atomLabels.length>0&&(e=e.filter(e=>t.atomLabels.includes(e.atomLabel))),t.onlyWithChanges&&(e=e.filter(t=>t.hasValueChange)),e}getStats(){const t=this.atomChanges.length,e=this.atomChanges.filter(t=>t.hasValueChange).length;return{totalChanges:t,changesWithValueChange:e,changesWithoutValueChange:t-e,atomCount:this.atoms.size}}getUniqueAtomLabels(){return Array.from(this.atoms.keys()).sort()}setEnabled(t){this.isEnabled=t}getEnabled(){return this.isEnabled}setMaxChanges(t){this.maxChanges=t,this.atomChanges.length>t&&(this.atomChanges=this.atomChanges.slice(0,t),this.notifyListeners())}subscribe(t){return this.listeners.add(t),()=>this.listeners.delete(t)}subscribeToAtoms(t){return this.atomListeners.add(t),()=>this.atomListeners.delete(t)}notifyListeners(){const t=this.getAtomChanges();this.listeners.forEach(e=>e(t))}notifyAtomListeners(){const t=this.getAtoms();this.atomListeners.forEach(e=>e(t))}}export const jotaiStateStore=new JotaiStateStore;
+"use strict";
+
+/**
+ * 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) {
+  const lower = label.toLowerCase();
+  if (ATOM_COLORS[lower]) return ATOM_COLORS[lower];
+  for (const [key, color] of Object.entries(ATOM_COLORS)) {
+    if (lower.includes(key)) return color;
+  }
+
+  // Generate consistent hex from name hash
+  const hash = label.split("").reduce((acc, char) => acc + char.charCodeAt(0), 0);
+  const hue = hash * 137 % 360;
+  const s = 0.7;
+  const l = 0.6;
+  const c = (1 - Math.abs(2 * l - 1)) * s;
+  const x = c * (1 - Math.abs(hue / 60 % 2 - 1));
+  const m = l - c / 2;
+  let r = 0,
+    g = 0,
+    b = 0;
+  if (hue < 60) {
+    r = c;
+    g = x;
+  } else if (hue < 120) {
+    r = x;
+    g = c;
+  } else if (hue < 180) {
+    g = c;
+    b = x;
+  } else if (hue < 240) {
+    g = x;
+    b = c;
+  } else if (hue < 300) {
+    r = x;
+    b = c;
+  } else {
+    r = c;
+    b = x;
+  }
+  const toHex = v => Math.round((v + m) * 255).toString(16).padStart(2, "0");
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+
+// ============================================
+// Helper Functions
+// ============================================
+
+function formatValuePreview(value, maxLength = 40) {
+  if (value === undefined) return "undefined";
+  if (value === null) return "null";
+  try {
+    if (typeof value === "function") return "(fn)";
+    if (typeof value === "string") {
+      return value.length > maxLength ? `"${value.slice(0, maxLength - 3)}..."` : `"${value}"`;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+      return String(value);
+    }
+    if (Array.isArray(value)) {
+      if (value.length === 0) return "[]";
+      const preview = JSON.stringify(value);
+      return preview.length > maxLength ? `[${value.length} items]` : preview;
+    }
+    if (typeof value === "object") {
+      const keys = Object.keys(value);
+      if (keys.length === 0) return "{}";
+      const preview = JSON.stringify(value);
+      if (preview.length <= maxLength) return preview;
+      return `{ ${keys.length} keys }`;
+    }
+    return String(value).slice(0, maxLength);
+  } catch {
+    return "[complex]";
+  }
+}
+function getValueDiffSummary(prevValue, nextValue) {
+  if (prevValue === nextValue) {
+    return {
+      summary: "no change",
+      changedKeys: [],
+      changedCount: 0
+    };
+  }
+  if (typeof prevValue !== "object" || typeof nextValue !== "object" || prevValue === null || nextValue === null) {
+    return {
+      summary: "changed",
+      changedKeys: [],
+      changedCount: 0
+    };
+  }
+  const prevKeys = Object.keys(prevValue);
+  const nextKeys = Object.keys(nextValue);
+  const added = nextKeys.filter(k => !prevKeys.includes(k));
+  const removed = prevKeys.filter(k => !nextKeys.includes(k));
+  const changed = [];
+  for (const key of prevKeys) {
+    if (nextKeys.includes(key) && prevValue[key] !== nextValue[key]) {
+      changed.push(key);
+    }
+  }
+  const allChangedKeys = [...added, ...removed, ...changed];
+  const parts = [];
+  if (added.length > 0) parts.push(`+${added.length}`);
+  if (removed.length > 0) parts.push(`-${removed.length}`);
+  if (changed.length > 0) parts.push(`~${changed.length}`);
+  const total = allChangedKeys.length;
+  if (parts.length === 0) {
+    return {
+      summary: "nested change",
+      changedKeys: [],
+      changedCount: 0
+    };
+  }
+  return {
+    summary: `${parts.join(" ")} ${total === 1 ? "key" : "keys"}`,
+    changedKeys: allChangedKeys,
+    changedCount: total
+  };
+}
+
+// ============================================
+// Jotai State Store
+// ============================================
+
+class JotaiStateStore {
+  atomChanges = [];
+  atoms = new Map();
+  listeners = new Set();
+  atomListeners = new Set();
+  clearListeners = new Set();
+  maxChanges = 200;
+  idCounter = 0;
+  isEnabled = true;
+  captureSuppressed = false;
+
+  // ---- Change Tracking ----
+
+  addAtomChange(params) {
+    if (!this.isEnabled || this.captureSuppressed) 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: `${Date.now()}-${++this.idCounter}`,
+      atomLabel,
+      timestamp: Date.now(),
+      prevValue,
+      nextValue,
+      hasValueChange,
+      category,
+      changedKeys,
+      changedKeysCount: changedCount,
+      diffSummary: summary,
+      valuePreview,
+      isSlowUpdate: false
+    };
+    this.atomChanges = [change, ...this.atomChanges].slice(0, this.maxChanges);
+    const atomInfo = this.atoms.get(atomLabel);
+    if (atomInfo) {
+      atomInfo.changeCount++;
+    }
+    this.notifyListeners();
+    this.notifyAtomListeners();
+  }
+  getAtomChanges() {
+    return [...this.atomChanges];
+  }
+  getAtomChangeById(id) {
+    return this.atomChanges.find(c => c.id === id);
+  }
+  clearAtomChanges() {
+    this.atomChanges = [];
+    for (const atom of this.atoms.values()) {
+      atom.changeCount = 0;
+    }
+    this.notifyListeners();
+    this.notifyAtomListeners();
+    this.clearListeners.forEach(listener => {
+      try {
+        listener();
+      } catch {
+        // Ignore listener errors
+      }
+    });
+  }
+
+  /**
+   * Listen for clearAtomChanges() calls. Used in remote mirror mode to
+   * forward a clear performed in the dashboard UI to the synced device.
+   */
+  onClear(listener) {
+    this.clearListeners.add(listener);
+    return () => {
+      this.clearListeners.delete(listener);
+    };
+  }
+
+  // ---- Remote Mirror Mode ----
+
+  /**
+   * Permanently suppress local capture. Use when this store acts as a mirror
+   * of a remote device's atom changes (e.g. the desktop dashboard): data
+   * arrives via replaceFromSnapshot() and local watchers must never record.
+   */
+  disableCapture() {
+    this.captureSuppressed = true;
+  }
+
+  /** Whether the store is in remote mirror mode (capture suppressed). */
+  isCaptureSuppressed() {
+    return this.captureSuppressed;
+  }
+
+  /**
+   * 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
+      };
+    });
+  }
+
+  /**
+   * 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.isEnabled) return;
+    this.atomChanges = changes.slice(0, this.maxChanges);
+    this.atoms = new Map(atomSnapshots.map(snapshot => [snapshot.label, {
+      label: snapshot.label,
+      changeCount: snapshot.changeCount,
+      color: snapshot.color,
+      getValue: () => snapshot.currentValue
+    }]));
+    this.notifyListeners();
+    this.notifyAtomListeners();
+  }
+
+  // ---- Atom Registry ----
+
+  registerAtom(label, getValue) {
+    if (this.atoms.has(label)) return;
+    const atomInfo = {
+      label,
+      changeCount: 0,
+      color: getAtomColor(label),
+      getValue
+    };
+    this.atoms.set(label, atomInfo);
+    this.notifyAtomListeners();
+  }
+  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.atomChanges];
+    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.atomChanges.length;
+    const withChanges = this.atomChanges.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 ----
+
+  setEnabled(enabled) {
+    this.isEnabled = enabled;
+  }
+  getEnabled() {
+    return this.isEnabled;
+  }
+  setMaxChanges(max) {
+    this.maxChanges = max;
+    if (this.atomChanges.length > max) {
+      this.atomChanges = this.atomChanges.slice(0, max);
+      this.notifyListeners();
+    }
+  }
+
+  // ---- Subscriptions ----
+
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  subscribeToAtoms(listener) {
+    this.atomListeners.add(listener);
+    return () => this.atomListeners.delete(listener);
+  }
+  notifyListeners() {
+    const changes = this.getAtomChanges();
+    this.listeners.forEach(listener => listener(changes));
+  }
+  notifyAtomListeners() {
+    const atoms = this.getAtoms();
+    this.atomListeners.forEach(listener => listener(atoms));
+  }
+}
+export const jotaiStateStore = new JotaiStateStore();

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

@@ -1 +1,144 @@
-"use strict";import{jotaiStateStore}from"./jotaiStateStore";export function watchAtoms(t,e,o){const a=!1!==o?.enabled,r=[];for(const[o,i]of Object.entries(e)){const e=i,n=Symbol.for(`@@buoy-jotai/watched/${o}`);if(e[n])continue;let c;e[n]=!0;try{c=t.get(i)}catch{c=void 0}jotaiStateStore.registerAtom(o,()=>{try{return t.get(i)}catch{return}}),a&&jotaiStateStore.addAtomChange({atomLabel:o,prevValue:void 0,nextValue:c,category:"initial"});const u=t.sub(i,()=>{try{const e=t.get(i);jotaiStateStore.addAtomChange({atomLabel:o,prevValue:c,nextValue:e,category:"write"}),c=e}catch{}});r.push(()=>{u(),delete e[n],jotaiStateStore.unregisterAtom(o)})}return()=>r.forEach(t=>t())}export function watchDefaultStoreAtoms(t,e){let o;try{const{getDefaultStore:t}=require("jotai/vanilla");o=t()}catch{try{const{getDefaultStore:t}=require("jotai");o=t()}catch{return console.warn("[@buoy-gg/jotai] Could not find getDefaultStore from jotai. Pass the store explicitly via watchAtoms(store, atoms) instead."),()=>{}}}return watchAtoms(o,t,e)}export function isAtomWatched(t){return void 0!==jotaiStateStore.getAtom(t)}
+"use strict";
+
+/**
+ * Buoy Jotai DevTools — Atom instrumentation
+ *
+ * watchAtoms() — RECOMMENDED. Pass a Jotai store and a named atom map.
+ * Uses store.sub() to observe each atom externally. Never touches atom internals.
+ *
+ * watchDefaultStoreAtoms() — Convenience wrapper that uses getDefaultStore().
+ */
+
+import { jotaiStateStore } from "./jotaiStateStore";
+
+/** Any Jotai atom — alias for Atom<unknown> for readability */
+
+/** Minimal store shape — what Jotai's createStore() / getDefaultStore() returns */
+
+/**
+ * Watch a set of Jotai atoms for value changes.
+ *
+ * Pass a Jotai store and an object mapping display names to atoms.
+ * Uses store.sub() to observe each atom — never modifies atom internals.
+ *
+ * @example
+ * ```tsx
+ * import { getDefaultStore } from 'jotai';
+ * import { watchAtoms } from '@buoy-gg/jotai';
+ * import { countAtom } from './atoms/count';
+ * import { authAtom } from './atoms/auth';
+ *
+ * watchAtoms(getDefaultStore(), {
+ *   countAtom,
+ *   authAtom,
+ * });
+ * ```
+ *
+ * @param store  - Jotai store (from createStore() or getDefaultStore())
+ * @param atoms  - Object mapping display labels to Jotai atoms
+ * @param options - Optional configuration
+ * @returns Cleanup function that removes all subscriptions
+ */
+export function watchAtoms(store, atoms, options) {
+  const enabled = options?.enabled !== false;
+  const cleanups = [];
+  for (const [label, atom] of Object.entries(atoms)) {
+    // Skip if already watched under this label
+    const atomAny = atom;
+    const watchedKey = Symbol.for(`@@buoy-jotai/watched/${label}`);
+    if (atomAny[watchedKey]) continue;
+    atomAny[watchedKey] = true;
+    let prevValue;
+    try {
+      prevValue = store.get(atom);
+    } catch {
+      prevValue = undefined;
+    }
+
+    // Register the atom for the browser view
+    jotaiStateStore.registerAtom(label, () => {
+      try {
+        return store.get(atom);
+      } catch {
+        return undefined;
+      }
+    });
+
+    // Record initial value
+    if (enabled) {
+      jotaiStateStore.addAtomChange({
+        atomLabel: label,
+        prevValue: undefined,
+        nextValue: prevValue,
+        category: "initial"
+      });
+    }
+
+    // Subscribe to future changes
+    const unsubscribe = store.sub(atom, () => {
+      try {
+        const nextValue = store.get(atom);
+        jotaiStateStore.addAtomChange({
+          atomLabel: label,
+          prevValue,
+          nextValue,
+          category: "write"
+        });
+        prevValue = nextValue;
+      } catch {
+        // Silently catch — our bug must never propagate into the store
+      }
+    });
+    cleanups.push(() => {
+      unsubscribe();
+      delete atomAny[watchedKey];
+      jotaiStateStore.unregisterAtom(label);
+    });
+  }
+  return () => cleanups.forEach(fn => fn());
+}
+
+/**
+ * Watch atoms using Jotai's default store (no Provider setup required).
+ *
+ * Convenience wrapper around watchAtoms() — auto-imports getDefaultStore.
+ *
+ * @example
+ * ```tsx
+ * import { watchDefaultStoreAtoms } from '@buoy-gg/jotai';
+ * import { countAtom, authAtom } from './atoms';
+ *
+ * watchDefaultStoreAtoms({ countAtom, authAtom });
+ * ```
+ */
+export function watchDefaultStoreAtoms(atoms, options) {
+  // Dynamic import to avoid bundling jotai internals when not needed
+  let store;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const {
+      getDefaultStore
+    } = require("jotai/vanilla");
+    store = getDefaultStore();
+  } catch {
+    // Try the main jotai entry (React Native)
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const {
+        getDefaultStore
+      } = require("jotai");
+      store = getDefaultStore();
+    } catch {
+      console.warn("[@buoy-gg/jotai] Could not find getDefaultStore from jotai. " + "Pass the store explicitly via watchAtoms(store, atoms) instead.");
+      return () => {};
+    }
+  }
+  return watchAtoms(store, atoms, options);
+}
+
+/**
+ * Check if an atom label is currently being watched
+ */
+export function isAtomWatched(label) {
+  return jotaiStateStore.getAtom(label) !== undefined;
+}

package/lib/module/preset.js

@@ -1 +1,94 @@
-"use strict";import{JotaiModal}from"./jotai/components/JotaiModal";import{JotaiIcon}from"./jotai/components/JotaiIcon";import{jsx as _jsx}from"react/jsx-runtime";export const jotaiToolPreset={id:"jotai",name:"JOTAI",description:"Jotai atom & state inspector",slot:"both",icon:({size:o})=>_jsx(JotaiIcon,{size:o}),component:JotaiModal,props:{enableSharedModalDimensions:!1}};export function createJotaiTool(o){return{id:o?.id||"jotai",name:o?.name||"JOTAI",description:o?.description||"Jotai atom & state inspector",slot:"both",icon:({size:i})=>_jsx(JotaiIcon,{size:i,color:o?.iconColor}),component:JotaiModal,props:{enableSharedModalDimensions:void 0!==o?.enableSharedModalDimensions&&o.enableSharedModalDimensions}}}
+"use strict";
+
+/**
+ * Pre-configured Jotai DevTools preset for FloatingDevTools
+ *
+ * ZERO-CONFIG: This preset is auto-discovered by FloatingDevTools!
+ * Just install @buoy-gg/jotai and call watchAtoms() with your atoms.
+ *
+ * @example Automatic (recommended)
+ * ```tsx
+ * import { getDefaultStore } from 'jotai';
+ * import { watchAtoms } from '@buoy-gg/jotai';
+ * import { countAtom, authAtom } from './atoms';
+ *
+ * watchAtoms(getDefaultStore(), { countAtom, authAtom });
+ *
+ * // The Jotai tool appears automatically in FloatingDevTools!
+ * <FloatingDevTools />
+ * ```
+ *
+ * @example Manual (only for custom configuration)
+ * ```tsx
+ * import { createJotaiTool } from '@buoy-gg/jotai';
+ *
+ * const customJotaiTool = createJotaiTool({
+ *   name: "ATOMS",
+ *   iconColor: "#6C47FF",
+ * });
+ *
+ * <FloatingDevTools apps={[customJotaiTool]} />
+ * ```
+ */
+
+import { JotaiModal } from "./jotai/components/JotaiModal";
+import { JotaiIcon } from "./jotai/components/JotaiIcon";
+
+/**
+ * Pre-configured Jotai DevTools preset for FloatingDevTools.
+ * Includes:
+ * - Live atom change monitoring
+ * - Atom value inspection (JSON viewer)
+ * - Value diff visualization (tree + split)
+ * - Filter by atom label
+ * - Changed keys tracking for object atoms
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+export const jotaiToolPreset = {
+  id: "jotai",
+  name: "JOTAI",
+  description: "Jotai atom & state inspector",
+  slot: "both",
+  icon: ({
+    size
+  }) => /*#__PURE__*/_jsx(JotaiIcon, {
+    size: size
+  }),
+  component: JotaiModal,
+  props: {
+    enableSharedModalDimensions: false
+  }
+};
+
+/**
+ * Create a custom Jotai DevTools configuration.
+ * Use this if you want to override default settings.
+ *
+ * @example
+ * ```tsx
+ * import { createJotaiTool } from '@buoy-gg/jotai';
+ *
+ * const myJotaiTool = createJotaiTool({
+ *   name: "ATOMS",
+ *   iconColor: "#6C47FF",
+ * });
+ * ```
+ */
+export function createJotaiTool(options) {
+  return {
+    id: options?.id || "jotai",
+    name: options?.name || "JOTAI",
+    description: options?.description || "Jotai atom & state inspector",
+    slot: "both",
+    icon: ({
+      size
+    }) => /*#__PURE__*/_jsx(JotaiIcon, {
+      size: size,
+      color: options?.iconColor
+    }),
+    component: JotaiModal,
+    props: {
+      enableSharedModalDimensions: options?.enableSharedModalDimensions !== undefined ? options.enableSharedModalDimensions : false
+    }
+  };
+}

package/lib/typescript/index.d.ts

@@ -40,7 +40,8 @@ export { JotaiModal } from "./jotai/components/JotaiModal";
 export { JotaiAtomChangeItem } from "./jotai/components/JotaiAtomChangeItem";
 export { JotaiAtomDetailContent, JotaiAtomDetailFooter, } from "./jotai/components/JotaiAtomDetailContent";
 export { JotaiIcon, JOTAI_ICON_COLOR } from "./jotai/components/JotaiIcon";
-export type { JotaiModalProps, JotaiAtomChange, JotaiAtomInfo, JotaiFilter, AtomChangeCategory, WatchAtomsOptions, } from "./jotai/types";
+export { jotaiSyncAdapter } from "./jotai/sync/jotaiSyncAdapter";
+export type { JotaiModalProps, JotaiAtomChange, JotaiAtomInfo, JotaiAtomSnapshot, JotaiFilter, AtomChangeCategory, WatchAtomsOptions, } from "./jotai/types";
 /** @internal */
 export { jotaiStateStore } from "./jotai/utils/jotaiStateStore";
 //# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;AAKnF,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,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/components/JotaiAtomBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JotaiAtomBrowser.d.ts","sourceRoot":"","sources":["../../../../src/jotai/components/JotaiAtomBrowser.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,UAAU,qBAAqB;IAC7B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAyGD,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,WAAW,EACX,aAAa,GACd,EAAE,qBAAqB,+BAiFvB"}