@idealyst/navigation 1.2.3 → 1.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/navigation",
-  "version": "1.2.3",
+  "version": "1.2.6",
   "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.3",
+    "@idealyst/components": "^1.2.6",
     "@idealyst/microphone": "^1.1.7",
-    "@idealyst/theme": "^1.2.3",
+    "@idealyst/theme": "^1.2.6",
     "@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.3",
+    "@idealyst/components": "^1.2.6",
     "@idealyst/datagrid": "^1.0.93",
     "@idealyst/datepicker": "^1.0.93",
     "@idealyst/microphone": "^1.1.7",
-    "@idealyst/theme": "^1.2.3",
+    "@idealyst/theme": "^1.2.6",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "react": "^19.1.0",

package/src/context/NavigatorContext.native.tsx

@@ -92,7 +92,28 @@ function hasNotFoundComponent(route: NavigatorParam): boolean {
 /**
  * Normalize a path and substitute variables
  */
-function normalizePath(path: string, vars?: Record<string, string>): string {
+function normalizePath(path: string | undefined | null, vars?: Record<string, string>): string {
+    // Handle invalid path input
+    if (path === undefined || path === null) {
+        console.error(
+            'Navigation Error: navigate() was called with an invalid path.\n' +
+            'Expected: navigate({ path: "/your-route" })\n' +
+            'Received: path is ' + String(path) + '\n' +
+            'Make sure you are passing an object with a "path" property, not a string directly.'
+        );
+        return '/';
+    }
+
+    if (typeof path !== 'string') {
+        console.error(
+            'Navigation Error: navigate() path must be a string.\n' +
+            'Expected: navigate({ path: "/your-route" })\n' +
+            'Received: ' + typeof path + '\n' +
+            'Make sure you are passing an object with a "path" property, not a string directly.'
+        );
+        return '/';
+    }
+
     let normalizedPath = path;
 
     // Convert empty string to '/'
@@ -188,6 +209,25 @@ const UnwrappedNavigatorProvider = ({ route }: NavigatorProviderProps) => {
     const navigation = useNavigation();
 
     const navigate = (params: NavigateParams, _redirectCount = 0) => {
+        // Validate params - catch common mistake of passing string directly
+        if (typeof params === 'string') {
+            console.error(
+                'Navigation Error: navigate() expects an object, not a string.\n' +
+                'Expected: navigate({ path: "' + params + '" })\n' +
+                'Received: navigate("' + params + '")\n' +
+                'Please pass an object with a "path" property.'
+            );
+            return;
+        }
+
+        if (!params || typeof params !== 'object') {
+            console.error(
+                'Navigation Error: navigate() expects an object with a "path" property.\n' +
+                'Received: ' + typeof params
+            );
+            return;
+        }
+
         // Prevent infinite redirect loops
         if (_redirectCount > 10) {
             console.error('Navigation: Maximum redirect count exceeded. Check onInvalidRoute handlers.');
@@ -310,6 +350,25 @@ const NavigatorProvider = ({ route }: NavigatorProviderProps) => {
 const DrawerNavigatorProvider = ({ navigation, route, children }: { navigation: any, route: any, children: React.ReactNode }) => {
 
     const navigate = (params: NavigateParams, _redirectCount = 0) => {
+        // Validate params - catch common mistake of passing string directly
+        if (typeof params === 'string') {
+            console.error(
+                'Navigation Error: navigate() expects an object, not a string.\n' +
+                'Expected: navigate({ path: "' + params + '" })\n' +
+                'Received: navigate("' + params + '")\n' +
+                'Please pass an object with a "path" property.'
+            );
+            return;
+        }
+
+        if (!params || typeof params !== 'object') {
+            console.error(
+                'Navigation Error: navigate() expects an object with a "path" property.\n' +
+                'Received: ' + typeof params
+            );
+            return;
+        }
+
         // Prevent infinite redirect loops
         if (_redirectCount > 10) {
             console.error('Navigation: Maximum redirect count exceeded. Check onInvalidRoute handlers.');

package/src/context/NavigatorContext.web.tsx

@@ -14,7 +14,28 @@ const NavigatorContext = createContext<NavigatorContextValue>({
 /**
  * Normalize a path and substitute variables
  */
-function normalizePath(path: string, vars?: Record<string, string>): string {
+function normalizePath(path: string | undefined | null, vars?: Record<string, string>): string {
+    // Handle invalid path input
+    if (path === undefined || path === null) {
+        console.error(
+            'Navigation Error: navigate() was called with an invalid path.\n' +
+            'Expected: navigate({ path: "/your-route" })\n' +
+            'Received: path is ' + String(path) + '\n' +
+            'Make sure you are passing an object with a "path" property, not a string directly.'
+        );
+        return '/';
+    }
+
+    if (typeof path !== 'string') {
+        console.error(
+            'Navigation Error: navigate() path must be a string.\n' +
+            'Expected: navigate({ path: "/your-route" })\n' +
+            'Received: ' + typeof path + '\n' +
+            'Make sure you are passing an object with a "path" property, not a string directly.'
+        );
+        return '/';
+    }
+
     let normalizedPath = path;
 
     // Convert empty string to '/'