vinext 1.0.0-beta.0 → 1.0.0-beta.1

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,13 +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 { 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";
@@ -18,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),
@@ -63,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",
@@ -150,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;
 	}
@@ -439,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;
@@ -571,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);
@@ -643,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();
@@ -729,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;
@@ -996,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;
 }
 /**
@@ -1090,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

@@ -30,8 +30,8 @@ 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 findVinextRouteRootConfigInPlugins(plugins: PluginOption[] | undefined): VinextRouteRootConfig | 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: {

package/dist/config/prerender.js

@@ -1,4 +1,5 @@
 import { isUnknownRecord } from "../utils/record.js";
+import { flattenPluginOptions } from "../utils/plugin-options.js";
 import { VINEXT_CACHE_CONFIG_PLUGIN_PROPERTY, findVinextCacheConfigInPlugins, loadVinextCacheConfigFromViteConfig } from "../cache/cache-adapters-virtual.js";
 //#region src/config/prerender.ts
 const VINEXT_PRERENDER_CONFIG_PLUGIN_PROPERTY = "__vinextPrerenderConfig";
@@ -10,16 +11,8 @@ function normalizeVinextPrerenderConfig(config) {
 	if (config.routes === "*") return { routes: "*" };
 	throw new Error("[vinext] Unsupported `prerender.routes` config. Currently only `routes: \"*\"` is supported.");
 }
-function flattenPluginOptions(value, target) {
-	if (Array.isArray(value)) {
-		for (const item of value) flattenPluginOptions(item, target);
-		return;
-	}
-	if (value) target.push(value);
-}
-function findVinextPrerenderConfigInPlugins(plugins) {
-	const flattened = [];
-	flattenPluginOptions(plugins, flattened);
+async function findVinextPrerenderConfigInPlugins(plugins) {
+	const flattened = await flattenPluginOptions(plugins);
 	for (const plugin of flattened) {
 		if (!isUnknownRecord(plugin)) continue;
 		const prerenderConfig = plugin[VINEXT_PRERENDER_CONFIG_PLUGIN_PROPERTY];
@@ -27,9 +20,8 @@ function findVinextPrerenderConfigInPlugins(plugins) {
 	}
 	return null;
 }
-function findVinextRouteRootConfigInPlugins(plugins) {
-	const flattened = [];
-	flattenPluginOptions(plugins, flattened);
+async function findVinextRouteRootConfigInPlugins(plugins) {
+	const flattened = await flattenPluginOptions(plugins);
 	for (const plugin of flattened) {
 		if (!isUnknownRecord(plugin)) continue;
 		const routeRootConfig = plugin[VINEXT_ROUTE_ROOT_CONFIG_PLUGIN_PROPERTY];
@@ -38,13 +30,13 @@ function findVinextRouteRootConfigInPlugins(plugins) {
 	return null;
 }
 async function loadVinextPrerenderConfigFromViteConfig(vite, root) {
-	return findVinextPrerenderConfigInPlugins((await vite.loadConfigFromFile({
+	return await findVinextPrerenderConfigInPlugins((await vite.loadConfigFromFile({
 		command: "build",
 		mode: "production"
 	}, void 0, root))?.config.plugins);
 }
 async function loadVinextRouteRootConfigFromViteConfig(vite, root) {
-	return findVinextRouteRootConfigInPlugins((await vite.loadConfigFromFile({
+	return await findVinextRouteRootConfigInPlugins((await vite.loadConfigFromFile({
 		command: "build",
 		mode: "production"
 	}, void 0, root))?.config.plugins);

package/dist/config/server-external-packages.js

@@ -85,7 +85,7 @@ function mergeServerExternalPackages(userPackages = [], transpilePackages = [])
 	const conflicts = userPackages.filter((name) => transpiled.has(name));
 	if (conflicts.length > 0) throw new Error(`The packages specified in the 'transpilePackages' conflict with the 'serverExternalPackages': ${conflicts.join(", ")}`);
 	const defaults = DEFAULT_SERVER_EXTERNAL_PACKAGES.filter((name) => !transpiled.has(name));
-	return [...new Set([...defaults, ...userPackages])];
+	return [.../* @__PURE__ */ new Set([...defaults, ...userPackages])];
 }
 //#endregion
 export { mergeServerExternalPackages };

package/dist/config/tsconfig-paths.js

@@ -1,8 +1,8 @@
+import path, { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { isUnknownRecord } from "../utils/record.js";
 import { parseStaticObjectLiteral } from "../plugins/fonts.js";
 import { createRequire } from "node:module";
 import fs from "node:fs";
-import path from "node:path";
 //#region src/config/tsconfig-paths.ts
 /**
 * tsconfig.json `compilerOptions.paths` loader.
@@ -61,7 +61,7 @@ function resolveTsconfigExtends(configPath, specifier) {
 		path.join(specifier, "tsconfig.json")
 	];
 	for (const item of candidates) try {
-		return requireFromConfig.resolve(item);
+		return toSlash(requireFromConfig.resolve(item));
 	} catch {}
 	return null;
 }

package/dist/{node_modules/.pnpm/am-i-vibing@0.5.0/node_modules → deps/.pnpm/am-i-vibing@0.5.0/deps}/am-i-vibing/dist/detector-1yx2Hoe0.js

@@ -1,4 +1,4 @@
-import { getProcessAncestry } from "../../../../process-ancestry@0.1.0/node_modules/process-ancestry/dist/index.js";
+import { getProcessAncestry } from "../../../../process-ancestry@0.1.0/deps/process-ancestry/dist/index.js";
 //#region ../../node_modules/.pnpm/am-i-vibing@0.5.0/node_modules/am-i-vibing/dist/detector-1yx2Hoe0.mjs
 /**
 * Provider configurations for major AI coding tools
@@ -291,4 +291,4 @@ function isAgent(envOrOptions, legacyAncestry) {
 	return result.type === "agent" || result.type === "hybrid";
 }
 //#endregion
-export { isAgent };
+export { providers as c, isAgent as n, detectAgenticEnvironment as t };

package/dist/deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js

@@ -0,0 +1,50 @@
+import nodePath from "node:path";
+//#region ../../node_modules/.pnpm/pathslash@0.1.0/node_modules/pathslash/dist/index.mjs
+const BACKSLASH_RE = /\\/g;
+const isWindows = process.platform === "win32";
+/**
+* Flip backslashes to forward slashes, used to slash-ify `node:path.win32`
+* output. `\\?\` (extended-length) paths are left untouched: there a forward
+* slash is a literal character, not a separator.
+*/
+const toForwardSlash = (path) => path.startsWith("\\\\?\\") ? path : path.replace(BACKSLASH_RE, "/");
+/**
+* Normalize separators to `/`, safely. On Windows it converts `\` to `/`. On
+* POSIX it does nothing, because there a backslash is a legal filename character
+* and rewriting it would corrupt the path.
+*/
+function toSlash(path) {
+	return isWindows ? toForwardSlash(path) : path;
+}
+const w = nodePath.win32;
+function slashed(fn) {
+	return (...args) => toForwardSlash(fn(...args));
+}
+const win32 = {
+	resolve: slashed(w.resolve),
+	normalize: slashed(w.normalize),
+	join: slashed(w.join),
+	relative: slashed(w.relative),
+	dirname: slashed(w.dirname),
+	format: slashed(w.format),
+	parse: (path) => {
+		const parsed = w.parse(path);
+		parsed.root = toForwardSlash(parsed.root);
+		parsed.dir = toForwardSlash(parsed.dir);
+		return parsed;
+	},
+	basename: w.basename,
+	extname: w.extname,
+	isAbsolute: w.isAbsolute,
+	matchesGlob: w.matchesGlob,
+	toNamespacedPath: w.toNamespacedPath,
+	delimiter: w.delimiter,
+	sep: "/"
+};
+const posix = { ...nodePath.posix };
+posix.posix = win32.posix = posix;
+posix.win32 = win32.win32 = win32;
+const path = isWindows ? win32 : posix;
+const { basename, delimiter, dirname, extname, format, isAbsolute, join, matchesGlob, normalize, parse, relative, resolve, sep, toNamespacedPath } = path;
+//#endregion
+export { path as default, posix, toSlash, win32 };

package/dist/entries/app-rsc-entry.js

@@ -1,4 +1,4 @@
-import { normalizePathSeparators } from "../utils/path.js";
+import { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { resolveEntryPath } from "./runtime-entry-module.js";
 import { isProxyFile } from "../server/middleware.js";
 import { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES } from "../server/image-optimization.js";
@@ -127,9 +127,9 @@ import { getNavigationContext as _getNavigationContext } from "next/navigation";
 import { configureMemoryCacheHandler as __configureMemoryCacheHandler } from "vinext/shims/cache-handler";
 import { headersContextFromRequest, getDraftModeCookieHeader, getAndClearPendingCookies, consumeDynamicUsage, consumeInvalidDynamicUsageError, setHeadersAccessPhase } from "next/headers";
 import { mergeMetadata, resolveModuleMetadata, mergeViewport, resolveModuleViewport } from "vinext/metadata";
-${middlewarePath ? `import * as middlewareModule from ${JSON.stringify(normalizePathSeparators(middlewarePath))};
+${middlewarePath ? `import * as middlewareModule from ${JSON.stringify(toSlash(middlewarePath))};
 import { applyAppMiddleware as __applyAppMiddleware } from ${JSON.stringify(appMiddlewarePath)};` : ""}
-${instrumentationPath ? `import * as _instrumentation from ${JSON.stringify(normalizePathSeparators(instrumentationPath))};
+${instrumentationPath ? `import * as _instrumentation from ${JSON.stringify(toSlash(instrumentationPath))};
 import { ensureInstrumentationRegistered as __ensureInstrumentationRegistered } from ${JSON.stringify(instrumentationRuntimePath)};` : ""}
 import { createAppRscHandler } from "vinext/server/app-rsc-handler";
 import { registerConfiguredCacheAdapters as __registerConfiguredCacheAdapters } from "virtual:vinext-cache-adapters";
@@ -333,6 +333,11 @@ export const __basePath = ${JSON.stringify(bp)};
 // thread the configured trailingSlash flag through canonical URL rendering.
 const __trailingSlash = ${JSON.stringify(ts)};
 
+// Hoisted above __createAppFallbackRenderer (which runs at module init) so the
+// fallback renderer can decide streaming-vs-blocking metadata redirects per
+// request user-agent. The later per-request references still read this const.
+const __htmlLimitedBots = ${JSON.stringify(htmlLimitedBots)};
+
 const rootNotFoundModule = ${rootNotFoundVar ? rootNotFoundVar : "null"};
 const rootForbiddenModule = ${rootForbiddenVar ? rootForbiddenVar : "null"};
 const rootUnauthorizedModule = ${rootUnauthorizedVar ? rootUnauthorizedVar : "null"};
@@ -358,6 +363,7 @@ const __fallbackRenderer = __createAppFallbackRenderer({
   ${(metadataRoutes?.length ?? 0) > 0 ? "applyFileBasedMetadata: __applyFileBasedMetadata," : ""}
   basePath: __basePath,
   trailingSlash: __trailingSlash,
+  htmlLimitedBots: __htmlLimitedBots,
   rootBoundaries: {
     rootForbiddenModule,
     rootLayouts,
@@ -380,6 +386,7 @@ const __fallbackRenderer = __createAppFallbackRenderer({
   makeThenableParams,
   sanitizer: __sanitizeErrorForClient,
   rscRenderer: renderToReadableStream,
+  getAndClearPendingCookies,
   getNavigationContext: _getNavigationContext,
   resolveChildSegments: __resolveAppPageChildSegments,
   clearRequestContext() {
@@ -432,7 +439,6 @@ const __runtimeImageConfig = ${JSON.stringify(config?.imageConfig)};
 const __publicFiles = new Set(${JSON.stringify(publicFiles)});
 const __allowedOrigins = ${JSON.stringify(allowedOrigins)};
 const __expireTime = ${JSON.stringify(expireTime)};
-const __htmlLimitedBots = ${JSON.stringify(htmlLimitedBots)};
 const __clientTraceMetadata = ${JSON.stringify(clientTraceMetadata)};
 const __reactMaxHeadersLength = ${JSON.stringify(reactMaxHeadersLength)};
 // Re-exported for the App Router prod-server to consume at startup —
@@ -582,6 +588,7 @@ export default createAppRscHandler({
           renderMode,
           observeMetadataSearchParamsAccess: buildOptions?.observeMetadataSearchParamsAccess === true,
           observePageSearchParamsAccess: buildOptions?.observePageSearchParamsAccess === true,
+          serveStreamingMetadata: buildOptions?.serveStreamingMetadata,
         }, layoutParamAccess, displayPathname);
       },
       clientReuseManifest,
@@ -962,7 +969,7 @@ export default createAppRscHandler({
       cleanPathname,
       context,
       hadBasePath,
-      filePath: ${JSON.stringify(middlewarePath ? normalizePathSeparators(middlewarePath) : "")},
+      filePath: ${JSON.stringify(middlewarePath ? toSlash(middlewarePath) : "")},
       i18nConfig: __i18nConfig,
       isDataRequest,
       isProxy: ${JSON.stringify(isProxyFile(middlewarePath))},

package/dist/entries/app-rsc-manifest.js

@@ -1,4 +1,4 @@
-import { normalizePathSeparators } from "../utils/path.js";
+import { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { computeAppRouteStaticSiblings, convertSegmentsToRouteParts } from "../routing/app-route-graph.js";
 import "../routing/app-router.js";
 import { createMetadataRouteEntriesSource } from "../server/metadata-route-build-data.js";
@@ -30,7 +30,7 @@ function createImportAllocator() {
 			const existing = importMap.get(filePath);
 			if (existing) return existing;
 			const varName = `mod_${importIdx++}`;
-			const absPath = normalizePathSeparators(filePath);
+			const absPath = toSlash(filePath);
 			imports.push(`import * as ${varName} from ${JSON.stringify(absPath)};`);
 			importMap.set(filePath, varName);
 			return varName;
@@ -39,7 +39,7 @@ function createImportAllocator() {
 			const existing = lazyMap.get(filePath);
 			if (existing) return existing;
 			const varName = `load_${lazyIdx++}`;
-			const absPath = normalizePathSeparators(filePath);
+			const absPath = toSlash(filePath);
 			imports.push(`const ${varName} = () => import(${JSON.stringify(absPath)});`);
 			lazyMap.set(filePath, varName);
 			return varName;
@@ -282,7 +282,7 @@ function buildAppRscManifestCode(options) {
 	const rootUnauthorizedVar = rootUnauthorizedPath ? imports.getImportVar(rootUnauthorizedPath) : null;
 	const rootLayoutVars = rootRouteLayoutPaths(rootRoute).map((layoutPath) => imports.getImportVar(layoutPath));
 	const globalErrorVar = options.globalErrorPath ? imports.getImportVar(options.globalErrorPath) : null;
-	const globalNotFoundImportSpecifier = options.globalNotFoundPath ? JSON.stringify(normalizePathSeparators(options.globalNotFoundPath)) : null;
+	const globalNotFoundImportSpecifier = options.globalNotFoundPath ? JSON.stringify(toSlash(options.globalNotFoundPath)) : null;
 	const dynamicMetadataRoutes = metadataRoutes.filter((r) => r.isDynamic);
 	for (const route of dynamicMetadataRoutes) imports.getImportVar(route.filePath);
 	const namesByPattern = buildRootParamNamesByPattern(options.routes);

package/dist/entries/pages-client-entry.js

@@ -1,8 +1,7 @@
-import { normalizePathSeparators } from "../utils/path.js";
+import { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { findFileWithExts } from "../routing/file-matcher.js";
 import { patternToNextFormat } from "../routing/route-validation.js";
 import { apiRouter, pagesRouter } from "../routing/pages-router.js";
-import "./pages-entry-helpers.js";
 import { hasExportedName } from "../build/report.js";
 import { readFile } from "node:fs/promises";
 //#region src/entries/pages-client-entry.ts
@@ -42,6 +41,7 @@ async function generateClientEntry(pagesDir, nextConfig, fileMatcher, options =
 	const pageRoutes = await pagesRouter(pagesDir, nextConfig?.pageExtensions, fileMatcher);
 	const apiRoutes = await apiRouter(pagesDir, nextConfig?.pageExtensions, fileMatcher);
 	const appFilePath = findFileWithExts(pagesDir, "_app", fileMatcher);
+	const errorFilePath = findFileWithExts(pagesDir, "_error", fileMatcher);
 	const hasApp = appFilePath !== null;
 	const appPrefetchRoutes = options.appPrefetchRoutes ?? [];
 	const pagesPrefetchRoutes = [...pageRoutes.map(toPagesLinkPrefetchRoute), ...apiRoutes.map((route) => ({
@@ -52,12 +52,13 @@ async function generateClientEntry(pagesDir, nextConfig, fileMatcher, options =
 	const pagesSspPatterns = (await Promise.all(pageRoutes.map(async (route) => await hasGetServerSidePropsExport(route.filePath) ? patternToNextFormat(route.pattern) : null))).filter((pattern) => pattern !== null);
 	const instrumentationClientPath = options.instrumentationClientPath ?? null;
 	const loaderEntries = pageRoutes.map((r) => {
-		const absPath = normalizePathSeparators(r.filePath);
+		const absPath = r.filePath;
 		const nextFormatPattern = patternToNextFormat(r.pattern);
 		return `  ${JSON.stringify(nextFormatPattern)}: () => import(${JSON.stringify(absPath)})`;
 	});
-	const appFileBase = appFilePath ? normalizePathSeparators(appFilePath) : void 0;
-	const userInstrumentationImport = instrumentationClientPath ? `import ${JSON.stringify(normalizePathSeparators(instrumentationClientPath))};\n` : "";
+	loaderEntries.push(errorFilePath !== null ? `  "/_error": () => import(${JSON.stringify(errorFilePath)})` : "  \"/_error\": () => import(\"next/error\")");
+	const appFileBase = appFilePath ?? void 0;
+	const userInstrumentationImport = instrumentationClientPath ? `import ${JSON.stringify(toSlash(instrumentationClientPath))};\n` : "";
 	const reactPreambleImport = options.reactPreamble === false ? "" : "import \"@vitejs/plugin-react/preamble\";\n";
 	const reactStrictModeEnabled = nextConfig.reactStrictMode === true;
 	return `${userInstrumentationImport}${reactPreambleImport}

package/dist/entries/pages-server-entry.js

@@ -1,9 +1,7 @@
-import { normalizePathSeparators } from "../utils/path.js";
 import { findFileWithExts } from "../routing/file-matcher.js";
 import { apiRouter, pagesRouter } from "../routing/pages-router.js";
 import { resolveEntryPath } from "./runtime-entry-module.js";
 import { isProxyFile } from "../server/middleware.js";
-import "./pages-entry-helpers.js";
 import { hasExportedName } from "../build/report.js";
 import { readFile } from "node:fs/promises";
 //#region src/entries/pages-server-entry.ts
@@ -39,18 +37,11 @@ async function getPagesDataKind(filePath) {
 async function generateServerEntry(pagesDir, nextConfig, fileMatcher, middlewarePath, instrumentationPath) {
 	const pageRoutes = await pagesRouter(pagesDir, nextConfig?.pageExtensions, fileMatcher);
 	const apiRoutes = await apiRouter(pagesDir, nextConfig?.pageExtensions, fileMatcher);
-	const pageImports = pageRoutes.map((r, i) => {
-		const absPath = normalizePathSeparators(r.filePath);
-		return `import * as page_${i} from ${JSON.stringify(absPath)};`;
-	});
-	const apiImports = apiRoutes.map((r, i) => {
-		const absPath = normalizePathSeparators(r.filePath);
-		return `import * as api_${i} from ${JSON.stringify(absPath)};`;
-	});
+	const pageImports = pageRoutes.map((r, i) => `import * as page_${i} from ${JSON.stringify(r.filePath)};`);
+	const apiImports = apiRoutes.map((r, i) => `import * as api_${i} from ${JSON.stringify(r.filePath)};`);
 	const pageRouteEntries = await Promise.all(pageRoutes.map(async (r, i) => {
-		const absPath = normalizePathSeparators(r.filePath);
 		const dataKind = await getPagesDataKind(r.filePath);
-		return `  { pattern: ${JSON.stringify(r.pattern)}, patternParts: ${JSON.stringify(r.patternParts)}, isDynamic: ${r.isDynamic}, params: ${JSON.stringify(r.params)}, module: page_${i}, filePath: ${JSON.stringify(absPath)}, dataKind: ${JSON.stringify(dataKind)} }`;
+		return `  { pattern: ${JSON.stringify(r.pattern)}, patternParts: ${JSON.stringify(r.patternParts)}, isDynamic: ${r.isDynamic}, params: ${JSON.stringify(r.params)}, module: page_${i}, filePath: ${JSON.stringify(r.filePath)}, dataKind: ${JSON.stringify(dataKind)} }`;
 	}));
 	const apiRouteEntries = apiRoutes.map((r, i) => `  { pattern: ${JSON.stringify(r.pattern)}, patternParts: ${JSON.stringify(r.patternParts)}, isDynamic: ${r.isDynamic}, params: ${JSON.stringify(r.params)}, module: api_${i} }`);
 	const appFilePath = findFileWithExts(pagesDir, "_app", fileMatcher);
@@ -60,7 +51,7 @@ async function generateServerEntry(pagesDir, nextConfig, fileMatcher, middleware
 	const appImportCode = appFilePath !== null ? `import { default as AppComponent } from ${JSON.stringify(appFilePath)};` : `const AppComponent = null;`;
 	const docImportCode = docFilePath !== null ? `import { default as DocumentComponent } from ${JSON.stringify(docFilePath)};` : `const DocumentComponent = null;`;
 	const errorAssetPathJson = errorFilePath !== null ? JSON.stringify(errorFilePath) : "null";
-	const errorImportCode = errorFilePath !== null ? `import * as ErrorPageModule from ${JSON.stringify(errorFilePath)};` : `const ErrorPageModule = null;`;
+	const errorImportCode = errorFilePath !== null ? `import * as ErrorPageModule from ${JSON.stringify(errorFilePath)};` : `import * as ErrorPageModule from "next/error";`;
 	const i18nConfigJson = nextConfig?.i18n ? JSON.stringify({
 		locales: nextConfig.i18n.locales,
 		defaultLocale: nextConfig.i18n.defaultLocale,
@@ -95,7 +86,7 @@ async function generateServerEntry(pagesDir, nextConfig, fileMatcher, middleware
 			contentSecurityPolicy: nextConfig?.images?.contentSecurityPolicy
 		}
 	});
-	const instrumentationImportCode = instrumentationPath ? `import * as _instrumentation from ${JSON.stringify(normalizePathSeparators(instrumentationPath))};` : "";
+	const instrumentationImportCode = instrumentationPath ? `import * as _instrumentation from ${JSON.stringify(instrumentationPath)};` : "";
 	const instrumentationInitCode = instrumentationPath ? `// Run instrumentation register() once at module evaluation time — before any
 // requests are handled. Matches Next.js semantics: register() is called once
 // on startup in the process that handles requests.
@@ -107,13 +98,13 @@ if (typeof _instrumentation.register === "function") {
 if (typeof _instrumentation.onRequestError === "function") {
   globalThis.__VINEXT_onRequestErrorHandler__ = _instrumentation.onRequestError;
 }` : "";
-	const middlewareImportCode = middlewarePath ? `import * as middlewareModule from ${JSON.stringify(normalizePathSeparators(middlewarePath))};` : "";
+	const middlewareImportCode = middlewarePath ? `import * as middlewareModule from ${JSON.stringify(middlewarePath)};` : "";
 	const middlewareExportCode = middlewarePath ? `
 export async function runMiddleware(request, ctx, options) {
   return __runGeneratedMiddleware({
     basePath: vinextConfig.basePath,
     ctx,
-    filePath: ${JSON.stringify(normalizePathSeparators(middlewarePath))},
+    filePath: ${JSON.stringify(middlewarePath)},
     i18nConfig,
     isDataRequest: options?.isDataRequest === true,
     isProxy: ${JSON.stringify(isProxyFile(middlewarePath))},
@@ -228,16 +219,14 @@ export const pageRoutes = [
 ${pageRouteEntries.join(",\n")}
 ];
 const _pageRouteTrie = _buildRouteTrie(pageRoutes);
-const _errorPageRoute = ErrorPageModule
-  ? {
-      pattern: "/_error",
-      patternParts: ["_error"],
-      isDynamic: false,
-      params: [],
-      module: ErrorPageModule,
-      filePath: ${errorAssetPathJson},
-    }
-  : null;
+const _errorPageRoute = {
+  pattern: "/_error",
+  patternParts: ["_error"],
+  isDynamic: false,
+  params: [],
+  module: ErrorPageModule,
+  filePath: ${errorAssetPathJson},
+};
 
 const apiRoutes = [
 ${apiRouteEntries.join(",\n")}

package/dist/entries/runtime-entry-module.js

@@ -1,4 +1,4 @@
-import { normalizePathSeparators } from "../utils/path.js";
+import { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import fs from "node:fs";
 import { fileURLToPath } from "node:url";
 //#region src/entries/runtime-entry-module.ts
@@ -14,7 +14,7 @@ import { fileURLToPath } from "node:url";
 * @param base - The caller's `import.meta.url`
 */
 function resolveEntryPath(rel, base) {
-	return normalizePathSeparators(fileURLToPath(new URL(rel, base)));
+	return toSlash(fileURLToPath(new URL(rel, base)));
 }
 /**
 * Resolve a real runtime module for a virtual entry generator.