voidzero-dev · fengmk2 · Jul 3, 2026 · Jul 3, 2026 · Jul 3, 2026 · Jul 3, 2026
diff --git a/.clippy.toml b/.clippy.toml
@@ -12,6 +12,7 @@ disallowed-methods = [
   { path = "str::replace", reason = "To avoid memory allocation, use `cow_utils::CowUtils::cow_replace` instead." },
   { path = "str::replacen", reason = "To avoid memory allocation, use `cow_utils::CowUtils::cow_replacen` instead." },
   { path = "std::env::current_dir", reason = "To get an `AbsolutePathBuf`, Use `vite_path::current_dir` instead." },
+  { path = "std::io::IsTerminal::is_terminal", reason = "Use `vite_powershell::is_stdin_terminal` for stdin, or `vite_shared::is_stdout_terminal` / `vite_shared::is_stderr_terminal`, which memoize the lookup." },
 ]
 
 disallowed-types = [

diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -307,6 +307,7 @@ vite_shared = { path = "crates/vite_shared" }
 vite_static_config = { path = "crates/vite_static_config" }
 vite_path = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "cb580c214bb2314fc1f633a3812782c9b3a1d956" }
 vite_powershell = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "cb580c214bb2314fc1f633a3812782c9b3a1d956" }
+vite_select = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "cb580c214bb2314fc1f633a3812782c9b3a1d956" }
 vite_str = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "cb580c214bb2314fc1f633a3812782c9b3a1d956" }
 vite_task = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "cb580c214bb2314fc1f633a3812782c9b3a1d956" }
 vite_workspace = { git = "https://github.com/voidzero-dev/vite-task.git", rev = "cb580c214bb2314fc1f633a3812782c9b3a1d956" }

diff --git a/.../vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/apps/web/index.html b/.../vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/apps/web/index.html
@@ -0,0 +1,6 @@
+<!doctype html>
+<html>
+  <body>
+    <h1>web</h1>
+  </body>
+</html>
diff --git a/...ite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/apps/web/package.json b/...ite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/apps/web/package.json
@@ -0,0 +1 @@
+{ "name": "web", "private": true }
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/package.json b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/package.json
@@ -0,0 +1 @@
+{ "name": "app-root-auto-select", "private": true, "workspaces": ["apps/*", "packages/*"] }
diff --git a/..._cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/packages/ui/package.json b/..._cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/packages/ui/package.json
@@ -0,0 +1 @@
+{ "name": "ui", "private": true, "type": "module", "main": "src/index.ts" }
diff --git a/..._cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/packages/ui/src/index.ts b/..._cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/packages/ui/src/index.ts
@@ -0,0 +1,3 @@
+export function hello(name: string): string {
+  return `hello ${name}`;
+}
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/snapshots.toml b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_auto_select/snapshots.toml
@@ -0,0 +1,10 @@
+[[case]]
+name = "auto_select"
+vp = ["local", "global"]
+comment = """
+With exactly one likely-runnable package, a bare app command in an interactive
+terminal auto-selects it, prints the Selected/Tip teaching lines, and runs
+there (rfcs/cwd-flag.md). This TTY-only branch was untestable in the legacy
+snap runner.
+"""
+steps = [["vp", "build"]]
diff --git a/...sts/cli_snapshots/fixtures/app_root_auto_select/snapshots/auto_select.global.md b/...sts/cli_snapshots/fixtures/app_root_auto_select/snapshots/auto_select.global.md
@@ -0,0 +1,21 @@
+# auto_select
+
+With exactly one likely-runnable package, a bare app command in an interactive
+terminal auto-selects it, prints the Selected/Tip teaching lines, and runs
+there (rfcs/cwd-flag.md). This TTY-only branch was untestable in the legacy
+snap runner.
+
+## `vp build`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Selected package: web (apps/web)
+Tip: run this directly with `vp -C apps/web build`
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  <size> kB │ gzip: <size> kB
+
+✓ built in <duration>
+```
diff --git a/...ests/cli_snapshots/fixtures/app_root_auto_select/snapshots/auto_select.local.md b/...ests/cli_snapshots/fixtures/app_root_auto_select/snapshots/auto_select.local.md
@@ -0,0 +1,19 @@
+# auto_select
+
+With exactly one likely-runnable package, a bare app command in an interactive
+terminal auto-selects it, prints the Selected/Tip teaching lines, and runs
+there (rfcs/cwd-flag.md). This TTY-only branch was untestable in the legacy
+snap runner.
+
+## `vp build`
+
+```
+Selected package: web (apps/web)
+Tip: run this directly with `vp -C apps/web build`
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  <size> kB │ gzip: <size> kB
+
+✓ built in <duration>
+```
diff --git a/...hots/tests/cli_snapshots/fixtures/app_root_default_package/dc_wrapper/frontend/index.html b/...hots/tests/cli_snapshots/fixtures/app_root_default_package/dc_wrapper/frontend/index.html
@@ -0,0 +1,6 @@
+<!doctype html>
+<html>
+  <body>
+    <h1>frontend</h1>
+  </body>
+</html>
diff --git a/...ts/tests/cli_snapshots/fixtures/app_root_default_package/dc_wrapper/frontend/package.json b/...ts/tests/cli_snapshots/fixtures/app_root_default_package/dc_wrapper/frontend/package.json
@@ -0,0 +1 @@
+{ "name": "frontend", "private": true }
diff --git a/...i_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/dc_wrapper/package.json b/...i_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/dc_wrapper/package.json
@@ -0,0 +1 @@
+{ "name": "dc-wrapper-config", "private": true }
diff --git a/...snapshots/tests/cli_snapshots/fixtures/app_root_default_package/dc_wrapper/vite.config.ts b/...snapshots/tests/cli_snapshots/fixtures/app_root_default_package/dc_wrapper/vite.config.ts
@@ -0,0 +1,5 @@
+import { defineConfig, type UserConfig } from 'vite-plus';
+
+export default defineConfig({
+  defaultPackage: './frontend',
+} satisfies UserConfig);
diff --git a/..._cli_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/missing/package.json b/..._cli_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/missing/package.json
@@ -0,0 +1 @@
+{ "name": "missing-default", "private": true }
diff --git a/...li_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/missing/vite.config.ts b/...li_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/missing/vite.config.ts
@@ -0,0 +1,3 @@
+export default {
+  defaultPackage: './packages/nope',
+};
diff --git a/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/package.json b/crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/package.json
@@ -0,0 +1 @@
+{ "name": "app-root-default-package", "private": true }
diff --git a/..._snapshots/tests/cli_snapshots/fixtures/app_root_default_package/packages/ui/package.json b/..._snapshots/tests/cli_snapshots/fixtures/app_root_default_package/packages/ui/package.json
@@ -0,0 +1 @@
+{ "name": "ui", "private": true, "type": "module", "main": "src/index.ts" }
diff --git a/..._snapshots/tests/cli_snapshots/fixtures/app_root_default_package/packages/ui/src/index.ts b/..._snapshots/tests/cli_snapshots/fixtures/app_root_default_package/packages/ui/src/index.ts
@@ -0,0 +1,3 @@
+export function hello(name: string): string {
+  return `hello ${name}`;
+}
diff --git a/...s/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/snapshots.toml b/...s/vite_cli_snapshots/tests/cli_snapshots/fixtures/app_root_default_package/snapshots.toml
@@ -0,0 +1,61 @@
+[[case]]
+name = "default_package"
+vp = ["local", "global"]
+comment = """
+defaultPackage in the root config acts as an implicit -C for bare app
+commands, including at a root that is not a JS workspace; vp prints a note
+line and runs in the configured directory (rfcs/cwd-flag.md).
+"""
+steps = [
+  ["vp", "pack"],
+  { argv = ["vpt", "list-dir", "packages/ui/dist"], comment = "output lands in the configured package" },
+]
+
+[[case]]
+name = "default_package_missing"
+vp = ["local", "global"]
+comment = "defaultPackage pointing at a missing directory errors before any workspace lookup."
+steps = [{ argv = ["vp", "build"], cwd = "missing" }]
+
+[[case]]
+name = "unanalyzable_config_ignored"
+vp = ["local", "global"]
+comment = """
+Regression guard for spread/unanalyzable configs: a config that only parses
+as an open map might hide defaultPackage behind the spread, but that must
+not fail the command. Bare vp build falls through and runs in place.
+"""
+# PTY-rendered (not tty = false): non-TTY steps record raw bytes, and the
+# raw Windows byte stream of a vite build differs invisibly from macOS; the
+# grid rendering normalizes that and is what the assertion needs anyway.
+steps = [{ argv = ["vp", "build"], cwd = "spread" }]
+
+[[case]]
+name = "default_package_ts_wrapper"
+vp = ["local", "global"]
+comment = """
+Regression: defaultPackage declared through a TypeScript wrapper
+(`satisfies UserConfig`, `as const`) is still a static string literal and
+must be honored. vp builds ./frontend, not the wrapper root.
+"""
+steps = [{ argv = ["vp", "build"], cwd = "ts_wrapper" }]
+
+[[case]]
+name = "default_package_value_wrapper"
+vp = ["local", "global"]
+comment = """
+Regression: the TypeScript wrapper is on the defaultPackage VALUE
+(`'./frontend' as const`), not the config object. Static extraction must
+unwrap it too, so vp builds ./frontend rather than erroring that
+defaultPackage is not a static string literal.
+"""
+steps = [{ argv = ["vp", "build"], cwd = "value_wrapper" }]
+
+[[case]]
+name = "default_package_define_config_wrapper"
+vp = ["local", "global"]
+comment = """
+defaultPackage inside `defineConfig({ ... } satisfies UserConfig)` is also
+honored: the wrapper on the defineConfig argument is unwrapped too.
+"""
+steps = [{ argv = ["vp", "build"], cwd = "dc_wrapper" }]
diff --git a/...snapshots/fixtures/app_root_default_package/snapshots/default_package.global.md b/...snapshots/fixtures/app_root_default_package/snapshots/default_package.global.md
@@ -0,0 +1,26 @@
+# default_package
+
+defaultPackage in the root config acts as an implicit -C for bare app
+commands, including at a root that is not a JS workspace; vp prints a note
+line and runs in the configured directory (rfcs/cwd-flag.md).
+
+## `vp pack`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+note: vp pack: using ./packages/ui (defaultPackage)
+ℹ entry: src/index.ts
+ℹ Build start
+ℹ dist/index.mjs  <size> kB │ gzip: <size> kB
+ℹ 1 files, total: <size> kB
+✔ Build complete in <duration>
+```
+
+## `vpt list-dir packages/ui/dist`
+
+output lands in the configured package
+
+```
+index.mjs
+```
diff --git a/..._snapshots/fixtures/app_root_default_package/snapshots/default_package.local.md b/..._snapshots/fixtures/app_root_default_package/snapshots/default_package.local.md
@@ -0,0 +1,24 @@
+# default_package
+
+defaultPackage in the root config acts as an implicit -C for bare app
+commands, including at a root that is not a JS workspace; vp prints a note
+line and runs in the configured directory (rfcs/cwd-flag.md).
+
+## `vp pack`
+
+```
+note: vp pack: using ./packages/ui (defaultPackage)
+ℹ entry: src/index.ts
+ℹ Build start
+ℹ dist/index.mjs  <size> kB │ gzip: <size> kB
+ℹ 1 files, total: <size> kB
+✔ Build complete in <duration>
+```
+
+## `vpt list-dir packages/ui/dist`
+
+output lands in the configured package
+
+```
+index.mjs
+```
diff --git a/..._root_default_package/snapshots/default_package_define_config_wrapper.global.md b/..._root_default_package/snapshots/default_package_define_config_wrapper.global.md
@@ -0,0 +1,18 @@
+# default_package_define_config_wrapper
+
+defaultPackage inside `defineConfig({ ... } satisfies UserConfig)` is also
+honored: the wrapper on the defineConfig argument is unwrapped too.
+
+## `cd dc_wrapper && vp build`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+note: vp build: using ./frontend (defaultPackage)
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  <size> kB │ gzip: <size> kB
+
+✓ built in <duration>
+```
diff --git a/...p_root_default_package/snapshots/default_package_define_config_wrapper.local.md b/...p_root_default_package/snapshots/default_package_define_config_wrapper.local.md
@@ -0,0 +1,16 @@
+# default_package_define_config_wrapper
+
+defaultPackage inside `defineConfig({ ... } satisfies UserConfig)` is also
+honored: the wrapper on the defineConfig argument is unwrapped too.
+
+## `cd dc_wrapper && vp build`
+
+```
+note: vp build: using ./frontend (defaultPackage)
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  <size> kB │ gzip: <size> kB
+
+✓ built in <duration>
+```
diff --git a/...s/fixtures/app_root_default_package/snapshots/default_package_missing.global.md b/...s/fixtures/app_root_default_package/snapshots/default_package_missing.global.md
@@ -0,0 +1,13 @@
+# default_package_missing
+
+defaultPackage pointing at a missing directory errors before any workspace lookup.
+
+## `cd missing && vp build`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+error: defaultPackage points to a missing directory: ./packages/nope
+```
diff --git a/...ts/fixtures/app_root_default_package/snapshots/default_package_missing.local.md b/...ts/fixtures/app_root_default_package/snapshots/default_package_missing.local.md
@@ -0,0 +1,11 @@
+# default_package_missing
+
+defaultPackage pointing at a missing directory errors before any workspace lookup.
+
+## `cd missing && vp build`
+
+**Exit code:** 1
+
+```
+error: defaultPackage points to a missing directory: ./packages/nope
+```
diff --git a/...ixtures/app_root_default_package/snapshots/default_package_ts_wrapper.global.md b/...ixtures/app_root_default_package/snapshots/default_package_ts_wrapper.global.md
@@ -0,0 +1,19 @@
+# default_package_ts_wrapper
+
+Regression: defaultPackage declared through a TypeScript wrapper
+(`satisfies UserConfig`, `as const`) is still a static string literal and
+must be honored. vp builds ./frontend, not the wrapper root.
+
+## `cd ts_wrapper && vp build`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+note: vp build: using ./frontend (defaultPackage)
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  <size> kB │ gzip: <size> kB
+
+✓ built in <duration>
+```
diff --git a/...fixtures/app_root_default_package/snapshots/default_package_ts_wrapper.local.md b/...fixtures/app_root_default_package/snapshots/default_package_ts_wrapper.local.md
@@ -0,0 +1,17 @@
+# default_package_ts_wrapper
+
+Regression: defaultPackage declared through a TypeScript wrapper
+(`satisfies UserConfig`, `as const`) is still a static string literal and
+must be honored. vp builds ./frontend, not the wrapper root.
+
+## `cd ts_wrapper && vp build`
+
+```
+note: vp build: using ./frontend (defaultPackage)
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  <size> kB │ gzip: <size> kB
+
+✓ built in <duration>
+```
diff --git a/...ures/app_root_default_package/snapshots/default_package_value_wrapper.global.md b/...ures/app_root_default_package/snapshots/default_package_value_wrapper.global.md
@@ -0,0 +1,20 @@
+# default_package_value_wrapper
+
+Regression: the TypeScript wrapper is on the defaultPackage VALUE
+(`'./frontend' as const`), not the config object. Static extraction must
+unwrap it too, so vp builds ./frontend rather than erroring that
+defaultPackage is not a static string literal.
+
+## `cd value_wrapper && vp build`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+note: vp build: using ./frontend (defaultPackage)
+vite <version> building client environment for production...
+✓ 2 modules transformed.
+computing gzip size...
+dist/index.html  <size> kB │ gzip: <size> kB
+
+✓ built in <duration>
+```
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		{ "name": "app-root-auto-select", "private": true, "workspaces": ["apps/", "packages/"] }
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		{ "name": "ui", "private": true, "type": "module", "main": "src/index.ts" }
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		{ "name": "dc-wrapper-config", "private": true }
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		{ "name": "app-root-default-package", "private": true }