@react-navigation/native 7.1.28 → 8.0.0-alpha.1

package/lib/typescript/src/useLinkProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLinkProps.d.ts","sourceRoot":"","sources":["../../../src/useLinkProps.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAKtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,qBAAqB,EAAY,MAAM,cAAc,CAAC;AAIpE,MAAM,MAAM,SAAS,CACnB,SAAS,SAAS,eAAe,CAAC,aAAa,EAC/C,SAAS,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS,IAEjD,CAAC;IACC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,CAAC,SAAS,SAAS,OAAO,GAC1B,SAAS,SAAS,SAAS,CAAC,SAAS,CAAC,GACpC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAAE,GACrD,KAAK,CAAC,CAAC,GACX;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AA+BN;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,SAAS,SAAS,eAAe,CAAC,aAAa,EAAE,EAC5E,MAAM,EACN,MAAM,EACN,IAAI,EACJ,MAAM,GACP,EAAE,SAAS,CAAC,SAAS,CAAC;;;kBAMf,KAAK,CAAC,UAAU,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAAG,qBAAqB;EA0E9E"}
+{"version":3,"file":"useLinkProps.d.ts","sourceRoot":"","sources":["../../../src/useLinkProps.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAKrB,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,KAAK,qBAAqB,EAAY,MAAM,cAAc,CAAC;AAIpE,MAAM,MAAM,SAAS,CACnB,SAAS,SAAS,EAAE,GAAG,aAAa,EACpC,SAAS,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS,IAEjD,CAAC;IACC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,CAAC,SAAS,SAAS,OAAO,GAC1B,SAAS,SAAS,SAAS,CAAC,SAAS,CAAC,GACpC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAAE,GACrD,KAAK,CAAC,CAAC,GACX;IACE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AA+BN;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,CAAC,SAAS,SAAS,EAAE,GAAG,aAAa,EAC1C,KAAK,CAAC,SAAS,SAAS,MAAM,SAAS,GAAG,MAAM,SAAS,EACzD,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;;;kBAM3D,KAAK,CAAC,UAAU,CAAC,iBAAiB,EAAE,UAAU,CAAC,GAAG,qBAAqB;EAwG9E"}

package/lib/typescript/src/useLinking.d.ts

@@ -1,14 +1,58 @@
-import { getStateFromPath as getStateFromPathDefault, type NavigationContainerRef, type ParamListBase } from '@react-navigation/core';
+import { type NavigationContainerRef, type ParamListBase } from '@react-navigation/core';
 import * as React from 'react';
 import type { LinkingOptions } from './types';
-type ResultState = ReturnType<typeof getStateFromPathDefault>;
+import type { Thenable } from './useThenable';
 /**
  * Run async function in series as it's called.
  */
 export declare const series: (cb: () => Promise<void>) => () => void;
 type Options = LinkingOptions<ParamListBase>;
-export declare function useLinking(ref: React.RefObject<NavigationContainerRef<ParamListBase> | null>, { enabled, config, getStateFromPath, getPathFromState, getActionFromState, }: Options, onUnhandledLinking: (lastUnhandledLining: string | undefined) => void): {
-    getInitialState: () => PromiseLike<ResultState | undefined>;
+export declare function useLinking(ref: React.RefObject<NavigationContainerRef<ParamListBase> | null>, { enabled, config, getStateFromPath, getPathFromState, getActionFromState, }: Options): {
+    getInitialState: () => Thenable<(Partial<Omit<Readonly<{
+        key: string;
+        index: number;
+        routeNames: string[];
+        history?: unknown[];
+        routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
+        type: string;
+        stale: false;
+    }>, "stale" | "routes">> & Readonly<{
+        stale?: true;
+        routes: import("@react-navigation/routers").PartialRoute<Readonly<{
+            key: string;
+            name: string;
+            path?: string;
+            history?: {
+                type: "params";
+                params: object;
+            }[];
+        } & Readonly<{
+            params?: Readonly<object | undefined>;
+        }>>>[];
+    }> & {
+        state?: Partial<Omit<Readonly<{
+            key: string;
+            index: number;
+            routeNames: string[];
+            history?: unknown[];
+            routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
+            type: string;
+            stale: false;
+        }>, "stale" | "routes">> & Readonly<{
+            stale?: true;
+            routes: import("@react-navigation/routers").PartialRoute<Readonly<{
+                key: string;
+                name: string;
+                path?: string;
+                history?: {
+                    type: "params";
+                    params: object;
+                }[];
+            } & Readonly<{
+                params?: Readonly<object | undefined>;
+            }>>>[];
+        }> & /*elided*/ any;
+    }) | undefined>;
 };
 export {};
 //# sourceMappingURL=useLinking.d.ts.map

package/lib/typescript/src/useLinking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLinking.d.ts","sourceRoot":"","sources":["../../../src/useLinking.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,gBAAgB,IAAI,uBAAuB,EAC3C,KAAK,sBAAsB,EAE3B,KAAK,aAAa,EAEnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AA0C9D;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,eAO7C,CAAC;AAIF,KAAK,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAE7C,wBAAgB,UAAU,CACxB,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,EAClE,EACE,OAAc,EACd,MAAM,EACN,gBAA0C,EAC1C,gBAA0C,EAC1C,kBAA8C,GAC/C,EAAE,OAAO,EACV,kBAAkB,EAAE,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI;2BAmGhD,WAAW,CAAC,WAAW,GAAG,SAAS,CAAC;EAkQ1D"}
+{"version":3,"file":"useLinking.d.ts","sourceRoot":"","sources":["../../../src/useLinking.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,sBAAsB,EAE3B,KAAK,aAAa,EAEnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA4D9C;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,eAO7C,CAAC;AAIF,KAAK,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAE7C,wBAAgB,UAAU,CACxB,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,EAClE,EACE,OAAc,EACd,MAAM,EACN,gBAA0C,EAC1C,gBAA0C,EAC1C,kBAA8C,GAC/C,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+UX"}

package/lib/typescript/src/useLinking.native.d.ts

@@ -1,9 +1,10 @@
 import { type NavigationContainerRef, type ParamListBase } from '@react-navigation/core';
 import * as React from 'react';
 import type { LinkingOptions } from './types';
+import type { Thenable } from './useThenable';
 type Options = LinkingOptions<ParamListBase>;
-export declare function useLinking(ref: React.RefObject<NavigationContainerRef<ParamListBase> | null>, { enabled, prefixes, filter, config, getInitialURL, subscribe, getStateFromPath, getActionFromState, }: Options, onUnhandledLinking: (lastUnhandledLining: string | undefined) => void): {
-    getInitialState: () => PromiseLike<(Partial<Omit<Readonly<{
+export declare function useLinking(ref: React.RefObject<NavigationContainerRef<ParamListBase> | null>, { enabled, prefixes, filter, config, getInitialURL, subscribe, getStateFromPath, getActionFromState, }: Options): {
+    getInitialState: () => Thenable<(Partial<Omit<Readonly<{
         key: string;
         index: number;
         routeNames: string[];
@@ -13,7 +14,61 @@ export declare function useLinking(ref: React.RefObject<NavigationContainerRef<P
         stale: false;
     }>, "stale" | "routes">> & Readonly<{
         stale?: true;
-        routes: import("@react-navigation/routers").PartialRoute<import("@react-navigation/routers").Route<string, object | undefined>>[];
+        routes: import("@react-navigation/routers").PartialRoute<Readonly<{
+            key: string;
+            name: string;
+            path?: string;
+            history?: {
+                type: "params";
+                params: object;
+            }[];
+        } & Readonly<{
+            params?: Readonly<object | undefined>;
+        }>>>[];
+    }> & {
+        state?: Partial<Omit<Readonly<{
+            key: string;
+            index: number;
+            routeNames: string[];
+            history?: unknown[];
+            routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
+            type: string;
+            stale: false;
+        }>, "stale" | "routes">> & Readonly<{
+            stale?: true;
+            routes: import("@react-navigation/routers").PartialRoute<Readonly<{
+                key: string;
+                name: string;
+                path?: string;
+                history?: {
+                    type: "params";
+                    params: object;
+                }[];
+            } & Readonly<{
+                params?: Readonly<object | undefined>;
+            }>>>[];
+        }> & /*elided*/ any;
+    }) | undefined> | Promise<(Partial<Omit<Readonly<{
+        key: string;
+        index: number;
+        routeNames: string[];
+        history?: unknown[];
+        routes: import("@react-navigation/routers").NavigationRoute<ParamListBase, string>[];
+        type: string;
+        stale: false;
+    }>, "stale" | "routes">> & Readonly<{
+        stale?: true;
+        routes: import("@react-navigation/routers").PartialRoute<Readonly<{
+            key: string;
+            name: string;
+            path?: string;
+            history?: {
+                type: "params";
+                params: object;
+            }[];
+        } & Readonly<{
+            params?: Readonly<object | undefined>;
+        }>>>[];
     }> & {
         state?: Partial<Omit<Readonly<{
             key: string;
@@ -25,7 +80,17 @@ export declare function useLinking(ref: React.RefObject<NavigationContainerRef<P
             stale: false;
         }>, "stale" | "routes">> & Readonly<{
             stale?: true;
-            routes: import("@react-navigation/routers").PartialRoute<import("@react-navigation/routers").Route<string, object | undefined>>[];
+            routes: import("@react-navigation/routers").PartialRoute<Readonly<{
+                key: string;
+                name: string;
+                path?: string;
+                history?: {
+                    type: "params";
+                    params: object;
+                }[];
+            } & Readonly<{
+                params?: Readonly<object | undefined>;
+            }>>>[];
         }> & /*elided*/ any;
     }) | undefined>;
 };

package/lib/typescript/src/useLinking.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLinking.native.d.ts","sourceRoot":"","sources":["../../../src/useLinking.native.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAEnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,KAAK,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAI7C,wBAAgB,UAAU,CACxB,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,EAClE,EACE,OAAc,EACd,QAAQ,EACR,MAAM,EACN,MAAM,EACN,aAQI,EACJ,SAmBC,EACD,gBAA0C,EAC1C,kBAA8C,GAC/C,EAAE,OAAO,EACV,kBAAkB,EAAE,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;EA8JtE"}
+{"version":3,"file":"useLinking.native.d.ts","sourceRoot":"","sources":["../../../src/useLinking.native.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAEnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,KAAK,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAI7C,wBAAgB,UAAU,CACxB,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,EAClE,EACE,OAAc,EACd,QAAgB,EAChB,MAAM,EACN,MAAM,EACN,aAQI,EACJ,SAQC,EACD,gBAA0C,EAC1C,kBAA8C,GAC/C,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkJX"}

package/lib/typescript/src/useScrollToTop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollToTop.d.ts","sourceRoot":"","sources":["../../../src/useScrollToTop.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,KAAK,aAAa,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpE,KAAK,cAAc,GACf;IAAE,WAAW,IAAI,IAAI,CAAA;CAAE,GACvB;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,GAC1C;IAAE,cAAc,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GACzE;IAAE,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CAAC;AAE9D,KAAK,iBAAiB,GAClB;IAAE,kBAAkB,IAAI,KAAK,CAAC,SAAS,GAAG,UAAU,CAAA;CAAE,GACtD;IAAE,OAAO,IAAI,cAAc,CAAA;CAAE,GAC7B,cAAc,GACd,IAAI,CAAC;AA8BT,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,QAoErE"}
+{"version":3,"file":"useScrollToTop.d.ts","sourceRoot":"","sources":["../../../src/useScrollToTop.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,KAAK,aAAa,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpE,KAAK,cAAc,GACf;IAAE,WAAW,IAAI,IAAI,CAAA;CAAE,GACvB;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,GAC1C;IAAE,cAAc,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GACzE;IAAE,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,CAAC;AAE9D,KAAK,iBAAiB,GAClB;IAAE,kBAAkB,IAAI,KAAK,CAAC,SAAS,GAAG,UAAU,CAAA;CAAE,GACtD;IAAE,OAAO,IAAI,cAAc,CAAA;CAAE,GAC7B,cAAc,GACd,IAAI,CAAC;AA8BT,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,QAsErE"}

package/lib/typescript/src/useThenable.d.ts

@@ -1,2 +1,5 @@
-export declare function useThenable<T>(create: () => PromiseLike<T>): [boolean, T | undefined];
+export type Thenable<T> = {
+    then(onfulfilled?: (value: T) => unknown): PromiseLike<unknown>;
+};
+export declare function useThenable<T>(create: () => Thenable<T> | undefined): [boolean, T | undefined];
 //# sourceMappingURL=useThenable.d.ts.map

package/lib/typescript/src/useThenable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useThenable.d.ts","sourceRoot":"","sources":["../../../src/useThenable.tsx"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,4BAuC1D"}
+{"version":3,"file":"useThenable.d.ts","sourceRoot":"","sources":["../../../src/useThenable.tsx"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IACxB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CACjE,CAAC;AAEF,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,4BA2CnE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@react-navigation/native",
   "description": "React Native integration for React Navigation",
-  "version": "7.1.28",
+  "version": "8.0.0-alpha.1",
   "keywords": [
     "react-native",
     "react-navigation",
@@ -30,7 +30,11 @@
   },
   "files": [
     "src",
+    "assets",
     "lib",
+    "ios",
+    "android",
+    "ReactNavigation.podspec",
     "!**/__tests__"
   ],
   "sideEffects": false,
@@ -42,27 +46,28 @@
     "clean": "del lib"
   },
   "dependencies": {
-    "@react-navigation/core": "^7.14.0",
+    "@react-navigation/core": "^8.0.0-alpha.1",
     "escape-string-regexp": "^4.0.0",
     "fast-deep-equal": "^3.1.3",
     "nanoid": "^3.3.11",
-    "use-latest-callback": "^0.2.4"
+    "sf-symbols-typescript": "^2.2.0",
+    "use-latest-callback": "^0.3.2"
   },
   "devDependencies": {
     "@jest/globals": "^30.0.0",
     "@testing-library/react-native": "^13.2.1",
-    "@types/react": "~19.0.10",
+    "@types/react": "~19.1.10",
     "@types/react-dom": "~19.1.7",
     "del-cli": "^6.0.0",
     "react": "19.1.0",
     "react-dom": "19.1.0",
-    "react-native": "0.81.5",
-    "react-native-builder-bob": "^0.40.17",
+    "react-native": "0.81.4",
+    "react-native-builder-bob": "^0.40.12",
     "react-test-renderer": "19.1.0",
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "react": ">= 18.2.0",
+    "react": ">= 19.0.0",
     "react-native": "*"
   },
   "react-native-builder-bob": {
@@ -83,5 +88,20 @@
       ]
     ]
   },
-  "gitHead": "e2e5f1e55afe7b135811832487f596c6060def74"
+  "codegenConfig": {
+    "name": "ReactNavigationSpec",
+    "type": "all",
+    "jsSrcsDir": "src/native",
+    "android": {
+      "componentProvider": {
+        "ReactNavigationMaterialSymbolView": "ReactNavigationMaterialSymbolView"
+      }
+    },
+    "ios": {
+      "componentProvider": {
+        "ReactNavigationSFSymbolView": "ReactNavigationSFSymbolView"
+      }
+    }
+  },
+  "gitHead": "7c3631904a6c70265ec6a2639fa0c0befc79d05c"
 }

package/src/Link.tsx

@@ -1,4 +1,4 @@
-import { useTheme } from '@react-navigation/core';
+import { type RootParamList, useTheme } from '@react-navigation/core';
 import * as React from 'react';
 import {
   type GestureResponderEvent,
@@ -9,18 +9,18 @@ import {
 
 import { type LinkProps, useLinkProps } from './useLinkProps';
 
-type Props<ParamList extends ReactNavigation.RootParamList> =
-  LinkProps<ParamList> &
-    Omit<TextProps, 'disabled'> & {
-      target?: string;
-      onPress?: (
-        e:
-          | React.MouseEvent<HTMLAnchorElement, MouseEvent>
-          | GestureResponderEvent
-      ) => void;
-      disabled?: boolean | null;
-      children: React.ReactNode;
-    };
+type Props<
+  ParamList extends {} = RootParamList,
+  RouteName extends keyof ParamList = keyof ParamList,
+> = LinkProps<ParamList, RouteName> &
+  Omit<TextProps, 'disabled'> & {
+    target?: string;
+    onPress?: (
+      e: React.MouseEvent<HTMLAnchorElement, MouseEvent> | GestureResponderEvent
+    ) => void;
+    disabled?: boolean | null;
+    children: React.ReactNode;
+  };
 
 /**
  * Component to render link to another screen using a path.
@@ -32,14 +32,17 @@ type Props<ParamList extends ReactNavigation.RootParamList> =
  * @param props.action Optional action to use for in-page navigation. By default, the path is parsed to an action based on linking config.
  * @param props.children Child elements to render the content.
  */
-export function Link<ParamList extends ReactNavigation.RootParamList>({
+export function Link<
+  const ParamList extends {} = RootParamList,
+  const RouteName extends keyof ParamList = keyof ParamList,
+>({
   screen,
   params,
   action,
   href,
   style,
   ...rest
-}: Props<ParamList>) {
+}: Props<ParamList, RouteName>) {
   const { colors, fonts } = useTheme();
   // @ts-expect-error: This is already type-checked by the prop types
   const props = useLinkProps<ParamList>({ screen, params, action, href });

package/src/NavigationContainer.tsx

@@ -3,16 +3,16 @@ import {
   getActionFromState,
   getPathFromState,
   getStateFromPath,
+  type InitialState,
   type NavigationContainerProps,
   type NavigationContainerRef,
-  type NavigationState,
   type ParamListBase,
+  type RootParamList,
   ThemeProvider,
   validatePathConfig,
 } from '@react-navigation/core';
 import * as React from 'react';
-import { I18nManager } from 'react-native';
-import useLatestCallback from 'use-latest-callback';
+import { I18nManager, Platform } from 'react-native';
 
 import { LinkingContext } from './LinkingContext';
 import { LocaleDirContext } from './LocaleDirContext';
@@ -21,12 +21,12 @@ import type {
   DocumentTitleOptions,
   LinkingOptions,
   LocaleDirection,
+  Persistor,
 } from './types';
-import { UnhandledLinkingContext } from './UnhandledLinkingContext';
 import { useBackButton } from './useBackButton';
 import { useDocumentTitle } from './useDocumentTitle';
 import { useLinking } from './useLinking';
-import { useThenable } from './useThenable';
+import { type Thenable, useThenable } from './useThenable';
 
 declare global {
   var REACT_NAVIGATION_DEVTOOLS: WeakMap<
@@ -41,7 +41,9 @@ type Props<ParamList extends {}> = NavigationContainerProps & {
   /**
    * Initial state object for the navigation tree.
    *
-   * If this is provided, deep link or URLs won't be handled on the initial render.
+   * If this is provided:
+   * - Deep link or URLs won't be handled on the initial render.
+   * - Persisted state won't be restored.
    */
   initialState?: NavigationContainerProps['initialState'];
   /**
@@ -56,11 +58,36 @@ type Props<ParamList extends {}> = NavigationContainerProps & {
    */
   linking?: LinkingOptions<ParamList>;
   /**
-   * Fallback element to render until initial state is resolved from deep linking.
+   * Persistor object to persist and restore navigation state.
+   *
+   * State is not restored if a deep link is handled on the initial render
+   * Not supported on web when linking is enabled.
+   *
+   * Example:
+   *
+   * ```ts
+   * const persistor = {
+   *   async persist(state) {
+   *     await AsyncStorage.setItem('state-key-v1', JSON.stringify(state));
+   *   },
+   *   async restore() {
+   *     const state = await AsyncStorage.getItem('state-key-v1');
+   *
+   *     return state ? JSON.parse(state) : undefined;
+   *   },
+   * };
+   *
+   * <NavigationContainer persistor={persistor}>...</NavigationContainer>
+   * ```
+   */
+  persistor?: Persistor;
+  /**
+   * Fallback element to render until initial state is resolved.
+   * Used when deep link or persisted state is being restored asynchronously.
    *
    * Defaults to `null`.
    */
-  fallback?: React.ReactNode;
+  fallback?: React.ReactElement | null;
   /**
    * Options to configure the document title on Web.
    *
@@ -70,21 +97,22 @@ type Props<ParamList extends {}> = NavigationContainerProps & {
   documentTitle?: DocumentTitleOptions;
 };
 
+const RESTORE_STATE_ERROR =
+  'Failed to restore navigation state. The state will be initialized based on the navigation tree.';
+
 function NavigationContainerInner(
   {
     direction = I18nManager.getConstants().isRTL ? 'rtl' : 'ltr',
     theme = DefaultTheme,
     linking,
+    persistor,
     fallback = null,
     documentTitle,
-    onReady,
     onStateChange,
     ...rest
   }: Props<ParamListBase>,
   ref?: React.Ref<NavigationContainerRef<ParamListBase> | null>
 ) {
-  const isLinkingEnabled = linking ? linking.enabled !== false : false;
-
   if (linking?.config) {
     validatePathConfig(linking.config);
   }
@@ -95,82 +123,108 @@ function NavigationContainerInner(
   useBackButton(refContainer);
   useDocumentTitle(refContainer, documentTitle);
 
-  const [lastUnhandledLink, setLastUnhandledLink] = React.useState<
-    string | undefined
-  >();
-
-  const { getInitialState } = useLinking(
-    refContainer,
-    {
-      enabled: isLinkingEnabled,
-      prefixes: [],
-      ...linking,
-    },
-    setLastUnhandledLink
-  );
-
-  const linkingContext = React.useMemo(() => ({ options: linking }), [linking]);
+  const linkingConfig = React.useMemo(() => {
+    if (linking == null) {
+      return {
+        options: {
+          enabled: false,
+        },
+      };
+    }
 
-  const unhandledLinkingContext = React.useMemo(
-    () => ({ lastUnhandledLink, setLastUnhandledLink }),
-    [lastUnhandledLink, setLastUnhandledLink]
-  );
+    return {
+      options: {
+        ...linking,
+        enabled: linking.enabled !== false,
+        prefixes: linking.prefixes ?? ['*'],
+        getStateFromPath: linking?.getStateFromPath ?? getStateFromPath,
+        getPathFromState: linking?.getPathFromState ?? getPathFromState,
+        getActionFromState: linking?.getActionFromState ?? getActionFromState,
+      },
+    };
+  }, [linking]);
 
-  const onReadyForLinkingHandling = useLatestCallback(() => {
-    // If the screen path matches lastUnhandledLink, we do not track it
-    const path = refContainer.current?.getCurrentRoute()?.path;
-    setLastUnhandledLink((previousLastUnhandledLink) => {
-      if (previousLastUnhandledLink === path) {
-        return undefined;
-      }
-      return previousLastUnhandledLink;
-    });
-    onReady?.();
-  });
+  const { getInitialState } = useLinking(refContainer, linkingConfig.options);
 
-  const onStateChangeForLinkingHandling = useLatestCallback(
-    (state: Readonly<NavigationState> | undefined) => {
-      // If the screen path matches lastUnhandledLink, we do not track it
-      const path = refContainer.current?.getCurrentRoute()?.path;
-      setLastUnhandledLink((previousLastUnhandledLink) => {
-        if (previousLastUnhandledLink === path) {
-          return undefined;
-        }
-        return previousLastUnhandledLink;
-      });
-      onStateChange?.(state);
-    }
-  );
   // Add additional linking related info to the ref
   // This will be used by the devtools
   React.useEffect(() => {
     if (refContainer.current) {
       REACT_NAVIGATION_DEVTOOLS.set(refContainer.current, {
         get linking() {
-          return {
-            ...linking,
-            enabled: isLinkingEnabled,
-            prefixes: linking?.prefixes ?? [],
-            getStateFromPath: linking?.getStateFromPath ?? getStateFromPath,
-            getPathFromState: linking?.getPathFromState ?? getPathFromState,
-            getActionFromState:
-              linking?.getActionFromState ?? getActionFromState,
-          };
+          return linkingConfig.options;
         },
       });
     }
   });
 
-  const [isResolved, initialState] = useThenable(getInitialState);
+  const [isLinkStateResolved, initialStateFromLink] = useThenable(() => {
+    if (rest.initialState != null || !linkingConfig.options.enabled) {
+      return undefined;
+    }
+
+    return getInitialState();
+  });
+
+  const isPersistenceSupported =
+    Platform.OS === 'web' ? !linkingConfig.options.enabled : true;
+
+  const [isPersistedStateResolved, initialStateFromPersisted] = useThenable(
+    () => {
+      if (
+        isPersistenceSupported === false ||
+        rest.initialState != null ||
+        persistor == null
+      ) {
+        return undefined;
+      }
+
+      let restoredState;
+
+      try {
+        restoredState = persistor.restore();
+      } catch (e) {
+        console.error(RESTORE_STATE_ERROR, e);
+
+        return undefined;
+      }
+
+      if (restoredState == null) {
+        return undefined;
+      }
+
+      if ('then' in restoredState) {
+        return restoredState.then(
+          (state) => state,
+          (error) => {
+            console.error(RESTORE_STATE_ERROR, error);
+
+            return undefined;
+          }
+        );
+      }
+
+      const thenable: Thenable<InitialState | undefined> = {
+        then(onfulfilled) {
+          return Promise.resolve(
+            onfulfilled ? onfulfilled(restoredState) : restoredState
+          );
+        },
+      };
+
+      return thenable;
+    }
+  );
 
   // FIXME
   // @ts-expect-error not sure why this is not working
   React.useImperativeHandle(ref, () => refContainer.current);
 
-  const isLinkingReady =
-    rest.initialState != null || !isLinkingEnabled || isResolved;
+  const isStateReady =
+    rest.initialState != null ||
+    (isLinkStateResolved && isPersistedStateResolved);
 
-  if (!isLinkingReady) {
+  if (!isStateReady) {
     return (
       <LocaleDirContext.Provider value={direction}>
         <ThemeProvider value={theme}>{fallback}</ThemeProvider>
@@ -180,32 +234,35 @@ function NavigationContainerInner(
 
   return (
     <LocaleDirContext.Provider value={direction}>
-      <UnhandledLinkingContext.Provider value={unhandledLinkingContext}>
-        <LinkingContext.Provider value={linkingContext}>
-          <BaseNavigationContainer
-            {...rest}
-            theme={theme}
-            onReady={onReadyForLinkingHandling}
-            onStateChange={onStateChangeForLinkingHandling}
-            initialState={
-              rest.initialState == null ? initialState : rest.initialState
-            }
-            ref={refContainer}
-          />
-        </LinkingContext.Provider>
-      </UnhandledLinkingContext.Provider>
+      <LinkingContext.Provider value={linkingConfig}>
+        <BaseNavigationContainer
+          {...rest}
+          theme={theme}
+          initialState={
+            rest.initialState ??
+            initialStateFromLink ??
+            initialStateFromPersisted
+          }
+          onStateChange={(state) => {
+            onStateChange?.(state);
+            persistor?.persist(state);
+          }}
+          ref={refContainer}
+        />
+      </LinkingContext.Provider>
     </LocaleDirContext.Provider>
   );
 }
 
 /**
  * Container component that manages the navigation state.
+ *
  * This should be rendered at the root wrapping the whole app.
  */
 export const NavigationContainer = React.forwardRef(
   NavigationContainerInner
-) as <RootParamList extends {} = ReactNavigation.RootParamList>(
-  props: Props<RootParamList> & {
-    ref?: React.Ref<NavigationContainerRef<RootParamList>>;
+) as <ParamList extends {} = RootParamList>(
+  props: Props<ParamList> & {
+    ref?: React.Ref<NavigationContainerRef<ParamList>>;
   }
 ) => React.ReactElement;