react-router 7.14.2 → 7.15.1

package/dist/production/index.mjs

@@ -1,5 +1,5 @@
 /**
- * react-router v7.14.2
+ * react-router v7.15.1
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -28,7 +28,7 @@ import {
   isSession,
   routeRSCServerRequest,
   setDevServerHooks
-} from "./chunk-2WLZNCK5.mjs";
+} from "./chunk-6S4627ZB.mjs";
 import {
   Action,
   Await,
@@ -133,6 +133,7 @@ import {
   useRoute,
   useRouteError,
   useRouteLoaderData,
+  useRouterState,
   useRoutes,
   useScrollRestoration,
   useSearchParams,
@@ -141,7 +142,7 @@ import {
   withComponentProps,
   withErrorBoundaryProps,
   withHydrateFallbackProps
-} from "./chunk-LK6U7ULH.mjs";
+} from "./chunk-JAKZPQZC.mjs";
 export {
   Await,
   BrowserRouter,
@@ -243,6 +244,7 @@ export {
   setDevServerHooks as unstable_setDevServerHooks,
   usePrompt as unstable_usePrompt,
   useRoute as unstable_useRoute,
+  useRouterState as unstable_useRouterState,
   useActionData,
   useAsyncError,
   useAsyncValue,

package/dist/{development/instrumentation-g0dG8UL0.d.ts → production/instrumentation-cRWWLfsU.d.ts}

@@ -1,4 +1,4 @@
-import { e as RouteObject, f as History, g as MaybePromise, c as RouterContextProvider, h as MapRoutePropertiesFunction, i as Action, L as Location, D as DataRouteMatch, j as Submission, k as RouteData, l as DataStrategyFunction, m as PatchRoutesOnNavigationFunction, n as DataRouteObject, U as UIMatch, T as To, o as HTMLFormMethod, F as FormEncType, p as Path, q as LoaderFunctionArgs, r as MiddlewareEnabled, s as AppLoadContext } from './routeModules-7rtk67cd.js';
+import { e as RouteObject, f as History, g as MaybePromise, c as RouterContextProvider, h as MapRoutePropertiesFunction, i as Action, L as Location, D as DataRouteMatch, j as Submission, k as RouteData, l as DataStrategyFunction, m as PatchRoutesOnNavigationFunction, n as DataRouteObject, o as RouteBranch, p as RouteManifest, U as UIMatch, T as To, q as HTMLFormMethod, F as FormEncType, r as Path, s as LoaderFunctionArgs, t as MiddlewareEnabled, u as AppLoadContext } from './data-BqZ2x964.js';
 
 /**
  * A Router instance manages all navigation and data loading/mutations
@@ -32,6 +32,20 @@ interface Router {
      * Return the routes for this router instance
      */
     get routes(): DataRouteObject[];
+    /**
+     * @private
+     * PRIVATE - DO NOT USE
+     *
+     * Return the route branches for this router instance
+     */
+    get branches(): RouteBranch<DataRouteObject>[] | undefined;
+    /**
+     * @private
+     * PRIVATE - DO NOT USE
+     *
+     * Return the manifest for this router instance
+     */
+    get manifest(): RouteManifest;
     /**
      * @private
      * PRIVATE - DO NOT USE
@@ -279,7 +293,6 @@ type HydrationState = Partial<Pick<RouterState, "loaderData" | "actionData" | "e
  * Future flags to toggle new feature behavior
  */
 interface FutureConfig {
-    unstable_passThroughRequests: boolean;
 }
 /**
  * Initialization options for createRouter
@@ -289,7 +302,7 @@ interface RouterInit {
     history: History;
     basename?: string;
     getContext?: () => MaybePromise<RouterContextProvider>;
-    unstable_instrumentations?: unstable_ClientInstrumentation[];
+    instrumentations?: ClientInstrumentation[];
     mapRouteProperties?: MapRoutePropertiesFunction;
     future?: Partial<FutureConfig>;
     hydrationRouteProperties?: string[];
@@ -317,7 +330,33 @@ interface StaticHandlerContext {
  * A StaticHandler instance manages a singular SSR navigation/fetch event
  */
 interface StaticHandler {
+    /**
+     * The set of data routes managed by this handler
+     */
     dataRoutes: DataRouteObject[];
+    /**
+     * @private
+     * PRIVATE - DO NOT USE
+     *
+     * The route branches derived from the data routes, used for internal route
+     * matching in Framework Mode
+     */
+    _internalRouteBranches: RouteBranch<DataRouteObject>[];
+    /**
+     * Perform a query for a given request - executing all matched route
+     * loaders/actions.  Used for document requests.
+     *
+     * @param request The request to query
+     * @param opts Optional query options
+     * @param opts.dataStrategy Alternate dataStrategy implementation
+     * @param opts.filterMatchesToLoad Predicate function to filter which matches should be loaded
+     * @param opts.generateMiddlewareResponse To enable middleware, provide a function
+     * to generate a response to bubble back up the middleware chain
+     * @param opts.requestContext Context object to pass to loaders/actions
+     * @param opts.skipLoaderErrorBubbling Skip loader error bubbling
+     * @param opts.skipRevalidation Skip revalidation after action submission
+     * @param opts.normalizePath Normalize the request path
+     */
     query(request: Request, opts?: {
         requestContext?: unknown;
         filterMatchesToLoad?: (match: DataRouteMatch) => boolean;
@@ -327,14 +366,27 @@ interface StaticHandler {
         generateMiddlewareResponse?: (query: (r: Request, args?: {
             filterMatchesToLoad?: (match: DataRouteMatch) => boolean;
         }) => Promise<StaticHandlerContext | Response>) => MaybePromise<Response>;
-        unstable_normalizePath?: (request: Request) => Path;
+        normalizePath?: (request: Request) => Path;
     }): Promise<StaticHandlerContext | Response>;
+    /**
+     * Perform a query for a specific route.  Used for resource requests.
+     *
+     * @param request The request to query
+     * @param opts Optional queryRoute options
+     * @param opts.dataStrategy Alternate dataStrategy implementation
+     * @param opts.generateMiddlewareResponse To enable middleware, provide a function
+     * to generate a response to bubble back up the middleware chain
+     * @param opts.requestContext Context object to pass to loaders/actions
+     * @param opts.routeId The ID of the route to query
+     * @param opts.normalizePath Normalize the request path
+  
+     */
     queryRoute(request: Request, opts?: {
         routeId?: string;
         requestContext?: unknown;
         dataStrategy?: DataStrategyFunction<unknown>;
         generateMiddlewareResponse?: (queryRoute: (r: Request) => Promise<Response>) => MaybePromise<Response>;
-        unstable_normalizePath?: (request: Request) => Path;
+        normalizePath?: (request: Request) => Path;
     }): Promise<any>;
 }
 type ViewTransitionOpts = {
@@ -378,14 +430,14 @@ type BaseNavigateOrFetchOptions = {
     preventScrollReset?: boolean;
     relative?: RelativeRoutingType;
     flushSync?: boolean;
-    unstable_defaultShouldRevalidate?: boolean;
+    defaultShouldRevalidate?: boolean;
 };
 type BaseNavigateOptions = BaseNavigateOrFetchOptions & {
     replace?: boolean;
     state?: any;
     fromRouteId?: string;
     viewTransition?: boolean;
-    unstable_mask?: To;
+    mask?: To;
 };
 type BaseSubmissionOptions = {
     formMethod?: HTMLFormMethod;
@@ -428,6 +480,8 @@ type NavigationStates = {
     Idle: {
         state: "idle";
         location: undefined;
+        matches: undefined;
+        historyAction: undefined;
         formMethod: undefined;
         formAction: undefined;
         formEncType: undefined;
@@ -438,6 +492,8 @@ type NavigationStates = {
     Loading: {
         state: "loading";
         location: Location;
+        matches: DataRouteMatch[];
+        historyAction: Action;
         formMethod: Submission["formMethod"] | undefined;
         formAction: Submission["formAction"] | undefined;
         formEncType: Submission["formEncType"] | undefined;
@@ -448,6 +504,8 @@ type NavigationStates = {
     Submitting: {
         state: "submitting";
         location: Location;
+        matches: DataRouteMatch[];
+        historyAction: Action;
         formMethod: Submission["formMethod"];
         formAction: Submission["formAction"];
         formEncType: Submission["formEncType"];
@@ -568,29 +626,29 @@ declare function createRouter(init: RouterInit): Router;
 interface CreateStaticHandlerOptions {
     basename?: string;
     mapRouteProperties?: MapRoutePropertiesFunction;
-    unstable_instrumentations?: Pick<unstable_ServerInstrumentation, "route">[];
+    instrumentations?: Pick<ServerInstrumentation, "route">[];
     future?: Partial<FutureConfig>;
 }
 
-type unstable_ServerInstrumentation = {
-    handler?: unstable_InstrumentRequestHandlerFunction;
-    route?: unstable_InstrumentRouteFunction;
+type ServerInstrumentation = {
+    handler?: InstrumentRequestHandlerFunction;
+    route?: InstrumentRouteFunction;
 };
-type unstable_ClientInstrumentation = {
-    router?: unstable_InstrumentRouterFunction;
-    route?: unstable_InstrumentRouteFunction;
+type ClientInstrumentation = {
+    router?: InstrumentRouterFunction;
+    route?: InstrumentRouteFunction;
 };
-type unstable_InstrumentRequestHandlerFunction = (handler: InstrumentableRequestHandler) => void;
-type unstable_InstrumentRouterFunction = (router: InstrumentableRouter) => void;
-type unstable_InstrumentRouteFunction = (route: InstrumentableRoute) => void;
-type unstable_InstrumentationHandlerResult = {
+type InstrumentRequestHandlerFunction = (handler: InstrumentableRequestHandler) => void;
+type InstrumentRouterFunction = (router: InstrumentableRouter) => void;
+type InstrumentRouteFunction = (route: InstrumentableRoute) => void;
+type InstrumentationHandlerResult = {
     status: "success";
     error: undefined;
 } | {
     status: "error";
     error: Error;
 };
-type InstrumentFunction<T> = (handler: () => Promise<unstable_InstrumentationHandlerResult>, info: T) => Promise<void>;
+type InstrumentFunction<T> = (handler: () => Promise<InstrumentationHandlerResult>, info: T) => Promise<void>;
 type ReadonlyRequest = {
     method: string;
     url: string;
@@ -616,7 +674,7 @@ type RouteLazyInstrumentationInfo = undefined;
 type RouteHandlerInstrumentationInfo = Readonly<{
     request: ReadonlyRequest;
     params: LoaderFunctionArgs["params"];
-    unstable_pattern: string;
+    pattern: string;
     context: ReadonlyContext;
 }>;
 type InstrumentableRouter = {
@@ -654,4 +712,4 @@ type RequestHandlerInstrumentationInfo = Readonly<{
     context: ReadonlyContext | undefined;
 }>;
 
-export { type BlockerFunction as B, type CreateStaticHandlerOptions as C, type Fetcher as F, type GetScrollPositionFunction as G, type HydrationState as H, IDLE_NAVIGATION as I, type Navigation as N, type RouterInit as R, type StaticHandler as S, type Router as a, type Blocker as b, type RelativeRoutingType as c, type RouterState as d, type GetScrollRestorationKeyFunction as e, type StaticHandlerContext as f, type NavigationStates as g, type RouterSubscriber as h, type RouterNavigateOptions as i, type RouterFetchOptions as j, type RevalidationState as k, type unstable_ServerInstrumentation as l, type unstable_InstrumentRequestHandlerFunction as m, type unstable_InstrumentRouterFunction as n, type unstable_InstrumentRouteFunction as o, type unstable_InstrumentationHandlerResult as p, IDLE_FETCHER as q, IDLE_BLOCKER as r, createRouter as s, type FutureConfig as t, type unstable_ClientInstrumentation as u };
+export { type BlockerFunction as B, type ClientInstrumentation as C, type Fetcher as F, type GetScrollPositionFunction as G, type HydrationState as H, type InstrumentRequestHandlerFunction as I, type NavigationStates as N, type RouterInit as R, type StaticHandler as S, type Router as a, type Blocker as b, type RelativeRoutingType as c, type Navigation as d, type RouterState as e, type GetScrollRestorationKeyFunction as f, type StaticHandlerContext as g, type RouterSubscriber as h, type RouterNavigateOptions as i, type RouterFetchOptions as j, type RevalidationState as k, type ServerInstrumentation as l, type InstrumentRouterFunction as m, type InstrumentRouteFunction as n, type InstrumentationHandlerResult as o, IDLE_NAVIGATION as p, IDLE_FETCHER as q, IDLE_BLOCKER as r, createRouter as s, type FutureConfig as t, type CreateStaticHandlerOptions as u };

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

@@ -1,5 +1,5 @@
-import { R as RouteModule, e as LinkDescriptor, L as Location, F as Func, f as Pretty, g as MetaDescriptor, G as GetLoaderData, h as ServerDataFunctionArgs, i as MiddlewareNextFunction, j as ClientDataFunctionArgs, D as DataStrategyResult, k as ServerDataFrom, N as Normalize, l as GetActionData } from '../../routeModules-BW4a8k3I.mjs';
-import { R as RouteFiles, P as Pages } from '../../register-D9d2sMQ7.mjs';
+import { R as RouteModule, e as LinkDescriptor, L as Location, F as Func, f as Pretty, g as MetaDescriptor, G as GetLoaderData, h as ServerDataFunctionArgs, i as MiddlewareNextFunction, j as ClientDataFunctionArgs, D as DataStrategyResult, k as ServerDataFrom, N as Normalize, l as GetActionData } from '../../data-BVUf681J.mjs';
+import { R as RouteFiles, P as Pages } from '../../register-Df8okEea.mjs';
 import 'react';
 
 type MaybePromise<T> = T | Promise<T>;

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

@@ -1,5 +1,5 @@
-import { R as RouteModule, t as LinkDescriptor, L as Location, u as Func, v as Pretty, w as MetaDescriptor, G as GetLoaderData, x as ServerDataFunctionArgs, y as MiddlewareNextFunction, z as ClientDataFunctionArgs, B as DataStrategyResult, E as ServerDataFrom, N as Normalize, I as GetActionData } from '../../routeModules-7rtk67cd.js';
-import { R as RouteFiles, P as Pages } from '../../register-DcBltf5q.js';
+import { R as RouteModule, v as LinkDescriptor, L as Location, w as Func, x as Pretty, y as MetaDescriptor, G as GetLoaderData, z as ServerDataFunctionArgs, B as MiddlewareNextFunction, E as ClientDataFunctionArgs, I as DataStrategyResult, J as ServerDataFrom, N as Normalize, K as GetActionData } from '../../data-BqZ2x964.js';
+import { R as RouteFiles, P as Pages } from '../../register-Bsscfj79.js';
 import 'react';
 
 type MaybePromise<T> = T | Promise<T>;

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

@@ -1,5 +1,5 @@
 "use strict";/**
- * react-router v7.14.2
+ * react-router v7.15.1
  *
  * Copyright (c) Remix Software Inc.
  *

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

@@ -1,5 +1,5 @@
 /**
- * react-router v7.14.2
+ * react-router v7.15.1
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/{development/register-D9d2sMQ7.d.mts → production/register-Bsscfj79.d.ts}

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

package/dist/production/{register-D9d2sMQ7.d.mts → register-Df8okEea.d.mts}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-router",
-  "version": "7.14.2",
+  "version": "7.15.1",
   "description": "Declarative routing for React",
   "keywords": [
     "react",