@buoy-gg/shared-ui 2.1.3 → 2.1.4-beta.1

package/lib/commonjs/clipboard/clipboard-impl.js

@@ -5,22 +5,98 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.isClipboardAvailable = exports.clipboardType = exports.clipboardFunction = void 0;
 /**
- * Auto-generated clipboard implementation
- * Detected: none
- * Generated at: 2026-02-03T00:33:15.804Z
+ * Runtime clipboard implementation
  *
- * DO NOT EDIT - This file is generated by scripts/detect-clipboard.js
+ * Uses Metro's allowOptionalDependencies with top-level try-catch
+ * so Metro marks these requires as optional (skipped if not installed).
  *
- * No clipboard library found. Install one of:
- * - expo-clipboard (for Expo projects)
- * - @react-native-clipboard/clipboard (for RN CLI projects)
+ * We grab module references eagerly (for Metro), but detect which one
+ * actually works lazily on first use — by trying to call it. This avoids
+ * NativeModules checks which don't work with TurboModules/new architecture.
+ *
+ * Consumers must set `transformer.allowOptionalDependencies = true`
+ * in their metro.config.js for this to work.
+ *
+ * Fallback chain:
+ * 1. expo-clipboard
+ * 2. @react-native-clipboard/clipboard
+ * 3. Graceful failure
  */
 
-const clipboardType = exports.clipboardType = null;
-const isClipboardAvailable = () => false;
+// Grab module references at load time (top-level try-catch for Metro)
+// Always require both — we decide which actually works at call time
+let _expoClipboard = null;
+try {
+  _expoClipboard = require("expo-clipboard");
+} catch {}
+let _rnClipboard = null;
+try {
+  const mod = require("@react-native-clipboard/clipboard");
+  _rnClipboard = mod.default || mod;
+} catch {}
+
+// Lazy detection: resolved on first clipboardFunction() call
+let _detectedType = null;
+let _clipboardFn = null;
+let _detected = false;
+async function detect(text) {
+  // 1. Try expo-clipboard by actually calling it
+  if (_expoClipboard && typeof _expoClipboard.setStringAsync === "function") {
+    try {
+      await _expoClipboard.setStringAsync(text);
+      _detectedType = "expo";
+      _clipboardFn = async t => {
+        await _expoClipboard.setStringAsync(t);
+        return true;
+      };
+      _detected = true;
+      return true;
+    } catch {}
+  }
+
+  // 2. Try @react-native-clipboard/clipboard
+  if (_rnClipboard && typeof _rnClipboard.setString === "function") {
+    try {
+      _rnClipboard.setString(text);
+      _detectedType = "react-native";
+      _clipboardFn = async t => {
+        _rnClipboard.setString(t);
+        return true;
+      };
+      _detected = true;
+      return true;
+    } catch {}
+  }
+  _detected = true;
+  return false;
+}
+const clipboardType = () => {
+  return _detectedType;
+};
+exports.clipboardType = clipboardType;
+const isClipboardAvailable = () => {
+  // Before first use, optimistically return true if we have a module ref
+  if (!_detected) return _expoClipboard != null || _rnClipboard != null;
+  return _clipboardFn != null;
+};
 exports.isClipboardAvailable = isClipboardAvailable;
 const clipboardFunction = async text => {
-  console.error("[RnBetterDevTools] Copy failed: No clipboard library found.\n" + `Attempted to copy: ${text.substring(0, 50)}${text.length > 50 ? "..." : ""}\n` + "Install expo-clipboard or @react-native-clipboard/clipboard, or provide a custom onCopy function.");
+  // If already detected, use the cached function
+  if (_detected && _clipboardFn) {
+    try {
+      return await _clipboardFn(text);
+    } catch (error) {
+      console.error("[buoy] Clipboard copy failed:", error);
+      return false;
+    }
+  }
+
+  // First call: detect which clipboard works by actually trying it
+  if (!_detected) {
+    const result = await detect(text);
+    if (result) return true;
+  }
+  console.warn("[buoy] No clipboard library available. Install expo-clipboard or @react-native-clipboard/clipboard.");
   return false;
 };
 exports.clipboardFunction = clipboardFunction;

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

@@ -7,7 +7,7 @@ exports.useNativeSafeAreaInsets = exports.safeAreaType = exports.hasSafeAreaPack
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-02-03T00:33:15.829Z
+ * Generated at: 2026-02-11T19:07:44.917Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/commonjs/index.js

@@ -30,6 +30,12 @@ var _exportNames = {
   subscriberCountNotifier: true,
   subscribeToSubscriberCountChanges: true,
   notifySubscriberCountChange: true,
+  useSafeRouter: true,
+  useSafePathname: true,
+  useSafeSegments: true,
+  useSafeGlobalSearchParams: true,
+  getSafeRouter: true,
+  isExpoRouterAvailable: true,
   isPlainObjectUtil: true,
   useSafeAreaInsets: true,
   useFilterManager: true,
@@ -202,6 +208,12 @@ Object.defineProperty(exports, "getSafeAreaInsets", {
     return _index3.getSafeAreaInsets;
   }
 });
+Object.defineProperty(exports, "getSafeRouter", {
+  enumerable: true,
+  get: function () {
+    return _index3.getSafeRouter;
+  }
+});
 Object.defineProperty(exports, "getStorageBackendType", {
   enumerable: true,
   get: function () {
@@ -244,6 +256,12 @@ Object.defineProperty(exports, "isEmpty", {
     return _index3.isEmpty;
   }
 });
+Object.defineProperty(exports, "isExpoRouterAvailable", {
+  enumerable: true,
+  get: function () {
+    return _index3.isExpoRouterAvailable;
+  }
+});
 Object.defineProperty(exports, "isJsonSerializable", {
   enumerable: true,
   get: function () {
@@ -376,6 +394,30 @@ Object.defineProperty(exports, "useSafeAreaInsets", {
     return _index1.useSafeAreaInsets;
   }
 });
+Object.defineProperty(exports, "useSafeGlobalSearchParams", {
+  enumerable: true,
+  get: function () {
+    return _index3.useSafeGlobalSearchParams;
+  }
+});
+Object.defineProperty(exports, "useSafePathname", {
+  enumerable: true,
+  get: function () {
+    return _index3.useSafePathname;
+  }
+});
+Object.defineProperty(exports, "useSafeRouter", {
+  enumerable: true,
+  get: function () {
+    return _index3.useSafeRouter;
+  }
+});
+Object.defineProperty(exports, "useSafeSegments", {
+  enumerable: true,
+  get: function () {
+    return _index3.useSafeSegments;
+  }
+});
 var _index = require("./ui/index.js");
 Object.keys(_index).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/lib/commonjs/storage/devToolsStorageKeys.js

@@ -197,11 +197,16 @@ const LEGACY_DEV_TOOL_PATTERNS = ["@devtools", "@dev_tools_", "@modal_state_",
 function isDevToolsStorageKey(key) {
   if (!key) return false;
 
-  // Check if it starts with our base prefix
+  // Check if it starts with our base prefix (@react_buoy)
   if (key.startsWith(devToolsStorageKeys.base)) {
     return true;
   }
 
+  // Check for buoy- prefixed keys (modal persistence, license, etc.)
+  if (key.startsWith("buoy-")) {
+    return true;
+  }
+
   // Check for legacy dev tool keys that need cleanup
   for (const pattern of LEGACY_DEV_TOOL_PATTERNS) {
     if (key.startsWith(pattern)) {

package/lib/commonjs/utils/index.js

@@ -51,6 +51,12 @@ Object.defineProperty(exports, "getSafeAreaInsets", {
     return _getSafeAreaInsets.getSafeAreaInsets;
   }
 });
+Object.defineProperty(exports, "getSafeRouter", {
+  enumerable: true,
+  get: function () {
+    return _safeExpoRouter.getSafeRouter;
+  }
+});
 Object.defineProperty(exports, "getStorageBackendType", {
   enumerable: true,
   get: function () {
@@ -81,6 +87,12 @@ Object.defineProperty(exports, "isEmpty", {
     return _typeHelpers.isEmpty;
   }
 });
+Object.defineProperty(exports, "isExpoRouterAvailable", {
+  enumerable: true,
+  get: function () {
+    return _safeExpoRouter.isExpoRouterAvailable;
+  }
+});
 Object.defineProperty(exports, "isJsonSerializable", {
   enumerable: true,
   get: function () {
@@ -159,6 +171,30 @@ Object.defineProperty(exports, "truncateText", {
     return _valueFormatting.truncateText;
   }
 });
+Object.defineProperty(exports, "useSafeGlobalSearchParams", {
+  enumerable: true,
+  get: function () {
+    return _safeExpoRouter.useSafeGlobalSearchParams;
+  }
+});
+Object.defineProperty(exports, "useSafePathname", {
+  enumerable: true,
+  get: function () {
+    return _safeExpoRouter.useSafePathname;
+  }
+});
+Object.defineProperty(exports, "useSafeRouter", {
+  enumerable: true,
+  get: function () {
+    return _safeExpoRouter.useSafeRouter;
+  }
+});
+Object.defineProperty(exports, "useSafeSegments", {
+  enumerable: true,
+  get: function () {
+    return _safeExpoRouter.useSafeSegments;
+  }
+});
 var _displayValue = require("./displayValue.js");
 var _getSafeAreaInsets = require("./getSafeAreaInsets.js");
 var _persistentStorage = require("./persistentStorage.js");
@@ -167,4 +203,5 @@ var _typeHelpers = require("./typeHelpers.js");
 var _valueFormatting = require("./valueFormatting.js");
 var _loadOptionalModule = require("./loadOptionalModule.js");
 var _subscribable = require("./subscribable.js");
-var _subscriberCountNotifier = require("./subscriberCountNotifier.js");
+var _subscriberCountNotifier = require("./subscriberCountNotifier.js");
+var _safeExpoRouter = require("./safeExpoRouter.js");

package/lib/commonjs/utils/safeExpoRouter.js

@@ -0,0 +1,172 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getSafeRouter = getSafeRouter;
+exports.isExpoRouterAvailable = isExpoRouterAvailable;
+exports.useSafeGlobalSearchParams = useSafeGlobalSearchParams;
+exports.useSafePathname = useSafePathname;
+exports.useSafeRouter = useSafeRouter;
+exports.useSafeSegments = useSafeSegments;
+var _reactNative = require("react-native");
+/**
+ * Safe wrapper for expo-router
+ *
+ * Provides optional imports for expo-router hooks and utilities.
+ * Falls back to no-op implementations when expo-router is not installed.
+ *
+ * On RN CLI (without Expo native modules), expo-router's JS may be bundled but
+ * its hooks crash at runtime because native Expo modules are missing.
+ * We detect the Expo native runtime before attempting to use expo-router hooks.
+ */
+
+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() {
+  // Check legacy NativeModules bridge (Expo SDK < 54)
+  if (_reactNative.NativeModules.ExpoLinking) {
+    return true;
+  }
+
+  // Check for Expo Modules Core native bridge (Expo SDK 51+)
+  // NativeUnimoduleProxy is registered by expo-modules-core on both old and new arch
+  if (_reactNative.NativeModules.NativeUnimoduleProxy) {
+    return true;
+  }
+
+  // Check for Expo Go app
+  if (_reactNative.NativeModules.ExpoGoModule || _reactNative.NativeModules.ExpoUpdates) {
+    return true;
+  }
+
+  // Fallback: try loading expo-modules-core which is required by all Expo native modules
+  try {
+    require("expo-modules-core");
+    return true;
+  } catch {
+    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");
+    isAvailable = expoRouter != null && typeof expoRouter.usePathname === "function" && typeof expoRouter.useSegments === "function";
+  } catch (error) {
+    isAvailable = false;
+    expoRouter = null;
+  }
+  checkedAvailability = true;
+  return isAvailable;
+}
+
+// ============================================================================
+// No-op implementations when expo-router is not available
+// ============================================================================
+
+function noOpUseRouter() {
+  return {
+    push: () => console.warn("[buoy] expo-router not installed: push() unavailable"),
+    replace: () => console.warn("[buoy] expo-router not installed: replace() unavailable"),
+    back: () => console.warn("[buoy] expo-router not installed: back() unavailable"),
+    canGoBack: () => false,
+    setParams: () => console.warn("[buoy] expo-router not installed: setParams() unavailable"),
+    navigate: () => console.warn("[buoy] expo-router not installed: navigate() unavailable")
+  };
+}
+function noOpUsePathname() {
+  return "/";
+}
+function noOpUseSegments() {
+  return [];
+}
+function noOpUseGlobalSearchParams() {
+  return {};
+}
+
+// ============================================================================
+// Safe hook exports
+// ============================================================================
+
+function useSafeRouter() {
+  if (!checkExpoRouterAvailability()) {
+    return noOpUseRouter();
+  }
+  try {
+    return expoRouter.useRouter();
+  } catch (error) {
+    console.warn("[buoy] Failed to use expo-router.useRouter:", error);
+    return noOpUseRouter();
+  }
+}
+function useSafePathname() {
+  if (!checkExpoRouterAvailability()) {
+    return noOpUsePathname();
+  }
+  try {
+    return expoRouter.usePathname();
+  } catch (error) {
+    console.warn("[buoy] Failed to use expo-router.usePathname:", error);
+    return noOpUsePathname();
+  }
+}
+function useSafeSegments() {
+  if (!checkExpoRouterAvailability()) {
+    return noOpUseSegments();
+  }
+  try {
+    return expoRouter.useSegments();
+  } catch (error) {
+    console.warn("[buoy] Failed to use expo-router.useSegments:", error);
+    return noOpUseSegments();
+  }
+}
+function useSafeGlobalSearchParams() {
+  if (!checkExpoRouterAvailability()) {
+    return noOpUseGlobalSearchParams();
+  }
+  try {
+    return expoRouter.useGlobalSearchParams();
+  } catch (error) {
+    console.warn("[buoy] Failed to use expo-router.useGlobalSearchParams:", error);
+    return noOpUseGlobalSearchParams();
+  }
+}
+
+// ============================================================================
+// Router instance getter (for imperative navigation)
+// ============================================================================
+
+function getSafeRouter() {
+  if (!checkExpoRouterAvailability()) {
+    return null;
+  }
+  try {
+    return expoRouter.router || null;
+  } catch (error) {
+    return null;
+  }
+}
+
+// ============================================================================
+// Availability check
+// ============================================================================
+
+function isExpoRouterAvailable() {
+  return checkExpoRouterAvailability();
+}

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

@@ -1,20 +1,95 @@
 "use strict";
 
 /**
- * Auto-generated clipboard implementation
- * Detected: none
- * Generated at: 2026-02-03T00:33:15.804Z
+ * Runtime clipboard implementation
  *
- * DO NOT EDIT - This file is generated by scripts/detect-clipboard.js
+ * Uses Metro's allowOptionalDependencies with top-level try-catch
+ * so Metro marks these requires as optional (skipped if not installed).
  *
- * No clipboard library found. Install one of:
- * - expo-clipboard (for Expo projects)
- * - @react-native-clipboard/clipboard (for RN CLI projects)
+ * We grab module references eagerly (for Metro), but detect which one
+ * actually works lazily on first use — by trying to call it. This avoids
+ * NativeModules checks which don't work with TurboModules/new architecture.
+ *
+ * Consumers must set `transformer.allowOptionalDependencies = true`
+ * in their metro.config.js for this to work.
+ *
+ * Fallback chain:
+ * 1. expo-clipboard
+ * 2. @react-native-clipboard/clipboard
+ * 3. Graceful failure
  */
 
-export const clipboardType = null;
-export const isClipboardAvailable = () => false;
+// Grab module references at load time (top-level try-catch for Metro)
+// Always require both — we decide which actually works at call time
+let _expoClipboard = null;
+try {
+  _expoClipboard = require("expo-clipboard");
+} catch {}
+let _rnClipboard = null;
+try {
+  const mod = require("@react-native-clipboard/clipboard");
+  _rnClipboard = mod.default || mod;
+} catch {}
+
+// Lazy detection: resolved on first clipboardFunction() call
+let _detectedType = null;
+let _clipboardFn = null;
+let _detected = false;
+async function detect(text) {
+  // 1. Try expo-clipboard by actually calling it
+  if (_expoClipboard && typeof _expoClipboard.setStringAsync === "function") {
+    try {
+      await _expoClipboard.setStringAsync(text);
+      _detectedType = "expo";
+      _clipboardFn = async t => {
+        await _expoClipboard.setStringAsync(t);
+        return true;
+      };
+      _detected = true;
+      return true;
+    } catch {}
+  }
+
+  // 2. Try @react-native-clipboard/clipboard
+  if (_rnClipboard && typeof _rnClipboard.setString === "function") {
+    try {
+      _rnClipboard.setString(text);
+      _detectedType = "react-native";
+      _clipboardFn = async t => {
+        _rnClipboard.setString(t);
+        return true;
+      };
+      _detected = true;
+      return true;
+    } catch {}
+  }
+  _detected = true;
+  return false;
+}
+export const clipboardType = () => {
+  return _detectedType;
+};
+export const isClipboardAvailable = () => {
+  // Before first use, optimistically return true if we have a module ref
+  if (!_detected) return _expoClipboard != null || _rnClipboard != null;
+  return _clipboardFn != null;
+};
 export const clipboardFunction = async text => {
-  console.error("[RnBetterDevTools] Copy failed: No clipboard library found.\n" + `Attempted to copy: ${text.substring(0, 50)}${text.length > 50 ? "..." : ""}\n` + "Install expo-clipboard or @react-native-clipboard/clipboard, or provide a custom onCopy function.");
+  // If already detected, use the cached function
+  if (_detected && _clipboardFn) {
+    try {
+      return await _clipboardFn(text);
+    } catch (error) {
+      console.error("[buoy] Clipboard copy failed:", error);
+      return false;
+    }
+  }
+
+  // First call: detect which clipboard works by actually trying it
+  if (!_detected) {
+    const result = await detect(text);
+    if (result) return true;
+  }
+  console.warn("[buoy] No clipboard library available. Install expo-clipboard or @react-native-clipboard/clipboard.");
   return false;
 };

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

@@ -3,7 +3,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-02-03T00:33:15.829Z
+ * Generated at: 2026-02-11T19:07:44.917Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/module/index.js

@@ -25,7 +25,9 @@ loadOptionalModule, getCachedOptionalModule,
 // Subscribable base class for self-managing listeners
 Subscribable,
 // Subscriber count notifier for cross-package notifications
-subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange } from "./utils/index.js";
+subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange,
+// Safe expo-router wrappers (falls back to no-ops on RN CLI)
+useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, isExpoRouterAvailable } from "./utils/index.js";
 
 // Also export formatting utils
 export * from "./utils/formatting/index.js";

package/lib/module/storage/devToolsStorageKeys.js

@@ -190,11 +190,16 @@ const LEGACY_DEV_TOOL_PATTERNS = ["@devtools", "@dev_tools_", "@modal_state_",
 export function isDevToolsStorageKey(key) {
   if (!key) return false;
 
-  // Check if it starts with our base prefix
+  // Check if it starts with our base prefix (@react_buoy)
   if (key.startsWith(devToolsStorageKeys.base)) {
     return true;
   }
 
+  // Check for buoy- prefixed keys (modal persistence, license, etc.)
+  if (key.startsWith("buoy-")) {
+    return true;
+  }
+
   // Check for legacy dev tool keys that need cleanup
   for (const pattern of LEGACY_DEV_TOOL_PATTERNS) {
     if (key.startsWith(pattern)) {

package/lib/module/utils/index.js

@@ -8,4 +8,5 @@ export { getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstruc
 export { parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath } from "./valueFormatting.js";
 export { loadOptionalModule, getCachedOptionalModule } from "./loadOptionalModule.js";
 export { Subscribable } from "./subscribable.js";
-export { subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange } from "./subscriberCountNotifier.js";
+export { subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange } from "./subscriberCountNotifier.js";
+export { useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, isExpoRouterAvailable } from "./safeExpoRouter.js";