@idealyst/navigation 1.2.19 → 1.2.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/navigation",
-  "version": "1.2.19",
+  "version": "1.2.21",
   "description": "Cross-platform navigation library for React and React Native",
   "readme": "README.md",
   "main": "src/index.ts",
@@ -44,9 +44,9 @@
   },
   "peerDependencies": {
     "@idealyst/camera": "^1.1.6",
-    "@idealyst/components": "^1.2.19",
+    "@idealyst/components": "^1.2.21",
     "@idealyst/microphone": "^1.1.7",
-    "@idealyst/theme": "^1.2.19",
+    "@idealyst/theme": "^1.2.21",
     "@react-navigation/bottom-tabs": ">=7.0.0",
     "@react-navigation/drawer": ">=7.0.0",
     "@react-navigation/native": ">=7.0.0",
@@ -71,11 +71,11 @@
   },
   "devDependencies": {
     "@idealyst/camera": "^1.1.6",
-    "@idealyst/components": "^1.2.19",
+    "@idealyst/components": "^1.2.21",
     "@idealyst/datagrid": "^1.0.93",
     "@idealyst/datepicker": "^1.0.93",
     "@idealyst/microphone": "^1.1.7",
-    "@idealyst/theme": "^1.2.19",
+    "@idealyst/theme": "^1.2.21",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "react": "^19.1.0",

package/src/hooks/index.native.ts

@@ -1,3 +1,4 @@
 // Native-specific hook exports
 export * from './useParams.native';
-export * from './useNavigationState.native';
+export * from './useNavigationState.native';
+export * from './useCurrentPath.native';

package/src/hooks/index.ts

@@ -1,3 +1,4 @@
 // Cross-platform hook exports
 export * from './useParams.web'; // This will be overridden by platform-specific exports
-export * from './useNavigationState.web'; // This will be overridden by platform-specific exports
+export * from './useNavigationState.web'; // This will be overridden by platform-specific exports
+export * from './useCurrentPath.web'; // This will be overridden by platform-specific exports

package/src/hooks/index.web.ts

@@ -1,3 +1,4 @@
 // Web-specific hook exports
 export * from './useParams.web';
-export * from './useNavigationState.web';
+export * from './useNavigationState.web';
+export * from './useCurrentPath.web';

package/src/hooks/useCurrentPath.native.ts

@@ -0,0 +1,16 @@
+import { useRoute } from '@react-navigation/native';
+
+/**
+ * Hook to get the current path the user is on.
+ * On native, returns the route name from React Navigation.
+ *
+ * @returns The current route path/name (e.g., '/users/123' or 'UserDetail')
+ *
+ * @example
+ * const currentPath = useCurrentPath();
+ * console.log(currentPath); // '/dashboard'
+ */
+export const useCurrentPath = (): string => {
+    const route = useRoute();
+    return route.path ?? route.name ?? '';
+};

package/src/hooks/useCurrentPath.web.ts

@@ -0,0 +1,16 @@
+import { useLocation } from '../router';
+
+/**
+ * Hook to get the current path the user is on.
+ * On web, returns the current pathname from React Router.
+ *
+ * @returns The current pathname (e.g., '/users/123')
+ *
+ * @example
+ * const currentPath = useCurrentPath();
+ * console.log(currentPath); // '/dashboard'
+ */
+export const useCurrentPath = (): string => {
+    const location = useLocation();
+    return location?.pathname ?? '/';
+};

package/src/index.native.ts

@@ -4,4 +4,7 @@ export * from './layouts';
 export * from './routing';
 export * from './hooks';
 
-// No React Router exports needed for native
+// Outlet is a web-only concept (React Router).
+// On native, we export a no-op component that renders nothing.
+// This allows shared code to import Outlet without platform checks.
+export { Outlet } from './router/index.native';

package/src/index.web.ts

@@ -9,3 +9,6 @@ export { NavigatorProvider, useNavigator } from './context/NavigatorContext.web'
 // it doesn't apply .web extension priority for nested re-exports.
 // This explicit export ensures useParams is available from @idealyst/navigation.
 export { useParams } from './hooks/useParams.web';
+
+// Re-export Outlet from React Router for web (no-op on native)
+export { Outlet } from './router/index.web';

package/src/router/index.native.ts

@@ -1,17 +1,43 @@
 // Native platforms don't use React Router
 // This is a stub to maintain cross-platform compatibility
 
+import { useRoute } from '@react-navigation/native';
+import type { Location } from './types';
+
+export type { Location };
+
 export const BrowserRouter = null;
 export const HashRouter = null;
 export const MemoryRouter = null;
 export const Router = null;
 export const useNavigate = () => null;
-export const useLocation = () => null;
+
+/**
+ * Cross-platform useLocation hook.
+ * On native, returns a location-like object derived from React Navigation's route.
+ */
+export const useLocation = (): Location => {
+    const route = useRoute();
+    return {
+        pathname: route.path ?? route.name ?? '',
+        search: '',
+        hash: '',
+        state: route.params ?? null,
+        key: route.key,
+    };
+};
+
 export const useParams = () => null;
 export const useSearchParams = () => null;
 export const Navigate = null;
-export const Outlet = null;
 export const Route = null;
 export const Routes = null;
 export const Link = null;
-export const NavLink = null;
+export const NavLink = null;
+
+/**
+ * Outlet is a web-only concept from React Router.
+ * On native, this is a no-op component that renders nothing.
+ * This allows shared code to import Outlet without platform checks.
+ */
+export const Outlet = (): null => null;

package/src/router/index.ts

@@ -18,10 +18,12 @@ import {
     Routes,
     Link,
     NavLink
-} from 'react-router-dom'
+} from 'react-router-dom';
 
+// Re-export our cross-platform Location type for consistency
+export type { Location } from './types';
 
-export {   
+export {
     BrowserRouter,
     HashRouter,
     MemoryRouter,

package/src/router/index.web.ts

@@ -18,10 +18,12 @@ import {
     Routes,
     Link,
     NavLink
-} from 'react-router-dom'
+} from 'react-router-dom';
 
+// Re-export our cross-platform Location type for consistency
+export type { Location } from './types';
 
-export {   
+export {
     BrowserRouter,
     HashRouter,
     MemoryRouter,

package/src/router/types.ts

@@ -0,0 +1,16 @@
+/**
+ * Cross-platform location type matching React Router's Location interface.
+ * Used by useLocation hook on both web and native.
+ */
+export interface Location {
+    /** The current pathname (e.g., '/users/123') */
+    pathname: string;
+    /** The query string (e.g., '?foo=bar') - empty string on native */
+    search: string;
+    /** The URL hash (e.g., '#section') - empty string on native */
+    hash: string;
+    /** State passed during navigation */
+    state: unknown;
+    /** Unique key for this location */
+    key: string;
+}