vinext 0.2.1 → 1.0.0-beta.1

package/dist/cli.js

@@ -1,29 +1,28 @@
 #!/usr/bin/env node
+import path, { toSlash } from "./deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { detectPackageManager, ensureViteConfigCompatibility, hasAppDir, hasViteConfig } from "./utils/project.js";
-import { normalizePathSeparators } from "./utils/path.js";
 import { formatReport, runCheck } from "./check.js";
 import { parseArgs } from "./cli-args.js";
 import { createDevServerConfigPlugin, normalizeDevServerHostname } from "./cli-dev-config.js";
 import { PHASE_PRODUCTION_BUILD } from "./shims/constants.js";
-import { createRscCompatibilityId, loadNextConfig, resolveNextConfig } from "./config/next-config.js";
+import { createRscCompatibilityId, findVinextNextConfigInPlugins, loadNextConfig, resolveNextConfig, resolveNextConfigInput } from "./config/next-config.js";
 import { generateRouteTypes } from "./typegen.js";
 import { clearPagesClientAssetsBuildMetadata } from "./build/pages-client-assets-module.js";
-import { findVinextPrerenderConfigInPlugins, formatVinextPrerenderLabel, resolveVinextPrerenderDecision } from "./config/prerender.js";
+import { runWithPreviewBuildCredentials } from "./build/preview-credentials.js";
+import { findVinextPrerenderConfigInPlugins, findVinextRouteRootConfigInPlugins, formatVinextPrerenderLabel, resolveVinextPrerenderDecision } from "./config/prerender.js";
 import vinext from "./index.js";
 import { runPrerender } from "./build/run-prerender.js";
-import { loadDotenv } from "./config/dotenv.js";
-import { deploy, parseDeployArgs } from "./packages/cloudflare/src/deploy.js";
-import { printDeployHelp } from "./packages/cloudflare/src/deploy-help.js";
+import { emitPrerenderPathManifest } from "./build/prerender-paths.js";
 import { getReactUpgradeDeps } from "./utils/react-version.js";
 import { init } from "./init.js";
-import { INIT_PLATFORMS, resolveInitPlatform, resolveInitPrerender } from "./init-platform.js";
+import { resolveInitOptions } from "./init-platform.js";
+import { loadDotenv } from "./config/dotenv.js";
 import { resolveVinextPackageRoot } from "./utils/vinext-root.js";
 import { emitStandaloneOutput } from "./build/standalone.js";
 import { cleanBuildOutput } from "./build/clean-output.js";
 import { formatAlreadyRunningError, tryAcquireLockfile } from "./server/dev-lockfile.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
-import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { randomBytes } from "node:crypto";
 import { execFileSync } from "node:child_process";
@@ -34,7 +33,6 @@ import { execFileSync } from "node:child_process";
 *   vinext dev     Start development server (Vite)
 *   vinext build   Build for production
 *   vinext start   Start production server
-*   vinext deploy  Deprecated Cloudflare deploy shim
 *   vinext typegen Generate App Router route helper types
 *   vinext lint    Run linter (delegates to eslint/oxlint)
 *
@@ -128,7 +126,11 @@ function hasPagesDir() {
 	return fs.existsSync(path.join(process.cwd(), "pages")) || fs.existsSync(path.join(process.cwd(), "src", "pages"));
 }
 async function loadBuildViteConfigMetadata(vite, root) {
-	if (!hasViteConfig(root)) return { prerenderConfig: null };
+	if (!hasViteConfig(root)) return {
+		nextConfig: null,
+		prerenderConfig: null,
+		routeRootConfig: null
+	};
 	const loaded = await vite.loadConfigFromFile({
 		command: "build",
 		mode: "production"
@@ -136,7 +138,9 @@ async function loadBuildViteConfigMetadata(vite, root) {
 	const emptyOutDir = loaded?.config.build?.emptyOutDir;
 	return {
 		emptyOutDir: typeof emptyOutDir === "boolean" ? emptyOutDir : void 0,
-		prerenderConfig: findVinextPrerenderConfigInPlugins(loaded?.config.plugins)
+		nextConfig: await findVinextNextConfigInPlugins(loaded?.config.plugins),
+		prerenderConfig: await findVinextPrerenderConfigInPlugins(loaded?.config.plugins),
+		routeRootConfig: await findVinextRouteRootConfigInPlugins(loaded?.config.plugins)
 	};
 }
 /**
@@ -277,12 +281,12 @@ async function buildApp() {
 	});
 	applyViteConfigCompatibility(process.cwd());
 	const vite = await loadVite();
-	const viteMajorVersion = Number.parseInt(vite.version, 10) || 7;
-	const withBuildBundlerOptions = (bundlerOptions) => viteMajorVersion >= 8 ? { rolldownOptions: bundlerOptions } : { rollupOptions: bundlerOptions };
+	const withBuildBundlerOptions = (bundlerOptions) => ({ rolldownOptions: bundlerOptions });
 	console.log(`\n  vinext build  (Vite ${getViteVersion()})\n`);
-	const root = process.cwd();
-	const isApp = hasAppDir(normalizePathSeparators(root));
-	const resolvedNextConfig = await resolveNextConfig(await loadNextConfig(root, PHASE_PRODUCTION_BUILD), root);
+	const root = toSlash(process.cwd());
+	const isApp = hasAppDir(root);
+	const buildConfigMetadata = await loadBuildViteConfigMetadata(vite, root);
+	const resolvedNextConfig = await resolveNextConfig(buildConfigMetadata.nextConfig ? await resolveNextConfigInput(buildConfigMetadata.nextConfig, PHASE_PRODUCTION_BUILD) : await loadNextConfig(root, PHASE_PRODUCTION_BUILD), root);
 	process.env.__VINEXT_SHARED_BUILD_ID = resolvedNextConfig.buildId;
 	process.env.__VINEXT_SHARED_RSC_COMPATIBILITY_ID = createRscCompatibilityId(resolvedNextConfig);
 	if (!process.env.__VINEXT_SHARED_REVALIDATE_SECRET) process.env.__VINEXT_SHARED_REVALIDATE_SECRET = randomBytes(32).toString("hex");
@@ -308,7 +312,6 @@ async function buildApp() {
 			});
 		}
 	}
-	const buildConfigMetadata = await loadBuildViteConfigMetadata(vite, root);
 	cleanBuildOutput({
 		root,
 		outDir: distDir,
@@ -317,46 +320,48 @@ async function buildApp() {
 	const isHybrid = isApp && hasPagesDir();
 	const pagesClientAssetsBuildSession = isHybrid ? randomBytes(16).toString("hex") : null;
 	if (pagesClientAssetsBuildSession) process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION = pagesClientAssetsBuildSession;
-	try {
-		const config = buildViteConfig({}, logger);
-		await (await vite.createBuilder(config)).buildApp();
-		if (isHybrid) {
-			console.log("  Building Pages Router server (hybrid)...");
-			const root = process.cwd();
-			let userTransformPlugins = [];
-			if (hasViteConfig(process.cwd())) {
-				const loaded = await vite.loadConfigFromFile({
-					command: "build",
-					mode: "production",
-					isSsrBuild: true
-				}, void 0, root);
-				if (loaded?.config.plugins) userTransformPlugins = loaded.config.plugins.flat(Infinity).filter((p) => !!p && typeof p.name === "string" && !p.name.startsWith("vinext:") && !p.name.startsWith("vite:react") && !p.name.startsWith("rsc:") && p.name !== "vite-rsc-load-module-dev-proxy" && p.name !== "vite-tsconfig-paths" && !p.name.startsWith("vite-plugin-cloudflare"));
-			}
-			await vite.build({
-				root,
-				configFile: false,
-				plugins: [...userTransformPlugins, vinext({ disableAppRouter: true })],
-				resolve: { dedupe: [
-					"react",
-					"react-dom",
-					"react/jsx-runtime",
-					"react/jsx-dev-runtime"
-				] },
-				...logger ? { customLogger: logger } : {},
-				build: {
-					outDir: "dist/server",
-					emptyOutDir: false,
-					ssr: "virtual:vinext-server-entry",
-					...withBuildBundlerOptions({ output: { entryFileNames: "entry.js" } })
+	await runWithPreviewBuildCredentials(async () => {
+		try {
+			const config = buildViteConfig({}, logger);
+			await (await vite.createBuilder(config)).buildApp();
+			if (isHybrid) {
+				console.log("  Building Pages Router server (hybrid)...");
+				const root = process.cwd();
+				let userTransformPlugins = [];
+				if (hasViteConfig(process.cwd())) {
+					const loaded = await vite.loadConfigFromFile({
+						command: "build",
+						mode: "production",
+						isSsrBuild: true
+					}, void 0, root);
+					if (loaded?.config.plugins) userTransformPlugins = loaded.config.plugins.flat(Infinity).filter((p) => !!p && typeof p.name === "string" && !p.name.startsWith("vinext:") && !p.name.startsWith("vite:react") && !p.name.startsWith("rsc:") && p.name !== "vite-rsc-load-module-dev-proxy" && !p.name.startsWith("vite-plugin-cloudflare"));
 				}
-			});
-		}
-	} finally {
-		if (pagesClientAssetsBuildSession) {
-			clearPagesClientAssetsBuildMetadata(pagesClientAssetsBuildSession);
-			if (process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION === pagesClientAssetsBuildSession) delete process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION;
+				await vite.build({
+					root,
+					configFile: false,
+					plugins: [...userTransformPlugins, vinext({ disableAppRouter: true })],
+					resolve: { dedupe: [
+						"react",
+						"react-dom",
+						"react/jsx-runtime",
+						"react/jsx-dev-runtime"
+					] },
+					...logger ? { customLogger: logger } : {},
+					build: {
+						outDir: "dist/server",
+						emptyOutDir: false,
+						ssr: "virtual:vinext-server-entry",
+						...withBuildBundlerOptions({ output: { entryFileNames: "entry.js" } })
+					}
+				});
+			}
+		} finally {
+			if (pagesClientAssetsBuildSession) {
+				clearPagesClientAssetsBuildMetadata(pagesClientAssetsBuildSession);
+				if (process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION === pagesClientAssetsBuildSession) delete process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION;
+			}
 		}
-	}
+	});
 	if (outputMode === "standalone") {
 		const standalone = emitStandaloneOutput({
 			root: process.cwd(),
@@ -380,14 +385,20 @@ async function buildApp() {
 		process.stdout.write("\x1B[0m");
 		console.log(`  ${formatVinextPrerenderLabel(prerenderDecision)}`);
 		prerenderResult = await runPrerender({
-			root: normalizePathSeparators(process.cwd()),
-			concurrency: parsed.prerenderConcurrency
+			root,
+			concurrency: parsed.prerenderConcurrency,
+			nextConfig: resolvedNextConfig
+		});
+		await emitPrerenderPathManifest({
+			root,
+			nextConfig: resolvedNextConfig,
+			routeRootConfig: buildConfigMetadata.routeRootConfig
 		});
 	}
 	process.stdout.write("\x1B[0m");
 	const { printBuildReport } = await import("./build/report.js");
 	await printBuildReport({
-		root: normalizePathSeparators(process.cwd()),
+		root,
 		pageExtensions: resolvedNextConfig.pageExtensions,
 		prerenderResult: prerenderResult ?? void 0
 	});
@@ -452,39 +463,15 @@ async function lint() {
 		process.exit(1);
 	}
 }
-async function deployCommand() {
-	const parsed = parseDeployArgs(rawArgs);
-	if (parsed.help) {
-		printDeployDeprecationWarning();
-		printDeployHelp();
-		return;
-	}
-	printDeployDeprecationWarning();
-	await loadVite();
-	console.log(`\n  vinext deploy  (Vite ${getViteVersion()})\n`);
-	await deploy({
-		root: process.cwd(),
-		preview: parsed.preview,
-		env: parsed.env,
-		skipBuild: parsed.skipBuild,
-		dryRun: parsed.dryRun,
-		name: parsed.name,
-		prerenderAll: parsed.prerenderAll,
-		prerenderConcurrency: parsed.prerenderConcurrency,
-		experimentalTPR: parsed.experimentalTPR,
-		tprCoverage: parsed.tprCoverage,
-		tprLimit: parsed.tprLimit,
-		tprWindow: parsed.tprWindow
-	});
-}
-function printDeployDeprecationWarning() {
-	console.log("  ⚠️  Warning: `vinext deploy` has moved to the `@vinext/cloudflare` package.\n  Please switch to `npx @vinext/cloudflare deploy` or `vp exec vinext-cloudflare deploy`; this compatibility command will be removed in a future release.\n");
+function failRemovedDeployCommand() {
+	console.error("\n  Error: `vinext deploy` has moved to the `@vinext/cloudflare` package.\n\n  Run `npx @vinext/cloudflare deploy` or `vp exec vinext-cloudflare deploy` instead.\n");
+	process.exit(1);
 }
 async function check() {
 	if (parseArgs(rawArgs).help) return printHelp("check");
 	console.log(`\n  vinext check\n`);
 	console.log("  Scanning project...\n");
-	const result = runCheck(normalizePathSeparators(process.cwd()));
+	const result = runCheck(toSlash(process.cwd()));
 	console.log(formatReport(result));
 }
 async function typegen() {
@@ -508,17 +495,13 @@ async function initCommand() {
 	const port = parsed.port ?? 3001;
 	const skipCheck = rawArgs.includes("--skip-check");
 	const force = rawArgs.includes("--force");
-	const platform = await resolveInitPlatform(rawArgs);
-	const platformOptions = await INIT_PLATFORMS[platform].options(rawArgs);
-	const prerender = await resolveInitPrerender(rawArgs);
+	const initOptions = await resolveInitOptions(rawArgs);
 	await init({
 		root: process.cwd(),
 		port,
 		skipCheck,
 		force,
-		platform,
-		prerender,
-		cloudflare: platform === "cloudflare" ? platformOptions : void 0
+		...initOptions
 	});
 }
 function printHelp(cmd) {
@@ -574,11 +557,7 @@ function printHelp(cmd) {
 `);
 		return;
 	}
-	if (cmd === "deploy") {
-		printDeployDeprecationWarning();
-		printDeployHelp();
-		return;
-	}
+	if (cmd === "deploy") failRemovedDeployCommand();
 	if (cmd === "check") {
 		console.log(`
   vinext check - Scan Next.js app for compatibility
@@ -611,6 +590,11 @@ function printHelp(cmd) {
     --platform <target>  Deployment target: cloudflare or node
     --prerender          Configure vinext build to pre-render all static routes
                          (default: prompt, with No selected by default)
+    --experimental-warm-cdn-cache
+                         Add experimental CDN pre-warming to the Cloudflare deploy script
+                         (Workers Cache CDN only, default: prompt with No)
+    --cdn-cache <type>   Cloudflare CDN cache: workers-cache or data-cache
+                         (default: workers-cache)
     --data-cache <type>  Cloudflare data cache: kv or none (default: kv)
     --image-optimization <type>
                          Cloudflare image optimization: cloudflare-images or none
@@ -619,11 +603,15 @@ function printHelp(cmd) {
   Examples:
     vinext init                   Prompt for a deployment platform
     vinext init --platform=cloudflare  Configure Cloudflare Workers (default)
+    vinext init --platform=cloudflare --cdn-cache=data-cache
+                                Fall through CDN caching to the data cache
     vinext init --platform=cloudflare --data-cache=kv
                                 Configure the default Cloudflare cache handlers
     vinext init --platform=cloudflare --image-optimization=none
                                 Do not configure Cloudflare Images
     vinext init --prerender     Add prerender: { routes: "*" } to vite.config.ts
+    vinext init --experimental-warm-cdn-cache
+                                Add experimental CDN pre-warming to deploy:vinext
     vinext init --platform=node   Configure a Node deployment
     vinext init -p 4000           Use port 4000 for dev:vinext
     vinext init --force           Overwrite existing vite.config.ts
@@ -722,10 +710,7 @@ switch (command) {
 		});
 		break;
 	case "deploy":
-		deployCommand().catch((e) => {
-			console.error(e);
-			process.exit(1);
-		});
+		failRemovedDeployCommand();
 		break;
 	case "init":
 		initCommand().catch((e) => {

package/dist/client/instrumentation-client-inject.js

@@ -1,5 +1,5 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import fs from "node:fs";
-import path from "node:path";
 //#region src/client/instrumentation-client-inject.ts
 /** Resolve empty-module next to this file (.js in dist, .ts in source). */
 function resolveInstrumentationClientEmptyModule(dir) {

package/dist/client/pages-router-link-navigation.js

@@ -2,7 +2,7 @@ import { stripBasePath } from "../utils/base-path.js";
 import { getLocalePathPrefix } from "../utils/domain-locale.js";
 //#region src/client/pages-router-link-navigation.ts
 function resolvePagesRouterQueryOnlyHref(href, { asPath, basePath, fallbackHref, locales }) {
-	if (!href.startsWith("?")) return href;
+	if (!href.startsWith("?") && !href.startsWith("#")) return href;
 	try {
 		const fallbackUrl = new URL(fallbackHref);
 		const base = new URL(asPath ?? `${stripBasePath(fallbackUrl.pathname, basePath)}${fallbackUrl.search}${fallbackUrl.hash}`, "http://vinext.local");

package/dist/config/config-matchers.js

@@ -159,7 +159,7 @@ function _getRedirectIndex(redirects) {
 	return index;
 }
 /** Hop-by-hop headers that should not be forwarded through a proxy. */
-const HOP_BY_HOP_HEADERS = new Set([
+const HOP_BY_HOP_HEADERS = /* @__PURE__ */ new Set([
 	"connection",
 	"keep-alive",
 	"proxy-authenticate",
@@ -175,7 +175,7 @@ const HOP_BY_HOP_HEADERS = new Set([
 * still forwards proxy auth credentials, while response sanitization strips
 * them before returning data to the client.
 */
-const REQUEST_HOP_BY_HOP_HEADERS = new Set([
+const REQUEST_HOP_BY_HOP_HEADERS = /* @__PURE__ */ new Set([
 	"connection",
 	"keep-alive",
 	"te",

package/dist/config/dotenv.js

@@ -1,5 +1,5 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import fs from "node:fs";
-import path from "node:path";
 import { parseEnv } from "node:util";
 //#region src/config/dotenv.ts
 /**

package/dist/config/next-config.d.ts

@@ -1,6 +1,8 @@
 import { PHASE_PRODUCTION_BUILD } from "../shims/constants.js";
+import { PluginOption } from "vite";
 
 //#region src/config/next-config.d.ts
+declare const VINEXT_NEXT_CONFIG_PLUGIN_PROPERTY = "__vinextNextConfig";
 /**
  * Parse a body size limit value (string or number) into bytes.
  * Accepts Next.js-style strings like "1mb", "500kb", "10mb", bare number strings like "1048576" (bytes),
@@ -241,6 +243,7 @@ type NextConfigFactory = (phase: string, opts: {
   defaultConfig: NextConfig;
 }) => NextConfig | Promise<NextConfig>;
 type NextConfigInput = NextConfig | NextConfigFactory;
+declare function findVinextNextConfigInPlugins(plugins: PluginOption[] | undefined): Promise<NextConfigInput | null>;
 /**
  * Resolved configuration with all async values awaited.
  */
@@ -564,4 +567,4 @@ declare function extractMdxOptions(config: NextConfig, root?: string): Promise<M
  */
 declare function detectNextIntlConfig(root: string, resolved: ResolvedNextConfig): void;
 //#endregion
-export { HasCondition, MdxOptions, NextConfig, NextConfigInput, NextHeader, NextI18nConfig, NextRedirect, NextRewrite, PHASE_PRODUCTION_BUILD, PrefetchInliningConfig, ResolvedNextConfig, createRscCompatibilityId, detectNextIntlConfig, extractMdxOptions, findNextConfigPath, lightningCssFeatureNamesToMask, loadNextConfig, normalizeAssetPrefix, parseBodySizeLimit, reassignsModuleExports, referencesCjsGlobals, resolveNextConfig, resolveNextConfigInput };
+export { HasCondition, MdxOptions, NextConfig, NextConfigInput, NextHeader, NextI18nConfig, NextRedirect, NextRewrite, PHASE_PRODUCTION_BUILD, PrefetchInliningConfig, ResolvedNextConfig, VINEXT_NEXT_CONFIG_PLUGIN_PROPERTY, createRscCompatibilityId, detectNextIntlConfig, extractMdxOptions, findNextConfigPath, findVinextNextConfigInPlugins, lightningCssFeatureNamesToMask, loadNextConfig, normalizeAssetPrefix, parseBodySizeLimit, reassignsModuleExports, referencesCjsGlobals, resolveNextConfig, resolveNextConfigInput };

package/dist/config/next-config.js

@@ -1,14 +1,14 @@
+import path, { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { normalizePageExtensions } from "../routing/file-matcher.js";
 import { applyLocaleToRoutes, isExternalUrl } from "./config-matchers.js";
 import { isUnknownRecord } from "../utils/record.js";
 import { getHtmlLimitedBotRegex } from "../utils/html-limited-bots.js";
+import { flattenPluginOptions } from "../utils/plugin-options.js";
 import { PHASE_DEVELOPMENT_SERVER, PHASE_PRODUCTION_BUILD } from "../shims/constants.js";
 import { loadTsconfigResolutionForRoot } from "./tsconfig-paths.js";
-import { getViteMajorVersion } from "../utils/vite-version.js";
 import { loadCommonJsModule, shouldRetryAsCommonJs } from "../utils/commonjs-loader.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
-import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomUUID } from "node:crypto";
 import commonjs from "vite-plugin-commonjs";
@@ -19,6 +19,7 @@ import commonjs from "vite-plugin-commonjs";
 * Loads the Next.js config file (if present) and extracts supported options.
 * Unsupported options are logged as warnings.
 */
+const VINEXT_NEXT_CONFIG_PLUGIN_PROPERTY = "__vinextNextConfig";
 /**
 * Parse a body size limit value (string or number) into bytes.
 * Accepts Next.js-style strings like "1mb", "500kb", "10mb", bare number strings like "1048576" (bytes),
@@ -64,6 +65,15 @@ function parseBodySizeLimit(value) {
 	if (bytes < 1) throw new Error(`Body size limit must be a positive number, got ${bytes}`);
 	return bytes;
 }
+async function findVinextNextConfigInPlugins(plugins) {
+	const flattened = await flattenPluginOptions(plugins);
+	for (const plugin of flattened) {
+		if (!isUnknownRecord(plugin)) continue;
+		const nextConfig = plugin[VINEXT_NEXT_CONFIG_PLUGIN_PROPERTY];
+		if (nextConfig) return nextConfig;
+	}
+	return null;
+}
 const CONFIG_FILES = [
 	"next.config.ts",
 	"next.config.mts",
@@ -151,10 +161,12 @@ async function unwrapConfig(mod, phase = PHASE_DEVELOPMENT_SERVER) {
 /**
 * Resolve a path through filesystem symlinks, falling back to the original
 * path when the file does not exist (e.g. virtual ids, query-suffixed ids).
+* Output is forward-slashed so it compares consistently with pathslash
+* results (fs.realpathSync returns backslashes on Windows).
 */
 function safeRealpath(p) {
 	try {
-		return fs.realpathSync(p);
+		return toSlash(fs.realpathSync(p));
 	} catch {
 		return p;
 	}
@@ -315,7 +327,7 @@ async function loadNextConfig(root, phase = DEFAULT_PHASE) {
 	const filename = path.basename(configPath);
 	const isTypeScriptConfig = /\.[cm]?ts$/.test(configPath);
 	const tsconfigResolution = loadTsconfigResolutionForRoot(root);
-	const useNativeTsconfigPaths = !!(isTypeScriptConfig ? tsconfigResolution.baseUrl : null) && getViteMajorVersion() >= 8;
+	const useNativeTsconfigPaths = !!(isTypeScriptConfig ? tsconfigResolution.baseUrl : null);
 	const normalizedConfigPath = safeRealpath(path.resolve(configPath));
 	try {
 		const { runnerImport } = await import("vite");
@@ -440,8 +452,8 @@ function createRscCompatibilityId(nextConfig) {
 * @returns A filesystem path suitable for path operations
 */
 function resolveCacheHandlerPathToFilesystem(filePath) {
-	if (filePath.startsWith("file://")) return fileURLToPath(filePath);
-	return filePath;
+	if (filePath.startsWith("file://")) return toSlash(fileURLToPath(filePath));
+	return toSlash(filePath);
 }
 function resolveHtmlLimitedBots(value) {
 	const source = value instanceof RegExp ? value.source : typeof value === "string" ? value : void 0;
@@ -572,11 +584,71 @@ function normalizePrefetchInliningConfig(value) {
 		maxSize: Number.isFinite(normalizedMaxSize) ? normalizedMaxSize : Number.MAX_SAFE_INTEGER
 	};
 }
+function normalizeI18nConfig(value) {
+	if (!value) return null;
+	const i18nType = typeof value;
+	if (i18nType !== "object") throw new Error(`Specified i18n should be an object received ${i18nType}.\nSee more info here: https://nextjs.org/docs/messages/invalid-i18n-config`);
+	const i18n = value;
+	if (!Array.isArray(i18n.locales)) throw new Error(`Specified i18n.locales should be an Array received ${typeof i18n.locales}.\nSee more info here: https://nextjs.org/docs/messages/invalid-i18n-config`);
+	if (i18n.locales.length > 100) console.warn(`Received ${i18n.locales.length} i18n.locales items which exceeds the recommended max of 100.\nSee more info here: https://nextjs.org/docs/advanced-features/i18n-routing#how-does-this-work-with-static-generation`);
+	if (!i18n.defaultLocale || typeof i18n.defaultLocale !== "string") throw new Error("Specified i18n.defaultLocale should be a string.\nSee more info here: https://nextjs.org/docs/messages/invalid-i18n-config");
+	if (i18n.domains !== void 0 && !Array.isArray(i18n.domains)) throw new Error(`Specified i18n.domains must be an array of domain objects e.g. [ { domain: 'example.fr', defaultLocale: 'fr', locales: ['fr'] } ] received ${typeof i18n.domains}.\nSee more info here: https://nextjs.org/docs/messages/invalid-i18n-config`);
+	if (i18n.domains) {
+		const invalidDomainItems = i18n.domains.filter((item) => {
+			if (!isUnknownRecord(item) || !item.defaultLocale) return true;
+			if (!item.domain || typeof item.domain !== "string") return true;
+			if (item.domain.includes(":")) {
+				console.warn(`i18n domain: "${item.domain}" is invalid it should be a valid domain without protocol (https://) or port (:3000) e.g. example.vercel.sh`);
+				return true;
+			}
+			const defaultLocaleDuplicate = i18n.domains.find((other) => isUnknownRecord(other) && other.defaultLocale === item.defaultLocale && other.domain !== item.domain);
+			if (defaultLocaleDuplicate && isUnknownRecord(defaultLocaleDuplicate)) {
+				console.warn(`Both ${item.domain} and ${String(defaultLocaleDuplicate.domain)} configured the defaultLocale ${item.defaultLocale} but only one can. Change one item's default locale to continue`);
+				return true;
+			}
+			let hasInvalidLocale = false;
+			if (Array.isArray(item.locales)) for (const locale of item.locales) {
+				if (typeof locale !== "string") hasInvalidLocale = true;
+				for (const domainItem of i18n.domains) {
+					if (domainItem === item || !isUnknownRecord(domainItem)) continue;
+					const domainLocales = domainItem.locales;
+					if (domainLocales && domainLocales.includes(locale)) {
+						console.warn(`Both ${item.domain} and ${String(domainItem.domain)} configured the locale (${String(locale)}) but only one can. Remove it from one i18n.domains config to continue`);
+						hasInvalidLocale = true;
+						break;
+					}
+				}
+			}
+			return hasInvalidLocale;
+		});
+		if (invalidDomainItems.length > 0) throw new Error(`Invalid i18n.domains values:\n${invalidDomainItems.map((item) => JSON.stringify(item)).join("\n")}\n\ndomains value must follow format { domain: 'example.fr', defaultLocale: 'fr', locales: ['fr'] }.\nSee more info here: https://nextjs.org/docs/messages/invalid-i18n-config`);
+	}
+	const invalidLocales = i18n.locales.filter((locale) => typeof locale !== "string");
+	if (invalidLocales.length > 0) throw new Error(`Specified i18n.locales contains invalid values (${invalidLocales.map(String).join(", ")}), locales must be valid locale tags provided as strings e.g. "en-US".\nSee here for list of valid language sub-tags: http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry`);
+	const locales = i18n.locales;
+	if (!locales.includes(i18n.defaultLocale)) throw new Error("Specified i18n.defaultLocale should be included in i18n.locales.\nSee more info here: https://nextjs.org/docs/messages/invalid-i18n-config");
+	const normalizedLocales = /* @__PURE__ */ new Set();
+	const duplicateLocales = /* @__PURE__ */ new Set();
+	for (const locale of locales) {
+		const localeLower = locale.toLowerCase();
+		if (normalizedLocales.has(localeLower)) duplicateLocales.add(locale);
+		normalizedLocales.add(localeLower);
+	}
+	if (duplicateLocales.size > 0) throw new Error(`Specified i18n.locales contains the following duplicate locales:\n${[...duplicateLocales].join(", ")}\nEach locale should be listed only once.\nSee more info here: https://nextjs.org/docs/messages/invalid-i18n-config`);
+	const localeDetectionType = typeof i18n.localeDetection;
+	if (localeDetectionType !== "boolean" && localeDetectionType !== "undefined") throw new Error(`Specified i18n.localeDetection should be undefined or a boolean received ${localeDetectionType}.\nSee more info here: https://nextjs.org/docs/messages/invalid-i18n-config`);
+	return {
+		locales: [i18n.defaultLocale, ...locales.filter((locale) => locale !== i18n.defaultLocale)],
+		defaultLocale: i18n.defaultLocale,
+		localeDetection: i18n.localeDetection ?? true,
+		domains: i18n.domains
+	};
+}
 /**
 * Resolve a NextConfig into a fully-resolved ResolvedNextConfig.
 * Awaits async functions for redirects/rewrites/headers.
 */
-async function resolveNextConfig(config, root = process.cwd(), options = {}) {
+async function resolveNextConfig(config, root = toSlash(process.cwd()), options = {}) {
 	if (!config) {
 		const buildId = await resolveBuildId(void 0);
 		const deploymentId = resolveDeploymentId(void 0);
@@ -644,6 +716,7 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 		return resolved;
 	}
 	warnDeprecatedConfigOptions(config, root);
+	const i18n = normalizeI18nConfig(config.i18n);
 	let redirects = [];
 	if (config.redirects) {
 		const result = await config.redirects();
@@ -730,13 +803,6 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 	const experimentalTurbo = readOptionalRecord(experimental?.turbo);
 	const turbopack = readOptionalRecord(config.turbopack);
 	const resolveExtensions = Array.isArray(turbopack?.resolveExtensions) ? readStringArray(turbopack.resolveExtensions) : Array.isArray(experimentalTurbo?.resolveExtensions) ? readStringArray(experimentalTurbo.resolveExtensions) : null;
-	let i18n = null;
-	if (config.i18n) i18n = {
-		locales: config.i18n.locales,
-		defaultLocale: config.i18n.defaultLocale,
-		localeDetection: config.i18n.localeDetection ?? true,
-		domains: config.i18n.domains
-	};
 	const buildId = await resolveBuildId(config.generateBuildId);
 	const deploymentId = resolveDeploymentId(config.deploymentId);
 	const cacheHandler = typeof config.cacheHandler === "string" ? resolveCacheHandlerPathToFilesystem(config.cacheHandler) : void 0;
@@ -997,7 +1063,7 @@ function invokeLoaderSideEffects(rules, root) {
 * loader rule. The remark/rehype plugins are captured in that closure.
 * We probe the webpack function with a mock config to extract them.
 */
-async function extractMdxOptions(config, root = process.cwd()) {
+async function extractMdxOptions(config, root = toSlash(process.cwd())) {
 	return (await probeWebpackConfig(config, root, false)).mdx;
 }
 /**
@@ -1091,4 +1157,4 @@ function extractPluginsFromOptions(opts) {
 	return null;
 }
 //#endregion
-export { PHASE_PRODUCTION_BUILD, createRscCompatibilityId, detectNextIntlConfig, extractMdxOptions, findNextConfigPath, lightningCssFeatureNamesToMask, loadNextConfig, normalizeAssetPrefix, parseBodySizeLimit, reassignsModuleExports, referencesCjsGlobals, resolveNextConfig, resolveNextConfigInput };
+export { PHASE_PRODUCTION_BUILD, VINEXT_NEXT_CONFIG_PLUGIN_PROPERTY, createRscCompatibilityId, detectNextIntlConfig, extractMdxOptions, findNextConfigPath, findVinextNextConfigInPlugins, lightningCssFeatureNamesToMask, loadNextConfig, normalizeAssetPrefix, parseBodySizeLimit, reassignsModuleExports, referencesCjsGlobals, resolveNextConfig, resolveNextConfigInput };

package/dist/config/prerender.d.ts

@@ -1,3 +1,4 @@
+import { VINEXT_CACHE_CONFIG_PLUGIN_PROPERTY, VinextCacheConfig, findVinextCacheConfigInPlugins, loadVinextCacheConfigFromViteConfig } from "../cache/cache-adapters-virtual.js";
 import { PluginOption } from "vite";
 
 //#region src/config/prerender.d.ts
@@ -18,12 +19,21 @@ type VinextPrerenderDecision = ResolvedVinextPrerenderConfig & {
   reason: VinextPrerenderDecisionReason;
 };
 declare const VINEXT_PRERENDER_CONFIG_PLUGIN_PROPERTY = "__vinextPrerenderConfig";
+declare const VINEXT_ROUTE_ROOT_CONFIG_PLUGIN_PROPERTY = "__vinextRouteRootConfig";
+type VinextRouteRootConfig = {
+  appDir?: string;
+  disableAppRouter?: boolean;
+  rscOutDir?: string;
+  ssrOutDir?: string;
+};
 type ViteConfigLoader = {
   loadConfigFromFile: typeof import("vite").loadConfigFromFile;
 };
 declare function normalizeVinextPrerenderConfig(config: VinextPrerenderConfig | undefined): ResolvedVinextPrerenderConfig | null;
-declare function findVinextPrerenderConfigInPlugins(plugins: PluginOption[] | undefined): ResolvedVinextPrerenderConfig | null;
+declare function findVinextPrerenderConfigInPlugins(plugins: PluginOption[] | undefined): Promise<ResolvedVinextPrerenderConfig | null>;
+declare function findVinextRouteRootConfigInPlugins(plugins: PluginOption[] | undefined): Promise<VinextRouteRootConfig | null>;
 declare function loadVinextPrerenderConfigFromViteConfig(vite: ViteConfigLoader, root: string): Promise<ResolvedVinextPrerenderConfig | null>;
+declare function loadVinextRouteRootConfigFromViteConfig(vite: ViteConfigLoader, root: string): Promise<VinextRouteRootConfig | null>;
 declare function resolveVinextPrerenderDecision(options: {
   prerenderAllFlag?: boolean;
   vinextPrerenderConfig?: ResolvedVinextPrerenderConfig | null;
@@ -31,4 +41,4 @@ declare function resolveVinextPrerenderDecision(options: {
 }): VinextPrerenderDecision | null;
 declare function formatVinextPrerenderLabel(decision: VinextPrerenderDecision): string;
 //#endregion
-export { ResolvedVinextPrerenderConfig, VINEXT_PRERENDER_CONFIG_PLUGIN_PROPERTY, VinextPrerenderConfig, VinextPrerenderDecision, VinextPrerenderDecisionReason, findVinextPrerenderConfigInPlugins, formatVinextPrerenderLabel, loadVinextPrerenderConfigFromViteConfig, normalizeVinextPrerenderConfig, resolveVinextPrerenderDecision };
+export { ResolvedVinextPrerenderConfig, VINEXT_CACHE_CONFIG_PLUGIN_PROPERTY, VINEXT_PRERENDER_CONFIG_PLUGIN_PROPERTY, VINEXT_ROUTE_ROOT_CONFIG_PLUGIN_PROPERTY, type VinextCacheConfig, VinextPrerenderConfig, VinextPrerenderDecision, VinextPrerenderDecisionReason, VinextRouteRootConfig, findVinextCacheConfigInPlugins, findVinextPrerenderConfigInPlugins, findVinextRouteRootConfigInPlugins, formatVinextPrerenderLabel, loadVinextCacheConfigFromViteConfig, loadVinextPrerenderConfigFromViteConfig, loadVinextRouteRootConfigFromViteConfig, normalizeVinextPrerenderConfig, resolveVinextPrerenderDecision };