@buoy-gg/route-events 1.7.2

package/lib/module/useRouteSitemap.js

@@ -0,0 +1,229 @@
+"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, 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
+  } = options;
+  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;
+    }
+    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]);
+
+  // 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]);
+  const isLoaded = !!routeNode;
+
+  // Parse routes
+  const routes = useMemo(() => {
+    if (!routeNode) return [];
+    return RouteParser.parseRouteTree(routeNode);
+  }, [routeNode, routeNodeVersion]);
+
+  // 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,
+    refresh,
+    findRoute,
+    getParents,
+    lastUpdatedAt,
+    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]);
+}

package/lib/module/utils/safeExpoRouter.js

@@ -0,0 +1,120 @@
+"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/module/utils/safeReactNavigation.js

@@ -0,0 +1,98 @@
+"use strict";
+
+/**
+ * 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.
+ */
+
+import { useMemo } from "react";
+let reactNavigation = null;
+let isAvailable = false;
+let checkedAvailability = false;
+function checkReactNavigationAvailability() {
+  if (checkedAvailability) return isAvailable;
+  try {
+    reactNavigation = require("@react-navigation/native");
+    isAvailable = reactNavigation != null;
+  } catch (error) {
+    isAvailable = false;
+    reactNavigation = null;
+  }
+  checkedAvailability = true;
+  return isAvailable;
+}
+
+// ============================================================================
+// No-op implementations when @react-navigation/native is not available
+// ============================================================================
+
+function noOpUseNavigation() {
+  return 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 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
+// ============================================================================
+
+export 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();
+  }
+}
+export 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);
+  }
+}
+
+// ============================================================================
+// Availability check
+// ============================================================================
+
+export function isReactNavigationAvailable() {
+  return checkReactNavigationAvailability();
+}

package/lib/typescript/RouteObserver.d.ts

@@ -0,0 +1,37 @@
+/**
+ * RouteObserver - Tracks route changes in Expo Router
+ *
+ * Note: This is a simple event emitter that works with the useRouteObserver hook
+ * The actual route tracking happens in the hook using public Expo Router APIs
+ */
+export interface RouteChangeEvent {
+    pathname: string;
+    params: Record<string, string | string[]>;
+    segments: string[];
+    timestamp: number;
+    previousPathname?: string;
+    timeSincePrevious?: number;
+}
+export declare class RouteObserver {
+    private listeners;
+    /**
+     * Emit a route change event
+     * Called by the useRouteObserver hook
+     */
+    emit(event: RouteChangeEvent): void;
+    /**
+     * Add listener for route changes
+     * @returns Cleanup function to remove the listener
+     */
+    addListener(callback: (event: RouteChangeEvent) => void): () => boolean;
+    /**
+     * Remove a specific listener
+     */
+    removeListener(callback: (event: RouteChangeEvent) => void): void;
+}
+/**
+ * Singleton instance of RouteObserver
+ * Use this for all route tracking to ensure events are centralized
+ */
+export declare const routeObserver: RouteObserver;
+//# sourceMappingURL=RouteObserver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RouteObserver.d.ts","sourceRoot":"","sources":["../../src/RouteObserver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAqD;IAEtE;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,gBAAgB;IAW5B;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI;IAKvD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI;CAG3D;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/lib/typescript/RouteParser.d.ts

@@ -0,0 +1,129 @@
+/**
+ * RouteParser - Extract and organize routes from Expo Router's RouteNode tree
+ *
+ * Based on research findings in:
+ * - docs/routing/expo/ROUTENODE_TYPE_DEFINITION.md
+ * - docs/routing/expo/ROUTES_SITEMAP_RESEARCH.md
+ */
+type RouteNode = {
+    type: 'route' | 'api' | 'layout' | 'redirect' | 'rewrite';
+    route: string;
+    contextKey: string;
+    children: RouteNode[];
+    dynamic: null | Array<{
+        name: string;
+        deep: boolean;
+        notFound?: boolean;
+    }>;
+    internal?: boolean;
+    generated?: boolean;
+    initialRouteName?: string;
+};
+/**
+ * Route type classification
+ */
+export type RouteType = 'static' | 'dynamic' | 'catch-all' | 'index' | 'layout' | 'group' | 'not-found';
+/**
+ * Parsed route information
+ */
+export interface RouteInfo {
+    /** Full path (e.g., "/pokemon/[id]") */
+    path: string;
+    /** Route name/segment (e.g., "[id]") */
+    name: string;
+    /** Route type classification */
+    type: RouteType;
+    /** Dynamic parameter names (e.g., ["id"]) */
+    params: string[];
+    /** Original RouteNode type */
+    nodeType: RouteNode['type'];
+    /** File path/context key */
+    contextKey: string;
+    /** Is this route internal/generated? */
+    isInternal: boolean;
+    /** Children routes */
+    children: RouteInfo[];
+    /** Depth in route tree (0 = root) */
+    depth: number;
+}
+/**
+ * Grouped routes for display
+ */
+export interface RouteGroup {
+    title: string;
+    icon: string;
+    description?: string;
+    routes: RouteInfo[];
+}
+/**
+ * Route statistics
+ */
+export interface RouteStats {
+    total: number;
+    static: number;
+    dynamic: number;
+    catchAll: number;
+    layouts: number;
+    groups: number;
+}
+export declare class RouteParser {
+    /**
+     * Parse RouteNode tree and extract all routes
+     */
+    static parseRouteTree(rootNode: RouteNode | null): RouteInfo[];
+    /**
+     * Recursively traverse RouteNode tree
+     */
+    private static traverseNode;
+    /**
+     * Build full path for a route node
+     */
+    private static buildPath;
+    /**
+     * Detect the route type classification
+     */
+    private static detectRouteType;
+    /**
+     * Extract dynamic parameter names from route
+     */
+    private static extractParams;
+    /**
+     * Determine if route should be included in results
+     */
+    private static shouldIncludeRoute;
+    /**
+     * Organize routes into groups for display
+     */
+    static organizeRoutes(routes: RouteInfo[]): RouteGroup[];
+    /**
+     * Flatten nested routes into a single array
+     */
+    private static flattenRoutes;
+    /**
+     * Get route statistics
+     */
+    static getRouteStats(routes: RouteInfo[]): RouteStats;
+    /**
+     * Search/filter routes by query
+     */
+    static filterRoutes(routes: RouteInfo[], query: string): RouteInfo[];
+    /**
+     * Build a visual tree string representation
+     */
+    static buildTreeString(routes: RouteInfo[], depth?: number): string;
+    private static buildTreePrefix;
+    /**
+     * Sort routes by various criteria
+     */
+    static sortRoutes(routes: RouteInfo[], sortBy?: 'path' | 'type' | 'name'): RouteInfo[];
+    /**
+     * Get route by path
+     */
+    static findRouteByPath(routes: RouteInfo[], path: string): RouteInfo | null;
+    /**
+     * Get all parent routes for a given route
+     */
+    static getParentRoutes(routes: RouteInfo[], targetPath: string): RouteInfo[];
+}
+export {};
+//# sourceMappingURL=RouteParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RouteParser.d.ts","sourceRoot":"","sources":["../../src/RouteParser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,OAAO,EAAE,IAAI,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,OAAO,GACP,QAAQ,GACR,OAAO,GACP,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,IAAI,EAAE,SAAS,CAAC;IAEhB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,8BAA8B;IAC9B,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAE5B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;IAEpB,sBAAsB;IACtB,QAAQ,EAAE,SAAS,EAAE,CAAC;IAEtB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EAAE;IAU9D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IA+B3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAsBxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA8B9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAQ5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAOjC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE;IA6CxD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU;IAarD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IAkBpE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM;IAuBtE,OAAO,CAAC,MAAM,CAAC,eAAe;IAU9B;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,GAAE,MAAM,GAAG,MAAM,GAAG,MAAe,GAAG,SAAS,EAAE;IAe9F;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAK3E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE;CAsB7E"}

package/lib/typescript/RouteTracker.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ *
+ * IMPORTANT: This component MUST be placed inside your navigation tree
+ * (as a child of Stack, Tabs, or Slot) for route tracking to work.
+ *
+ * @example
+ * ```tsx
+ * // In your _layout.tsx
+ * import { RouteTracker } from '@buoy-gg/route-events';
+ *
+ * export default function RootLayout() {
+ *   return (
+ *     <>
+ *       <Stack>
+ *         <Stack.Screen name="(tabs)" />
+ *       </Stack>
+ *       <RouteTracker />
+ *       <FloatingDevTools ... />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export declare function RouteTracker(): null;
+//# sourceMappingURL=RouteTracker.d.ts.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * NavigationStack - Visual representation of current navigation stack
+ *
+ * Shows all screens currently mounted in memory, which one is visible,
+ * and provides controls to manipulate the stack.
+ */
+export interface NavigationStackProps {
+    style?: any;
+}
+export declare function NavigationStack({ style }: NavigationStackProps): import("react").JSX.Element;
+//# sourceMappingURL=NavigationStack.d.ts.map

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

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

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

@@ -0,0 +1,21 @@
+import type { RouteChangeEvent } from "../RouteObserver";
+interface RouteConversation {
+    pathname: string;
+    lastEvent: RouteChangeEvent;
+    events: RouteChangeEvent[];
+    totalNavigations: number;
+}
+interface RouteEventDetailContentProps {
+    conversation: RouteConversation;
+    selectedEventIndex?: number;
+    onEventIndexChange?: (index: number) => void;
+    disableInternalFooter?: boolean;
+}
+export declare function RouteEventDetailContent({ conversation, selectedEventIndex, onEventIndexChange, disableInternalFooter, }: RouteEventDetailContentProps): import("react").JSX.Element;
+export declare function RouteEventDetailFooter({ conversation, selectedEventIndex, onEventIndexChange, }: {
+    conversation: RouteConversation;
+    selectedEventIndex?: number;
+    onEventIndexChange?: (index: number) => void;
+}): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=RouteEventDetailContent.d.ts.map