vite-plus 0.3.0 → 0.3.2

package/dist/config/bin.js

@@ -1,66 +1,94 @@
-import { t as renderCliDoc } from "../help-BmKpeOP9.js";
-import { i as log, o as printHeader } from "../terminal-MKGAuy-p.js";
-import { i as promptGitHooks, n as defaultInteractive } from "../prompts-DF3yU-eU.js";
-import { t as lib_default } from "../lib-L3DWSRQp.js";
-import { o as updateExistingAgentInstructions } from "../agent-Wqx0MPk0.js";
-import { c as isHooksUserDisabled, l as resolveHooksLocation, o as install, s as isGitHooksEnvDisabled } from "../hooks-DFqViZqZ.js";
-import { join } from "node:path";
-import { existsSync } from "node:fs";
-//#region src/config/bin.ts
-async function main() {
-	const args = lib_default(process.argv.slice(3), {
-		boolean: [
-			"help",
-			"hooks",
-			"agent"
-		],
-		string: ["hooks-dir"],
-		alias: { h: "help" }
-	});
-	if (args.help) {
-		const helpMessage = renderCliDoc({
-			usage: "vp config [OPTIONS]",
-			summary: "Configure Vite+ for the current project (hook dispatcher + agent integration).",
-			documentationUrl: "https://viteplus.dev/guide/commit-hooks",
-			sections: [{
-				title: "Options",
-				rows: [
-					{
-						label: "--hooks-dir <path>",
-						description: "Custom hooks directory (default: .vite-hooks, or last used in this clone)"
-					},
-					{
-						label: "--no-hooks",
-						description: "Skip hook dispatcher installation"
-					},
-					{
-						label: "--no-agent",
-						description: "Skip updating coding agent instructions"
-					},
-					{
-						label: "-h, --help",
-						description: "Show this help message"
-					}
-				]
-			}, {
-				title: "Environment",
-				rows: [{
-					label: "VP_GIT_HOOKS=0",
-					description: "Skip hook dispatcher installation"
-				}]
-			}]
-		});
-		printHeader();
-		log(helpMessage);
+import { i as log, n as errorMsg } from "../terminal-MKGAuy-p.js";
+import { i as promptGitHooks, n as defaultInteractive } from "../prompts-CujFOJXu.js";
+import { o as updateExistingAgentInstructions } from "../agent-C59HKB4Y.js";
+import { t as require_dist } from "../dist-BDYZP12R.js";
+import { a as install, c as resolveHooksLocation, o as isGitHooksEnvDisabled, s as isHooksUserDisabled } from "../hooks-C-4gykWR.js";
+import { t as unwrapCliParseOutcome } from "../cli-parse-DHE8NrBU.js";
+import path, { join, relative } from "node:path";
+import { parseConfigArgs } from "../../binding/index.js";
+import fs, { existsSync } from "node:fs";
+//#region src/utils/legacy-vitest-alias.ts
+var import_dist = require_dist();
+const LEGACY_VITEST_ALIAS = "npm:@voidzero-dev/vite-plus-test";
+function containsLegacyVitestAlias(value, visited = /* @__PURE__ */ new Set()) {
+	if (typeof value === "string") return value === LEGACY_VITEST_ALIAS || value.startsWith(`${LEGACY_VITEST_ALIAS}@`);
+	if (value === null || typeof value !== "object" || visited.has(value)) return false;
+	visited.add(value);
+	return Object.values(value).some((entry) => containsLegacyVitestAlias(entry, visited));
+}
+function asRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function containsAliasInFields(config, fields) {
+	const record = asRecord(config);
+	return fields.some((field) => containsLegacyVitestAlias(record?.[field]));
+}
+function containsPackageAlias(config) {
+	return containsAliasInFields(config, [
+		"dependencies",
+		"devDependencies",
+		"optionalDependencies",
+		"peerDependencies",
+		"overrides",
+		"resolutions",
+		"catalog",
+		"catalogs"
+	]) || containsAliasInFields(config?.pnpm, ["overrides"]) || containsAliasInFields(config?.workspaces, ["catalog", "catalogs"]);
+}
+function readConfigFile(filePath) {
+	try {
+		const source = fs.readFileSync(filePath, "utf8");
+		return asRecord(path.basename(filePath) === "package.json" ? JSON.parse(source) : (0, import_dist.parse)(source));
+	} catch {
 		return;
 	}
-	const dir = args["hooks-dir"];
+}
+/**
+* Find a package-manager setting that still aliases Vitest to the deleted
+* `@voidzero-dev/vite-plus-test` wrapper. Check the nearest package and its
+* workspace root, without inspecting unrelated ancestor package settings.
+*/
+function findLegacyVitestAliasConfig(startDir) {
+	let currentDir = path.resolve(startDir);
+	let foundPackage = false;
+	while (true) {
+		const packagePath = path.join(currentDir, "package.json");
+		const pkg = readConfigFile(packagePath);
+		const isNearestPackage = !foundPackage && fs.existsSync(packagePath);
+		if (isNearestPackage) foundPackage = true;
+		const workspacePath = path.join(currentDir, "pnpm-workspace.yaml");
+		const isWorkspaceRoot = fs.existsSync(workspacePath) || pkg !== void 0 && Object.hasOwn(pkg, "workspaces");
+		if ((isNearestPackage || isWorkspaceRoot) && containsPackageAlias(pkg)) return packagePath;
+		if (isWorkspaceRoot) {
+			if (containsAliasInFields(readConfigFile(workspacePath), [
+				"catalog",
+				"catalogs",
+				"overrides"
+			])) return workspacePath;
+			return;
+		}
+		const parentDir = path.dirname(currentDir);
+		if (parentDir === currentDir) return;
+		currentDir = parentDir;
+	}
+}
+//#endregion
+//#region src/config/bin.ts
+async function main() {
+	const args = unwrapCliParseOutcome(parseConfigArgs(process.argv.slice(3)));
+	const dir = args.hooksDir;
 	const skipHooks = args.hooks === false;
 	const skipAgent = args.agent === false;
 	const interactive = defaultInteractive();
 	const lifecycleEvent = process.env.npm_lifecycle_event;
 	const isLifecycleScript = lifecycleEvent === "prepare" || lifecycleEvent === "postinstall";
 	const root = process.cwd();
+	const staleVitestAliasConfig = findLegacyVitestAliasConfig(root);
+	if (staleVitestAliasConfig) {
+		const relativeConfigPath = relative(root, staleVitestAliasConfig);
+		errorMsg(`Found a stale Vitest alias in ${relativeConfigPath} that points to the removed \`@voidzero-dev/vite-plus-test\` package. Run \`vp migrate\` to update the project before installing dependencies.`);
+		process.exit(1);
+	}
 	if (!skipHooks && isGitHooksEnvDisabled()) log("skip install (git hooks disabled)");
 	else if (!skipHooks) {
 		const location = resolveHooksLocation(dir);

package/dist/{constants-Bn-U8o4v.js → constants-IhOditRA.js}

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 //#region package.json
-var version = "0.3.0";
+var version = "0.3.2";
 //#endregion
 //#region src/utils/constants.ts
 const VITE_PLUS_NAME = "vite-plus";
@@ -14,7 +14,7 @@ const VITE_CONFIG_FILES = [
 	"vite.config.cts"
 ];
 const VITEST_VERSION = "4.1.11";
-const TSDOWN_MIGRATE_VERSION = "0.23.0-rc.0";
+const SETUP_VP_VERSION = "v1.20.0";
 const TSDOWN_MIGRATION_SKILL_URL = "https://github.com/rolldown/tsdown/blob/main/skills/tsdown-migrate/SKILL.md";
 const VITE_PLUS_OVERRIDE_PACKAGES = process.env.VP_OVERRIDE_PACKAGES ? JSON.parse(process.env.VP_OVERRIDE_PACKAGES) : {
 	vite: `npm:@voidzero-dev/vite-plus-core@${VITE_PLUS_VERSION}`,
@@ -77,4 +77,4 @@ const DEFAULT_ENVS = {
 };
 const CONFIG_METADATA_ENV = "VP_RESOLVING_CONFIG_METADATA";
 //#endregion
-export { version as _, TSDOWN_MIGRATE_VERSION as a, VITEST_VERSION as c, VITE_PLUS_OVERRIDE_PACKAGES as d, VITE_PLUS_VERSION as f, resolveBundled as g, resolve as h, DEFAULT_ENVS as i, VITE_CONFIG_FILES as l, isForceOverrideMode as m, BASEURL_TSCONFIG_WARNING as n, TSDOWN_MIGRATION_SKILL_URL as o, createBaseUrlTsconfigFixArgs as p, CONFIG_METADATA_ENV as r, VITEST_AGE_GATE_EXEMPT_PACKAGES as s, BASEURL_TSCONFIG_FIX_PACKAGE as t, VITE_PLUS_NAME as u };
+export { version as _, SETUP_VP_VERSION as a, VITEST_VERSION as c, VITE_PLUS_OVERRIDE_PACKAGES as d, VITE_PLUS_VERSION as f, resolveBundled as g, resolve as h, DEFAULT_ENVS as i, VITE_CONFIG_FILES as l, isForceOverrideMode as m, BASEURL_TSCONFIG_WARNING as n, TSDOWN_MIGRATION_SKILL_URL as o, createBaseUrlTsconfigFixArgs as p, CONFIG_METADATA_ENV as r, VITEST_AGE_GATE_EXEMPT_PACKAGES as s, BASEURL_TSCONFIG_FIX_PACKAGE as t, VITE_PLUS_NAME as u };

package/dist/create/bin.d.ts

@@ -1,20 +1,28 @@
+import "../../binding/index.js";
+//#region src/types/package.d.ts
+declare const PackageManager: {
+  readonly pnpm: "pnpm";
+  readonly npm: "npm";
+  readonly yarn: "yarn";
+  readonly bun: "bun";
+};
+type PackageManager = (typeof PackageManager)[keyof typeof PackageManager];
+//#endregion
 //#region src/create/bin.d.ts
-interface Options {
+export interface Options {
   directory?: string;
   interactive: boolean;
   list: boolean;
-  help: boolean;
   verbose: boolean;
   agent?: string | string[] | false;
   editor?: string | false;
   git?: boolean;
   hooks?: boolean;
-  packageManager?: string;
+  packageManager?: PackageManager;
   /**
    * Approve and run gated dependency build scripts without prompting. Useful in
    * non-interactive runs that need a ready-to-use project.
    */
   approveBuilds?: boolean;
 }
-//#endregion
-export { Options };
+//#endregion

package/dist/create/bin.js

@@ -1,21 +1,22 @@
 import { r as __toESM, t as __commonJSMin } from "../rolldown-runtime-CMFfr-1z.js";
 import { t as renderCliDoc } from "../help-BmKpeOP9.js";
 import { a as muted, i as log, o as printHeader, r as formatDuration, s as success, t as accent } from "../terminal-MKGAuy-p.js";
-import { u as VITE_PLUS_NAME } from "../constants-Bn-U8o4v.js";
-import { a as resolveViteConfig, n as findWorkspaceRoot, r as hasViteConfig, t as findViteConfig } from "../resolve-vite-config-ipGb39Jo.js";
-import { A as isCancel, C as log$1, D as spinner, E as select, O as text, S as intro, a as resolveGitInit, c as selectPackageManager, d as readYamlFile, h as resolveApproveBuildTargets, i as promptGitHooks, k as require_picocolors, m as detectGatedBuilds, n as defaultInteractive, o as runViteFmt, p as approveBuilds, r as downloadPackageManager$1, s as runViteInstall, t as cancelAndExit, u as editYamlFile, v as DependencyType, w as multiselect, y as PackageManager } from "../prompts-DF3yU-eU.js";
-import { t as lib_default } from "../lib-L3DWSRQp.js";
+import { u as VITE_PLUS_NAME } from "../constants-IhOditRA.js";
 import { i as readJsonFile, n as editJsonFile } from "../json-cULBl7Pi.js";
-import { o as fetchNpmResource, r as getScopeFromPackageName, s as getNpmRegistry, t as checkNpmPackageExists } from "../package-CBe9EWPY.js";
-import { a as selectAgentTargets, c as writeCopilotSetupWorkflow, d as templatesDir, l as displayRelative, r as detectExistingAgentTargetPaths, s as writeAgentInstructions, t as COPILOT_AGENT_ID } from "../agent-Wqx0MPk0.js";
-import { A as detectWorkspace$1, B as promptTsupMigration, F as detectFramework, G as promptPrettierMigration, I as hasFrameworkShim, J as detectEslintProject, M as updatePackageJsonWithDeps, N as updateWorkspaceConfig, P as addFrameworkShim, R as detectTsupProject, U as detectPrettierProject, Z as promptEslintMigration, a as selectEditors, b as initGitRepository, c as rewriteMonorepoProject, g as installGitHooks, j as isBingoTemplate, l as rewriteStandaloneProject, m as setPackageManager, n as detectExistingEditors, o as writeEditorConfigs, s as rewriteMonorepo, v as shouldSkipStagedMigrationForHooks, x as injectCreateDefaultTemplate, y as findGitRoot } from "../editor-CC4DqODz.js";
+import { o as fetchNpmResource, r as getScopeFromPackageName, s as getNpmRegistry, t as checkNpmPackageExists } from "../package-BB-Jh_z3.js";
+import { i as hasViteConfig, o as resolveViteConfig, r as findWorkspaceRoot, t as findViteConfig } from "../resolve-vite-config-CHHjsjKJ.js";
+import { C as multiselect, D as text, E as spinner, O as require_picocolors, S as log$1, T as select, a as resolveGitInit, c as selectPackageManager, d as readYamlFile, h as resolveApproveBuildTargets, i as promptGitHooks, k as isCancel, m as detectGatedBuilds, n as defaultInteractive, o as runViteFmt, p as approveBuilds, r as downloadPackageManager$1, s as runViteInstall, t as cancelAndExit, u as editYamlFile, v as DependencyType, x as intro, y as PackageManager } from "../prompts-CujFOJXu.js";
+import { t as require_semver } from "../semver-CaDAb8vV.js";
+import { a as selectAgentTargets, c as writeCopilotSetupWorkflow, d as templatesDir, l as displayRelative, r as detectExistingAgentTargetPaths, s as writeAgentInstructions, t as COPILOT_AGENT_ID } from "../agent-C59HKB4Y.js";
+import { F as addFrameworkShim, I as detectFramework, K as promptPrettierMigration, L as hasFrameworkShim, M as isBingoTemplate, N as updatePackageJsonWithDeps, P as updateWorkspaceConfig, Q as promptEslintMigration, S as injectCreateDefaultTemplate, V as promptTsupMigration, W as detectPrettierProject, Y as detectEslintProject, _ as installGitHooks, a as selectEditors, b as findGitRoot, c as rewriteMonorepoProject, h as setPackageManager, j as detectWorkspace$1, l as rewriteStandaloneProject, n as detectExistingEditors, o as writeEditorConfigs, s as rewriteMonorepo, x as initGitRepository, y as shouldSkipStagedMigrationForHooks, z as detectTsupProject } from "../editor-QOIGtmH4.js";
 import { n as runCommandSilently, t as runCommand$1 } from "../command-CguLh2KL.js";
+import { t as unwrapCliParseOutcome } from "../cli-parse-DHE8NrBU.js";
 import path from "node:path";
-import { getVpDirs, runCommand, upsertJsonConfig, vitePlusHeader } from "../../binding/index.js";
+import { getVpDirs, parseCreateArgs, runCommand, upsertJsonConfig, vitePlusHeader } from "../../binding/index.js";
 import { styleText } from "node:util";
 import fs from "node:fs";
-import { createHash, randomUUID } from "node:crypto";
 import os from "node:os";
+import { createHash, randomUUID } from "node:crypto";
 import fsPromises from "node:fs/promises";
 import assert from "node:assert";
 //#region src/create/command.ts
@@ -96,6 +97,7 @@ function prependToPathToEnvs(extraPath, envs) {
 }
 //#endregion
 //#region ../../node_modules/.pnpm/nanotar@0.3.0/node_modules/nanotar/dist/index.mjs
+var import_semver = /* @__PURE__ */ __toESM(require_semver(), 1);
 const tarItemTypeMap = {
 	"0": "file",
 	"1": "hardLink",
@@ -263,10 +265,16 @@ function sanitizeHostForPath(host) {
 * (via `.npmrc` scope mappings) don't share a cache slot. The registry
 * guarantees `manifest.tarballUrl` is a valid URL, so any parse failure
 * here is a real bug worth surfacing.
+*
+* Require a strict descendant of `cacheRoot` so sibling staging directories
+* stay inside the cache, even if a caller skips `readOrgManifest` validation.
 */
-function getExtractionDir(manifest) {
+function resolveExtractionDir(cacheRoot, manifest) {
 	const { host } = new URL(manifest.tarballUrl);
-	return path.join(getCacheRoot(), sanitizeHostForPath(host), manifest.scope, "create", manifest.version);
+	const resolvedRoot = path.resolve(cacheRoot);
+	const resolvedDir = path.resolve(resolvedRoot, sanitizeHostForPath(host), manifest.scope, "create", manifest.version);
+	if (!resolvedDir.startsWith(`${resolvedRoot}${path.sep}`)) throw new Error(`org template extraction path escapes the cache root: ${manifest.version}`);
+	return resolvedDir;
 }
 function parseIntegrity(integrity) {
 	const match = integrity.split(/\s+/)[0].match(/^(sha\d+)-(.+)$/);
@@ -446,7 +454,7 @@ async function cleanupStaleStagingDirs(destDir) {
 * cleans up and returns the existing directory.
 */
 async function ensureOrgPackageExtracted(manifest) {
-	const extractedRoot = getExtractionDir(manifest);
+	const extractedRoot = resolveExtractionDir(getCacheRoot(), manifest);
 	if (fs.existsSync(path.join(extractedRoot, "package.json"))) return extractedRoot;
 	const parent = path.dirname(extractedRoot);
 	await fs.promises.mkdir(parent, { recursive: true });
@@ -668,6 +676,7 @@ async function readOrgManifest(scope, requestedVersion) {
 		resolvedVersion = packument["dist-tags"]?.latest;
 		if (!resolvedVersion) return null;
 	}
+	if (import_semver.default.valid(resolvedVersion) === null) throw new OrgManifestSchemaError(`invalid version "${resolvedVersion}" (expected a semantic version)`, packageName);
 	const meta = packument.versions?.[resolvedVersion];
 	if (!meta) return null;
 	let templates = validateManifest(meta, packageName);
@@ -783,6 +792,7 @@ function discoverTemplate(templateName, templateArgs, workspaceInfo, interactive
 		if (isBingoTemplate(pkg)) {
 			type = TemplateType.bingo;
 			args.push("--skip-requests");
+			envs.VP_CREATE_INTERACTIVE = interactive === false ? "0" : "1";
 		}
 		return {
 			command: "node",
@@ -3976,11 +3986,6 @@ function getRandomProjectName(options = {}) {
 function hasExplicitEditorOptIn(editor) {
 	return typeof editor === "string" && editor.trim() !== "";
 }
-function normalizeEditorOption(editor) {
-	if (!Array.isArray(editor)) return editor;
-	if (editor.includes(false)) return false;
-	return editor.findLast((value) => typeof value === "string");
-}
 function shouldConfigureEditorsForCreate({ editor, isMonorepo }) {
 	if (editor === false) return false;
 	if (!isMonorepo) return true;
@@ -4664,129 +4669,6 @@ function dropAliasedRuntimeDevDeps(appProjectPath, packageManager) {
 }
 //#endregion
 //#region src/create/bin.ts
-const helpMessage = renderCliDoc({
-	usage: "vp create [TEMPLATE] [OPTIONS] [-- TEMPLATE_OPTIONS]",
-	summary: "Use any builtin, local or remote template with Vite+.",
-	documentationUrl: "https://viteplus.dev/guide/create",
-	sections: [
-		{
-			title: "Arguments",
-			rows: [{
-				label: "TEMPLATE",
-				description: [
-					`Template name. Run \`${accent("vp create --list")}\` to see available templates.`,
-					`- Default: ${accent("vite:monorepo")}, ${accent("vite:application")}, ${accent("vite:library")}, ${accent("vite:generator")}`,
-					"- Remote: vite, @tanstack/start, create-next-app,",
-					"  create-nuxt, github:user/repo, https://github.com/user/template-repo, etc.",
-					"- Local: a `create.templates` entry name from vite.config.ts (monorepo)",
-					`- Org scope: ${accent("@your-org")} → picker from ${accent("@your-org/create")}'s ${accent("createConfig.templates")} manifest`,
-					`- Org entry: ${accent("@your-org:web")} → manifest entry "web" from ${accent("@your-org/create")}`,
-					`When omitted, uses \`create.defaultTemplate\` from vite.config.ts if set.`
-				]
-			}]
-		},
-		{
-			title: "Options",
-			rows: [
-				{
-					label: "--directory DIR",
-					description: "Target directory for the generated project."
-				},
-				{
-					label: "--agent NAME",
-					description: "Write coding agent instructions to AGENTS.md, CLAUDE.md, etc."
-				},
-				{
-					label: "--no-agent",
-					description: "Skip writing coding agent instructions"
-				},
-				{
-					label: "--editor NAME",
-					description: "Write editor config files for the specified editor."
-				},
-				{
-					label: "--no-editor",
-					description: "Skip writing editor config files"
-				},
-				{
-					label: "--git",
-					description: "Initialize a git repository"
-				},
-				{
-					label: "--no-git",
-					description: "Skip git repository initialization"
-				},
-				{
-					label: "--hooks",
-					description: "Set up pre-commit hooks (default in non-interactive mode)"
-				},
-				{
-					label: "--no-hooks",
-					description: "Skip pre-commit hooks setup"
-				},
-				{
-					label: "--package-manager NAME",
-					description: "Use specified package manager (pnpm, npm, yarn, bun)"
-				},
-				{
-					label: "--approve-builds",
-					description: "Approve and run gated dependency build scripts without prompting"
-				},
-				{
-					label: "--verbose",
-					description: "Show detailed scaffolding output"
-				},
-				{
-					label: "--no-interactive",
-					description: "Run in non-interactive mode"
-				},
-				{
-					label: "--list",
-					description: "List all available templates"
-				},
-				{
-					label: "-h, --help",
-					description: "Show this help message"
-				}
-			]
-		},
-		{
-			title: "Template Options",
-			lines: ["  Any arguments after -- are passed directly to the template."]
-		},
-		{
-			title: "Examples",
-			lines: [
-				`  ${muted("# Interactive mode")}`,
-				`  ${accent("vp create")}`,
-				"",
-				`  ${muted("# Use existing templates (shorthand expands to create-* packages)")}`,
-				`  ${accent("vp create vite")}`,
-				`  ${accent("vp create @tanstack/start")}`,
-				`  ${accent("vp create svelte")}`,
-				`  ${accent("vp create vite -- --template react-ts")}`,
-				"",
-				`  ${muted("# Full package names also work")}`,
-				`  ${accent("vp create create-vite")}`,
-				`  ${accent("vp create create-next-app")}`,
-				"",
-				`  ${muted("# Create Vite+ monorepo, application, library, or generator scaffolds")}`,
-				`  ${accent("vp create vite:monorepo")}`,
-				`  ${accent("vp create vite:application")}`,
-				`  ${accent("vp create vite:library")}`,
-				`  ${accent("vp create vite:generator")}`,
-				"",
-				`  ${muted("# Use templates from GitHub (via degit)")}`,
-				`  ${accent("vp create github:user/repo")}`,
-				`  ${accent("vp create https://github.com/user/template-repo")}`,
-				"",
-				`  ${muted("# Pick from an org that publishes @scope/create with createConfig.templates")}`,
-				`  ${accent("vp create @your-org")} ${muted("# interactive picker")}`,
-				`  ${accent("vp create @your-org:web")} ${muted("# direct manifest-entry selection")}`
-			]
-		}
-	]
-});
 const listTemplatesMessage = renderCliDoc({
 	usage: "vp create --list",
 	summary: "List available builtin and popular project templates.",
@@ -4861,52 +4743,23 @@ const listTemplatesMessage = renderCliDoc({
 		}
 	]
 });
-function normalizeAgentOption(agent) {
-	if (!Array.isArray(agent)) return agent;
-	if (agent.includes(false)) return false;
-	return agent.filter((value) => typeof value === "string");
-}
 function parseArgs() {
-	const args = process.argv.slice(3);
-	const separatorIndex = args.indexOf("--");
-	const viteArgs = separatorIndex >= 0 ? args.slice(0, separatorIndex) : args;
-	const templateArgs = separatorIndex >= 0 ? args.slice(separatorIndex + 1) : [];
-	const parsed = lib_default(viteArgs, {
-		alias: { h: "help" },
-		boolean: [
-			"help",
-			"list",
-			"all",
-			"interactive",
-			"hooks",
-			"verbose",
-			"git",
-			"approve-builds"
-		],
-		string: [
-			"directory",
-			"agent",
-			"editor",
-			"package-manager"
-		],
-		default: { interactive: defaultInteractive() }
-	});
+	const parsed = unwrapCliParseOutcome(parseCreateArgs(process.argv.slice(3)));
 	return {
-		templateName: parsed._[0],
+		templateName: parsed.templateName,
 		options: {
 			directory: parsed.directory,
-			interactive: parsed.interactive,
-			list: parsed.list || false,
-			help: parsed.help || false,
-			verbose: parsed.verbose || false,
-			agent: normalizeAgentOption(parsed.agent),
-			editor: normalizeEditorOption(parsed.editor),
+			interactive: parsed.interactive ?? defaultInteractive(),
+			list: parsed.list ?? false,
+			verbose: parsed.verbose ?? false,
+			agent: parsed.agent,
+			editor: parsed.editor,
 			git: parsed.git,
 			hooks: parsed.hooks,
-			packageManager: parsed["package-manager"],
-			approveBuilds: parsed["approve-builds"] || false
+			packageManager: parsed.packageManager,
+			approveBuilds: parsed.approveBuilds ?? false
 		},
-		templateArgs
+		templateArgs: parsed.templateArgs
 	};
 }
 function describeScaffold(templateName, templateArgs) {
@@ -4944,27 +4797,31 @@ function formatTemplateName(templateName) {
 }
 function getNextCommand(projectDir, command) {
 	if (!projectDir || projectDir === ".") return command;
-	return `cd ${projectDir} && ${command}`;
+	return `cd ${formatProjectDirArgument(projectDir)} && ${command}`;
+}
+function formatProjectDirArgument(projectDir) {
+	const argument = projectDir.startsWith("-") ? `./${projectDir}` : projectDir;
+	return /^[A-Za-z0-9_@./\\-]+$/.test(argument) ? argument : JSON.stringify(argument);
 }
 function getCopilotSetupRoot(projectRoot, isExistingMonorepo) {
 	if (!isExistingMonorepo) return projectRoot;
 	return findGitRoot(projectRoot) ?? projectRoot;
 }
 function showCreateSummary(options) {
-	const { description, installSummary, nextCommand, packageManager, packageManagerVersion, projectDir } = options;
+	const { description, gitInitialized, installSummary, nextCommand, packageManager, packageManagerVersion, projectDir } = options;
 	log(`${styleText("magenta", "◇")} Scaffolded ${accent(projectDir)}${description ? ` with ${description}` : ""}`);
 	log(`${styleText("gray", "•")} Node ${process.versions.node}  ${packageManager} ${packageManagerVersion}`);
 	if (installSummary?.status === "installed") log(`${styleText("green", "✓")} Dependencies installed in ${formatDuration(installSummary.durationMs)}`);
+	if (gitInitialized) {
+		const git = !projectDir || projectDir === "." ? "git" : `git -C ${formatProjectDirArgument(projectDir)}`;
+		const gitCommand = `${git} add -A && ${git} commit -m "chore: initial commit"`;
+		log(`${styleText("blue", "→")} Git (optional): ${accent(gitCommand)}`);
+	}
 	log(`${styleText("blue", "→")} Next: ${accent(nextCommand)}`);
 }
 async function main() {
 	const { templateName, options, templateArgs } = parseArgs();
 	let compactOutput = !options.verbose;
-	if (options.help) {
-		printHeader();
-		log(helpMessage);
-		return;
-	}
 	if (options.list) {
 		await showAvailableTemplates();
 		return;
@@ -4996,6 +4853,7 @@ async function main() {
 	let selectedEditors;
 	let selectedParentDir;
 	let remoteTargetDir;
+	let gitInitialized = false;
 	let shouldSetupHooks = false;
 	let bundled;
 	let skipShorthandExpansion = false;
@@ -5159,11 +5017,6 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
 			targetDir = selectedParentDir ? path.join(selectedParentDir, selected.targetDir).split(path.sep).join("/") : selected.targetDir;
 		}
 	}
-	if (options.packageManager && !Object.values(PackageManager).includes(options.packageManager)) {
-		const valid = Object.values(PackageManager).join(", ");
-		log$1.error(`Invalid package manager: ${options.packageManager}. Must be one of: ${valid}`);
-		cancelAndExit("Invalid --package-manager value", 1);
-	}
 	const requestedPackageManager = options.packageManager;
 	const detectedPackageManager = workspaceInfoOptional.packageManager;
 	const packageManager = (isMonorepo ? detectedPackageManager ?? requestedPackageManager : requestedPackageManager ?? detectedPackageManager) ?? await selectPackageManager(options.interactive, compactOutput);
@@ -5290,7 +5143,8 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
 		workspaceInfo.packages = scaffoldedWorkspace.packages;
 		if (shouldSetupGit) {
 			updateCreateProgress("Initializing git repository");
-			if (await initGitRepository(fullPath)) ensureDefaultGitignoreEntries(fullPath);
+			gitInitialized = await initGitRepository(fullPath);
+			if (gitInitialized) ensureDefaultGitignoreEntries(fullPath);
 		}
 		updateCreateProgress("Writing agent instructions");
 		pauseCreateProgress();
@@ -5336,6 +5190,7 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
 		clearCreateProgress();
 		showCreateSummary({
 			description: describeScaffold(selectedTemplateName, selectedTemplateArgs),
+			gitInitialized,
 			installSummary,
 			nextCommand: getNextCommand(projectDir, "vp run"),
 			packageManager: workspaceInfo.packageManager,
@@ -5510,7 +5365,8 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
 	} else {
 		if (shouldSetupGit) {
 			updateCreateProgress("Initializing git repository");
-			if (await initGitRepository(fullPath)) ensureDefaultGitignoreEntries(fullPath);
+			gitInitialized = await initGitRepository(fullPath);
+			if (gitInitialized) ensureDefaultGitignoreEntries(fullPath);
 		}
 		if (shouldMigrateLintFmtTools) await installAndMigrate(fullPath);
 		updateCreateProgress("Applying Vite+ project setup");
@@ -5532,6 +5388,7 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
 	clearCreateProgress();
 	showCreateSummary({
 		description: describeScaffold(selectedTemplateName, selectedTemplateArgs),
+		gitInitialized,
 		installSummary,
 		nextCommand: getNextCommand(projectDir, "vp run"),
 		packageManager: workspaceInfo.packageManager,

package/dist/{define-config-GXUdVT-0.js → define-config-DAaCa0U_.js}

@@ -1,10 +1,10 @@
-import { c as VITEST_VERSION, r as CONFIG_METADATA_ENV } from "./constants-Bn-U8o4v.js";
+import { c as VITEST_VERSION, r as CONFIG_METADATA_ENV } from "./constants-IhOditRA.js";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { readFileSync } from "node:fs";
 import { defineConfig, defineProject } from "vitest/config";
-//#region ../../node_modules/.pnpm/tsdown@0.22.14_@arethetypeswrong+core@0.18.2_@tsdown+css@0.22.14_@tsdown+exe@0.22.14_@t_4084c24f9f44f250d2b604ebc16f10f3/node_modules/tsdown/esm-shims.js
+//#region ../../node_modules/.pnpm/tsdown@0.23.0_@arethetypeswrong+core@0.18.2_@tsdown+css@0.23.0_@tsdown+exe@0.23.0_@type_298964156353ef75a02894ab80b3a2e6/node_modules/tsdown/esm-shims.js
 const getFilename = () => fileURLToPath(import.meta.url);
 const getDirname = () => path.dirname(getFilename());
 const __dirname = /* @__PURE__ */ getDirname();

package/dist/{define-config-DWoAkNdp.d.ts → define-config-DPNEJxPz.d.ts}

@@ -1,6 +1,6 @@
-import { t as PackUserConfig } from "./pack-PvUg_xpv.js";
+import { t as PackUserConfig } from "./pack-BK38MLVZ.js";
 import { ConfigEnv, UserProjectConfigExport, UserProjectConfigFn, UserWorkspaceConfig } from "vitest/config";
-import { PluginOption, UserConfig } from "@voidzero-dev/vite-plus-core";
+import { PluginOption, UserConfig } from "vite";
 import { OxfmtConfig } from "oxfmt";
 import { OxlintConfig } from "oxlint";
 import { InlineConfig } from "vitest/node";
@@ -169,7 +169,7 @@ type Configuration = Record<string, string | TaskFunction | GenerateTask | (stri
 type StagedConfig = Configuration;
 //#endregion
 //#region src/define-config.d.ts
-declare module '@voidzero-dev/vite-plus-core' {
+declare module 'vite' {
   interface UserConfig {
     /**
      * Options for oxlint
@@ -236,12 +236,8 @@ declare module '@voidzero-dev/vite-plus-core' {
       templates?: CreateTemplateEntry[];
     };
     /**
-     * Vitest test configuration.
-     *
-     * Vitest augments vite's `UserConfig` with a `test` field via
-     * `declare module 'vite'`, but vite-plus-core is a fork of vite so that
-     * augmentation does not apply here. Re-declare it locally so user
-     * configs like `defineConfig({ test: { globals: true } })` typecheck.
+     * Vitest may augment a separate Vite copy, for example an npm peer dependency.
+     * Keep the public test field on the CLI's core types in that layout too.
      */
     test?: InlineConfig;
   }

package/dist/{define-config-WiVlryJ2.cjs → define-config-DpAPETDf.cjs}

@@ -37,7 +37,7 @@ let node_module = require("node:module");
 let node_url = require("node:url");
 let vitest_config = require("vitest/config");
 //#region package.json
-var version = "0.3.0", VITE_PLUS_VERSION, VITEST_VERSION, CONFIG_METADATA_ENV;
+var version = "0.3.2", VITE_PLUS_VERSION, VITEST_VERSION, CONFIG_METADATA_ENV;
 var init_constants = __esmMin((() => {
 	VITE_PLUS_VERSION = process.env.VP_VERSION || version;
 	VITEST_VERSION = "4.1.11";

package/dist/define-config.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_define_config = require("./define-config-WiVlryJ2.cjs");
+const require_define_config = require("./define-config-DpAPETDf.cjs");
 require_define_config.init_define_config();
 exports.AUTO_INLINE_DEPS = require_define_config.AUTO_INLINE_DEPS;
 exports.assertCoverageProviderVersionMatch = require_define_config.assertCoverageProviderVersionMatch;