vinext 0.1.8 → 0.2.1

package/dist/check.js

@@ -1,4 +1,5 @@
 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";
@@ -192,7 +193,7 @@ const CONFIG_SUPPORT = {
 	env: { status: "supported" },
 	images: {
 		status: "partial",
-		detail: "remotePatterns validated, no local optimization"
+		detail: "remotePatterns validated; on-the-fly optimization via images.optimizer (Cloudflare Images), passthrough otherwise"
 	},
 	allowedDevOrigins: {
 		status: "supported",
@@ -258,13 +259,49 @@ const CONFIG_SUPPORT = {
 		status: "partial",
 		detail: "config recognized; vinext does not implement navigation result caching"
 	},
+	"experimental.middlewarePrefetch": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.proxyPrefetch": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.middlewareClientMaxBodySize": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.proxyClientMaxBodySize": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.externalMiddlewareRewritesResolve": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.externalProxyRewritesResolve": {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	"experimental.instrumentationHook": {
+		status: "unsupported",
+		detail: "not recognized; instrumentation files are enabled automatically"
+	},
+	skipMiddlewareUrlNormalize: {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
+	skipProxyUrlNormalize: {
+		status: "unsupported",
+		detail: "not recognized; use of this option is ignored"
+	},
 	"i18n.domains": {
 		status: "partial",
 		detail: "supported for Pages Router; App Router unchanged"
 	},
 	reactStrictMode: {
 		status: "partial",
-		detail: "config option recognized but not yet enforced; root is not wrapped in <React.StrictMode>"
+		detail: "enforced for the Pages Router (client root wrapped in <React.StrictMode> when true); App Router is not yet wrapped (Next.js defaults App Router strict mode on)"
 	},
 	poweredByHeader: {
 		status: "supported",
@@ -552,9 +589,8 @@ 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.
+* `root` must be forward-slash: it is passed to `findSourceFiles`, which
+* requires it.
 */
 function scanImports(root) {
 	const files = findSourceFiles(root);
@@ -572,7 +608,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 = path.posix.relative(root, file);
+				const relFile = normalizePathSeparators(path.relative(root, file));
 				const usedInFiles = importUsage.get(normalized) ?? [];
 				if (!usedInFiles.includes(relFile)) usedInFiles.push(relFile);
 			}
@@ -740,7 +776,9 @@ function analyzeConfig(root) {
 		"transpilePackages",
 		"webpack",
 		"reactStrictMode",
-		"poweredByHeader"
+		"poweredByHeader",
+		"skipMiddlewareUrlNormalize",
+		"skipProxyUrlNormalize"
 	]) {
 		if (!present.top.has(opt)) continue;
 		const support = CONFIG_SUPPORT[opt];
@@ -792,9 +830,8 @@ 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.
+* `root` must be forward-slash — joined with `path.posix.join` and passed to
+* `findDir`. Only called from `runCheck`, which normalizes it.
 */
 function checkConventions(root) {
 	const items = [];
@@ -893,7 +930,7 @@ function checkConventions(root) {
 	const cjsGlobalFiles = [];
 	for (const file of allSourceFiles) {
 		const content = fs.readFileSync(file, "utf-8");
-		const rel = path.posix.relative(root, file);
+		const rel = normalizePathSeparators(path.relative(root, file));
 		if (viewTransitionRegex.test(content)) viewTransitionFiles.push(rel);
 		if (hasFreeCjsGlobal(content)) cjsGlobalFiles.push(rel);
 	}

package/dist/cli-args.d.ts

@@ -18,7 +18,6 @@ type ParsedArgs = {
   precompress?: boolean;
   positionals?: string[];
 };
-declare function parsePositiveIntegerArg(raw: string, flag: string): number;
 /**
  * Parse CLI arguments into a structured object.
  *
@@ -30,4 +29,4 @@ declare function parsePositiveIntegerArg(raw: string, flag: string): number;
  */
 declare function parseArgs(args: string[]): ParsedArgs;
 //#endregion
-export { parseArgs, parsePositiveIntegerArg };
+export { parseArgs };

package/dist/cli-args.js

@@ -121,4 +121,4 @@ function parseArgs(args) {
 	return result;
 }
 //#endregion
-export { parseArgs, parsePositiveIntegerArg };
+export { parseArgs };

package/dist/cli-dev-config.d.ts

@@ -0,0 +1,12 @@
+import { Plugin, ServerOptions } from "vite";
+
+//#region src/cli-dev-config.d.ts
+type DevServerCliOptions = {
+  port?: number;
+  hostname?: string;
+};
+declare function applyDevServerDefaults(server: ServerOptions, options: DevServerCliOptions): void;
+declare function createDevServerConfigPlugin(options: DevServerCliOptions): Plugin;
+declare function normalizeDevServerHostname(host: string | boolean | undefined): string;
+//#endregion
+export { DevServerCliOptions, applyDevServerDefaults, createDevServerConfigPlugin, normalizeDevServerHostname };

package/dist/cli-dev-config.js

@@ -0,0 +1,23 @@
+//#region src/cli-dev-config.ts
+function applyDevServerDefaults(server, options) {
+	server.port = options.port ?? server.port ?? 3e3;
+	server.host = options.hostname ?? server.host ?? "localhost";
+}
+function createDevServerConfigPlugin(options) {
+	return {
+		name: "vinext:dev-server-config",
+		enforce: "post",
+		config: {
+			order: "post",
+			handler(config) {
+				applyDevServerDefaults(config.server ??= {}, options);
+			}
+		}
+	};
+}
+function normalizeDevServerHostname(host) {
+	if (typeof host === "string") return host;
+	return host === true ? "0.0.0.0" : "localhost";
+}
+//#endregion
+export { applyDevServerDefaults, createDevServerConfigPlugin, normalizeDevServerHostname };

package/dist/cli.js

@@ -1,16 +1,22 @@
 #!/usr/bin/env node
 import { detectPackageManager, ensureViteConfigCompatibility, hasAppDir, hasViteConfig } from "./utils/project.js";
+import { normalizePathSeparators } from "./utils/path.js";
 import { formatReport, runCheck } from "./check.js";
 import { parseArgs } from "./cli-args.js";
-import { normalizePathSeparators } from "./utils/path.js";
+import { createDevServerConfigPlugin, normalizeDevServerHostname } from "./cli-dev-config.js";
 import { PHASE_PRODUCTION_BUILD } from "./shims/constants.js";
 import { createRscCompatibilityId, loadNextConfig, resolveNextConfig } from "./config/next-config.js";
 import { generateRouteTypes } from "./typegen.js";
-import { getReactUpgradeDeps, init } from "./init.js";
+import { clearPagesClientAssetsBuildMetadata } from "./build/pages-client-assets-module.js";
+import { findVinextPrerenderConfigInPlugins, formatVinextPrerenderLabel, resolveVinextPrerenderDecision } from "./config/prerender.js";
+import vinext from "./index.js";
 import { runPrerender } from "./build/run-prerender.js";
 import { loadDotenv } from "./config/dotenv.js";
-import { deploy, parseDeployArgs } from "./deploy.js";
-import vinext from "./index.js";
+import { deploy, parseDeployArgs } from "./packages/cloudflare/src/deploy.js";
+import { printDeployHelp } from "./packages/cloudflare/src/deploy-help.js";
+import { getReactUpgradeDeps } from "./utils/react-version.js";
+import { init } from "./init.js";
+import { INIT_PLATFORMS, resolveInitPlatform, resolveInitPrerender } from "./init-platform.js";
 import { resolveVinextPackageRoot } from "./utils/vinext-root.js";
 import { emitStandaloneOutput } from "./build/standalone.js";
 import { cleanBuildOutput } from "./build/clean-output.js";
@@ -28,7 +34,7 @@ import { execFileSync } from "node:child_process";
 *   vinext dev     Start development server (Vite)
 *   vinext build   Build for production
 *   vinext start   Start production server
-*   vinext deploy  Deploy to Cloudflare Workers
+*   vinext deploy  Deprecated Cloudflare deploy shim
 *   vinext typegen Generate App Router route helper types
 *   vinext lint    Run linter (delegates to eslint/oxlint)
 *
@@ -121,13 +127,17 @@ function createBuildLogger(vite) {
 function hasPagesDir() {
 	return fs.existsSync(path.join(process.cwd(), "pages")) || fs.existsSync(path.join(process.cwd(), "src", "pages"));
 }
-async function loadBuildEmptyOutDir(vite, root) {
-	if (!hasViteConfig(root)) return void 0;
-	const emptyOutDir = (await vite.loadConfigFromFile({
+async function loadBuildViteConfigMetadata(vite, root) {
+	if (!hasViteConfig(root)) return { prerenderConfig: null };
+	const loaded = await vite.loadConfigFromFile({
 		command: "build",
 		mode: "production"
-	}, void 0, root))?.config.build?.emptyOutDir;
-	return typeof emptyOutDir === "boolean" ? emptyOutDir : void 0;
+	}, void 0, root);
+	const emptyOutDir = loaded?.config.build?.emptyOutDir;
+	return {
+		emptyOutDir: typeof emptyOutDir === "boolean" ? emptyOutDir : void 0,
+		prerenderConfig: findVinextPrerenderConfigInPlugins(loaded?.config.plugins)
+	};
 }
 /**
 * Build the Vite config automatically. If a vite.config.ts exists in the
@@ -180,20 +190,20 @@ async function dev() {
 	});
 	applyViteConfigCompatibility(process.cwd());
 	const vite = await loadVite();
-	const port = parsed.port ?? 3e3;
-	const host = parsed.hostname ?? "localhost";
+	const initialPort = parsed.port ?? 3e3;
+	const initialHost = parsed.hostname ?? "localhost";
 	let lockfile;
 	const startedAt = Date.now();
 	if (process.env.VINEXT_NO_DEV_LOCK !== "1") {
 		const root = process.cwd();
-		const initialDisplayHost = host === "0.0.0.0" ? "localhost" : host;
+		const initialDisplayHost = initialHost === "0.0.0.0" ? "localhost" : initialHost;
 		const acquired = tryAcquireLockfile({
 			root,
 			info: {
 				pid: process.pid,
-				port,
-				hostname: host,
-				appUrl: `http://${initialDisplayHost}:${port}`,
+				port: initialPort,
+				hostname: initialHost,
+				appUrl: `http://${initialDisplayHost}:${initialPort}`,
 				startedAt,
 				cwd: root
 			}
@@ -209,13 +219,21 @@ async function dev() {
 		lockfile = acquired.lockfile;
 	}
 	console.log(`\n  vinext dev  (Vite ${getViteVersion()})\n`);
-	const config = buildViteConfig({ server: {
-		port,
-		host
-	} });
+	const config = buildViteConfig();
+	(config.plugins ??= []).push(createDevServerConfigPlugin(parsed));
 	let server;
 	try {
 		server = await vite.createServer(config);
+		const port = server.config.server.port ?? 3e3;
+		const host = normalizeDevServerHostname(server.config.server.host);
+		lockfile?.update({
+			pid: process.pid,
+			port,
+			hostname: host,
+			appUrl: `http://${host === "0.0.0.0" ? "localhost" : host}:${port}`,
+			startedAt,
+			cwd: process.cwd()
+		});
 		await server.listen();
 	} catch (err) {
 		lockfile?.release();
@@ -223,8 +241,10 @@ async function dev() {
 	}
 	server.printUrls();
 	if (lockfile) {
+		const configuredPort = server.config.server.port ?? 3e3;
+		const configuredHost = normalizeDevServerHostname(server.config.server.host);
 		const resolved = server.resolvedUrls?.local[0];
-		let actualPort = port;
+		let actualPort = configuredPort;
 		let appUrl;
 		if (resolved) {
 			appUrl = resolved.replace(/\/$/, "");
@@ -234,13 +254,13 @@ async function dev() {
 			} catch {}
 		} else {
 			const address = server.httpServer?.address();
-			actualPort = typeof address === "object" && address ? address.port : port;
-			appUrl = `http://${host === "0.0.0.0" ? "localhost" : host}:${actualPort}`;
+			actualPort = typeof address === "object" && address ? address.port : configuredPort;
+			appUrl = `http://${configuredHost === "0.0.0.0" ? "localhost" : configuredHost}:${actualPort}`;
 		}
 		lockfile.update({
 			pid: process.pid,
 			port: actualPort,
-			hostname: host,
+			hostname: configuredHost,
 			appUrl,
 			startedAt,
 			cwd: process.cwd()
@@ -261,7 +281,7 @@ async function buildApp() {
 	const withBuildBundlerOptions = (bundlerOptions) => viteMajorVersion >= 8 ? { rolldownOptions: bundlerOptions } : { rollupOptions: bundlerOptions };
 	console.log(`\n  vinext build  (Vite ${getViteVersion()})\n`);
 	const root = process.cwd();
-	const isApp = hasAppDir(process.cwd());
+	const isApp = hasAppDir(normalizePathSeparators(root));
 	const resolvedNextConfig = await resolveNextConfig(await loadNextConfig(root, PHASE_PRODUCTION_BUILD), root);
 	process.env.__VINEXT_SHARED_BUILD_ID = resolvedNextConfig.buildId;
 	process.env.__VINEXT_SHARED_RSC_COMPATIBILITY_ID = createRscCompatibilityId(resolvedNextConfig);
@@ -288,15 +308,19 @@ async function buildApp() {
 			});
 		}
 	}
+	const buildConfigMetadata = await loadBuildViteConfigMetadata(vite, root);
 	cleanBuildOutput({
 		root,
 		outDir: distDir,
-		emptyOutDir: await loadBuildEmptyOutDir(vite, root)
+		emptyOutDir: buildConfigMetadata.emptyOutDir
 	});
-	const config = buildViteConfig({}, logger);
-	await (await vite.createBuilder(config)).buildApp();
-	if (isApp) {
-		if (hasPagesDir()) {
+	const isHybrid = isApp && hasPagesDir();
+	const pagesClientAssetsBuildSession = isHybrid ? randomBytes(16).toString("hex") : null;
+	if (pagesClientAssetsBuildSession) process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION = pagesClientAssetsBuildSession;
+	try {
+		const config = buildViteConfig({}, logger);
+		await (await vite.createBuilder(config)).buildApp();
+		if (isHybrid) {
 			console.log("  Building Pages Router server (hybrid)...");
 			const root = process.cwd();
 			let userTransformPlugins = [];
@@ -327,6 +351,11 @@ async function buildApp() {
 				}
 			});
 		}
+	} finally {
+		if (pagesClientAssetsBuildSession) {
+			clearPagesClientAssetsBuildMetadata(pagesClientAssetsBuildSession);
+			if (process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION === pagesClientAssetsBuildSession) delete process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION;
+		}
 	}
 	if (outputMode === "standalone") {
 		const standalone = emitStandaloneOutput({
@@ -338,23 +367,27 @@ async function buildApp() {
 		return process.exit(0);
 	}
 	let prerenderResult;
-	if (parsed.prerenderAll || resolvedNextConfig.output === "export") {
+	const prerenderDecision = resolveVinextPrerenderDecision({
+		prerenderAllFlag: parsed.prerenderAll,
+		vinextPrerenderConfig: buildConfigMetadata.prerenderConfig,
+		nextOutput: resolvedNextConfig.output
+	});
+	if (prerenderDecision) {
 		if (resolvedNextConfig.enablePrerenderSourceMaps) {
 			process.setSourceMapsEnabled(true);
 			Error.stackTraceLimit = Math.max(Error.stackTraceLimit, 50);
 		}
-		const label = parsed.prerenderAll ? "Pre-rendering all routes..." : "Pre-rendering all routes (output: 'export')...";
 		process.stdout.write("\x1B[0m");
-		console.log(`  ${label}`);
+		console.log(`  ${formatVinextPrerenderLabel(prerenderDecision)}`);
 		prerenderResult = await runPrerender({
-			root: process.cwd(),
+			root: normalizePathSeparators(process.cwd()),
 			concurrency: parsed.prerenderConcurrency
 		});
 	}
 	process.stdout.write("\x1B[0m");
 	const { printBuildReport } = await import("./build/report.js");
 	await printBuildReport({
-		root: process.cwd(),
+		root: normalizePathSeparators(process.cwd()),
 		pageExtensions: resolvedNextConfig.pageExtensions,
 		prerenderResult: prerenderResult ?? void 0
 	});
@@ -421,7 +454,12 @@ async function lint() {
 }
 async function deployCommand() {
 	const parsed = parseDeployArgs(rawArgs);
-	if (parsed.help) return printHelp("deploy");
+	if (parsed.help) {
+		printDeployDeprecationWarning();
+		printDeployHelp();
+		return;
+	}
+	printDeployDeprecationWarning();
 	await loadVite();
 	console.log(`\n  vinext deploy  (Vite ${getViteVersion()})\n`);
 	await deploy({
@@ -439,6 +477,9 @@ async function deployCommand() {
 		tprWindow: parsed.tprWindow
 	});
 }
+function printDeployDeprecationWarning() {
+	console.log("  ⚠️  Warning: `vinext deploy` has moved to the `@vinext/cloudflare` package.\n  Please switch to `npx @vinext/cloudflare deploy` or `vp exec vinext-cloudflare deploy`; this compatibility command will be removed in a future release.\n");
+}
 async function check() {
 	if (parseArgs(rawArgs).help) return printHelp("check");
 	console.log(`\n  vinext check\n`);
@@ -467,11 +508,17 @@ async function initCommand() {
 	const port = parsed.port ?? 3001;
 	const skipCheck = rawArgs.includes("--skip-check");
 	const force = rawArgs.includes("--force");
+	const platform = await resolveInitPlatform(rawArgs);
+	const platformOptions = await INIT_PLATFORMS[platform].options(rawArgs);
+	const prerender = await resolveInitPrerender(rawArgs);
 	await init({
 		root: process.cwd(),
 		port,
 		skipCheck,
-		force
+		force,
+		platform,
+		prerender,
+		cloudflare: platform === "cloudflare" ? platformOptions : void 0
 	});
 }
 function printHelp(cmd) {
@@ -501,8 +548,8 @@ function printHelp(cmd) {
 
   Options:
     --verbose            Show full Vite/Rollup build output (suppressed by default)
-    --prerender-all      Pre-render discovered routes after building (future releases
-                         will serve these files in vinext start)
+    --prerender-all      Pre-render discovered routes after building. Equivalent
+                         to vinext({ prerender: true }) and takes priority.
     --prerender-concurrency <count>
                          Maximum number of routes to pre-render in parallel
     --precompress        Precompress static assets at build time (.br, .gz, .zst)
@@ -528,52 +575,8 @@ function printHelp(cmd) {
 		return;
 	}
 	if (cmd === "deploy") {
-		console.log(`
-  vinext deploy - Deploy to Cloudflare Workers
-
-  Usage: vinext deploy [options]
-
-  One-command deployment to Cloudflare Workers. Automatically:
-    - Detects App Router or Pages Router
-    - Generates wrangler.jsonc, worker/index.ts, vite.config.ts if missing
-    - Installs @cloudflare/vite-plugin and wrangler if needed
-    - Builds the project with Vite
-    - Deploys via wrangler
-
-  Options:
-    --preview                Deploy to preview environment (same as --env preview)
-    --env <name>             Deploy using wrangler env.<name>
-    --name <name>            Custom Worker name (default: from package.json)
-    --skip-build             Skip the build step (use existing dist/)
-    --dry-run                Generate config files without building or deploying
-    --prerender-all          Pre-render discovered routes after building (future
-                             releases will auto-populate the remote cache)
-    --prerender-concurrency <count>
-                             Maximum number of routes to pre-render in parallel
-    -h, --help               Show this help
-
-  Experimental:
-    --experimental-tpr               Enable Traffic-aware Pre-Rendering
-    --tpr-coverage <pct>             Traffic coverage target, 0–100 (default: 90)
-    --tpr-limit <count>              Hard cap on pages to pre-render (default: 1000)
-    --tpr-window <hours>             Analytics lookback window in hours (default: 24)
-
-  TPR (Traffic-aware Pre-Rendering) uses Cloudflare zone analytics to determine
-  which pages get the most traffic and pre-renders them into KV cache during
-  deploy. This feature is experimental and must be explicitly enabled. Requires
-  a custom domain (zone analytics are unavailable on *.workers.dev) and the
-  CLOUDFLARE_API_TOKEN environment variable with Zone.Analytics read permission.
-
-  Examples:
-    vinext deploy                              Build and deploy to production
-    vinext deploy --preview                    Deploy to a preview URL
-    vinext deploy --env staging                Deploy using wrangler env.staging
-    vinext deploy --dry-run                    See what files would be generated
-    vinext deploy --name my-app                Deploy with a custom Worker name
-    vinext deploy --experimental-tpr           Enable TPR during deploy
-    vinext deploy --experimental-tpr --tpr-coverage 95   Cover 95% of traffic
-    vinext deploy --experimental-tpr --tpr-limit 500     Cap at 500 pages
-`);
+		printDeployDeprecationWarning();
+		printDeployHelp();
 		return;
 	}
 	if (cmd === "check") {
@@ -605,10 +608,23 @@ function printHelp(cmd) {
     -p, --port <port>    Dev server port for the vinext script (default: 3001)
     --skip-check         Skip the compatibility check step
     --force              Overwrite existing vite.config.ts
+    --platform <target>  Deployment target: cloudflare or node
+    --prerender          Configure vinext build to pre-render all static routes
+                         (default: prompt, with No selected by default)
+    --data-cache <type>  Cloudflare data cache: kv or none (default: kv)
+    --image-optimization <type>
+                         Cloudflare image optimization: cloudflare-images or none
     -h, --help           Show this help
 
   Examples:
-    vinext init                   Migrate with defaults
+    vinext init                   Prompt for a deployment platform
+    vinext init --platform=cloudflare  Configure Cloudflare Workers (default)
+    vinext init --platform=cloudflare --data-cache=kv
+                                Configure the default Cloudflare cache handlers
+    vinext init --platform=cloudflare --image-optimization=none
+                                Do not configure Cloudflare Images
+    vinext init --prerender     Add prerender: { routes: "*" } to vite.config.ts
+    vinext init --platform=node   Configure a Node deployment
     vinext init -p 4000           Use port 4000 for dev:vinext
     vinext init --force           Overwrite existing vite.config.ts
     vinext init --skip-check      Skip the compatibility report
@@ -653,7 +669,6 @@ function printHelp(cmd) {
     dev      Start development server
     build    Build for production
     start    Start production server
-    deploy   Deploy to Cloudflare Workers
     typegen  Generate App Router route helper types
     init     Migrate a Next.js project to vinext
     check    Scan Next.js app for compatibility
@@ -664,15 +679,16 @@ function printHelp(cmd) {
     --version      Show version
 
   Examples:
-    vinext dev                  Start dev server on port 3000
-    vinext dev -p 4000          Start dev server on port 4000
-    vinext build                Build for production
-    vinext typegen              Generate route helper types
-    vinext start                Start production server
-    vinext deploy               Deploy to Cloudflare Workers
-    vinext init                 Migrate a Next.js project
-    vinext check                Check compatibility
-    vinext lint                 Run linter
+    vinext dev                         Start dev server on port 3000
+    vinext dev -p 4000                 Start dev server on port 4000
+    vinext build                       Build for production
+    vinext typegen                     Generate route helper types
+    vinext start                       Start production server
+    vinext init                        Migrate a Next.js project
+    vinext check                       Check compatibility
+    vinext lint                        Run linter
+    npx @vinext/cloudflare deploy      Deploy to Cloudflare Workers
+    vp exec vinext-cloudflare deploy   Deploy to Cloudflare Workers with Vite+
 
   vinext is a drop-in replacement for the \`next\` CLI.
   No vite.config.ts needed — just run \`vinext dev\` in your Next.js project.

package/dist/{server → client}/dev-error-overlay-store.d.ts

@@ -1,4 +1,4 @@
-//#region src/server/dev-error-overlay-store.d.ts
+//#region src/client/dev-error-overlay-store.d.ts
 type Source = "server" | "vite" | "uncaught" | "caught" | "window-error" | "unhandledrejection";
 type ReportedError = {
   id: number;

package/dist/{server → client}/dev-error-overlay-store.js

@@ -1,4 +1,4 @@
-//#region src/server/dev-error-overlay-store.ts
+//#region src/client/dev-error-overlay-store.ts
 const MAX_DEV_OVERLAY_ERRORS = 50;
 let snapshot = {
 	errors: [],

package/dist/{server → client}/dev-error-overlay.d.ts

@@ -1,6 +1,6 @@
 import { ReportedError, dismissOverlay } from "./dev-error-overlay-store.js";
 
-//#region src/server/dev-error-overlay.d.ts
+//#region src/client/dev-error-overlay.d.ts
 declare const DEV_ERROR_OVERLAY_HOST_ID = "__vinext_dev_error_overlay_root";
 declare const DEV_ERROR_OVERLAY_MOUNT_ID = "__vinext_dev_error_overlay_mount";
 declare function installDevErrorOverlay(): void;

package/dist/{server → client}/dev-error-overlay.js

@@ -1,11 +1,11 @@
 import { VINEXT_DEV_ERROR_RECOVERY_EVENT } from "../utils/dev-error-recovery-event.js";
 import { isNavigationSignalError } from "../utils/navigation-signal.js";
-import { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT } from "./dev-stack-sourcemap-endpoint.js";
+import { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT } from "../utils/dev-stack-sourcemap-endpoint.js";
 import { dismissOverlay, expandOverlay, getOverlaySnapshot, minimizeOverlay, reportToOverlay, setOverlayIndex, subscribeOverlay, updateOverlayErrorStack } from "./dev-error-overlay-store.js";
 import { Fragment, useEffect, useMemo, useState, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { createRoot } from "react-dom/client";
-//#region src/server/dev-error-overlay.tsx
+//#region src/client/dev-error-overlay.tsx
 const DEV_ERROR_OVERLAY_HOST_ID = "__vinext_dev_error_overlay_root";
 const DEV_ERROR_OVERLAY_MOUNT_ID = "__vinext_dev_error_overlay_mount";
 const VITE_ERROR_HANDLER_DATA_KEY = "__vinext_vite_error_handler__";

package/dist/client/navigation-runtime.d.ts

@@ -9,6 +9,8 @@ type NavigationRuntimeSnapshot = {
 type NavigationRuntimeRscChunk = string | [3, string];
 type NavigationRuntimeRscBootstrap = {
   done?: boolean;
+  dynamicStaleTimeSeconds?: number;
+  initialCacheKind?: "dynamic" | "static";
   nav?: NavigationRuntimeSnapshot;
   params?: Record<string, string | string[]>;
   rsc: NavigationRuntimeRscChunk[];

package/dist/client/navigation-runtime.js

@@ -50,10 +50,12 @@ function isNavigationRuntimeParams(value) {
 function isNavigationRuntimeRscBootstrap(value) {
 	if (!isUnknownRecord(value)) return false;
 	const done = Reflect.get(value, "done");
+	const dynamicStaleTimeSeconds = Reflect.get(value, "dynamicStaleTimeSeconds");
+	const initialCacheKind = Reflect.get(value, "initialCacheKind");
 	const nav = Reflect.get(value, "nav");
 	const params = Reflect.get(value, "params");
 	const rsc = Reflect.get(value, "rsc");
-	return (done === void 0 || typeof done === "boolean") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk);
+	return (done === void 0 || typeof done === "boolean") && (dynamicStaleTimeSeconds === void 0 || typeof dynamicStaleTimeSeconds === "number" && Number.isFinite(dynamicStaleTimeSeconds) && dynamicStaleTimeSeconds >= 0) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk);
 }
 function isReadonlyStringArray(value) {
 	return Array.isArray(value) && value.every((entry) => typeof entry === "string");

package/dist/client/vinext-next-data.d.ts

@@ -6,6 +6,7 @@ type VinextLinkPrefetchRoute = {
   documentOnly?: boolean;
   isDynamic: boolean;
   patternParts: string[];
+  requiresDynamicNavigationRequest?: boolean;
 };
 /**
  * Pages Router route pattern exposed to the client so the App Router's
@@ -22,13 +23,15 @@ type VinextPagesLinkPrefetchRoute = {
   documentOnly?: boolean;
   isDynamic: boolean;
   patternParts: string[];
+  requiresDynamicNavigationRequest?: boolean;
 };
 type VinextNextData = {
   /** vinext-specific additions (not part of Next.js upstream). */__vinext?: {
     /** Absolute URL of the page module for dynamic import. */pageModuleUrl?: string; /** Absolute URL of the `_app` module for dynamic import. */
     appModuleUrl?: string; /** True when the Pages Router server has middleware/proxy configured. */
     hasMiddleware?: boolean; /** True when build-time rewrites can affect the initial Pages Router ready state. */
-    hasRewrites?: boolean;
+    hasRewrites?: boolean; /** Server-resolved Pages route URL used to hydrate fallback shells behind rewrites. */
+    routeUrl?: string;
   };
 } & NEXT_DATA;
 type BrowserVinextNextData = NonNullable<Window["__NEXT_DATA__"]> & VinextNextData;

package/dist/client/window-next.d.ts

@@ -97,7 +97,8 @@ type PagesRouterPublicInstance = {
    * prefetch — App Router targets land here as `{ __appRouter: true }`.
    * See: `packages/next/src/shared/lib/router/router.ts:2525`.
    */
-  components: Record<string, unknown>;
+  components: Record<string, unknown>; /** Persistent Pages Router static-data cache, matching Next.js `Router.sdc`. */
+  sdc: Record<string, Promise<Response>>;
 };
 declare global {
   interface Window {