@buoy-gg/shared-ui 7.0.39 → 7.0.41

package/lib/commonjs/utils/safeExpoRouter.js

@@ -11,7 +11,7 @@ exports.useSafeGlobalSearchParams = useSafeGlobalSearchParams;
 exports.useSafePathname = useSafePathname;
 exports.useSafeRouter = useSafeRouter;
 exports.useSafeSegments = useSafeSegments;
-var _reactNative = require("react-native");
+var _expoRouterModule = require("./expoRouterModule");
 /**
  * Safe wrapper for expo-router
  *
@@ -26,59 +26,10 @@ var _reactNative = require("react-native");
 let expoRouter = null;
 let isAvailable = false;
 let checkedAvailability = false;
-
-/**
- * Check if the Expo native runtime is available.
- * Handles both old SDKs (NativeModules.ExpoLinking) and new SDKs (54+)
- * where native modules moved to the Expo Modules API.
- */
-function hasExpoNativeRuntime() {
-  // Modern Expo (SDK 50+, both Old and New Architecture): expo-modules-core
-  // installs a global `expo` object — the Expo Modules API runtime — via JSI
-  // when the native runtime is actually present. This is the most reliable
-  // signal and, crucially, the ONLY one of these checks that fires on SDK 54+ /
-  // New Architecture dev builds, where the legacy NativeModules entries below
-  // are no longer registered (ExpoLinking is gone, NativeUnimoduleProxy isn't
-  // on the bridge). It stays absent on bare RN CLI, so there's no false
-  // positive there. Without this, navigation-dependent tools (route sitemap,
-  // remote navigate, perf-monitor automation) silently no-op on modern builds.
-  const expoGlobal = globalThis.expo;
-  if (expoGlobal != null && (expoGlobal.modules != null || expoGlobal.EventEmitter != null || expoGlobal.NativeModule != null)) {
-    return true;
-  }
-
-  // Check legacy NativeModules bridge (Expo SDK < 54)
-  if (_reactNative.NativeModules.ExpoLinking) {
-    return true;
-  }
-
-  // Check for Expo Modules Core native bridge (older SDKs / Old Architecture)
-  if (_reactNative.NativeModules.NativeUnimoduleProxy || _reactNative.NativeModules.ExpoModulesCore) {
-    return true;
-  }
-
-  // Check for Expo Go app
-  if (_reactNative.NativeModules.ExpoGoModule || _reactNative.NativeModules.ExpoUpdates) {
-    return true;
-  }
-
-  // No Expo native runtime detected (e.g. bare RN CLI).
-  // NOTE: We intentionally do NOT try require("expo-modules-core") here because
-  // on RN CLI it may be bundled as a transitive dep but the native modules
-  // (requireOptionalNativeModule etc.) are undefined, causing crashes.
-  return false;
-}
 function checkExpoRouterAvailability() {
   if (checkedAvailability) return isAvailable;
   try {
-    // Verify the Expo native runtime is available.
-    // On RN CLI, expo-router JS may be bundled but native modules aren't registered,
-    // so require() succeeds but hooks crash at runtime.
-    if (!hasExpoNativeRuntime()) {
-      checkedAvailability = true;
-      return false;
-    }
-    expoRouter = require("expo-router");
+    expoRouter = (0, _expoRouterModule.loadExpoRouter)();
     isAvailable = expoRouter != null && typeof expoRouter.usePathname === "function" && typeof expoRouter.useSegments === "function";
   } catch (error) {
     isAvailable = false;
@@ -190,8 +141,7 @@ let routerStore;
 function getRouterStore() {
   if (routerStore !== undefined) return routerStore;
   try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    routerStore = require("expo-router/build/global-state/router-store")?.store ?? null;
+    routerStore = (0, _expoRouterModule.loadExpoRouterStore)();
   } catch {
     routerStore = null;
   }

package/lib/commonjs/utils/safeExpoRouter.web.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getSafeCurrentPathname = getSafeCurrentPathname;
+exports.getSafeCurrentRoute = getSafeCurrentRoute;
+exports.getSafeRouter = getSafeRouter;
+exports.isExpoRouterAvailable = isExpoRouterAvailable;
+exports.useSafeGlobalSearchParams = useSafeGlobalSearchParams;
+exports.useSafePathname = useSafePathname;
+exports.useSafeRouter = useSafeRouter;
+exports.useSafeSegments = useSafeSegments;
+var _react = require("react");
+var _browserNavigation = require("./browserNavigation.js");
+const subscribe = callback => (0, _browserNavigation.subscribeBrowserNavigation)(callback);
+const currentURL = _browserNavigation.getBrowserRouteURL;
+function useSafeRouter() {
+  return _browserNavigation.browserRouter;
+}
+function useSafePathname() {
+  (0, _react.useSyncExternalStore)(subscribe, _browserNavigation.getBrowserHref, () => '/');
+  return currentURL().pathname;
+}
+function useSafeSegments() {
+  return useSafePathname().split('/').filter(Boolean);
+}
+function useSafeGlobalSearchParams() {
+  (0, _react.useSyncExternalStore)(subscribe, _browserNavigation.getBrowserHref, () => '/');
+  return Object.fromEntries(currentURL().searchParams);
+}
+function getSafeRouter() {
+  return typeof window === 'undefined' ? null : _browserNavigation.browserRouter;
+}
+function getSafeCurrentPathname() {
+  return currentURL().pathname;
+}
+function getSafeCurrentRoute() {
+  const url = currentURL();
+  return {
+    pathname: url.pathname,
+    href: `${url.pathname}${url.search}${url.hash}`,
+    segments: url.pathname.split('/').filter(Boolean)
+  };
+}
+function isExpoRouterAvailable() {
+  return false;
+}

package/lib/commonjs/utils/toolModules.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getRegisteredToolModule = getRegisteredToolModule;
+exports.getToolModuleVersion = getToolModuleVersion;
+exports.registerToolModules = registerToolModules;
+const modules = new Map();
+let version = 0;
+function registerToolModules(input) {
+  for (const [id, module] of Object.entries(input)) {
+    const name = id.startsWith('@buoy-gg/') ? id.replace(/\/web$/, '') : `@buoy-gg/${id}`;
+    if (modules.get(name) !== module) {
+      modules.set(name, module);
+      version++;
+    }
+  }
+}
+function getRegisteredToolModule(name) {
+  return modules.get(name) ?? null;
+}
+function getToolModuleVersion() {
+  return version;
+}

package/lib/module/JsModal.js

@@ -17,12 +17,13 @@ import { AccountSetup } from "./license/AccountSetup";
 import { useState, useRef, useEffect, useMemo, useCallback, memo, isValidElement, cloneElement } from "react";
 import { View, StyleSheet, TouchableWithoutFeedback, Dimensions, PanResponder, Animated, ScrollView, Text } from "react-native";
 import { absoluteFill } from "./utils/absoluteFill.js";
-import { useSafeAreaInsets } from "./hooks/useSafeAreaInsets.js";
+import { useSafeAreaInsets } from "./hooks/useSafeAreaInsets";
 import { gameUIColors, buoyColors } from "./ui/gameUI/index.js";
 import { DraggableHeader, ModalHintBanner, WindowControls } from "./ui/components/index.js";
 import { ToolBackground } from "./ui/backgrounds/ToolBackground.js";
 import { night } from "./ui/night/nightTheme.js";
-import { persistentStorage } from "./utils/persistentStorage.js";
+import { persistentStorage } from "./utils/persistentStorage";
+import { ModalStorage } from "./utils/modalStorage.js";
 import { devToolsStorageKeys } from "./storage/devToolsStorageKeys.js";
 import { useHintsDisabled } from "./context/index.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
@@ -62,61 +63,6 @@ const FLOATING_MIN_HEIGHT = 80; // Just a bit more than header height (60px head
  */
 const WINDOW_CONTROLS_BAND = 20;
 
-// ============================================================================
-// STORAGE - Modal state persistence with AsyncStorage
-// ============================================================================
-
-/**
- * Utility class for persisting modal state to AsyncStorage
- *
- * Handles saving and loading modal state including mode, dimensions,
- * and position with memory caching for performance.
- */
-class ModalStorage {
-  static memoryCache = {};
-
-  /**
-   * Save modal state to AsyncStorage with memory caching
-   *
-   * @param key - Storage key for the modal state
-   * @param value - Modal state to persist
-   */
-  static async save(key, value) {
-    try {
-      this.memoryCache[key] = value;
-      await persistentStorage.setItem(key, JSON.stringify(value));
-    } catch (error) {
-      // Failed to save modal state
-    }
-  }
-
-  /**
-   * Load modal state from AsyncStorage with memory cache fallback
-   *
-   * @param key - Storage key for the modal state
-   * @returns Persisted modal state or null if not found
-   */
-  static async load(key) {
-    try {
-      // Try memory cache first
-      if (this.memoryCache[key]) {
-        return this.memoryCache[key];
-      }
-
-      // Load from storage (AsyncStorage or memory fallback)
-      const stored = await persistentStorage.getItem(key);
-      if (stored) {
-        const parsed = JSON.parse(stored);
-        this.memoryCache[key] = parsed;
-        return parsed;
-      }
-    } catch (error) {
-      // Failed to load modal state
-    }
-    return null;
-  }
-}
-
 // ============================================================================
 // TYPE DEFINITIONS - Interface contracts for the modal
 // ============================================================================
@@ -646,6 +592,7 @@ const JsModalComponent = ({
         height: currentDimensionsRef.current.height
       }
     };
+    if (enablePersistence && persistenceKey) void ModalStorage.saveMinimized(persistenceKey, currentState);
 
     // Animate modal shrinking toward target position
     const targetX = minimizeTargetPosition?.x ?? SCREEN.width - 50;
@@ -686,7 +633,7 @@ const JsModalComponent = ({
         onMinimize(currentState);
       });
     }
-  }, [mode, onMinimize, minimizeTargetPosition, visibilityProgress, bottomSheetTranslateY, floatingScale, floatingPosition]);
+  }, [mode, onMinimize, minimizeTargetPosition, enablePersistence, persistenceKey, visibilityProgress, bottomSheetTranslateY, floatingScale, floatingPosition]);
   const lastMinimizeRequest = useRef(minimizeRequest);
   useEffect(() => {
     if (lastMinimizeRequest.current === minimizeRequest) return;
@@ -1329,7 +1276,11 @@ const JsModalComponent = ({
             paddingBottom: footerHeight
           },
           showsVerticalScrollIndicator: true,
-          nestedScrollEnabled: true,
+          nestedScrollEnabled: true
+          // Without this, a tap on a button while the keyboard is up only
+          // dismisses the keyboard: typing a URL and tapping Load did nothing.
+          ,
+          keyboardShouldPersistTaps: "handled",
           children: children
         }), footer ? /*#__PURE__*/_jsx(View, {
           style: footerStyles.footerContainer,
@@ -1443,6 +1394,7 @@ const JsModalComponent = ({
             },
             showsVerticalScrollIndicator: true,
             nestedScrollEnabled: true,
+            keyboardShouldPersistTaps: "handled",
             children: children
           }), footer ? /*#__PURE__*/_jsx(View, {
             style: footerStyles.footerContainer,

package/lib/module/JsModal.web.js

@@ -11,7 +11,7 @@ import { AccountSetup } from "./license/AccountSetup";
  * native file. Zero react-native imports — header chrome that lives in
  * shared-ui RN components (`WindowControls`, `DraggableHeader`, `ModalHeader`,
  * `ModalHintBanner`) is replicated as DOM with provenance comments, the same
- * way DevToolsSettingsModal.web.tsx replicates the WindowControls close dot.
+ * way the browser host supplies DOM positioning.
  *
  * Gesture spec (verbatim from native):
  * - Sheet header drag: steal at |dy| > 3px, absolute finger anchoring
@@ -26,17 +26,8 @@ import { AccountSetup } from "./license/AccountSetup";
  * - Header taps (both modes): taps accumulate within a 500ms window and
  *   settle after 300ms — 2 taps toggles mode, ≥3 taps minimizes.
  *
- * Persistence (verbatim from native ModalStorage): the `persistenceKey` prop
- * is the storage key, used verbatim (native callers pass fully-derived
- * `@react_buoy…` keys or short keys — no extra derivation happens here
- * either). JSON shape `{ mode, panelHeight, dimensions: {width, height, top,
- * left}, isVisible }`, saved on a 500ms debounce after state loads, with the
- * same in-memory cache in front of storage. Backed by a local
- * localStorage adapter matching the `persistentStorage` API — importing
- * `./utils/persistentStorage` is avoided on purpose: its lazy `require()`
- * probing of expo-file-system/AsyncStorage doesn't survive Vite's ESM graph.
- * The hint-acknowledged flag uses the real `devToolsStorageKeys` helper
- * (zero-dep) so the key matches native exactly.
+ * Persistence uses the shared ModalStorage implementation and platform storage.
+ * State is saved on a 500ms debounce, with an immediate save on minimize.
  *
  * Intentional deviations from the native file (all logged):
  * - No native-driver springs: rAF drives all animations. The open/close
@@ -56,14 +47,12 @@ import { AccountSetup } from "./license/AccountSetup";
  *   WKWebView) doesn't bake in a 0×0 screen.
  * - Safe-area insets come from a one-shot `env(safe-area-inset-*)` probe
  *   (same trick as floatingTools.web.tsx) instead of the RN hook.
- * - On restore-from-minimize, the floating position re-syncs from the last
- *   committed dimensions when the panel becomes visible: the web AppHost
- *   doesn't pass `initialModalState` back, and without the re-sync the panel
- *   would reappear at the minimize target.
+ * - On restore, the floating position re-syncs from the saved dimensions.
+ *   Some tool components do not forward `initialModalState`.
  * - `JsModalProps` is additionally exported (native keeps it private) so web
  *   consumers can type wrappers without redeclaring the contract.
- * - `visible={false}` renders children in a `display:none` div (state and
- *   listeners survive) instead of native's offscreen −9999 container.
+ * - `visible={false}` hides the content in a `display:none` container.
+ *   Tool state that must survive shell changes belongs above this component.
  * - The hidden/floating/bottomSheet root branches carry distinct React keys:
  *   the rAF animations write opacity/transform straight to the DOM, and DOM
  *   reuse across branches (e.g. an async persisted-mode flip mid-entrance)
@@ -73,6 +62,8 @@ import { AccountSetup } from "./license/AccountSetup";
  */
 
 import { useState, useRef, useEffect, useLayoutEffect, useCallback, memo, isValidElement, cloneElement } from "react";
+import { persistentStorage as webPersistentStorage } from "./utils/persistentStorage";
+import { ModalStorage } from "./utils/modalStorage.js";
 import { devToolsStorageKeys } from "./storage/devToolsStorageKeys.js";
 import { useHintsDisabled } from "./context/index.js";
 // RN component, but safe here: every consumer of the web modal (desktop
@@ -130,59 +121,6 @@ const screenH = () => typeof window !== "undefined" ? window.innerHeight : 0;
 // STORAGE — exact native ModalStorage semantics over localStorage
 // ============================================================================
 
-/**
- * Local localStorage-backed adapter matching the shared `persistentStorage`
- * API surface JsModal uses (getItem/setItem). Same recipe as the app shims
- * (example-tauri/src/shims/shared-ui.web.ts).
- */
-const webPersistentStorage = {
-  async getItem(key) {
-    try {
-      return window.localStorage.getItem(key);
-    } catch {
-      return null;
-    }
-  },
-  async setItem(key, value) {
-    try {
-      window.localStorage.setItem(key, value);
-    } catch {
-      // Best-effort, like native's swallowed save errors.
-    }
-  }
-};
-
-/** Persisted JSON shape — identical to native `PersistedModalState`. */
-
-/** Native `ModalStorage` twin: memory cache in front of persistent storage. */
-class ModalStorage {
-  static memoryCache = {};
-  static async save(key, value) {
-    try {
-      this.memoryCache[key] = value;
-      await webPersistentStorage.setItem(key, JSON.stringify(value));
-    } catch {
-      // Failed to save modal state
-    }
-  }
-  static async load(key) {
-    try {
-      if (this.memoryCache[key]) {
-        return this.memoryCache[key];
-      }
-      const stored = await webPersistentStorage.getItem(key);
-      if (stored) {
-        const parsed = JSON.parse(stored);
-        this.memoryCache[key] = parsed;
-        return parsed;
-      }
-    } catch {
-      // Failed to load modal state
-    }
-    return null;
-  }
-}
-
 // ============================================================================
 // TYPES — same exported names as native
 // ============================================================================
@@ -404,8 +342,8 @@ const WC_COLORS = {
   minimize: "#FEBC2E",
   toggleMode: "#28C840"
 };
-const WC_BUTTON_SIZE = 12; // native BUTTON_SIZE
-const WC_BUTTON_SPACING = 8; // native BUTTON_SPACING
+const WC_BUTTON_SIZE = 24;
+const WC_BUTTON_SPACING = 2;
 const WC_ICON_SIZE = 8; // native ICON_SIZE
 
 const wcDotStyle = bg => ({
@@ -415,7 +353,7 @@ const wcDotStyle = bg => ({
   display: "flex",
   alignItems: "center",
   justifyContent: "center",
-  backgroundColor: bg,
+  background: `radial-gradient(circle, ${bg} 6px, transparent 6px)`,
   border: "none",
   padding: 0,
   cursor: "pointer",
@@ -488,10 +426,10 @@ const DragIndicator = /*#__PURE__*/memo(function DragIndicator({
       alignItems: "center",
       position: "relative",
       // native dragIndicatorContainer: paddingVertical 8; custom variant
-      // claims the 20pt window-controls band (native WINDOW_CONTROLS_BAND)
+      // reserves room for the browser window controls
       // so the header row below can run the full width.
       justifyContent: hasCustomContent ? "center" : undefined,
-      minHeight: hasCustomContent ? 20 : undefined,
+      minHeight: hasCustomContent ? 32 : undefined,
       paddingTop: hasCustomContent ? 0 : 8,
       paddingBottom: hasCustomContent ? 0 : 8,
       backgroundColor: "transparent"
@@ -766,6 +704,8 @@ const JsModalComponent = ({
   const [insets] = useState(readSafeAreaInsets);
   const [isStateLoaded, setIsStateLoaded] = useState(!enablePersistence);
   const [mode, setMode] = useState(initialMode);
+  const onModeChangeRef = useRef(onModeChange);
+  onModeChangeRef.current = onModeChange;
   const [isResizing, setIsResizing] = useState(false);
   const [isDragging, setIsDragging] = useState(false);
   const [panelHeight, setPanelHeight] = useState(initialHeight);
@@ -819,7 +759,7 @@ const JsModalComponent = ({
       if (mounted && savedState) {
         if (savedState.mode) {
           setMode(savedState.mode);
-          onModeChange?.(savedState.mode);
+          onModeChangeRef.current?.(savedState.mode);
         }
         if (savedState.panelHeight) {
           setPanelHeight(savedState.panelHeight);
@@ -843,7 +783,7 @@ const JsModalComponent = ({
       mounted = false;
     };
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [persistenceKey, enablePersistence, onModeChange]);
+  }, [persistenceKey, enablePersistence]);
   useEffect(() => {
     if (!enablePersistence || !persistenceKey || !isStateLoaded) return;
     const timeoutId = setTimeout(() => {
@@ -898,12 +838,10 @@ const JsModalComponent = ({
   const toggleMode = useCallback(() => {
     setIsDragging(false);
     setIsResizing(false);
-    setMode(prev => {
-      const newMode = prev === "bottomSheet" ? "floating" : "bottomSheet";
-      onModeChange?.(newMode);
-      return newMode;
-    });
-  }, [onModeChange]);
+    const newMode = mode === "bottomSheet" ? "floating" : "bottomSheet";
+    setMode(newMode);
+    onModeChangeRef.current?.(newMode);
+  }, [mode]);
 
   // Belt-and-suspenders: also clear flags when mode changes (native parity).
   useEffect(() => {
@@ -924,6 +862,7 @@ const JsModalComponent = ({
         height: currentDimensionsRef.current.height
       }
     };
+    if (enablePersistence && persistenceKey) void ModalStorage.saveMinimized(persistenceKey, currentState);
 
     // native defaults: SCREEN.width - 50 / SCREEN.height - 150
     const targetX = minimizeTargetPosition?.x ?? screenW() - 50;
@@ -960,7 +899,7 @@ const JsModalComponent = ({
         el.style.transform = `translate(${x}px, ${y}px)`;
       }, () => onMinimize(currentState)));
     }
-  }, [mode, onMinimize, minimizeTargetPosition, cancelAnims]);
+  }, [mode, onMinimize, minimizeTargetPosition, cancelAnims, enablePersistence, persistenceKey]);
   const lastMinimizeRequest = useRef(minimizeRequest);
   useEffect(() => {
     if (lastMinimizeRequest.current === minimizeRequest) return;
@@ -973,7 +912,7 @@ const JsModalComponent = ({
     if (!initialModalState) return;
     if (initialModalState.mode) {
       setMode(initialModalState.mode);
-      onModeChange?.(initialModalState.mode);
+      onModeChangeRef.current?.(initialModalState.mode);
     }
     if (initialModalState.panelHeight) {
       setPanelHeight(initialModalState.panelHeight);
@@ -1020,9 +959,7 @@ const JsModalComponent = ({
     } else {
       const el = floatRef.current;
       if (!el) return;
-      // Restore-from-minimize deviation (see header): re-sync position from
-      // the last committed rect so the panel doesn't reopen at the minimize
-      // target the web AppHost never restores via initialModalState.
+      // Restore the saved position after the minimize animation.
       posRef.current = {
         x: currentDimensionsRef.current.left,
         y: currentDimensionsRef.current.top
@@ -1080,7 +1017,7 @@ const JsModalComponent = ({
     if (mode !== "bottomSheet") return;
     // Ignore clicks on interactive header children (window controls live
     // outside the header, but custom content may contain buttons).
-    if (e.target.closest("button")) return;
+    if (e.button !== 0 || e.target.closest('button, a, input, textarea, select, [role="button"], [role="tab"], [role="switch"], [contenteditable="true"], [tabindex]')) return;
     const g = sheetGestureRef.current;
     g.active = true;
     g.resizing = false;
@@ -1185,7 +1122,7 @@ const JsModalComponent = ({
   const handleFloatPointerDown = useCallback(e => {
     // native: DraggableHeader enabled = mode === "floating" && !isResizing
     if (mode !== "floating" || isResizing) return;
-    if (e.target.closest("button")) return;
+    if (e.button !== 0 || e.target.closest('button, a, input, textarea, select, [role="button"], [role="tab"], [role="switch"], [contenteditable="true"], [tabindex]')) return;
     const g = dragGestureRef.current;
     g.active = true;
     g.dragging = false;

package/lib/module/clipboard/autoDetectClipboard.js

@@ -19,10 +19,10 @@
  */
 
 // Re-export everything from the generated implementation
-export { clipboardFunction, clipboardType, isClipboardAvailable } from "./clipboard-impl.js";
+export { clipboardFunction, clipboardType, isClipboardAvailable } from "./clipboard-impl";
 
 // For backwards compatibility, also export these wrapper functions
-import { clipboardFunction, isClipboardAvailable as _isClipboardAvailable } from "./clipboard-impl.js";
+import { clipboardFunction, isClipboardAvailable as _isClipboardAvailable } from "./clipboard-impl";
 
 /**
  * Attempts to auto-detect and return a clipboard implementation.

package/lib/module/clipboard/clipboard-impl.web.js

@@ -0,0 +1,14 @@
+"use strict";
+
+export const isClipboardAvailable = () => typeof navigator !== "undefined" && typeof navigator.clipboard?.writeText === "function";
+export const clipboardType = () => isClipboardAvailable() ? "web" : null;
+export const clipboardFunction = async text => {
+  try {
+    if (!isClipboardAvailable()) return false;
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    // Clipboard access can be denied even in a secure context.
+    return false;
+  }
+};

package/lib/module/dataViewer/tree/TreeDiffViewer.js

@@ -291,8 +291,10 @@ function stringifyValue(value, compact = true) {
     return `"${value}"`;
   }
   if (typeof value === "number") {
-    // Format large numbers with commas for readability
-    return value.toLocaleString();
+    // The exact value. toLocaleString() added separators (1019 read as
+    // "1,019", like a string) and rounded to three decimals, so a diff could
+    // show a change that looked like nothing, or hide one that was real.
+    return String(value);
   }
   if (typeof value === "boolean") {
     return String(value);

package/lib/module/hooks/index.js

@@ -4,6 +4,6 @@ export { useFilterManager } from "./useFilterManager.js";
 export { usePersistedState, resetPersistedStateCache } from "./usePersistedState.js";
 export { useChangeLog, useSubscribedValue } from "./useChangeLog.js";
 export { useEventStoreEvents } from "./useEventStoreEvents.js";
-export { useSafeAreaInsets } from "./useSafeAreaInsets.js";
-export { getSafeAreaInsets } from "./useSafeAreaInsets.js";
+export { useSafeAreaInsets } from "./useSafeAreaInsets";
+export { getSafeAreaInsets } from "./useSafeAreaInsets";
 export { useDeviceInfo, getDeviceInfo, logDeviceInfo } from "./useDeviceInfo.js";

package/lib/module/hooks/safe-area-impl.js

@@ -3,7 +3,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-09-18T01:47:02.828Z
+ * Generated at: 2026-09-28T19:22:44.461Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/module/hooks/usePersistedState.js

@@ -1,7 +1,7 @@
 "use strict";
 
 import { useCallback, useEffect, useRef, useState } from "react";
-import { persistentStorage } from "../utils/persistentStorage.js";
+import { persistentStorage } from "../utils/persistentStorage";
 
 /**
  * Per-key cache so remounts (and multiple consumers of the same key) render

package/lib/module/hooks/useSafeAreaInsets.web.js

@@ -0,0 +1,30 @@
+"use strict";
+
+import { useEffect, useState } from "react";
+import { getSafeAreaInsets } from "../utils/getSafeAreaInsets.web.js";
+export { getSafeAreaInsets } from "../utils/getSafeAreaInsets.web.js";
+export function useSafeAreaInsets(options = {}) {
+  const [insets, setInsets] = useState({
+    top: 0,
+    bottom: 0,
+    left: 0,
+    right: 0
+  });
+  useEffect(() => {
+    const update = () => setInsets(getSafeAreaInsets());
+    update();
+    window.addEventListener("resize", update);
+    window.visualViewport?.addEventListener("resize", update);
+    return () => {
+      window.removeEventListener("resize", update);
+      window.visualViewport?.removeEventListener("resize", update);
+    };
+  }, []);
+  return {
+    top: Math.max(insets.top, options.minTop ?? 0),
+    bottom: Math.max(insets.bottom, options.minBottom ?? 0),
+    left: Math.max(insets.left, options.minLeft ?? 0),
+    right: Math.max(insets.right, options.minRight ?? 0)
+  };
+}
+export const hasNotch = () => getSafeAreaInsets().hasNotch;

package/lib/module/icons/index.js

@@ -59,4 +59,5 @@ Trash2Glyph as Trash, UnlockGlyph as Unlock, UploadGlyph as Upload, UserGlyph as
 export { SentryIcon, EventsIcon, RoutesIcon, RoutePinIcon, RoutePathIcon, RouteDotIcon, RouteTwoPinsIcon, CameraIcon, HighlightIcon, ReduxIcon, StorageIcon, AskBuoyIcon, HighlighterIcon, QueryIcon, ScenariosIcon } from "@buoy-gg/floating-tools-core";
 // `WifiIcon` here stays the lucide glyph (react-query's online toggle); the BIF wifi ships as
 // `WifiBifIcon`. `BenchmarkIcon` IS the BIF stopwatch since 2026-09-04 (perf-monitor's dial icon).
-export { WifiIcon as WifiBifIcon, BenchmarkIcon, BENCHMARK_ICON_COLOR } from "@buoy-gg/floating-tools-core";
+export { WifiIcon as WifiBifIcon, BenchmarkIcon, BENCHMARK_ICON_COLOR } from "@buoy-gg/floating-tools-core";
+export { NotificationsIcon, NOTIFICATIONS_ICON_COLOR } from "@buoy-gg/floating-tools-core";

package/lib/module/index.js

@@ -52,6 +52,9 @@ Subscribable,
 subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange,
 // Safe expo-router wrappers (falls back to no-ops on RN CLI)
 useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable } from "./utils/index.js";
+export * from "./utils/toolModules.js";
+export { registerBrowserRouter, browserRouter, subscribeBrowserNavigation } from "./utils/browserNavigation.js";
+
 // Time Machine snapshot-provider kit (restore scope, verdict ladder, result shapes)
 export { PREVIEW_ITEM_RENDER_BYTE_LIMIT, createRestoreScope, emptyRestoreResult, failedRestore, skippedRestore, classifyPreviewItem, wontApply, unionKeys } from "./utils/snapshotProviderKit.js";