react-router 7.10.1 → 7.11.0-pre.0

package/dist/development/dom-export.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { f as RouterProviderProps$1, e as RouterInit, u as unstable_ClientInstrumentation, g as unstable_ClientOnErrorFunction } from './router-CwNp5l9u.mjs';
-export { D as unstable_DecodeActionFunction, a as unstable_DecodeFormStateFunction, b as unstable_DecodeReplyFunction, R as unstable_RSCHydratedRouter, d as unstable_RSCManifestPayload, e as unstable_RSCPayload, f as unstable_RSCRenderPayload, c as unstable_createCallServer } from './browser-C5z6FZmz.mjs';
+import { f as RouterProviderProps$1, e as RouterInit, u as unstable_ClientInstrumentation, g as ClientOnErrorFunction } from './router-5fbeEIMQ.mjs';
+export { D as unstable_DecodeActionFunction, a as unstable_DecodeFormStateFunction, b as unstable_DecodeReplyFunction, R as unstable_RSCHydratedRouter, d as unstable_RSCManifestPayload, e as unstable_RSCPayload, f as unstable_RSCRenderPayload, c as unstable_createCallServer } from './browser-Cv4JZyZ5.mjs';
 
 type RouterProviderProps = Omit<RouterProviderProps$1, "flushSync">;
 declare function RouterProvider(props: Omit<RouterProviderProps, "flushSync">): React.JSX.Element;
@@ -71,9 +71,9 @@ interface HydratedRouterProps {
      */
     unstable_instrumentations?: unstable_ClientInstrumentation[];
     /**
-     * An error handler function that will be called for any loader/action/render
-     * errors that are encountered in your application.  This is useful for
-     * logging or reporting errors instead of the `ErrorBoundary` because it's not
+     * An error handler function that will be called for any middleware, loader, action,
+     * or render errors that are encountered in your application.  This is useful for
+     * logging or reporting errors instead of in the {@link ErrorBoundary} because it's not
      * subject to re-rendering and will only run one time per error.
      *
      * The `errorInfo` parameter is passed along from
@@ -81,13 +81,14 @@ interface HydratedRouterProps {
      * and is only present for render errors.
      *
      * ```tsx
-     * <HydratedRouter unstable_onError={(error, errorInfo) => {
-     *   console.error(error, errorInfo);
-     *   reportToErrorService(error, errorInfo);
+     * <HydratedRouter onError=(error, info) => {
+     *   let { location, params, unstable_pattern, errorInfo } = info;
+     *   console.error(error, location, errorInfo);
+     *   reportToErrorService(error, location, errorInfo);
      * }} />
      * ```
      */
-    unstable_onError?: unstable_ClientOnErrorFunction;
+    onError?: ClientOnErrorFunction;
     /**
      * Control whether router state updates are internally wrapped in
      * [`React.startTransition`](https://react.dev/reference/react/startTransition).
@@ -117,7 +118,7 @@ interface HydratedRouterProps {
  * @mode framework
  * @param props Props
  * @param {dom.HydratedRouterProps.getContext} props.getContext n/a
- * @param {dom.HydratedRouterProps.unstable_onError} props.unstable_onError n/a
+ * @param {dom.HydratedRouterProps.onError} props.onError n/a
  * @returns A React element that represents the hydrated application.
  */
 declare function HydratedRouter(props: HydratedRouterProps): React.JSX.Element;

package/dist/development/dom-export.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
-import { RouterProviderProps as RouterProviderProps$1, RouterInit, unstable_ClientOnErrorFunction } from 'react-router';
-import { u as unstable_ClientInstrumentation } from './instrumentation-BB0wRuqz.js';
-export { D as unstable_DecodeActionFunction, a as unstable_DecodeFormStateFunction, b as unstable_DecodeReplyFunction, R as unstable_RSCHydratedRouter, d as unstable_RSCManifestPayload, e as unstable_RSCPayload, f as unstable_RSCRenderPayload, c as unstable_createCallServer } from './browser-BpxEZgZC.js';
+import { RouterProviderProps as RouterProviderProps$1, RouterInit, ClientOnErrorFunction } from 'react-router';
+import { u as unstable_ClientInstrumentation } from './instrumentation-BlrVzjbg.js';
+export { D as unstable_DecodeActionFunction, a as unstable_DecodeFormStateFunction, b as unstable_DecodeReplyFunction, R as unstable_RSCHydratedRouter, d as unstable_RSCManifestPayload, e as unstable_RSCPayload, f as unstable_RSCRenderPayload, c as unstable_createCallServer } from './browser-o-qhcuhA.js';
 
 type RouterProviderProps = Omit<RouterProviderProps$1, "flushSync">;
 declare function RouterProvider(props: Omit<RouterProviderProps, "flushSync">): React.JSX.Element;
@@ -72,9 +72,9 @@ interface HydratedRouterProps {
      */
     unstable_instrumentations?: unstable_ClientInstrumentation[];
     /**
-     * An error handler function that will be called for any loader/action/render
-     * errors that are encountered in your application.  This is useful for
-     * logging or reporting errors instead of the `ErrorBoundary` because it's not
+     * An error handler function that will be called for any middleware, loader, action,
+     * or render errors that are encountered in your application.  This is useful for
+     * logging or reporting errors instead of in the {@link ErrorBoundary} because it's not
      * subject to re-rendering and will only run one time per error.
      *
      * The `errorInfo` parameter is passed along from
@@ -82,13 +82,14 @@ interface HydratedRouterProps {
      * and is only present for render errors.
      *
      * ```tsx
-     * <HydratedRouter unstable_onError={(error, errorInfo) => {
-     *   console.error(error, errorInfo);
-     *   reportToErrorService(error, errorInfo);
+     * <HydratedRouter onError=(error, info) => {
+     *   let { location, params, unstable_pattern, errorInfo } = info;
+     *   console.error(error, location, errorInfo);
+     *   reportToErrorService(error, location, errorInfo);
      * }} />
      * ```
      */
-    unstable_onError?: unstable_ClientOnErrorFunction;
+    onError?: ClientOnErrorFunction;
     /**
      * Control whether router state updates are internally wrapped in
      * [`React.startTransition`](https://react.dev/reference/react/startTransition).
@@ -118,7 +119,7 @@ interface HydratedRouterProps {
  * @mode framework
  * @param props Props
  * @param {dom.HydratedRouterProps.getContext} props.getContext n/a
- * @param {dom.HydratedRouterProps.unstable_onError} props.unstable_onError n/a
+ * @param {dom.HydratedRouterProps.onError} props.onError n/a
  * @returns A React element that represents the hydrated application.
  */
 declare function HydratedRouter(props: HydratedRouterProps): React.JSX.Element;

package/dist/development/dom-export.js

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }/**
- * react-router v7.10.1
+ * react-router v7.11.0-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -13,7 +13,7 @@
 
 
 
-var _chunkFKYGG5Z2js = require('./chunk-FKYGG5Z2.js');
+var _chunkOVG6YSZ5js = require('./chunk-OVG6YSZ5.js');
 
 
 
@@ -32,7 +32,7 @@ var _chunkFKYGG5Z2js = require('./chunk-FKYGG5Z2.js');
 
 
 
-var _chunkRBZI3ZHDjs = require('./chunk-RBZI3ZHD.js');
+var _chunkUO7KGW2Ujs = require('./chunk-UO7KGW2U.js');
 
 // lib/dom-export/dom-router-provider.tsx
 var _react = require('react'); var React = _interopRequireWildcard(_react); var React2 = _interopRequireWildcard(_react); var React3 = _interopRequireWildcard(_react);
@@ -204,7 +204,7 @@ function HydratedRouter(props) {
   }, []);
   React2.useEffect(() => {
     if (process.env.NODE_ENV === "development" && criticalCss === void 0) {
-      document.querySelectorAll(`[${_chunkRBZI3ZHDjs.CRITICAL_CSS_DATA_ATTRIBUTE}]`).forEach((element) => element.remove());
+      document.querySelectorAll(`[${_chunkUO7KGW2Ujs.CRITICAL_CSS_DATA_ATTRIBUTE}]`).forEach((element) => element.remove());
     }
   }, [criticalCss]);
   let [location2, setLocation] = React2.useState(router.state.location);
@@ -253,7 +253,7 @@ function HydratedRouter(props) {
         {
           router,
           unstable_useTransitions: props.unstable_useTransitions,
-          unstable_onError: props.unstable_onError
+          onError: props.onError
         }
       ))
     ), /* @__PURE__ */ React2.createElement(React2.Fragment, null))
@@ -376,10 +376,10 @@ function createRouterFromPayload({
     };
   if (payload.type !== "render") throw new Error("Invalid payload type");
   globalVar.__reactRouterRouteModules = _nullishCoalesce(globalVar.__reactRouterRouteModules, () => ( {}));
-  _chunkFKYGG5Z2js.populateRSCRouteModules.call(void 0, globalVar.__reactRouterRouteModules, payload.matches);
+  _chunkOVG6YSZ5js.populateRSCRouteModules.call(void 0, globalVar.__reactRouterRouteModules, payload.matches);
   let patches = /* @__PURE__ */ new Map();
   _optionalChain([payload, 'access', _22 => _22.patches, 'optionalAccess', _23 => _23.forEach, 'call', _24 => _24((patch) => {
-    _chunkRBZI3ZHDjs.invariant.call(void 0, patch.parentId, "Invalid patch parentId");
+    _chunkUO7KGW2Ujs.invariant.call(void 0, patch.parentId, "Invalid patch parentId");
     if (!patches.has(patch.parentId)) {
       patches.set(patch.parentId, []);
     }
@@ -401,12 +401,12 @@ function createRouterFromPayload({
     }
     return [route];
   }, []);
-  globalVar.__reactRouterDataRouter = _chunkRBZI3ZHDjs.createRouter.call(void 0, {
+  globalVar.__reactRouterDataRouter = _chunkUO7KGW2Ujs.createRouter.call(void 0, {
     routes,
     getContext,
     basename: payload.basename,
-    history: _chunkRBZI3ZHDjs.createBrowserHistory.call(void 0, ),
-    hydrationData: _chunkFKYGG5Z2js.getHydrationData.call(void 0, {
+    history: _chunkUO7KGW2Ujs.createBrowserHistory.call(void 0, ),
+    hydrationData: _chunkOVG6YSZ5js.getHydrationData.call(void 0, {
       state: {
         loaderData: payload.loaderData,
         actionData: payload.actionData,
@@ -415,7 +415,7 @@ function createRouterFromPayload({
       routes,
       getRouteInfo: (routeId) => {
         let match = payload.matches.find((m) => m.id === routeId);
-        _chunkRBZI3ZHDjs.invariant.call(void 0, match, "Route not found in payload");
+        _chunkUO7KGW2Ujs.invariant.call(void 0, match, "Route not found in payload");
         return {
           clientLoader: match.clientLoader,
           hasLoader: match.hasLoader,
@@ -513,9 +513,9 @@ function createRouterFromPayload({
     routeModules: globalVar.__reactRouterRouteModules
   };
 }
-var renderedRoutesContext = _chunkRBZI3ZHDjs.createContext.call(void 0, );
+var renderedRoutesContext = _chunkUO7KGW2Ujs.createContext.call(void 0, );
 function getRSCSingleFetchDataStrategy(getRouter, ssr, basename, createFromReadableStream, fetchImplementation) {
-  let dataStrategy = _chunkRBZI3ZHDjs.getSingleFetchDataStrategyImpl.call(void 0, 
+  let dataStrategy = _chunkUO7KGW2Ujs.getSingleFetchDataStrategyImpl.call(void 0, 
     getRouter,
     (match) => {
       let M = match;
@@ -571,20 +571,20 @@ function getRSCSingleFetchDataStrategy(getRouter, ssr, basename, createFromReada
 function getFetchAndDecodeViaRSC(createFromReadableStream, fetchImplementation) {
   return async (args, basename, targetRoutes) => {
     let { request, context } = args;
-    let url = _chunkRBZI3ZHDjs.singleFetchUrl.call(void 0, request.url, basename, "rsc");
+    let url = _chunkUO7KGW2Ujs.singleFetchUrl.call(void 0, request.url, basename, "rsc");
     if (request.method === "GET") {
-      url = _chunkRBZI3ZHDjs.stripIndexParam.call(void 0, url);
+      url = _chunkUO7KGW2Ujs.stripIndexParam.call(void 0, url);
       if (targetRoutes) {
         url.searchParams.set("_routes", targetRoutes.join(","));
       }
     }
     let res = await fetchImplementation(
-      new Request(url, await _chunkRBZI3ZHDjs.createRequestInit.call(void 0, request))
+      new Request(url, await _chunkUO7KGW2Ujs.createRequestInit.call(void 0, request))
     );
     if (res.status >= 400 && !res.headers.has("X-Remix-Response")) {
-      throw new (0, _chunkRBZI3ZHDjs.ErrorResponseImpl)(res.status, res.statusText, await res.text());
+      throw new (0, _chunkUO7KGW2Ujs.ErrorResponseImpl)(res.status, res.statusText, await res.text());
     }
-    _chunkRBZI3ZHDjs.invariant.call(void 0, res.body, "No response body to decode");
+    _chunkUO7KGW2Ujs.invariant.call(void 0, res.body, "No response body to decode");
     try {
       const payload = await createFromReadableStream(res.body, {
         temporaryReferences: void 0
@@ -608,7 +608,7 @@ function getFetchAndDecodeViaRSC(createFromReadableStream, fetchImplementation)
       }
       context.get(renderedRoutesContext).push(...payload.matches);
       let results = { routes: {} };
-      const dataKey = _chunkRBZI3ZHDjs.isMutationMethod.call(void 0, request.method) ? "actionData" : "loaderData";
+      const dataKey = _chunkUO7KGW2Ujs.isMutationMethod.call(void 0, request.method) ? "actionData" : "loaderData";
       for (let [routeId, data] of Object.entries(payload[dataKey] || {})) {
         results.routes[routeId] = { data };
       }
@@ -641,7 +641,7 @@ function RSCHydratedRouter({
     [createFromReadableStream, payload, fetchImplementation, getContext]
   );
   React3.useEffect(() => {
-    _chunkRBZI3ZHDjs.setIsHydrated.call(void 0, );
+    _chunkUO7KGW2Ujs.setIsHydrated.call(void 0, );
   }, []);
   React3.useLayoutEffect(() => {
     const globalVar = window;
@@ -743,12 +743,11 @@ function RSCHydratedRouter({
     routeDiscovery: { mode: "lazy", manifestPath: "/__manifest" },
     routeModules
   };
-  return /* @__PURE__ */ React3.createElement(_chunkRBZI3ZHDjs.RSCRouterContext.Provider, { value: true }, /* @__PURE__ */ React3.createElement(_chunkFKYGG5Z2js.RSCRouterGlobalErrorBoundary, { location: state.location }, /* @__PURE__ */ React3.createElement(_chunkRBZI3ZHDjs.FrameworkContext.Provider, { value: frameworkContext }, /* @__PURE__ */ React3.createElement(
-    _chunkRBZI3ZHDjs.RouterProvider,
+  return /* @__PURE__ */ React3.createElement(_chunkUO7KGW2Ujs.RSCRouterContext.Provider, { value: true }, /* @__PURE__ */ React3.createElement(_chunkOVG6YSZ5js.RSCRouterGlobalErrorBoundary, { location: state.location }, /* @__PURE__ */ React3.createElement(_chunkUO7KGW2Ujs.FrameworkContext.Provider, { value: frameworkContext }, /* @__PURE__ */ React3.createElement(
+    _chunkUO7KGW2Ujs.RouterProvider,
     {
       router: transitionEnabledRouter,
-      flushSync: ReactDOM2.flushSync,
-      unstable_useTransitions: true
+      flushSync: ReactDOM2.flushSync
     }
   ))));
 }
@@ -761,8 +760,8 @@ function createRouteFromServerManifest(match, payload) {
   // the server loader flow regardless of whether the client loader calls
   // `serverLoader` or not, otherwise we'll have nothing to render.
   match.hasComponent && !match.element;
-  _chunkRBZI3ZHDjs.invariant.call(void 0, window.__reactRouterRouteModules);
-  _chunkFKYGG5Z2js.populateRSCRouteModules.call(void 0, window.__reactRouterRouteModules, match);
+  _chunkUO7KGW2Ujs.invariant.call(void 0, window.__reactRouterRouteModules);
+  _chunkOVG6YSZ5js.populateRSCRouteModules.call(void 0, window.__reactRouterRouteModules, match);
   let dataRoute = {
     id: match.id,
     element: match.element,
@@ -812,7 +811,7 @@ function createRouteFromServerManifest(match, payload) {
         return await callSingleFetch(singleFetch);
       }
     }) : match.hasAction ? (_, singleFetch) => callSingleFetch(singleFetch) : () => {
-      throw _chunkRBZI3ZHDjs.noActionDefinedError.call(void 0, "action", match.id);
+      throw _chunkUO7KGW2Ujs.noActionDefinedError.call(void 0, "action", match.id);
     },
     path: match.path,
     shouldRevalidate: match.shouldRevalidate,
@@ -825,7 +824,7 @@ function createRouteFromServerManifest(match, payload) {
     hasShouldRevalidate: match.shouldRevalidate != null
   };
   if (typeof dataRoute.loader === "function") {
-    dataRoute.loader.hydrate = _chunkRBZI3ZHDjs.shouldHydrateRouteLoader.call(void 0, 
+    dataRoute.loader.hydrate = _chunkUO7KGW2Ujs.shouldHydrateRouteLoader.call(void 0, 
       match.id,
       match.clientLoader,
       match.hasLoader,
@@ -835,7 +834,7 @@ function createRouteFromServerManifest(match, payload) {
   return dataRoute;
 }
 function callSingleFetch(singleFetch) {
-  _chunkRBZI3ZHDjs.invariant.call(void 0, typeof singleFetch === "function", "Invalid singleFetch parameter");
+  _chunkUO7KGW2Ujs.invariant.call(void 0, typeof singleFetch === "function", "Invalid singleFetch parameter");
   return singleFetch();
 }
 function preventInvalidServerHandlerCall(type, routeId, hasHandler) {
@@ -843,7 +842,7 @@ function preventInvalidServerHandlerCall(type, routeId, hasHandler) {
     let fn = type === "action" ? "serverAction()" : "serverLoader()";
     let msg = `You are trying to call ${fn} on a route that does not have a server ${type} (routeId: "${routeId}")`;
     console.error(msg);
-    throw new (0, _chunkRBZI3ZHDjs.ErrorResponseImpl)(400, "Bad Request", new Error(msg), true);
+    throw new (0, _chunkUO7KGW2Ujs.ErrorResponseImpl)(400, "Bad Request", new Error(msg), true);
   }
 }
 var nextPaths = /* @__PURE__ */ new Set();
@@ -898,7 +897,7 @@ async function fetchAndApplyManifestPatches(paths, createFromReadableStream, fet
 function addToFifoQueue(path, queue) {
   if (queue.size >= discoveredPathsMaxSize) {
     let first = queue.values().next().value;
-    queue.delete(first);
+    if (typeof first === "string") queue.delete(first);
   }
   queue.add(path);
 }

package/dist/development/dom-export.mjs

@@ -1,5 +1,5 @@
 /**
- * react-router v7.10.1
+ * react-router v7.11.0-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -14,7 +14,7 @@ import {
   deserializeErrors,
   getHydrationData,
   populateRSCRouteModules
-} from "./chunk-PMGK554W.mjs";
+} from "./chunk-QMKP6CC3.mjs";
 import {
   CRITICAL_CSS_DATA_ATTRIBUTE,
   ErrorResponseImpl,
@@ -42,7 +42,7 @@ import {
   singleFetchUrl,
   stripIndexParam,
   useFogOFWarDiscovery
-} from "./chunk-WWGJGFF6.mjs";
+} from "./chunk-KRMLYMWA.mjs";
 
 // lib/dom-export/dom-router-provider.tsx
 import * as React from "react";
@@ -245,7 +245,7 @@ function HydratedRouter(props) {
         {
           router,
           unstable_useTransitions: props.unstable_useTransitions,
-          unstable_onError: props.unstable_onError
+          onError: props.onError
         }
       ))
     ), /* @__PURE__ */ React2.createElement(React2.Fragment, null))
@@ -739,8 +739,7 @@ function RSCHydratedRouter({
     RouterProvider,
     {
       router: transitionEnabledRouter,
-      flushSync: ReactDOM2.flushSync,
-      unstable_useTransitions: true
+      flushSync: ReactDOM2.flushSync
     }
   ))));
 }
@@ -890,7 +889,7 @@ async function fetchAndApplyManifestPatches(paths, createFromReadableStream, fet
 function addToFifoQueue(path, queue) {
   if (queue.size >= discoveredPathsMaxSize) {
     let first = queue.values().next().value;
-    queue.delete(first);
+    if (typeof first === "string") queue.delete(first);
   }
   queue.add(path);
 }

package/dist/{production/index-react-server-client-CCjKYJTH.d.ts → development/index-react-server-client-Cv5Q9lf0.d.ts}

@@ -1,4 +1,4 @@
-import { bE as RouteManifest, o as RouteModules, Q as HydrationState, a1 as DataRouteObject, a as ClientLoaderFunction, a5 as StaticHandlerContext, bF as ServerRouteModule, q as MiddlewareEnabled, c as RouterContextProvider, r as AppLoadContext, al as LoaderFunctionArgs, ac as ActionFunctionArgs, au as unstable_ServerInstrumentation, aj as HTMLFormMethod, ah as FormEncType, w as RelativeRoutingType, bh as PageLinkDescriptor, T as To, bG as History, a4 as GetScrollRestorationKeyFunction, e as RouterInit, bH as FutureConfig$1, u as unstable_ClientInstrumentation, p as DataStrategyFunction, a0 as PatchRoutesOnNavigationFunction, s as NavigateOptions, a6 as Fetcher, K as RouteObject, n as Router, v as SerializeFrom, B as BlockerFunction, L as Location, bI as CreateStaticHandlerOptions$1, a2 as StaticHandler } from './instrumentation-BB0wRuqz.js';
+import { bE as RouteManifest, o as RouteModules, Q as HydrationState, a1 as DataRouteObject, a as ClientLoaderFunction, a5 as StaticHandlerContext, bF as ServerRouteModule, q as MiddlewareEnabled, c as RouterContextProvider, r as AppLoadContext, al as LoaderFunctionArgs, ac as ActionFunctionArgs, au as unstable_ServerInstrumentation, aj as HTMLFormMethod, ah as FormEncType, w as RelativeRoutingType, bh as PageLinkDescriptor, T as To, bG as History, a4 as GetScrollRestorationKeyFunction, e as RouterInit, bH as FutureConfig$1, u as unstable_ClientInstrumentation, p as DataStrategyFunction, a0 as PatchRoutesOnNavigationFunction, s as NavigateOptions, a6 as Fetcher, K as RouteObject, n as Router, v as SerializeFrom, B as BlockerFunction, L as Location, bI as CreateStaticHandlerOptions$1, a2 as StaticHandler } from './instrumentation-BlrVzjbg.js';
 import * as React from 'react';
 
 interface Route {
@@ -215,6 +215,18 @@ interface SharedSubmitOptions {
      * Enable flushSync for this submission's state updates
      */
     flushSync?: boolean;
+    /**
+     * Specify the default revalidation behavior after this submission
+     *
+     * If no `shouldRevalidate` functions are present on the active routes, then this
+     * value will be used directly.  Otherwise it will be passed into `shouldRevalidate`
+     * so the route can make the final determination on revalidation. This can be
+     * useful when updating search params and you don't want to trigger a revalidation.
+     *
+     * By default (when not specified), loaders will revalidate according to the routers
+     * standard revalidation behavior.
+     */
+    unstable_defaultShouldRevalidate?: boolean;
 }
 /**
  * Submit options available to fetchers
@@ -251,7 +263,8 @@ interface SubmitOptions extends FetcherSubmitOptions {
 
 declare const FrameworkContext: React.Context<FrameworkContextObject | undefined>;
 /**
- * Defines the discovery behavior of the link:
+ * Defines the [lazy route discovery](../../explanation/lazy-route-discovery)
+ * behavior of the link/form:
  *
  * - "render" - default, discover the route when the link renders
  * - "none" - don't eagerly discover, only discover if the link is clicked
@@ -1112,16 +1125,16 @@ declare namespace HistoryRouter {
  */
 interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
     /**
-     * Defines the link discovery behavior
+     * Defines the link [lazy route discovery](../../explanation/lazy-route-discovery) behavior.
+     *
+     * - **render** — default, discover the route when the link renders
+     * - **none** — don't eagerly discover, only discover if the link is clicked
      *
      * ```tsx
      * <Link /> // default ("render")
      * <Link discover="render" />
      * <Link discover="none" />
      * ```
-     *
-     * - **render** — default, discover the route when the link renders
-     * - **none** — don't eagerly discover, only discover if the link is clicked
      */
     discover?: DiscoverBehavior;
     /**
@@ -1266,6 +1279,22 @@ interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>,
      * To apply specific styles for the transition, see {@link useViewTransitionState}
      */
     viewTransition?: boolean;
+    /**
+     * Specify the default revalidation behavior for the navigation.
+     *
+     * ```tsx
+     * <Link to="/some/path" unstable_defaultShouldRevalidate={false} />
+     * ```
+     *
+     * If no `shouldRevalidate` functions are present on the active routes, then this
+     * value will be used directly.  Otherwise it will be passed into `shouldRevalidate`
+     * so the route can make the final determination on revalidation. This can be
+     * useful when updating search params and you don't want to trigger a revalidation.
+     *
+     * By default (when not specified), loaders will revalidate according to the routers
+     * standard revalidation behavior.
+     */
+    unstable_defaultShouldRevalidate?: boolean;
 }
 /**
  * A progressively enhanced [`<a href>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a)
@@ -1295,6 +1324,7 @@ interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>,
  * @param {LinkProps.state} props.state n/a
  * @param {LinkProps.to} props.to n/a
  * @param {LinkProps.viewTransition} props.viewTransition [modes: framework, data] n/a
+ * @param {LinkProps.unstable_defaultShouldRevalidate} props.unstable_defaultShouldRevalidate n/a
  */
 declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLAnchorElement>>;
 /**
@@ -1524,6 +1554,18 @@ interface SharedFormProps extends React.FormHTMLAttributes<HTMLFormElement> {
      * then this form will not do anything.
      */
     onSubmit?: React.FormEventHandler<HTMLFormElement>;
+    /**
+     * Specify the default revalidation behavior after this submission
+     *
+     * If no `shouldRevalidate` functions are present on the active routes, then this
+     * value will be used directly.  Otherwise it will be passed into `shouldRevalidate`
+     * so the route can make the final determination on revalidation. This can be
+     * useful when updating search params and you don't want to trigger a revalidation.
+     *
+     * By default (when not specified), loaders will revalidate according to the routers
+     * standard revalidation behavior.
+     */
+    unstable_defaultShouldRevalidate?: boolean;
 }
 /**
  * Form props available to fetchers
@@ -1537,16 +1579,16 @@ interface FetcherFormProps extends SharedFormProps {
  */
 interface FormProps extends SharedFormProps {
     /**
-     * Defines the link discovery behavior. See {@link DiscoverBehavior}.
+     * Defines the form [lazy route discovery](../../explanation/lazy-route-discovery) behavior.
+     *
+     * - **render** — default, discover the route when the form renders
+     * - **none** — don't eagerly discover, only discover if the form is submitted
      *
      * ```tsx
-     * <Link /> // default ("render")
-     * <Link discover="render" />
-     * <Link discover="none" />
+     * <Form /> // default ("render")
+     * <Form discover="render" />
+     * <Form discover="none" />
      * ```
-     *
-     * - **render** — default, discover the route when the link renders
-     * - **none** — don't eagerly discover, only discover if the link is clicked
      */
     discover?: DiscoverBehavior;
     /**
@@ -1631,6 +1673,7 @@ interface FormProps extends SharedFormProps {
  * @param {FormProps.replace} replace n/a
  * @param {FormProps.state} state n/a
  * @param {FormProps.viewTransition} viewTransition n/a
+ * @param {FormProps.unstable_defaultShouldRevalidate} unstable_defaultShouldRevalidate n/a
  * @returns A progressively enhanced [`<form>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form) component
  */
 declare const Form: React.ForwardRefExoticComponent<FormProps & React.RefAttributes<HTMLFormElement>>;
@@ -1721,18 +1764,21 @@ 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_defaultShouldRevalidate Specify the default revalidation
+ * behavior for the navigation. Defaults to `true`.
  * @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, unstable_useTransitions, }?: {
+declare function useLinkClickHandler<E extends Element = HTMLAnchorElement>(to: To, { target, replace: replaceProp, state, preventScrollReset, relative, viewTransition, unstable_defaultShouldRevalidate, unstable_useTransitions, }?: {
     target?: React.HTMLAttributeAnchorTarget;
     replace?: boolean;
     state?: any;
     preventScrollReset?: boolean;
     relative?: RelativeRoutingType;
     viewTransition?: boolean;
+    unstable_defaultShouldRevalidate?: boolean;
     unstable_useTransitions?: boolean;
 }): (event: React.MouseEvent<E, MouseEvent>) => void;
 /**