@umituz/react-native-design-system 2.9.1 → 2.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-design-system",
-  "version": "2.9.1",
+  "version": "2.9.2",
   "description": "Universal design system for React Native apps - Consolidated package with atoms, molecules, organisms, theme, typography, responsive, safe area, exception, infinite scroll, UUID, image, timezone, offline, and onboarding utilities",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/molecules/navigation/StackNavigator.tsx

@@ -26,8 +26,10 @@ export function StackNavigator<T extends ParamListBase>({ config }: StackNavigat
     try {
         NavigationValidator.validateScreens(config.screens, "stack");
         NavigationValidator.validateInitialRoute(config.initialRouteName, config.screens);
-    } catch {
-        // Silent validation failure
+    } catch (error) {
+        if (__DEV__) {
+            console.error('[StackNavigator] Validation failed:', error);
+        }
     }
 
     const { screens } = config;

package/src/molecules/navigation/TabsNavigator.tsx

@@ -32,8 +32,10 @@ export function TabsNavigator<T extends ParamListBase>({
             config.initialRouteName,
             config.screens
         );
-    } catch {
-        // Silent validation failure
+    } catch (error) {
+        if (__DEV__) {
+            console.error('[TabsNavigator] Validation failed:', error);
+        }
     }
 
     // Memoize filtered screens

package/src/molecules/navigation/hooks/useAppNavigation.ts

@@ -1,12 +1,32 @@
 import { useNavigation } from "@react-navigation/native";
 import type { NavigationProp, ParamListBase } from "@react-navigation/native";
+import { AppNavigation } from "../utils/AppNavigation";
 
 /**
  * useAppNavigation Hook
  *
- * A wrapper around React Navigation's useNavigation hook.
- * Standardizes navigation usage across all packages and apps.
+ * A unified wrapper around React Navigation's useNavigation hook.
+ * Standardizes navigation usage across all packages and apps by 
+ * providing a consistent interface that bridges static and hook-based navigation.
  */
-export function useAppNavigation<T extends ParamListBase>(): NavigationProp<T> {
-  return useNavigation<NavigationProp<T>>();
+export function useAppNavigation<T extends ParamListBase>() {
+  const navigation = useNavigation<NavigationProp<T>>();
+
+  return {
+    ...navigation,
+    // Standardized actions using the global AppNavigation utility for consistency
+    goBack: () => AppNavigation.goBack(),
+    navigate: (name: any, params?: any) => AppNavigation.navigate(name, params),
+    push: (name: any, params?: any) => AppNavigation.push(name, params),
+    replace: (name: any, params?: any) => AppNavigation.replace(name, params),
+    reset: (name: any, params?: any) => AppNavigation.reset(name, params),
+    pop: (count?: number) => AppNavigation.pop(count),
+    popToTop: () => AppNavigation.popToTop(),
+  } as NavigationProp<T> & {
+    push: (name: string, params?: object) => void;
+    replace: (name: string, params?: object) => void;
+    reset: (name: string, params?: object) => void;
+    pop: (count?: number) => void;
+    popToTop: () => void;
+  };
 }

package/src/molecules/navigation/utils/AppNavigation.ts

@@ -1,19 +1,21 @@
 import { NavigationContainerRef, CommonActions, StackActions } from '@react-navigation/native';
 
+/**
+ * AppNavigation - Global Navigation Utility
+ * 
+ * Provides static access to navigation methods from anywhere in the app.
+ * Must be initialized with setRef in the root NavigationContainer.
+ */
 export class AppNavigation {
     private static navigationRef: NavigationContainerRef<any> | null = null;
 
     static setRef(ref: NavigationContainerRef<any> | null): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Setting navigation ref', !!ref);
+        }
         this.navigationRef = ref;
     }
 
-    /**
-     * @deprecated Use setRef instead
-     */
-    static setNavigationRef(ref: NavigationContainerRef<any> | null): void {
-        this.setRef(ref);
-    }
-
     static getRef(): NavigationContainerRef<any> | null {
         return this.navigationRef;
     }
@@ -27,24 +29,36 @@ export class AppNavigation {
     }
 
     static navigate(name: string, params?: object): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Navigating to:', name, params);
+        }
         if (this.navigationRef?.isReady()) {
             this.navigationRef.navigate(name, params);
         }
     }
 
     static push(name: string, params?: object): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Pushing:', name, params);
+        }
         if (this.navigationRef?.isReady()) {
             this.navigationRef.dispatch(StackActions.push(name, params));
         }
     }
 
     static goBack(): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Going back');
+        }
         if (this.navigationRef?.isReady() && this.navigationRef.canGoBack()) {
             this.navigationRef.goBack();
         }
     }
 
     static reset(name: string, params?: object): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Resetting to:', name, params);
+        }
         if (this.navigationRef?.isReady()) {
             this.navigationRef.dispatch(
                 CommonActions.reset({
@@ -56,18 +70,27 @@ export class AppNavigation {
     }
 
     static replace(name: string, params?: object): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Replacing with:', name, params);
+        }
         if (this.navigationRef?.isReady()) {
             this.navigationRef.dispatch(StackActions.replace(name, params));
         }
     }
 
     static navigateToNested(parentParams: { screen: string; params?: any }): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Navigating to nested:', parentParams);
+        }
         if (this.navigationRef?.isReady()) {
             this.navigationRef.navigate(parentParams.screen, parentParams.params);
         }
     }
 
     static navigateToParent(name: string, params?: object): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Navigating to parent:', name, params);
+        }
         if (this.navigationRef?.isReady()) {
             const parent = this.navigationRef.getParent();
             if (parent) {
@@ -77,12 +100,18 @@ export class AppNavigation {
     }
 
     static popToTop(): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Popping to top');
+        }
         if (this.navigationRef?.isReady()) {
             this.navigationRef.dispatch(StackActions.popToTop());
         }
     }
 
     static pop(count: number = 1): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Popping:', count);
+        }
         if (this.navigationRef?.isReady()) {
             this.navigationRef.dispatch(StackActions.pop(count));
         }
@@ -113,6 +142,9 @@ export class AppNavigation {
     }
 
     static closeModal(): void {
+        if (__DEV__) {
+            console.log('[AppNavigation] Closing modal');
+        }
         if (this.navigationRef?.isReady()) {
             const parent = this.navigationRef.getParent();
             if (parent?.canGoBack()) {