@buoy-gg/jotai 7.0.35 → 7.0.38

package/lib/module/index.js

@@ -1,85 +1 @@
-"use strict";
-
-/**
- * @buoy-gg/jotai
- *
- * Jotai Atom DevTools for React Native
- *
- * PUBLIC API - Only these exports are supported for external use.
- *
- * @example Recommended setup (one line, pass your atoms)
- * ```tsx
- * import { getDefaultStore } from 'jotai';
- * import { watchAtoms } from '@buoy-gg/jotai';
- * import { countAtom } from './atoms/count';
- * import { authAtom } from './atoms/auth';
- *
- * // One call, anywhere at module scope or in your root layout:
- * watchAtoms(getDefaultStore(), {
- *   countAtom,
- *   authAtom,
- * });
- * ```
- *
- * @example With a custom store (Provider-based)
- * ```tsx
- * import { createStore } from 'jotai';
- * import { watchAtoms } from '@buoy-gg/jotai';
- *
- * const myStore = createStore();
- *
- * watchAtoms(myStore, { countAtom, authAtom });
- * ```
- */
-
-// Side-effect: registers the Time Machine snapshot provider
-import "./jotai/utils/snapshotProvider";
-
-// =============================================================================
-// PRESET (Primary entry point for FloatingDevTools)
-// =============================================================================
-export { jotaiToolPreset, createJotaiTool } from "./preset";
-
-// =============================================================================
-// WATCH ATOMS (Recommended — subscribe-only, non-intrusive)
-// =============================================================================
-export { watchAtoms } from "./jotai/utils/watchAtoms";
-
-// =============================================================================
-// CONVENIENCE (Default store shortcut)
-// =============================================================================
-export { watchDefaultStoreAtoms } from "./jotai/utils/watchAtoms";
-
-// =============================================================================
-// UTILITIES
-// =============================================================================
-export { isAtomWatched } from "./jotai/utils/watchAtoms";
-// =============================================================================
-// HOOKS (For consuming Jotai atom data)
-// =============================================================================
-export { useJotaiAtomChanges } from "./jotai/hooks/useJotaiAtomChanges";
-// =============================================================================
-// COMPONENTS (For custom UI implementations)
-// =============================================================================
-// `JotaiToolView` is the same tool rendered inline (header bar + body + footer)
-// instead of inside a JsModal — for hosts that show tools in a panel.
-export { JotaiModal, JotaiToolView } from "./jotai/components/JotaiModal";
-export { JotaiAtomChangeItem } from "./jotai/components/JotaiAtomChangeItem";
-export { JotaiAtomDetailContent, JotaiAtomDetailFooter } from "./jotai/components/JotaiAtomDetailContent";
-export { JotaiAtomValueDetailContent } from "./jotai/components/JotaiAtomValueDetailContent";
-export { JotaiIcon, JOTAI_ICON_COLOR } from "./jotai/components/JotaiIcon";
-
-// =============================================================================
-// EXTERNAL SYNC (Adapter for @buoy-gg/external-sync's useExternalSync)
-// =============================================================================
-export { jotaiSyncAdapter } from "./jotai/sync/jotaiSyncAdapter";
-
-// =============================================================================
-// TYPES
-// =============================================================================
-
-// =============================================================================
-// INTERNAL EXPORTS (For @buoy-gg/* packages only - not part of public API)
-// =============================================================================
-/** @internal */
-export { jotaiStateStore } from "./jotai/utils/jotaiStateStore";
+"use strict";import"./jotai/utils/snapshotProvider";export{jotaiToolPreset,createJotaiTool}from"./preset";export{watchAtoms}from"./jotai/utils/watchAtoms";export{watchDefaultStoreAtoms}from"./jotai/utils/watchAtoms";export{isAtomWatched}from"./jotai/utils/watchAtoms";export{useJotaiAtomChanges}from"./jotai/hooks/useJotaiAtomChanges";export{JotaiModal,JotaiToolView}from"./jotai/components/JotaiModal";export{JotaiAtomChangeItem}from"./jotai/components/JotaiAtomChangeItem";export{JotaiAtomDetailContent,JotaiAtomDetailFooter}from"./jotai/components/JotaiAtomDetailContent";export{JotaiAtomValueDetailContent}from"./jotai/components/JotaiAtomValueDetailContent";export{JotaiIcon,JOTAI_ICON_COLOR}from"./jotai/components/JotaiIcon";export{jotaiSyncAdapter}from"./jotai/sync/jotaiSyncAdapter";export{jotaiStateStore}from"./jotai/utils/jotaiStateStore";

package/lib/module/jotai/components/JotaiAtomBrowser.js

@@ -1,195 +1 @@
-"use strict";
-
-/**
- * JotaiAtomBrowser
- *
- * Atoms tab — shows all registered Jotai atoms and their current value.
- * Mirrors ZustandStoreBrowser.tsx from @buoy-gg/zustand: tapping a card
- * NAVIGATES to the atom's detail screen (live editor + details + read-only
- * tree) rather than expanding in place — the modal owns that selection.
- */
-
-import { useMemo } from "react";
-import { View, Text, StyleSheet, ScrollView } from "react-native";
-import { CompactRow, night, ToolEmptyState, resolveListEmptyState, monoFont } from "@buoy-gg/shared-ui";
-import { jotaiStateStore } from "../utils/jotaiStateStore";
-import { JOTAI_TEST_ID, atomRowTestID } from "../utils/testIDs";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-function getValuePreview(atom) {
-  try {
-    const value = atom.getValue();
-    if (value && typeof value === "object" && value.__buoyValueOnDevice === true) {
-      return "on device";
-    }
-    if (value === undefined) return "undefined";
-    if (value === null) return "null";
-    if (Array.isArray(value)) {
-      if (value.length === 0) return "[]";
-      return `[${value.length} item${value.length === 1 ? "" : "s"}]`;
-    }
-    if (typeof value === "object") {
-      const keys = Object.keys(value);
-      if (keys.length === 0) return "{}";
-      if (keys.length <= 3) return keys.join(", ");
-      return `${keys.slice(0, 2).join(", ")} +${keys.length - 2}`;
-    }
-    return String(value).slice(0, 40);
-  } catch {
-    return "";
-  }
-}
-
-/**
- * The card's categorical slot — the atom's write story, mirroring the
- * zustand card's "persisted"/"in-memory" backing label.
- */
-function getWriteKindLabel(atom) {
-  if (atom.writeKind === "value") return "primitive";
-  if (atom.writeKind === "action") return "custom write";
-  return atom.setValue ? "writable" : "derived";
-}
-function EmptyBrowserState() {
-  return /*#__PURE__*/_jsx(ToolEmptyState, {
-    testID: `${JOTAI_TEST_ID}-atoms-empty`
-    // scanning = "scanning for targets… and finding none". The registry is
-    // discovered, not configured, so an empty one is a scan result.
-    ,
-    otto: "scanning",
-    title: "No atoms registered",
-    message: "Use watchAtoms(store, { atomName }) to register your Jotai atoms.\nThey will appear here with their current value."
-  });
-}
-export function JotaiAtomBrowser({
-  atoms,
-  searchQuery,
-  onOpenAtom
-}) {
-  const filteredAtoms = useMemo(() => {
-    if (!searchQuery) return atoms;
-    const search = searchQuery.toLowerCase();
-    return atoms.filter(a => a.label.toLowerCase().includes(search));
-  }, [atoms, searchQuery]);
-  if (filteredAtoms.length === 0 && !searchQuery) {
-    return /*#__PURE__*/_jsx(EmptyBrowserState, {});
-  }
-  if (filteredAtoms.length === 0 && searchQuery) {
-    return /*#__PURE__*/_jsx(ToolEmptyState, {
-      testID: `${JOTAI_TEST_ID}-atoms-no-match`,
-      ...resolveListEmptyState({
-        subject: "atoms",
-        verb: "registered",
-        search: searchQuery,
-        total: atoms.length,
-        waiting: {
-          otto: "scanning",
-          title: "No atoms registered",
-          message: "Use watchAtoms() to register your Jotai atoms."
-        }
-      })
-    });
-  }
-  return /*#__PURE__*/_jsxs(ScrollView, {
-    style: styles.container,
-    contentContainerStyle: styles.scrollContent,
-    showsVerticalScrollIndicator: true,
-    testID: `${JOTAI_TEST_ID}-atoms-scroll`,
-    children: [/*#__PURE__*/_jsxs(View, {
-      style: styles.sectionHeader,
-      children: [/*#__PURE__*/_jsx(Text, {
-        style: styles.sectionTitle,
-        children: "ATOMS"
-      }), /*#__PURE__*/_jsx(View, {
-        style: styles.sectionCountBadge,
-        children: /*#__PURE__*/_jsx(Text, {
-          style: styles.sectionCountText,
-          testID: `${JOTAI_TEST_ID}-atoms-count`,
-          children: filteredAtoms.length
-        })
-      })]
-    }), filteredAtoms.map(atom => {
-      const valuePreview = getValuePreview(atom);
-      const atomColor = jotaiStateStore.getAtomColor(atom.label);
-      const rowID = atomRowTestID(atom.label);
-      return /*#__PURE__*/_jsxs(View, {
-        style: styles.atomRowWrapper,
-        children: [/*#__PURE__*/_jsx(CompactRow, {
-          statusDotColor: atomColor,
-          statusLabel: getWriteKindLabel(atom),
-          primaryText: atom.label,
-          secondaryText: valuePreview || undefined,
-          showChevron: true,
-          onPress: () => onOpenAtom(atom.label),
-          testID: rowID,
-          statusTestID: `${rowID}-kind`,
-          primaryTestID: `${rowID}-name`,
-          secondaryTestID: `${rowID}-preview`
-        }), atom.changeCount > 0 && /*#__PURE__*/_jsx(View, {
-          style: [styles.absCountBadge, {
-            backgroundColor: atomColor + "22",
-            borderColor: atomColor + "55"
-          }],
-          pointerEvents: "none",
-          children: /*#__PURE__*/_jsx(Text, {
-            style: [styles.absCountText, {
-              color: atomColor
-            }],
-            testID: `${rowID}-count`,
-            children: String(atom.changeCount)
-          })
-        })]
-      }, atom.label);
-    })]
-  });
-}
-const styles = StyleSheet.create({
-  container: {
-    flex: 1
-  },
-  atomRowWrapper: {
-    position: "relative"
-  },
-  absCountBadge: {
-    position: "absolute",
-    top: 4,
-    right: 10,
-    paddingHorizontal: 5,
-    paddingVertical: 1,
-    borderRadius: 4,
-    borderWidth: 1,
-    zIndex: 1
-  },
-  absCountText: {
-    fontSize: 9,
-    fontWeight: "700",
-    fontFamily: monoFont
-  },
-  scrollContent: {
-    paddingTop: 8,
-    paddingBottom: 20
-  },
-  sectionHeader: {
-    flexDirection: "row",
-    alignItems: "center",
-    paddingHorizontal: 16,
-    paddingVertical: 8,
-    gap: 8
-  },
-  sectionTitle: {
-    fontSize: 11,
-    fontWeight: "700",
-    letterSpacing: 0.5,
-    color: night.color.textTertiary
-  },
-  sectionCountBadge: {
-    backgroundColor: night.color.accentFill,
-    paddingHorizontal: 8,
-    paddingVertical: 2,
-    borderRadius: 4
-  },
-  sectionCountText: {
-    fontSize: 10,
-    fontWeight: "700",
-    color: night.color.accent,
-    fontFamily: monoFont
-  }
-});
+"use strict";import{useMemo}from"react";import{View,Text,StyleSheet,ScrollView}from"react-native";import{CompactRow,night,ToolEmptyState,resolveListEmptyState,monoFont}from"@buoy-gg/shared-ui";import{jotaiStateStore}from"../utils/jotaiStateStore";import{JOTAI_TEST_ID,atomRowTestID}from"../utils/testIDs";import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";function getValuePreview(t){try{const e=t.getValue();if(e&&"object"==typeof e&&!0===e.__buoyValueOnDevice)return"on device";if(void 0===e)return"undefined";if(null===e)return"null";if(Array.isArray(e))return 0===e.length?"[]":`[${e.length} item${1===e.length?"":"s"}]`;if("object"==typeof e){const t=Object.keys(e);return 0===t.length?"{}":t.length<=3?t.join(", "):`${t.slice(0,2).join(", ")} +${t.length-2}`}return String(e).slice(0,40)}catch{return""}}function getWriteKindLabel(t){return"value"===t.writeKind?"primitive":"action"===t.writeKind?"custom write":t.setValue?"writable":"derived"}function EmptyBrowserState(){return _jsx(ToolEmptyState,{testID:`${JOTAI_TEST_ID}-atoms-empty`,otto:"scanning",title:"No atoms registered",message:"Use watchAtoms(store, { atomName }) to register your Jotai atoms.\nThey will appear here with their current value."})}export function JotaiAtomBrowser({atoms:t,searchQuery:e,onOpenAtom:o}){const r=useMemo(()=>{if(!e)return t;const o=e.toLowerCase();return t.filter(t=>t.label.toLowerCase().includes(o))},[t,e]);return 0!==r.length||e?0===r.length&&e?_jsx(ToolEmptyState,{testID:`${JOTAI_TEST_ID}-atoms-no-match`,...resolveListEmptyState({subject:"atoms",verb:"registered",search:e,total:t.length,waiting:{otto:"scanning",title:"No atoms registered",message:"Use watchAtoms() to register your Jotai atoms."}})}):_jsxs(ScrollView,{style:styles.container,contentContainerStyle:styles.scrollContent,showsVerticalScrollIndicator:!0,testID:`${JOTAI_TEST_ID}-atoms-scroll`,children:[_jsxs(View,{style:styles.sectionHeader,children:[_jsx(Text,{style:styles.sectionTitle,children:"ATOMS"}),_jsx(View,{style:styles.sectionCountBadge,children:_jsx(Text,{style:styles.sectionCountText,testID:`${JOTAI_TEST_ID}-atoms-count`,children:r.length})})]}),r.map(t=>{const e=getValuePreview(t),r=jotaiStateStore.getAtomColor(t.label),n=atomRowTestID(t.label);return _jsxs(View,{style:styles.atomRowWrapper,children:[_jsx(CompactRow,{statusDotColor:r,statusLabel:getWriteKindLabel(t),primaryText:t.label,secondaryText:e||void 0,showChevron:!0,onPress:()=>o(t.label),testID:n,statusTestID:`${n}-kind`,primaryTestID:`${n}-name`,secondaryTestID:`${n}-preview`}),t.changeCount>0&&_jsx(View,{style:[styles.absCountBadge,{backgroundColor:r+"22",borderColor:r+"55"}],pointerEvents:"none",children:_jsx(Text,{style:[styles.absCountText,{color:r}],testID:`${n}-count`,children:String(t.changeCount)})})]},t.label)})]}):_jsx(EmptyBrowserState,{})}const styles=StyleSheet.create({container:{flex:1},atomRowWrapper:{position:"relative"},absCountBadge:{position:"absolute",top:4,right:10,paddingHorizontal:5,paddingVertical:1,borderRadius:4,borderWidth:1,zIndex:1},absCountText:{fontSize:9,fontWeight:"700",fontFamily:monoFont},scrollContent:{paddingTop:8,paddingBottom:20},sectionHeader:{flexDirection:"row",alignItems:"center",paddingHorizontal:16,paddingVertical:8,gap:8},sectionTitle:{fontSize:11,fontWeight:"700",letterSpacing:.5,color:night.color.textTertiary},sectionCountBadge:{backgroundColor:night.color.accentFill,paddingHorizontal:8,paddingVertical:2,borderRadius:4},sectionCountText:{fontSize:10,fontWeight:"700",color:night.color.accent,fontFamily:monoFont}});

package/lib/module/jotai/components/JotaiAtomChangeItem.js

@@ -1,81 +1 @@
-"use strict";
-
-/**
- * Compact list item for displaying a Jotai atom change
- *
- * Mirrors ZustandStateChangeItem.tsx — uses shared CompactRow for consistent styling
- */
-
-import { memo } from "react";
-import { ChangeRow, night } from "@buoy-gg/shared-ui";
-import { jotaiStateStore } from "../utils/jotaiStateStore";
-import { jsx as _jsx } from "react/jsx-runtime";
-function getStatusLabel(category, atomLabel) {
-  if (category === "initial") return "Initial";
-  return atomLabel.charAt(0).toUpperCase() + atomLabel.slice(1);
-}
-function getCategoryColor(category, atomLabel) {
-  if (category === "initial") return night.color.textTertiary;
-  return jotaiStateStore.getAtomColor(atomLabel);
-}
-function formatCompact(value, maxLen = 20) {
-  if (value === undefined) return "undefined";
-  if (value === null) return "null";
-  if (typeof value === "boolean") return String(value);
-  if (typeof value === "number") return String(value);
-  if (typeof value === "string") {
-    const truncated = value.length > maxLen ? value.slice(0, maxLen - 1) + "…" : value;
-    return `"${truncated}"`;
-  }
-  if (Array.isArray(value)) {
-    return value.length === 0 ? "[]" : `[${value.length} item${value.length === 1 ? "" : "s"}]`;
-  }
-  if (typeof value === "object") {
-    const keys = Object.keys(value);
-    if (keys.length === 0) return "{}";
-    return `{${keys.slice(0, 2).join(", ")}${keys.length > 2 ? "…" : ""}}`;
-  }
-  return String(value).slice(0, maxLen);
-}
-function getSublabel(change) {
-  if (!change.hasValueChange) return "no change";
-  return `${formatCompact(change.prevValue)} → ${formatCompact(change.nextValue)}`;
-}
-function getBadgeText(change) {
-  if (change.category === "initial") return "INIT";
-  return "WRITE";
-}
-function getPrimaryText(change) {
-  if (change.changedKeys.length > 0 && change.changedKeys.length <= 3) {
-    return change.changedKeys.join(", ");
-  }
-  if (change.changedKeys.length > 3) {
-    return `${change.changedKeys.slice(0, 2).join(", ")} +${change.changedKeys.length - 2}`;
-  }
-  return change.valuePreview || "atom()";
-}
-
-// Memo justified by profiling (tool-bench 2026-07-06) — see
-// ZustandStateChangeItem (same pattern).
-export const JotaiAtomChangeItem = /*#__PURE__*/memo(function JotaiAtomChangeItem({
-  change,
-  onPress,
-  testID
-}) {
-  const statusColor = getCategoryColor(change.category, change.atomLabel);
-  const statusLabel = getStatusLabel(change.category, change.atomLabel);
-  const sublabel = getSublabel(change);
-  const primaryText = getPrimaryText(change);
-  const badgeText = getBadgeText(change);
-  return /*#__PURE__*/_jsx(ChangeRow, {
-    statusColor: statusColor,
-    statusLabel: statusLabel,
-    sublabel: sublabel,
-    primaryText: primaryText,
-    timestamp: change.timestamp,
-    badgeText: badgeText,
-    changed: change.hasValueChange,
-    onPress: () => onPress(change),
-    testID: testID
-  });
-});
+"use strict";import{memo}from"react";import{ChangeRow,night}from"@buoy-gg/shared-ui";import{jotaiStateStore}from"../utils/jotaiStateStore";import{jsx as _jsx}from"react/jsx-runtime";function getStatusLabel(t,e){return"initial"===t?"Initial":e.charAt(0).toUpperCase()+e.slice(1)}function getCategoryColor(t,e){return"initial"===t?night.color.textTertiary:jotaiStateStore.getAtomColor(e)}function formatCompact(t,e=20){if(void 0===t)return"undefined";if(null===t)return"null";if("boolean"==typeof t)return String(t);if("number"==typeof t)return String(t);if("string"==typeof t)return`"${t.length>e?t.slice(0,e-1)+"…":t}"`;if(Array.isArray(t))return 0===t.length?"[]":`[${t.length} item${1===t.length?"":"s"}]`;if("object"==typeof t){const e=Object.keys(t);return 0===e.length?"{}":`{${e.slice(0,2).join(", ")}${e.length>2?"…":""}}`}return String(t).slice(0,e)}function getSublabel(t){return t.hasValueChange?`${formatCompact(t.prevValue)} → ${formatCompact(t.nextValue)}`:"no change"}function getBadgeText(t){return"initial"===t.category?"INIT":"WRITE"}function getPrimaryText(t){return t.changedKeys.length>0&&t.changedKeys.length<=3?t.changedKeys.join(", "):t.changedKeys.length>3?`${t.changedKeys.slice(0,2).join(", ")} +${t.changedKeys.length-2}`:t.valuePreview||"atom()"}export const JotaiAtomChangeItem=memo(function({change:t,onPress:e,testID:r}){const n=getCategoryColor(t.category,t.atomLabel),a=getStatusLabel(t.category,t.atomLabel),o=getSublabel(t),i=getPrimaryText(t),g=getBadgeText(t);return _jsx(ChangeRow,{statusColor:n,statusLabel:a,sublabel:o,primaryText:i,timestamp:t.timestamp,badgeText:g,changed:t.hasValueChange,onPress:()=>e(t),testID:r})});