vinext 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/build/prerender.js

@@ -1,8 +1,9 @@
 import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { createValidFileMatcher, findFileWithExtensions } from "../routing/file-matcher.js";
 import { VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER } from "../utils/protocol-headers.js";
-import { NEXT_CACHE_TAGS_HEADER, VINEXT_PRERENDER_CACHE_LIFE_HEADER } from "../server/headers.js";
+import { NEXT_CACHE_TAGS_HEADER, VINEXT_METADATA_ROUTE_CACHE_HEADER, VINEXT_PRERENDER_CACHE_LIFE_HEADER, VINEXT_PRERENDER_METADATA_ROUTES_PATH } from "../server/headers.js";
 import { classifyAppRoute, classifyPagesRoute, getAppRouteRenderEntryPath } from "./report.js";
+import { resolveClientStaleTimeSeconds } from "../utils/cache-control-metadata.js";
 import { NoOpCacheHandler, getCacheHandler, setCacheHandler } from "../shims/cache-handler.js";
 import { headersContextFromRequest, runWithHeadersContext } from "../shims/headers.js";
 import { _consumeRequestScopedCacheLife } from "../shims/cache-request-state.js";
@@ -14,9 +15,12 @@ import { navigationRuntimeRscBootstrapExpression } from "../server/app-ssr-strea
 import { encodePrerenderRouteParams, serializePrerenderRouteParamsHeader } from "../server/prerender-route-params.js";
 import { readPrerenderSecret } from "./server-manifest.js";
 import { createAppPprFallbackShells, markAppPprDynamicFallbackShellHtml } from "../server/app-ppr-fallback-shell.js";
-import { getOutputPath, getRscOutputPath } from "../utils/prerender-output-paths.js";
+import { getAppRouteOutputPath, getOutputPath, getRscOutputPath } from "../utils/prerender-output-paths.js";
 import { startProdServer } from "../server/prod-server.js";
 import { prerenderPoolAvailable, resolvePrerenderPoolSize, startPrerenderServerPool } from "./prerender-server-pool.js";
+import { enterPrerenderPhase } from "./prerender-phase.js";
+import { buildAppRouteCacheValue } from "../server/app-route-handler-response.js";
+import { isMetadataResponseCacheable } from "../server/metadata-route-cache-policy.js";
 import fs from "node:fs";
 import os from "node:os";
 //#region src/build/prerender.ts
@@ -264,8 +268,7 @@ async function prerenderPages({ routes, apiRoutes, pagesDir, outDir, config, mod
 	});
 	const previousHandler = getCacheHandler();
 	setCacheHandler(new NoOpCacheHandler());
-	const previousPrerenderFlag = process.env.VINEXT_PRERENDER;
-	process.env.VINEXT_PRERENDER = "1";
+	const restorePrerenderPhase = enterPrerenderPhase();
 	let ownedProdServerHandle = null;
 	let renderPool = null;
 	try {
@@ -496,11 +499,13 @@ async function prerenderPages({ routes, apiRoutes, pagesDir, outDir, config, mod
 		});
 		return { routes: results };
 	} finally {
-		if (renderPool) await renderPool.close();
-		setCacheHandler(previousHandler);
-		if (previousPrerenderFlag === void 0) delete process.env.VINEXT_PRERENDER;
-		else process.env.VINEXT_PRERENDER = previousPrerenderFlag;
-		if (ownedProdServerHandle) await new Promise((resolve) => ownedProdServerHandle.server.close(() => resolve()));
+		try {
+			if (renderPool) await renderPool.close();
+			setCacheHandler(previousHandler);
+			if (ownedProdServerHandle) await new Promise((resolve) => ownedProdServerHandle.server.close(() => resolve()));
+		} finally {
+			restorePrerenderPhase();
+		}
 	}
 }
 /**
@@ -529,8 +534,7 @@ async function prerenderApp({ routes, metadataRoutes = [], outDir, config, mode,
 	fs.mkdirSync(outDir, { recursive: true });
 	const previousHandler = getCacheHandler();
 	setCacheHandler(new NoOpCacheHandler());
-	const previousPrerenderFlag = process.env.VINEXT_PRERENDER;
-	process.env.VINEXT_PRERENDER = "1";
+	const restorePrerenderPhase = enterPrerenderPhase();
 	const serverDir = path.dirname(rscBundlePath);
 	let rscHandler;
 	let staticParamsMap = {};
@@ -742,14 +746,83 @@ async function prerenderApp({ routes, metadataRoutes = [], outDir, config, mode,
 				isSpeculative: false
 			});
 		}
+		if (metadataRoutes.length > 0) {
+			const response = await fetch(`${baseUrl}${VINEXT_PRERENDER_METADATA_ROUTES_PATH}`, { headers: secretHeaders });
+			const text = await response.text();
+			if (!response.ok) throw new Error(`[vinext] Failed to enumerate prerenderable metadata routes: ${parsePrerenderEndpointError(text)}`);
+			const metadataEntries = JSON.parse(text);
+			if (!Array.isArray(metadataEntries)) throw new Error("[vinext] Invalid prerender metadata route response");
+			const queuedMetadataPaths = /* @__PURE__ */ new Set();
+			for (const metadataEntry of metadataEntries) {
+				if (typeof metadataEntry !== "object" || metadataEntry === null || typeof Reflect.get(metadataEntry, "path") !== "string" || typeof Reflect.get(metadataEntry, "routePattern") !== "string" || !Array.isArray(Reflect.get(metadataEntry, "routeSegments"))) continue;
+				const { path: metadataPath, routePattern, routeSegments } = metadataEntry;
+				if (!metadataPath.startsWith("/") || !routePattern.startsWith("/") || routeSegments.some((segment) => typeof segment !== "string") || queuedMetadataPaths.has(metadataPath)) continue;
+				queuedMetadataPaths.add(metadataPath);
+				urlsToRender.push({
+					kind: "metadata",
+					metadataRouteSegments: routeSegments,
+					urlPath: metadataPath,
+					routePattern,
+					prerenderRouteParams: null,
+					revalidate: false,
+					isSpeculative: false
+				});
+			}
+		}
 		/**
 		* Render a single URL and return its result.
 		* `onProgress` is intentionally not called here; the outer loop calls it
 		* exactly once per URL after this function returns, keeping the callback
 		* at a single, predictable call site.
 		*/
-		async function renderUrl({ urlPath, routePattern, prerenderRouteParams, revalidate, isSpeculative, isFallback }) {
+		async function renderUrl({ kind, metadataRouteSegments, urlPath, routePattern, prerenderRouteParams, revalidate, isSpeculative, isFallback }) {
 			try {
+				if (kind === "metadata") {
+					const request = new Request(`http://localhost${config.basePath ?? ""}${urlPath}`);
+					const response = await runWithHeadersContext(headersContextFromRequest(request), () => rscHandler(request));
+					if (!response.ok) {
+						await response.body?.cancel();
+						return {
+							route: routePattern,
+							status: "error",
+							error: `Metadata route returned ${response.status}`
+						};
+					}
+					const cacheControl = response.headers.get("cache-control") ?? "";
+					if (!isMetadataResponseCacheable(response)) {
+						await response.body?.cancel();
+						return {
+							route: routePattern,
+							status: "skipped",
+							reason: "dynamic"
+						};
+					}
+					const requestCacheLife = readPrerenderCacheLifeHeader(response.headers);
+					const collectedTags = readPrerenderCacheTagsHeader(response.headers);
+					const cacheValue = await buildAppRouteCacheValue(response);
+					cacheValue.headers[VINEXT_METADATA_ROUTE_CACHE_HEADER] = "1";
+					const outputPath = getAppRouteOutputPath(urlPath);
+					const fullPath = path.join(outDir, outputPath);
+					fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+					fs.writeFileSync(fullPath, new Uint8Array(cacheValue.body));
+					const renderedCacheControl = resolveRenderedCacheControl(requestCacheLife ?? {}, cacheControl, config.expireTime);
+					const renderedRevalidate = renderedCacheControl.revalidate ?? false;
+					const renderedStale = resolveClientStaleTimeSeconds(requestCacheLife ?? void 0);
+					return {
+						route: routePattern,
+						...urlPath === routePattern ? {} : { path: urlPath },
+						status: "rendered",
+						outputFiles: [outputPath],
+						revalidate: renderedRevalidate,
+						...typeof renderedRevalidate === "number" ? { expire: renderedCacheControl.expire } : {},
+						...renderedStale === void 0 ? {} : { stale: renderedStale },
+						router: "metadata",
+						headers: cacheValue.headers,
+						responseStatus: cacheValue.status,
+						routeSegments: metadataRouteSegments ?? [],
+						tags: collectedTags
+					};
+				}
 				const prerenderRouteParamsHeader = serializePrerenderRouteParamsHeader(prerenderRouteParams);
 				const htmlHeaders = new Headers();
 				if (prerenderRouteParamsHeader !== null) htmlHeaders.set(VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, prerenderRouteParamsHeader);
@@ -838,12 +911,14 @@ async function prerenderApp({ routes, metadataRoutes = [], outDir, config, mode,
 				outputFiles.push(rscOutputPath);
 				const renderedCacheControl = resolveRenderedCacheControl(htmlRender.requestCacheLife ?? {}, htmlCacheControl, config.expireTime);
 				const renderedRevalidate = typeof revalidate === "number" ? renderedCacheControl.revalidate === void 0 ? revalidate : Math.min(revalidate, renderedCacheControl.revalidate) : renderedCacheControl.revalidate ?? revalidate;
+				const renderedStale = resolveClientStaleTimeSeconds(htmlRender.requestCacheLife);
 				return {
 					route: routePattern,
 					status: "rendered",
 					outputFiles,
 					revalidate: renderedRevalidate,
 					...typeof renderedRevalidate === "number" ? { expire: renderedCacheControl.expire } : {},
+					...renderedStale === void 0 ? {} : { stale: renderedStale },
 					router: "app",
 					...htmlRender.tags.length > 0 ? { tags: htmlRender.tags } : {},
 					...htmlRender.linkHeader ? { headers: { link: htmlRender.linkHeader } } : {},
@@ -916,11 +991,13 @@ async function prerenderApp({ routes, metadataRoutes = [], outDir, config, mode,
 			...outputFiles.length > 0 ? { outputFiles } : {}
 		};
 	} finally {
-		if (renderPool) await renderPool.close();
-		setCacheHandler(previousHandler);
-		if (previousPrerenderFlag === void 0) delete process.env.VINEXT_PRERENDER;
-		else process.env.VINEXT_PRERENDER = previousPrerenderFlag;
-		if (ownedProdServerHandle) await new Promise((resolve) => ownedProdServerHandle.server.close(() => resolve()));
+		try {
+			if (renderPool) await renderPool.close();
+			setCacheHandler(previousHandler);
+			if (ownedProdServerHandle) await new Promise((resolve) => ownedProdServerHandle.server.close(() => resolve()));
+		} finally {
+			restorePrerenderPhase();
+		}
 	}
 }
 function resolveRenderedCacheControl(requestCacheLife, cacheControl, fallbackExpireSeconds) {
@@ -944,7 +1021,8 @@ function readPrerenderCacheLifeHeader(headers) {
 		const cacheLife = {};
 		if (typeof parsed.revalidate === "number" && Number.isFinite(parsed.revalidate)) cacheLife.revalidate = parsed.revalidate;
 		if (typeof parsed.expire === "number" && Number.isFinite(parsed.expire)) cacheLife.expire = parsed.expire;
-		return cacheLife.revalidate === void 0 && cacheLife.expire === void 0 ? null : cacheLife;
+		if (typeof parsed.stale === "number" && Number.isFinite(parsed.stale) && parsed.stale >= 0) cacheLife.stale = parsed.stale;
+		return cacheLife.revalidate === void 0 && cacheLife.expire === void 0 && cacheLife.stale === void 0 ? null : cacheLife;
 	} catch {
 		return null;
 	}
@@ -984,9 +1062,12 @@ function writePrerenderIndex(routes, outDir, options) {
 			status: r.status,
 			revalidate: r.revalidate,
 			...typeof r.revalidate === "number" ? { expire: r.expire } : {},
+			...typeof r.stale === "number" ? { stale: r.stale } : {},
 			router: r.router,
 			...r.tags && r.tags.length > 0 ? { tags: r.tags } : {},
+			...r.routeSegments ? { routeSegments: r.routeSegments } : {},
 			...r.headers ? { headers: r.headers } : {},
+			...typeof r.responseStatus === "number" ? { responseStatus: r.responseStatus } : {},
 			...r.path ? { path: r.path } : {},
 			...r.fallback ? { fallback: true } : {}
 		};

package/dist/build/public-dir-conflict.d.ts

@@ -0,0 +1,14 @@
+//#region src/build/public-dir-conflict.d.ts
+type PublicDirConflictOptions = {
+  root: string;
+  publicDir: string | null;
+  assetsDir: string;
+};
+type PublicNextRequestConflictOptions = Pick<PublicDirConflictOptions, "root" | "publicDir"> & {
+  basePath: string;
+  requestUrl: string;
+};
+declare function assertNoPublicNextRequestConflict({ root, publicDir, basePath, requestUrl }: PublicNextRequestConflictOptions): void;
+declare function assertNoPublicDirAssetConflict({ root, publicDir, assetsDir }: PublicDirConflictOptions): void;
+//#endregion
+export { PublicDirConflictOptions, PublicNextRequestConflictOptions, assertNoPublicDirAssetConflict, assertNoPublicNextRequestConflict };

package/dist/build/public-dir-conflict.js

@@ -0,0 +1,25 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
+import { existsSync } from "node:fs";
+//#region src/build/public-dir-conflict.ts
+const PUBLIC_NEXT_CONFLICT_ERROR = "You can not have a '_next' folder inside of your public folder. This conflicts with the internal '/_next' route. https://nextjs.org/docs/messages/public-next-folder-conflict";
+function assertNoPublicNextDir(root, publicDir) {
+	if (!publicDir) return;
+	if (existsSync(path.join(path.resolve(root, publicDir), "_next"))) throw new Error(PUBLIC_NEXT_CONFLICT_ERROR);
+}
+function assertNoPublicNextRequestConflict({ root, publicDir, basePath, requestUrl }) {
+	const internalOrigin = "http://vinext.invalid";
+	const parseTarget = requestUrl.startsWith("/") ? internalOrigin + requestUrl : requestUrl;
+	let pathname = new URL(parseTarget, internalOrigin).pathname;
+	if (basePath && (pathname === basePath || pathname.startsWith(basePath + "/"))) pathname = pathname.slice(basePath.length) || "/";
+	if (pathname.startsWith("/_next")) assertNoPublicNextDir(root, publicDir);
+}
+function assertNoPublicDirAssetConflict({ root, publicDir, assetsDir }) {
+	assertNoPublicNextDir(root, publicDir);
+	if (!publicDir || !assetsDir) return;
+	const resolvedPublicDir = path.resolve(root, publicDir);
+	const publicAssetsDir = path.resolve(resolvedPublicDir, assetsDir);
+	const relativeAssetsDir = path.relative(resolvedPublicDir, publicAssetsDir);
+	if (relativeAssetsDir !== "" && !relativeAssetsDir.startsWith("../") && !path.isAbsolute(relativeAssetsDir) && existsSync(publicAssetsDir)) throw new Error(`[vinext] The public directory contains a path reserved for build assets: ${relativeAssetsDir}`);
+}
+//#endregion
+export { assertNoPublicDirAssetConflict, assertNoPublicNextRequestConflict };

package/dist/build/report.d.ts

@@ -2,12 +2,12 @@ import { LayoutBuildClassification } from "./layout-classification-types.js";
 import { Route } from "../routing/pages-router.js";
 import { AppRoute } from "../routing/app-route-graph.js";
 import { PrerenderResult } from "./prerender.js";
-
 //#region src/build/report.d.ts
 type RouteType = "static" | "isr" | "ssr" | "unknown" | "api";
 type RouteRow = {
   pattern: string;
-  type: RouteType; /** Only set for `isr` routes. */
+  type: RouteType;
+  /** Only set for `isr` routes. */
   revalidate?: number;
   /**
    * True when the route was classified as `static` by speculative prerender

package/dist/build/route-classification-injector.d.ts

@@ -1,6 +1,5 @@
 import { ModuleInfoProvider } from "./layout-classification.js";
 import { RouteClassificationManifest } from "./route-classification-manifest.js";
-
 //#region src/build/route-classification-injector.d.ts
 /**
  * Build-time route classification injection.

package/dist/build/route-classification-manifest.d.ts

@@ -1,11 +1,13 @@
 import { ClassificationReason, ModuleGraphStaticReason } from "./layout-classification-types.js";
 import { AppRoute } from "../routing/app-route-graph.js";
-
 //#region src/build/route-classification-manifest.d.ts
 type Layer1Class = "static" | "dynamic";
 type RouteManifestEntry = {
-  /** Route pattern for diagnostics (e.g. "/blog/:slug"). */pattern: string; /** Absolute file paths for each layout, ordered root → leaf. */
-  layoutPaths: string[]; /** Layer 1 (segment config) results keyed by numeric layout index. */
+  /** Route pattern for diagnostics (e.g. "/blog/:slug"). */
+  pattern: string;
+  /** Absolute file paths for each layout, ordered root → leaf. */
+  layoutPaths: string[];
+  /** Layer 1 (segment config) results keyed by numeric layout index. */
   layer1: Map<number, Layer1Class>;
   /**
    * Structured reasons for every Layer 1 decision, keyed by the same layout

package/dist/build/run-prerender.d.ts

@@ -1,9 +1,10 @@
 import { ResolvedNextConfig } from "../config/next-config.js";
 import { PrerenderResult, PrerenderRouteResult } from "./prerender.js";
-
 //#region src/build/run-prerender.d.ts
 type RunPrerenderOptions = {
-  /** Project root directory. */root: string; /** Fully resolved Next.js config. Loaded from disk when omitted. */
+  /** Project root directory. */
+  root: string;
+  /** Fully resolved Next.js config. Loaded from disk when omitted. */
   nextConfig?: ResolvedNextConfig;
   /**
    * Override the path to the Pages Router server bundle.

package/dist/build/run-prerender.js

@@ -3,9 +3,11 @@ import { findDir } from "../utils/project.js";
 import { apiRouter, pagesRouter } from "../routing/pages-router.js";
 import { appRouter } from "../routing/app-router.js";
 import { scanMetadataFiles } from "../server/metadata-routes.js";
+import { PHASE_PRODUCTION_BUILD } from "../shims/constants.js";
 import { loadNextConfig, resolveNextConfig } from "../config/next-config.js";
 import { readPrerenderSecret } from "./server-manifest.js";
 import { rememberCurrentServerEntryImportMtime, startProdServer } from "../server/prod-server.js";
+import { enterPrerenderPhase } from "./prerender-phase.js";
 import { prerenderApp, prerenderPages, writePrerenderIndex } from "./prerender.js";
 import { injectPregeneratedConcretePaths } from "./inject-pregenerated-paths.js";
 import fs from "node:fs";
@@ -104,12 +106,10 @@ async function runPrerender(options) {
 	const appDir = findDir(root, "app", "src/app");
 	const pagesDir = findDir(root, "pages", "src/pages");
 	if (!appDir && !pagesDir) return null;
-	const previousPrerenderFlag = process.env.VINEXT_PRERENDER;
-	process.env.VINEXT_PRERENDER = "1";
 	const manifestDir = path.join(root, "dist", "server");
 	const rscBundlePath = options.rscBundlePath ?? path.join(root, "dist", "server", "index.js");
 	const serverDir = path.dirname(rscBundlePath);
-	const config = options.nextConfig ? { ...options.nextConfig } : { ...await resolveNextConfig(await loadNextConfig(root), root) };
+	const config = options.nextConfig ? { ...options.nextConfig } : { ...await resolveNextConfig(await loadNextConfig(root, PHASE_PRODUCTION_BUILD), root) };
 	const builtBuildId = readBuiltBuildId(serverDir);
 	if (builtBuildId) config.buildId = builtBuildId;
 	const mode = config.output === "export" ? "export" : "default";
@@ -121,6 +121,7 @@ async function runPrerender(options) {
 	const outDir = mode === "export" ? path.join(root, "dist", "client") : path.join(root, "dist", "server", "prerendered-routes");
 	let sharedProdServer = null;
 	let sharedPrerenderSecret;
+	const restorePrerenderPhase = enterPrerenderPhase();
 	try {
 		if (appDir && pagesDir) {
 			sharedProdServer = await startProdServer({
@@ -187,9 +188,11 @@ async function runPrerender(options) {
 			if (result.outputFiles) allOutputFiles.push(...result.outputFiles);
 		}
 	} finally {
-		if (sharedProdServer) await new Promise((resolve) => sharedProdServer.server.close(() => resolve()));
-		if (previousPrerenderFlag === void 0) delete process.env.VINEXT_PRERENDER;
-		else process.env.VINEXT_PRERENDER = previousPrerenderFlag;
+		try {
+			if (sharedProdServer) await new Promise((resolve) => sharedProdServer.server.close(() => resolve()));
+		} finally {
+			restorePrerenderPhase();
+		}
 	}
 	if (allRoutes.length === 0) {
 		progress.finish(0, 0, 0);

package/dist/build/static-export.d.ts

@@ -1,24 +1,32 @@
 import { ResolvedNextConfig } from "../config/next-config.js";
 import { Route } from "../routing/pages-router.js";
 import { AppRoute } from "../routing/app-route-graph.js";
-
 //#region src/build/static-export.d.ts
 type StaticExportOptions = {
   /**
    * Absolute path to the pre-built Pages Router server bundle
    * (e.g. `dist/server/entry.js`).
    */
-  pagesBundlePath: string; /** Discovered page routes (excludes API routes) */
-  routes: Route[]; /** Discovered API routes */
-  apiRoutes: Route[]; /** Pages directory path */
-  pagesDir: string; /** Output directory for static files */
-  outDir: string; /** Resolved next.config.js */
+  pagesBundlePath: string;
+  /** Discovered page routes (excludes API routes) */
+  routes: Route[];
+  /** Discovered API routes */
+  apiRoutes: Route[];
+  /** Pages directory path */
+  pagesDir: string;
+  /** Output directory for static files */
+  outDir: string;
+  /** Resolved next.config.js */
   config: ResolvedNextConfig;
 };
 type StaticExportResult = {
-  /** Number of HTML files generated */pageCount: number; /** Generated file paths (relative to outDir) */
-  files: string[]; /** Warnings encountered */
-  warnings: string[]; /** Errors encountered (non-fatal, specific pages) */
+  /** Number of HTML files generated */
+  pageCount: number;
+  /** Generated file paths (relative to outDir) */
+  files: string[];
+  /** Warnings encountered */
+  warnings: string[];
+  /** Errors encountered (non-fatal, specific pages) */
   errors: Array<{
     route: string;
     error: string;
@@ -31,7 +39,8 @@ type StaticExportResult = {
  */
 declare function staticExportPages(options: StaticExportOptions): Promise<StaticExportResult>;
 type AppStaticExportOptions = {
-  /** Discovered app routes */routes: AppRoute[];
+  /** Discovered app routes */
+  routes: AppRoute[];
   /**
    * App directory path. When provided, static export scans it for file-based
    * metadata assets such as icon.png and sitemap.xml.
@@ -41,8 +50,10 @@ type AppStaticExportOptions = {
    * Absolute path to the pre-built RSC handler bundle
    * (e.g. `dist/server/index.js`).
    */
-  rscBundlePath: string; /** Output directory */
-  outDir: string; /** Resolved next.config.js */
+  rscBundlePath: string;
+  /** Output directory */
+  outDir: string;
+  /** Resolved next.config.js */
   config: ResolvedNextConfig;
 };
 /**

package/dist/cache/cache-adapters-virtual.d.ts

@@ -11,7 +11,8 @@ type CacheAdapterDescriptor<O extends Record<string, unknown> = Record<string, u
    * Module specifier (or absolute path, e.g. from `require.resolve(...)`) whose
    * default export is a cache adapter factory.
    */
-  adapter: string; /** JSON-serializable options forwarded to the factory at runtime. */
+  adapter: string;
+  /** JSON-serializable options forwarded to the factory at runtime. */
   options?: O;
 };
 /**
@@ -20,7 +21,9 @@ type CacheAdapterDescriptor<O extends Record<string, unknown> = Record<string, u
  * from a worker entry.
  */
 type VinextCacheConfig = {
-  /** Page-level ISR serving strategy (CDN cache adapter). */cdn?: CacheAdapterDescriptor; /** Data cache (fetch / `"use cache"` / `unstable_cache`) handler. */
+  /** Page-level ISR serving strategy (CDN cache adapter). */
+  cdn?: CacheAdapterDescriptor;
+  /** Data cache (fetch / `"use cache"` / `unstable_cache`) handler. */
   data?: CacheAdapterDescriptor;
 };
 /** Public virtual module id imported by the server entries. */

package/dist/check.js

@@ -295,12 +295,12 @@ const CONFIG_SUPPORT = {
 		detail: "not recognized; instrumentation files are enabled automatically"
 	},
 	skipMiddlewareUrlNormalize: {
-		status: "unsupported",
-		detail: "not recognized; use of this option is ignored"
+		status: "partial",
+		detail: "preserves raw Pages Router _next/data URLs passed to middleware"
 	},
 	skipProxyUrlNormalize: {
-		status: "unsupported",
-		detail: "not recognized; use of this option is ignored"
+		status: "partial",
+		detail: "preserves raw Pages Router _next/data URLs passed to proxy"
 	},
 	"i18n.domains": {
 		status: "partial",

package/dist/cli-dev-config.d.ts

@@ -1,5 +1,4 @@
 import { Plugin, ServerOptions } from "vite";
-
 //#region src/cli-dev-config.d.ts
 type DevServerCliOptions = {
   port?: number;

package/dist/cli.d.ts

@@ -1 +1 @@
-export { };
+export {}

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

@@ -0,0 +1,12 @@
+import { RequestContext } from "../config/request-context.js";
+import { BasePathMatchState } from "../config/config-matchers.js";
+import { ClientRewrite } from "./client-rewrites.js";
+//#region src/client/client-rewrite-matcher.d.ts
+declare function matchClientRewrite(pathname: string, rewrite: ClientRewrite, context: RequestContext, basePathState: BasePathMatchState): {
+  kind: "rewrite";
+  destination: string;
+} | {
+  kind: "server";
+} | null;
+//#endregion
+export { matchClientRewrite };

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

@@ -0,0 +1,20 @@
+import { isExternalUrl } from "../utils/external-url.js";
+import { matchRewrite } from "../config/config-matchers.js";
+//#region src/client/client-rewrite-matcher.ts
+function matchClientRewrite(pathname, rewrite, context, basePathState) {
+	const destination = matchRewrite(pathname, [{
+		source: rewrite.source,
+		destination: rewrite.destination ?? "/",
+		has: rewrite.has,
+		locale: rewrite.locale,
+		basePath: rewrite.basePath
+	}], context, basePathState);
+	if (destination === null) return null;
+	if (rewrite.requiresServerEvaluation || isExternalUrl(destination)) return { kind: "server" };
+	return {
+		kind: "rewrite",
+		destination
+	};
+}
+//#endregion
+export { matchClientRewrite };

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

@@ -0,0 +1,31 @@
+import { HasCondition, NextRewrite, ResolvedNextConfig } from "../config/next-config.js";
+//#region src/client/client-rewrites.d.ts
+type ClientHasCondition = Omit<HasCondition, "type"> & {
+  type: "host" | "query";
+};
+type ClientRewriteFields = Pick<NextRewrite, "basePath" | "locale" | "source"> & {
+  has?: ClientHasCondition[];
+};
+/**
+ * Rewrite data that is safe to publish in a browser bundle.
+ *
+ * Rules that require server-only data deliberately omit both the destination
+ * and the data that made server evaluation necessary. The client can still
+ * use browser-authoritative conditions as a prefilter before handing the
+ * navigation to the server.
+ */
+type ClientRewrite = (ClientRewriteFields & {
+  destination: string;
+  requiresServerEvaluation?: never;
+}) | (ClientRewriteFields & {
+  destination?: never;
+  requiresServerEvaluation: true;
+});
+type ClientRewrites = {
+  afterFiles: ClientRewrite[];
+  beforeFiles: ClientRewrite[];
+  fallback: ClientRewrite[];
+};
+declare function toClientRewrites(rewrites: ResolvedNextConfig["rewrites"]): ClientRewrites;
+//#endregion
+export { ClientRewrite, ClientRewrites, toClientRewrites };

package/dist/client/client-rewrites.js

@@ -0,0 +1,41 @@
+import { isExternalUrl } from "../utils/external-url.js";
+//#region src/client/client-rewrites.ts
+function isClientHasCondition(condition) {
+	switch (condition.type) {
+		case "host":
+		case "query": return true;
+		case "cookie":
+		case "header": return false;
+		default: return false;
+	}
+}
+function toClientRewrite(rewrite) {
+	const clientHas = rewrite.has?.filter(isClientHasCondition);
+	const hasServerOnlyCondition = rewrite.has?.some((condition) => !isClientHasCondition(condition)) ?? false;
+	const common = {
+		source: rewrite.source,
+		has: clientHas?.length ? clientHas : void 0,
+		locale: rewrite.locale,
+		basePath: rewrite.basePath
+	};
+	if (isExternalUrl(rewrite.destination) || (rewrite.missing?.length ?? 0) > 0 || hasServerOnlyCondition) return {
+		...common,
+		requiresServerEvaluation: true
+	};
+	return {
+		source: rewrite.source,
+		destination: rewrite.destination,
+		has: common.has,
+		locale: rewrite.locale,
+		basePath: rewrite.basePath
+	};
+}
+function toClientRewrites(rewrites) {
+	return {
+		beforeFiles: rewrites.beforeFiles.map(toClientRewrite),
+		afterFiles: rewrites.afterFiles.map(toClientRewrite),
+		fallback: rewrites.fallback.map(toClientRewrite)
+	};
+}
+//#endregion
+export { toClientRewrites };

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

@@ -1,5 +1,4 @@
 import { ReportedError, dismissOverlay } from "./dev-error-overlay-store.js";
-
 //#region src/client/dev-error-overlay.d.ts
 declare const DEV_ERROR_OVERLAY_HOST_ID = "__vinext_dev_error_overlay_root";
 declare const DEV_ERROR_OVERLAY_MOUNT_ID = "__vinext_dev_error_overlay_mount";

package/dist/client/empty-module.d.ts

@@ -1 +1 @@
-export { };
+export {}

package/dist/client/index.d.ts

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

package/dist/client/index.js

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

package/dist/client/instrumentation-client-state.d.ts

@@ -1,5 +1,4 @@
 import { ClientInstrumentationHooks } from "./instrumentation-client.js";
-
 //#region src/client/instrumentation-client-state.d.ts
 declare function normalizeClientInstrumentationHooks(hooks: ClientInstrumentationHooks): ClientInstrumentationHooks | null;
 declare function setClientInstrumentationHooks(hooks: ClientInstrumentationHooks | null): ClientInstrumentationHooks | null;

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

@@ -1,6 +1,5 @@
 import { RouteManifest } from "../routing/app-route-graph.js";
 import { AppRouterScrollIntent } from "../shims/app-router-scroll-state.js";
-
 //#region src/client/navigation-runtime.d.ts
 type NavigationRuntimeSnapshot = {
   pathname: string;
@@ -14,6 +13,12 @@ type NavigationRuntimeRscBootstrap = {
   nav?: NavigationRuntimeSnapshot;
   params?: Record<string, string | string[]>;
   rsc: NavigationRuntimeRscChunk[];
+  /**
+   * Client reuse bound in seconds resolved from the initial render's completed
+   * `cacheLife` — the done-script sibling of `dynamicStaleTimeSeconds`, which
+   * carries the `experimental.staleTimes` config value instead.
+   */
+  staleTimeSeconds?: number;
 };
 type NavigationRuntimeKind = "navigate" | "traverse" | "refresh";
 type NavigationRuntimeHistoryUpdateMode = "push" | "replace";

package/dist/client/navigation-runtime.js

@@ -55,7 +55,11 @@ function isNavigationRuntimeRscBootstrap(value) {
 	const nav = Reflect.get(value, "nav");
 	const params = Reflect.get(value, "params");
 	const rsc = Reflect.get(value, "rsc");
-	return (done === void 0 || typeof done === "boolean") && (dynamicStaleTimeSeconds === void 0 || typeof dynamicStaleTimeSeconds === "number" && Number.isFinite(dynamicStaleTimeSeconds) && dynamicStaleTimeSeconds >= 0) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk);
+	const staleTimeSeconds = Reflect.get(value, "staleTimeSeconds");
+	return (done === void 0 || typeof done === "boolean") && isOptionalStaleTimeSeconds(dynamicStaleTimeSeconds) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk) && isOptionalStaleTimeSeconds(staleTimeSeconds);
+}
+function isOptionalStaleTimeSeconds(value) {
+	return value === void 0 || typeof value === "number" && Number.isFinite(value) && value >= 0;
 }
 function isReadonlyStringArray(value) {
 	return Array.isArray(value) && value.every((entry) => typeof entry === "string");