@qzsy/vinext 0.1.12 → 0.1.81

package/dist/init-platform.d.ts

@@ -0,0 +1,38 @@
+import { Readable, Writable } from "node:stream";
+
+//#region src/init-platform.d.ts
+type InitPlatform = "cloudflare" | "node";
+type InitDataCache = "kv" | "none";
+type InitCdnCache = "data-cache" | "workers-cache";
+type InitImageOptimization = "cloudflare-images" | "none";
+type CloudflareInitOptions = {
+  dataCache: InitDataCache;
+  cdnCache: InitCdnCache;
+  imageOptimization: InitImageOptimization;
+};
+declare const INIT_PLATFORMS: {
+  cloudflare: {
+    name: string;
+    options: typeof resolveCloudflareInitOptions;
+  };
+  node: {
+    name: string;
+    options: () => Promise<undefined>;
+  };
+};
+type PlatformPromptOptions = {
+  env?: Record<string, string | undefined>;
+  input?: Readable;
+  output?: Writable;
+  isInteractive?: boolean;
+  question?: (prompt: string) => Promise<string>;
+};
+declare function isAgentEnvironment(env?: Record<string, string | undefined>): boolean;
+declare function parsePlatformArg(args: string[]): InitPlatform | undefined;
+declare function parseDataCacheArg(args: string[]): InitDataCache | undefined;
+declare function parseCdnCacheArg(args: string[]): InitCdnCache | undefined;
+declare function parseImageOptimizationArg(args: string[]): InitImageOptimization | undefined;
+declare function resolveInitPlatform(args: string[], options?: PlatformPromptOptions): Promise<InitPlatform>;
+declare function resolveCloudflareInitOptions(args: string[], options?: PlatformPromptOptions): Promise<CloudflareInitOptions>;
+//#endregion
+export { CloudflareInitOptions, INIT_PLATFORMS, InitCdnCache, InitDataCache, InitImageOptimization, InitPlatform, isAgentEnvironment, parseCdnCacheArg, parseDataCacheArg, parseImageOptimizationArg, parsePlatformArg, resolveCloudflareInitOptions, resolveInitPlatform };

package/dist/init-platform.js

@@ -0,0 +1,150 @@
+import { isAgent } from "./node_modules/.pnpm/am-i-vibing@0.5.0/node_modules/am-i-vibing/dist/detector-1yx2Hoe0.js";
+import { createInterface } from "node:readline/promises";
+//#region src/init-platform.ts
+const INIT_PLATFORMS = {
+	cloudflare: {
+		name: "Cloudflare",
+		options: resolveCloudflareInitOptions
+	},
+	node: {
+		name: "Node",
+		options: async () => void 0
+	}
+};
+function isAgentEnvironment(env = process.env) {
+	return isAgent({ env });
+}
+function parsePlatformArg(args) {
+	for (let index = 0; index < args.length; index++) {
+		const arg = args[index];
+		let value;
+		if (arg === "--platform") {
+			value = args[index + 1];
+			if (!value || value.startsWith("-")) throw new Error("--platform requires a value (cloudflare or node).");
+		} else if (arg.startsWith("--platform=")) {
+			value = arg.slice(11);
+			if (!value) throw new Error("--platform requires a value (cloudflare or node).");
+		}
+		if (value) {
+			if (value === "cloudflare" || value === "node") return value;
+			throw new Error(`Unsupported platform "${value}". Expected cloudflare or node.`);
+		}
+	}
+}
+function parseChoiceArg(args, flag, choices, displayedChoices = choices) {
+	for (let index = 0; index < args.length; index++) {
+		const arg = args[index];
+		let value;
+		if (arg === flag) {
+			value = args[index + 1];
+			if (!value || value.startsWith("-")) throw new Error(`${flag} requires a value (${displayedChoices.join(" or ")}).`);
+		} else if (arg.startsWith(`${flag}=`)) {
+			value = arg.slice(flag.length + 1);
+			if (!value) throw new Error(`${flag} requires a value (${displayedChoices.join(" or ")}).`);
+		}
+		if (value) {
+			if (choices.includes(value)) return value;
+			throw new Error(`Unsupported ${flag} value "${value}". Expected ${displayedChoices.join(" or ")}.`);
+		}
+	}
+}
+function parseDataCacheArg(args) {
+	return parseChoiceArg(args, "--data-cache", ["kv", "none"]);
+}
+function parseCdnCacheArg(args) {
+	return parseChoiceArg(args, "--cdn-cache", ["data-cache", "workers-cache"], ["data-cache"]);
+}
+function parseImageOptimizationArg(args) {
+	return parseChoiceArg(args, "--image-optimization", ["cloudflare-images", "none"]);
+}
+async function resolveInitPlatform(args, options = {}) {
+	const explicitPlatform = parsePlatformArg(args);
+	if (explicitPlatform) return explicitPlatform;
+	if (isAgentEnvironment(options.env ?? process.env)) throw new Error("vinext init needs a deployment target. Ask the user whether they want Cloudflare or Node, then re-run the command with --platform=cloudflare or --platform=node.");
+	const input = options.input ?? process.stdin;
+	const output = options.output ?? process.stdout;
+	if (!(options.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY))) return "cloudflare";
+	const readline = options.question ? void 0 : createInterface({
+		input,
+		output
+	});
+	const question = options.question ?? ((prompt) => readline.question(prompt));
+	try {
+		while (true) {
+			const answer = (await question(`  Choose a deployment platform:
+    1. ${INIT_PLATFORMS.cloudflare.name} (default)\n    2. ${INIT_PLATFORMS.node.name}\n  Platform [1]: `)).trim().toLowerCase();
+			if (answer === "" || answer === "1" || answer === "cloudflare") {
+				output.write("\n");
+				return "cloudflare";
+			}
+			if (answer === "2" || answer === "node") {
+				output.write("\n");
+				return "node";
+			}
+			output.write("  Please choose Cloudflare (1) or Node (2).\n");
+		}
+	} finally {
+		readline?.close();
+	}
+}
+async function resolveCloudflareInitOptions(args, options = {}) {
+	const explicitDataCache = parseDataCacheArg(args);
+	const explicitCdnCache = parseCdnCacheArg(args);
+	const explicitImageOptimization = parseImageOptimizationArg(args);
+	if (explicitDataCache && explicitImageOptimization) return {
+		dataCache: explicitDataCache,
+		cdnCache: explicitCdnCache ?? "data-cache",
+		imageOptimization: explicitImageOptimization
+	};
+	if (isAgentEnvironment(options.env ?? process.env)) throw new Error("vinext init needs Cloudflare cache and image choices. Ask the user which data cache (kv or none) and image optimization (cloudflare-images or none) they want, then re-run with --data-cache=... and --image-optimization=....");
+	const input = options.input ?? process.stdin;
+	const output = options.output ?? process.stdout;
+	if (!(options.isInteractive ?? Boolean(process.stdin.isTTY && process.stdout.isTTY))) return {
+		dataCache: explicitDataCache ?? "kv",
+		cdnCache: explicitCdnCache ?? "data-cache",
+		imageOptimization: explicitImageOptimization ?? "cloudflare-images"
+	};
+	const readline = options.question ? void 0 : createInterface({
+		input,
+		output
+	});
+	const question = options.question ?? ((prompt) => readline.question(prompt));
+	try {
+		const promptChoice = async (current, prompt, values, defaultValue, error) => {
+			if (current) return current;
+			while (true) {
+				const answer = (await question(prompt)).trim().toLowerCase();
+				if (answer === "") {
+					output.write("\n");
+					return defaultValue;
+				}
+				const value = values[answer];
+				if (value) {
+					output.write("\n");
+					return value;
+				}
+				output.write(`  ${error}\n`);
+			}
+		};
+		return {
+			dataCache: await promptChoice(explicitDataCache, "  Choose a data cache:\n    1. Cloudflare KV (default)\n    2. None\n  Data cache [1]: ", {
+				"1": "kv",
+				kv: "kv",
+				"2": "none",
+				none: "none"
+			}, "kv", "Please choose Cloudflare KV (1) or None (2)."),
+			cdnCache: explicitCdnCache ?? "data-cache",
+			imageOptimization: await promptChoice(explicitImageOptimization, "  Choose image optimization:\n    1. Cloudflare Images (default)\n    2. None\n  Image optimization [1]: ", {
+				"1": "cloudflare-images",
+				"cloudflare-images": "cloudflare-images",
+				images: "cloudflare-images",
+				"2": "none",
+				none: "none"
+			}, "cloudflare-images", "Please choose Cloudflare Images (1) or None (2).")
+		};
+	} finally {
+		readline?.close();
+	}
+}
+//#endregion
+export { INIT_PLATFORMS, isAgentEnvironment, parseCdnCacheArg, parseDataCacheArg, parseImageOptimizationArg, parsePlatformArg, resolveCloudflareInitOptions, resolveInitPlatform };

package/dist/init.d.ts

@@ -1,30 +1,20 @@
+import { CloudflareInitOptions, InitPlatform } from "./init-platform.js";
+import { getReactUpgradeDeps } from "./utils/react-version.js";
+
 //#region src/init.d.ts
-/**
- * vinext init — one-command project migration for Next.js apps.
- *
- * Automates the steps needed to run a Next.js app under vinext:
- *
- *   1. Run `vinext check` to show compatibility report
- *   2. Install dependencies (vite, @vitejs/plugin-react, and App Router deps)
- *   3. Add "type": "module" to package.json
- *   4. Rename CJS config files to .cjs
- *   5. Add vinext scripts to package.json
- *   6. Generate vite.config.ts
- *   7. Update .gitignore to include /dist/ and .vinext/
- *   8. Print summary
- *
- * Non-destructive: does NOT modify next.config, tsconfig, or source files.
- * The project should work with both Next.js and vinext simultaneously.
- */
 type InitOptions = {
   /** Project root directory */root: string; /** Dev server port (default: 3001) */
   port?: number; /** Skip the compatibility check step */
   skipCheck?: boolean; /** Force overwrite even if vite.config.ts exists */
-  force?: boolean; /** @internal — override exec for testing (avoids ESM spy issues) */
+  force?: boolean; /** Deployment target selected by the user */
+  platform?: InitPlatform; /** Cloudflare cache and image choices. */
+  cloudflare?: CloudflareInitOptions; /** @internal — override exec for testing (avoids ESM spy issues) */
   _exec?: (cmd: string, opts: {
     cwd: string;
     stdio: string;
-  }) => void;
+  }) => string | void | Promise<string | void>; /** @internal — override pnpm ignored-builds inspection for testing */
+  _inspectPnpmIgnoredBuilds?: (root: string) => string; /** @internal — stable compatibility date for snapshot tests */
+  _today?: string;
 };
 type InitResult = {
   /** Whether dependencies were installed */installedDeps: string[]; /** Whether "type": "module" was added */
@@ -33,7 +23,9 @@ type InitResult = {
   addedScripts: string[]; /** Whether vite.config.ts was generated */
   generatedViteConfig: boolean; /** Whether vite.config.ts generation was skipped (already exists) */
   skippedViteConfig: boolean; /** Whether .gitignore was updated to include vinext-generated output */
-  updatedGitignore: boolean;
+  updatedGitignore: boolean; /** Deployment target configured by init */
+  platform: InitPlatform; /** Platform-specific deployment files generated by init */
+  generatedPlatformFiles: string[];
 };
 declare function generateViteConfig(_isAppRouter: boolean): string;
 /**
@@ -41,29 +33,14 @@ declare function generateViteConfig(_isAppRouter: boolean): string;
  * Returns the list of script names that were added.
  */
 declare function addScripts(root: string, port: number): string[];
-declare function getInitDeps(isAppRouter: boolean): string[];
+declare function getInitDeps(isAppRouter: boolean, platform: InitPlatform): string[];
 declare function isDepInstalled(root: string, dep: string): boolean;
-/**
- * Check if react/react-dom need upgrading for react-server-dom-webpack compatibility.
- *
- * react-server-dom-webpack versions are pinned to match their React version
- * (e.g. rsdw@19.2.6 requires react@^19.2.6). When a project has an older
- * React (e.g. create-next-app ships react@19.2.3), we need to upgrade
- * react/react-dom BEFORE installing rsdw to avoid peer-dep conflicts.
- *
- * Uses createRequire to resolve react's package.json through Node's module
- * resolution, which works correctly across all package managers (npm, pnpm,
- * yarn, Yarn PnP) and monorepo layouts with hoisting/symlinking.
- *
- * Returns ["react@latest", "react-dom@latest"] if upgrade is needed, [] otherwise.
- */
-declare function getReactUpgradeDeps(root: string): string[];
 /**
  * Ensure vinext-generated output directories are listed in .gitignore.
  * Creates the file if it doesn't exist. Returns true if the file was modified
  * (or created), false if all entries were already present.
  */
-declare function updateGitignore(root: string): boolean;
+declare function updateGitignore(root: string, platform?: InitPlatform): boolean;
 declare function init(options: InitOptions): Promise<InitResult>;
 //#endregion
 export { InitOptions, addScripts, generateViteConfig, getInitDeps, getReactUpgradeDeps, init, isDepInstalled, updateGitignore };

package/dist/init.js

@@ -1,9 +1,11 @@
-import { detectPackageManager, detectPackageManagerName, ensureESModule, hasAppDir, hasViteConfig, renameCJSConfigs } from "./utils/project.js";
+import { detectPackageManager, detectPackageManagerName, ensureESModule, findViteConfigPath, hasViteConfig, renameCJSConfigs } from "./utils/project.js";
 import { formatReport, runCheck } from "./check.js";
-import { createRequire } from "node:module";
+import { detectProject } from "./cloudflare/project.js";
+import { setupCloudflarePlatform, usesCommonJsViteConfig, validateCloudflarePlatformSetup } from "./init-cloudflare.js";
+import { getReactUpgradeDeps } from "./utils/react-version.js";
 import fs from "node:fs";
 import path from "node:path";
-import { execFileSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 //#region src/init.ts
 /**
 * vinext init — one-command project migration for Next.js apps.
@@ -11,17 +13,52 @@ import { execFileSync } from "node:child_process";
 * Automates the steps needed to run a Next.js app under vinext:
 *
 *   1. Run `vinext check` to show compatibility report
-*   2. Install dependencies (vite, @vitejs/plugin-react, and App Router deps)
-*   3. Add "type": "module" to package.json
-*   4. Rename CJS config files to .cjs
-*   5. Add vinext scripts to package.json
-*   6. Generate vite.config.ts
-*   7. Update .gitignore to include /dist/ and .vinext/
+*   2. Add "type": "module" to package.json
+*   3. Rename CJS config files to .cjs
+*   4. Add vinext scripts to package.json
+*   5. Generate vite.config.ts and platform files
+*   6. Update .gitignore to include /dist/ and .vinext/
+*   7. Install dependencies (vite, @vitejs/plugin-react, and App Router deps)
 *   8. Print summary
 *
 * Non-destructive: does NOT modify next.config, tsconfig, or source files.
 * The project should work with both Next.js and vinext simultaneously.
 */
+const terminalStyle = {
+	bold: (value) => process.stdout.isTTY ? `\x1b[1m${value}\x1b[0m` : value,
+	cyan: (value) => process.stdout.isTTY ? `\x1b[36m${value}\x1b[0m` : value,
+	green: (value) => process.stdout.isTTY ? `\x1b[32m${value}\x1b[0m` : value,
+	yellow: (value) => process.stdout.isTTY ? `\x1b[33m${value}\x1b[0m` : value
+};
+function formatList(items, indent) {
+	return items.map((item) => `${indent}- ${item}`).join("\n");
+}
+function isApproveBuildsError(error) {
+	const details = [
+		error instanceof Error ? error.message : String(error),
+		typeof error === "object" && error && "output" in error ? String(error.output) : "",
+		typeof error === "object" && error && "stdout" in error ? String(error.stdout) : "",
+		typeof error === "object" && error && "stderr" in error ? String(error.stderr) : ""
+	].join("\n");
+	return /approve-builds|ignored build scripts|blocked build scripts|ERR_PNPM_.*BUILD/i.test(details);
+}
+function hasAutomaticallyIgnoredBuilds(output) {
+	const automaticallyIgnored = output.match(/Automatically ignored builds during installation:\s*\n([\s\S]*?)(?:\n\s*\n|$)/i)?.[1];
+	if (!automaticallyIgnored) return false;
+	return automaticallyIgnored.split("\n").map((line) => line.trim()).some((line) => line.length > 0 && !/^none\.?$/i.test(line) && !/^cannot identify\b/i.test(line));
+}
+function inspectPnpmIgnoredBuilds(root) {
+	const result = spawnSync("pnpm", ["ignored-builds"], {
+		cwd: root,
+		encoding: "utf-8",
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		]
+	});
+	return `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
+}
 function generateViteConfig(_isAppRouter) {
 	return `import vinext from "vinext";
 import { defineConfig } from "vite";
@@ -61,7 +98,7 @@ function addScripts(root, port) {
 		return [];
 	}
 }
-function getInitDeps(isAppRouter) {
+function getInitDeps(isAppRouter, platform) {
 	const deps = [
 		"vinext",
 		"vite",
@@ -71,6 +108,7 @@ function getInitDeps(isAppRouter) {
 		deps.push("@vitejs/plugin-rsc");
 		deps.push("react-server-dom-webpack");
 	}
+	if (platform === "cloudflare") deps.push("@cloudflare/vite-plugin", "@vinext/cloudflare", "wrangler");
 	return deps;
 }
 function isDepInstalled(root, dep) {
@@ -101,68 +139,50 @@ function isDepInstalled(root, dep) {
 *
 * Returns ["react@latest", "react-dom@latest"] if upgrade is needed, [] otherwise.
 */
-function getReactUpgradeDeps(root) {
-	try {
-		const version = findPackageVersion(createRequire(path.join(root, "package.json")).resolve("react"), "react");
-		if (!version) return [];
-		const parts = version.split(".");
-		const major = parseInt(parts[0], 10);
-		const minor = parseInt(parts[1], 10);
-		const patch = parseInt(parts[2], 10);
-		if (major < 19 || major === 19 && minor < 2 || major === 19 && minor === 2 && patch < 6) return ["react@latest", "react-dom@latest"];
-		return [];
-	} catch {
-		return [];
-	}
-}
-/**
-* Walk up from a resolved module entry to find its package.json and return
-* the version field. Uses the same approach as PR #18's findReactServerPackages.
-*/
-function findPackageVersion(resolvedEntry, packageName) {
-	let dir = path.dirname(resolvedEntry);
-	while (dir !== path.dirname(dir)) {
-		const candidate = path.join(dir, "package.json");
-		try {
-			const pkg = JSON.parse(fs.readFileSync(candidate, "utf-8"));
-			if (pkg.name === packageName) return pkg.version ?? null;
-		} catch {}
-		dir = path.dirname(dir);
-	}
-	return null;
-}
-function installDeps(root, deps, exec, { dev = true } = {}) {
-	if (deps.length === 0) return;
+async function installDeps(root, deps, exec, { dev = true } = {}) {
+	if (deps.length === 0) return "";
 	const baseCmd = detectPackageManager(root);
-	exec(`${dev ? baseCmd : baseCmd.replace(/ -D$/, "")} ${deps.join(" ")}`, {
+	return await exec(`${dev ? baseCmd : baseCmd.replace(/ -D$/, "")} ${deps.join(" ")}`, {
 		cwd: root,
 		stdio: "inherit"
-	});
+	}) ?? "";
 }
 /**
 * Ensure vinext-generated output directories are listed in .gitignore.
 * Creates the file if it doesn't exist. Returns true if the file was modified
 * (or created), false if all entries were already present.
 */
-function updateGitignore(root) {
+function updateGitignore(root, platform = "node") {
 	const gitignorePath = path.join(root, ".gitignore");
-	const entries = [{
-		entry: "/dist/",
-		coveredBy: new Set([
-			"/dist/",
-			"/dist",
-			"dist/",
-			"dist"
-		])
-	}, {
-		entry: ".vinext/",
-		coveredBy: new Set([
-			"/.vinext/",
-			"/.vinext",
-			".vinext/",
-			".vinext"
-		])
-	}];
+	const entries = [
+		{
+			entry: "/dist/",
+			coveredBy: new Set([
+				"/dist/",
+				"/dist",
+				"dist/",
+				"dist"
+			])
+		},
+		{
+			entry: ".vinext/",
+			coveredBy: new Set([
+				"/.vinext/",
+				"/.vinext",
+				".vinext/",
+				".vinext"
+			])
+		},
+		...platform === "cloudflare" ? [{
+			entry: ".wrangler/",
+			coveredBy: new Set([
+				"/.wrangler/",
+				"/.wrangler",
+				".wrangler/",
+				".wrangler"
+			])
+		}] : []
+	];
 	let content = "";
 	let lines = [];
 	if (fs.existsSync(gitignorePath)) {
@@ -175,78 +195,168 @@ function updateGitignore(root) {
 	fs.writeFileSync(gitignorePath, content + separator + missingEntries.join("\n") + "\n", "utf-8");
 	return true;
 }
+function setupNodePlatform(context) {
+	if (context.viteConfigExists && !context.force) return {
+		generatedViteConfig: false,
+		skippedViteConfig: true,
+		generatedPlatformFiles: [],
+		nextSteps: []
+	};
+	fs.writeFileSync(context.existingViteConfigPath ?? path.join(context.root, "vite.config.ts"), generateViteConfig(context.isAppRouter), "utf-8");
+	return {
+		generatedViteConfig: true,
+		skippedViteConfig: false,
+		generatedPlatformFiles: [],
+		nextSteps: []
+	};
+}
 async function init(options) {
 	const root = path.resolve(options.root);
 	const port = options.port ?? 3001;
-	const exec = options._exec ?? ((cmd, opts) => {
-		const [program, ...args] = cmd.split(" ");
-		execFileSync(program, args, {
-			...opts,
-			shell: true
+	if (!options.platform) throw new Error("A deployment platform must be selected before running vinext init.");
+	const platform = options.platform;
+	if (platform === "cloudflare" && !options.cloudflare) throw new Error("Cloudflare init options must be resolved before running vinext init.");
+	const exec = options._exec ?? ((cmd, opts) => new Promise((resolve, reject) => {
+		const child = spawn(cmd, {
+			cwd: opts.cwd,
+			shell: true,
+			stdio: [
+				"inherit",
+				"pipe",
+				"pipe"
+			]
 		});
-	});
+		let output = "";
+		child.stdout.on("data", (chunk) => {
+			const text = chunk.toString();
+			output += text;
+			process.stdout.write(text);
+		});
+		child.stderr.on("data", (chunk) => {
+			const text = chunk.toString();
+			output += text;
+			process.stderr.write(text);
+		});
+		child.on("error", (error) => reject(Object.assign(error, { output })));
+		child.on("close", (status) => {
+			if (status === 0) resolve(output);
+			else reject(Object.assign(/* @__PURE__ */ new Error(`Command failed with exit code ${status}: ${cmd}`), {
+				status,
+				output
+			}));
+		});
+	}));
 	const pkgPath = path.join(root, "package.json");
 	if (!fs.existsSync(pkgPath)) {
 		console.error("  Error: No package.json found in the current directory.");
 		console.error("  Run this command from the root of a Next.js project.\n");
 		process.exit(1);
 	}
+	let existingViteConfigPath = findViteConfigPath(root);
+	if (existingViteConfigPath?.endsWith("vite.config.js")) {
+		const existingConfig = fs.readFileSync(existingViteConfigPath, "utf-8");
+		const cjsPath = existingViteConfigPath.replace(/\.js$/, ".cjs");
+		if (usesCommonJsViteConfig(existingViteConfigPath, existingConfig) && fs.existsSync(cjsPath)) throw new Error("Cannot rename CommonJS vite.config.js because vite.config.cjs already exists. Remove or consolidate one of the files, then rerun vinext init.");
+	}
 	const viteConfigExists = hasViteConfig(root);
-	const isApp = hasAppDir(root);
+	const isApp = detectProject(root).isAppRouter;
 	const pmName = detectPackageManagerName(root);
+	if (platform === "cloudflare") validateCloudflarePlatformSetup({
+		root,
+		isAppRouter: isApp,
+		existingViteConfigPath,
+		today: options._today
+	}, options.cloudflare);
 	if (!options.skipCheck) {
 		console.log("  Running compatibility check...\n");
 		const checkResult = runCheck(root);
 		console.log(formatReport(checkResult, { calledFromInit: true }));
 		console.log();
 	}
-	const missingDeps = getInitDeps(isApp).filter((dep) => !isDepInstalled(root, dep));
+	const renamedConfigs = renameCJSConfigs(root);
+	if (existingViteConfigPath?.endsWith("vite.config.js") && usesCommonJsViteConfig(existingViteConfigPath, fs.readFileSync(existingViteConfigPath, "utf-8"))) {
+		const renamedPath = existingViteConfigPath.replace(/\.js$/, ".cjs");
+		fs.renameSync(existingViteConfigPath, renamedPath);
+		renamedConfigs.push([path.basename(existingViteConfigPath), path.basename(renamedPath)]);
+		existingViteConfigPath = renamedPath;
+	}
+	const addedTypeModule = ensureESModule(root);
+	const addedScripts = addScripts(root, port);
+	const setupContext = {
+		root,
+		isAppRouter: isApp,
+		existingViteConfigPath,
+		viteConfigExists,
+		force: options.force ?? false,
+		today: options._today
+	};
+	const platformSetup = platform === "cloudflare" ? setupCloudflarePlatform(setupContext, options.cloudflare) : setupNodePlatform(setupContext);
+	const { generatedViteConfig, skippedViteConfig, generatedPlatformFiles } = platformSetup;
+	const updatedGitignore = updateGitignore(root, platform);
+	const missingDeps = getInitDeps(isApp, platform).filter((dep) => !isDepInstalled(root, dep));
+	let dependencyInstallNeedsApproval = false;
+	let dependenciesAdded = false;
 	if (isApp && missingDeps.includes("react-server-dom-webpack")) {
 		const reactUpgrade = getReactUpgradeDeps(root);
 		if (reactUpgrade.length > 0) {
-			console.log(`  Upgrading ${reactUpgrade.map((d) => d.replace(/@latest$/, "")).join(", ")}...`);
-			installDeps(root, reactUpgrade, exec, { dev: false });
+			console.log(`  ${terminalStyle.cyan(terminalStyle.bold("Upgrading dependencies:"))}`);
+			console.log(formatList(reactUpgrade.map((dep) => dep.replace(/@latest$/, "")), "    "));
+			try {
+				if (isApproveBuildsError(await installDeps(root, reactUpgrade, exec, { dev: false }))) dependencyInstallNeedsApproval = true;
+			} catch (error) {
+				if (pmName !== "pnpm" || !isApproveBuildsError(error)) throw error;
+				dependencyInstallNeedsApproval = true;
+			}
 		}
 	}
 	if (missingDeps.length > 0) {
-		console.log(`  Installing ${missingDeps.join(", ")}...`);
-		installDeps(root, missingDeps, exec);
+		console.log(`  ${terminalStyle.cyan(terminalStyle.bold("Installing dependencies:"))}`);
+		console.log(formatList(missingDeps, "    "));
+		try {
+			const installOutput = await installDeps(root, missingDeps, exec);
+			dependenciesAdded = true;
+			if (isApproveBuildsError(installOutput)) dependencyInstallNeedsApproval = true;
+		} catch (error) {
+			if (pmName !== "pnpm" || !isApproveBuildsError(error)) throw error;
+			dependencyInstallNeedsApproval = true;
+		}
 		console.log();
 	}
-	const renamedConfigs = renameCJSConfigs(root);
-	const addedTypeModule = ensureESModule(root);
-	const addedScripts = addScripts(root, port);
-	let generatedViteConfig = false;
-	const skippedViteConfig = viteConfigExists && !options.force;
-	if (!skippedViteConfig) {
-		const configContent = generateViteConfig(isApp);
-		fs.writeFileSync(path.join(root, "vite.config.ts"), configContent, "utf-8");
-		generatedViteConfig = true;
+	if (pmName === "pnpm" && !dependencyInstallNeedsApproval && !options._exec && hasAutomaticallyIgnoredBuilds(inspectPnpmIgnoredBuilds(root))) dependencyInstallNeedsApproval = true;
+	else if (pmName === "pnpm" && !dependencyInstallNeedsApproval && options._inspectPnpmIgnoredBuilds && hasAutomaticallyIgnoredBuilds(options._inspectPnpmIgnoredBuilds(root))) dependencyInstallNeedsApproval = true;
+	console.log(`  ${terminalStyle.green(terminalStyle.bold("vinext init complete!"))}\n`);
+	if (dependenciesAdded) {
+		console.log(`    ${terminalStyle.green("✓")} Added dependencies to devDependencies:`);
+		console.log(formatList(missingDeps, "      "));
 	}
-	const updatedGitignore = updateGitignore(root);
-	console.log("  vinext init complete!\n");
-	if (missingDeps.length > 0) console.log(`    \u2713 Added ${missingDeps.join(", ")} to devDependencies`);
-	if (addedTypeModule) console.log(`    \u2713 Added "type": "module" to package.json`);
-	for (const [oldName, newName] of renamedConfigs) console.log(`    \u2713 Renamed ${oldName} \u2192 ${newName}`);
-	for (const script of addedScripts) console.log(`    \u2713 Added ${script} script`);
-	if (generatedViteConfig) console.log(`    \u2713 Generated vite.config.ts`);
-	if (skippedViteConfig) console.log(`    - Skipped vite.config.ts (already exists, use --force to overwrite)`);
-	if (updatedGitignore) console.log(`    \u2713 Added vinext output directories to .gitignore`);
+	if (dependencyInstallNeedsApproval) console.log(`    ${terminalStyle.yellow("!")} Dependency installation is waiting for build-script approval`);
+	if (addedTypeModule) console.log(`    ${terminalStyle.green("✓")} Added "type": "module" to package.json`);
+	for (const [oldName, newName] of renamedConfigs) console.log(`    ${terminalStyle.green("✓")} Renamed ${oldName} \u2192 ${newName}`);
+	for (const script of addedScripts) console.log(`    ${terminalStyle.green("✓")} Added ${script} script`);
+	if (generatedViteConfig) console.log(`    ${terminalStyle.green("✓")} Generated vite.config.ts`);
+	for (const file of generatedPlatformFiles) console.log(`    ${terminalStyle.green("✓")} Generated ${file}`);
+	if (skippedViteConfig) console.log(`    ${terminalStyle.yellow("-")} Skipped vite.config.ts (already exists, use --force to overwrite)`);
+	if (updatedGitignore) console.log(`    ${terminalStyle.green("✓")} Added vinext output directories to .gitignore`);
+	const nextSteps = [...platformSetup.nextSteps];
+	if (dependencyInstallNeedsApproval) nextSteps.push("Dependency installation is incomplete because pnpm blocked dependency build scripts:", "1. Review and approve the required build scripts:", "   pnpm approve-builds", "2. Finish installing dependencies:", "   pnpm install");
 	console.log(`
-  Next steps:
+  ${terminalStyle.cyan(terminalStyle.bold("Next steps:"))}
+${nextSteps.map((step) => `    ${step}`).join("\n")}${nextSteps.length > 0 ? "\n" : ""}
     ${pmName} run dev:vinext    Start the vinext dev server
     ${pmName} run build:vinext  Build production output
     ${pmName} run start:vinext  Start vinext production server
     ${pmName} run dev           Start Next.js (still works as before)
 `);
 	return {
-		installedDeps: missingDeps,
+		installedDeps: dependenciesAdded ? missingDeps : [],
 		addedTypeModule,
 		renamedConfigs,
 		addedScripts,
 		generatedViteConfig,
 		skippedViteConfig,
-		updatedGitignore
+		updatedGitignore,
+		platform,
+		generatedPlatformFiles
 	};
 }
 //#endregion