vinext 1.3.0 → 1.3.1

package/dist/utils/client-reference-chunks.d.ts

@@ -0,0 +1,45 @@
+//#region src/utils/client-reference-chunks.d.ts
+/**
+ * The chunks an App Router client reference loads in the browser, which the
+ * RSC render names in the reference's Flight row (see
+ * server/app-client-reference-manifest.ts).
+ */
+export type ClientReferenceChunks = {
+  /** Reference key -> index into `modules`. */
+  references: Record<string, number>;
+  /**
+   * Each chunk that registers client references (see
+   * shims/internal/client-reference-loader.ts), with the JS chunks to
+   * modulepreload (it and the chunks it imports that the browser entry
+   * doesn't, picked by `build.modulePreload`), and the stylesheets they need.
+   */
+  modules: {
+    file: string;
+    imports: string[];
+    css: string[];
+  }[];
+};
+/**
+ * How the browser loads a chunk a Flight row names. React passes the loader
+ * only the chunk id, so the id is the kind followed by the URL.
+ */
+export declare const CLIENT_REFERENCE_CHUNK_KIND: {
+  /**
+   * The chunk that registers the reference, imported once the stylesheets
+   * its id lists after its URL have loaded.
+   */
+  readonly module: "m";
+  /** A JS chunk to modulepreload: the module chunk, or one it imports. */
+  readonly preload: "p";
+};
+/** Separates the URLs in a module chunk's id. A URL can't hold a raw newline. */
+export declare const CLIENT_REFERENCE_CHUNK_URL_SEPARATOR = "\n";
+/**
+ * React's webpack Flight binding takes a client reference's chunks as
+ * `[chunkId, filename, ...]` pairs. Only the id reaches the browser's chunk
+ * loader, so the filenames are left empty. The module chunk's id lists its
+ * stylesheets, so the loader can link them before the chunk evaluates, as
+ * Vite's preload helper does.
+ */
+export declare function toFlightChunks(module: ClientReferenceChunks["modules"][number]): string[];
+//#endregion

package/dist/utils/client-reference-chunks.js

@@ -0,0 +1,30 @@
+//#region src/utils/client-reference-chunks.ts
+/**
+* How the browser loads a chunk a Flight row names. React passes the loader
+* only the chunk id, so the id is the kind followed by the URL.
+*/
+const CLIENT_REFERENCE_CHUNK_KIND = {
+	/**
+	* The chunk that registers the reference, imported once the stylesheets
+	* its id lists after its URL have loaded.
+	*/
+	module: "m",
+	/** A JS chunk to modulepreload: the module chunk, or one it imports. */
+	preload: "p"
+};
+/** Separates the URLs in a module chunk's id. A URL can't hold a raw newline. */
+const CLIENT_REFERENCE_CHUNK_URL_SEPARATOR = "\n";
+/**
+* React's webpack Flight binding takes a client reference's chunks as
+* `[chunkId, filename, ...]` pairs. Only the id reaches the browser's chunk
+* loader, so the filenames are left empty. The module chunk's id lists its
+* stylesheets, so the loader can link them before the chunk evaluates, as
+* Vite's preload helper does.
+*/
+function toFlightChunks(module) {
+	const chunks = [CLIENT_REFERENCE_CHUNK_KIND.module + [module.file, ...module.css].join("\n"), ""];
+	for (const file of module.imports) chunks.push(CLIENT_REFERENCE_CHUNK_KIND.preload + file, "");
+	return chunks;
+}
+//#endregion
+export { CLIENT_REFERENCE_CHUNK_KIND, CLIENT_REFERENCE_CHUNK_URL_SEPARATOR, toFlightChunks };

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

@@ -1,7 +1,10 @@
+import { ClientReferenceChunks } from "./client-reference-chunks.js";
 //#region src/utils/client-runtime-metadata.d.ts
 type ClientRuntimeMetadata = {
   clientEntryFile?: string;
   appBootstrapPreinitModules?: string[];
+  appRouteManifestModule?: string;
+  appClientReferenceChunks?: ClientReferenceChunks;
   cssGraph?: Record<string, {
     imports?: string[];
     css?: string[];
@@ -14,6 +17,10 @@ type ClientRuntimeMetadata = {
  * Read the client build manifest and compute runtime metadata used by
  * Cloudflare worker entry injection and Node production server startup.
  *
+ * - `appRouteManifestModule` — the App Router RouteManifest chunk, which the
+ *   browser entry imports as it boots, preloaded during SSR.
+ * - `appClientReferenceChunks` — what each App Router client reference loads
+ *   in the browser, which the RSC render names in its Flight row.
  * - `lazyChunks` — chunks only reachable through dynamic `import()`, excluded
  *   from modulepreload hints.
  * - `dynamicPreloads` — per-module JS/CSS files for rendered `next/dynamic()`
@@ -32,4 +39,5 @@ export declare function computeClientRuntimeMetadata(opts: {
   assetPrefix: string;
   includeClientEntry?: boolean | "pages-client-entry";
 }): ClientRuntimeMetadata;
-//#endregion
+//#endregion
+export {};

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

@@ -1,9 +1,9 @@
 import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { isAbsoluteAssetPrefix, resolveAssetsDir } from "./asset-prefix.js";
 import { isSharedClientChunkName, manifestFileWithAssetPrefix, manifestFileWithBase } from "./manifest-paths.js";
-import { findClientEntryFileFromVinextManifest, findPagesClientEntryFileFromVinextManifest, readClientEntryManifest } from "./client-entry-manifest.js";
-import { findClientEntryFile, findPagesClientEntryFile, readClientBuildManifest } from "./client-build-manifest.js";
-import { computeDynamicImportPreloads, computeLazyChunks, dynamicImportPreloadsWithBase } from "./lazy-chunks.js";
+import { findClientEntryFileFromVinextManifest, findPagesClientEntryFileFromVinextManifest, readClientEntryManifest, readClientReferenceSources } from "./client-entry-manifest.js";
+import { findClientEntryFile, findPagesClientEntryFile, isPagesClientEntryChunk, readClientBuildManifest } from "./client-build-manifest.js";
+import { addDynamicImportPreloadAliases, computeDynamicImportPreloads, computeLazyChunks, dynamicImportPreloadsWithBase } from "./lazy-chunks.js";
 //#region src/utils/client-runtime-metadata.ts
 /**
 * Shared Pages Router chunk files, keyed on Rolldown chunk names rather than
@@ -12,7 +12,20 @@ import { computeDynamicImportPreloads, computeLazyChunks, dynamicImportPreloadsW
 */
 function collectSharedChunkFiles(buildManifest, applyBase) {
 	const files = /* @__PURE__ */ new Set();
-	for (const chunk of Object.values(buildManifest)) if (chunk.file.endsWith(".js") && isSharedClientChunkName(chunk.name)) files.add(applyBase(chunk.file));
+	const visitedKeys = /* @__PURE__ */ new Set();
+	const addStaticImports = (key) => {
+		for (const importedKey of buildManifest[key]?.imports ?? []) {
+			if (visitedKeys.has(importedKey)) continue;
+			visitedKeys.add(importedKey);
+			const importedFile = buildManifest[importedKey]?.file;
+			if (importedFile?.endsWith(".js")) files.add(applyBase(importedFile));
+			addStaticImports(importedKey);
+		}
+	};
+	for (const [key, chunk] of Object.entries(buildManifest)) {
+		if (chunk.file.endsWith(".js") && isSharedClientChunkName(chunk.name)) files.add(applyBase(chunk.file));
+		if (isPagesClientEntryChunk(key, chunk)) addStaticImports(key);
+	}
 	return files.size > 0 ? [...files] : void 0;
 }
 function collectCssGraph(buildManifest, applyBase) {
@@ -56,6 +69,10 @@ function collectAppBootstrapPreinitModules(buildManifest, appBrowserEntry, apply
 * Read the client build manifest and compute runtime metadata used by
 * Cloudflare worker entry injection and Node production server startup.
 *
+* - `appRouteManifestModule` — the App Router RouteManifest chunk, which the
+*   browser entry imports as it boots, preloaded during SSR.
+* - `appClientReferenceChunks` — what each App Router client reference loads
+*   in the browser, which the RSC render names in its Flight row.
 * - `lazyChunks` — chunks only reachable through dynamic `import()`, excluded
 *   from modulepreload hints.
 * - `dynamicPreloads` — per-module JS/CSS files for rendered `next/dynamic()`
@@ -83,18 +100,32 @@ function computeClientRuntimeMetadata(opts) {
 		const entry = opts.includeClientEntry === "pages-client-entry" ? findPagesClientEntryFileFromVinextManifest(clientEntryManifest, opts.assetBase) ?? findPagesClientEntryFile(entryOptions) : findClientEntryFileFromVinextManifest(clientEntryManifest, opts.assetBase) ?? findClientEntryFile(entryOptions);
 		if (entry) metadata.clientEntryFile = entry;
 	}
+	const appAssetUrl = (file) => {
+		const url = manifestFileWithAssetPrefix(file, opts.assetBase, opts.assetPrefix);
+		return isAbsoluteAssetPrefix(opts.assetPrefix) ? url : "/" + url;
+	};
+	const referenceChunks = clientEntryManifest?.appClientReferenceChunks;
+	if (referenceChunks) metadata.appClientReferenceChunks = {
+		references: referenceChunks.references,
+		modules: referenceChunks.modules.map((module) => ({
+			file: appAssetUrl(module.file),
+			imports: module.imports.map(appAssetUrl),
+			css: module.css.map(appAssetUrl)
+		}))
+	};
 	if (!buildManifest) return metadata;
 	if (opts.includeClientEntry) {
 		metadata.cssGraph = collectCssGraph(buildManifest, (file) => manifestFileWithBase(file, opts.assetBase));
 		metadata.sharedChunks = collectSharedChunkFiles(buildManifest, (file) => manifestFileWithBase(file, opts.assetBase));
 	}
-	metadata.appBootstrapPreinitModules = collectAppBootstrapPreinitModules(buildManifest, clientEntryManifest?.appBrowserEntry, (file) => {
-		const url = manifestFileWithAssetPrefix(file, opts.assetBase, opts.assetPrefix);
-		return isAbsoluteAssetPrefix(opts.assetPrefix) ? url : "/" + url;
-	});
+	metadata.appBootstrapPreinitModules = collectAppBootstrapPreinitModules(buildManifest, clientEntryManifest?.appBrowserEntry, appAssetUrl);
+	if (clientEntryManifest?.appRouteManifest) metadata.appRouteManifestModule = appAssetUrl(clientEntryManifest.appRouteManifest);
 	const lazyChunks = computeLazyChunks(buildManifest).map((file) => manifestFileWithBase(file, opts.assetBase));
 	if (lazyChunks.length > 0) metadata.lazyChunks = lazyChunks;
-	const dynamicPreloads = dynamicImportPreloadsWithBase(computeDynamicImportPreloads(buildManifest), (file) => manifestFileWithAssetPrefix(file, opts.assetBase, opts.assetPrefix));
+	const dynamicImportPreloads = computeDynamicImportPreloads(buildManifest);
+	const clientReferenceSources = readClientReferenceSources(opts.clientDir);
+	if (clientReferenceSources) addDynamicImportPreloadAliases(dynamicImportPreloads, buildManifest, clientReferenceSources);
+	const dynamicPreloads = dynamicImportPreloadsWithBase(dynamicImportPreloads, (file) => manifestFileWithAssetPrefix(file, opts.assetBase, opts.assetPrefix));
 	if (Object.keys(dynamicPreloads).length > 0) metadata.dynamicPreloads = dynamicPreloads;
 	return metadata;
 }

package/dist/utils/compare.d.ts

@@ -1,3 +1,12 @@
 //#region src/utils/compare.d.ts
 export declare const compareStrings: (left: string, right: string) => number;
+/**
+ * Turbopack reads a folder's subfolders from a `BTreeMap<RcStr, _>`, whose
+ * keys compare as Rust `str`s: by UTF-8 bytes. That is Unicode code point
+ * order, which JavaScript's `<` (UTF-16 code units) doesn't match above the
+ * Basic Multilingual Plane.
+ * https://github.com/vercel/next.js/blob/v16.2.7/crates/next-core/src/app_structure.rs#L188-L192
+ * https://github.com/vercel/next.js/blob/v16.2.7/turbopack/crates/turbo-rcstr/src/lib.rs#L350-L354
+ */
+export declare function compareFolderNames(a: string, b: string): number;
 //#endregion

package/dist/utils/compare.js

@@ -4,5 +4,19 @@ const compareStrings = (left, right) => {
 	if (left > right) return 1;
 	return 0;
 };
+/**
+* Turbopack reads a folder's subfolders from a `BTreeMap<RcStr, _>`, whose
+* keys compare as Rust `str`s: by UTF-8 bytes. That is Unicode code point
+* order, which JavaScript's `<` (UTF-16 code units) doesn't match above the
+* Basic Multilingual Plane.
+* https://github.com/vercel/next.js/blob/v16.2.7/crates/next-core/src/app_structure.rs#L188-L192
+* https://github.com/vercel/next.js/blob/v16.2.7/turbopack/crates/turbo-rcstr/src/lib.rs#L350-L354
+*/
+function compareFolderNames(a, b) {
+	const left = Array.from(a, (char) => char.codePointAt(0) ?? 0);
+	const right = Array.from(b, (char) => char.codePointAt(0) ?? 0);
+	for (let index = 0; index < Math.min(left.length, right.length); index++) if (left[index] !== right[index]) return left[index] - right[index];
+	return left.length - right.length;
+}
 //#endregion
-export { compareStrings };
+export { compareFolderNames, compareStrings };

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

@@ -26,6 +26,11 @@ export type BuildManifestChunk = {
  * static `imports` tree (breadth-first). Any chunk file NOT reached by this
  * walk is only reachable through `dynamicImports` and is therefore "lazy".
  *
+ * The Pages Router client entry `import()`s every page and `_app`, but the
+ * HTML for a page renders that page and `_app`, so their chunks are roots of
+ * the walk too: Next.js emits their scripts in the initial HTML. Their own
+ * dynamic imports (next/dynamic, React.lazy) stay lazy.
+ *
  * @param buildManifest - Vite's build manifest (manifest.json), which is a
  *   Record<string, ManifestChunk> where each chunk has `file`, `imports`,
  *   `dynamicImports`, `isEntry`, and `isDynamicEntry` fields.
@@ -58,5 +63,14 @@ export declare function computeLazyChunks(buildManifest: Record<string, BuildMan
  * should be preloaded when that dynamic boundary is rendered.
  */
 export declare function computeDynamicImportPreloads(buildManifest: Record<string, BuildManifestChunk>): Record<string, string[]>;
+/**
+ * Give a module the preloads of a chunk that loads it. The client build
+ * imports an App Router client reference through the module that registers it
+ * (see build/client-reference-chunks.ts), so the build manifest keys that
+ * module's chunk, not the reference's module a next/dynamic boundary names.
+ *
+ * @param aliases Module manifest key -> the file of the chunk that loads it.
+ */
+export declare function addDynamicImportPreloadAliases(preloads: Record<string, string[]>, buildManifest: Record<string, BuildManifestChunk>, aliases: Record<string, string>): void;
 export declare function dynamicImportPreloadsWithBase(preloads: Record<string, string[]>, applyBase: (file: string) => string): Record<string, string[]>;
 //#endregion

package/dist/utils/lazy-chunks.js

@@ -1,3 +1,4 @@
+import { isPagesClientEntryChunk } from "./client-build-manifest.js";
 //#region src/utils/lazy-chunks.ts
 /**
 * Compute the set of chunk filenames that are ONLY reachable through dynamic
@@ -10,6 +11,11 @@
 * static `imports` tree (breadth-first). Any chunk file NOT reached by this
 * walk is only reachable through `dynamicImports` and is therefore "lazy".
 *
+* The Pages Router client entry `import()`s every page and `_app`, but the
+* HTML for a page renders that page and `_app`, so their chunks are roots of
+* the walk too: Next.js emits their scripts in the initial HTML. Their own
+* dynamic imports (next/dynamic, React.lazy) stay lazy.
+*
 * @param buildManifest - Vite's build manifest (manifest.json), which is a
 *   Record<string, ManifestChunk> where each chunk has `file`, `imports`,
 *   `dynamicImports`, `isEntry`, and `isDynamicEntry` fields.
@@ -32,6 +38,9 @@ function computeLazyChunks(buildManifest) {
 		if (chunk.imports) {
 			for (const imp of chunk.imports) if (!visited.has(imp)) queue.push(imp);
 		}
+		if (isPagesClientEntryChunk(key, chunk)) {
+			for (const imp of chunk.dynamicImports ?? []) if (!visited.has(imp)) queue.push(imp);
+		}
 	}
 	const lazyChunks = [];
 	const allFiles = /* @__PURE__ */ new Set();
@@ -103,10 +112,27 @@ function computeDynamicImportPreloads(buildManifest) {
 	}
 	return preloads;
 }
+/**
+* Give a module the preloads of a chunk that loads it. The client build
+* imports an App Router client reference through the module that registers it
+* (see build/client-reference-chunks.ts), so the build manifest keys that
+* module's chunk, not the reference's module a next/dynamic boundary names.
+*
+* @param aliases Module manifest key -> the file of the chunk that loads it.
+*/
+function addDynamicImportPreloadAliases(preloads, buildManifest, aliases) {
+	const keysByFile = /* @__PURE__ */ new Map();
+	for (const [key, chunk] of Object.entries(buildManifest)) keysByFile.set(chunk.file, normalizeManifestKey(key));
+	for (const [moduleKey, file] of Object.entries(aliases)) {
+		const key = keysByFile.get(file);
+		const files = key === void 0 ? void 0 : preloads[key];
+		if (files && !Object.hasOwn(preloads, moduleKey)) preloads[moduleKey] = files;
+	}
+}
 function dynamicImportPreloadsWithBase(preloads, applyBase) {
 	const withBase = {};
 	for (const [key, files] of Object.entries(preloads)) withBase[key] = files.map(applyBase);
 	return withBase;
 }
 //#endregion
-export { computeDynamicImportPreloads, computeLazyChunks, dynamicImportPreloadsWithBase };
+export { addDynamicImportPreloadAliases, computeDynamicImportPreloads, computeLazyChunks, dynamicImportPreloadsWithBase };

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

@@ -21,4 +21,5 @@ export declare function encodeMiddlewareRequestHeaders(targetHeaders: Headers, r
  */
 export declare function buildRequestHeadersFromMiddlewareResponse(baseHeaders: Headers, middlewareHeaders: MiddlewareHeaderSource): Headers | null;
 export declare function shouldKeepMiddlewareHeader(key: string): boolean;
-//#endregion
+//#endregion
+export {};

package/dist/utils/project.d.ts

@@ -111,4 +111,5 @@ export declare function findDir(root: string, ...candidates: string[]): string |
  * Check if the project uses App Router (has an app/ directory).
  */
 export declare function hasAppDir(root: string): boolean;
-//#endregion
+//#endregion
+export {};

package/dist/utils/project.js

@@ -333,6 +333,14 @@ function detectMDXFromConfig(root) {
 	}
 	return false;
 }
+/**
+* Next.js copies a set legacy `experimental.cacheComponents` over the
+* top-level key (warnOptionHasBeenMovedOutOfExperimental).
+*/
+function configEnablesCacheComponents(content) {
+	if (/\bexperimental\s*:\s*\{[^}]*\bcacheComponents\s*:\s*false\b/.test(content)) return false;
+	return /\bcacheComponents\s*:\s*true\b/.test(content);
+}
 function detectCacheComponents(root) {
 	for (const fileName of [
 		"next.config.ts",
@@ -344,7 +352,7 @@ function detectCacheComponents(root) {
 		const configPath = path.join(root, fileName);
 		if (!fs.existsSync(configPath)) continue;
 		try {
-			if (/\bcacheComponents\s*:\s*true\b/.test(fs.readFileSync(configPath, "utf-8"))) return true;
+			if (configEnablesCacheComponents(fs.readFileSync(configPath, "utf-8"))) return true;
 		} catch {}
 	}
 	return false;

package/dist/utils/query.d.ts

@@ -51,4 +51,5 @@ export declare function mergeRewriteQuery(originalUrl: string, rewriteUrl: strin
  * and fragment identifier.
  */
 export declare function appendSearchParamsToUrl(url: string, params: Iterable<[string, string]>): string;
-//#endregion
+//#endregion
+export {};

package/dist/utils/sorted-array.d.ts

@@ -4,4 +4,5 @@ type SortedStringPosition = Readonly<{
   index: number;
 }>;
 export declare function findSortedStringPosition(values: readonly string[], candidate: string): SortedStringPosition;
-//#endregion
+//#endregion
+export {};

package/dist/utils/vite-cli-invocation.d.ts

@@ -18,4 +18,5 @@ export declare function getViteCliInvocation(argv?: string[]): Invocation | unde
 export declare function isViteCliConfigFile(configFile: string, inlineConfig?: Pick<InlineConfig, "root" | "configFile">): boolean;
 export declare function isViteCliInvocation(command: Command, argv?: string[]): boolean;
 export declare function claimViteCliBuildInvocation(argv?: string[]): boolean;
-//#endregion
+//#endregion
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vinext",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Run Next.js apps on Vite. Drop-in replacement for the next CLI.",
   "homepage": "https://vinext.dev/",
   "license": "MIT",
@@ -230,7 +230,7 @@
     "magic-string": "^0.30.21",
     "vite-plugin-commonjs": "^0.10.4",
     "web-vitals": "^4.2.4",
-    "@vinext/types": "^1.0.1"
+    "@vinext/types": "^1.0.2"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",
@@ -241,12 +241,12 @@
     "@vitejs/plugin-rsc": "^0.5.38",
     "am-i-vibing": "^0.5.0",
     "ignore": "5.3.2",
-    "image-size": "2.0.2",
+    "image-size": "2.0.4",
     "pathslash": "^0.1.0",
     "react-server-dom-webpack": "^19.3.1",
     "ua-parser-js": "1.0.35",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
-    "vite-plus": "1.1.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.3.0",
+    "vite-plus": "1.3.0"
   },
   "peerDependencies": {
     "@mdx-js/rollup": "^3.0.0",