@buoy-gg/route-events 7.0.41 → 7.0.43

package/lib/module/useNavigationStack.web.js

@@ -1,28 +1 @@
-"use strict";
-
-import { useSyncExternalStore } from 'react';
-import { navigationStackStore } from './stores/navigationStackStore';
-const empty = [];
-export function useNavigationStack() {
-  const stack = useSyncExternalStore(callback => navigationStackStore.subscribe(callback), () => navigationStackStore.getStack(), () => empty);
-  const focused = stack.find(item => item.isFocused) ?? null;
-  const actions = () => {
-    const current = navigationStackStore.getActions();
-    if (!current) throw new Error('Mount RouteTracker to capture browser navigation.');
-    return current;
-  };
-  return {
-    stack,
-    focusedRoute: focused,
-    stackDepth: stack.length,
-    isAtRoot: !focused || focused.index === 0,
-    isLoaded: stack.length > 0,
-    error: null,
-    refresh: () => {},
-    navigateToIndex: index => actions().navigateToIndex(index),
-    navigateToRoute: (name, params) => actions().navigateToRoute?.(name, params) ?? false,
-    popToIndex: index => actions().popToIndex(index),
-    goBack: () => actions().goBack(),
-    popToTop: () => actions().popToTop()
-  };
-}
+"use strict";import{useSyncExternalStore as c}from"react";import{navigationStackStore as r}from"./stores/navigationStackStore";const s=[];export function useNavigationStack(){const e=c(o=>r.subscribe(o),()=>r.getStack(),()=>s);const n=e.find(o=>o.isFocused)??null;const t=()=>{const o=r.getActions();if(!o)throw new Error("Mount RouteTracker to capture browser navigation.");return o};return{stack:e,focusedRoute:n,stackDepth:e.length,isAtRoot:!n||n.index===0,isLoaded:e.length>0,error:null,refresh:()=>{},navigateToIndex:o=>t().navigateToIndex(o),navigateToRoute:(o,a)=>t().navigateToRoute?.(o,a)??false,popToIndex:o=>t().popToIndex(o),goBack:()=>t().goBack(),popToTop:()=>t().popToTop()}}

package/lib/module/useRouteObserver.js

@@ -1,70 +1 @@
-"use strict";
-
-/**
- * useRouteObserver - React hook for observing route changes
- *
- * Uses public Expo Router hooks to track route changes and emits them
- * to the global RouteObserver singleton.
- */
-
-import { useEffect, useRef } from "react";
-import { useSafePathname, useSafeSegments, useSafeGlobalSearchParams } from "@buoy-gg/shared-ui";
-import { routeObserver } from "./RouteObserver";
-
-/**
- * Hook to observe route changes in Expo Router
- * Automatically emits events to the global RouteObserver
- *
- * @param callback - Optional function to call on route changes (in addition to the observer)
- *
- * @example
- * ```tsx
- * // Just track routes (no custom callback)
- * useRouteObserver();
- *
- * // Track routes with custom callback
- * useRouteObserver((event) => {
- *   // Handle route change
- *   analytics.trackPageView(event.pathname);
- * });
- * ```
- */
-export function useRouteObserver(callback) {
-  const pathname = useSafePathname();
-  const segments = useSafeSegments();
-  const params = useSafeGlobalSearchParams();
-  const callbackRef = useRef(callback);
-  const previousPathnameRef = useRef(undefined);
-  const previousTimestampRef = useRef(undefined);
-
-  // Update ref when callback changes
-  useEffect(() => {
-    callbackRef.current = callback;
-  }, [callback]);
-
-  // Trigger observer and callback whenever route changes
-  useEffect(() => {
-    const now = Date.now();
-    const timeSincePrevious = previousTimestampRef.current ? now - previousTimestampRef.current : undefined;
-    const event = {
-      pathname,
-      params: params,
-      segments: segments,
-      timestamp: now,
-      previousPathname: previousPathnameRef.current,
-      timeSincePrevious
-    };
-
-    // Update refs for next navigation
-    previousPathnameRef.current = pathname;
-    previousTimestampRef.current = now;
-
-    // Emit to the global observer (this notifies the modal)
-    routeObserver.emit(event);
-
-    // Also call the custom callback if provided
-    if (callbackRef.current) {
-      callbackRef.current(event);
-    }
-  }, [pathname, segments, params]);
-}
+"use strict";import{useEffect as i,useRef as o}from"react";import{useSafePathname as p,useSafeSegments as v,useSafeGlobalSearchParams as d}from"@buoy-gg/shared-ui";import{routeObserver as S}from"./RouteObserver";export function useRouteObserver(e){const t=p();const u=v();const m=d();const r=o(e);const a=o(void 0);const n=o(void 0);i(()=>{r.current=e},[e]);i(()=>{const s=Date.now();const f=n.current?s-n.current:void 0;const c={pathname:t,params:m,segments:u,timestamp:s,previousPathname:a.current,timeSincePrevious:f};a.current=t;n.current=s;S.emit(c);if(r.current){r.current(c)}},[t,u,m])}

package/lib/module/useRouteObserverReactNavigation.js

@@ -1,106 +1 @@
-"use strict";
-
-/**
- * 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 { useEffect, useRef } from "react";
-import { useSafeNavigationContainerRef } from "./utils/safeReactNavigation";
-import { routeObserver } from "./RouteObserver";
-
-/**
- * Walk a React Navigation state tree to find the deepest focused route.
- * Returns the route object and the array of route names from root to leaf.
- */
-function getDeepestFocusedRoute(state) {
-  if (!state || !state.routes || state.routes.length === 0) {
-    return {
-      route: null,
-      segments: []
-    };
-  }
-  const route = state.routes[state.index ?? 0];
-  const segments = [route.name];
-  if (route.state) {
-    const nested = getDeepestFocusedRoute(route.state);
-    if (nested.route) {
-      return {
-        route: nested.route,
-        segments: [...segments, ...nested.segments]
-      };
-    }
-  }
-  return {
-    route,
-    segments
-  };
-}
-function emitRouteEvent(state, previousPathnameRef, previousTimestampRef, callbackRef) {
-  if (!state) return;
-  const {
-    route,
-    segments
-  } = getDeepestFocusedRoute(state);
-  if (!route) return;
-  const pathname = `/${route.name}`;
-
-  // Skip if pathname hasn't changed
-  if (pathname === previousPathnameRef.current) return;
-  const now = Date.now();
-  const timeSincePrevious = previousTimestampRef.current ? now - previousTimestampRef.current : undefined;
-  const event = {
-    pathname,
-    params: route.params || {},
-    segments,
-    timestamp: now,
-    previousPathname: previousPathnameRef.current,
-    timeSincePrevious
-  };
-  previousPathnameRef.current = pathname;
-  previousTimestampRef.current = now;
-  routeObserver.emit(event);
-  if (callbackRef.current) {
-    callbackRef.current(event);
-  }
-}
-
-/**
- * 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 function useRouteObserverReactNavigation(callback) {
-  const containerRef = useSafeNavigationContainerRef();
-  const callbackRef = useRef(callback);
-  const previousPathnameRef = useRef(undefined);
-  const previousTimestampRef = useRef(undefined);
-  useEffect(() => {
-    callbackRef.current = callback;
-  }, [callback]);
-  useEffect(() => {
-    if (!containerRef) return;
-
-    // Emit for the initial state
-    const initialState = containerRef.getRootState?.();
-    if (initialState) {
-      emitRouteEvent(initialState, previousPathnameRef, previousTimestampRef, callbackRef);
-    }
-
-    // Listen for state changes
-    const unsubscribe = containerRef.addListener?.("state", () => {
-      const state = containerRef.getRootState?.();
-      emitRouteEvent(state, previousPathnameRef, previousTimestampRef, callbackRef);
-    });
-    return () => {
-      unsubscribe?.();
-    };
-  }, [containerRef]);
-}
+"use strict";import{useEffect as m,useRef as c}from"react";import{useSafeNavigationContainerRef as p}from"./utils/safeReactNavigation";import{routeObserver as R}from"./RouteObserver";function a(t){if(!t||!t.routes||t.routes.length===0){return{route:null,segments:[]}}const e=t.routes[t.index??0];const n=[e.name];if(e.state){const r=a(e.state);if(r.route){return{route:r.route,segments:[...n,...r.segments]}}}return{route:e,segments:n}}function d(t,e,n,r){if(!t)return;const{route:o,segments:i}=a(t);if(!o)return;const u=`/${o.name}`;if(u===e.current)return;const s=Date.now();const g=n.current?s-n.current:void 0;const f={pathname:u,params:o.params||{},segments:i,timestamp:s,previousPathname:e.current,timeSincePrevious:g};e.current=u;n.current=s;R.emit(f);if(r.current){r.current(f)}}export function useRouteObserverReactNavigation(t){const e=p();const n=c(t);const r=c(void 0);const o=c(void 0);m(()=>{n.current=t},[t]);m(()=>{if(!e)return;const i=e.getRootState?.();if(i){d(i,r,o,n)}const u=e.addListener?.("state",()=>{const s=e.getRootState?.();d(s,r,o,n)});return()=>{u?.()}},[e])}

package/lib/module/useRouteSitemap.js

@@ -1,250 +1 @@
-"use strict";
-
-/**
- * useRouteSitemap - React hooks for accessing parsed route information
- *
- * Provides access to the Expo Router route tree with parsing, filtering,
- * and search capabilities.
- */
-
-import { useState, useEffect, useMemo, useCallback } from "react";
-import { RouteParser } from "./RouteParser";
-import { getRouteNodeMetadata, isExpoRouterStoreSupported, loadRouteNode } from "./expoRouterStore";
-
-// 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
- * });
- * ```
- */
-export function useRouteSitemap(options = {}) {
-  const {
-    searchQuery = "",
-    sortBy = "path",
-    autoRefresh = false,
-    refreshInterval = 1000,
-    injectedRoutes,
-    injectedSource = null,
-    injectedLastUpdatedAt = null
-  } = options;
-  const hasInjectedRoutes = injectedRoutes != null;
-  const [routeTreeState, setRouteTreeState] = useState(() => {
-    const node = loadRouteNode();
-    const metadata = 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 = useCallback(() => {
-    setRouteTreeState(previous => {
-      const node = loadRouteNode();
-      const metadata = 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.
-  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 (!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
-  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 : isExpoRouterStoreSupported();
-
-  // Parse routes (or use the pre-parsed routes injected from the dashboard).
-  const routes = useMemo(() => {
-    if (hasInjectedRoutes) return injectedRoutes;
-    if (!routeNode) return [];
-    return RouteParser.parseRouteTree(routeNode);
-  }, [routeNode, routeNodeVersion, hasInjectedRoutes, injectedRoutes]);
-
-  // Sort routes
-  const sortedRoutes = useMemo(() => {
-    return RouteParser.sortRoutes(routes, sortBy);
-  }, [routes, sortBy]);
-
-  // Filter routes by search query
-  const filteredRoutes = useMemo(() => {
-    if (!searchQuery) return sortedRoutes;
-    return RouteParser.filterRoutes(sortedRoutes, searchQuery);
-  }, [sortedRoutes, searchQuery]);
-
-  // Organize into groups
-  const groups = useMemo(() => {
-    return RouteParser.organizeRoutes(filteredRoutes);
-  }, [filteredRoutes]);
-
-  // Calculate stats
-  const stats = useMemo(() => {
-    return RouteParser.getRouteStats(routes);
-  }, [routes]);
-
-  // Helper functions
-  const findRoute = path => RouteParser.findRouteByPath(routes, path);
-  const getParents = path => 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]');
- * ```
- */
-export function useRoute(path) {
-  const {
-    findRoute
-  } = useRouteSitemap();
-  return useMemo(() => findRoute(path), [findRoute, path]);
-}
-
-/**
- * Get all parent routes for a given path
- *
- * @example
- * ```tsx
- * const parents = useParentRoutes('/pokemon/[id]');
- * // Returns: [{ path: '/pokemon', ... }]
- * ```
- */
-export function useParentRoutes(path) {
-  const {
-    getParents
-  } = useRouteSitemap();
-  return useMemo(() => getParents(path), [getParents, path]);
-}
+"use strict";import{useState as C,useEffect as N,useMemo as u,useCallback as K}from"react";import{RouteParser as s}from"./RouteParser";import{getRouteNodeMetadata as S,isExpoRouterStoreSupported as v,loadRouteNode as P}from"./expoRouterStore";function z(e){if(!e||!e.routes)return null;const r=e.routes?.[0];if(!r)return null;const c={type:"route",route:"",dynamic:null,children:[],contextKey:"_app"};function p(a,i,g=""){if(!a||!a.routes)return;a.routes.forEach(R=>{const t=R.name;if(t.startsWith("__")||t.includes("_layout")||t.startsWith("+not-found")){return}const n={type:t==="index"?"route":"route",route:t==="index"?"":t,dynamic:t.includes("[")?[t.match(/\[([^\]]+)\]/)?.[1]||""]:null,children:[],contextKey:`app/${t}`};i.children.push(n);if(R.state){p(R.state,n,`${g}/${t}`)}})}p(e,c);return c.children.length>0?c:null}export function useRouteSitemap(e={}){const{searchQuery:r="",sortBy:c="path",autoRefresh:p=false,refreshInterval:a=1e3,injectedRoutes:i,injectedSource:g=null,injectedLastUpdatedAt:R=null}=e;const t=i!=null;const[n,T]=C(()=>{const o=P();const f=S();return{node:o,version:0,lastUpdatedAt:f.lastLoadedAt,source:f.source}});const d=n.node;const U=n.version;const j=n.lastUpdatedAt;const I=n.source;const m=K(()=>{T(o=>{const f=P();const h=S();return{node:f,version:o.version+1,lastUpdatedAt:h.lastLoadedAt,source:h.source}})},[]);N(()=>{if(d){return}if(t){return}if(!v()){return}let o=0;const f=100;const h=()=>{o++;m();if(o<f){A=setTimeout(h,100)}};let A=setTimeout(h,100);return()=>clearTimeout(A)},[d,m,t]);N(()=>{if(!p)return;const o=setInterval(m,a);return()=>clearInterval(o)},[p,a,m]);const L=t?i.length>0:!!d;const _=t?true:v();const l=u(()=>{if(t)return i;if(!d)return[];return s.parseRouteTree(d)},[d,U,t,i]);const y=u(()=>{return s.sortRoutes(l,c)},[l,c]);const x=u(()=>{if(!r)return y;return s.filterRoutes(y,r)},[y,r]);const E=u(()=>{return s.organizeRoutes(x)},[x]);const $=u(()=>{return s.getRouteStats(l)},[l]);const b=o=>s.findRouteByPath(l,o);const B=o=>s.getParentRoutes(l,o);return{routes:y,groups:E,stats:$,filteredRoutes:x,isLoaded:L,isSupported:_,refresh:m,findRoute:b,getParents:B,lastUpdatedAt:t?R:j,source:t?g:I}}export function useRoute(e){const{findRoute:r}=useRouteSitemap();return u(()=>r(e),[r,e])}export function useParentRoutes(e){const{getParents:r}=useRouteSitemap();return u(()=>r(e),[r,e])}

package/lib/module/utils/routeTemplate.js

@@ -1,73 +1 @@
-"use strict";
-
-/**
- * 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).
- */
-export 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.
- */
-export 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. */
-export 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";export function getRouteTemplate(t,e){if(!e||e.length===0)return null;const r=e.map(n=>{if(/^\d+$/.test(n)){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(n)){return"[id]"}return n});const o="/"+r.join("/");return o!==t?o:null}export function routeHref(t,e){if(!e)return t;const r=new Set(t.split("/").filter(Boolean).map(n=>{try{return decodeURIComponent(n)}catch{return n}}));const o=[];for(const[n,i]of Object.entries(e)){const c=Array.isArray(i)?i:[i];if(c.length>0&&c.every(u=>r.has(String(u))))continue;for(const u of c)o.push(`${encodeURIComponent(n)}=${encodeURIComponent(String(u))}`)}return o.length?`${t}?${o.join("&")}`:t}export function splitRouteHref(t){const e=t.indexOf("?");if(e<0)return{pathname:t,params:{}};const r={};for(const o of t.slice(e+1).split("&")){if(!o)continue;const[n,i=""]=o.split("=");try{r[decodeURIComponent(n)]=decodeURIComponent(i)}catch{r[n]=i}}return{pathname:t.slice(0,e),params:r}}