@qzsy/vinext 0.1.12 → 0.1.80

package/dist/index.js

@@ -1,10 +1,11 @@
 import { detectPackageManager } from "./utils/project.js";
-import { normalizePathSeparators, stripJsExtension, stripViteModuleQuery } from "./utils/path.js";
 import { normalizePathnameForRouteMatchStrict } from "./routing/utils.js";
 import { escapeRegExp } from "./utils/regex.js";
+import { normalizePathSeparators, stripJsExtension, stripViteModuleQuery } from "./utils/path.js";
 import { buildViteResolveExtensions, createValidFileMatcher, findFileWithExts, normalizeViteResolveExtensions } from "./routing/file-matcher.js";
 import { apiRouter, invalidateRouteCache, matchRoute, pagesRouter } from "./routing/pages-router.js";
-import { INTERNAL_HEADERS, NEXTJS_DEPLOYMENT_ID_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_MW_CTX_HEADER, VINEXT_TIMING_HEADER } from "./server/headers.js";
+import { VINEXT_MW_CTX_HEADER } from "./utils/protocol-headers.js";
+import { INTERNAL_HEADERS, NEXTJS_DEPLOYMENT_ID_HEADER, VINEXT_INTERNAL_HEADERS, VINEXT_TIMING_HEADER } from "./server/headers.js";
 import { normalizePath as normalizePath$1 } from "./server/normalize-path.js";
 import { matchesRewriteSource, proxyExternalRequest } from "./config/config-matchers.js";
 import { isOpenRedirectShaped } from "./server/open-redirect.js";
@@ -16,6 +17,8 @@ import { appRouteGraph, appRouter, invalidateAppRouteCache, matchAppRoute } from
 import { findInstrumentationClientFile, findInstrumentationFile, runInstrumentation } from "./server/instrumentation.js";
 import { isUnknownRecord } from "./utils/record.js";
 import { logRequest, now } from "./server/request-log.js";
+import { resolvePagesI18nRequest } from "./server/pages-i18n.js";
+import { isNextDataPathname, parseNextDataPathname } from "./server/pages-data-route.js";
 import { createSSRHandler } from "./server/dev-server.js";
 import { handleApiRoute } from "./server/api-handler.js";
 import { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, isImageOptimizationPath, resolveDevImageRedirect } from "./server/image-optimization.js";
@@ -27,6 +30,7 @@ import { validateDevRequest } from "./server/dev-origin-check.js";
 import { generateRscEntry } from "./entries/app-rsc-entry.js";
 import { generateSsrEntry } from "./entries/app-ssr-entry.js";
 import { VIRTUAL_CACHE_ADAPTERS, generateCacheAdaptersModule } from "./cache/cache-adapters-virtual.js";
+import { VIRTUAL_IMAGE_ADAPTERS, generateImageAdaptersModule } from "./image/image-adapters-virtual.js";
 import { generateBrowserEntry, isLinkPrefetchRoute, toDocumentOnlyAppRoute, toLinkPrefetchRoute } from "./entries/app-browser-entry.js";
 import { collectRouteClassificationManifest } from "./build/route-classification-manifest.js";
 import { planRouteClassificationInjection } from "./build/route-classification-injector.js";
@@ -35,7 +39,7 @@ import { resolveAssetsDir } from "./utils/asset-prefix.js";
 import { RESOLVED_VIRTUAL_GOOGLE_FONTS, VIRTUAL_GOOGLE_FONTS, createGoogleFontsPlugin, createLocalFontsPlugin, generateGoogleFontsVirtualModule, parseStaticObjectLiteral } from "./plugins/fonts.js";
 import { getDepOptimizeNodeEnvOptions, getViteMajorVersion, serializeViteDefine } from "./utils/vite-version.js";
 import { createRscCompatibilityId, findNextConfigPath, loadNextConfig, resolveNextConfig, resolveNextConfigInput } from "./config/next-config.js";
-import { isNextDataPathname, parseNextDataPathname } from "./server/pages-data-route.js";
+import { mergeServerExternalPackages } from "./config/server-external-packages.js";
 import { precompressAssets } from "./build/precompress.js";
 import { ensureAssetsIgnore } from "./build/assets-ignore.js";
 import { emitNextClientRuntimeManifests } from "./build/next-client-runtime-manifests.js";
@@ -48,6 +52,7 @@ import { renderVinextBuiltUrl } from "./utils/built-asset-url.js";
 import { asyncHooksStubPlugin } from "./plugins/async-hooks-stub.js";
 import { clientReferenceDedupPlugin } from "./plugins/client-reference-dedup.js";
 import { dataUrlCssPlugin } from "./plugins/css-data-url.js";
+import { createCssModuleImportCompatibilityPlugin } from "./plugins/css-module-imports.js";
 import { createRscClientReferenceLoadersPlugin } from "./plugins/rsc-client-reference-loaders.js";
 import { createInstrumentationClientTransformPlugin } from "./plugins/instrumentation-client.js";
 import { INSTRUMENTATION_CLIENT_EMPTY_MODULE, generateInstrumentationClientInjectModule } from "./client/instrumentation-client-inject.js";
@@ -60,9 +65,11 @@ import { createOgAssetsPlugin, createOgInlineFetchAssetsPlugin } from "./plugins
 import { generateRouteTypes } from "./typegen.js";
 import { SSR_EXTERNAL_REACT_ENTRIES, VINEXT_OPTIMIZE_DEPS_EXCLUDE, mergeOptimizeDepsExclude } from "./plugins/rsc-client-shim-excludes.js";
 import { createServerExternalsManifestPlugin } from "./plugins/server-externals-manifest.js";
+import { hasWranglerConfig } from "./cloudflare/project.js";
+import { formatMissingCloudflarePluginError } from "./cloudflare/deploy-config.js";
 import { VINEXT_CLIENT_ENTRY_MANIFEST } from "./utils/client-entry-manifest.js";
-import { buildRuntimeGlobalsScript, computeClientRuntimeMetadata } from "./utils/client-runtime-metadata.js";
-import { formatMissingCloudflarePluginError, hasWranglerConfig } from "./deploy.js";
+import { computeClientRuntimeMetadata } from "./utils/client-runtime-metadata.js";
+import { PAGES_CLIENT_ASSETS_MODULE, buildPagesClientAssetsModule, setPagesClientAssetsBuildMetadata, takePagesClientAssetsBuildMetadata, writePagesClientAssetsModuleIfMissing } from "./build/pages-client-assets-module.js";
 import { resolvePostcssStringPlugins } from "./plugins/postcss.js";
 import { buildSassPreprocessorOptions, createSassAwareFileSystemLoader, createSassTildeImporter } from "./plugins/sass.js";
 import { createClientAssetFileNames, createClientCodeSplittingConfig, createClientFileNameConfig, createClientManualChunks, createClientOutputConfig, createRscFrameworkChunkOutputConfig, getBuildBundlerOptions, getClientTreeshakeConfigForVite, withBuildBundlerOptions } from "./build/client-build-config.js";
@@ -76,6 +83,7 @@ import { createWasmModuleImportPlugin } from "./plugins/wasm-module-import.js";
 import { getTypeofWindowReplacement, replaceTypeofWindow } from "./plugins/typeof-window.js";
 import { hasMdxFiles } from "./utils/mdx-scan.js";
 import { scanPublicFileRoutes } from "./utils/public-routes.js";
+import { createIgnoreDynamicRequestsPlugin } from "./plugins/ignore-dynamic-requests.js";
 import { staticExportApp, staticExportPages } from "./build/static-export.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
@@ -301,6 +309,8 @@ const VIRTUAL_SERVER_ENTRY = "virtual:vinext-server-entry";
 const RESOLVED_SERVER_ENTRY = "\0virtual:vinext-server-entry";
 const VIRTUAL_CLIENT_ENTRY = "virtual:vinext-client-entry";
 const RESOLVED_CLIENT_ENTRY = "\0virtual:vinext-client-entry";
+const VIRTUAL_PAGES_CLIENT_ASSETS = "virtual:vinext-pages-client-assets";
+const RESOLVED_PAGES_CLIENT_ASSETS = "\0virtual:vinext-pages-client-assets";
 const VIRTUAL_RSC_ENTRY = "virtual:vinext-rsc-entry";
 const RESOLVED_RSC_ENTRY = "\0virtual:vinext-rsc-entry";
 const VIRTUAL_APP_SSR_ENTRY = "virtual:vinext-app-ssr-entry";
@@ -312,6 +322,8 @@ const RESOLVED_APP_CAPABILITIES = "\0virtual:vinext-app-capabilities";
 const RESOLVED_ROOT_PARAMS = "\0virtual:vinext-root-params";
 /** Virtual module that registers config-driven cache adapters (see VinextOptions.cache). */
 const RESOLVED_CACHE_ADAPTERS = "\0" + VIRTUAL_CACHE_ADAPTERS;
+/** Virtual module that registers the config-driven image optimizer (see VinextOptions.images). */
+const RESOLVED_IMAGE_ADAPTERS = "\0" + VIRTUAL_IMAGE_ADAPTERS;
 /** Virtual module for composed instrumentation-client bootstrap. */
 const VIRTUAL_INSTRUMENTATION_CLIENT = "private-next-instrumentation-client";
 const RESOLVED_INSTRUMENTATION_CLIENT = `${VIRTUAL_INSTRUMENTATION_CLIENT}.mjs`;
@@ -337,9 +349,11 @@ function createStaticImageAsset(imagePath) {
 * the `id.startsWith(_shimsDir)` checks would never match.
 */
 const _shimsDir = normalizePathSeparators(path.resolve(__dirname, "shims")) + "/";
+const _serverDir = normalizePathSeparators(path.resolve(__dirname, "server"));
 const _fontGoogleShimPath = resolveShimModulePath(_shimsDir, "font-google");
-const _appBrowserServerActionClientPath = resolveShimModulePath(normalizePathSeparators(path.resolve(__dirname, "server")), "app-browser-server-action-client");
-const _appRscHandlerPath = resolveShimModulePath(normalizePathSeparators(path.resolve(__dirname, "server")), "app-rsc-handler");
+const _appBrowserServerActionClientPath = resolveShimModulePath(_serverDir, "app-browser-server-action-client");
+const _appRscHandlerPath = resolveShimModulePath(_serverDir, "app-rsc-handler");
+const _pagesClientAssetsPath = resolveShimModulePath(_serverDir, "pages-client-assets");
 const _canExternalizeAppRscHandler = _appRscHandlerPath.endsWith(".js");
 const _defaultImageLoaderShimPath = resolveShimModulePath(_shimsDir, "default-image-loader");
 /** Absolute path to `images.loaderFile` when configured; set in vinext:config. */
@@ -472,6 +486,8 @@ function vinext(options = {}) {
 	let hasCloudflarePlugin = false;
 	let warnedInlineNextConfigOverride = false;
 	let hasNitroPlugin = false;
+	const pagesClientAssetsOutputDirs = /* @__PURE__ */ new Set();
+	let pagesClientAssetsModule = null;
 	let rscCompatibilityId;
 	const draftModeSecret = randomUUID();
 	const sassComposesLoader = createSassAwareFileSystemLoader();
@@ -517,7 +533,8 @@ function vinext(options = {}) {
 		const appPrefetchRoutes = hasAppDir ? (await appRouter(appDir, nextConfig?.pageExtensions, fileMatcher)).map((route) => isLinkPrefetchRoute(route) ? toLinkPrefetchRoute(route) : toDocumentOnlyAppRoute(route)) : [];
 		return generateClientEntry(pagesDir, nextConfig, fileMatcher, {
 			appPrefetchRoutes,
-			instrumentationClientPath
+			instrumentationClientPath,
+			reactPreamble: options.react !== false
 		});
 	}
 	async function writeRouteTypes() {
@@ -608,6 +625,7 @@ function vinext(options = {}) {
 	const plugins = [
 		...viteMajorVersion >= 8 ? [] : [loadVite7TsconfigPathsPlugin(earlyBaseDir)],
 		reactPluginPromise,
+		createIgnoreDynamicRequestsPlugin(() => nextConfig?.turbopackTranspilePackages ?? []),
 		commonjs(),
 		...viteMajorVersion >= 8 ? [{
 			name: "vinext:jsx-in-js",
@@ -636,9 +654,14 @@ function vinext(options = {}) {
 		createMiddlewareServerOnlyPlugin({
 			getMiddlewarePath: () => middlewarePath,
 			getCanonicalMiddlewarePath: () => middlewarePath ? tryRealpathSync(middlewarePath) ?? middlewarePath : null,
+			isNeutralServerModule: (id) => {
+				const canonicalId = canonicalizePageTransformPath(id);
+				return isWithinPagesDirectory(canonicalId) && isApiPage(canonicalId);
+			},
 			serverOnlyShimPath: resolveShimModulePath(shimsDir, "server-only")
 		}),
 		dataUrlCssPlugin(),
+		createCssModuleImportCompatibilityPlugin(),
 		{
 			name: "vinext:image-loader-file",
 			enforce: "pre",
@@ -758,6 +781,7 @@ function vinext(options = {}) {
 				defines["process.env.__VINEXT_IMAGE_DANGEROUSLY_ALLOW_SVG"] = JSON.stringify(String(nextConfig.images?.dangerouslyAllowSVG ?? false));
 				defines["process.env.__VINEXT_IMAGE_DANGEROUSLY_ALLOW_LOCAL_IP"] = JSON.stringify(String(nextConfig.images?.dangerouslyAllowLocalIP ?? false));
 				defines["process.env.__VINEXT_IMAGE_LOADER_CONFIGURED"] = JSON.stringify(nextConfig.images?.loaderFile ? "true" : "false");
+				defines["process.env.__VINEXT_IMAGE_UNOPTIMIZED"] = JSON.stringify(String(nextConfig.images?.unoptimized === true));
 				defines["process.env.__VINEXT_BUILD_ID"] = JSON.stringify(nextConfig.buildId);
 				defines["process.env.__VINEXT_RSC_COMPATIBILITY_ID"] = JSON.stringify(rscCompatibilityId);
 				defines["process.env.__VINEXT_DEPLOYMENT_ID"] = JSON.stringify(nextConfig.deploymentId ?? "");
@@ -824,7 +848,7 @@ function vinext(options = {}) {
 					"vinext/cache": path.resolve(__dirname, "cache"),
 					"vinext/instrumentation": path.resolve(__dirname, "server", "instrumentation"),
 					"vinext/instrumentation-client": path.resolve(__dirname, "client", "instrumentation-client"),
-					"vinext/dev-error-overlay": path.resolve(__dirname, "server", "dev-error-overlay"),
+					"vinext/dev-error-overlay": path.resolve(__dirname, "client", "dev-error-overlay"),
 					"vinext/html": path.resolve(__dirname, "server", "html"),
 					...clientInjectModule === null ? { "private-next-instrumentation-client": instrumentationClientPath ?? INSTRUMENTATION_CLIENT_EMPTY_MODULE } : {}
 				}).flatMap(([k, v]) => k.startsWith("next/") ? [[k, v], [`${k}.js`, v]] : [[k, v]]));
@@ -842,6 +866,8 @@ function vinext(options = {}) {
 				hasUserMdxPlugin = pluginsFlat.some((p) => p && typeof p === "object" && "name" in p && typeof p.name === "string" && (p.name === "@mdx-js/rollup" || p.name === "mdx"));
 				if (!hasUserMdxPlugin && hasMdxFiles(root, hasAppDir ? appDir : null, hasPagesDir ? pagesDir : null)) await ensureMdxDelegate("detected");
 				const isSSR = !!config.build?.ssr;
+				const serverTranspilePackages = [...nextConfig?.turbopackTranspilePackages ?? [], ...nextConfig?.optimizePackageImports ?? []];
+				const nextServerExternal = mergeServerExternalPackages(nextConfig?.serverExternalPackages, serverTranspilePackages);
 				const isMultiEnv = hasAppDir || hasCloudflarePlugin || hasNitroPlugin;
 				const hasBuildInput = getBuildBundlerOptions(config.build)?.input !== void 0;
 				const shouldInjectPlainPagesEnvironments = !hasAppDir && !hasCloudflarePlugin && !isSSR && !hasBuildInput;
@@ -893,7 +919,9 @@ function vinext(options = {}) {
 							"react",
 							"react-dom",
 							"react-dom/server",
-							"ipaddr.js"
+							"ipaddr.js",
+							...Array.isArray(config.ssr?.external) ? config.ssr.external : [],
+							...nextServerExternal
 						],
 						noExternal: true
 					} },
@@ -901,7 +929,8 @@ function vinext(options = {}) {
 						alias: {
 							...tsconfigPathAliases,
 							...nextConfig.aliases,
-							...nextShimMap
+							...nextShimMap,
+							"vinext/server/pages-client-assets": _pagesClientAssetsPath
 						},
 						dedupe: [
 							"react",
@@ -938,7 +967,6 @@ function vinext(options = {}) {
 						...cssModulesOverride
 					}
 				};
-				const nextServerExternal = nextConfig?.serverExternalPackages ?? [];
 				const userSsrExternal = Array.isArray(config.ssr?.external) ? [...config.ssr.external, ...nextServerExternal] : config.ssr?.external === true ? true : nextServerExternal;
 				const externalizeSsrReactInDev = env.command === "serve" && !hasCloudflarePlugin && !hasNitroPlugin;
 				const incomingExclude = config.optimizeDeps?.exclude ?? [];
@@ -1075,7 +1103,8 @@ function vinext(options = {}) {
 								"react",
 								"react-dom",
 								"react-dom/server",
-								"ipaddr.js"
+								"ipaddr.js",
+								...nextServerExternal
 							],
 							noExternal: true
 						},
@@ -1146,7 +1175,7 @@ function vinext(options = {}) {
 			resolveId: {
 				filter: { id: /(?:next\/|vinext\/(?:shims\/|server\/app-rsc-handler)|virtual:vinext-|@vercel\/og(?:\.js)?$)/ },
 				handler(id, importer) {
-					const cleanId = id.startsWith("\0") ? id.slice(1) : id;
+					const cleanId = normalizePathSeparators(id.startsWith("\0") ? id.slice(1) : id);
 					if (cleanId === "vinext/server/app-rsc-handler") {
 						if (_canExternalizeAppRscHandler && this.environment?.name === "rsc" && this.environment.config?.command === "serve") return {
 							id: _appRscHandlerPath,
@@ -1158,19 +1187,20 @@ function vinext(options = {}) {
 					if (cleanId.startsWith("vinext/shims/")) return resolveShimModulePath(_shimsDir, stripJsExtension(stripViteModuleQuery(cleanId.slice(13))));
 					if (cleanId === VIRTUAL_SERVER_ENTRY) return RESOLVED_SERVER_ENTRY;
 					if (cleanId === VIRTUAL_CLIENT_ENTRY) return RESOLVED_CLIENT_ENTRY;
-					if (cleanId.endsWith("/virtual:vinext-server-entry") || cleanId.endsWith("\\virtual:vinext-server-entry")) return RESOLVED_SERVER_ENTRY;
-					if (cleanId.endsWith("/virtual:vinext-client-entry") || cleanId.endsWith("\\virtual:vinext-client-entry")) return RESOLVED_CLIENT_ENTRY;
+					if (cleanId.endsWith("/virtual:vinext-server-entry")) return RESOLVED_SERVER_ENTRY;
+					if (cleanId.endsWith("/virtual:vinext-client-entry")) return RESOLVED_CLIENT_ENTRY;
 					if (cleanId === VIRTUAL_RSC_ENTRY) return RESOLVED_RSC_ENTRY;
 					if (cleanId === VIRTUAL_APP_SSR_ENTRY) return RESOLVED_APP_SSR_ENTRY;
 					if (cleanId === VIRTUAL_APP_BROWSER_ENTRY) return RESOLVED_APP_BROWSER_ENTRY;
 					if (cleanId === VIRTUAL_APP_CAPABILITIES) return RESOLVED_APP_CAPABILITIES;
 					if (cleanId === "next/root-params" || cleanId === "next/root-params.js") return RESOLVED_ROOT_PARAMS;
-					if (cleanId === "virtual:vinext-cache-adapters" || cleanId.endsWith("/virtual:vinext-cache-adapters") || cleanId.endsWith("\\virtual:vinext-cache-adapters")) return RESOLVED_CACHE_ADAPTERS;
+					if (cleanId === "virtual:vinext-cache-adapters" || cleanId.endsWith("/virtual:vinext-cache-adapters")) return RESOLVED_CACHE_ADAPTERS;
+					if (cleanId === "virtual:vinext-image-adapters" || cleanId.endsWith("/virtual:vinext-image-adapters")) return RESOLVED_IMAGE_ADAPTERS;
 					if (cleanId.startsWith("virtual:vinext-google-fonts?")) return RESOLVED_VIRTUAL_GOOGLE_FONTS + cleanId.slice(VIRTUAL_GOOGLE_FONTS.length);
-					if (cleanId.endsWith("/virtual:vinext-rsc-entry") || cleanId.endsWith("\\virtual:vinext-rsc-entry")) return RESOLVED_RSC_ENTRY;
-					if (cleanId.endsWith("/virtual:vinext-app-ssr-entry") || cleanId.endsWith("\\virtual:vinext-app-ssr-entry")) return RESOLVED_APP_SSR_ENTRY;
-					if (cleanId.endsWith("/virtual:vinext-app-browser-entry") || cleanId.endsWith("\\virtual:vinext-app-browser-entry")) return RESOLVED_APP_BROWSER_ENTRY;
-					if (cleanId.includes("/virtual:vinext-google-fonts?") || cleanId.includes("\\virtual:vinext-google-fonts?")) {
+					if (cleanId.endsWith("/virtual:vinext-rsc-entry")) return RESOLVED_RSC_ENTRY;
+					if (cleanId.endsWith("/virtual:vinext-app-ssr-entry")) return RESOLVED_APP_SSR_ENTRY;
+					if (cleanId.endsWith("/virtual:vinext-app-browser-entry")) return RESOLVED_APP_BROWSER_ENTRY;
+					if (cleanId.includes("/virtual:vinext-google-fonts?")) {
 						const queryIndex = cleanId.indexOf(VIRTUAL_GOOGLE_FONTS + "?");
 						return RESOLVED_VIRTUAL_GOOGLE_FONTS + cleanId.slice(queryIndex + VIRTUAL_GOOGLE_FONTS.length);
 					}
@@ -1181,12 +1211,13 @@ function vinext(options = {}) {
 			async load(id) {
 				if (id === RESOLVED_SERVER_ENTRY) return await generateServerEntry$1();
 				if (id === RESOLVED_CLIENT_ENTRY) return await generateClientEntry$1();
+				if (id === RESOLVED_PAGES_CLIENT_ASSETS) return "export default { clientEntry: '/@id/__x00__virtual:vinext-client-entry' };";
 				if (id === RESOLVED_RSC_ENTRY && hasAppDir) {
 					const routes = await appRouter(appDir, nextConfig?.pageExtensions, fileMatcher);
 					const metaRoutes = scanMetadataFiles(appDir);
 					const hasServerActions = await resolveHasServerActions(this.environment.config);
 					const globalErrorPath = findFileWithExts(appDir, "global-error", fileMatcher);
-					const globalNotFoundPath = findFileWithExts(appDir, "global-not-found", fileMatcher);
+					const globalNotFoundPath = nextConfig?.globalNotFound ? findFileWithExts(appDir, "global-not-found", fileMatcher) : null;
 					rscClassificationManifest = collectRouteClassificationManifest(routes);
 					return generateRscEntry(appDir, routes, middlewarePath, metaRoutes, globalErrorPath, nextConfig?.basePath, nextConfig?.trailingSlash, {
 						redirects: nextConfig?.redirects,
@@ -1203,13 +1234,18 @@ function vinext(options = {}) {
 						reactMaxHeadersLength: nextConfig?.reactMaxHeadersLength,
 						cacheMaxMemorySize: nextConfig?.cacheMaxMemorySize,
 						inlineCss: nextConfig?.inlineCss,
+						globalNotFound: nextConfig?.globalNotFound,
 						cacheComponents: nextConfig?.cacheComponents,
 						hasServerActions,
 						i18n: nextConfig?.i18n,
 						imageConfig: {
 							deviceSizes: nextConfig?.images?.deviceSizes,
 							imageSizes: nextConfig?.images?.imageSizes,
-							qualities: nextConfig?.images?.qualities
+							qualities: nextConfig?.images?.qualities,
+							dangerouslyAllowSVG: nextConfig?.images?.dangerouslyAllowSVG,
+							dangerouslyAllowLocalIP: nextConfig?.images?.dangerouslyAllowLocalIP,
+							contentDispositionType: nextConfig?.images?.contentDispositionType,
+							contentSecurityPolicy: nextConfig?.images?.contentSecurityPolicy
 						},
 						hasPagesDir,
 						publicFiles: scanPublicFileRoutes(root),
@@ -1219,6 +1255,7 @@ function vinext(options = {}) {
 				}
 				if (id === RESOLVED_ROOT_PARAMS) return generateRootParamsModule((hasAppDir ? await appRouter(appDir, nextConfig?.pageExtensions, fileMatcher) : []).flatMap((route) => route.rootParamNames ?? []));
 				if (id === RESOLVED_CACHE_ADAPTERS) return generateCacheAdaptersModule(options.cache);
+				if (id === RESOLVED_IMAGE_ADAPTERS) return generateImageAdaptersModule(options.images);
 				if (id === RESOLVED_APP_SSR_ENTRY && hasAppDir) return generateSsrEntry(hasPagesDir);
 				if (id === RESOLVED_APP_BROWSER_ENTRY && hasAppDir) {
 					const graph = await appRouteGraph(appDir, nextConfig?.pageExtensions, fileMatcher);
@@ -1278,6 +1315,28 @@ export const loadServerActionClient = ${hasServerActions ? `() => import(${JSON.
 				}
 			}
 		},
+		{
+			name: "vinext:pages-client-assets-resolver",
+			sharedDuringBuild: true,
+			resolveId: {
+				filter: { id: /virtual:vinext-pages-client-assets$/ },
+				handler(id) {
+					const cleanId = normalizePathSeparators(id.startsWith("\0") ? id.slice(1) : id);
+					if (cleanId !== VIRTUAL_PAGES_CLIENT_ASSETS && !cleanId.endsWith("/virtual:vinext-pages-client-assets")) return;
+					if (this.environment?.config.command !== "build") return RESOLVED_PAGES_CLIENT_ASSETS;
+					const buildRoot = this.environment.config.root ?? process.cwd();
+					const environmentOutDir = path.resolve(buildRoot, this.environment.config.build.outDir);
+					const sidecarDir = !hasAppDir && this.environment.name === "ssr" ? path.dirname(environmentOutDir) : environmentOutDir;
+					let externalId = normalizePathSeparators(path.relative(environmentOutDir, path.join(sidecarDir, PAGES_CLIENT_ASSETS_MODULE)));
+					if (!externalId.startsWith(".")) externalId = `./${externalId}`;
+					pagesClientAssetsOutputDirs.add(sidecarDir);
+					return {
+						id: externalId,
+						external: true
+					};
+				}
+			}
+		},
 		{
 			name: "vinext:css-url-assets-mark",
 			enforce: "pre",
@@ -1298,11 +1357,14 @@ export const loadServerActionClient = ${hasServerActions ? `() => import(${JSON.
 			}
 		},
 		{
-			name: "vinext:client-css-url-assets-defaults",
+			name: "vinext:css-url-assets-defaults",
 			apply: "build",
-			configEnvironment(name) {
-				if (name !== "client") return null;
-				return { build: { assetsInlineLimit: clientAssetsInlineLimit } };
+			configEnvironment(name, config) {
+				if (name === "client") return { build: { assetsInlineLimit: clientAssetsInlineLimit } };
+				if (!hasAppDir || name !== "rsc" && name !== "ssr") return null;
+				const output = getBuildBundlerOptions(config.build)?.output;
+				if (Array.isArray(output) || output?.assetFileNames !== void 0) return null;
+				return { build: { ...withBuildBundlerOptions(viteMajorVersion, { output: { assetFileNames: createClientAssetFileNames(resolveAssetsDir(nextConfig.assetPrefix ?? "")) } }) } };
 			}
 		},
 		{
@@ -1385,6 +1447,7 @@ export const loadServerActionClient = ${hasServerActions ? `() => import(${JSON.
 				}
 			}
 		},
+		createCssModuleImportCompatibilityPlugin({ compiledMdx: true }),
 		{
 			name: "vinext:react-canary",
 			enforce: "pre",
@@ -1844,11 +1907,15 @@ export const loadServerActionClient = ${hasServerActions ? `() => import(${JSON.
 								hadBasePath: true,
 								isDataReq,
 								isDataRequest,
+								hasMiddleware: capturedMiddlewarePath !== null,
 								rawSearch: url.includes("?") ? url.slice(url.indexOf("?")) : "",
 								runMiddleware: devRunMiddlewareAdapter,
-								matchPageRoute: (resolvedPathname) => {
-									const m = matchRoute(resolvedPathname, devPageRoutes);
-									return m ? { route: { isDynamic: m.route.isDynamic } } : null;
+								matchPageRoute: (resolvedPathname, request) => {
+									const m = matchRoute(nextConfig?.i18n ? resolvePagesI18nRequest(resolvedPathname, nextConfig.i18n, request.headers, new URL(request.url).hostname, bp, nextConfig.trailingSlash ?? false).url : resolvedPathname, devPageRoutes);
+									return m ? { route: {
+										isDynamic: m.route.isDynamic,
+										pattern: m.route.pattern
+									} } : null;
 								},
 								proxyExternal: async (currentRequest, externalUrl) => {
 									const externalMethod = req.method ?? "GET";
@@ -2035,7 +2102,7 @@ export const loadServerActionClient = ${hasServerActions ? `() => import(${JSON.
 				handler(code, id) {
 					const cacheDirPrefix = getCacheDirPrefix(this.environment.config.cacheDir);
 					if (normalizePathSeparators(id).startsWith(cacheDirPrefix)) return null;
-					return replaceTypeofWindow(code, getTypeofWindowReplacement(this.environment));
+					return replaceTypeofWindow(code, getTypeofWindowReplacement(this.environment), id);
 				}
 			}
 		},
@@ -2289,29 +2356,6 @@ export const loadServerActionClient = ${hasServerActions ? `() => import(${JSON.
 		createOgInlineFetchAssetsPlugin(),
 		createOgAssetsPlugin(),
 		createServerExternalsManifestPlugin(),
-		{
-			name: "vinext:image-config",
-			apply: "build",
-			enforce: "post",
-			writeBundle: {
-				sequential: true,
-				order: "post",
-				handler(options) {
-					if (this.environment?.name !== "rsc") return;
-					const outDir = options.dir;
-					if (!outDir) return;
-					const imageConfig = {
-						deviceSizes: nextConfig?.images?.deviceSizes,
-						imageSizes: nextConfig?.images?.imageSizes,
-						qualities: nextConfig?.images?.qualities,
-						dangerouslyAllowSVG: nextConfig?.images?.dangerouslyAllowSVG,
-						contentDispositionType: nextConfig?.images?.contentDispositionType,
-						contentSecurityPolicy: nextConfig?.images?.contentSecurityPolicy
-					};
-					fs.writeFileSync(path.join(outDir, "image-config.json"), JSON.stringify(imageConfig));
-				}
-			}
-		},
 		(() => {
 			let buildIdWritten = false;
 			return {
@@ -2484,6 +2528,65 @@ export const loadServerActionClient = ${hasServerActions ? `() => import(${JSON.
 				}
 			};
 		})(),
+		{
+			name: "vinext:pages-client-assets",
+			apply: "build",
+			enforce: "post",
+			sharedDuringBuild: true,
+			closeBundle: {
+				sequential: true,
+				order: "post",
+				handler() {
+					const envConfig = this.environment.config;
+					if (this.environment.name === "client") {
+						const buildRoot = envConfig.root ?? process.cwd();
+						const clientDir = path.resolve(buildRoot, envConfig.build.outDir);
+						const runtimeMetadata = computeClientRuntimeMetadata({
+							clientDir,
+							assetBase: envConfig.base ?? "/",
+							assetPrefix: nextConfig.assetPrefix,
+							includeClientEntry: !hasAppDir ? true : hasPagesDir ? "pages-client-entry" : false
+						});
+						let ssrManifest;
+						const ssrManifestPath = path.join(clientDir, ".vite", "ssr-manifest.json");
+						if (fs.existsSync(ssrManifestPath)) try {
+							ssrManifest = JSON.parse(fs.readFileSync(ssrManifestPath, "utf-8"));
+						} catch {}
+						pagesClientAssetsModule = buildPagesClientAssetsModule({
+							clientEntry: runtimeMetadata.clientEntryFile ?? void 0,
+							appBootstrapPreinitModules: runtimeMetadata.appBootstrapPreinitModules,
+							ssrManifest,
+							lazyChunks: runtimeMetadata.lazyChunks ?? void 0,
+							dynamicPreloads: runtimeMetadata.dynamicPreloads ?? void 0
+						});
+						const buildSession = process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION;
+						if (hasAppDir && hasPagesDir && buildSession) setPagesClientAssetsBuildMetadata(buildSession, pagesClientAssetsModule);
+					}
+					if (pagesClientAssetsModule === null) {
+						if (pagesClientAssetsOutputDirs.size === 0) return;
+						const buildSession = process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION;
+						if (buildSession) pagesClientAssetsModule = takePagesClientAssetsBuildMetadata(buildSession);
+					}
+					if (pagesClientAssetsModule === null) {
+						const emptyModule = buildPagesClientAssetsModule({});
+						for (const outputDir of pagesClientAssetsOutputDirs) writePagesClientAssetsModuleIfMissing(outputDir, emptyModule);
+						return;
+					}
+					for (const outputDir of pagesClientAssetsOutputDirs) {
+						fs.mkdirSync(outputDir, { recursive: true });
+						fs.writeFileSync(path.join(outputDir, PAGES_CLIENT_ASSETS_MODULE), pagesClientAssetsModule);
+					}
+				}
+			},
+			buildApp() {
+				if (pagesClientAssetsModule === null) return Promise.resolve();
+				for (const outputDir of pagesClientAssetsOutputDirs) {
+					fs.mkdirSync(outputDir, { recursive: true });
+					fs.writeFileSync(path.join(outputDir, PAGES_CLIENT_ASSETS_MODULE), pagesClientAssetsModule);
+				}
+				return Promise.resolve();
+			}
+		},
 		{
 			name: "vinext:inline-css-manifest",
 			apply: "build",
@@ -2517,61 +2620,7 @@ export const loadServerActionClient = ${hasServerActions ? `() => import(${JSON.
 					const envConfig = this.environment?.config;
 					if (!envConfig) return;
 					const buildRoot = envConfig.root ?? process.cwd();
-					const distDir = path.resolve(buildRoot, "dist");
-					if (!fs.existsSync(distDir)) return;
-					const clientDir = path.resolve(buildRoot, "dist", "client");
-					const runtimeMetadata = computeClientRuntimeMetadata({
-						clientDir,
-						assetBase: envConfig.base ?? "/",
-						assetPrefix: nextConfig.assetPrefix,
-						includeClientEntry: !hasAppDir ? true : hasPagesDir ? "pages-client-entry" : false
-					});
-					const lazyChunksData = runtimeMetadata.lazyChunks ?? null;
-					const dynamicPreloadsData = runtimeMetadata.dynamicPreloads ?? null;
-					let clientEntryFile = runtimeMetadata.clientEntryFile ?? null;
-					let ssrManifestData = null;
-					const ssrManifestPath = path.join(clientDir, ".vite", "ssr-manifest.json");
-					if (fs.existsSync(ssrManifestPath)) try {
-						ssrManifestData = JSON.parse(fs.readFileSync(ssrManifestPath, "utf-8"));
-					} catch {}
-					if (hasAppDir) {
-						const workerEntry = path.resolve(distDir, "server", "index.js");
-						if (fs.existsSync(workerEntry)) {
-							const script = buildRuntimeGlobalsScript({
-								clientEntryFile,
-								ssrManifest: ssrManifestData,
-								lazyChunks: lazyChunksData,
-								dynamicPreloads: dynamicPreloadsData
-							});
-							if (script) {
-								const code = fs.readFileSync(workerEntry, "utf-8");
-								fs.writeFileSync(workerEntry, script + "\n" + code);
-							}
-						}
-					} else {
-						let workerOutDir = null;
-						for (const entry of fs.readdirSync(distDir)) {
-							const candidate = path.join(distDir, entry);
-							if (entry === "client") continue;
-							if (fs.statSync(candidate).isDirectory() && fs.existsSync(path.join(candidate, "wrangler.json"))) {
-								workerOutDir = candidate;
-								break;
-							}
-						}
-						if (!workerOutDir) return;
-						const workerEntry = path.join(workerOutDir, "index.js");
-						if (!fs.existsSync(workerEntry)) return;
-						const script = buildRuntimeGlobalsScript({
-							clientEntryFile,
-							ssrManifest: ssrManifestData,
-							lazyChunks: lazyChunksData,
-							dynamicPreloads: dynamicPreloadsData
-						});
-						if (script) {
-							const code = fs.readFileSync(workerEntry, "utf-8");
-							fs.writeFileSync(workerEntry, script + "\n" + code);
-						}
-					}
+					const clientDir = path.resolve(buildRoot, envConfig.build.outDir);
 					const headersPath = path.join(clientDir, "_headers");
 					if (!fs.existsSync(headersPath)) {
 						const headersContent = [

package/dist/init-cloudflare.d.ts

@@ -0,0 +1,43 @@
+import { CloudflareInitOptions } from "./init-platform.js";
+
+//#region src/init-cloudflare.d.ts
+type CloudflareProjectInfo = {
+  root: string;
+  projectName: string;
+  isAppRouter: boolean;
+  hasISR: boolean;
+  hasMDX: boolean;
+  nativeModulesToStub: string[];
+};
+type CloudflarePlatformSetupContext = {
+  root: string;
+  isAppRouter: boolean;
+  existingViteConfigPath?: string;
+  today?: string;
+};
+type CloudflarePlatformSetupResult = {
+  generatedViteConfig: boolean;
+  skippedViteConfig: boolean;
+  generatedPlatformFiles: string[];
+  nextSteps: string[];
+};
+declare function validateCloudflarePlatformSetup(context: CloudflarePlatformSetupContext, cloudflare: CloudflareInitOptions): void;
+declare function setupCloudflarePlatform(context: CloudflarePlatformSetupContext, cloudflare: CloudflareInitOptions): CloudflarePlatformSetupResult;
+declare function generateWranglerConfig(info: CloudflareProjectInfo, options?: CloudflareInitOptions, today?: string): string;
+declare function updateWranglerConfigForCloudflare(code: string, options: CloudflareInitOptions): string;
+declare function getWranglerImagesBinding(code: string): string;
+/** Generate worker/index.ts for Pages Router */
+declare function generatePagesRouterWorkerEntry(): string;
+/** Generate vite.config.ts for App Router */
+declare function generateAppRouterViteConfig(info?: CloudflareProjectInfo, options?: CloudflareInitOptions, imagesBinding?: string): string;
+/** Generate vite.config.ts for Pages Router */
+declare function generatePagesRouterViteConfig(info?: CloudflareProjectInfo, options?: CloudflareInitOptions, imagesBinding?: string): string;
+declare function updateViteConfigForCloudflare(filePath: string, code: string, options: {
+  isAppRouter: boolean;
+  nativeModulesToStub: string[];
+  cache?: CloudflareInitOptions;
+  imagesBinding?: string;
+}): string;
+declare function usesCommonJsViteConfig(filePath: string, code: string): boolean;
+//#endregion
+export { CloudflarePlatformSetupContext, CloudflarePlatformSetupResult, CloudflareProjectInfo, generateAppRouterViteConfig, generatePagesRouterViteConfig, generatePagesRouterWorkerEntry, generateWranglerConfig, getWranglerImagesBinding, setupCloudflarePlatform, updateViteConfigForCloudflare, updateWranglerConfigForCloudflare, usesCommonJsViteConfig, validateCloudflarePlatformSetup };