react-router 7.9.6-pre.1 → 7.10.0-pre.0

package/dist/production/index.mjs

@@ -1,5 +1,5 @@
 /**
- * react-router v7.9.6-pre.1
+ * react-router v7.10.0-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -28,7 +28,7 @@ import {
   isSession,
   routeRSCServerRequest,
   setDevServerHooks
-} from "./chunk-LC2OWLJG.mjs";
+} from "./chunk-QKAGOFED.mjs";
 import {
   Action,
   Await,
@@ -139,7 +139,7 @@ import {
   withComponentProps,
   withErrorBoundaryProps,
   withHydrateFallbackProps
-} from "./chunk-LESYMMDQ.mjs";
+} from "./chunk-KJ5676BZ.mjs";
 export {
   Await,
   BrowserRouter,

package/dist/{development/instrumentation-Unc20tLk.d.ts → production/instrumentation-Dwf-sTWa.d.ts}

@@ -541,6 +541,8 @@ interface DataStrategyMatch extends AgnosticRouteMatch<string, AgnosticDataRoute
         route: Promise<void> | undefined;
     };
     /**
+     * @deprecated Deprecated in favor of `shouldCallHandler`
+     *
      * A boolean value indicating whether this route handler should be called in
      * this pass.
      *
@@ -566,8 +568,20 @@ interface DataStrategyMatch extends AgnosticRouteMatch<string, AgnosticDataRoute
      *    custom `shouldRevalidate` implementations)
      */
     shouldLoad: boolean;
-    unstable_shouldRevalidateArgs: ShouldRevalidateFunctionArgs | null;
-    unstable_shouldCallHandler(defaultShouldRevalidate?: boolean): boolean;
+    /**
+     * Arguments passed to the `shouldRevalidate` function for this `loader` execution.
+     * Will be `null` if this is not a revalidating loader {@link DataStrategyMatch}.
+     */
+    shouldRevalidateArgs: ShouldRevalidateFunctionArgs | null;
+    /**
+     * Determine if this route's handler should be called during this `dataStrategy`
+     * execution. Calling it with no arguments will leverage the default revalidation
+     * behavior. You can pass your own `defaultShouldRevalidate` value if you wish
+     * to change the default revalidation behavior with your `dataStrategy`.
+     *
+     * @param defaultShouldRevalidate `defaultShouldRevalidate` override value (optional)
+     */
+    shouldCallHandler(defaultShouldRevalidate?: boolean): boolean;
     /**
      * An async function that will resolve any `route.lazy` implementations and
      * execute the route's handler (if necessary), returning a {@link DataStrategyResult}
@@ -1015,7 +1029,8 @@ declare class ErrorResponseImpl implements ErrorResponse {
 /**
  * Check if the given error is an {@link ErrorResponse} generated from a 4xx/5xx
  * [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)
- * thrown from an [`action`](../../start/framework/route-module#action)/[`loader`](../../start/framework/route-module#loader)
+ * thrown from an [`action`](../../start/framework/route-module#action) or
+ * [`loader`](../../start/framework/route-module#loader) function.
  *
  * @example
  * import { isRouteErrorResponse } from "react-router";
@@ -1041,7 +1056,6 @@ declare class ErrorResponseImpl implements ErrorResponse {
  * @mode data
  * @param error The error to check.
  * @returns `true` if the error is an {@link ErrorResponse}, `false` otherwise.
- *
  */
 declare function isRouteErrorResponse(error: any): error is ErrorResponse;
 
@@ -1395,6 +1409,7 @@ type ViewTransitionOpts = {
 interface RouterSubscriber {
     (state: RouterState, opts: {
         deletedFetchers: string[];
+        newErrors: RouteData | null;
         viewTransitionOpts?: ViewTransitionOpts;
         flushSync: boolean;
     }): void;
@@ -1743,6 +1758,7 @@ interface unstable_ClientOnErrorFunction {
     (error: unknown, info: {
         location: Location;
         params: Params;
+        unstable_pattern: string;
         errorInfo?: React.ErrorInfo;
     }): void;
 }
@@ -1782,6 +1798,25 @@ interface RouterProviderProps {
      * ```
      */
     unstable_onError?: unstable_ClientOnErrorFunction;
+    /**
+     * Control whether router state updates are internally wrapped in
+     * [`React.startTransition`](https://react.dev/reference/react/startTransition).
+     *
+     * - When left `undefined`, all state updates are wrapped in
+     *   `React.startTransition`
+     *   - This can lead to buggy behaviors if you are wrapping your own
+     *     navigations/fetchers in `startTransition`.
+     * - When set to `true`, {@link Link} and {@link Form} navigations will be wrapped
+     *   in `React.startTransition` and router state changes will be wrapped in
+     *   `React.startTransition` and also sent through
+     *   [`useOptimistic`](https://react.dev/reference/react/useOptimistic) to
+     *   surface mid-navigation router state changes to the UI.
+     * - When set to `false`, the router will not leverage `React.startTransition` or
+     *   `React.useOptimistic` on any navigations or state changes.
+     *
+     * For more information, please see the [docs](https://reactrouter.com/explanation/react-transitions).
+     */
+    unstable_useTransitions?: boolean;
 }
 /**
  * Render the UI for the given {@link DataRouter}. This component should
@@ -1812,9 +1847,10 @@ interface RouterProviderProps {
  * @param {RouterProviderProps.flushSync} props.flushSync n/a
  * @param {RouterProviderProps.unstable_onError} props.unstable_onError n/a
  * @param {RouterProviderProps.router} props.router n/a
+ * @param {RouterProviderProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @returns React element for the rendered router
  */
-declare function RouterProvider({ router, flushSync: reactDomFlushSyncImpl, unstable_onError, }: RouterProviderProps): React.ReactElement;
+declare function RouterProvider({ router, flushSync: reactDomFlushSyncImpl, unstable_onError, unstable_useTransitions, }: RouterProviderProps): React.ReactElement;
 /**
  * @category Types
  */
@@ -1835,6 +1871,21 @@ interface MemoryRouterProps {
      * Index of `initialEntries` the application should initialize to
      */
     initialIndex?: number;
+    /**
+     * Control whether router state updates are internally wrapped in
+     * [`React.startTransition`](https://react.dev/reference/react/startTransition).
+     *
+     * - When left `undefined`, all router state updates are wrapped in
+     *   `React.startTransition`
+     * - When set to `true`, {@link Link} and {@link Form} navigations will be wrapped
+     *   in `React.startTransition` and all router state updates are wrapped in
+     *   `React.startTransition`
+     * - When set to `false`, the router will not leverage `React.startTransition`
+     *   on any navigations or state changes.
+     *
+     * For more information, please see the [docs](https://reactrouter.com/explanation/react-transitions).
+     */
+    unstable_useTransitions?: boolean;
 }
 /**
  * A declarative {@link Router | `<Router>`} that stores all entries in memory.
@@ -1847,10 +1898,11 @@ interface MemoryRouterProps {
  * @param {MemoryRouterProps.children} props.children n/a
  * @param {MemoryRouterProps.initialEntries} props.initialEntries n/a
  * @param {MemoryRouterProps.initialIndex} props.initialIndex n/a
+ * @param {MemoryRouterProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @returns A declarative in-memory {@link Router | `<Router>`} for client-side
  * routing.
  */
-declare function MemoryRouter({ basename, children, initialEntries, initialIndex, }: MemoryRouterProps): React.ReactElement;
+declare function MemoryRouter({ basename, children, initialEntries, initialIndex, unstable_useTransitions, }: MemoryRouterProps): React.ReactElement;
 /**
  * @category Types
  */
@@ -2203,6 +2255,10 @@ interface RouterProps {
      * will not be reactive to location changes.
      */
     static?: boolean;
+    /**
+     * Whether this router should wrap navigations in `React.startTransition()`
+     */
+    unstable_useTransitions: boolean;
 }
 /**
  * Provides location context for the rest of the app.
@@ -2221,10 +2277,11 @@ interface RouterProps {
  * @param {RouterProps.navigationType} props.navigationType n/a
  * @param {RouterProps.navigator} props.navigator n/a
  * @param {RouterProps.static} props.static n/a
+ * @param {RouterProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @returns React element for the rendered router or `null` if the location does
  * not match the {@link props.basename}
  */
-declare function Router({ basename: basenameProp, children, location: locationProp, navigationType, navigator, static: staticProp, }: RouterProps): React.ReactElement | null;
+declare function Router({ basename: basenameProp, children, location: locationProp, navigationType, navigator, static: staticProp, unstable_useTransitions, }: RouterProps): React.ReactElement | null;
 /**
  * @category Types
  */
@@ -2568,7 +2625,7 @@ interface DataRouteMatch extends RouteMatch<string, DataRouteObject> {
 }
 type PatchRoutesOnNavigationFunctionArgs = AgnosticPatchRoutesOnNavigationFunctionArgs<RouteObject, RouteMatch>;
 type PatchRoutesOnNavigationFunction = AgnosticPatchRoutesOnNavigationFunction<RouteObject, RouteMatch>;
-interface DataRouterContextObject extends Omit<NavigationContextObject, "future"> {
+interface DataRouterContextObject extends Omit<NavigationContextObject, "future" | "unstable_useTransitions"> {
     router: Router$1;
     staticContext?: StaticHandlerContext;
     unstable_onError?: unstable_ClientOnErrorFunction;
@@ -2622,6 +2679,7 @@ interface NavigationContextObject {
     basename: string;
     navigator: Navigator;
     static: boolean;
+    unstable_useTransitions: boolean;
     future: {};
 }
 declare const NavigationContext: React.Context<NavigationContextObject>;

package/dist/production/lib/types/internal.d.mts

@@ -1,5 +1,5 @@
-import { R as RouteModule, h as LinkDescriptor, L as Location, F as Func, i as Pretty, j as MetaDescriptor, G as GetLoaderData, k as ServerDataFunctionArgs, l as MiddlewareNextFunction, m as ClientDataFunctionArgs, D as DataStrategyResult, n as ServerDataFrom, N as Normalize, o as GetActionData } from '../../router-CAvh_Drx.mjs';
-import { R as RouteFiles, P as Pages } from '../../register-QkB3HGjm.mjs';
+import { R as RouteModule, h as LinkDescriptor, L as Location, F as Func, i as Pretty, j as MetaDescriptor, G as GetLoaderData, k as ServerDataFunctionArgs, l as MiddlewareNextFunction, m as ClientDataFunctionArgs, D as DataStrategyResult, n as ServerDataFrom, N as Normalize, o as GetActionData } from '../../router-Dgz_Mh9m.mjs';
+import { R as RouteFiles, P as Pages } from '../../register-C97Jz2jB.mjs';
 import 'react';
 
 type MaybePromise<T> = T | Promise<T>;

package/dist/production/lib/types/internal.d.ts

@@ -1,5 +1,5 @@
-import { R as RouteModule, f as LinkDescriptor, L as Location, F as Func, g as Pretty, h as MetaDescriptor, G as GetLoaderData, i as ServerDataFunctionArgs, j as MiddlewareNextFunction, k as ClientDataFunctionArgs, D as DataStrategyResult, l as ServerDataFrom, N as Normalize, m as GetActionData } from '../../instrumentation-Unc20tLk.js';
-import { R as RouteFiles, P as Pages } from '../../register-BpU9rFBJ.js';
+import { R as RouteModule, f as LinkDescriptor, L as Location, F as Func, g as Pretty, h as MetaDescriptor, G as GetLoaderData, i as ServerDataFunctionArgs, j as MiddlewareNextFunction, k as ClientDataFunctionArgs, D as DataStrategyResult, l as ServerDataFrom, N as Normalize, m as GetActionData } from '../../instrumentation-Dwf-sTWa.js';
+import { R as RouteFiles, P as Pages } from '../../register-BnQsYkwj.js';
 import 'react';
 
 type MaybePromise<T> = T | Promise<T>;

package/dist/production/lib/types/internal.js

@@ -1,5 +1,5 @@
 "use strict";/**
- * react-router v7.9.6-pre.1
+ * react-router v7.10.0-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/production/lib/types/internal.mjs

@@ -1,5 +1,5 @@
 /**
- * react-router v7.9.6-pre.1
+ * react-router v7.10.0-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/production/{register-BpU9rFBJ.d.ts → register-BnQsYkwj.d.ts}

@@ -1,4 +1,4 @@
-import { R as RouteModule } from './instrumentation-Unc20tLk.js';
+import { R as RouteModule } from './instrumentation-Dwf-sTWa.js';
 
 /**
  * Apps can use this interface to "register" app-wide types for React Router via interface declaration merging and module augmentation.

package/dist/production/{register-QkB3HGjm.d.mts → register-C97Jz2jB.d.mts}

@@ -1,4 +1,4 @@
-import { R as RouteModule } from './router-CAvh_Drx.mjs';
+import { R as RouteModule } from './router-Dgz_Mh9m.mjs';
 
 /**
  * Apps can use this interface to "register" app-wide types for React Router via interface declaration merging and module augmentation.

package/dist/production/{router-CAvh_Drx.d.mts → router-Dgz_Mh9m.d.mts}

@@ -541,6 +541,8 @@ interface DataStrategyMatch extends AgnosticRouteMatch<string, AgnosticDataRoute
         route: Promise<void> | undefined;
     };
     /**
+     * @deprecated Deprecated in favor of `shouldCallHandler`
+     *
      * A boolean value indicating whether this route handler should be called in
      * this pass.
      *
@@ -566,8 +568,20 @@ interface DataStrategyMatch extends AgnosticRouteMatch<string, AgnosticDataRoute
      *    custom `shouldRevalidate` implementations)
      */
     shouldLoad: boolean;
-    unstable_shouldRevalidateArgs: ShouldRevalidateFunctionArgs | null;
-    unstable_shouldCallHandler(defaultShouldRevalidate?: boolean): boolean;
+    /**
+     * Arguments passed to the `shouldRevalidate` function for this `loader` execution.
+     * Will be `null` if this is not a revalidating loader {@link DataStrategyMatch}.
+     */
+    shouldRevalidateArgs: ShouldRevalidateFunctionArgs | null;
+    /**
+     * Determine if this route's handler should be called during this `dataStrategy`
+     * execution. Calling it with no arguments will leverage the default revalidation
+     * behavior. You can pass your own `defaultShouldRevalidate` value if you wish
+     * to change the default revalidation behavior with your `dataStrategy`.
+     *
+     * @param defaultShouldRevalidate `defaultShouldRevalidate` override value (optional)
+     */
+    shouldCallHandler(defaultShouldRevalidate?: boolean): boolean;
     /**
      * An async function that will resolve any `route.lazy` implementations and
      * execute the route's handler (if necessary), returning a {@link DataStrategyResult}
@@ -1015,7 +1029,8 @@ declare class ErrorResponseImpl implements ErrorResponse {
 /**
  * Check if the given error is an {@link ErrorResponse} generated from a 4xx/5xx
  * [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)
- * thrown from an [`action`](../../start/framework/route-module#action)/[`loader`](../../start/framework/route-module#loader)
+ * thrown from an [`action`](../../start/framework/route-module#action) or
+ * [`loader`](../../start/framework/route-module#loader) function.
  *
  * @example
  * import { isRouteErrorResponse } from "react-router";
@@ -1041,7 +1056,6 @@ declare class ErrorResponseImpl implements ErrorResponse {
  * @mode data
  * @param error The error to check.
  * @returns `true` if the error is an {@link ErrorResponse}, `false` otherwise.
- *
  */
 declare function isRouteErrorResponse(error: any): error is ErrorResponse;
 
@@ -1181,6 +1195,7 @@ interface unstable_ClientOnErrorFunction {
     (error: unknown, info: {
         location: Location;
         params: Params;
+        unstable_pattern: string;
         errorInfo?: React.ErrorInfo;
     }): void;
 }
@@ -1220,6 +1235,25 @@ interface RouterProviderProps {
      * ```
      */
     unstable_onError?: unstable_ClientOnErrorFunction;
+    /**
+     * Control whether router state updates are internally wrapped in
+     * [`React.startTransition`](https://react.dev/reference/react/startTransition).
+     *
+     * - When left `undefined`, all state updates are wrapped in
+     *   `React.startTransition`
+     *   - This can lead to buggy behaviors if you are wrapping your own
+     *     navigations/fetchers in `startTransition`.
+     * - When set to `true`, {@link Link} and {@link Form} navigations will be wrapped
+     *   in `React.startTransition` and router state changes will be wrapped in
+     *   `React.startTransition` and also sent through
+     *   [`useOptimistic`](https://react.dev/reference/react/useOptimistic) to
+     *   surface mid-navigation router state changes to the UI.
+     * - When set to `false`, the router will not leverage `React.startTransition` or
+     *   `React.useOptimistic` on any navigations or state changes.
+     *
+     * For more information, please see the [docs](https://reactrouter.com/explanation/react-transitions).
+     */
+    unstable_useTransitions?: boolean;
 }
 /**
  * Render the UI for the given {@link DataRouter}. This component should
@@ -1250,9 +1284,10 @@ interface RouterProviderProps {
  * @param {RouterProviderProps.flushSync} props.flushSync n/a
  * @param {RouterProviderProps.unstable_onError} props.unstable_onError n/a
  * @param {RouterProviderProps.router} props.router n/a
+ * @param {RouterProviderProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @returns React element for the rendered router
  */
-declare function RouterProvider({ router, flushSync: reactDomFlushSyncImpl, unstable_onError, }: RouterProviderProps): React.ReactElement;
+declare function RouterProvider({ router, flushSync: reactDomFlushSyncImpl, unstable_onError, unstable_useTransitions, }: RouterProviderProps): React.ReactElement;
 /**
  * @category Types
  */
@@ -1273,6 +1308,21 @@ interface MemoryRouterProps {
      * Index of `initialEntries` the application should initialize to
      */
     initialIndex?: number;
+    /**
+     * Control whether router state updates are internally wrapped in
+     * [`React.startTransition`](https://react.dev/reference/react/startTransition).
+     *
+     * - When left `undefined`, all router state updates are wrapped in
+     *   `React.startTransition`
+     * - When set to `true`, {@link Link} and {@link Form} navigations will be wrapped
+     *   in `React.startTransition` and all router state updates are wrapped in
+     *   `React.startTransition`
+     * - When set to `false`, the router will not leverage `React.startTransition`
+     *   on any navigations or state changes.
+     *
+     * For more information, please see the [docs](https://reactrouter.com/explanation/react-transitions).
+     */
+    unstable_useTransitions?: boolean;
 }
 /**
  * A declarative {@link Router | `<Router>`} that stores all entries in memory.
@@ -1285,10 +1335,11 @@ interface MemoryRouterProps {
  * @param {MemoryRouterProps.children} props.children n/a
  * @param {MemoryRouterProps.initialEntries} props.initialEntries n/a
  * @param {MemoryRouterProps.initialIndex} props.initialIndex n/a
+ * @param {MemoryRouterProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @returns A declarative in-memory {@link Router | `<Router>`} for client-side
  * routing.
  */
-declare function MemoryRouter({ basename, children, initialEntries, initialIndex, }: MemoryRouterProps): React.ReactElement;
+declare function MemoryRouter({ basename, children, initialEntries, initialIndex, unstable_useTransitions, }: MemoryRouterProps): React.ReactElement;
 /**
  * @category Types
  */
@@ -1641,6 +1692,10 @@ interface RouterProps {
      * will not be reactive to location changes.
      */
     static?: boolean;
+    /**
+     * Whether this router should wrap navigations in `React.startTransition()`
+     */
+    unstable_useTransitions: boolean;
 }
 /**
  * Provides location context for the rest of the app.
@@ -1659,10 +1714,11 @@ interface RouterProps {
  * @param {RouterProps.navigationType} props.navigationType n/a
  * @param {RouterProps.navigator} props.navigator n/a
  * @param {RouterProps.static} props.static n/a
+ * @param {RouterProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @returns React element for the rendered router or `null` if the location does
  * not match the {@link props.basename}
  */
-declare function Router$1({ basename: basenameProp, children, location: locationProp, navigationType, navigator, static: staticProp, }: RouterProps): React.ReactElement | null;
+declare function Router$1({ basename: basenameProp, children, location: locationProp, navigationType, navigator, static: staticProp, unstable_useTransitions, }: RouterProps): React.ReactElement | null;
 /**
  * @category Types
  */
@@ -2006,7 +2062,7 @@ interface DataRouteMatch extends RouteMatch<string, DataRouteObject> {
 }
 type PatchRoutesOnNavigationFunctionArgs = AgnosticPatchRoutesOnNavigationFunctionArgs<RouteObject, RouteMatch>;
 type PatchRoutesOnNavigationFunction = AgnosticPatchRoutesOnNavigationFunction<RouteObject, RouteMatch>;
-interface DataRouterContextObject extends Omit<NavigationContextObject, "future"> {
+interface DataRouterContextObject extends Omit<NavigationContextObject, "future" | "unstable_useTransitions"> {
     router: Router;
     staticContext?: StaticHandlerContext;
     unstable_onError?: unstable_ClientOnErrorFunction;
@@ -2060,6 +2116,7 @@ interface NavigationContextObject {
     basename: string;
     navigator: Navigator;
     static: boolean;
+    unstable_useTransitions: boolean;
     future: {};
 }
 declare const NavigationContext: React.Context<NavigationContextObject>;
@@ -2966,6 +3023,7 @@ type ViewTransitionOpts = {
 interface RouterSubscriber {
     (state: RouterState, opts: {
         deletedFetchers: string[];
+        newErrors: RouteData | null;
         viewTransitionOpts?: ViewTransitionOpts;
         flushSync: boolean;
     }): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-router",
-  "version": "7.9.6-pre.1",
+  "version": "7.10.0-pre.0",
   "description": "Declarative routing for React",
   "keywords": [
     "react",