@buoy-gg/route-events 7.0.26 → 7.0.28

package/lib/commonjs/components/RoutesSitemap.js

@@ -57,7 +57,7 @@ function RoutesSitemap({
 }) {
   const [searchQuery, setSearchQuery] = (0, _react.useState)("");
   const [isSearching, setIsSearching] = (0, _react.useState)(false);
-  const [expandedGroups, setExpandedGroups] = (0, _react.useState)(new Set(["Root Routes", "Dynamic Routes"]));
+  const [expandedGroups, setExpandedGroups] = (0, _react.useState)(new Set(["Static Routes", "Dynamic Routes"]));
   const [isRefreshing, setIsRefreshing] = (0, _react.useState)(false);
   const [showUpgradeModal, setShowUpgradeModal] = (0, _react.useState)(false);
 
@@ -263,96 +263,15 @@ function RoutesSitemap({
   }
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     style: [styles.container, style],
-    children: [!isSearching ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-      style: styles.header,
-      children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-        style: styles.actionsRow,
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-          style: [styles.actionWrapper, IS_DESKTOP && styles.actionWrapperDesktop],
-          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
-            style: [styles.iconButton, IS_DESKTOP && styles.iconButtonDesktop],
-            onPress: handleGoHome,
-            accessibilityLabel: "Go to home route",
-            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Home, {
-              size: ACTION_ICON_SIZE,
-              color: _sharedUi.buoyColors.textSecondary
-            })
-          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
-            style: [styles.actionLabel, IS_DESKTOP && styles.actionLabelDesktop],
-            children: "Home"
-          })]
-        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-          style: [styles.actionWrapper, IS_DESKTOP && styles.actionWrapperDesktop],
-          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.CopyButton, {
-            value: copyAllData,
-            size: IS_DESKTOP ? ACTION_ICON_SIZE : 14,
-            buttonStyle: IS_DESKTOP ? styles.actionButtonHeaderDesktop : styles.actionButtonHeader
-          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
-            style: [styles.actionLabel, IS_DESKTOP && styles.actionLabelDesktop],
-            children: "Copy"
-          })]
-        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-          style: [styles.actionWrapper, IS_DESKTOP && styles.actionWrapperDesktop],
-          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
-            style: [styles.iconButton, IS_DESKTOP && styles.iconButtonDesktop, isRefreshing && styles.refreshButtonDisabled],
-            onPress: handleManualRefresh,
-            disabled: isRefreshing,
-            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.RefreshCw, {
-              size: ACTION_ICON_SIZE,
-              color: isRefreshing ? _sharedUi.buoyColors.textMuted : _sharedUi.buoyColors.textSecondary
-            })
-          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
-            style: [styles.actionLabel, IS_DESKTOP && styles.actionLabelDesktop],
-            children: "Refresh"
-          })]
-        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-          style: [styles.actionWrapper, IS_DESKTOP && styles.actionWrapperDesktop],
-          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
-            style: [styles.iconButton, IS_DESKTOP && styles.iconButtonDesktop],
-            onPress: () => setIsSearching(true),
-            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Search, {
-              size: ACTION_ICON_SIZE,
-              color: _sharedUi.buoyColors.textSecondary
-            })
-          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
-            style: [styles.actionLabel, IS_DESKTOP && styles.actionLabelDesktop],
-            children: "Search"
-          })]
-        })]
-      }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-        style: styles.statsGrid,
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
-          value: stats.total,
-          label: "Total"
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
-          value: stats.static,
-          label: "Static"
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
-          value: stats.dynamic,
-          label: "Dynamic"
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
-          value: stats.catchAll,
-          label: "Catch-All"
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
-          value: stats.layouts,
-          label: "Layouts"
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
-          value: stats.groups,
-          label: "Groups"
-        })]
-      })]
-    }) :
-    /*#__PURE__*/
-    /* Search mode - full width search bar */
-    (0, _jsxRuntime.jsxs)(_reactNative.View, {
+    children: [isSearching && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
       style: styles.searchContainer,
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Search, {
         size: 16,
-        color: _sharedUi.buoyColors.textMuted
+        color: _sharedUi.night.color.textTertiary
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TextInput, {
         style: styles.searchInput,
         placeholder: "Search routes...",
-        placeholderTextColor: _sharedUi.buoyColors.textMuted,
+        placeholderTextColor: _sharedUi.night.color.placeholder,
         value: searchQuery,
         onChangeText: setSearchQuery,
         autoCapitalize: "none",
@@ -379,7 +298,85 @@ function RoutesSitemap({
     }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.ScrollView, {
       style: styles.scrollView,
       contentContainerStyle: styles.scrollContent,
-      children: [displayGroups.length === 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      children: [!isSearching && /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+        style: styles.header,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+          style: styles.actionsRow,
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+            style: [styles.actionWrapper, IS_DESKTOP && styles.actionWrapperDesktop],
+            children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+              style: [styles.iconButton, IS_DESKTOP && styles.iconButtonDesktop],
+              onPress: handleGoHome,
+              accessibilityLabel: "Go to home route",
+              children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Home, {
+                size: ACTION_ICON_SIZE,
+                color: _sharedUi.night.color.textSecondary
+              })
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+              style: [styles.actionLabel, IS_DESKTOP && styles.actionLabelDesktop],
+              children: "Home"
+            })]
+          }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+            style: [styles.actionWrapper, IS_DESKTOP && styles.actionWrapperDesktop],
+            children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.CopyButton, {
+              value: copyAllData,
+              size: IS_DESKTOP ? ACTION_ICON_SIZE : 14,
+              buttonStyle: IS_DESKTOP ? styles.actionButtonHeaderDesktop : styles.actionButtonHeader
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+              style: [styles.actionLabel, IS_DESKTOP && styles.actionLabelDesktop],
+              children: "Copy"
+            })]
+          }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+            style: [styles.actionWrapper, IS_DESKTOP && styles.actionWrapperDesktop],
+            children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+              style: [styles.iconButton, IS_DESKTOP && styles.iconButtonDesktop, isRefreshing && styles.refreshButtonDisabled],
+              onPress: handleManualRefresh,
+              disabled: isRefreshing,
+              children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.RefreshCw, {
+                size: ACTION_ICON_SIZE,
+                color: isRefreshing ? _sharedUi.night.color.textTertiary : _sharedUi.night.color.textSecondary
+              })
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+              style: [styles.actionLabel, IS_DESKTOP && styles.actionLabelDesktop],
+              children: "Refresh"
+            })]
+          }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+            style: [styles.actionWrapper, IS_DESKTOP && styles.actionWrapperDesktop],
+            children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
+              style: [styles.iconButton, IS_DESKTOP && styles.iconButtonDesktop],
+              onPress: () => setIsSearching(true),
+              children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Search, {
+                size: ACTION_ICON_SIZE,
+                color: _sharedUi.night.color.textSecondary
+              })
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+              style: [styles.actionLabel, IS_DESKTOP && styles.actionLabelDesktop],
+              children: "Search"
+            })]
+          })]
+        }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+          style: styles.statsGrid,
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
+            value: stats.total,
+            label: "Total"
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
+            value: stats.static,
+            label: "Static"
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
+            value: stats.dynamic,
+            label: "Dynamic"
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
+            value: stats.catchAll,
+            label: "Catch-All"
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
+            value: stats.layouts,
+            label: "Layouts"
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(StatItem, {
+            value: stats.groups,
+            label: "Groups"
+          })]
+        })]
+      }), displayGroups.length === 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
         style: styles.emptyState,
         children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
           style: styles.emptyText,
@@ -446,10 +443,10 @@ function RouteGroupView({
         style: styles.groupHeaderLeft,
         children: [isExpanded ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.ChevronDown, {
           size: 14,
-          color: _sharedUi.buoyColors.textSecondary
+          color: _sharedUi.night.color.textSecondary
         }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.ChevronRight, {
           size: 14,
-          color: _sharedUi.buoyColors.textSecondary
+          color: _sharedUi.night.color.textSecondary
         }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
           style: styles.groupTitle,
           children: group.title
@@ -506,10 +503,10 @@ function RouteItemView({
             style: styles.expandIndicator,
             children: isExpanded ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.ChevronDown, {
               size: 14,
-              color: _sharedUi.buoyColors.textSecondary
+              color: _sharedUi.night.color.textSecondary
             }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.ChevronRight, {
               size: 14,
-              color: _sharedUi.buoyColors.textSecondary
+              color: _sharedUi.night.color.textSecondary
             })
           }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
             style: styles.routePath,
@@ -613,7 +610,8 @@ function getRouteTypeColor(type) {
 const styles = _reactNative.StyleSheet.create({
   container: {
     flex: 1,
-    backgroundColor: _sharedUi.buoyColors.base
+    // Transparent so JsModal's ToolBackground shows through (the modal paints opaque base beneath it).
+    backgroundColor: "transparent"
   },
   loadingContainer: {
     flex: 1,
@@ -621,7 +619,7 @@ const styles = _reactNative.StyleSheet.create({
     alignItems: "center"
   },
   loadingText: {
-    color: _sharedUi.buoyColors.textSecondary,
+    color: _sharedUi.night.color.textSecondary,
     fontSize: 14,
     fontFamily: "monospace",
     textAlign: "center",
@@ -633,8 +631,9 @@ const styles = _reactNative.StyleSheet.create({
     flexDirection: "column",
     padding: 8,
     borderBottomWidth: 1,
-    borderBottomColor: _sharedUi.buoyColors.border,
-    gap: 12
+    borderBottomColor: _sharedUi.night.color.border,
+    gap: 12,
+    marginBottom: 8
   },
   actionsRow: {
     flexDirection: "row",
@@ -653,7 +652,7 @@ const styles = _reactNative.StyleSheet.create({
     flexShrink: 1,
     flexBasis: "30%",
     minWidth: 90,
-    backgroundColor: _sharedUi.buoyColors.card,
+    backgroundColor: _sharedUi.night.color.surface,
     borderRadius: 8,
     paddingVertical: 10,
     paddingHorizontal: 12,
@@ -662,12 +661,12 @@ const styles = _reactNative.StyleSheet.create({
   statValue: {
     fontSize: 18,
     fontWeight: "800",
-    color: _sharedUi.buoyColors.text,
+    color: _sharedUi.night.color.text,
     fontFamily: "monospace"
   },
   statLabel: {
     fontSize: 10,
-    color: _sharedUi.buoyColors.textMuted,
+    color: _sharedUi.night.color.textTertiary,
     marginTop: 4,
     fontFamily: "monospace",
     textTransform: "uppercase",
@@ -687,12 +686,12 @@ const styles = _reactNative.StyleSheet.create({
   actionButtonHeader: {
     padding: 6,
     borderRadius: 4,
-    backgroundColor: _sharedUi.buoyColors.input
+    backgroundColor: _sharedUi.night.color.surfaceElevated
   },
   actionButtonHeaderDesktop: {
     padding: 12,
     borderRadius: 8,
-    backgroundColor: _sharedUi.buoyColors.input
+    backgroundColor: _sharedUi.night.color.surfaceElevated
   },
   iconButton: {
     padding: 6,
@@ -703,11 +702,11 @@ const styles = _reactNative.StyleSheet.create({
   iconButtonDesktop: {
     padding: 12,
     borderRadius: 8,
-    backgroundColor: _sharedUi.buoyColors.input
+    backgroundColor: _sharedUi.night.color.surfaceElevated
   },
   actionLabel: {
     fontSize: 8,
-    color: _sharedUi.buoyColors.textMuted,
+    color: _sharedUi.night.color.textTertiary,
     fontFamily: "monospace",
     textTransform: "uppercase",
     letterSpacing: 0.5
@@ -727,11 +726,11 @@ const styles = _reactNative.StyleSheet.create({
     paddingVertical: 16,
     marginTop: 16,
     borderTopWidth: 1,
-    borderTopColor: _sharedUi.buoyColors.border
+    borderTopColor: _sharedUi.night.color.border
   },
   metaText: {
     fontSize: 12,
-    color: _sharedUi.buoyColors.textSecondary,
+    color: _sharedUi.night.color.textSecondary,
     fontFamily: "monospace"
   },
   sourceBadge: {
@@ -739,12 +738,12 @@ const styles = _reactNative.StyleSheet.create({
     paddingVertical: 2,
     borderRadius: 999,
     borderWidth: 1,
-    borderColor: _sharedUi.buoyColors.border,
-    backgroundColor: _sharedUi.buoyColors.card
+    borderColor: _sharedUi.night.color.border,
+    backgroundColor: _sharedUi.night.color.surface
   },
   sourceText: {
     fontSize: 11,
-    color: _sharedUi.buoyColors.textSecondary,
+    color: _sharedUi.night.color.textSecondary,
     textTransform: "capitalize",
     fontFamily: "monospace"
   },
@@ -754,11 +753,11 @@ const styles = _reactNative.StyleSheet.create({
     padding: 8,
     gap: 8,
     borderBottomWidth: 1,
-    borderBottomColor: _sharedUi.buoyColors.border
+    borderBottomColor: _sharedUi.night.color.border
   },
   searchInput: {
     flex: 1,
-    color: _sharedUi.buoyColors.text,
+    color: _sharedUi.night.color.text,
     fontSize: 14,
     fontFamily: "monospace"
   },
@@ -766,7 +765,7 @@ const styles = _reactNative.StyleSheet.create({
     padding: 4
   },
   clearButtonText: {
-    color: _sharedUi.buoyColors.textMuted,
+    color: _sharedUi.night.color.textTertiary,
     fontSize: 18
   },
   closeSearchButton: {
@@ -774,7 +773,7 @@ const styles = _reactNative.StyleSheet.create({
     paddingVertical: 4
   },
   closeSearchText: {
-    color: _sharedUi.buoyColors.primary,
+    color: _sharedUi.night.color.accent,
     fontSize: 14,
     fontWeight: "600",
     fontFamily: "monospace"
@@ -783,14 +782,14 @@ const styles = _reactNative.StyleSheet.create({
     flex: 1
   },
   scrollContent: {
-    paddingVertical: 8
+    paddingBottom: 8
   },
   emptyState: {
     padding: 32,
     alignItems: "center"
   },
   emptyText: {
-    color: _sharedUi.buoyColors.textSecondary,
+    color: _sharedUi.night.color.textSecondary,
     fontSize: 14,
     fontFamily: "monospace"
   },
@@ -803,9 +802,9 @@ const styles = _reactNative.StyleSheet.create({
     justifyContent: "space-between",
     padding: 12,
     paddingHorizontal: 16,
-    backgroundColor: _sharedUi.buoyColors.card,
+    backgroundColor: _sharedUi.night.color.surface,
     borderLeftWidth: 3,
-    borderLeftColor: _sharedUi.buoyColors.textSecondary
+    borderLeftColor: _sharedUi.night.color.fillTertiary
   },
   groupHeaderLeft: {
     flexDirection: "row",
@@ -816,7 +815,7 @@ const styles = _reactNative.StyleSheet.create({
   groupTitle: {
     fontSize: 12,
     fontWeight: "700",
-    color: _sharedUi.buoyColors.text,
+    color: _sharedUi.night.color.text,
     fontFamily: "monospace",
     textTransform: "uppercase",
     letterSpacing: 0.8
@@ -839,19 +838,20 @@ const styles = _reactNative.StyleSheet.create({
     fontFamily: "monospace"
   },
   routesList: {
-    backgroundColor: _sharedUi.buoyColors.base
+    // Transparent so the night sheet's star field shows through.
+    backgroundColor: "transparent"
   },
   groupDescription: {
     paddingHorizontal: 16,
     paddingVertical: 8,
     marginBottom: 8,
-    backgroundColor: _sharedUi.buoyColors.input,
+    backgroundColor: _sharedUi.night.color.surfaceElevated,
     borderLeftWidth: 3,
-    borderLeftColor: _sharedUi.buoyColors.textSecondary
+    borderLeftColor: _sharedUi.night.color.fillTertiary
   },
   groupDescriptionText: {
     fontSize: 11,
-    color: _sharedUi.buoyColors.textSecondary,
+    color: _sharedUi.night.color.textSecondary,
     fontFamily: "monospace",
     lineHeight: 16
   },
@@ -859,10 +859,10 @@ const styles = _reactNative.StyleSheet.create({
     marginBottom: 6
   },
   routeCard: {
-    backgroundColor: _sharedUi.buoyColors.card,
+    backgroundColor: _sharedUi.night.color.surface,
     borderRadius: 6,
     borderWidth: 1,
-    borderColor: _sharedUi.buoyColors.border,
+    borderColor: _sharedUi.night.color.border,
     overflow: "hidden",
     shadowColor: "#000",
     shadowOffset: {
@@ -894,7 +894,7 @@ const styles = _reactNative.StyleSheet.create({
   routePath: {
     fontSize: 13,
     fontWeight: "600",
-    color: _sharedUi.buoyColors.text,
+    color: _sharedUi.night.color.text,
     fontFamily: "monospace",
     flex: 1
   },
@@ -917,7 +917,7 @@ const styles = _reactNative.StyleSheet.create({
   childCountText: {
     fontSize: 11,
     fontWeight: "600",
-    color: _sharedUi.macOSColors.text.icon,
+    color: _sharedUi.night.color.textSecondary,
     fontFamily: "monospace"
   },
   typeTag: {
@@ -936,9 +936,9 @@ const styles = _reactNative.StyleSheet.create({
     width: 28,
     height: 24,
     borderRadius: 4,
-    backgroundColor: _sharedUi.buoyColors.input,
+    backgroundColor: _sharedUi.night.color.surfaceElevated,
     borderWidth: 1,
-    borderColor: _sharedUi.buoyColors.border,
+    borderColor: _sharedUi.night.color.border,
     alignItems: "center",
     justifyContent: "center"
   },
@@ -949,19 +949,19 @@ const styles = _reactNative.StyleSheet.create({
     borderRadius: 4,
     alignItems: "center",
     justifyContent: "center",
-    backgroundColor: _sharedUi.buoyColors.primary + "15",
+    backgroundColor: _sharedUi.night.color.accentSoft,
     borderWidth: 1,
-    borderColor: _sharedUi.buoyColors.primary + "40"
+    borderColor: _sharedUi.night.color.accentBorder
   },
   goButtonText: {
     fontSize: 12,
-    color: _sharedUi.buoyColors.primary,
+    color: _sharedUi.night.color.accent,
     fontFamily: "monospace",
     fontWeight: "600"
   },
   childrenContainer: {
     borderLeftWidth: 2,
-    borderLeftColor: _sharedUi.buoyColors.border,
+    borderLeftColor: _sharedUi.night.color.border,
     marginLeft: 16,
     marginRight: 8,
     marginTop: 2,

package/lib/commonjs/sync/routeEventsSyncAdapter.js

@@ -123,7 +123,8 @@ const routeEventsSyncAdapter = exports.routeEventsSyncAdapter = {
      * dynamic params into a concrete path before invoking this.
      */
     navigate: params => {
-      const path = params?.path;
+      const p = params;
+      const path = p?.path;
       if (!path) {
         throw new Error("navigate requires a 'path' param");
       }
@@ -131,9 +132,14 @@ const routeEventsSyncAdapter = exports.routeEventsSyncAdapter = {
       if (!router) {
         throw new Error("expo-router is not available on this device");
       }
-      router.navigate(path);
+      // Push by default so navigate-then-back flows keep working. Callers that
+      // mean "leave this screen" (sitemap Go, agents resetting to home) pass
+      // replace: true — otherwise "Go to home" stacks another `/` on top.
+      const go = p?.replace === true && typeof router.replace === "function" ? router.replace : router.navigate;
+      go(path);
       return {
-        navigated: path
+        navigated: path,
+        replaced: p?.replace === true
       };
     },
     // ── Stack actions: delegate to the live navigation actions captured by

package/lib/commonjs/useNavigationStack.js

@@ -19,12 +19,11 @@ var _sharedUi = require("@buoy-gg/shared-ui");
  * - RN CLI: uses NavigationContainerRefContext (works as sibling of navigators)
  */
 
-// Resolved once at module load; null when @react-navigation/native is absent
-// (the fallback context then yields an undefined containerRef, so the
-// dispatch paths below never execute).
+// Resolved once at module load; null when React Navigation is absent
+// (useSafeNavigationContainerRef then yields undefined, so the dispatch
+// paths below never execute).
 const CommonActions = (0, _safeReactNavigation.getCommonActions)();
 const StackActions = (0, _safeReactNavigation.getStackActions)();
-const NavigationContainerRefContext = (0, _safeReactNavigation.getNavigationContainerRefContext)();
 
 // ============================================================================
 // Type Definitions
@@ -202,7 +201,7 @@ function buildStack(navigationState, isExpo) {
  */
 function useNavigationStack() {
   const isExpo = (0, _sharedUi.isExpoRouterAvailable)();
-  const containerRef = (0, _react.useContext)(NavigationContainerRefContext);
+  const containerRef = (0, _safeReactNavigation.useSafeNavigationContainerRef)();
   const [navigationState, setNavigationState] = (0, _react.useState)(() => containerRef?.getRootState?.() ?? null);
   const [isLoaded, setIsLoaded] = (0, _react.useState)(false);
   const [error, setError] = (0, _react.useState)(null);

package/lib/commonjs/useRouteObserverReactNavigation.js

@@ -18,10 +18,6 @@ var _RouteObserver = require("./RouteObserver");
  * a NavigationContainer — does NOT need to be inside a navigator.
  */
 
-// Resolved once at module load; falls back to an always-undefined context
-// when @react-navigation/native is absent, so the effect below no-ops.
-const NavigationContainerRefContext = (0, _safeReactNavigation.getNavigationContainerRefContext)();
-
 /**
  * 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.
@@ -85,7 +81,7 @@ function emitRouteEvent(state, previousPathnameRef, previousTimestampRef, callba
  * Works anywhere inside a NavigationContainer (does not need to be inside a navigator).
  */
 function useRouteObserverReactNavigation(callback) {
-  const containerRef = (0, _react.useContext)(NavigationContainerRefContext);
+  const containerRef = (0, _safeReactNavigation.useSafeNavigationContainerRef)();
   const callbackRef = (0, _react.useRef)(callback);
   const previousPathnameRef = (0, _react.useRef)(undefined);
   const previousTimestampRef = (0, _react.useRef)(undefined);

package/lib/commonjs/utils/safeReactNavigation.js

@@ -4,10 +4,10 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getCommonActions = getCommonActions;
-exports.getNavigationContainerRefContext = getNavigationContainerRefContext;
 exports.getStackActions = getStackActions;
 exports.isReactNavigationAvailable = isReactNavigationAvailable;
 exports.useSafeNavigation = useSafeNavigation;
+exports.useSafeNavigationContainerRef = useSafeNavigationContainerRef;
 exports.useSafeNavigationState = useSafeNavigationState;
 var _react = require("react");
 /**
@@ -20,6 +20,31 @@ var _react = require("react");
 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 {
@@ -29,6 +54,17 @@ function checkReactNavigationAvailability() {
     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;
 }
@@ -120,13 +156,33 @@ 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];
+}
+
 /**
- * NavigationContainerRefContext, read via @react-navigation/native's
- * re-export (never from @react-navigation/core directly — core is not a
- * declared dependency). Falls back to an always-undefined context.
+ * 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 getNavigationContainerRefContext() {
-  return checkReactNavigationAvailability() && reactNavigation.NavigationContainerRefContext ? reactNavigation.NavigationContainerRefContext : FallbackNavigationContainerRefContext;
+function useSafeNavigationContainerRef() {
+  const [npmCtx, vendoredCtx] = getContainerRefContexts();
+  const npmRef = (0, _react.useContext)(npmCtx);
+  const vendoredRef = (0, _react.useContext)(vendoredCtx);
+  return npmRef ?? vendoredRef;
 }
 
 // ============================================================================