@buoy-gg/route-events 2.1.3 → 2.1.4-beta.1

package/lib/typescript/RouteTracker.d.ts

@@ -1,15 +1,15 @@
 /**
  * RouteTracker - A component to place inside your navigation tree
  *
- * This component calls useRouteObserver() which uses expo-router hooks
- * (usePathname, useSegments, etc.) to track navigation changes.
+ * Automatically detects whether Expo Router or React Navigation is available
+ * and uses the appropriate route observation method.
  *
  * IMPORTANT: This component MUST be placed inside your navigation tree
- * (as a child of Stack, Tabs, or Slot) for route tracking to work.
+ * (as a child of Stack, Tabs, Slot, or NavigationContainer) for route tracking to work.
  *
  * @example
  * ```tsx
- * // In your _layout.tsx
+ * // Expo Router - in your _layout.tsx
  * import { RouteTracker } from '@buoy-gg/route-events';
  *
  * export default function RootLayout() {
@@ -23,7 +23,20 @@
  *     </>
  *   );
  * }
+ *
+ * // React Navigation (RN CLI) - inside NavigationContainer
+ * import { RouteTracker } from '@buoy-gg/route-events';
+ *
+ * function App() {
+ *   return (
+ *     <NavigationContainer>
+ *       <RootNavigator />
+ *       <RouteTracker />
+ *       <FloatingDevTools ... />
+ *     </NavigationContainer>
+ *   );
+ * }
  * ```
  */
-export declare function RouteTracker(): null;
+export declare function RouteTracker(): import("react").JSX.Element;
 //# sourceMappingURL=RouteTracker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RouteTracker.d.ts","sourceRoot":"","sources":["../../src/RouteTracker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,wBAAgB,YAAY,IAAI,IAAI,CAGnC"}
+{"version":3,"file":"RouteTracker.d.ts","sourceRoot":"","sources":["../../src/RouteTracker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAgBH,wBAAgB,YAAY,gCAM3B"}

package/lib/typescript/components/NavigationStack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationStack.d.ts","sourceRoot":"","sources":["../../../src/components/NavigationStack.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAMD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,EAAE,oBAAoB,+BAyZ9D"}
+{"version":3,"file":"NavigationStack.d.ts","sourceRoot":"","sources":["../../../src/components/NavigationStack.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAMD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,EAAE,oBAAoB,+BAya9D"}

package/lib/typescript/components/ReactNavigationRoutes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ReactNavigationRoutes - Visual sitemap of all screens in a React Navigation app
+ *
+ * Discovers all registered screens by walking the navigation state tree.
+ * Each navigator's state includes a `routeNames` array listing ALL screens
+ * registered with it — even ones not currently mounted in the stack.
+ *
+ * Provides navigation to any discovered screen using nested screen/params actions.
+ */
+export interface ReactNavigationRoutesProps {
+    style?: any;
+}
+export declare function ReactNavigationRoutes({ style }: ReactNavigationRoutesProps): import("react").JSX.Element;
+//# sourceMappingURL=ReactNavigationRoutes.d.ts.map

package/lib/typescript/components/ReactNavigationRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNavigationRoutes.d.ts","sourceRoot":"","sources":["../../../src/components/ReactNavigationRoutes.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8BH,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAkHD,wBAAgB,qBAAqB,CAAC,EAAE,KAAK,EAAE,EAAE,0BAA0B,+BAmS1E"}

package/lib/typescript/components/RouteEventsModalWithTabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouteEventsModalWithTabs.d.ts","sourceRoot":"","sources":["../../../src/components/RouteEventsModalWithTabs.tsx"],"names":[],"mappings":"AA8CA,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,CAAC;IACvC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAID,wBAAgB,wBAAwB,CAAC,EACvC,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,GACpC,EAAE,6BAA6B,sCAigB/B"}
+{"version":3,"file":"RouteEventsModalWithTabs.d.ts","sourceRoot":"","sources":["../../../src/components/RouteEventsModalWithTabs.tsx"],"names":[],"mappings":"AAoDA,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,CAAC;IACvC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AA8CD,wBAAgB,wBAAwB,CAAC,EACvC,OAAO,EACP,OAAO,EACP,MAAM,EACN,UAAU,EACV,2BAAmC,GACpC,EAAE,6BAA6B,sCA8hB/B"}

package/lib/typescript/index.d.ts

@@ -19,6 +19,7 @@ export type { RouteEventItemCompactProps } from "./components/RouteEventItemComp
 export { RouteEventExpandedContent } from "./components/RouteEventExpandedContent";
 export type { RouteEventExpandedContentProps } from "./components/RouteEventExpandedContent";
 export { useRouteObserver } from "./useRouteObserver";
+export { useRouteObserverReactNavigation } from "./useRouteObserverReactNavigation";
 export { useRouteEvents } from "./hooks/useRouteEvents";
 export type { UseRouteEventsOptions, UseRouteEventsResult, } from "./hooks/useRouteEvents";
 export { useRouteSitemap, useRoute, useParentRoutes } from "./useRouteSitemap";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAKxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,YAAY,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAK3F,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,YAAY,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,YAAY,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAK7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAK9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKhD,qEAAqE;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,qEAAqE;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAKxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,YAAY,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAK3F,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,YAAY,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,YAAY,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAK7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAK9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKhD,qEAAqE;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,qEAAqE;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}

package/lib/typescript/useNavigationStack.d.ts

@@ -1,10 +1,13 @@
 /**
  * useNavigationStack - Hook to access current navigation stack state
  *
- * Provides real-time access to the navigation stack from Expo Router,
+ * Provides real-time access to the navigation stack,
  * showing what screens are currently mounted in memory and which is visible.
  *
- * Data source: @react-navigation/native
+ * Supports both Expo Router and React Navigation (RN CLI).
+ *
+ * - Expo Router: uses useNavigation/useNavigationState (inside navigator context)
+ * - RN CLI: uses NavigationContainerRefContext (works as sibling of navigators)
  */
 export interface StackDisplayItem {
     key: string;
@@ -29,7 +32,10 @@ export interface UseNavigationStackResult {
     popToTop: () => void;
 }
 /**
- * Access the current navigation stack from Expo Router
+ * Access the current navigation stack.
+ *
+ * Works in both Expo Router and RN CLI apps. On RN CLI, uses the
+ * NavigationContainer ref context so it works even as a sibling of navigators.
  *
  * @example
  * ```tsx

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

@@ -1 +1 @@
-{"version":3,"file":"useNavigationStack.d.ts","sourceRoot":"","sources":["../../src/useNavigationStack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IAEvC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAGlB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAGpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAsED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI,wBAAwB,CAkK7D"}
+{"version":3,"file":"useNavigationStack.d.ts","sourceRoot":"","sources":["../../src/useNavigationStack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsBH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IAEvC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAGlB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAGpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAuKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,IAAI,wBAAwB,CAqK7D"}

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

@@ -1 +1 @@
-{"version":3,"file":"useRouteObserver.d.ts","sourceRoot":"","sources":["../../src/useRouteObserver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,QAyC5E"}
+{"version":3,"file":"useRouteObserver.d.ts","sourceRoot":"","sources":["../../src/useRouteObserver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,QA0C5E"}

package/lib/typescript/useRouteObserverReactNavigation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * useRouteObserverReactNavigation - React hook for observing route changes
+ * using @react-navigation/native APIs.
+ *
+ * This is the React Navigation (RN CLI) counterpart to useRouteObserver.ts
+ * which uses Expo Router hooks. Both emit to the same routeObserver singleton.
+ *
+ * Uses NavigationContainerRefContext so it works anywhere inside
+ * a NavigationContainer — does NOT need to be inside a navigator.
+ */
+import { type RouteChangeEvent } from "./RouteObserver";
+/**
+ * Hook to observe route changes via @react-navigation/native.
+ * Automatically emits events to the global RouteObserver.
+ *
+ * Works anywhere inside a NavigationContainer (does not need to be inside a navigator).
+ */
+export declare function useRouteObserverReactNavigation(callback?: (event: RouteChangeEvent) => void): void;
+//# sourceMappingURL=useRouteObserverReactNavigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRouteObserverReactNavigation.d.ts","sourceRoot":"","sources":["../../src/useRouteObserverReactNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAwEvE;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,QAmC7C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/route-events",
-  "version": "2.1.3",
+  "version": "2.1.4-beta.1",
   "description": "route-events package",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -26,11 +26,11 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/floating-tools-core": "2.1.3",
-    "@buoy-gg/shared-ui": "2.1.3"
+    "@buoy-gg/floating-tools-core": "2.1.4-beta.1",
+    "@buoy-gg/shared-ui": "2.1.4-beta.1"
   },
   "peerDependencies": {
-    "@buoy-gg/license": "*",
+    "@buoy-gg/license": "2.1.4-beta.1",
     "@react-native-async-storage/async-storage": "*",
     "@react-navigation/native": "*",
     "expo-router": "*",
@@ -38,7 +38,7 @@
     "react-native": "*"
   },
   "peerDependenciesMeta": {
-    "@buoy-gg/license": {
+    "expo-router": {
       "optional": true
     }
   },
@@ -49,7 +49,7 @@
     "@types/react-native": "^0.73.0",
     "expo-router": "~5.0.7",
     "typescript": "~5.8.3",
-    "@buoy-gg/license": "2.1.3"
+    "@buoy-gg/license": "2.1.4-beta.1"
   },
   "react-native-builder-bob": {
     "source": "src",

package/lib/commonjs/utils/safeExpoRouter.js

@@ -1,129 +0,0 @@
-"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;
-/**
- * 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.
- */
-
-let expoRouter = null;
-let isAvailable = false;
-let checkedAvailability = false;
-function checkExpoRouterAvailability() {
-  if (checkedAvailability) return isAvailable;
-  try {
-    expoRouter = require("expo-router");
-    isAvailable = expoRouter != null;
-  } 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("[route-events] expo-router not installed: push() unavailable"),
-    replace: () => console.warn("[route-events] expo-router not installed: replace() unavailable"),
-    back: () => console.warn("[route-events] expo-router not installed: back() unavailable"),
-    canGoBack: () => false,
-    setParams: () => console.warn("[route-events] expo-router not installed: setParams() unavailable"),
-    navigate: () => console.warn("[route-events] 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("[route-events] Failed to use expo-router.useRouter:", error);
-    return noOpUseRouter();
-  }
-}
-function useSafePathname() {
-  if (!checkExpoRouterAvailability()) {
-    return noOpUsePathname();
-  }
-  try {
-    return expoRouter.usePathname();
-  } catch (error) {
-    console.warn("[route-events] Failed to use expo-router.usePathname:", error);
-    return noOpUsePathname();
-  }
-}
-function useSafeSegments() {
-  if (!checkExpoRouterAvailability()) {
-    return noOpUseSegments();
-  }
-  try {
-    return expoRouter.useSegments();
-  } catch (error) {
-    console.warn("[route-events] Failed to use expo-router.useSegments:", error);
-    return noOpUseSegments();
-  }
-}
-function useSafeGlobalSearchParams() {
-  if (!checkExpoRouterAvailability()) {
-    return noOpUseGlobalSearchParams();
-  }
-  try {
-    return expoRouter.useGlobalSearchParams();
-  } catch (error) {
-    console.warn("[route-events] 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/utils/safeExpoRouter.js

@@ -1,120 +0,0 @@
-"use strict";
-
-/**
- * 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.
- */
-
-let expoRouter = null;
-let isAvailable = false;
-let checkedAvailability = false;
-function checkExpoRouterAvailability() {
-  if (checkedAvailability) return isAvailable;
-  try {
-    expoRouter = require("expo-router");
-    isAvailable = expoRouter != null;
-  } 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("[route-events] expo-router not installed: push() unavailable"),
-    replace: () => console.warn("[route-events] expo-router not installed: replace() unavailable"),
-    back: () => console.warn("[route-events] expo-router not installed: back() unavailable"),
-    canGoBack: () => false,
-    setParams: () => console.warn("[route-events] expo-router not installed: setParams() unavailable"),
-    navigate: () => console.warn("[route-events] expo-router not installed: navigate() unavailable")
-  };
-}
-function noOpUsePathname() {
-  return "/";
-}
-function noOpUseSegments() {
-  return [];
-}
-function noOpUseGlobalSearchParams() {
-  return {};
-}
-
-// ============================================================================
-// Safe hook exports
-// ============================================================================
-
-export function useSafeRouter() {
-  if (!checkExpoRouterAvailability()) {
-    return noOpUseRouter();
-  }
-  try {
-    return expoRouter.useRouter();
-  } catch (error) {
-    console.warn("[route-events] Failed to use expo-router.useRouter:", error);
-    return noOpUseRouter();
-  }
-}
-export function useSafePathname() {
-  if (!checkExpoRouterAvailability()) {
-    return noOpUsePathname();
-  }
-  try {
-    return expoRouter.usePathname();
-  } catch (error) {
-    console.warn("[route-events] Failed to use expo-router.usePathname:", error);
-    return noOpUsePathname();
-  }
-}
-export function useSafeSegments() {
-  if (!checkExpoRouterAvailability()) {
-    return noOpUseSegments();
-  }
-  try {
-    return expoRouter.useSegments();
-  } catch (error) {
-    console.warn("[route-events] Failed to use expo-router.useSegments:", error);
-    return noOpUseSegments();
-  }
-}
-export function useSafeGlobalSearchParams() {
-  if (!checkExpoRouterAvailability()) {
-    return noOpUseGlobalSearchParams();
-  }
-  try {
-    return expoRouter.useGlobalSearchParams();
-  } catch (error) {
-    console.warn("[route-events] Failed to use expo-router.useGlobalSearchParams:", error);
-    return noOpUseGlobalSearchParams();
-  }
-}
-
-// ============================================================================
-// Router instance getter (for imperative navigation)
-// ============================================================================
-
-export function getSafeRouter() {
-  if (!checkExpoRouterAvailability()) {
-    return null;
-  }
-  try {
-    return expoRouter.router || null;
-  } catch (error) {
-    return null;
-  }
-}
-
-// ============================================================================
-// Availability check
-// ============================================================================
-
-export function isExpoRouterAvailable() {
-  return checkExpoRouterAvailability();
-}

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

@@ -1,13 +0,0 @@
-/**
- * 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.
- */
-export declare function useSafeRouter(): any;
-export declare function useSafePathname(): string;
-export declare function useSafeSegments(): string[];
-export declare function useSafeGlobalSearchParams(): Record<string, string | string[]>;
-export declare function getSafeRouter(): any;
-export declare function isExpoRouterAvailable(): boolean;
-//# sourceMappingURL=safeExpoRouter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"safeExpoRouter.d.ts","sourceRoot":"","sources":["../../../src/utils/safeExpoRouter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoDH,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;AAMD,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}