@buoy-gg/route-events 7.0.41 → 7.0.43

package/lib/commonjs/useRouteSitemap.js

@@ -1,255 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useParentRoutes = useParentRoutes;
-exports.useRoute = useRoute;
-exports.useRouteSitemap = useRouteSitemap;
-var _react = require("react");
-var _RouteParser = require("./RouteParser");
-var _expoRouterStore = require("./expoRouterStore");
-/**
- * useRouteSitemap - React hooks for accessing parsed route information
- *
- * Provides access to the Expo Router route tree with parsing, filtering,
- * and search capabilities.
- */
-
-// Type-only definition to avoid Metro resolution issues
-
-/**
- * Extract all routes from the navigation state recursively
- * This builds a RouteNode-like structure from React Navigation's state
- */
-function buildRouteNodeFromNavigationState(state) {
-  if (!state || !state.routes) return null;
-
-  // Find the app directory structure from the navigation state
-  // The root route usually contains the file-based routing structure
-  const rootRoute = state.routes?.[0];
-  if (!rootRoute) return null;
-
-  // Build a simple route node structure
-  // This will work with the RouteParser
-  const routeNode = {
-    type: 'route',
-    route: '',
-    dynamic: null,
-    children: [],
-    contextKey: '_app'
-  };
-
-  // Recursively collect all routes from the state
-  function collectRoutes(navState, parent, pathPrefix = '') {
-    if (!navState || !navState.routes) return;
-    navState.routes.forEach(route => {
-      const routeName = route.name;
-
-      // Skip internal routes
-      if (routeName.startsWith('__') || routeName.includes('_layout') || routeName.startsWith('+not-found')) {
-        return;
-      }
-
-      // Create a route node
-      const node = {
-        type: routeName === 'index' ? 'route' : 'route',
-        route: routeName === 'index' ? '' : routeName,
-        dynamic: routeName.includes('[') ? [routeName.match(/\[([^\]]+)\]/)?.[1] || ''] : null,
-        children: [],
-        contextKey: `app/${routeName}`
-      };
-      parent.children.push(node);
-
-      // If this route has nested state, recurse
-      if (route.state) {
-        collectRoutes(route.state, node, `${pathPrefix}/${routeName}`);
-      }
-    });
-  }
-  collectRoutes(state, routeNode);
-  return routeNode.children.length > 0 ? routeNode : null;
-}
-
-// ============================================================================
-// Hook Options & Return Types
-// ============================================================================
-
-// ============================================================================
-// Main Hook
-// ============================================================================
-
-/**
- * Hook to access and parse Expo Router's route tree
- *
- * @example
- * ```tsx
- * const { routes, groups, stats, filteredRoutes } = useRouteSitemap({
- *   searchQuery: 'pokemon',
- *   sortBy: 'path',
- *   autoRefresh: true
- * });
- * ```
- */
-function useRouteSitemap(options = {}) {
-  const {
-    searchQuery = "",
-    sortBy = "path",
-    autoRefresh = false,
-    refreshInterval = 1000,
-    injectedRoutes,
-    injectedSource = null,
-    injectedLastUpdatedAt = null
-  } = options;
-  const hasInjectedRoutes = injectedRoutes != null;
-  const [routeTreeState, setRouteTreeState] = (0, _react.useState)(() => {
-    const node = (0, _expoRouterStore.loadRouteNode)();
-    const metadata = (0, _expoRouterStore.getRouteNodeMetadata)();
-    return {
-      node,
-      version: 0,
-      lastUpdatedAt: metadata.lastLoadedAt,
-      source: metadata.source
-    };
-  });
-  const routeNode = routeTreeState.node;
-  const routeNodeVersion = routeTreeState.version;
-  const lastUpdatedAt = routeTreeState.lastUpdatedAt;
-  const source = routeTreeState.source;
-  const refresh = (0, _react.useCallback)(() => {
-    setRouteTreeState(previous => {
-      const node = (0, _expoRouterStore.loadRouteNode)();
-      const metadata = (0, _expoRouterStore.getRouteNodeMetadata)();
-      return {
-        node,
-        version: previous.version + 1,
-        lastUpdatedAt: metadata.lastLoadedAt,
-        source: metadata.source
-      };
-    });
-  }, []);
-
-  // When the route tree isn't available yet (e.g., Expo Router still mounting),
-  // poll until it becomes ready. Use a more aggressive retry since the store
-  // is a singleton that gets populated asynchronously.
-  (0, _react.useEffect)(() => {
-    if (routeNode) {
-      return;
-    }
-
-    // Routes injected from outside (dashboard) don't come from the local store.
-    if (hasInjectedRoutes) {
-      return;
-    }
-
-    // On web (no expo-router) the tree will never load — don't poll forever.
-    if (!(0, _expoRouterStore.isExpoRouterStoreSupported)()) {
-      return;
-    }
-    let retryCount = 0;
-    const maxRetries = 100; // 10 seconds max
-
-    const poll = () => {
-      retryCount++;
-      refresh();
-      if (retryCount < maxRetries) {
-        timeoutRef = setTimeout(poll, 100);
-      }
-    };
-    let timeoutRef = setTimeout(poll, 100);
-    return () => clearTimeout(timeoutRef);
-  }, [routeNode, refresh, hasInjectedRoutes]);
-
-  // Optional auto-refresh hook for callers that want periodic updates
-  (0, _react.useEffect)(() => {
-    if (!autoRefresh) return;
-    const interval = setInterval(refresh, refreshInterval);
-    return () => clearInterval(interval);
-  }, [autoRefresh, refreshInterval, refresh]);
-
-  // With injected routes we're "supported" regardless of the local runtime, and
-  // "loaded" once the device has actually sent a non-empty tree (an empty array
-  // means the device is still booting expo-router → keep showing "Loading...").
-  const isLoaded = hasInjectedRoutes ? injectedRoutes.length > 0 : !!routeNode;
-  const isSupported = hasInjectedRoutes ? true : (0, _expoRouterStore.isExpoRouterStoreSupported)();
-
-  // Parse routes (or use the pre-parsed routes injected from the dashboard).
-  const routes = (0, _react.useMemo)(() => {
-    if (hasInjectedRoutes) return injectedRoutes;
-    if (!routeNode) return [];
-    return _RouteParser.RouteParser.parseRouteTree(routeNode);
-  }, [routeNode, routeNodeVersion, hasInjectedRoutes, injectedRoutes]);
-
-  // Sort routes
-  const sortedRoutes = (0, _react.useMemo)(() => {
-    return _RouteParser.RouteParser.sortRoutes(routes, sortBy);
-  }, [routes, sortBy]);
-
-  // Filter routes by search query
-  const filteredRoutes = (0, _react.useMemo)(() => {
-    if (!searchQuery) return sortedRoutes;
-    return _RouteParser.RouteParser.filterRoutes(sortedRoutes, searchQuery);
-  }, [sortedRoutes, searchQuery]);
-
-  // Organize into groups
-  const groups = (0, _react.useMemo)(() => {
-    return _RouteParser.RouteParser.organizeRoutes(filteredRoutes);
-  }, [filteredRoutes]);
-
-  // Calculate stats
-  const stats = (0, _react.useMemo)(() => {
-    return _RouteParser.RouteParser.getRouteStats(routes);
-  }, [routes]);
-
-  // Helper functions
-  const findRoute = path => _RouteParser.RouteParser.findRouteByPath(routes, path);
-  const getParents = path => _RouteParser.RouteParser.getParentRoutes(routes, path);
-  return {
-    routes: sortedRoutes,
-    groups,
-    stats,
-    filteredRoutes,
-    isLoaded,
-    isSupported,
-    refresh,
-    findRoute,
-    getParents,
-    lastUpdatedAt: hasInjectedRoutes ? injectedLastUpdatedAt : lastUpdatedAt,
-    source: hasInjectedRoutes ? injectedSource : source
-  };
-}
-
-// ============================================================================
-// Helper Hooks
-// ============================================================================
-
-/**
- * Get a specific route by path
- *
- * @example
- * ```tsx
- * const pokemonRoute = useRoute('/pokemon/[id]');
- * ```
- */
-function useRoute(path) {
-  const {
-    findRoute
-  } = useRouteSitemap();
-  return (0, _react.useMemo)(() => findRoute(path), [findRoute, path]);
-}
-
-/**
- * Get all parent routes for a given path
- *
- * @example
- * ```tsx
- * const parents = useParentRoutes('/pokemon/[id]');
- * // Returns: [{ path: '/pokemon', ... }]
- * ```
- */
-function useParentRoutes(path) {
-  const {
-    getParents
-  } = useRouteSitemap();
-  return (0, _react.useMemo)(() => getParents(path), [getParents, path]);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useParentRoutes=useParentRoutes;exports.useRoute=useRoute;exports.useRouteSitemap=useRouteSitemap;var _react=require("react");var _RouteParser=require("./RouteParser");var _expoRouterStore=require("./expoRouterStore");function buildRouteNodeFromNavigationState(t){if(!t||!t.routes)return null;const r=t.routes?.[0];if(!r)return null;const s={type:"route",route:"",dynamic:null,children:[],contextKey:"_app"};function l(n,a,h=""){if(!n||!n.routes)return;n.routes.forEach(R=>{const e=R.name;if(e.startsWith("__")||e.includes("_layout")||e.startsWith("+not-found")){return}const u={type:e==="index"?"route":"route",route:e==="index"?"":e,dynamic:e.includes("[")?[e.match(/\[([^\]]+)\]/)?.[1]||""]:null,children:[],contextKey:`app/${e}`};a.children.push(u);if(R.state){l(R.state,u,`${h}/${e}`)}})}l(t,s);return s.children.length>0?s:null}function useRouteSitemap(t={}){const{searchQuery:r="",sortBy:s="path",autoRefresh:l=false,refreshInterval:n=1e3,injectedRoutes:a,injectedSource:h=null,injectedLastUpdatedAt:R=null}=t;const e=a!=null;const[u,S]=(0,_react.useState)(()=>{const o=(0,_expoRouterStore.loadRouteNode)();const d=(0,_expoRouterStore.getRouteNodeMetadata)();return{node:o,version:0,lastUpdatedAt:d.lastLoadedAt,source:d.source}});const c=u.node;const y=u.version;const g=u.lastUpdatedAt;const v=u.source;const f=(0,_react.useCallback)(()=>{S(o=>{const d=(0,_expoRouterStore.loadRouteNode)();const p=(0,_expoRouterStore.getRouteNodeMetadata)();return{node:d,version:o.version+1,lastUpdatedAt:p.lastLoadedAt,source:p.source}})},[]);(0,_react.useEffect)(()=>{if(c){return}if(e){return}if(!(0,_expoRouterStore.isExpoRouterStoreSupported)()){return}let o=0;const d=100;const p=()=>{o++;f();if(o<d){x=setTimeout(p,100)}};let x=setTimeout(p,100);return()=>clearTimeout(x)},[c,f,e]);(0,_react.useEffect)(()=>{if(!l)return;const o=setInterval(f,n);return()=>clearInterval(o)},[l,n,f]);const M=e?a.length>0:!!c;const N=e?true:(0,_expoRouterStore.isExpoRouterStoreSupported)();const i=(0,_react.useMemo)(()=>{if(e)return a;if(!c)return[];return _RouteParser.RouteParser.parseRouteTree(c)},[c,y,e,a]);const m=(0,_react.useMemo)(()=>{return _RouteParser.RouteParser.sortRoutes(i,s)},[i,s]);const P=(0,_react.useMemo)(()=>{if(!r)return m;return _RouteParser.RouteParser.filterRoutes(m,r)},[m,r]);const _=(0,_react.useMemo)(()=>{return _RouteParser.RouteParser.organizeRoutes(P)},[P]);const A=(0,_react.useMemo)(()=>{return _RouteParser.RouteParser.getRouteStats(i)},[i]);const T=o=>_RouteParser.RouteParser.findRouteByPath(i,o);const U=o=>_RouteParser.RouteParser.getParentRoutes(i,o);return{routes:m,groups:_,stats:A,filteredRoutes:P,isLoaded:M,isSupported:N,refresh:f,findRoute:T,getParents:U,lastUpdatedAt:e?R:g,source:e?h:v}}function useRoute(t){const{findRoute:r}=useRouteSitemap();return(0,_react.useMemo)(()=>r(t),[r,t])}function useParentRoutes(t){const{getParents:r}=useRouteSitemap();return(0,_react.useMemo)(()=>r(t),[r,t])}

package/lib/commonjs/utils/routeTemplate.js

@@ -1,79 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getRouteTemplate = getRouteTemplate;
-exports.routeHref = routeHref;
-exports.splitRouteHref = splitRouteHref;
-/**
- * Infer a route template from a concrete pathname and its segments.
- * Dynamic segments (numeric ids, UUIDs) collapse to `[id]`, so
- * `/products/42` becomes `/products/[id]`. Returns null when the template
- * matches the pathname (i.e. the route is fully static).
- */
-function getRouteTemplate(pathname, segments) {
-  if (!segments || segments.length === 0) return null;
-  const templateParts = segments.map(segment => {
-    // Numeric ids
-    if (/^\d+$/.test(segment)) {
-      return "[id]";
-    }
-    // UUIDs
-    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(segment)) {
-      return "[id]";
-    }
-    return segment;
-  });
-  const template = "/" + templateParts.join("/");
-  return template !== pathname ? template : null;
-}
-
-/**
- * The href that reopens a recorded route: its pathname plus the params that are
- * not already in the path, as a query string. Expo Router reports dynamic
- * segment values (`/order/42` → `{ id: "42" }`) and search params (`?menu=1`)
- * in one `params` object; only the second kind needs to be carried, because the
- * first is already in the pathname.
- */
-function routeHref(pathname, params) {
-  if (!params) return pathname;
-  const inPath = new Set(pathname.split("/").filter(Boolean).map(seg => {
-    try {
-      return decodeURIComponent(seg);
-    } catch {
-      return seg;
-    }
-  }));
-  const query = [];
-  for (const [key, raw] of Object.entries(params)) {
-    const values = Array.isArray(raw) ? raw : [raw];
-    // A catch-all segment's values, or one dynamic segment's value.
-    if (values.length > 0 && values.every(v => inPath.has(String(v)))) continue;
-    for (const v of values) query.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(v))}`);
-  }
-  return query.length ? `${pathname}?${query.join("&")}` : pathname;
-}
-
-/** Split an href from {@link routeHref} back into its path and params. */
-function splitRouteHref(href) {
-  const q = href.indexOf("?");
-  if (q < 0) return {
-    pathname: href,
-    params: {}
-  };
-  const params = {};
-  for (const pair of href.slice(q + 1).split("&")) {
-    if (!pair) continue;
-    const [k, v = ""] = pair.split("=");
-    try {
-      params[decodeURIComponent(k)] = decodeURIComponent(v);
-    } catch {
-      params[k] = v;
-    }
-  }
-  return {
-    pathname: href.slice(0, q),
-    params
-  };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getRouteTemplate=getRouteTemplate;exports.routeHref=routeHref;exports.splitRouteHref=splitRouteHref;function getRouteTemplate(t,n){if(!n||n.length===0)return null;const r=n.map(e=>{if(/^\d+$/.test(e)){return"[id]"}if(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(e)){return"[id]"}return e});const o="/"+r.join("/");return o!==t?o:null}function routeHref(t,n){if(!n)return t;const r=new Set(t.split("/").filter(Boolean).map(e=>{try{return decodeURIComponent(e)}catch{return e}}));const o=[];for(const[e,i]of Object.entries(n)){const u=Array.isArray(i)?i:[i];if(u.length>0&&u.every(c=>r.has(String(c))))continue;for(const c of u)o.push(`${encodeURIComponent(e)}=${encodeURIComponent(String(c))}`)}return o.length?`${t}?${o.join("&")}`:t}function splitRouteHref(t){const n=t.indexOf("?");if(n<0)return{pathname:t,params:{}};const r={};for(const o of t.slice(n+1).split("&")){if(!o)continue;const[e,i=""]=o.split("=");try{r[decodeURIComponent(e)]=decodeURIComponent(i)}catch{r[e]=i}}return{pathname:t.slice(0,n),params:r}}

package/lib/commonjs/utils/safeReactNavigation.js

@@ -1,194 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getCommonActions = getCommonActions;
-exports.getStackActions = getStackActions;
-exports.isReactNavigationAvailable = isReactNavigationAvailable;
-exports.useSafeNavigation = useSafeNavigation;
-exports.useSafeNavigationContainerRef = useSafeNavigationContainerRef;
-exports.useSafeNavigationState = useSafeNavigationState;
-var _react = require("react");
-/**
- * Safe wrapper for @react-navigation/native
- *
- * Provides optional imports for React Navigation hooks.
- * Falls back to no-op implementations when @react-navigation/native is not installed.
- */
-
-let reactNavigation = null;
-let isAvailable = false;
-let checkedAvailability = false;
-
-// Expo Router (SDK 54+) VENDORS React Navigation: its NavigationContainer
-// provides the vendored NavigationContainerRefContext from
-// expo-router/build/react-navigation, NOT the one exported by the
-// @react-navigation/native package (which may not even be installed, or is a
-// second module instance whose context nobody provides). Reading only the npm
-// context in such apps yields undefined forever — the Stack tab then hangs on
-// "Loading navigation stack...". So we load both copies and consult both
-// contexts.
-let vendoredReactNavigation = null;
-let checkedVendored = false;
-function getVendoredReactNavigation() {
-  if (checkedVendored) return vendoredReactNavigation;
-  checkedVendored = true;
-  try {
-    // Compat entry re-exporting the vendored native/core/routers modules.
-    // Older expo-router versions (and RN CLI apps) don't have it — the
-    // require throws and we stay on @react-navigation/native.
-    const vendored = require("expo-router/react-navigation");
-    vendoredReactNavigation = vendored?.NavigationContainerRefContext ? vendored : null;
-  } catch {
-    vendoredReactNavigation = null;
-  }
-  return vendoredReactNavigation;
-}
-function checkReactNavigationAvailability() {
-  if (checkedAvailability) return isAvailable;
-  try {
-    reactNavigation = require("@react-navigation/native");
-    isAvailable = reactNavigation != null;
-  } catch (error) {
-    isAvailable = false;
-    reactNavigation = null;
-  }
-
-  // Expo Router apps don't necessarily install @react-navigation/native at
-  // all — the vendored copy then supplies CommonActions/StackActions/hooks
-  // (actions are plain serializable objects, so either copy's work).
-  if (!isAvailable) {
-    const vendored = getVendoredReactNavigation();
-    if (vendored) {
-      reactNavigation = vendored;
-      isAvailable = true;
-    }
-  }
-  checkedAvailability = true;
-  return isAvailable;
-}
-
-// ============================================================================
-// No-op implementations when @react-navigation/native is not available
-// ============================================================================
-
-function noOpUseNavigation() {
-  return (0, _react.useMemo)(() => ({
-    navigate: () => console.warn("[route-events] @react-navigation/native not installed: navigate() unavailable"),
-    goBack: () => console.warn("[route-events] @react-navigation/native not installed: goBack() unavailable"),
-    canGoBack: () => false,
-    reset: () => console.warn("[route-events] @react-navigation/native not installed: reset() unavailable"),
-    setParams: () => console.warn("[route-events] @react-navigation/native not installed: setParams() unavailable"),
-    dispatch: () => console.warn("[route-events] @react-navigation/native not installed: dispatch() unavailable"),
-    isFocused: () => true,
-    addListener: () => () => {},
-    removeListener: () => {},
-    getParent: () => undefined,
-    getState: () => undefined,
-    getId: () => undefined
-  }), []);
-}
-function noOpUseNavigationState(selector) {
-  return (0, _react.useMemo)(() => {
-    // Return a minimal state structure
-    const emptyState = {
-      key: "default",
-      index: 0,
-      routeNames: [],
-      routes: [],
-      type: "stack"
-    };
-    try {
-      return selector ? selector(emptyState) : emptyState;
-    } catch {
-      return emptyState;
-    }
-  }, [selector]);
-}
-
-// ============================================================================
-// Safe hook exports
-// ============================================================================
-
-function useSafeNavigation() {
-  if (!checkReactNavigationAvailability()) {
-    return noOpUseNavigation();
-  }
-  try {
-    return reactNavigation.useNavigation();
-  } catch (error) {
-    console.warn("[route-events] Failed to use @react-navigation/native.useNavigation:", error);
-    return noOpUseNavigation();
-  }
-}
-function useSafeNavigationState(selector) {
-  if (!checkReactNavigationAvailability()) {
-    return noOpUseNavigationState(selector);
-  }
-  try {
-    return reactNavigation.useNavigationState(selector);
-  } catch (error) {
-    console.warn("[route-events] Failed to use @react-navigation/native.useNavigationState:", error);
-    return noOpUseNavigationState(selector);
-  }
-}
-
-// ============================================================================
-// Guarded module accessors
-// ============================================================================
-
-/**
- * Fallback for useContext when @react-navigation/native is absent: a stable
- * context that always yields undefined, so callers' `if (!containerRef)`
- * guards skip every dispatch path. Module presence is constant for the app
- * lifetime, so hook order stays stable either way.
- */
-const FallbackNavigationContainerRefContext = /*#__PURE__*/(0, _react.createContext)(undefined);
-
-/** CommonActions from @react-navigation/native, or null when absent. */
-function getCommonActions() {
-  return checkReactNavigationAvailability() ? reactNavigation.CommonActions : null;
-}
-
-/** StackActions from @react-navigation/native, or null when absent. */
-function getStackActions() {
-  return checkReactNavigationAvailability() ? reactNavigation.StackActions : null;
-}
-
-// Both contexts are resolved ONCE and cached so hook identity/order stays
-// stable for the app lifetime (module presence is constant).
-let npmContainerRefContext = null;
-let vendoredContainerRefContext = null;
-function getContainerRefContexts() {
-  if (npmContainerRefContext == null) {
-    npmContainerRefContext = checkReactNavigationAvailability() && reactNavigation.NavigationContainerRefContext ? reactNavigation.NavigationContainerRefContext : FallbackNavigationContainerRefContext;
-  }
-  if (vendoredContainerRefContext == null) {
-    const vendored = getVendoredReactNavigation();
-    vendoredContainerRefContext = vendored?.NavigationContainerRefContext ?? FallbackNavigationContainerRefContext;
-  }
-  return [npmContainerRefContext, vendoredContainerRefContext];
-}
-
-/**
- * The navigation container ref for THIS app, whichever module instance
- * provides it: @react-navigation/native's NavigationContainerRefContext
- * (RN CLI, older expo-router) or Expo Router's vendored copy (SDK 54+).
- * Returns undefined when rendered outside any NavigationContainer or when
- * React Navigation is absent entirely.
- */
-function useSafeNavigationContainerRef() {
-  const [npmCtx, vendoredCtx] = getContainerRefContexts();
-  const npmRef = (0, _react.useContext)(npmCtx);
-  const vendoredRef = (0, _react.useContext)(vendoredCtx);
-  return npmRef ?? vendoredRef;
-}
-
-// ============================================================================
-// Availability check
-// ============================================================================
-
-function isReactNavigationAvailable() {
-  return checkReactNavigationAvailability();
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getCommonActions=getCommonActions;exports.getStackActions=getStackActions;exports.isReactNavigationAvailable=isReactNavigationAvailable;exports.useSafeNavigation=useSafeNavigation;exports.useSafeNavigationContainerRef=useSafeNavigationContainerRef;exports.useSafeNavigationState=useSafeNavigationState;var _react=require("react");let reactNavigation=null;let isAvailable=false;let checkedAvailability=false;let vendoredReactNavigation=null;let checkedVendored=false;function getVendoredReactNavigation(){if(checkedVendored)return vendoredReactNavigation;checkedVendored=true;try{const e=require("expo-router/react-navigation");vendoredReactNavigation=e?.NavigationContainerRefContext?e:null}catch{vendoredReactNavigation=null}return vendoredReactNavigation}function checkReactNavigationAvailability(){if(checkedAvailability)return isAvailable;try{reactNavigation=require("@react-navigation/native");isAvailable=reactNavigation!=null}catch(e){isAvailable=false;reactNavigation=null}if(!isAvailable){const e=getVendoredReactNavigation();if(e){reactNavigation=e;isAvailable=true}}checkedAvailability=true;return isAvailable}function noOpUseNavigation(){return(0,_react.useMemo)(()=>({navigate:()=>console.warn("[route-events] @react-navigation/native not installed: navigate() unavailable"),goBack:()=>console.warn("[route-events] @react-navigation/native not installed: goBack() unavailable"),canGoBack:()=>false,reset:()=>console.warn("[route-events] @react-navigation/native not installed: reset() unavailable"),setParams:()=>console.warn("[route-events] @react-navigation/native not installed: setParams() unavailable"),dispatch:()=>console.warn("[route-events] @react-navigation/native not installed: dispatch() unavailable"),isFocused:()=>true,addListener:()=>()=>{},removeListener:()=>{},getParent:()=>void 0,getState:()=>void 0,getId:()=>void 0}),[])}function noOpUseNavigationState(e){return(0,_react.useMemo)(()=>{const t={key:"default",index:0,routeNames:[],routes:[],type:"stack"};try{return e?e(t):t}catch{return t}},[e])}function useSafeNavigation(){if(!checkReactNavigationAvailability()){return noOpUseNavigation()}try{return reactNavigation.useNavigation()}catch(e){console.warn("[route-events] Failed to use @react-navigation/native.useNavigation:",e);return noOpUseNavigation()}}function useSafeNavigationState(e){if(!checkReactNavigationAvailability()){return noOpUseNavigationState(e)}try{return reactNavigation.useNavigationState(e)}catch(t){console.warn("[route-events] Failed to use @react-navigation/native.useNavigationState:",t);return noOpUseNavigationState(e)}}const FallbackNavigationContainerRefContext=(0,_react.createContext)(void 0);function getCommonActions(){return checkReactNavigationAvailability()?reactNavigation.CommonActions:null}function getStackActions(){return checkReactNavigationAvailability()?reactNavigation.StackActions:null}let npmContainerRefContext=null;let vendoredContainerRefContext=null;function getContainerRefContexts(){if(npmContainerRefContext==null){npmContainerRefContext=checkReactNavigationAvailability()&&reactNavigation.NavigationContainerRefContext?reactNavigation.NavigationContainerRefContext:FallbackNavigationContainerRefContext}if(vendoredContainerRefContext==null){const e=getVendoredReactNavigation();vendoredContainerRefContext=e?.NavigationContainerRefContext??FallbackNavigationContainerRefContext}return[npmContainerRefContext,vendoredContainerRefContext]}function useSafeNavigationContainerRef(){const[e,t]=getContainerRefContexts();const n=(0,_react.useContext)(e);const a=(0,_react.useContext)(t);return n??a}function isReactNavigationAvailable(){return checkReactNavigationAvailability()}

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

@@ -1,36 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getCommonActions = getCommonActions;
-exports.getStackActions = getStackActions;
-exports.isReactNavigationAvailable = isReactNavigationAvailable;
-exports.useSafeNavigation = useSafeNavigation;
-exports.useSafeNavigationContainerRef = useSafeNavigationContainerRef;
-exports.useSafeNavigationState = useSafeNavigationState;
-var _utils = require("@buoy-gg/shared-ui/utils");
-function useSafeNavigation() {
-  return _utils.browserRouter;
-}
-function useSafeNavigationState(selector) {
-  return selector({
-    routes: [],
-    routeNames: [],
-    index: 0,
-    key: 'browser',
-    type: 'stack'
-  });
-}
-function useSafeNavigationContainerRef() {
-  return undefined;
-}
-function getCommonActions() {
-  return null;
-}
-function getStackActions() {
-  return null;
-}
-function isReactNavigationAvailable() {
-  return false;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getCommonActions=getCommonActions;exports.getStackActions=getStackActions;exports.isReactNavigationAvailable=isReactNavigationAvailable;exports.useSafeNavigation=useSafeNavigation;exports.useSafeNavigationContainerRef=useSafeNavigationContainerRef;exports.useSafeNavigationState=useSafeNavigationState;var _utils=require("@buoy-gg/shared-ui/utils");function useSafeNavigation(){return _utils.browserRouter}function useSafeNavigationState(e){return e({routes:[],routeNames:[],index:0,key:"browser",type:"stack"})}function useSafeNavigationContainerRef(){return void 0}function getCommonActions(){return null}function getStackActions(){return null}function isReactNavigationAvailable(){return false}

package/lib/commonjs/utils/testIDs.js

@@ -1,63 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.eventRowTestID = eventRowTestID;
-exports.pathSlug = pathSlug;
-exports.sitemapGroupTestID = sitemapGroupTestID;
-exports.sitemapRouteTestID = sitemapRouteTestID;
-exports.stackItemTestID = stackItemTestID;
-/**
- * Stable e2e handles for the routes tool.
- *
- * Everything in this tool is addressed by its PATH, never by a list index or a
- * per-session id. Route events are a prepend-list whose indices shift on every
- * navigation, the sitemap re-sorts and regroups as you search, and the stack
- * renumbers itself on every push — the pathname is the one thing that means the
- * same screen on the next launch, and the only thing a test can name up front.
- *
- * A pathname is not testID-safe as it stands (`/blog/2024/react-native-tips`,
- * `/pokemon/[id]`), so it is slugged the way the rest of Buoy's handles read:
- * `buoy-routes-route-blog-year-slug`.
- */
-
-/** Any path-ish string → a testID-safe slug (`/` → `-`, brackets dropped). */
-function pathSlug(path) {
-  return String(path).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "root";
-}
-
-/**
- * `buoy-routes-event-row-<slug>-<visit>` for one row of the events timeline.
- *
- * The visit number is part of the handle because revisiting a screen is the
- * normal case here: three trips to `/about` would otherwise be three views
- * sharing one testID, which Detox reports as "multiple elements found" — an
- * ambiguity error where the test meant "the second visit". It also makes the
- * tool's own visit counting addressable rather than merely visible.
- */
-function eventRowTestID(pathname, visitNumber) {
-  return `buoy-routes-event-row-${pathSlug(pathname)}-${visitNumber}`;
-}
-
-/** `buoy-routes-route-<slug>` for one row of the sitemap. */
-function sitemapRouteTestID(path) {
-  return `buoy-routes-route-${pathSlug(path)}`;
-}
-
-/** `buoy-routes-group-<slug>` for a sitemap group header. */
-function sitemapGroupTestID(title) {
-  return `buoy-routes-group-${pathSlug(title)}`;
-}
-
-/**
- * `buoy-routes-stack-item-<index>` for one frame of the navigation stack.
- *
- * The exception to addressing by path: a stack legitimately holds the same
- * route twice (push `/route-bench/1` from `/route-bench/1`), and its whole
- * subject is POSITION — "index 2 of 4" is what the row means, so the position
- * is what the handle should say.
- */
-function stackItemTestID(index) {
-  return `buoy-routes-stack-item-${index}`;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.eventRowTestID=eventRowTestID;exports.pathSlug=pathSlug;exports.sitemapGroupTestID=sitemapGroupTestID;exports.sitemapRouteTestID=sitemapRouteTestID;exports.stackItemTestID=stackItemTestID;function pathSlug(e){return String(e).toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||"root"}function eventRowTestID(e,t){return`buoy-routes-event-row-${pathSlug(e)}-${t}`}function sitemapRouteTestID(e){return`buoy-routes-route-${pathSlug(e)}`}function sitemapGroupTestID(e){return`buoy-routes-group-${pathSlug(e)}`}function stackItemTestID(e){return`buoy-routes-stack-item-${e}`}