vite-plus 1.2.0 → 1.4.0

package/dist/migration/bin.js

@@ -1,129 +1,623 @@
-import { t as documentationUrl$1 } from "../documentation-DqcZSthV.js";
-import { a as muted, c as warnMsg, i as log, o as printHeader, r as formatDuration, t as accent } from "../terminal-MKGAuy-p.js";
-import { _ as engines, a as SETUP_VP_VERSION, d as VITE_PLUS_OVERRIDE_PACKAGES, f as VITE_PLUS_VERSION, m as isForceOverrideMode } from "../constants-BW3g7VnD.js";
-import { a as writeJsonFile, c as modify, i as readJsonFile, l as parse, o as applyEdits, s as findNodeAtLocation, u as parseTree } from "../json-JP24qHUF.js";
-import { a as hasVitePlusDependency, i as hasPackageManagerDeclaration, n as detectPackageMetadata, o as readNearestPackageJson } from "../package-BP16iQby.js";
-import { t as vitest_v5_entry_points_default } from "../vitest-v5-entry-points-DthU1e_O.js";
-import { C as confirm, D as outro, M as isCancel, O as select, S as normalize$1, T as log$1, c as selectPackageManager, i as promptGitHooks, k as spinner, l as upgradeYarn, n as defaultInteractive, o as runViteFmt, r as downloadPackageManager$1, s as runViteInstall, t as cancelAndExit, x as getMajor, y as PackageManager } from "../prompts-BGpQtC5z.js";
-import { _ as isGreaterThanOrEqual, p as compare } from "../comparison-CmVirWIW-DUGaiYqF.js";
-import { a as rangeToComparators, i as normalizeRange, n as findMinimumForRange, o as rangesIntersect, r as isRangeSubset, s as satisfies, t as extractOverrideTargetName } from "../package-overrides-D1RcXSFl.js";
-import { i as selectAgentTargetPaths, l as displayRelative, n as detectAgentConflicts, r as detectExistingAgentTargetPaths, s as writeAgentInstructions } from "../agent-KeDc6vmg.js";
-import { n as addMigrationWarning, r as createMigrationReport } from "../report-NhQk8VHb.js";
-import { $ as confirmEslintMigration, A as createCatalogDependencyResolver, B as addFrameworkShim, C as mergeViteConfigFiles, D as usesWebdriverioProvider, E as ensureVitePlusBootstrap, G as migrateTsupToTsdown, H as hasFrameworkShim, I as minimatch, J as confirmPrettierMigration, L as findGitRoot, M as detectWorkspace$1, O as configureYarnNodeModulesMode, Q as warnPackageLevelPrettier, S as mergeTsdownConfigFile, T as detectVitePlusBootstrapPending, U as confirmTsupMigration, V as detectFramework, W as detectTsupProject, X as migratePrettierToOxfmt, Y as detectPrettierProject, _ as installGitHooks, at as warnLegacyEslintConfig, ct as checkViteVersion, d as finalizeCoreMigrationForExistingVitePlus, et as detectEslintProject, f as detectNodeVersionManagerFile, g as detectLegacyGitHooksMigrationCandidate, i as selectEditor, it as warnIncompatibleEslintIntegration, k as detectYarnPnpMode, l as rewriteStandaloneProject, lt as checkVitestVersion, m as migrateSetupVpVersion, nt as migrateEslintToOxlint, o as writeEditorConfigs, ot as warnPackageLevelEslint, p as migrateNodeVersionManagerFile, q as warnMissingTsupConfig, r as isJsonLikeFile, s as rewriteMonorepo, st as WEBDRIVERIO_PROVIDER, t as detectEditorConflicts, tt as detectIncompatibleEslintIntegration, u as detectPendingCoreMigration, v as preflightGitHooksSetup, w as collectToolchainVersionChanges, x as injectLintTypeCheckDefaults, y as shouldSkipStagedMigrationForHooks, z as extractOverrideParentSegments } from "../editor-b1XUwt9v.js";
-import { n as runCommandSilently } from "../command-CguLh2KL.js";
-import { t as require_dist } from "../dist-Bi7ZEK3c.js";
-import { a as hasBaseUrlInTsconfig, i as fixBaseUrlInTsconfig, t as confirmBaseUrlFix } from "../tsconfig-D2DzAQ_D.js";
-import { t as unwrapCliParseOutcome } from "../cli-parse-DHE8NrBU.js";
-import { t as ROLLDOWN_COMPAT_RESULT_PREFIX } from "../protocol-D99W10Qi.js";
+import { t as documentationUrl$1 } from "../documentation-cv_y0Auv.js";
+import { a as muted, c as warnMsg, i as log, o as printHeader, r as formatDuration, t as accent } from "../terminal-BcuPUy-j.js";
+import { _ as engines, a as SETUP_VP_VERSION, d as VITE_PLUS_OVERRIDE_PACKAGES, f as VITE_PLUS_VERSION, m as isForceOverrideMode } from "../constants-DRUnJ_Dz.js";
+import { a as writeJsonFile, c as modify, i as readJsonFile, l as parse, n as editJsonFile, o as applyEdits, r as isJsonFile, s as findNodeAtLocation, u as parseTree } from "../json-kl84kDyH.js";
+import { a as hasVitePlusDependency, i as hasPackageManagerDeclaration, n as detectPackageMetadata, o as readNearestPackageJson } from "../package-DzsomcUD.js";
+import { t as vitest_v5_entry_points_default } from "../vitest-v5-entry-points-NyJsFeux.js";
+import { C as confirm, D as outro, M as isCancel, O as select, S as normalize$1, T as log$1, c as selectPackageManager, i as promptGitHooks, k as spinner, l as upgradeYarn, n as defaultInteractive, o as runViteFmt, r as downloadPackageManager$1, s as runViteInstall, t as cancelAndExit, x as getMajor, y as PackageManager } from "../prompts-GL1vj0wk.js";
+import { _ as isGreaterThanOrEqual, p as compare } from "../comparison-CmVirWIW-UlEf2maz.js";
+import { a as rangeToComparators, i as normalizeRange, n as findMinimumForRange, o as rangesIntersect, r as isRangeSubset, s as satisfies, t as extractOverrideTargetName } from "../package-overrides-Ci8GXouY.js";
+import { i as selectAgentTargetPaths, l as displayRelative, n as detectAgentConflicts, r as detectExistingAgentTargetPaths, s as writeAgentInstructions } from "../agent-D8oxxhVR.js";
+import { n as addMigrationWarning, r as createMigrationReport } from "../report-DLHO30yZ.js";
+import { A as detectVitePlusBootstrapPending, C as removeMigratedOxlintConfigs, Ct as warnMigration, D as mergeViteConfigFiles, E as mergeTsdownConfigFile, F as detectYarnPnpMode, I as createCatalogDependencyResolver, J as detectFramework, K as extractOverrideParentSegments, M as sourceTreeMatches, N as usesWebdriverioProvider, O as retryPreservedOxlintConfigs, P as configureYarnNodeModulesMode, Q as migrateTsupToTsdown, R as detectWorkspace$1, S as prepareOxlintConfigs, St as readPackageJsonIfExists, T as injectLintTypeCheckDefaults, U as minimatch, W as findGitRoot, X as confirmTsupMigration, Y as hasFrameworkShim, Z as detectTsupProject, _ as hasExistingViteHooksPolicy, _t as WEBDRIVERIO_PROVIDER, at as warnPackageLevelPrettier, b as preflightGitHooksSetup, bt as getCommandStartIndex, ct as detectIncompatibleEslintIntegration, d as finalizeCoreMigrationForExistingVitePlus, dt as warnIncompatibleEslintIntegration, et as warnMissingTsupConfig, f as detectNodeVersionManagerFile, ft as warnLegacyEslintConfig, g as detectLegacyGitHooksMigrationCandidate, gt as SHELL_STATE_COMMANDS, ht as RETENTION_SCAN_SKIP_DIRS, i as selectEditor, j as ensureVitePlusBootstrap, k as collectToolchainVersionChanges, l as rewriteStandaloneProject, lt as migrateEslintToOxlint, m as migrateSetupVpVersion, mt as LINT_STAGED_JSON_CONFIG_FILES, nt as detectPrettierProject, o as writeEditorConfigs, ot as confirmEslintMigration, p as migrateNodeVersionManagerFile, pt as warnPackageLevelEslint, q as addFrameworkShim, r as isJsonLikeFile, rt as migratePrettierToOxfmt, s as rewriteMonorepo, st as detectEslintProject, t as detectEditorConflicts, tt as confirmPrettierMigration, u as detectPendingCoreMigration, v as installGitHooks, vt as checkViteVersion, x as shouldSkipStagedMigrationForHooks, xt as isPlainRecord, y as isViteHooksSetupComplete, yt as checkVitestVersion } from "../editor-ClL78D8u.js";
+import { i as runCommandSilently } from "../command-rY79K5NI.js";
+import { t as require_dist } from "../dist-Bs0SObNC.js";
+import { a as hasBaseUrlInTsconfig, i as fixBaseUrlInTsconfig, t as confirmBaseUrlFix } from "../tsconfig-LE_mAwe_.js";
+import { i as WATCH_OPTIONS_WITH_VALUE, n as SCRIPT_EXTENSIONS, t as NODE_OPTIONS_WITH_VALUE } from "../vpx-script-EXgV5QOf.js";
+import { t as unwrapCliParseOutcome } from "../cli-parse-aeUeFDlC.js";
+import { t as ROLLDOWN_COMPAT_RESULT_PREFIX } from "../protocol-CkNmY-Mr.js";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { analyzeMigrationSource, isDirectoryGitignored, parseMigrateArgs } from "../../binding/index.js";
+import { analyzeMigrationSource, isDirectoryGitignored, parseLiteralCommands, parseMigrateArgs } from "../../binding/index.js";
 import { styleText } from "node:util";
 import fs, { existsSync } from "node:fs";
-//#region src/migration/vitest-v5/commands.ts
-/** Parse only a single literal argv command. Shell expansion, pipelines, and
-* compound commands need review; treating them as argv could change behavior. */
-function literalArgv(command) {
-	const tokens = [];
-	let value = "";
-	let start = 0;
-	let quote = "";
-	let active = false;
-	for (let i = 0; i < command.length; i++) {
-		const character = command[i];
-		if (quote) {
-			if (character === quote) quote = "";
-			else if (character === "\\" || quote === "\"" && (character === "$" || character === "`")) return;
-			else value += character;
-		} else if (character === "'" || character === "\"") {
-			if (!active) start = i;
-			quote = character;
-			active = true;
-		} else if (character === "\n" || character === "\r") return;
-		else if (/\s/.test(character)) {
-			if (active) tokens.push({
-				value,
-				start,
-				end: i
-			});
-			active = false;
-			value = "";
-		} else if (/[|&;<>($`\\)]/.test(character)) return;
-		else {
-			if (!active) start = i;
-			value += character;
-			active = true;
+import os from "node:os";
+// src/migration/migrator/tsx.ts
+const TSX_COMMAND = /(?:^|[\s;&|("'=/\\`])tsx(?:\.(?:cmd|exe|ps1))?(?:\/(?:esm|cjs))?(?=$|[\s;&|)"'`])/i;
+const LOADER_OPTIONS = /* @__PURE__ */ new Set([
+	"--import",
+	"--loader",
+	"--experimental-loader",
+	"--require",
+	"-r"
+]);
+const TSX_LOADER = /^tsx(?:\/(?:esm|cjs))?$/;
+const LOADER_SETTINGS = /* @__PURE__ */ new Set([
+	"import",
+	"loader",
+	"require"
+]);
+const KEEP_EVAL = "`vpx` does not run TypeScript passed to --eval or --print";
+const KEEP_CHECK = "`vpx` does not transform TypeScript for -c or --check";
+const KEEP_REPL = "`vpx` does not start a TypeScript REPL";
+const KEEP_TEST_GLOBS = "`--test` without files finds `.ts` tests with tsx globs; list the test files for `vpx --test`";
+const KEEP_WATCH_PATH = "`--watch-path` has no `vpx` equivalent; use `--include`";
+const KEEP_SHELL = "the command uses shell syntax that vp migrate does not rewrite, such as pipes, variables, or subshells";
+const KEEP_OTHER = "vp migrate does not rewrite this use of tsx";
+const KEEP_TSX_TSCONFIG = "`TSX_TSCONFIG_PATH` selects the tsconfig for tsx only; pass it to `vpx` as `--tsconfig`";
+const KEEP_NODE_OPTIONS = "`NODE_OPTIONS` loads tsx, whose hooks would compete with those of `vpx`; remove it first";
+const KEEP_WATCH_TEST = "`vpx --watch` does not run `--test`";
+const KEEP_OPTIONS = /* @__PURE__ */ new Map([
+	["-e", KEEP_EVAL],
+	["--eval", KEEP_EVAL],
+	["-p", KEEP_EVAL],
+	["--print", KEEP_EVAL],
+	["-pe", KEEP_EVAL],
+	["-c", KEEP_CHECK],
+	["--check", KEEP_CHECK],
+	["-i", KEEP_REPL],
+	["--interactive", KEEP_REPL],
+	["--watch-path", KEEP_WATCH_PATH]
+]);
+const TSX_ENV_SHEBANG = /^(#!\s*\S*\benv\s+(?:-S\s+)?)(tsx(?=[ \t\r\n]|$)[^\r\n]*)/;
+const SHEBANG_ENTRY = "./shebang.ts";
+const TSX_SHEBANG = /^#![^\n]*[\s/]tsx(?=\s|$)/;
+const TSX_LOADER_FLAG = /(?:(?:--import|--loader|--experimental-loader|--require|-r)[= \t]+|(?<![\w-])(?:import|loader|experimental-loader|require)=)['"]?tsx(?:\/(?:esm|cjs))?(?![\w./-])/;
+const TSX_CODE_REFERENCE = new RegExp([
+	/(?:\bfrom|\bimport|\bimport\.meta\.resolve|\brequire(?:\.resolve)?)\s*\(?\s*(?:\/\*[\s\S]*?\*\/\s*)*['"`]tsx(?:\/[^'"`]*)?['"`]/.source,
+	/['"`](?:npx |pnpm (?:exec )?|yarn |bunx )?tsx\s/.source,
+	/\(\s*\[?\s*['"`]tsx['"`]\s*[,)\]]/.source,
+	TSX_LOADER_FLAG.source,
+	/['"`](?:--import|--loader|--experimental-loader|--require|-r)['"`]\s*,\s*['"`]tsx(?:\/(?:esm|cjs))?['"`]/.source
+].join("|"));
+const TSX_TEXT_REFERENCE = new RegExp([/(?:^|[\s;&|("'=/\\`])tsx(?:\.(?:cmd|exe|ps1))?(?:\/(?:esm|cjs))?['"]?(?:[ \t]+\S|[ \t]*$)/.source, TSX_LOADER_FLAG.source].join("|"), "m");
+const TSX_CONFIG_VALUE = new RegExp([
+	/(?:^|[\s;&|("'=/\\`])tsx(?:\.(?:cmd|exe|ps1))?[ \t]+\S/.source,
+	TSX_LOADER_FLAG.source,
+	/^tsx\//.source
+].join("|"), "i");
+const IGNORED_FIELDS = /* @__PURE__ */ new Set([
+	"bundleDependencies",
+	"bundledDependencies",
+	"dependencies",
+	"description",
+	"devDependencies",
+	"keywords",
+	"name",
+	"optionalDependencies",
+	"overrides",
+	"peerDependencies",
+	"peerDependenciesMeta",
+	"pnpm",
+	"resolutions"
+]);
+const CODE_EXTENSIONS = /* @__PURE__ */ new Set([
+	...SCRIPT_EXTENSIONS,
+	".astro",
+	".svelte",
+	".vue"
+]);
+const REFERENCE_EXTENSIONS = /* @__PURE__ */ new Set([
+	...CODE_EXTENSIONS,
+	".json",
+	".jsonc",
+	".toml",
+	".yml",
+	".yaml",
+	".sh",
+	".bash",
+	".zsh",
+	".fish",
+	".ps1",
+	".cmd",
+	".bat"
+]);
+const LOCKFILES = /* @__PURE__ */ new Set([
+	"bun.lock",
+	"npm-shrinkwrap.json",
+	"package-lock.json",
+	"pnpm-lock.yaml",
+	"yarn.lock"
+]);
+const USE_SCAN_SKIP_DIRS = /* @__PURE__ */ new Set([
+	...RETENTION_SCAN_SKIP_DIRS,
+	".cache",
+	".next",
+	".nuxt",
+	".svelte-kit",
+	".turbo",
+	".vite",
+	"coverage"
+]);
+const ESM_SYNTAX = /(?:^|;)\s*(?:import(?![\w$])\s*(?![\w$]+\s*=)[\w*{'"]|export(?![\w$])\s*[\w*{])|\bimport\.meta\b/m;
+const COMMONJS_GLOBALS = [
+	["__dirname", /(?<![.\w$])__dirname\b/],
+	["__filename", /(?<![.\w$])__filename\b/],
+	["require", /(?<![.\w$])require\s*(?:\(|\.\s*[\w$])/],
+	["exports", /(?<![.\w$'"`])exports(?![\w$'"`]|\s*:)/],
+	["module", /(?<![.\w$])module\s*(?:\.\s*[\w$]|\[)/]
+];
+const EXPORT_ASSIGNMENT = /(?:^|;)\s*export\s*=/m;
+const RELATIVE_REQUIRE = /(?<![.\w$])require\s*\(\s*['"`](\.{1,2}\/[^'"`]+?)\.(js|cjs|mjs|jsx)['"`]/g;
+const TYPESCRIPT_EXTENSIONS = {
+	js: ["ts", "tsx"],
+	cjs: ["cts"],
+	mjs: ["mts"],
+	jsx: ["tsx"]
+};
+const shellCommand = (previous) => /^-[a-z]*c$/.test(previous);
+const COMMAND_LAUNCHERS = /* @__PURE__ */ new Map([
+	["bash", shellCommand],
+	["concurrently", () => true],
+	["nodemon", (previous) => previous === "--exec" || previous === "-x"],
+	["sh", shellCommand],
+	["zsh", shellCommand]
+]);
+/**
+* Rewrite the tsx invocations in a command to `vpx`: `tsx a.ts` becomes `vpx a.ts`,
+* `tsx watch a.ts` becomes `vpx --watch a.ts` (`vpx watch` runs the npm package `watch`),
+* and `node --import tsx a.ts` becomes `vpx a.ts`. Package-manager wrappers such as
+* `npx tsx` go away with tsx, since `vpx` is a bin of vite-plus. A form `vpx` cannot run
+* stays as it is, with the reason in `kept`. With `cwd`, the directory the command runs
+* in, the scripts it runs are checked for syntax `vpx` runs differently.
+*/
+function rewriteTsxCommand(command, cwd) {
+	if (!TSX_COMMAND.test(command)) return {
+		command,
+		kept: []
+	};
+	const segments = parseLiteralCommands(command, true);
+	if (!segments || /%\w+%/.test(command)) return {
+		command,
+		kept: [KEEP_SHELL]
+	};
+	const rewrite = {
+		command,
+		cwd,
+		edits: [],
+		kept: []
+	};
+	for (const tokens of segments) {
+		const name = tokens[0].value;
+		if (SHELL_STATE_COMMANDS.includes(name) || name === "chdir") {
+			rewrite.cwd = void 0;
+			continue;
 		}
+		rewriteSegment(rewrite, tokens);
 	}
-	if (quote) return;
-	if (active) tokens.push({
-		value,
-		start,
-		end: command.length
+	let rewritten = command;
+	for (const edit of rewrite.edits.toSorted((a, b) => b.start - a.start)) rewritten = rewritten.slice(0, edit.start) + edit.text + rewritten.slice(edit.end);
+	if (!rewrite.kept.length && TSX_COMMAND.test(rewritten)) rewrite.kept.push(KEEP_OTHER);
+	return {
+		command: rewritten,
+		kept: rewrite.kept
+	};
+}
+function rewriteSegment(rewrite, tokens) {
+	const values = tokens.map(({ value }) => value);
+	let first = 0;
+	const skipAssignments = () => {
+		while (/^[A-Za-z_]\w*=/.test(values[first] ?? "")) first++;
+	};
+	skipAssignments();
+	const shell = values[first] === "cross-env-shell";
+	if (values[first] === "cross-env" || shell) {
+		first++;
+		skipAssignments();
+	}
+	if (first >= values.length) return;
+	const envReason = envKeepReason(values.slice(0, first));
+	const start = first + getCommandStartIndex(values.slice(first));
+	const launcher = COMMAND_LAUNCHERS.get(values[start]);
+	if (values[start] === "tsx") rewriteTsx(rewrite, tokens, first, start, envReason);
+	else if (values[start] === "node") rewriteNodeLoader(rewrite, tokens, first, start, envReason);
+	else if (shell) for (const token of tokens.slice(start)) rewriteQuotedCommand(rewrite, token, envReason);
+	else if (launcher) {
+		for (let index = start + 1; index < tokens.length; index++) if (launcher(values[index - 1])) rewriteQuotedCommand(rewrite, tokens[index], envReason);
+	}
+}
+/**
+* Why environment assignments keep tsx for the command they apply to, or undefined.
+* Names match in any case, as on Windows.
+*/
+function envKeepReason(assignments) {
+	if (assignments.some((value) => /^TSX_TSCONFIG_PATH=/i.test(value))) return KEEP_TSX_TSCONFIG;
+	if (assignments.some((value) => /^NODE_OPTIONS=/i.test(value) && TSX_COMMAND.test(value.slice(13)))) return KEEP_NODE_OPTIONS;
+}
+/**
+* An option's name without `=value`. Node.js reads `_` as `-` in long option names, as
+* in `--watch_path`, and so does `vpx`.
+*/
+function optionName(arg) {
+	const name = arg.split("=", 1)[0];
+	return name.startsWith("--") ? `--${name.slice(2).replaceAll("_", "-")}` : name;
+}
+/** Remove `tokens[index]` with the space before it. */
+function removal(tokens, index) {
+	return {
+		start: tokens[index - 1].end,
+		end: tokens[index].end,
+		text: ""
+	};
+}
+/**
+* Why `vpx` would fail on a script that tsx runs, judged from its source. tsx resolves
+* `require('./a.js')` to `a.ts`, and compiles ES module syntax to CommonJS in a `.cts`
+* file and in a package without `"type": "module"`. `vpx` resolves `require()` as
+* Node.js does, rejects ES module syntax in a `.cts` file, and runs the other files as ES
+* modules, so `__dirname`, `__filename`, and `require` are not defined.
+*/
+function scriptKeepReason(cwd, script) {
+	if (cwd === void 0 || /[*?[{]/.test(script) || !SCRIPT_EXTENSIONS.some((extension) => script.endsWith(extension))) return;
+	const file = script.startsWith("~/") ? path.join(os.homedir(), script.slice(2)) : path.resolve(cwd, script);
+	let source;
+	try {
+		source = fs.readFileSync(file, "utf8");
+	} catch (error) {
+		return error.code === "ENOENT" ? `\`${script}\` does not exist yet, so vp migrate cannot check it` : void 0;
+	}
+	for (const [, base, extension] of source.matchAll(RELATIVE_REQUIRE)) {
+		const resolve = (ext) => path.resolve(path.dirname(file), `${base}.${ext}`);
+		const typescript = fs.existsSync(resolve(extension)) ? void 0 : TYPESCRIPT_EXTENSIONS[extension].find((ext) => fs.existsSync(resolve(ext)));
+		if (typescript) return `\`${script}\` requires \`${base}.${extension}\`, which only tsx resolves to \`${base}.${typescript}\`; write the TypeScript extension`;
+	}
+	const code = stripComments(source);
+	if (!/\.(?:c?ts|tsx|jsx?)$/.test(script) || !(ESM_SYNTAX.test(source) || ESM_SYNTAX.test(code))) return;
+	if (script.endsWith(".cts")) return `\`${script}\` uses import or export, which \`vpx\` does not compile to CommonJS; rename it to .mts`;
+	if ((usesCommonJsGlobals(code) || EXPORT_ASSIGNMENT.test(code)) && readNearestPackageJson(path.dirname(file))?.type !== "module") return `\`${script}\` mixes import or export with CommonJS globals such as __dirname, require, or module.exports, and \`vpx\` runs it as an ES module; use import.meta.dirname, import.meta.filename, createRequire(), or export`;
+}
+/** `source` without comments; a string that only looks like one, as in `'http://x'`, stays. */
+function stripComments(source) {
+	return source.replaceAll(/("(?:\\.|[^"\\\n])*"|'(?:\\.|[^'\\\n])*'|`(?:\\.|[^`\\])*`)|\/\*[\s\S]*?\*\/|\/\/[^\n]*/g, (_, string) => string ?? "");
+}
+/**
+* Whether `code`, without comments, uses a CommonJS global it does not declare or import
+* at module level, as in `const require = createRequire(import.meta.url)` or `import
+* module from 'node:module'`. A declaration inside a function, which an unindented line
+* does not start, covers only that function.
+*/
+function usesCommonJsGlobals(code) {
+	return COMMONJS_GLOBALS.some(([name, use]) => use.test(code) && !new RegExp(`^(?:(?:export\\s+)?(?:const|let|var|function|class)\\s+${name}\\b|import\\s+(?:\\*\\s+as\\s+)?${name}\\b)`, "m").test(code));
+}
+/**
+* Why `vpx` cannot run what tsx or `node --import tsx` runs: `positionals` are the entry
+* and its arguments, or with `--test`, the test files; `preloads` are local `--require`
+* and `--import` modules, which load first.
+*/
+function runKeepReason(cwd, test, positionals, preloads) {
+	const [entry] = positionals;
+	if (entry === void 0) return test ? KEEP_TEST_GLOBS : KEEP_REPL;
+	if (!test && !SCRIPT_EXTENSIONS.some((extension) => entry.endsWith(extension))) return `\`${entry}\` has no file extension, which \`vpx\` needs to run it as a script`;
+	const scripts = test ? positionals.filter((value) => !value.startsWith("-")) : [entry];
+	for (const script of [...preloads, ...scripts]) {
+		const reason = scriptKeepReason(cwd, script);
+		if (reason) return reason;
+	}
+}
+function rewriteTsx(rewrite, tokens, first, start, keepReason) {
+	if (keepReason) {
+		rewrite.kept.push(keepReason);
+		return;
+	}
+	let index = start + 1;
+	const watch = tokens[index]?.value === "watch";
+	if (watch) index++;
+	const scanned = scanOptions(tokens, index, true);
+	const reason = runReason(rewrite.cwd, tokens, scanned, watch);
+	if (reason) {
+		rewrite.kept.push(reason);
+		return;
+	}
+	rewrite.edits.push({
+		start: tokens[first].start,
+		end: tokens[index - 1].end,
+		text: watch ? "vpx --watch" : "vpx"
+	}, ...scanned.removals);
+}
+function rewriteNodeLoader(rewrite, tokens, first, start, keepReason) {
+	const scanned = scanOptions(tokens, start + 1, false);
+	if (!scanned.loaders) {
+		if (keepReason === KEEP_NODE_OPTIONS) rewrite.kept.push(keepReason);
+		return;
+	}
+	const reason = keepReason ?? runReason(rewrite.cwd, tokens, scanned, false);
+	if (reason) {
+		rewrite.kept.push(reason);
+		return;
+	}
+	rewrite.edits.push({
+		start: tokens[first].start,
+		end: tokens[start].end,
+		text: "vpx"
+	}, ...scanned.removals);
+}
+/** Read the options of `tsx` (`tsx` true) or `node` from `tokens[index]` up to the entry. */
+function scanOptions(tokens, index, tsx) {
+	const scanned = {
+		entryIndex: tokens.length,
+		removals: [],
+		loaders: 0,
+		preloads: [],
+		test: false,
+		watch: false
+	};
+	for (; index < tokens.length; index++) {
+		const { value } = tokens[index];
+		if (value === "--" || !value.startsWith("-")) {
+			scanned.entryIndex = value === "--" ? index + 1 : index;
+			break;
+		}
+		const name = optionName(value);
+		const inline = value.includes("=");
+		if (tsx && name === "--no-cache") {
+			scanned.removals.push(removal(tokens, index));
+			continue;
+		}
+		if (LOADER_OPTIONS.has(name)) {
+			const loader = inline ? value.slice(value.indexOf("=") + 1) : tokens[index + 1]?.value;
+			if (loader !== void 0 && TSX_LOADER.test(loader)) {
+				scanned.removals.push({
+					...removal(tokens, index),
+					end: tokens[inline ? index : index + 1].end
+				});
+				scanned.loaders++;
+			} else if (loader !== void 0 && (loader.startsWith(".") || path.isAbsolute(loader))) scanned.preloads.push(loader);
+			if (!inline) index++;
+			continue;
+		}
+		scanned.keepReason ??= KEEP_OPTIONS.get(name);
+		scanned.test ||= name === "--test";
+		scanned.watch ||= name === "--watch";
+		if (!inline && (NODE_OPTIONS_WITH_VALUE.has(name) || tsx && (WATCH_OPTIONS_WITH_VALUE.has(name) || name === "--tsconfig"))) index++;
+	}
+	return scanned;
+}
+/** Why `vpx` cannot run what the scanned options and the scripts after them run. */
+function runReason(cwd, tokens, scanned, watch) {
+	if (scanned.keepReason) return scanned.keepReason;
+	if ((watch || scanned.watch) && scanned.test) return KEEP_WATCH_TEST;
+	return runKeepReason(cwd, scanned.test, tokens.slice(scanned.entryIndex).map(({ value }) => value), scanned.preloads);
+}
+/**
+* Rewrite a command that a launcher runs, given as one quoted argument. `inherited` keeps
+* tsx for it, as when the launcher passes on `TSX_TSCONFIG_PATH`.
+*/
+function rewriteQuotedCommand(rewrite, token, inherited) {
+	const raw = rewrite.command.slice(token.start, token.end);
+	const quote = raw[0];
+	if (quote !== "\"" && quote !== "'" || raw.length < 2 || !raw.endsWith(quote)) return;
+	const inner = rewriteTsxCommand(token.value, rewrite.cwd);
+	rewrite.kept.push(...inner.kept);
+	if (inner.command === token.value) return;
+	if (inherited) rewrite.kept.push(inherited);
+	else if (!inner.command.includes(quote)) rewrite.edits.push({
+		start: token.start,
+		end: token.end,
+		text: `${quote}${inner.command}${quote}`
+	});
+}
+/** The commands in a scripts or lint-staged record. */
+function recordCommands(record) {
+	if (!isPlainRecord(record)) return [];
+	return Object.values(record).flatMap((value) => Array.isArray(value) ? value : [value]).filter((command) => typeof command === "string");
+}
+/** The commands a package.json runs: its scripts and lint-staged tasks. */
+function packageCommands(pkg) {
+	return [...recordCommands(pkg.scripts), ...recordCommands(pkg["lint-staged"])];
+}
+function lintStagedJsonFiles(dir) {
+	return LINT_STAGED_JSON_CONFIG_FILES.map((name) => path.join(dir, name)).filter((file) => fs.existsSync(file) && isJsonFile(file));
+}
+/**
+* A package that lists tsx outside devDependencies keeps it: its published code or
+* production scripts can need tsx, and `vpx` comes from the vite-plus devDependency.
+*/
+function ownsTsxAtRuntime(pkg) {
+	return pkg.dependencies?.tsx !== void 0 || pkg.optionalDependencies?.tsx !== void 0 || pkg.peerDependencies?.tsx !== void 0;
+}
+function packageDirs(rootDir, packages) {
+	return [rootDir, ...(packages ?? []).map((pkg) => path.join(rootDir, pkg.path))];
+}
+/**
+* Whether a script, lint-staged task, or `#!/usr/bin/env tsx` shebang runs tsx in a form
+* `vpx` replaces.
+*/
+function detectTsxProject(rootDir, packages) {
+	return packageDirs(rootDir, packages).some((dir) => {
+		const pkg = readPackageJsonIfExists(path.join(dir, "package.json"));
+		if (!pkg || ownsTsxAtRuntime(pkg)) return false;
+		return [...packageCommands(pkg), ...lintStagedJsonFiles(dir).flatMap((file) => recordCommands(readJsonFile(file)))].some((command) => rewriteTsxCommand(command, dir).command !== command) || sourceTreeMatches(dir, (content, file) => {
+			const result = rewriteTsxShebang(content, file);
+			return result !== void 0 && "content" in result;
+		});
+	});
+}
+/** Rewrite each command of a scripts or lint-staged record; returns whether one changed. */
+function rewriteCommandRecord(record, label, cwd, report) {
+	let edited = false;
+	for (const [key, value] of Object.entries(record)) {
+		const commands = Array.isArray(value) ? value : [value];
+		const rewritten = commands.map((command) => {
+			if (typeof command !== "string") return command;
+			const result = rewriteTsxCommand(command, cwd);
+			for (const reason of result.kept) warnMigration(`Kept tsx in ${label} "${key}": ${reason}.`, report);
+			return result.command;
+		});
+		if (rewritten.some((command, index) => command !== commands[index])) {
+			record[key] = Array.isArray(value) ? rewritten : rewritten[0];
+			edited = true;
+		}
+	}
+	return edited;
+}
+/**
+* The `vpx` version of a script file's tsx shebang, or why it keeps tsx; undefined when
+* the file has no `#!/usr/bin/env tsx` shebang.
+*/
+function rewriteTsxShebang(content, file) {
+	const match = TSX_ENV_SHEBANG.exec(content);
+	if (!match) return;
+	const [line, prefix, command] = match;
+	const result = rewriteTsxCommand(`${command.trimEnd()} ${SHEBANG_ENTRY}`);
+	const reason = result.kept[0] ?? scriptKeepReason(path.dirname(file), `./${path.basename(file)}`);
+	if (reason) return { reason };
+	return { content: `${prefix}${result.command.slice(0, -` ${SHEBANG_ENTRY}`.length)}${content.slice(line.length)}` };
+}
+/** Point `#!/usr/bin/env tsx` shebangs of a package's script files at `vpx`. */
+function rewriteTsxShebangs(dir, report) {
+	let changed = false;
+	sourceTreeMatches(dir, (content, file) => {
+		const result = rewriteTsxShebang(content, file);
+		if (result && "reason" in result) warnMigration(`Kept tsx in the shebang of ${displayRelative(file)}: ${result.reason}.`, report);
+		else if (result) {
+			fs.writeFileSync(file, result.content);
+			changed = true;
+		}
+		return false;
 	});
-	return tokens;
+	return changed;
+}
+/**
+* What still runs or imports tsx under `dir`, or undefined. The scan crosses into nested
+* packages, which can resolve this package's tsx, and reads build output, which can
+* still load it.
+*/
+function findTsxUse(dir) {
+	let found;
+	sourceTreeMatches(dir, (content, file) => {
+		if (LOCKFILES.has(path.basename(file))) return false;
+		const uses = fileUsesTsx(content, file);
+		if (uses) found = `${displayRelative(file)} still uses tsx`;
+		return uses;
+	}, {
+		crossPackageBoundaries: true,
+		extensions: REFERENCE_EXTENSIONS,
+		includeExtensionless: true,
+		includePackageReferences: true,
+		matchesPackage: (packageDir, pkg) => {
+			const field = Object.entries(pkg).find(([key, value]) => !IGNORED_FIELDS.has(key) && jsonUsesTsx(value, [
+				"imports",
+				"lint-staged",
+				"scripts"
+			].includes(key)))?.[0];
+			if (field !== void 0) found = `\`${field}\` in ${displayRelative(path.join(packageDir, "package.json"))} still uses tsx`;
+			return field !== void 0;
+		},
+		skipDirs: USE_SCAN_SKIP_DIRS
+	});
+	return found;
 }
-/** Read command lists without executing a shell. Directory-changing builtins,
-* expansions, pipelines, and shell programs remain unresolved. */
+/** Whether `file` runs, imports, or loads tsx. */
+function fileUsesTsx(content, file) {
+	if (TSX_SHEBANG.test(content)) return true;
+	const name = path.basename(file);
+	if (LINT_STAGED_JSON_CONFIG_FILES.some((config) => config === name) && jsonUsesTsx(parse(content), true)) return true;
+	const extension = path.extname(file);
+	if (extension === ".json" || extension === ".jsonc") return jsonUsesTsx(parse(content), false);
+	if (CODE_EXTENSIONS.has(extension)) return TSX_CODE_REFERENCE.test(content);
+	return TSX_TEXT_REFERENCE.test(content) || extension === "" && TSX_CODE_REFERENCE.test(content);
+}
+/**
+* Whether a JSON value holds a string that runs or loads tsx: a tsx command with an
+* argument, a loader flag such as `--import=tsx` or `["--import", "tsx"]`, or a subpath
+* such as `tsx/cjs`. A bare `tsx` counts only in `commands` (scripts, lint-staged tasks,
+* and `imports` aliases) and as a loader setting such as Mocha's `"import": "tsx"`;
+* elsewhere it is often a file extension, as in `moduleFileExtensions`.
+*/
+function jsonUsesTsx(value, commands) {
+	if (typeof value === "string") return commands && TSX_COMMAND.test(value) || TSX_CONFIG_VALUE.test(value);
+	if (Array.isArray(value)) return value.some((item, index) => jsonUsesTsx(item, commands) || typeof item === "string" && LOADER_OPTIONS.has(item) && TSX_LOADER.test(String(value[index + 1])));
+	return isPlainRecord(value) && Object.entries(value).some(([key, item]) => jsonUsesTsx(item, commands) || LOADER_SETTINGS.has(key) && [item].flat().some((loader) => TSX_LOADER.test(String(loader))));
+}
+/**
+* Move tsx scripts to `vpx`: rewrite package.json scripts, lint-staged tasks, and
+* `#!/usr/bin/env tsx` shebangs, then remove the tsx devDependency from each package
+* where nothing uses tsx anymore.
+*/
+function migrateTsxToVpx(rootDir, packages, report) {
+	let changed = false;
+	const migrated = [];
+	for (const dir of packageDirs(rootDir, packages)) {
+		const packageJsonPath = path.join(dir, "package.json");
+		const pkg = readPackageJsonIfExists(packageJsonPath);
+		if (!pkg) continue;
+		if (ownsTsxAtRuntime(pkg)) {
+			if (packageCommands(pkg).some((c) => TSX_COMMAND.test(c))) warnMigration(`Kept tsx in ${displayRelative(packageJsonPath)}: it is listed in dependencies, optionalDependencies, or peerDependencies there, and \`vpx\` comes from the vite-plus devDependency.`, report);
+			continue;
+		}
+		migrated.push(dir);
+		editJsonFile(packageJsonPath, (json) => {
+			let edited = false;
+			for (const field of ["scripts", "lint-staged"]) {
+				const record = json[field];
+				if (isPlainRecord(record) && rewriteCommandRecord(record, `${displayRelative(packageJsonPath)} ${field}`, dir, report)) edited = true;
+			}
+			changed ||= edited;
+			return edited ? json : void 0;
+		});
+		for (const file of lintStagedJsonFiles(dir)) editJsonFile(file, (config) => {
+			const edited = rewriteCommandRecord(config, displayRelative(file), dir, report);
+			changed ||= edited;
+			return edited ? config : void 0;
+		});
+		if (rewriteTsxShebangs(dir, report)) changed = true;
+	}
+	let dependencyRemoved = false;
+	for (const dir of migrated) {
+		const packageJsonPath = path.join(dir, "package.json");
+		if (readPackageJsonIfExists(packageJsonPath)?.devDependencies?.tsx === void 0) continue;
+		const use = findTsxUse(dir);
+		if (use) {
+			warnMigration(`Kept the tsx devDependency in ${displayRelative(packageJsonPath)}: ${use}.`, report);
+			continue;
+		}
+		editJsonFile(packageJsonPath, (json) => {
+			delete json.devDependencies.tsx;
+			return json;
+		});
+		dependencyRemoved = true;
+	}
+	if (report && changed) report.tsxMigrated = true;
+	return {
+		changed: changed || dependencyRemoved,
+		dependencyRemoved
+	};
+}
+async function confirmTsxMigration(interactive) {
+	if (interactive) {
+		const confirmed = await confirm({
+			message: "Migrate tsx scripts to vpx?\n  " + styleText("gray", "vpx is Vite+'s built-in TypeScript script runner: `tsx <file>` becomes `vpx <file>`, `tsx watch` becomes `vpx --watch`, and the tsx dependency is removed once nothing uses it."),
+			initialValue: true
+		});
+		if (isCancel(confirmed)) cancelAndExit();
+		return confirmed;
+	}
+	log$1.info("tsx scripts detected. Auto-migrating to vpx...");
+	return true;
+}
+// src/migration/vitest-v5/commands.ts
+/** Read test commands without evaluating shell state or directory changes. */
 function literalTestCommands(command) {
-	const commands = [];
-	let quote = "";
-	let start = 0;
-	const append = (end) => {
-		const tokens = literalArgv(command.slice(start, end));
-		if (!tokens?.length) return false;
+	const commands = parseLiteralCommands(command, true);
+	if (!commands) return;
+	const result = [];
+	for (const tokens of commands) {
 		const values = tokens.map(({ value }) => value);
 		while (/^[A-Za-z_]\w*=/.test(values[0] ?? "")) values.shift();
-		if (!values.length || [
-			"cd",
-			"pushd",
-			"popd",
-			".",
-			"source",
-			"eval",
-			"export",
-			"set",
-			"unset"
-		].includes(values[0])) return false;
-		commands.push(values);
-		return true;
-	};
-	for (let index = 0; index < command.length; index++) {
-		const char = command[index];
-		if (char === "\\") return;
-		if (quote) {
-			if (char === quote) quote = "";
-		} else if (char === "\"" || char === "'") quote = char;
-		else if (char === "#") return;
-		else if (char === ";" || command.slice(index, index + 2) === "&&" || command.slice(index, index + 2) === "||") {
-			if (!append(index)) return;
-			if (char !== ";") index++;
-			start = index + 1;
-		}
+		if (!values.length || SHELL_STATE_COMMANDS.includes(values[0])) return;
+		result.push(values);
 	}
-	return !quote && append(command.length) ? commands : void 0;
+	return result;
 }
 /** Locate the runner's arguments after a supported package-manager wrapper. */
 function vitestCommandArgsStart(values) {
-	let start = 0;
-	if ([
-		"pnpm",
-		"npm",
-		"yarn",
-		"bun",
-		"npx",
-		"bunx"
-	].includes(values[0])) {
-		start = 1;
-		if (values[start] === "exec" || values[start] === "x") start++;
-		if (values[start] === "--") start++;
-	}
+	const start = getCommandStartIndex(values);
 	if (values[start] === "vitest") return start + 1;
 	if (values[start] === "vp" && values[start + 1] === "test") return start + 2;
 	return -1;
 }
 function migrateBenchmarkOutput(command) {
-	const argv = literalArgv(command);
+	const argv = parseLiteralCommands(command, false)?.[0];
 	if (!argv) return command;
 	const values = argv.map(({ value }) => value);
 	const start = vitestCommandArgsStart(values);
@@ -182,7 +676,7 @@ function migrateVitestV5Command(file, command, preserveV4, line = 1, reviewV4 =
 		findings
 	};
 	command = migrateBenchmarkOutput(command);
-	const argv = literalArgv(command);
+	const argv = parseLiteralCommands(command, false)?.[0];
 	const values = argv?.map(({ value }) => value);
 	const runner = values ? vitestCommandArgsStart(values) : -1;
 	let removedFlag = /(?:^|\s)(?:--compare|--outputJson)(?:\s|=|$)/.test(command);
@@ -230,8 +724,7 @@ function migrateVitestV5Command(file, command, preserveV4, line = 1, reviewV4 =
 		findings
 	};
 }
-//#endregion
-//#region src/migration/vitest-v5/ast.ts
+// src/migration/vitest-v5/ast.ts
 function isNode(value) {
 	return typeof value === "object" && value !== null && "type" in value && "start" in value;
 }
@@ -505,7 +998,7 @@ var SourceEditor = class {
 				}
 			}
 			const propertyIndent = multilinePrefix && object.properties.length ? indent : `${objectIndent}  `;
-			const entries = [...additions.values()].map((property) => printAddedProperty(property, propertyIndent, newline));
+			const entries = Array.from(additions.values(), (property) => printAddedProperty(property, propertyIndent, newline));
 			const suffix = multiline && !multilinePrefix ? `${newline}${object.properties.length ? propertyIndent : objectIndent}` : "";
 			this.edit(start, multiline && !multilinePrefix && /^\s*$/.test(prefix) ? first : start, multiline ? `${newline}${propertyIndent}${entries.join(`,${newline}${propertyIndent}`)}${object.properties.length ? "," : ""}${suffix}` : ` ${entries.join(", ")}${object.properties.length ? "," : ""} `);
 		}
@@ -538,8 +1031,7 @@ var SourceEditor = class {
 		};
 	}
 };
-//#endregion
-//#region src/migration/vitest-v5/benchmark-config.ts
+// src/migration/vitest-v5/benchmark-config.ts
 const REPORTERS = /* @__PURE__ */ new Set([
 	"default",
 	"verbose",
@@ -607,8 +1099,7 @@ function migrateBenchmarkConfig(editor, test) {
 		oldJson
 	]) if (prop) editor.remove(benchmark, prop);
 }
-//#endregion
-//#region src/migration/vitest-v5/compatibility.ts
+// src/migration/vitest-v5/compatibility.ts
 const settings = {
 	clearMocks: {
 		value: "false",
@@ -656,8 +1147,7 @@ function compatibilityProperty(key) {
 		comment: `// Vitest v4 compatibility: ${reason}\n// ${adoption}\n// ${documentationUrl$1("/guide/vitest-v5#remove-unneeded-compatibility-settings")}\n// https://vitest.dev/guide/migration/#${section}`
 	};
 }
-//#endregion
-//#region src/migration/vitest-v5/config-object.ts
+// src/migration/vitest-v5/config-object.ts
 const CONFIG_KEYS = /* @__PURE__ */ new Set([
 	"root",
 	"test",
@@ -703,8 +1193,7 @@ function resolveConfigObject(editor, node) {
 	}
 	return node;
 }
-//#endregion
-//#region src/migration/vitest-v5/config.ts
+// src/migration/vitest-v5/config.ts
 function isTrue(node) {
 	return isBoolean(node) && node.value;
 }
@@ -1001,8 +1490,7 @@ function migrateConfig(file, source, options, mergedConfig, benchmarkOnly = fals
 	});
 	return editor.finish();
 }
-//#endregion
-//#region src/migration/vitest-v5/documentation.ts
+// src/migration/vitest-v5/documentation.ts
 const guide = documentationUrl$1("/guide/vitest-v5");
 const upstream = "https://vitest.dev/guide/migration/";
 const sections = {
@@ -1054,8 +1542,7 @@ function vitestV5Documentation(code) {
 	if (sections[code]) return `${upstream}#${sections[code]}`;
 	return `${guide}#${localSections[code] ?? "resolve-migration-findings"}`;
 }
-//#endregion
-//#region src/migration/vitest-v5/lockfile.ts
+// src/migration/vitest-v5/lockfile.ts
 var import_dist = require_dist();
 function record$1(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
@@ -1143,8 +1630,7 @@ function lockedVitestVersion(root, directory, manager, spec) {
 		}
 	} catch {}
 }
-//#endregion
-//#region src/migration/vitest-v5/storybook.ts
+// src/migration/vitest-v5/storybook.ts
 const STORYBOOK_PLUGIN = /* @__PURE__ */ new Set(["@storybook/addon-vitest/vitest-plugin"]);
 const NODE_PATH = /* @__PURE__ */ new Set(["node:path", "path"]);
 const NODE_URL = /* @__PURE__ */ new Set(["node:url", "url"]);
@@ -1268,8 +1754,7 @@ function resolveStorybookScope(editor, object, sources, file, cwd) {
 		return unknown(`cannot parse ${label}/main`);
 	}
 }
-//#endregion
-//#region src/migration/vitest-v5/scopes.ts
+// src/migration/vitest-v5/scopes.ts
 const DEFAULT_TEST_INCLUDE = ["**/*.{test,spec}.?(c|m)[jt]s?(x)"];
 const DEFAULT_TEST_EXCLUDE = ["**/node_modules/**", "**/.git/**"];
 const DEFAULT_BENCHMARK_INCLUDE = ["**/*.{bench,benchmark}.?(c|m)[jt]s?(x)"];
@@ -1659,7 +2144,7 @@ function resolveVitestV5TestModes(sources, configFiles, preserveV4, entries) {
 		if (!found) unknown();
 	}
 	return {
-		modes: new Map([...sources.keys()].map((file) => {
+		modes: new Map(Array.from(sources.keys(), (file) => {
 			const matching = [];
 			let benchmarkFile = false;
 			const hasInSourceTests = sources.get(file)?.includes("import.meta.vitest");
@@ -1696,8 +2181,7 @@ function resolveVitestV5TestModes(sources, configFiles, preserveV4, entries) {
 		findings
 	};
 }
-//#endregion
-//#region src/migration/vitest-v5/benchmarks.ts
+// src/migration/vitest-v5/benchmarks.ts
 /** Keep the workload as a separate callback: making it the test callback
 * would measure nothing, and inlining it into a new closure can change scope. */
 function migrateBenchmarks(editor, globals = false) {
@@ -1840,8 +2324,7 @@ function migrateBenchmarks(editor, globals = false) {
 		calls
 	};
 }
-//#endregion
-//#region src/migration/vitest-v5/source.ts
+// src/migration/vitest-v5/source.ts
 const RUNNER_SYMBOLS = {
 	test: "test",
 	it: "it",
@@ -2074,6 +2557,45 @@ function looksLikeConstructorMock(editor, node) {
 	}
 	return false;
 }
+function unwrapTypeExpression(node) {
+	while (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "TSNonNullExpression" || node.type === "TSTypeAssertion") node = node.expression;
+	return node;
+}
+/** Recognize a local promise consumed by a later statement without crossing
+* control flow or function boundaries. Ambiguous paths still need review. */
+function isAssertionBindingHandled(editor, node) {
+	let initializer = node;
+	let declarator = editor.parent(initializer);
+	while (declarator && unwrapTypeExpression(declarator) === node) {
+		initializer = declarator;
+		declarator = editor.parent(initializer);
+	}
+	if (declarator?.type !== "VariableDeclarator" || declarator.init !== initializer || declarator.id.type !== "Identifier") return false;
+	const binding = editor.binding(declarator.id);
+	const declaration = editor.parent(declarator);
+	const block = declaration && editor.parent(declaration);
+	const fn = editor.functionParent(node);
+	if (!binding?.constant || declaration?.type !== "VariableDeclaration" || declaration.kind !== "const" || block?.type !== "BlockStatement" || !fn || fn.generator) return false;
+	for (let ancestor = editor.parent(block); ancestor && ancestor !== fn; ancestor = editor.parent(ancestor)) if (ancestor.type === "TryStatement") return false;
+	for (const statement of block.body.slice(block.body.indexOf(declaration) + 1)) switch (statement.type) {
+		case "ReturnStatement": {
+			if (!statement.argument) return false;
+			let expression = unwrapTypeExpression(statement.argument);
+			if (expression.type === "AwaitExpression") expression = unwrapTypeExpression(expression.argument);
+			return editor.binding(expression) === binding;
+		}
+		case "ExpressionStatement": {
+			const expression = unwrapTypeExpression(statement.expression);
+			if (expression.type === "AwaitExpression" && editor.binding(unwrapTypeExpression(expression.argument)) === binding) return true;
+			break;
+		}
+		case "VariableDeclaration":
+		case "FunctionDeclaration":
+		case "EmptyStatement": break;
+		default: return false;
+	}
+	return false;
+}
 function chain(node, isApi) {
 	const members = [];
 	const calls = [];
@@ -2268,7 +2790,7 @@ function rewriteSource(file, source, options) {
 				if (asynchronous && parent?.type === "ExpressionStatement") {
 					if (canAwait(node)) editor.edit(node.start, node.start, "await ");
 					else editor.report(node, "unawaited-assertion", "Await or return this asynchronous assertion in an async-compatible function.");
-				} else if (asynchronous && parent?.type !== "MemberExpression" && parent?.type !== "AwaitExpression" && parent?.type !== "ReturnStatement") editor.report(node, "unawaited-assertion", "Check that the result of this asynchronous assertion is awaited or returned.");
+				} else if (asynchronous && parent?.type !== "MemberExpression" && parent?.type !== "AwaitExpression" && parent?.type !== "ReturnStatement" && !isAssertionBindingHandled(editor, node)) editor.report(node, "unawaited-assertion", "Check that the result of this asynchronous assertion is awaited or returned.");
 			}
 			if (importedName(editor, node.callee, RENDER_SOURCES) === "render" && parent?.type !== "AwaitExpression" && parent?.type !== "ReturnStatement") {
 				if (canAwait(node)) {
@@ -2352,8 +2874,7 @@ function rewriteSource(file, source, options) {
 	if (benchmark && result.content === source) editor.report(benchmark, "benchmark-api", "The benchmark rewrite was discarded. Migrate the remaining legacy bench API manually before upgrading to Vitest v5.", "block");
 	return result;
 }
-//#endregion
-//#region src/migration/vitest-v5/webdriverio.ts
+// src/migration/vitest-v5/webdriverio.ts
 const MIN_VERSION = "5.0.0";
 const DEFAULT_SPEC = "^5.0.0";
 const REGISTRY_ALIAS = `npm:${WEBDRIVERIO_PROVIDER}@`;
@@ -2573,8 +3094,7 @@ function migrateWebdriverioDependencies(workspace, sources, inputs) {
 	overrideMap(path.join(workspace.rootDir, "pnpm-workspace.yaml"), ["overrides"]);
 	return findings;
 }
-//#endregion
-//#region src/migration/migrator/vitest-v5.ts
+// src/migration/migrator/vitest-v5.ts
 const SKIP_DIRS = /* @__PURE__ */ new Set([
 	"node_modules",
 	".git",
@@ -2905,7 +3425,7 @@ function planVitestV5Migration(workspace, originalProjects) {
 	const findings = [];
 	const directories = [workspace.rootDir, ...(workspace.packages ?? []).map((pkg) => path.resolve(workspace.rootDir, pkg.path))];
 	const projects = [];
-	const projectSources = new Map([...new Set(directories)].map((directory) => [directory, new Map(filesInProject(directory).map((file) => [file, fs.readFileSync(file, "utf8")]))]));
+	const projectSources = new Map(Array.from(new Set(directories), (directory) => [directory, new Map(filesInProject(directory).map((file) => [file, fs.readFileSync(file, "utf8")]))]));
 	const allSources = /* @__PURE__ */ new Map();
 	for (const sources of projectSources.values()) for (const [file, source] of sources) allSources.set(file, source);
 	const rewrittenSources = new Map(allSources);
@@ -3032,7 +3552,7 @@ function currentProjectConfigs(plan) {
 	const filesByProject = new Map(plan.projects.map((project) => [project.directory, filesInProject(project.directory)]));
 	const sources = new Map([...filesByProject.values()].flat().map((file) => [file, fs.readFileSync(file, "utf8")]));
 	const configs = findVitestV5ConfigFiles(sources, findVitestV5ConfigEntries(sources, filesByProject.keys()).flatMap((entry) => entry.file ? [entry.file] : []));
-	return new Map([...filesByProject].map(([directory, files]) => [directory, files.filter((file) => configs.has(file))]));
+	return new Map(Array.from(filesByProject, ([directory, files]) => [directory, files.filter((file) => configs.has(file))]));
 }
 /** Run after other migration steps create or merge configs. Keep the source
 * version and deferred reviews in memory until the final report; no state file. */
@@ -3080,8 +3600,7 @@ function finishVitestV5Migration(plan) {
 	const after = planVitestV5Migration(workspaceFromPlan(plan), new Map(plan.projects.map((project) => [project.directory, completedProjects.get(project.directory) ?? project])));
 	return [...findings, ...after.findings];
 }
-//#endregion
-//#region src/migration/compat/runner.ts
+// src/migration/compat/runner.ts
 /**
 * Resolve the isolated compat worker emitted at `migration/compat/worker.js`.
 *
@@ -3137,8 +3656,7 @@ async function checkRolldownCompatibility(rootDir, report) {
 		for (const warning of compatibilityResult?.warnings ?? []) addMigrationWarning(report, warning);
 	} catch {}
 }
-//#endregion
-//#region src/migration/format.ts
+// src/migration/format.ts
 const FORMAT_FAILURE_MESSAGE = "Automatic formatting failed. Run `vp fmt` manually after migration.";
 const MAX_FORMAT_ARG_BYTES = process.platform === "win32" ? 24e3 : 1e5;
 function chunkPathsByArgLength(paths) {
@@ -3264,8 +3782,29 @@ async function formatMigratedProject(projectRoot, interactive, report, options =
 	addMigrationWarning(report, FORMAT_FAILURE_MESSAGE);
 	return false;
 }
-//#endregion
-//#region src/migration/npm-reinstall.ts
+// src/migration/install-result.ts
+/**
+* Reconcile a CommandRunSummary from `runViteInstall` with the migration's
+* duration counter and exit-code state. `runViteInstall` returns
+* `{ status: 'failed', exitCode }` without throwing; treating that as a success
+* (incrementing duration unconditionally) would let the migration claim
+* "Dependencies installed" while node_modules is desynced from the just-mutated
+* package.json. This helper centralizes the right handling: credit duration on
+* success, warn + flip exitCode on failure, stay silent on skip.
+*/
+function handleInstallResult(installSummary, rootDir, report, options) {
+	if (installSummary.status === "installed") return installSummary.durationMs;
+	if (installSummary.status === "failed") {
+		const exitCode = installSummary.exitCode ?? 1;
+		const message = `Dependency installation failed (exit code ${exitCode}). Run \`vp install\` manually in ${rootDir} to resync node_modules.`;
+		warnMsg(message);
+		report.warnings.push(message);
+		if (options?.propagateExitCode !== false) process.exitCode = exitCode;
+		return 0;
+	}
+	return 0;
+}
+// src/migration/npm-reinstall.ts
 const VITE_PLUS_CORE_PACKAGE = "@voidzero-dev/vite-plus-core";
 function isViteInstallPath(packagePath) {
 	return packagePath === "node_modules/vite" || packagePath.endsWith("/node_modules/vite");
@@ -3354,18 +3893,20 @@ function prepareNpmViteAliasReinstall(rootDir, projectPaths = [rootDir]) {
 		}
 	};
 }
-//#endregion
-//#region src/migration/setup-plan.ts
+// src/migration/setup-plan.ts
 async function collectGitHooksDecision(rootDir, packageManager, options, packages = []) {
-	let shouldSetupHooks = await promptGitHooks(options);
-	if (shouldSetupHooks) {
-		const reason = preflightGitHooksSetup(rootDir, packageManager, packages);
-		if (reason) {
-			log$1.warn(`⚠ ${reason}`);
-			shouldSetupHooks = false;
-		}
+	const hasExistingHooks = options.hooks === void 0 && hasExistingViteHooksPolicy(rootDir);
+	if (hasExistingHooks && isViteHooksSetupComplete(rootDir)) {
+		log(`${muted("•")} Git hooks already configured, skipping`);
+		return false;
 	}
-	return shouldSetupHooks;
+	if (!hasExistingHooks && !await promptGitHooks(options)) return false;
+	const reason = preflightGitHooksSetup(rootDir, packageManager, packages);
+	if (reason) {
+		log$1.warn(`⚠ ${reason}`);
+		return false;
+	}
+	return true;
 }
 async function collectAgentInstructionPlan(rootDir, options) {
 	const existingAgentTargetPaths = options.agent !== void 0 || !options.interactive ? void 0 : detectExistingAgentTargetPaths(rootDir);
@@ -3469,13 +4010,9 @@ async function collectMigrationSetupPlan(rootDir, packageManager, options, packa
 		...eslintPlan
 	};
 }
-//#endregion
-//#region src/migration/bin.ts
+// src/migration/bin.ts
 async function confirmNodeVersionFileMigration(interactive, detection) {
-	const message = {
-		"package.json": "Migrate Volta node version (package.json) to .node-version?",
-		".nvmrc": "Migrate .nvmrc to .node-version?"
-	}[detection.file];
+	const message = { "package.json": "Migrate Volta node version (package.json) to .node-version?" }[detection.file];
 	if (interactive) {
 		const confirmed = await confirm({
 			message,
@@ -3609,7 +4146,7 @@ function hasExistingVitePlusMigrationCandidates(workspaceInfo, options) {
 	const eslintProject = detectEslintProject(workspaceInfo.rootDir, workspaceInfo.packages);
 	const prettierProject = detectPrettierProject(workspaceInfo.rootDir, workspaceInfo.packages);
 	const tsupProject = detectTsupProject(workspaceInfo.rootDir, workspaceInfo.packages);
-	return hasExplicitExistingVitePlusSetupRequest(options) || detectLegacyGitHooksMigrationCandidate(workspaceInfo.rootDir) || hasBaseUrlInWorkspace(workspaceInfo) || eslintProject.hasDependency || prettierProject.hasDependency || tsupProject.hasDependency || detectNodeVersionManagerFile(workspaceInfo.rootDir) !== void 0 || getFrameworkShimCandidates(workspaceInfo.rootDir, workspaceInfo.packages).length > 0;
+	return hasExplicitExistingVitePlusSetupRequest(options) || detectLegacyGitHooksMigrationCandidate(workspaceInfo.rootDir) || hasBaseUrlInWorkspace(workspaceInfo) || eslintProject.hasDependency || prettierProject.hasDependency || tsupProject.hasDependency || detectTsxProject(workspaceInfo.rootDir, workspaceInfo.packages) || detectNodeVersionManagerFile(workspaceInfo.rootDir) !== void 0 || getFrameworkShimCandidates(workspaceInfo.rootDir, workspaceInfo.packages).length > 0;
 }
 function getExistingVitePlusSetupOptions(options, useFullMigrationDefaults = false) {
 	if (useFullMigrationDefaults) return options;
@@ -3629,6 +4166,7 @@ async function collectMigrationPlan(rootDir, detectedPackageManager, detectedPac
 	if (prettierProject.hasDependency && prettierProject.configFile) migratePrettier = await confirmPrettierMigration(options.interactive);
 	else if (prettierProject.hasDependency) warnPackageLevelPrettier();
 	const { migrateTsup, tsupConfigFile } = await collectTsupMigrationDecision(rootDir, options, packages);
+	const migrateTsx = detectTsxProject(rootDir, packages) && await confirmTsxMigration(options.interactive);
 	const fixBaseUrl = hasBaseUrlInWorkspace({
 		rootDir,
 		packages
@@ -3646,33 +4184,13 @@ async function collectMigrationPlan(rootDir, detectedPackageManager, detectedPac
 		prettierConfigFile: prettierProject.configFile,
 		migrateTsup,
 		tsupConfigFile,
+		migrateTsx,
 		fixBaseUrl,
 		migrateNodeVersionFile,
 		nodeVersionDetection,
 		frameworkShimFrameworks
 	};
 }
-/**
-* Reconcile a CommandRunSummary from `runViteInstall` with the migration's
-* duration counter and exit-code state. `runViteInstall` returns
-* `{ status: 'failed', exitCode }` without throwing; treating that as a success
-* (incrementing duration unconditionally) would let the migration claim
-* "Dependencies installed" while node_modules is desynced from the just-mutated
-* package.json. This helper centralizes the right handling: credit duration on
-* success, warn + flip exitCode on failure, stay silent on skip.
-*/
-function handleInstallResult(installSummary, rootDir, report, options) {
-	if (installSummary.status === "installed") return installSummary.durationMs;
-	if (installSummary.status === "failed") {
-		const exitCode = installSummary.exitCode ?? 1;
-		const message = `Dependency installation failed (exit code ${exitCode}). Run \`vp install\` manually in ${rootDir} to resync node_modules.`;
-		warnMsg(message);
-		report.warnings.push(message);
-		if (options?.propagateExitCode !== false) process.exitCode = exitCode;
-		return 0;
-	}
-	return 0;
-}
 const FULL_MIGRATION_HINT = `${styleText("gray", "•")} Skipped editor, hooks, and lint setup. Run \`vp migrate --full\` to apply them.`;
 function showMigrationSummary(options) {
 	const { projectRoot, packageManager, packageManagerVersion, installDurationMs, finalInstallOk, report, updatedExistingVitePlus, suggestFullMigration } = options;
@@ -3702,6 +4220,7 @@ function showMigrationSummary(options) {
 	if (report.eslintMigrated) log(`${styleText("gray", "•")} ESLint rules migrated to Oxlint`);
 	if (report.prettierMigrated) log(`${styleText("gray", "•")} Prettier migrated to Oxfmt`);
 	if (report.tsupMigrated) log(`${styleText("gray", "•")} tsup config migrated to tsdown (\`vp pack\`)`);
+	if (report.tsxMigrated) log(`${styleText("gray", "•")} tsx scripts migrated to \`vpx\``);
 	if (report.nodeVersionFileMigrated) log(`${styleText("gray", "•")} Node version manager file migrated to .node-version`);
 	const setupVpFileCount = report.setupVpVersionUpdatedFileCount;
 	if (setupVpFileCount > 0) {
@@ -3855,6 +4374,10 @@ async function executeMigrationPlan(workspaceInfoOptional, plan, interactive, vi
 			cancelAndExit("Complete the tsup migration manually, then re-run `vp migrate`.", 1);
 		}
 	}
+	if (plan.migrateTsx) {
+		updateMigrationProgress("Migrating tsx scripts");
+		migrateTsxToVpx(workspaceInfo.rootDir, workspaceInfo.packages, report);
+	}
 	vitestV5Plan = applyRefreshedVitestV5Migration(vitestV5Plan);
 	const skipStagedMigration = shouldSkipStagedMigrationForHooks(workspaceInfo.rootDir, plan.shouldSetupHooks, plan.packageManager, workspaceInfo.packages);
 	updateMigrationProgress("Rewriting configs");
@@ -3987,6 +4510,7 @@ async function main() {
 		updateMigrationProgress("Rewriting toolchain imports across the workspace");
 		const coreMigrationResult = finalizeCoreMigrationForExistingVitePlus(workspaceInfoOptional, true, report, pendingCoreMigration);
 		if (coreMigrationResult.dependencies || coreMigrationResult.scripts || coreMigrationResult.tsconfigTypes || coreMigrationResult.imports || coreMigrationResult.tsdownConfig || coreMigrationResult.taskCacheConfig) didMigrate = true;
+		if (retryPreservedOxlintConfigs(workspaceInfoOptional.rootDir, true, report, workspaceInfoOptional.packages)) didMigrate = true;
 		clearMigrationProgress();
 		const fullSetup = options.full === true;
 		const skippedSetupCandidates = !fullSetup && !hasExplicitExistingVitePlusSetupRequest(options) && hasExistingVitePlusMigrationCandidates(workspaceInfoOptional, options);
@@ -4077,6 +4601,15 @@ async function main() {
 				tsupMigrated = true;
 			}
 		}
+		if (fullSetup && detectTsxProject(workspaceInfoOptional.rootDir, workspaceInfoOptional.packages)) {
+			if (options.interactive) clearMigrationProgress();
+			if (await confirmTsxMigration(options.interactive)) {
+				updateMigrationProgress("Migrating tsx scripts");
+				const tsxResult = migrateTsxToVpx(workspaceInfoOptional.rootDir, workspaceInfoOptional.packages, report);
+				didMigrate ||= tsxResult.changed;
+				needsInstall ||= tsxResult.dependencyRemoved;
+			}
+		}
 		if (fullSetup) {
 			const nodeVersionDetection = detectNodeVersionManagerFile(workspaceInfoOptional.rootDir);
 			if (nodeVersionDetection) {
@@ -4102,7 +4635,10 @@ async function main() {
 		].includes(path.basename(file)));
 		if (eslintMigrated || prettierMigrated || tsupMigrated) {
 			updateMigrationProgress("Rewriting configs");
-			mergeViteConfigFiles(workspaceInfoOptional.rootDir, true, report, workspaceInfoOptional.packages);
+			const rootDir = workspaceInfoOptional.rootDir;
+			const oxlintConfigs = workspaceInfoOptional.isMonorepo ? prepareOxlintConfigs([rootDir, ...workspaceInfoOptional.packages.map((pkg) => path.join(rootDir, pkg.path))]) : void 0;
+			mergeViteConfigFiles(rootDir, true, report, workspaceInfoOptional.packages, rootDir, oxlintConfigs);
+			if (oxlintConfigs) removeMigratedOxlintConfigs(oxlintConfigs);
 			if (tsupMigrated) {
 				mergeTsdownConfigFile(workspaceInfoOptional.rootDir, true, report);
 				for (const pkg of workspaceInfoOptional.packages ?? []) mergeTsdownConfigFile(path.join(workspaceInfoOptional.rootDir, pkg.path), true, report);
@@ -4208,5 +4744,4 @@ main().catch((err) => {
 	console.error(err);
 	process.exit(1);
 });
-//#endregion
 export {};