@buoy-gg/shared-ui 7.0.21 → 7.0.22

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-08-15T04:40:03.239Z
+ * Generated at: 2026-08-18T00:32:52.026Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/commonjs/index.js

@@ -39,6 +39,7 @@ var _exportNames = {
   scheduleReloadApp: true,
   resolveReloadStrategy: true,
   REMOTE_RELOAD_DELAY_MS: true,
+  getDevServerOrigin: true,
   Subscribable: true,
   subscriberCountNotifier: true,
   subscribeToSubscriberCountChanges: true,
@@ -49,6 +50,7 @@ var _exportNames = {
   useSafeGlobalSearchParams: true,
   getSafeRouter: true,
   getSafeCurrentPathname: true,
+  getSafeCurrentRoute: true,
   isExpoRouterAvailable: true,
   isPlainObjectUtil: true,
   useSafeAreaInsets: true,
@@ -225,6 +227,12 @@ Object.defineProperty(exports, "getConstructorName", {
     return _index3.getConstructorName;
   }
 });
+Object.defineProperty(exports, "getDevServerOrigin", {
+  enumerable: true,
+  get: function () {
+    return _index3.getDevServerOrigin;
+  }
+});
 Object.defineProperty(exports, "getDeviceInfo", {
   enumerable: true,
   get: function () {
@@ -249,6 +257,12 @@ Object.defineProperty(exports, "getSafeCurrentPathname", {
     return _index3.getSafeCurrentPathname;
   }
 });
+Object.defineProperty(exports, "getSafeCurrentRoute", {
+  enumerable: true,
+  get: function () {
+    return _index3.getSafeCurrentRoute;
+  }
+});
 Object.defineProperty(exports, "getSafeRouter", {
   enumerable: true,
   get: function () {

package/lib/commonjs/utils/devServer.js

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getDevServerOrigin = getDevServerOrigin;
+/**
+ * devServer
+ *
+ * Origin of the Metro/Expo dev server that served this bundle, e.g.
+ * `http://192.168.1.20:8081`.
+ *
+ * Why a remote driver wants it: reloading the app normally runs IN the app
+ * (`DevSettings.reload()`), which is exactly what stops working when the app
+ * has crashed — a fatal render error unmounts the tree, so no JS action can be
+ * answered and the one command that would recover the app is unreachable. The
+ * dev server's message socket reloads through the NATIVE side instead (it is
+ * what the `r` key and the redbox's Reload button use), so a driver that knows
+ * this origin can recover an app that can no longer help itself.
+ *
+ * Reported once, while the app is healthy, so it is already known by the time
+ * it's needed.
+ */
+
+const ORIGIN_RE = /^(https?:\/\/[^/]+)/;
+
+/** Bundle URL this JS realm was loaded from, or null off React Native. */
+function scriptURL() {
+  try {
+    // Requires stay lexically inside try{} so Metro treats them as optional —
+    // react-native-web has neither path and falls through to null.
+    const NativeSourceCode =
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    require("react-native/Libraries/NativeModules/specs/NativeSourceCode").default;
+    const url = NativeSourceCode?.getConstants?.().scriptURL;
+    if (url) return url;
+  } catch {
+    // RN internals moved, or old architecture — try NativeModules below.
+  }
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const {
+      NativeModules
+    } = require("react-native");
+    const url = NativeModules?.SourceCode?.getConstants?.().scriptURL ?? NativeModules?.SourceCode?.scriptURL;
+    if (url) return url;
+  } catch {
+    // not React Native
+  }
+  return null;
+}
+
+/**
+ * `http://host:port` of the dev server, or null in production / on web (a
+ * release bundle's scriptURL is a `file://` path, which has no origin worth
+ * reporting).
+ */
+function getDevServerOrigin() {
+  const url = scriptURL();
+  if (!url || !/^https?:\/\//.test(url)) return null;
+  return url.match(ORIGIN_RE)?.[1] ?? null;
+}

package/lib/commonjs/utils/index.js

@@ -57,6 +57,12 @@ Object.defineProperty(exports, "getConstructorName", {
     return _typeHelpers.getConstructorName;
   }
 });
+Object.defineProperty(exports, "getDevServerOrigin", {
+  enumerable: true,
+  get: function () {
+    return _devServer.getDevServerOrigin;
+  }
+});
 Object.defineProperty(exports, "getRenderCaptureProvider", {
   enumerable: true,
   get: function () {
@@ -75,6 +81,12 @@ Object.defineProperty(exports, "getSafeCurrentPathname", {
     return _safeExpoRouter.getSafeCurrentPathname;
   }
 });
+Object.defineProperty(exports, "getSafeCurrentRoute", {
+  enumerable: true,
+  get: function () {
+    return _safeExpoRouter.getSafeCurrentRoute;
+  }
+});
 Object.defineProperty(exports, "getSafeRouter", {
   enumerable: true,
   get: function () {
@@ -291,6 +303,7 @@ var _renderCaptureRegistry = require("./renderCaptureRegistry.js");
 var _stateSnapshotRegistry = require("./stateSnapshotRegistry.js");
 var _minimalSuperJSON = require("./minimalSuperJSON.js");
 var _reloadApp = require("./reloadApp.js");
+var _devServer = require("./devServer.js");
 var _subscribable = require("./subscribable.js");
 var _subscriberCountNotifier = require("./subscriberCountNotifier.js");
 var _safeExpoRouter = require("./safeExpoRouter.js");

package/lib/commonjs/utils/renderCaptureRegistry.js

@@ -15,16 +15,45 @@ exports.setRenderCaptureProvider = setRenderCaptureProvider;
  * `installReaFpsGetter`.
  */
 
+/**
+ * Why a component rendered, counted across a capture window.
+ *
+ * The split between `props` and `propsUnstable` is the one that matters in
+ * practice. Both mean "my props changed", but they send you to different
+ * files: `props` is a genuine update (a value differs) and belongs to the
+ * component; `propsUnstable` means the values are equal and only the
+ * IDENTITY changed — a fresh arrow or object literal handed down by the
+ * parent every render — and the fix is always upstream. Reporting that as
+ * plain "props" is technically true and sends people into the wrong file,
+ * which is why it gets its own bucket.
+ */
+
 /** One component's aggregated renders across a capture window. */
 
 /** Result of a capture window (one benchmark recording). */
 
-let provider = null;
+/**
+ * The provider lives on a global, NOT in module scope.
+ *
+ * Package managers routinely give each @buoy-gg/* package its own nested copy
+ * of shared-ui — observed in the wild with ten identical 7.0.21 copies and
+ * nothing hoisted, simply because shared-ui was nobody's direct dependency.
+ * Module-scoped state means highlight-updates registers into its copy and
+ * perf-monitor reads a different one, so capture silently produces nothing:
+ * no error, no warning, just `renderCommits: null` in every report.
+ *
+ * A global key survives duplicate module instances. Same reasoning as
+ * external-sync's crash-flush registry.
+ */
+const PROVIDER_KEY = "__buoyRenderCaptureProvider";
+function providerHost() {
+  return globalThis;
+}
 
 /** Register (or clear with null) the active provider. Last registration wins. */
 function setRenderCaptureProvider(p) {
-  provider = p;
+  providerHost()[PROVIDER_KEY] = p;
 }
 function getRenderCaptureProvider() {
-  return provider;
+  return providerHost()[PROVIDER_KEY] ?? null;
 }

package/lib/commonjs/utils/safeExpoRouter.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getSafeCurrentPathname = getSafeCurrentPathname;
+exports.getSafeCurrentRoute = getSafeCurrentRoute;
 exports.getSafeRouter = getSafeRouter;
 exports.isExpoRouterAvailable = isExpoRouterAvailable;
 exports.useSafeGlobalSearchParams = useSafeGlobalSearchParams;
@@ -184,6 +185,7 @@ function getSafeRouter() {
 // path the require throws and the imperative fallback simply disables (callers
 // degrade to route-events history). expo-router's store exposes getRouteInfo(),
 // which returns the live pathname even before any navigation is recorded.
+
 let routerStore;
 function getRouterStore() {
   if (routerStore !== undefined) return routerStore;
@@ -205,12 +207,35 @@ function getRouterStore() {
  * can't be reached.
  */
 function getSafeCurrentPathname() {
+  return getSafeCurrentRoute()?.pathname ?? null;
+}
+
+/** A route location that can be re-visited later via {@link getSafeRouter}. */
+
+/**
+ * The current route as a re-visitable location, read imperatively from
+ * expo-router's store.
+ *
+ * Like {@link getSafeCurrentPathname} this works before any navigation has
+ * been recorded (cold start on the initial route), and returns null when
+ * expo-router isn't available or the store can't be reached.
+ */
+function getSafeCurrentRoute() {
   if (!checkExpoRouterAvailability()) {
     return null;
   }
   try {
-    const pathname = getRouterStore()?.getRouteInfo?.()?.pathname;
-    return typeof pathname === "string" && pathname.length > 0 ? pathname : null;
+    const info = getRouterStore()?.getRouteInfo?.();
+    const pathname = info?.pathname;
+    if (typeof pathname !== "string" || pathname.length === 0) return null;
+    const withParams = info?.pathnameWithParams;
+    return {
+      pathname,
+      href: typeof withParams === "string" && withParams.length > 0 ? withParams : pathname,
+      ...(Array.isArray(info?.segments) ? {
+        segments: info.segments
+      } : {})
+    };
   } catch (error) {
     return null;
   }

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

@@ -3,7 +3,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-08-15T04:40:03.239Z
+ * Generated at: 2026-08-18T00:32:52.026Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/module/index.js

@@ -33,13 +33,15 @@ registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvid
 superJsonSerialize, superJsonDeserialize,
 // JS-bundle reload (core's `app` adapter + perf-monitor's batch runner)
 reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS,
+// Dev-server origin — how a remote driver recovers an app that crashed too
+// hard to reload itself
+getDevServerOrigin,
 // Subscribable base class for self-managing listeners
 Subscribable,
 // Subscriber count notifier for cross-package notifications
 subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange,
 // Safe expo-router wrappers (falls back to no-ops on RN CLI)
-useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, isExpoRouterAvailable } from "./utils/index.js";
-
+useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable } from "./utils/index.js";
 // Also export formatting utils
 export * from "./utils/formatting/index.js";
 export * from "./utils/time/index.js";

package/lib/module/utils/devServer.js

@@ -0,0 +1,58 @@
+"use strict";
+
+/**
+ * devServer
+ *
+ * Origin of the Metro/Expo dev server that served this bundle, e.g.
+ * `http://192.168.1.20:8081`.
+ *
+ * Why a remote driver wants it: reloading the app normally runs IN the app
+ * (`DevSettings.reload()`), which is exactly what stops working when the app
+ * has crashed — a fatal render error unmounts the tree, so no JS action can be
+ * answered and the one command that would recover the app is unreachable. The
+ * dev server's message socket reloads through the NATIVE side instead (it is
+ * what the `r` key and the redbox's Reload button use), so a driver that knows
+ * this origin can recover an app that can no longer help itself.
+ *
+ * Reported once, while the app is healthy, so it is already known by the time
+ * it's needed.
+ */
+
+const ORIGIN_RE = /^(https?:\/\/[^/]+)/;
+
+/** Bundle URL this JS realm was loaded from, or null off React Native. */
+function scriptURL() {
+  try {
+    // Requires stay lexically inside try{} so Metro treats them as optional —
+    // react-native-web has neither path and falls through to null.
+    const NativeSourceCode =
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    require("react-native/Libraries/NativeModules/specs/NativeSourceCode").default;
+    const url = NativeSourceCode?.getConstants?.().scriptURL;
+    if (url) return url;
+  } catch {
+    // RN internals moved, or old architecture — try NativeModules below.
+  }
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const {
+      NativeModules
+    } = require("react-native");
+    const url = NativeModules?.SourceCode?.getConstants?.().scriptURL ?? NativeModules?.SourceCode?.scriptURL;
+    if (url) return url;
+  } catch {
+    // not React Native
+  }
+  return null;
+}
+
+/**
+ * `http://host:port` of the dev server, or null in production / on web (a
+ * release bundle's scriptURL is a `file://` path, which has no origin worth
+ * reporting).
+ */
+export function getDevServerOrigin() {
+  const url = scriptURL();
+  if (!url || !/^https?:\/\//.test(url)) return null;
+  return url.match(ORIGIN_RE)?.[1] ?? null;
+}

package/lib/module/utils/index.js

@@ -12,6 +12,7 @@ export { setRenderCaptureProvider, getRenderCaptureProvider } from "./renderCapt
 export { registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders } from "./stateSnapshotRegistry.js";
 export { serialize as superJsonSerialize, deserialize as superJsonDeserialize } from "./minimalSuperJSON.js";
 export { reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS } from "./reloadApp.js";
+export { getDevServerOrigin } from "./devServer.js";
 export { Subscribable } from "./subscribable.js";
 export { subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange } from "./subscriberCountNotifier.js";
-export { useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, isExpoRouterAvailable } from "./safeExpoRouter.js";
+export { useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable } from "./safeExpoRouter.js";

package/lib/module/utils/renderCaptureRegistry.js

@@ -10,16 +10,45 @@
  * `installReaFpsGetter`.
  */
 
+/**
+ * Why a component rendered, counted across a capture window.
+ *
+ * The split between `props` and `propsUnstable` is the one that matters in
+ * practice. Both mean "my props changed", but they send you to different
+ * files: `props` is a genuine update (a value differs) and belongs to the
+ * component; `propsUnstable` means the values are equal and only the
+ * IDENTITY changed — a fresh arrow or object literal handed down by the
+ * parent every render — and the fix is always upstream. Reporting that as
+ * plain "props" is technically true and sends people into the wrong file,
+ * which is why it gets its own bucket.
+ */
+
 /** One component's aggregated renders across a capture window. */
 
 /** Result of a capture window (one benchmark recording). */
 
-let provider = null;
+/**
+ * The provider lives on a global, NOT in module scope.
+ *
+ * Package managers routinely give each @buoy-gg/* package its own nested copy
+ * of shared-ui — observed in the wild with ten identical 7.0.21 copies and
+ * nothing hoisted, simply because shared-ui was nobody's direct dependency.
+ * Module-scoped state means highlight-updates registers into its copy and
+ * perf-monitor reads a different one, so capture silently produces nothing:
+ * no error, no warning, just `renderCommits: null` in every report.
+ *
+ * A global key survives duplicate module instances. Same reasoning as
+ * external-sync's crash-flush registry.
+ */
+const PROVIDER_KEY = "__buoyRenderCaptureProvider";
+function providerHost() {
+  return globalThis;
+}
 
 /** Register (or clear with null) the active provider. Last registration wins. */
 export function setRenderCaptureProvider(p) {
-  provider = p;
+  providerHost()[PROVIDER_KEY] = p;
 }
 export function getRenderCaptureProvider() {
-  return provider;
+  return providerHost()[PROVIDER_KEY] ?? null;
 }

package/lib/module/utils/safeExpoRouter.js

@@ -174,6 +174,7 @@ export function getSafeRouter() {
 // path the require throws and the imperative fallback simply disables (callers
 // degrade to route-events history). expo-router's store exposes getRouteInfo(),
 // which returns the live pathname even before any navigation is recorded.
+
 let routerStore;
 function getRouterStore() {
   if (routerStore !== undefined) return routerStore;
@@ -195,12 +196,35 @@ function getRouterStore() {
  * can't be reached.
  */
 export function getSafeCurrentPathname() {
+  return getSafeCurrentRoute()?.pathname ?? null;
+}
+
+/** A route location that can be re-visited later via {@link getSafeRouter}. */
+
+/**
+ * The current route as a re-visitable location, read imperatively from
+ * expo-router's store.
+ *
+ * Like {@link getSafeCurrentPathname} this works before any navigation has
+ * been recorded (cold start on the initial route), and returns null when
+ * expo-router isn't available or the store can't be reached.
+ */
+export function getSafeCurrentRoute() {
   if (!checkExpoRouterAvailability()) {
     return null;
   }
   try {
-    const pathname = getRouterStore()?.getRouteInfo?.()?.pathname;
-    return typeof pathname === "string" && pathname.length > 0 ? pathname : null;
+    const info = getRouterStore()?.getRouteInfo?.();
+    const pathname = info?.pathname;
+    if (typeof pathname !== "string" || pathname.length === 0) return null;
+    const withParams = info?.pathnameWithParams;
+    return {
+      pathname,
+      href: typeof withParams === "string" && withParams.length > 0 ? withParams : pathname,
+      ...(Array.isArray(info?.segments) ? {
+        segments: info.segments
+      } : {})
+    };
   } catch (error) {
     return null;
   }

package/lib/typescript/commonjs/hooks/safe-area-impl.d.ts

@@ -1,7 +1,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-08-15T04:40:03.239Z
+ * Generated at: 2026-08-18T00:32:52.026Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

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

@@ -1,7 +1,8 @@
 export * from "./ui";
 export * from "./stores";
 export * from "./sync/wireBudget";
-export { absoluteFill, displayValue, parseDisplayValue, getSafeAreaInsets, persistentStorage, isUsingPersistentStorage, getStorageBackendType, safeStringify, getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, loadOptionalModule, getCachedOptionalModule, setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, type StateSnapshotPreview, type StateSnapshotPreviewItem, type StateSnapshotPreviewVerdict, superJsonSerialize, superJsonDeserialize, type SuperJSONResult, reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, Subscribable, type SubscribableListener, subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, isExpoRouterAvailable, } from "./utils";
+export { absoluteFill, displayValue, parseDisplayValue, getSafeAreaInsets, persistentStorage, isUsingPersistentStorage, getStorageBackendType, safeStringify, getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, loadOptionalModule, getCachedOptionalModule, setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, type RenderCauseCounts, registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, type StateSnapshotPreview, type StateSnapshotPreviewItem, type StateSnapshotPreviewVerdict, superJsonSerialize, superJsonDeserialize, type SuperJSONResult, reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, getDevServerOrigin, Subscribable, type SubscribableListener, subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable, } from "./utils";
+export type { SafeRouteLocation } from "./utils";
 export * from "./utils/formatting";
 export * from "./utils/time";
 export { isPlainObject as isPlainObjectUtil } from "./utils/typeHelpers";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/utils/devServer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * devServer
+ *
+ * Origin of the Metro/Expo dev server that served this bundle, e.g.
+ * `http://192.168.1.20:8081`.
+ *
+ * Why a remote driver wants it: reloading the app normally runs IN the app
+ * (`DevSettings.reload()`), which is exactly what stops working when the app
+ * has crashed — a fatal render error unmounts the tree, so no JS action can be
+ * answered and the one command that would recover the app is unreachable. The
+ * dev server's message socket reloads through the NATIVE side instead (it is
+ * what the `r` key and the redbox's Reload button use), so a driver that knows
+ * this origin can recover an app that can no longer help itself.
+ *
+ * Reported once, while the app is healthy, so it is already known by the time
+ * it's needed.
+ */
+/**
+ * `http://host:port` of the dev server, or null in production / on web (a
+ * release bundle's scriptURL is a `file://` path, which has no origin worth
+ * reporting).
+ */
+export declare function getDevServerOrigin(): string | null;
+//# sourceMappingURL=devServer.d.ts.map

package/lib/typescript/commonjs/utils/devServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../../../../src/utils/devServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8BH;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAIlD"}

package/lib/typescript/commonjs/utils/index.d.ts

@@ -6,11 +6,12 @@ export { safeStringify } from "./safeStringify";
 export { getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, } from "./typeHelpers";
 export { parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, } from "./valueFormatting";
 export { loadOptionalModule, getCachedOptionalModule } from "./loadOptionalModule";
-export { setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, } from "./renderCaptureRegistry";
+export { setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, type RenderCauseCounts, } from "./renderCaptureRegistry";
 export { registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, type StateSnapshotPreview, type StateSnapshotPreviewItem, type StateSnapshotPreviewVerdict, } from "./stateSnapshotRegistry";
 export { serialize as superJsonSerialize, deserialize as superJsonDeserialize, type SuperJSONResult, } from "./minimalSuperJSON";
 export { reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, } from "./reloadApp";
+export { getDevServerOrigin } from "./devServer";
 export { Subscribable, type SubscribableListener } from "./subscribable";
 export { subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, } from "./subscriberCountNotifier";
-export { useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, isExpoRouterAvailable, } from "./safeExpoRouter";
+export { useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable, type SafeRouteLocation, } from "./safeExpoRouter";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,IAAI,kBAAkB,EAC/B,WAAW,IAAI,oBAAoB,EACnC,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,IAAI,kBAAkB,EAC/B,WAAW,IAAI,oBAAoB,EACnC,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/lib/typescript/commonjs/utils/renderCaptureRegistry.d.ts

@@ -7,6 +7,30 @@
  * other — same optional-capability pattern as PerfMonitorController's
  * `installReaFpsGetter`.
  */
+/**
+ * Why a component rendered, counted across a capture window.
+ *
+ * The split between `props` and `propsUnstable` is the one that matters in
+ * practice. Both mean "my props changed", but they send you to different
+ * files: `props` is a genuine update (a value differs) and belongs to the
+ * component; `propsUnstable` means the values are equal and only the
+ * IDENTITY changed — a fresh arrow or object literal handed down by the
+ * parent every render — and the fix is always upstream. Reporting that as
+ * plain "props" is technically true and sends people into the wrong file,
+ * which is why it gets its own bucket.
+ */
+export interface RenderCauseCounts {
+    /** First render — nothing to compare against. */
+    mount?: number;
+    /** Props changed and at least one VALUE differs. A real update. */
+    props?: number;
+    /** Props changed by identity only; every changed value is equivalent. */
+    propsUnstable?: number;
+    /** Own state/hooks changed (useState, useReducer, context read). */
+    hooks?: number;
+    /** Rendered with no change of its own — a parent cascade. */
+    parent?: number;
+}
 /** One component's aggregated renders across a capture window. */
 export interface RenderCaptureTopComponent {
     name: string;
@@ -18,6 +42,16 @@ export interface RenderCaptureTopComponent {
     maxMs: number;
     /** totalMs / renders. */
     avgMs: number;
+    /** Why it rendered. Present whenever capture ran. */
+    causes?: RenderCauseCounts;
+    /**
+     * Prop keys most often seen changing. Detail tier — only populated when
+     * `captureRenderDetail` is on, because collecting key names allocates on
+     * every render.
+     */
+    changedProps?: string[];
+    /** Nearest composite ancestor that rendered with it. Detail tier. */
+    parentName?: string;
 }
 /** Result of a capture window (one benchmark recording). */
 export interface RenderCaptureSummary {
@@ -32,14 +66,30 @@ export interface RenderCaptureSummary {
     capturedDurations: boolean;
     /** Sum of all self durations in ms across the capture. */
     totalRenderMs?: number;
+    /**
+     * Renders that produced nothing new: parent cascades plus identity-only
+     * prop changes. Both are removable without changing behaviour, so this is
+     * the recoverable share of `totalRenders` — the number to lead with.
+     */
+    wastedRenders?: number;
+    /** Cause totals across every component, including ones outside topComponents. */
+    causes?: RenderCauseCounts;
     /** Heaviest components by total self duration, capped by the provider. */
     topComponents: RenderCaptureTopComponent[];
 }
 export interface RenderCaptureProvider {
     /** Whether capture can work right now (dev build, DevTools hook present). */
     isSupported(): boolean;
-    /** Begin a capture window. Resets any previous unclaimed data. */
-    start(): void;
+    /**
+     * Begin a capture window. Resets any previous unclaimed data.
+     *
+     * `detail` opts into the allocating tier (changed prop keys, parent names).
+     * Causes and `wastedRenders` come back either way — older providers that
+     * ignore the argument simply return a summary without them.
+     */
+    start(opts?: {
+        detail?: boolean;
+    }): void;
     /** End the window and return the aggregate, or null if never started. */
     stop(): RenderCaptureSummary | null;
     /**

package/lib/typescript/commonjs/utils/renderCaptureRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderCaptureRegistry.d.ts","sourceRoot":"","sources":["../../../../src/utils/renderCaptureRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kEAAkE;AAClE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;CAGf;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,aAAa,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,WAAW,IAAI,OAAO,CAAC;IACvB,kEAAkE;IAClE,KAAK,IAAI,IAAI,CAAC;IACd,yEAAyE;IACzE,IAAI,IAAI,oBAAoB,GAAG,IAAI,CAAC;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7C;AAID,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAEvE"}
+{"version":3,"file":"renderCaptureRegistry.d.ts","sourceRoot":"","sources":["../../../../src/utils/renderCaptureRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,0EAA0E;IAC1E,aAAa,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,WAAW,IAAI,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACzC,yEAAyE;IACzE,IAAI,IAAI,oBAAoB,GAAG,IAAI,CAAC;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7C;AAyBD,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAEvE"}

package/lib/typescript/commonjs/utils/safeExpoRouter.d.ts

@@ -22,5 +22,28 @@ export declare function getSafeRouter(): any;
  * can't be reached.
  */
 export declare function getSafeCurrentPathname(): string | null;
+/** A route location that can be re-visited later via {@link getSafeRouter}. */
+export interface SafeRouteLocation {
+    /** Pathname with dynamic segments resolved, e.g. `/pokemon/25`. */
+    pathname: string;
+    /**
+     * What to actually navigate to: the pathname WITH its search params
+     * (`/pokemon/25?tab=stats`). Falls back to `pathname` on router builds that
+     * don't expose it. Non-serializable params passed imperatively through
+     * `navigate(path, params)` are NOT part of this — only the URL is.
+     */
+    href: string;
+    /** Route segments, when the router exposes them (display only). */
+    segments?: string[];
+}
+/**
+ * The current route as a re-visitable location, read imperatively from
+ * expo-router's store.
+ *
+ * Like {@link getSafeCurrentPathname} this works before any navigation has
+ * been recorded (cold start on the initial route), and returns null when
+ * expo-router isn't available or the store can't be reached.
+ */
+export declare function getSafeCurrentRoute(): SafeRouteLocation | null;
 export declare function isExpoRouterAvailable(): boolean;
 //# sourceMappingURL=safeExpoRouter.d.ts.map

package/lib/typescript/commonjs/utils/safeExpoRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safeExpoRouter.d.ts","sourceRoot":"","sources":["../../../../src/utils/safeExpoRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgHH,wBAAgB,aAAa,QAW5B;AAED,wBAAgB,eAAe,IAAI,MAAM,CAWxC;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAW7E;AAMD,wBAAgB,aAAa,QAU5B;AAuBD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAUtD;AAMD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}
+{"version":3,"file":"safeExpoRouter.d.ts","sourceRoot":"","sources":["../../../../src/utils/safeExpoRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgHH,wBAAgB,aAAa,QAW5B;AAED,wBAAgB,eAAe,IAAI,MAAM,CAWxC;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAW7E;AAMD,wBAAgB,aAAa,QAU5B;AAiCD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,GAAG,IAAI,CAoB9D;AAMD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/lib/typescript/module/hooks/safe-area-impl.d.ts

@@ -1,7 +1,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-08-15T04:40:03.239Z
+ * Generated at: 2026-08-18T00:32:52.026Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

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

@@ -1,7 +1,8 @@
 export * from "./ui";
 export * from "./stores";
 export * from "./sync/wireBudget";
-export { absoluteFill, displayValue, parseDisplayValue, getSafeAreaInsets, persistentStorage, isUsingPersistentStorage, getStorageBackendType, safeStringify, getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, loadOptionalModule, getCachedOptionalModule, setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, type StateSnapshotPreview, type StateSnapshotPreviewItem, type StateSnapshotPreviewVerdict, superJsonSerialize, superJsonDeserialize, type SuperJSONResult, reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, Subscribable, type SubscribableListener, subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, isExpoRouterAvailable, } from "./utils";
+export { absoluteFill, displayValue, parseDisplayValue, getSafeAreaInsets, persistentStorage, isUsingPersistentStorage, getStorageBackendType, safeStringify, getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, loadOptionalModule, getCachedOptionalModule, setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, type RenderCauseCounts, registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, type StateSnapshotPreview, type StateSnapshotPreviewItem, type StateSnapshotPreviewVerdict, superJsonSerialize, superJsonDeserialize, type SuperJSONResult, reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, getDevServerOrigin, Subscribable, type SubscribableListener, subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable, } from "./utils";
+export type { SafeRouteLocation } from "./utils";
 export * from "./utils/formatting";
 export * from "./utils/time";
 export { isPlainObject as isPlainObjectUtil } from "./utils/typeHelpers";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/utils/devServer.d.ts

@@ -0,0 +1,24 @@
+/**
+ * devServer
+ *
+ * Origin of the Metro/Expo dev server that served this bundle, e.g.
+ * `http://192.168.1.20:8081`.
+ *
+ * Why a remote driver wants it: reloading the app normally runs IN the app
+ * (`DevSettings.reload()`), which is exactly what stops working when the app
+ * has crashed — a fatal render error unmounts the tree, so no JS action can be
+ * answered and the one command that would recover the app is unreachable. The
+ * dev server's message socket reloads through the NATIVE side instead (it is
+ * what the `r` key and the redbox's Reload button use), so a driver that knows
+ * this origin can recover an app that can no longer help itself.
+ *
+ * Reported once, while the app is healthy, so it is already known by the time
+ * it's needed.
+ */
+/**
+ * `http://host:port` of the dev server, or null in production / on web (a
+ * release bundle's scriptURL is a `file://` path, which has no origin worth
+ * reporting).
+ */
+export declare function getDevServerOrigin(): string | null;
+//# sourceMappingURL=devServer.d.ts.map

package/lib/typescript/module/utils/devServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../../../../src/utils/devServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8BH;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAIlD"}

package/lib/typescript/module/utils/index.d.ts

@@ -6,11 +6,12 @@ export { safeStringify } from "./safeStringify";
 export { getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, } from "./typeHelpers";
 export { parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, } from "./valueFormatting";
 export { loadOptionalModule, getCachedOptionalModule } from "./loadOptionalModule";
-export { setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, } from "./renderCaptureRegistry";
+export { setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, type RenderCauseCounts, } from "./renderCaptureRegistry";
 export { registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, type StateSnapshotPreview, type StateSnapshotPreviewItem, type StateSnapshotPreviewVerdict, } from "./stateSnapshotRegistry";
 export { serialize as superJsonSerialize, deserialize as superJsonDeserialize, type SuperJSONResult, } from "./minimalSuperJSON";
 export { reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, } from "./reloadApp";
+export { getDevServerOrigin } from "./devServer";
 export { Subscribable, type SubscribableListener } from "./subscribable";
 export { subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, } from "./subscriberCountNotifier";
-export { useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, isExpoRouterAvailable, } from "./safeExpoRouter";
+export { useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable, type SafeRouteLocation, } from "./safeExpoRouter";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,IAAI,kBAAkB,EAC/B,WAAW,IAAI,oBAAoB,EACnC,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,GACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,IAAI,kBAAkB,EAC/B,WAAW,IAAI,oBAAoB,EACnC,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/lib/typescript/module/utils/renderCaptureRegistry.d.ts

@@ -7,6 +7,30 @@
  * other — same optional-capability pattern as PerfMonitorController's
  * `installReaFpsGetter`.
  */
+/**
+ * Why a component rendered, counted across a capture window.
+ *
+ * The split between `props` and `propsUnstable` is the one that matters in
+ * practice. Both mean "my props changed", but they send you to different
+ * files: `props` is a genuine update (a value differs) and belongs to the
+ * component; `propsUnstable` means the values are equal and only the
+ * IDENTITY changed — a fresh arrow or object literal handed down by the
+ * parent every render — and the fix is always upstream. Reporting that as
+ * plain "props" is technically true and sends people into the wrong file,
+ * which is why it gets its own bucket.
+ */
+export interface RenderCauseCounts {
+    /** First render — nothing to compare against. */
+    mount?: number;
+    /** Props changed and at least one VALUE differs. A real update. */
+    props?: number;
+    /** Props changed by identity only; every changed value is equivalent. */
+    propsUnstable?: number;
+    /** Own state/hooks changed (useState, useReducer, context read). */
+    hooks?: number;
+    /** Rendered with no change of its own — a parent cascade. */
+    parent?: number;
+}
 /** One component's aggregated renders across a capture window. */
 export interface RenderCaptureTopComponent {
     name: string;
@@ -18,6 +42,16 @@ export interface RenderCaptureTopComponent {
     maxMs: number;
     /** totalMs / renders. */
     avgMs: number;
+    /** Why it rendered. Present whenever capture ran. */
+    causes?: RenderCauseCounts;
+    /**
+     * Prop keys most often seen changing. Detail tier — only populated when
+     * `captureRenderDetail` is on, because collecting key names allocates on
+     * every render.
+     */
+    changedProps?: string[];
+    /** Nearest composite ancestor that rendered with it. Detail tier. */
+    parentName?: string;
 }
 /** Result of a capture window (one benchmark recording). */
 export interface RenderCaptureSummary {
@@ -32,14 +66,30 @@ export interface RenderCaptureSummary {
     capturedDurations: boolean;
     /** Sum of all self durations in ms across the capture. */
     totalRenderMs?: number;
+    /**
+     * Renders that produced nothing new: parent cascades plus identity-only
+     * prop changes. Both are removable without changing behaviour, so this is
+     * the recoverable share of `totalRenders` — the number to lead with.
+     */
+    wastedRenders?: number;
+    /** Cause totals across every component, including ones outside topComponents. */
+    causes?: RenderCauseCounts;
     /** Heaviest components by total self duration, capped by the provider. */
     topComponents: RenderCaptureTopComponent[];
 }
 export interface RenderCaptureProvider {
     /** Whether capture can work right now (dev build, DevTools hook present). */
     isSupported(): boolean;
-    /** Begin a capture window. Resets any previous unclaimed data. */
-    start(): void;
+    /**
+     * Begin a capture window. Resets any previous unclaimed data.
+     *
+     * `detail` opts into the allocating tier (changed prop keys, parent names).
+     * Causes and `wastedRenders` come back either way — older providers that
+     * ignore the argument simply return a summary without them.
+     */
+    start(opts?: {
+        detail?: boolean;
+    }): void;
     /** End the window and return the aggregate, or null if never started. */
     stop(): RenderCaptureSummary | null;
     /**

package/lib/typescript/module/utils/renderCaptureRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderCaptureRegistry.d.ts","sourceRoot":"","sources":["../../../../src/utils/renderCaptureRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kEAAkE;AAClE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;CAGf;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,aAAa,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,WAAW,IAAI,OAAO,CAAC;IACvB,kEAAkE;IAClE,KAAK,IAAI,IAAI,CAAC;IACd,yEAAyE;IACzE,IAAI,IAAI,oBAAoB,GAAG,IAAI,CAAC;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7C;AAID,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAEvE"}
+{"version":3,"file":"renderCaptureRegistry.d.ts","sourceRoot":"","sources":["../../../../src/utils/renderCaptureRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,0EAA0E;IAC1E,aAAa,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,WAAW,IAAI,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACzC,yEAAyE;IACzE,IAAI,IAAI,oBAAoB,GAAG,IAAI,CAAC;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7C;AAyBD,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAE9E;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAEvE"}

package/lib/typescript/module/utils/safeExpoRouter.d.ts

@@ -22,5 +22,28 @@ export declare function getSafeRouter(): any;
  * can't be reached.
  */
 export declare function getSafeCurrentPathname(): string | null;
+/** A route location that can be re-visited later via {@link getSafeRouter}. */
+export interface SafeRouteLocation {
+    /** Pathname with dynamic segments resolved, e.g. `/pokemon/25`. */
+    pathname: string;
+    /**
+     * What to actually navigate to: the pathname WITH its search params
+     * (`/pokemon/25?tab=stats`). Falls back to `pathname` on router builds that
+     * don't expose it. Non-serializable params passed imperatively through
+     * `navigate(path, params)` are NOT part of this — only the URL is.
+     */
+    href: string;
+    /** Route segments, when the router exposes them (display only). */
+    segments?: string[];
+}
+/**
+ * The current route as a re-visitable location, read imperatively from
+ * expo-router's store.
+ *
+ * Like {@link getSafeCurrentPathname} this works before any navigation has
+ * been recorded (cold start on the initial route), and returns null when
+ * expo-router isn't available or the store can't be reached.
+ */
+export declare function getSafeCurrentRoute(): SafeRouteLocation | null;
 export declare function isExpoRouterAvailable(): boolean;
 //# sourceMappingURL=safeExpoRouter.d.ts.map

package/lib/typescript/module/utils/safeExpoRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safeExpoRouter.d.ts","sourceRoot":"","sources":["../../../../src/utils/safeExpoRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgHH,wBAAgB,aAAa,QAW5B;AAED,wBAAgB,eAAe,IAAI,MAAM,CAWxC;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAW7E;AAMD,wBAAgB,aAAa,QAU5B;AAuBD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAUtD;AAMD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}
+{"version":3,"file":"safeExpoRouter.d.ts","sourceRoot":"","sources":["../../../../src/utils/safeExpoRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgHH,wBAAgB,aAAa,QAW5B;AAED,wBAAgB,eAAe,IAAI,MAAM,CAWxC;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C;AAED,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAW7E;AAMD,wBAAgB,aAAa,QAU5B;AAiCD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAEtD;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,GAAG,IAAI,CAoB9D;AAMD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/shared-ui",
-  "version": "7.0.21",
+  "version": "7.0.22",
   "description": "Shared UI components, hooks, and utilities",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -136,10 +136,10 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/floating-tools-core": "^7.0.21"
+    "@buoy-gg/floating-tools-core": "^7.0.22"
   },
   "peerDependencies": {
-    "@buoy-gg/license": "7.0.21",
+    "@buoy-gg/license": "7.0.22",
     "@react-native-clipboard/clipboard": "*",
     "expo-clipboard": "*",
     "expo-file-system": "*",
@@ -167,7 +167,7 @@
     "expo-clipboard": "~7.1.5",
     "react-native-safe-area-context": "^5.6.2",
     "typescript": "~5.8.3",
-    "@buoy-gg/license": "^7.0.21"
+    "@buoy-gg/license": "^7.0.22"
   },
   "react-native-builder-bob": {
     "source": "src",

package/scripts/detect-safe-area.js

@@ -30,6 +30,27 @@ const OUTPUT_FILE = path.join(__dirname, "..", "src", "hooks", "safe-area-impl.t
 // Check for explicit fallback override (used during publishing)
 const forceFallback = process.env.REACT_BUOY_FALLBACK === "1";
 
+// In the monorepo this file is CHECKED IN, so rewriting it on every postinstall
+// dirtied the working tree with a change nobody made — which is how it ended up
+// committed by accident twice (see `chore: regenerated safe-area state from
+// release install` and the revert that followed).
+//
+// Skipping here is safe because the committed variant is what monorepo builds
+// and the example apps want, and it costs nothing: the publish path below still
+// regenerates. detect-clipboard.js already guards itself the same way.
+//
+// The `forceFallback` exemption is load-bearing — prepublishOnly runs this with
+// REACT_BUOY_FALLBACK=1, and skipping THAT would publish the native variant,
+// whose static `react-native-safe-area-context` import breaks every consumer
+// that doesn't have the package. That is the exact failure this script exists
+// to prevent.
+if (!forceFallback && fs.existsSync(path.join(__dirname, "..", "src"))) {
+  console.log(
+    "[@buoy/shared-ui] Safe area: skipping postinstall (workspace mode — src/ is checked in)"
+  );
+  process.exit(0);
+}
+
 /**
  * Find the monorepo/project root by looking for pnpm-workspace.yaml or package.json with workspaces
  */