react-router 7.13.0 → 7.13.1-pre.0

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.13.0
+ * react-router v7.13.1-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -13,7 +13,7 @@
 
 
 
-var _chunk7PAHGFS4js = require('./chunk-7PAHGFS4.js');
+var _chunkCGPAOPIJjs = require('./chunk-CGPAOPIJ.js');
 
 
 
@@ -32,7 +32,7 @@ var _chunk7PAHGFS4js = require('./chunk-7PAHGFS4.js');
 
 
 
-var _chunkWICQJKU6js = require('./chunk-WICQJKU6.js');
+var _chunkLF5SS6XEjs = require('./chunk-LF5SS6XE.js');
 
 // lib/dom-export/dom-router-provider.tsx
 var _react = require('react'); var React = _interopRequireWildcard(_react); var React2 = _interopRequireWildcard(_react); var React3 = _interopRequireWildcard(_react);
@@ -149,6 +149,12 @@ function createHydratedRouter({
       hydrationData.errors = _reactrouter.UNSAFE_deserializeErrors.call(void 0, hydrationData.errors);
     }
   }
+  if (window.history.state && window.history.state.masked) {
+    window.history.replaceState(
+      { ...window.history.state, masked: void 0 },
+      ""
+    );
+  }
   let router2 = _reactrouter.UNSAFE_createRouter.call(void 0, {
     routes,
     history: _reactrouter.UNSAFE_createBrowserHistory.call(void 0, ),
@@ -170,6 +176,7 @@ function createHydratedRouter({
       ssrInfo.context.future.unstable_trailingSlashAwareDataRequests
     ),
     patchRoutesOnNavigation: _reactrouter.UNSAFE_getPatchRoutesOnNavigationFunction.call(void 0, 
+      () => router2,
       ssrInfo.manifest,
       ssrInfo.routeModules,
       ssrInfo.context.ssr,
@@ -205,7 +212,7 @@ function HydratedRouter(props) {
   }, []);
   React2.useEffect(() => {
     if (process.env.NODE_ENV === "development" && criticalCss === void 0) {
-      document.querySelectorAll(`[${_chunkWICQJKU6js.CRITICAL_CSS_DATA_ATTRIBUTE}]`).forEach((element) => element.remove());
+      document.querySelectorAll(`[${_chunkLF5SS6XEjs.CRITICAL_CSS_DATA_ATTRIBUTE}]`).forEach((element) => element.remove());
     }
   }, [criticalCss]);
   let [location2, setLocation] = React2.useState(router.state.location);
@@ -377,10 +384,10 @@ function createRouterFromPayload({
     };
   if (payload.type !== "render") throw new Error("Invalid payload type");
   globalVar.__reactRouterRouteModules = _nullishCoalesce(globalVar.__reactRouterRouteModules, () => ( {}));
-  _chunk7PAHGFS4js.populateRSCRouteModules.call(void 0, globalVar.__reactRouterRouteModules, payload.matches);
+  _chunkCGPAOPIJjs.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) => {
-    _chunkWICQJKU6js.invariant.call(void 0, patch.parentId, "Invalid patch parentId");
+    _chunkLF5SS6XEjs.invariant.call(void 0, patch.parentId, "Invalid patch parentId");
     if (!patches.has(patch.parentId)) {
       patches.set(patch.parentId, []);
     }
@@ -402,12 +409,12 @@ function createRouterFromPayload({
     }
     return [route];
   }, []);
-  globalVar.__reactRouterDataRouter = _chunkWICQJKU6js.createRouter.call(void 0, {
+  globalVar.__reactRouterDataRouter = _chunkLF5SS6XEjs.createRouter.call(void 0, {
     routes,
     getContext,
     basename: payload.basename,
-    history: _chunkWICQJKU6js.createBrowserHistory.call(void 0, ),
-    hydrationData: _chunk7PAHGFS4js.getHydrationData.call(void 0, {
+    history: _chunkLF5SS6XEjs.createBrowserHistory.call(void 0, ),
+    hydrationData: _chunkCGPAOPIJjs.getHydrationData.call(void 0, {
       state: {
         loaderData: payload.loaderData,
         actionData: payload.actionData,
@@ -416,7 +423,7 @@ function createRouterFromPayload({
       routes,
       getRouteInfo: (routeId) => {
         let match = payload.matches.find((m) => m.id === routeId);
-        _chunkWICQJKU6js.invariant.call(void 0, match, "Route not found in payload");
+        _chunkLF5SS6XEjs.invariant.call(void 0, match, "Route not found in payload");
         return {
           clientLoader: match.clientLoader,
           hasLoader: match.hasLoader,
@@ -514,9 +521,9 @@ function createRouterFromPayload({
     routeModules: globalVar.__reactRouterRouteModules
   };
 }
-var renderedRoutesContext = _chunkWICQJKU6js.createContext.call(void 0, );
+var renderedRoutesContext = _chunkLF5SS6XEjs.createContext.call(void 0, );
 function getRSCSingleFetchDataStrategy(getRouter, ssr, basename, createFromReadableStream, fetchImplementation) {
-  let dataStrategy = _chunkWICQJKU6js.getSingleFetchDataStrategyImpl.call(void 0, 
+  let dataStrategy = _chunkLF5SS6XEjs.getSingleFetchDataStrategyImpl.call(void 0, 
     getRouter,
     (match) => {
       let M = match;
@@ -574,20 +581,20 @@ function getRSCSingleFetchDataStrategy(getRouter, ssr, basename, createFromReada
 function getFetchAndDecodeViaRSC(createFromReadableStream, fetchImplementation) {
   return async (args, basename, trailingSlashAware, targetRoutes) => {
     let { request, context } = args;
-    let url = _chunkWICQJKU6js.singleFetchUrl.call(void 0, request.url, basename, trailingSlashAware, "rsc");
+    let url = _chunkLF5SS6XEjs.singleFetchUrl.call(void 0, request.url, basename, trailingSlashAware, "rsc");
     if (request.method === "GET") {
-      url = _chunkWICQJKU6js.stripIndexParam.call(void 0, url);
+      url = _chunkLF5SS6XEjs.stripIndexParam.call(void 0, url);
       if (targetRoutes) {
         url.searchParams.set("_routes", targetRoutes.join(","));
       }
     }
     let res = await fetchImplementation(
-      new Request(url, await _chunkWICQJKU6js.createRequestInit.call(void 0, request))
+      new Request(url, await _chunkLF5SS6XEjs.createRequestInit.call(void 0, request))
     );
     if (res.status >= 400 && !res.headers.has("X-Remix-Response")) {
-      throw new (0, _chunkWICQJKU6js.ErrorResponseImpl)(res.status, res.statusText, await res.text());
+      throw new (0, _chunkLF5SS6XEjs.ErrorResponseImpl)(res.status, res.statusText, await res.text());
     }
-    _chunkWICQJKU6js.invariant.call(void 0, res.body, "No response body to decode");
+    _chunkLF5SS6XEjs.invariant.call(void 0, res.body, "No response body to decode");
     try {
       const payload = await createFromReadableStream(res.body, {
         temporaryReferences: void 0
@@ -611,7 +618,7 @@ function getFetchAndDecodeViaRSC(createFromReadableStream, fetchImplementation)
       }
       context.get(renderedRoutesContext).push(...payload.matches);
       let results = { routes: {} };
-      const dataKey = _chunkWICQJKU6js.isMutationMethod.call(void 0, request.method) ? "actionData" : "loaderData";
+      const dataKey = _chunkLF5SS6XEjs.isMutationMethod.call(void 0, request.method) ? "actionData" : "loaderData";
       for (let [routeId, data] of Object.entries(payload[dataKey] || {})) {
         results.routes[routeId] = { data };
       }
@@ -644,7 +651,7 @@ function RSCHydratedRouter({
     [createFromReadableStream, payload, fetchImplementation, getContext]
   );
   React3.useEffect(() => {
-    _chunkWICQJKU6js.setIsHydrated.call(void 0, );
+    _chunkLF5SS6XEjs.setIsHydrated.call(void 0, );
   }, []);
   React3.useLayoutEffect(() => {
     const globalVar = window;
@@ -748,8 +755,8 @@ function RSCHydratedRouter({
     routeDiscovery: { mode: "lazy", manifestPath: "/__manifest" },
     routeModules
   };
-  return /* @__PURE__ */ React3.createElement(_chunkWICQJKU6js.RSCRouterContext.Provider, { value: true }, /* @__PURE__ */ React3.createElement(_chunk7PAHGFS4js.RSCRouterGlobalErrorBoundary, { location: state.location }, /* @__PURE__ */ React3.createElement(_chunkWICQJKU6js.FrameworkContext.Provider, { value: frameworkContext }, /* @__PURE__ */ React3.createElement(
-    _chunkWICQJKU6js.RouterProvider,
+  return /* @__PURE__ */ React3.createElement(_chunkLF5SS6XEjs.RSCRouterContext.Provider, { value: true }, /* @__PURE__ */ React3.createElement(_chunkCGPAOPIJjs.RSCRouterGlobalErrorBoundary, { location: state.location }, /* @__PURE__ */ React3.createElement(_chunkLF5SS6XEjs.FrameworkContext.Provider, { value: frameworkContext }, /* @__PURE__ */ React3.createElement(
+    _chunkLF5SS6XEjs.RouterProvider,
     {
       router: transitionEnabledRouter,
       flushSync: ReactDOM2.flushSync
@@ -765,8 +772,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;
-  _chunkWICQJKU6js.invariant.call(void 0, window.__reactRouterRouteModules);
-  _chunk7PAHGFS4js.populateRSCRouteModules.call(void 0, window.__reactRouterRouteModules, match);
+  _chunkLF5SS6XEjs.invariant.call(void 0, window.__reactRouterRouteModules);
+  _chunkCGPAOPIJjs.populateRSCRouteModules.call(void 0, window.__reactRouterRouteModules, match);
   let dataRoute = {
     id: match.id,
     element: match.element,
@@ -816,7 +823,7 @@ function createRouteFromServerManifest(match, payload) {
         return await callSingleFetch(singleFetch);
       }
     }) : match.hasAction ? (_, singleFetch) => callSingleFetch(singleFetch) : () => {
-      throw _chunkWICQJKU6js.noActionDefinedError.call(void 0, "action", match.id);
+      throw _chunkLF5SS6XEjs.noActionDefinedError.call(void 0, "action", match.id);
     },
     path: match.path,
     shouldRevalidate: match.shouldRevalidate,
@@ -829,7 +836,7 @@ function createRouteFromServerManifest(match, payload) {
     hasShouldRevalidate: match.shouldRevalidate != null
   };
   if (typeof dataRoute.loader === "function") {
-    dataRoute.loader.hydrate = _chunkWICQJKU6js.shouldHydrateRouteLoader.call(void 0, 
+    dataRoute.loader.hydrate = _chunkLF5SS6XEjs.shouldHydrateRouteLoader.call(void 0, 
       match.id,
       match.clientLoader,
       match.hasLoader,
@@ -839,7 +846,7 @@ function createRouteFromServerManifest(match, payload) {
   return dataRoute;
 }
 function callSingleFetch(singleFetch) {
-  _chunkWICQJKU6js.invariant.call(void 0, typeof singleFetch === "function", "Invalid singleFetch parameter");
+  _chunkLF5SS6XEjs.invariant.call(void 0, typeof singleFetch === "function", "Invalid singleFetch parameter");
   return singleFetch();
 }
 function preventInvalidServerHandlerCall(type, routeId, hasHandler) {
@@ -847,7 +854,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, _chunkWICQJKU6js.ErrorResponseImpl)(400, "Bad Request", new Error(msg), true);
+    throw new (0, _chunkLF5SS6XEjs.ErrorResponseImpl)(400, "Bad Request", new Error(msg), true);
   }
 }
 var nextPaths = /* @__PURE__ */ new Set();

package/dist/development/dom-export.mjs

@@ -1,5 +1,5 @@
 /**
- * react-router v7.13.0
+ * react-router v7.13.1-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -14,7 +14,7 @@ import {
   deserializeErrors,
   getHydrationData,
   populateRSCRouteModules
-} from "./chunk-4LKRSAEJ.mjs";
+} from "./chunk-BPFEYQ6M.mjs";
 import {
   CRITICAL_CSS_DATA_ATTRIBUTE,
   ErrorResponseImpl,
@@ -42,7 +42,7 @@ import {
   singleFetchUrl,
   stripIndexParam,
   useFogOFWarDiscovery
-} from "./chunk-JZWAC4HX.mjs";
+} from "./chunk-WQZSGSJA.mjs";
 
 // lib/dom-export/dom-router-provider.tsx
 import * as React from "react";
@@ -141,6 +141,12 @@ function createHydratedRouter({
       hydrationData.errors = deserializeErrors(hydrationData.errors);
     }
   }
+  if (window.history.state && window.history.state.masked) {
+    window.history.replaceState(
+      { ...window.history.state, masked: void 0 },
+      ""
+    );
+  }
   let router2 = createRouter({
     routes,
     history: createBrowserHistory(),
@@ -162,6 +168,7 @@ function createHydratedRouter({
       ssrInfo.context.future.unstable_trailingSlashAwareDataRequests
     ),
     patchRoutesOnNavigation: getPatchRoutesOnNavigationFunction(
+      () => router2,
       ssrInfo.manifest,
       ssrInfo.routeModules,
       ssrInfo.context.ssr,

package/dist/development/{index-react-server-client-1TI9M9o1.d.ts → index-react-server-client-C4tCIird.d.ts}

@@ -1,4 +1,4 @@
-import { bG as RouteManifest, o as RouteModules, Q as HydrationState, a1 as DataRouteObject, a as ClientLoaderFunction, a5 as StaticHandlerContext, bH 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, bI as History, a4 as GetScrollRestorationKeyFunction, e as RouterInit, bJ 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, bK as CreateStaticHandlerOptions$1, a2 as StaticHandler } from './instrumentation-DvHY1sgY.js';
+import { bG as RouteManifest, o as RouteModules, Q as HydrationState, a1 as DataRouteObject, a as ClientLoaderFunction, a5 as StaticHandlerContext, bH 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, bI as History, a4 as GetScrollRestorationKeyFunction, e as RouterInit, bJ 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, bK as CreateStaticHandlerOptions$1, a2 as StaticHandler } from './instrumentation--6Pioq_G.js';
 import * as React from 'react';
 
 interface Route {
@@ -1304,6 +1304,54 @@ interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>,
      * standard revalidation behavior.
      */
     unstable_defaultShouldRevalidate?: boolean;
+    /**
+     * Masked path for for this navigation, when you want to navigate the router to
+     * one location but display a separate location in the URL bar.
+     *
+     * This is useful for contextual navigations such as opening an image in a modal
+     * on top of a gallery while keeping the underlying gallery active. If a user
+     * shares the masked URL, or opens the link in a new tab, they will only load
+     * the masked location without the underlying contextual location.
+     *
+     * This feature relies on `history.state` and is thus only intended for SPA uses
+     * and SSR renders will not respect the masking.
+     *
+     * ```tsx
+     * // routes/gallery.tsx
+     * export function clientLoader({ request }: Route.LoaderArgs) {
+     *   let sp = new URL(request.url).searchParams;
+     *   return {
+     *     images: getImages(),
+     *     modalImage: sp.has("image") ? getImage(sp.get("image")!) : null,
+     *   };
+     * }
+     *
+     * export default function Gallery({ loaderData }: Route.ComponentProps) {
+     *   return (
+     *     <>
+     *       <GalleryGrid>
+     *        {loaderData.images.map((image) => (
+     *          <Link
+     *            key={image.id}
+     *            to={`/gallery?image=${image.id}`}
+     *            unstable_mask={`/images/${image.id}`}
+     *          >
+     *            <img src={image.url} alt={image.alt} />
+     *          </Link>
+     *        ))}
+     *       </GalleryGrid>
+     *
+     *       {data.modalImage ? (
+     *         <dialog open>
+     *           <img src={data.modalImage.url} alt={data.modalImage.alt} />
+     *         </dialog>
+     *       ) : null}
+     *     </>
+     *   );
+     * }
+     * ```
+     */
+    unstable_mask?: To;
 }
 /**
  * A progressively enhanced [`<a href>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a)
@@ -1334,6 +1382,7 @@ interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>,
  * @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
+ * @param {LinkProps.unstable_mask} props.unstable_mask [modes: framework, data] n/a
  */
 declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLAnchorElement>>;
 /**
@@ -1775,14 +1824,17 @@ declare namespace ScrollRestoration {
  * {@link useViewTransitionState}. Defaults to `false`.
  * @param options.unstable_defaultShouldRevalidate Specify the default revalidation
  * behavior for the navigation. Defaults to `true`.
+ * @param options.unstable_mask Masked location to display in the browser instead
+ * of the router location. Defaults to `undefined`.
  * @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_defaultShouldRevalidate, unstable_useTransitions, }?: {
+declare function useLinkClickHandler<E extends Element = HTMLAnchorElement>(to: To, { target, replace: replaceProp, unstable_mask, state, preventScrollReset, relative, viewTransition, unstable_defaultShouldRevalidate, unstable_useTransitions, }?: {
     target?: React.HTMLAttributeAnchorTarget;
     replace?: boolean;
+    unstable_mask?: To;
     state?: any;
     preventScrollReset?: boolean;
     relative?: RelativeRoutingType;

package/dist/development/{index-react-server-client-MKTlCGL3.d.mts → index-react-server-client-EzWJGpN_.d.mts}

@@ -1,4 +1,4 @@
-import { bG as RouteManifest, q as RouteModules, W as HydrationState, a3 as DataRouteObject, a as ClientLoaderFunction, a7 as StaticHandlerContext, bH 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, bI as History, a6 as GetScrollRestorationKeyFunction, e as RouterInit, bJ 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, bK as CreateStaticHandlerOptions$1, a4 as StaticHandler } from './router-5iOvts3c.mjs';
+import { bG as RouteManifest, q as RouteModules, W as HydrationState, a3 as DataRouteObject, a as ClientLoaderFunction, a7 as StaticHandlerContext, bH 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, bI as History, a6 as GetScrollRestorationKeyFunction, e as RouterInit, bJ 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, bK as CreateStaticHandlerOptions$1, a4 as StaticHandler } from './router-cLsU7kHk.mjs';
 import * as React from 'react';
 
 interface Route {
@@ -1304,6 +1304,54 @@ interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>,
      * standard revalidation behavior.
      */
     unstable_defaultShouldRevalidate?: boolean;
+    /**
+     * Masked path for for this navigation, when you want to navigate the router to
+     * one location but display a separate location in the URL bar.
+     *
+     * This is useful for contextual navigations such as opening an image in a modal
+     * on top of a gallery while keeping the underlying gallery active. If a user
+     * shares the masked URL, or opens the link in a new tab, they will only load
+     * the masked location without the underlying contextual location.
+     *
+     * This feature relies on `history.state` and is thus only intended for SPA uses
+     * and SSR renders will not respect the masking.
+     *
+     * ```tsx
+     * // routes/gallery.tsx
+     * export function clientLoader({ request }: Route.LoaderArgs) {
+     *   let sp = new URL(request.url).searchParams;
+     *   return {
+     *     images: getImages(),
+     *     modalImage: sp.has("image") ? getImage(sp.get("image")!) : null,
+     *   };
+     * }
+     *
+     * export default function Gallery({ loaderData }: Route.ComponentProps) {
+     *   return (
+     *     <>
+     *       <GalleryGrid>
+     *        {loaderData.images.map((image) => (
+     *          <Link
+     *            key={image.id}
+     *            to={`/gallery?image=${image.id}`}
+     *            unstable_mask={`/images/${image.id}`}
+     *          >
+     *            <img src={image.url} alt={image.alt} />
+     *          </Link>
+     *        ))}
+     *       </GalleryGrid>
+     *
+     *       {data.modalImage ? (
+     *         <dialog open>
+     *           <img src={data.modalImage.url} alt={data.modalImage.alt} />
+     *         </dialog>
+     *       ) : null}
+     *     </>
+     *   );
+     * }
+     * ```
+     */
+    unstable_mask?: To;
 }
 /**
  * A progressively enhanced [`<a href>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a)
@@ -1334,6 +1382,7 @@ interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>,
  * @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
+ * @param {LinkProps.unstable_mask} props.unstable_mask [modes: framework, data] n/a
  */
 declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLAnchorElement>>;
 /**
@@ -1775,14 +1824,17 @@ declare namespace ScrollRestoration {
  * {@link useViewTransitionState}. Defaults to `false`.
  * @param options.unstable_defaultShouldRevalidate Specify the default revalidation
  * behavior for the navigation. Defaults to `true`.
+ * @param options.unstable_mask Masked location to display in the browser instead
+ * of the router location. Defaults to `undefined`.
  * @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_defaultShouldRevalidate, unstable_useTransitions, }?: {
+declare function useLinkClickHandler<E extends Element = HTMLAnchorElement>(to: To, { target, replace: replaceProp, unstable_mask, state, preventScrollReset, relative, viewTransition, unstable_defaultShouldRevalidate, unstable_useTransitions, }?: {
     target?: React.HTMLAttributeAnchorTarget;
     replace?: boolean;
+    unstable_mask?: To;
     state?: any;
     preventScrollReset?: boolean;
     relative?: RelativeRoutingType;

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, bA as UNSAFE_WithComponentProps, bE as UNSAFE_WithErrorBoundaryProps, bC as UNSAFE_WithHydrateFallbackProps } from './router-5iOvts3c.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-MKTlCGL3.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, bA as UNSAFE_WithComponentProps, bE as UNSAFE_WithErrorBoundaryProps, bC as UNSAFE_WithHydrateFallbackProps } from './router-cLsU7kHk.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-EzWJGpN_.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, bA as UNSAFE_WithComponentProps, bE as UNSAFE_WithErrorBoundaryProps, bC as UNSAFE_WithHydrateFallbackProps } from './instrumentation-DvHY1sgY.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-1TI9M9o1.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, bA as UNSAFE_WithComponentProps, bE as UNSAFE_WithErrorBoundaryProps, bC as UNSAFE_WithHydrateFallbackProps } from './instrumentation--6Pioq_G.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-C4tCIird.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.13.0
+ * react-router v7.13.1-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -19,7 +19,7 @@
 
 
 
-var _chunkHMDR2CVHjs = require('./chunk-HMDR2CVH.js');
+var _chunkTC44ITIJjs = require('./chunk-TC44ITIJ.js');
 
 
 
@@ -34,7 +34,7 @@ var _chunkHMDR2CVHjs = require('./chunk-HMDR2CVH.js');
 
 
 
-var _chunkWICQJKU6js = require('./chunk-WICQJKU6.js');
+var _chunkLF5SS6XEjs = require('./chunk-LF5SS6XE.js');
 
 
 
@@ -58,4 +58,4 @@ var _chunkWICQJKU6js = require('./chunk-WICQJKU6.js');
 
 
 
-exports.BrowserRouter = _chunkHMDR2CVHjs.BrowserRouter; exports.Form = _chunkHMDR2CVHjs.Form; exports.HashRouter = _chunkHMDR2CVHjs.HashRouter; exports.Link = _chunkHMDR2CVHjs.Link; exports.Links = _chunkWICQJKU6js.Links; exports.MemoryRouter = _chunkWICQJKU6js.MemoryRouter; exports.Meta = _chunkWICQJKU6js.Meta; exports.NavLink = _chunkHMDR2CVHjs.NavLink; exports.Navigate = _chunkWICQJKU6js.Navigate; exports.Outlet = _chunkWICQJKU6js.Outlet; exports.Route = _chunkWICQJKU6js.Route; exports.Router = _chunkWICQJKU6js.Router; exports.RouterProvider = _chunkWICQJKU6js.RouterProvider; exports.Routes = _chunkWICQJKU6js.Routes; exports.ScrollRestoration = _chunkHMDR2CVHjs.ScrollRestoration; exports.StaticRouter = _chunkHMDR2CVHjs.StaticRouter; exports.StaticRouterProvider = _chunkHMDR2CVHjs.StaticRouterProvider; exports.UNSAFE_AwaitContextProvider = _chunkWICQJKU6js.AwaitContextProvider; exports.UNSAFE_WithComponentProps = _chunkWICQJKU6js.WithComponentProps; exports.UNSAFE_WithErrorBoundaryProps = _chunkWICQJKU6js.WithErrorBoundaryProps; exports.UNSAFE_WithHydrateFallbackProps = _chunkWICQJKU6js.WithHydrateFallbackProps; exports.unstable_HistoryRouter = _chunkHMDR2CVHjs.HistoryRouter;
+exports.BrowserRouter = _chunkTC44ITIJjs.BrowserRouter; exports.Form = _chunkTC44ITIJjs.Form; exports.HashRouter = _chunkTC44ITIJjs.HashRouter; exports.Link = _chunkTC44ITIJjs.Link; exports.Links = _chunkLF5SS6XEjs.Links; exports.MemoryRouter = _chunkLF5SS6XEjs.MemoryRouter; exports.Meta = _chunkLF5SS6XEjs.Meta; exports.NavLink = _chunkTC44ITIJjs.NavLink; exports.Navigate = _chunkLF5SS6XEjs.Navigate; exports.Outlet = _chunkLF5SS6XEjs.Outlet; exports.Route = _chunkLF5SS6XEjs.Route; exports.Router = _chunkLF5SS6XEjs.Router; exports.RouterProvider = _chunkLF5SS6XEjs.RouterProvider; exports.Routes = _chunkLF5SS6XEjs.Routes; exports.ScrollRestoration = _chunkTC44ITIJjs.ScrollRestoration; exports.StaticRouter = _chunkTC44ITIJjs.StaticRouter; exports.StaticRouterProvider = _chunkTC44ITIJjs.StaticRouterProvider; exports.UNSAFE_AwaitContextProvider = _chunkLF5SS6XEjs.AwaitContextProvider; exports.UNSAFE_WithComponentProps = _chunkLF5SS6XEjs.WithComponentProps; exports.UNSAFE_WithErrorBoundaryProps = _chunkLF5SS6XEjs.WithErrorBoundaryProps; exports.UNSAFE_WithHydrateFallbackProps = _chunkLF5SS6XEjs.WithHydrateFallbackProps; exports.unstable_HistoryRouter = _chunkTC44ITIJjs.HistoryRouter;

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

@@ -1,5 +1,5 @@
 /**
- * react-router v7.13.0
+ * react-router v7.13.1-pre.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -32,7 +32,7 @@ import {
   WithComponentProps,
   WithErrorBoundaryProps,
   WithHydrateFallbackProps
-} from "./chunk-JZWAC4HX.mjs";
+} from "./chunk-WQZSGSJA.mjs";
 export {
   BrowserRouter,
   Form,

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

@@ -60,6 +60,11 @@ interface Location<State = any> extends Path {
      * Note: This value is always "default" on the initial location.
      */
     key: string;
+    /**
+     * The masked location displayed in the URL bar, which differs from the URL the
+     * router is operating on
+     */
+    unstable_mask: Path | undefined;
 }
 /**
  * A change to the current location.
@@ -1224,6 +1229,10 @@ interface RouterState {
      * Tracks whether we've completed our initial data load
      */
     initialized: boolean;
+    /**
+     * Tracks whether we should be rendering a HydrateFallback during hydration
+     */
+    renderFallback: boolean;
     /**
      * Current scroll position we should start at for a new view
      *  - number -> scroll position to restore to
@@ -1376,6 +1385,7 @@ type BaseNavigateOptions = BaseNavigateOrFetchOptions & {
     state?: any;
     fromRouteId?: string;
     viewTransition?: boolean;
+    unstable_mask?: To;
 };
 type BaseSubmissionOptions = {
     formMethod?: HTMLFormMethod;
@@ -2097,6 +2107,7 @@ type LdJsonValue = LdJsonPrimitive | LdJsonObject | LdJsonArray;
  */
 type RouteHandle = unknown;
 
+declare function getRequest(): Request;
 declare const redirect: typeof redirect$1;
 declare const redirectDocument: typeof redirectDocument$1;
 declare const replace: typeof replace$1;
@@ -2550,4 +2561,4 @@ interface MemorySessionStorageOptions {
  */
 declare function createMemorySessionStorage<Data = SessionData, FlashData = Data>({ cookie }?: MemorySessionStorageOptions): SessionStorage<Data, FlashData>;
 
-export { Await, type Cookie, type CookieOptions, type CookieSignatureOptions, type FlashSessionData, type IsCookieFunction, type IsSessionFunction, type MiddlewareFunction, type MiddlewareNextFunction, type RouterContext, RouterContextProvider, type Session, type SessionData, type SessionIdStorageStrategy, type SessionStorage, createContext, createCookie, createCookieSessionStorage, createMemorySessionStorage, createSession, createSessionStorage, createStaticHandler, data, href, isCookie, isRouteErrorResponse, isSession, matchRoutes, redirect, redirectDocument, replace, type DecodeActionFunction as unstable_DecodeActionFunction, type DecodeFormStateFunction as unstable_DecodeFormStateFunction, type DecodeReplyFunction as unstable_DecodeReplyFunction, type LoadServerActionFunction as unstable_LoadServerActionFunction, type RSCManifestPayload as unstable_RSCManifestPayload, type RSCMatch as unstable_RSCMatch, type RSCPayload as unstable_RSCPayload, type RSCRenderPayload as unstable_RSCRenderPayload, type RSCRouteConfig as unstable_RSCRouteConfig, type RSCRouteConfigEntry as unstable_RSCRouteConfigEntry, type RSCRouteManifest as unstable_RSCRouteManifest, type RSCRouteMatch as unstable_RSCRouteMatch, matchRSCServerRequest as unstable_matchRSCServerRequest };
+export { Await, type Cookie, type CookieOptions, type CookieSignatureOptions, type FlashSessionData, type IsCookieFunction, type IsSessionFunction, type MiddlewareFunction, type MiddlewareNextFunction, type RouterContext, RouterContextProvider, type Session, type SessionData, type SessionIdStorageStrategy, type SessionStorage, createContext, createCookie, createCookieSessionStorage, createMemorySessionStorage, createSession, createSessionStorage, createStaticHandler, data, href, isCookie, isRouteErrorResponse, isSession, matchRoutes, redirect, redirectDocument, replace, type DecodeActionFunction as unstable_DecodeActionFunction, type DecodeFormStateFunction as unstable_DecodeFormStateFunction, type DecodeReplyFunction as unstable_DecodeReplyFunction, type LoadServerActionFunction as unstable_LoadServerActionFunction, type RSCManifestPayload as unstable_RSCManifestPayload, type RSCMatch as unstable_RSCMatch, type RSCPayload as unstable_RSCPayload, type RSCRenderPayload as unstable_RSCRenderPayload, type RSCRouteConfig as unstable_RSCRouteConfig, type RSCRouteConfigEntry as unstable_RSCRouteConfigEntry, type RSCRouteManifest as unstable_RSCRouteManifest, type RSCRouteMatch as unstable_RSCRouteMatch, getRequest as unstable_getRequest, matchRSCServerRequest as unstable_matchRSCServerRequest };

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

@@ -60,6 +60,11 @@ interface Location<State = any> extends Path {
      * Note: This value is always "default" on the initial location.
      */
     key: string;
+    /**
+     * The masked location displayed in the URL bar, which differs from the URL the
+     * router is operating on
+     */
+    unstable_mask: Path | undefined;
 }
 /**
  * A change to the current location.
@@ -1224,6 +1229,10 @@ interface RouterState {
      * Tracks whether we've completed our initial data load
      */
     initialized: boolean;
+    /**
+     * Tracks whether we should be rendering a HydrateFallback during hydration
+     */
+    renderFallback: boolean;
     /**
      * Current scroll position we should start at for a new view
      *  - number -> scroll position to restore to
@@ -1376,6 +1385,7 @@ type BaseNavigateOptions = BaseNavigateOrFetchOptions & {
     state?: any;
     fromRouteId?: string;
     viewTransition?: boolean;
+    unstable_mask?: To;
 };
 type BaseSubmissionOptions = {
     formMethod?: HTMLFormMethod;
@@ -2097,6 +2107,7 @@ type LdJsonValue = LdJsonPrimitive | LdJsonObject | LdJsonArray;
  */
 type RouteHandle = unknown;
 
+declare function getRequest(): Request;
 declare const redirect: typeof redirect$1;
 declare const redirectDocument: typeof redirectDocument$1;
 declare const replace: typeof replace$1;
@@ -2550,4 +2561,4 @@ interface MemorySessionStorageOptions {
  */
 declare function createMemorySessionStorage<Data = SessionData, FlashData = Data>({ cookie }?: MemorySessionStorageOptions): SessionStorage<Data, FlashData>;
 
-export { Await, type Cookie, type CookieOptions, type CookieSignatureOptions, type FlashSessionData, type IsCookieFunction, type IsSessionFunction, type MiddlewareFunction, type MiddlewareNextFunction, type RouterContext, RouterContextProvider, type Session, type SessionData, type SessionIdStorageStrategy, type SessionStorage, createContext, createCookie, createCookieSessionStorage, createMemorySessionStorage, createSession, createSessionStorage, createStaticHandler, data, href, isCookie, isRouteErrorResponse, isSession, matchRoutes, redirect, redirectDocument, replace, type DecodeActionFunction as unstable_DecodeActionFunction, type DecodeFormStateFunction as unstable_DecodeFormStateFunction, type DecodeReplyFunction as unstable_DecodeReplyFunction, type LoadServerActionFunction as unstable_LoadServerActionFunction, type RSCManifestPayload as unstable_RSCManifestPayload, type RSCMatch as unstable_RSCMatch, type RSCPayload as unstable_RSCPayload, type RSCRenderPayload as unstable_RSCRenderPayload, type RSCRouteConfig as unstable_RSCRouteConfig, type RSCRouteConfigEntry as unstable_RSCRouteConfigEntry, type RSCRouteManifest as unstable_RSCRouteManifest, type RSCRouteMatch as unstable_RSCRouteMatch, matchRSCServerRequest as unstable_matchRSCServerRequest };
+export { Await, type Cookie, type CookieOptions, type CookieSignatureOptions, type FlashSessionData, type IsCookieFunction, type IsSessionFunction, type MiddlewareFunction, type MiddlewareNextFunction, type RouterContext, RouterContextProvider, type Session, type SessionData, type SessionIdStorageStrategy, type SessionStorage, createContext, createCookie, createCookieSessionStorage, createMemorySessionStorage, createSession, createSessionStorage, createStaticHandler, data, href, isCookie, isRouteErrorResponse, isSession, matchRoutes, redirect, redirectDocument, replace, type DecodeActionFunction as unstable_DecodeActionFunction, type DecodeFormStateFunction as unstable_DecodeFormStateFunction, type DecodeReplyFunction as unstable_DecodeReplyFunction, type LoadServerActionFunction as unstable_LoadServerActionFunction, type RSCManifestPayload as unstable_RSCManifestPayload, type RSCMatch as unstable_RSCMatch, type RSCPayload as unstable_RSCPayload, type RSCRenderPayload as unstable_RSCRenderPayload, type RSCRouteConfig as unstable_RSCRouteConfig, type RSCRouteConfigEntry as unstable_RSCRouteConfigEntry, type RSCRouteManifest as unstable_RSCRouteManifest, type RSCRouteMatch as unstable_RSCRouteMatch, getRequest as unstable_getRequest, matchRSCServerRequest as unstable_matchRSCServerRequest };