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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-design-system",
-  "version": "2.9.1",
+  "version": "2.9.3",
   "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,23 @@
 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 that returns the unified AppNavigation object 
+ * but enriched with context-specific features from React Navigation.
+ * 
+ * Ensures components and non-component logic use the EXACT same navigation interface.
  */
-export function useAppNavigation<T extends ParamListBase>(): NavigationProp<T> {
-  return useNavigation<NavigationProp<T>>();
+export function useAppNavigation<T extends ParamListBase>() {
+  const navigation = useNavigation<NavigationProp<T>>();
+
+  // We return a merge of the standard navigation object and our unified AppNavigation actions.
+  // This ensures that even if called via a hook, actions like goBack() go through our 
+  // unified implementation (including logging and safety checks).
+  return {
+    ...navigation,
+    ...AppNavigation,
+  } as NavigationProp<T> & typeof AppNavigation;
 }

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

@@ -1,123 +1,148 @@
 import { NavigationContainerRef, CommonActions, StackActions } from '@react-navigation/native';
 
-export class AppNavigation {
-    private static navigationRef: NavigationContainerRef<any> | null = null;
-
-    static setRef(ref: NavigationContainerRef<any> | null): void {
-        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;
-    }
-
-    static isReady(): boolean {
-        return this.navigationRef?.isReady() ?? false;
-    }
-
-    static canGoBack(): boolean {
-        return this.navigationRef?.canGoBack() ?? false;
-    }
-
-    static navigate(name: string, params?: object): void {
-        if (this.navigationRef?.isReady()) {
-            this.navigationRef.navigate(name, params);
-        }
-    }
-
-    static push(name: string, params?: object): void {
-        if (this.navigationRef?.isReady()) {
-            this.navigationRef.dispatch(StackActions.push(name, params));
-        }
-    }
-
-    static goBack(): void {
-        if (this.navigationRef?.isReady() && this.navigationRef.canGoBack()) {
-            this.navigationRef.goBack();
-        }
-    }
-
-    static reset(name: string, params?: object): void {
-        if (this.navigationRef?.isReady()) {
-            this.navigationRef.dispatch(
-                CommonActions.reset({
-                    index: 0,
-                    routes: [{ name, params }],
-                })
-            );
-        }
-    }
-
-    static replace(name: string, params?: object): void {
-        if (this.navigationRef?.isReady()) {
-            this.navigationRef.dispatch(StackActions.replace(name, params));
-        }
-    }
-
-    static navigateToNested(parentParams: { screen: string; params?: any }): void {
-        if (this.navigationRef?.isReady()) {
-            this.navigationRef.navigate(parentParams.screen, parentParams.params);
-        }
-    }
-
-    static navigateToParent(name: string, params?: object): void {
-        if (this.navigationRef?.isReady()) {
-            const parent = this.navigationRef.getParent();
-            if (parent) {
-                parent.navigate(name, params);
-            }
-        }
-    }
-
-    static popToTop(): void {
-        if (this.navigationRef?.isReady()) {
-            this.navigationRef.dispatch(StackActions.popToTop());
-        }
-    }
-
-    static pop(count: number = 1): void {
-        if (this.navigationRef?.isReady()) {
-            this.navigationRef.dispatch(StackActions.pop(count));
-        }
-    }
-
-    static getCurrentRoute(): string | undefined {
-        return this.navigationRef?.getCurrentRoute()?.name;
-    }
-
-    static getCurrentParams<T extends object>(): T | undefined {
-        return this.navigationRef?.getCurrentRoute()?.params as T | undefined;
-    }
-
-    static goToSettings(): void {
-        this.navigate('Settings');
-    }
-
-    static goToProfile(): void {
-        this.navigate('Profile');
-    }
-
-    static goToHome(): void {
-        this.navigate('Home');
-    }
-
-    static openModal(name: string, params?: object): void {
-        this.navigateToParent(name, params);
-    }
-
-    static closeModal(): void {
-        if (this.navigationRef?.isReady()) {
-            const parent = this.navigationRef.getParent();
-            if (parent?.canGoBack()) {
-                parent.goBack();
-            }
-        }
-    }
-}
+/**
+ * Global Navigation Implementation
+ * Single source of truth for all navigation actions.
+ */
+
+let navigationRef: NavigationContainerRef<any> | null = null;
+
+/**
+ * Set the global navigation reference.
+ * Should be called in the root NavigationContainer.
+ */
+export const setRef = (ref: NavigationContainerRef<any> | null): void => {
+    if (__DEV__) {
+        console.log('[AppNavigation] Setting navigation ref', !!ref);
+    }
+    navigationRef = ref;
+};
+
+/**
+ * Get the current navigation reference.
+ */
+export const getRef = (): NavigationContainerRef<any> | null => navigationRef;
+
+/**
+ * Check if the navigator is ready.
+ */
+export const isReady = (): boolean => navigationRef?.isReady() ?? false;
+
+/**
+ * Check if the navigator can go back.
+ */
+export const canGoBack = (): boolean => navigationRef?.canGoBack() ?? false;
+
+/**
+ * Navigate to a specific route.
+ */
+export const navigate = (name: string, params?: object): void => {
+    if (__DEV__) {
+        console.log('[AppNavigation] Navigating to:', name, params);
+    }
+    if (navigationRef?.isReady()) {
+        navigationRef.navigate(name, params);
+    }
+};
+
+/**
+ * Push a new route onto the stack.
+ */
+export const push = (name: string, params?: object): void => {
+    if (__DEV__) {
+        console.log('[AppNavigation] Pushing:', name, params);
+    }
+    if (navigationRef?.isReady()) {
+        navigationRef.dispatch(StackActions.push(name, params));
+    }
+};
+
+/**
+ * Go back to the previous screen.
+ */
+export const goBack = (): void => {
+    if (__DEV__) {
+        console.log('[AppNavigation] Going back');
+    }
+    if (navigationRef?.isReady() && navigationRef.canGoBack()) {
+        navigationRef.goBack();
+    }
+};
+
+/**
+ * Reset the navigation state.
+ */
+export const reset = (name: string, params?: object): void => {
+    if (__DEV__) {
+        console.log('[AppNavigation] Resetting to:', name, params);
+    }
+    if (navigationRef?.isReady()) {
+        navigationRef.dispatch(
+            CommonActions.reset({
+                index: 0,
+                routes: [{ name, params }],
+            })
+        );
+    }
+};
+
+/**
+ * Replace the current route.
+ */
+export const replace = (name: string, params?: object): void => {
+    if (__DEV__) {
+        console.log('[AppNavigation] Replacing with:', name, params);
+    }
+    if (navigationRef?.isReady()) {
+        navigationRef.dispatch(StackActions.replace(name, params));
+    }
+};
+
+/**
+ * Pop to the top of the stack.
+ */
+export const popToTop = (): void => {
+    if (__DEV__) {
+        console.log('[AppNavigation] Popping to top');
+    }
+    if (navigationRef?.isReady()) {
+        navigationRef.dispatch(StackActions.popToTop());
+    }
+};
+
+/**
+ * Pop specific number of screens.
+ */
+export const pop = (count: number = 1): void => {
+    if (__DEV__) {
+        console.log('[AppNavigation] Popping:', count);
+    }
+    if (navigationRef?.isReady()) {
+        navigationRef.dispatch(StackActions.pop(count));
+    }
+};
+
+/**
+ * Get the current route name.
+ */
+export const getCurrentRoute = (): string | undefined => {
+    return navigationRef?.getCurrentRoute()?.name;
+};
+
+/**
+ * Unified AppNavigation Object for both static and hook-based usage.
+ */
+export const AppNavigation = {
+    setRef,
+    getRef,
+    isReady,
+    canGoBack,
+    navigate,
+    push,
+    goBack,
+    reset,
+    replace,
+    popToTop,
+    pop,
+    getCurrentRoute,
+};