vinext 1.0.0-beta.8 → 1.0.0

package/dist/build/client-build-config.d.ts

@@ -12,7 +12,7 @@ type ClientAssetFileNameInfo = {
  * function so it can inspect every source-name candidate Rolldown records for
  * an asset (a single output asset can carry several `originalFileNames`).
  */
-declare function createClientAssetFileNames(assetsDir: string): (assetInfo: ClientAssetFileNameInfo) => string;
+export declare function createClientAssetFileNames(assetsDir: string): (assetInfo: ClientAssetFileNameInfo) => string;
 /**
  * Create a manualChunks function for client builds.
  *
@@ -38,12 +38,12 @@ declare function createClientAssetFileNames(assetsDir: string): (assetInfo: Clie
  *   well: shared dependencies between routes get their own chunks,
  *   and route-specific code stays in route chunks.
  */
-declare function createClientManualChunks(shimsDir: string, preserveRouteBoundaries?: boolean): (id: string) => string | undefined;
-declare function createClientFileNameConfig(assetsDir: string): {
+export declare function createClientManualChunks(shimsDir: string, preserveRouteBoundaries?: boolean): (id: string) => string | undefined;
+export declare function createClientFileNameConfig(assetsDir: string): {
   entryFileNames: string;
   chunkFileNames: string;
 };
-declare function createClientCodeSplittingConfig(clientManualChunks: (id: string) => string | undefined): {
+export declare function createClientCodeSplittingConfig(clientManualChunks: (id: string) => string | undefined): {
   minSize: number;
   groups: {
     name(moduleId: string): string | null;
@@ -54,8 +54,16 @@ declare function createClientCodeSplittingConfig(clientManualChunks: (id: string
  * Derived from the package list so the regex and {@link isRscFrameworkModule}
  * predicate can't drift.
  */
-declare const RSC_FRAMEWORK_CHUNK_TEST: RegExp;
-declare function isRscFrameworkModule(id: string): boolean;
+export declare const RSC_FRAMEWORK_CHUNK_TEST: RegExp;
+export declare function isRscFrameworkModule(id: string): boolean;
+/**
+ * Keep virtual entry ids out of emitted RSC chunk filenames.
+ *
+ * Rolldown's entries-aware chunk names can contain the `\\0` virtual-id marker,
+ * which is not a portable module-specifier or filesystem name. Preserve every
+ * other character and remove both the printable and actual-NUL forms.
+ */
+export declare function sanitizeRscChunkFileName(name: string): string;
 /**
  * Output config that isolates React (and the RSC flight runtime) into a
  * dedicated "framework" chunk in the RSC server build. See
@@ -63,7 +71,8 @@ declare function isRscFrameworkModule(id: string): boolean;
  * modules that are only reachable through dynamic imports must stay out of the
  * eager framework chunk (issue #2073).
  */
-declare function createRscFrameworkChunkOutputConfig(): {
+export declare function createRscFrameworkChunkOutputConfig(): {
+  sanitizeFileName: typeof sanitizeRscChunkFileName;
   codeSplitting: {
     groups: {
       name: string;
@@ -80,12 +89,31 @@ declare function createRscFrameworkChunkOutputConfig(): {
  * treats node_modules as side-effect-free while preserving side effects in
  * local code.
  */
-declare function getClientTreeshakeConfig(): {
+export declare function getClientTreeshakeConfig(): {
   moduleSideEffects: "no-external";
 };
 type VinextBuildConfig = NonNullable<UserConfig["build"]>;
 type VinextBuildBundlerOptions = NonNullable<VinextBuildConfig["rolldownOptions"]>;
-declare function getBuildBundlerOptions(build: UserConfig["build"] | undefined): VinextBuildBundlerOptions | undefined;
-declare function withBuildBundlerOptions(bundlerOptions: VinextBuildBundlerOptions): Partial<VinextBuildConfig>;
-//#endregion
-export { RSC_FRAMEWORK_CHUNK_TEST, createClientAssetFileNames, createClientCodeSplittingConfig, createClientFileNameConfig, createClientManualChunks, createRscFrameworkChunkOutputConfig, getBuildBundlerOptions, getClientTreeshakeConfig, isRscFrameworkModule, withBuildBundlerOptions };
+export declare function getBuildBundlerOptions(build: UserConfig["build"] | undefined): VinextBuildBundlerOptions | undefined;
+export declare function withBuildBundlerOptions(bundlerOptions: VinextBuildBundlerOptions): Partial<VinextBuildConfig>;
+type VinextBuildOutput = Exclude<NonNullable<VinextBuildBundlerOptions["output"]>, readonly unknown[]>;
+type VinextCodeSplittingConfig = Exclude<NonNullable<VinextBuildOutput["codeSplitting"]>, boolean>;
+type ChunkFileNames = NonNullable<VinextBuildOutput["chunkFileNames"]>;
+type ChunkFileNameFunction = Exclude<ChunkFileNames, string>;
+/**
+ * Keep vinext modules partitioned by the stage entries that actually use them.
+ * Without an entry-aware catch-all, Rolldown may merge a small helper shared by
+ * request/response entries into a response-heavy chunk; importing that helper
+ * then evaluates React and renderer code on a request-stage cache hit.
+ */
+export declare function createMultiStageCodeSplittingConfig(existing: VinextBuildOutput["codeSplitting"]): VinextCodeSplittingConfig & {
+  groups: NonNullable<VinextCodeSplittingConfig["groups"]>;
+};
+/**
+ * Keep router stage chunks beside the server entry so their generated
+ * `./vinext-client-assets.js` and deploy-filled cacheability externals continue
+ * to resolve. Other chunks keep
+ * the host's existing output pattern (or vinext's server-assets default).
+ */
+export declare function createMultiStageChunkFileNames(assetsDir: string, existing: VinextBuildOutput["chunkFileNames"]): ChunkFileNameFunction;
+//#endregion

package/dist/build/client-build-config.js

@@ -166,6 +166,30 @@ function isRscFrameworkModule(id) {
 	return pkg !== null && FRAMEWORK_PACKAGES.includes(pkg);
 }
 /**
+* Keep virtual entry ids out of emitted RSC chunk filenames.
+*
+* Rolldown's entries-aware chunk names can contain the `\\0` virtual-id marker,
+* which is not a portable module-specifier or filesystem name. Preserve every
+* other character and remove both the printable and actual-NUL forms.
+*/
+function sanitizeRscChunkFileName(name) {
+	const withoutVirtualMarkers = name.replaceAll("\\0", "");
+	const invalid = /* @__PURE__ */ new Set([
+		"<",
+		">",
+		":",
+		"\"",
+		"/",
+		"\\",
+		"|",
+		"?",
+		"*"
+	]);
+	let sanitized = "";
+	for (const character of withoutVirtualMarkers) sanitized += character.charCodeAt(0) <= 31 || invalid.has(character) ? "_" : character;
+	return sanitized;
+}
+/**
 * Output config that isolates React (and the RSC flight runtime) into a
 * dedicated "framework" chunk in the RSC server build. See
 * {@link RSC_FRAMEWORK_CHUNK_TEST} for the motivation (issue #1549). Framework
@@ -173,11 +197,14 @@ function isRscFrameworkModule(id) {
 * eager framework chunk (issue #2073).
 */
 function createRscFrameworkChunkOutputConfig() {
-	return { codeSplitting: { groups: [{
-		name: "framework",
-		test: RSC_FRAMEWORK_CHUNK_TEST,
-		entriesAware: true
-	}] } };
+	return {
+		sanitizeFileName: sanitizeRscChunkFileName,
+		codeSplitting: { groups: [{
+			name: "framework",
+			test: RSC_FRAMEWORK_CHUNK_TEST,
+			entriesAware: true
+		}] }
+	};
 }
 /**
 * Returns Rolldown treeshake configuration for production client builds.
@@ -196,5 +223,48 @@ function getBuildBundlerOptions(build) {
 function withBuildBundlerOptions(bundlerOptions) {
 	return { rolldownOptions: bundlerOptions };
 }
+/**
+* Keep vinext modules partitioned by the stage entries that actually use them.
+* Without an entry-aware catch-all, Rolldown may merge a small helper shared by
+* request/response entries into a response-heavy chunk; importing that helper
+* then evaluates React and renderer code on a request-stage cache hit.
+*/
+function createMultiStageCodeSplittingConfig(existing) {
+	const base = existing && typeof existing === "object" ? existing : {};
+	return {
+		...base,
+		groups: [{
+			name: "vinext-stage-runtime",
+			test: /(?:^|[/\\])(?:packages[/\\]vinext[/\\]src|(?:packages[/\\]vinext|node_modules[/\\](?:\.pnpm[/\\][^/\\]+[/\\]node_modules[/\\])?vinext)[/\\]dist)[/\\]/,
+			entriesAware: true
+		}, ...base.groups ?? []]
+	};
+}
+/**
+* Keep router stage chunks beside the server entry so their generated
+* `./vinext-client-assets.js` and deploy-filled cacheability externals continue
+* to resolve. Other chunks keep
+* the host's existing output pattern (or vinext's server-assets default).
+*/
+function createMultiStageChunkFileNames(assetsDir, existing) {
+	return (chunk) => {
+		const name = sanitizeRscChunkFileName(chunk.name);
+		if (chunk.moduleIds?.some((id) => /\/server\/app-ssr-entry\.[cm]?[jt]sx?$/.test(toSlash(id.split("?", 1)[0] ?? ""))) || [
+			"app-router-entry",
+			"pages-router-entry",
+			"app-response-stage-entry",
+			"pages-request-stage-entry",
+			"pages-response-stage-entry",
+			"virtual_vinext-rsc-entry",
+			"virtual_vinext-request-stage",
+			"virtual_vinext-response-stage"
+		].some((entryName) => name.includes(entryName))) return `${name}-[hash].js`;
+		if (typeof existing === "function") return existing({
+			...chunk,
+			name
+		});
+		return (existing ?? joinAssetFileNamePattern(assetsDir, "[name]-[hash].js")).replaceAll("[name]", name);
+	};
+}
 //#endregion
-export { RSC_FRAMEWORK_CHUNK_TEST, createClientAssetFileNames, createClientCodeSplittingConfig, createClientFileNameConfig, createClientManualChunks, createRscFrameworkChunkOutputConfig, getBuildBundlerOptions, getClientTreeshakeConfig, isRscFrameworkModule, withBuildBundlerOptions };
+export { RSC_FRAMEWORK_CHUNK_TEST, createClientAssetFileNames, createClientCodeSplittingConfig, createClientFileNameConfig, createClientManualChunks, createMultiStageChunkFileNames, createMultiStageCodeSplittingConfig, createRscFrameworkChunkOutputConfig, getBuildBundlerOptions, getClientTreeshakeConfig, isRscFrameworkModule, sanitizeRscChunkFileName, withBuildBundlerOptions };

package/dist/build/css-url-assets.d.ts

@@ -11,9 +11,9 @@ type EmitRestoredCssUrlAsset = (asset: {
  * source. Idempotent and side-effect free (only adds a query param), so it is
  * safe to run on every build-environment stylesheet, vendored CSS included.
  */
-declare function markCssUrlAssetReferences(code: string, id: string): string | null;
+export declare function markCssUrlAssetReferences(code: string, id: string): string | null;
 /** Rebase relative asset URLs when Sass inlines a partial into an entry file. */
-declare function rebaseCssUrlAssetReferences(code: string, sourceDirectory: string, targetDirectory: string): string | null;
+export declare function rebaseCssUrlAssetReferences(code: string, sourceDirectory: string, targetDirectory: string): string | null;
 /**
  * Mutates emitted CSS assets in place so byte-identical `url()` dependencies
  * keep their distinct Next-compatible filenames. Sibling files are produced via
@@ -25,6 +25,5 @@ declare function rebaseCssUrlAssetReferences(code: string, sourceDirectory: stri
  * chunk (`cssCodeSplit: false` / `?inline`) already has final URLs, so chunk
  * code only has the leaked marker stripped — no sibling files are emitted.
  */
-declare function restoreDedupedCssAssetReferences(bundle: CssUrlAssetBundle, emitRestoredAsset: EmitRestoredCssUrlAsset): void;
-//#endregion
-export { markCssUrlAssetReferences, rebaseCssUrlAssetReferences, restoreDedupedCssAssetReferences };
+export declare function restoreDedupedCssAssetReferences(bundle: CssUrlAssetBundle, emitRestoredAsset: EmitRestoredCssUrlAsset): void;
+//#endregion

package/dist/build/css-url-assets.js

@@ -70,15 +70,18 @@ function decodeURIComponentSafe(value) {
 		return value;
 	}
 }
+function splitMarkerQuery(query) {
+	return query.replaceAll(`?${CSS_URL_ASSET_MARKER}=`, `&${CSS_URL_ASSET_MARKER}=`).split("&");
+}
 function getMarker(query) {
-	for (const part of query.split("&")) {
+	for (const part of splitMarkerQuery(query)) {
 		const eq = part.indexOf("=");
 		if ((eq === -1 ? part : part.slice(0, eq)) === CSS_URL_ASSET_MARKER) return eq === -1 ? "" : decodeURIComponentSafe(part.slice(eq + 1));
 	}
 	return null;
 }
 function dropMarker(query) {
-	return query.split("&").filter((part) => (part.indexOf("=") === -1 ? part : part.slice(0, part.indexOf("="))) !== CSS_URL_ASSET_MARKER).join("&");
+	return splitMarkerQuery(query).filter((part) => (part.indexOf("=") === -1 ? part : part.slice(0, part.indexOf("="))) !== CSS_URL_ASSET_MARKER).join("&");
 }
 function isRelativeAssetUrl(rawPath) {
 	return !(rawPath === "" || rawPath.startsWith("/") || rawPath.startsWith("#") || rawPath.includes("(") || /^[a-zA-Z][\w+.-]*:/.test(rawPath));

package/dist/build/google-fonts/build-url.d.ts

@@ -1,5 +1,5 @@
 //#region src/build/google-fonts/build-url.d.ts
-type FontAxes = {
+export type FontAxes = {
   /** Weight values: explicit faces ("400") or a variable range ("400..800"). */
   wght?: string[];
   /** Ital values, "0" (normal) and/or "1" (italic). */
@@ -7,6 +7,5 @@ type FontAxes = {
   /** Other variable axes the caller wants to include, e.g. `[["opsz","14..32"]]`. */
   variableAxes?: [string, string][];
 };
-declare function buildGoogleFontsUrl(fontFamily: string, axes: FontAxes, display: string): string;
-//#endregion
-export { FontAxes, buildGoogleFontsUrl };
+export declare function buildGoogleFontsUrl(fontFamily: string, axes: FontAxes, display: string): string;
+//#endregion

package/dist/build/google-fonts/fallback-metrics.d.ts

@@ -6,7 +6,6 @@ type AdjustFontFallback = {
   lineGapOverride: string;
   sizeAdjust: string;
 };
-declare function getFallbackFontOverrideMetrics(fontFamily: string): AdjustFontFallback | undefined;
-declare function buildFallbackFontFace(family: string, metrics: AdjustFontFallback): string;
-//#endregion
-export { buildFallbackFontFace, getFallbackFontOverrideMetrics };
+export declare function getFallbackFontOverrideMetrics(fontFamily: string): AdjustFontFallback | undefined;
+export declare function buildFallbackFontFace(family: string, metrics: AdjustFontFallback): string;
+//#endregion

package/dist/build/google-fonts/find-font-files-in-css.d.ts

@@ -8,9 +8,8 @@
  * packages/font/src/google/find-font-files-in-css.ts
  * https://github.com/vercel/next.js/blob/canary/packages/font/src/google/find-font-files-in-css.ts
  */
-declare function findFontFilesInCss(css: string, subsetsToPreload?: string[]): {
+export declare function findFontFilesInCss(css: string, subsetsToPreload?: string[]): {
   googleFontFileUrl: string;
   preloadFontFile: boolean;
 }[];
-//#endregion
-export { findFontFilesInCss };
+//#endregion

package/dist/build/google-fonts/font-metadata.d.ts

@@ -15,6 +15,5 @@ type FontFamilyMetadata = {
   /** Preloadable subsets (e.g. "latin", "latin-ext", "vietnamese"). */
   subsets: string[];
 };
-declare const googleFontsMetadata: Record<string, FontFamilyMetadata>;
-//#endregion
-export { googleFontsMetadata };
+export declare const googleFontsMetadata: Record<string, FontFamilyMetadata>;
+//#endregion

package/dist/build/google-fonts/get-axes.d.ts

@@ -1,5 +1,4 @@
 import { FontAxes } from "./build-url.js";
 //#region src/build/google-fonts/get-axes.d.ts
-declare function getFontAxes(fontFamily: string, weights: string[], styles: string[], selectedVariableAxes?: string[]): FontAxes;
-//#endregion
-export { getFontAxes };
+export declare function getFontAxes(fontFamily: string, weights: string[], styles: string[], selectedVariableAxes?: string[]): FontAxes;
+//#endregion

package/dist/build/google-fonts/sort-variants.d.ts

@@ -1,4 +1,3 @@
 //#region src/build/google-fonts/sort-variants.d.ts
-declare function sortFontsVariantValues(valA: string, valB: string): number;
-//#endregion
-export { sortFontsVariantValues };
+export declare function sortFontsVariantValues(valA: string, valB: string): number;
+//#endregion

package/dist/build/google-fonts/validate.d.ts

@@ -22,6 +22,5 @@ type ValidatedGoogleFontOptions = {
   variable?: string;
   subsets: string[];
 };
-declare function validateGoogleFontOptions(fontFamily: string, options: GoogleFontOptions): ValidatedGoogleFontOptions;
-//#endregion
-export { validateGoogleFontOptions };
+export declare function validateGoogleFontOptions(fontFamily: string, options: GoogleFontOptions): ValidatedGoogleFontOptions;
+//#endregion

package/dist/build/google-fonts/validate.js

@@ -25,12 +25,16 @@ function validateGoogleFontOptions(fontFamily, options) {
 	const fontStyles = fontFamilyData.styles;
 	const weights = !weight ? [] : dedupe(Array.isArray(weight) ? weight : [weight]);
 	const styles = !style ? [] : dedupe(Array.isArray(style) ? style : [style]);
-	if (weights.length === 0) if (fontWeights.includes("variable")) weights.push("variable");
-	else throw new Error(`Missing weight for font \`${fontFamily}\`.\nAvailable weights: ${formatAvailableValues(fontWeights)}`);
+	if (weights.length === 0) {
+		if (fontWeights.includes("variable")) weights.push("variable");
+		else throw new Error(`Missing weight for font \`${fontFamily}\`.\nAvailable weights: ${formatAvailableValues(fontWeights)}`);
+	}
 	if (weights.length > 1 && weights.includes("variable")) throw new Error(`Unexpected \`variable\` in weight array for font \`${fontFamily}\`. You only need \`variable\`, it includes all available weights.`);
 	for (const selectedWeight of weights) if (!fontWeights.includes(selectedWeight)) throw new Error(`Unknown weight \`${selectedWeight}\` for font \`${fontFamily}\`.\nAvailable weights: ${formatAvailableValues(fontWeights)}`);
-	if (styles.length === 0) if (fontStyles.length === 1) styles.push(fontStyles[0]);
-	else styles.push("normal");
+	if (styles.length === 0) {
+		if (fontStyles.length === 1) styles.push(fontStyles[0]);
+		else styles.push("normal");
+	}
 	for (const selectedStyle of styles) if (!fontStyles.includes(selectedStyle)) throw new Error(`Unknown style \`${selectedStyle}\` for font \`${fontFamily}\`.\nAvailable styles: ${formatAvailableValues(fontStyles)}`);
 	if (!ALLOWED_DISPLAY_VALUES.includes(display)) throw new Error(`Invalid display value \`${display}\` for font \`${fontFamily}\`.\nAvailable display values: ${formatAvailableValues(ALLOWED_DISPLAY_VALUES)}`);
 	if (axes) {

package/dist/build/inject-pregenerated-paths.d.ts

@@ -2,6 +2,5 @@
 declare global {
   var __VINEXT_PREGENERATED_CONCRETE_PATHS: unknown;
 }
-declare function injectPregeneratedConcretePaths(root: string): void;
-//#endregion
-export { injectPregeneratedConcretePaths };
+export declare function injectPregeneratedConcretePaths(root: string, applicationEntry?: string, serverOutputDir?: string, additionalRuntimeDirs?: readonly string[]): void;
+//#endregion

package/dist/build/inject-pregenerated-paths.js

@@ -1,21 +1,23 @@
 import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
-import { escapeRegExp } from "../utils/regex.js";
+import { PREGENERATED_CONCRETE_PATHS_MODULE } from "../server/pregenerated-concrete-paths.js";
+import { readServerRuntimeOutputDirs } from "./server-manifest.js";
 import { readPrerenderManifest } from "../server/prerender-manifest.js";
 import fs from "node:fs";
 //#region src/build/inject-pregenerated-paths.ts
-const VINEXT_PREGEN_START = "/* __VINEXT_PREGENERATED_CONCRETE_PATHS_START__ */";
-const VINEXT_PREGEN_END = "/* __VINEXT_PREGENERATED_CONCRETE_PATHS_END__ */";
-const VINEXT_PREGEN_RE = new RegExp(`${escapeRegExp(VINEXT_PREGEN_START)}[\\s\\S]*?${escapeRegExp(VINEXT_PREGEN_END)}\\n?`, "g");
-function injectPregeneratedConcretePaths(root) {
-	const workerEntry = path.resolve(root, "dist", "server", "index.js");
-	if (!fs.existsSync(workerEntry)) return;
-	let code = fs.readFileSync(workerEntry, "utf-8").replace(VINEXT_PREGEN_RE, "");
-	const table = readPrerenderManifest(path.join(root, "dist", "server", "vinext-prerender.json"))?.pregeneratedConcretePaths ?? [];
-	if (table.length > 0) {
-		globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS = table;
-		code = `${VINEXT_PREGEN_START}\nglobalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS = ${JSON.stringify(table)};\n${VINEXT_PREGEN_END}\n` + code;
-	} else delete globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS;
-	fs.writeFileSync(workerEntry, code);
+function injectPregeneratedConcretePaths(root, applicationEntry = path.resolve(root, "dist", "server", "index.js"), serverOutputDir = path.resolve(root, "dist", "server"), additionalRuntimeDirs = []) {
+	const table = readPrerenderManifest(path.join(serverOutputDir, "vinext-prerender.json"))?.pregeneratedConcretePaths ?? [];
+	const runtimeModuleCode = table.length > 0 ? `globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS = ${JSON.stringify(table)};\n` : "delete globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS;\n";
+	for (const outputDir of /* @__PURE__ */ new Set([
+		serverOutputDir,
+		path.dirname(applicationEntry),
+		...additionalRuntimeDirs,
+		...readServerRuntimeOutputDirs(serverOutputDir, root)
+	])) {
+		fs.mkdirSync(outputDir, { recursive: true });
+		fs.writeFileSync(path.join(outputDir, PREGENERATED_CONCRETE_PATHS_MODULE), runtimeModuleCode);
+	}
+	if (table.length > 0) globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS = table;
+	else delete globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS;
 }
 //#endregion
 export { injectPregeneratedConcretePaths };

package/dist/build/inline-css.d.ts

@@ -1,6 +1,5 @@
 //#region src/build/inline-css.d.ts
 type InlineCssManifest = Record<string, string>;
-declare function collectInlineCssManifest(clientDir: string, assetPrefix: string): InlineCssManifest;
-declare function injectInlineCssManifestGlobal(entryPath: string, manifest: InlineCssManifest): boolean;
-//#endregion
-export { collectInlineCssManifest, injectInlineCssManifestGlobal };
+export declare function collectInlineCssManifest(clientDir: string, assetPrefix: string): InlineCssManifest;
+export declare function injectInlineCssManifestGlobal(entryPath: string, manifest: InlineCssManifest): boolean;
+//#endregion

package/dist/build/layout-classification-types.d.ts

@@ -17,7 +17,7 @@
  * its own diagnostic shape without the consumer having to fall back to
  * stringly-typed `reason` fields.
  */
-type ClassificationReason = {
+export type ClassificationReason = {
   layer: "segment-config";
   key: "dynamic" | "revalidate";
   value: string | number;
@@ -32,7 +32,7 @@ type ClassificationReason = {
 } | {
   layer: "no-classifier";
 };
-type ModuleGraphStaticReason = {
+export type ModuleGraphStaticReason = {
   layer: "module-graph";
   result: "static";
   firstShimMatch?: string;
@@ -45,7 +45,7 @@ type ModuleGraphStaticReason = {
  * `absent` means no classifier layer had anything to say — the caller should
  * defer to the next layer (or to the runtime probe).
  */
-type LayoutBuildClassification = {
+export type LayoutBuildClassification = {
   kind: "absent";
 } | {
   kind: "static";
@@ -57,5 +57,4 @@ type LayoutBuildClassification = {
   kind: "needs-probe";
   reason: ClassificationReason;
 };
-//#endregion
-export { ClassificationReason, LayoutBuildClassification, ModuleGraphStaticReason };
+//#endregion

package/dist/build/layout-classification.d.ts

@@ -6,7 +6,7 @@ type ModuleGraphClassificationResult = {
   /** First dynamic shim module ID encountered during BFS, when any. */
   firstShimMatch?: string;
 };
-type ModuleInfoProvider = {
+export type ModuleInfoProvider = {
   getModuleInfo(id: string): {
     importedIds: string[];
     dynamicImportedIds: string[];
@@ -35,12 +35,12 @@ type RouteForClassification = {
  * shim module ID (when any). Operators use the shim ID via the debug
  * channel to trace why a layout was flagged for probing.
  */
-declare function classifyLayoutByModuleGraph(layoutModuleId: string, dynamicShimPaths: ReadonlySet<string>, moduleInfo: ModuleInfoProvider): ModuleGraphClassificationResult;
-declare function moduleGraphReason(graphResult: ModuleGraphClassificationResult & {
+export declare function classifyLayoutByModuleGraph(layoutModuleId: string, dynamicShimPaths: ReadonlySet<string>, moduleInfo: ModuleInfoProvider): ModuleGraphClassificationResult;
+export declare function moduleGraphReason(graphResult: ModuleGraphClassificationResult & {
   result: "static";
 }): ModuleGraphStaticReason;
-declare function moduleGraphReason(graphResult: ModuleGraphClassificationResult): ClassificationReason;
-declare function isStaticModuleGraphResult(graphResult: ModuleGraphClassificationResult): graphResult is ModuleGraphClassificationResult & {
+export declare function moduleGraphReason(graphResult: ModuleGraphClassificationResult): ClassificationReason;
+export declare function isStaticModuleGraphResult(graphResult: ModuleGraphClassificationResult): graphResult is ModuleGraphClassificationResult & {
   result: "static";
 };
 /**
@@ -57,6 +57,5 @@ declare function isStaticModuleGraphResult(graphResult: ModuleGraphClassificatio
  * via the numeric-index manifest in `route-classification-manifest.ts`.
  * Used only by `tests/layout-classification.test.ts`.
  */
-declare function classifyAllRouteLayouts(routes: readonly RouteForClassification[], dynamicShimPaths: ReadonlySet<string>, moduleInfo: ModuleInfoProvider): Map<string, LayoutBuildClassification>;
-//#endregion
-export { ModuleInfoProvider, classifyAllRouteLayouts, classifyLayoutByModuleGraph, isStaticModuleGraphResult, moduleGraphReason };
+export declare function classifyAllRouteLayouts(routes: readonly RouteForClassification[], dynamicShimPaths: ReadonlySet<string>, moduleInfo: ModuleInfoProvider): Map<string, LayoutBuildClassification>;
+//#endregion

package/dist/build/lifecycle.d.ts

@@ -0,0 +1,42 @@
+import { VinextCacheConfig } from "../cache/cache-adapters-virtual.js";
+import { ResolvedVinextPrerenderConfig, VinextRouteRootConfig } from "../config/prerender.js";
+import { ResolvedNextConfig } from "../config/next-config.js";
+import { runWithPreviewBuildCredentials } from "./preview-credentials.js";
+import { Plugin, PluginOption, ResolvedConfig, UserConfig, ViteBuilder } from "vite";
+//#region src/build/lifecycle.d.ts
+export type BuildLifecycleContext = {
+  cacheConfig: VinextCacheConfig | null;
+  configNodeEnv?: string;
+  createPagesOnlyPlugins: (pagesClientAssetsModule: string | null) => PluginOption[];
+  emptyOutDir?: boolean;
+  hasAppDir: boolean;
+  hasPagesDir: boolean;
+  nextConfig: ResolvedNextConfig;
+  prerenderAll?: boolean;
+  prerenderConfig: ResolvedVinextPrerenderConfig | null;
+  prerenderConcurrency?: number;
+  prerenderSecret: string;
+  previewBuildCredentials?: Parameters<typeof runWithPreviewBuildCredentials>[1];
+  revalidateSecret: string;
+  root: string;
+  routeRootConfig: VinextRouteRootConfig | null;
+  rscBuildIdentity?: string;
+  rscCompatibilityId?: string;
+  deferPostBuild?: boolean;
+  skipHybridPagesBundle?: boolean;
+};
+export declare const VINEXT_BUILD_LIFECYCLE_CONFIG = "__vinextBuildLifecycle";
+export type BuildLifecycleInvocation = {
+  onComplete?: () => void;
+};
+export declare function prepareBuildOutput(context: BuildLifecycleContext, emptyOutDir?: boolean | undefined): void;
+export declare function createBuildLifecyclePlugins(options: {
+  createContext: () => BuildLifecycleContext;
+  isEnabled: (builder: ViteBuilder) => boolean;
+  onComplete?: () => void;
+  onPrepare?: () => void;
+  shouldDeferPostBuild?: () => boolean;
+  shouldPrepare: (config: UserConfig | ResolvedConfig) => boolean;
+  shouldBuildPlainPages: () => boolean;
+}): Plugin[];
+//#endregion