vinext 0.1.6 → 0.1.8

package/dist/build/client-build-config.d.ts

@@ -26,12 +26,10 @@ declare function createClientAssetFileNames(assetsDir: string): (assetInfo: Clie
  *
  * Splits the client bundle into:
  * - "framework" — React, ReactDOM, and scheduler (loaded on every page)
- * - "vinext"    — vinext shims (router, head, link, etc.)
+ * - "vinext"    — shared vinext runtime shims
  *
- * All other vendor code is left to Rollup's default chunk-splitting
- * algorithm. Rollup automatically deduplicates shared modules into
- * common chunks based on the import graph — no manual intervention
- * needed.
+ * Route-owned client shims and all other vendor code are left to the bundler's
+ * graph-based chunking so they stay behind their client-reference boundaries.
  *
  * Why not split every npm package into its own chunk?
  * - Per-package splitting (`vendor-X`) creates 50-200+ chunks for a
@@ -48,7 +46,7 @@ declare function createClientAssetFileNames(assetsDir: string): (assetInfo: Clie
  *   well: shared dependencies between routes get their own chunks,
  *   and route-specific code stays in route chunks.
  */
-declare function createClientManualChunks(shimsDir: string): (id: string) => string | undefined;
+declare function createClientManualChunks(shimsDir: string, preserveRouteBoundaries?: boolean): (id: string) => string | undefined;
 /**
  * Rollup output config with manualChunks for client code-splitting.
  * Used by both CLI builds and multi-environment builds.

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

@@ -1,4 +1,18 @@
 //#region src/build/client-build-config.ts
+const ROUTE_OWNED_CLIENT_SHIMS = new Set([
+	"compat-router",
+	"dynamic",
+	"dynamic-preload-chunks",
+	"form",
+	"image",
+	"layout-segment-context",
+	"legacy-image",
+	"link",
+	"offline",
+	"router",
+	"script",
+	"web-vitals"
+]);
 const NEXT_CLIENT_CSS_ASSET_FILE_NAMES = "css/[name].[hash:8][extname]";
 const NEXT_CLIENT_STATIC_MEDIA_FILE_NAMES = "media/[name].[hash:8][extname]";
 function joinAssetFileNamePattern(assetsDir, pattern) {
@@ -48,12 +62,10 @@ function getPackageName(id) {
 *
 * Splits the client bundle into:
 * - "framework" — React, ReactDOM, and scheduler (loaded on every page)
-* - "vinext"    — vinext shims (router, head, link, etc.)
+* - "vinext"    — shared vinext runtime shims
 *
-* All other vendor code is left to Rollup's default chunk-splitting
-* algorithm. Rollup automatically deduplicates shared modules into
-* common chunks based on the import graph — no manual intervention
-* needed.
+* Route-owned client shims and all other vendor code are left to the bundler's
+* graph-based chunking so they stay behind their client-reference boundaries.
 *
 * Why not split every npm package into its own chunk?
 * - Per-package splitting (`vendor-X`) creates 50-200+ chunks for a
@@ -70,7 +82,7 @@ function getPackageName(id) {
 *   well: shared dependencies between routes get their own chunks,
 *   and route-specific code stays in route chunks.
 */
-function createClientManualChunks(shimsDir) {
+function createClientManualChunks(shimsDir, preserveRouteBoundaries = false) {
 	return function clientManualChunks(id) {
 		if (id.includes("node_modules")) {
 			const pkg = getPackageName(id);
@@ -78,7 +90,15 @@ function createClientManualChunks(shimsDir) {
 			if (pkg === "react" || pkg === "react-dom" || pkg === "scheduler") return "framework";
 			return;
 		}
-		if (id.startsWith(shimsDir)) return "vinext";
+		if (id.startsWith(shimsDir)) {
+			if (preserveRouteBoundaries) {
+				const relativeId = id.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;
+			}
+			return "vinext";
+		}
 	};
 }
 /**

package/dist/build/prerender.js

@@ -306,7 +306,6 @@ async function prerenderPages({ routes, apiRoutes, pagesDir, outDir, config, mod
 		for (const route of bundlePageRoutes) {
 			if (BLOCKED_PAGES.includes(route.pattern)) continue;
 			if (route.pattern === "/404") continue;
-			if (!routes.find((r) => r.filePath === route.filePath || r.pattern === route.pattern)) continue;
 			const { type, revalidate: classifiedRevalidate } = classifyPagesRoute(route.filePath);
 			if (type === "ssr") {
 				if (mode === "export") results.push({
@@ -648,7 +647,7 @@ async function prerenderApp({ routes, metadataRoutes = [], outDir, config, mode,
 					});
 					continue;
 				}
-				if (!Array.isArray(paramSets) || paramSets.length === 0) {
+				if (paramSets.length === 0) {
 					results.push({
 						route: route.pattern,
 						status: "skipped",

package/dist/check.d.ts

@@ -59,22 +59,40 @@ type CheckResult = {
 declare function hasFreeCjsGlobal(content: string): boolean;
 /**
  * Scan source files for `import ... from 'next/...'` statements.
+ *
+ * `root` must be forward-slash: it is passed to `findSourceFiles` (which
+ * requires it) and used as the base of `path.posix.relative`, which only yields
+ * a canonical relative path when both operands are forward-slash.
  */
 declare function scanImports(root: string): CheckItem[];
 /**
  * Analyze next.config.js/mjs/ts for supported and unsupported options.
+ *
+ * `root` must be forward-slash — joined with `path.posix.join`. Only called
+ * from `runCheck`, which normalizes it.
  */
 declare function analyzeConfig(root: string): CheckItem[];
 /**
  * Check package.json dependencies for known libraries.
+ *
+ * `root` must be forward-slash — joined with `path.posix.join`. Only called
+ * from `runCheck`, which normalizes it.
  */
 declare function checkLibraries(root: string): CheckItem[];
 /**
  * Check file conventions (pages, app directory, middleware, etc.)
+ *
+ * `root` must be forward-slash — joined with `path.posix.join`, passed to
+ * `findDir`, and used as the base of `path.posix.relative`. Only called from
+ * `runCheck`, which normalizes it.
  */
 declare function checkConventions(root: string): CheckItem[];
 /**
  * Run the full compatibility check.
+ *
+ * `root` must be forward-slash — callers normalize it at the CLI entry, and it
+ * is forwarded to `scanImports` / `checkConventions` / `findDir`, which build
+ * paths with `path.posix.*`.
  */
 declare function runCheck(root: string): CheckResult;
 /**

package/dist/check.js

@@ -1,5 +1,4 @@
 import { detectPackageManager, findDir } from "./utils/project.js";
-import { normalizePathSeparators } from "./utils/path.js";
 import fs from "node:fs";
 import path from "node:path";
 import { parseAst } from "vite";
@@ -331,6 +330,11 @@ const LIBRARY_SUPPORT = {
 };
 /**
 * Recursively find all source files in a directory.
+*
+* `dir` must be forward-slash, and the returned paths are forward-slash too:
+* each entry is joined with `path.posix.join`, which only stays canonical when
+* the base already is. This keeps downstream substring checks (e.g.
+* `f.includes("/api/")`) and reported paths consistent across platforms.
 */
 function findSourceFiles(dir, extensions = [
 	".ts",
@@ -343,7 +347,7 @@ function findSourceFiles(dir, extensions = [
 	if (!fs.existsSync(dir)) return results;
 	const entries = fs.readdirSync(dir, { withFileTypes: true });
 	for (const entry of entries) {
-		const fullPath = normalizePathSeparators(path.join(dir, entry.name));
+		const fullPath = path.posix.join(dir, entry.name);
 		if (entry.isDirectory()) {
 			if (entry.name === "node_modules" || entry.name === ".next" || entry.name === "dist" || entry.name === ".git") continue;
 			results.push(...findSourceFiles(fullPath, extensions));
@@ -547,6 +551,10 @@ function hasFreeCjsGlobal(content) {
 }
 /**
 * Scan source files for `import ... from 'next/...'` statements.
+*
+* `root` must be forward-slash: it is passed to `findSourceFiles` (which
+* requires it) and used as the base of `path.posix.relative`, which only yields
+* a canonical relative path when both operands are forward-slash.
 */
 function scanImports(root) {
 	const files = findSourceFiles(root);
@@ -564,7 +572,7 @@ function scanImports(root) {
 			if (mod.startsWith("next/") || mod === "next" || mod === "server-only" || mod === "client-only") {
 				const normalized = mod === "next" ? "next" : mod;
 				if (!importUsage.has(normalized)) importUsage.set(normalized, []);
-				const relFile = normalizePathSeparators(path.relative(root, file));
+				const relFile = path.posix.relative(root, file);
 				const usedInFiles = importUsage.get(normalized) ?? [];
 				if (!usedInFiles.includes(relFile)) usedInFiles.push(relFile);
 			}
@@ -691,6 +699,9 @@ function collectConfigKeys(source) {
 }
 /**
 * Analyze next.config.js/mjs/ts for supported and unsupported options.
+*
+* `root` must be forward-slash — joined with `path.posix.join`. Only called
+* from `runCheck`, which normalizes it.
 */
 function analyzeConfig(root) {
 	const configFiles = [
@@ -702,7 +713,7 @@ function analyzeConfig(root) {
 	];
 	let configPath = null;
 	for (const f of configFiles) {
-		const p = path.join(root, f);
+		const p = path.posix.join(root, f);
 		if (fs.existsSync(p)) {
 			configPath = p;
 			break;
@@ -757,9 +768,12 @@ function analyzeConfig(root) {
 }
 /**
 * Check package.json dependencies for known libraries.
+*
+* `root` must be forward-slash — joined with `path.posix.join`. Only called
+* from `runCheck`, which normalizes it.
 */
 function checkLibraries(root) {
-	const pkgPath = path.join(root, "package.json");
+	const pkgPath = path.posix.join(root, "package.json");
 	if (!fs.existsSync(pkgPath)) return [];
 	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
 	const allDeps = {
@@ -777,17 +791,19 @@ function checkLibraries(root) {
 }
 /**
 * Check file conventions (pages, app directory, middleware, etc.)
+*
+* `root` must be forward-slash — joined with `path.posix.join`, passed to
+* `findDir`, and used as the base of `path.posix.relative`. Only called from
+* `runCheck`, which normalizes it.
 */
 function checkConventions(root) {
 	const items = [];
-	const pagesDir = findDir(root, "pages", path.join("src", "pages"));
-	const appDirPath = findDir(root, "app", path.join("src", "app"));
-	const hasPages = pagesDir !== null;
-	const hasApp = appDirPath !== null;
-	const hasProxy = fs.existsSync(path.join(root, "proxy.ts")) || fs.existsSync(path.join(root, "proxy.js"));
-	const hasMiddleware = fs.existsSync(path.join(root, "middleware.ts")) || fs.existsSync(path.join(root, "middleware.js"));
+	const pagesDir = findDir(root, "pages", "src/pages");
+	const appDirPath = findDir(root, "app", "src/app");
+	const hasProxy = fs.existsSync(path.posix.join(root, "proxy.ts")) || fs.existsSync(path.posix.join(root, "proxy.js"));
+	const hasMiddleware = fs.existsSync(path.posix.join(root, "middleware.ts")) || fs.existsSync(path.posix.join(root, "middleware.js"));
 	if (pagesDir !== null) {
-		const isSrc = pagesDir.includes(path.join("src", "pages"));
+		const isSrc = pagesDir.includes("src/pages");
 		items.push({
 			name: isSrc ? "Pages Router (src/pages/)" : "Pages Router (pages/)",
 			status: "supported"
@@ -813,7 +829,7 @@ function checkConventions(root) {
 		});
 	}
 	if (appDirPath !== null) {
-		const isSrc = appDirPath.includes(path.join("src", "app"));
+		const isSrc = appDirPath.includes("src/app");
 		items.push({
 			name: isSrc ? "App Router (src/app/)" : "App Router (app/)",
 			status: "supported"
@@ -858,12 +874,12 @@ function checkConventions(root) {
 		name: "middleware.ts (deprecated in Next.js 16)",
 		status: "supported"
 	});
-	if (!hasPages && !hasApp) items.push({
+	if (pagesDir === null && appDirPath === null) items.push({
 		name: "No pages/ or app/ directory found",
 		status: "unsupported",
 		detail: "vinext requires a pages/ or app/ directory"
 	});
-	const pkgPath = path.join(root, "package.json");
+	const pkgPath = path.posix.join(root, "package.json");
 	if (fs.existsSync(pkgPath)) {
 		if (JSON.parse(fs.readFileSync(pkgPath, "utf-8")).type !== "module") items.push({
 			name: "Missing \"type\": \"module\" in package.json",
@@ -877,7 +893,7 @@ function checkConventions(root) {
 	const cjsGlobalFiles = [];
 	for (const file of allSourceFiles) {
 		const content = fs.readFileSync(file, "utf-8");
-		const rel = normalizePathSeparators(path.relative(root, file));
+		const rel = path.posix.relative(root, file);
 		if (viewTransitionRegex.test(content)) viewTransitionFiles.push(rel);
 		if (hasFreeCjsGlobal(content)) cjsGlobalFiles.push(rel);
 	}
@@ -892,7 +908,7 @@ function checkConventions(root) {
 		"postcss.config.js",
 		"postcss.config.cjs"
 	]) {
-		const configPath = path.join(root, configFile);
+		const configPath = path.posix.join(root, configFile);
 		if (fs.existsSync(configPath)) {
 			const content = fs.readFileSync(configPath, "utf-8");
 			if (/plugins\s*:\s*\[\s*['"]/.test(content)) items.push({
@@ -913,6 +929,10 @@ function checkConventions(root) {
 }
 /**
 * Run the full compatibility check.
+*
+* `root` must be forward-slash — callers normalize it at the CLI entry, and it
+* is forwarded to `scanImports` / `checkConventions` / `findDir`, which build
+* paths with `path.posix.*`.
 */
 function runCheck(root) {
 	const imports = scanImports(root);

package/dist/cli.js

@@ -2,6 +2,7 @@
 import { detectPackageManager, ensureViteConfigCompatibility, hasAppDir, hasViteConfig } from "./utils/project.js";
 import { formatReport, runCheck } from "./check.js";
 import { parseArgs } from "./cli-args.js";
+import { normalizePathSeparators } from "./utils/path.js";
 import { PHASE_PRODUCTION_BUILD } from "./shims/constants.js";
 import { createRscCompatibilityId, loadNextConfig, resolveNextConfig } from "./config/next-config.js";
 import { generateRouteTypes } from "./typegen.js";
@@ -440,10 +441,9 @@ async function deployCommand() {
 }
 async function check() {
 	if (parseArgs(rawArgs).help) return printHelp("check");
-	const root = process.cwd();
 	console.log(`\n  vinext check\n`);
 	console.log("  Scanning project...\n");
-	const result = runCheck(root);
+	const result = runCheck(normalizePathSeparators(process.cwd()));
 	console.log(formatReport(result));
 }
 async function typegen() {

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

@@ -272,7 +272,8 @@ type ResolvedNextConfig = {
   aliases: Record<string, string>; /** Extra allowed origins for dev server access (from allowedDevOrigins). */
   allowedDevOrigins: string[]; /** Extra allowed origins for server action CSRF validation (from experimental.serverActions.allowedOrigins). */
   serverActionsAllowedOrigins: string[]; /** Packages whose barrel imports should be optimized (from experimental.optimizePackageImports). */
-  optimizePackageImports: string[]; /** Inline app CSS into production HTML (from experimental.inlineCss). */
+  optimizePackageImports: string[]; /** Packages explicitly requested for server/client transpilation. */
+  transpilePackages: string[]; /** Inline app CSS into production HTML (from experimental.inlineCss). */
   inlineCss: boolean; /** Parsed body size limit for server actions in bytes (from experimental.serverActions.bodySizeLimit). Defaults to 1MB. */
   serverActionsBodySizeLimit: number; /** Verbatim body size limit config value (e.g. "2mb") for the "Body exceeded {limit} limit" error. Defaults to "1 MB". */
   serverActionsBodySizeLimitLabel: string; /** Route-level expire fallback in seconds for ISR entries with numeric revalidate. */

package/dist/config/next-config.js

@@ -569,6 +569,7 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 			allowedDevOrigins: [],
 			serverActionsAllowedOrigins: [],
 			optimizePackageImports: [],
+			transpilePackages: [],
 			inlineCss: false,
 			serverActionsBodySizeLimit: 1 * 1024 * 1024,
 			serverActionsBodySizeLimitLabel: "1 MB",
@@ -666,6 +667,7 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 	const topLevelServerExternalPackages = Array.isArray(config.serverExternalPackages) ? readStringArray(config.serverExternalPackages) : void 0;
 	const legacyServerComponentsExternal = readStringArray(experimental?.serverComponentsExternalPackages);
 	const serverExternalPackages = topLevelServerExternalPackages ?? legacyServerComponentsExternal;
+	const transpilePackages = readStringArray(config.transpilePackages);
 	if (experimental?.swcEnvOptions !== void 0) console.warn("[vinext] next.config option \"experimental.swcEnvOptions\" is not applicable and will be ignored (vinext uses Vite, not SWC). A Vite-compatible polyfill solution may be explored in the future.");
 	if (experimental?.rootParams !== void 0) console.warn("[vinext] `experimental.rootParams` is no longer needed, because `next/root-params` is available by default. You can remove it from next.config.(js|mjs|ts).");
 	const useLightningcss = experimental?.useLightningcss === true;
@@ -728,6 +730,7 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 		allowedDevOrigins,
 		serverActionsAllowedOrigins,
 		optimizePackageImports,
+		transpilePackages,
 		inlineCss,
 		serverActionsBodySizeLimit,
 		serverActionsBodySizeLimitLabel,

package/dist/config/server-external-packages.d.ts

@@ -0,0 +1,4 @@
+//#region src/config/server-external-packages.d.ts
+declare function mergeServerExternalPackages(userPackages?: readonly string[], transpilePackages?: readonly string[]): string[];
+//#endregion
+export { mergeServerExternalPackages };

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

@@ -0,0 +1,91 @@
+//#region src/config/server-external-packages.ts
+const DEFAULT_SERVER_EXTERNAL_PACKAGES = [
+	"@alinea/generated",
+	"@appsignal/nodejs",
+	"@aws-sdk/client-s3",
+	"@aws-sdk/s3-presigned-post",
+	"@blockfrost/blockfrost-js",
+	"@highlight-run/node",
+	"@huggingface/transformers",
+	"@jpg-store/lucid-cardano",
+	"@libsql/client",
+	"@mikro-orm/core",
+	"@mikro-orm/knex",
+	"@node-rs/argon2",
+	"@node-rs/bcrypt",
+	"@prisma/client",
+	"@react-pdf/renderer",
+	"@sentry/profiling-node",
+	"@sparticuz/chromium",
+	"@sparticuz/chromium-min",
+	"@statsig/statsig-node-core",
+	"@swc/core",
+	"@xenova/transformers",
+	"@zenstackhq/runtime",
+	"argon2",
+	"autoprefixer",
+	"aws-crt",
+	"bcrypt",
+	"better-sqlite3",
+	"canvas",
+	"chromadb-default-embed",
+	"config",
+	"cpu-features",
+	"cypress",
+	"dd-trace",
+	"eslint",
+	"express",
+	"firebase-admin",
+	"htmlrewriter",
+	"import-in-the-middle",
+	"isolated-vm",
+	"jest",
+	"jsdom",
+	"keyv",
+	"libsql",
+	"mdx-bundler",
+	"mongodb",
+	"mongoose",
+	"newrelic",
+	"next-mdx-remote",
+	"next-seo",
+	"node-cron",
+	"node-pty",
+	"node-web-audio-api",
+	"onnxruntime-node",
+	"oslo",
+	"pg",
+	"pino",
+	"pino-pretty",
+	"pino-roll",
+	"playwright",
+	"playwright-core",
+	"postcss",
+	"prettier",
+	"prisma",
+	"puppeteer",
+	"puppeteer-core",
+	"ravendb",
+	"require-in-the-middle",
+	"rimraf",
+	"sharp",
+	"shiki",
+	"sqlite3",
+	"thread-stream",
+	"ts-morph",
+	"ts-node",
+	"typescript",
+	"vscode-oniguruma",
+	"webpack",
+	"websocket",
+	"zeromq"
+];
+function mergeServerExternalPackages(userPackages = [], transpilePackages = []) {
+	const transpiled = new Set(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])];
+}
+//#endregion
+export { mergeServerExternalPackages };

package/dist/deploy.d.ts

@@ -58,6 +58,13 @@ declare function formatMissingCloudflarePluginError(options: {
   isAppRouter: boolean;
   configFile?: string;
 }): string;
+/**
+ * Detect the project structure (router, config, worker entry, package name).
+ *
+ * `root` must be forward-slash — it is joined with `path.posix.*`, passed to
+ * `findDir` / `hasAppDir`, and used as the base of `path.posix.basename`.
+ * Callers normalize it at the deploy entry.
+ */
 declare function detectProject(root: string): ProjectInfo;
 /** @see {@link _ensureESModule} */
 declare const ensureESModule: typeof ensureESModule$1;

package/dist/deploy.js

@@ -1,6 +1,7 @@
 import { detectPackageManager as detectPackageManager$1, ensureESModule as ensureESModule$1, findDir, findInNodeModules, hasAppDir, renameCJSConfigs as renameCJSConfigs$1 } from "./utils/project.js";
 import { parsePositiveIntegerArg } from "./cli-args.js";
 import { escapeRegExp } from "./utils/regex.js";
+import { normalizePathSeparators } from "./utils/path.js";
 import { loadNextConfig, resolveNextConfig } from "./config/next-config.js";
 import { getReactUpgradeDeps } from "./init.js";
 import { runTPR } from "./cloudflare/tpr.js";
@@ -107,23 +108,30 @@ function formatMissingCloudflarePluginError(options) {
 	const configRef = options.configFile ? options.configFile : "your Vite config";
 	return `[vinext] Missing @cloudflare/vite-plugin in ${configRef}.\n\n  Cloudflare Workers builds require the cloudflare() plugin.\n  Add it to ${configRef}:\n\n    import { cloudflare } from "@cloudflare/vite-plugin";\n\n    export default defineConfig({\n      plugins: [\n        vinext(),\n        cloudflare(${cfArg}),\n      ],\n    });\n\n  Or delete ${configRef} and re-run \`vinext deploy\` to auto-generate it.`;
 }
+/**
+* Detect the project structure (router, config, worker entry, package name).
+*
+* `root` must be forward-slash — it is joined with `path.posix.*`, passed to
+* `findDir` / `hasAppDir`, and used as the base of `path.posix.basename`.
+* Callers normalize it at the deploy entry.
+*/
 function detectProject(root) {
 	const hasApp = hasAppDir(root);
-	const hasPages = findDir(root, "pages", path.join("src", "pages")) !== null;
+	const hasPages = findDir(root, "pages", "src/pages") !== null;
 	const isAppRouter = hasApp;
 	const isPagesRouter = !hasApp && hasPages;
-	const hasViteConfig = fs.existsSync(path.join(root, "vite.config.ts")) || fs.existsSync(path.join(root, "vite.config.js")) || fs.existsSync(path.join(root, "vite.config.mjs"));
+	const hasViteConfig = fs.existsSync(path.posix.join(root, "vite.config.ts")) || fs.existsSync(path.posix.join(root, "vite.config.js")) || fs.existsSync(path.posix.join(root, "vite.config.mjs"));
 	const wranglerConfigExists = hasWranglerConfig(root);
-	const hasWorkerEntry = fs.existsSync(path.join(root, "worker", "index.ts")) || fs.existsSync(path.join(root, "worker", "index.js"));
+	const hasWorkerEntry = fs.existsSync(path.posix.join(root, "worker", "index.ts")) || fs.existsSync(path.posix.join(root, "worker", "index.js"));
 	const hasCloudflarePlugin = findInNodeModules(root, "@cloudflare/vite-plugin") !== null;
 	const hasRscPlugin = findInNodeModules(root, "@vitejs/plugin-rsc") !== null;
 	const hasWrangler = findInNodeModules(root, ".bin/wrangler") !== null;
-	const pkgPath = path.join(root, "package.json");
+	const pkgPath = path.posix.join(root, "package.json");
 	let pkg = null;
 	if (fs.existsSync(pkgPath)) try {
 		pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
 	} catch {}
-	let projectName = path.basename(root);
+	let projectName = path.posix.basename(root);
 	if (pkg?.name && typeof pkg.name === "string") projectName = pkg.name.replace(/^@[^/]+\//, "").toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
 	const hasTypeModule = pkg?.type === "module";
 	let hasISR = false;
@@ -380,6 +388,7 @@ import { handleImageOptimization, DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, isI
 import type { ImageConfig } from "vinext/server/image-optimization";
 import { cloneRequestWithHeaders, cloneRequestWithUrl, filterInternalHeaders, isOpenRedirectShaped } from "vinext/server/request-pipeline";
 import { notFoundStaticAssetResponse } from "vinext/server/http-error-responses";
+import { finalizeMissingStaticAssetResponse } from "vinext/server/worker-utils";
 import { assetPrefixPathname, isNextStaticPath } from "vinext/utils/asset-prefix";
 import { hasBasePath, stripBasePath } from "vinext/utils/base-path";
 
@@ -438,15 +447,11 @@ export default {
         return new Response("This page could not be found", { status: 404 });
       }
 
-      // Invalid \`_next/static/*\` paths short-circuit with a plain-text 404
-      // instead of falling through to renderPage (which would render the full
-      // HTML 404 page with bootstrap scripts + CSS). Valid assets are served
-      // by Cloudflare's ASSETS binding BEFORE the worker runs; only misses
-      // reach this code. Matches Next.js (#1337):
-      //   packages/next/src/server/lib/router-server.ts
-      if (isNextStaticPath(pathname, basePath, assetPathPrefix)) {
-        return notFoundStaticAssetResponse();
-      }
+      // Valid assets are served by Cloudflare's ASSETS binding before the
+      // worker runs. Missing asset-shaped requests still need to reach
+      // middleware so it can rewrite or respond; a final 404 is converted
+      // back to Next.js's canonical plain-text static-file response below.
+      const missingBuildAsset = isNextStaticPath(pathname, basePath, assetPathPrefix);
 
       // Strip internal headers from inbound requests so they cannot be
       // forged to influence routing or impersonate internal state.
@@ -538,10 +543,12 @@ export default {
 
       const result = await runPagesRequest(request, deps);
       if (result.type === "response") {
-        return result.response;
+        return finalizeMissingStaticAssetResponse(result.response, missingBuildAsset);
       }
       // Should not reach here for prod/worker (all callbacks supplied).
-      return new Response("This page could not be found", { status: 404 });
+      return missingBuildAsset
+        ? notFoundStaticAssetResponse()
+        : new Response("This page could not be found", { status: 404 });
 
     } catch (error) {
       console.error("[vinext] Worker error:", error);
@@ -945,7 +952,7 @@ async function deploy(options) {
 		mode: "production"
 	});
 	console.log("\n  vinext deploy\n");
-	const info = detectProject(root);
+	const info = detectProject(normalizePathSeparators(root));
 	if (!info.isAppRouter && !info.isPagesRouter) {
 		console.error("  Error: No app/ or pages/ directory found.");
 		console.error("  vinext deploy requires a Next.js project with an app/ or pages/ directory");
@@ -973,7 +980,7 @@ async function deploy(options) {
 		console.log();
 		installDeps(root, missingDeps);
 		const nameOverride = options.name ? info.projectName : void 0;
-		Object.assign(info, detectProject(root));
+		Object.assign(info, detectProject(normalizePathSeparators(root)));
 		if (nameOverride) info.projectName = nameOverride;
 	}
 	if (!info.hasTypeModule) {

package/dist/entries/app-rsc-entry.d.ts

@@ -44,7 +44,8 @@ type AppRouterConfig = {
   reactMaxHeadersLength?: number; /** Maximum in-memory cache size in bytes. 0 disables the default memory cache. */
   cacheMaxMemorySize?: number; /** Inline app CSS into production HTML (from experimental.inlineCss). */
   inlineCss?: boolean; /** Enables Next.js Cache Components semantics for App Router document HTML. */
-  cacheComponents?: boolean; /** Internationalization routing config for middleware matcher locale handling. */
+  cacheComponents?: boolean; /** Whether the RSC build discovered any server references. Defaults to true. */
+  hasServerActions?: boolean; /** Internationalization routing config for middleware matcher locale handling. */
   i18n?: NextI18nConfig | null;
   imageConfig?: ImageConfig;
   /**