@react-navigation/core 7.4.0 → 7.6.0

package/lib/typescript/module/src/useNavigationBuilder.d.ts

@@ -8,7 +8,7 @@ import { type DefaultNavigatorOptions, type EventMapCore, PrivateValueStore } fr
  * @param options Options object containing `children` and additional options for the router.
  * @returns An object containing `state`, `navigation`, `descriptors` objects.
  */
-export declare function useNavigationBuilder<State extends NavigationState, RouterOptions extends DefaultRouterOptions, ActionHelpers extends Record<string, (...args: any) => void>, ScreenOptions extends {}, EventMap extends Record<string, any>>(createRouter: RouterFactory<State, any, RouterOptions>, options: DefaultNavigatorOptions<ParamListBase, string | undefined, State, ScreenOptions, EventMap, any> & RouterOptions): {
+export declare function useNavigationBuilder<State extends NavigationState, RouterOptions extends DefaultRouterOptions, ActionHelpers extends Record<string, (...args: any) => void>, ScreenOptions extends {}, EventMap extends Record<string, any>>(createRouter: RouterFactory<State, NavigationAction, RouterOptions>, options: DefaultNavigatorOptions<ParamListBase, string | undefined, State, ScreenOptions, EventMap, any> & RouterOptions): {
     state: State;
     navigation: {
         dispatch(action: Readonly<{
@@ -25,21 +25,24 @@ export declare function useNavigationBuilder<State extends NavigationState, Rout
             type: string;
             stale: false;
         }>>) => NavigationAction)): void;
-        navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined] | [screen: string, params: object | undefined, merge: boolean]): void;
-        navigate<RouteName extends string>(options: {
-            name: string;
+        navigate<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined, options?: {
+            merge?: boolean;
+            pop?: boolean;
+        } | undefined] : never): void;
+        navigate<RouteName extends string>(options: RouteName extends unknown ? {
+            name: RouteName;
             params: object | undefined;
             path?: string;
             merge?: boolean;
             pop?: boolean;
-        }): void;
-        navigateDeprecated<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigateDeprecated<RouteName extends string>(options: {
-            name: string;
+        } : never): void;
+        navigateDeprecated<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
+        navigateDeprecated<RouteName extends string>(options: RouteName extends unknown ? {
+            name: RouteName;
             params: object | undefined;
             merge?: boolean;
-        }): void;
-        preload<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        } : never): void;
+        preload<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
         reset(state: Readonly<{
             key: string;
             index: number;
@@ -98,21 +101,24 @@ export declare function useNavigationBuilder<State extends NavigationState, Rout
             source?: string;
             target?: string;
         }> | ((state: Readonly<State>) => NavigationAction)): void;
-        navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined] | [screen: string, params: object | undefined, merge: boolean]): void;
-        navigate<RouteName extends string>(options: {
-            name: string;
+        navigate<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined, options?: {
+            merge?: boolean;
+            pop?: boolean;
+        } | undefined] : never): void;
+        navigate<RouteName extends string>(options: RouteName extends unknown ? {
+            name: RouteName;
             params: object | undefined;
             path?: string;
             merge?: boolean;
             pop?: boolean;
-        }): void;
-        navigateDeprecated<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigateDeprecated<RouteName extends string>(options: {
-            name: string;
+        } : never): void;
+        navigateDeprecated<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
+        navigateDeprecated<RouteName extends string>(options: RouteName extends unknown ? {
+            name: RouteName;
             params: object | undefined;
             merge?: boolean;
-        }): void;
-        preload<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        } : never): void;
+        preload<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
         reset(state: State | PartialState<State>): void;
         goBack(): void;
         isFocused(): boolean;
@@ -141,21 +147,24 @@ export declare function useNavigationBuilder<State extends NavigationState, Rout
             source?: string;
             target?: string;
         }> | ((state: Readonly<State>) => NavigationAction)): void;
-        navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined] | [screen: string, params: object | undefined, merge: boolean]): void;
-        navigate<RouteName extends string>(options: {
-            name: string;
+        navigate<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined, options?: {
+            merge?: boolean;
+            pop?: boolean;
+        } | undefined] : never): void;
+        navigate<RouteName extends string>(options: RouteName extends unknown ? {
+            name: RouteName;
             params: object | undefined;
             path?: string;
             merge?: boolean;
             pop?: boolean;
-        }): void;
-        navigateDeprecated<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigateDeprecated<RouteName extends string>(options: {
-            name: string;
+        } : never): void;
+        navigateDeprecated<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
+        navigateDeprecated<RouteName extends string>(options: RouteName extends unknown ? {
+            name: RouteName;
             params: object | undefined;
             merge?: boolean;
-        }): void;
-        preload<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        } : never): void;
+        preload<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
         reset(state: State | PartialState<State>): void;
         goBack(): void;
         isFocused(): boolean;

package/lib/typescript/module/src/useNavigationBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationBuilder.d.ts","sourceRoot":"","sources":["../../../../src/useNavigationBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EAIjB,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,EACL,KAAK,uBAAuB,EAE5B,KAAK,YAAY,EAEjB,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAkNjB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,oBAAoB,EAC1C,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC,EAC5D,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAEpC,YAAY,EAAE,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,aAAa,CAAC,EACtD,OAAO,EAAE,uBAAuB,CAC9B,aAAa,EACb,MAAM,GAAG,SAAS,EAClB,KAAK,EACL,aAAa,EACb,QAAQ,EACR,GAAG,CACJ,GACC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAygBhB"}
+{"version":3,"file":"useNavigationBuilder.d.ts","sourceRoot":"","sources":["../../../../src/useNavigationBuilder.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EAIjB,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,EACL,KAAK,uBAAuB,EAE5B,KAAK,YAAY,EAEjB,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAkNjB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,oBAAoB,EAC1C,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC,EAC5D,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAEpC,YAAY,EAAE,aAAa,CAAC,KAAK,EAAE,gBAAgB,EAAE,aAAa,CAAC,EACnE,OAAO,EAAE,uBAAuB,CAC9B,aAAa,EACb,MAAM,GAAG,SAAS,EAClB,KAAK,EACL,aAAa,EACb,QAAQ,EACR,GAAG,CACJ,GACC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4gBhB"}

package/lib/typescript/module/src/useNavigationCache.d.ts

@@ -24,21 +24,24 @@ export declare function useNavigationCache<State extends NavigationState, Screen
             source?: string;
             target?: string;
         }> | ((state: Readonly<State>) => NavigationAction)): void;
-        navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined] | [screen: string, params: object | undefined, merge: boolean]): void;
-        navigate<RouteName extends string>(options: {
-            name: string;
+        navigate<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined, options?: {
+            merge?: boolean;
+            pop?: boolean;
+        } | undefined] : never): void;
+        navigate<RouteName extends string>(options: RouteName extends unknown ? {
+            name: RouteName;
             params: object | undefined;
             path?: string;
             merge?: boolean;
             pop?: boolean;
-        }): void;
-        navigateDeprecated<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-        navigateDeprecated<RouteName extends string>(options: {
-            name: string;
+        } : never): void;
+        navigateDeprecated<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
+        navigateDeprecated<RouteName extends string>(options: RouteName extends unknown ? {
+            name: RouteName;
             params: object | undefined;
             merge?: boolean;
-        }): void;
-        preload<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+        } : never): void;
+        preload<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
         reset(state: State | import("@react-navigation/routers").PartialState<State>): void;
         goBack(): void;
         isFocused(): boolean;

package/lib/typescript/module/src/useNavigationCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationCache.d.ts","sourceRoot":"","sources":["../../../../src/useNavigationCache.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,KAAK,OAAO,CACV,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAClC;IACF,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,KAAK,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC,aAAa,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,UAAU,EAAE,CACV,EAAE,EAAE,CACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KACnC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAC/B,IAAI,CAAC;IACV,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACxC,OAAO,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC3C,CAAC;AAEF,KAAK,cAAc,CACjB,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAClC,cAAc,CAChB,aAAa,EACb,MAAM,EACN,MAAM,GAAG,SAAS,EAClB,KAAK,EACL,aAAa,EACb,QAAQ,CACT,CAAC;AAEF,KAAK,eAAe,CAClB,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAClC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAChD,EACA,KAAK,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,MAAM,EACN,OAAO,GACR,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4KzC"}
+{"version":3,"file":"useNavigationCache.d.ts","sourceRoot":"","sources":["../../../../src/useNavigationCache.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,KAAK,OAAO,CACV,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAClC;IACF,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,KAAK,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC,aAAa,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,UAAU,EAAE,CACV,EAAE,EAAE,CACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KACnC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAC/B,IAAI,CAAC;IACV,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACxC,OAAO,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC3C,CAAC;AAEF,KAAK,cAAc,CACjB,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAClC,cAAc,CAChB,aAAa,EACb,MAAM,EACN,MAAM,GAAG,SAAS,EAClB,KAAK,EACL,aAAa,EACb,QAAQ,CACT,CAAC;AAEF,KAAK,eAAe,CAClB,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAClC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,EAAE,EACxB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAChD,EACA,KAAK,EACL,QAAQ,EACR,UAAU,EACV,UAAU,EACV,MAAM,EACN,OAAO,GACR,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4KzC"}

package/lib/typescript/module/src/useNavigationHelpers.d.ts

@@ -29,21 +29,24 @@ export declare function useNavigationHelpers<State extends NavigationState, Acti
         type: string;
         stale: false;
     }>>) => NavigationAction)): void;
-    navigate<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined] | [screen: string, params: object | undefined, merge: boolean]): void;
-    navigate<RouteName extends string>(options: {
-        name: string;
+    navigate<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined, options?: {
+        merge?: boolean;
+        pop?: boolean;
+    } | undefined] : never): void;
+    navigate<RouteName extends string>(options: RouteName extends unknown ? {
+        name: RouteName;
         params: object | undefined;
         path?: string;
         merge?: boolean;
         pop?: boolean;
-    }): void;
-    navigateDeprecated<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
-    navigateDeprecated<RouteName extends string>(options: {
-        name: string;
+    } : never): void;
+    navigateDeprecated<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
+    navigateDeprecated<RouteName extends string>(options: RouteName extends unknown ? {
+        name: RouteName;
         params: object | undefined;
         merge?: boolean;
-    }): void;
-    preload<RouteName extends string>(...args: [screen: string] | [screen: string, params: object | undefined]): void;
+    } : never): void;
+    preload<RouteName extends string>(...args: RouteName extends unknown ? [screen: RouteName, params?: object | undefined] : never): void;
     reset(state: Readonly<{
         key: string;
         index: number;

package/lib/typescript/module/src/useNavigationHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNavigationHelpers.d.ts","sourceRoot":"","sources":["../../../../src/useNavigationHelpers.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,KAAK,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAKhE,KAAK,OAAO,CAAC,KAAK,SAAS,eAAe,EAAE,MAAM,SAAS,gBAAgB,IAAI;IAC7E,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;IAChD,QAAQ,EAAE,MAAM,KAAK,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CACzC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAChD,MAAM,SAAS,gBAAgB,EAC/B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,EACA,EAAE,EAAE,WAAW,EACf,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsFxB"}
+{"version":3,"file":"useNavigationHelpers.d.ts","sourceRoot":"","sources":["../../../../src/useNavigationHelpers.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,KAAK,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAKhE,KAAK,OAAO,CAAC,KAAK,SAAS,eAAe,EAAE,MAAM,SAAS,gBAAgB,IAAI;IAC7E,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;IAChD,QAAQ,EAAE,MAAM,KAAK,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CACzC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,SAAS,eAAe,EAC7B,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAChD,MAAM,SAAS,gBAAgB,EAC/B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,EACA,EAAE,EAAE,WAAW,EACf,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsFxB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@react-navigation/core",
   "description": "Core utilities for building navigators",
-  "version": "7.4.0",
+  "version": "7.6.0",
   "keywords": [
     "react",
     "react-native",
@@ -46,7 +46,7 @@
     "clean": "del lib"
   },
   "dependencies": {
-    "@react-navigation/routers": "^7.2.0",
+    "@react-navigation/routers": "^7.3.0",
     "escape-string-regexp": "^4.0.0",
     "nanoid": "3.3.8",
     "query-string": "^7.1.3",
@@ -63,7 +63,7 @@
     "del-cli": "^5.1.0",
     "immer": "^10.0.3",
     "react": "18.3.1",
-    "react-native-builder-bob": "^0.33.2",
+    "react-native-builder-bob": "^0.38.0",
     "react-test-renderer": "18.2.0",
     "typescript": "^5.5.2"
   },
@@ -95,5 +95,5 @@
       ]
     ]
   },
-  "gitHead": "2dc0ec3eaca7aa010d9934cabaa64562b265271a"
+  "gitHead": "3f7e8f132c141c8a73ec5678e8bb37fbeb8283b4"
 }

package/src/deepFreeze.tsx

@@ -23,10 +23,13 @@ export const deepFreeze = <T,>(object: T): Readonly<T> => {
 
   // Freeze properties before freezing self
   for (const key in object) {
-    if (Object.getOwnPropertyDescriptor(object, key)?.configurable) {
-      const value = object[key];
+    // Don't freeze objects in params since they are passed by the user
+    if (key !== 'params') {
+      if (Object.getOwnPropertyDescriptor(object, key)?.configurable) {
+        const value = object[key];
 
-      deepFreeze(value);
+        deepFreeze(value);
+      }
     }
   }
 

package/src/types.tsx

@@ -6,6 +6,7 @@ import type {
   ParamListBase,
   PartialState,
   Route,
+  Router,
 } from '@react-navigation/routers';
 import type * as React from 'react';
 
@@ -22,21 +23,6 @@ declare global {
 
 type Keyof<T extends {}> = Extract<keyof T, string>;
 
-type ScreenParamsPair<
-  ParamList extends ParamListBase,
-  RouteName extends keyof ParamList,
-> = {
-  // First we use a mapped type to get an union of screen & params pairs
-  // Then we pick the pair which matches the RouteName
-  // Mapped type is used instead of just ParamList[RouteName]
-  // Otherwise it'll result in union of all params leading to incorrect types
-  [Screen in keyof ParamList]: undefined extends ParamList[Screen] // Params are either undefined or a union with undefined
-    ?
-        | [screen: Screen] // if the params are optional, we don't have to provide it
-        | [screen: Screen, params: ParamList[Screen]]
-    : [screen: Screen, params: ParamList[Screen]];
-}[RouteName];
-
 export type DefaultNavigatorOptions<
   ParamList extends ParamListBase,
   NavigatorID extends string | undefined,
@@ -108,11 +94,15 @@ export type DefaultNavigatorOptions<
   }) => React.ReactElement;
 
   /**
-   A function returning a state, which may be set after modifying the routes name.
+   * A function returning overrides for the underlying router used by the navigator.
+   * The overrides will be shallow merged into the original router.
+   * It receives the original router as an argument to the function.
+   *
+   * This must be a pure function and cannot reference outside dynamic variables.
    */
-  UNSTABLE_getStateForRouteNamesChange?: (
-    state: NavigationState
-  ) => PartialState<NavigationState> | undefined;
+  UNSTABLE_router?: <Action extends NavigationAction>(
+    original: Router<State, Action>
+  ) => Partial<Router<State, Action>>;
 } & (NavigatorID extends string
     ? {
         /**
@@ -256,16 +246,24 @@ type NavigationHelpersCommon<
    * @param [merge] Whether to merge the params onto the route.
    */
   navigate<RouteName extends keyof ParamList>(
-    ...args: {
-      [Screen in keyof ParamList]: undefined extends ParamList[Screen]
-        ?
-            | [screen: Screen]
-            | [screen: Screen, params: ParamList[Screen]]
-            | [screen: Screen, params: ParamList[Screen], merge: boolean]
-        :
-            | [screen: Screen, params: ParamList[Screen]]
-            | [screen: Screen, params: ParamList[Screen], merge: boolean];
-    }[RouteName]
+    ...args: // This condition allows us to iterate over a union type
+    // This is to avoid getting a union of all the params from `ParamList[RouteName]`,
+    // which will get our types all mixed up if a union RouteName is passed in.
+    RouteName extends unknown
+      ? // This condition checks if the params are optional,
+        // which means it's either undefined or a union with undefined
+        undefined extends ParamList[RouteName]
+        ? [
+            screen: RouteName,
+            params?: ParamList[RouteName],
+            options?: { merge?: boolean; pop?: boolean },
+          ]
+        : [
+            screen: RouteName,
+            params: ParamList[RouteName],
+            options?: { merge?: boolean; pop?: boolean },
+          ]
+      : never
   ): void;
 
   /**
@@ -278,15 +276,15 @@ type NavigationHelpersCommon<
    * @param [options.pop] Whether to pop routes in a stack to go back to the matching route.
    */
   navigate<RouteName extends keyof ParamList>(
-    options: {
-      [Screen in keyof ParamList]: {
-        name: Screen;
-        params: ParamList[Screen];
-        path?: string;
-        merge?: boolean;
-        pop?: boolean;
-      };
-    }[RouteName]
+    options: RouteName extends unknown
+      ? {
+          name: RouteName;
+          params: ParamList[RouteName];
+          path?: string;
+          merge?: boolean;
+          pop?: boolean;
+        }
+      : never
   ): void;
 
   /**
@@ -298,7 +296,11 @@ type NavigationHelpersCommon<
    * @param [params] Params object for the route.
    */
   navigateDeprecated<RouteName extends keyof ParamList>(
-    ...args: ScreenParamsPair<ParamList, RouteName>
+    ...args: RouteName extends unknown
+      ? undefined extends ParamList[RouteName]
+        ? [screen: RouteName, params?: ParamList[RouteName]]
+        : [screen: RouteName, params: ParamList[RouteName]]
+      : never
   ): void;
 
   /**
@@ -309,13 +311,13 @@ type NavigationHelpersCommon<
    * @param options Object with `name` for the route to navigate to, and a `params` object.
    */
   navigateDeprecated<RouteName extends keyof ParamList>(
-    options: {
-      [Screen in keyof ParamList]: {
-        name: Screen;
-        params: ParamList[Screen];
-        merge?: boolean;
-      };
-    }[RouteName]
+    options: RouteName extends unknown
+      ? {
+          name: RouteName;
+          params: ParamList[RouteName];
+          merge?: boolean;
+        }
+      : never
   ): void;
 
   /**
@@ -325,7 +327,11 @@ type NavigationHelpersCommon<
    * @param [params] Params object for the route.
    */
   preload<RouteName extends keyof ParamList>(
-    ...args: ScreenParamsPair<ParamList, RouteName>
+    ...args: RouteName extends unknown
+      ? undefined extends ParamList[RouteName]
+        ? [screen: RouteName, params?: ParamList[RouteName]]
+        : [screen: RouteName, params: ParamList[RouteName]]
+      : never
   ): void;
 
   /**

package/src/useNavigationBuilder.tsx

@@ -254,7 +254,7 @@ export function useNavigationBuilder<
   ScreenOptions extends {},
   EventMap extends Record<string, any>,
 >(
-  createRouter: RouterFactory<State, any, RouterOptions>,
+  createRouter: RouterFactory<State, NavigationAction, RouterOptions>,
   options: DefaultNavigatorOptions<
     ParamListBase,
     string | undefined,
@@ -277,6 +277,7 @@ export function useNavigationBuilder<
     screenOptions,
     screenLayout,
     screenListeners,
+    UNSTABLE_router,
     ...rest
   } = options;
 
@@ -298,7 +299,18 @@ export function useNavigationBuilder<
       );
     }
 
-    return createRouter(rest as unknown as RouterOptions);
+    const original = createRouter(rest as unknown as RouterOptions);
+
+    if (UNSTABLE_router != null) {
+      const overrides = UNSTABLE_router(original);
+
+      return {
+        ...original,
+        ...overrides,
+      };
+    }
+
+    return original;
   });
 
   const screens = routeConfigs.reduce<
@@ -488,26 +500,17 @@ export function useNavigationBuilder<
     !isArrayEqual(state.routeNames, routeNames) ||
     !isRecordEqual(routeKeyList, previousRouteKeyList)
   ) {
-    const navigatorStateForNextRouteNamesChange =
-      options.UNSTABLE_getStateForRouteNamesChange?.(state);
     // When the list of route names change, the router should handle it to remove invalid routes
-    nextState = navigatorStateForNextRouteNamesChange
-      ? // @ts-expect-error this is ok
-        router.getRehydratedState(navigatorStateForNextRouteNamesChange, {
-          routeNames,
-          routeParamList,
-          routeGetIdList,
-        })
-      : router.getStateForRouteNamesChange(state, {
-          routeNames,
-          routeParamList,
-          routeGetIdList,
-          routeKeyChanges: Object.keys(routeKeyList).filter(
-            (name) =>
-              name in previousRouteKeyList &&
-              routeKeyList[name] !== previousRouteKeyList[name]
-          ),
-        });
+    nextState = router.getStateForRouteNamesChange(state, {
+      routeNames,
+      routeParamList,
+      routeGetIdList,
+      routeKeyChanges: Object.keys(routeKeyList).filter(
+        (name) =>
+          name in previousRouteKeyList &&
+          routeKeyList[name] !== previousRouteKeyList[name]
+      ),
+    });
   }
 
   const previousNestedParamsRef = React.useRef(route?.params);