vinext 1.0.0-beta.8 → 1.0.0

package/dist/utils/client-runtime-metadata.d.ts

@@ -2,6 +2,10 @@
 type ClientRuntimeMetadata = {
   clientEntryFile?: string;
   appBootstrapPreinitModules?: string[];
+  cssGraph?: Record<string, {
+    imports?: string[];
+    css?: string[];
+  }>;
   lazyChunks?: string[];
   dynamicPreloads?: Record<string, string[]>;
 };
@@ -13,17 +17,18 @@ type ClientRuntimeMetadata = {
  *   from modulepreload hints.
  * - `dynamicPreloads` — per-module JS/CSS files for rendered `next/dynamic()`
  *   boundaries, injected as preload links during SSR.
+ * - `cssGraph` — static chunk imports and stylesheets used to preserve Pages
+ *   Router module-graph order in the initial HTML.
  * - `clientEntryFile` — the client entry chunk filename (optional, only
  *   needed for Pages Router).
  *
  * All file paths are normalised with the configured `assetBase` (basePath)
  * and `assetPrefix`.
  */
-declare function computeClientRuntimeMetadata(opts: {
+export declare function computeClientRuntimeMetadata(opts: {
   clientDir: string;
   assetBase: string;
   assetPrefix: string;
   includeClientEntry?: boolean | "pages-client-entry";
 }): ClientRuntimeMetadata;
-//#endregion
-export { computeClientRuntimeMetadata };
+//#endregion

package/dist/utils/client-runtime-metadata.js

@@ -5,6 +5,19 @@ import { findClientEntryFile, findPagesClientEntryFile, readClientBuildManifest
 import { findClientEntryFileFromVinextManifest, findPagesClientEntryFileFromVinextManifest, readClientEntryManifest } from "./client-entry-manifest.js";
 import { computeDynamicImportPreloads, computeLazyChunks, dynamicImportPreloadsWithBase } from "./lazy-chunks.js";
 //#region src/utils/client-runtime-metadata.ts
+function collectCssGraph(buildManifest, applyBase) {
+	const cssGraph = {};
+	for (const [key, chunk] of Object.entries(buildManifest)) {
+		const imports = chunk.imports ?? [];
+		const css = (chunk.css ?? []).map(applyBase);
+		if (imports.length === 0 && css.length === 0) continue;
+		cssGraph[key] = {
+			...imports.length > 0 ? { imports } : {},
+			...css.length > 0 ? { css } : {}
+		};
+	}
+	return Object.keys(cssGraph).length > 0 ? cssGraph : void 0;
+}
 function collectAppBootstrapPreinitModules(buildManifest, appBrowserEntry, applyBase) {
 	if (!appBrowserEntry) return void 0;
 	const entryKey = Object.keys(buildManifest).find((key) => buildManifest[key].file === appBrowserEntry);
@@ -37,6 +50,8 @@ function collectAppBootstrapPreinitModules(buildManifest, appBrowserEntry, apply
 *   from modulepreload hints.
 * - `dynamicPreloads` — per-module JS/CSS files for rendered `next/dynamic()`
 *   boundaries, injected as preload links during SSR.
+* - `cssGraph` — static chunk imports and stylesheets used to preserve Pages
+*   Router module-graph order in the initial HTML.
 * - `clientEntryFile` — the client entry chunk filename (optional, only
 *   needed for Pages Router).
 *
@@ -44,7 +59,8 @@ function collectAppBootstrapPreinitModules(buildManifest, appBrowserEntry, apply
 * and `assetPrefix`.
 */
 function computeClientRuntimeMetadata(opts) {
-	const buildManifest = readClientBuildManifest(path.join(opts.clientDir, ".vite", "manifest.json"));
+	const buildManifestPath = path.join(opts.clientDir, ".vite", "manifest.json");
+	const buildManifest = readClientBuildManifest(buildManifestPath);
 	const clientEntryManifest = readClientEntryManifest(opts.clientDir);
 	const metadata = {};
 	if (opts.includeClientEntry) {
@@ -58,6 +74,7 @@ function computeClientRuntimeMetadata(opts) {
 		if (entry) metadata.clientEntryFile = entry;
 	}
 	if (!buildManifest) return metadata;
+	if (opts.includeClientEntry) metadata.cssGraph = collectCssGraph(buildManifest, (file) => manifestFileWithBase(file, opts.assetBase));
 	metadata.appBootstrapPreinitModules = collectAppBootstrapPreinitModules(buildManifest, clientEntryManifest?.appBrowserEntry, (file) => {
 		const url = manifestFileWithAssetPrefix(file, opts.assetBase, opts.assetPrefix);
 		return isAbsoluteAssetPrefix(opts.assetPrefix) ? url : "/" + url;

package/dist/utils/commonjs-loader.d.ts

@@ -1,16 +1,15 @@
 //#region src/utils/commonjs-loader.d.ts
-declare function shouldRetryAsCommonJs(error: unknown, resolvedPath: string): boolean;
+export declare function shouldRetryAsCommonJs(error: unknown, resolvedPath: string): boolean;
 /**
  * Load a `.js` file as CommonJS even when a surrounding `package.json`
  * declares `"type": "module"`. Nested misclassified `.js` dependencies are
  * compiled the same way, while Node keeps handling builtins, JSON, native
  * addons, and correctly classified modules through its normal loader.
  */
-declare function loadCommonJsModule(resolvedPath: string): unknown;
+export declare function loadCommonJsModule(resolvedPath: string): unknown;
 /**
  * Import a module normally, retrying only `.js` files that fail because Node
  * classified CommonJS source as ESM.
  */
-declare function importExportWithCommonJsFallback(resolvedPath: string): Promise<unknown>;
-//#endregion
-export { importExportWithCommonJsFallback, loadCommonJsModule, shouldRetryAsCommonJs };
+export declare function importExportWithCommonJsFallback(resolvedPath: string): Promise<unknown>;
+//#endregion

package/dist/utils/compare.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/compare.d.ts
-declare const compareStrings: (left: string, right: string) => number;
-//#endregion
-export { compareStrings };
+export declare const compareStrings: (left: string, right: string) => number;
+//#endregion

package/dist/utils/deployment-id.d.ts

@@ -1,8 +1,7 @@
 //#region src/utils/deployment-id.d.ts
-declare const NEXT_DEPLOYMENT_ID_HEADER = "x-deployment-id";
-declare function getDeploymentId(): string | undefined;
-declare function appendDeploymentIdQuery(value: string, deploymentId?: string | undefined): string;
-declare function appendAssetDeploymentIdQuery(value: string, deploymentId?: string | undefined): string;
-declare function applyDeploymentIdHeader(headers: Headers, deploymentId?: string | undefined): void;
-//#endregion
-export { NEXT_DEPLOYMENT_ID_HEADER, appendAssetDeploymentIdQuery, appendDeploymentIdQuery, applyDeploymentIdHeader, getDeploymentId };
+export declare const NEXT_DEPLOYMENT_ID_HEADER = "x-deployment-id";
+export declare function getDeploymentId(): string | undefined;
+export declare function appendDeploymentIdQuery(value: string, deploymentId?: string | undefined): string;
+export declare function appendAssetDeploymentIdQuery(value: string, deploymentId?: string | undefined): string;
+export declare function applyDeploymentIdHeader(headers: Headers, deploymentId?: string | undefined): void;
+//#endregion

package/dist/utils/dev-error-recovery-event.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/dev-error-recovery-event.d.ts
-declare const VINEXT_DEV_ERROR_RECOVERY_EVENT = "vinext:dev-error-recovery";
-//#endregion
-export { VINEXT_DEV_ERROR_RECOVERY_EVENT };
+export declare const VINEXT_DEV_ERROR_RECOVERY_EVENT = "vinext:dev-error-recovery";
+//#endregion

package/dist/utils/dev-stack-sourcemap-endpoint.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/dev-stack-sourcemap-endpoint.d.ts
-declare const VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT = "/__vinext_original-stack-trace";
-//#endregion
-export { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT };
+export declare const VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT = "/__vinext_original-stack-trace";
+//#endregion

package/dist/utils/domain-locale.d.ts

@@ -1,11 +1,11 @@
 //#region src/utils/domain-locale.d.ts
-type DomainLocale = {
+export type DomainLocale = {
   domain: string;
   defaultLocale: string;
   locales?: readonly string[];
   http?: true;
 };
-declare function normalizeDomainHostname(hostname: string | null | undefined): string | undefined;
+export declare function normalizeDomainHostname(hostname: string | null | undefined): string | undefined;
 /**
  * Match a configured domain either by hostname or locale.
  * When both are provided, the checks intentionally use OR semantics so the
@@ -13,13 +13,12 @@ declare function normalizeDomainHostname(hostname: string | null | undefined): s
  * If both are passed, the first domain matching either input wins, so callers
  * should pass hostname or detectedLocale, not both.
  */
-declare function detectDomainLocale(domainItems?: readonly DomainLocale[], hostname?: string, detectedLocale?: string): DomainLocale | undefined;
-declare function addLocalePrefix(path: string, locale: string, localeDefault: string): string;
-declare function getLocalePathPrefix(path: string, locales: readonly string[] | undefined): string | undefined;
-declare function getDomainLocaleUrl(url: string, locale: string, { basePath, currentHostname, domainItems }: {
+export declare function detectDomainLocale(domainItems?: readonly DomainLocale[], hostname?: string, detectedLocale?: string): DomainLocale | undefined;
+export declare function addLocalePrefix(path: string, locale: string, localeDefault: string): string;
+export declare function getLocalePathPrefix(path: string, locales: readonly string[] | undefined): string | undefined;
+export declare function getDomainLocaleUrl(url: string, locale: string, { basePath, currentHostname, domainItems }: {
   basePath?: string;
   currentHostname?: string | null;
   domainItems?: readonly DomainLocale[];
 }): string | undefined;
-//#endregion
-export { DomainLocale, addLocalePrefix, detectDomainLocale, getDomainLocaleUrl, getLocalePathPrefix, normalizeDomainHostname };
+//#endregion

package/dist/utils/encode-cache-tag.d.ts

@@ -24,7 +24,6 @@
  * Mirrors Next.js's `packages/next/src/server/lib/encode-cache-tag.ts`
  * (introduced in vercel/next.js#93601).
  */
-declare function encodeCacheTag(tag: string): string;
-declare function encodeCacheTags(tags: readonly string[]): string[];
-//#endregion
-export { encodeCacheTag, encodeCacheTags };
+export declare function encodeCacheTag(tag: string): string;
+export declare function encodeCacheTags(tags: readonly string[]): string[];
+//#endregion

package/dist/utils/error-cause.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/error-cause.d.ts
-declare function flattenErrorCauses(err: unknown): void;
-//#endregion
-export { flattenErrorCauses };
+export declare function flattenErrorCauses(err: unknown): void;
+//#endregion

package/dist/utils/external-url.d.ts

@@ -1,5 +1,4 @@
 //#region src/utils/external-url.d.ts
 /** Detect an absolute URL with any scheme, or a protocol-relative URL. */
-declare function isExternalUrl(url: string): boolean;
-//#endregion
-export { isExternalUrl };
+export declare function isExternalUrl(url: string): boolean;
+//#endregion

package/dist/utils/has-trailing-comma.d.ts

@@ -13,12 +13,11 @@
  *
  * Returns "" for an empty / whitespace-only / comment-only fragment.
  */
-declare function lastSignificantChar(source: string): string;
+export declare function lastSignificantChar(source: string): string;
 /**
  * True when `source` ends — ignoring trailing whitespace and comments — with a
  * real trailing comma. Used to avoid splicing a second comma (`,,` is a syntax
  * error) when injecting a property or argument into existing source.
  */
-declare function hasTrailingComma(source: string): boolean;
-//#endregion
-export { hasTrailingComma, lastSignificantChar };
+export declare function hasTrailingComma(source: string): boolean;
+//#endregion

package/dist/utils/hash.d.ts

@@ -8,7 +8,7 @@
  * that must be byte-for-byte identical to what Next.js emits (ETags), use
  * `fnv1a52` below instead — the two are NOT interchangeable.
  */
-declare function fnv1a64(input: string): string;
+export declare function fnv1a64(input: string): string;
 /**
  * FNV-1a hash producing a 52-bit result, a byte-for-byte port of Next.js's
  * `fnv1a52` in packages/next/src/server/lib/etag.ts (itself derived from
@@ -19,6 +19,5 @@ declare function fnv1a64(input: string): string;
  * Deliberately separate from `fnv1a64` above — that one is a vinext-internal
  * key format and produces different values. Do not swap one for the other.
  */
-declare function fnv1a52(str: string): number;
-//#endregion
-export { fnv1a52, fnv1a64 };
+export declare function fnv1a52(str: string): number;
+//#endregion

package/dist/utils/html-limited-bots.d.ts

@@ -1,5 +1,5 @@
 //#region src/utils/html-limited-bots.d.ts
-declare function getHtmlLimitedBotRegex(htmlLimitedBots: string | undefined): RegExp;
+export declare function getHtmlLimitedBotRegex(htmlLimitedBots: string | undefined): RegExp;
 /**
  * Returns true when the User-Agent matches a known crawler/bot. Combines
  * Next.js's "headless browser bot" check (Googlebot proper) with the
@@ -16,6 +16,5 @@ declare function getHtmlLimitedBotRegex(htmlLimitedBots: string | undefined): Re
  * (same flag that drives `getHtmlLimitedBotRegex`), so a custom list applies
  * to both streaming metadata gating and bot-aware fallback rendering.
  */
-declare function isBotUserAgent(userAgent: string, htmlLimitedBots?: string): boolean;
-//#endregion
-export { getHtmlLimitedBotRegex, isBotUserAgent };
+export declare function isBotUserAgent(userAgent: string, htmlLimitedBots?: string): boolean;
+//#endregion

package/dist/utils/lazy-chunks.d.ts

@@ -2,7 +2,7 @@
 /**
  * Build-manifest chunk metadata used to compute lazy chunks.
  */
-type BuildManifestChunk = {
+export type BuildManifestChunk = {
   file: string;
   isEntry?: boolean;
   isDynamicEntry?: boolean;
@@ -28,7 +28,7 @@ type BuildManifestChunk = {
  * @returns Array of chunk filenames (e.g. "_next/static/mermaid-NOHMQCX5.js") that
  *   should be excluded from modulepreload hints.
  */
-declare function computeLazyChunks(buildManifest: Record<string, BuildManifestChunk>): string[];
+export declare function computeLazyChunks(buildManifest: Record<string, BuildManifestChunk>): string[];
 /**
  * Compute the production preload files for each module referenced by a
  * `next/dynamic()` boundary.
@@ -42,9 +42,9 @@ declare function computeLazyChunks(buildManifest: Record<string, BuildManifestCh
  * Note on shared chunks: a boundary's static-import tree (`collectStaticChunkFiles`)
  * can include chunks that the page entry ALSO loads eagerly (a shared vendor
  * chunk imported by both). Those files are intentionally NOT subtracted here, so
- * a rendered boundary may emit a `<link rel="preload">` / `<link rel="stylesheet">`
- * for a chunk the page already `<link rel="modulepreload">`s. This is harmless —
- * the browser dedupes preloads by URL, `ReactDOM.preload()` dedupes script hints,
+ * a rendered boundary may emit a `<link rel="modulepreload">` /
+ * `<link rel="stylesheet">` for a chunk the page already modulepreloads. This
+ * is harmless — matching module fetch modes lets the browser reuse the request,
  * and React's stylesheet resource model dedupes by href + precedence — and it
  * mirrors Next.js listing a module's full file set in its react-loadable
  * manifest. Subtracting the eager set would couple this to the entry's import
@@ -53,7 +53,6 @@ declare function computeLazyChunks(buildManifest: Record<string, BuildManifestCh
  * @returns A map keyed by root-relative module ID, with JS/CSS files that
  * should be preloaded when that dynamic boundary is rendered.
  */
-declare function computeDynamicImportPreloads(buildManifest: Record<string, BuildManifestChunk>): Record<string, string[]>;
-declare function dynamicImportPreloadsWithBase(preloads: Record<string, string[]>, applyBase: (file: string) => string): Record<string, string[]>;
-//#endregion
-export { BuildManifestChunk, computeDynamicImportPreloads, computeLazyChunks, dynamicImportPreloadsWithBase };
+export declare function computeDynamicImportPreloads(buildManifest: Record<string, BuildManifestChunk>): Record<string, string[]>;
+export declare function dynamicImportPreloadsWithBase(preloads: Record<string, string[]>, applyBase: (file: string) => string): Record<string, string[]>;
+//#endregion

package/dist/utils/lazy-chunks.js

@@ -57,9 +57,9 @@ function collectStaticChunkFiles(buildManifest, key, files, seenFiles, visitedCh
 	visitedChunks.add(key);
 	const chunk = buildManifest[key];
 	if (!chunk) return;
+	for (const importedKey of chunk.imports ?? []) collectStaticChunkFiles(buildManifest, importedKey, files, seenFiles, visitedChunks);
 	if (chunk.file.endsWith(".js")) addFile(files, seenFiles, chunk.file);
 	for (const cssFile of chunk.css ?? []) addFile(files, seenFiles, cssFile);
-	for (const importedKey of chunk.imports ?? []) collectStaticChunkFiles(buildManifest, importedKey, files, seenFiles, visitedChunks);
 }
 /**
 * Compute the production preload files for each module referenced by a
@@ -74,9 +74,9 @@ function collectStaticChunkFiles(buildManifest, key, files, seenFiles, visitedCh
 * Note on shared chunks: a boundary's static-import tree (`collectStaticChunkFiles`)
 * can include chunks that the page entry ALSO loads eagerly (a shared vendor
 * chunk imported by both). Those files are intentionally NOT subtracted here, so
-* a rendered boundary may emit a `<link rel="preload">` / `<link rel="stylesheet">`
-* for a chunk the page already `<link rel="modulepreload">`s. This is harmless —
-* the browser dedupes preloads by URL, `ReactDOM.preload()` dedupes script hints,
+* a rendered boundary may emit a `<link rel="modulepreload">` /
+* `<link rel="stylesheet">` for a chunk the page already modulepreloads. This
+* is harmless — matching module fetch modes lets the browser reuse the request,
 * and React's stylesheet resource model dedupes by href + precedence — and it
 * mirrors Next.js listing a module's full file set in its react-loadable
 * manifest. Subtracting the eager set would couple this to the entry's import

package/dist/utils/manifest-paths.d.ts

@@ -1,6 +1,6 @@
 //#region src/utils/manifest-paths.d.ts
-declare function manifestFileWithBase(file: string, base: string): string;
-declare function manifestFileWithAssetPrefix(file: string, base: string, assetPrefix: string): string;
+export declare function manifestFileWithBase(file: string, base: string): string;
+export declare function manifestFileWithAssetPrefix(file: string, base: string, assetPrefix: string): string;
 /**
  * Resolve the URL a client asset is actually SERVED from, starting from a
  * base-anchored manifest / SSR-manifest value (no leading slash), e.g.
@@ -18,13 +18,12 @@ declare function manifestFileWithAssetPrefix(file: string, base: string, assetPr
  * Returns an absolute URL for an absolute `assetPrefix`, otherwise a
  * root-relative URL beginning with `/`.
  */
-declare function assetServingUrlFromBaseAnchored(value: string, basePath: string, assetPrefix: string): string;
+export declare function assetServingUrlFromBaseAnchored(value: string, basePath: string, assetPrefix: string): string;
 /**
  * Strip a `base` prefix that Vite applied twice: it bakes `base` into the
  * on-disk chunk fileName and then prepends it again in `ssr-manifest.json`,
  * yielding `docs/docs/_next/static/...` which 404s. Only an exact
  * `<base>/<base>/` prefix is collapsed; a single prefix is left untouched.
  */
-declare function collapseDuplicateBase(file: string, base: string): string;
-//#endregion
-export { assetServingUrlFromBaseAnchored, collapseDuplicateBase, manifestFileWithAssetPrefix, manifestFileWithBase };
+export declare function collapseDuplicateBase(file: string, base: string): string;
+//#endregion

package/dist/utils/mdx-scan.d.ts

@@ -1,9 +1,16 @@
 //#region src/utils/mdx-scan.d.ts
 /** Module-level cache for hasMdxFiles — avoids re-scanning per Vite environment. */
-declare const mdxScanCache: Map<string, boolean>;
+export declare const mdxScanCache: Map<string, boolean>;
 /**
  * Check if the project has .mdx files in app/ or pages/ directories.
  */
-declare function hasMdxFiles(root: string, appDir: string | null, pagesDir: string | null): boolean;
-//#endregion
-export { hasMdxFiles, mdxScanCache };
+export declare function hasMdxFiles(root: string, appDir: string | null, pagesDir: string | null): boolean;
+/**
+ * Load a reader that keeps only the ESM of an MDX module, so the JavaScript
+ * export helpers can read it. It takes the ESM nodes from the MDX parser that
+ * `@mdx-js/rollup` compiles with, resolved beside the plugin vinext
+ * auto-injects or one the app installs, or from the app itself. Returns null
+ * when that parser isn't installed.
+ */
+export declare function loadMdxEsmReader(root: string): Promise<((source: string) => string) | null>;
+//#endregion

package/dist/utils/mdx-scan.js

@@ -1,5 +1,7 @@
 import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
+import { createRequire } from "node:module";
 import fs from "node:fs";
+import { pathToFileURL } from "node:url";
 //#region src/utils/mdx-scan.ts
 /** Module-level cache for hasMdxFiles — avoids re-scanning per Vite environment. */
 const mdxScanCache = /* @__PURE__ */ new Map();
@@ -30,5 +32,29 @@ function scanDirForMdx(dir) {
 	} catch {}
 	return false;
 }
+/**
+* Load a reader that keeps only the ESM of an MDX module, so the JavaScript
+* export helpers can read it. It takes the ESM nodes from the MDX parser that
+* `@mdx-js/rollup` compiles with, resolved beside the plugin vinext
+* auto-injects or one the app installs, or from the app itself. Returns null
+* when that parser isn't installed.
+*/
+async function loadMdxEsmReader(root) {
+	const fromVinext = createRequire(import.meta.url);
+	const fromRoot = createRequire(path.join(root, "package.json"));
+	const candidates = [
+		() => createRequire(fromVinext.resolve("@mdx-js/rollup")).resolve("@mdx-js/mdx"),
+		() => createRequire(fromRoot.resolve("@mdx-js/rollup")).resolve("@mdx-js/mdx"),
+		() => fromRoot.resolve("@mdx-js/mdx")
+	];
+	let mdx = null;
+	for (const resolveEntry of candidates) try {
+		mdx = await import(pathToFileURL(resolveEntry()).href);
+		break;
+	} catch {}
+	if (!mdx) return null;
+	const processor = mdx.createProcessor();
+	return (source) => processor.parse(source).children.flatMap((node) => node.type === "mdxjsEsm" && typeof node.value === "string" ? [node.value] : []).join("\n\n");
+}
 //#endregion
-export { hasMdxFiles, mdxScanCache };
+export { hasMdxFiles, loadMdxEsmReader, mdxScanCache };

package/dist/utils/middleware-request-headers.d.ts

@@ -6,8 +6,10 @@ type MiddlewareHeaderSource = Headers | Record<string, MiddlewareHeaderValue>;
  * override list. Its subsequent generic middleware-header merge exposes these
  * under their literal protocol-header names on both the request and response.
  */
-declare function getUnconsumedMiddlewareRequestHeaders(source: MiddlewareHeaderSource): Map<string, string>;
-declare function encodeMiddlewareRequestHeaders(targetHeaders: Headers, requestHeaders: Headers): void;
+export declare function getUnconsumedMiddlewareRequestHeaders(source: MiddlewareHeaderSource): Map<string, string>;
+/** Whether middleware changed the headers seen by downstream application code. */
+export declare function hasMiddlewareRequestHeaderOverrides(source: MiddlewareHeaderSource | null): boolean;
+export declare function encodeMiddlewareRequestHeaders(targetHeaders: Headers, requestHeaders: Headers): void;
 /**
  * A non-empty `x-middleware-override-headers` value lists the complete
  * post-middleware header set, so any name absent from it was deleted by
@@ -17,7 +19,6 @@ declare function encodeMiddlewareRequestHeaders(targetHeaders: Headers, requestH
  * override. Any unconsumed `x-middleware-request-*` values are subsequently
  * copied to the request under their literal protocol-header names.
  */
-declare function buildRequestHeadersFromMiddlewareResponse(baseHeaders: Headers, middlewareHeaders: MiddlewareHeaderSource): Headers | null;
-declare function shouldKeepMiddlewareHeader(key: string): boolean;
-//#endregion
-export { buildRequestHeadersFromMiddlewareResponse, encodeMiddlewareRequestHeaders, getUnconsumedMiddlewareRequestHeaders, shouldKeepMiddlewareHeader };
+export declare function buildRequestHeadersFromMiddlewareResponse(baseHeaders: Headers, middlewareHeaders: MiddlewareHeaderSource): Headers | null;
+export declare function shouldKeepMiddlewareHeader(key: string): boolean;
+//#endregion

package/dist/utils/middleware-request-headers.js

@@ -34,6 +34,11 @@ function getUnconsumedMiddlewareRequestHeaders(source) {
 	for (const [key, value] of getForwardedRequestHeaders(source)) if (value && !overriddenHeaders?.has(key)) unconsumedHeaders.set(`${MIDDLEWARE_REQUEST_HEADER_PREFIX}${key}`, value);
 	return unconsumedHeaders;
 }
+/** Whether middleware changed the headers seen by downstream application code. */
+function hasMiddlewareRequestHeaderOverrides(source) {
+	if (!source) return false;
+	return Boolean(getMiddlewareHeaderValue(source, "x-middleware-override-headers")) || getUnconsumedMiddlewareRequestHeaders(source).size > 0;
+}
 function encodeMiddlewareRequestHeaders(targetHeaders, requestHeaders) {
 	const overrideHeaderNames = [...requestHeaders.keys()];
 	targetHeaders.set(MIDDLEWARE_OVERRIDE_HEADERS, overrideHeaderNames.join(","));
@@ -71,4 +76,4 @@ function shouldKeepMiddlewareHeader(key) {
 	return key === "x-middleware-override-headers" || key === "x-middleware-cache" || key === "x-middleware-set-cookie" || key.startsWith("x-middleware-request-");
 }
 //#endregion
-export { buildRequestHeadersFromMiddlewareResponse, encodeMiddlewareRequestHeaders, getUnconsumedMiddlewareRequestHeaders, shouldKeepMiddlewareHeader };
+export { buildRequestHeadersFromMiddlewareResponse, encodeMiddlewareRequestHeaders, getUnconsumedMiddlewareRequestHeaders, hasMiddlewareRequestHeaderOverrides, shouldKeepMiddlewareHeader };

package/dist/utils/navigation-signal.d.ts

@@ -1,4 +1,4 @@
 //#region src/utils/navigation-signal.d.ts
-declare function isNavigationSignalError(error: unknown): boolean;
-//#endregion
-export { isNavigationSignalError };
+export declare function isNavigationSignalError(error: unknown): boolean;
+export declare function isValidNavigationSignalError(error: unknown): boolean;
+//#endregion

package/dist/utils/navigation-signal.js

@@ -1,4 +1,10 @@
+import { parseRedirectDigest } from "./redirect-digest.js";
 //#region src/utils/navigation-signal.ts
+const HTTP_ACCESS_FALLBACK_STATUSES = /* @__PURE__ */ new Set([
+	401,
+	403,
+	404
+]);
 function getErrorDigest(error) {
 	if (!error || typeof error !== "object" || !("digest" in error)) return null;
 	return String(error.digest);
@@ -8,5 +14,14 @@ function isNavigationSignalError(error) {
 	if (digest === null) return false;
 	return digest === "NEXT_NOT_FOUND" || digest.startsWith("NEXT_HTTP_ERROR_FALLBACK;") || digest.startsWith("NEXT_REDIRECT;");
 }
+function isValidNavigationSignalError(error) {
+	if (!error || typeof error !== "object" || !("digest" in error) || typeof error.digest !== "string") return false;
+	const digest = error.digest;
+	if (digest === "NEXT_NOT_FOUND") return true;
+	const [code, status] = digest.split(";");
+	if (code === "NEXT_HTTP_ERROR_FALLBACK" && HTTP_ACCESS_FALLBACK_STATUSES.has(Number(status))) return true;
+	const redirect = parseRedirectDigest(digest);
+	return redirect !== null && (redirect.type === null || redirect.type === "push" || redirect.type === "replace");
+}
 //#endregion
-export { isNavigationSignalError };
+export { isNavigationSignalError, isValidNavigationSignalError };

package/dist/utils/number.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/number.d.ts
-declare function isNonNegativeSafeInteger(value: unknown): value is number;
-//#endregion
-export { isNonNegativeSafeInteger };
+export declare function isNonNegativeSafeInteger(value: unknown): value is number;
+//#endregion

package/dist/utils/package-name.d.ts

@@ -1,11 +1,10 @@
 //#region src/utils/package-name.d.ts
-declare const BARE_PACKAGE_SPECIFIER_RE: RegExp;
+export declare const BARE_PACKAGE_SPECIFIER_RE: RegExp;
 /**
  * Extract the npm package name from a bare package specifier.
  *
  * Relative and absolute paths, package imports, URL/virtual schemes, malformed
  * scoped names, and Node builtins are not npm package references.
  */
-declare function packageNameFromSpecifier(specifier: string): string | null;
-//#endregion
-export { BARE_PACKAGE_SPECIFIER_RE, packageNameFromSpecifier };
+export declare function packageNameFromSpecifier(specifier: string): string | null;
+//#endregion

package/dist/utils/parse-cookie.d.ts

@@ -1,13 +1,12 @@
 //#region src/utils/parse-cookie.d.ts
-type ParsedCookies = Record<string, string>;
+export type ParsedCookies = Record<string, string>;
 /**
  * Parse a Cookie header using the semantics of Next.js's compiled `cookie`
  * package.
  */
-declare function parseCookieHeader(cookieHeader: string | null | undefined): ParsedCookies;
+export declare function parseCookieHeader(cookieHeader: string | null | undefined): ParsedCookies;
 /**
  * Parse a Cookie header using Next.js/@edge-runtime RequestCookies semantics.
  */
-declare function parseEdgeRequestCookieHeader(cookieHeader: string): Map<string, string>;
-//#endregion
-export { ParsedCookies, parseCookieHeader, parseEdgeRequestCookieHeader };
+export declare function parseEdgeRequestCookieHeader(cookieHeader: string): Map<string, string>;
+//#endregion

package/dist/utils/path.d.ts

@@ -1,18 +1,17 @@
 //#region src/utils/path.d.ts
-declare const isWindows: boolean;
-declare const NODE_MODULES_PATH_RE: RegExp;
-declare function stripViteModuleQuery(id: string): string;
+export declare const isWindows: boolean;
+export declare const NODE_MODULES_PATH_RE: RegExp;
+export declare function stripViteModuleQuery(id: string): string;
 /** Canonicalize an external-origin filesystem path for use as a Vite module id. */
-declare function canonicalizeFilePath(filePath: string): string;
+export declare function canonicalizeFilePath(filePath: string): string;
 /** Whether `filePath` is a strict descendant of `directory`. */
-declare function isPathInside(directory: string, filePath: string): boolean;
+export declare function isPathInside(directory: string, filePath: string): boolean;
 /** Whether `filePath` is `directory` itself or one of its descendants. */
-declare function isPathInsideOrEqual(directory: string, filePath: string): boolean;
+export declare function isPathInsideOrEqual(directory: string, filePath: string): boolean;
 /** Strip a trailing `.js` extension from a module specifier so
  *  `resolveShimModulePath` looks for the correct base name (e.g. `headers.js`
  *  → `headers`). Public and internal shim imports may carry extensionful
  *  subpaths; normalising before resolution prevents looking for non-existent
  *  files like `headers.js.ts`. */
-declare function stripJsExtension(name: string): string;
-//#endregion
-export { NODE_MODULES_PATH_RE, canonicalizeFilePath, isPathInside, isPathInsideOrEqual, isWindows, stripJsExtension, stripViteModuleQuery };
+export declare function stripJsExtension(name: string): string;
+//#endregion

package/dist/utils/plugin-options.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/plugin-options.d.ts
-declare function flattenPluginOptions(value: unknown): Promise<unknown[]>;
-//#endregion
-export { flattenPluginOptions };
+export declare function flattenPluginOptions(value: unknown): Promise<unknown[]>;
+//#endregion

package/dist/utils/precompressed-variant.d.ts

@@ -1,9 +1,8 @@
 //#region src/utils/precompressed-variant.d.ts
-type PrecompressedEncoding = "br" | "gzip" | "zstd";
+export type PrecompressedEncoding = "br" | "gzip" | "zstd";
 /**
  * Return whether an encoded representation reduces conservative HTTP/1 wire
  * bytes after accounting for the response fields needed to negotiate it.
  */
-declare function isPrecompressedVariantBeneficial(compressedSize: number, originalSize: number, encoding: PrecompressedEncoding): boolean;
-//#endregion
-export { PrecompressedEncoding, isPrecompressedVariantBeneficial };
+export declare function isPrecompressedVariantBeneficial(compressedSize: number, originalSize: number, encoding: PrecompressedEncoding): boolean;
+//#endregion

package/dist/utils/prerender-output-paths.d.ts

@@ -3,14 +3,13 @@
  * Determine the HTML output file path for a prerendered URL.
  * Respects trailingSlash config.
  */
-declare function getOutputPath(urlPath: string, trailingSlash: boolean): string;
-/**
- * Determine the RSC output file path for a prerendered URL.
- * "/blog/hello-world" -> "blog/hello-world.rsc"
- * "/"                 -> "index.rsc"
- */
-declare function getRscOutputPath(urlPath: string): string;
+export declare function getOutputPath(urlPath: string, trailingSlash: boolean, basePath?: string): string;
+/** Determine the Flight payload path for a prerendered App Router URL. */
+export declare function getRscOutputPath(urlPath: string, options?: {
+  mode: "default" | "export";
+  trailingSlash: boolean;
+  basePath?: string;
+}): string;
 /** Determine the binary artifact path for a prerendered App Route response. */
-declare function getAppRouteOutputPath(urlPath: string): string;
-//#endregion
-export { getAppRouteOutputPath, getOutputPath, getRscOutputPath };
+export declare function getAppRouteOutputPath(urlPath: string): string;
+//#endregion