@react-navigation/native 7.0.0-alpha.1 → 7.0.0-alpha.11

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

@@ -1,22 +1,18 @@
-import { NavigationContainerRef, ParamListBase } from '@react-navigation/core';
+import { type NavigationContainerRef, type ParamListBase } from '@react-navigation/core';
 import * as React from 'react';
 import type { LinkingOptions } from './types';
+/**
+ * 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>>, { enabled, config, getStateFromPath, getPathFromState, getActionFromState, }: Options): {
+export declare function useLinking(ref: React.RefObject<NavigationContainerRef<ParamListBase>>, { enabled, config, getStateFromPath, getPathFromState, getActionFromState, }: Options, onUnhandledLinking: (lastUnhandledLining: string | undefined) => void): {
     getInitialState: () => PromiseLike<(Partial<Omit<Readonly<{
         key: string;
         index: number;
         routeNames: string[];
         history?: unknown[] | undefined;
-        routes: (Readonly<{
-            key: string;
-            name: string;
-            path?: string | undefined;
-        }> & Readonly<{
-            params?: Readonly<object | undefined>;
-        }> & {
-            state?: Readonly<any> | import("@react-navigation/core").PartialState<Readonly<any>> | undefined;
-        })[];
+        routes: import("@react-navigation/core").NavigationRoute<ParamListBase, string>[];
         type: string;
         stale: false;
     }>, "stale" | "routes">> & Readonly<{
@@ -28,15 +24,7 @@ export declare function useLinking(ref: React.RefObject<NavigationContainerRef<P
             index: number;
             routeNames: string[];
             history?: unknown[] | undefined;
-            routes: (Readonly<{
-                key: string;
-                name: string;
-                path?: string | undefined;
-            }> & Readonly<{
-                params?: Readonly<object | undefined>;
-            }> & {
-                state?: Readonly<any> | import("@react-navigation/core").PartialState<Readonly<any>> | undefined;
-            })[];
+            routes: import("@react-navigation/core").NavigationRoute<ParamListBase, string>[];
             type: string;
             stale: false;
         }>, "stale" | "routes">> & Readonly<{

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,EAKL,sBAAsB,EAEtB,aAAa,EAEd,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAiF9C,KAAK,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAE7C,wBAAgB,UAAU,CACxB,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC,EAC3D,EACE,OAAc,EACd,MAAM,EACN,gBAA0C,EAC1C,gBAA0C,EAC1C,kBAA8C,GAC/C,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwTX"}
+{"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;AA4C9C;;GAEG;AACH,eAAO,MAAM,MAAM,OAAQ,MAAM,QAAQ,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,CAAC,EAC3D,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;;;;;;;;;;;;;;;;;;;;;;;;;;EAgVtE"}

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

@@ -1,22 +1,14 @@
-import { NavigationContainerRef, 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 Options = LinkingOptions<ParamListBase>;
-export declare function useLinking(ref: React.RefObject<NavigationContainerRef<ParamListBase>>, { enabled, prefixes, filter, config, getInitialURL, subscribe, getStateFromPath, getActionFromState, }: Options): {
+export declare function useLinking(ref: React.RefObject<NavigationContainerRef<ParamListBase>>, { enabled, prefixes, filter, config, getInitialURL, subscribe, getStateFromPath, getActionFromState, }: Options, onUnhandledLinking: (lastUnhandledLining: string | undefined) => void): {
     getInitialState: () => PromiseLike<(Partial<Omit<Readonly<{
         key: string;
         index: number;
         routeNames: string[];
         history?: unknown[] | undefined;
-        routes: (Readonly<{
-            key: string;
-            name: string;
-            path?: string | undefined;
-        }> & Readonly<{
-            params?: Readonly<object | undefined>;
-        }> & {
-            state?: Readonly<any> | import("@react-navigation/core").PartialState<Readonly<any>> | undefined;
-        })[];
+        routes: import("@react-navigation/core").NavigationRoute<ParamListBase, string>[];
         type: string;
         stale: false;
     }>, "stale" | "routes">> & Readonly<{
@@ -28,15 +20,7 @@ export declare function useLinking(ref: React.RefObject<NavigationContainerRef<P
             index: number;
             routeNames: string[];
             history?: unknown[] | undefined;
-            routes: (Readonly<{
-                key: string;
-                name: string;
-                path?: string | undefined;
-            }> & Readonly<{
-                params?: Readonly<object | undefined>;
-            }> & {
-                state?: Readonly<any> | import("@react-navigation/core").PartialState<Readonly<any>> | undefined;
-            })[];
+            routes: import("@react-navigation/core").NavigationRoute<ParamListBase, string>[];
             type: string;
             stale: false;
         }>, "stale" | "routes">> & Readonly<{

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,sBAAsB,EACtB,aAAa,EAEd,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,CAAC,EAC3D,EACE,OAAc,EACd,QAAQ,EACR,MAAM,EACN,MAAM,EACN,aAQI,EACJ,SAmBC,EACD,gBAA0C,EAC1C,kBAA8C,GAC/C,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6JX"}
+{"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,CAAC,EAC3D,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;;;;;;;;;;;;;;;;;;;;;;;;;;EAkKtE"}

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

@@ -0,0 +1,7 @@
+/**
+ * Hook to access the text direction specified in the `NavigationContainer`.
+ */
+export declare function useLocale(): {
+    direction: import("./types").LocaleDirection;
+};
+//# sourceMappingURL=useLocale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLocale.d.ts","sourceRoot":"","sources":["../../../src/useLocale.tsx"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,SAAS;;EAUxB"}

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

@@ -1 +1 @@
-{"version":3,"file":"useScrollToTop.d.ts","sourceRoot":"","sources":["../../../src/useScrollToTop.tsx"],"names":[],"mappings":"AAMA,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,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GAC1E;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,CAAC;AA8BnB,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,QA+DrE"}
+{"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,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,GAC1E;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,CAAC;AA8BnB,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,QAoErE"}

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,4BAsC1D"}
+{"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"}

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

@@ -0,0 +1,7 @@
+import { type NavigationState, type PartialState } from '@react-navigation/core';
+export declare function UNSTABLE_useUnhandledLinking(): {
+    lastUnhandledLink: string | undefined;
+    getStateForRouteNamesChange: (currentState: NavigationState) => PartialState<NavigationState> | undefined;
+    clearUnhandledLink: () => void;
+};
+//# sourceMappingURL=useUnhandledLinking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUnhandledLinking.d.ts","sourceRoot":"","sources":["../../../src/useUnhandledLinking.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AA2BhC,wBAAgB,4BAA4B;;gDAU1B,eAAe,KAC5B,aAAa,eAAe,CAAC,GAAG,SAAS;;EA+C7C"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@react-navigation/native",
   "description": "React Native integration for React Navigation",
-  "version": "7.0.0-alpha.1",
+  "version": "7.0.0-alpha.11",
   "keywords": [
     "react-native",
     "react-navigation",
@@ -37,26 +37,26 @@
     "clean": "del lib"
   },
   "dependencies": {
-    "@react-navigation/core": "^7.0.0-alpha.1",
+    "@react-navigation/core": "^7.0.0-alpha.10",
     "escape-string-regexp": "^4.0.0",
     "fast-deep-equal": "^3.1.3",
-    "nanoid": "^3.1.23"
+    "nanoid": "3.3.7",
+    "use-latest-callback": "^0.1.9"
   },
   "devDependencies": {
-    "@testing-library/react-native": "^11.5.0",
-    "@types/react": "~18.0.26",
-    "@types/react-dom": "~18.0.9",
-    "@types/react-native": "~0.70.8",
-    "del-cli": "^5.0.0",
-    "react": "18.1.0",
+    "@testing-library/react-native": "^12.4.3",
+    "@types/react": "~18.2.45",
+    "@types/react-dom": "~18.0.11",
+    "del-cli": "^5.1.0",
+    "react": "18.2.0",
     "react-dom": "18.2.0",
-    "react-native": "0.70.5",
-    "react-native-builder-bob": "^0.20.4",
-    "typescript": "^4.9.4"
+    "react-native": "0.73.2",
+    "react-native-builder-bob": "^0.23.2",
+    "typescript": "^5.3.3"
   },
   "peerDependencies": {
-    "react": "*",
-    "react-native": "*"
+    "react": ">= 18.2.0",
+    "react-native": ">= 0.72.0"
   },
   "react-native-builder-bob": {
     "source": "src",
@@ -72,5 +72,5 @@
       ]
     ]
   },
-  "gitHead": "230c09deeeb886929a15cb4cdcb496372a9496e1"
+  "gitHead": "b407411496a2eaeeeb29b563d66294e79ae31311"
 }

package/src/Link.tsx

@@ -1,7 +1,13 @@
+import { useTheme } from '@react-navigation/core';
 import * as React from 'react';
-import { GestureResponderEvent, Platform, Text, TextProps } from 'react-native';
+import {
+  type GestureResponderEvent,
+  Platform,
+  Text,
+  type TextProps,
+} from 'react-native';
 
-import { Props as LinkProps, useLinkProps } from './useLinkProps';
+import { type Props as LinkProps, useLinkProps } from './useLinkProps';
 
 type Props<ParamList extends ReactNavigation.RootParamList> =
   LinkProps<ParamList> &
@@ -31,8 +37,10 @@ export function Link<ParamList extends ReactNavigation.RootParamList>({
   params,
   action,
   href,
+  style,
   ...rest
 }: Props<ParamList>) {
+  const { colors, fonts } = useTheme();
   // @ts-expect-error: This is already type-checked by the prop types
   const props = useLinkProps<ParamList>({ screen, params, action, href });
 
@@ -56,5 +64,6 @@ export function Link<ParamList extends ReactNavigation.RootParamList>({
       web: { onClick: onPress } as any,
       default: { onPress },
     }),
+    style: [{ color: colors.primary }, fonts.regular, style],
   });
 }

package/src/LinkingContext.tsx

@@ -3,8 +3,14 @@ import * as React from 'react';
 
 import type { LinkingOptions } from './types';
 
+const MISSING_CONTEXT_ERROR = "Couldn't find a LinkingContext context.";
+
 export const LinkingContext = React.createContext<{
-  options: LinkingOptions<ParamListBase> | undefined;
-}>({ options: undefined });
+  options?: LinkingOptions<ParamListBase>;
+}>({
+  get options(): any {
+    throw new Error(MISSING_CONTEXT_ERROR);
+  },
+});
 
 LinkingContext.displayName = 'LinkingContext';

package/src/LocaleDirContext.tsx

@@ -0,0 +1,7 @@
+import * as React from 'react';
+
+import type { LocaleDirection } from './types';
+
+export const LocaleDirContext = React.createContext<LocaleDirection>('ltr');
+
+LocaleDirContext.displayName = 'LocaleDirContext';

package/src/NavigationContainer.tsx

@@ -3,23 +3,32 @@ import {
   getActionFromState,
   getPathFromState,
   getStateFromPath,
-  NavigationContainerProps,
-  NavigationContainerRef,
-  ParamListBase,
+  type NavigationContainerProps,
+  type NavigationContainerRef,
+  type NavigationState,
+  type ParamListBase,
   validatePathConfig,
 } from '@react-navigation/core';
 import * as React from 'react';
+import { I18nManager } from 'react-native';
+import useLatestCallback from 'use-latest-callback';
 
 import { LinkingContext } from './LinkingContext';
+import { LocaleDirContext } from './LocaleDirContext';
 import { DefaultTheme } from './theming/DefaultTheme';
-import { ThemeProvider } from './theming/ThemeProvider';
-import type { DocumentTitleOptions, LinkingOptions, Theme } from './types';
+import type {
+  DocumentTitleOptions,
+  LinkingOptions,
+  LocaleDirection,
+} from './types';
+import { UnhandledLinkingContext } from './UnhandledLinkingContext';
 import { useBackButton } from './useBackButton';
 import { useDocumentTitle } from './useDocumentTitle';
 import { useLinking } from './useLinking';
 import { useThenable } from './useThenable';
 
 declare global {
+  // eslint-disable-next-line no-var
   var REACT_NAVIGATION_DEVTOOLS: WeakMap<
     NavigationContainerRef<any>,
     { readonly linking: LinkingOptions<any> }
@@ -29,7 +38,7 @@ declare global {
 global.REACT_NAVIGATION_DEVTOOLS = new WeakMap();
 
 type Props<ParamList extends {}> = NavigationContainerProps & {
-  theme?: Theme;
+  direction?: LocaleDirection;
   linking?: LinkingOptions<ParamList>;
   fallback?: React.ReactNode;
   documentTitle?: DocumentTitleOptions;
@@ -43,7 +52,8 @@ type Props<ParamList extends {}> = NavigationContainerProps & {
  * @param props.onReady Callback which is called after the navigation tree mounts.
  * @param props.onStateChange Callback which is called with the latest navigation state when it changes.
  * @param props.onUnhandledAction Callback which is called when an action is not handled.
- * @param props.theme Theme object for the navigators.
+ * @param props.direction Text direction of the components. Defaults to `'ltr'`.
+ * @param props.theme Theme object for the UI elements.
  * @param props.linking Options for deep linking. Deep link handling is enabled when this prop is provided, unless `linking.enabled` is `false`.
  * @param props.fallback Fallback component to render until we have finished getting initial state when linking is enabled. Defaults to `null`.
  * @param props.documentTitle Options to configure the document title on Web. Updating document title is handled by default unless `documentTitle.enabled` is `false`.
@@ -52,10 +62,13 @@ type Props<ParamList extends {}> = NavigationContainerProps & {
  */
 function NavigationContainerInner(
   {
+    direction = I18nManager.getConstants().isRTL ? 'rtl' : 'ltr',
     theme = DefaultTheme,
     linking,
     fallback = null,
     documentTitle,
+    onReady,
+    onStateChange,
     ...rest
   }: Props<ParamListBase>,
   ref?: React.Ref<NavigationContainerRef<ParamListBase> | null>
@@ -72,12 +85,52 @@ function NavigationContainerInner(
   useBackButton(refContainer);
   useDocumentTitle(refContainer, documentTitle);
 
-  const { getInitialState } = useLinking(refContainer, {
-    enabled: isLinkingEnabled,
-    prefixes: [],
-    ...linking,
+  const [lastUnhandledLink, setLastUnhandledLink] = React.useState<
+    string | undefined
+  >();
+
+  const { getInitialState } = useLinking(
+    refContainer,
+    {
+      enabled: isLinkingEnabled,
+      prefixes: [],
+      ...linking,
+    },
+    setLastUnhandledLink
+  );
+
+  const linkingContext = React.useMemo(() => ({ options: linking }), [linking]);
+
+  const unhandledLinkingContext = React.useMemo(
+    () => ({ lastUnhandledLink, setLastUnhandledLink }),
+    [lastUnhandledLink, setLastUnhandledLink]
+  );
+
+  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 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(() => {
@@ -102,8 +155,6 @@ function NavigationContainerInner(
 
   React.useImperativeHandle(ref, () => refContainer.current);
 
-  const linkingContext = React.useMemo(() => ({ options: linking }), [linking]);
-
   const isLinkingReady =
     rest.initialState != null || !isLinkingEnabled || isResolved;
 
@@ -114,17 +165,22 @@ function NavigationContainerInner(
   }
 
   return (
-    <LinkingContext.Provider value={linkingContext}>
-      <ThemeProvider value={theme}>
-        <BaseNavigationContainer
-          {...rest}
-          initialState={
-            rest.initialState == null ? initialState : rest.initialState
-          }
-          ref={refContainer}
-        />
-      </ThemeProvider>
-    </LinkingContext.Provider>
+    <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>
+    </LocaleDirContext.Provider>
   );
 }
 

package/src/ServerContainer.tsx

@@ -1,7 +1,7 @@
 import { CurrentRenderContext } from '@react-navigation/core';
 import * as React from 'react';
 
-import { ServerContext, ServerContextType } from './ServerContext';
+import { ServerContext, type ServerContextType } from './ServerContext';
 import type { ServerContainerRef } from './types';
 
 type Props = ServerContextType & {

package/src/UnhandledLinkingContext.tsx

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+const MISSING_CONTEXT_ERROR =
+  "Couldn't find an UnhandledLinkingContext context.";
+
+export const UnhandledLinkingContext = React.createContext<{
+  lastUnhandledLink: string | undefined;
+  setLastUnhandledLink: (lastUnhandledUrl: string | undefined) => void;
+}>({
+  get lastUnhandledLink(): any {
+    throw new Error(MISSING_CONTEXT_ERROR);
+  },
+  get setLastUnhandledLink(): any {
+    throw new Error(MISSING_CONTEXT_ERROR);
+  },
+});
+
+UnhandledLinkingContext.displayName = 'UnhandledLinkingContext';

package/src/{__mocks__ → __stubs__}/window.tsx

@@ -1,4 +1,4 @@
-const location = new URL('', 'http://example.com');
+let location = new URL('', 'http://example.com');
 
 let listeners: (() => void)[] = [];
 let entries = [{ state: null, href: location.href }];
@@ -12,7 +12,7 @@ const history = {
   },
 
   pushState(state: any, _: string, path: string) {
-    Object.assign(location, new URL(path, location.origin));
+    location = new URL(path, location.origin);
 
     currentState = state;
     entries = entries.slice(0, index + 1);
@@ -21,7 +21,7 @@ const history = {
   },
 
   replaceState(state: any, _: string, path: string) {
-    Object.assign(location, new URL(path, location.origin));
+    location = new URL(path, location.origin);
 
     currentState = state;
     entries[index] = { state, href: location.href };
@@ -35,7 +35,7 @@ const history = {
       ) {
         index += n;
         const entry = entries[index];
-        Object.assign(location, new URL(entry.href));
+        location = new URL(entry.href);
         currentState = entry.state;
         listeners.forEach((cb) => cb());
       }
@@ -65,7 +65,9 @@ const removeEventListener = (type: 'popstate', listener: () => void) => {
 
 export const window = {
   document: { title: '' },
-  location,
+  get location() {
+    return location;
+  },
   history,
   addEventListener,
   removeEventListener,

package/src/createStaticNavigation.tsx

@@ -1,8 +1,9 @@
 import {
   createComponentForStaticNavigation,
   createPathConfigForStaticNavigation,
-  ParamListBase,
-  StaticNavigation,
+  type NavigationContainerRef,
+  type ParamListBase,
+  type StaticNavigation,
 } from '@react-navigation/core';
 import * as React from 'react';
 
@@ -34,14 +35,20 @@ export function createStaticNavigation(tree: StaticNavigation<any, any, any>) {
       : {},
   };
 
-  return function Navigation({ linking, ...rest }: Props) {
+  function Navigation(
+    { linking, ...rest }: Props,
+    ref: React.Ref<NavigationContainerRef<ParamListBase>>
+  ) {
     return (
       <NavigationContainer
         {...rest}
+        ref={ref}
         linking={linking ? { ...linking, config: linkingConfig } : undefined}
       >
         <Component />
       </NavigationContainer>
     );
-  };
+  }
+
+  return React.forwardRef(Navigation);
 }

package/src/extractPathFromURL.tsx

@@ -15,7 +15,10 @@ export function extractPathFromURL(prefixes: string[], url: string) {
         .join('\\.')}`
     );
 
-    const normalizedURL = url.replace(/\/+/g, '/');
+    const [originAndPath, searchParams] = url.split('?');
+    const normalizedURL = originAndPath
+      .replace(/\/+/g, '/')
+      .concat(searchParams ? `?${searchParams}` : '');
 
     if (prefixRegex.test(normalizedURL)) {
       return normalizedURL.replace(prefixRegex, '');

package/src/index.tsx

@@ -5,10 +5,10 @@ export { NavigationContainer } from './NavigationContainer';
 export { ServerContainer } from './ServerContainer';
 export { DarkTheme } from './theming/DarkTheme';
 export { DefaultTheme } from './theming/DefaultTheme';
-export { ThemeProvider } from './theming/ThemeProvider';
-export { useTheme } from './theming/useTheme';
 export * from './types';
+export { useLinkBuilder } from './useLinkBuilder';
 export { useLinkProps } from './useLinkProps';
-export { useLinkTools } from './useLinkTools';
+export { useLocale } from './useLocale';
 export { useScrollToTop } from './useScrollToTop';
+export { UNSTABLE_useUnhandledLinking } from './useUnhandledLinking';
 export * from '@react-navigation/core';

package/src/types.tsx

@@ -6,6 +6,31 @@ import type {
   Route,
 } from '@react-navigation/core';
 
+declare global {
+  // eslint-disable-next-line @typescript-eslint/no-namespace
+  namespace ReactNavigation {
+    interface Theme {
+      dark: boolean;
+      colors: {
+        primary: string;
+        background: string;
+        card: string;
+        text: string;
+        border: string;
+        notification: string;
+      };
+      fonts: {
+        regular: FontStyle;
+        medium: FontStyle;
+        bold: FontStyle;
+        heavy: FontStyle;
+      };
+    }
+  }
+}
+
+export type LocaleDirection = 'ltr' | 'rtl';
+
 type FontStyle = {
   fontFamily: string;
   fontWeight:
@@ -22,23 +47,7 @@ type FontStyle = {
     | '900';
 };
 
-export type Theme = {
-  dark: boolean;
-  colors: {
-    primary: string;
-    background: string;
-    card: string;
-    text: string;
-    border: string;
-    notification: string;
-  };
-  fonts: {
-    regular: FontStyle;
-    medium: FontStyle;
-    bold: FontStyle;
-    heavy: FontStyle;
-  };
-};
+export type Theme = ReactNavigation.Theme;
 
 export type LinkingOptions<ParamList extends {}> = {
   /**
@@ -96,8 +105,21 @@ export type LinkingOptions<ParamList extends {}> = {
    * ```
    */
   config?: {
-    initialRouteName?: keyof ParamList;
+    /**
+     * Path string to match against for the whole navigation tree.
+     * It's not possible to specify params here since this doesn't belong to a screen.
+     * This is useful when the whole app is under a specific path.
+     * e.g. all of the screens are under `/admin` in `https://example.com/admin`
+     */
+    path?: string;
+    /**
+     * Path configuration for child screens.
+     */
     screens: PathConfigMap<ParamList>;
+    /**
+     * Name of the initial route to use for the root navigator.
+     */
+    initialRouteName?: keyof ParamList;
   };
   /**
    * Custom function to get the initial URL used for linking.