vinext 1.2.1 → 1.3.1

package/dist/cli-args.d.ts

@@ -21,4 +21,5 @@ type ParsedArgs = {
  * arguments directly to Vite.
  */
 export declare function parseArgs(args: string[]): ParsedArgs;
-//#endregion
+//#endregion
+export {};

package/dist/cli.js

@@ -125,6 +125,7 @@ async function proxyVite(command) {
 async function start() {
 	const parsed = parseArgs(rawArgs);
 	if (parsed.help) return printHelp("start");
+	if (!process.env.NODE_ENV) Reflect.set(process.env, "NODE_ENV", "production");
 	loadDotenv({
 		root: process.cwd(),
 		mode: "production"
@@ -194,6 +195,7 @@ async function check() {
 async function typegen() {
 	const parsed = parseArgs(rawArgs);
 	if (parsed.help) return printHelp("typegen");
+	if (!process.env.NODE_ENV) Reflect.set(process.env, "NODE_ENV", "production");
 	const root = path.resolve(parsed.positionals?.[0] ?? process.cwd());
 	loadDotenv({
 		root,

package/dist/client/client-redirect-matcher.js

@@ -11,7 +11,8 @@ function getMatcherRule(redirect) {
 			has: redirect.has,
 			missing: redirect.missing,
 			locale: redirect.locale,
-			basePath: redirect.basePath
+			basePath: redirect.basePath,
+			defaultLocaleVariant: redirect.defaultLocaleVariant
 		}];
 		matcherRules.set(redirect, rule);
 	}

package/dist/client/client-redirects.d.ts

@@ -1,7 +1,7 @@
 import { NextRedirect, ResolvedNextConfig } from "../config/next-config.js";
 import { ClientHasCondition } from "./client-rewrites.js";
 //#region src/client/client-redirects.d.ts
-type ClientRedirectFields = Pick<NextRedirect, "basePath" | "locale" | "source"> & {
+type ClientRedirectFields = Pick<NextRedirect, "basePath" | "defaultLocaleVariant" | "locale" | "source"> & {
   has?: ClientHasCondition[];
   missing?: ClientHasCondition[];
 };
@@ -16,7 +16,7 @@ type ClientRedirectFields = Pick<NextRedirect, "basePath" | "locale" | "source">
  */
 export type ClientRedirect = (ClientRedirectFields & {
   destination: string;
-  permanent: boolean;
+  permanent?: boolean;
   requiresServerEvaluation?: never;
 }) | (ClientRedirectFields & {
   destination?: never;
@@ -24,4 +24,5 @@ export type ClientRedirect = (ClientRedirectFields & {
   requiresServerEvaluation: true;
 });
 export declare function toClientRedirects(redirects: ResolvedNextConfig["redirects"]): ClientRedirect[];
-//#endregion
+//#endregion
+export {};

package/dist/client/client-redirects.js

@@ -9,7 +9,8 @@ function toClientRedirect(redirect) {
 		has: clientHas?.length ? clientHas : void 0,
 		missing: clientMissing?.length ? clientMissing : void 0,
 		locale: redirect.locale,
-		basePath: redirect.basePath
+		basePath: redirect.basePath,
+		defaultLocaleVariant: redirect.defaultLocaleVariant
 	};
 	if (hasServerOnlyCondition) return {
 		...common,

package/dist/client/client-rewrite-params.d.ts

@@ -0,0 +1,9 @@
+//#region src/client/client-rewrite-params.d.ts
+/**
+ * Whether a rewrite to `destination` appends the source `params` to its
+ * query. Next.js does that when the destination's path, host and hash use
+ * none of them, for each param its query does not already name; the Pages
+ * router's sync rewrite path does not, so it defers these rewrites.
+ */
+export declare function clientRewriteAppendsParams(destination: string, params: Record<string, string>): boolean;
+//#endregion

package/dist/client/client-rewrite-params.js

@@ -0,0 +1,20 @@
+//#region src/client/client-rewrite-params.ts
+/**
+* Whether a rewrite to `destination` appends the source `params` to its
+* query. Next.js does that when the destination's path, host and hash use
+* none of them, for each param its query does not already name; the Pages
+* router's sync rewrite path does not, so it defers these rewrites.
+*/
+function clientRewriteAppendsParams(destination, params) {
+	const keys = Object.keys(params).filter((key) => key !== "nextInternalLocale");
+	if (keys.length === 0) return false;
+	const hashIndex = destination.indexOf("#");
+	const beforeHash = hashIndex === -1 ? destination : destination.slice(0, hashIndex);
+	const queryIndex = beforeHash.indexOf("?");
+	const withoutQuery = (queryIndex === -1 ? beforeHash : beforeHash.slice(0, queryIndex)) + (hashIndex === -1 ? "" : destination.slice(hashIndex));
+	if (keys.some((key) => new RegExp(`:${key}(?![A-Za-z0-9_])`).test(withoutQuery))) return false;
+	const queryKeys = new Set(queryIndex === -1 ? [] : new URLSearchParams(beforeHash.slice(queryIndex + 1)).keys());
+	return keys.some((key) => !queryKeys.has(key));
+}
+//#endregion
+export { clientRewriteAppendsParams };

package/dist/client/client-rewrites.d.ts

@@ -28,4 +28,5 @@ export type ClientRewrites = {
 };
 export declare function isClientHasCondition(condition: HasCondition): condition is ClientHasCondition;
 export declare function toClientRewrites(rewrites: ResolvedNextConfig["rewrites"]): ClientRewrites;
-//#endregion
+//#endregion
+export {};

package/dist/client/dev-error-overlay-store.d.ts

@@ -35,4 +35,5 @@ export declare function dismissOverlay(): void;
 export declare function setOverlayIndex(index: number): void;
 export declare function minimizeOverlay(): void;
 export declare function expandOverlay(): void;
-//#endregion
+//#endregion
+export {};

package/dist/client/dev-error-overlay.js

@@ -26,11 +26,12 @@ function installDevErrorOverlay() {
 	installed = true;
 	window.addEventListener("error", (event) => {
 		const err = event.error;
+		if (!err) return;
 		if (isNavigationSignalError(err)) return;
 		if (err instanceof Error) {
 			if (alreadyReported(err)) return;
 			reportDevError(err, { source: "window-error" });
-		} else if (event.message) reportDevError(new Error(event.message), { source: "window-error" });
+		} else reportDevError(event.message ? new Error(event.message) : err, { source: "window-error" });
 	});
 	window.addEventListener("unhandledrejection", (event) => {
 		const reason = event.reason;

package/dist/client/index.js

@@ -1,2 +1 @@
-import { getVinextReact } from "./react-instance.js";
-export { getVinextReact };
+export { getVinextReact } from "./react-instance.js";

package/dist/client/instrumentation-client-state.js

@@ -1,17 +1,17 @@
 //#region src/client/instrumentation-client-state.ts
-let clientInstrumentationHooks = null;
+const VINEXT_CLIENT_INSTRUMENTATION_HOOKS = Symbol.for("vinext.client.instrumentationHooks");
 function normalizeClientInstrumentationHooks(hooks) {
 	return Object.values(hooks).some((value) => typeof value === "function") ? hooks : null;
 }
 function setClientInstrumentationHooks(hooks) {
-	clientInstrumentationHooks = hooks;
-	return clientInstrumentationHooks;
+	Reflect.set(globalThis, VINEXT_CLIENT_INSTRUMENTATION_HOOKS, hooks);
+	return hooks;
 }
 function getClientInstrumentationHooks() {
-	return clientInstrumentationHooks;
+	return Reflect.get(globalThis, VINEXT_CLIENT_INSTRUMENTATION_HOOKS) ?? null;
 }
 function notifyAppRouterTransitionStart(href, navigationType) {
-	clientInstrumentationHooks?.onRouterTransitionStart?.(href, navigationType);
+	getClientInstrumentationHooks()?.onRouterTransitionStart?.(href, navigationType);
 }
 //#endregion
 export { getClientInstrumentationHooks, normalizeClientInstrumentationHooks, notifyAppRouterTransitionStart, setClientInstrumentationHooks };

package/dist/client/navigation-runtime.d.ts

@@ -1,4 +1,4 @@
-import { RouteManifest } from "../routing/app-route-graph.js";
+import { BrowserRouteManifest, BrowserRouteManifestWire } from "../routing/browser-route-manifest.js";
 import { AppRouterScrollIntent } from "../shims/app-router-scroll-state.js";
 //#region src/client/navigation-runtime.d.ts
 type NavigationRuntimeSnapshot = {
@@ -7,6 +7,8 @@ type NavigationRuntimeSnapshot = {
 };
 export type NavigationRuntimeRscChunk = string | [3, string];
 export type NavigationRuntimeRscBootstrap = {
+  /** The server's App Router RSC compatibility ID for this page. */
+  compatibilityId?: string;
   done?: boolean;
   dynamicStaleTimeSeconds?: number;
   initialCacheKind?: "dynamic" | "static";
@@ -68,9 +70,15 @@ export type NavigationRuntimeFunctions = {
    * committing writes its URL first, as Next.js does from an insertion effect.
    */
   flushCommittingNavigationUrl?: () => void;
+  /**
+   * Starts loading the browser RouteManifest chunk, or joins the load in
+   * progress. Returns null once the manifest is registered. Created by
+   * createNavigationRuntimeRouteManifestLoader.
+   */
+  loadRouteManifest?: () => Promise<boolean> | null;
 };
 export type NavigationRuntimeBootstrap = {
-  routeManifest: RouteManifest | null;
+  routeManifest: BrowserRouteManifest | null;
   rsc: NavigationRuntimeRscBootstrap | undefined;
 };
 export type NavigationRuntime = {
@@ -78,10 +86,26 @@ export type NavigationRuntime = {
   functions: NavigationRuntimeFunctions;
 };
 export declare const NAVIGATION_RUNTIME_KEY: unique symbol;
+export declare function isNavigationRuntimeFunctions(value: unknown): value is NavigationRuntimeFunctions;
 export declare function getNavigationRuntime(): NavigationRuntime | null;
 export declare function registerNavigationRuntimeBootstrap(bootstrap: Partial<NavigationRuntimeBootstrap>): NavigationRuntime;
 export declare function registerNavigationRuntimeFunctions(functions: Partial<NavigationRuntimeFunctions>): NavigationRuntime;
 export declare function ensureNavigationRuntimeRscBootstrap(): NavigationRuntimeRscBootstrap;
+/**
+ * The browser entry does not inline the RouteManifest: the manifest grows with
+ * every route of the app, so it lives in its own chunk that loads alongside
+ * hydration. The navigation planner needs it to classify commits (root layout
+ * changes, intercepted payloads, preserved slots), so navigations, commits and
+ * prefetches that read it wait for this load first.
+ */
+export declare function createNavigationRuntimeRouteManifestLoader(importManifest: () => Promise<{
+  default: BrowserRouteManifestWire | null;
+}>): () => Promise<boolean> | null;
+/**
+ * Starts or joins the RouteManifest load. Resolves whether it loaded, and
+ * returns null once it has (or when no App Router runtime registered a loader).
+ */
+export declare function loadNavigationRuntimeRouteManifest(): Promise<boolean> | null;
 export declare function hasAppNavigationRuntime(): boolean;
 /**
  * True when the App Router has installed its runtime bootstrap on `window`,
@@ -96,4 +120,5 @@ export declare function hasAppNavigationRuntime(): boolean;
  * tag) should call this instead.
  */
 export declare function hasAppNavigationRuntimeBootstrap(): boolean;
-//#endregion
+//#endregion
+export {};

package/dist/client/navigation-runtime.js

@@ -1,20 +1,15 @@
 import { isUnknownRecord } from "../utils/record.js";
+import { decodeBrowserRouteManifest } from "../routing/browser-route-manifest.js";
 import { NAVIGATION_RUNTIME_SYMBOL_DESCRIPTION } from "./browser-globals.js";
 //#region src/client/navigation-runtime.ts
 const NAVIGATION_RUNTIME_KEY = Symbol.for(NAVIGATION_RUNTIME_SYMBOL_DESCRIPTION);
 const ROUTE_MANIFEST_SEGMENT_GRAPH_MAP_KEYS = [
-	"boundaries",
-	"defaults",
 	"interceptions",
 	"interceptionsBySlotId",
 	"layouts",
-	"pages",
 	"rootBoundaries",
-	"routeHandlers",
 	"routes",
-	"slotBindings",
-	"slots",
-	"templates"
+	"slotBindings"
 ];
 function createNavigationRuntime() {
 	return {
@@ -31,7 +26,7 @@ function readRuntimeWindow() {
 }
 function isNavigationRuntimeFunctions(value) {
 	if (!isUnknownRecord(value)) return false;
-	return isOptionalRuntimeFunction(Reflect.get(value, "clearNavigationCaches")) && isOptionalRuntimeFunction(Reflect.get(value, "commitHashNavigation")) && isOptionalRuntimeFunction(Reflect.get(value, "navigateExternal")) && isOptionalRuntimeFunction(Reflect.get(value, "navigate")) && isOptionalRuntimeFunction(Reflect.get(value, "getPrefetchRouterState")) && isOptionalRuntimeFunction(Reflect.get(value, "notifyLinkNavigationStart")) && isOptionalRuntimeFunction(Reflect.get(value, "pingVisibleLinks")) && isOptionalRuntimeFunction(Reflect.get(value, "preparePrefetchResponse")) && isOptionalRuntimeFunction(Reflect.get(value, "claimCurrentHistoryTreeSnapshot")) && isOptionalRuntimeFunction(Reflect.get(value, "commitAppOwnedHistoryStateWrite")) && isOptionalRuntimeFunction(Reflect.get(value, "discardPendingNavigation")) && isOptionalRuntimeFunction(Reflect.get(value, "flushCommittingNavigationUrl"));
+	return isOptionalRuntimeFunction(Reflect.get(value, "clearNavigationCaches")) && isOptionalRuntimeFunction(Reflect.get(value, "commitHashNavigation")) && isOptionalRuntimeFunction(Reflect.get(value, "navigateExternal")) && isOptionalRuntimeFunction(Reflect.get(value, "navigate")) && isOptionalRuntimeFunction(Reflect.get(value, "getPrefetchRouterState")) && isOptionalRuntimeFunction(Reflect.get(value, "notifyLinkNavigationStart")) && isOptionalRuntimeFunction(Reflect.get(value, "pingVisibleLinks")) && isOptionalRuntimeFunction(Reflect.get(value, "preparePrefetchResponse")) && isOptionalRuntimeFunction(Reflect.get(value, "claimCurrentHistoryTreeSnapshot")) && isOptionalRuntimeFunction(Reflect.get(value, "commitAppOwnedHistoryStateWrite")) && isOptionalRuntimeFunction(Reflect.get(value, "discardPendingNavigation")) && isOptionalRuntimeFunction(Reflect.get(value, "flushCommittingNavigationUrl")) && isOptionalRuntimeFunction(Reflect.get(value, "loadRouteManifest"));
 }
 function isNavigationRuntimeRscChunk(value) {
 	if (typeof value === "string") return true;
@@ -49,6 +44,7 @@ function isNavigationRuntimeParams(value) {
 }
 function isNavigationRuntimeRscBootstrap(value) {
 	if (!isUnknownRecord(value)) return false;
+	const compatibilityId = Reflect.get(value, "compatibilityId");
 	const done = Reflect.get(value, "done");
 	const dynamicStaleTimeSeconds = Reflect.get(value, "dynamicStaleTimeSeconds");
 	const initialCacheKind = Reflect.get(value, "initialCacheKind");
@@ -58,7 +54,7 @@ function isNavigationRuntimeRscBootstrap(value) {
 	const renderedSearch = Reflect.get(value, "renderedSearch");
 	const rsc = Reflect.get(value, "rsc");
 	const staleTimeSeconds = Reflect.get(value, "staleTimeSeconds");
-	return (done === void 0 || typeof done === "boolean") && isOptionalStaleTimeSeconds(dynamicStaleTimeSeconds) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (searchParamsFromBrowser === void 0 || typeof searchParamsFromBrowser === "boolean") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && (renderedSearch === void 0 || typeof renderedSearch === "string") && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk) && isOptionalStaleTimeSeconds(staleTimeSeconds);
+	return (compatibilityId === void 0 || typeof compatibilityId === "string") && (done === void 0 || typeof done === "boolean") && isOptionalStaleTimeSeconds(dynamicStaleTimeSeconds) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (searchParamsFromBrowser === void 0 || typeof searchParamsFromBrowser === "boolean") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && (renderedSearch === void 0 || typeof renderedSearch === "string") && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk) && isOptionalStaleTimeSeconds(staleTimeSeconds);
 }
 function isOptionalStaleTimeSeconds(value) {
 	return value === void 0 || typeof value === "number" && Number.isFinite(value) && value >= 0;
@@ -71,7 +67,7 @@ function isNullableString(value) {
 }
 function isNavigationRuntimeInterception(value) {
 	if (!isUnknownRecord(value)) return false;
-	return typeof value.id === "string" && typeof value.sourcePattern === "string" && isReadonlyStringArray(value.sourcePatternParts) && typeof value.targetPattern === "string" && isReadonlyStringArray(value.targetPatternParts) && typeof value.slotId === "string" && isNullableString(value.ownerLayoutId) && isNullableString(value.interceptingRouteId) && isNullableString(value.targetRouteId);
+	return typeof value.id === "string" && isReadonlyStringArray(value.sourcePatternParts) && isReadonlyStringArray(value.targetPatternParts) && typeof value.slotId === "string" && isNullableString(value.ownerLayoutId) && isNullableString(value.targetRouteId);
 }
 function isNavigationRuntimeInterceptionArray(value) {
 	return Array.isArray(value) && value.every(isNavigationRuntimeInterception);
@@ -150,6 +146,41 @@ function ensureNavigationRuntimeRscBootstrapForRuntime(runtime) {
 	}
 	return rscBootstrap;
 }
+/**
+* The browser entry does not inline the RouteManifest: the manifest grows with
+* every route of the app, so it lives in its own chunk that loads alongside
+* hydration. The navigation planner needs it to classify commits (root layout
+* changes, intercepted payloads, preserved slots), so navigations, commits and
+* prefetches that read it wait for this load first.
+*/
+function createNavigationRuntimeRouteManifestLoader(importManifest) {
+	let loaded = false;
+	let reportedFailure = false;
+	let pending = null;
+	return () => {
+		if (loaded) return null;
+		pending ??= importManifest().then(({ default: wire }) => {
+			registerNavigationRuntimeBootstrap({ routeManifest: wire === null ? null : decodeBrowserRouteManifest(wire) });
+			loaded = true;
+			return true;
+		}).catch((error) => {
+			pending = null;
+			if (!reportedFailure) {
+				reportedFailure = true;
+				console.error("[vinext] Failed to load the App Router route manifest:", error);
+			}
+			return false;
+		});
+		return pending;
+	};
+}
+/**
+* Starts or joins the RouteManifest load. Resolves whether it loaded, and
+* returns null once it has (or when no App Router runtime registered a loader).
+*/
+function loadNavigationRuntimeRouteManifest() {
+	return getNavigationRuntime()?.functions.loadRouteManifest?.() ?? null;
+}
 function hasAppNavigationRuntime() {
 	return typeof getNavigationRuntime()?.functions.navigate === "function";
 }
@@ -169,4 +200,4 @@ function hasAppNavigationRuntimeBootstrap() {
 	return getNavigationRuntime() !== null;
 }
 //#endregion
-export { NAVIGATION_RUNTIME_KEY, ensureNavigationRuntimeRscBootstrap, getNavigationRuntime, hasAppNavigationRuntime, hasAppNavigationRuntimeBootstrap, registerNavigationRuntimeBootstrap, registerNavigationRuntimeFunctions };
+export { NAVIGATION_RUNTIME_KEY, createNavigationRuntimeRouteManifestLoader, ensureNavigationRuntimeRscBootstrap, getNavigationRuntime, hasAppNavigationRuntime, hasAppNavigationRuntimeBootstrap, isNavigationRuntimeFunctions, loadNavigationRuntimeRouteManifest, registerNavigationRuntimeBootstrap, registerNavigationRuntimeFunctions };

package/dist/client/pages-router-link-navigation.d.ts

@@ -39,4 +39,5 @@ export declare function navigatePagesRouterLinkWithFallback({ router, loadRouter
   navigation: PagesRouterLinkNavigation;
   fallback: () => void;
 }): Promise<void>;
-//#endregion
+//#endregion
+export {};

package/dist/client/vinext-next-data.d.ts

@@ -5,10 +5,33 @@ export type VinextLinkPrefetchRoute = {
   documentOnly?: boolean;
   isDynamic: boolean;
   patternParts: string[];
+  /**
+   * The route's segment config rules out static generation, so Next.js
+   * renders it on every request, and its automatic prefetch never renders the
+   * page. Read at build time. Never set with Cache Components: segment config
+   * doesn't decide what renders dynamically there, so an automatic prefetch of
+   * a dynamic route without a loading boundary still renders its page
+   * (Next.js prefetches its static shell instead).
+   */
+  rendersDynamically?: true;
+  /**
+   * Intercepting pages that can render a URL of this route under a matching
+   * interception context. Next.js builds each as its own route, so its
+   * `rendersDynamically` replaces the route's own then. Set only alongside
+   * `rendersDynamically` classification.
+   */
+  intercepts?: VinextLinkPrefetchIntercept[];
   requiresDynamicNavigationRequest?: boolean;
   /** The route has dynamic params above its root layout. */
   hasRootParams?: true;
 };
+export type VinextLinkPrefetchIntercept = {
+  /** The URL pattern of the route the interception context must be on, or below. */
+  sourcePatternParts: string[];
+  /** The URL pattern the intercepting page intercepts. */
+  targetPatternParts: string[];
+  rendersDynamically?: true;
+};
 /**
  * Pages Router route pattern exposed to the client so the App Router's
  * navigation runtime can decide whether a soft-navigated URL should be
@@ -21,7 +44,6 @@ export type VinextLinkPrefetchRoute = {
  */
 export type VinextPagesLinkPrefetchRoute = {
   canPrefetchLoadingShell: false;
-  documentOnly?: boolean;
   isDynamic: boolean;
   patternParts: string[];
   requiresDynamicNavigationRequest?: boolean;
@@ -50,4 +72,5 @@ type VinextLocaleGlobalTarget = {
 export declare function extractVinextNextDataJson(html: string): string | null;
 export declare function parseVinextNextDataJson(json: string): BrowserVinextNextData;
 export declare function applyVinextLocaleGlobals(target: VinextLocaleGlobalTarget, nextData: VinextNextData): void;
-//#endregion
+//#endregion
+export {};

package/dist/client/window-next.d.ts

@@ -168,4 +168,5 @@ type WindowNext = {
  */
 export declare function installWindowNext(fields: Partial<WindowNext>): void;
 export declare function setWindowNextInternalSourcePage(sourcePage: string | null): void;
-//#endregion
+//#endregion
+export {};

package/dist/config/config-matchers.d.ts

@@ -2,34 +2,8 @@ import { HasCondition, NextHeader, NextI18nConfig, NextRedirect, NextRewrite } f
 import { RequestContext, normalizeHost, parseCookies, requestContextFromRequest } from "./request-context.js";
 import { RedirectDestinationQueryPart } from "./destination-params.js";
 import { isExternalUrl } from "../utils/external-url.js";
+import { configSourceError, matchConfigPattern } from "./config-source.js";
 //#region src/config/config-matchers.d.ts
-/**
- * Detect regex patterns vulnerable to catastrophic backtracking (ReDoS).
- *
- * Uses the same deterministic structural analysis as middleware matcher
- * validation. Nested bounded repetition is accepted only when its repeated
- * language has fixed width and unambiguous branches; a fixed outer count can
- * otherwise still cause polynomially catastrophic backtracking on long near
- * misses.
- *
- * Returns true if the pattern appears safe, false if it's potentially dangerous.
- */
-export declare function isSafeRegex(pattern: string, flags?: string): boolean;
-/**
- * Compile a regex pattern safely. Returns the compiled RegExp or null if the
- * pattern is invalid or vulnerable to ReDoS.
- *
- * Logs a warning when a pattern is rejected so developers can fix their config.
- */
-export declare function safeRegExp(pattern: string, flags?: string): RegExp | null;
-/**
- * Convert a Next.js header/rewrite/redirect source pattern into a regex string.
- *
- * Regex groups in the source (e.g. `(\d+)`) are extracted first, the remaining
- * text is escaped/converted in a **single pass** (avoiding chained `.replace()`
- * which CodeQL flags as incomplete sanitization), then groups are restored.
- */
-export declare function escapeHeaderSource(source: string): string;
 /**
  * basePath gating state passed alongside the pathname to every matcher.
  *
@@ -75,14 +49,13 @@ export declare function applyMiddlewareRequestHeaders(middlewareHeaders: Record<
   postMwReqCtx: RequestContext;
 };
 export declare function checkHasConditions(has: HasCondition[] | undefined, missing: HasCondition[] | undefined, ctx: RequestContext): boolean;
-export declare function matchConfigPattern(pathname: string, pattern: string): Record<string, string> | null;
 /**
  * A matched config redirect. `destinationQuery` holds the destination query's
  * parts, split before params were substituted, for merging the request query.
  */
 export type RedirectMatch = {
   destination: string;
-  permanent: boolean;
+  statusCode: number;
   destinationQuery: RedirectDestinationQueryPart[];
 };
 /**
@@ -184,6 +157,17 @@ export declare function sanitizeDestination(dest: string): string;
  * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/server-route-utils.ts
  */
 export declare function preserveRedirectDestinationQuery(destination: string, requestSearch: string, destinationQuery?: RedirectDestinationQueryPart[]): string;
+/**
+ * Percent-encode what a config-redirect `Location` header cannot carry.
+ *
+ * The destination template was already parsed like a URL by matchRedirect, so
+ * its literal path, hash and host are encoded as Next.js sends them. Captures
+ * and the destination query are inserted verbatim, like Next.js, so they can
+ * still hold control or non-ASCII characters. Next.js writes those raw and its
+ * Node server answers 500 for a character above U+00FF (the Headers
+ * constructor throws the same way); vinext percent-encodes them instead.
+ */
+export declare function encodeRedirectLocation(location: string): string;
 /**
  * Proxy an incoming request to an external URL and return the upstream response.
  *
@@ -220,17 +204,19 @@ export declare function matchHeaders(pathname: string, headers: NextHeader[], ct
  *     starts with `/:nextInternalLocale(en|sv|nl)` so that locale-prefixed
  *     URLs match. For redirects only, a second variant prefixed with
  *     `/${defaultLocale}` is also emitted, matching Next.js exactly.
- *   - **Vinext divergence**: we ALSO retain the original (unprefixed) source
- *     so that requests for the default locale that arrive without a prefix
- *     still match. Next.js solves this upstream by path-normalising every
- *     incoming default-locale request to include the prefix
- *     (`resolve-routes.ts` lines ~251-263); vinext currently does that
- *     normalisation only inside the pages-server-entry route matcher, so
- *     the rewrite/redirect matcher would otherwise miss unprefixed paths.
- *     Keeping the unprefixed variant gives functionally identical behaviour
- *     without requiring a server-wide path normalisation pass. The original
- *     source is appended LAST so the locale-aware variants win when both
- *     forms could match.
+ *   - Headers get only that variant, exactly like Next.js. Every header
+ *     matcher caller splices the (domain-aware) default locale into
+ *     unprefixed request paths first (`normalizeDefaultLocalePathname`,
+ *     mirroring `resolve-routes.ts`), so `/about` is matched as `/en/about`.
+ *     `/_next/*` paths are left unprefixed and therefore only match
+ *     `locale: false` rules, as in Next.js.
+ *   - **Vinext divergence (redirects/rewrites only)**: we ALSO retain the
+ *     original (unprefixed) source, appended LAST so the locale-aware
+ *     variants win when both forms could match. Their callers normalise
+ *     default-locale paths too, so this is a legacy fallback. Headers never
+ *     get it: it would apply rules Next.js skips (`/((?!api).*)` would match
+ *     `/fr/api/x` as `fr/api/x`), and default-locale requests would match
+ *     both variants, appending additive headers such as `Set-Cookie` twice.
  *
  * Destinations that are local (start with `/`) are similarly rewritten with
  * `/:nextInternalLocale` for the locale-capture variant so the locale
@@ -243,4 +229,4 @@ export declare function applyLocaleToRoutes<T extends NextRedirect | NextRewrite
   trailingSlash?: boolean;
 }): T[];
 //#endregion
-export { type RequestContext, isExternalUrl, normalizeHost, parseCookies, requestContextFromRequest };
+export { type RequestContext, configSourceError, isExternalUrl, matchConfigPattern, normalizeHost, parseCookies, requestContextFromRequest };