@react-router/dev 8.3.1 → 8.5.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # `@react-router/dev`
 
+## v8.5.0
+
+### Patch Changes
+
+- Fix critical CSS collection in dev registering server-only route imports as client dependencies, which triggered dependency re-optimization and full page reloads ([#15595](https://github.com/remix-run/react-router/pull/15595))
+- Fix intermittent `Prerender: Request failed for ... connect ECONNREFUSED` errors during prerendering ([#15325](https://github.com/remix-run/react-router/pull/15325))
+  - Send requests to the address the Vite preview server bound to
+  - Avoid re-resolving `localhost` for each request, which could select a different address family (`127.0.0.1` vs `::1`)
+
+### Unstable Changes
+
+⚠️  _[Unstable features](https://reactrouter.com/community/api-development-strategy#unstable-flags) are not recommended for production use_
+
+- Add `ssr: "unstable_api-only"` to retain a runtime server for loaders, actions, and route discovery while disabling production document rendering ([#15601](https://github.com/remix-run/react-router/pull/15601))
+  - Generate a root-only SPA shell when prerendering is disabled
+  - Support prerendered pages and data files alongside runtime loaders and actions, with a SPA fallback for non-prerendered paths
+  - Default API-only builds to lazy route discovery
+  - Reject API-only configuration in RSC Framework Mode
+  - Preserve server-only route exports in additional Vite server environments in both API-only and SSR modes
+  - Serve prerendered pages and the SPA fallback in Vite preview while retaining live data requests and route discovery
+- Add the `future.unstable_customRouteDiscovery` flag to opt into application-controlled route discovery in conventional Framework Mode ([#15602](https://github.com/remix-run/react-router/pull/15602))
+- Fix source maps for route modules in unstable RSC Framework Mode ([#15479](https://github.com/remix-run/react-router/pull/15479))
+- Add `unstable_apiServerOrigin` to configure the origin for API-only loader, action, and route discovery requests ([#15601](https://github.com/remix-run/react-router/pull/15601))
+- Updated dependencies:
+  - [`react-router@8.5.0`](https://github.com/remix-run/react-router/releases/tag/react-router@8.5.0)
+  - [`@react-router/node@8.5.0`](https://github.com/remix-run/react-router/releases/tag/@react-router/node@8.5.0)
+  - [`@react-router/serve@8.5.0`](https://github.com/remix-run/react-router/releases/tag/@react-router/serve@8.5.0)
+
+## v8.4.0
+
+### Patch Changes
+
+- Fix action submissions behind an HTTPS reverse proxy in `react-router dev` and `vite preview` by using `X-Forwarded-Proto` when constructing `request.url` ([#15466](https://github.com/remix-run/react-router/pull/15466))
+  - No React Router configuration is required
+  - The URL host continues to come from `Host`, not `X-Forwarded-Host`
+  - Configure reverse proxies to overwrite client-supplied `X-Forwarded-Proto` headers
+  - Do not expose dev or preview servers publicly
+- Pass development conditions as CLI flags when relaunching the dev process ([#15435](https://github.com/remix-run/react-router/pull/15435))
+- Fix stack trace locations for split route modules when source maps are enabled in the `reactRouter` Vite plugin ([#15440](https://github.com/remix-run/react-router/pull/15440))
+- Updated dependencies:
+  - [`react-router@8.4.0`](https://github.com/remix-run/react-router/releases/tag/react-router@8.4.0)
+  - [`@react-router/node@8.4.0`](https://github.com/remix-run/react-router/releases/tag/@react-router/node@8.4.0)
+  - [`@react-router/serve@8.4.0`](https://github.com/remix-run/react-router/releases/tag/@react-router/serve@8.4.0)
+
 ## v8.3.1
 
 ### Patch Changes

package/dist/{build-Ou3B3epu.js → build-ZbZgdE7Y.js}

@@ -1,5 +1,5 @@
 /**
- * @react-router/dev v8.3.1
+ * @react-router/dev v8.5.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import { _ as getVite, v as preloadVite } from "./typegen-DxFMuBQP.js";
+import { _ as getVite, v as preloadVite } from "./typegen-CiHN93zF.js";
 //#region vite/build.ts
 async function build(root, viteBuildOptions) {
 	await preloadVite();

package/dist/cli/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * @react-router/dev v8.3.1
+ * @react-router/dev v8.5.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -9,7 +9,7 @@
  *
  * @license MIT
  */
-import { _ as getVite, l as hasNodeDependency, n as watch, t as run$1, u as loadConfig, v as preloadVite } from "../typegen-DxFMuBQP.js";
+import { _ as getVite, l as hasNodeDependency, n as watch, t as run$1, u as loadConfig, v as preloadVite } from "../typegen-CiHN93zF.js";
 import { createRequire } from "node:module";
 import { parseArgs } from "node:util";
 import semver from "semver";
@@ -107,20 +107,34 @@ async function hasReactRouterRscPlugin({ root, viteBuildOptions: { config, logLe
 //#endregion
 //#region restart-with-conditions.ts
 /**
-* Restarts the current Node process, appending new flags to the
-* existing NODE_OPTIONS. SIGINT/SIGTERM are always forwarded to the child.
+* Build the child process invocation used to relaunch the CLI with extra flags.
+*
+* Extra flags are placed on argv immediately after the runtime binary. Putting
+* them in NODE_OPTIONS is not portable: Bun silently ignores `--conditions`
+* there, so the child would restart again and hit the already-restarted guard.
 */
-function restartWithMergedOptions(nodeOptions) {
-	if (process$1.env.REACT_ROUTER_DEV_RESTARTED === "true") throw new Error("restartWithMergedOptions() was called, but the process has already been restarted. This is likely a bug in @react-router/dev.");
-	const mergedOptions = [process$1.env.NODE_OPTIONS, nodeOptions].filter(Boolean).join(" ").trim();
-	console.log(`[restart] Relaunching with NODE_OPTIONS: ${mergedOptions}`);
-	const [cmd, ...args] = process$1.argv;
-	const child = spawn(cmd, args, {
+function resolveRestartSpawn(argv, extraOptions, env) {
+	const extraArgs = extraOptions.split(/\s+/).filter(Boolean);
+	const [command, ...args] = argv;
+	return {
+		command,
+		args: [...extraArgs, ...args],
 		env: {
-			...process$1.env,
-			NODE_OPTIONS: mergedOptions,
+			...env,
 			REACT_ROUTER_DEV_RESTARTED: "true"
-		},
+		}
+	};
+}
+/**
+* Restarts the current process with extra CLI flags after argv[0].
+* SIGINT/SIGTERM are always forwarded to the child.
+*/
+function restartWithMergedOptions(nodeOptions) {
+	if (process$1.env.REACT_ROUTER_DEV_RESTARTED === "true") throw new Error("restartWithMergedOptions() was called, but the process has already been restarted. This is likely a bug in @react-router/dev.");
+	const { command, args, env } = resolveRestartSpawn(process$1.argv, nodeOptions, process$1.env);
+	console.log(`[restart] Relaunching with ${nodeOptions}`);
+	const child = spawn(command, args, {
+		env,
 		stdio: "inherit"
 	});
 	let signalHandlers = ["SIGINT", "SIGTERM"].map((sig) => {
@@ -158,7 +172,7 @@ async function routes(rootDirectory, flags = {}) {
 }
 async function build(root, options = {}) {
 	root = resolveRootDirectory(root, options);
-	let { build } = await import("../build-Ou3B3epu.js");
+	let { build } = await import("../build-ZbZgdE7Y.js");
 	if (options.profile) await start();
 	try {
 		await build(root, options);
@@ -168,7 +182,7 @@ async function build(root, options = {}) {
 }
 async function dev(root, options = {}) {
 	if (developmentConditionEnabled) {
-		let { dev } = await import("../dev-DFccbHpq.js");
+		let { dev } = await import("../dev-DGFm0uWr.js");
 		if (options.profile) await start();
 		exitHook(() => stop(console.info));
 		root = resolveRootDirectory(root, options);

package/dist/{config-t89niiFv.d.ts → config-DP95WFpo.d.ts}

@@ -38,6 +38,7 @@ type ServerBundlesBuildManifest = BaseBuildManifest & {
 };
 type ServerModuleFormat = "esm" | "cjs";
 interface FutureConfig {
+  unstable_customRouteDiscovery: boolean;
   unstable_enableNodeReadableStream: boolean;
   unstable_optimizeDeps: boolean;
 }
@@ -140,12 +141,30 @@ type ReactRouterConfig = {
    */
   serverBundles?: ServerBundlesFunction;
   /**
-   * Enable server-side rendering for your application. Disable to use "SPA
-   * Mode", which will request the `/` path at build-time and save it as an
-   * `index.html` file with your assets so your application can be deployed as a
-   * SPA without server-rendering. Default's to `true`.
+   * Control runtime server-side document rendering. Defaults to `true`.
+   *
+   * Set `false` to generate a static client build without a runtime server.
+   * Without prerendering, this generates a root-only SPA shell. With
+   * prerendering, it generates HTML and data files for selected paths plus
+   * a SPA fallback for non-prerendered paths.
+   *
+   * Set `"unstable_api-only"` to retain a runtime server for loaders, actions,
+   * and route discovery while disabling production document rendering.
+   * Documents follow the same prerendering and SPA fallback behavior as
+   * `ssr:false`, with runtime loaders and actions available for all routes.
+   * API-only mode is unstable and is not supported in RSC Framework Mode.
+   */
+  ssr?: boolean | "unstable_api-only";
+  /**
+   * The origin to use for server requests when `ssr` is `"unstable_api-only"`.
+   * This is ignored when `ssr` is `true` or `false`. Defaults to the same
+   * origin that serves the client build. Applies to loader, action, and route
+   * discovery requests.
+   *
+   * **Note:** The server origin will need to be configured appropriately for
+   * Cross-Origin Request Sharing (CORS).
    */
-  ssr?: boolean;
+  unstable_apiServerOrigin?: string;
   /**
    * Enable subresource integrity hashes on asset script tags. Defaults to
    * `false`.
@@ -256,12 +275,24 @@ type ResolvedReactRouterConfig = Readonly<{
    */
   serverModuleFormat: ServerModuleFormat;
   /**
-   * Enable server-side rendering for your application. Disable to use "SPA
-   * Mode", which will request the `/` path at build-time and save it as an
-   * `index.html` file with your assets so your application can be deployed as a
-   * SPA without server-rendering. Default's to `true`.
+   * Control runtime server-side document rendering. Defaults to `true`.
+   *
+   * Set `false` to generate a static client build without a runtime server.
+   * Without prerendering, this generates a root-only SPA shell. With
+   * prerendering, it generates HTML and data files for selected paths plus
+   * a SPA fallback for non-prerendered paths.
+   *
+   * Set `"unstable_api-only"` to retain a runtime server for loaders, actions,
+   * and route discovery while disabling production document rendering.
+   * Documents follow the same prerendering and SPA fallback behavior as
+   * `ssr:false`, with runtime loaders and actions available for all routes.
+   * API-only mode is unstable and is not supported in RSC Framework Mode.
+   */
+  ssr: boolean | "unstable_api-only";
+  /**
+   * The origin to use for server requests in API-only mode.
    */
-  ssr: boolean;
+  unstable_apiServerOrigin?: string;
   /**
    * Whether to generate subresource integrity hashes for asset script tags.
    */

package/dist/config.d.ts

@@ -1,3 +1,3 @@
 
-import { i as ServerBundlesFunction, n as Preset, r as ReactRouterConfig, t as BuildManifest } from "./config-t89niiFv.js";
+import { i as ServerBundlesFunction, n as Preset, r as ReactRouterConfig, t as BuildManifest } from "./config-DP95WFpo.js";
 export type { BuildManifest, ReactRouterConfig as Config, Preset, ServerBundlesFunction };

package/dist/config.js

@@ -1,5 +1,5 @@
 /**
- * @react-router/dev v8.3.1
+ * @react-router/dev v8.5.0
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/{dev-DFccbHpq.js → dev-DGFm0uWr.js}

@@ -1,5 +1,5 @@
 /**
- * @react-router/dev v8.3.1
+ * @react-router/dev v8.5.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import { _ as getVite, v as preloadVite } from "./typegen-DxFMuBQP.js";
+import { _ as getVite, v as preloadVite } from "./typegen-CiHN93zF.js";
 import { n as start, r as stop, t as getSession } from "./cli/index.js";
 import colors from "picocolors";
 //#region vite/dev.ts

package/dist/{routes-C-NBxWG3.js → routes-Cyup1Gnm.js}

@@ -1,5 +1,5 @@
 /**
- * @react-router/dev v8.3.1
+ * @react-router/dev v8.5.0
  *
  * Copyright (c) Remix Software Inc.
  *

package/dist/routes.js

@@ -1,5 +1,5 @@
 /**
- * @react-router/dev v8.3.1
+ * @react-router/dev v8.5.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-import { a as prefix, i as layout, n as getAppDirectory, o as relative, r as index, s as route } from "./routes-C-NBxWG3.js";
+import { a as prefix, i as layout, n as getAppDirectory, o as relative, r as index, s as route } from "./routes-Cyup1Gnm.js";
 export { getAppDirectory, index, layout, prefix, relative, route };

package/dist/{typegen-DxFMuBQP.js → typegen-CiHN93zF.js}

@@ -1,5 +1,5 @@
 /**
- * @react-router/dev v8.3.1
+ * @react-router/dev v8.5.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import { c as setAppDirectory, l as validateRouteConfig, t as configRoutesToRouteManifest, u as invariant } from "./routes-C-NBxWG3.js";
+import { c as setAppDirectory, l as validateRouteConfig, t as configRoutesToRouteManifest, u as invariant } from "./routes-Cyup1Gnm.js";
 import { createRequire } from "node:module";
 import colors from "picocolors";
 import fs from "node:fs";
@@ -228,10 +228,18 @@ async function resolveConfig({ root, viteRunnerContext, reactRouterConfigFile, s
 		ssr: true
 	};
 	let userAndPresetConfigs = mergeReactRouterConfig(...presets, reactRouterUserConfig);
-	let { appDirectory: userAppDirectory, basename, buildDirectory: userBuildDirectory, buildEnd, prerender, routeDiscovery: userRouteDiscovery, serverBuildFile, serverBundles, serverModuleFormat, ssr } = {
+	let { appDirectory: userAppDirectory, basename, buildDirectory: userBuildDirectory, buildEnd, prerender, routeDiscovery: userRouteDiscovery, serverBuildFile, serverBundles, serverModuleFormat, ssr, unstable_apiServerOrigin } = {
 		...defaults,
 		...userAndPresetConfigs
 	};
+	if (ssr === "unstable_api-only" && unstable_apiServerOrigin != null) try {
+		let url = new URL(unstable_apiServerOrigin);
+		if (url.pathname !== "/" || url.search || url.hash) return err("The `unstable_apiServerOrigin` config must be an origin without a path, query, or hash.");
+		unstable_apiServerOrigin = url.origin;
+	} catch {
+		return err("The `unstable_apiServerOrigin` config must be a valid absolute URL.");
+	}
+	else unstable_apiServerOrigin = void 0;
 	if (!ssr && serverBundles) serverBundles = void 0;
 	if (prerender) {
 		let isValidPrerenderPathsConfig = (p) => typeof p === "boolean" || typeof p === "function" || Array.isArray(p);
@@ -295,6 +303,7 @@ async function resolveConfig({ root, viteRunnerContext, reactRouterConfigFile, s
 		if ("unstable_subResourceIntegrity" in futureConfig) return err("The `future.unstable_subResourceIntegrity` flag has been stabilized and moved to a top-level `config.subResourceIntegrity` field");
 	}
 	let future = {
+		unstable_customRouteDiscovery: userAndPresetConfigs.future?.unstable_customRouteDiscovery ?? false,
 		unstable_enableNodeReadableStream: userAndPresetConfigs.future?.unstable_enableNodeReadableStream ?? false,
 		unstable_optimizeDeps: userAndPresetConfigs.future?.unstable_optimizeDeps ?? false
 	};
@@ -314,6 +323,7 @@ async function resolveConfig({ root, viteRunnerContext, reactRouterConfigFile, s
 		serverBundles,
 		serverModuleFormat,
 		ssr,
+		unstable_apiServerOrigin,
 		splitRouteModules,
 		subResourceIntegrity,
 		allowedActionOrigins,
@@ -624,6 +634,8 @@ function generateServerBuild(ctx) {
       export const routeDiscovery: ServerBuild["routeDiscovery"];
       export const routes: ServerBuild["routes"];
       export const ssr: ServerBuild["ssr"];
+      export const unstable_apiOnly: ServerBuild["unstable_apiOnly"];
+      export const unstable_apiServerOrigin: ServerBuild["unstable_apiServerOrigin"];
       export const allowedActionOrigins: ServerBuild["allowedActionOrigins"];
       export const unstable_getCriticalCss: ServerBuild["unstable_getCriticalCss"];
     }

package/dist/vite.js

@@ -1,5 +1,5 @@
 /**
- * @react-router/dev v8.3.1
+ * @react-router/dev v8.5.0
  *
  * Copyright (c) Remix Software Inc.
  *
@@ -8,8 +8,8 @@
  *
  * @license MIT
  */
-import { _ as getVite, a as t, c as createConfigLoader, d as resolveEntryFiles, f as resolveRSCEntryFiles, g as getUserBuildRollupOptions, h as defineOptimizeDepsCompilerOptions, i as parse$1, l as hasNodeDependency, m as defineCompilerOptions, n as watch, o as traverse, p as ssrExternals, r as generate, s as configRouteToBranchRoute, v as preloadVite } from "./typegen-DxFMuBQP.js";
-import { u as invariant } from "./routes-C-NBxWG3.js";
+import { _ as getVite, a as t, c as createConfigLoader, d as resolveEntryFiles, f as resolveRSCEntryFiles, g as getUserBuildRollupOptions, h as defineOptimizeDepsCompilerOptions, i as parse$1, l as hasNodeDependency, m as defineCompilerOptions, n as watch, o as traverse, p as ssrExternals, r as generate, s as configRouteToBranchRoute, v as preloadVite } from "./typegen-CiHN93zF.js";
+import { u as invariant } from "./routes-Cyup1Gnm.js";
 import { createRequire } from "node:module";
 import colors from "picocolors";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
@@ -37,7 +37,13 @@ import { readFile as readFile$1 } from "fs/promises";
 async function fromNodeRequest(nodeReq, nodeRes) {
 	invariant(nodeReq.originalUrl, "Expected `nodeReq.originalUrl` to be defined");
 	nodeReq.url = nodeReq.originalUrl;
-	return createRequest(nodeReq, nodeRes);
+	return createRequest(nodeReq, nodeRes, { protocol: getForwardedProtocol(nodeReq) });
+}
+function getForwardedProtocol(nodeReq) {
+	let forwardedProto = nodeReq.headers["x-forwarded-proto"];
+	let proto = (Array.isArray(forwardedProto) ? forwardedProto[0] : forwardedProto)?.split(",")[0].trim().toLowerCase();
+	if (proto?.endsWith(":")) proto = proto.slice(0, -1);
+	return proto === "http" || proto === "https" ? `${proto}:` : void 0;
 }
 //#endregion
 //#region vite/resolve-file-url.ts
@@ -108,7 +114,8 @@ const findDeps = async (vite, node, deps) => {
 		}
 	}
 	async function addFromUrl(url) {
-		let node = await vite.moduleGraph.getModuleByUrl(url);
+		let ssrNode = await vite.environments.ssr.moduleGraph.getModuleByUrl(url);
+		let node = ssrNode?.id ? vite.moduleGraph.getModuleById(ssrNode.id) : void 0;
 		if (node) await addFromNode(node);
 	}
 	if (node.ssrTransformResult) {
@@ -614,9 +621,9 @@ const routeChunkExportNames = [
 ];
 const mainChunkName = "main";
 const routeChunkNames = ["main", ...routeChunkExportNames];
-function getRouteChunkCode(code, chunkName, cache, cacheKey) {
-	if (chunkName === mainChunkName) return omitChunkedExports(code, routeChunkExportNames, {}, cache, cacheKey);
-	return getChunkedExport(code, chunkName, {}, cache, cacheKey);
+function getRouteChunkCode(code, chunkName, cache, cacheKey, generateOptions = {}) {
+	if (chunkName === mainChunkName) return omitChunkedExports(code, routeChunkExportNames, generateOptions, cache, cacheKey);
+	return getChunkedExport(code, chunkName, generateOptions, cache, cacheKey);
 }
 const routeChunkQueryStringPrefix = "?route-chunk=";
 const routeChunkQueryStrings = {
@@ -910,7 +917,7 @@ async function nodeHttpFetch(request, { signal }) {
 	return new Promise((resolve, reject) => {
 		const req = http.request({
 			protocol: url.protocol,
-			hostname: url.hostname,
+			hostname: url.hostname.replace(/^\[|\]$/g, ""),
 			port: url.port || void 0,
 			path: url.pathname + url.search,
 			method: request.method,
@@ -960,9 +967,15 @@ async function startPreviewServer(viteConfig) {
 	}
 }
 function getResolvedUrl(previewServer) {
-	const baseUrl = previewServer.resolvedUrls?.local[0];
-	if (!baseUrl) throw new Error("Prerender: No resolved URL is available from the Vite preview server");
-	return new URL(baseUrl);
+	const printableUrl = previewServer.resolvedUrls?.local[0];
+	const address = previewServer.httpServer?.address();
+	if (address && typeof address === "object" && address.address !== "::" && address.address !== "0.0.0.0") {
+		const protocol = printableUrl ? new URL(printableUrl).protocol : "http:";
+		const hostname = address.family === "IPv6" ? `[${address.address}]` : address.address;
+		return new URL(`${protocol}//${hostname}:${address.port}/`);
+	}
+	if (!printableUrl) throw new Error("Prerender: No resolved URL is available from the Vite preview server");
+	return new URL(printableUrl);
 }
 //#endregion
 //#region vite/plugin.ts
@@ -1231,14 +1244,16 @@ const reactRouterVitePlugin = () => {
     import * as entryServer from ${JSON.stringify(resolveFileUrl(ctx, ctx.entryServerFilePath, { publicPath: ctx.publicPath }))};
     ${Object.keys(routes).map((key, index) => {
 			let route = routes[key];
-			if (isSpaMode && key !== "root") return `const route${index} = { default: () => null };`;
+			if (isSpaMode && !isApiOnlyMode(ctx.reactRouterConfig) && key !== "root") return `const route${index} = { default: () => null };`;
 			else return `import * as route${index} from ${JSON.stringify(resolveFileUrl(ctx, resolveRelativeRouteFilePath(route, ctx.reactRouterConfig), { publicPath: ctx.publicPath }))};`;
 		}).join("\n")}
       export { default as assets } from ${JSON.stringify(virtual$1.serverManifest.id)};
       export const assetsBuildDirectory = ${JSON.stringify(path$2.relative(ctx.rootDirectory, getClientBuildDirectory$1(ctx.reactRouterConfig)))};
       export const basename = ${JSON.stringify(ctx.reactRouterConfig.basename)};
       export const future = ${JSON.stringify(ctx.reactRouterConfig.future)};
-      export const ssr = ${ctx.reactRouterConfig.ssr};
+      export const ssr = ${Boolean(ctx.reactRouterConfig.ssr)};
+      export const unstable_apiOnly = ${isApiOnlyMode(ctx.reactRouterConfig)};
+      export const unstable_apiServerOrigin = ${isApiOnlyMode(ctx.reactRouterConfig) ? JSON.stringify(ctx.reactRouterConfig.unstable_apiServerOrigin) : "undefined"};
       export const isSpaMode = ${isSpaMode};
       export const prerender = ${JSON.stringify(prerenderPaths)};
       export const routeDiscovery = ${JSON.stringify(ctx.reactRouterConfig.routeDiscovery)};
@@ -1484,7 +1499,7 @@ const reactRouterVitePlugin = () => {
 				invariant(serverEnvironment);
 				return {
 					__reactRouterPluginContext: ctx,
-					appType: viteCommand === "serve" && _viteConfigEnv.mode === "production" && ctx.reactRouterConfig.ssr === false ? "spa" : "custom",
+					appType: viteCommand === "serve" && _viteConfigEnv.mode === "production" && (!ctx.reactRouterConfig.ssr || ctx.reactRouterConfig.ssr === "unstable_api-only") ? isApiOnlyMode(ctx.reactRouterConfig) ? "mpa" : "spa" : "custom",
 					ssr: {
 						external: serverEnvironment.resolve?.external,
 						resolve: serverEnvironment.resolve
@@ -1717,6 +1732,21 @@ const reactRouterVitePlugin = () => {
 					previewServer.middlewares.use(async (req, res, next) => {
 						if (!ctx.reactRouterConfig.ssr && (!process.env.hasOwnProperty("IS_RR_BUILD_REQUEST") ? true : process.env.IS_RR_BUILD_REQUEST !== "yes")) return next();
 						try {
+							if (isApiOnlyMode(ctx.reactRouterConfig) && process.env.IS_RR_BUILD_REQUEST !== "yes") {
+								let { basename, routeDiscovery } = ctx.reactRouterConfig;
+								let manifestPath = routeDiscovery?.mode === "lazy" ? path$2.posix.join(basename, routeDiscovery.manifestPath ?? "/__manifest") : void 0;
+								let pathname = new URL(req.originalUrl ?? req.url ?? "/", "http://localhost").pathname;
+								if (!pathname.endsWith(".data") && pathname !== manifestPath) {
+									let clientBuildDirectory = getClientBuildDirectory$1(ctx.reactRouterConfig);
+									let previewPathname = decodeURIComponent(new URL(req.url ?? "/", "http://localhost").pathname);
+									if (previewPathname.endsWith(".html") && existsSync(path$2.join(clientBuildDirectory, previewPathname))) return next();
+									let fallbackFile = path$2.join(clientBuildDirectory, "__spa-fallback.html");
+									if (!existsSync(fallbackFile)) fallbackFile = path$2.join(clientBuildDirectory, "index.html");
+									res.setHeader("Content-Type", "text/html; charset=utf-8");
+									res.end(await readFile(fallbackFile));
+									return;
+								}
+							}
 							let handler = await getHandler();
 							let request = await fromNodeRequest(req, res);
 							await sendResponse(res, await handler(request, await reactRouterDevLoadContext(request)));
@@ -1817,11 +1847,14 @@ const reactRouterVitePlugin = () => {
 				let routeFileName = path$2.basename(routeModuleId);
 				let sourceExports = await getRouteModuleExports(viteChildCompiler, ctx, routeModuleId);
 				let { chunkedExports = [] } = options?.ssr ? {} : await detectRouteChunksIfEnabled(cache, ctx, id, code);
-				return `export { ${sourceExports.filter((exportName) => {
-					let isRouteEntryExport = options?.ssr && SERVER_ONLY_ROUTE_EXPORTS.includes(exportName) || CLIENT_ROUTE_EXPORTS$1.includes(exportName);
-					let isChunkedExport = chunkedExports.includes(exportName);
-					return isRouteEntryExport && !isChunkedExport;
-				}).join(", ")} } from "./${routeFileName}";`;
+				return {
+					code: `export { ${sourceExports.filter((exportName) => {
+						let isRouteEntryExport = options?.ssr && SERVER_ONLY_ROUTE_EXPORTS.includes(exportName) || CLIENT_ROUTE_EXPORTS$1.includes(exportName);
+						let isChunkedExport = chunkedExports.includes(exportName);
+						return isRouteEntryExport && !isChunkedExport;
+					}).join(", ")} } from "./${routeFileName}";`,
+					map: { mappings: "" }
+				};
 			}
 		},
 		{
@@ -1946,7 +1979,8 @@ const reactRouterVitePlugin = () => {
 				if (isRouteChunkModuleId(id)) id = id.split("?")[0];
 				let route = getRoute(ctx.reactRouterConfig, id);
 				if (!route) return;
-				if (!options?.ssr && isSpaModeEnabled(ctx.reactRouterConfig)) {
+				let isServerEnvironment = isReactRouterServerEnvironment(ctx, this.environment.name);
+				if (!options?.ssr && isSpaModeEnabled(ctx.reactRouterConfig) && !isApiOnlyMode(ctx.reactRouterConfig)) {
 					let exportNames = getExportNames(code);
 					let serverOnlyExports = exportNames.filter((exp) => {
 						if (route.id === "root" && exp === "loader") return false;
@@ -1967,6 +2001,7 @@ const reactRouterVitePlugin = () => {
 				let [filepath] = id.split("?");
 				let ast = parse$1(code, { sourceType: "module" });
 				if (!options?.ssr) removeExports(ast, SERVER_ONLY_ROUTE_EXPORTS);
+				else if (isApiOnlyMode(ctx.reactRouterConfig) && isServerEnvironment && !isPrerenderingEnabled(ctx.reactRouterConfig) && viteCommand === "build" && route.id !== "root") removeExports(ast, CLIENT_ROUTE_EXPORTS$1);
 				decorateComponentExportsWithProps(ast);
 				return generate(ast, {
 					sourceMaps: true,
@@ -2108,7 +2143,7 @@ const reactRouterVitePlugin = () => {
 						else requests.push(createRouteRequest(prerenderPath, reactRouterConfig));
 					}
 				}
-				if (!ctx.reactRouterConfig.ssr) requests.push(createSpaModeRequest(ctx.reactRouterConfig));
+				if (!ctx.reactRouterConfig.ssr || ctx.reactRouterConfig.ssr === "unstable_api-only") requests.push(createSpaModeRequest(ctx.reactRouterConfig));
 				return requests;
 			},
 			async postProcess(request, response, metadata) {
@@ -2175,7 +2210,7 @@ const reactRouterVitePlugin = () => {
 			async finalize(buildDirectory) {
 				invariant(viteConfig);
 				let { ssr } = ctx.reactRouterConfig;
-				if (!ssr) {
+				if (!ssr || ssr === "unstable_api-only") {
 					let spaFallback = path$2.join(buildDirectory, "__spa-fallback.html");
 					let index = path$2.join(buildDirectory, "index.html");
 					let finalSpaPath;
@@ -2310,7 +2345,10 @@ function isPrerenderingEnabled(reactRouterConfig) {
 	return reactRouterConfig.prerender != null && reactRouterConfig.prerender !== false;
 }
 function isSpaModeEnabled(reactRouterConfig) {
-	return reactRouterConfig.ssr === false && !isPrerenderingEnabled(reactRouterConfig);
+	return (!reactRouterConfig.ssr || reactRouterConfig.ssr === "unstable_api-only") && !isPrerenderingEnabled(reactRouterConfig);
+}
+function isApiOnlyMode(reactRouterConfig) {
+	return reactRouterConfig.ssr === "unstable_api-only";
 }
 function getStaticPrerenderPaths(routes) {
 	let paths = ["/"];
@@ -2476,7 +2514,10 @@ async function detectRouteChunksIfEnabled(cache, ctx, id, input) {
 }
 async function getRouteChunkIfEnabled(cache, ctx, id, chunkName, input) {
 	if (!ctx.reactRouterConfig.splitRouteModules) return null;
-	return getRouteChunkCode(await resolveRouteFileCode(ctx, input), chunkName, cache, normalizeRelativeFilePath(id, ctx.reactRouterConfig) + (typeof input === "string" ? "" : "?read"));
+	return getRouteChunkCode(await resolveRouteFileCode(ctx, input), chunkName, cache, normalizeRelativeFilePath(id, ctx.reactRouterConfig) + (typeof input === "string" ? "" : "?read"), {
+		sourceMaps: true,
+		sourceFileName: path$2.basename(id.split("?")[0])
+	});
 }
 function validateRouteChunks$1({ ctx, id, valid }) {
 	if (isRootRouteModuleId(ctx, id)) return;
@@ -2665,7 +2706,7 @@ function createDataRequest(prerenderPath, reactRouterConfig, onlyRoutes, isResou
 	let url = new URL(`http://localhost${normalizedPath}`);
 	if (onlyRoutes?.length) url.searchParams.set("_routes", onlyRoutes.join(","));
 	return {
-		request: new Request(url),
+		request: new Request(url, { headers: { "X-React-Router-Prerender": "yes" } }),
 		metadata: {
 			type: "data",
 			path: prerenderPath,
@@ -2675,7 +2716,7 @@ function createDataRequest(prerenderPath, reactRouterConfig, onlyRoutes, isResou
 }
 function createRouteRequest(prerenderPath, reactRouterConfig, data) {
 	let normalizedPath = `${reactRouterConfig.basename}${prerenderPath}/`.replace(/\/\/+/g, "/");
-	let headers = new Headers();
+	let headers = new Headers({ "X-React-Router-Prerender": "yes" });
 	if (data) {
 		let encodedData = encodeURI(data);
 		if (encodedData.length < 8 * 1024) headers.set("X-React-Router-Prerender-Data", encodedData);
@@ -2690,8 +2731,13 @@ function createRouteRequest(prerenderPath, reactRouterConfig, data) {
 }
 function createResourceRouteRequest(prerenderPath, reactRouterConfig, requestInit) {
 	let normalizedPath = `${reactRouterConfig.basename}${prerenderPath}/`.replace(/\/\/+/g, "/").replace(/\/$/g, "");
+	let headers = new Headers(requestInit?.headers);
+	headers.set("X-React-Router-Prerender", "yes");
 	return {
-		request: new Request(`http://localhost${normalizedPath}`, requestInit),
+		request: new Request(`http://localhost${normalizedPath}`, {
+			...requestInit,
+			headers
+		}),
 		metadata: {
 			type: "resource",
 			path: prerenderPath
@@ -2851,6 +2897,38 @@ const ENSURE_CLIENT_ROUTE_MODULE_CHUNK_FOR_HMR = `
 import * as ___EnsureClientRouteModuleForHMR_REACT___ from "react";
 export function EnsureClientRouteModuleForHMR___() { return ___EnsureClientRouteModuleForHMR_REACT___.createElement(___EnsureClientRouteModuleForHMR_REACT___.Fragment, null) }
 `;
+function createEmptySourceMap() {
+	return {
+		version: 3,
+		names: [],
+		sources: [],
+		mappings: ""
+	};
+}
+function generateRouteModule(code, map, filename) {
+	const ast = parse$1(code, { sourceType: "module" });
+	const generatorOptions = {
+		sourceMaps: true,
+		sourceFileName: filename,
+		inputSourceMap: map
+	};
+	return {
+		ast,
+		generate: () => generate(ast, generatorOptions)
+	};
+}
+function prependUnmappedCode(prefix, generated) {
+	if (generated.map) generated.map.mappings = ";".repeat(prefix.match(/\n/g)?.length ?? 0) + generated.map.mappings;
+	return {
+		code: prefix + generated.code,
+		map: generated.map
+	};
+}
+function appendUnmappedCode(generated, code) {
+	if (!generated.code.endsWith("\n") && !code.startsWith("\n")) code = "\n" + code;
+	if (generated.map) generated.map.mappings += ";A".repeat(code.match(/\n/g)?.length ?? 0);
+	generated.code += code;
+}
 function virtualRouteModulesPlugin({ enforceSplitRouteModules, environments: { client = ["client", "ssr"], server = ["rsc"] } = {}, getRouteIdForFile, isRootRouteModule, transformToJs, shouldTransform }) {
 	let clientEnvironments = new Set(client);
 	let serverEnvironments = new Set(server);
@@ -2886,7 +2964,10 @@ function virtualRouteModulesPlugin({ enforceSplitRouteModules, environments: { c
 				}
 			});
 		}
-		return { code: "\"use client\";\n" + result };
+		return {
+			code: "\"use client\";\n" + result,
+			map: createEmptySourceMap()
+		};
 	}
 	async function createServerRouteEntry(id, code, isRootRouteModule, routeId) {
 		let result = "";
@@ -2926,16 +3007,19 @@ ${result}`;
 				}
 			});
 		}
-		return { code: result };
+		return {
+			code: result,
+			map: createEmptySourceMap()
+		};
 	}
-	function createServerRouteModule(code) {
-		const ast = parse$1(code, { sourceType: "module" });
+	function createServerRouteModule(code, map, filename) {
+		const { ast, generate } = generateRouteModule(code, map, filename);
 		removeExports(ast, CLIENT_ROUTE_EXPORTS);
-		return generate(ast);
+		return generate();
 	}
-	async function createClientRouteModuleChunk(id, code, chunk, routeId, isRootRouteModule, isDevMode) {
+	async function createClientRouteModuleChunk(id, code, chunk, routeId, isRootRouteModule, isDevMode, map, filename) {
 		let routeChunks = detectRouteChunks(cache, id, code, isRootRouteModule);
-		const ast = parse$1(code, { sourceType: "module" });
+		const { ast, generate } = generateRouteModule(code, map, filename);
 		const { staticExports } = await parseRouteExports(code);
 		if (chunk === "shared") removeExports(ast, [...SERVER_ROUTE_EXPORTS, ...routeChunks.chunkedExports]);
 		else {
@@ -2943,33 +3027,26 @@ ${result}`;
 			toRemove.delete(chunk);
 			removeExports(ast, Array.from(toRemove));
 		}
-		let result = "\"use client\";\n" + generate(ast).code;
+		let result = prependUnmappedCode("\"use client\";\n", generate());
 		if (chunk === "shared") {
-			if (isRootRouteModule && !staticExports.includes("ErrorBoundary") && !staticExports.includes("ServerErrorBoundary")) {
-				const hasRootLayout = staticExports.includes("Layout") || staticExports.includes("ServerLayout");
-				result += `\nimport { createElement as __rr_createElement } from "react";\n`;
-				result += `import { UNSAFE_RSCDefaultRootErrorBoundary } from "react-router";\n`;
-				result += `export function ErrorBoundary() {\n`;
-				result += `  return __rr_createElement(UNSAFE_RSCDefaultRootErrorBoundary, { hasRootLayout: ${hasRootLayout} });\n`;
-				result += `}\n`;
-			}
-			result += ENSURE_CLIENT_ROUTE_MODULE_CHUNK_FOR_HMR;
+			if (isRootRouteModule && !staticExports.includes("ErrorBoundary") && !staticExports.includes("ServerErrorBoundary")) appendUnmappedCode(result, `
+import { createElement as __rr_createElement } from "react";
+import { UNSAFE_RSCDefaultRootErrorBoundary } from "react-router";
+export function ErrorBoundary() {
+  return __rr_createElement(UNSAFE_RSCDefaultRootErrorBoundary, { hasRootLayout: ${staticExports.includes("Layout") || staticExports.includes("ServerLayout")} });\n}\n`);
+			appendUnmappedCode(result, ENSURE_CLIENT_ROUTE_MODULE_CHUNK_FOR_HMR);
 		}
 		let hasAction = staticExports.includes("action");
 		let hasLoader = staticExports.includes("loader");
 		let hasComponent = staticExports.includes("default") || staticExports.includes("ServerComponent");
 		let hasErrorBoundary = staticExports.includes("ErrorBoundary") || staticExports.includes("ServerErrorBoundary");
-		if (isDevMode) {
-			result += `export function ReactRouterHMRMeta___() {return null;};\n`;
-			result += `Object.assign(ReactRouterHMRMeta___, {
+		if (isDevMode) appendUnmappedCode(result, `export function ReactRouterHMRMeta___() {return null;};\nObject.assign(ReactRouterHMRMeta___, {
         hasAction: ${JSON.stringify(hasAction)},
         hasComponent: ${JSON.stringify(hasComponent)},
         hasErrorBoundary: ${JSON.stringify(hasErrorBoundary)},
         hasLoader: ${JSON.stringify(hasLoader)},
         hasClientLoader: ${JSON.stringify(staticExports.includes("clientLoader"))},
-      });\n`;
-			result += `\nif (import.meta.hot) {\n`;
-			result += `  import.meta.hot.accept((mod) => {
+      });\n\nif (import.meta.hot) {\n  import.meta.hot.accept((mod) => {
           if (typeof __reactRouterDataRouter === "object") {
             __reactRouterDataRouter._updateRoutesForHMR(new Map([[${JSON.stringify(routeId)}, {
               routeModule: mod,
@@ -2983,10 +3060,8 @@ ${result}`;
             }
           }
         });
-      `;
-			result += `}\n`;
-		}
-		return { code: result };
+      }\n`);
+		return result;
 	}
 	return {
 		name: "react-router-rsc-virtual-route-modules",
@@ -2998,12 +3073,13 @@ ${result}`;
 			let isClientEnvironment = clientEnvironments.has(this.environment.name);
 			let isServerEnvironment = serverEnvironments.has(this.environment.name);
 			if (!isClientEnvironment && !isServerEnvironment) return;
-			let code = await transformToJs(_code, filename);
+			let transformed = await transformToJs(_code, filename);
+			let code = transformed.code;
 			let searchParams = rest.length > 0 ? new URLSearchParams(rest.join("?")) : null;
 			let clientRouteModuleType = searchParams?.get("client-route-module");
 			let isServerRouteModule = searchParams?.has("server-route-module");
-			if (clientRouteModuleType) return await createClientRouteModuleChunk(id, code, clientRouteModuleType, routeId, isRootRouteModule(filename), this.environment.mode === "dev");
-			if (isServerRouteModule) return createServerRouteModule(code);
+			if (clientRouteModuleType) return await createClientRouteModuleChunk(id, code, clientRouteModuleType, routeId, isRootRouteModule(filename), this.environment.mode === "dev", transformed.map, filename);
+			if (isServerRouteModule) return createServerRouteModule(code, transformed.map, filename);
 			if (isClientEnvironment) return await createClientRouteEntry(id, code, isRootRouteModule(filename), routeId);
 			return await createServerRouteEntry(id, code, isRootRouteModule(filename), routeId);
 		}
@@ -3169,7 +3245,7 @@ function reactRouterRSCVitePlugin() {
 		await preloadVite();
 		let vite = getVite();
 		let lang = getTransformLanguage(filename);
-		return ("transformWithOxc" in vite && typeof vite.transformWithOxc === "function" ? await vite.transformWithOxc(code, filename, {
+		return "transformWithOxc" in vite && typeof vite.transformWithOxc === "function" ? await vite.transformWithOxc(code, filename, {
 			lang,
 			jsx: {
 				runtime: "automatic",
@@ -3182,7 +3258,7 @@ function reactRouterRSCVitePlugin() {
 			format: "esm",
 			jsx: "automatic",
 			jsxDev: viteCommand !== "build"
-		})).code;
+		});
 	}
 	async function getClientVersion(source) {
 		const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(source));
@@ -3211,6 +3287,7 @@ function reactRouterRSCVitePlugin() {
 						if (userConfig.buildEnd) errors.push("buildEnd");
 						if (userConfig.presets?.length) errors.push("presets");
 						if (userConfig.serverBundles) errors.push("serverBundles");
+						if (userConfig.ssr === "unstable_api-only") errors.push("ssr: \"unstable_api-only\"");
 						if (errors.length) return `RSC Framework Mode does not currently support the following React Router config:\n${errors.map((x) => ` - ${x}`).join("\n")}\n`;
 					}
 				});
@@ -3642,7 +3719,7 @@ function createRSCOptimizeDepsRouteModulesPlugin({ routeFiles, transformToJs })
 				let normalizedFilename = getVite().normalizePath(filename);
 				if (!routeFiles.has(normalizedFilename)) return;
 				return {
-					code: createClientRouteModuleForOptimizeDepsScan(await transformToJs(code, filename)).code,
+					code: createClientRouteModuleForOptimizeDepsScan((await transformToJs(code, filename)).code).code,
 					map: null,
 					moduleType: "js"
 				};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@react-router/dev",
   "type": "module",
-  "version": "8.3.1",
+  "version": "8.5.0",
   "description": "Dev tools and CLI for React Router",
   "keywords": [
     "react",
@@ -107,7 +107,7 @@
     "semver": "^7.8.1",
     "tinyglobby": "^0.2.16",
     "valibot": "^1.4.1",
-    "@react-router/node": "8.3.1"
+    "@react-router/node": "8.5.0"
   },
   "devDependencies": {
     "@babel/plugin-syntax-jsx": "^7.29.7",
@@ -132,8 +132,8 @@
     "vite": "^7.0.0",
     "wireit": "0.14.12",
     "wrangler": "^4.95.0",
-    "@react-router/serve": "8.3.1",
-    "react-router": "^8.3.1"
+    "react-router": "^8.5.0",
+    "@react-router/serve": "8.5.0"
   },
   "peerDependencies": {
     "@vitejs/plugin-rsc": "~0.5.26",
@@ -141,8 +141,8 @@
     "typescript": "^5.1.0 || ^6.0.0 || ^7.0.0",
     "vite": "^7.0.0 || ^8.0.0",
     "wrangler": "^4.0.0",
-    "@react-router/serve": "^8.3.1",
-    "react-router": "^8.3.1"
+    "@react-router/serve": "^8.5.0",
+    "react-router": "^8.5.0"
   },
   "peerDependenciesMeta": {
     "@vitejs/plugin-rsc": {