vinext 1.0.0-beta.8 → 1.0.0

package/dist/build/report.d.ts

@@ -3,8 +3,8 @@ import { LayoutBuildClassification } from "./layout-classification-types.js";
 import { Route } from "../routing/pages-router.js";
 import { PrerenderResult } from "./prerender.js";
 //#region src/build/report.d.ts
-type RouteType = "static" | "isr" | "ssr" | "unknown" | "api";
-type RouteRow = {
+export type RouteType = "static" | "isr" | "ssr" | "unknown" | "api";
+export type RouteRow = {
   pattern: string;
   type: RouteType;
   /** Only set for `isr` routes. */
@@ -23,8 +23,8 @@ type StaticMiddlewareMatcherObject = {
   has?: Array<Record<string, string>>;
   missing?: Array<Record<string, string>>;
 };
-type StaticMiddlewareMatcher = string | Array<string | StaticMiddlewareMatcherObject>;
-declare function getAppRouteRenderEntryPath(route: AppRouteRenderEntry): string | null;
+export type StaticMiddlewareMatcher = string | Array<string | StaticMiddlewareMatcherObject>;
+export declare function getAppRouteRenderEntryPath(route: AppRouteRenderEntry): string | null;
 /**
  * Returns true if the source code contains an export declaration with the given name.
  * For re-export specifiers, this intentionally follows Next.js' static analyzer
@@ -34,23 +34,28 @@ declare function getAppRouteRenderEntryPath(route: AppRouteRenderEntry): string
  *   export const foo = ...
  *   export { foo }
  */
-declare function hasNamedExport(code: string, name: string): boolean;
+export declare function hasNamedExport(code: string, name: string): boolean;
 /** Returns true when Next.js' analyzer recognizes the requested export name. */
-declare function hasExportedName(code: string, name: string): boolean;
+export declare function hasExportedName(code: string, name: string): boolean;
+/**
+ * Whether the module's runtime value exports include the given name. Type-only
+ * exports and re-export aliases under another name don't count.
+ */
+export declare function hasRuntimeExportedName(code: string, name: string): boolean;
 /**
  * Extracts the string value of `export const <name> = "value"`.
  * Handles TypeScript annotations/assertions and no-substitution template literals.
  * Returns null if the export is absent or not a string literal.
  */
-declare function extractExportConstString(code: string, name: string): string | null;
-declare function extractMiddlewareMatcherConfig(filePath: string): StaticMiddlewareMatcher | undefined;
+export declare function extractExportConstString(code: string, name: string): string | null;
+export declare function extractMiddlewareMatcherConfig(filePath: string): StaticMiddlewareMatcher | undefined;
 /**
  * Extract the statically analyzable `config.matcher` value without first
  * narrowing it to vinext's runtime matcher type. Build validation needs the
  * raw value so malformed matcher objects are rejected instead of disappearing
  * as though no matcher had been configured.
  */
-declare function extractMiddlewareMatcherConfigValue(filePath: string): unknown;
+export declare function extractMiddlewareMatcherConfigValue(filePath: string): unknown;
 /**
  * Extracts the numeric value of `export const <name> = <number|false>`.
  * Supports integers, decimals, negative values, `Infinity`, and `false`.
@@ -59,7 +64,7 @@ declare function extractMiddlewareMatcherConfigValue(filePath: string): unknown;
  * Handles TypeScript annotations/assertions and JavaScript numeric separators.
  * Returns null if the export is absent or not a number/`false`.
  */
-declare function extractExportConstNumber(code: string, name: string): number | null;
+export declare function extractExportConstNumber(code: string, name: string): number | null;
 /**
  * Extracts the `revalidate` value from inside a `getStaticProps` return object.
  * Looks for:  revalidate: <number>  or  revalidate: false  or  revalidate: Infinity
@@ -71,7 +76,7 @@ declare function extractExportConstNumber(code: string, name: string): number |
  *   Infinity — fully static (treated same as false by Next.js)
  *   null     — no `revalidate` key found (fully static)
  */
-declare function extractGetStaticPropsRevalidate(code: string): number | false | null;
+export declare function extractGetStaticPropsRevalidate(code: string): number | false | null;
 /**
  * Classifies a layout file by its segment config exports (`dynamic`, `revalidate`).
  *
@@ -84,14 +89,16 @@ declare function extractGetStaticPropsRevalidate(code: string): number | false |
  * for layout skip decisions — ISR is a page-level concept. Only the extremes
  * (`revalidate = 0` → dynamic, `revalidate = Infinity` → static) are decisive.
  */
-declare function classifyLayoutSegmentConfig(code: string): LayoutBuildClassification;
+export declare function classifyLayoutSegmentConfig(code: string): LayoutBuildClassification;
 /**
  * Classifies a Pages Router page file by reading its source and examining
  * which data-fetching exports it contains.
  *
  * API routes (files under pages/api/) are always `api`.
  */
-declare function classifyPagesRoute(filePath: string): {
+export declare function classifyPagesRoute(filePath: string): {
+  hasStaticProps?: boolean;
+  hasServerSideProps?: boolean;
   type: RouteType;
   revalidate?: number;
 };
@@ -102,10 +109,23 @@ declare function classifyPagesRoute(filePath: string): {
  * @param routePath  Absolute path to the route.ts handler (null for page routes)
  * @param isDynamic  Whether the URL pattern contains dynamic segments
  */
-declare function classifyAppRoute(pagePath: string | null, routePath: string | null, isDynamic: boolean): {
+export declare function classifyAppRoute(pagePath: string | null, routePath: string | null, isDynamic: boolean): {
   type: RouteType;
   revalidate?: number;
 };
+/**
+ * Return whether a Route Handler has a GET contract that Next.js considers
+ * eligible for static generation. This intentionally examines only the route
+ * module's direct segment config; request-time dynamic usage is decided by the
+ * staged Worker probe after the module has executed to completion.
+ *
+ * Ported from Next.js:
+ * packages/next/src/server/route-modules/app-route/helpers/is-static-gen-enabled.ts
+ */
+export declare function classifyAppRouteHandler(filePath: string): {
+  hasGet: boolean;
+  staticGenerationEnabled: boolean;
+};
 /**
  * Builds a sorted list of RouteRow objects from the discovered routes.
  * Routes are sorted alphabetically by path, matching filesystem order.
@@ -115,7 +135,7 @@ declare function classifyAppRoute(pagePath: string | null, routePath: string | n
  * to `static` (confirmed by execution). The `prerendered` flag is set on those
  * rows so the formatter can add a legend note.
  */
-declare function buildReportRows(options: {
+export declare function buildReportRows(options: {
   pageRoutes?: Route[];
   apiRoutes?: Route[];
   appRoutes?: AppRoute[];
@@ -133,15 +153,14 @@ declare function buildReportRows(options: {
  *
  *   ○ Static  ◐ ISR  ƒ Dynamic  λ API
  */
-declare function formatBuildReport(rows: RouteRow[], routerLabel?: string): string;
+export declare function formatBuildReport(rows: RouteRow[], routerLabel?: string): string;
 /**
  * Scans the project at `root`, classifies all routes, and prints the
  * Next.js-style build report to stdout.
  */
-declare function printBuildReport(options: {
+export declare function printBuildReport(options: {
   root: string;
   pageExtensions: string[];
   prerenderResult?: PrerenderResult;
 }): Promise<void>;
-//#endregion
-export { RouteRow, RouteType, StaticMiddlewareMatcher, buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, extractMiddlewareMatcherConfigValue, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, printBuildReport };
+//#endregion

package/dist/build/report.js

@@ -4,7 +4,7 @@ import fs from "node:fs";
 import { parseSync } from "vite";
 //#region src/build/report.ts
 /**
-* Build report — prints a Next.js-style route table after `vinext build`.
+* Build report — prints a Next.js-style route table after `vite build`.
 *
 * Classifies every discovered route as:
 *   ○  Static   — confirmed static: force-static or revalidate=Infinity
@@ -89,6 +89,14 @@ function hasExportedName(code, name) {
 	}
 	return false;
 }
+/**
+* Whether the module's runtime value exports include the given name. Type-only
+* exports and re-export aliases under another name don't count.
+*/
+function hasRuntimeExportedName(code, name) {
+	const program = parseRouteModule(code);
+	return program !== null && hasRuntimeExportedNameInProgram(program, name);
+}
 function hasNamedExportInProgram(program, name) {
 	for (const node of program.body) {
 		if (node.type !== "ExportNamedDeclaration") continue;
@@ -97,6 +105,20 @@ function hasNamedExportInProgram(program, name) {
 	}
 	return false;
 }
+function hasRuntimeExportedNameInProgram(program, name) {
+	for (const node of program.body) {
+		if (node.type !== "ExportNamedDeclaration" || node.exportKind === "type") continue;
+		if (declarationHasBindingName(node.declaration, name)) return true;
+		for (const specifier of node.specifiers) {
+			if (specifier.exportKind === "type") continue;
+			if (moduleExportNameValue(specifier.exported ?? specifier.local) === name) return true;
+		}
+	}
+	return false;
+}
+function hasRuntimeExportAllInProgram(program) {
+	return program.body.some((node) => node.type === "ExportAllDeclaration" && node.exportKind !== "type");
+}
 function unwrapStaticExpression(expression) {
 	let current = expression;
 	while (current.type === "ParenthesizedExpression" || current.type === "TSAsExpression" || current.type === "TSSatisfiesExpression" || current.type === "TSTypeAssertion" || current.type === "TSNonNullExpression") current = current.expression;
@@ -434,12 +456,19 @@ function classifyPagesRoute(filePath) {
 		return { type: "unknown" };
 	}
 	const program = parseRouteModule(code);
-	if (program && hasNamedExportInProgram(program, "getServerSideProps")) return { type: "ssr" };
+	if (program && hasNamedExportInProgram(program, "getServerSideProps")) return {
+		hasServerSideProps: true,
+		type: "ssr"
+	};
 	if (program && hasNamedExportInProgram(program, "getStaticProps")) {
 		const revalidate = extractGetStaticPropsRevalidateFromProgram(program, code);
-		if (revalidate === null || revalidate === false || revalidate === Infinity) return { type: "static" };
+		if (revalidate === null || revalidate === false || revalidate === Infinity) return {
+			hasStaticProps: true,
+			type: "static"
+		};
 		if (revalidate === 0) return { type: "ssr" };
 		return {
+			hasStaticProps: true,
 			type: "isr",
 			revalidate
 		};
@@ -480,6 +509,46 @@ function classifyAppRoute(pagePath, routePath, isDynamic) {
 	return { type: "unknown" };
 }
 /**
+* Return whether a Route Handler has a GET contract that Next.js considers
+* eligible for static generation. This intentionally examines only the route
+* module's direct segment config; request-time dynamic usage is decided by the
+* staged Worker probe after the module has executed to completion.
+*
+* Ported from Next.js:
+* packages/next/src/server/route-modules/app-route/helpers/is-static-gen-enabled.ts
+*/
+function classifyAppRouteHandler(filePath) {
+	let code;
+	try {
+		code = fs.readFileSync(filePath, "utf8");
+	} catch {
+		return {
+			hasGet: false,
+			staticGenerationEnabled: false
+		};
+	}
+	const program = parseRouteModule(code);
+	if (!program) return {
+		hasGet: false,
+		staticGenerationEnabled: false
+	};
+	const dynamicValue = extractExportConstStringFromProgram(program, "dynamic");
+	const revalidateValue = extractExportConstNumberFromProgram(program, "revalidate");
+	const hasGet = hasRuntimeExportedNameInProgram(program, "GET");
+	const hasNonStaticMethod = [
+		"POST",
+		"PUT",
+		"DELETE",
+		"PATCH",
+		"OPTIONS"
+	].some((method) => hasRuntimeExportedNameInProgram(program, method));
+	const hasUnknownRuntimeExports = hasRuntimeExportAllInProgram(program);
+	return {
+		hasGet,
+		staticGenerationEnabled: !hasNonStaticMethod && !hasUnknownRuntimeExports && (dynamicValue === "force-static" || dynamicValue === "error" || revalidateValue === Infinity || revalidateValue !== null && revalidateValue > 0 || hasRuntimeExportedNameInProgram(program, "generateStaticParams"))
+	};
+}
+/**
 * Builds a sorted list of RouteRow objects from the discovered routes.
 * Routes are sorted alphabetically by path, matching filesystem order.
 *
@@ -606,4 +675,4 @@ async function printBuildReport(options) {
 	}
 }
 //#endregion
-export { buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, extractMiddlewareMatcherConfigValue, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, printBuildReport };
+export { buildReportRows, classifyAppRoute, classifyAppRouteHandler, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, extractMiddlewareMatcherConfigValue, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, hasRuntimeExportedName, printBuildReport };

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

@@ -28,6 +28,5 @@ type PlanRouteClassificationInjectionOptions = {
   manifest: RouteClassificationManifest;
   moduleInfo: ModuleInfoProvider;
 };
-declare function planRouteClassificationInjection(options: PlanRouteClassificationInjectionOptions): RouteClassificationInjectionPlan;
-//#endregion
-export { planRouteClassificationInjection };
+export declare function planRouteClassificationInjection(options: PlanRouteClassificationInjectionOptions): RouteClassificationInjectionPlan;
+//#endregion

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

@@ -16,7 +16,7 @@ type RouteManifestEntry = {
    */
   layer1Reasons: Map<number, ClassificationReason>;
 };
-type RouteClassificationManifest = {
+export type RouteClassificationManifest = {
   routes: RouteManifestEntry[];
 };
 /**
@@ -25,7 +25,7 @@ type RouteClassificationManifest = {
  * layout means the routing scan and the filesystem have drifted, and shipping
  * a build in that state would silently break layout rendering.
  */
-declare function collectRouteClassificationManifest(routes: readonly AppRoute[]): RouteClassificationManifest;
+export declare function collectRouteClassificationManifest(routes: readonly AppRoute[]): RouteClassificationManifest;
 /**
  * Builds a JavaScript arrow-function expression that dispatches route index
  * to a pre-computed `Map<layoutIndex, "static" | "dynamic">` of build-time
@@ -36,7 +36,7 @@ declare function collectRouteClassificationManifest(routes: readonly AppRoute[])
  * module-graph classifier can only prove static, so "needs-probe" results
  * are omitted by the caller before this map is constructed.
  */
-declare function buildClassificationReplacement(manifest: RouteClassificationManifest, layer2PerRoute: ReadonlyMap<number, ReadonlyMap<number, ModuleGraphStaticReason>>): string;
+export declare function buildClassificationReplacement(manifest: RouteClassificationManifest, layer2PerRoute: ReadonlyMap<number, ReadonlyMap<number, ModuleGraphStaticReason>>): string;
 /**
  * Sibling of `buildClassificationReplacement`: emits a dispatch function
  * that returns `Map<layoutIndex, ClassificationReason>` per route.
@@ -49,6 +49,5 @@ declare function buildClassificationReplacement(manifest: RouteClassificationMan
  * a segment-config reason must override a module-graph reason for the same
  * layout index.
  */
-declare function buildReasonsReplacement(manifest: RouteClassificationManifest, layer2PerRoute: ReadonlyMap<number, ReadonlyMap<number, ModuleGraphStaticReason>>): string;
-//#endregion
-export { RouteClassificationManifest, buildClassificationReplacement, buildReasonsReplacement, collectRouteClassificationManifest };
+export declare function buildReasonsReplacement(manifest: RouteClassificationManifest, layer2PerRoute: ReadonlyMap<number, ReadonlyMap<number, ModuleGraphStaticReason>>): string;
+//#endregion

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

@@ -1,3 +1,4 @@
+import { VinextRouteRootConfig } from "../config/prerender.js";
 import { ResolvedNextConfig } from "../config/next-config.js";
 import { PrerenderResult, PrerenderRouteResult } from "./prerender.js";
 //#region src/build/run-prerender.d.ts
@@ -14,10 +15,13 @@ type RunPrerenderOptions = {
   pagesBundlePath?: string;
   /**
    * Override the path to the App Router RSC bundle.
-   * Defaults to `<root>/dist/server/index.js`.
+   * Defaults to the App handler recorded in the server build manifest, or
+   * `<root>/dist/server/index.js` for builds without a manifest.
    * Intended for tests that build to a custom outDir.
    */
   rscBundlePath?: string;
+  /** Build output roots captured from the vinext Vite plugin. */
+  routeRootConfig?: VinextRouteRootConfig | null;
   /**
    * Maximum number of routes rendered in parallel.
    * Defaults to prerenderApp/prerenderPages internal defaults when omitted.
@@ -33,16 +37,15 @@ type RunPrerenderOptions = {
  * to stderr/stdout. Returns the full PrerenderResult so callers can pass it to
  * printBuildReport.
  *
- * Works for both plain Node and Cloudflare Workers builds — the CF Workers
- * bundle outputs `dist/server/index.js` which is a standard Node server entry,
- * so no wrangler/miniflare is needed.
+ * Works for both plain Node and hosted builds by resolving the generated App
+ * handler independently of any deployment facade that owns `index.js`.
  *
  * Hybrid projects (both `app/` and `pages/` present) run both prerender
  * phases sharing a single prod server instance. The merged results are written
  * to a single `dist/server/vinext-prerender.json`.
  *
  * If a required production bundle does not exist, an error is thrown directing
- * the user to run `vinext build` first.
+ * the user to run `vite build` first.
  */
 /**
  * Throw if any route is a `fatal` error (a thrown generateStaticParams /
@@ -51,10 +54,9 @@ type RunPrerenderOptions = {
  * non-fatal errors (e.g. transport failures), which only fail under
  * `output: 'export'`. Exported for direct unit testing. Refs cloudflare/vinext#1982
  */
-declare function assertNoFatalPrerenderRoutes(routes: readonly PrerenderRouteResult[]): void;
+export declare function assertNoFatalPrerenderRoutes(routes: readonly PrerenderRouteResult[]): void;
 /**
  * Statically generate routes and return the prerender result.
  */
-declare function runPrerender(options: RunPrerenderOptions): Promise<PrerenderResult | null>;
-//#endregion
-export { assertNoFatalPrerenderRoutes, runPrerender };
+export declare function runPrerender(options: RunPrerenderOptions): Promise<PrerenderResult | null>;
+//#endregion

package/dist/build/run-prerender.js

@@ -1,19 +1,21 @@
 import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 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 { appRouter } from "../routing/app-router.js";
+import { apiRouter, pagesRouter } from "../routing/pages-router.js";
+import { scanMetadataFiles } from "../server/metadata-routes.js";
 import { readPrerenderSecret } from "./server-manifest.js";
+import { registerPrerenderCloudflareLoader } from "./prerender-cloudflare-loader.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 { resolveBuiltRscEntryPath } from "./server-entry.js";
 import fs from "node:fs";
 //#region src/build/run-prerender.ts
 /**
-* Shared prerender runner used by both `vinext build` (cli.ts) and
+* Shared prerender runner used by both `vite build` (cli.ts) and
 * `vinext-cloudflare deploy --prerender-all` (deploy.ts).
 *
 * `runPrerender` handles route scanning, dynamic imports, progress reporting,
@@ -74,16 +76,15 @@ function readBuiltBuildId(serverDir) {
 * to stderr/stdout. Returns the full PrerenderResult so callers can pass it to
 * printBuildReport.
 *
-* Works for both plain Node and Cloudflare Workers builds — the CF Workers
-* bundle outputs `dist/server/index.js` which is a standard Node server entry,
-* so no wrangler/miniflare is needed.
+* Works for both plain Node and hosted builds by resolving the generated App
+* handler independently of any deployment facade that owns `index.js`.
 *
 * Hybrid projects (both `app/` and `pages/` present) run both prerender
 * phases sharing a single prod server instance. The merged results are written
 * to a single `dist/server/vinext-prerender.json`.
 *
 * If a required production bundle does not exist, an error is thrown directing
-* the user to run `vinext build` first.
+* the user to run `vite build` first.
 */
 /**
 * Throw if any route is a `fatal` error (a thrown generateStaticParams /
@@ -106,11 +107,15 @@ async function runPrerender(options) {
 	const appDir = findDir(root, "app", "src/app");
 	const pagesDir = findDir(root, "pages", "src/pages");
 	if (!appDir && !pagesDir) return null;
-	const manifestDir = path.join(root, "dist", "server");
-	const rscBundlePath = options.rscBundlePath ?? path.join(root, "dist", "server", "index.js");
-	const serverDir = path.dirname(rscBundlePath);
+	registerPrerenderCloudflareLoader();
+	const manifestDir = path.resolve(root, "dist", "server");
+	const buildOutDir = path.resolve(root, "dist");
+	const configuredRscServerDir = path.resolve(root, options.routeRootConfig?.rscOutDir ?? path.join("dist", "server"));
+	const rscBundlePath = options.rscBundlePath ?? resolveBuiltRscEntryPath(configuredRscServerDir);
+	const relativeEntryPath = path.relative(configuredRscServerDir, rscBundlePath);
+	const serverDir = !relativeEntryPath.startsWith("../") && !path.isAbsolute(relativeEntryPath) ? configuredRscServerDir : path.dirname(rscBundlePath);
 	const config = options.nextConfig ? { ...options.nextConfig } : { ...await resolveNextConfig(await loadNextConfig(root, PHASE_PRODUCTION_BUILD), root) };
-	const builtBuildId = readBuiltBuildId(serverDir);
+	const builtBuildId = readBuiltBuildId(manifestDir) ?? readBuiltBuildId(serverDir);
 	if (builtBuildId) config.buildId = builtBuildId;
 	const mode = config.output === "export" ? "export" : "default";
 	const allRoutes = [];
@@ -118,7 +123,7 @@ async function runPrerender(options) {
 	let totalUrls = 0;
 	let completedUrls = 0;
 	const progress = new PrerenderProgress();
-	const outDir = mode === "export" ? path.join(root, "dist", "client") : path.join(root, "dist", "server", "prerendered-routes");
+	const outDir = mode === "export" ? path.join(root, "dist", "client") : path.join(manifestDir, "prerendered-routes");
 	let sharedProdServer = null;
 	let sharedPrerenderSecret;
 	const restorePrerenderPhase = enterPrerenderPhase();
@@ -127,7 +132,9 @@ async function runPrerender(options) {
 			sharedProdServer = await startProdServer({
 				port: 0,
 				host: "127.0.0.1",
-				outDir: path.dirname(serverDir),
+				outDir: buildOutDir,
+				rscEntryPath: rscBundlePath,
+				serverDir,
 				noCompression: true,
 				purpose: "prerender"
 			});
@@ -146,6 +153,8 @@ async function runPrerender(options) {
 				config,
 				concurrency: options.concurrency,
 				rscBundlePath,
+				serverDir,
+				buildOutDir,
 				...sharedProdServer ? { _prodServer: sharedProdServer } : {},
 				onProgress: ({ total, route }) => {
 					if (appTotal === 0) {
@@ -174,7 +183,7 @@ async function runPrerender(options) {
 				...sharedProdServer ? {
 					_prodServer: sharedProdServer,
 					_prerenderSecret: sharedPrerenderSecret
-				} : { pagesBundlePath: options.pagesBundlePath ?? path.join(root, "dist", "server", "entry.js") },
+				} : { pagesBundlePath: options.pagesBundlePath ?? path.join(manifestDir, "entry.js") },
 				onProgress: ({ total, route }) => {
 					if (pagesTotal === 0) {
 						pagesTotal = total;
@@ -218,7 +227,7 @@ async function runPrerender(options) {
 		const errorRoutes = allRoutes.filter((r) => r.status === "error").map((r) => `  ${r.route}: ${r.error}`).join("\n");
 		throw new Error(`Static export failed: ${errors} route${errors !== 1 ? "s" : ""} cannot be statically exported.\n${errorRoutes}\n\nRemove server-side data fetching (getServerSideProps, force-dynamic, revalidate) from these routes, or remove \`output: "export"\` from next.config.js.`);
 	}
-	injectPregeneratedConcretePaths(root);
+	injectPregeneratedConcretePaths(root, rscBundlePath, manifestDir, [configuredRscServerDir]);
 	if (fs.existsSync(rscBundlePath)) rememberCurrentServerEntryImportMtime(rscBundlePath);
 	return {
 		routes: allRoutes,

package/dist/build/server-entry.d.ts

@@ -0,0 +1,4 @@
+//#region src/build/server-entry.d.ts
+/** Resolve the built App handler even when a deployment host owns index.js. */
+export declare function resolveBuiltRscEntryPath(serverDir: string): string;
+//#endregion

package/dist/build/server-entry.js

@@ -0,0 +1,28 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
+import fs from "node:fs";
+//#region src/build/server-entry.ts
+const RSC_ENTRY_MANIFEST_KEY = "virtual:vinext-rsc-entry";
+/** Resolve the built App handler even when a deployment host owns index.js. */
+function resolveBuiltRscEntryPath(serverDir) {
+	const fallbackPath = path.join(serverDir, "index.js");
+	const manifestPath = path.join(serverDir, ".vite", "manifest.json");
+	let manifest;
+	try {
+		manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+	} catch (error) {
+		if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return fallbackPath;
+		if (error instanceof SyntaxError) return fallbackPath;
+		throw error;
+	}
+	if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) return fallbackPath;
+	const entry = Reflect.get(manifest, RSC_ENTRY_MANIFEST_KEY);
+	if (!entry || typeof entry !== "object") return fallbackPath;
+	const file = Reflect.get(entry, "file");
+	if (typeof file !== "string") return fallbackPath;
+	const entryPath = path.resolve(serverDir, file);
+	const relativePath = path.relative(serverDir, entryPath);
+	if (relativePath.startsWith("../") || path.isAbsolute(relativePath)) return fallbackPath;
+	return fs.existsSync(entryPath) ? entryPath : fallbackPath;
+}
+//#endregion
+export { resolveBuiltRscEntryPath };

package/dist/build/server-manifest.d.ts

@@ -13,6 +13,11 @@
  * Callers that require a secret (i.e. the prerender phase itself) should
  * warn when this returns `undefined`.
  */
-declare function readPrerenderSecret(serverDir: string): string | undefined;
-//#endregion
-export { readPrerenderSecret };
+export declare function readPrerenderSecret(serverDir: string): string | undefined;
+/**
+ * Read every server output root that contains a deployable response-stage
+ * graph. Paths are stored relative to the project root so build artifacts stay
+ * relocatable, then resolved for post-build sidecar updates.
+ */
+export declare function readServerRuntimeOutputDirs(serverDir: string, root: string): string[];
+//#endregion

package/dist/build/server-manifest.js

@@ -16,7 +16,19 @@ import { readJsonFile } from "../utils/safe-json-file.js";
 * warn when this returns `undefined`.
 */
 function readPrerenderSecret(serverDir) {
-	return readJsonFile(path.join(serverDir, "vinext-server.json"))?.prerenderSecret;
+	const manifestPath = path.join(serverDir, "vinext-server.json");
+	return readJsonFile(manifestPath)?.prerenderSecret;
+}
+/**
+* Read every server output root that contains a deployable response-stage
+* graph. Paths are stored relative to the project root so build artifacts stay
+* relocatable, then resolved for post-build sidecar updates.
+*/
+function readServerRuntimeOutputDirs(serverDir, root) {
+	const manifestPath = path.join(serverDir, "vinext-server.json");
+	const manifest = readJsonFile(manifestPath);
+	if (!Array.isArray(manifest?.runtimeOutputDirs)) return [];
+	return manifest.runtimeOutputDirs.filter((outputDir) => typeof outputDir === "string").map((outputDir) => path.resolve(root, outputDir));
 }
 //#endregion
-export { readPrerenderSecret };
+export { readPrerenderSecret, readServerRuntimeOutputDirs };

package/dist/build/ssr-manifest.d.ts

@@ -1,5 +1,5 @@
 //#region src/build/ssr-manifest.d.ts
-type BundleBackfillChunk = {
+export type BundleBackfillChunk = {
   type: "chunk";
   fileName: string;
   imports?: string[];
@@ -13,10 +13,9 @@ type BundleBackfillChunk = {
  * Realpath with NATIVE separators (backslashes on Windows). Callers apply
  * `toSlash` where the result becomes a module id / manifest key.
  */
-declare function tryRealpathSync(candidate: string): string | null;
-declare function relativeWithinRoot(root: string, moduleId: string): string | null;
-declare function augmentSsrManifestFromBundle(ssrManifest: Record<string, string[]>, bundle: Record<string, BundleBackfillChunk | {
+export declare function tryRealpathSync(candidate: string): string | null;
+export declare function relativeWithinRoot(root: string, moduleId: string): string | null;
+export declare function augmentSsrManifestFromBundle(ssrManifest: Record<string, string[]>, bundle: Record<string, BundleBackfillChunk | {
   type: string;
 }>, root: string, base?: string): Record<string, string[]>;
-//#endregion
-export { BundleBackfillChunk, augmentSsrManifestFromBundle, relativeWithinRoot, tryRealpathSync };
+//#endregion

package/dist/build/standalone.d.ts

@@ -26,6 +26,5 @@ type StandaloneBuildResult = {
  * (i.e. those left external by the bundler), so no client-only deps are
  * included.
  */
-declare function emitStandaloneOutput(options: StandaloneBuildOptions): StandaloneBuildResult;
-//#endregion
-export { emitStandaloneOutput };
+export declare function emitStandaloneOutput(options: StandaloneBuildOptions): StandaloneBuildResult;
+//#endregion

package/dist/build/standalone.js

@@ -1,5 +1,5 @@
-import { readJsonFile } from "../utils/safe-json-file.js";
 import { resolveVinextPackageRoot } from "../utils/vinext-root.js";
+import { readJsonFile } from "../utils/safe-json-file.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
 import nodePath from "node:path";
@@ -148,7 +148,7 @@ function emitStandaloneOutput(options) {
 	const outDir = nodePath.resolve(options.outDir);
 	const clientDir = nodePath.join(outDir, "client");
 	const serverDir = nodePath.join(outDir, "server");
-	if (!fs.existsSync(clientDir) || !fs.existsSync(serverDir)) throw new Error(`No build output found in ${outDir}. Run vinext build first.`);
+	if (!fs.existsSync(clientDir) || !fs.existsSync(serverDir)) throw new Error(`No build output found in ${outDir}. Run vite build first.`);
 	const standaloneDir = nodePath.join(outDir, "standalone");
 	const standaloneDistDir = nodePath.join(standaloneDir, "dist");
 	const standaloneNodeModulesDir = nodePath.join(standaloneDir, "node_modules");

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

@@ -2,7 +2,7 @@ import { AppRoute } from "../routing/app-route-graph.js";
 import { ResolvedNextConfig } from "../config/next-config.js";
 import { Route } from "../routing/pages-router.js";
 //#region src/build/static-export.d.ts
-type StaticExportOptions = {
+export type StaticExportOptions = {
   /**
    * Absolute path to the pre-built Pages Router server bundle
    * (e.g. `dist/server/entry.js`).
@@ -19,8 +19,8 @@ type StaticExportOptions = {
   /** Resolved next.config.js */
   config: ResolvedNextConfig;
 };
-type StaticExportResult = {
-  /** Number of HTML files generated */
+export type StaticExportResult = {
+  /** Number of rendered route entries */
   pageCount: number;
   /** Generated file paths (relative to outDir) */
   files: string[];
@@ -37,8 +37,8 @@ type StaticExportResult = {
  *
  * Delegates to `prerenderPages()` in export mode.
  */
-declare function staticExportPages(options: StaticExportOptions): Promise<StaticExportResult>;
-type AppStaticExportOptions = {
+export declare function staticExportPages(options: StaticExportOptions): Promise<StaticExportResult>;
+export type AppStaticExportOptions = {
   /** Discovered app routes */
   routes: AppRoute[];
   /**
@@ -61,6 +61,5 @@ type AppStaticExportOptions = {
  *
  * Delegates to `prerenderApp()` in export mode.
  */
-declare function staticExportApp(options: AppStaticExportOptions): Promise<StaticExportResult>;
-//#endregion
-export { AppStaticExportOptions, StaticExportOptions, StaticExportResult, staticExportApp, staticExportPages };
+export declare function staticExportApp(options: AppStaticExportOptions): Promise<StaticExportResult>;
+//#endregion