@idealyst/navigation 1.2.72 → 1.2.73

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/navigation",
-  "version": "1.2.72",
+  "version": "1.2.73",
   "description": "Cross-platform navigation library for React and React Native",
   "readme": "README.md",
   "main": "src/index.ts",
@@ -45,9 +45,9 @@
   },
   "peerDependencies": {
     "@idealyst/camera": "^1.2.30",
-    "@idealyst/components": "^1.2.72",
+    "@idealyst/components": "^1.2.73",
     "@idealyst/microphone": "^1.2.30",
-    "@idealyst/theme": "^1.2.72",
+    "@idealyst/theme": "^1.2.73",
     "@react-navigation/bottom-tabs": ">=7.0.0",
     "@react-navigation/drawer": ">=7.0.0",
     "@react-navigation/native": ">=7.0.0",
@@ -75,13 +75,13 @@
     "@idealyst/audio-playback": "^1.2.46",
     "@idealyst/blur": "^1.2.40",
     "@idealyst/camera": "^1.2.30",
-    "@idealyst/components": "^1.2.72",
+    "@idealyst/components": "^1.2.73",
     "@idealyst/datagrid": "^1.2.30",
     "@idealyst/datepicker": "^1.2.30",
     "@idealyst/lottie": "^1.2.38",
-    "@idealyst/markdown": "^1.2.72",
+    "@idealyst/markdown": "^1.2.73",
     "@idealyst/microphone": "^1.2.30",
-    "@idealyst/theme": "^1.2.72",
+    "@idealyst/theme": "^1.2.73",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "react": "^19.1.0",

package/src/context/NavigatorContext.native.tsx

@@ -204,7 +204,7 @@ const parseParameterizedPath = (path: string, rootRoute: any): { routeName: stri
     return null;
 };
 
-const UnwrappedNavigatorProvider = ({ route }: NavigatorProviderProps) => {
+const UnwrappedNavigatorProvider = ({ route, floatingComponent }: NavigatorProviderProps) => {
 
     const navigation = useNavigation();
 
@@ -331,18 +331,19 @@ const UnwrappedNavigatorProvider = ({ route }: NavigatorProviderProps) => {
             goBack,
         }}>
             <RouteComponent />
+            {floatingComponent}
         </NavigatorContext.Provider>
     )
 };
 
-const NavigatorProvider = ({ route }: NavigatorProviderProps) => {
+const NavigatorProvider = ({ route, floatingComponent }: NavigatorProviderProps) => {
     const {rt} = useUnistyles()
 
     const isDarkMode = rt.themeName === 'dark';
 
     return (
         <NavigationContainer theme={isDarkMode ? DarkTheme : DefaultTheme}>
-            <UnwrappedNavigatorProvider route={route} />
+            <UnwrappedNavigatorProvider route={route} floatingComponent={floatingComponent} />
         </NavigationContainer>
     )
 };

package/src/context/NavigatorContext.web.tsx

@@ -223,6 +223,7 @@ function getParentPath(path: string): string | null {
 
 export const NavigatorProvider = ({
     route,
+    floatingComponent,
 }: NavigatorProviderProps) => {
     const reactRouterNavigate = useNavigate();
     const location = useLocation();
@@ -319,6 +320,7 @@ export const NavigatorProvider = ({
             goBack,
         }}>
             <RouteComponent />
+            {floatingComponent}
         </NavigatorContext.Provider>
     );
 };

package/src/context/types.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { NavigatorParam } from "../routing";
 
 /**
@@ -25,6 +26,13 @@ export type NavigateParams = {
 
 export type NavigatorProviderProps = {
     route: NavigatorParam;
+    /**
+     * Optional component to render alongside the route hierarchy.
+     * This component has access to the NavigatorContext (useNavigator hook)
+     * but is not tied to any specific screen.
+     * Useful for global floating UI like FABs, toasts, or audio players.
+     */
+    floatingComponent?: React.ReactNode;
     _overrideNavigation?: any; // Used in the drawer navigator which has to provide its own navigation object
 };