react-router 7.9.6 → 7.10.0-pre.1

package/dist/development/{index-react-server-client-rcoGPJhU.d.mts → index-react-server-client-CipGfVBI.d.mts}

@@ -1,4 +1,4 @@
-import { bE as RouteManifest, q as RouteModules, W as HydrationState, a3 as DataRouteObject, a as ClientLoaderFunction, a7 as StaticHandlerContext, bF as ServerRouteModule, s as MiddlewareEnabled, c as RouterContextProvider, t as AppLoadContext, an as LoaderFunctionArgs, ae as ActionFunctionArgs, aw as unstable_ServerInstrumentation, al as HTMLFormMethod, aj as FormEncType, y as RelativeRoutingType, bh as PageLinkDescriptor, T as To, bG as History, a6 as GetScrollRestorationKeyFunction, e as RouterInit, bH as FutureConfig$1, u as unstable_ClientInstrumentation, r as DataStrategyFunction, a2 as PatchRoutesOnNavigationFunction, v as NavigateOptions, a8 as Fetcher, Q as RouteObject, p as Router, x as SerializeFrom, B as BlockerFunction, L as Location, bI as CreateStaticHandlerOptions$1, a4 as StaticHandler } from './router-CAvh_Drx.mjs';
+import { bE as RouteManifest, q as RouteModules, W as HydrationState, a3 as DataRouteObject, a as ClientLoaderFunction, a7 as StaticHandlerContext, bF as ServerRouteModule, s as MiddlewareEnabled, c as RouterContextProvider, t as AppLoadContext, an as LoaderFunctionArgs, ae as ActionFunctionArgs, aw as unstable_ServerInstrumentation, al as HTMLFormMethod, aj as FormEncType, y as RelativeRoutingType, bh as PageLinkDescriptor, T as To, bG as History, a6 as GetScrollRestorationKeyFunction, e as RouterInit, bH as FutureConfig$1, u as unstable_ClientInstrumentation, r as DataStrategyFunction, a2 as PatchRoutesOnNavigationFunction, v as NavigateOptions, a8 as Fetcher, Q as RouteObject, p as Router, x as SerializeFrom, B as BlockerFunction, L as Location, bI as CreateStaticHandlerOptions$1, a4 as StaticHandler } from './router-CwNp5l9u.mjs';
 import * as React from 'react';
 
 interface Route {
@@ -536,7 +536,7 @@ interface DOMRouterOpts {
      * added routes via `route.lazy` or `patchRoutesOnNavigation`).  This is
      * mostly useful for observability such as wrapping navigations, fetches,
      * as well as route loaders/actions/middlewares with logging and/or performance
-     * tracing.
+     * tracing.  See the [docs](../../how-to/instrumentation) for more information.
      *
      * ```tsx
      * let router = createBrowserRouter(routes, {
@@ -580,189 +580,32 @@ interface DOMRouterOpts {
      */
     unstable_instrumentations?: unstable_ClientInstrumentation[];
     /**
-     * Override the default data strategy of running loaders in parallel.
-     * See {@link DataStrategyFunction}.
-     *
-     * <docs-warning>This is a low-level API intended for advanced use-cases. This
-     * overrides React Router's internal handling of
-     * [`action`](../../start/data/route-object#action)/[`loader`](../../start/data/route-object#loader)
-     * execution, and if done incorrectly will break your app code. Please use
-     * with caution and perform the appropriate testing.</docs-warning>
-     *
-     * By default, React Router is opinionated about how your data is loaded/submitted -
-     * and most notably, executes all of your [`loader`](../../start/data/route-object#loader)s
-     * in parallel for optimal data fetching. While we think this is the right
-     * behavior for most use-cases, we realize that there is no "one size fits all"
-     * solution when it comes to data fetching for the wide landscape of
-     * application requirements.
-     *
-     * The `dataStrategy` option gives you full control over how your [`action`](../../start/data/route-object#action)s
-     * and [`loader`](../../start/data/route-object#loader)s are executed and lays
-     * the foundation to build in more advanced APIs such as middleware, context,
-     * and caching layers. Over time, we expect that we'll leverage this API
-     * internally to bring more first class APIs to React Router, but until then
-     * (and beyond), this is your way to add more advanced functionality for your
-     * application's data needs.
-     *
-     * The `dataStrategy` function should return a key/value-object of
-     * `routeId` -> {@link DataStrategyResult} and should include entries for any
-     * routes where a handler was executed. A `DataStrategyResult` indicates if
-     * the handler was successful or not based on the `DataStrategyResult.type`
-     * field. If the returned `DataStrategyResult.result` is a [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response),
-     * React Router will unwrap it for you (via [`res.json`](https://developer.mozilla.org/en-US/docs/Web/API/Response/json)
-     * or [`res.text`](https://developer.mozilla.org/en-US/docs/Web/API/Response/text)).
-     * If you need to do custom decoding of a [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)
-     * but want to preserve the status code, you can use the `data` utility to
-     * return your decoded data along with a `ResponseInit`.
-     *
-     * <details>
-     * <summary><b>Example <code>dataStrategy</code> Use Cases</b></summary>
-     *
-     * **Adding logging**
-     *
-     * In the simplest case, let's look at hooking into this API to add some logging
-     * for when our route [`action`](../../start/data/route-object#action)s/[`loader`](../../start/data/route-object#loader)s
-     * execute:
+     * Override the default data strategy of running loaders in parallel -
+     * see the [docs](../../how-to/data-strategy) for more information.
      *
      * ```tsx
      * let router = createBrowserRouter(routes, {
-     *   async dataStrategy({ matches, request }) {
-     *     const matchesToLoad = matches.filter((m) => m.shouldLoad);
-     *     const results: Record<string, DataStrategyResult> = {};
-     *     await Promise.all(
-     *       matchesToLoad.map(async (match) => {
-     *         console.log(`Processing ${match.route.id}`);
-     *         results[match.route.id] = await match.resolve();;
-     *       })
+     *   async dataStrategy({
+     *     matches,
+     *     request,
+     *     runClientMiddleware,
+     *   }) {
+     *     const matchesToLoad = matches.filter((m) =>
+     *       m.shouldCallHandler(),
      *     );
-     *     return results;
-     *   },
-     * });
-     * ```
-     *
-     * **Middleware**
-     *
-     * Let's define a middleware on each route via [`handle`](../../start/data/route-object#handle)
-     * and call middleware sequentially first, then call all
-     * [`loader`](../../start/data/route-object#loader)s in parallel - providing
-     * any data made available via the middleware:
-     *
-     * ```ts
-     * const routes = [
-     *   {
-     *     id: "parent",
-     *     path: "/parent",
-     *     loader({ request }, context) {
-     *        // ...
-     *     },
-     *     handle: {
-     *       async middleware({ request }, context) {
-     *         context.parent = "PARENT MIDDLEWARE";
-     *       },
-     *     },
-     *     children: [
-     *       {
-     *         id: "child",
-     *         path: "child",
-     *         loader({ request }, context) {
-     *           // ...
-     *         },
-     *         handle: {
-     *           async middleware({ request }, context) {
-     *             context.child = "CHILD MIDDLEWARE";
-     *           },
-     *         },
-     *       },
-     *     ],
-     *   },
-     * ];
      *
-     * let router = createBrowserRouter(routes, {
-     *   async dataStrategy({ matches, params, request }) {
-     *     // Run middleware sequentially and let them add data to `context`
-     *     let context = {};
-     *     for (const match of matches) {
-     *       if (match.route.handle?.middleware) {
-     *         await match.route.handle.middleware(
-     *           { request, params },
-     *           context
-     *         );
-     *       }
-     *     }
-     *
-     *     // Run loaders in parallel with the `context` value
-     *     let matchesToLoad = matches.filter((m) => m.shouldLoad);
-     *     let results = await Promise.all(
-     *       matchesToLoad.map((match, i) =>
-     *         match.resolve((handler) => {
-     *           // Whatever you pass to `handler` will be passed as the 2nd parameter
-     *           // to your loader/action
-     *           return handler(context);
-     *         })
-     *       )
-     *     );
-     *     return results.reduce(
-     *       (acc, result, i) =>
-     *         Object.assign(acc, {
-     *           [matchesToLoad[i].route.id]: result,
+     *     const results: Record<string, DataStrategyResult> = {};
+     *     await runClientMiddleware(() =>
+     *       Promise.all(
+     *         matchesToLoad.map(async (match) => {
+     *           results[match.route.id] = await match.resolve();
      *         }),
-     *       {}
+     *       ),
      *     );
-     *   },
-     * });
-     * ```
-     *
-     * **Custom Handler**
-     *
-     * It's also possible you don't even want to define a [`loader`](../../start/data/route-object#loader)
-     * implementation at the route level. Maybe you want to just determine the
-     * routes and issue a single GraphQL request for all of your data? You can do
-     * that by setting your `route.loader=true` so it qualifies as "having a
-     * loader", and then store GQL fragments on `route.handle`:
-     *
-     * ```ts
-     * const routes = [
-     *   {
-     *     id: "parent",
-     *     path: "/parent",
-     *     loader: true,
-     *     handle: {
-     *       gql: gql`
-     *         fragment Parent on Whatever {
-     *           parentField
-     *         }
-     *       `,
-     *     },
-     *     children: [
-     *       {
-     *         id: "child",
-     *         path: "child",
-     *         loader: true,
-     *         handle: {
-     *           gql: gql`
-     *             fragment Child on Whatever {
-     *               childField
-     *             }
-     *           `,
-     *         },
-     *       },
-     *     ],
-     *   },
-     * ];
-     *
-     * let router = createBrowserRouter(routes, {
-     *   async dataStrategy({ matches, params, request }) {
-     *     // Compose route fragments into a single GQL payload
-     *     let gql = getFragmentsFromRouteHandles(matches);
-     *     let data = await fetchGql(gql);
-     *     // Parse results back out into individual route level `DataStrategyResult`'s
-     *     // keyed by `routeId`
-     *     let results = parseResultsFromGql(data);
      *     return results;
      *   },
      * });
      * ```
-     *</details>
      */
     dataStrategy?: DataStrategyFunction;
     /**
@@ -1122,6 +965,21 @@ interface BrowserRouterProps {
      * {@link Route | `<Route>`} components describing your route configuration
      */
     children?: React.ReactNode;
+    /**
+     * 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;
     /**
      * [`Window`](https://developer.mozilla.org/en-US/docs/Web/API/Window) object
      * override. Defaults to the global `window` instance
@@ -1138,11 +996,12 @@ interface BrowserRouterProps {
  * @param props Props
  * @param {BrowserRouterProps.basename} props.basename n/a
  * @param {BrowserRouterProps.children} props.children n/a
+ * @param {BrowserRouterProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @param {BrowserRouterProps.window} props.window n/a
  * @returns A declarative {@link Router | `<Router>`} using the browser [`History`](https://developer.mozilla.org/en-US/docs/Web/API/History)
  * API for client-side routing.
  */
-declare function BrowserRouter({ basename, children, window, }: BrowserRouterProps): React.JSX.Element;
+declare function BrowserRouter({ basename, children, unstable_useTransitions, window, }: BrowserRouterProps): React.JSX.Element;
 /**
  * @category Types
  */
@@ -1155,6 +1014,21 @@ interface HashRouterProps {
      * {@link Route | `<Route>`} components describing your route configuration
      */
     children?: React.ReactNode;
+    /**
+     * 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;
     /**
      * [`Window`](https://developer.mozilla.org/en-US/docs/Web/API/Window) object
      * override. Defaults to the global `window` instance
@@ -1172,11 +1046,12 @@ interface HashRouterProps {
  * @param props Props
  * @param {HashRouterProps.basename} props.basename n/a
  * @param {HashRouterProps.children} props.children n/a
+ * @param {HashRouterProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @param {HashRouterProps.window} props.window n/a
  * @returns A declarative {@link Router | `<Router>`} using the URL [`hash`](https://developer.mozilla.org/en-US/docs/Web/API/URL/hash)
  * for client-side routing.
  */
-declare function HashRouter({ basename, children, window }: HashRouterProps): React.JSX.Element;
+declare function HashRouter({ basename, children, unstable_useTransitions, window, }: HashRouterProps): React.JSX.Element;
 /**
  * @category Types
  */
@@ -1193,6 +1068,21 @@ interface HistoryRouterProps {
      *  A {@link History} implementation for use by the router
      */
     history: History;
+    /**
+     * 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 accepts a pre-instantiated
@@ -1209,10 +1099,11 @@ interface HistoryRouterProps {
  * @param {HistoryRouterProps.basename} props.basename n/a
  * @param {HistoryRouterProps.children} props.children n/a
  * @param {HistoryRouterProps.history} props.history n/a
+ * @param {HistoryRouterProps.unstable_useTransitions} props.unstable_useTransitions n/a
  * @returns A declarative {@link Router | `<Router>`} using the provided history
  * implementation for client-side routing.
  */
-declare function HistoryRouter({ basename, children, history, }: HistoryRouterProps): React.JSX.Element;
+declare function HistoryRouter({ basename, children, history, unstable_useTransitions, }: HistoryRouterProps): React.JSX.Element;
 declare namespace HistoryRouter {
     var displayName: string;
 }
@@ -1830,15 +1721,19 @@ declare namespace ScrollRestoration {
  * @param options.viewTransition Enables a [View Transition](https://developer.mozilla.org/en-US/docs/Web/API/View_Transitions_API)
  * for this navigation. To apply specific styles during the transition, see
  * {@link useViewTransitionState}. Defaults to `false`.
+ * @param options.unstable_useTransitions Wraps the navigation in
+ * [`React.startTransition`](https://react.dev/reference/react/startTransition)
+ * for concurrent rendering. Defaults to `false`.
  * @returns A click handler function that can be used in a custom {@link Link} component.
  */
-declare function useLinkClickHandler<E extends Element = HTMLAnchorElement>(to: To, { target, replace: replaceProp, state, preventScrollReset, relative, viewTransition, }?: {
+declare function useLinkClickHandler<E extends Element = HTMLAnchorElement>(to: To, { target, replace: replaceProp, state, preventScrollReset, relative, viewTransition, unstable_useTransitions, }?: {
     target?: React.HTMLAttributeAnchorTarget;
     replace?: boolean;
     state?: any;
     preventScrollReset?: boolean;
     relative?: RelativeRoutingType;
     viewTransition?: boolean;
+    unstable_useTransitions?: boolean;
 }): (event: React.MouseEvent<E, MouseEvent>) => void;
 /**
  * Returns a tuple of the current URL's [`URLSearchParams`](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams)
@@ -2167,7 +2062,7 @@ type FetcherWithComponents<TData> = Fetcher<TData> & {
      * @param reason Optional `reason` to provide to [`AbortController.abort()`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort)
      * @returns void
      */
-    unstable_reset: (opts?: {
+    reset: (opts?: {
         reason?: unknown;
     }) => void;
     /**
@@ -2256,7 +2151,7 @@ type FetcherWithComponents<TData> = Fetcher<TData> & {
  *   })
  *
  *   // reset fetcher
- *   fetcher.unstable_reset()
+ *   fetcher.reset()
  * }
  *
  * @public

package/dist/development/index-react-server-client.d.mts

@@ -1,3 +1,3 @@
-export { b2 as MemoryRouter, b3 as Navigate, b4 as Outlet, b5 as Route, b6 as Router, b7 as RouterProvider, b8 as Routes, aR as UNSAFE_AwaitContextProvider, by as UNSAFE_WithComponentProps, bC as UNSAFE_WithErrorBoundaryProps, bA as UNSAFE_WithHydrateFallbackProps } from './router-CAvh_Drx.mjs';
-export { l as BrowserRouter, q as Form, m as HashRouter, n as Link, X as Links, W as Meta, p as NavLink, r as ScrollRestoration, T as StaticRouter, V as StaticRouterProvider, o as unstable_HistoryRouter } from './index-react-server-client-rcoGPJhU.mjs';
+export { b2 as MemoryRouter, b3 as Navigate, b4 as Outlet, b5 as Route, b6 as Router, b7 as RouterProvider, b8 as Routes, aR as UNSAFE_AwaitContextProvider, by as UNSAFE_WithComponentProps, bC as UNSAFE_WithErrorBoundaryProps, bA as UNSAFE_WithHydrateFallbackProps } from './router-CwNp5l9u.mjs';
+export { l as BrowserRouter, q as Form, m as HashRouter, n as Link, X as Links, W as Meta, p as NavLink, r as ScrollRestoration, T as StaticRouter, V as StaticRouterProvider, o as unstable_HistoryRouter } from './index-react-server-client-CipGfVBI.mjs';
 import 'react';

package/dist/development/index-react-server-client.d.ts

@@ -1,3 +1,3 @@
-export { b2 as MemoryRouter, b3 as Navigate, b4 as Outlet, b5 as Route, b6 as Router, b7 as RouterProvider, b8 as Routes, aP as UNSAFE_AwaitContextProvider, by as UNSAFE_WithComponentProps, bC as UNSAFE_WithErrorBoundaryProps, bA as UNSAFE_WithHydrateFallbackProps } from './instrumentation-Unc20tLk.js';
-export { l as BrowserRouter, q as Form, m as HashRouter, n as Link, X as Links, W as Meta, p as NavLink, r as ScrollRestoration, T as StaticRouter, V as StaticRouterProvider, o as unstable_HistoryRouter } from './index-react-server-client-Da3kmxNd.js';
+export { b2 as MemoryRouter, b3 as Navigate, b4 as Outlet, b5 as Route, b6 as Router, b7 as RouterProvider, b8 as Routes, aP as UNSAFE_AwaitContextProvider, by as UNSAFE_WithComponentProps, bC as UNSAFE_WithErrorBoundaryProps, bA as UNSAFE_WithHydrateFallbackProps } from './instrumentation-BB0wRuqz.js';
+export { l as BrowserRouter, q as Form, m as HashRouter, n as Link, X as Links, W as Meta, p as NavLink, r as ScrollRestoration, T as StaticRouter, V as StaticRouterProvider, o as unstable_HistoryRouter } from './index-react-server-client-CCjKYJTH.js';
 import 'react';

package/dist/development/index-react-server-client.js

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});/**
- * react-router v7.9.6
+ * react-router v7.10.0-pre.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -19,7 +19,7 @@
 
 
 
-var _chunkO4JVZSOYjs = require('./chunk-O4JVZSOY.js');
+var _chunkXHWAND4Xjs = require('./chunk-XHWAND4X.js');
 
 
 
@@ -34,7 +34,7 @@ var _chunkO4JVZSOYjs = require('./chunk-O4JVZSOY.js');
 
 
 
-var _chunkAMVS5XVJjs = require('./chunk-AMVS5XVJ.js');
+var _chunkKQLPIZ7Ejs = require('./chunk-KQLPIZ7E.js');
 
 
 
@@ -58,4 +58,4 @@ var _chunkAMVS5XVJjs = require('./chunk-AMVS5XVJ.js');
 
 
 
-exports.BrowserRouter = _chunkO4JVZSOYjs.BrowserRouter; exports.Form = _chunkO4JVZSOYjs.Form; exports.HashRouter = _chunkO4JVZSOYjs.HashRouter; exports.Link = _chunkO4JVZSOYjs.Link; exports.Links = _chunkAMVS5XVJjs.Links; exports.MemoryRouter = _chunkAMVS5XVJjs.MemoryRouter; exports.Meta = _chunkAMVS5XVJjs.Meta; exports.NavLink = _chunkO4JVZSOYjs.NavLink; exports.Navigate = _chunkAMVS5XVJjs.Navigate; exports.Outlet = _chunkAMVS5XVJjs.Outlet; exports.Route = _chunkAMVS5XVJjs.Route; exports.Router = _chunkAMVS5XVJjs.Router; exports.RouterProvider = _chunkAMVS5XVJjs.RouterProvider; exports.Routes = _chunkAMVS5XVJjs.Routes; exports.ScrollRestoration = _chunkO4JVZSOYjs.ScrollRestoration; exports.StaticRouter = _chunkO4JVZSOYjs.StaticRouter; exports.StaticRouterProvider = _chunkO4JVZSOYjs.StaticRouterProvider; exports.UNSAFE_AwaitContextProvider = _chunkAMVS5XVJjs.AwaitContextProvider; exports.UNSAFE_WithComponentProps = _chunkAMVS5XVJjs.WithComponentProps; exports.UNSAFE_WithErrorBoundaryProps = _chunkAMVS5XVJjs.WithErrorBoundaryProps; exports.UNSAFE_WithHydrateFallbackProps = _chunkAMVS5XVJjs.WithHydrateFallbackProps; exports.unstable_HistoryRouter = _chunkO4JVZSOYjs.HistoryRouter;
+exports.BrowserRouter = _chunkXHWAND4Xjs.BrowserRouter; exports.Form = _chunkXHWAND4Xjs.Form; exports.HashRouter = _chunkXHWAND4Xjs.HashRouter; exports.Link = _chunkXHWAND4Xjs.Link; exports.Links = _chunkKQLPIZ7Ejs.Links; exports.MemoryRouter = _chunkKQLPIZ7Ejs.MemoryRouter; exports.Meta = _chunkKQLPIZ7Ejs.Meta; exports.NavLink = _chunkXHWAND4Xjs.NavLink; exports.Navigate = _chunkKQLPIZ7Ejs.Navigate; exports.Outlet = _chunkKQLPIZ7Ejs.Outlet; exports.Route = _chunkKQLPIZ7Ejs.Route; exports.Router = _chunkKQLPIZ7Ejs.Router; exports.RouterProvider = _chunkKQLPIZ7Ejs.RouterProvider; exports.Routes = _chunkKQLPIZ7Ejs.Routes; exports.ScrollRestoration = _chunkXHWAND4Xjs.ScrollRestoration; exports.StaticRouter = _chunkXHWAND4Xjs.StaticRouter; exports.StaticRouterProvider = _chunkXHWAND4Xjs.StaticRouterProvider; exports.UNSAFE_AwaitContextProvider = _chunkKQLPIZ7Ejs.AwaitContextProvider; exports.UNSAFE_WithComponentProps = _chunkKQLPIZ7Ejs.WithComponentProps; exports.UNSAFE_WithErrorBoundaryProps = _chunkKQLPIZ7Ejs.WithErrorBoundaryProps; exports.UNSAFE_WithHydrateFallbackProps = _chunkKQLPIZ7Ejs.WithHydrateFallbackProps; exports.unstable_HistoryRouter = _chunkXHWAND4Xjs.HistoryRouter;

package/dist/development/index-react-server-client.mjs

@@ -1,5 +1,5 @@
 /**
- * react-router v7.9.6
+ * react-router v7.10.0-pre.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -32,7 +32,7 @@ import {
   WithComponentProps,
   WithErrorBoundaryProps,
   WithHydrateFallbackProps
-} from "./chunk-4WY6JWTD.mjs";
+} from "./chunk-GIMUO62I.mjs";
 export {
   BrowserRouter,
   Form,

package/dist/development/index-react-server.d.mts

@@ -497,6 +497,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.
      *
@@ -522,8 +524,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}
@@ -862,7 +876,8 @@ type 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";
@@ -888,7 +903,6 @@ type 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;
 
@@ -1324,6 +1338,7 @@ type ViewTransitionOpts = {
 interface RouterSubscriber {
     (state: RouterState, opts: {
         deletedFetchers: string[];
+        newErrors: RouteData | null;
         viewTransitionOpts?: ViewTransitionOpts;
         flushSync: boolean;
     }): void;

package/dist/development/index-react-server.d.ts

@@ -497,6 +497,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.
      *
@@ -522,8 +524,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}
@@ -862,7 +876,8 @@ type 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";
@@ -888,7 +903,6 @@ type 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;
 
@@ -1324,6 +1338,7 @@ type ViewTransitionOpts = {
 interface RouterSubscriber {
     (state: RouterState, opts: {
         deletedFetchers: string[];
+        newErrors: RouteData | null;
         viewTransitionOpts?: ViewTransitionOpts;
         flushSync: boolean;
     }): void;