vinext 1.3.0 → 1.4.0

package/dist/init-cloudflare.d.ts

@@ -8,7 +8,6 @@ export type CloudflareProjectInfo = {
   hasMDX: boolean;
   /** The effective Next.js config sets `output: "export"`. */
   isStaticExport?: boolean;
-  nativeModulesToStub: string[];
 };
 export type CloudflarePlatformSetupContext = {
   root: string;
@@ -46,14 +45,13 @@ export declare function cssModulesConfigSource(indent?: string): string;
 /** Generate vite.config.ts for App Router */
 export declare function generateAppRouterViteConfig(info?: CloudflareProjectInfo, options?: CloudflareInitOptions, imagesBinding?: string, versionMetadataBinding?: string, serviceBinding?: boolean, assetsBinding?: string, assetsDirectory?: string, hasCssModules?: boolean): string;
 /** Generate vite.config.ts for Pages Router */
-export declare function generatePagesRouterViteConfig(info?: CloudflareProjectInfo, options?: CloudflareInitOptions, imagesBinding?: string, versionMetadataBinding?: string, serviceBinding?: boolean, hasCssModules?: boolean, assetsBinding?: string, assetsDirectory?: string): string;
+export declare function generatePagesRouterViteConfig(options?: CloudflareInitOptions, imagesBinding?: string, versionMetadataBinding?: string, serviceBinding?: boolean, hasCssModules?: boolean, assetsBinding?: string, assetsDirectory?: string): string;
 export declare function updateViteConfigForCssModules(filePath: string, code: string): {
   code: string;
   preservedExistingGenerateScopedName: boolean;
 };
 export declare function updateViteConfigForCloudflare(filePath: string, code: string, options: {
   isAppRouter: boolean;
-  nativeModulesToStub: string[];
   cache?: CloudflareInitOptions;
   assetsBinding?: string;
   assetsDirectory?: string;

package/dist/init-cloudflare.js

@@ -32,14 +32,15 @@ const CACHE_METADATA_EXPORT = {
 const CTX_EXPORTS_DEFAULT_DATE = "2025-11-17";
 function validateCloudflarePlatformSetup(context, cloudflare) {
 	if (cloudflare.name !== void 0) validateWorkerName(cloudflare.name);
+	if (cloudflare.legacyWrangler && cloudflare.ignoreWranglerConfig) throw new Error("--ignore-wrangler-config cannot be combined with --legacy-wrangler-cloudflare-init.");
 	if (!cloudflare.legacyWrangler) {
-		const existingWrangler = [
+		const existingWrangler = cloudflare.ignoreWranglerConfig ? void 0 : [
 			"wrangler.toml",
 			"wrangler.json",
 			"wrangler.jsonc",
 			RESPONSE_STORE_WRANGLER_CONFIG
 		].find((name) => fs.existsSync(path.join(context.root, name)));
-		if (existingWrangler) throw new Error(`Cloudflare init cannot replace an existing Wrangler config (${existingWrangler}). Migrate its bindings to cloudflare.config.ts first, or use --legacy-wrangler-cloudflare-init to keep the Wrangler setup.`);
+		if (existingWrangler) throw new Error(`Cloudflare init cannot replace an existing Wrangler config (${existingWrangler}). Migrate its bindings to cloudflare.config.ts first, use --ignore-wrangler-config if it belongs to another Worker, or use --legacy-wrangler-cloudflare-init to keep the Wrangler setup.`);
 		const typedConfigPath = path.join(context.root, "cloudflare.config.ts");
 		if (cloudflare.cdnCache === "static-assets" && fs.existsSync(typedConfigPath)) throw new Error("Static Assets cache setup for an existing cloudflare.config.ts must be configured manually. Keep its assets binding aligned with staticAssetsAdapter({ binding }) and include \"/_vinext/static-cache/*\" in assets.runWorkerFirst to protect private cache files.");
 		if (cloudflare.cdnCache === "response-store" && (cloudflare.responseStoreMode ?? "service-binding") === "service-binding" && fs.existsSync(typedConfigPath) && !fs.readFileSync(typedConfigPath, "utf-8").includes("export const responseStoreServiceBinding")) throw new Error("The existing cloudflare.config.ts must export responseStoreServiceBinding for the Response Store auxiliary Worker. Configure it before rerunning init.");
@@ -47,7 +48,6 @@ function validateCloudflarePlatformSetup(context, cloudflare) {
 		if (context.existingViteConfigPath) {
 			const updatedConfig = updateViteConfigForCloudflare(context.existingViteConfigPath, fs.readFileSync(context.existingViteConfigPath, "utf-8"), {
 				isAppRouter: context.isAppRouter,
-				nativeModulesToStub: detectProject(context.root).nativeModulesToStub,
 				cache: cloudflare
 			});
 			if (context.hasCssModules) updateViteConfigForCssModules(context.existingViteConfigPath, updatedConfig);
@@ -56,7 +56,6 @@ function validateCloudflarePlatformSetup(context, cloudflare) {
 	}
 	const tomlPath = path.join(context.root, "wrangler.toml");
 	if (fs.existsSync(tomlPath)) throw new Error("wrangler.toml is not supported by vinext init. Convert it to wrangler.jsonc and rerun.");
-	const projectInfo = detectProject(context.root);
 	const wranglerPath = ["wrangler.jsonc", "wrangler.json"].map((fileName) => path.join(context.root, fileName)).find((candidate) => fs.existsSync(candidate));
 	const wranglerCode = wranglerPath ? fs.readFileSync(wranglerPath, "utf-8") : void 0;
 	if (!wranglerCode && cloudflare.cdnCache === "response-store" && (cloudflare.responseStoreMode ?? "service-binding") === "service-binding" && fs.existsSync(path.join(context.root, RESPONSE_STORE_WRANGLER_CONFIG))) readResponseStoreServiceName(context.root, {});
@@ -71,7 +70,6 @@ function validateCloudflarePlatformSetup(context, cloudflare) {
 	if (context.existingViteConfigPath) {
 		const updatedConfig = updateViteConfigForCloudflare(context.existingViteConfigPath, fs.readFileSync(context.existingViteConfigPath, "utf-8"), {
 			isAppRouter: context.isAppRouter,
-			nativeModulesToStub: projectInfo.nativeModulesToStub,
 			cache: cloudflare,
 			assetsBinding,
 			assetsDirectory,
@@ -101,7 +99,6 @@ function setupCloudflarePlatform(context, cloudflare) {
 		const currentConfig = fs.readFileSync(context.existingViteConfigPath, "utf-8");
 		let updatedConfig = updateViteConfigForCloudflare(context.existingViteConfigPath, currentConfig, {
 			isAppRouter: context.isAppRouter,
-			nativeModulesToStub: projectInfo.nativeModulesToStub,
 			cache: cloudflare,
 			assetsBinding,
 			assetsDirectory,
@@ -118,7 +115,7 @@ function setupCloudflarePlatform(context, cloudflare) {
 			generatedViteConfig = true;
 		} else skippedViteConfig = true;
 	} else {
-		const configContent = context.isAppRouter ? generateAppRouterViteConfig(projectInfo, cloudflare, imagesBinding, versionMetadataBinding, false, assetsBinding, assetsDirectory, context.hasCssModules) : generatePagesRouterViteConfig(projectInfo, cloudflare, imagesBinding, versionMetadataBinding, false, context.hasCssModules, assetsBinding, assetsDirectory);
+		const configContent = context.isAppRouter ? generateAppRouterViteConfig(projectInfo, cloudflare, imagesBinding, versionMetadataBinding, false, assetsBinding, assetsDirectory, context.hasCssModules) : generatePagesRouterViteConfig(cloudflare, imagesBinding, versionMetadataBinding, false, context.hasCssModules, assetsBinding, assetsDirectory);
 		fs.writeFileSync(path.join(context.root, "vite.config.ts"), configContent, "utf-8");
 		generatedViteConfig = true;
 	}
@@ -178,7 +175,6 @@ function setupCfPlatform(context, cloudflare) {
 		const current = fs.readFileSync(context.existingViteConfigPath, "utf-8");
 		let updated = updateViteConfigForCloudflare(context.existingViteConfigPath, current, {
 			isAppRouter: context.isAppRouter,
-			nativeModulesToStub: projectInfo.nativeModulesToStub,
 			cache: cloudflare
 		});
 		if (context.hasCssModules) {
@@ -191,7 +187,7 @@ function setupCfPlatform(context, cloudflare) {
 			generatedViteConfig = true;
 		}
 	} else {
-		const viteConfig = context.isAppRouter ? generateAppRouterViteConfig(projectInfo, cloudflare, "IMAGES", DEFAULT_VERSION_METADATA_BINDING, serviceBinding, "ASSETS", "dist/client", context.hasCssModules) : generatePagesRouterViteConfig(projectInfo, cloudflare, "IMAGES", DEFAULT_VERSION_METADATA_BINDING, serviceBinding, context.hasCssModules);
+		const viteConfig = context.isAppRouter ? generateAppRouterViteConfig(projectInfo, cloudflare, "IMAGES", DEFAULT_VERSION_METADATA_BINDING, serviceBinding, "ASSETS", "dist/client", context.hasCssModules) : generatePagesRouterViteConfig(cloudflare, "IMAGES", DEFAULT_VERSION_METADATA_BINDING, serviceBinding, context.hasCssModules);
 		fs.writeFileSync(path.join(context.root, "vite.config.ts"), viteConfig, "utf-8");
 		generatedViteConfig = true;
 	}
@@ -849,7 +845,7 @@ function generateAppRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPT
 		...cacheImports(options),
 		...hasCssModules ? ["import { createHash } from \"node:crypto\";", "import { patchCssModules } from \"vite-css-modules\";"] : []
 	];
-	if (hasCssModules || info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) imports.push(`import path from "node:path";`);
+	if (hasCssModules) imports.push(`import path from "node:path";`);
 	const plugins = [];
 	if (hasCssModules) plugins.push("    patchCssModules({ exportMode: \"default\" }),");
 	if (info?.hasMDX) plugins.push(`    // vinext auto-injects @mdx-js/rollup with plugins from next.config`);
@@ -860,21 +856,17 @@ function generateAppRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPT
         childEnvironments: ["ssr"],
       },
     }),`);
-	let resolveBlock = "";
-	const aliases = [];
-	if (info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) for (const mod of info.nativeModulesToStub) aliases.push(`      "${mod}": path.resolve(__dirname, "empty-stub.js"),`);
-	if (aliases.length > 0) resolveBlock = `\n  resolve: {\n    alias: {\n${aliases.join("\n")}\n    },\n  },`;
 	return `${imports.join("\n")}
 
 export default defineConfig({
   plugins: [
 ${plugins.join("\n")}
-  ],${resolveBlock}${hasCssModules ? cssModulesConfigSource() : ""}
+  ],${hasCssModules ? cssModulesConfigSource() : ""}
 });
 `;
 }
 /** Generate vite.config.ts for Pages Router */
-function generatePagesRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_OPTIONS, imagesBinding = "IMAGES", versionMetadataBinding = DEFAULT_VERSION_METADATA_BINDING, serviceBinding = false, hasCssModules = false, assetsBinding = "ASSETS", assetsDirectory = "dist/client") {
+function generatePagesRouterViteConfig(options = DEFAULT_CLOUDFLARE_INIT_OPTIONS, imagesBinding = "IMAGES", versionMetadataBinding = DEFAULT_VERSION_METADATA_BINDING, serviceBinding = false, hasCssModules = false, assetsBinding = "ASSETS", assetsDirectory = "dist/client") {
 	const legacyStaticAssets = options.legacyWrangler && options.cdnCache === "static-assets";
 	const imports = [
 		`import { defineConfig } from "vite";`,
@@ -884,18 +876,14 @@ function generatePagesRouterViteConfig(info, options = DEFAULT_CLOUDFLARE_INIT_O
 		...cacheImports(options),
 		...hasCssModules ? ["import { createHash } from \"node:crypto\";", "import { patchCssModules } from \"vite-css-modules\";"] : []
 	];
-	if (hasCssModules || info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) imports.push(`import path from "node:path";`);
-	let resolveBlock = "";
-	const aliases = [];
-	if (info?.nativeModulesToStub && info.nativeModulesToStub.length > 0) for (const mod of info.nativeModulesToStub) aliases.push(`      "${mod}": path.resolve(__dirname, "empty-stub.js"),`);
-	if (aliases.length > 0) resolveBlock = `\n  resolve: {\n    alias: {\n${aliases.join("\n")}\n    },\n  },`;
+	if (hasCssModules) imports.push(`import path from "node:path";`);
 	return `${imports.join("\n")}
 
 export default defineConfig({
 ${legacyStaticAssets ? `  environments: { client: { build: { outDir: ${JSON.stringify(assetsDirectory)} } }, ssr: { build: { outDir: "dist/server" } } },\n` : ""}  plugins: [
 ${hasCssModules ? "    patchCssModules({ exportMode: \"default\" }),\n" : ""}    ${vinextExpression(options, "vinext", "imagesOptimizer", imagesBinding, versionMetadataBinding, "responseStoreAdapter", assetsBinding, assetsDirectory).replace(/\n/g, "\n    ")},
     cloudflare(${legacyStaticAssets ? "{ viteEnvironment: { name: \"ssr\" } }" : serviceBinding ? "{ auxiliaryWorkers: [{ config: responseStoreServiceBinding }] }" : ""}),
-  ],${resolveBlock}${hasCssModules ? cssModulesConfigSource() : ""}
+  ],${hasCssModules ? cssModulesConfigSource() : ""}
 });
 `;
 }
@@ -1447,27 +1435,6 @@ function updateViteConfigForCssModules(filePath, code) {
 		preservedExistingGenerateScopedName: Boolean(existingName)
 	};
 }
-function ensureNativeAliases(output, config, modules, pathBinding, code) {
-	if (modules.length === 0) return;
-	const resolve = findProperty(config, "resolve");
-	if (resolve && resolve.value.type !== "ObjectExpression") throw new Error("The Vite config's resolve option must be an object for vinext init to update it.");
-	const resolveObject = resolve?.value;
-	const alias = resolveObject ? findProperty(resolveObject, "alias") : void 0;
-	if (alias && alias.value.type !== "ObjectExpression") throw new Error("The Vite config's resolve.alias option must be an object for vinext init to update it.");
-	const aliasLines = modules.map((moduleName) => `      ${JSON.stringify(moduleName)}: ${pathBinding}.resolve(__dirname, "empty-stub.js"),`);
-	if (!resolveObject) {
-		insertObjectProperty(output, config, `  resolve: {\n    alias: {\n${aliasLines.join("\n")}\n    },\n  },`, code);
-		return;
-	}
-	if (!alias) {
-		insertObjectProperty(output, resolveObject, `    alias: {\n${aliasLines.join("\n")}\n    },`, code);
-		return;
-	}
-	const aliasObject = alias.value;
-	const existingAliases = new Set(aliasObject.properties.flatMap((property) => property.type === "Property" && propertyName(property) ? [propertyName(property)] : []));
-	const missingLines = aliasLines.filter((_, index) => !existingAliases.has(modules[index]));
-	if (missingLines.length > 0) insertObjectProperty(output, aliasObject, missingLines.join("\n"), code);
-}
 function updateViteConfigForCloudflare(filePath, code, options) {
 	const program = parseViteConfig(filePath, code);
 	const cacheOptions = options.cache ?? DEFAULT_CLOUDFLARE_INIT_OPTIONS;
@@ -1604,11 +1571,6 @@ function updateViteConfigForCloudflare(filePath, code, options) {
 			if (cacheOptions.cdnCache === "static-assets" || cacheOptions.prerender) ensureVinextPrerenderOptions(output, config, vinextBinding, cacheOptions.cdnCache === "static-assets" ? options.assetsDirectory ?? "dist/client" : void 0, code);
 		}
 	}
-	if (options.nativeModulesToStub.length > 0) {
-		const pathLocal = (commonJs ? findRequiredBinding(program, "node:path", "default") : program.body.filter((statement) => statement.type === "ImportDeclaration").find((statement) => statement.source.value === "node:path")?.specifiers.find((specifier) => specifier.type === "ImportDefaultSpecifier")?.local.name) ?? allocateBinding(bindings, "path");
-		const pathBinding = commonJs ? ensureDefaultRequire(program, output, "node:path", pathLocal) : ensureDefaultImport(program, output, "node:path", pathLocal);
-		ensureNativeAliases(output, config, options.nativeModulesToStub, pathBinding, code);
-	}
 	return formatInlineConfig(filePath, output.toString(), code);
 }
 function usesCommonJsViteConfig(filePath, code) {

package/dist/init-platform.d.ts

@@ -12,6 +12,8 @@ export type CloudflareInitOptions = {
   responseStoreMode?: InitResponseStoreMode;
   warmCdnCache?: boolean;
   legacyWrangler?: boolean;
+  /** Proceed even though the root Wrangler config belongs to another Worker. */
+  ignoreWranglerConfig?: boolean;
   prerender?: boolean;
   /** Worker name for generated config, instead of one derived from package.json. */
   name?: string;

package/dist/init-platform.js

@@ -137,11 +137,14 @@ async function resolveInitPlatform(args, options = {}) {
 }
 async function resolveInitOptions(args, options = {}) {
 	const legacyWrangler = parseBooleanArg(args, "--legacy-wrangler-cloudflare-init", void 0, "--legacy-wrangler-cloudflare-init expects true or false when using the \"--legacy-wrangler-cloudflare-init=value\" form.");
+	const ignoreWranglerConfig = parseBooleanArg(args, "--ignore-wrangler-config", void 0, "--ignore-wrangler-config expects true or false when using the \"--ignore-wrangler-config=value\" form.");
 	const name = parseNameArg(args);
 	const platform = legacyWrangler && !parsePlatformArg(args) ? "cloudflare" : await resolveInitPlatform(args, options);
 	const platformOptions = await INIT_PLATFORMS[platform].options(args, options);
 	const explicitWarmCdnCache = parseWarmCdnCacheArg(args);
 	if (legacyWrangler && platform !== "cloudflare") throw new Error("--legacy-wrangler-cloudflare-init requires --platform=cloudflare.");
+	if (ignoreWranglerConfig && platform !== "cloudflare") throw new Error("--ignore-wrangler-config requires --platform=cloudflare.");
+	if (ignoreWranglerConfig && legacyWrangler) throw new Error("--ignore-wrangler-config cannot be combined with --legacy-wrangler-cloudflare-init.");
 	if (name && platform !== "cloudflare") throw new Error("--name requires --platform=cloudflare.");
 	const explicitPrerender = parsePrerenderArg(args);
 	if (platform === "cloudflare" && platformOptions?.cdnCache === "static-assets" && explicitPrerender === false) throw new Error("--no-prerender cannot be used with --cdn-cache=static-assets, which requires build-time prerendering.");
@@ -158,6 +161,7 @@ async function resolveInitOptions(args, options = {}) {
 			...platformOptions,
 			warmCdnCache,
 			...legacyWrangler ? { legacyWrangler } : {},
+			...ignoreWranglerConfig ? { ignoreWranglerConfig } : {},
 			...prerender ? { prerender: true } : {},
 			...name ? { name } : {}
 		} : void 0

package/dist/plugins/client-compile-hints.d.ts

@@ -0,0 +1,30 @@
+import { Plugin } from "vite";
+//#region src/plugins/client-compile-hints.d.ts
+/**
+ * V8's file-level explicit compile hint (Chrome 136+). V8 compiles every
+ * function in a file that starts with this comment eagerly, on the background
+ * thread that streams the script, instead of lazily on the main thread the
+ * first time each function runs. Other engines ignore it.
+ * https://v8.dev/blog/explicit-compile-hints
+ */
+export declare const CLIENT_COMPILE_HINT = "//# allFunctionsCalledOnLoad";
+/**
+ * Marks the client chunks every page load runs with V8's compile hint.
+ *
+ * Those are the browser entry chunks and the chunks they import statically:
+ * React, React DOM, the Flight client and the vinext runtime. Hydration calls
+ * most of their functions on load, so lazy compilation only moves that work
+ * onto the main thread. Chunks reached through dynamic imports (route code,
+ * lazy client references, navigation-only modules) keep lazy compilation,
+ * since eagerly compiling code a page may never call costs time and memory.
+ *
+ * The hint has to be the first line of the file, so it is added in the last
+ * generateBundle pass, after minification and after Vite's import analysis
+ * prepends its `__vite__mapDeps` preload helper. That pass runs after Rolldown
+ * hashes file names, so `augmentChunkHash` salts the hash of every chunk that
+ * gets the hint: a hinted file never reuses the URL of an unhinted one, which
+ * browsers may hold as immutable. Its sourcemap keeps following the chunk's
+ * name, so builds that name sourcemaps themselves are left alone.
+ */
+export declare function createClientCompileHintsPlugin(isBrowserEntry: (id: string) => boolean): Plugin;
+//#endregion

package/dist/plugins/client-compile-hints.js

@@ -0,0 +1,88 @@
+//#region src/plugins/client-compile-hints.ts
+/**
+* V8's file-level explicit compile hint (Chrome 136+). V8 compiles every
+* function in a file that starts with this comment eagerly, on the background
+* thread that streams the script, instead of lazily on the main thread the
+* first time each function runs. Other engines ignore it.
+* https://v8.dev/blog/explicit-compile-hints
+*/
+const CLIENT_COMPILE_HINT = "//# allFunctionsCalledOnLoad";
+/** Shifts a sourcemap down one generated line, for a line added at the top. */
+function shiftSourceMapSource(source) {
+	const text = typeof source === "string" ? source : new TextDecoder().decode(source);
+	const map = JSON.parse(text);
+	map.mappings = ";" + map.mappings;
+	return JSON.stringify(map);
+}
+/**
+* Marks the client chunks every page load runs with V8's compile hint.
+*
+* Those are the browser entry chunks and the chunks they import statically:
+* React, React DOM, the Flight client and the vinext runtime. Hydration calls
+* most of their functions on load, so lazy compilation only moves that work
+* onto the main thread. Chunks reached through dynamic imports (route code,
+* lazy client references, navigation-only modules) keep lazy compilation,
+* since eagerly compiling code a page may never call costs time and memory.
+*
+* The hint has to be the first line of the file, so it is added in the last
+* generateBundle pass, after minification and after Vite's import analysis
+* prepends its `__vite__mapDeps` preload helper. That pass runs after Rolldown
+* hashes file names, so `augmentChunkHash` salts the hash of every chunk that
+* gets the hint: a hinted file never reuses the URL of an unhinted one, which
+* browsers may hold as immutable. Its sourcemap keeps following the chunk's
+* name, so builds that name sourcemaps themselves are left alone.
+*/
+function createClientCompileHintsPlugin(isBrowserEntry) {
+	const startupByEnvironment = /* @__PURE__ */ new WeakMap();
+	const startupChunks = (environment) => (environment && startupByEnvironment.get(environment)?.chunks) ?? void 0;
+	return {
+		name: "vinext:client-compile-hints",
+		apply: "build",
+		enforce: "post",
+		renderStart(outputOptions) {
+			const environment = this.environment;
+			if (environment?.name !== "client") return;
+			const { codeSplitting, sourcemap, sourcemapFileNames } = outputOptions;
+			if (!codeSplitting || sourcemap === "inline" || sourcemap && sourcemapFileNames !== void 0) {
+				startupByEnvironment.delete(environment);
+				return;
+			}
+			startupByEnvironment.set(environment, { chunks: null });
+		},
+		renderChunk(_code, _chunk, _options, meta) {
+			const state = this.environment && startupByEnvironment.get(this.environment);
+			if (!state || state.chunks) return null;
+			const startup = /* @__PURE__ */ new Set();
+			const pending = [];
+			for (const chunk of Object.values(meta.chunks)) if (chunk.isEntry && chunk.facadeModuleId !== null && isBrowserEntry(chunk.facadeModuleId)) pending.push(chunk.fileName);
+			for (let fileName = pending.pop(); fileName !== void 0; fileName = pending.pop()) {
+				const chunk = meta.chunks[fileName];
+				if (startup.has(fileName) || !chunk) continue;
+				startup.add(fileName);
+				pending.push(...chunk.imports);
+			}
+			state.chunks = startup;
+			return null;
+		},
+		augmentChunkHash(chunk) {
+			if (startupChunks(this.environment)?.has(chunk.fileName)) return CLIENT_COMPILE_HINT;
+		},
+		generateBundle: {
+			order: "post",
+			handler(options, bundle) {
+				const startup = startupChunks(this.environment);
+				if (!startup) return;
+				for (const chunk of Object.values(bundle)) {
+					if (chunk.type !== "chunk" || !startup.has(chunk.preliminaryFileName)) continue;
+					chunk.code = `${CLIENT_COMPILE_HINT}\n${chunk.code}`;
+					if (!options.sourcemap) continue;
+					if (chunk.map) chunk.map.mappings = ";" + chunk.map.mappings;
+					const mapAsset = chunk.sourcemapFileName ? bundle[chunk.sourcemapFileName] : void 0;
+					if (mapAsset?.type === "asset") mapAsset.source = shiftSourceMapSource(mapAsset.source);
+				}
+			}
+		}
+	};
+}
+//#endregion
+export { CLIENT_COMPILE_HINT, createClientCompileHintsPlugin };

package/dist/plugins/client-reference-dedup.d.ts

@@ -30,4 +30,5 @@ export declare function extractPackageImportSpecifier(absolutePath: string, read
  * Dev-only — production builds use the SSR manifest which handles this correctly.
  */
 export declare function clientReferenceDedupPlugin(options?: ClientReferenceDedupOptions): Plugin;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/cloudflare-dev-module-urls.d.ts

@@ -38,4 +38,5 @@ type CloudflareDevModuleUrlsOptions = {
  * @returns The Vite plugin
  */
 export declare function createCloudflareDevModuleUrlsPlugin(options: CloudflareDevModuleUrlsOptions): Plugin;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/dynamic-preload-metadata.d.ts

@@ -6,6 +6,8 @@ type TransformResult = {
   map: ReturnType<MagicString["generateMap"]>;
 };
 type ResolveDynamicImport = (specifier: string, importer: string) => Promise<string | null>;
+export declare function toManifestModuleId(root: string, resolvedId: string): string | null;
 export declare function transformNextDynamicPreloadMetadata(code: string, id: string, root: string, resolveDynamicImport: ResolveDynamicImport): Promise<TransformResult | null>;
 export declare function createDynamicPreloadMetadataPlugin(getTranspiledPackages: () => readonly string[]): Plugin;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/dynamic-preload-metadata.js

@@ -290,4 +290,4 @@ function createDynamicPreloadMetadataPlugin(getTranspiledPackages) {
 	};
 }
 //#endregion
-export { createDynamicPreloadMetadataPlugin, transformNextDynamicPreloadMetadata };
+export { createDynamicPreloadMetadataPlugin, toManifestModuleId, transformNextDynamicPreloadMetadata };

package/dist/plugins/environment.d.ts

@@ -7,4 +7,5 @@ type PluginEnvironment = {
 };
 /** Whether a Vite environment produces server-consumed output. */
 export declare function isServerEnvironment(environment: PluginEnvironment): boolean;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/extensionless-dynamic-import.js

@@ -1,5 +1,5 @@
 import path, { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
-import { escapeRegExp } from "../utils/regex.js";
+import { escapeRegExp, exactRegExpLiteral } from "../utils/regex.js";
 import { DYNAMIC_IMPORT_PRESCAN, SCRIPT_MODULE_ID_RE, parseProgram, scriptParserLanguage, walkAst } from "./ast-utils.js";
 import { isUnknownRecord } from "../utils/record.js";
 import { magicStringTransformResult } from "./transform-result.js";
@@ -219,7 +219,11 @@ function aliasesMayMatch(aliases, requestPattern) {
 	const requestPrefix = requestPattern.slice(0, requestPattern.indexOf("*"));
 	return aliases.some((alias) => {
 		const { find } = alias;
-		if (find instanceof RegExp) return !isViteInternalAlias(alias);
+		if (find instanceof RegExp) {
+			const literal = exactRegExpLiteral(find);
+			if (literal !== null) return matchesTemplatePattern(requestPattern, literal);
+			return !isViteInternalAlias(alias);
+		}
 		if (matchesTemplatePattern(requestPattern, find)) return true;
 		const aliasPrefix = `${find}/`;
 		return requestPrefix.startsWith(aliasPrefix) || aliasPrefix.startsWith(requestPrefix);

package/dist/plugins/fonts.js

@@ -74,10 +74,12 @@ const CACHED_FONT_DIR_TOKEN = "__VINEXT_FONT_CACHE_DIR__";
 * Cached stylesheet whose `url()` references use `CACHED_FONT_DIR_TOKEN`.
 * The suffix ties the cache to that format: a `style.css` written by an
 * earlier vinext holds the writing checkout's absolute paths, which would
-* 404 once embedded, so it is never read and the font is fetched again.
-* Change the suffix whenever the cached CSS format changes.
+* 404 once embedded, and a `style-q7f3kd.css` names extensionless Google
+* font URLs `.ttf` whatever their format, so neither is read and the font
+* is fetched again. Change the suffix whenever the cached CSS format
+* changes.
 */
-const CACHED_FONT_CSS_FILE = "style-q7f3kd.css";
+const CACHED_FONT_CSS_FILE = "style-h8r2vn.css";
 function formatGoogleFontsErrorBody(body) {
 	const trimmed = body.trim();
 	if (!trimmed) return "(empty response body)";
@@ -330,16 +332,11 @@ async function downloadGoogleFont(cssUrl, family, fontDir, fontDirName) {
 	}
 	let css = await cssResponse.text();
 	if (!css.trim()) throw new Error(`Google Fonts returned an empty stylesheet: ${cssUrl}`);
-	const urlRe = /url\((https:\/\/fonts\.gstatic\.com\/[^)]+)\)/g;
 	const urls = /* @__PURE__ */ new Map();
-	let urlMatch;
-	while ((urlMatch = urlRe.exec(css)) !== null) {
-		const fontUrl = urlMatch[1];
-		if (!urls.has(fontUrl)) {
-			const ext = fontUrl.includes(".woff2") ? ".woff2" : fontUrl.includes(".woff") ? ".woff" : ".ttf";
-			const fileHash = createHash("md5").update(fontUrl).digest("hex").slice(0, 8);
-			urls.set(fontUrl, `${family.toLowerCase().replace(/\s+/g, "-")}-${fileHash}${ext}`);
-		}
+	for (const { googleFontFileUrl: fontUrl, ext } of findFontFilesInCss(css)) {
+		if (!fontUrl.startsWith("https://fonts.gstatic.com/")) continue;
+		const fileHash = createHash("md5").update(fontUrl).digest("hex").slice(0, 8);
+		urls.set(fontUrl, `${family.toLowerCase().replace(/\s+/g, "-")}-${fileHash}.${ext}`);
 	}
 	fs.mkdirSync(fontDir, { recursive: true });
 	for (const [fontUrl, filename] of urls) {

package/dist/plugins/ignore-dynamic-requests.d.ts

@@ -15,4 +15,5 @@ declare function transformVeryDynamicRequests(code: string, id: string): MagicSt
 export declare function createIgnoreDynamicRequestsPlugin(getTranspiledPackages?: () => readonly string[]): Plugin;
 export declare const _transformVeryDynamicRequests: typeof transformVeryDynamicRequests;
 export declare const _mayContainVeryDynamicRequest: typeof mayContainVeryDynamicRequest;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/import-meta-url.d.ts

@@ -17,4 +17,5 @@ export declare function createImportMetaUrlPlugin(options: {
 }): ImportMetaUrlCapability;
 export declare function rewriteImportMetaUrl(code: string, id: string, root: string, environment: ImportMetaUrlEnvironment): MagicStringTransformResult | null;
 export declare function rewriteServerCjsGlobals(code: string, id: string, root: string): MagicStringTransformResult | null;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/next-intl-catalog.d.ts

@@ -0,0 +1,12 @@
+import { NextIntlCatalogLoader } from "../config/next-config.js";
+import { Plugin } from "vite";
+//#region src/plugins/next-intl-catalog.d.ts
+/**
+ * Runs next-intl's catalog loader on its `experimental.messages` catalogs, as
+ * Next.js does through the webpack/Turbopack rule `createNextIntlPlugin` adds.
+ * With `precompile: true` the plugin also aliases use-intl's formatter to one
+ * that only formats precompiled messages, so raw catalogs would render their
+ * ICU placeholders literally.
+ */
+export declare function createNextIntlCatalogPlugin(getRoot: () => string, getCatalogLoader: () => NextIntlCatalogLoader | null): Plugin;
+//#endregion

package/dist/plugins/next-intl-catalog.js

@@ -0,0 +1,85 @@
+import path, { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
+import { escapeRegExp } from "../utils/regex.js";
+import { canonicalizeFilePath, stripViteModuleQuery } from "../utils/path.js";
+import { createRequire } from "node:module";
+import fsp from "node:fs/promises";
+import { pathToFileURL } from "node:url";
+//#region src/plugins/next-intl-catalog.ts
+const SPECIAL_QUERY_RE = /[?&](?:worker|sharedworker|raw|url)\b/;
+/**
+* Runs next-intl's catalog loader on its `experimental.messages` catalogs, as
+* Next.js does through the webpack/Turbopack rule `createNextIntlPlugin` adds.
+* With `precompile: true` the plugin also aliases use-intl's formatter to one
+* that only formats precompiled messages, so raw catalogs would render their
+* ICU placeholders literally.
+*/
+function createNextIntlCatalogPlugin(getRoot, getCatalogLoader) {
+	return {
+		name: "vinext:next-intl-catalog",
+		enforce: "pre",
+		applyToEnvironment() {
+			const catalogLoader = getCatalogLoader();
+			if (!catalogLoader) return false;
+			return createCatalogLoadPlugin(getRoot(), catalogLoader);
+		}
+	};
+}
+function createCatalogLoadPlugin(root, catalogLoader) {
+	const catalogDirs = [...new Set(catalogLoader.include.flatMap((dir) => [toSlash(dir), canonicalizeFilePath(dir)]))].map((dir) => `${escapeRegExp(dir)}/`);
+	let loaderPromise;
+	return {
+		name: "vinext:next-intl-catalog",
+		load: {
+			filter: { id: new RegExp(`^(?:${catalogDirs.join("|")})`) },
+			async handler(id) {
+				if (SPECIAL_QUERY_RE.test(id)) return null;
+				const file = stripViteModuleQuery(id);
+				catalogLoader.test.lastIndex = 0;
+				if (!catalogLoader.test.test(file)) return null;
+				loaderPromise ??= importCatalogLoader(root, catalogLoader.options);
+				return {
+					code: await runLoader(await loaderPromise, await fsp.readFile(file, "utf8"), {
+						resourcePath: file,
+						rootContext: root,
+						options: catalogLoader.options
+					}),
+					moduleType: "js"
+				};
+			}
+		}
+	};
+}
+async function importCatalogLoader(root, options) {
+	const loaderPath = createRequire(path.join(root, "package.json")).resolve("next-intl/extractor/catalogLoader");
+	const url = pathToFileURL(loaderPath);
+	url.searchParams.set("vinext-config", JSON.stringify([root, options]));
+	const loaderModule = await import(url.href);
+	if (typeof loaderModule.default !== "function") throw new Error(`[vinext] ${loaderPath} does not export a webpack loader`);
+	return loaderModule.default;
+}
+function runLoader(loader, source, context) {
+	return new Promise((resolve, reject) => {
+		let isAsync = false;
+		const callback = (error, result) => {
+			if (error) reject(error);
+			else resolve(String(result));
+		};
+		try {
+			const result = loader.call({
+				resourcePath: context.resourcePath,
+				rootContext: context.rootContext,
+				getOptions: () => context.options,
+				async: () => {
+					isAsync = true;
+					return callback;
+				},
+				callback
+			}, source);
+			if (!isAsync) callback(null, result);
+		} catch (error) {
+			reject(error);
+		}
+	});
+}
+//#endregion
+export { createNextIntlCatalogPlugin };

package/dist/plugins/og-assets.d.ts

@@ -63,4 +63,5 @@ export declare function copyMissingOgWasm(opts: {
  * target — so it helps Node/self-hosted builds as well as Cloudflare Workers.
  */
 export declare function createOgAssetsPlugin(): Plugin;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/og-assets.js

@@ -37,9 +37,8 @@ function createOgInlineFetchAssetsPlugin() {
 				...options,
 				skipSelf: true
 			});
-			if (resolved === null || resolved.external) return null;
-			await ownership.recordResolvedImport(source, resolved.id);
-			return null;
+			if (resolved !== null && !resolved.external) await ownership.recordResolvedImport(source, resolved.id);
+			return options.kind === "require-call" ? null : resolved;
 		},
 		transform: {
 			filter: { code: "import.meta.url" },

package/dist/plugins/optimize-imports.d.ts

@@ -61,4 +61,5 @@ export declare function buildBarrelExportMap(entryPath: string | null, readFile:
  * @param getRoot - Returns the current project root (set by the vinext:config hook).
  */
 export declare function createOptimizeImportsPlugin(getNextConfig: () => ResolvedNextConfig | undefined, getRoot: () => string): Plugin;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/pages-node-externals.d.ts

@@ -5,6 +5,7 @@ type PagesNodeExternalsOptions = {
   getPagesDir: () => string | null;
   getAliases: () => Readonly<Record<string, string>>;
   getTsconfigAliases: () => Readonly<Record<string, string>>;
+  getTsconfigExactAliases: () => Readonly<Record<string, string>>;
   getBundledPackages: () => ReadonlySet<string>;
   isEnabled: () => boolean;
 };
@@ -19,4 +20,5 @@ type PagesNodeExternalsOptions = {
  * selected `import` export just like Turbopack.
  */
 export declare function createPagesNodeExternalsPlugin(options: PagesNodeExternalsOptions): Plugin;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/pages-node-externals.js

@@ -141,7 +141,7 @@ function createPagesNodeExternalsPlugin(options) {
 				}
 				const packageName = packageNameFromSpecifier(id);
 				if (!packageName || FRAMEWORK_PACKAGES.has(packageName) || id === "next" || id.startsWith("next/") || id.startsWith("vinext/") || id.startsWith("@vinext/") || options.getBundledPackages().has(packageName)) return null;
-				if (matchesAlias(id, options.getAliases()) || matchesAlias(id, options.getTsconfigAliases())) {
+				if (matchesAlias(id, options.getAliases()) || matchesAlias(id, options.getTsconfigAliases()) || Object.hasOwn(options.getTsconfigExactAliases(), id)) {
 					const aliased = await this.resolve(id, importer, { skipSelf: true });
 					if (aliased && !aliased.external) {
 						const aliasedFile = canonicalFile(aliased.id);

package/dist/plugins/remove-console.d.ts

@@ -16,4 +16,5 @@ type RemoveConsoleResult = {
  * Returns `null` if no console calls are removed.
  */
 export declare function removeConsoleCalls(code: string, config: RemoveConsoleConfig): RemoveConsoleResult | null;
-//#endregion
+//#endregion
+export {};

package/dist/plugins/require-condition-resolution.d.ts

@@ -12,4 +12,5 @@ export declare function isConditionalRequireScriptModuleId(id: string): boolean;
 type IdResolverFactory = typeof createIdResolver;
 type CommonJsTransformFilter = (id: string) => boolean | undefined;
 export declare function createRequireConditionResolutionPlugin(createResolver?: IdResolverFactory, commonjsTransformFilter?: CommonJsTransformFilter): Plugin;
-//#endregion
+//#endregion
+export {};