vinext 1.0.0-beta.0 → 1.0.0-beta.2

package/README.md

@@ -32,7 +32,23 @@ Run `vinext check` against an existing application before migrating. If a gap is
 
 ## Quick start
 
-vinext includes an [Agent Skill](https://agentskills.io/home) that handles migration for you. It works with Claude Code, OpenCode, Cursor, Codex, and dozens of other AI coding tools. Install it, open your Next.js project, and tell the AI to migrate:
+**Use the official setup commands below.** They are the recommended way to create or migrate a vinext project because they configure dependencies, scripts, Vite, and your deployment target for you.
+
+Start a new project with `create-vinext-app`:
+
+```bash
+pnpm create vinext-app@latest my-app
+```
+
+Migrate an existing Next.js project with `vinext init`:
+
+```bash
+npx vinext init
+```
+
+### Optional: migrate with an AI agent
+
+Prefer `vinext init` for a direct, repeatable migration. If you want an AI agent to investigate compatibility issues and guide the migration, vinext also includes an optional [Agent Skill](https://agentskills.io/home). It works with Claude Code, OpenCode, Cursor, Codex, and dozens of other AI coding tools:
 
 ```sh
 npx skills add cloudflare/vinext
@@ -190,7 +206,10 @@ vinext works everywhere. It natively supports Cloudflare Workers (with `npx @vin
 vinext is a Vite plugin that reimplements the public Next.js API — routing, server rendering, `next/*` module imports, the CLI — so you can run Next.js applications on Vite instead of the Next.js compiler toolchain. It can be deployed anywhere: Cloudflare Workers is the first natively supported target, with other platforms available via Nitro. Native adapters for more platforms are [planned](https://github.com/cloudflare/vinext/issues/80).
 
 **Is this a fork of Next.js?**
-No. vinext is an alternative implementation of the Next.js API surface built on Vite. It does import some Next.js types and utilities, but the core is written from scratch. The goal is not to create a competing framework or add features beyond what Next.js offers; it is to provide the same well-defined API surface on Vite's toolchain.
+No. vinext is an alternative implementation of the Next.js API surface built on Vite. The core is written from scratch. The goal is not to create a competing framework or add features beyond what Next.js offers; it is to provide the same well-defined API surface on Vite's toolchain.
+
+**Does vinext require Next.js to be installed?**
+No. vinext ships fallback declarations for the supported `next` and `next/*` APIs, so applications can run and type-check without the `next` package. If both packages are installed, vinext keeps using Next.js's authoritative types and adds only its own extensions. Compatibility features that consume Next.js internals, such as `styled-jsx`, may still require a matching Next.js installation when used.
 
 **How is this different from OpenNext?**
 [OpenNext](https://opennext.js.org/) adapts the _output_ of a standard `next build` to run on various platforms. Because it builds on Next.js's own output, it inherits broad API coverage and has been well-tested for much longer. vinext takes a different approach: it reimplements the Next.js APIs on Vite from scratch, which means faster builds and smaller bundles, but less coverage of the long tail of Next.js features. If you need a mature, well-tested way to run Next.js outside Vercel, OpenNext is the safer choice. If you want a lighter Vite-based toolchain and do not need every Next.js API, vinext may be a good fit.

package/dist/build/assets-ignore.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/build/assets-ignore.ts
 /**
 * Build metadata that must never be served by the Cloudflare ASSETS binding.

package/dist/build/clean-output.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/build/clean-output.ts
 function resolveOutDir(root, outDir) {
 	const resolvedRoot = path.resolve(root);

package/dist/build/client-build-config.js

@@ -1,10 +1,12 @@
+import { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 //#region src/build/client-build-config.ts
-const ROUTE_OWNED_CLIENT_SHIMS = new Set([
+const ROUTE_OWNED_CLIENT_SHIMS = /* @__PURE__ */ new Set([
 	"compat-router",
 	"dynamic",
 	"dynamic-preload-chunks",
 	"form",
 	"image",
+	"internal/hybrid-client-route-owner",
 	"layout-segment-context",
 	"legacy-image",
 	"link",
@@ -47,7 +49,7 @@ function createClientAssetFileNames(assetsDir) {
 * (node_modules/.pnpm/pkg@ver/node_modules/pkg).
 */
 function getPackageName(id) {
-	const normalizedId = id.replaceAll("\\", "/");
+	const normalizedId = toSlash(id);
 	const nmIdx = normalizedId.lastIndexOf("node_modules/");
 	if (nmIdx === -1) return null;
 	const rest = normalizedId.slice(nmIdx + 13);
@@ -90,9 +92,10 @@ function createClientManualChunks(shimsDir, preserveRouteBoundaries = false) {
 			if (pkg === "react" || pkg === "react-dom" || pkg === "scheduler") return "framework";
 			return;
 		}
-		if (id.startsWith(shimsDir)) {
+		const slashedId = toSlash(id);
+		if (slashedId.startsWith(shimsDir)) {
 			if (preserveRouteBoundaries) {
-				const relativeId = id.slice(shimsDir.length).split("?", 1)[0] ?? "";
+				const relativeId = slashedId.slice(shimsDir.length).split("?", 1)[0] ?? "";
 				const extensionIndex = relativeId.lastIndexOf(".");
 				const shimName = extensionIndex === -1 ? relativeId : relativeId.slice(0, extensionIndex);
 				if (ROUTE_OWNED_CLIENT_SHIMS.has(shimName)) return void 0;

package/dist/build/css-url-assets.js

@@ -1,4 +1,4 @@
-import path from "node:path";
+import path, { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 //#region src/build/css-url-assets.ts
 /**
 * Next-parity for CSS `url()` asset dependencies.
@@ -35,7 +35,7 @@ const CSS_URL_RE = /url\(\s*(?:"([^"]*)"|'([^']*)'|([^'")]*?))\s*\)/g;
 const CSS_ASSET_EXT_RE = /\.(?:avif|bmp|gif|ico|jpe?g|png|svg|webp|woff2?|eot|ttf|otf|mp4|webm|ogg|mp3|wav|flac|aac|wasm)$/i;
 const CSS_REQUEST_RE = /\.(?:css|scss|sass|less|styl|stylus)(?:\?|$)/i;
 function basename(value) {
-	const normalized = value.replaceAll("\\", "/");
+	const normalized = toSlash(value);
 	const slash = normalized.lastIndexOf("/");
 	return slash === -1 ? normalized : normalized.slice(slash + 1);
 }
@@ -137,7 +137,7 @@ function rebaseCssUrlAssetReferences(code, sourceDirectory, targetDirectory) {
 		const lower = parts.path.toLowerCase();
 		if (!CSS_ASSET_EXT_RE.test(lower) || lower.endsWith(".css")) return null;
 		const absolutePath = path.resolve(sourceDirectory, parts.path);
-		let rebasedPath = path.relative(targetDirectory, absolutePath).replaceAll("\\", "/");
+		let rebasedPath = path.relative(targetDirectory, absolutePath);
 		if (!rebasedPath.startsWith(".")) rebasedPath = `./${rebasedPath}`;
 		return joinUrl({
 			...parts,

package/dist/build/google-fonts/fallback-metrics.js

@@ -1,5 +1,5 @@
 import { escapeCSSString } from "../../shims/font-utils.js";
-import fallback_metrics_data_default from "./fallback-metrics-data.js";
+import fallback_metrics_data_default from "./fallback-metrics-data.json.js";
 //#region src/build/google-fonts/fallback-metrics.ts
 const EXPECTED_METRIC_LENGTH = 6;
 const fallbackMetrics = fallback_metrics_data_default;

package/dist/build/google-fonts/font-metadata.js

@@ -1,4 +1,4 @@
-import font_data_default from "./font-data.js";
+import font_data_default from "./font-data.json.js";
 //#region src/build/google-fonts/font-metadata.ts
 const googleFontsMetadata = font_data_default;
 //#endregion

package/dist/build/inject-pregenerated-paths.js

@@ -1,7 +1,7 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { escapeRegExp } from "../utils/regex.js";
 import { readPrerenderManifest } from "../server/prerender-manifest.js";
 import fs from "node:fs";
-import path from "node:path";
 //#region src/build/inject-pregenerated-paths.ts
 const VINEXT_PREGEN_START = "/* __VINEXT_PREGENERATED_CONCRETE_PATHS_START__ */";
 const VINEXT_PREGEN_END = "/* __VINEXT_PREGENERATED_CONCRETE_PATHS_END__ */";

package/dist/build/inline-css.js

@@ -1,6 +1,6 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { resolveAssetUrlPrefix, resolveAssetsDir } from "../utils/asset-prefix.js";
 import fs from "node:fs";
-import path from "node:path";
 //#region src/build/inline-css.ts
 const INLINE_CSS_GLOBAL_MARKER = "globalThis.__VINEXT_INLINE_CSS__ = ";
 function collectCssFiles(directory) {
@@ -12,9 +12,6 @@ function collectCssFiles(directory) {
 	}
 	return files;
 }
-function toUrlPath(filePath) {
-	return filePath.split(path.sep).join("/");
-}
 function addPathnameAlias(manifest, href, css) {
 	try {
 		const url = new URL(href);
@@ -27,7 +24,7 @@ function collectInlineCssManifest(clientDir, assetPrefix) {
 	const urlPrefix = resolveAssetUrlPrefix(assetPrefix);
 	const manifest = {};
 	for (const filePath of collectCssFiles(assetsDir)) {
-		const href = `${urlPrefix}${toUrlPath(path.relative(assetsDir, filePath))}`;
+		const href = `${urlPrefix}${path.relative(assetsDir, filePath)}`;
 		const css = fs.readFileSync(filePath, "utf8");
 		manifest[href] = css;
 		addPathnameAlias(manifest, href, css);

package/dist/build/module-dependency-cache.d.ts

@@ -0,0 +1,4 @@
+//#region src/build/module-dependency-cache.d.ts
+declare function createModuleDependencyCache<T>(collect: (moduleId: string) => Promise<T>): (moduleId: string) => Promise<T>;
+//#endregion
+export { createModuleDependencyCache };

package/dist/build/module-dependency-cache.js

@@ -0,0 +1,13 @@
+//#region src/build/module-dependency-cache.ts
+function createModuleDependencyCache(collect) {
+	const cache = /* @__PURE__ */ new Map();
+	return function getModuleDependencies(moduleId) {
+		const cached = cache.get(moduleId);
+		if (cached) return cached;
+		const pending = collect(moduleId);
+		cache.set(moduleId, pending);
+		return pending;
+	};
+}
+//#endregion
+export { createModuleDependencyCache };

package/dist/build/next-client-runtime-manifests.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/build/next-client-runtime-manifests.ts
 function normalizeRewriteForClientManifest(rewrite) {
 	if (rewrite.destination.startsWith("/")) return {

package/dist/build/pages-client-assets-module.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/build/pages-client-assets-module.ts
 const PAGES_CLIENT_ASSETS_MODULE = "vinext-client-assets.js";
 const pagesClientAssetsByBuildSession = /* @__PURE__ */ new Map();

package/dist/build/precompress.js

@@ -1,6 +1,6 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { ASSET_PREFIX_URL_DIR } from "../utils/asset-prefix.js";
-import path from "node:path";
-import fs from "node:fs/promises";
+import fsp from "node:fs/promises";
 import os from "node:os";
 import zlib from "node:zlib";
 import { promisify } from "node:util";
@@ -20,7 +20,7 @@ const brotliCompress = promisify(zlib.brotliCompress);
 const gzip = promisify(zlib.gzip);
 const zstdCompress = typeof zlib.zstdCompress === "function" ? promisify(zlib.zstdCompress) : null;
 /** File extensions worth compressing (text-based, not already compressed). */
-const COMPRESSIBLE_EXTENSIONS = new Set([
+const COMPRESSIBLE_EXTENSIONS = /* @__PURE__ */ new Set([
 	".js",
 	".mjs",
 	".css",
@@ -46,7 +46,7 @@ const CONCURRENCY = Math.min(os.availableParallelism(), 8);
 async function* walkFiles(dir, base = dir) {
 	let entries;
 	try {
-		entries = await fs.readdir(dir, { withFileTypes: true });
+		entries = await fsp.readdir(dir, { withFileTypes: true });
 	} catch {
 		return;
 	}
@@ -89,13 +89,13 @@ async function precompressAssets(clientDir, options = {}) {
 	for (let i = 0; i < filePaths.length; i += CONCURRENCY) {
 		const chunk = filePaths.slice(i, i + CONCURRENCY);
 		await Promise.all(chunk.map(async (fullPath) => {
-			const content = await fs.readFile(fullPath);
+			const content = await fsp.readFile(fullPath);
 			if (content.length < MIN_SIZE) return;
 			const compressions = [brotliCompress(content, { params: { [zlib.constants.BROTLI_PARAM_QUALITY]: 5 } }), gzip(content, { level: 8 })];
 			if (zstdCompress) compressions.push(zstdCompress(content, { params: { [zlib.constants.ZSTD_c_compressionLevel]: 8 } }));
 			const [brContent, gzContent, zstdContent] = await Promise.all(compressions);
-			const writes = [fs.writeFile(fullPath + ".br", brContent), fs.writeFile(fullPath + ".gz", gzContent)];
-			if (zstdContent) writes.push(fs.writeFile(fullPath + ".zst", zstdContent));
+			const writes = [fsp.writeFile(fullPath + ".br", brContent), fsp.writeFile(fullPath + ".gz", gzContent)];
+			if (zstdContent) writes.push(fsp.writeFile(fullPath + ".zst", zstdContent));
 			await Promise.all(writes);
 			result.filesCompressed++;
 			result.totalOriginalBytes += content.length;

package/dist/build/prerender-paths.d.ts

@@ -10,8 +10,8 @@ type PrerenderPathManifest = {
 declare const PRERENDER_PATH_DISCOVERY_ENV = "__VINEXT_PRERENDER_PATH_DISCOVERY";
 declare const PRERENDER_PATHS_MANIFEST = "vinext-prerender-paths.json";
 type EmitPrerenderPathManifestOptions = {
-  root: string;
-  nextConfigOverride?: Partial<ResolvedNextConfig>;
+  root: string; /** Fully resolved Next.js config. Loaded from disk when omitted. */
+  nextConfig?: ResolvedNextConfig;
   appDir?: string | null;
   pagesDir?: string | null;
   routeRootConfig?: VinextRouteRootConfig | null;

package/dist/build/prerender-paths.js

@@ -1,5 +1,5 @@
+import path, { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { findDir } from "../utils/project.js";
-import { normalizePathSeparators } from "../utils/path.js";
 import { apiRouter, pagesRouter } from "../routing/pages-router.js";
 import { VINEXT_PRERENDER_SECRET_HEADER } from "../utils/protocol-headers.js";
 import { classifyAppRoute, classifyPagesRoute, getAppRouteRenderEntryPath, hasNamedExport } from "./report.js";
@@ -11,7 +11,6 @@ import { readPrerenderSecret } from "./server-manifest.js";
 import { startProdServer } from "../server/prod-server.js";
 import { buildUrlFromParams, resolveParentParams } from "./prerender.js";
 import fs from "node:fs";
-import path from "node:path";
 //#region src/build/prerender-paths.ts
 const PRERENDER_PATH_DISCOVERY_ENV = "__VINEXT_PRERENDER_PATH_DISCOVERY";
 const PRERENDER_PATHS_MANIFEST = "vinext-prerender-paths.json";
@@ -68,16 +67,16 @@ function resolveConfiguredRouteDirs(root, routeRootConfig) {
 	let baseDir;
 	if (routeRootConfig.appDir) {
 		baseDir = path.isAbsolute(routeRootConfig.appDir) ? routeRootConfig.appDir : path.resolve(root, routeRootConfig.appDir);
-		baseDir = normalizePathSeparators(baseDir);
+		baseDir = toSlash(baseDir);
 	} else {
-		const hasRootApp = fs.existsSync(path.posix.join(root, "app"));
-		const hasRootPages = fs.existsSync(path.posix.join(root, "pages"));
-		const hasSrcApp = fs.existsSync(path.posix.join(root, "src", "app"));
-		const hasSrcPages = fs.existsSync(path.posix.join(root, "src", "pages"));
-		baseDir = hasRootApp || hasRootPages ? root : hasSrcApp || hasSrcPages ? path.posix.join(root, "src") : root;
+		const hasRootApp = fs.existsSync(path.join(root, "app"));
+		const hasRootPages = fs.existsSync(path.join(root, "pages"));
+		const hasSrcApp = fs.existsSync(path.join(root, "src", "app"));
+		const hasSrcPages = fs.existsSync(path.join(root, "src", "pages"));
+		baseDir = hasRootApp || hasRootPages ? root : hasSrcApp || hasSrcPages ? path.join(root, "src") : root;
 	}
-	const appDir = path.posix.join(baseDir, "app");
-	const pagesDir = path.posix.join(baseDir, "pages");
+	const appDir = path.join(baseDir, "app");
+	const pagesDir = path.join(baseDir, "pages");
 	return {
 		appDir: !routeRootConfig.disableAppRouter && fs.existsSync(appDir) ? appDir : null,
 		pagesDir: fs.existsSync(pagesDir) ? pagesDir : null
@@ -237,11 +236,7 @@ async function emitPrerenderPathManifest(options) {
 	const pagesBundlePath = options.pagesBundlePath ?? path.join(root, "dist", "server", "entry.js");
 	const bundleServerDir = fs.existsSync(rscBundlePath) ? path.dirname(rscBundlePath) : path.dirname(pagesBundlePath);
 	const manifestDir = path.join(root, "dist", "server");
-	const loadedConfig = await resolveNextConfig(await loadNextConfig(root, PHASE_PRODUCTION_BUILD), root);
-	const config = options.nextConfigOverride ? {
-		...loadedConfig,
-		...options.nextConfigOverride
-	} : { ...loadedConfig };
+	const config = options.nextConfig ? { ...options.nextConfig } : { ...await resolveNextConfig(await loadNextConfig(root, PHASE_PRODUCTION_BUILD), root) };
 	const builtBuildId = readBuiltBuildId(manifestDir) ?? readBuiltBuildId(bundleServerDir);
 	if (builtBuildId) config.buildId = builtBuildId;
 	const paths = [];

package/dist/build/prerender-server-pool.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 { fileURLToPath } from "node:url";
 import os from "node:os";
 import { fork } from "node:child_process";
@@ -50,7 +50,7 @@ const APPROX_BYTES_PER_WORKER = 768 * 1024 * 1024;
 const WORKER_READY_TIMEOUT_MS = 6e4;
 /** Best-effort close timeout so build cleanup is not blocked forever by a wedged child. */
 const WORKER_CLOSE_TIMEOUT_MS = 5e3;
-const PRERENDER_WORKER_TRANSPORT_ERROR_CODES = new Set([
+const PRERENDER_WORKER_TRANSPORT_ERROR_CODES = /* @__PURE__ */ new Set([
 	"ECONNREFUSED",
 	"ECONNRESET",
 	"EPIPE",

package/dist/build/prerender.js

@@ -1,3 +1,4 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { createValidFileMatcher, findFileWithExtensions } from "../routing/file-matcher.js";
 import { VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER } from "../utils/protocol-headers.js";
 import { VINEXT_PRERENDER_CACHE_LIFE_HEADER } from "../server/headers.js";
@@ -17,7 +18,6 @@ import { getOutputPath, getRscOutputPath } from "../utils/prerender-output-paths
 import { startProdServer } from "../server/prod-server.js";
 import { prerenderPoolAvailable, resolvePrerenderPoolSize, startPrerenderServerPool } from "./prerender-server-pool.js";
 import fs from "node:fs";
-import path from "node:path";
 import os from "node:os";
 //#region src/build/prerender.ts
 /**

package/dist/build/preview-credentials.d.ts

@@ -0,0 +1,11 @@
+//#region src/build/preview-credentials.d.ts
+type PreviewBuildCredentials = {
+  id: string;
+  signingKey: string;
+  encryptionKey: string;
+};
+declare function createPreviewBuildCredentials(): PreviewBuildCredentials;
+declare function getPreviewBuildCredentials(): PreviewBuildCredentials | undefined;
+declare function runWithPreviewBuildCredentials<T>(callback: () => T): T;
+//#endregion
+export { PreviewBuildCredentials, createPreviewBuildCredentials, getPreviewBuildCredentials, runWithPreviewBuildCredentials };

package/dist/build/preview-credentials.js

@@ -0,0 +1,19 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomBytes } from "node:crypto";
+//#region src/build/preview-credentials.ts
+const previewBuildCredentialsStorage = new AsyncLocalStorage();
+function createPreviewBuildCredentials() {
+	return {
+		id: randomBytes(16).toString("hex"),
+		signingKey: randomBytes(32).toString("hex"),
+		encryptionKey: randomBytes(32).toString("hex")
+	};
+}
+function getPreviewBuildCredentials() {
+	return previewBuildCredentialsStorage.getStore();
+}
+function runWithPreviewBuildCredentials(callback) {
+	return previewBuildCredentialsStorage.run(createPreviewBuildCredentials(), callback);
+}
+//#endregion
+export { createPreviewBuildCredentials, getPreviewBuildCredentials, runWithPreviewBuildCredentials };

package/dist/build/report.d.ts

@@ -44,6 +44,13 @@ declare function hasExportedName(code: string, name: string): boolean;
  */
 declare function extractExportConstString(code: string, name: string): string | null;
 declare function extractMiddlewareMatcherConfig(filePath: string): StaticMiddlewareMatcher | undefined;
+/**
+ * Extract the statically analyzable `config.matcher` value without first
+ * narrowing it to vinext's runtime matcher type. Build validation needs the
+ * raw value so malformed matcher objects are rejected instead of disappearing
+ * as though no matcher had been configured.
+ */
+declare function extractMiddlewareMatcherConfigValue(filePath: string): unknown;
 /**
  * Extracts the numeric value of `export const <name> = <number|false>`.
  * Supports integers, decimals, negative values, `Infinity`, and `false`.
@@ -130,9 +137,6 @@ declare function formatBuildReport(rows: RouteRow[], routerLabel?: string): stri
 /**
  * Scans the project at `root`, classifies all routes, and prints the
  * Next.js-style build report to stdout.
- *
- * `root` must be forward-slash — it is passed to `findDir`. The caller (the
- * `vinext build` entry in cli.ts) normalizes it.
  */
 declare function printBuildReport(options: {
   root: string;
@@ -140,4 +144,4 @@ declare function printBuildReport(options: {
   prerenderResult?: PrerenderResult;
 }): Promise<void>;
 //#endregion
-export { RouteRow, RouteType, StaticMiddlewareMatcher, buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, printBuildReport };
+export { RouteRow, RouteType, StaticMiddlewareMatcher, buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, extractMiddlewareMatcherConfigValue, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, printBuildReport };

package/dist/build/report.js

@@ -1,3 +1,4 @@
+import { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { findDir } from "../utils/project.js";
 import fs from "node:fs";
 import { parseSync } from "vite";
@@ -134,6 +135,16 @@ function extractStringFromConstInitializer(initializer) {
 	return null;
 }
 function extractMiddlewareMatcherConfig(filePath) {
+	const value = extractMiddlewareMatcherConfigValue(filePath);
+	return isStaticMiddlewareMatcher(value) ? value : void 0;
+}
+/**
+* Extract the statically analyzable `config.matcher` value without first
+* narrowing it to vinext's runtime matcher type. Build validation needs the
+* raw value so malformed matcher objects are rejected instead of disappearing
+* as though no matcher had been configured.
+*/
+function extractMiddlewareMatcherConfigValue(filePath) {
 	let code;
 	try {
 		code = fs.readFileSync(filePath, "utf8");
@@ -147,7 +158,7 @@ function extractMiddlewareMatcherConfig(filePath) {
 	const matcherExpression = objectPropertyValue(config, "matcher");
 	if (!matcherExpression) return void 0;
 	const value = extractStaticJsonValue(matcherExpression);
-	return isStaticMiddlewareMatcher(value) ? value : void 0;
+	return value === UNSUPPORTED_STATIC_VALUE ? void 0 : value;
 }
 function objectPropertyValue(object, key) {
 	for (const property of object.properties) {
@@ -415,7 +426,7 @@ function classifyLayoutSegmentConfig(code) {
 * API routes (files under pages/api/) are always `api`.
 */
 function classifyPagesRoute(filePath) {
-	if (filePath.replace(/\\/g, "/").includes("/pages/api/")) return { type: "api" };
+	if (toSlash(filePath).includes("/pages/api/")) return { type: "api" };
 	let code;
 	try {
 		code = fs.readFileSync(filePath, "utf8");
@@ -569,9 +580,6 @@ function formatBuildReport(rows, routerLabel = "app") {
 /**
 * Scans the project at `root`, classifies all routes, and prints the
 * Next.js-style build report to stdout.
-*
-* `root` must be forward-slash — it is passed to `findDir`. The caller (the
-* `vinext build` entry in cli.ts) normalizes it.
 */
 async function printBuildReport(options) {
 	const { root } = options;
@@ -598,4 +606,4 @@ async function printBuildReport(options) {
 	}
 }
 //#endregion
-export { buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, printBuildReport };
+export { buildReportRows, classifyAppRoute, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, extractMiddlewareMatcherConfigValue, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, printBuildReport };

package/dist/build/run-prerender.d.ts

@@ -3,13 +3,8 @@ import { PrerenderResult, PrerenderRouteResult } from "./prerender.js";
 
 //#region src/build/run-prerender.d.ts
 type RunPrerenderOptions = {
-  /** Project root directory. */root: string;
-  /**
-   * Override next.config values. Merged on top of the config loaded from disk.
-   * Intended for tests that need to exercise a specific config (e.g. output: 'export')
-   * without writing a next.config file.
-   */
-  nextConfigOverride?: Partial<ResolvedNextConfig>;
+  /** Project root directory. */root: string; /** Fully resolved Next.js config. Loaded from disk when omitted. */
+  nextConfig?: ResolvedNextConfig;
   /**
    * Override the path to the Pages Router server bundle.
    * Defaults to `<root>/dist/server/entry.js`.
@@ -58,10 +53,6 @@ type RunPrerenderOptions = {
 declare function assertNoFatalPrerenderRoutes(routes: readonly PrerenderRouteResult[]): void;
 /**
  * Statically generate routes and return the prerender result.
- *
- * `options.root` must be forward-slash — it is passed to `findDir` and flows
- * into the route model. The caller (the `vinext build` entry in cli.ts)
- * normalizes it.
  */
 declare function runPrerender(options: RunPrerenderOptions): Promise<PrerenderResult | null>;
 //#endregion

package/dist/build/run-prerender.js

@@ -1,3 +1,4 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { findDir } from "../utils/project.js";
 import { apiRouter, pagesRouter } from "../routing/pages-router.js";
 import { appRouter } from "../routing/app-router.js";
@@ -8,7 +9,6 @@ import { rememberCurrentServerEntryImportMtime, startProdServer } from "../serve
 import { prerenderApp, prerenderPages, writePrerenderIndex } from "./prerender.js";
 import { injectPregeneratedConcretePaths } from "./inject-pregenerated-paths.js";
 import fs from "node:fs";
-import path from "node:path";
 //#region src/build/run-prerender.ts
 /**
 * Shared prerender runner used by both `vinext build` (cli.ts) and
@@ -98,10 +98,6 @@ function assertNoFatalPrerenderRoutes(routes) {
 }
 /**
 * Statically generate routes and return the prerender result.
-*
-* `options.root` must be forward-slash — it is passed to `findDir` and flows
-* into the route model. The caller (the `vinext build` entry in cli.ts)
-* normalizes it.
 */
 async function runPrerender(options) {
 	const { root } = options;
@@ -113,11 +109,7 @@ async function runPrerender(options) {
 	const manifestDir = path.join(root, "dist", "server");
 	const rscBundlePath = options.rscBundlePath ?? path.join(root, "dist", "server", "index.js");
 	const serverDir = path.dirname(rscBundlePath);
-	const loadedConfig = await resolveNextConfig(await loadNextConfig(root), root);
-	const config = options.nextConfigOverride ? {
-		...loadedConfig,
-		...options.nextConfigOverride
-	} : { ...loadedConfig };
+	const config = options.nextConfig ? { ...options.nextConfig } : { ...await resolveNextConfig(await loadNextConfig(root), root) };
 	const builtBuildId = readBuiltBuildId(serverDir);
 	if (builtBuildId) config.buildId = builtBuildId;
 	const mode = config.output === "export" ? "export" : "default";

package/dist/build/server-manifest.js

@@ -1,5 +1,5 @@
+import path from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { readJsonFile } from "../utils/safe-json-file.js";
-import path from "node:path";
 //#region src/build/server-manifest.ts
 /**
 * Shared utilities for reading/writing vinext-server.json.

package/dist/build/ssr-manifest.d.ts

@@ -9,6 +9,10 @@ type BundleBackfillChunk = {
     importedAssets?: Set<string>;
   };
 };
+/**
+ * Realpath with NATIVE separators (backslashes on Windows). Callers apply
+ * `toSlash` where the result becomes a module id / manifest key.
+ */
 declare function tryRealpathSync(candidate: string): string | null;
 declare function relativeWithinRoot(root: string, moduleId: string): string | null;
 declare function augmentSsrManifestFromBundle(ssrManifest: Record<string, string[]>, bundle: Record<string, BundleBackfillChunk | {

package/dist/build/ssr-manifest.js

@@ -1,7 +1,11 @@
+import path, { toSlash } from "../deps/.pnpm/pathslash@0.1.0/deps/pathslash/dist/index.js";
 import { collapseDuplicateBase, manifestFileWithBase } from "../utils/manifest-paths.js";
 import fs from "node:fs";
-import path from "node:path";
 //#region src/build/ssr-manifest.ts
+/**
+* Realpath with NATIVE separators (backslashes on Windows). Callers apply
+* `toSlash` where the result becomes a module id / manifest key.
+*/
 function tryRealpathSync(candidate) {
 	try {
 		return fs.realpathSync.native(candidate);
@@ -13,26 +17,26 @@ function isWindowsAbsolutePath(candidate) {
 	return /^[a-zA-Z]:[\\/]/.test(candidate) || candidate.startsWith("\\\\");
 }
 function relativeWithinRoot(root, moduleId) {
-	const relativeId = (isWindowsAbsolutePath(root) || isWindowsAbsolutePath(moduleId) ? path.win32.relative(root, moduleId) : path.relative(root, moduleId)).replace(/\\/g, "/");
+	const relativeId = isWindowsAbsolutePath(root) || isWindowsAbsolutePath(moduleId) ? path.win32.relative(root, moduleId) : path.relative(root, moduleId);
 	if (!relativeId || relativeId === ".." || relativeId.startsWith("../")) return null;
 	return relativeId;
 }
 function normalizeManifestModuleId(moduleId, root) {
-	const normalizedId = moduleId.replace(/\\/g, "/");
+	const normalizedId = toSlash(moduleId);
 	if (normalizedId.startsWith("\0")) return normalizedId;
 	if (normalizedId.startsWith("node_modules/") || normalizedId.includes("/node_modules/")) return normalizedId;
 	if (!isWindowsAbsolutePath(moduleId) && !path.isAbsolute(moduleId)) {
 		if (!normalizedId.startsWith(".") && !normalizedId.includes("../")) return normalizedId;
 	}
-	const rootCandidates = new Set([root]);
+	const rootCandidates = /* @__PURE__ */ new Set([root]);
 	const realRoot = tryRealpathSync(root);
-	if (realRoot) rootCandidates.add(realRoot);
+	if (realRoot) rootCandidates.add(toSlash(realRoot));
 	const moduleCandidates = /* @__PURE__ */ new Set();
 	if (isWindowsAbsolutePath(moduleId) || path.isAbsolute(moduleId)) moduleCandidates.add(moduleId);
 	else moduleCandidates.add(path.resolve(root, moduleId));
 	for (const candidate of moduleCandidates) {
 		const realCandidate = tryRealpathSync(candidate);
-		if (realCandidate) moduleCandidates.add(realCandidate);
+		if (realCandidate) moduleCandidates.add(toSlash(realCandidate));
 	}
 	for (const rootCandidate of rootCandidates) for (const moduleCandidate of moduleCandidates) {
 		const relativeId = relativeWithinRoot(rootCandidate, moduleCandidate);