@buoy-gg/storage 7.0.4 → 7.0.5

package/lib/module/storage/utils/setStorageValue.js

@@ -0,0 +1,209 @@
+"use strict";
+
+/**
+ * Writing a storage value back, in one place.
+ *
+ * The counterpart to `deleteStorageKeys` — and the same reasoning applies: each
+ * backend writes differently, and a second copy of that fan-out is how one
+ * backend quietly starts corrupting values.
+ *
+ * The hard part is NOT the write, it's the types:
+ *
+ * - **AsyncStorage** stores strings only. A value that was stored as JSON must
+ *   stay valid JSON, or an object silently becomes a quoted string and the app
+ *   that reads it breaks in a way that looks nothing like a devtools edit.
+ * - **MMKV** is natively typed (string / number / boolean / buffer). Writing
+ *   `"42"` over a number turns it into a string, so the original type is
+ *   restored from `valueType`. Buffers can't round-trip at all — the snapshot
+ *   only ever carried a `<ArrayBuffer n bytes>` placeholder.
+ * - **SecureStore** stores strings, and biometric-protected keys are never
+ *   touched (writing needs the same auth prompt reading does).
+ *
+ * Pro gating and confirmation are deliberately NOT here; they belong to the UI
+ * that has the user's attention. This assumes the caller already asked.
+ */
+
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import { secureStoreRegistry } from "./SecureStoreRegistry";
+/**
+ * Why a key can't be edited, or null when it can. UI uses this both to hide the
+ * edit affordance and to explain itself, rather than failing at save time.
+ */
+export function storageEditBlockedReason(storageKey, mmkvInstances = []) {
+  if (storageKey.storageType === "mmkv") {
+    if (storageKey.valueType === "buffer") {
+      return "Buffer values can't be edited — the tool only ever sees their byte length, not their contents.";
+    }
+    const instance = mmkvInstances.find(i => i.id === (storageKey.instanceId || "default"));
+    if (instance?.readOnly) {
+      return `MMKV instance "${instance.id}" is registered read-only.`;
+    }
+  }
+  if (storageKey.storageType === "secure") {
+    const entry = secureStoreRegistry.getAll().find(e => e.key === storageKey.key);
+    if (entry?.options.requireAuthentication) {
+      return "Biometric-protected keys can't be edited — writing one would fire an auth prompt.";
+    }
+    if (!secureStoreRegistry.getModule()) {
+      return "No SecureStore module is registered.";
+    }
+  }
+  return null;
+}
+
+/**
+ * Validate `raw` for this key WITHOUT writing. Returns an error message, or
+ * null when the text is acceptable. The editor calls this as you type.
+ */
+export function validateStorageValue(storageKey, raw) {
+  if (storageKey.storageType === "mmkv") {
+    const type = mmkvTargetType(storageKey);
+    if (type === "number") {
+      if (raw.trim() === "" || Number.isNaN(Number(raw))) {
+        return "Must be a number — this MMKV key is stored as a number.";
+      }
+    }
+    if (type === "boolean") {
+      const t = raw.trim().toLowerCase();
+      if (t !== "true" && t !== "false") {
+        return 'Must be "true" or "false" — this MMKV key is stored as a boolean.';
+      }
+    }
+    return null;
+  }
+
+  // AsyncStorage + SecureStore are string-valued. Only guard the case where
+  // the CURRENT value is structured: silently flattening an object into a
+  // string is the corruption worth preventing. A plain string stays free-form.
+  if (isStructured(storageKey.value)) {
+    try {
+      JSON.parse(raw);
+    } catch (e) {
+      return `This key holds JSON — ${e instanceof Error ? e.message : "invalid JSON"}`;
+    }
+  }
+  return null;
+}
+
+/**
+ * The text an editor should open with: JSON pretty-printed so it's actually
+ * editable, everything else verbatim.
+ */
+export function storageValueToEditableText(value) {
+  if (value === undefined || value === null) return "";
+  if (typeof value === "string") {
+    // Values arrive already parsed when they were JSON, so a string here is a
+    // real string — except AsyncStorage hands back raw JSON text sometimes.
+    const trimmed = value.trim();
+    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+      try {
+        return JSON.stringify(JSON.parse(value), null, 2);
+      } catch {
+        return value;
+      }
+    }
+    return value;
+  }
+  if (typeof value === "object") return JSON.stringify(value, null, 2);
+  return String(value);
+}
+
+/**
+ * The value as a STRUCTURE, for the tree editor to apply ops against.
+ *
+ * Backends disagree on how far they've already parsed: `useAsyncStorageKeys`
+ * hands back a parsed object, while MMKV reports its native type so a JSON blob
+ * arrives as the raw string. Both have to end up as the same thing before an op
+ * can address a path inside them.
+ *
+ * Returns `undefined` when the value isn't a container — scalars are edited
+ * through the plain value editor, not the tree.
+ */
+export function structuredStorageValue(storageKey) {
+  const {
+    value
+  } = storageKey;
+  if (value !== null && typeof value === "object") return value;
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return undefined;
+    try {
+      const parsed = JSON.parse(value);
+      return parsed !== null && typeof parsed === "object" ? parsed : undefined;
+    } catch {
+      return undefined;
+    }
+  }
+  return undefined;
+}
+
+/**
+ * Write `raw` to whichever backend holds this key, restoring the value's
+ * original type. Rejects (rather than writing something lossy) when the key
+ * isn't editable or the text doesn't fit the type — callers surface that.
+ */
+export async function setStorageValue(storageKey, raw, mmkvInstances = []) {
+  const blocked = storageEditBlockedReason(storageKey, mmkvInstances);
+  if (blocked) throw new Error(blocked);
+  const invalid = validateStorageValue(storageKey, raw);
+  if (invalid) throw new Error(invalid);
+  switch (storageKey.storageType) {
+    case "async":
+      {
+        await AsyncStorage.setItem(storageKey.key, normalizeJsonText(storageKey, raw));
+        return;
+      }
+    case "secure":
+      {
+        await secureStoreRegistry.setValue(storageKey.key, normalizeJsonText(storageKey, raw));
+        return;
+      }
+    case "mmkv":
+      {
+        const instanceId = storageKey.instanceId || "default";
+        const target = mmkvInstances.find(i => i.id === instanceId);
+        if (!target) {
+          throw new Error(`MMKV instance "${instanceId}" is not registered.`);
+        }
+        target.instance.set(storageKey.key, coerceMMKV(storageKey, raw));
+        return;
+      }
+    default:
+      {
+        throw new Error(`Unsupported storage type "${String(storageKey.storageType)}"`);
+      }
+  }
+}
+
+/** True when the value is an object/array (so its text must stay valid JSON). */
+function isStructured(value) {
+  return value !== null && typeof value === "object";
+}
+
+/**
+ * Re-serialize JSON so the stored string is compact and canonical, matching
+ * what the app itself would have written with `JSON.stringify`. Free-form
+ * strings pass through untouched.
+ */
+function normalizeJsonText(storageKey, raw) {
+  if (!isStructured(storageKey.value)) return raw;
+  return JSON.stringify(JSON.parse(raw));
+}
+
+/** The MMKV native type to write back, defaulting to the current JS type. */
+function mmkvTargetType(storageKey) {
+  if (storageKey.valueType) return storageKey.valueType;
+  if (typeof storageKey.value === "number") return "number";
+  if (typeof storageKey.value === "boolean") return "boolean";
+  return "string";
+}
+function coerceMMKV(storageKey, raw) {
+  switch (mmkvTargetType(storageKey)) {
+    case "number":
+      return Number(raw);
+    case "boolean":
+      return raw.trim().toLowerCase() === "true";
+    default:
+      return raw;
+  }
+}

package/lib/module/storage/utils/storageBrowserRefresh.js

@@ -0,0 +1,44 @@
+"use strict";
+
+/**
+ * A "the underlying storage changed, re-read it" signal for the storage
+ * browser.
+ *
+ * On device the browser refreshes itself from the AsyncStorage/MMKV listeners,
+ * but those never fire in remote-mirror mode (the desktop dashboard suppresses
+ * local capture and receives the device's events as snapshots instead). Without
+ * this seam the browse tab is a one-shot read at mount — values stay frozen
+ * until the panel remounts, which is exactly the "shows old data until I switch
+ * tools and come back" behaviour.
+ *
+ * The dashboard calls {@link requestStorageBrowserRefresh} whenever a fresh
+ * device snapshot lands; the browser re-reads all three backends (debounced).
+ * It is a no-op when nothing is listening.
+ */
+
+const listeners = new Set();
+
+/**
+ * Subscribe to external refresh requests. Returns an unsubscribe function.
+ * @internal — used by the storage browser.
+ */
+export function onStorageBrowserRefresh(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+/**
+ * Ask any mounted storage browser to re-read AsyncStorage, MMKV and
+ * SecureStore. Safe to call at any rate — the browser debounces.
+ */
+export function requestStorageBrowserRefresh() {
+  listeners.forEach(listener => {
+    try {
+      listener();
+    } catch {
+      // Listener errors are not ours
+    }
+  });
+}

package/lib/module/storage/utils/storageOps.js

@@ -0,0 +1,46 @@
+"use strict";
+
+/**
+ * The five operations a storage event can be, and how to recognise one.
+ *
+ * AsyncStorage and MMKV each have their own action union, and neither maps
+ * cleanly onto what a reader wants to see — `multiRemove`, `removeItem` and
+ * `delete` are one idea wearing three names. These collapse both onto a single
+ * vocabulary so every surface labels, filters and colours events the same way.
+ *
+ * This is semantics, not presentation: it lives in `utils` rather than beside
+ * any one view, so a view can be deleted without taking the vocabulary with it.
+ */
+
+import { macOSColors } from "@buoy-gg/shared-ui";
+export const STORAGE_OPS = ["SET", "GET", "MERGE", "DELETE", "CLEAR"];
+const OP_DOT = {
+  SET: macOSColors.semantic.info,
+  GET: macOSColors.text.muted,
+  MERGE: macOSColors.semantic.debug,
+  DELETE: macOSColors.semantic.error,
+  CLEAR: macOSColors.semantic.warning
+};
+export function storageOpDot(op) {
+  return OP_DOT[op];
+}
+
+/** Both backends' action unions, collapsed onto the five display operations. */
+export function storageOpOf(event) {
+  const action = event.action;
+  if (action === "clear" || action === "clearAll") return "CLEAR";
+  if (action.startsWith("get.")) return "GET";
+  if (action === "removeItem" || action === "multiRemove" || action === "delete") return "DELETE";
+  if (action === "mergeItem" || action === "multiMerge") return "MERGE";
+  return "SET";
+}
+
+/**
+ * The store synthesises one event per existing key when it first subscribes, so
+ * the list isn't empty on open. Those are a SNAPSHOT, not a write: the key
+ * already held that value, so there is no "before" to diff against and showing
+ * one would invent a change that never happened.
+ */
+export function isInitialScan(event) {
+  return Boolean(event.data?.initialScan);
+}

package/lib/module/storage/utils/storageTimeTravelUtils.js

@@ -6,15 +6,20 @@
  * Provides jump and undo functionality for AsyncStorage operations.
  */
 
+import { isDevToolsStorageKey } from "@buoy-gg/shared-ui";
 import AsyncStorage from "@react-native-async-storage/async-storage";
-import { writeMany } from "./asyncStorageCompat";
-import { pauseCapture, resumeCapture } from "./AsyncStorageListener";
-
+import { writeMany, removeMany } from "./asyncStorageCompat";
 /**
  * Undo a single storage operation
  *
  * Restores the previous value(s) before the operation occurred.
- * This pauses event capture to avoid creating new events during restoration.
+ *
+ * The restore is deliberately NOT capture-paused. Pausing it meant the write
+ * landed but emitted no event, so the modal's event list and current-value
+ * panel never changed — UNDO looked like a dead button even though it had
+ * worked. Letting the restore emit normally makes it visible and keeps the
+ * history honest about what the storage actually did. There is no feedback
+ * loop: a write emits an event, and an event never triggers a write.
  *
  * @param event - The storage event to undo
  */
@@ -23,10 +28,7 @@ export async function undoOperation(event) {
     action,
     data
   } = event;
-
-  // Pause capture to avoid creating events during restoration
-  pauseCapture();
-  try {
+  {
     switch (action) {
       case "setItem":
       case "mergeItem":
@@ -81,20 +83,21 @@ export async function undoOperation(event) {
       default:
         throw new Error(`Cannot undo unknown action type: ${action}`);
     }
-  } finally {
-    // Always resume capture, even if an error occurred
-    resumeCapture();
   }
 }
 
 /**
  * Jump to a specific point in storage history
  *
- * This reconstructs the storage state as it was after a specific event
- * by clearing storage and replaying all events up to that point.
+ * Reconstructs the state as of `targetEventIndex` by replaying `events` up to
+ * that point, then reconciling ONLY the keys that timeline governs.
  *
- * Note: This is a destructive operation - it will clear current storage
- * and replay events to reach the target state.
+ * This used to begin with `AsyncStorage.clear()`, which was badly out of
+ * proportion: the modal's JUMP button passes one key's history, so clearing
+ * wiped every unrelated app key — and Buoy's own `@react_buoy*` settings with
+ * them — to restore a single value. Now a jump touches exactly the keys that
+ * appear in the events it was given, and never Buoy's own keys. Like
+ * [undoOperation], the writes emit normally so the change is visible.
  *
  * @param events - All events in chronological order (oldest first)
  * @param targetEventIndex - The index of the event to jump to (0-based)
@@ -104,34 +107,52 @@ export async function jumpToState(events, targetEventIndex) {
     throw new Error(`Invalid event index: ${targetEventIndex}`);
   }
 
-  // Pause capture to avoid creating events during replay
-  pauseCapture();
-  try {
-    // Clear all storage first
-    await AsyncStorage.clear();
-
-    // Build up the state by applying each event up to and including the target
-    // We use the final values from each event, not the operations themselves
-    const stateMap = new Map();
-    for (let i = 0; i <= targetEventIndex; i++) {
-      const event = events[i];
-      applyEventToStateMap(event, stateMap);
-    }
+  // Build up the state by applying each event up to and including the target.
+  // We use the final values from each event, not the operations themselves.
+  const stateMap = new Map();
+  for (let i = 0; i <= targetEventIndex; i++) {
+    applyEventToStateMap(events[i], stateMap);
+  }
 
-    // Apply the final state
-    const pairsToSet = [];
-    for (const [key, value] of stateMap) {
-      if (value !== null) {
-        pairsToSet.push([key, value]);
-      }
-    }
-    if (pairsToSet.length > 0) {
-      await writeMany(pairsToSet);
+  // Every key the WHOLE timeline touches — including events after the target,
+  // so a key created later is removed rather than left behind.
+  const governedKeys = new Set();
+  for (const event of events) {
+    collectEventKeys(event, governedKeys);
+  }
+  const pairsToSet = [];
+  const keysToRemove = [];
+  for (const key of governedKeys) {
+    // Buoy's own settings are never app state to travel through.
+    if (isDevToolsStorageKey(key)) continue;
+    const value = stateMap.get(key);
+    if (value === undefined || value === null) {
+      keysToRemove.push(key);
+    } else {
+      pairsToSet.push([key, value]);
     }
-  } finally {
-    // Always resume capture
-    resumeCapture();
   }
+  if (keysToRemove.length > 0) {
+    await removeMany(keysToRemove);
+  }
+  if (pairsToSet.length > 0) {
+    await writeMany(pairsToSet);
+  }
+}
+
+/**
+ * Collect every key an event refers to, across all action shapes — including
+ * `prevPairs`, so keys a `clear` removed are still governed by the timeline.
+ */
+function collectEventKeys(event, into) {
+  const {
+    data
+  } = event;
+  if (!data) return;
+  if (data.key) into.add(data.key);
+  if (data.keys) for (const key of data.keys) into.add(key);
+  if (data.pairs) for (const [key] of data.pairs) into.add(key);
+  if (data.prevPairs) for (const [key] of data.prevPairs) into.add(key);
 }
 
 /**

package/lib/module/storage/utils/valueType.js

@@ -13,6 +13,29 @@ export function getValueTypeLabel(value) {
   return "unknown";
 }
 
+/**
+ * A stored value as a tree can show it.
+ *
+ * AsyncStorage and SecureStore hold strings, so an object arrives as the text
+ * `{"a":1}` — displaying that as a string is technically true and useless. Any
+ * surface that renders or edits a value structurally has to do this same
+ * un-stringify first, so it lives here rather than being re-derived (slightly
+ * differently) in each one.
+ *
+ * A string that doesn't parse comes back untouched: it was just a string that
+ * happened to start with a brace.
+ */
+export function parseStorageValue(value) {
+  if (typeof value !== "string") return value;
+  const trimmed = value.trim();
+  if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return value;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+
 /** Longest value preview rendered inline next to the type label. */
 const MAX_INLINE_PREVIEW = 40;
 

package/lib/typescript/index.d.ts

@@ -10,12 +10,15 @@
  */
 export { storageToolPreset, createStorageTool } from "./preset";
 export { StorageSection } from "./storage/components/StorageSection";
-export { StorageModalWithTabs } from "./storage/components/StorageModalWithTabs";
+export { StorageModalWithTabs, StorageToolView, } from "./storage/components/StorageModalWithTabs";
 export { StorageKeyCard } from "./storage/components/StorageKeyCard";
 export { StorageKeyStatsSection } from "./storage/components/StorageKeyStats";
 export { StorageKeySection } from "./storage/components/StorageKeySection";
 export { StorageBrowserMode } from "./storage/components/StorageBrowserMode";
+export type { StorageFilterType, StorageTypeFilter, } from "./storage/components/StorageFilterCards";
+export { StorageTypeFilterBar, countByStorageType, type StorageTypeCounts, } from "./storage/components/StorageTypeFilterBar";
 export { StorageEventsSection } from "./storage/components/StorageEventsSection";
+export { STORAGE_OPS, storageOpOf, storageOpDot, isInitialScan, type StorageOp, } from "./storage/utils/storageOps";
 export { StorageEventCard, getValueType, type StorageEventCardData, type StorageValueType, } from "./storage/components/StorageEventCard";
 export { StorageEventDetailContent, StorageEventDetailFooter, } from "./storage/components/StorageEventDetailContent";
 export { MMKVInstanceSelector } from "./storage/components/MMKVInstanceSelector";
@@ -26,6 +29,7 @@ export { useMMKVInstances, useMMKVInstance, useMMKVInstanceExists, } from "./sto
 export { useStorageEvents, type UseStorageEventsOptions, type UseStorageEventsResult, } from "./storage/hooks/useStorageEvents";
 export type { StorageEvent, StorageEventListener, StorageEventCallback, } from "./storage/stores/storageEventStore";
 export { clearAllAppStorage } from "./storage/utils/clearAllStorage";
+export { setStorageValue, storageEditBlockedReason, validateStorageValue, storageValueToEditableText, type EditableMMKVInstance, } from "./storage/utils/setStorageValue";
 export { isMMKVAvailable, getMMKVClass, getMMKVUnavailableMessage, } from "./storage/utils/mmkvAvailability";
 export { detectMMKVType, formatMMKVValue, isTypeMatch, type MMKVValueType, type MMKVValueInfo, } from "./storage/utils/mmkvTypeDetection";
 export { undoOperation, jumpToState, canUndo, } from "./storage/utils/storageTimeTravelUtils";
@@ -38,4 +42,11 @@ export type { SecureStoreLike, SecureStoreKeyDescriptor, SecureStoreOptionsLike,
 export { storageSyncAdapter } from "./storage/sync/storageSyncAdapter";
 /** @internal */
 export { storageEventStore } from "./storage/stores/storageEventStore";
+/**
+ * Tell a mounted storage browser to re-read every backend. Used by the desktop
+ * dashboard, where local storage listeners are suppressed and device data
+ * arrives as snapshots instead.
+ * @internal
+ */
+export { requestStorageBrowserRefresh } from "./storage/utils/storageBrowserRefresh";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAKnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,kCAAkC,CAAC;AAK1C,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAK5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EACL,eAAe,EACf,YAAY,EACZ,yBAAyB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,eAAe,EACf,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,WAAW,EACX,OAAO,GACR,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAK7E,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sCAAsC,CAAC;AAM9C,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAK7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/storage/components/DiffViewer/TreeDiffViewer.d.ts

@@ -1,7 +1,10 @@
 interface TreeDiffViewerProps {
     oldValue: unknown;
     newValue: unknown;
+    /** Forwarded to the shared viewer — false renders the tree inline so an
+     *  ancestor ScrollView scrolls it as part of the page. */
+    scrollEnabled?: boolean;
 }
-export declare function TreeDiffViewer({ oldValue, newValue }: TreeDiffViewerProps): import("react").JSX.Element;
+export declare function TreeDiffViewer({ oldValue, newValue, scrollEnabled, }: TreeDiffViewerProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=TreeDiffViewer.d.ts.map

package/lib/typescript/storage/components/DiffViewer/TreeDiffViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeDiffViewer.d.ts","sourceRoot":"","sources":["../../../../../src/storage/components/DiffViewer/TreeDiffViewer.tsx"],"names":[],"mappings":"AAIA,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,mBAAmB,+BAUzE"}
+{"version":3,"file":"TreeDiffViewer.d.ts","sourceRoot":"","sources":["../../../../../src/storage/components/DiffViewer/TreeDiffViewer.tsx"],"names":[],"mappings":"AAIA,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB;8DAC0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,QAAQ,EACR,aAAoB,GACrB,EAAE,mBAAmB,+BAWrB"}

package/lib/typescript/storage/components/DiffViewer/modes/ThemedSplitView.d.ts

@@ -7,7 +7,13 @@ interface ThemedSplitViewProps {
     theme: DiffTheme;
     options?: DiffOptions;
     showThemeName?: boolean;
+    /**
+     * Scroll the rows inside their own fixed-height pane (default). Set false to
+     * render every row inline at natural height and let an ancestor ScrollView
+     * move them — one page-level scroll instead of a nested scroll region.
+     */
+    scrollEnabled?: boolean;
 }
-export declare function ThemedSplitView({ oldValue, newValue, theme, options, showThemeName, }: ThemedSplitViewProps): import("react").JSX.Element;
+export declare function ThemedSplitView({ oldValue, newValue, theme, options, showThemeName, scrollEnabled, }: ThemedSplitViewProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=ThemedSplitView.d.ts.map

package/lib/typescript/storage/components/DiffViewer/modes/ThemedSplitView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemedSplitView.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/components/DiffViewer/modes/ThemedSplitView.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAaD,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,OAAyB,EACzB,aAAqB,GACtB,EAAE,oBAAoB,+BAgLtB"}
+{"version":3,"file":"ThemedSplitView.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/components/DiffViewer/modes/ThemedSplitView.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAaD,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,OAAyB,EACzB,aAAqB,EACrB,aAAoB,GACrB,EAAE,oBAAoB,+BAmMtB"}

package/lib/typescript/storage/components/GameUIStorageBrowser.d.ts

@@ -1,5 +1,6 @@
 import { MutableRefObject } from "react";
 import { RequiredStorageKey } from "../types";
+import { type StorageFilterType, type StorageTypeFilter } from "./StorageFilterCards";
 /** Free tier limit for storage keys */
 export declare const FREE_TIER_KEY_LIMIT = 25;
 interface GameUIStorageBrowserProps {
@@ -11,13 +12,38 @@ interface GameUIStorageBrowserProps {
     searchQuery?: string;
     storageDataRef?: MutableRefObject<any[]>;
     eventCountByKey?: Record<string, number>;
+    /**
+     * Epoch ms of the most recent recorded write per key, for keys whose write
+     * we actually witnessed — a key can exist without us ever having seen it
+     * written. Currently unused by the card list; kept because the host computes
+     * it for the Events tab anyway.
+     */
+    lastWriteByKey?: Record<string, number>;
     onViewHistory?: (key: string) => void;
     enabledStorageTypes?: Set<'async' | 'mmkv' | 'secure'>;
+    /**
+     * Status filter (valid / missing / issues), lifted so a host that has its own
+     * toolbar can render the counters there — the desktop dashboard puts them
+     * beside the search field. Omit both to keep the filter internal.
+     */
+    statusFilter?: StorageFilterType;
+    onStatusFilterChange?: (filter: StorageFilterType) => void;
+    /** Reports the three status counts whenever they change, for that host toolbar. */
+    onStatusCountsChange?: (counts: {
+        validCount: number;
+        missingCount: number;
+        issuesCount: number;
+    }) => void;
     /** Keys pinned to the top of the list */
     pinnedKeys?: Set<string>;
     /** Toggle a key's pinned state */
     onTogglePin?: (key: string) => void;
+    /** Backend filter, lifted so the Events tab can share the same selection. */
+    storageTypeFilter?: StorageTypeFilter;
+    onStorageTypeFilterChange?: (type: StorageTypeFilter) => void;
+    /** Pad full-screen views past the home indicator (docked sheet only). */
+    applySafeAreaInset?: boolean;
 }
-export declare function GameUIStorageBrowser({ requiredStorageKeys, showFilters, ignoredPatterns, onTogglePattern, onAddPattern, searchQuery, storageDataRef, eventCountByKey, onViewHistory, enabledStorageTypes, pinnedKeys, onTogglePin, }: GameUIStorageBrowserProps): import("react").JSX.Element;
+export declare function GameUIStorageBrowser({ requiredStorageKeys, showFilters, ignoredPatterns, onTogglePattern, onAddPattern, searchQuery, storageDataRef, eventCountByKey, lastWriteByKey, onViewHistory, enabledStorageTypes, statusFilter, onStatusFilterChange, onStatusCountsChange, pinnedKeys, onTogglePin, storageTypeFilter, onStorageTypeFilterChange, applySafeAreaInset, }: GameUIStorageBrowserProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=GameUIStorageBrowser.d.ts.map

package/lib/typescript/storage/components/GameUIStorageBrowser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GameUIStorageBrowser.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/GameUIStorageBrowser.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,gBAAgB,EACjB,MAAM,OAAO,CAAC;AAUf,OAAO,EAAkB,kBAAkB,EAAmB,MAAM,UAAU,CAAC;AA4C/E,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,UAAU,yBAAyB;IACjC,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IACvD,yCAAyC;IACzC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,kCAAkC;IAClC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,oBAAoB,CAAC,EACnC,mBAAwB,EACxB,WAAmB,EACnB,eAA0C,EAC1C,eAAe,EACf,YAAY,EACZ,WAAgB,EAChB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,WAAW,GACZ,EAAE,yBAAyB,+BAkzB3B"}
+{"version":3,"file":"GameUIStorageBrowser.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/GameUIStorageBrowser.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,gBAAgB,EACjB,MAAM,OAAO,CAAC;AAWf,OAAO,EAAkB,kBAAkB,EAAmB,MAAM,UAAU,CAAC;AAK/E,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AA2C9B,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,UAAU,yBAAyB;IACjC,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IACvD;;;;OAIG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC3D,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE;QAC9B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,KAAK,IAAI,CAAC;IACX,yCAAyC;IACzC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,kCAAkC;IAClC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,yBAAyB,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9D,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,oBAAoB,CAAC,EACnC,mBAAwB,EACxB,WAAmB,EACnB,eAA0C,EAC1C,eAAe,EACf,YAAY,EACZ,WAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,GACnB,EAAE,yBAAyB,+BA+9B3B"}

package/lib/typescript/storage/components/SelectionActionBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectionActionBar.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/SelectionActionBar.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI1C,UAAU,uBAAuB;IAC/B,4BAA4B;IAC5B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,kCAAkC;IAClC,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACpD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,gEAAgE;IAChE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAC9C,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,EAAE,uBAAuB,sCA+JzB"}
+{"version":3,"file":"SelectionActionBar.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/SelectionActionBar.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,UAAU,uBAAuB;IAC/B,4BAA4B;IAC5B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,kCAAkC;IAClC,aAAa,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACpD,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,gEAAgE;IAChE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAC9C,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,EAAE,uBAAuB,sCA6HzB"}