@buoy-gg/shared-ui 7.0.33 → 7.0.35

package/lib/commonjs/index.js

@@ -52,10 +52,25 @@ var _exportNames = {
   getSafeCurrentPathname: true,
   getSafeCurrentRoute: true,
   isExpoRouterAvailable: true,
+  PREVIEW_ITEM_RENDER_BYTE_LIMIT: true,
+  createRestoreScope: true,
+  emptyRestoreResult: true,
+  failedRestore: true,
+  skippedRestore: true,
+  classifyPreviewItem: true,
+  wontApply: true,
+  unionKeys: true,
+  entityColor: true,
+  formatValuePreview: true,
+  shallowDiffSummary: true,
   isPlainObjectUtil: true,
   useSafeAreaInsets: true,
   useFilterManager: true,
   usePersistedState: true,
+  resetPersistedStateCache: true,
+  useChangeLog: true,
+  useSubscribedValue: true,
+  useEventStoreEvents: true,
   useDeviceInfo: true,
   getDeviceInfo: true,
   logDeviceInfo: true,
@@ -222,6 +237,12 @@ Object.defineProperty(exports, "NightSwitch", {
     return _primitives.NightSwitch;
   }
 });
+Object.defineProperty(exports, "PREVIEW_ITEM_RENDER_BYTE_LIMIT", {
+  enumerable: true,
+  get: function () {
+    return _snapshotProviderKit.PREVIEW_ITEM_RENDER_BYTE_LIMIT;
+  }
+});
 Object.defineProperty(exports, "ProBadge", {
   enumerable: true,
   get: function () {
@@ -282,6 +303,18 @@ Object.defineProperty(exports, "buoyColors", {
     return _gameUIColors.buoyColors;
   }
 });
+Object.defineProperty(exports, "classifyPreviewItem", {
+  enumerable: true,
+  get: function () {
+    return _snapshotProviderKit.classifyPreviewItem;
+  }
+});
+Object.defineProperty(exports, "createRestoreScope", {
+  enumerable: true,
+  get: function () {
+    return _snapshotProviderKit.createRestoreScope;
+  }
+});
 Object.defineProperty(exports, "dialColors", {
   enumerable: true,
   get: function () {
@@ -294,6 +327,24 @@ Object.defineProperty(exports, "displayValue", {
     return _index3.displayValue;
   }
 });
+Object.defineProperty(exports, "emptyRestoreResult", {
+  enumerable: true,
+  get: function () {
+    return _snapshotProviderKit.emptyRestoreResult;
+  }
+});
+Object.defineProperty(exports, "entityColor", {
+  enumerable: true,
+  get: function () {
+    return _stateTools.entityColor;
+  }
+});
+Object.defineProperty(exports, "failedRestore", {
+  enumerable: true,
+  get: function () {
+    return _snapshotProviderKit.failedRestore;
+  }
+});
 Object.defineProperty(exports, "flattenObject", {
   enumerable: true,
   get: function () {
@@ -312,6 +363,12 @@ Object.defineProperty(exports, "formatValue", {
     return _index3.formatValue;
   }
 });
+Object.defineProperty(exports, "formatValuePreview", {
+  enumerable: true,
+  get: function () {
+    return _stateTools.formatValuePreview;
+  }
+});
 Object.defineProperty(exports, "freeKeyRaises", {
   enumerable: true,
   get: function () {
@@ -546,6 +603,12 @@ Object.defineProperty(exports, "reloadApp", {
     return _index3.reloadApp;
   }
 });
+Object.defineProperty(exports, "resetPersistedStateCache", {
+  enumerable: true,
+  get: function () {
+    return _index1.resetPersistedStateCache;
+  }
+});
 Object.defineProperty(exports, "resolveEffectiveTier", {
   enumerable: true,
   get: function () {
@@ -576,6 +639,18 @@ Object.defineProperty(exports, "setRenderCaptureProvider", {
     return _index3.setRenderCaptureProvider;
   }
 });
+Object.defineProperty(exports, "shallowDiffSummary", {
+  enumerable: true,
+  get: function () {
+    return _stateTools.shallowDiffSummary;
+  }
+});
+Object.defineProperty(exports, "skippedRestore", {
+  enumerable: true,
+  get: function () {
+    return _snapshotProviderKit.skippedRestore;
+  }
+});
 Object.defineProperty(exports, "subscribeToStateSnapshotProviders", {
   enumerable: true,
   get: function () {
@@ -612,12 +687,30 @@ Object.defineProperty(exports, "truncateText", {
     return _index3.truncateText;
   }
 });
+Object.defineProperty(exports, "unionKeys", {
+  enumerable: true,
+  get: function () {
+    return _snapshotProviderKit.unionKeys;
+  }
+});
+Object.defineProperty(exports, "useChangeLog", {
+  enumerable: true,
+  get: function () {
+    return _index1.useChangeLog;
+  }
+});
 Object.defineProperty(exports, "useDeviceInfo", {
   enumerable: true,
   get: function () {
     return _index1.useDeviceInfo;
   }
 });
+Object.defineProperty(exports, "useEventStoreEvents", {
+  enumerable: true,
+  get: function () {
+    return _index1.useEventStoreEvents;
+  }
+});
 Object.defineProperty(exports, "useFeatureGate", {
   enumerable: true,
   get: function () {
@@ -684,6 +777,18 @@ Object.defineProperty(exports, "useSafeSegments", {
     return _index3.useSafeSegments;
   }
 });
+Object.defineProperty(exports, "useSubscribedValue", {
+  enumerable: true,
+  get: function () {
+    return _index1.useSubscribedValue;
+  }
+});
+Object.defineProperty(exports, "wontApply", {
+  enumerable: true,
+  get: function () {
+    return _snapshotProviderKit.wontApply;
+  }
+});
 var _index = require("./ui/index.js");
 Object.keys(_index).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -720,6 +825,42 @@ Object.keys(_wireBudget).forEach(function (key) {
     }
   });
 });
+var _wireForm = require("./sync/wireForm.js");
+Object.keys(_wireForm).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _wireForm[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _wireForm[key];
+    }
+  });
+});
+var _toolSyncAdapter = require("./sync/toolSyncAdapter.js");
+Object.keys(_toolSyncAdapter).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _toolSyncAdapter[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _toolSyncAdapter[key];
+    }
+  });
+});
+var _defineTool = require("./tools/defineTool.js");
+Object.keys(_defineTool).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _defineTool[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _defineTool[key];
+    }
+  });
+});
 var _toolActionRegistry = require("./sync/toolActionRegistry.js");
 Object.keys(_toolActionRegistry).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -745,6 +886,8 @@ Object.keys(_toolUiBridge).forEach(function (key) {
   });
 });
 var _index3 = require("./utils/index.js");
+var _snapshotProviderKit = require("./utils/snapshotProviderKit.js");
+var _stateTools = require("./utils/stateTools.js");
 var _index4 = require("./utils/formatting/index.js");
 Object.keys(_index4).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/lib/commonjs/license/FreeAccountPrompt.js

@@ -10,6 +10,7 @@ var _gameUIColors = require("../ui/gameUI/constants/gameUIColors.js");
 var _lucideIcons = require("../icons/lucide-icons.js");
 var _index = require("../clipboard/index.js");
 var _openPricing = require("./openPricing.js");
+var _fonts = require("../ui/fonts.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
@@ -160,7 +161,7 @@ const styles = _reactNative.StyleSheet.create({
     fontSize: 14,
     fontWeight: "600",
     color: _gameUIColors.buoyColors.text,
-    fontFamily: "monospace"
+    fontFamily: _fonts.monoFont
   },
   reassure: {
     fontSize: 12,

package/lib/commonjs/license/LicenseEntryModal.js

@@ -10,6 +10,7 @@ var _absoluteFill = require("../utils/absoluteFill.js");
 var _macOSDesignSystemColors = require("../ui/gameUI/constants/macOSDesignSystemColors.js");
 var _openPricing = require("./openPricing.js");
 var _lucideIcons = require("../icons/lucide-icons.js");
+var _fonts = require("../ui/fonts.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
@@ -344,7 +345,7 @@ const styles = _reactNative.StyleSheet.create({
   },
   codeText: {
     fontSize: 11,
-    fontFamily: _reactNative.Platform.OS === "ios" ? "Menlo" : "monospace",
+    fontFamily: _fonts.monoFont,
     lineHeight: 18,
     color: _macOSDesignSystemColors.macOSColors.text.primary
   },

package/lib/commonjs/storage/definePersistedSetting.js

@@ -0,0 +1,67 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.definePersistedSetting = definePersistedSetting;
+var _persistentStorage = require("../utils/persistentStorage.js");
+/**
+ * definePersistedSetting — the `load / save / clear` triple every tool wrote
+ * for its module-level settings (copy settings, HUD prefs, JS TOP prefs, …).
+ *
+ * Contract, the same one all of them followed:
+ *  - `load()` never throws and never returns a partial object: the stored
+ *    value is merged OVER the defaults so fields added in a later release
+ *    get their default instead of `undefined`, then `sanitize` gets the last
+ *    word (drop values the UI no longer offers, coerce types).
+ *  - `save()` and `clear()` are best-effort; persistence is optional.
+ *  - `loadOrNull()` distinguishes "nothing saved yet" from the defaults, for
+ *    callers that treat first launch differently.
+ */
+
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function definePersistedSetting(key, defaults, options = {}) {
+  const storage = options.storage ?? _persistentStorage.persistentStorage;
+  const parse = options.parse ?? (raw => JSON.parse(raw));
+  const serialize = options.serialize ?? (value => JSON.stringify(value));
+  function resolve(stored) {
+    const merged = isPlainObject(defaults) && isPlainObject(stored) ? {
+      ...defaults,
+      ...stored
+    } : stored;
+    return options.sanitize ? options.sanitize(merged, stored) : merged;
+  }
+  async function loadOrNull() {
+    try {
+      const raw = await storage.getItem(key);
+      if (raw == null || raw === "") return null;
+      return resolve(parse(raw));
+    } catch {
+      return null;
+    }
+  }
+  return {
+    key,
+    defaults,
+    loadOrNull,
+    async load() {
+      return (await loadOrNull()) ?? defaults;
+    },
+    async save(value) {
+      try {
+        await storage.setItem(key, serialize(value));
+      } catch {
+        // Persistence is best-effort.
+      }
+    },
+    async clear() {
+      try {
+        await storage.removeItem(key);
+      } catch {
+        // Persistence is best-effort.
+      }
+    }
+  };
+}

package/lib/commonjs/storage/index.js

@@ -3,6 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "definePersistedSetting", {
+  enumerable: true,
+  get: function () {
+    return _definePersistedSetting.definePersistedSetting;
+  }
+});
 Object.defineProperty(exports, "devToolsStorageKeys", {
   enumerable: true,
   get: function () {
@@ -15,4 +21,5 @@ Object.defineProperty(exports, "isDevToolsStorageKey", {
     return _devToolsStorageKeys.isDevToolsStorageKey;
   }
 });
-var _devToolsStorageKeys = require("./devToolsStorageKeys.js");
+var _devToolsStorageKeys = require("./devToolsStorageKeys.js");
+var _definePersistedSetting = require("./definePersistedSetting.js");

package/lib/commonjs/stores/ChangeLog.js

@@ -0,0 +1,197 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ChangeLog = void 0;
+/**
+ * ChangeLog — the class-shaped event log the state tools share.
+ *
+ * redux (`ReduxActionStore`), zustand (`ZustandStateStore`), jotai
+ * (`JotaiStateStore`) and react-query (`ReactQueryEventStore`) each carried
+ * the same ~120 lines: a newest-first ring buffer, a `Set` of array listeners
+ * (`(items) => void`), a `Set` of clear listeners for the desktop's mirror
+ * mode, an `enabled` flag (the UI's pause button), a `captureSuppressed` flag
+ * (the dashboard must never record its own traffic), a monotonic id counter,
+ * `getById`, and hydrate-by-id for lazily fetched detail payloads.
+ *
+ * This is that core. Tool stores `extend` it and keep their public method
+ * names (`addStateChange`, `getActions`, `clearAtomChanges`, …) as thin
+ * wrappers, so no call site — including Buoy Desktop — has to change.
+ *
+ * Semantics preserved from the originals, deliberately:
+ * - `getAll()` returns a COPY (`[...items]`) — consumers seed React state
+ *   from it and rely on a fresh identity per notification.
+ * - `clear()` always notifies, even when already empty, then fires the clear
+ *   listeners (the dashboard forwards the clear to the device either way).
+ * - `replaceAll()` respects `enabled`: the pause button freezes a mirror.
+ * - `disableCapture()` is permanent for the store's lifetime.
+ */
+
+class ChangeLog {
+  /** Newest first. Subclasses may read; mutate only through the helpers. */
+  items = [];
+  itemListeners = new Set();
+  clearListeners = new Set();
+  idCounter = 0;
+  enabled = true;
+  captureSuppressed = false;
+  constructor(options = {}) {
+    this.max = options.max ?? 200;
+  }
+
+  // ---- Recording ----
+
+  /** True when a new item should be recorded (not paused, not a mirror). */
+  canRecord() {
+    return this.enabled && !this.captureSuppressed;
+  }
+
+  /** `${Date.now()}-${n}` — unique per store instance, sorts by time. */
+  nextId() {
+    return `${Date.now()}-${++this.idCounter}`;
+  }
+
+  /**
+   * Prepend one item and trim to `max`. Does NOT notify — subclasses often
+   * touch companion state (per-entity counters, raw-state eviction) before
+   * they notify. Call `notifyListeners()` when done, or use `record()`.
+   */
+  push(item) {
+    this.items = [item, ...this.items].slice(0, this.max);
+  }
+
+  /** `push()` + notify. The common case. */
+  record(item) {
+    this.push(item);
+    this.notifyListeners();
+  }
+
+  /** Replace the buffer wholesale (already merged/hydrated by the caller) and notify. */
+  setItems(next) {
+    this.items = next.slice(0, this.max);
+    this.notifyListeners();
+  }
+
+  // ---- Reading ----
+
+  /** All items, newest first. Fresh array each call. */
+  getAll() {
+    return [...this.items];
+  }
+  getById(id) {
+    return this.items.find(item => item.id === id);
+  }
+  get size() {
+    return this.items.length;
+  }
+
+  // ---- Clearing ----
+
+  /**
+   * Empty the buffer, notify, then fire clear listeners. Always notifies —
+   * a clear is a user action and the list must repaint even if nothing was
+   * in it. Subclasses that keep companion counters reset them first.
+   */
+  clear() {
+    this.items = [];
+    this.notifyListeners();
+    this.clearListeners.forEach(listener => {
+      try {
+        listener();
+      } catch {
+        // Ignore listener errors
+      }
+    });
+  }
+
+  /**
+   * Listen for `clear()` 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 (the desktop dashboard): data arrives via
+   * `replaceAll()` / a subclass snapshot method and local instrumentation
+   * must never record.
+   */
+  disableCapture() {
+    this.captureSuppressed = true;
+  }
+
+  /** Whether the store is in remote mirror mode (capture suppressed). */
+  isCaptureSuppressed() {
+    return this.captureSuppressed;
+  }
+
+  /**
+   * Replace the whole list from a remote snapshot and notify. Respects the
+   * enabled flag so the UI's pause button freezes the mirror. Returns false
+   * when skipped. Subclasses with hydration-preserving merges compute the
+   * merged list themselves and call `setItems()`.
+   */
+  replaceAll(next) {
+    if (!this.enabled) return false;
+    this.setItems(next);
+    return true;
+  }
+
+  /**
+   * Patch one item in place (by id) and notify. Used to hydrate a mirrored
+   * item with detail payloads fetched on demand from the device.
+   */
+  hydrateById(id, patch) {
+    const index = this.items.findIndex(item => item.id === id);
+    if (index === -1) return;
+    this.items = [...this.items.slice(0, index), {
+      ...this.items[index],
+      ...patch
+    }, ...this.items.slice(index + 1)];
+    this.notifyListeners();
+  }
+
+  // ---- Enable / disable ----
+
+  setEnabled(enabled) {
+    this.enabled = enabled;
+  }
+  getEnabled() {
+    return this.enabled;
+  }
+  setMax(max) {
+    this.max = max;
+    if (this.items.length > max) {
+      this.items = this.items.slice(0, max);
+      this.notifyListeners();
+    }
+  }
+  getMax() {
+    return this.max;
+  }
+
+  // ---- Subscriptions ----
+
+  subscribe(listener) {
+    this.itemListeners.add(listener);
+    return () => {
+      this.itemListeners.delete(listener);
+    };
+  }
+  notifyListeners() {
+    const items = this.getAll();
+    this.itemListeners.forEach(listener => listener(items));
+  }
+  get listenerCount() {
+    return this.itemListeners.size;
+  }
+}
+exports.ChangeLog = ChangeLog;