@buoy-gg/route-events 7.0.41 → 7.0.43

package/lib/module/expoRouterStore.js

@@ -1,114 +1 @@
-"use strict";
-
-let cachedStore = null;
-let cachedStoreSource = null;
-let importError = null;
-let hasLoggedMissingStore = false;
-let hasLoggedMissingRouteNode = false;
-let lastRouteNodeTimestamp = null;
-function logOnce(message, error) {
-  if (__DEV__) {
-    if (error) {
-      console.error(`[RouteEvents] ${message}`, error);
-    } else {
-      console.warn(`[RouteEvents] ${message}`);
-    }
-  }
-}
-
-/**
- * Attempt to require the expo-router store from known locations.
- * Returns null (with a logged error in dev) when expo-router is not available.
- *
- * Note: The store uses getters that read from an internal storeRef.
- * The storeRef gets populated when Expo Router's useStore() hook runs.
- * So we cache the store reference but its property values update over time.
- */
-/**
- * Whether the expo-router store can be loaded in this runtime. The store is
- * pulled in via CommonJS `require`, which only exists under Metro/Node. On the
- * web (e.g. the desktop dashboard rendering these RN tools via react-native-web)
- * `require` is undefined, the route tree lives on the device — not here — and
- * there is nothing to load. Callers use this to skip polling/logging.
- */
-export function isExpoRouterStoreSupported() {
-  return typeof require !== "undefined";
-}
-export function getExpoRouterStore() {
-  if (cachedStore) {
-    return cachedStore;
-  }
-
-  // No `require` (web): bail quietly rather than throwing ReferenceError and
-  // logging a misleading "install expo-router" message on the dashboard.
-  if (!isExpoRouterStoreSupported()) {
-    return null;
-  }
-  const loadFromBuild = () => {
-    try {
-      const module = require("expo-router/build/global-state/router-store");
-      if (module?.store) {
-        cachedStore = module.store;
-        cachedStoreSource = "build";
-        importError = null;
-        hasLoggedMissingStore = false;
-        return true;
-      }
-    } catch (error) {
-      importError = error;
-    }
-    return false;
-  };
-  const loadFromSrc = () => {
-    try {
-      const module = require("expo-router/src/global-state/router-store");
-      if (module?.store) {
-        cachedStore = module.store;
-        cachedStoreSource = "src";
-        importError = null;
-        hasLoggedMissingStore = false;
-        return true;
-      }
-    } catch (error) {
-      importError = error;
-    }
-    return false;
-  };
-  if (loadFromBuild() || loadFromSrc()) {
-    return cachedStore;
-  }
-  if (!hasLoggedMissingStore) {
-    logOnce("Unable to load expo-router internals. @buoy-gg/route-events requires expo-router >= 2.0.0. Install expo-router and ensure it is configured before using the Routes tab.", importError ?? undefined);
-    hasLoggedMissingStore = true;
-  }
-  return null;
-}
-
-/**
- * Returns the current RouteNode tree (if available).
- * Logs a helpful warning in development when the tree is missing even though
- * the navigation ref is ready.
- */
-export function loadRouteNode() {
-  const store = getExpoRouterStore();
-  if (!store) {
-    return null;
-  }
-  if (store.routeNode) {
-    hasLoggedMissingRouteNode = false;
-    lastRouteNodeTimestamp = Date.now();
-    return store.routeNode;
-  }
-  const isReady = store.navigationRef?.isReady?.();
-  if (__DEV__ && !hasLoggedMissingRouteNode && isReady) {
-    logOnce("Expo Router route tree is unavailable. Ensure your app directory is configured and that expo-router is initialized before opening the Route Events devtool.");
-    hasLoggedMissingRouteNode = true;
-  }
-  return null;
-}
-export function getRouteNodeMetadata() {
-  return {
-    source: cachedStoreSource,
-    lastLoadedAt: lastRouteNodeTimestamp
-  };
-}
+"use strict";let o=null;let l=null;let u=null;let n=false;let s=false;let i=null;function a(e,r){if(__DEV__){if(r){console.error(`[RouteEvents] ${e}`,r)}else{console.warn(`[RouteEvents] ${e}`)}}}export function isExpoRouterStoreSupported(){return typeof require!=="undefined"}export function getExpoRouterStore(){if(o){return o}if(!isExpoRouterStoreSupported()){return null}const e=()=>{try{const t=require("expo-router/build/global-state/router-store");if(t?.store){o=t.store;l="build";u=null;n=false;return true}}catch(t){u=t}return false};const r=()=>{try{const t=require("expo-router/src/global-state/router-store");if(t?.store){o=t.store;l="src";u=null;n=false;return true}}catch(t){u=t}return false};if(e()||r()){return o}if(!n){a("Unable to load expo-router internals. @buoy-gg/route-events requires expo-router >= 2.0.0. Install expo-router and ensure it is configured before using the Routes tab.",u??void 0);n=true}return null}export function loadRouteNode(){const e=getExpoRouterStore();if(!e){return null}if(e.routeNode){s=false;i=Date.now();return e.routeNode}const r=e.navigationRef?.isReady?.();if(__DEV__&&!s&&r){a("Expo Router route tree is unavailable. Ensure your app directory is configured and that expo-router is initialized before opening the Route Events devtool.");s=true}return null}export function getRouteNodeMetadata(){return{source:l,lastLoadedAt:i}}

package/lib/module/expoRouterStore.web.js

@@ -1,37 +1 @@
-"use strict";
-
-import { getBrowserHref } from '@buoy-gg/shared-ui/utils';
-import { getBrowserRoutePaths, getBrowserRoutesUpdatedAt } from './browserRouteRegistry';
-export function isExpoRouterStoreSupported() {
-  return typeof window !== 'undefined';
-}
-export function loadRouteNode() {
-  if (!isExpoRouterStoreSupported()) return null;
-  const paths = new Set([...getBrowserRoutePaths(), new URL(getBrowserHref()).pathname]);
-  return {
-    route: '',
-    type: 'layout',
-    contextKey: 'browser',
-    children: [...paths].map(path => ({
-      route: path.replace(/^\//, '') || 'index',
-      type: 'route',
-      contextKey: path,
-      children: [],
-      dynamic: null
-    }))
-  };
-}
-export function getExpoRouterStore() {
-  return {
-    routeNode: loadRouteNode(),
-    navigationRef: {
-      isReady: () => typeof window !== 'undefined'
-    }
-  };
-}
-export function getRouteNodeMetadata() {
-  return {
-    source: null,
-    lastLoadedAt: getBrowserRoutesUpdatedAt()
-  };
-}
+"use strict";import{getBrowserHref as o}from"@buoy-gg/shared-ui/utils";import{getBrowserRoutePaths as r,getBrowserRoutesUpdatedAt as n}from"./browserRouteRegistry";export function isExpoRouterStoreSupported(){return typeof window!=="undefined"}export function loadRouteNode(){if(!isExpoRouterStoreSupported())return null;const t=new Set([...r(),new URL(o()).pathname]);return{route:"",type:"layout",contextKey:"browser",children:[...t].map(e=>({route:e.replace(/^\//,"")||"index",type:"route",contextKey:e,children:[],dynamic:null}))}}export function getExpoRouterStore(){return{routeNode:loadRouteNode(),navigationRef:{isReady:()=>typeof window!=="undefined"}}}export function getRouteNodeMetadata(){return{source:null,lastLoadedAt:n()}}

package/lib/module/hooks/useRouteEvents.js

@@ -1,54 +1 @@
-"use strict";
-
-/**
- * useRouteEvents Hook
- *
- * React hook for subscribing to route events from the centralized store.
- * Uses self-managing Subscribable pattern - the store automatically
- * subscribes to routeObserver when this hook mounts and unsubscribes
- * when all subscribers unmount.
- *
- * @example
- * ```typescript
- * function MyComponent() {
- *   const { events, clearEvents, isListening } = useRouteEvents();
- *
- *   return (
- *     <View>
- *       {events.map((event) => (
- *         <Text key={event.timestamp.toString()}>
- *           {event.pathname}
- *         </Text>
- *       ))}
- *     </View>
- *   );
- * }
- * ```
- */
-
-import { useEventStoreEvents } from "@buoy-gg/shared-ui";
-import { routeEventStore } from "../stores/routeEventStore";
-
-// Re-export RouteChangeEvent for convenience
-
-export function useRouteEvents(options = {}) {
-  const {
-    maxEvents = 500,
-    enabled = true
-  } = options;
-  // Subscribing auto-starts the route observer (Subscribable pattern), and
-  // the shared hook frame-coalesces navigation bursts into one commit.
-  const {
-    events,
-    clearEvents,
-    isActive
-  } = useEventStoreEvents(routeEventStore, {
-    maxEvents,
-    enabled
-  });
-  return {
-    events,
-    clearEvents,
-    isListening: isActive
-  };
-}
+"use strict";import{useEventStoreEvents as i}from"@buoy-gg/shared-ui";import{routeEventStore as u}from"../stores/routeEventStore";export function useRouteEvents(e={}){const{maxEvents:t=500,enabled:n=true}=e;const{events:s,clearEvents:r,isActive:o}=i(u,{maxEvents:t,enabled:n});return{events:s,clearEvents:r,isListening:o}}

package/lib/module/index.js

@@ -1,70 +1 @@
-"use strict";
-
-/**
- * @buoy-gg/route-events
- *
- * Route tracking and navigation DevTools for React Native.
- * Supports React Navigation and Expo Router.
- *
- * PUBLIC API - Only these exports are supported for external use.
- */
-
-// =============================================================================
-// PRESET (Primary entry point for users)
-// =============================================================================
-export { routeEventsToolPreset, createRouteEventsTool } from "./preset";
-
-// =============================================================================
-// MAIN COMPONENT
-// =============================================================================
-// `RoutesToolView` is the same tool rendered inline (header bar + body + footer)
-// instead of inside a JsModal — for hosts that show tools in a panel.
-export { RouteEventsModalWithTabs, RoutesToolView } from "./components/RouteEventsModalWithTabs";
-// =============================================================================
-// ROUTE TRACKER (Required - place inside your navigation tree)
-// =============================================================================
-export { RouteTracker } from "./RouteTracker";
-export { registerBrowserRoutes } from "./browserRouteRegistry";
-
-// =============================================================================
-// COMPONENTS (For custom UI implementations)
-// =============================================================================
-export { RoutesSitemap } from "./components/RoutesSitemap";
-export { NavigationStack } from "./components/NavigationStack";
-export { RouteEventItemCompact } from "./components/RouteEventItemCompact";
-export { RouteEventExpandedContent } from "./components/RouteEventExpandedContent";
-export { RouteEventDetail } from "./components/RouteEventDetail";
-// =============================================================================
-// HOOKS (For consuming route data)
-// =============================================================================
-export { useRouteObserver } from "./useRouteObserver";
-export { useRouteObserverReactNavigation } from "./useRouteObserverReactNavigation";
-export { useRouteEvents } from "./hooks/useRouteEvents";
-export { useRouteSitemap, useRoute, useParentRoutes } from "./useRouteSitemap";
-export { useNavigationStack } from "./useNavigationStack";
-// =============================================================================
-// EXTERNAL SYNC (Adapter for @buoy-gg/external-sync's useExternalSync)
-// =============================================================================
-export { routeEventsSyncAdapter } from "./sync/routeEventsSyncAdapter";
-
-// =============================================================================
-// TYPES
-// =============================================================================
-
-// =============================================================================
-// UTILITIES (For advanced use cases)
-// =============================================================================
-export { RouteParser } from "./RouteParser";
-export { RouteObserver } from "./RouteObserver";
-
-// =============================================================================
-// INTERNAL EXPORTS (For @buoy-gg/* packages only - not part of public API)
-// =============================================================================
-/** @internal - Singleton instance for cross-package communication */
-export { routeObserver } from "./RouteObserver";
-/** @internal - Event store for centralized route event management */
-export { routeEventStore } from "./stores/routeEventStore";
-/** @internal - Navigation-stack store: web/alt-framework hosts without
- * <RouteTracker /> feed it via setStack/setActions so the sync adapter's
- * stack snapshot + remote stack actions work. */
-export { navigationStackStore } from "./stores/navigationStackStore";
+"use strict";export{routeEventsToolPreset,createRouteEventsTool}from"./preset";export{RouteEventsModalWithTabs,RoutesToolView}from"./components/RouteEventsModalWithTabs";export{RouteTracker}from"./RouteTracker";export{registerBrowserRoutes}from"./browserRouteRegistry";export{RoutesSitemap}from"./components/RoutesSitemap";export{NavigationStack}from"./components/NavigationStack";export{RouteEventItemCompact}from"./components/RouteEventItemCompact";export{RouteEventExpandedContent}from"./components/RouteEventExpandedContent";export{RouteEventDetail}from"./components/RouteEventDetail";export{useRouteObserver}from"./useRouteObserver";export{useRouteObserverReactNavigation}from"./useRouteObserverReactNavigation";export{useRouteEvents}from"./hooks/useRouteEvents";export{useRouteSitemap,useRoute,useParentRoutes}from"./useRouteSitemap";export{useNavigationStack}from"./useNavigationStack";export{routeEventsSyncAdapter}from"./sync/routeEventsSyncAdapter";export{RouteParser}from"./RouteParser";export{RouteObserver}from"./RouteObserver";export{routeObserver}from"./RouteObserver";export{routeEventStore}from"./stores/routeEventStore";export{navigationStackStore}from"./stores/navigationStackStore";

package/lib/module/preset.js

@@ -1,66 +1 @@
-"use strict";
-
-/**
- * Pre-configured route events tool for FloatingDevTools
- *
- * This preset provides a zero-config way to add route tracking to your dev tools.
- * Just import and spread it into your apps array!
- *
- * @example
- * ```tsx
- * import { routeEventsToolPreset } from '@buoy-gg/route-events';
- *
- * const installedApps = [
- *   routeEventsToolPreset, // That's it!
- *   // ...other tools
- * ];
- * ```
- */
-
-import { RoutesIcon } from "@buoy-gg/floating-tools-core";
-import { RouteEventsModalWithTabs } from "./components/RouteEventsModalWithTabs";
-import { createToolFactory, defineToolPreset } from "@buoy-gg/shared-ui";
-
-/**
- * Pre-configured route events tool for FloatingDevTools.
- * Includes:
- * - Route sitemap browser
- * - Event timeline with filtering
- * - Navigation stack visualization
- * - Automatic route tracking (no setup needed)
- */
-import { jsx as _jsx } from "react/jsx-runtime";
-export const routeEventsToolPreset = defineToolPreset({
-  id: "route-events",
-  name: "ROUTES",
-  description: "Route tracking & navigation inspector",
-  slot: "both",
-  icon: ({
-    size
-  }) => /*#__PURE__*/_jsx(RoutesIcon, {
-    size: size
-  }),
-  component: RouteEventsModalWithTabs,
-  props: {
-    enableSharedModalDimensions: false
-  }
-});
-
-/**
- * Create a custom route events tool configuration.
- * Use this if you want to override default settings.
- *
- * @example
- * ```tsx
- * import { createRouteEventsTool } from '@buoy-gg/route-events';
- *
- * const myRouteTool = createRouteEventsTool({
- *   name: "MY ROUTES",
- *   color: "#a78bfa",
- *   enableSharedModalDimensions: true,
- * });
- * ```
- */
-export const createRouteEventsTool = createToolFactory(routeEventsToolPreset, options => ({
-  enableSharedModalDimensions: options.enableSharedModalDimensions ?? false
-}));
+"use strict";import{RoutesIcon as e}from"@buoy-gg/floating-tools-core";import{RouteEventsModalWithTabs as t}from"./components/RouteEventsModalWithTabs";import{createToolFactory as s,defineToolPreset as n}from"@buoy-gg/shared-ui";import{jsx as r}from"react/jsx-runtime";export const routeEventsToolPreset=n({id:"route-events",name:"ROUTES",description:"Route tracking & navigation inspector",slot:"both",icon:({size:o})=>r(e,{size:o}),component:t,props:{enableSharedModalDimensions:false}});export const createRouteEventsTool=s(routeEventsToolPreset,o=>({enableSharedModalDimensions:o.enableSharedModalDimensions??false}));

package/lib/module/stores/navigationStackStore.js

@@ -1,41 +1 @@
-"use strict";
-
-/**
- * Navigation Stack Store
- *
- * Holds the latest serializable navigation stack plus references to the live
- * navigation action functions. The stack is captured inside the navigation tree
- * by <RouteTracker /> (which runs useNavigationStack), and read by the
- * route-events sync adapter so the dashboard can render the Stack tab and drive
- * navigation on the device remotely.
- *
- * The stack itself (StackDisplayItem[]) is JSON-serializable and synced to the
- * dashboard. The action functions are NOT serialized — they stay on the device
- * and are invoked when the dashboard sends a remote action.
- */
-
-class NavigationStackStore {
-  stack = [];
-  actions = null;
-  listeners = new Set();
-  getStack() {
-    return this.stack;
-  }
-  setStack(stack) {
-    this.stack = stack;
-    this.listeners.forEach(listener => listener());
-  }
-  getActions() {
-    return this.actions;
-  }
-  setActions(actions) {
-    this.actions = actions;
-  }
-  subscribe(listener) {
-    this.listeners.add(listener);
-    return () => {
-      this.listeners.delete(listener);
-    };
-  }
-}
-export const navigationStackStore = new NavigationStackStore();
+"use strict";class e{stack=[];actions=null;listeners=new Set;getStack(){return this.stack}setStack(t){this.stack=t;this.listeners.forEach(s=>s())}getActions(){return this.actions}setActions(t){this.actions=t}subscribe(t){this.listeners.add(t);return()=>{this.listeners.delete(t)}}}export const navigationStackStore=new e;

package/lib/module/stores/routeEventStore.js

@@ -1,128 +1 @@
-"use strict";
-
-/**
- * Route Event Store
- *
- * Centralized store that aggregates route change events from the RouteObserver.
- * Uses BaseEventStore pattern - the store automatically subscribes to routeObserver
- * when the first subscriber joins and unsubscribes when the last subscriber leaves.
- *
- * @example
- * ```typescript
- * import { routeEventStore } from '@buoy-gg/route-events';
- *
- * // Subscribe to route events - automatically starts listening!
- * const unsubscribe = routeEventStore.subscribeToEvents((events) => {
- *   console.log('Route events:', events);
- * });
- *
- * // Later, clean up - automatically stops if no other subscribers
- * unsubscribe();
- * ```
- */
-
-import { BaseEventStore, devToolsStorageKeys, persistentStorage } from "@buoy-gg/shared-ui";
-import { routeObserver } from "../RouteObserver";
-
-// Re-export types for convenience
-
-/**
- * Listener callback type for route events array
- */
-
-/**
- * Listener callback for individual new events
- */
-
-class RouteEventStore extends BaseEventStore {
-  // Unsubscribe function for routeObserver
-  routeObserverUnsubscribe = null;
-  // The store's own subscription — see setBootCapture.
-  bootCaptureRelease = null;
-  bootCaptureHydrated = false;
-
-  /**
-   * Capture from app launch, not from the first open of the tool.
-   *
-   * A BaseEventStore only listens while something subscribes to it, and for
-   * routes that was the open modal or a watching desktop — so every
-   * navigation before the tool was first opened was simply never recorded,
-   * and the Events tab opened on "No route events yet" after a session of
-   * navigating. (It looked fine on any machine with Buoy Desktop running,
-   * because the desktop's watch subscribed at boot.) Network and storage both
-   * capture from launch; this holds a subscription of the store's own so
-   * routes does too.
-   *
-   * The hold follows the tool's persisted monitoring switch: the modal calls
-   * this on every toggle, and `hydrateBootCapture` reads the persisted value
-   * at boot so a paused tool stays paused across a relaunch.
-   */
-  setBootCapture(enabled) {
-    if (enabled && !this.bootCaptureRelease) {
-      this.bootCaptureRelease = this.subscribeToEvents(() => {});
-    } else if (!enabled && this.bootCaptureRelease) {
-      this.bootCaptureRelease();
-      this.bootCaptureRelease = null;
-    }
-  }
-
-  /** Arm boot capture from the persisted monitoring switch (default on). */
-  hydrateBootCapture() {
-    if (this.bootCaptureHydrated) return;
-    this.bootCaptureHydrated = true;
-    void persistentStorage.getItem(devToolsStorageKeys.routeEvents.isMonitoring()).then(raw => {
-      // The modal may already have decided while the read was in flight.
-      if (this.bootCaptureRelease) return;
-      this.setBootCapture(raw !== "false");
-    }).catch(() => this.setBootCapture(true));
-  }
-  constructor() {
-    super({
-      storeName: "route-events",
-      maxEvents: 500
-    });
-  }
-
-  /**
-   * Start listening to route changes from routeObserver
-   */
-  startCapturing() {
-    if (!this.routeObserverUnsubscribe) {
-      this.routeObserverUnsubscribe = routeObserver.addListener(event => {
-        this.addEvent(event);
-      });
-    }
-  }
-
-  /**
-   * Stop listening to route changes
-   */
-  stopCapturing() {
-    if (this.routeObserverUnsubscribe) {
-      this.routeObserverUnsubscribe();
-      this.routeObserverUnsubscribe = null;
-    }
-  }
-
-  /**
-   * Check if currently listening (has subscribers)
-   */
-  isCapturing() {
-    return this.routeObserverUnsubscribe !== null;
-  }
-
-  // Alias for backwards compatibility
-  isListening() {
-    return this.isCapturing();
-  }
-}
-
-// Singleton instance
-export const routeEventStore = new RouteEventStore();
-
-// Convenience exports
-export const subscribeToRouteEvents = listener => routeEventStore.subscribeToEvents(listener);
-export const onRouteEvent = callback => routeEventStore.onEvent(callback);
-export const getRouteEvents = () => routeEventStore.getEvents();
-export const clearRouteEvents = () => routeEventStore.clearEvents();
-export const isRouteListening = () => routeEventStore.isListening();
+"use strict";import{BaseEventStore as s,devToolsStorageKeys as r,persistentStorage as o}from"@buoy-gg/shared-ui";import{routeObserver as i}from"../RouteObserver";class u extends s{routeObserverUnsubscribe=null;bootCaptureRelease=null;bootCaptureHydrated=false;setBootCapture(e){if(e&&!this.bootCaptureRelease){this.bootCaptureRelease=this.subscribeToEvents(()=>{})}else if(!e&&this.bootCaptureRelease){this.bootCaptureRelease();this.bootCaptureRelease=null}}hydrateBootCapture(){if(this.bootCaptureHydrated)return;this.bootCaptureHydrated=true;void o.getItem(r.routeEvents.isMonitoring()).then(e=>{if(this.bootCaptureRelease)return;this.setBootCapture(e!=="false")}).catch(()=>this.setBootCapture(true))}constructor(){super({storeName:"route-events",maxEvents:500})}startCapturing(){if(!this.routeObserverUnsubscribe){this.routeObserverUnsubscribe=i.addListener(e=>{this.addEvent(e)})}}stopCapturing(){if(this.routeObserverUnsubscribe){this.routeObserverUnsubscribe();this.routeObserverUnsubscribe=null}}isCapturing(){return this.routeObserverUnsubscribe!==null}isListening(){return this.isCapturing()}}export const routeEventStore=new u;export const subscribeToRouteEvents=t=>routeEventStore.subscribeToEvents(t);export const onRouteEvent=t=>routeEventStore.onEvent(t);export const getRouteEvents=()=>routeEventStore.getEvents();export const clearRouteEvents=()=>routeEventStore.clearEvents();export const isRouteListening=()=>routeEventStore.isListening();