diff --git a/.github/scripts/__tests__/upgrade-deps-utils.spec.ts b/.github/scripts/__tests__/upgrade-deps-utils.spec.ts
index b8b6b1f4a8..671ff1d069 100644
--- a/.github/scripts/__tests__/upgrade-deps-utils.spec.ts
+++ b/.github/scripts/__tests__/upgrade-deps-utils.spec.ts
@@ -16,3 +16,9 @@ test('selects the highest stable version from the supported major', () => {
 test('returns undefined when the supported major has no stable release', () => {
   expect(findLatestStableVersionForMajor(['4.2.0-beta.1', '5.0.0'], 4)).toBeUndefined();
 });
+
+test('keeps Vitest upgrades on v5 after the migration', () => {
+  expect(
+    findLatestStableVersionForMajor(['4.1.11', '5.0.0', '5.1.0', '5.2.0-beta.1', '6.0.0'], 5),
+  ).toBe('5.1.0');
+});
diff --git a/.github/scripts/upgrade-deps.ts b/.github/scripts/upgrade-deps.ts
index acc5a6e633..b895b6f2d0 100644
--- a/.github/scripts/upgrade-deps.ts
+++ b/.github/scripts/upgrade-deps.ts
@@ -72,7 +72,7 @@ type PnpmWorkspaceEntry = {
 const STABLE_SEMVER_TAG_RE = /^v?\d+\.\d+\.\d+$/;
 // Vitest major upgrades can change the bundled API, export shims, and CLI
 // behavior. Advance this only after Vite+ has adapted to the new major.
-const SUPPORTED_VITEST_MAJOR = 4;
+const SUPPORTED_VITEST_MAJOR = 5;
 
 const isFullSha = (s: string): boolean => /^[0-9a-f]{40}$/.test(s);
 
@@ -211,18 +211,15 @@ async function updatePnpmWorkspace(versions: PnpmWorkspaceVersions): Promise<voi
   let content = fs.readFileSync(filePath, 'utf8');
 
   // oxlint's trailing \n in the pattern disambiguates from oxlint-tsgolint.
-  // All @vitest/* catalog entries (browser + core direct deps) must stay pinned
+  // Official @vitest/* catalog entries (browser + core direct deps) stay pinned
   // to the same exact version as `vitest` itself, otherwise the catalog drifts
   // from VITEST_VERSION.
   const vitestExactVersionPackages = [
     '@vitest/browser',
     '@vitest/browser-playwright',
     '@vitest/browser-preview',
-    '@vitest/browser-webdriverio',
-    '@vitest/expect',
     '@vitest/mocker',
     '@vitest/pretty-format',
-    '@vitest/runner',
     '@vitest/snapshot',
     '@vitest/spy',
     '@vitest/utils',
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 58a8ff6bbc..cb35a49236 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -389,10 +389,13 @@ jobs:
         include:
           - os: namespace-profile-linux-x64-default
             target: x86_64-unknown-linux-gnu
+            test-node: 22.18.0
           - os: namespace-profile-mac-default
             target: aarch64-apple-darwin
+            test-node: 24.11.0
           - os: namespace-profile-windows-4c-8g
             target: x86_64-pc-windows-msvc
+            test-node: 26.0.0
     runs-on: ${{ matrix.os }}
     steps:
       - uses: taiki-e/checkout-action@7d1e50e93dc4fb3bba58f85018fadf77898aee8b # v1.4.2
@@ -467,10 +470,20 @@ jobs:
         run: vp check
 
       - name: Run unit tests
-        run: RUST_BACKTRACE=1 pnpm test:unit
+        run: vp env exec --node ${{ matrix.test-node }} node packages/cli/dist/bin.js test run
         env:
+          RUST_BACKTRACE: '1'
           RUST_MIN_STACK: 8388608
 
+      - name: Test vendored workspaces with Vitest v5
+        if: runner.os == 'Linux'
+        run: |
+          pnpm --filter @rolldown/test-dev-server build
+          pnpm exec playwright install --with-deps chromium
+          pnpm test:vendored
+        env:
+          PLAYWRIGHT_BROWSERS_PATH: '0'
+
       - name: Test global package install (powershell)
         if: ${{ matrix.os != 'namespace-profile-linux-x64-default' }}
         shell: pwsh
diff --git a/.github/workflows/upgrade-deps.yml b/.github/workflows/upgrade-deps.yml
index 69e1399fe3..fbda2b0e9f 100644
--- a/.github/workflows/upgrade-deps.yml
+++ b/.github/workflows/upgrade-deps.yml
@@ -97,8 +97,9 @@ jobs:
 
             ### Background
             - Upgrade script: `./.github/scripts/upgrade-deps.ts`
-            - Vitest is intentionally capped at the latest stable `4.x` release until
-              Vite+ adapts to a newer major. Do not remove or bypass that cap.
+            - Vitest is capped at the latest stable `5.x` release. Keep the exact
+              version selected by the upgrade script when merging upstream catalogs.
+              Official Vitest packages must use that version. Do not bypass the cap.
             - Sync-remote tool: `pnpm tool sync-remote` (source in
               `packages/tools/src/sync-remote-deps.ts`) — clones rolldown/vite into the
               working tree, merges their pnpm-workspace catalogs into the root
@@ -119,7 +120,7 @@ jobs:
                cross-major semver conflict in the merged catalog, e.g.
                `Incompatible semver ranges for <pkg>: ^X vs ^Y`. The merger refuses to
                auto-resolve cross-major conflicts for packages outside its synced list
-               (oxc-*, vitest deps). For passthrough deps that vp does NOT import
+               (oxc-* and tinybench). For passthrough deps that vp does NOT import
                directly (e.g. `diff`, `acorn`, `astring`, anything only present in
                `rolldown/scripts/package.json` or vite's internals), bump vp's
                `pnpm-workspace.yaml` catalog entry to match the rolldown/vite version,
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_tool_help/snapshots/command_tool_deep_help_delegation.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_tool_help/snapshots/command_tool_deep_help_delegation.md
index 327af269cb..6f3bf09aaa 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_tool_help/snapshots/command_tool_deep_help_delegation.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/command_tool_help/snapshots/command_tool_deep_help_delegation.md
@@ -5,7 +5,7 @@ Help requests with additional arguments delegate to the underlying tool.
 ## `vp test --help --coverage`
 
 ```
-vitest/4.1.11
+vitest/5.0.0
 
 Usage:
   $ vitest [...filters]
@@ -17,6 +17,7 @@ Commands:
   dev [...filters]
   bench [...filters]
   init <project>
+  doctor [...filters]
   list [...filters]
   [...filters]
   complete [shell]
@@ -28,6 +29,7 @@ For more info, run any command with the `--help` flag:
   $ vitest dev --help
   $ vitest bench --help
   $ vitest init --help
+  $ vitest doctor --help
   $ vitest list --help
   $ vitest --help
   $ vitest complete --help
@@ -47,7 +49,7 @@ Options:
   --coverage.allowExternal                                   Collect coverage of files outside the project root (default: false)
   --coverage.skipFull                                        Do not show files with 100% statement, branch, and function coverage (default: false)
   --coverage.thresholds.100                                  Shortcut to set all coverage thresholds to 100 (default: false)
-  --coverage.thresholds.perFile                              Check thresholds per file. See --coverage.thresholds.lines, --coverage.thresholds.functions, --coverage.thresholds.branches and --coverage.thresholds.statements for the actual thresholds (default: false)
+  --coverage.thresholds.perFile <boolean>                    Check thresholds per file. See --coverage.thresholds.lines, --coverage.thresholds.functions, --coverage.thresholds.branches and --coverage.thresholds.statements for the actual thresholds (default: false). Object form is available in config files only.
   --coverage.thresholds.autoUpdate <boolean|function>        Update threshold values: "lines", "functions", "branches" and "statements" to configuration file when current coverage is above the configured thresholds (default: false)
   --coverage.thresholds.lines <number>                       Threshold for lines. Visit https://github.com/istanbuljs/nyc#coverage-thresholds for more information. This option is not available for custom providers
   --coverage.thresholds.functions <number>                   Threshold for functions. Visit https://github.com/istanbuljs/nyc#coverage-thresholds for more information. This option is not available for custom providers
@@ -63,4 +65,5 @@ Options:
   --coverage.changed <commit/branch>                         Collect coverage only for files changed since a specified commit or branch (e.g., origin/main or HEAD~1). Inherits value from --changed by default.
   --coverage.excludeAfterRemap                               Apply exclusions again after coverage has been remapped to original sources. (default: false)
   --coverage.htmlDir <path>                                  Directory of HTML coverage output to be served in UI mode and HTML reporter.
+  --coverage.autoAttachSubprocess                            Track coverage of the node:child_process and node:worker_threads spawned during test run. Supported only by v8 provider. (default: false)
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_approve_builds_migrate_pnpm11/snapshots/create_approve_builds_migrate_pnpm11.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_approve_builds_migrate_pnpm11/snapshots/create_approve_builds_migrate_pnpm11.md
index 51d6f4d597..79610e972d 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_approve_builds_migrate_pnpm11/snapshots/create_approve_builds_migrate_pnpm11.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_approve_builds_migrate_pnpm11/snapshots/create_approve_builds_migrate_pnpm11.md
@@ -73,6 +73,8 @@ peerDependencyRules:
 the guidance's `vp pm approve-builds` command approves the gated build
 
 ```
+✓ Lockfile passes supply-chain policies (verified <duration> ago)
+Already up to date
 node_modules/.pnpm/core-js@3.39.0/node_modules/core-js: Running postinstall script, done in <duration>
 ```
 
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_approve_builds_pnpm11/snapshots/create_approve_builds_pnpm11.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_approve_builds_pnpm11/snapshots/create_approve_builds_pnpm11.md
index 02d8568dde..3f4588cd04 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_approve_builds_pnpm11/snapshots/create_approve_builds_pnpm11.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/create_approve_builds_pnpm11/snapshots/create_approve_builds_pnpm11.md
@@ -69,6 +69,8 @@ peerDependencyRules:
 the guidance's `vp pm approve-builds` command approves the gated build
 
 ```
+✓ Lockfile passes supply-chain policies (verified <duration> ago)
+Already up to date
 node_modules/.pnpm/core-js@3.39.0/node_modules/core-js: Running postinstall script, done in <duration>
 ```
 
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/package.json
index abe4023cd1..9e1c18d988 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/package.json
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/package.json
@@ -1,6 +1,6 @@
 {
   "name": "migration-agent-claude",
   "dependencies": {
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.0"
   }
 }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/snapshots/migration_agent_claude.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/snapshots/migration_agent_claude.md
index d49e12e6ef..7c5658547c 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/snapshots/migration_agent_claude.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_agent_claude/snapshots/migration_agent_claude.md
@@ -7,6 +7,10 @@ migration with --agent claude should write CLAUDE.md
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_inline_array/snapshots/migration_bunfig_inline_array.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_inline_array/snapshots/migration_bunfig_inline_array.md
index 2bf7d20796..acb7be696e 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_inline_array/snapshots/migration_bunfig_inline_array.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_inline_array/snapshots/migration_bunfig_inline_array.md
@@ -7,6 +7,10 @@ migration preserves inline arrays in an existing bunfig.toml
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  bun <version>
 • 2 config updates applied
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_missing/snapshots/migration_bunfig_missing.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_missing/snapshots/migration_bunfig_missing.md
index 0494111c9a..4175f7d200 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_missing/snapshots/migration_bunfig_missing.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_missing/snapshots/migration_bunfig_missing.md
@@ -7,6 +7,10 @@ migration does not create bunfig.toml
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  bun <version>
 • 2 config updates applied
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_no_install_section/snapshots/migration_bunfig_no_install_section.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_no_install_section/snapshots/migration_bunfig_no_install_section.md
index 0948892875..c307849e14 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_no_install_section/snapshots/migration_bunfig_no_install_section.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_bunfig_no_install_section/snapshots/migration_bunfig_no_install_section.md
@@ -7,6 +7,10 @@ migration preserves bunfig.toml without an install section
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  bun <version>
 • 2 config updates applied
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_config/snapshots/migration_from_vitest_config.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_config/snapshots/migration_from_vitest_config.md
index ca978ebabc..3c06ad5c93 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_config/snapshots/migration_from_vitest_config.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_config/snapshots/migration_from_vitest_config.md
@@ -30,8 +30,10 @@ import { defineConfig } from 'vite-plus';
 export default defineConfig({
   plugins: [foo()],
   test: {
+    clearMocks: false,
     dir: join(import.meta.dirname, 'test'),
     browser: {
+      locators: { exact: false },
       enabled: true,
       provider: playwright(),
       headless: true,
@@ -86,7 +88,7 @@ catalog:
   vite: npm:@voidzero-dev/vite-plus-core@<version>
   vitest: <version>
   vite-plus: <version>
-  '@vitest/browser-webdriverio': <version>
+  '@vitest/browser-webdriverio': ^5.0.0-beta.5 || >=5.0.0
   '@vitest/browser-playwright': <version>
   '@vitest/coverage-v8': <version>
 allowBuilds:
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_files/snapshots/migration_from_vitest_files.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_files/snapshots/migration_from_vitest_files.md
index 839948754a..b293b96c0d 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_files/snapshots/migration_from_vitest_files.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_from_vitest_files/snapshots/migration_from_vitest_files.md
@@ -7,6 +7,10 @@ migration should rewrite imports to vite-plus
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default and uses exact browser locators. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_merge_vite_config_ts/snapshots/migration_merge_vite_config_ts.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_merge_vite_config_ts/snapshots/migration_merge_vite_config_ts.md
index 93c54c83f6..706b01f853 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_merge_vite_config_ts/snapshots/migration_merge_vite_config_ts.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_merge_vite_config_ts/snapshots/migration_merge_vite_config_ts.md
@@ -53,8 +53,10 @@ export default defineConfig({
   },
   plugins: lazyPlugins(() => [react()]),
   test: {
+    clearMocks: false,
     dir: join(import.meta.dirname, 'test'),
     browser: {
+      locators: { exact: false },
       enabled: true,
       provider: playwright(),
       headless: true,
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_bun/snapshots/migration_monorepo_bun.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_bun/snapshots/migration_monorepo_bun.md
index 7a02ce2eb8..86a27c35d1 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_bun/snapshots/migration_monorepo_bun.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_bun/snapshots/migration_monorepo_bun.md
@@ -7,11 +7,27 @@ migration should work with bun object-form workspaces
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 2 review items
+
+packages/app/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/utils/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
 ✔ Merged .oxlintrc.json into vite.config.ts
 ◇ Migrated . to Vite+ <version>
 • Node <version>  bun <version>
 • 2 config updates applied, 1 file had imports rewritten
 • Inline Vite plugins wrapped with lazyPlugins for check/lint/fmt
+! Warnings:
+  - Vitest v5: 2 review items
+
+packages/app/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/utils/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file vite.config.ts`
@@ -43,6 +59,7 @@ export default defineConfig({
       }
     ]
   },
+  test: { clearMocks: false },
   plugins: lazyPlugins(() => [react()]),
 });
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_pnpm/snapshots/migration_monorepo_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_pnpm/snapshots/migration_monorepo_pnpm.md
index ffbf239a39..b06c487ba4 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_pnpm/snapshots/migration_monorepo_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_pnpm/snapshots/migration_monorepo_pnpm.md
@@ -7,6 +7,14 @@ migration should merge vite.config.ts and remove oxlintrc and oxfmtrc
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 2 review items
+
+packages/app/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/utils/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
 ✔ Merged .oxlintrc.json into vite.config.ts
 
 ✔ Merged .oxfmtrc.json into vite.config.ts
@@ -14,6 +22,14 @@ VITE+ - The Unified Toolchain for the Web
 • Node <version>  pnpm <version>
 • 4 config updates applied, 1 file had imports rewritten
 • Inline Vite plugins wrapped with lazyPlugins for check/lint/fmt
+! Warnings:
+  - Vitest v5: 2 review items
+
+packages/app/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/utils/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file vite.config.ts`
@@ -51,6 +67,7 @@ export default defineConfig({
       }
     ]
   },
+  test: { clearMocks: false },
   plugins: lazyPlugins(() => [react()]),
 });
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots.toml
index 6277bbdcf3..ef55410659 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_monorepo_root_vitest_adjacent"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "root with a vitest-adjacent dep but no direct vitest still gets a direct vitest pin", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "vitest pinned at the root even though vite-plus is injected first", continue-on-failure = true },
 ]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots/migration_monorepo_root_vitest_adjacent.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots/migration_monorepo_root_vitest_adjacent.md
index 568c949547..3d026b9f9f 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots/migration_monorepo_root_vitest_adjacent.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_root_vitest_adjacent/snapshots/migration_monorepo_root_vitest_adjacent.md
@@ -1,5 +1,10 @@
 # migration_monorepo_root_vitest_adjacent
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 root with a vitest-adjacent dep but no direct vitest still gets a direct vitest pin
@@ -7,6 +12,10 @@ root with a vitest-adjacent dep but no direct vitest still gets a direct vitest
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default and uses exact browser locators. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots.toml
index 3551495224..ad2c569fca 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_monorepo_skip_vite_peer_dependency"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "migration should preserve vite peer contracts in workspace packages", continue-on-failure = true },
   { argv = ["vpt", "print-file", "packages/vite-plugin/src/index.ts"], comment = "vite-plugin has vite in peerDeps: vite imports stay public, vitest rewrites", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "check root package.json (no peerDependencies)", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots/migration_monorepo_skip_vite_peer_dependency.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots/migration_monorepo_skip_vite_peer_dependency.md
index aa2b4ee2d9..2b8cee65bb 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots/migration_monorepo_skip_vite_peer_dependency.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_skip_vite_peer_dependency/snapshots/migration_monorepo_skip_vite_peer_dependency.md
@@ -1,5 +1,10 @@
 # migration_monorepo_skip_vite_peer_dependency
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 migration should preserve vite peer contracts in workspace packages
@@ -7,9 +12,18 @@ migration should preserve vite peer contracts in workspace packages
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+packages/vite-plugin/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+packages/vite-plugin/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file packages/vite-plugin/src/index.ts`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots.toml
index b24d023fbc..024fe3aebb 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_monorepo_yarn4"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "migration should merge vite.config.ts and remove oxlintrc", continue-on-failure = true },
   { argv = ["vpt", "print-file", "vite.config.ts"], comment = "check vite.config.ts", continue-on-failure = true },
   { argv = ["vpt", "stat-file", ".oxlintrc.json", "--assert-not", "file"], comment = "check .oxlintrc.json is removed", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots/migration_monorepo_yarn4.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots/migration_monorepo_yarn4.md
index 2427b17e57..8a476e4520 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots/migration_monorepo_yarn4.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_monorepo_yarn4/snapshots/migration_monorepo_yarn4.md
@@ -1,5 +1,10 @@
 # migration_monorepo_yarn4
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 migration should merge vite.config.ts and remove oxlintrc
@@ -7,6 +12,14 @@ migration should merge vite.config.ts and remove oxlintrc
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 2 review items
+
+packages/app/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/utils/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
 ⚠ Vite+ does not currently support Yarn Plug'n'Play (PnP).
 
 ✔ Switched Yarn to node-modules mode
@@ -17,6 +30,14 @@ VITE+ - The Unified Toolchain for the Web
 • 2 config updates applied, 1 file had imports rewritten
 • Inline Vite plugins wrapped with lazyPlugins for check/lint/fmt
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 2 review items
+
+packages/app/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/utils/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file vite.config.ts`
@@ -48,6 +69,7 @@ export default defineConfig({
       }
     ]
   },
+  test: { clearMocks: false },
   plugins: lazyPlugins(() => [react()]),
 });
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/package.json
index 58151f5f0a..a810147949 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/package.json
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/package.json
@@ -1,6 +1,6 @@
 {
   "name": "migration-no-agent",
   "dependencies": {
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.0"
   }
 }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/snapshots/migration_no_agent.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/snapshots/migration_no_agent.md
index c9b1704fc3..32ca1b5637 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/snapshots/migration_no_agent.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_no_agent/snapshots/migration_no_agent.md
@@ -7,6 +7,10 @@ migration with --no-agent should skip agent instructions
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_not_supported_vitest3/snapshots/migration_not_supported_vitest3.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_not_supported_vitest3/snapshots/migration_not_supported_vitest3.md
index 13e484183e..940ce39c89 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_not_supported_vitest3/snapshots/migration_not_supported_vitest3.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_not_supported_vitest3/snapshots/migration_not_supported_vitest3.md
@@ -14,10 +14,12 @@ migration should fail because vitest version is not supported
 ```
 VITE+ - The Unified Toolchain for the Web
 
-✘ vitest@3.2.4 in package.json is not supported by auto migration
+Vitest v5: 2 review items (1 block dependency updates)
 
-Please upgrade vitest to version >=4.0.0 first
-Vite+ cannot automatically migrate this project yet.
+package.json
+  1:1 BLOCK [source-version] Upgrade the original project to Vitest 4 before running this migration.
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_npmx_dev/snapshots/migration_npmx_dev.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_npmx_dev/snapshots/migration_npmx_dev.md
index 47b7ab55d9..614ea32428 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_npmx_dev/snapshots/migration_npmx_dev.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_npmx_dev/snapshots/migration_npmx_dev.md
@@ -7,6 +7,10 @@ npmx.dev shape: existing Vite+ upgrade, concrete @vitest/* should move into the
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default and uses exact browser locators. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
@@ -16,6 +20,11 @@ VITE+ - The Unified Toolchain for the Web
     @vitest/browser-playwright  4.1.10 → <version>
     @vitest/coverage-v8         4.1.10 → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default and uses exact browser locators. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/.nvmrc
index d7fd7cd552..c519bf5baa 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/.nvmrc
@@ -1 +1 @@
-v25.8.2
+v24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/snapshots/migration_nvmrc.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/snapshots/migration_nvmrc.md
index 52016a7ea3..a45814eb79 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/snapshots/migration_nvmrc.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc/snapshots/migration_nvmrc.md
@@ -18,7 +18,7 @@ VITE+ - The Unified Toolchain for the Web
 check .node-version is created with v prefix stripped
 
 ```
-25.8.2
+24.11.0
 ```
 
 ## `vpt stat-file .nvmrc --assert-not file`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_lts/snapshots/migration_nvmrc_lts.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_lts/snapshots/migration_nvmrc_lts.md
index 980c299d10..e2dd4c857a 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_lts/snapshots/migration_nvmrc_lts.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_lts/snapshots/migration_nvmrc_lts.md
@@ -7,10 +7,19 @@ migration should detect .nvmrc with lts alias and auto-migrate
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+.nvmrc
+  1:1 REVIEW [node-runtime] Resolve .nvmrc (lts/iron) and select Node ^22.18.0 || ^24.11.0 || >=26.0.0.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied
 • Node version manager file migrated to .node-version
+! Warnings:
+  - Vitest v5: 1 review item
+
+.node-version
+  1:1 REVIEW [node-runtime] Resolve .node-version (lts/iron) and select Node ^22.18.0 || ^24.11.0 || >=26.0.0.
 ```
 
 ## `vpt print-file .node-version`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_node_alias/snapshots/migration_nvmrc_node_alias.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_node_alias/snapshots/migration_nvmrc_node_alias.md
index 9fda9150d8..7792d6378c 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_node_alias/snapshots/migration_nvmrc_node_alias.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_nvmrc_node_alias/snapshots/migration_nvmrc_node_alias.md
@@ -7,11 +7,21 @@
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+.nvmrc
+  1:1 REVIEW [node-runtime] Resolve .nvmrc (node) and select Node ^22.18.0 || ^24.11.0 || >=26.0.0.
+
 "node" in .nvmrc is not a specific version; automatically mapping to "lts/*"
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied
 • Node version manager file migrated to .node-version
+! Warnings:
+  - Vitest v5: 1 review item
+
+.node-version
+  1:1 REVIEW [node-runtime] Resolve .node-version (lts/*) and select Node ^22.18.0 || ^24.11.0 || >=26.0.0.
 ```
 
 ## `vpt print-file .node-version`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots.toml
index 697fa1ae73..d65afb29f7 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots.toml
@@ -2,8 +2,10 @@
 name = "migration_preserve_below_policy_node_pins"
 vp = "global"
 steps = [
-  { argv = ["vp", "migrate", "--no-interactive"], comment = "existing Vite+ project: a Node pin below the supported range is preserved, not raised (native binding supports Node >=20)", continue-on-failure = true },
+  { argv = ["vp", "migrate", "--no-interactive"], comment = "reject a Node pin below the new CLI engine before modifying the project; never raise it silently", continue-on-failure = true },
   { argv = ["vpt", "print-file", ".node-version"], comment = "stays 24.3.0", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "engines.node stays 24.x and devEngines.runtime node stays ^24 (preserved, not raised)", continue-on-failure = true },
-  { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], comment = "vite-stack catalog updated to the migration target", continue-on-failure = true },
+  { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], comment = "catalog remains unchanged after failed preflight", continue-on-failure = true },
+  { argv = ["vpt", "write-file", ".node-version", "24.11.0\n"], comment = "the user explicitly selects a supported runtime", snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], comment = "migration can proceed without changing the public engine contract", continue-on-failure = true },
 ]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots/migration_preserve_below_policy_node_pins.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots/migration_preserve_below_policy_node_pins.md
index 12d3b03dcb..59f6075606 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots/migration_preserve_below_policy_node_pins.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_preserve_below_policy_node_pins/snapshots/migration_preserve_below_policy_node_pins.md
@@ -2,17 +2,21 @@
 
 ## `vp migrate --no-interactive`
 
-existing Vite+ project: a Node pin below the supported range is preserved, not raised (native binding supports Node >=20)
+reject a Node pin below the new CLI engine before modifying the project; never raise it silently
+
+**Exit code:** 1
 
 ```
 VITE+ - The Unified Toolchain for the Web
 
-◇ Updated . to Vite+ <version>
-• Node <version>  pnpm <version>
-• Dependencies:
-    vite-plus  0.1.21 → <version>
-    vite              → <version>
-• Package manager settings configured
+Vitest v5: 2 review items (1 block dependency updates)
+
+.node-version
+  1:1 BLOCK [node-runtime] .node-version (24.3.0) cannot run Vite+ with Vitest v5. Select Node ^22.18.0 || ^24.11.0 || >=26.0.0; use vp env pin 22 --force for a runtime pin. Do not widen a library's engines.node contract automatically.
+
+package.json
+  1:1 REVIEW [node-runtime] engines.node (24.x) includes unsupported test runtimes. Pin the test/CI runtime to Node ^22.18.0 || ^24.11.0 || >=26.0.0; keep the library's public engine contract separate.
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
 ```
 
 ## `vpt print-file .node-version`
@@ -55,7 +59,7 @@ engines.node stays 24.x and devEngines.runtime node stays ^24 (preserved, not ra
 
 ## `vpt print-file pnpm-workspace.yaml`
 
-vite-stack catalog updated to the migration target
+catalog remains unchanged after failed preflight
 
 ```
 packages:
@@ -64,12 +68,36 @@ packages:
 catalogs:
   vite-stack:
     vite: npm:@voidzero-dev/vite-plus-core@<version>
+    vitest: npm:@voidzero-dev/vite-plus-test@0.1.21
     vite-plus: <version>
-overrides:
-  vite@*: catalog:vite-stack
-peerDependencyRules:
-  allowAny:
-    - vite
-  allowedVersions:
-    vite: '*'
+```
+
+## `vpt write-file .node-version '24.11.0
+'`
+
+the user explicitly selects a supported runtime
+
+
+## `vp migrate --no-interactive`
+
+migration can proceed without changing the public engine contract
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [node-runtime] engines.node (24.x) includes unsupported test runtimes. Pin the test/CI runtime to Node ^22.18.0 || ^24.11.0 || >=26.0.0; keep the library's public engine contract separate.
+◇ Updated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• Dependencies:
+    vite-plus  0.1.21 → <version>
+    vite              → <version>
+• Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [node-runtime] engines.node (24.x) includes unsupported test runtimes. Pin the test/CI runtime to Node ^22.18.0 || ^24.11.0 || >=26.0.0; keep the library's public engine contract separate.
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots.toml
index 6925688aca..702fe11fcd 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_rewrite_declare_module"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "retained vitest augmentations should keep a package-local vitest", continue-on-failure = true },
   { argv = ["vpt", "print-file", "src/index.ts"], comment = "declare module 'vite'/'vitest' outside config files are preserved: through the core alias a 'vite' augmentation reaches the UserConfig that types vite-plus defineConfig, while vite-plus exports no UserConfig symbol to merge a rewritten augmentation with", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "check package.json", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots/migration_rewrite_declare_module.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots/migration_rewrite_declare_module.md
index f3c4113b66..db7fc0b9a2 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots/migration_rewrite_declare_module.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_declare_module/snapshots/migration_rewrite_declare_module.md
@@ -1,5 +1,10 @@
 # migration_rewrite_declare_module
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 retained vitest augmentations should keep a package-local vitest
@@ -7,6 +12,10 @@ retained vitest augmentations should keep a package-local vitest
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/package.json
index bacbc28e4e..5f6c39340a 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/package.json
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/package.json
@@ -2,6 +2,6 @@
   "name": "migration-rewrite-reference-types",
   "devDependencies": {
     "vite": "^6.0.0",
-    "vitest": "^3.0.0"
+    "vitest": "^4.1.0"
   }
 }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/snapshots/migration_rewrite_reference_types.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/snapshots/migration_rewrite_reference_types.md
index b38abf818e..7b1a8db528 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/snapshots/migration_rewrite_reference_types.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_rewrite_reference_types/snapshots/migration_rewrite_reference_types.md
@@ -7,6 +7,10 @@ vitest/tsdown reference types are rewritten; vite references are preserved (issu
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default and uses exact browser locators. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots.toml
index 57e698ea19..ff9c166fb5 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_skip_vite_dependency"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "migration should skip rewriting vite imports when vite is in dependencies", continue-on-failure = true },
   { argv = ["vpt", "print-file", "src/index.ts"], comment = "vite imports should NOT be rewritten, vitest imports SHOULD be rewritten", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "check package.json", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots/migration_skip_vite_dependency.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots/migration_skip_vite_dependency.md
index 9663a94770..97d90891a5 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots/migration_skip_vite_dependency.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_dependency/snapshots/migration_skip_vite_dependency.md
@@ -1,5 +1,10 @@
 # migration_skip_vite_dependency
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 migration should skip rewriting vite imports when vite is in dependencies
@@ -7,6 +12,10 @@ migration should skip rewriting vite imports when vite is in dependencies
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots.toml
index 45f4bd7dda..a8d3af4afc 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_skip_vite_peer_dependency"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "migration should preserve vite peer contracts", continue-on-failure = true },
   { argv = ["vpt", "print-file", "src/index.ts"], comment = "vite imports stay public, vitest imports rewrite", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "vite peer range is preserved", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots/migration_skip_vite_peer_dependency.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots/migration_skip_vite_peer_dependency.md
index 8ace240699..d51c0aabe5 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots/migration_skip_vite_peer_dependency.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_skip_vite_peer_dependency/snapshots/migration_skip_vite_peer_dependency.md
@@ -1,5 +1,10 @@
 # migration_skip_vite_peer_dependency
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 migration should preserve vite peer contracts
@@ -7,6 +12,10 @@ migration should preserve vite peer contracts
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_npm/snapshots/migration_standalone_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_npm/snapshots/migration_standalone_npm.md
index 05a6fe8589..017d2d446a 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_npm/snapshots/migration_standalone_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_npm/snapshots/migration_standalone_npm.md
@@ -7,6 +7,11 @@ migration should work with npm, add overrides, and update lockfile
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
 Formatting code...
 
 Code formatted
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_pnpm/snapshots/migration_standalone_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_pnpm/snapshots/migration_standalone_pnpm.md
index 08aa2e4839..d4b4405aaf 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_pnpm/snapshots/migration_standalone_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_pnpm/snapshots/migration_standalone_pnpm.md
@@ -7,6 +7,11 @@ migration should work with pnpm, write overrides and peerDependencyRules to pnpm
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
 Formatting code...
 
 Code formatted
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_yarn4_idempotent/snapshots/migration_standalone_yarn4_idempotent.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_yarn4_idempotent/snapshots/migration_standalone_yarn4_idempotent.md
index a721c83007..582a2f8b84 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_yarn4_idempotent/snapshots/migration_standalone_yarn4_idempotent.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_yarn4_idempotent/snapshots/migration_standalone_yarn4_idempotent.md
@@ -7,6 +7,11 @@ implicit Yarn Berry PnP converts before the first pass
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
 ⚠ Vite+ does not currently support Yarn Plug'n'Play (PnP).
 
 ✔ Switched Yarn to node-modules mode
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_yarn_below_catalog/snapshots/migration_standalone_yarn_below_catalog.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_yarn_below_catalog/snapshots/migration_standalone_yarn_below_catalog.md
index f533720f40..1c8e88df7a 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_yarn_below_catalog/snapshots/migration_standalone_yarn_below_catalog.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_standalone_yarn_below_catalog/snapshots/migration_standalone_yarn_below_catalog.md
@@ -7,6 +7,11 @@ Yarn < 4.10.0 cannot resolve `catalog:`, so managed specs stay concrete
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
 ⚠ Vite+ does not currently support Yarn Plug'n'Play (PnP).
 
 ✔ Switched Yarn to node-modules mode
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_peer_only_pnpm/snapshots/migration_upgrade_browser_peer_only_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_peer_only_pnpm/snapshots/migration_upgrade_browser_peer_only_pnpm.md
index caddc39162..f7584dcd56 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_peer_only_pnpm/snapshots/migration_upgrade_browser_peer_only_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_peer_only_pnpm/snapshots/migration_upgrade_browser_peer_only_pnpm.md
@@ -71,5 +71,13 @@ repaired project should no longer be pending
 ```
 VITE+ - The Unified Toolchain for the Web
 
-This project is already using Vite+! Happy coding!
+◇ Updated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• Dependencies:
+    vite   → <version>
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default and uses exact browser locators. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots.toml
index 5fcc933381..a5b5034a56 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_upgrade_browser_source_only_pnpm"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "source-only browser provider should be restored", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "provider, framework peer, and local vitest should be present", continue-on-failure = true },
   { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], comment = "shared vitest catalog and override should be present", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots/migration_upgrade_browser_source_only_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots/migration_upgrade_browser_source_only_pnpm.md
index 9f857f2cc1..cde2d633da 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots/migration_upgrade_browser_source_only_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_source_only_pnpm/snapshots/migration_upgrade_browser_source_only_pnpm.md
@@ -1,5 +1,10 @@
 # migration_upgrade_browser_source_only_pnpm
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 source-only browser provider should be restored
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots.toml
index ae1ea23cc3..4300fcd93c 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_upgrade_browser_webdriverio_pnpm"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "source-only WebdriverIO provider should be restored", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "provider, webdriverio, and local vitest should be present", continue-on-failure = true },
   { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], comment = "driver builds and shared vitest should be enabled", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migration_upgrade_browser_webdriverio_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migration_upgrade_browser_webdriverio_pnpm.md
index fdf43408bc..5ffaab714e 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migration_upgrade_browser_webdriverio_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_browser_webdriverio_pnpm/snapshots/migration_upgrade_browser_webdriverio_pnpm.md
@@ -1,5 +1,10 @@
 # migration_upgrade_browser_webdriverio_pnpm
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 source-only WebdriverIO provider should be restored
@@ -48,7 +53,7 @@ catalog:
   vite: npm:@voidzero-dev/vite-plus-core@<version>
   vite-plus: <version>
   vitest: <version>
-  '@vitest/browser-webdriverio': <version>
+  '@vitest/browser-webdriverio': ^5.0.0-beta.5 || >=5.0.0
 overrides:
   vite@*: 'catalog:'
   vitest@*: 'catalog:'
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_bun_catalog/snapshots/migration_upgrade_bun_catalog.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_bun_catalog/snapshots/migration_upgrade_bun_catalog.md
index b694a66f21..786beda9ca 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_bun_catalog/snapshots/migration_upgrade_bun_catalog.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_bun_catalog/snapshots/migration_upgrade_bun_catalog.md
@@ -7,12 +7,21 @@ existing bun Vite+ catalog WORKSPACE gains a direct vite edge for bun#8406 (bun
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  bun <version>
 • Dependencies:
     vite-plus  0.1.20 → <version>
     vite              → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_deprecated_coverage_c8_npm/snapshots/migration_upgrade_deprecated_coverage_c8_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_deprecated_coverage_c8_npm/snapshots/migration_upgrade_deprecated_coverage_c8_npm.md
index 1559bb6fe7..0d791d9cc9 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_deprecated_coverage_c8_npm/snapshots/migration_upgrade_deprecated_coverage_c8_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_deprecated_coverage_c8_npm/snapshots/migration_upgrade_deprecated_coverage_c8_npm.md
@@ -7,6 +7,10 @@ deprecated coverage-c8 has an independent version line
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  npm <version>
 • Dependencies:
@@ -14,6 +18,11 @@ VITE+ - The Unified Toolchain for the Web
     vite              → <version>
     vitest     4.1.8  → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/.nvmrc
index 5bd6811705..0a492611a0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/.nvmrc
@@ -1 +1 @@
-20.19.0
+24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/snapshots/migration_upgrade_hooks_flag_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/snapshots/migration_upgrade_hooks_flag_pnpm.md
index 9686b0da9e..bd0ef42a13 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/snapshots/migration_upgrade_hooks_flag_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_hooks_flag_pnpm/snapshots/migration_upgrade_hooks_flag_pnpm.md
@@ -10,6 +10,10 @@ existing Vite+ project: upgrade plus only the git hooks action
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_monorepo_vitest_localized_pnpm/snapshots/migration_upgrade_monorepo_vitest_localized_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_monorepo_vitest_localized_pnpm/snapshots/migration_upgrade_monorepo_vitest_localized_pnpm.md
index c5969a996a..aa0ca72bed 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_monorepo_vitest_localized_pnpm/snapshots/migration_upgrade_monorepo_vitest_localized_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_monorepo_vitest_localized_pnpm/snapshots/migration_upgrade_monorepo_vitest_localized_pnpm.md
@@ -7,12 +7,21 @@ existing Vite+ workspace packages should be reconciled
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+packages/app/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
     vite-plus  latest → <version>
     vite              → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+packages/app/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_nuxt_test_utils_monorepo/snapshots/migration_upgrade_nuxt_test_utils_monorepo.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_nuxt_test_utils_monorepo/snapshots/migration_upgrade_nuxt_test_utils_monorepo.md
index 465554a573..b35590d70e 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_nuxt_test_utils_monorepo/snapshots/migration_upgrade_nuxt_test_utils_monorepo.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_nuxt_test_utils_monorepo/snapshots/migration_upgrade_nuxt_test_utils_monorepo.md
@@ -7,6 +7,13 @@ preserve upstream Vitest package-wide and localize it to the affected workspace
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 2 review items
+
+packages/nuxt/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/unit/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
@@ -15,6 +22,14 @@ VITE+ - The Unified Toolchain for the Web
 • 1 file had imports rewritten
 • Kept upstream `vitest` imports in 2 files for @nuxt/test-utils compatibility
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 2 review items
+
+packages/nuxt/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/unit/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file packages/nuxt/package.json`
@@ -112,5 +127,12 @@ workspace result is idempotent
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 2 review items
+
+packages/nuxt/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
+
+packages/unit/package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 This project is already using Vite+! Happy coding!
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_peer_vitest_catalog_pnpm/snapshots/migration_upgrade_peer_vitest_catalog_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_peer_vitest_catalog_pnpm/snapshots/migration_upgrade_peer_vitest_catalog_pnpm.md
index 9c3d0f07fa..46a6337a93 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_peer_vitest_catalog_pnpm/snapshots/migration_upgrade_peer_vitest_catalog_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_peer_vitest_catalog_pnpm/snapshots/migration_upgrade_peer_vitest_catalog_pnpm.md
@@ -7,12 +7,21 @@ peer catalog must resolve before managed Vitest catalogs are pruned
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
     vite-plus  latest → <version>
     vite              → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
@@ -65,5 +74,9 @@ repaired project should no longer be pending
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 This project is already using Vite+! Happy coding!
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots.toml
index 2cac60d5fb..bcbbc6553f 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots.toml
@@ -1,7 +1,7 @@
 [[case]]
 name = "migration_upgrade_pkg_pr_new_npm"
 vp = "global"
-env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"4.1.10\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
+env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"5.0.0\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
 steps = [
   { argv = ["vp", "migrate", "--no-interactive"], comment = "bridge commit builds replace every stale managed spec", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "direct dependencies and npm overrides use the same immutable commit version", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots/migration_upgrade_pkg_pr_new_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots/migration_upgrade_pkg_pr_new_npm.md
index 3af614f730..8c2a658107 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots/migration_upgrade_pkg_pr_new_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_npm/snapshots/migration_upgrade_pkg_pr_new_npm.md
@@ -7,12 +7,21 @@ bridge commit builds replace every stale managed spec
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  npm <version>
 • Dependencies:
     vite-plus  0.1.20 → <version>
     vite              → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
@@ -40,6 +49,10 @@ bridge commit migration is idempotent
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 This project is already using Vite+! Happy coding!
 ```
 
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots.toml
index 195da5bf86..9c44fb93df 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots.toml
@@ -1,7 +1,7 @@
 [[case]]
 name = "migration_upgrade_pkg_pr_new_pnpm"
 vp = "global"
-env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"4.1.10\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
+env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"5.0.0\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
 steps = [
   { argv = ["vp", "migrate", "--no-interactive"], comment = "bridge commit builds upgrade like an ordinary npm version", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "direct dependencies use catalogs aligned to the bridge build", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots/migration_upgrade_pkg_pr_new_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots/migration_upgrade_pkg_pr_new_pnpm.md
index 59094af3ff..ed7eace139 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots/migration_upgrade_pkg_pr_new_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pkg_pr_new_pnpm/snapshots/migration_upgrade_pkg_pr_new_pnpm.md
@@ -7,6 +7,10 @@ bridge commit builds upgrade like an ordinary npm version
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
@@ -15,6 +19,11 @@ VITE+ - The Unified Toolchain for the Web
     vitest               0.1.20 → <version>
     @vitest/coverage-v8  4.1.6  → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
@@ -70,6 +79,10 @@ bridge commit migration is idempotent
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 This project is already using Vite+! Happy coding!
 ```
 
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots.toml
index 2dd891519b..f936f856c5 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots.toml
@@ -1,7 +1,7 @@
 [[case]]
 name = "migration_upgrade_pnpm9_overrides"
 vp = "global"
-env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"4.1.10\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
+env = { VP_OVERRIDE_PACKAGES = "{\"vite\":\"npm:@voidzero-dev/vite-plus-core@0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617\",\"vitest\":\"5.0.0\"}", VP_VERSION = "0.0.0-commit.0c515e3fbf5c140db35280d700df0bd600838617" }
 steps = [
   { argv = ["vp", "migrate", "--no-interactive"], comment = "pnpm 9.5-10.6.1: settings stay in package.json, catalog is still rewritten off the wrappers", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "pnpm.overrides stay catalog: (not inlined to a version)", continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots/migration_upgrade_pnpm9_overrides.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots/migration_upgrade_pnpm9_overrides.md
index 79bec01712..1fd1d3c898 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots/migration_upgrade_pnpm9_overrides.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_pnpm9_overrides/snapshots/migration_upgrade_pnpm9_overrides.md
@@ -7,6 +7,10 @@ pnpm 9.5-10.6.1: settings stay in package.json, catalog is still rewritten off t
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
@@ -15,6 +19,11 @@ VITE+ - The Unified Toolchain for the Web
     vitest               0.1.20 → <version>
     @vitest/coverage-v8  4.1.6  → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_required_vitest_peer_metadata_npm/snapshots/migration_upgrade_required_vitest_peer_metadata_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_required_vitest_peer_metadata_npm/snapshots/migration_upgrade_required_vitest_peer_metadata_npm.md
index 0df8aa080f..c37ca047b0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_required_vitest_peer_metadata_npm/snapshots/migration_upgrade_required_vitest_peer_metadata_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_required_vitest_peer_metadata_npm/snapshots/migration_upgrade_required_vitest_peer_metadata_npm.md
@@ -7,6 +7,10 @@ clean checkout conservatively preserves existing Vitest
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  npm <version>
 • Dependencies:
@@ -14,6 +18,11 @@ VITE+ - The Unified Toolchain for the Web
     vite              → <version>
     vitest     4.1.8  → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
@@ -57,5 +66,9 @@ metadata confirms the unnamed required Vitest peer
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 This project is already using Vite+! Happy coding!
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/.nvmrc
index 5bd6811705..0a492611a0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/.nvmrc
@@ -1 +1 @@
-20.19.0
+24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/snapshots/migration_upgrade_setup_full_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/snapshots/migration_upgrade_setup_full_pnpm.md
index 1ff640f201..649f56e446 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/snapshots/migration_upgrade_setup_full_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_full_pnpm/snapshots/migration_upgrade_setup_full_pnpm.md
@@ -14,6 +14,10 @@ existing Vite+ project: upgrade plus the full setup
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
@@ -53,7 +57,7 @@ vite-plus version upgrade is applied
 .nvmrc is migrated to .node-version by the full setup
 
 ```
-20.19.0
+24.11.0
 ```
 
 ## `vpt stat-file .nvmrc --assert-not file`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/.nvmrc
index 5bd6811705..0a492611a0 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/.nvmrc
@@ -1 +1 @@
-20.19.0
+24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/snapshots/migration_upgrade_setup_skipped_default_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/snapshots/migration_upgrade_setup_skipped_default_pnpm.md
index dced98c173..89362e455e 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/snapshots/migration_upgrade_setup_skipped_default_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_setup_skipped_default_pnpm/snapshots/migration_upgrade_setup_skipped_default_pnpm.md
@@ -7,6 +7,10 @@ existing Vite+ project: upgrade the toolchain version only, skip the full setup
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
@@ -14,6 +18,11 @@ VITE+ - The Unified Toolchain for the Web
     vite              → <version>
 • Package manager settings configured
 • Skipped editor, hooks, and lint setup. Run `vp migrate --full` to apply them.
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_stale_local_pnpm/snapshots/migration_upgrade_stale_local_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_stale_local_pnpm/snapshots/migration_upgrade_stale_local_pnpm.md
index e02b10c9fb..595b32294f 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_stale_local_pnpm/snapshots/migration_upgrade_stale_local_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_stale_local_pnpm/snapshots/migration_upgrade_stale_local_pnpm.md
@@ -10,12 +10,21 @@ newer global CLI must bypass the installed stale local CLI
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
     vite-plus  0.1.24 → <version>
     vite              → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/pnpm-workspace.yaml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/pnpm-workspace.yaml
index 9e76cdd806..ce4cfd2128 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/pnpm-workspace.yaml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/pnpm-workspace.yaml
@@ -4,5 +4,5 @@ packages:
 catalog:
   vite-plus: 0.1.21
   vite: npm:@voidzero-dev/vite-plus-core@0.1.21
-  vitest: 3.2.4
-  '@vitest/coverage-v8': 3.2.4
+  vitest: 4.1.8
+  '@vitest/coverage-v8': 4.1.8
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/snapshots/migration_upgrade_version_table_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/snapshots/migration_upgrade_version_table_pnpm.md
index 6f4a2ff727..d829b8b8cc 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/snapshots/migration_upgrade_version_table_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_version_table_pnpm/snapshots/migration_upgrade_version_table_pnpm.md
@@ -12,12 +12,21 @@ existing-Vite+ upgrade shows the toolchain version-change table with the raw vit
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • Dependencies:
     vite-plus            0.1.21 → <version>
     vite                 8.0.0  → <version>
-    vitest               3.2.4  → <version>
-    @vitest/coverage-v8  3.2.4  → <version>
+    vitest               4.1.8  → <version>
+    @vitest/coverage-v8  4.1.8  → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vite_plus_protocol_pin_npm/snapshots/migration_upgrade_vite_plus_protocol_pin_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vite_plus_protocol_pin_npm/snapshots/migration_upgrade_vite_plus_protocol_pin_npm.md
index 5837313658..4d480b3630 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vite_plus_protocol_pin_npm/snapshots/migration_upgrade_vite_plus_protocol_pin_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vite_plus_protocol_pin_npm/snapshots/migration_upgrade_vite_plus_protocol_pin_npm.md
@@ -7,11 +7,20 @@ deliberate vite-plus protocol pin must survive bootstrap
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  npm <version>
 • Dependencies:
     vite   → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_exact_peer_npm/snapshots/migration_upgrade_vitest_exact_peer_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_exact_peer_npm/snapshots/migration_upgrade_vitest_exact_peer_npm.md
index e70c98d085..64b032b8cd 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_exact_peer_npm/snapshots/migration_upgrade_vitest_exact_peer_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_exact_peer_npm/snapshots/migration_upgrade_vitest_exact_peer_npm.md
@@ -7,6 +7,10 @@ exact @vitest peers require a package-local vitest
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  npm <version>
 • Dependencies:
@@ -18,6 +22,11 @@ VITE+ - The Unified Toolchain for the Web
     @vitest/utils        4.1.8  → <version>
     @vitest/web-worker   4.1.8  → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_non_runtime_only_npm/snapshots/migration_upgrade_vitest_non_runtime_only_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_non_runtime_only_npm/snapshots/migration_upgrade_vitest_non_runtime_only_npm.md
index 77366f0439..f4ef069a69 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_non_runtime_only_npm/snapshots/migration_upgrade_vitest_non_runtime_only_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_non_runtime_only_npm/snapshots/migration_upgrade_vitest_non_runtime_only_npm.md
@@ -7,14 +7,24 @@ non-runtime @vitest packages must not keep a vitest pin
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 2 review items
+
+package.json
+  1:1 REVIEW [legacy-dependency] Review the direct @vitest/ws-client dependency after migrating its imports; it is no longer part of the bundled Vitest graph.
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  npm <version>
 • Dependencies:
-    vite-plus          latest → <version>
-    vite                      → <version>
-    @vitest/utils      4.1.8  → <version>
-    @vitest/ws-client  4.1.8  → <version>
+    vite-plus      latest → <version>
+    vite                  → <version>
+    @vitest/utils  4.1.8  → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 2 review items
+
+package.json
+  1:1 REVIEW [legacy-dependency] Review the direct @vitest/ws-client dependency after migrating its imports; it is no longer part of the bundled Vitest graph.
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
@@ -27,7 +37,7 @@ internal packages align, eslint plugin stays independent, vitest is removed
   "devDependencies": {
     "@vitest/eslint-plugin": "^1.6.0",
     "@vitest/utils": "<version>",
-    "@vitest/ws-client": "<version>",
+    "@vitest/ws-client": "^4.1.8",
     "vite-plus": "<version>"
   },
   "overrides": {
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_reference_whitespace_pnpm/snapshots/migration_upgrade_vitest_reference_whitespace_pnpm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_reference_whitespace_pnpm/snapshots/migration_upgrade_vitest_reference_whitespace_pnpm.md
index 3ace8f239c..f90da7940c 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_reference_whitespace_pnpm/snapshots/migration_upgrade_vitest_reference_whitespace_pnpm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_reference_whitespace_pnpm/snapshots/migration_upgrade_vitest_reference_whitespace_pnpm.md
@@ -7,6 +7,10 @@ TypeScript whitespace in a Vitest type directive is valid
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_retained_references_npm/snapshots/migration_upgrade_vitest_retained_references_npm.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_retained_references_npm/snapshots/migration_upgrade_vitest_retained_references_npm.md
index ed98a9fea3..965fecdf78 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_retained_references_npm/snapshots/migration_upgrade_vitest_retained_references_npm.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_upgrade_vitest_retained_references_npm/snapshots/migration_upgrade_vitest_retained_references_npm.md
@@ -7,6 +7,10 @@ retained upstream references require package-local Vitest
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Updated . to Vite+ <version>
 • Node <version>  npm <version>
 • Dependencies:
@@ -14,6 +18,11 @@ VITE+ - The Unified Toolchain for the Web
     vite              → <version>
     vitest     4.1.8  → <version>
 • Package manager settings configured
+! Warnings:
+  - Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ```
 
 ## `vpt print-file package.json`
@@ -90,5 +99,9 @@ retained references remain stable on rerun
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 This project is already using Vite+! Happy coding!
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_import_only/snapshots/migration_vitest_import_only.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_import_only/snapshots/migration_vitest_import_only.md
index c31bf9f0dc..54f0c0c0c9 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_import_only/snapshots/migration_vitest_import_only.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_import_only/snapshots/migration_vitest_import_only.md
@@ -7,6 +7,10 @@ ordinary vitest imports should migrate without retaining direct vitest
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied, 1 file had imports rewritten
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots.toml
index 4b4ca5ffeb..16de4053ab 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots.toml
@@ -2,6 +2,7 @@
 name = "migration_vitest_peer_dep"
 vp = "global"
 steps = [
+  { argv = ["vpt", "write-file", "node_modules/vitest/package.json", "{\"name\":\"vitest\",\"version\":\"4.1.11\"}"], comment = "record the original runner version without adding a direct dependency", snapshot = false },
   { argv = ["vp", "migrate", "--no-interactive"], comment = "vitest should be added to devDeps when vitest-browser-svelte is present", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "vitest should be in devDependencies", continue-on-failure = true },
   { argv = ["vpt", "print-file", "pnpm-workspace.yaml"], continue-on-failure = true },
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots/migration_vitest_peer_dep.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots/migration_vitest_peer_dep.md
index 17f735d8f0..dedf529414 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots/migration_vitest_peer_dep.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_peer_dep/snapshots/migration_vitest_peer_dep.md
@@ -1,5 +1,10 @@
 # migration_vitest_peer_dep
 
+## `vpt write-file node_modules/vitest/package.json '{"name":"vitest","version":"4.1.11"}'`
+
+record the original runner version without adding a direct dependency
+
+
 ## `vp migrate --no-interactive`
 
 vitest should be added to devDeps when vitest-browser-svelte is present
@@ -7,6 +12,10 @@ vitest should be added to devDeps when vitest-browser-svelte is present
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default and uses exact browser locators. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_unmanaged_override/snapshots/migration_vitest_unmanaged_override.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_unmanaged_override/snapshots/migration_vitest_unmanaged_override.md
index 8278e5fb88..ee88facaf2 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_unmanaged_override/snapshots/migration_vitest_unmanaged_override.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_unmanaged_override/snapshots/migration_vitest_unmanaged_override.md
@@ -7,6 +7,10 @@ vitest omitted from managed overrides must remain user-owned
 ```
 VITE+ - The Unified Toolchain for the Web
 
+Vitest v5: 1 review item
+
+package.json
+  1:1 REVIEW [configless-defaults] No test config exists. Vitest v5 clears mocks by default. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.
 ◇ Migrated . to Vite+ <version>
 • Node <version>  pnpm <version>
 • 2 config updates applied
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/example.test.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/example.test.ts
new file mode 100644
index 0000000000..853beb85e1
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/example.test.ts
@@ -0,0 +1,6 @@
+import { expect, test } from 'vitest';
+
+test.sequential('compatibility', () => {
+  expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow('');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/package.json
new file mode 100644
index 0000000000..59c0e1da8b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/package.json
@@ -0,0 +1,13 @@
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "4.1.11"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots.toml
new file mode 100644
index 0000000000..194387c3cc
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots.toml
@@ -0,0 +1,94 @@
+[[case]]
+name = "compatibility"
+vp = "global"
+steps = [
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "vite.config.ts"],
+  ["vpt", "print-file", "example.test.ts"],
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "print-file", ".vite-plus/migrations.json"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "node_preflight"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", ".node-version", "20.19.0\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "print-file", "example.test.ts"],
+]
+
+[[case]]
+name = "node_container_scope"
+vp = "global"
+comment = "Check the runtime image and feature option, not source properties or Dev Container feature tags."
+steps = [
+  { argv = ["vpt", "write-file", "worker.js", "export const options = { node:2 };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", ".devcontainer/devcontainer.json", "{\"features\":{\"ghcr.io/devcontainers/features/node:1\":{\"version\":\"lts\"}}}\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "Dockerfile", "# FROM node:20\nFROM node:20-alpine AS build\nRUN echo node:2\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json"],
+  { argv = ["vpt", "write-file", "Dockerfile", "# FROM node:20\nFROM node:24.11.0-alpine AS build\nRUN echo node:2\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "worker.js"],
+  ["vpt", "print-file", ".devcontainer/devcontainer.json"],
+]
+
+[[case]]
+name = "mixed_project_assertions"
+vp = "global"
+comment = "Keep Node DOM matchers, migrate browser matchers, and retain review findings for shared transform inputs across repeated migrations."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { projects: [{ test: { name: 'node', include: ['node.test.ts', 'shared.test.ts'] } }, { test: { name: 'browser', browser: { enabled: true }, include: ['browser.test.ts', 'shared.test.ts'] } }] } };\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "node.test.ts", "import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "browser.test.ts", "import { expect } from 'vitest';\nawait expect.element(element)['toHaveTextContent']('partial');\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "shared.test.ts", "import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "node.test.ts"],
+  ["vpt", "print-file", "browser.test.ts"],
+  ["vpt", "print-file", "shared.test.ts"],
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+]
+
+[[case]]
+name = "plugin_projects_and_dom_types"
+vp = "global"
+comment = "Do not scan plugin project paths as Vitest configs; report the Jest-only DOM type entry without changing a mixed test contract."
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "import { defineConfig } from 'vitest/config';\nconst config = defineConfig({ plugins: [{ name: 'paths', projects: ['./tsconfig.json', './plugin-options.ts'] }], test: {} });\nexport default config;\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "tsconfig.json", "{\"compilerOptions\":{\"types\":[\"@testing-library/jest-dom\",\"vitest/globals\"]}}\n"], snapshot = false },
+  { argv = ["vpt", "write-file", "plugin-options.ts", "export default { test: {} };\n"], snapshot = false },
+  ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"],
+  ["vpt", "print-file", "plugin-options.ts"],
+  ["vpt", "print-file", "tsconfig.json"],
+]
+
+[[case]]
+name = "removed_api_preflight"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", "custom-runner.ts", "import { startTests } from '@vitest/runner';\nstartTests([]);\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json"],
+]
+
+[[case]]
+name = "api_conflict_preflight"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", "vite.config.ts", "export default { test: { api: { port: 1 }, browser: { api: { port: 2 } } } };\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json"],
+]
+
+[[case]]
+name = "benchmark_preflight"
+vp = "global"
+steps = [
+  { argv = ["vpt", "write-file", "example.bench.ts", "import { bench } from 'vitest';\nbench('old benchmark', () => 20 + 22);\n"], snapshot = false },
+  { argv = ["vp", "migrate", "--no-interactive"], continue-on-failure = true },
+  ["vpt", "print-file", "package.json"],
+  ["vpt", "print-file", "example.bench.ts"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_conflict_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_conflict_preflight.md
new file mode 100644
index 0000000000..72023e2592
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/api_conflict_preflight.md
@@ -0,0 +1,37 @@
+# api_conflict_preflight
+
+## `vpt write-file vite.config.ts 'export default { test: { api: { port: 1 }, browser: { api: { port: 2 } } } };
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item (1 block dependency updates)
+
+vite.config.ts
+  1:55 BLOCK [api-conflict] Resolve conflicting test.api and test.browser.api values before upgrading.
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_preflight.md
new file mode 100644
index 0000000000..dbfbc7c8e5
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/benchmark_preflight.md
@@ -0,0 +1,45 @@
+# benchmark_preflight
+
+## `vpt write-file example.bench.ts 'import { bench } from '\''vitest'\'';
+bench('\''old benchmark'\'', () => 20 + 22);
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item (1 block dependency updates)
+
+example.bench.ts
+  1:10 BLOCK [benchmark-api] Replace the removed top-level bench import with the bench test-context fixture.
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
+
+## `vpt print-file example.bench.ts`
+
+```
+import { bench } from 'vitest';
+bench('old benchmark', () => 20 + 22);
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/compatibility.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/compatibility.md
new file mode 100644
index 0000000000..1d3b3bbc25
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/compatibility.md
@@ -0,0 +1,79 @@
+# compatibility
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+```
+
+## `vpt print-file vite.config.ts`
+
+```
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  fmt: {},
+  lint: {"jsPlugins":[{"name":"vite-plus","specifier":"vite-plus/oxlint-plugin"}],"rules":{"vite-plus/prefer-vite-plus-imports":"error"},"options":{"typeAware":true,"typeCheck":true}},
+  test: {
+    clearMocks: false,
+    sharedViteServer: false,
+    reporters: [['json', { stdout: true }], ['junit', { stdout: true }]],
+    projects: [{ extends: false,  test: { clearMocks: false,  name: 'unit' } }, { extends: true, test: { name: 'inherited' } }],
+  },
+});
+```
+
+## `vpt print-file example.test.ts`
+
+```
+import { expect, test } from 'vite-plus/test';
+
+test('compatibility', { concurrent: false }, async () => {
+  await expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow(/^$/);
+});
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vp test list --no-static-parse"
+  },
+  "devDependencies": {
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
+  }
+}
+```
+
+## `vpt print-file .vite-plus/migrations.json`
+
+```
+{
+  "version": 1,
+  "vitest5": {
+    ".": {
+      "sourceVersion": "4.1.11",
+      "configless": false
+    }
+  }
+}
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/mixed_project_assertions.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/mixed_project_assertions.md
new file mode 100644
index 0000000000..5a4f5a51a9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/mixed_project_assertions.md
@@ -0,0 +1,74 @@
+# mixed_project_assertions
+
+Keep Node DOM matchers, migrate browser matchers, and retain review findings for shared transform inputs across repeated migrations.
+
+## `vpt write-file vite.config.ts 'export default { test: { projects: [{ test: { name: '\''node'\'', include: ['\''node.test.ts'\'', '\''shared.test.ts'\''] } }, { test: { name: '\''browser'\'', browser: { enabled: true }, include: ['\''browser.test.ts'\'', '\''shared.test.ts'\''] } }] } };
+'`
+
+
+## `vpt write-file node.test.ts 'import { expect } from '\''vitest'\'';
+expect(element).toHaveTextContent('\''partial'\'');
+'`
+
+
+## `vpt write-file browser.test.ts 'import { expect } from '\''vitest'\'';
+await expect.element(element)['\''toHaveTextContent'\'']('\''partial'\'');
+'`
+
+
+## `vpt write-file shared.test.ts 'import { expect } from '\''vitest'\'';
+expect(element).toHaveTextContent('\''partial'\'');
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item
+
+shared.test.ts
+  2:1 REVIEW [text-content-project] Resolve this assertion's test project: browser assertions need toMatchTextContent for v4 partial matching; keep Node jest-dom assertions unchanged.
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 4 files had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+shared.test.ts
+  2:1 REVIEW [text-content-project] Resolve this assertion's test project: browser assertions need toMatchTextContent for v4 partial matching; keep Node jest-dom assertions unchanged.
+```
+
+## `vpt print-file node.test.ts`
+
+```
+import { expect } from 'vite-plus/test';
+expect(element).toHaveTextContent('partial');
+```
+
+## `vpt print-file browser.test.ts`
+
+```
+import { expect } from 'vite-plus/test';
+await expect.element(element)["toMatchTextContent"]('partial');
+```
+
+## `vpt print-file shared.test.ts`
+
+```
+import { expect } from 'vite-plus/test';
+expect(element).toHaveTextContent('partial');
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item
+
+shared.test.ts
+  2:1 REVIEW [text-content-project] Resolve this assertion's test project: browser assertions need toMatchTextContent for v4 partial matching; keep Node jest-dom assertions unchanged.
+This project is already using Vite+! Happy coding!
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_container_scope.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_container_scope.md
new file mode 100644
index 0000000000..9866ad5bc7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_container_scope.md
@@ -0,0 +1,89 @@
+# node_container_scope
+
+Check the runtime image and feature option, not source properties or Dev Container feature tags.
+
+## `vpt write-file worker.js 'export const options = { node:2 };
+'`
+
+
+## `vpt write-file .devcontainer/devcontainer.json '{"features":{"ghcr.io/devcontainers/features/node:1":{"version":"lts"}}}
+'`
+
+
+## `vpt write-file Dockerfile '# FROM node:20
+FROM node:20-alpine AS build
+RUN echo node:2
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 2 review items (1 block dependency updates)
+
+.devcontainer/devcontainer.json
+  1:1 REVIEW [node-runtime] Resolve Dev Container Node feature (lts) and select Node ^22.18.0 || ^24.11.0 || >=26.0.0.
+
+Dockerfile
+  2:1 BLOCK [node-runtime] Node container image (20) cannot run Vite+ with Vitest v5. Select Node ^22.18.0 || ^24.11.0 || >=26.0.0; use vp env pin 22 --force for a runtime pin. Do not widen a library's engines.node contract automatically.
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
+
+## `vpt write-file Dockerfile '# FROM node:20
+FROM node:24.11.0-alpine AS build
+RUN echo node:2
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item
+
+.devcontainer/devcontainer.json
+  1:1 REVIEW [node-runtime] Resolve Dev Container Node feature (lts) and select Node ^22.18.0 || ^24.11.0 || >=26.0.0.
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 2 files had imports rewritten
+! Warnings:
+  - Vitest v5: 1 review item
+
+.devcontainer/devcontainer.json
+  1:1 REVIEW [node-runtime] Resolve Dev Container Node feature (lts) and select Node ^22.18.0 || ^24.11.0 || >=26.0.0.
+```
+
+## `vpt print-file worker.js`
+
+```
+export const options = { node:2 };
+```
+
+## `vpt print-file .devcontainer/devcontainer.json`
+
+```
+{"features":{"ghcr.io/devcontainers/features/node:1":{"version":"lts"}}}
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_preflight.md
new file mode 100644
index 0000000000..19c25fdf2f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/node_preflight.md
@@ -0,0 +1,48 @@
+# node_preflight
+
+## `vpt write-file .node-version '20.19.0
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item (1 block dependency updates)
+
+.node-version
+  1:1 BLOCK [node-runtime] .node-version (20.19.0) cannot run Vite+ with Vitest v5. Select Node ^22.18.0 || ^24.11.0 || >=26.0.0; use vp env pin 22 --force for a runtime pin. Do not widen a library's engines.node contract automatically.
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
+
+## `vpt print-file example.test.ts`
+
+```
+import { expect, test } from 'vitest';
+
+test.sequential('compatibility', () => {
+  expect(Promise.resolve(42)).resolves.toBe(42);
+  expect(() => { throw new Error(''); }).toThrow('');
+});
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/plugin_projects_and_dom_types.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/plugin_projects_and_dom_types.md
new file mode 100644
index 0000000000..22675f10dc
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/plugin_projects_and_dom_types.md
@@ -0,0 +1,55 @@
+# plugin_projects_and_dom_types
+
+Do not scan plugin project paths as Vitest configs; report the Jest-only DOM type entry without changing a mixed test contract.
+
+## `vpt write-file vite.config.ts 'import { defineConfig } from '\''vitest/config'\'';
+const config = defineConfig({ plugins: [{ name: '\''paths'\'', projects: ['\''./tsconfig.json'\'', '\''./plugin-options.ts'\''] }], test: {} });
+export default config;
+'`
+
+
+## `vpt write-file tsconfig.json '{"compilerOptions":{"types":["@testing-library/jest-dom","vitest/globals"]}}
+'`
+
+
+## `vpt write-file plugin-options.ts 'export default { test: {} };
+'`
+
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 2 review items
+
+tsconfig.json
+  1:1 REVIEW [jest-dom-types] If this config checks Vitest tests, load @testing-library/jest-dom/vitest in compilerOptions.types or an included TypeScript setup file. The root jest-dom type entry augments Jest, not Vitest v5.
+
+vite.config.ts
+  3:1 REVIEW [dynamic-config] Review the effective exported test config and its v4 defaults.
+◇ Migrated . to Vite+ <version>
+• Node <version>  pnpm <version>
+• 1 config update applied, 2 files had imports rewritten
+• Inline Vite plugins wrapped with lazyPlugins for check/lint/fmt
+! Warnings:
+  - Vitest v5: 2 review items
+
+tsconfig.json
+  1:1 REVIEW [jest-dom-types] If this config checks Vitest tests, load @testing-library/jest-dom/vitest in compilerOptions.types or an included TypeScript setup file. The root jest-dom type entry augments Jest, not Vitest v5.
+
+vite.config.ts
+  7:1 REVIEW [dynamic-config] Review the effective exported test config and its v4 defaults.
+```
+
+## `vpt print-file plugin-options.ts`
+
+```
+export default { test: {} };
+```
+
+## `vpt print-file tsconfig.json`
+
+```
+{"compilerOptions":{"types":["@testing-library/jest-dom","vitest/globals"]}}
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/removed_api_preflight.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/removed_api_preflight.md
new file mode 100644
index 0000000000..2b277372fd
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/snapshots/removed_api_preflight.md
@@ -0,0 +1,38 @@
+# removed_api_preflight
+
+## `vpt write-file custom-runner.ts 'import { startTests } from '\''@vitest/runner'\'';
+startTests([]);
+'`
+
+
+## `vp migrate --no-interactive`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Vitest v5: 1 review item (1 block dependency updates)
+
+custom-runner.ts
+  1:10 BLOCK [removed-api] Migrate startTests from @vitest/runner manually; no reviewed root v5 replacement exists.
+Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.
+```
+
+## `vpt print-file package.json`
+
+```
+{
+  "name": "migration-vitest-v5",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "scripts": {
+    "test": "vitest list"
+  },
+  "devDependencies": {
+    "vite": "^8.0.0",
+    "vitest": "<version>"
+  }
+}
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/vite.config.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/vite.config.ts
new file mode 100644
index 0000000000..0c35ccb6e7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_vitest_v5/vite.config.ts
@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    reporters: ['json', ['junit', {}]],
+    projects: [{ test: { name: 'unit' } }, { extends: true, test: { name: 'inherited' } }],
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/package.json
index 2b9893f340..05a285f697 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/package.json
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/package.json
@@ -4,7 +4,7 @@
     "vite": "^7.0.0"
   },
   "volta": {
-    "node": "20.19.0",
+    "node": "24.11.0",
     "npm": "10.2.5"
   }
 }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/snapshots/migration_volta.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/snapshots/migration_volta.md
index 2b17219a50..85227f734c 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/snapshots/migration_volta.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta/snapshots/migration_volta.md
@@ -20,7 +20,7 @@ VITE+ - The Unified Toolchain for the Web
 check .node-version is created from volta.node
 
 ```
-20.19.0
+24.11.0
 ```
 
 ## `vpt print-file package.json`
@@ -35,7 +35,7 @@ volta field is preserved in package.json (not removed)
     "vite-plus": "catalog:"
   },
   "volta": {
-    "node": "20.19.0",
+    "node": "24.11.0",
     "npm": "10.2.5"
   },
   "devEngines": {
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/.nvmrc b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/.nvmrc
index 5f53e875de..c519bf5baa 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/.nvmrc
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/.nvmrc
@@ -1 +1 @@
-v20.19.0
+v24.11.0
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots.toml
index e2a1e969b6..4c41cf96b4 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots.toml
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots.toml
@@ -3,7 +3,7 @@ name = "migration_volta_with_nvmrc"
 vp = "global"
 steps = [
   { argv = ["vp", "migrate", "--no-interactive"], comment = ".nvmrc should take priority over volta.node", continue-on-failure = true },
-  { argv = ["vpt", "print-file", ".node-version"], comment = "check .node-version comes from .nvmrc (v20.19.0), not volta.node (18.0.0)", continue-on-failure = true },
+  { argv = ["vpt", "print-file", ".node-version"], comment = "check .node-version comes from .nvmrc (v24.11.0), not volta.node (18.0.0)", continue-on-failure = true },
   { argv = ["vpt", "stat-file", ".nvmrc", "--assert-not", "file"], comment = "check .nvmrc is removed", continue-on-failure = true },
   { argv = ["vpt", "print-file", "package.json"], comment = "volta field must remain intact", continue-on-failure = true },
 ]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots/migration_volta_with_nvmrc.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots/migration_volta_with_nvmrc.md
index 9cb0ddf50f..cb3c2e856c 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots/migration_volta_with_nvmrc.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/migration_volta_with_nvmrc/snapshots/migration_volta_with_nvmrc.md
@@ -17,10 +17,10 @@ VITE+ - The Unified Toolchain for the Web
 
 ## `vpt print-file .node-version`
 
-check .node-version comes from .nvmrc (v20.19.0), not volta.node (18.0.0)
+check .node-version comes from .nvmrc (v24.11.0), not volta.node (18.0.0)
 
 ```
-20.19.0
+24.11.0
 ```
 
 ## `vpt stat-file .nvmrc --assert-not file`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_inline_snapshot_indent/snapshots/test_inline_snapshot_indent.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_inline_snapshot_indent/snapshots/test_inline_snapshot_indent.md
index 871bcffef7..f5be99adbd 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_inline_snapshot_indent/snapshots/test_inline_snapshot_indent.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_inline_snapshot_indent/snapshots/test_inline_snapshot_indent.md
@@ -16,7 +16,7 @@ write inline snapshot via --update (regression test for #1553)
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
 
 ## `vpt print-file src/inline-snapshot.test.ts`
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_managed_package_manager_path/snapshots/test_managed_package_manager_path.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_managed_package_manager_path/snapshots/test_managed_package_manager_path.md
index a6794df8b2..2a4fb2e166 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_managed_package_manager_path/snapshots/test_managed_package_manager_path.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_managed_package_manager_path/snapshots/test_managed_package_manager_path.md
@@ -25,5 +25,5 @@ VITE+ - The Unified Toolchain for the Web
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/coverage.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/coverage.test.js
new file mode 100644
index 0000000000..3333839212
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/coverage.test.js
@@ -0,0 +1,8 @@
+import { expect, test } from 'vitest';
+import { expect as bundledExpect, test as bundledTest } from 'vite-plus/test';
+import { sum } from './src/covered.js';
+test('covered sum', () => {
+  expect(expect).toBe(bundledExpect);
+  expect(test).toBe(bundledTest);
+  expect(sum(20, 22)).toBe(42);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/coverage.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/coverage.test.js
new file mode 100644
index 0000000000..a6a76fb757
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/coverage.test.js
@@ -0,0 +1,3 @@
+import { expect, test } from 'vitest';
+import { sum } from './src/covered.js';
+test('covered sum', () => { expect(sum(20, 22)).toBe(42); });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/package.json
new file mode 100644
index 0000000000..25c5d92a41
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/package.json
@@ -0,0 +1,6 @@
+{
+  "name": "coverage-v4-reference",
+  "private": true,
+  "type": "module",
+  "devDependencies": { "vitest": "4.1.11", "@vitest/coverage-v8": "4.1.11" }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/vitest.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/vitest.config.mjs
new file mode 100644
index 0000000000..6db30b38cb
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/legacy/vitest.config.mjs
@@ -0,0 +1,12 @@
+export default {
+  test: {
+    include: ['coverage.test.js'],
+    coverage: {
+      enabled: true,
+      provider: 'v8',
+      include: ['src/**'],
+      exclude: ['src/ignored.js'],
+      reporter: ['json'],
+    },
+  },
+};
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/package.json
new file mode 100644
index 0000000000..2d23d96cf7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/package.json
@@ -0,0 +1,10 @@
+{
+  "name": "test-v5-coverage",
+  "private": true,
+  "type": "module",
+  "devDependencies": {
+    "vite-plus": "latest",
+    "@vitest/coverage-v8": "5.0.0",
+    "@vitest/coverage-istanbul": "5.0.0"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots.toml
new file mode 100644
index 0000000000..f0c7259fbb
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots.toml
@@ -0,0 +1,11 @@
+[[case]]
+name = "coverage_providers_and_v4_file_set"
+vp = "global"
+local-registry = true
+comment = "Install the packed CLI and project-owned providers together; checkout symlinks cannot test native provider resolution."
+steps = [
+  { argv = ["npm", "install", "--ignore-scripts", "--no-audit", "--no-fund"], snapshot = false, timeout = 120000 },
+  { argv = ["npm", "install", "--prefix", "legacy", "--ignore-scripts", "--no-audit", "--no-fund"], snapshot = false, timeout = 120000 },
+  { argv = ["vpt", "cp", "-r", "src", "legacy"], snapshot = false },
+  { argv = ["node", "verify.mjs"], timeout = 120000 },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots/coverage_providers_and_v4_file_set.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots/coverage_providers_and_v4_file_set.md
new file mode 100644
index 0000000000..d6c3fa41c3
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/snapshots/coverage_providers_and_v4_file_set.md
@@ -0,0 +1,24 @@
+# coverage_providers_and_v4_file_set
+
+Install the packed CLI and project-owned providers together; checkout symlinks cannot test native provider resolution.
+
+## `npm install --ignore-scripts --no-audit --no-fund`
+
+
+## `npm install --prefix legacy --ignore-scripts --no-audit --no-fund`
+
+
+## `vpt cp -r src legacy`
+
+
+## `node verify.mjs`
+
+```
+v8: matching provider, shared runner, covered/untested files, and exclusion passed
+v8: aggregate glob threshold passes; perFile rejects the untested file
+istanbul: matching provider, shared runner, covered/untested files, and exclusion passed
+istanbul: aggregate glob threshold passes; perFile rejects the untested file
+Vitest v4/v5 coverage file sets match: src/covered.js, src/untested.js
+Istanbul provider uses the final @vitest/istanbul-lib-* graph
+Mismatched provider rejected before tests run
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/covered.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/covered.js
new file mode 100644
index 0000000000..86bc41cc44
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/covered.js
@@ -0,0 +1 @@
+export function sum(a, b) { return a + b; }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/ignored.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/ignored.js
new file mode 100644
index 0000000000..d7b0b4498d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/ignored.js
@@ -0,0 +1 @@
+export function ignored() { return 'excluded'; }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/untested.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/untested.js
new file mode 100644
index 0000000000..b78823d289
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/src/untested.js
@@ -0,0 +1 @@
+export function untested() { return 'not called'; }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/threshold.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/threshold.config.js
new file mode 100644
index 0000000000..0daddd907f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/threshold.config.js
@@ -0,0 +1,13 @@
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({ test: {
+  include: ['coverage.test.js'],
+  coverage: {
+    enabled: true,
+    provider: process.env.COVERAGE_PROVIDER,
+    reporter: [],
+    include: ['src/**'],
+    exclude: ['src/ignored.js'],
+    thresholds: { 'src/**': { perFile: process.env.PER_FILE === 'true', lines: 50 } },
+  },
+} });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/verify.mjs
new file mode 100644
index 0000000000..0d1270a5f0
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_coverage/verify.mjs
@@ -0,0 +1,74 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { relative, resolve } from 'node:path';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+
+const readJson = (file) => JSON.parse(readFileSync(file, 'utf8'));
+const expectedFiles = ['src/covered.js', 'src/untested.js'];
+const files = (map, root = process.cwd()) => Object.keys(map).map((file) => relative(root, file).replaceAll('\\', '/')).sort();
+const config = (provider) => defineConfig({ test: {
+  include: ['coverage.test.js'],
+  coverage: {
+    enabled: true, provider, reporter: ['json'],
+    include: ['src/**'], exclude: ['src/ignored.js'],
+    reportsDirectory: `output/${provider}`,
+    thresholds: { perFile: true, 'src/**': { perFile: true, lines: 0 } },
+  },
+} });
+for (const provider of ['v8', 'istanbul']) {
+  const runner = await createVitest({ config: false, watch: false, reporters: [] }, config(provider));
+  try {
+    assert.equal(runner.config.coverage.thresholds['src/**'].perFile, true);
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    assert.equal(runner.state.getCountOfFailedTests(), 0);
+    const map = readJson(`output/${provider}/coverage-final.json`);
+    assert.deepEqual(files(map), expectedFiles);
+    assert.ok(Object.values(map[resolve('src/covered.js')].s).some((hits) => hits > 0));
+    assert.ok(Object.values(map[resolve('src/untested.js')].s).every((hits) => hits === 0));
+    console.log(`${provider}: matching provider, shared runner, covered/untested files, and exclusion passed`);
+  } finally { await runner.close(); }
+
+  for (const perFile of [false, true]) {
+    const threshold = spawnSync(process.execPath, ['node_modules/vite-plus/dist/bin.js', 'test', 'run', '--config', 'threshold.config.js'], {
+      encoding: 'utf8', env: { ...process.env, COVERAGE_PROVIDER: provider, PER_FILE: String(perFile) },
+    });
+    assert.equal(threshold.status, perFile ? 1 : 0, `${threshold.stdout}\n${threshold.stderr}`);
+    if (perFile) {
+      assert.match(`${threshold.stdout}\n${threshold.stderr}`, /untested\.js/);
+      assert.match(`${threshold.stdout}\n${threshold.stderr}`, /threshold/);
+    }
+  }
+  console.log(`${provider}: aggregate glob threshold passes; perFile rejects the untested file`);
+}
+
+const legacy = spawnSync(process.execPath, ['node_modules/vitest/vitest.mjs', 'run'], {
+  cwd: 'legacy', encoding: 'utf8', env: process.env,
+});
+assert.equal(legacy.status, 0, `${legacy.stdout}\n${legacy.stderr}`);
+const legacyFiles = files(readJson('legacy/coverage/coverage-final.json'), resolve('legacy'));
+assert.deepEqual(legacyFiles, expectedFiles);
+console.log('Vitest v4/v5 coverage file sets match: src/covered.js, src/untested.js');
+
+const require = createRequire(import.meta.url);
+const istanbul = readJson(require.resolve('@vitest/coverage-istanbul/package.json'));
+for (const name of ['coverage', 'instrument', 'report', 'source-maps']) {
+  assert.ok(istanbul.dependencies[`@vitest/istanbul-lib-${name}`]);
+}
+console.log('Istanbul provider uses the final @vitest/istanbul-lib-* graph');
+
+// Corrupt only this disposable install's provider metadata. The runner must
+// reject the mismatch before loading or executing the provider.
+const manifest = require.resolve('@vitest/coverage-v8/package.json');
+const before = readFileSync(manifest, 'utf8');
+try {
+  writeFileSync(manifest, JSON.stringify({ ...JSON.parse(before), version: '4.1.11' }));
+  await assert.rejects(
+    () => createVitest({ config: false, watch: false, reporters: [] }, config('v8')),
+    /coverage provider must match the test runner version/,
+  );
+  console.log('Mismatched provider rejected before tests run');
+} finally { writeFileSync(manifest, before); }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/identity.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/identity.test.js
new file mode 100644
index 0000000000..c9a2a3e61b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/identity.test.js
@@ -0,0 +1,12 @@
+import { expect, test, vi } from 'vite-plus/test';
+import { expect as rawExpect, vi as rawVi } from 'vitest';
+
+expect.extend({ toBeAnswer(received) { return { pass: received === 42, message: () => 'Expected 42' }; } });
+test('installed runner shares custom matchers and mock state', () => {
+  expect(rawExpect).toBe(expect);
+  expect(rawVi).toBe(vi);
+  rawExpect(42).toBeAnswer();
+  const mock = vi.fn();
+  mock();
+  rawExpect(mock).toHaveBeenCalledOnce();
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/package.json
new file mode 100644
index 0000000000..0ca0917ef3
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/package.json
@@ -0,0 +1,6 @@
+{
+  "name": "test-v5-install-managers",
+  "private": true,
+  "type": "module",
+  "devDependencies": { "vite-plus": "latest", "vitest": "5.0.0" }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots.toml
new file mode 100644
index 0000000000..d8c2bd0180
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots.toml
@@ -0,0 +1,60 @@
+[[case]]
+name = "npm_install_and_runtime"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "packageManager", "npm@10.9.4"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts", "--", "--no-audit", "--no-fund"], snapshot = false, timeout = 180000 },
+  ["vp", "test", "run"],
+]
+
+[[case]]
+name = "pnpm_install_and_runtime"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "packageManager", "pnpm@11.24.0"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  ["vp", "test", "run"],
+]
+
+[[case]]
+name = "bun_install_and_runtime"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "packageManager", "bun@1.3.11"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  ["vp", "test", "run"],
+]
+
+[[case]]
+name = "yarn_without_project_vite_or_vitest"
+vp = "global"
+local-registry = true
+env = { YARN_ENABLE_SCRIPTS = "0" }
+comment = "Install only vite-plus: its dependency graph must provide Vitest's Vite peer without a project Vite or Vitest dependency."
+steps = [
+  { argv = ["vpt", "write-file", "package.json", "{\"name\":\"test-v5-yarn-peer\",\"private\":true,\"type\":\"module\",\"packageManager\":\"yarn@4.12.0\",\"devDependencies\":{\"vite-plus\":\"latest\"}}\n"], snapshot = false },
+  { argv = ["vpt", "write-file", ".yarnrc.yml", "nodeLinker: node-modules\n"], snapshot = false },
+  { argv = ["vp", "install"], snapshot = false, timeout = 180000 },
+  ["node", "--input-type=module", "-e", "import assert from 'node:assert/strict'; import { createRequire } from 'node:module'; import { defineConfig } from 'vite-plus/test/config'; const require = createRequire(import.meta.resolve('vite-plus/package.json')); assert.equal(require('vite/package.json').name, '@voidzero-dev/vite-plus-core'); assert.equal(require('vite/package.json').version, require('@voidzero-dev/vite-plus-core/package.json').version); assert.equal(typeof defineConfig, 'function'); console.log('Vitest Vite peer uses the bundled core');"],
+  ["vp", "test", "run"],
+]
+
+[[case]]
+name = "yarn_pnp_conversion_and_runtime"
+vp = "global"
+local-registry = true
+unset-env = ["VP_SKIP_INSTALL"]
+env = { YARN_ENABLE_SCRIPTS = "0" }
+comment = "Vite+ does not support PnP; validate the documented conversion to node-modules before executing the v5 runner."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "packageManager", "yarn@4.12.0"], snapshot = false },
+  { argv = ["vpt", "write-file", ".yarnrc.yml", "nodeLinker: pnp\n"], snapshot = false },
+  { argv = ["vp", "install"], snapshot = false, timeout = 180000 },
+  ["vpt", "stat-file", ".pnp.cjs", "--assert", "file"],
+  { argv = ["vp", "migrate", "--no-interactive", "--no-hooks", "--no-agent", "--no-editor"], timeout = 180000 },
+  ["vpt", "print-file", ".yarnrc.yml"],
+  ["vp", "test", "run"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/bun_install_and_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/bun_install_and_runtime.md
new file mode 100644
index 0000000000..b5d5a67281
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/bun_install_and_runtime.md
@@ -0,0 +1,23 @@
+# bun_install_and_runtime
+
+## `vpt json-edit package.json packageManager bun@1.3.11`
+
+
+## `vp install --ignore-scripts`
+
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/npm_install_and_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/npm_install_and_runtime.md
new file mode 100644
index 0000000000..2475093f1c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/npm_install_and_runtime.md
@@ -0,0 +1,23 @@
+# npm_install_and_runtime
+
+## `vpt json-edit package.json packageManager npm@10.9.4`
+
+
+## `vp install --ignore-scripts -- --no-audit --no-fund`
+
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/pnpm_install_and_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/pnpm_install_and_runtime.md
new file mode 100644
index 0000000000..7fd00770cf
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/pnpm_install_and_runtime.md
@@ -0,0 +1,23 @@
+# pnpm_install_and_runtime
+
+## `vpt json-edit package.json packageManager pnpm@11.24.0`
+
+
+## `vp install --ignore-scripts`
+
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_pnp_conversion_and_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_pnp_conversion_and_runtime.md
new file mode 100644
index 0000000000..838becb802
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_pnp_conversion_and_runtime.md
@@ -0,0 +1,72 @@
+# yarn_pnp_conversion_and_runtime
+
+Vite+ does not support PnP; validate the documented conversion to node-modules before executing the v5 runner.
+
+## `vpt json-edit package.json packageManager yarn@4.12.0`
+
+
+## `vpt write-file .yarnrc.yml 'nodeLinker: pnp
+'`
+
+
+## `vp install`
+
+
+## `vpt stat-file .pnp.cjs --assert file`
+
+```
+.pnp.cjs: file
+```
+
+## `vp migrate --no-interactive --no-hooks --no-agent --no-editor`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+⚠ Vite+ does not currently support Yarn Plug'n'Play (PnP).
+
+✔ Switched Yarn to node-modules mode
+
+Formatting code...
+
+Code formatted
+◇ Updated . to Vite+ <version>
+• Node <version>  yarn <version>
+• Dependencies:
+    vite-plus  latest → <version>
+    vite              → <version>
+✓ Dependencies installed in <duration>
+• 1 file had imports rewritten
+• Package manager settings configured
+```
+
+## `vpt print-file .yarnrc.yml`
+
+```
+nodeLinker: node-modules
+npmPreapprovedPackages:
+  - vitest
+  - "@vitest/*"
+catalog:
+  vite: npm:@voidzero-dev/vite-plus-core@<version>
+  vitest: <version>
+  vite-plus: <version>
+  "@vitest/browser-webdriverio": ^5.0.0-beta.5 || >=5.0.0
+  "@vitest/browser-playwright": <version>
+```
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_without_project_vite_or_vitest.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_without_project_vite_or_vitest.md
new file mode 100644
index 0000000000..453a208fa5
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/snapshots/yarn_without_project_vite_or_vitest.md
@@ -0,0 +1,36 @@
+# yarn_without_project_vite_or_vitest
+
+Install only vite-plus: its dependency graph must provide Vitest's Vite peer without a project Vite or Vitest dependency.
+
+## `vpt write-file package.json '{"name":"test-v5-yarn-peer","private":true,"type":"module","packageManager":"yarn@4.12.0","devDependencies":{"vite-plus":"latest"}}
+'`
+
+
+## `vpt write-file .yarnrc.yml 'nodeLinker: node-modules
+'`
+
+
+## `vp install`
+
+
+## `node --input-type=module -e 'import assert from '\''node:assert/strict'\''; import { createRequire } from '\''node:module'\''; import { defineConfig } from '\''vite-plus/test/config'\''; const require = createRequire(import.meta.resolve('\''vite-plus/package.json'\'')); assert.equal(require('\''vite/package.json'\'').name, '\''@voidzero-dev/vite-plus-core'\''); assert.equal(require('\''vite/package.json'\'').version, require('\''@voidzero-dev/vite-plus-core/package.json'\'').version); assert.equal(typeof defineConfig, '\''function'\''); console.log('\''Vitest Vite peer uses the bundled core'\'');'`
+
+```
+Vitest Vite peer uses the bundled core
+```
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓ identity.test.js (1 test) <duration>
+   ✓ installed runner shares custom matchers and mock state <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/vite.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/vite.config.js
new file mode 100644
index 0000000000..80b08a60e0
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_install_managers/vite.config.js
@@ -0,0 +1,2 @@
+import { defineConfig } from 'vite-plus';
+export default defineConfig({ test: { include: ['identity.test.js'] } });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/benchmark.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/benchmark.test.js
new file mode 100644
index 0000000000..5902b5035e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/benchmark.test.js
@@ -0,0 +1,10 @@
+import { expect, test } from 'vite-plus/test';
+
+test('bench is a test-context fixture', async ({ bench }) => {
+  let calls = 0;
+  const result = await bench('sum', () => { calls++; return 20 + 22; }).run({
+    iterations: 1, time: 1, warmup: false,
+  });
+  expect(calls).toBeGreaterThan(0);
+  expect(result.name).toBe('sum');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/dynamic.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/dynamic.test.js
new file mode 100644
index 0000000000..1ada27dbf7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/dynamic.test.js
@@ -0,0 +1,6 @@
+import { writeFileSync } from 'node:fs';
+import { test, expect } from 'vite-plus/test';
+
+writeFileSync('collection-ran.txt', 'collected');
+const register = (name) => test(name, () => expect(true).toBe(true));
+register('generated at collection time');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/package.json
new file mode 100644
index 0000000000..ffed0dd235
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/package.json
@@ -0,0 +1,5 @@
+{
+  "name": "test-v5-node-apis",
+  "private": true,
+  "type": "module"
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/runtime.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/runtime.test.js
new file mode 100644
index 0000000000..2f5dbed6e6
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/runtime.test.js
@@ -0,0 +1,24 @@
+import { test, expect, vi, recordArtifact } from 'vite-plus/test';
+import { writeFileSync } from 'node:fs';
+
+test('one-based worker identifiers', () => {
+  expect(Number(process.env.VITEST_POOL_ID)).toBeGreaterThanOrEqual(1);
+  expect(Number(process.env.VITEST_WORKER_ID)).toBeGreaterThanOrEqual(1);
+});
+
+test('class mocks preserve their implementation prototype', () => {
+  class Service { value() { return 42; } }
+  const MockService = vi.fn(Service);
+  const instance = new MockService();
+  expect(instance).toBeInstanceOf(Service);
+  expect(instance.value()).toBe(42);
+});
+
+test('annotations and custom artifacts', async ({ annotate, task }) => {
+  writeFileSync('attachment.txt', 'v5 attachment content');
+  await annotate('plain-text attachment', {
+    path: 'attachment.txt',
+    contentType: 'text/plain',
+  });
+  await recordArtifact(task, { type: 'fixture:identity', value: 42 });
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots.toml
new file mode 100644
index 0000000000..fa50158377
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots.toml
@@ -0,0 +1,14 @@
+[[case]]
+name = "node_api_and_reports"
+vp = "local"
+steps = [{ argv = ["node", "verify.mjs"], timeout = 120000 }]
+
+[[case]]
+name = "list_static_and_runtime_collection"
+vp = "local"
+steps = [
+  ["vp", "test", "list", "dynamic.test.js", "--json"],
+  ["vpt", "stat-file", "collection-ran.txt", "--assert", "missing"],
+  ["vp", "test", "list", "dynamic.test.js", "--no-static-parse", "--json"],
+  ["vpt", "stat-file", "collection-ran.txt", "--assert", "file"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/list_static_and_runtime_collection.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/list_static_and_runtime_collection.md
new file mode 100644
index 0000000000..1c0ba7fe1f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/list_static_and_runtime_collection.md
@@ -0,0 +1,39 @@
+# list_static_and_runtime_collection
+
+## `vp test list dynamic.test.js --json`
+
+```
+[
+  {
+    "name": "name",
+    "file": "<workspace>/dynamic.test.js",
+    "location": {
+      "line": 5,
+      "column": 28
+    }
+  }
+]
+```
+
+## `vpt stat-file collection-ran.txt --assert missing`
+
+```
+collection-ran.txt: missing
+```
+
+## `vp test list dynamic.test.js --no-static-parse --json`
+
+```
+[
+  {
+    "name": "generated at collection time",
+    "file": "<workspace>/dynamic.test.js"
+  }
+]
+```
+
+## `vpt stat-file collection-ran.txt --assert file`
+
+```
+collection-ran.txt: file
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/node_api_and_reports.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/node_api_and_reports.md
new file mode 100644
index 0000000000..b5daa7b25d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/snapshots/node_api_and_reports.md
@@ -0,0 +1,15 @@
+# node_api_and_reports
+
+## `node verify.mjs`
+
+```
+resolveConfig returns Vite config with .test and integration plugins
+collect staticParse=true: collection side effects skipped
+collect staticParse=false: collection side effects executed
+JSON report written to <workspace>/.vitest/json/output.json
+blob report written to <workspace>/.vitest/blob/blob.json
+JUNIT report written to <workspace>/.vitest/junit/output.xml
+JSON, JUnit, blob, attachments, artifacts, worker IDs, class mock prototypes, and the bench fixture passed
+JSON report written to <workspace>/merged.json
+blob merge preserved all four test results
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/verify.mjs
new file mode 100644
index 0000000000..c824be79cd
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_node_apis/verify.mjs
@@ -0,0 +1,65 @@
+import assert from 'node:assert/strict';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { defineConfig } from 'vite-plus';
+import { createVitest, resolveConfig } from 'vite-plus/test/node';
+
+const base = { config: false, watch: false, reporters: [] };
+const resolved = await resolveConfig(base, defineConfig({ test: { clearMocks: false } }));
+assert.equal(resolved.test.clearMocks, false);
+assert.ok(resolved.plugins.some(({ name }) => name === 'vite-plus:vitest-resolver'));
+console.log('resolveConfig returns Vite config with .test and integration plugins');
+
+for (const staticParse of [true, false]) {
+  const runner = await createVitest({ ...base, include: ['dynamic.test.js'] }, defineConfig({}));
+  try {
+    const result = await runner.collect([], { staticParse });
+    assert.equal(result.unhandledErrors.length, 0);
+    assert.equal(existsSync('collection-ran.txt'), !staticParse);
+    const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+    if (!staticParse) assert.deepEqual(tasks.map(({ name }) => name), ['generated at collection time']);
+    console.log(`collect staticParse=${staticParse}: collection side effects ${staticParse ? 'skipped' : 'executed'}`);
+  } finally {
+    await runner.close();
+  }
+}
+
+const runner = await createVitest({
+  ...base,
+  include: ['runtime.test.js'],
+  benchmark: { enabled: true, include: ['benchmark.test.js'] },
+  reporters: ['json', 'junit', 'blob'],
+}, defineConfig({}));
+try {
+  const result = await runner.start();
+  assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+  assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().flatMap((file) => [file.result, ...file.tasks.map((task) => ({ name: task.name, result: task.result }))])));
+  const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+  assert.equal(tasks.length, 4);
+  assert.equal(runner.mode, 'test');
+  const artifacts = tasks.flatMap((task) => task.artifacts ?? []);
+  assert.ok(artifacts.some(({ type }) => type === 'fixture:identity'));
+  const attachment = tasks.flatMap((task) => task.annotations).find(({ attachment }) => attachment)?.attachment;
+  assert.ok(attachment?.path.includes('.vitest/attachments/'));
+  assert.equal(readFileSync(attachment.path, 'utf8'), 'v5 attachment content');
+} finally {
+  await runner.close();
+}
+
+const reports = '.vitest';
+const json = JSON.parse(readFileSync(join(reports, 'json/output.json'), 'utf8'));
+assert.equal(json.numPassedTests, 4);
+assert.equal(json.numFailedTests, 0);
+assert.match(readFileSync(join(reports, 'junit/output.xml'), 'utf8'), /tests="4"/);
+assert.equal(readdirSync(join(reports, 'blob')).filter((file) => file.endsWith('.json')).length, 1);
+console.log('JSON, JUnit, blob, attachments, artifacts, worker IDs, class mock prototypes, and the bench fixture passed');
+
+const merged = await createVitest({ ...base, reporters: [['json', { outputFile: 'merged.json' }]] }, defineConfig({}));
+try {
+  const result = await merged.mergeReports(join(reports, 'blob'));
+  assert.equal(result.unhandledErrors.length, 0);
+  assert.equal(JSON.parse(readFileSync('merged.json', 'utf8')).numPassedTests, 4);
+  console.log('blob merge preserved all four test results');
+} finally {
+  await merged.close();
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom-environment.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom-environment.js
new file mode 100644
index 0000000000..092dd4d66b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom-environment.js
@@ -0,0 +1,19 @@
+import assert from 'node:assert/strict';
+import { populateGlobal } from 'vite-plus/test/runtime';
+
+export default {
+  name: 'descriptor-environment',
+  viteEnvironment: 'ssr',
+  setup(global) {
+    const target = {};
+    const getter = () => { throw new Error('The original getter must not run'); };
+    Object.defineProperty(target, 'probe', { get: getter, configurable: true });
+    const { originals } = populateGlobal(target, { probe: 42 }, { additionalKeys: ['probe'] });
+    assert.equal(target.probe, 42);
+    assert.equal(originals.get('probe').get, getter);
+    Object.defineProperty(target, 'probe', originals.get('probe'));
+    assert.equal(Object.getOwnPropertyDescriptor(target, 'probe').get, getter);
+    global.__descriptorCheck = true;
+    return { teardown() { delete global.__descriptorCheck; } };
+  },
+};
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom.test.js
new file mode 100644
index 0000000000..4d9226371a
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/custom.test.js
@@ -0,0 +1,4 @@
+import { expect, test } from 'vite-plus/test';
+test('custom environment restores property descriptors without invoking getters', () => {
+  expect(globalThis.__descriptorCheck).toBe(true);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/happy-dom.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/happy-dom.test.js
new file mode 100644
index 0000000000..c83cc8aef7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/happy-dom.test.js
@@ -0,0 +1,8 @@
+import { expect, test } from 'vite-plus/test';
+
+test('DOM assignment affects happy-dom matchMedia', () => {
+  globalThis.innerWidth = 412;
+  expect(matchMedia('(max-width: 500px)').matches).toBe(true);
+  globalThis.innerWidth = 812;
+  expect(matchMedia('(max-width: 500px)').matches).toBe(false);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/jsdom.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/jsdom.test.js
new file mode 100644
index 0000000000..83b481d111
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/jsdom.test.js
@@ -0,0 +1,10 @@
+import { expect, test } from 'vite-plus/test';
+import { expect as rawExpect } from 'vitest';
+
+test('DOM assignment reaches the jsdom window and shares assertion state', () => {
+  expect(expect).toBe(rawExpect);
+  globalThis.innerWidth = 412;
+  expect(jsdom.window.innerWidth).toBe(412);
+  document.body.innerHTML = '<p>jsdom</p>';
+  expect(document.querySelector('p').textContent).toBe('jsdom');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/package.json
new file mode 100644
index 0000000000..b5f5758d6b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/package.json
@@ -0,0 +1,12 @@
+{
+  "name": "test-v5-optional-packages",
+  "private": true,
+  "type": "module",
+  "devDependencies": {
+    "vite-plus": "latest",
+    "@vitest/ui": "5.0.0",
+    "jsdom": "27.2.0",
+    "happy-dom": "20.0.10",
+    "temporal-polyfill": "1.0.4"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots.toml
new file mode 100644
index 0000000000..1b78132f11
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots.toml
@@ -0,0 +1,11 @@
+[[case]]
+name = "environments_temporal_html_and_worker_startup"
+vp = "global"
+local-registry = true
+steps = [
+  { argv = ["npm", "install", "--ignore-scripts", "--no-audit", "--no-fund"], snapshot = false, timeout = 120000 },
+  { argv = ["vp", "test", "run", "--reporter=default", "--reporter=html", "--maxWorkers=1"], timeout = 120000 },
+  { argv = ["vpt", "stat-file", ".vitest/index.html", "--assert", "file"] },
+  { argv = ["node", "verify-ui.mjs"], timeout = 120000 },
+  { argv = ["node", "verify-worker.mjs"], timeout = 120000, comment = "A failed worker must produce a controlled diagnostic and a nonzero exit status." },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots/environments_temporal_html_and_worker_startup.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots/environments_temporal_html_and_worker_startup.md
new file mode 100644
index 0000000000..5c4d285f13
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/snapshots/environments_temporal_html_and_worker_startup.md
@@ -0,0 +1,48 @@
+# environments_temporal_html_and_worker_startup
+
+## `npm install --ignore-scripts --no-audit --no-fund`
+
+
+## `vp test run --reporter=default --reporter=html --maxWorkers=1`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+ RUN  <version> <workspace>
+
+ ✓  custom  custom.test.js (1 test) <duration>
+ ✓  happy-dom  happy-dom.test.js (1 test) <duration>
+ ✓  jsdom  jsdom.test.js (1 test) <duration>
+ ✓  temporal  temporal.test.js (3 tests) <duration>
+
+ Test Files  4 passed (4)
+      Tests  6 passed (6)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+
+ HTML  Report is generated
+       You can run npx vite preview --outDir .vitest to see the test results.
+```
+
+## `vpt stat-file .vitest/index.html --assert file`
+
+```
+.vitest/index.html: file
+```
+
+## `node verify-ui.mjs`
+
+```
+UI rejects a bare URL, accepts its token, and serves the clean URL with an authenticated cookie
+```
+
+## `node verify-worker.mjs`
+
+A failed worker must produce a controlled diagnostic and a nonzero exit status.
+
+**Exit code:** 1
+
+```
+Vitest caught 1 unhandled error during the test run.
+Worker exited unexpectedly with exit code 9 during starting state
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/temporal.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/temporal.test.js
new file mode 100644
index 0000000000..0a391c4928
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/temporal.test.js
@@ -0,0 +1,26 @@
+import { afterEach, expect, test, vi } from 'vite-plus/test';
+
+afterEach(() => vi.useRealTimers());
+
+test('new defaults mock Temporal with fake timers', () => {
+  const now = Temporal.Now.instant;
+  vi.useFakeTimers();
+  vi.setSystemTime(1234);
+  expect(Temporal.Now.instant).not.toBe(now);
+  expect(Temporal.Now.instant().epochMilliseconds).toBe(1234);
+});
+
+test('migrated toNotFake preserves Temporal while fake timers run', () => {
+  const now = Temporal.Now.instant;
+  vi.useFakeTimers({ toNotFake: ['Temporal'] });
+  vi.setSystemTime(1234);
+  expect(Temporal.Now.instant).toBe(now);
+  // The polyfill can still read mocked Date internally; toNotFake preserves
+  // its implementation, not every transitive source of wall-clock time.
+});
+
+test('setSystemTime also mocks Temporal without fake timers', () => {
+  vi.setSystemTime(2345);
+  expect(vi.isFakeTimers()).toBe(false);
+  expect(Temporal.Now.instant().epochMilliseconds).toBe(2345);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-ui.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-ui.mjs
new file mode 100644
index 0000000000..27ac337d1e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-ui.mjs
@@ -0,0 +1,26 @@
+import assert from 'node:assert/strict';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+
+const runner = await createVitest({
+  config: false, watch: false, reporters: [], ui: true, open: false,
+  api: { host: '127.0.0.1', port: 0 },
+}, defineConfig({}));
+try {
+  if (!runner.vite.httpServer.listening) await runner.vite.listen(0);
+  const base = `http://127.0.0.1:${runner.vite.httpServer.address().port}`;
+  const ui = new URL(runner.config.uiBase, base);
+  assert.equal((await fetch(ui)).status, 403);
+  ui.searchParams.set('token', runner.config.api.token);
+  const authenticated = await fetch(ui, { redirect: 'manual' });
+  assert.equal(authenticated.status, 302);
+  const cookie = authenticated.headers.get('set-cookie');
+  assert.match(cookie, /HttpOnly/);
+  assert.match(cookie, /SameSite=Strict/i);
+  const clean = new URL(authenticated.headers.get('location'), base);
+  assert.equal(clean.search, '');
+  const page = await fetch(clean, { headers: { cookie } });
+  assert.equal(page.status, 200);
+  assert.ok((await page.text()).includes(JSON.stringify(runner.config.api.token)));
+  console.log('UI rejects a bare URL, accepts its token, and serves the clean URL with an authenticated cookie');
+} finally { await runner.close(); }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-worker.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-worker.mjs
new file mode 100644
index 0000000000..432a692da7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/verify-worker.mjs
@@ -0,0 +1,15 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+
+const result = spawnSync(process.execPath, ['node_modules/vite-plus/dist/bin.js', 'test', 'run', '--config', 'worker-failure.config.js'], {
+  encoding: 'utf8', env: process.env,
+});
+assert.equal(result.status, 1, `${result.stdout}\n${result.stderr}`);
+const output = `${result.stdout}\n${result.stderr}`;
+assert.match(output, /bad option: --vitest-invalid-worker-option/);
+assert.match(output, /Worker exited unexpectedly with exit code 9 during starting state/);
+assert.match(output, /Vitest caught 1 unhandled error/);
+// Keep the actual diagnostic and status; omit OS-specific Node paths and stacks.
+console.log('Vitest caught 1 unhandled error during the test run.');
+console.log(output.match(/Worker exited unexpectedly with exit code 9 during starting state/)[0]);
+process.exitCode = result.status;
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/vite.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/vite.config.js
new file mode 100644
index 0000000000..47f6de7690
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/vite.config.js
@@ -0,0 +1,10 @@
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({ test: {
+  projects: [
+    { test: { name: 'jsdom', environment: 'jsdom', include: ['jsdom.test.js'] } },
+    { test: { name: 'happy-dom', environment: 'happy-dom', include: ['happy-dom.test.js'] } },
+    { test: { name: 'temporal', setupFiles: ['temporal-polyfill/global'], include: ['temporal.test.js'] } },
+    { test: { name: 'custom', environment: './custom-environment.js', include: ['custom.test.js'] } },
+  ],
+} });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/worker-failure.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/worker-failure.config.js
new file mode 100644
index 0000000000..198d46d385
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_optional_packages/worker-failure.config.js
@@ -0,0 +1,6 @@
+import { defineConfig } from 'vite-plus';
+export default defineConfig({ test: {
+  pool: 'forks',
+  execArgv: ['--vitest-invalid-worker-option'],
+  include: ['custom.test.js'],
+} });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/package.json
new file mode 100644
index 0000000000..42e24bd2ff
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/package.json
@@ -0,0 +1,5 @@
+{
+  "name": "test-v5-parent-config",
+  "private": true,
+  "type": "module"
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots.toml
new file mode 100644
index 0000000000..3f1486e2a8
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots.toml
@@ -0,0 +1,11 @@
+[[case]]
+name = "diagnostic"
+vp = ["local", "global"]
+cwd = "sub"
+steps = [["vp", "test", "run"]]
+
+[[case]]
+name = "explicit_config"
+vp = "local"
+cwd = "sub"
+steps = [["vp", "test", "run", "--config", "../vite.config.ts", "--dir", "."]]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/diagnostic.global.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/diagnostic.global.md
new file mode 100644
index 0000000000..e93be44fe2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/diagnostic.global.md
@@ -0,0 +1,20 @@
+# diagnostic
+
+## `vp test run`
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+warn: No test config was found in this directory.
+A config exists at ../vite.config.ts. Run `vp test --config ../vite.config.ts --dir .`.
+
+ RUN  <version> <workspace>/sub
+
+ ✓ example.test.ts (1 test) <duration>
+   ✓ runs in the selected directory <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/diagnostic.local.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/diagnostic.local.md
new file mode 100644
index 0000000000..dabd8179fa
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/diagnostic.local.md
@@ -0,0 +1,18 @@
+# diagnostic
+
+## `vp test run`
+
+```
+warn: No test config was found in this directory.
+A config exists at ../vite.config.ts. Run `vp test --config ../vite.config.ts --dir .`.
+
+ RUN  <version> <workspace>/sub
+
+ ✓ example.test.ts (1 test) <duration>
+   ✓ runs in the selected directory <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/explicit_config.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/explicit_config.md
new file mode 100644
index 0000000000..72bec25bd4
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/snapshots/explicit_config.md
@@ -0,0 +1,16 @@
+# explicit_config
+
+## `vp test run --config ../vite.config.ts --dir .`
+
+```
+
+ RUN  <version> <workspace>/sub
+
+ ✓  parent  example.test.ts (1 test) <duration>
+   ✓ runs in the selected directory <duration>
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  <time>
+   Duration  <duration> (<timing>)
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/sub/example.test.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/sub/example.test.ts
new file mode 100644
index 0000000000..46103006bf
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/sub/example.test.ts
@@ -0,0 +1,5 @@
+import { expect, test } from 'vite-plus/test';
+
+test('runs in the selected directory', () => {
+  expect(2 + 2).toBe(4);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/vite.config.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/vite.config.ts
new file mode 100644
index 0000000000..f06c3d680c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_parent_config/vite.config.ts
@@ -0,0 +1,3 @@
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({ test: { name: 'parent' } });
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/browser.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/browser.test.js
new file mode 100644
index 0000000000..1e3b7e0da4
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/browser.test.js
@@ -0,0 +1,28 @@
+import { expect, test, vi } from 'vite-plus/test';
+import { expect as upstreamExpect } from 'vitest';
+import { page } from 'vite-plus/test/browser';
+import { page as compatibilityPage } from 'vite-plus/test/browser/context';
+import { page as providerPage } from 'vite-plus/test/browser-preview/context';
+import { page as bareContextPage } from 'vite-plus/test/context';
+import { page as pluginPage } from 'vite-plus/test/plugins/browser-context';
+import { page as providerAliasPage } from 'vite-plus/test/browser/providers/preview/context';
+
+test('Preview shares runtime and browser context across public entry points', async () => {
+  expect(expect).toBe(upstreamExpect);
+  expect(page).toBe(compatibilityPage);
+  expect(page).toBe(providerPage);
+  expect(page).toBe(bareContextPage);
+  expect(page).toBe(pluginPage);
+  expect(page).toBe(providerAliasPage);
+  document.body.innerHTML = '<button type="button">Increment</button><output>0</output>';
+  document.querySelector('button').addEventListener('click', () => { document.querySelector('output').textContent = '1'; });
+  // Vitest 5.0.0 Preview always calls advanceTimers, even with real timers.
+  // The separate upstream_real_timers case records that release blocker.
+  vi.useFakeTimers({ toFake: ['setTimeout', 'clearTimeout'] });
+  try {
+    await page.getByRole('button', { name: 'Increment' }).click();
+  } finally {
+    vi.useRealTimers();
+  }
+  await expect.element(page.getByRole('status')).toHaveTextContent('1');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/defines.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/defines.test.js
new file mode 100644
index 0000000000..15a0c848aa
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/defines.test.js
@@ -0,0 +1,9 @@
+import { expect, test } from 'vite-plus/test';
+
+test('browser global string define', () => {
+  expect(globalThis['__VP_STRING_DEFINE__']).toBe('/messages');
+});
+
+test('browser global boolean define', () => {
+  expect(globalThis['__VP_BOOL_DEFINE__']).toBe(false);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/package.json
new file mode 100644
index 0000000000..2c54206a43
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/package.json
@@ -0,0 +1 @@
+{"name":"vitest-v5-preview","private":true,"type":"module"}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots.toml
new file mode 100644
index 0000000000..5fd85a99ea
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots.toml
@@ -0,0 +1,19 @@
+[[case]]
+name = "preview_runtime"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+steps = [{ argv = ["node", "verify.mjs"], timeout = 120000 }]
+
+[[case]]
+name = "upstream_real_timers"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+comment = "Known upstream Vitest 5.0.0 release blocker, also reproduced without Vite+: Preview locator clicks call advanceTimers with real timers. Remove this expected-failure assertion when upstream is fixed."
+steps = [{ argv = ["node", "verify.mjs", "--real-timers"], timeout = 120000 }]
+
+[[case]]
+name = "upstream_browser_defines"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+comment = "Known upstream Vitest 5.0.0 release blocker, also reproduced without Vite+: browser globals receive JSON-encoded define values. Remove this expected-failure assertion when upstream is fixed."
+steps = [{ argv = ["node", "verify.mjs", "--browser-defines"], timeout = 120000 }]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/preview_runtime.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/preview_runtime.md
new file mode 100644
index 0000000000..9407a8715c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/preview_runtime.md
@@ -0,0 +1,9 @@
+# preview_runtime
+
+## `node verify.mjs`
+
+```
+Browser runner started at http://localhost:<port>/__vitest_test__/?sessionId=<uuid>
+
+Preview: runtime identity, browser export aliases, fake-timer locator clicks, and async assertions passed
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_browser_defines.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_browser_defines.md
new file mode 100644
index 0000000000..2ad7a60290
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_browser_defines.md
@@ -0,0 +1,11 @@
+# upstream_browser_defines
+
+Known upstream Vitest 5.0.0 release blocker, also reproduced without Vite+: browser globals receive JSON-encoded define values. Remove this expected-failure assertion when upstream is fixed.
+
+## `node verify.mjs --browser-defines`
+
+```
+Browser runner started at http://localhost:<port>/__vitest_test__/?sessionId=<uuid>
+
+Release blocker reproduced: upstream Vitest 5.0.0 browser globals retain JSON-encoded define values
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_real_timers.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_real_timers.md
new file mode 100644
index 0000000000..0d93b0ea96
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/snapshots/upstream_real_timers.md
@@ -0,0 +1,11 @@
+# upstream_real_timers
+
+Known upstream Vitest 5.0.0 release blocker, also reproduced without Vite+: Preview locator clicks call advanceTimers with real timers. Remove this expected-failure assertion when upstream is fixed.
+
+## `node verify.mjs --real-timers`
+
+```
+Browser runner started at http://localhost:<port>/__vitest_test__/?sessionId=<uuid>
+
+Release blocker reproduced: upstream Vitest 5.0.0 Preview locator clicks fail with real timers
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/upstream.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/upstream.test.js
new file mode 100644
index 0000000000..dfec0412c8
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/upstream.test.js
@@ -0,0 +1,7 @@
+import { test } from 'vitest';
+import { page } from 'vitest/browser';
+
+test('Preview locator clicks with real timers', async () => {
+  document.body.innerHTML = '<button>Click</button>';
+  await page.getByRole('button', { name: 'Click' }).click();
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/verify.mjs
new file mode 100644
index 0000000000..d9f1fc5113
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_preview/verify.mjs
@@ -0,0 +1,66 @@
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+import { preview } from 'vite-plus/test/browser-preview';
+
+// Automate Preview's normal manually opened page, without replacing its
+// locator implementation or opening the developer's default browser.
+const require = createRequire(import.meta.resolve('vite-plus/package.json'));
+const { chromium } = require('playwright');
+const browser = await chromium.launch({ headless: true });
+const tab = await browser.newPage();
+const provider = preview();
+const realTimers = process.argv.includes('--real-timers');
+const browserDefines = process.argv.includes('--browser-defines');
+const createProvider = provider.providerFactory;
+provider.providerFactory = (project) => {
+  const instance = createProvider(project);
+  const openPage = instance.openPage.bind(instance);
+  instance.openPage = async (session, url) => {
+    project.browser.vite.openBrowser = () => {};
+    await openPage(session, url);
+    await tab.goto(url);
+  };
+  return instance;
+};
+let runner;
+try {
+  runner = await createVitest({ config: false, watch: false, reporters: [] }, defineConfig({
+    ...(browserDefines ? { define: { __VP_STRING_DEFINE__: JSON.stringify('/messages'), __VP_BOOL_DEFINE__: 'false' } } : {}),
+    test: {
+      include: [browserDefines ? 'defines.test.js' : realTimers ? 'upstream.test.js' : 'browser.test.js'],
+      browser: { enabled: true, provider, headless: false, instances: [{ browser: 'chromium' }] },
+    },
+  }));
+  const result = await runner.start();
+  assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+  assert.equal(runner.state.getFiles().length, 1);
+  if (browserDefines) {
+    const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+    assert.equal(tasks.length, 2);
+    for (const task of tasks) {
+      assert.equal(task.result.state, 'fail');
+      assert.match(task.result.errors[0].message, /Object.is equality/);
+    }
+    assert.match(tasks[0].result.errors[0].message, /messages/);
+    assert.match(tasks[1].result.errors[0].message, /false/);
+    console.log('Release blocker reproduced: upstream Vitest 5.0.0 browser globals retain JSON-encoded define values');
+    process.exitCode = 0;
+  } else if (realTimers) {
+    const tasks = runner.state.getFiles().flatMap((file) => file.tasks);
+    assert.equal(tasks.length, 1);
+    assert.equal(tasks[0].result.state, 'fail');
+    assert.match(tasks[0].result.errors[0].message, /timers APIs are not mocked/);
+    console.log('Release blocker reproduced: upstream Vitest 5.0.0 Preview locator clicks fail with real timers');
+    // The assertion above deliberately verifies an upstream failure. Do not
+    // treat this case as evidence that the Preview release gate passed.
+    process.exitCode = 0;
+  } else {
+    assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().flatMap((file) => [file.result, ...file.tasks.map((task) => task.result)])));
+    console.log('Preview: runtime identity, browser export aliases, fake-timer locator clicks, and async assertions passed');
+  }
+} finally {
+  await runner?.close();
+  await browser.close();
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/identity.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/identity.test.js
new file mode 100644
index 0000000000..d2be81cc76
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/identity.test.js
@@ -0,0 +1,11 @@
+import { expect, inject, test, vi } from 'vite-plus/test';
+import { expect as upstreamExpect, vi as upstreamVi } from 'vitest';
+import { matcherExpect } from 'jest-extended';
+
+test('runner, public imports, and external matchers share assertion state', () => {
+  expect(upstreamExpect).toBe(expect);
+  expect(matcherExpect).toBe(expect);
+  expect(upstreamVi).toBe(vi);
+  expect(inject('value')).toEqual(expect.any(String));
+  expect('shared').toHaveSharedState();
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/package.json
new file mode 100644
index 0000000000..e8593b9e8f
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/package.json
@@ -0,0 +1,5 @@
+{
+  "name": "vitest-v5-projects",
+  "private": true,
+  "type": "module"
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots.toml
new file mode 100644
index 0000000000..aa6b615964
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots.toml
@@ -0,0 +1,9 @@
+[[case]]
+name = "project_runtime_matrix"
+vp = "local"
+steps = [
+  { argv = ["vpt", "mkdir", "-p", "node_modules"], snapshot = false },
+  { argv = ["vpt", "cp", "-r", "vendor/jest-extended", "node_modules"], snapshot = false },
+  { argv = ["vpt", "cp", "-r", "vendor/vitest", "node_modules"], snapshot = false },
+  { argv = ["node", "verify.mjs"], timeout = 120000 },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots/project_runtime_matrix.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots/project_runtime_matrix.md
new file mode 100644
index 0000000000..656d43fff9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/snapshots/project_runtime_matrix.md
@@ -0,0 +1,21 @@
+# project_runtime_matrix
+
+## `vpt mkdir -p node_modules`
+
+
+## `vpt cp -r vendor/jest-extended node_modules`
+
+
+## `vpt cp -r vendor/vitest node_modules`
+
+
+## `node verify.mjs`
+
+```
+single: 1 projects, 1 servers; imports, hooks, and assertions passed
+shared: 3 projects, 2 servers; imports, hooks, and assertions passed
+separate: 2 projects, 2 servers; imports, hooks, and assertions passed
+composed: 1 projects, 1 servers; imports, hooks, and assertions passed
+referenced: 1 projects, 1 servers; imports, hooks, and assertions passed
+nested: 1 projects, 1 servers; imports, hooks, and assertions passed
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/index.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/index.js
new file mode 100644
index 0000000000..183f86e07d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/index.js
@@ -0,0 +1,7 @@
+import { expect } from 'vitest';
+export const matcherExpect = expect;
+expect.extend({
+  toHaveSharedState(actual) {
+    return { pass: actual === 'shared', message: () => 'expected shared assertion state' };
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/package.json
new file mode 100644
index 0000000000..7f87668e69
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/jest-extended/package.json
@@ -0,0 +1 @@
+{"name":"jest-extended","version":"0.0.0","type":"module","exports":"./index.js"}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/index.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/index.js
new file mode 100644
index 0000000000..905194c725
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/index.js
@@ -0,0 +1 @@
+throw new Error('The project runner must not replace the bundled Vitest runner.');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/package.json
new file mode 100644
index 0000000000..3f04eb136b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vendor/vitest/package.json
@@ -0,0 +1 @@
+{"name":"vitest","version":"4.1.11","type":"module","exports":"./index.js"}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/verify.mjs
new file mode 100644
index 0000000000..415e709e3e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/verify.mjs
@@ -0,0 +1,42 @@
+import assert from 'node:assert/strict';
+import { createVitest } from 'vite-plus/test/node';
+
+const integrationPlugins = [
+  'vite-plus:vitest-resolver',
+  'vite-plus:auto-inline-matcher-deps',
+  'vite-plus:coverage-version-guard',
+];
+for (const name of ['single', 'shared', 'separate', 'composed', 'referenced', 'nested']) {
+  process.env.VP_TEST_PROJECT_CASE = name;
+  globalThis.__vpHookServers = [];
+  globalThis.__vpHookProjects = [];
+  const runner = await createVitest({ config: './vite.config.mjs', watch: false, reporters: [] });
+  try {
+    for (const active of runner.projects) {
+      for (const pluginName of integrationPlugins) {
+        assert.equal(active.viteConfig.plugins.filter((plugin) => plugin.name === pluginName).length, 1, `${name}/${active.name}/${pluginName}`);
+      }
+    }
+    const servers = new Set(runner.projects.map((active) => active.vite));
+    assert.equal(globalThis.__vpHookServers.length, new Set(globalThis.__vpHookServers).size);
+    assert.deepEqual(globalThis.__vpHookProjects.toSorted(), runner.projects.filter((project) => project.viteConfig.plugins.some((plugin) => plugin.name === 'test-root-hook')).map((project) => project.name).toSorted());
+    if (name === 'shared') {
+      assert.equal(servers.size, 2);
+      assert.equal(runner.getProjectByName('default').vite, runner.getProjectByName('inherited').vite);
+      assert.notEqual(runner.getProjectByName('default').vite, runner.getProjectByName('independent').vite);
+      assert.equal(runner.getProjectByName('independent').viteConfig.plugins.some((plugin) => plugin.name === 'test-root-hook'), false);
+    }
+    if (name === 'separate') {
+      assert.equal(servers.size, 2);
+      assert.notEqual(runner.projects[0].vite, runner.projects[1].vite);
+      assert.equal(runner.getProjectByName('independent').viteConfig.plugins.some((plugin) => plugin.name === 'test-root-hook'), false);
+    }
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().map((file) => ({ project: file.projectName, errors: file.result?.errors, tests: file.tasks.map((task) => task.result?.errors) }))));
+    assert.equal(runner.state.getFiles().length, runner.projects.length);
+    console.log(`${name}: ${runner.projects.length} projects, ${servers.size} servers; imports, hooks, and assertions passed`);
+  } finally {
+    await runner.close();
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vite.config.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vite.config.mjs
new file mode 100644
index 0000000000..88ccadc1c2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vite.config.mjs
@@ -0,0 +1,27 @@
+import { defineConfig, defineProject } from 'vite-plus';
+
+const project = (name, extra = {}) => ({
+  ...extra,
+  test: { name, include: ['identity.test.js'], provide: { value: name } },
+});
+const options = {
+  single: {},
+  shared: { projects: [project('default'), project('inherited', { extends: true }), project('independent', { extends: false })] },
+  separate: { sharedViteServer: false, projects: [project('default'), project('independent', { extends: false })] },
+  composed: { projects: [defineProject(project('composed'))] },
+  referenced: { projects: ['./vitest.referenced.config.js'] },
+  nested: { projects: ['./vitest.nested.config.js'] },
+};
+
+export default defineConfig({
+  plugins: [{
+    name: 'test-root-hook',
+    configureServer(server) { globalThis.__vpHookServers.push(server); },
+    configureVitest({ project }) { globalThis.__vpHookProjects.push(project.name); },
+  }],
+  test: {
+    include: ['identity.test.js'],
+    provide: { value: 'root' },
+    ...options[process.env.VP_TEST_PROJECT_CASE],
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.nested.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.nested.config.js
new file mode 100644
index 0000000000..7d6f8ed1a0
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.nested.config.js
@@ -0,0 +1,8 @@
+import { defineProject } from 'vite-plus';
+export default defineProject({
+  test: {
+    name: 'nested-parent',
+    provide: { value: 'nested' },
+    projects: [{ test: { name: 'nested-child', include: ['identity.test.js'] } }],
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.referenced.config.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.referenced.config.js
new file mode 100644
index 0000000000..7e1ae230b7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_projects/vitest.referenced.config.js
@@ -0,0 +1,8 @@
+import { defineProject } from 'vite-plus';
+export default defineProject({
+  test: {
+    name: 'referenced',
+    include: ['identity.test.js'],
+    provide: { value: 'referenced' },
+  },
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/package.json
new file mode 100644
index 0000000000..12ff2563e8
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/package.json
@@ -0,0 +1,4 @@
+{
+  "name": "test-v5-runtime",
+  "private": true
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots.toml
new file mode 100644
index 0000000000..21e3bbbe5d
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots.toml
@@ -0,0 +1,15 @@
+[[case]]
+name = "reject_node_20"
+vp = "global"
+steps = [
+  ["vpt", "write-file", ".node-version", "20.19.0\n"],
+  { argv = ["vp", "test", "run"], timeout = 180000 },
+]
+
+[[case]]
+name = "reject_node_25"
+vp = "global"
+steps = [
+  ["vpt", "write-file", ".node-version", "25.0.0\n"],
+  { argv = ["vp", "test", "run"], timeout = 180000 },
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots/reject_node_20.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots/reject_node_20.md
new file mode 100644
index 0000000000..b85d582a91
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots/reject_node_20.md
@@ -0,0 +1,18 @@
+# reject_node_20
+
+## `vpt write-file .node-version '20.19.0
+'`
+
+```
+```
+
+## `vp test run`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+vp test requires Node ^22.18.0 || ^24.11.0 || >=26.0.0.
+This project selects Node <version>. Run `vp env pin 22 --force`, or update the project's runtime range.
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots/reject_node_25.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots/reject_node_25.md
new file mode 100644
index 0000000000..39330c0c9c
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_runtime/snapshots/reject_node_25.md
@@ -0,0 +1,18 @@
+# reject_node_25
+
+## `vpt write-file .node-version '25.0.0
+'`
+
+```
+```
+
+## `vp test run`
+
+**Exit code:** 1
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+vp test requires Node ^22.18.0 || ^24.11.0 || >=26.0.0.
+This project selects Node <version>. Run `vp env pin 22 --force`, or update the project's runtime range.
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/browser.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/browser.test.js
new file mode 100644
index 0000000000..38afd04180
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/browser.test.js
@@ -0,0 +1,10 @@
+import { expect, test } from 'vite-plus/test';
+import { page } from 'vite-plus/test/browser-playwright/context';
+
+test('fixed viewport and reference image', async () => {
+  document.body.style.margin = '0';
+  document.body.innerHTML = '<div data-testid="box" style="width:100px;height:40px;background:blue"></div>';
+  expect([window.innerWidth, window.innerHeight]).toEqual([800, 600]);
+  await expect(page.getByTestId('box')).toMatchScreenshot('box');
+  await page.screenshot({ name: 'viewport' });
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/failure.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/failure.test.js
new file mode 100644
index 0000000000..8ed87b51d9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/failure.test.js
@@ -0,0 +1,6 @@
+import { expect, test } from 'vite-plus/test';
+
+test('intentional failure screenshot', () => {
+  document.body.innerHTML = '<div style="height:40px;background:red"></div>';
+  expect(true, 'fixture deliberately fails to capture its attachment').toBe(false);
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/package.json
new file mode 100644
index 0000000000..a05f3ca57b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/package.json
@@ -0,0 +1 @@
+{ "name": "test-v5-screenshots", "private": true, "type": "module" }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots.toml
new file mode 100644
index 0000000000..f191a4074b
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots.toml
@@ -0,0 +1,13 @@
+[[case]]
+name = "headless_paths_and_dimensions"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+steps = [{ argv = ["node", "verify.mjs"], timeout = 120000 }]
+
+[[case]]
+name = "headed_paths_and_dimensions"
+vp = "local"
+skip-platforms = ["linux", "windows"]
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+comment = "Headed coverage runs on macOS; the Linux and Windows snapshot workers have no desktop display. All platforms run the headless case."
+steps = [{ argv = ["node", "verify.mjs", "--headed"], timeout = 120000 }]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headed_paths_and_dimensions.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headed_paths_and_dimensions.md
new file mode 100644
index 0000000000..c604fb6317
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headed_paths_and_dimensions.md
@@ -0,0 +1,11 @@
+# headed_paths_and_dimensions
+
+Headed coverage runs on macOS; the Linux and Windows snapshot workers have no desktop display. All platforms run the headless case.
+
+## `node verify.mjs --headed`
+
+```
+Headed record: custom reference path, 100 x 40 element, 800 x 600 viewport
+Headed compare: custom reference path, 100 x 40 element, 800 x 600 viewport
+Failure screenshot: .vitest/attachments/failure-screenshots, 800 x 600
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headless_paths_and_dimensions.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headless_paths_and_dimensions.md
new file mode 100644
index 0000000000..db1a0afc0e
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/snapshots/headless_paths_and_dimensions.md
@@ -0,0 +1,9 @@
+# headless_paths_and_dimensions
+
+## `node verify.mjs`
+
+```
+Headless record: custom reference path, 100 x 40 element, 800 x 600 viewport
+Headless compare: custom reference path, 100 x 40 element, 800 x 600 viewport
+Failure screenshot: .vitest/attachments/failure-screenshots, 800 x 600
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/verify.mjs
new file mode 100644
index 0000000000..6825a3dbb9
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_screenshots/verify.mjs
@@ -0,0 +1,57 @@
+import assert from 'node:assert/strict';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+import { playwright } from 'vite-plus/test/browser-playwright';
+
+const headed = process.argv.includes('--headed');
+const pngs = (directory) => readdirSync(directory, { recursive: true }).filter((name) => name.endsWith('.png')).map((name) => join(directory, name));
+const dimensions = (file) => {
+  const buffer = readFileSync(file);
+  assert.equal(buffer.subarray(1, 4).toString(), 'PNG');
+  return [buffer.readUInt32BE(16), buffer.readUInt32BE(20)];
+};
+for (const phase of ['record', 'compare', 'failure']) {
+  const runner = await createVitest({
+    config: false, watch: false, reporters: [], update: phase === 'record',
+  }, defineConfig({ test: {
+    include: [phase === 'failure' ? 'failure.test.js' : 'browser.test.js'],
+    browser: {
+      enabled: true, provider: playwright(), headless: !headed, ui: false,
+      instances: [{ browser: 'chromium' }], viewport: { width: 800, height: 600 },
+      screenshotFailures: true, screenshotDirectory: 'manual-images',
+      expect: { toMatchScreenshot: { screenshotDirectory: 'reference-images' } },
+    },
+  } }));
+  try {
+    const result = await runner.start();
+    assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+    assert.equal(runner.state.getFiles().length, 1);
+    if (phase === 'failure') {
+      assert.equal(runner.state.getFiles()[0].tasks.length, 1);
+      const task = runner.state.getFiles()[0].tasks[0];
+      assert.equal(task.result.state, 'fail');
+      assert.equal(task.result.errors.length, 1);
+      assert.match(task.result.errors[0].message, /fixture deliberately fails/);
+      const images = pngs('.vitest/attachments/failure-screenshots');
+      assert.equal(images.length, 1);
+      assert.deepEqual(dimensions(images[0]), [800, 600]);
+      console.log('Failure screenshot: .vitest/attachments/failure-screenshots, 800 x 600');
+    } else {
+      assert.equal(runner.state.getCountOfFailedTests(), 0,
+        JSON.stringify(runner.state.getFiles().flatMap((file) => file.tasks.map((task) => task.result))));
+      const references = pngs('reference-images');
+      assert.equal(references.length, 1, `reference images: ${JSON.stringify(references)}`);
+      assert.deepEqual(dimensions(references[0]), [100, 40]);
+      const manual = pngs('manual-images').filter((file) => file.includes('viewport'));
+      assert.equal(manual.length, 1, `manual images: ${JSON.stringify(pngs('manual-images'))}`);
+      assert.deepEqual(dimensions(manual[0]), [800, 600]);
+      assert.equal(existsSync('__screenshots__'), false);
+      console.log(`${headed ? 'Headed' : 'Headless'} ${phase}: custom reference path, 100 x 40 element, 800 x 600 viewport`);
+    }
+  } finally { await runner.close(); }
+}
+// All assertions above must succeed, including the deliberate failure's error
+// and attachment. No unexpected browser failure can turn this case green.
+process.exitCode = 0;
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/package.json
new file mode 100644
index 0000000000..14e8b9a7fb
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/package.json
@@ -0,0 +1,12 @@
+{
+  "name": "test-v5-upstream-types",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.24.0",
+  "devDependencies": {
+    "vitest": "5.0.0",
+    "@vitest/browser-preview": "5.0.0",
+    "@testing-library/jest-dom": "6.9.1",
+    "typescript": "6.0.3"
+  }
+}
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots.toml
new file mode 100644
index 0000000000..bcad2d1ee4
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots.toml
@@ -0,0 +1,21 @@
+[[case]]
+name = "jest_dom_browser_type_order"
+vp = "global"
+local-registry = true
+comment = "Known upstream type conflict: browser-first declarations reject valid Node jest-dom assertions. Check upstream imports without Vite+ installed, plus the opposite-order control; this is not a passed release gate."
+steps = [
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  ["node", "verify.mjs"],
+]
+
+[[case]]
+name = "jest_dom_v7_browser_type_order"
+vp = "global"
+local-registry = true
+comment = "Check whether the current jest-dom release resolves the upstream declaration-order conflict."
+steps = [
+  { argv = ["vpt", "json-edit", "package.json", "devDependencies.@testing-library/jest-dom", "7.0.1"], snapshot = false },
+  { argv = ["vpt", "json-edit", "package.json", "devDependencies.@testing-library/dom", "10.4.1"], snapshot = false },
+  { argv = ["vp", "install", "--ignore-scripts"], snapshot = false, timeout = 180000 },
+  ["node", "verify.mjs"],
+]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_browser_type_order.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_browser_type_order.md
new file mode 100644
index 0000000000..9818119561
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_browser_type_order.md
@@ -0,0 +1,14 @@
+# jest_dom_browser_type_order
+
+Known upstream type conflict: browser-first declarations reject valid Node jest-dom assertions. Check upstream imports without Vite+ installed, plus the opposite-order control; this is not a passed release gate.
+
+## `vp install --ignore-scripts`
+
+
+## `node verify.mjs`
+
+```
+vitest: browser-first=true, Node jest-dom type errors=2
+vitest: browser-first=false, Node jest-dom type errors=0
+Release blocker reproduced: browser and jest-dom declaration order changes Node matcher types
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_v7_browser_type_order.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_v7_browser_type_order.md
new file mode 100644
index 0000000000..56ed974d89
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/snapshots/jest_dom_v7_browser_type_order.md
@@ -0,0 +1,20 @@
+# jest_dom_v7_browser_type_order
+
+Check whether the current jest-dom release resolves the upstream declaration-order conflict.
+
+## `vpt json-edit package.json devDependencies.@testing-library/jest-dom 7.0.1`
+
+
+## `vpt json-edit package.json devDependencies.@testing-library/dom 10.4.1`
+
+
+## `vp install --ignore-scripts`
+
+
+## `node verify.mjs`
+
+```
+vitest: browser-first=true, Node jest-dom type errors=2
+vitest: browser-first=false, Node jest-dom type errors=0
+Release blocker reproduced: browser and jest-dom declaration order changes Node matcher types
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/verify.mjs
new file mode 100644
index 0000000000..bcdb0c16d7
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_upstream_types/verify.mjs
@@ -0,0 +1,45 @@
+import assert from 'node:assert/strict';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import ts from 'typescript';
+
+const file = path.resolve('virtual-jest-dom-type-probe.ts');
+assert.equal(existsSync('node_modules/vite-plus'), false);
+const options = {
+  target: ts.ScriptTarget.ESNext,
+  module: ts.ModuleKind.Preserve,
+  moduleResolution: ts.ModuleResolutionKind.Bundler,
+  strict: true,
+  skipLibCheck: true,
+  noEmit: true,
+  types: [],
+};
+for (const browserFirst of [true, false]) {
+  const imports = ['vitest/browser', '@testing-library/jest-dom/vitest'];
+  if (!browserFirst) imports.reverse();
+  const source = imports.map((name) => `import '${name}';`).join('\n') + `
+    import { expect } from 'vitest';
+    import { page } from 'vitest/browser';
+    page.getByRole('button');
+    expect(document.body).toHaveTextContent(/text/);
+    expect(document.body).toHaveStyle({ '--custom': '1px' });
+  `;
+  const host = ts.createCompilerHost(options);
+  const getSourceFile = host.getSourceFile.bind(host);
+  host.getSourceFile = (name, language, ...rest) =>
+    name === file
+      ? ts.createSourceFile(name, source, language, true)
+      : getSourceFile(name, language, ...rest);
+  const program = ts.createProgram([file], options, host);
+  assert.ok(program.getSourceFiles().some(({ fileName }) =>
+    /@vitest\/browser\/matchers\.d\.ts$/.test(fileName.replaceAll('\\', '/')),
+  ));
+  const diagnostics = ts.getPreEmitDiagnostics(program);
+  assert.deepEqual(diagnostics.map(({ code }) => code), browserFirst ? [2345, 2353] : []);
+  if (browserFirst) {
+    assert.match(ts.flattenDiagnosticMessageText(diagnostics[0].messageText, ' '), /RegExp/);
+    assert.match(ts.flattenDiagnosticMessageText(diagnostics[1].messageText, ' '), /CSSStyleDeclaration/);
+  }
+  console.log(`vitest: browser-first=${browserFirst}, Node jest-dom type errors=${diagnostics.length}`);
+}
+console.log('Release blocker reproduced: browser and jest-dom declaration order changes Node matcher types');
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/browser.test.js b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/browser.test.js
new file mode 100644
index 0000000000..87af5409b2
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/browser.test.js
@@ -0,0 +1,20 @@
+import { expect, test } from 'vite-plus/test';
+import { expect as rawExpect } from 'vitest';
+import { commands, page } from 'vite-plus/test/browser';
+import { page as providerPage } from 'vite-plus/test/browser-webdriverio/context';
+import { page as legacyPage } from 'vite-plus/test/browser/providers/webdriverio/context';
+
+test('community provider shares runner state and serialized locators', async () => {
+  expect(expect).toBe(rawExpect);
+  expect(page).toBe(providerPage);
+  expect(page).toBe(legacyPage);
+  document.body.innerHTML = '<button>Increment</button><output>0</output>';
+  document.querySelector('button').onclick = () => { document.querySelector('output').textContent = '1'; };
+  const button = page.getByRole('button', { name: 'Increment' });
+  const serialized = await commands.inspectLocator(button);
+  expect(serialized.selector).toBeTypeOf('string');
+  expect(serialized.locator).toBeTypeOf('string');
+  expect(serialized.session).toBe(true);
+  await button.click();
+  await expect.element(page.getByRole('status')).toHaveTextContent('1');
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/package.json b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/package.json
new file mode 100644
index 0000000000..70fbd2ebd1
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/package.json
@@ -0,0 +1 @@
+{ "name": "test-v5-webdriverio", "private": true, "type": "module" }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots.toml b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots.toml
new file mode 100644
index 0000000000..4f30d25c82
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots.toml
@@ -0,0 +1,5 @@
+[[case]]
+name = "community_provider_and_browser_protocol"
+vp = "local"
+env = { PLAYWRIGHT_BROWSERS_PATH = "0" }
+steps = [{ argv = ["node", "verify.mjs"], timeout = 180000 }]
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/community_provider_and_browser_protocol.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/community_provider_and_browser_protocol.md
new file mode 100644
index 0000000000..e7d4e05469
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/snapshots/community_provider_and_browser_protocol.md
@@ -0,0 +1,7 @@
+# community_provider_and_browser_protocol
+
+## `node verify.mjs`
+
+```
+WebDriverIO 5.0.0-rc.1 with Vitest 5.0.0: runner/context identity, real-timer clicks, session URLs, and serialized custom-command locators passed
+```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/verify.mjs b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/verify.mjs
new file mode 100644
index 0000000000..6606d1d234
--- /dev/null
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_v5_webdriverio/verify.mjs
@@ -0,0 +1,43 @@
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+import { defineConfig } from 'vite-plus';
+import { createVitest } from 'vite-plus/test/node';
+import { webdriverio } from 'vite-plus/test/browser-webdriverio';
+
+const require = createRequire(import.meta.resolve('vite-plus/package.json'));
+const { chromium } = require('playwright');
+assert.equal(require('@vitest/browser-webdriverio/package.json').version, '5.0.0-rc.1');
+const provider = webdriverio({ capabilities: { 'goog:chromeOptions': {
+  binary: chromium.executablePath(), args: ['--no-sandbox'],
+} } });
+let sessionOpened = false;
+const createProvider = provider.providerFactory;
+provider.providerFactory = (project) => {
+  const instance = createProvider(project);
+  const openPage = instance.openPage.bind(instance);
+  instance.openPage = async (session, url) => {
+    assert.equal(new URL(url).searchParams.get('sessionId'), session);
+    sessionOpened = true;
+    return openPage(session, url);
+  };
+  return instance;
+};
+const runner = await createVitest({ config: false, watch: false, reporters: [] }, defineConfig({ test: {
+  include: ['browser.test.js'],
+  browser: {
+    enabled: true, headless: true, provider, instances: [{ browser: 'chrome' }],
+    viewport: { width: 800, height: 600 },
+    commands: { inspectLocator(context, locator) {
+      assert.equal(typeof locator, 'object');
+      return { ...locator, session: typeof context.sessionId === 'string' && context.sessionId.length > 0 };
+    } },
+  },
+} }));
+try {
+  const result = await runner.start();
+  assert.equal(result.unhandledErrors.length, 0, JSON.stringify(result.unhandledErrors));
+  assert.equal(runner.state.getCountOfFailedTests(), 0, JSON.stringify(runner.state.getFiles().flatMap((file) => [file.result, ...file.tasks.map((task) => task.result)])));
+  assert.equal(runner.state.getFiles().length, 1);
+  assert.ok(sessionOpened);
+  console.log('WebDriverIO 5.0.0-rc.1 with Vitest 5.0.0: runner/context identity, real-timer clicks, session URLs, and serialized custom-command locators passed');
+} finally { await runner.close(); }
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_vi_mock_hoist/snapshots/test_vi_mock_hoist.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_vi_mock_hoist/snapshots/test_vi_mock_hoist.md
index 11c3827035..265e7e7e11 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_vi_mock_hoist/snapshots/test_vi_mock_hoist.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/test_vi_mock_hoist/snapshots/test_vi_mock_hoist.md
@@ -14,5 +14,5 @@ vi.mock() from 'vite-plus/test' must hoist via upstream mocker (no vite-plus pat
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_plugins_async_test/snapshots/vite_plugins_async_test.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_plugins_async_test/snapshots/vite_plugins_async_test.md
index 34969de666..380067c8ca 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_plugins_async_test/snapshots/vite_plugins_async_test.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vite_plugins_async_test/snapshots/vite_plugins_async_test.md
@@ -14,5 +14,5 @@ async plugins factory should load vitest plugin with configureVitest hook
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/snapshots/vitest_browser_mode.md b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/snapshots/vitest_browser_mode.md
index 86f0e13eaf..5b4ecb4bcb 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/snapshots/vitest_browser_mode.md
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/snapshots/vitest_browser_mode.md
@@ -6,13 +6,14 @@
 $ vp test
 
  RUN  <version> <workspace>
+      API started at http://localhost:<port>/
 
  ✓  chromium  src/foo.test.js (1 test) <duration>
 
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
 
 ## `vpt write-file src/foo.js 'export default '\''foo'\'';
@@ -26,13 +27,14 @@ $ vp test
 $ vp test ○ cache miss: 'src/foo.js' modified, executing
 
  RUN  <version> <workspace>
+      API started at http://localhost:<port>/
 
  ✓  chromium  src/foo.test.js (1 test) <duration>
 
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 ```
 
 ## `vpt write-file src/bar.js 'export default '\''bar'\'';
@@ -46,13 +48,14 @@ $ vp test ○ cache miss: 'src/foo.js' modified, executing
 $ vp test ◉ cache hit, replaying
 
  RUN  <version> <workspace>
+      API started at http://localhost:<port>/
 
  ✓  chromium  src/foo.test.js (1 test) <duration>
 
  Test Files  1 passed (1)
       Tests  1 passed (1)
    Start at  <time>
-   Duration  <duration> (transform <duration>, setup <duration>, import <duration>, tests <duration>, environment <duration>)
+   Duration  <duration> (<timing>)
 
 ---
 vp run: cache hit, <duration> saved.
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/vitest.config.ts b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/vitest.config.ts
index 22c1dc03b6..00dd92e6b7 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/vitest.config.ts
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/fixtures/vitest_browser_mode/vitest.config.ts
@@ -1,7 +1,7 @@
-// import { defineProject } from 'vitest/config';
+import { defineConfig } from 'vite-plus';
 import { playwright } from 'vite-plus/test/browser-playwright';
 
-export default {
+export default defineConfig({
   plugins: [
     {
       name: 'vitest-browser-mode-suppress-known-vite-logs',
@@ -35,4 +35,4 @@ export default {
       ],
     },
   },
-};
+});
diff --git a/crates/vp_cli_snapshots/tests/cli_snapshots/redact.rs b/crates/vp_cli_snapshots/tests/cli_snapshots/redact.rs
index 1301e2dc33..8aa2ac62b7 100644
--- a/crates/vp_cli_snapshots/tests/cli_snapshots/redact.rs
+++ b/crates/vp_cli_snapshots/tests/cli_snapshots/redact.rs
@@ -14,6 +14,11 @@ static UUID_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
 });
 static DURATION_RE: LazyLock<regex::Regex> =
     LazyLock::new(|| regex::Regex::new(r"\b\d+(\.\d+)?(ns|µs|ms|s)\b").unwrap());
+// Vitest v5 prints the timing breakdown as percentages. Its order and omitted
+// zero-cost phases vary between runs, so redact the complete timing detail.
+static VITEST_TIMING_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
+    regex::Regex::new(r"(?m)(Duration\s+<duration>) \((?:[a-z]+ \d+%(?:, )?)+\)").unwrap()
+});
 // Only v-prefixed versions are masked: tool and runtime banners all print
 // that form (`vite v7.3.2`, `vp v0.2.2`, `Node.js v24.18.0`) and churn on
 // every dep bump, while bare semver literals (`app-1.0.0.tgz`,
@@ -181,6 +186,10 @@ static ASSET_HASH_RE: LazyLock<regex::Regex> =
 // verbatim.
 static LOCAL_REGISTRY_URL_RE: LazyLock<regex::Regex> =
     LazyLock::new(|| regex::Regex::new(r"http://127\.0\.0\.1:\d+").unwrap());
+static VITEST_API_PORT_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
+    regex::Regex::new(r"((?:API|Browser runner) started at http://(?:localhost|127\.0\.0\.1):)\d+")
+        .unwrap()
+});
 // npm names its debug log after the wall-clock start of the failing run.
 static NPM_LOG_NAME_RE: LazyLock<regex::Regex> = LazyLock::new(|| {
     regex::Regex::new(r"\d{4}-\d{2}-\d{2}T\d{2}_\d{2}_\d{2}_\d{3}Z(-debug-\d+\.log)").unwrap()
@@ -444,6 +453,7 @@ pub fn redact_output(
     // Redact durations like "0ns", "123ms" or "1.23s" to "<duration>".
     // Runs before version redaction so "1.23s" never half-matches as a version.
     output = DURATION_RE.replace_all(&output, "<duration>").into_owned();
+    output = VITEST_TIMING_RE.replace_all(&output, "$1 (<timing>)").into_owned();
 
     // Redact semver-shaped versions (bundled tool versions, Node versions).
     output = VERSION_RE.replace_all(&output, "<version>").into_owned();
@@ -575,6 +585,7 @@ pub fn redact_output(
     // Mask the local-registry proxy's ephemeral port, npm's timestamped debug
     // log name, live spinner frames, and pnpm's nondeterministic progress lines
     output = LOCAL_REGISTRY_URL_RE.replace_all(&output, "http://127.0.0.1:<port>").into_owned();
+    output = VITEST_API_PORT_RE.replace_all(&output, "${1}<port>").into_owned();
     output = NPM_LOG_NAME_RE.replace_all(&output, "<timestamp>${1}").into_owned();
     output = SPINNER_FRAME_RE.replace_all(&output, "\u{283F}").into_owned();
     output = PNPM_PROGRESS_RE.replace_all(&output, "").into_owned();
diff --git a/crates/vp_cli_snapshots/tests/redact_unit.rs b/crates/vp_cli_snapshots/tests/redact_unit.rs
index 5c264e6756..da491b832f 100644
--- a/crates/vp_cli_snapshots/tests/redact_unit.rs
+++ b/crates/vp_cli_snapshots/tests/redact_unit.rs
@@ -11,6 +11,24 @@ mod redact;
 
 use redact::{redact_output, redact_version_probe_output};
 
+#[test]
+fn masks_vitest_v5_timing_but_preserves_coverage_percentages() {
+    let input = " Duration  112ms (transform 57%, import 28%, worker 8%, tests 6%)\nCoverage 90%\n";
+    assert_eq!(
+        redact_output(input.to_owned(), &[], true),
+        " Duration  <duration> (<timing>)\nCoverage 90%\n"
+    );
+}
+
+#[test]
+fn masks_vitest_api_port_but_preserves_other_localhost_urls() {
+    let input = "API started at http://localhost:63316/\nBrowser runner started at http://localhost:63317/__vitest_test__/?sessionId=keep-session\nhttp://localhost:9229/\n";
+    assert_eq!(
+        redact_output(input.to_owned(), &[], true),
+        "API started at http://localhost:<port>/\nBrowser runner started at http://localhost:<port>/__vitest_test__/?sessionId=keep-session\nhttp://localhost:9229/\n"
+    );
+}
+
 #[test]
 fn masks_bare_version_block_only_for_version_probe_steps() {
     // `npm --version` / `npx --version` print a bare semver alone in the
diff --git a/crates/vp_global_cli/src/js_executor.rs b/crates/vp_global_cli/src/js_executor.rs
index 2bdf387ebf..0911309d1a 100644
--- a/crates/vp_global_cli/src/js_executor.rs
+++ b/crates/vp_global_cli/src/js_executor.rs
@@ -354,7 +354,7 @@ impl JsExecutor {
     }
 
     /// Prepare a JS command with the entry point resolved.
-    fn prepare_js_entry(
+    async fn prepare_js_entry(
         &self,
         project_path: &AbsolutePath,
         node_binary: &AbsolutePath,
@@ -374,6 +374,10 @@ impl JsExecutor {
             }
         };
 
+        if args.first().is_some_and(|arg| arg == "test") {
+            validate_test_runtime(&entry_point, node_binary).await?;
+        }
+
         tracing::debug!("Delegating to CLI via JS entry point: {:?} {:?}", entry_point, args);
 
         let mut cmd = Self::create_js_command(node_binary, bin_prefix);
@@ -396,7 +400,7 @@ impl JsExecutor {
         bin_prefix: &AbsolutePath,
         args: &[String],
     ) -> Result<ExitStatus, Error> {
-        let cmd = self.prepare_js_entry(project_path, node_binary, bin_prefix, args)?;
+        let cmd = self.prepare_js_entry(project_path, node_binary, bin_prefix, args).await?;
         Ok(vp_command::execute_with_terminal_guard(cmd).await?)
     }
 
@@ -408,7 +412,7 @@ impl JsExecutor {
         bin_prefix: &AbsolutePath,
         args: &[String],
     ) -> Result<Output, Error> {
-        let mut cmd = self.prepare_js_entry(project_path, node_binary, bin_prefix, args)?;
+        let mut cmd = self.prepare_js_entry(project_path, node_binary, bin_prefix, args).await?;
         let output = cmd.output().await?;
         Ok(output)
     }
@@ -445,6 +449,52 @@ impl JsExecutor {
     }
 }
 
+/// Check the engine of the exact CLI selected for delegation before loading JS.
+/// Query the binary itself so system-first mode is checked as well as managed Node.
+async fn validate_test_runtime(
+    entry_point: &AbsolutePath,
+    node_binary: &AbsolutePath,
+) -> Result<(), Error> {
+    let Some(package_dir) = entry_point.parent().and_then(AbsolutePath::parent) else {
+        return Ok(());
+    };
+    let package_file = package_dir.join("package.json");
+    let Ok(source) = tokio::fs::read_to_string(package_file.as_path()).await else {
+        return Ok(());
+    };
+    let package: serde_json::Value = serde_json::from_str(&source)?;
+    let Some(engine) = package
+        .get("engines")
+        .and_then(|engines| engines.get("node"))
+        .and_then(serde_json::Value::as_str)
+    else {
+        return Ok(());
+    };
+    let result = Command::new(node_binary.as_path()).arg("--version").output().await?;
+    if !result.status.success() {
+        return Err(Error::UserMessage(
+            "Could not determine the selected Node.js version for vp test.".into(),
+        ));
+    }
+    check_test_node_engine(engine, String::from_utf8_lossy(&result.stdout).trim())
+}
+
+fn check_test_node_engine(engine: &str, version: &str) -> Result<(), Error> {
+    let version = version.strip_prefix('v').unwrap_or(version);
+    let range = node_semver::Range::parse(engine).map_err(|_| {
+        Error::ConfigError(vt_str::format!("Invalid vite-plus Node.js engine: {engine}"))
+    })?;
+    let selected = node_semver::Version::parse(version).map_err(|_| {
+        Error::ConfigError(vt_str::format!("Invalid selected Node.js version: {version}"))
+    })?;
+    if !range.satisfies(&selected) {
+        return Err(Error::UserMessage(vt_str::format!(
+            "vp test requires Node {engine}.\nThis project selects Node {version}. Run `vp env pin 22 --force`, or update the project's runtime range."
+        )));
+    }
+    Ok(())
+}
+
 /// Resolve the version of the project-local `vite-plus`, if one is installed.
 fn resolve_local_vite_plus_version(project_path: &AbsolutePath) -> Option<String> {
     let package_dir = JsExecutor::resolve_local_vite_plus_package_dir(project_path)?;
@@ -525,6 +575,21 @@ async fn find_system_node_runtime() -> Option<JsRuntime> {
 mod tests {
     use super::*;
 
+    #[test]
+    fn test_vitest_v5_node_engine() {
+        let engine = "^22.18.0 || ^24.11.0 || >=26.0.0";
+        for version in ["22.18.0", "24.11.0", "26.0.0", "v26.1.0"] {
+            assert!(check_test_node_engine(engine, version).is_ok(), "{version}");
+        }
+        for version in ["20.19.0", "22.12.0", "24.0.0", "25.0.0"] {
+            let error = check_test_node_engine(engine, version).unwrap_err().to_string();
+            assert!(error.contains("vp env pin 22 --force"), "{error}");
+            assert!(error.contains(version), "{error}");
+        }
+        // An installed v4 CLI still has its own supported Node range.
+        assert!(check_test_node_engine("^20.19.0 || >=22.18.0", "20.19.0").is_ok());
+    }
+
     /// Shared VP_HOME for tests that download a real Node.js runtime: pinning
     /// isolates them from concurrent scopes, and one shared root keeps the
     /// download cache warm across tests and runs.
diff --git a/crates/vp_migration/src/import_rewriter.rs b/crates/vp_migration/src/import_rewriter.rs
index 7b7493fb5e..014dbf0f62 100644
--- a/crates/vp_migration/src/import_rewriter.rs
+++ b/crates/vp_migration/src/import_rewriter.rs
@@ -1572,9 +1572,66 @@ static PARSED_VITE_RULES: LazyLock<Vec<RuleConfig<SupportLang>>> = LazyLock::new
 });
 
 static PARSED_VITEST_RULES: LazyLock<Vec<RuleConfig<SupportLang>>> = LazyLock::new(|| {
-    ast_grep::load_rules(REWRITE_VITEST_RULES).expect("failed to parse vitest rewrite rules")
+    ast_grep::load_rules(&vitest_rewrite_rules()).expect("failed to parse vitest rewrite rules")
 });
 
+static VITEST_V5_ENTRY_POINTS: LazyLock<HashMap<String, String>> = LazyLock::new(|| {
+    serde_json::from_str(include_str!("../../../packages/cli/src/vitest-v5-entry-points.json"))
+        .expect("invalid Vitest entry-point map")
+});
+
+static VITE_PLUS_TEST_SUBPATHS: LazyLock<Vec<String>> = LazyLock::new(|| {
+    let pkg: serde_json::Value =
+        serde_json::from_str(include_str!("../../../packages/cli/package.json"))
+            .expect("invalid vite-plus manifest");
+    pkg["exports"]
+        .as_object()
+        .expect("missing vite-plus exports")
+        .keys()
+        .filter_map(|key| key.strip_prefix("./test/").map(str::to_owned))
+        .collect()
+});
+
+fn vitest_rewrite_rules() -> String {
+    let allowed = VITE_PLUS_TEST_SUBPATHS
+        .iter()
+        .map(|name| regex::escape(name))
+        .collect::<Vec<_>>()
+        .join("|");
+    let generic = REWRITE_VITEST_RULES.replace(
+        r#"regex: ^['"]vitest/.+['"]$"#,
+        &format!(r#"regex: ^['"]vitest/({allowed})['"]$"#),
+    );
+    // Exact public replacements run before the generic subpath rules. Each
+    // generated rule retains the same AST context and Nuxt skip classification.
+    let template = REWRITE_VITEST_RULES
+        .split("---\nid: rewrite-vitest-subpath-import")
+        .nth(1)
+        .expect("missing subpath rule template");
+    let template = format!("---\nid: rewrite-vitest-subpath-import{template}");
+    let mut rules = String::new();
+    let mut entries = VITEST_V5_ENTRY_POINTS.iter().collect::<Vec<_>>();
+    entries.sort_by_key(|(source, _)| *source);
+    for (source, target) in entries {
+        rules.push_str(
+            &template
+                .replace(
+                    "rewrite-vitest-subpath-",
+                    &format!("rewrite-vitest-subpath-{}-", source.replace('/', "-")),
+                )
+                .replace(
+                    r#"regex: ^['"]vitest/.+['"]$"#,
+                    &format!(r#"regex: ^['"]{}['"]$"#, regex::escape(source)),
+                )
+                .replace("replace: vitest/", &format!("replace: {source}"))
+                .replace("by: \"vite-plus/test/\"", &format!("by: \"{target}\"")),
+        );
+        rules.push('\n');
+    }
+    rules.push_str(&generic);
+    rules
+}
+
 const BARE_VITEST_RULE_IDS: [&str; 4] = [
     "rewrite-vitest-import",
     "rewrite-vitest-export",
@@ -1593,7 +1650,7 @@ fn is_unscoped_vitest_rule(rule: &RuleConfig<SupportLang>) -> bool {
 }
 
 static PARSED_UNSCOPED_VITEST_RULES: LazyLock<Vec<RuleConfig<SupportLang>>> = LazyLock::new(|| {
-    ast_grep::load_rules(REWRITE_VITEST_RULES)
+    ast_grep::load_rules(&vitest_rewrite_rules())
         .expect("failed to parse vitest rewrite rules")
         .into_iter()
         .filter(is_unscoped_vitest_rule)
@@ -1602,7 +1659,7 @@ static PARSED_UNSCOPED_VITEST_RULES: LazyLock<Vec<RuleConfig<SupportLang>>> = La
 
 static PARSED_VITEST_RULES_WITHOUT_UNSCOPED: LazyLock<Vec<RuleConfig<SupportLang>>> =
     LazyLock::new(|| {
-        ast_grep::load_rules(REWRITE_VITEST_RULES)
+        ast_grep::load_rules(&vitest_rewrite_rules())
             .expect("failed to parse vitest rewrite rules")
             .into_iter()
             .filter(|rule| !is_unscoped_vitest_rule(rule))
@@ -1901,8 +1958,25 @@ fn rewrite_reference_types(
                 changed = true;
                 continue;
             }
-            if apply_regex_replace(line, &RE_REF_VITEST_SUBPATH, "${1}vite-plus/test/${2}${3}") {
-                changed = true;
+            if let Some(captures) = RE_REF_VITEST_SUBPATH.captures(line) {
+                let subpath = &captures[2];
+                let original = format!("vitest/{subpath}");
+                let target = VITEST_V5_ENTRY_POINTS.get(&original).cloned().or_else(|| {
+                    VITE_PLUS_TEST_SUBPATHS
+                        .iter()
+                        .any(|name| name == subpath)
+                        .then(|| format!("vite-plus/test/{subpath}"))
+                });
+                if let Some(target) = target {
+                    *line = format!(
+                        "{}{}{}{}",
+                        &captures[1],
+                        target,
+                        &captures[3],
+                        &line[captures[0].len()..]
+                    );
+                    changed = true;
+                }
                 continue;
             }
             if apply_regex_replace(line, &RE_REF_VITEST, "${1}vite-plus/test${2}") {
@@ -2943,19 +3017,14 @@ export default startVitest;"#;
 export default startVitest;"#
         );
 
-        // Test vitest/plugins/runner subpath
+        // Removed and unknown subpaths must not produce unpublished Vite+ paths.
         let vite_config = r#"import { somePlugin } from 'vitest/plugins/runner';
 
 export default somePlugin;"#;
 
         let result = rewrite_import_content(vite_config, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(
-            result.content,
-            r#"import { somePlugin } from 'vite-plus/test/plugins/runner';
-
-export default somePlugin;"#
-        );
+        assert!(!result.updated);
+        assert_eq!(result.content, vite_config);
     }
 
     #[test]
@@ -5688,21 +5757,17 @@ console.log(pkg.version);"#;
     }
 
     #[test]
-    fn test_rewrite_import_content_vitest_package_json_like_suffix_still_rewritten() {
-        // Sanity check: only the exact `vitest/package.json` subpath is
-        // skipped. A subpath that merely starts with `package.json` (e.g.,
-        // `package.json.js`) MUST still be rewritten by the catch-all rule.
+    fn test_rewrite_import_content_vitest_unknown_package_json_suffix_is_preserved() {
         let content = r#"import 'vitest/package.json.js';"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"import 'vite-plus/test/package.json.js';"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     // The `rewrite-vitest-subpath-*` rules now explicitly exclude `vitest/config`
     // via `not: regex: ^['"]vitest/(package\.json|config)['"]$` to make the intent
     // robust against rule-reordering or ast-grep conflict-resolution changes.
-    // These tests verify the exclusion holds for all 4 import shapes and that
-    // a similar-but-distinct path like `vitest/config-extra` is NOT excluded.
+    // Unknown paths such as `vitest/config-extra` must remain untouched too.
 
     #[test]
     fn test_rewrite_import_content_vitest_config_export_not_subpath_rewritten() {
@@ -5737,13 +5802,10 @@ console.log(pkg.version);"#;
 
     #[test]
     fn test_rewrite_import_content_vitest_config_extra_subpath_static_import() {
-        // `vitest/config-extra` is NOT `vitest/config` — the subpath exclusion
-        // must not be too broad. It should still be rewritten by the catch-all
-        // subpath rule to `vite-plus/test/config-extra`.
         let content = r#"import { something } from 'vitest/config-extra';"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"import { something } from 'vite-plus/test/config-extra';"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -5751,8 +5813,8 @@ console.log(pkg.version);"#;
         // Same sanity check for export_statement shape.
         let content = r#"export { something } from 'vitest/config-extra';"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"export { something } from 'vite-plus/test/config-extra';"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -5760,8 +5822,8 @@ console.log(pkg.version);"#;
         // Same sanity check for require() shape.
         let content = r#"const m = require('vitest/config-extra');"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"const m = require('vite-plus/test/config-extra');"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
     }
 
     #[test]
@@ -5769,7 +5831,41 @@ console.log(pkg.version);"#;
         // Same sanity check for dynamic import() shape.
         let content = r#"const m = await import('vitest/config-extra');"#;
         let result = rewrite_import_content(content, &SkipPackages::default()).unwrap();
-        assert!(result.updated);
-        assert_eq!(result.content, r#"const m = await import('vite-plus/test/config-extra');"#);
+        assert!(!result.updated);
+        assert_eq!(result.content, content);
+    }
+
+    #[test]
+    fn test_vitest_v5_canonical_entry_points() {
+        for (source, target) in VITEST_V5_ENTRY_POINTS.iter() {
+            for template in [
+                "import { value } from 'SOURCE';",
+                "export { value } from 'SOURCE';",
+                "const value = require('SOURCE');",
+                "const value = import('SOURCE');",
+                "type Value = typeof import('SOURCE');",
+                "/// <reference types=\"SOURCE\" /> // retain comment",
+            ] {
+                let content = template.replace("SOURCE", source);
+                let result = rewrite_import_content(&content, &SkipPackages::default()).unwrap();
+                assert_eq!(result.content, template.replace("SOURCE", target), "{content}");
+            }
+        }
+    }
+
+    #[test]
+    fn test_vitest_v5_removed_entry_points_are_preserved() {
+        for source in [
+            "vitest/runners",
+            "vitest/suite",
+            "vitest/internal/module-runner",
+            "vitest/plugins/expect",
+            "vitest/unknown",
+        ] {
+            let content = format!("import {{ value }} from '{source}';");
+            let result = rewrite_import_content(&content, &SkipPackages::default()).unwrap();
+            assert!(!result.updated, "{source}");
+            assert_eq!(result.content, content);
+        }
     }
 }
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 293673f43f..6428608b2b 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -55,7 +55,10 @@ const guideSidebar = [
       {
         text: 'Migrate to Vite+',
         link: '/guide/migrate',
-        items: [{ text: 'Migration Rules', link: '/guide/migrate-rules' }],
+        items: [
+          { text: 'Migration Rules', link: '/guide/migrate-rules' },
+          { text: 'Upgrade to Vitest 5', link: '/guide/vitest-v5' },
+        ],
       },
       { text: 'Installing Dependencies', link: '/guide/install' },
       { text: 'Environment', link: '/guide/env' },
diff --git a/docs/guide/migrate.md b/docs/guide/migrate.md
index a4640170c0..6b2e8c6cff 100644
--- a/docs/guide/migrate.md
+++ b/docs/guide/migrate.md
@@ -58,6 +58,8 @@ rewrite, and package-manager behavior.
 
 Most projects will require further manual adjustments after running `vp migrate`.
 
+For the Vitest v5 upgrade, read the [compatibility settings and review checklist](./vitest-v5.md). The preflight checks your original runner version and Node runtime before dependency updates. Keep the original lockfile available and resolve blocking findings before retrying.
+
 ## Recommended Workflow
 
 Before running the migration:
@@ -85,7 +87,7 @@ You need to add overrides to your package manager so that other packages resolve
 ```json
 "overrides": {
   "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-  "vitest": "4.1.11"
+  "vitest": "5.0.0"
 }
 ```
 
@@ -94,7 +96,7 @@ If you are using `pnpm`, add this to your `pnpm-workspace.yaml`:
 ```yaml
 overrides:
   vite: npm:@voidzero-dev/vite-plus-core@latest
-  vitest: 4.1.11
+  vitest: 5.0.0
 ```
 
 Or, if you are using Yarn:
@@ -102,7 +104,7 @@ Or, if you are using Yarn:
 ```json
 "resolutions": {
   "vite": "npm:@voidzero-dev/vite-plus-core@latest",
-  "vitest": "4.1.11"
+  "vitest": "5.0.0"
 }
 ```
 
diff --git a/docs/guide/test.md b/docs/guide/test.md
index 3ab3aa3c81..4c1840a9f3 100644
--- a/docs/guide/test.md
+++ b/docs/guide/test.md
@@ -2,6 +2,8 @@
 
 `vp test` runs tests with [Vitest](https://vitest.dev).
 
+The bundled runner uses Vitest `5.0.0` and requires Node `^22.18.0 || ^24.11.0 || >=26.0.0`. For existing projects, follow [Upgrade to Vitest 5](./vitest-v5.md) before updating dependencies.
+
 ## Overview
 
 `vp test` is built on [Vitest](https://vitest.dev/), so you get a Vite-native test runner that reuses your Vite config and plugins, supports Jest-style expectations, snapshots, and coverage, and handles modern ESM, TypeScript, and JSX projects cleanly.
diff --git a/docs/guide/vitest-v5.md b/docs/guide/vitest-v5.md
new file mode 100644
index 0000000000..fe51bae954
--- /dev/null
+++ b/docs/guide/vitest-v5.md
@@ -0,0 +1,138 @@
+# Upgrade to Vitest 5
+
+Vite+ bundles Vitest `5.0.0`. Use Node `^22.18.0 || ^24.11.0 || >=26.0.0` for the CLI and tests. Node 20 and Node 25 cannot run this toolchain.
+
+Run `vp migrate` from the workspace root before updating dependencies by hand. Keep the original lockfile and installed packages available so the migration can identify the source Vitest version, including the runner inside an older `vite-plus` installation.
+
+```bash
+vp migrate
+vp install
+vp check
+vp test
+```
+
+Read the file-specific review report before committing the result. The migration stops before dependency updates for an incompatible runtime, conflicting `test.api` and `test.browser.api` settings, or removed runtime APIs without a supported replacement. Resolve these blockers and run the command again. You can finish safe edits with a successful exit status while review items remain.
+
+Keep your library's public `engines.node` contract separate from its test runtime. Use `vp env pin 22 --force` to change a Vite+ runtime pin after choosing a supported Node line. Review `.nvmrc`, `devEngines.runtime`, CI matrices, and Node container images too.
+
+## Preserve existing behavior
+
+For v4 configs, the migration adds compatibility settings where you omitted the corresponding option. Explicit settings take precedence.
+
+| Setting                              | Reason to retain it during the upgrade                                 |
+| ------------------------------------ | ---------------------------------------------------------------------- |
+| `test.clearMocks: false`             | Retain mock history from setup files, `beforeAll`, and earlier tests.  |
+| `test.sharedViteServer: false`       | Retain separate servers for inline projects.                           |
+| Inline `extends: false`              | Retain v4's lack of root-config inheritance.                           |
+| `browser.locators.exact: false`      | Retain partial and case-insensitive locator matching.                  |
+| Reporter `{ stdout: true }`          | Retain stdout for JSON/JUnit reporters without an output file.         |
+| Glob threshold `perFile: true`       | Retain enforcement inherited from `coverage.thresholds.perFile` in v4. |
+| `fakeTimers.toNotFake: ['Temporal']` | Retain fake-timer behavior with a global Temporal polyfill.            |
+
+New projects use v5 defaults. After the existing suite passes, remove compatibility settings one at a time to adopt those defaults.
+
+The Vitest pass leaves configless projects without a config. In interactive mode, you can confirm a separate action to create a minimal compatibility config. A new config can change config discovery and project structure. Other migration steps, such as merging lint configuration, can create `vite.config.ts`; the v4 compatibility settings apply to that new config during the same migration.
+
+Commit `.vite-plus/migrations.json` with the migration. It records the completed versioned pass, including configless projects. Later runs retain your v5 choices and continue to report unresolved risks. Do not delete this state to suppress review items.
+
+## Source changes
+
+The migration uses syntax and import bindings for targeted edits. You get a review item for dynamic options, ambiguous wrappers, or a callback whose contract cannot accept `async`.
+
+```ts
+// Before
+test.sequential('result', () => {
+  expect(result).resolves.toBe(42);
+});
+
+// After
+test('result', { concurrent: false }, async () => {
+  await expect(result).resolves.toBe(42);
+});
+```
+
+In browser tests, use `toMatchTextContent` for v4 string and regular-expression assertions. The v4 string matcher accepted partial text, so identical text in a fixture does not prove that you intended v5's exact match. Choose `toHaveTextContent` yourself if you want the new semantics.
+
+Keep Node `@testing-library/jest-dom` assertions unchanged. In a mixed Node/browser package, the migration checks static project membership before renaming a matcher. You must review shared files, dynamic configs, and command-line browser overrides. Calls through `expect.element()` identify browser assertions without that ambiguity.
+
+Await `render` from `vitest-browser-vue` and `vitest-browser-svelte` before querying its result. Replace `toThrow('')` and `toThrowError('')` with `/^$/` to keep assertions for an empty message.
+
+For programmatic config loading, replace `{ viteConfig, vitestConfig }` destructuring with the return value from `resolveConfig()` and its `.test` property. Direct migrated `vitest list` commands get `--no-static-parse`; supported `Vitest.collect(filters, options)` calls get `{ staticParse: false }`. Keep an explicit static-parse choice if you want v5's static collection.
+
+## Entry points and packages
+
+Use `vite-plus/test` for assertions and supported runner APIs. Keep coverage providers and `@vitest/ui` at the bundled runner's exact version, `5.0.0`. Keep `@vitest/web-worker` aligned when your project uses it.
+
+| v4 import                                | v5 import or action                                                         |
+| ---------------------------------------- | --------------------------------------------------------------------------- |
+| `vitest/coverage`, `vitest/reporters`    | `vite-plus/test/node`                                                       |
+| `vitest/environments`, `vitest/snapshot` | `vite-plus/test/runtime`                                                    |
+| `vitest/mocker`                          | `vite-plus/test/mocker`                                                     |
+| `vitest/runners`, `vitest/suite`         | Review `TestRunner` and its static methods from `vite-plus/test`.           |
+| Root-compatible `@vitest/expect` symbols | `vite-plus/test`; review unsupported helpers.                               |
+| `@vitest/runner`                         | Migrate supported symbols to the root API and review the remaining imports. |
+| `vitest/internal/module-runner`          | Redesign the integration; no public replacement exists.                     |
+| `@vitest/ws-client`                      | Review the integration; upstream no longer adds v5 features.                |
+
+Vite+ retains `vite-plus/test/coverage`, `/reporters`, `/environments`, `/snapshot`, and `/mocker` aliases through the Vite+ 1.x line. It does not provide partial runner or expect plugin shims.
+
+The community maintains `@vitest/browser-webdriverio` on its own release schedule. Install a compatible peer and check browser behavior; do not force its version to match the official package patch version. The selected compatibility baseline is `5.0.0-rc.1`.
+
+Vitest `5.0.0` Preview fails locator clicks with real timers because its user-event adapter advances fake timers without checking whether they are enabled. This upstream issue blocks the stable rollout. Use Playwright or retain a v4-based Vite+ release while the issue remains open. Enabling fake timers changes test behavior and does not resolve the release blocker.
+
+Vitest `5.0.0` also assigns JSON-encoded Vite `define` values to browser globals without decoding them. For example, a string can contain extra quotes, and a boolean can remain a string. This issue also blocks the rollout. Keep affected projects on the v4-based release until the browser assertions pass with an upstream fix or an approved compatibility patch.
+
+## Reports and screenshots
+
+Update CI uploads, report consumers, and merge commands to use these paths. Keep old ignore entries while files remain in those directories. The migration adds `.vitest/` to `.gitignore` without deleting old entries.
+
+| Output              | v4 default                    | v5 default                                 |
+| ------------------- | ----------------------------- | ------------------------------------------ |
+| Attachments         | `.vitest-attachements/`       | `.vitest/attachments/`                     |
+| Failure screenshots | `__screenshots__/`            | `.vitest/attachments/failure-screenshots/` |
+| Blob reports        | `.vitest-reports/blob-*.json` | `.vitest/blob/blob-*.json`                 |
+| HTML                | `html/index.html`             | `.vitest/index.html`                       |
+| JSON                | stdout                        | `.vitest/json/output.json`                 |
+| JUnit               | stdout                        | `.vitest/junit/output.xml`                 |
+
+HTML reporter options now use `outputDir` instead of the file-valued `outputFile`. The migration converts an `index.html` path to its parent directory and reports custom filenames for review. Other reporters retain `outputFile` support.
+
+Copy a custom `browser.screenshotDirectory` to `browser.expect.toMatchScreenshot.screenshotDirectory`. Review reference images before moving or regenerating them; v4 could save them in an unintended location. The default reference screenshot directory remains `__screenshots__`.
+
+## Review checklist
+
+Use the file locations in the migration report to review these changes. Run browser and coverage suites as well as Node tests.
+
+For jest-dom matcher types, load `@testing-library/jest-dom/vitest` in `compilerOptions.types` or import it from a TypeScript setup file that your `tsconfig.json` includes. The root `@testing-library/jest-dom` type entry augments Jest. A JavaScript setup file excluded by `allowJs: false` does not load the Vitest augmentation for type checking. Review shared Jest/Vitest configs before changing their type entries.
+
+With `vitest@5.0.0`, loading browser declarations first can also make TypeScript reject valid Node jest-dom assertions: `toHaveTextContent(/pattern/)` and CSS custom properties in `toHaveStyle()`. We reproduced this conflict with upstream imports and with Vite+ imports. Both `@testing-library/jest-dom@6.9.1` and `7.0.1` reproduce it. Check the declarations loaded by each test `tsconfig.json`; adding the jest-dom type entry alone might not resolve the conflict. Keep the affected project on the v4-based release until its Node and browser matcher types pass separate checks.
+
+| Area                     | Required review                                                                                                                                                                                            |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Test names and snapshots | Full names use `>` separators. Check `-t` patterns, `test.each`/`test.for` titles, and `pretty-format` output.                                                                                             |
+| Hoisted mocks            | Move nested `vi.mock`, `vi.unmock`, and `vi.hoisted` calls to the top level after checking captured variables.                                                                                             |
+| Browser automocks        | Factory-free mocks retain mock defaults. Choose `{ spy: true }` if you need real implementations.                                                                                                          |
+| Constructor mocks        | Check prototypes, methods, and `instanceof` for `vi.fn`, `vi.spyOn`, and `mockImplementation`.                                                                                                             |
+| Benchmarks               | Replace top-level `bench` and removed benchmark reporting options with the `bench` test-context fixture and regular reporters. Keep supported options such as `benchmark.enabled` and `benchmark.include`. |
+| Async assertions         | Await or return `resolves`, `rejects`, file snapshots, polls, and browser assertions. Review `expect.poll` timeouts without increasing them to hide failures.                                              |
+| Matcher types            | Update old `Assertion<T>`, `Matchers<T>`, and `jest.Matchers` declarations for return and received type parameters.                                                                                        |
+| Browser commands         | Accept `SerializedLocator` objects instead of selector strings.                                                                                                                                            |
+| Browser UI               | Use Vitest's printed URLs, including UI tokens and orchestrator `sessionId`. Check headed/headless screenshots at fixed viewports.                                                                         |
+| Project configuration    | Check dynamic projects, root-config merges, nested projects, and hooks that assume one server or config execution per project.                                                                             |
+| Test collection          | Review dynamic command wrappers and programmatic `collect()` calls whose static-parse options need manual edits.                                                                                           |
+| Coverage                 | Compare v4/v5 resolved file sets for configured `coverage.include` and `coverage.exclude`. Relative-path matching can change the measured set.                                                             |
+| Worker IDs               | Review arithmetic and indexing based on `VITEST_POOL_ID` or `VITEST_WORKER_ID`; IDs start at 1.                                                                                                            |
+| Custom environments      | Restore `populateGlobal().originals` entries with `Object.defineProperty`; the map contains descriptors.                                                                                                   |
+| DOM globals              | Check assignments in jsdom/happy-dom tests; global assignments also update the window.                                                                                                                     |
+| Temporal                 | Review scopes that use Temporal and `vi.setSystemTime()`. `toNotFake` does not preserve behavior without fake timers.                                                                                      |
+| Removed APIs             | Replace unsupported runner and internal imports before updating packages. Type-only references still require review and type checks.                                                                       |
+
+## Run below a config directory
+
+Vitest v5 no longer searches parent directories for a config. From a subdirectory, pass both the parent config and the intended test directory:
+
+```bash
+vp test --config ../vite.config.ts --dir .
+```
+
+See the [upstream Vitest 5 migration guide](https://vitest.dev/guide/migration/) for API examples and the new benchmark design.
diff --git a/ecosystem-ci/patch-project.ts b/ecosystem-ci/patch-project.ts
index df86e933fd..33a67ac4df 100644
--- a/ecosystem-ci/patch-project.ts
+++ b/ecosystem-ci/patch-project.ts
@@ -248,14 +248,14 @@ if (project === 'nuxt-devtools') {
 // vp migrate runs full dependency rewriting instead of skipping.
 const forceFreshMigration = 'forceFreshMigration' in repoConfig && repoConfig.forceFreshMigration;
 
-// Mirror VITE_PLUS_OVERRIDE_PACKAGES: pin `vitest` only. The `@vitest/*` family
-// are exact deps of `vitest`, so a single `vitest` override cascades them.
+// Mirror VITE_PLUS_OVERRIDE_PACKAGES: pin `vitest` only. Vitest pins its
+// internal dependencies; the migration aligns optional browser providers.
 //
 // Coverage providers are intentionally NOT in the shipped override map (the
 // product leaves them user-owned; the runtime guard fail-fasts on a skew). But
 // this rig FORCE-INSTALLS the locally built vitest, and many ecosystem projects
 // pin an older `@vitest/coverage-*` in their lockfile. Without alignment, the
-// forced runner (4.1.9) skews from the project's pinned provider and the guard
+// forced runner skews from the project's pinned provider and the guard
 // aborts `vp test --coverage` — testing an incoherent combo no real install has.
 // Pin the providers here so the E2E coverage step runs against a consistent
 // runner+provider pair, exactly as a user who followed the guard's advice would.
@@ -308,6 +308,26 @@ execSync(`${cli} migrate --no-agent --no-interactive`, {
   env: migrateEnv,
 });
 
+if (project === 'bun-vite-template') {
+  // The pinned template runs Vitest only. Its JS setup file loads jest-dom's
+  // Vitest runtime, but allowJs: false excludes that file from type checking.
+  // Apply the migration report's manual type-entry repair for this fixture.
+  const tsconfigPath = join(repoRoot, 'tsconfig.json');
+  const tsconfig = JSON.parse(await readFile(tsconfigPath, 'utf-8'));
+  const types = tsconfig.compilerOptions?.types;
+  if (
+    !Array.isArray(types) ||
+    !types.includes('vitest/globals') ||
+    !types.includes('@testing-library/jest-dom')
+  ) {
+    throw new Error('bun-vite-template patch: expected the pinned Jest DOM type configuration');
+  }
+  tsconfig.compilerOptions.types = types.map((type) =>
+    type === '@testing-library/jest-dom' ? '@testing-library/jest-dom/vitest' : type,
+  );
+  await writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`);
+}
+
 if (project === 'tiptap') {
   // Keep Tiptap's upstream lint semantics. Migration enables type-aware type
   // checking, which reports TypeScript diagnostics that upstream CI does not check.
diff --git a/package.json b/package.json
index 092589edd2..9426e15d8e 100644
--- a/package.json
+++ b/package.json
@@ -16,6 +16,7 @@
     "test": "vp test && just snapshot-test",
     "snapshot-test": "just snapshot-test",
     "test:unit": "vp test",
+    "test:vendored": "node packages/tools/src/test-vendored-vitest.ts",
     "fmt": "vp fmt",
     "docs:dev": "pnpm -C docs dev",
     "docs:build": "pnpm -C docs build",
diff --git a/packages/cli/BUNDLING.md b/packages/cli/BUNDLING.md
index 87c16a5564..04852669ad 100644
--- a/packages/cli/BUNDLING.md
+++ b/packages/cli/BUNDLING.md
@@ -106,6 +106,37 @@ export type * from 'vite/types/importMeta.d.ts';
 
 Reads vitest's exports plus the three `@vitest/browser-*` provider packages and creates shim files that re-export everything under `./test/*`:
 
+Ship `vite` as a dependency alias for the same `@voidzero-dev/vite-plus-core` version. Vitest v5 requires a `vite` peer. Yarn users must be able to install `vite-plus` without adding `vite` or `vitest` to their project. Keep the alias in `dependencies`, not `devDependencies`.
+
+The main surface mirrors Vitest `5.0.0`, except for package metadata and wildcard
+exports. The final export keys are snapshotted in the export tests. The following
+paths are Vite+ compatibility contracts through the `1.x` release line:
+
+| Compatibility path                                       | Public upstream target |
+| -------------------------------------------------------- | ---------------------- |
+| `vite-plus/test/coverage`, `vite-plus/test/reporters`    | `vitest/node`          |
+| `vite-plus/test/environments`, `vite-plus/test/snapshot` | `vitest/runtime`       |
+| `vite-plus/test/mocker`                                  | `@vitest/mocker`       |
+
+Provider paths and `browser/providers/*` aliases remain available. WebDriverIO
+is a community-maintained optional peer with its own compatible range; the
+build checks the selected provider's Vitest peer before generating its shims.
+The `plugins/*` compatibility paths mirror public exports of their named
+standalone packages and retain upstream type declarations.
+
+Removed runner, suite, expect-plugin, and internal module-runner paths have no
+partial shim. Use `TestRunner` and `expect` from `vite-plus/test` where the root
+API supports the old symbol. The migration reports uses without a replacement.
+The resolver uses an explicit package allowlist, so standalone `@vitest/expect`,
+deprecated `@vitest/ws-client`, and `@vitest/istanbul-lib-*` dependencies keep
+their own project resolution.
+
+Inline projects inherit the declaring config's Vite+ plugins. Independent
+projects (`extends: false` or an external base) receive their own plugins.
+Referenced configs that use `defineConfig` or `defineProject` receive the same
+integration, including nested projects. Raw referenced configs retain upstream
+resolution and its soft coverage-version warning when no Vite+ hook runs.
+
 ```typescript
 // For each vitest export like "./node"
 // Creates a shim file: dist/test/node.js
@@ -386,6 +417,8 @@ In addition to vitest's own exports, the three `@vitest/browser-*` provider pack
 
 Each provider's own subpaths (e.g. `./context`) are mirrored under both alias prefixes.
 
+Browser-context runtime aliases re-export `vitest/browser`, the virtual entry used by Vitest v5. This applies to provider `/context` paths, `./test/browser/context`, `./test/context`, and `./test/plugins/browser-context`. Their declarations retain the upstream browser-context types and module augmentations. The upstream `@vitest/browser/context` JavaScript file is now an error stub, not the browser runtime.
+
 > **Note — webdriverio and playwright are opt-in.** `@vitest/browser` (base) and `@vitest/browser-preview` stay bundled **runtime dependencies** of `vite-plus` (and are stripped from users' manifests during migration) because neither carries a heavy non-optional peer. `@vitest/browser-webdriverio` and `@vitest/browser-playwright` are now vite-plus **devDependencies + optional peerDependencies** — each is kept as a devDependency so build-time shim generation can still emit the `./test/browser-webdriverio*` / `./test/browser-playwright*` exports (the export/shim surfaces above are unchanged), but neither is a bundled runtime dep. They are optional peers because each drags a non-optional framework peer (`webdriverio` / `playwright`) that non-browser consumers must not be forced to install. Users targeting a provider instead **keep** it in their **own** dependencies via `vp migrate` (pinned to the bundled vitest version, with its framework peer ensured), so their rewritten `vite-plus/test/browser-webdriverio` / `vite-plus/test/browser-playwright` imports resolve.
 
 #### Why provider d.ts shims are inlined
diff --git a/packages/cli/build.ts b/packages/cli/build.ts
index e64ec88014..5b8fa65f8b 100644
--- a/packages/cli/build.ts
+++ b/packages/cli/build.ts
@@ -28,9 +28,11 @@ import { parseArgs } from 'node:util';
 
 import { createBuildCommand, NapiCli } from '@napi-rs/cli';
 import { format } from 'oxfmt';
+import { satisfies } from 'semver';
 
 import { generateLicenseFile } from '../../scripts/generate-license.js';
 import corePkg from '../core/package.json' with { type: 'json' };
+import { VITEST_WEBDRIVERIO_RANGE, VITEST_VERSION } from './src/utils/constants.ts';
 
 const projectDir = dirname(fileURLToPath(import.meta.url));
 const TEST_PACKAGE_NAME = 'vitest';
@@ -53,9 +55,6 @@ const BROWSER_PROVIDER_PACKAGES: ReadonlyArray<{ pkg: string; short: string }> =
 // `./test/plugins/<name>` to restore the surface that the removed
 // `@voidzero-dev/vite-plus-test` wrapper previously exposed.
 const PLUGIN_SHIM_ENTRIES: ReadonlyArray<readonly [importSpecifier: string, pluginName: string]> = [
-  ['@vitest/runner', 'runner'],
-  ['@vitest/runner/utils', 'runner-utils'],
-  ['@vitest/runner/types', 'runner-types'],
   ['@vitest/utils', 'utils'],
   ['@vitest/utils/source-map', 'utils-source-map'],
   ['@vitest/utils/source-map/node', 'utils-source-map-node'],
@@ -69,7 +68,6 @@ const PLUGIN_SHIM_ENTRIES: ReadonlyArray<readonly [importSpecifier: string, plug
   ['@vitest/utils/constants', 'utils-constants'],
   ['@vitest/utils/diff', 'utils-diff'],
   ['@vitest/spy', 'spy'],
-  ['@vitest/expect', 'expect'],
   ['@vitest/snapshot', 'snapshot'],
   ['@vitest/snapshot/environment', 'snapshot-environment'],
   ['@vitest/snapshot/manager', 'snapshot-manager'],
@@ -90,6 +88,16 @@ const PLUGIN_SHIM_ENTRIES: ReadonlyArray<readonly [importSpecifier: string, plug
   ['@vitest/browser-preview', 'browser-preview'],
 ];
 
+// Public Vite+ 1.x contracts with complete v5 targets. Removed runner and
+// expect entry points deliberately have no partial compatibility shim.
+const TEST_COMPATIBILITY_EXPORTS: ReadonlyArray<readonly [string, string]> = [
+  ['coverage', 'vitest/node'],
+  ['reporters', 'vitest/node'],
+  ['environments', 'vitest/runtime'],
+  ['snapshot', 'vitest/runtime'],
+  ['mocker', '@vitest/mocker'],
+];
+
 /**
  * Vitest-related bare specifiers that appear in `@vitest/browser-*` d.ts files
  * and the sub-path under `dist/test/` whose shim re-exports the same module.
@@ -362,6 +370,9 @@ async function syncTestPackageExports() {
 
   // Read test package.json
   const testPkg = JSON.parse(await readFile(testPkgPath, 'utf-8'));
+  if (testPkg.version !== VITEST_VERSION) {
+    throw new Error(`Expected vitest@${VITEST_VERSION}, found ${testPkg.version}`);
+  }
   const testExports = testPkg.exports as Record<string, unknown>;
 
   // Clean up previous build
@@ -395,6 +406,15 @@ async function syncTestPackageExports() {
     }
   }
 
+  for (const [name, specifier] of TEST_COMPATIBILITY_EXPORTS) {
+    generatedExports[`./test/${name}`] = await createShimForExport(
+      name,
+      { types: './index.d.ts', default: './index.js' },
+      specifier,
+      testDistDir,
+    );
+  }
+
   // Private shims for `@vitest/browser` and `@vitest/browser/context`. These
   // are referenced as relative paths from the inlined browser-provider d.ts
   // shims so that `@vitest/browser` resolves through vite-plus's own pnpm-edge
@@ -415,6 +435,15 @@ async function syncTestPackageExports() {
       continue;
     }
     const providerPkg = JSON.parse(await readFile(providerPkgPath, 'utf-8'));
+    if (
+      short === 'webdriverio' &&
+      (!satisfies(providerPkg.version, VITEST_WEBDRIVERIO_RANGE) ||
+        !satisfies(testPkg.version, providerPkg.peerDependencies?.vitest ?? ''))
+    ) {
+      throw new Error(
+        `${pkg}@${providerPkg.version} is incompatible with vitest@${testPkg.version}`,
+      );
+    }
     const providerPkgRoot = dirname(providerPkgPath);
     const providerExports = (providerPkg.exports ?? {}) as Record<string, unknown>;
 
@@ -494,9 +523,18 @@ async function syncTestPackageExports() {
   console.log('  Created ./test/browser-compat');
 
   for (const [importSpecifier, pluginName] of PLUGIN_SHIM_ENTRIES) {
+    const [scope, name, ...subpath] = importSpecifier.split('/');
+    const packageName = `${scope}/${name}`;
+    const packagePath = require.resolve(`${packageName}/package.json`, { paths: [projectDir] });
+    const packageJson = JSON.parse(await readFile(packagePath, 'utf8'));
+    const exportKey = subpath.length ? `./${subpath.join('/')}` : '.';
+    const exportValue = packageJson.exports?.[exportKey];
+    if (!exportValue) {
+      throw new Error(`Missing public export ${importSpecifier} for ./test/plugins/${pluginName}`);
+    }
     const shimExport = await createShimForExport(
       `plugins/${pluginName}`,
-      `${pluginName}.js`,
+      exportValue,
       importSpecifier,
       testDistDir,
     );
@@ -1006,8 +1044,8 @@ async function writePrivateAtVitestBrowserShims(testDistDir: string): Promise<vo
  * migration rewrites `@vitest/browser-<provider>/context` →
  * `vite-plus/test/browser-<provider>/context`, Node ESM resolution fails with
  * ERR_PACKAGE_PATH_NOT_EXPORTED unless the export entry has a `default`/`import`
- * target. We re-export from `@vitest/browser/context` so the bundled
- * `@vitest/browser` (vite-plus's own pnpm-edge) is reached at runtime.
+ * target. Re-export from `vitest/browser`, the v5 virtual runtime entry.
+ * `@vitest/browser/context` now contains a context-error stub even in a browser.
  */
 async function ensureContextRuntimeShim(
   shimBaseName: string,
@@ -1024,7 +1062,7 @@ async function ensureContextRuntimeShim(
   const jsRelPath = `./dist/test/${shimBaseName}.js`;
   const jsAbsPath = join(testDistDir, `${shimBaseName}.js`);
   await mkdir(dirname(jsAbsPath), { recursive: true });
-  await writeFile(jsAbsPath, `export * from '@vitest/browser/context';\n`);
+  await writeFile(jsAbsPath, `export * from 'vitest/browser';\n`);
   entry.default = jsRelPath;
 }
 
@@ -1034,12 +1072,13 @@ async function ensureContextRuntimeShim(
  * Vitest's package.json only exposes `./browser` (mapped to `./test/browser`).
  * The migration rewrites `@vitest/browser/context` →
  * `vite-plus/test/browser/context`, so we add this path with both runtime and
- * type targets that re-export from `@vitest/browser/context`.
+ * type targets. Runtime imports use the v5 `vitest/browser` virtual module;
+ * types retain the upstream browser-context declarations and augmentations.
  */
 async function createBrowserContextExport(testDistDir: string): Promise<ExportValue> {
   const dir = join(testDistDir, 'browser');
   await mkdir(dir, { recursive: true });
-  await writeFile(join(dir, 'context.js'), `export * from '@vitest/browser/context';\n`);
+  await writeFile(join(dir, 'context.js'), `export * from 'vitest/browser';\n`);
   await writeFile(
     join(dir, 'context.d.ts'),
     `import '@vitest/browser/context';\nexport * from '@vitest/browser/context';\n`,
@@ -1165,6 +1204,10 @@ async function createShimForExport(
 
   const baseFileName = shimBaseName.includes('/') ? shimBaseName.split('/').pop()! : shimBaseName;
   const shimDirForFile = shimBaseName.includes('/') ? shimDir : distDir;
+  // Preserve the Vite+ browser-context aliases after v5 moved the virtual
+  // module. Keep the original type specifier for module augmentations.
+  const runtimeSpecifier =
+    testImportSpecifier === '@vitest/browser/context' ? 'vitest/browser' : testImportSpecifier;
 
   // Handle different export value formats
   if (typeof exportValue === 'string') {
@@ -1180,7 +1223,7 @@ async function createShimForExport(
     }
 
     const jsPath = join(shimDirForFile, `${baseFileName}.js`);
-    await writeFile(jsPath, `export * from '${testImportSpecifier}';\n`);
+    await writeFile(jsPath, `export * from '${runtimeSpecifier}';\n`);
     return { default: `./dist/test/${shimBaseName}.js` };
   }
 
@@ -1214,7 +1257,7 @@ async function createShimForExport(
 
     if (value.default && typeof value.default === 'string') {
       const jsPath = join(shimDirForFile, `${baseFileName}.js`);
-      await writeFile(jsPath, `export * from '${testImportSpecifier}';\n`);
+      await writeFile(jsPath, `export * from '${runtimeSpecifier}';\n`);
       (result as Record<string, string>).default = `./dist/test/${shimBaseName}.js`;
     }
 
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 0be80d5ab2..90fb4159e9 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -132,23 +132,22 @@
       "types": "./dist/test/internal/browser.d.ts",
       "default": "./dist/test/internal/browser.js"
     },
-    "./test/runners": {
-      "types": "./dist/test/runners.d.ts",
-      "default": "./dist/test/runners.js"
-    },
-    "./test/suite": {
-      "types": "./dist/test/suite.d.ts",
-      "default": "./dist/test/suite.js"
-    },
-    "./test/environments": {
-      "types": "./dist/test/environments.d.ts",
-      "default": "./dist/test/environments.js"
+    "./test/internal/traces": {
+      "default": "./dist/test/internal/traces.js"
     },
     "./test/config": {
       "types": "./dist/test/config.d.ts",
       "require": "./dist/test/config.cjs",
       "default": "./dist/test/config.js"
     },
+    "./test/runtime": {
+      "types": "./dist/test/runtime.d.ts",
+      "default": "./dist/test/runtime.js"
+    },
+    "./test/worker": {
+      "types": "./dist/test/worker.d.ts",
+      "default": "./dist/test/worker.js"
+    },
     "./test/coverage": {
       "types": "./dist/test/coverage.d.ts",
       "default": "./dist/test/coverage.js"
@@ -157,17 +156,17 @@
       "types": "./dist/test/reporters.d.ts",
       "default": "./dist/test/reporters.js"
     },
+    "./test/environments": {
+      "types": "./dist/test/environments.d.ts",
+      "default": "./dist/test/environments.js"
+    },
     "./test/snapshot": {
       "types": "./dist/test/snapshot.d.ts",
       "default": "./dist/test/snapshot.js"
     },
-    "./test/runtime": {
-      "types": "./dist/test/runtime.d.ts",
-      "default": "./dist/test/runtime.js"
-    },
-    "./test/worker": {
-      "types": "./dist/test/worker.d.ts",
-      "default": "./dist/test/worker.js"
+    "./test/mocker": {
+      "types": "./dist/test/mocker.d.ts",
+      "default": "./dist/test/mocker.js"
     },
     "./test/browser-playwright": {
       "types": "./dist/test/browser-playwright.d.ts",
@@ -243,109 +242,127 @@
       "types": "./dist/test/browser-compat.d.ts",
       "default": "./dist/test/browser-compat.js"
     },
-    "./test/plugins/runner": {
-      "default": "./dist/test/plugins/runner.js"
-    },
-    "./test/plugins/runner-utils": {
-      "default": "./dist/test/plugins/runner-utils.js"
-    },
-    "./test/plugins/runner-types": {
-      "default": "./dist/test/plugins/runner-types.js"
-    },
     "./test/plugins/utils": {
+      "types": "./dist/test/plugins/utils.d.ts",
       "default": "./dist/test/plugins/utils.js"
     },
     "./test/plugins/utils-source-map": {
+      "types": "./dist/test/plugins/utils-source-map.d.ts",
       "default": "./dist/test/plugins/utils-source-map.js"
     },
     "./test/plugins/utils-source-map-node": {
+      "types": "./dist/test/plugins/utils-source-map-node.d.ts",
       "default": "./dist/test/plugins/utils-source-map-node.js"
     },
     "./test/plugins/utils-error": {
+      "types": "./dist/test/plugins/utils-error.d.ts",
       "default": "./dist/test/plugins/utils-error.js"
     },
     "./test/plugins/utils-helpers": {
+      "types": "./dist/test/plugins/utils-helpers.d.ts",
       "default": "./dist/test/plugins/utils-helpers.js"
     },
     "./test/plugins/utils-display": {
+      "types": "./dist/test/plugins/utils-display.d.ts",
       "default": "./dist/test/plugins/utils-display.js"
     },
     "./test/plugins/utils-timers": {
+      "types": "./dist/test/plugins/utils-timers.d.ts",
       "default": "./dist/test/plugins/utils-timers.js"
     },
     "./test/plugins/utils-offset": {
+      "types": "./dist/test/plugins/utils-offset.d.ts",
       "default": "./dist/test/plugins/utils-offset.js"
     },
     "./test/plugins/utils-resolver": {
+      "types": "./dist/test/plugins/utils-resolver.d.ts",
       "default": "./dist/test/plugins/utils-resolver.js"
     },
     "./test/plugins/utils-serialize": {
+      "types": "./dist/test/plugins/utils-serialize.d.ts",
       "default": "./dist/test/plugins/utils-serialize.js"
     },
     "./test/plugins/utils-constants": {
+      "types": "./dist/test/plugins/utils-constants.d.ts",
       "default": "./dist/test/plugins/utils-constants.js"
     },
     "./test/plugins/utils-diff": {
+      "types": "./dist/test/plugins/utils-diff.d.ts",
       "default": "./dist/test/plugins/utils-diff.js"
     },
     "./test/plugins/spy": {
+      "types": "./dist/test/plugins/spy.d.ts",
       "default": "./dist/test/plugins/spy.js"
     },
-    "./test/plugins/expect": {
-      "default": "./dist/test/plugins/expect.js"
-    },
     "./test/plugins/snapshot": {
+      "types": "./dist/test/plugins/snapshot.d.ts",
       "default": "./dist/test/plugins/snapshot.js"
     },
     "./test/plugins/snapshot-environment": {
+      "types": "./dist/test/plugins/snapshot-environment.d.ts",
       "default": "./dist/test/plugins/snapshot-environment.js"
     },
     "./test/plugins/snapshot-manager": {
+      "types": "./dist/test/plugins/snapshot-manager.d.ts",
       "default": "./dist/test/plugins/snapshot-manager.js"
     },
     "./test/plugins/mocker": {
+      "types": "./dist/test/plugins/mocker.d.ts",
       "default": "./dist/test/plugins/mocker.js"
     },
     "./test/plugins/mocker-node": {
+      "types": "./dist/test/plugins/mocker-node.d.ts",
       "default": "./dist/test/plugins/mocker-node.js"
     },
     "./test/plugins/mocker-browser": {
+      "types": "./dist/test/plugins/mocker-browser.d.ts",
       "default": "./dist/test/plugins/mocker-browser.js"
     },
     "./test/plugins/mocker-redirect": {
+      "types": "./dist/test/plugins/mocker-redirect.d.ts",
       "default": "./dist/test/plugins/mocker-redirect.js"
     },
     "./test/plugins/mocker-transforms": {
+      "types": "./dist/test/plugins/mocker-transforms.d.ts",
       "default": "./dist/test/plugins/mocker-transforms.js"
     },
     "./test/plugins/mocker-automock": {
+      "types": "./dist/test/plugins/mocker-automock.d.ts",
       "default": "./dist/test/plugins/mocker-automock.js"
     },
     "./test/plugins/mocker-register": {
+      "types": "./dist/test/plugins/mocker-register.d.ts",
       "default": "./dist/test/plugins/mocker-register.js"
     },
     "./test/plugins/pretty-format": {
+      "types": "./dist/test/plugins/pretty-format.d.ts",
       "default": "./dist/test/plugins/pretty-format.js"
     },
     "./test/plugins/browser": {
+      "types": "./dist/test/plugins/browser.d.ts",
       "default": "./dist/test/plugins/browser.js"
     },
     "./test/plugins/browser-context": {
+      "types": "./dist/test/plugins/browser-context.d.ts",
       "default": "./dist/test/plugins/browser-context.js"
     },
     "./test/plugins/browser-client": {
       "default": "./dist/test/plugins/browser-client.js"
     },
     "./test/plugins/browser-locators": {
+      "types": "./dist/test/plugins/browser-locators.d.ts",
       "default": "./dist/test/plugins/browser-locators.js"
     },
     "./test/plugins/browser-playwright": {
+      "types": "./dist/test/plugins/browser-playwright.d.ts",
       "default": "./dist/test/plugins/browser-playwright.js"
     },
     "./test/plugins/browser-webdriverio": {
+      "types": "./dist/test/plugins/browser-webdriverio.d.ts",
       "default": "./dist/test/plugins/browser-webdriverio.js"
     },
     "./test/plugins/browser-preview": {
+      "types": "./dist/test/plugins/browser-preview.d.ts",
       "default": "./dist/test/plugins/browser-preview.js"
     }
   },
@@ -361,10 +378,8 @@
     "@oxlint/plugins": "catalog:",
     "@vitest/browser": "catalog:",
     "@vitest/browser-preview": "catalog:",
-    "@vitest/expect": "catalog:",
     "@vitest/mocker": "catalog:",
     "@vitest/pretty-format": "catalog:",
-    "@vitest/runner": "catalog:",
     "@vitest/snapshot": "catalog:",
     "@vitest/spy": "catalog:",
     "@vitest/utils": "catalog:",
@@ -375,10 +390,14 @@
     "vitest": "catalog:"
   },
   "devDependencies": {
+    "@babel/parser": "catalog:",
+    "@babel/traverse": "catalog:",
+    "@babel/types": "catalog:",
     "@emnapi/core": "catalog:",
     "@emnapi/runtime": "catalog:",
     "@napi-rs/cli": "catalog:",
     "@nkzw/safe-word-list": "catalog:",
+    "@types/babel__traverse": "catalog:",
     "@types/cross-spawn": "catalog:",
     "@types/semver": "catalog:",
     "@types/validate-npm-package-name": "catalog:",
@@ -404,7 +423,7 @@
   },
   "peerDependencies": {
     "@vitest/browser-playwright": "catalog:",
-    "@vitest/browser-webdriverio": "catalog:"
+    "@vitest/browser-webdriverio": "^5.0.0-beta.5 || >=5.0.0"
   },
   "peerDependenciesMeta": {
     "@vitest/browser-playwright": {
@@ -429,6 +448,6 @@
     ]
   },
   "engines": {
-    "node": "^20.19.0 || ^22.18.0 || >=24.11.0"
+    "node": "^22.18.0 || ^24.11.0 || >=26.0.0"
   }
 }
diff --git a/packages/cli/src/__tests__/__snapshots__/exports-map.spec.ts.snap b/packages/cli/src/__tests__/__snapshots__/exports-map.spec.ts.snap
new file mode 100644
index 0000000000..4bfd8e07ba
--- /dev/null
+++ b/packages/cli/src/__tests__/__snapshots__/exports-map.spec.ts.snap
@@ -0,0 +1,75 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`package.json exports map > keeps the reviewed Vitest v5 export surface 1`] = `
+[
+  "./test",
+  "./test/browser",
+  "./test/browser-compat",
+  "./test/browser-playwright",
+  "./test/browser-playwright/context",
+  "./test/browser-preview",
+  "./test/browser-preview/context",
+  "./test/browser-webdriverio",
+  "./test/browser-webdriverio/context",
+  "./test/browser/context",
+  "./test/browser/providers/playwright",
+  "./test/browser/providers/playwright/context",
+  "./test/browser/providers/preview",
+  "./test/browser/providers/preview/context",
+  "./test/browser/providers/webdriverio",
+  "./test/browser/providers/webdriverio/context",
+  "./test/client",
+  "./test/config",
+  "./test/context",
+  "./test/coverage",
+  "./test/environments",
+  "./test/globals",
+  "./test/import-meta",
+  "./test/importMeta",
+  "./test/internal/browser",
+  "./test/internal/traces",
+  "./test/jsdom",
+  "./test/locators",
+  "./test/matchers",
+  "./test/mocker",
+  "./test/node",
+  "./test/optional-runtime-types.js",
+  "./test/optional-types.js",
+  "./test/plugins/browser",
+  "./test/plugins/browser-client",
+  "./test/plugins/browser-context",
+  "./test/plugins/browser-locators",
+  "./test/plugins/browser-playwright",
+  "./test/plugins/browser-preview",
+  "./test/plugins/browser-webdriverio",
+  "./test/plugins/mocker",
+  "./test/plugins/mocker-automock",
+  "./test/plugins/mocker-browser",
+  "./test/plugins/mocker-node",
+  "./test/plugins/mocker-redirect",
+  "./test/plugins/mocker-register",
+  "./test/plugins/mocker-transforms",
+  "./test/plugins/pretty-format",
+  "./test/plugins/snapshot",
+  "./test/plugins/snapshot-environment",
+  "./test/plugins/snapshot-manager",
+  "./test/plugins/spy",
+  "./test/plugins/utils",
+  "./test/plugins/utils-constants",
+  "./test/plugins/utils-diff",
+  "./test/plugins/utils-display",
+  "./test/plugins/utils-error",
+  "./test/plugins/utils-helpers",
+  "./test/plugins/utils-offset",
+  "./test/plugins/utils-resolver",
+  "./test/plugins/utils-serialize",
+  "./test/plugins/utils-source-map",
+  "./test/plugins/utils-source-map-node",
+  "./test/plugins/utils-timers",
+  "./test/reporters",
+  "./test/runtime",
+  "./test/snapshot",
+  "./test/utils",
+  "./test/worker",
+]
+`;
diff --git a/packages/cli/src/__tests__/define-config-plugins.spec.ts b/packages/cli/src/__tests__/define-config-plugins.spec.ts
index b9b10b70b3..0967e04fc7 100644
--- a/packages/cli/src/__tests__/define-config-plugins.spec.ts
+++ b/packages/cli/src/__tests__/define-config-plugins.spec.ts
@@ -7,6 +7,7 @@ import {
   checkCoverageProviderVersion,
   computeAutoInlineList,
   defineConfig,
+  defineProject,
   resolveCoverageProviderToCheck,
 } from '../define-config.ts';
 import { VITEST_VERSION } from '../utils/constants.ts';
@@ -38,6 +39,7 @@ describe('defineConfig project plugin injection', () => {
       test: {
         projects: [
           {
+            extends: false,
             plugins: [existing],
             test: { name: 'unit', include: ['test/unit/**/*.spec.ts'], environment: 'node' },
           },
@@ -58,6 +60,7 @@ describe('defineConfig project plugin injection', () => {
   it('injects plugins into the return value of a function-shaped project entry', () => {
     const existing: Plugin = { name: 'user-fn-project-plugin' };
     const projectFn = () => ({
+      extends: false,
       plugins: [existing],
       test: { name: 'nuxt', environment: 'happy-dom' as const },
     });
@@ -93,6 +96,7 @@ describe('defineConfig project plugin injection', () => {
       test: {
         projects: [
           {
+            extends: false,
             test: { name: 'no-plugins', environment: 'node' },
           },
         ],
@@ -106,6 +110,60 @@ describe('defineConfig project plugin injection', () => {
     expect(pluginName(project.plugins[1])).toBe(AUTO_INLINE_PLUGIN_NAME);
     expect(pluginName(project.plugins[2])).toBe(COVERAGE_GUARD_PLUGIN_NAME);
   });
+
+  it.each([undefined, true])('inherits root plugins with extends %s', (extendsRoot) => {
+    const userPlugin = { name: 'user-project' };
+    const project = { extends: extendsRoot, plugins: [userPlugin], test: { name: 'unit' } };
+    const config = defineConfig({ test: { projects: [project] } });
+    expect(config.test?.projects?.[0]).toBe(project);
+    expect(project.plugins).toEqual([userPlugin]);
+  });
+
+  it('resolves inheritance for async functions and promise projects', async () => {
+    const inherited = { test: { name: 'inherited' } };
+    const config = defineConfig({
+      test: {
+        projects: [
+          async () => inherited,
+          Promise.resolve({ extends: false, test: { name: 'independent' } }),
+        ],
+      },
+    });
+    const [fn, promise] = config.test!.projects!;
+    expect(typeof fn).toBe('function');
+    if (typeof fn !== 'function') {
+      throw new Error('Expected project function');
+    }
+    expect(await fn({ command: 'serve', mode: 'test' })).toBe(inherited);
+    const resolved = (await promise) as { plugins: unknown[] };
+    expect(resolved.plugins.map(pluginName)).toEqual([
+      RESOLVER_PLUGIN_NAME,
+      AUTO_INLINE_PLUGIN_NAME,
+      COVERAGE_GUARD_PLUGIN_NAME,
+    ]);
+  });
+
+  it('does not duplicate injected plugins when helpers are composed', () => {
+    const config = defineConfig(defineConfig({ plugins: [{ name: 'user' }] }));
+    expect(config.plugins!.map(pluginName)).toEqual([
+      RESOLVER_PLUGIN_NAME,
+      AUTO_INLINE_PLUGIN_NAME,
+      COVERAGE_GUARD_PLUGIN_NAME,
+      'user',
+    ]);
+  });
+
+  it('injects nested independent projects in referenced defineProject configs', () => {
+    const config = defineProject({
+      test: {
+        projects: [{ extends: false, test: { name: 'child' } }, { test: { name: 'inherited' } }],
+      },
+    });
+    expect(config.plugins).toHaveLength(3);
+    const [independent, inherited] = config.test!.projects! as { plugins?: unknown[] }[];
+    expect(independent.plugins).toHaveLength(3);
+    expect(inherited.plugins).toBeUndefined();
+  });
 });
 
 const AUTO_INLINE_PLUGIN_NAME = 'vite-plus:auto-inline-matcher-deps';
diff --git a/packages/cli/src/__tests__/define-config-vitest-resolver.spec.ts b/packages/cli/src/__tests__/define-config-vitest-resolver.spec.ts
index 148f8e5604..7714a337d5 100644
--- a/packages/cli/src/__tests__/define-config-vitest-resolver.spec.ts
+++ b/packages/cli/src/__tests__/define-config-vitest-resolver.spec.ts
@@ -1,6 +1,7 @@
 import { fileURLToPath } from 'node:url';
 
-import type { Plugin } from 'vite';
+import { preview } from '@vitest/browser-preview';
+import type { Alias, Plugin, UserConfig } from 'vite';
 import { describe, expect, it } from 'vitest';
 
 import { defineConfig, defineProject, isVitestFamilySpecifier } from '../define-config.ts';
@@ -42,8 +43,15 @@ describe('isVitestFamilySpecifier', () => {
     expect(isVitestFamilySpecifier('@vitest/browser/context')).toBe(true);
   });
 
-  it('matches `@vitest/expect`', () => {
-    expect(isVitestFamilySpecifier('@vitest/expect')).toBe(true);
+  it.each([
+    '@vitest/expect',
+    '@vitest/runner',
+    '@vitest/ws-client',
+    '@vitest/istanbul-lib-coverage',
+    '@vitest/istanbul-lib-instrument',
+    '@vitest/future-package',
+  ])('leaves %s on the project dependency edge', (name) => {
+    expect(isVitestFamilySpecifier(name)).toBe(false);
   });
 
   it('matches a queried subpath (query stripped before matching)', () => {
@@ -76,6 +84,61 @@ describe('isVitestFamilySpecifier', () => {
 });
 
 describe('vitePlusVitestResolverPlugin', () => {
+  it('anchors Preview optimizer dependencies without changing other providers', () => {
+    const plugin = findPlugin(defineConfig({}).plugins, RESOLVER_PLUGIN_NAME)!;
+    const hook = (plugin.config as { handler: (config: UserConfig) => void }).handler;
+    const config: UserConfig = {
+      test: {
+        browser: {
+          enabled: true,
+          provider: preview(),
+        },
+      },
+    };
+    hook(config);
+    const aliases = config.resolve!.alias as Alias[];
+    expect(aliases).toHaveLength(9);
+    for (const id of ['@testing-library/user-event', '@testing-library/dom']) {
+      expect(aliases.find(({ find }) => (find as RegExp).test(id))?.replacement).toContain(id);
+    }
+    hook(config);
+    expect(config.resolve!.alias).toHaveLength(9);
+  });
+
+  it('anchors browser optimizer entries to the bundled ESM runtime', () => {
+    const plugin = findPlugin(defineConfig({}).plugins, RESOLVER_PLUGIN_NAME)!;
+    const hook = (plugin.config as { handler: (config: UserConfig) => void }).handler;
+    const config: UserConfig = { test: { browser: { enabled: true } } };
+    hook(config);
+    const aliases = config.resolve!.alias as Alias[];
+    expect(aliases).toHaveLength(7);
+    for (const id of ['vitest', 'vitest/internal/browser', 'vitest/internal/traces']) {
+      expect(aliases.find(({ find }) => (find as RegExp).test(id))?.replacement).toBe(
+        fileURLToPath(import.meta.resolve(id)),
+      );
+    }
+    hook(config);
+    expect(config.resolve!.alias).toHaveLength(7);
+  });
+
+  it('preserves explicit browser aliases and leaves Node-only configs unchanged', () => {
+    const plugin = findPlugin(defineConfig({}).plugins, RESOLVER_PLUGIN_NAME)!;
+    const hook = (plugin.config as { handler: (config: UserConfig) => void }).handler;
+    const config: UserConfig = {
+      resolve: { alias: { vitest: '/custom/vitest' } },
+      test: { browser: { enabled: true } },
+    };
+    hook(config);
+    expect((config.resolve!.alias as Alias[])[0]).toEqual({
+      find: 'vitest',
+      replacement: '/custom/vitest',
+    });
+    expect(config.resolve!.alias).toHaveLength(5);
+    const nodeOnly: UserConfig = { test: {} };
+    hook(nodeOnly);
+    expect(nodeOnly).toEqual({ test: {} });
+  });
+
   it('is injected into the root plugins array as an enforce:pre plugin with resolveId', () => {
     const result = defineConfig({}) as { plugins: unknown[] };
     const plugin = findPlugin(result.plugins, RESOLVER_PLUGIN_NAME);
@@ -86,13 +149,17 @@ describe('vitePlusVitestResolverPlugin', () => {
     expect(typeof plugin?.resolveId).toBe('function');
   });
 
-  it('is injected into each `test.projects` entry (before user plugins)', () => {
+  it('is injected into independent `test.projects` entries', () => {
     const existing: Plugin = { name: 'user-project-plugin' };
     const result = defineConfig({
       test: {
         projects: [
-          { test: { name: 'unit', environment: 'node' } },
-          { plugins: [existing], test: { name: 'browser', environment: 'jsdom' } },
+          { extends: false, test: { name: 'unit', environment: 'node' } },
+          {
+            extends: './base.config.ts',
+            plugins: [existing],
+            test: { name: 'browser', environment: 'jsdom' },
+          },
         ],
       },
     }) as { test: { projects: unknown[] } };
@@ -189,19 +256,19 @@ describe('vitePlusVitestResolverPlugin resolveId (bundle-first)', () => {
 
   it('tries the vite-plus anchor then the vitest anchor for the nested @vitest/* family', async () => {
     const resolveId = getResolveId();
-    const VITEST_ANCHORED = '/bundled/.pnpm/vitest/node_modules/@vitest/expect/dist/index.js';
+    const VITEST_ANCHORED = '/bundled/.pnpm/vitest/node_modules/@vitest/mocker/dist/index.js';
     let anchorProbes = 0;
     const { ctx, calls } = makeCtx(({ fromProject }) => {
       if (fromProject) {
-        return { id: '/fake/project/node_modules/@vitest/expect/dist/index.js' };
+        return { id: '/fake/project/node_modules/@vitest/mocker/dist/index.js' };
       }
       anchorProbes += 1;
-      // vite-plus anchor misses (@vitest/expect is a dep of vitest, not vite-plus);
+      // Simulate a layout in which only the second bundled anchor resolves it;
       // the second (vitest) anchor resolves it.
       return anchorProbes >= 2 ? { id: VITEST_ANCHORED } : null;
     });
 
-    const id = idOf(await resolveId.call(ctx, '@vitest/expect', PROJECT_IMPORTER, {}));
+    const id = idOf(await resolveId.call(ctx, '@vitest/mocker', PROJECT_IMPORTER, {}));
 
     expect(id).toBe(VITEST_ANCHORED);
     expect(anchorProbes).toBe(2);
diff --git a/packages/cli/src/__tests__/exports-map.spec.ts b/packages/cli/src/__tests__/exports-map.spec.ts
index 73e5b6ca71..2f58124971 100644
--- a/packages/cli/src/__tests__/exports-map.spec.ts
+++ b/packages/cli/src/__tests__/exports-map.spec.ts
@@ -16,6 +16,7 @@ import { createRequire } from 'node:module';
 import path from 'node:path';
 import url from 'node:url';
 
+import ts from 'typescript';
 import { describe, expect, it } from 'vitest';
 
 const cliPkgDir = path.resolve(path.dirname(url.fileURLToPath(import.meta.url)), '../..');
@@ -35,6 +36,90 @@ function namedValueExports(mod: Record<string, unknown>): string[] {
 }
 
 describe('package.json exports map', () => {
+  it('provides the bundled Vitest Vite peer without relying on project dependencies', () => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    expect(pkg.dependencies.vite).toBe('workspace:@voidzero-dev/vite-plus-core@*');
+    expect(pkg.devDependencies.vite).toBeUndefined();
+  });
+
+  it('keeps the reviewed Vitest v5 export surface', () => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    expect(
+      Object.keys(pkg.exports)
+        .filter((key) => key === './test' || key.startsWith('./test/'))
+        .toSorted(),
+    ).toMatchSnapshot();
+  });
+
+  it('resolves every runtime test export under Node ESM conditions', () => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    for (const [key, value] of Object.entries(pkg.exports as Record<string, ExportConditions>)) {
+      if (!(key === './test' || key.startsWith('./test/')) || (!value.default && !value.import)) {
+        continue;
+      }
+      const resolved = import.meta.resolve(`vite-plus${key.slice(1)}`);
+      expect(fs.existsSync(url.fileURLToPath(resolved)), key).toBe(true);
+    }
+  });
+
+  it('compiles all typed test exports with NodeNext resolution', () => {
+    const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf8'));
+    const entries = Object.entries(pkg.exports as Record<string, ExportConditions>).filter(
+      ([key, entry]) =>
+        (key === './test' || key.startsWith('./test/')) &&
+        (entry.types || (isConditionObject(entry.import) && entry.import.types)),
+    );
+    const source =
+      entries
+        .map(([key], index) => `import type * as E${index} from 'vite-plus${key.slice(1)}';`)
+        .join('\n') +
+      `
+import { expect } from 'vite-plus/test';
+declare module 'vite-plus/test' {
+  interface Matchers<R extends void | Promise<void> = void | Promise<void>, T = unknown> {
+    toMatchReceived(expected: T): R;
+  }
+}
+const synchronous: void = expect(42).toMatchReceived(42);
+const asynchronous: Promise<void> = expect(Promise.resolve(42)).resolves.toMatchReceived(42);
+// @ts-expect-error The received type is number, not string.
+expect(42).toMatchReceived('42');
+// @ts-expect-error An asynchronous matcher does not return void.
+const invalidReturn: void = expect(Promise.resolve(42)).resolves.toMatchReceived(42);
+`;
+    const filename = path.join(cliPkgDir, '__test_exports__.mts');
+    const options: ts.CompilerOptions = {
+      noEmit: true,
+      strict: true,
+      skipLibCheck: true,
+      types: [],
+      module: ts.ModuleKind.NodeNext,
+      target: ts.ScriptTarget.ESNext,
+    };
+    const host = ts.createCompilerHost(options);
+    const getSourceFile = host.getSourceFile.bind(host);
+    host.getSourceFile = (file, ...args) =>
+      file === filename
+        ? ts.createSourceFile(file, source, ts.ScriptTarget.ESNext, true)
+        : getSourceFile(file, ...args);
+    const program = ts.createProgram([filename], options, host);
+    const diagnostics = ts.getPreEmitDiagnostics(program);
+    expect(diagnostics.map((d) => ts.flattenDiagnosticMessageText(d.messageText, '\n'))).toEqual(
+      [],
+    );
+  });
+
+  it.each([
+    ['coverage', 'vitest/node'],
+    ['reporters', 'vitest/node'],
+    ['environments', 'vitest/runtime'],
+    ['snapshot', 'vitest/runtime'],
+    ['mocker', '@vitest/mocker'],
+  ])('keeps the complete %s compatibility target', (name, upstream) => {
+    const source = fs.readFileSync(path.join(cliPkgDir, 'dist/test', `${name}.js`), 'utf8');
+    expect(source).toBe(`export * from '${upstream}';\n`);
+  });
+
   it('every dual-condition entry emits `require` before `default`', () => {
     const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf-8'));
     const exports = pkg.exports as Record<string, unknown>;
@@ -63,6 +148,19 @@ describe('package.json exports map', () => {
     expect(offenders, 'entries with require ordered after default').toEqual([]);
   });
 
+  it.each([
+    'browser/context',
+    'context',
+    'plugins/browser-context',
+    'browser-preview/context',
+    'browser-playwright/context',
+    'browser-webdriverio/context',
+  ])('routes the %s runtime alias to the v5 browser virtual module', (name) => {
+    expect(fs.readFileSync(path.join(cliPkgDir, 'dist/test', `${name}.js`), 'utf8')).toBe(
+      "export * from 'vitest/browser';\n",
+    );
+  });
+
   it('./test/config has both `require` and `default`, with `require` first', () => {
     const pkg = JSON.parse(fs.readFileSync(cliPkgJsonPath, 'utf-8'));
     const entry = (pkg.exports as Record<string, unknown>)['./test/config'];
diff --git a/packages/cli/src/__tests__/oxlint-plugin.spec.ts b/packages/cli/src/__tests__/oxlint-plugin.spec.ts
index 9297027348..b3bf16c028 100644
--- a/packages/cli/src/__tests__/oxlint-plugin.spec.ts
+++ b/packages/cli/src/__tests__/oxlint-plugin.spec.ts
@@ -100,6 +100,20 @@ describe('rewriteVitePlusImportSpecifier', () => {
     expect(rewriteVitePlusImportSpecifier('vitest/package.json')).toBeNull();
     // ...but other `vitest/<sub>` specifiers still rewrite normally.
     expect(rewriteVitePlusImportSpecifier('vitest/node')).toBe('vite-plus/test/node');
+    expect(rewriteVitePlusImportSpecifier('vitest/coverage')).toBe('vite-plus/test/node');
+    expect(rewriteVitePlusImportSpecifier('vitest/reporters')).toBe('vite-plus/test/node');
+    expect(rewriteVitePlusImportSpecifier('vitest/environments')).toBe('vite-plus/test/runtime');
+    expect(rewriteVitePlusImportSpecifier('vitest/snapshot')).toBe('vite-plus/test/runtime');
+    expect(rewriteVitePlusImportSpecifier('vitest/mocker')).toBe('vite-plus/test/mocker');
+    for (const subpath of [
+      'runners',
+      'suite',
+      'internal/module-runner',
+      'plugins/expect',
+      'unknown',
+    ]) {
+      expect(rewriteVitePlusImportSpecifier(`vitest/${subpath}`)).toBeNull();
+    }
     expect(rewriteVitePlusImportSpecifier('tsx')).toBeNull();
   });
 });
diff --git a/packages/cli/src/__tests__/resolve-test.spec.ts b/packages/cli/src/__tests__/resolve-test.spec.ts
index f5acc13f30..da227bcb2e 100644
--- a/packages/cli/src/__tests__/resolve-test.spec.ts
+++ b/packages/cli/src/__tests__/resolve-test.spec.ts
@@ -4,10 +4,42 @@ import { join } from 'node:path';
 
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 
-import { test } from '../resolve-test.js';
+import { parentTestConfigDiagnostic, test } from '../resolve-test.js';
 import { resolve, resolveBundled } from '../utils/constants.js';
 
 describe('resolve-test', () => {
+  describe('parent config diagnostic', () => {
+    let dir: string;
+    beforeEach(() => {
+      dir = mkdtempSync(join(tmpdir(), 'vp-parent-test-config-'));
+      mkdirSync(join(dir, 'sub'));
+      writeFileSync(join(dir, 'vite.config.ts'), 'export default {}');
+    });
+    afterEach(() => rmSync(dir, { recursive: true, force: true }));
+
+    it('reports a parent config without selecting it', () => {
+      expect(parentTestConfigDiagnostic(join(dir, 'sub'), ['run'])).toBe(
+        'No test config was found in this directory.\n' +
+          'A config exists at ../vite.config.ts. Run `vp test --config ../vite.config.ts --dir .`.',
+      );
+    });
+
+    it.each([
+      ['--config', '../vite.config.ts'],
+      ['--config=../vite.config.ts'],
+      ['-c', '../vite.config.ts'],
+      ['--help'],
+      ['--root', '..'],
+    ])('respects explicit options %j', (...args) => {
+      expect(parentTestConfigDiagnostic(join(dir, 'sub'), args)).toBeNull();
+    });
+
+    it('prefers a config in the selected directory', () => {
+      writeFileSync(join(dir, 'sub', 'vitest.config.mts'), 'export default {}');
+      expect(parentTestConfigDiagnostic(join(dir, 'sub'), [])).toBeNull();
+    });
+  });
+
   it('resolves a vitest binary that exists', async () => {
     const { binPath } = await test();
 
diff --git a/packages/cli/src/bin.ts b/packages/cli/src/bin.ts
index 8f5865b8ad..768f4f06e6 100644
--- a/packages/cli/src/bin.ts
+++ b/packages/cli/src/bin.ts
@@ -20,9 +20,9 @@ import { doc } from './resolve-doc.ts';
 import { fmt } from './resolve-fmt.ts';
 import { lint } from './resolve-lint.ts';
 import { pack } from './resolve-pack.ts';
-import { test } from './resolve-test.ts';
+import { parentTestConfigDiagnostic, test } from './resolve-test.ts';
 import { vite } from './resolve-vite.ts';
-import { accent, errorMsg, log } from './utils/terminal.ts';
+import { accent, errorMsg, log, warnMsg } from './utils/terminal.ts';
 
 // Node.js sets O_NONBLOCK when pipe-backed stdio is first accessed. Materialize
 // the output streams before restoring the blocking semantics expected by Rust.
@@ -132,6 +132,12 @@ if (maybePrintCommandHelp(args)) {
     // This module imports `vitest/config` through define-config. Load it here
     // so `migrate` and `config` can handle stale aliases before Vitest loads.
     const { resolveUniversalViteConfig } = await import('./resolve-vite-config.js');
+    if (command === 'test') {
+      const diagnostic = parentTestConfigDiagnostic(process.cwd(), args.slice(1));
+      if (diagnostic) {
+        warnMsg(diagnostic);
+      }
+    }
     const initInspection = inspectInitCommand(command, args.slice(1));
     if (
       initInspection.handled &&
diff --git a/packages/cli/src/define-config.ts b/packages/cli/src/define-config.ts
index 0e78fb0347..d63e54e9f1 100644
--- a/packages/cli/src/define-config.ts
+++ b/packages/cli/src/define-config.ts
@@ -1,10 +1,11 @@
 import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
+import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import type { OxfmtConfig } from 'oxfmt';
 import type { OxlintConfig } from 'oxlint';
-import type { PluginOption, UserConfig } from 'vite';
+import type { Alias, Plugin, PluginOption, UserConfig } from 'vite';
 import {
   defineConfig as viteDefineConfig,
   defineProject as viteDefineProject,
@@ -21,6 +22,7 @@ import type { PackUserConfig } from './pack.ts';
 import type { RunConfig } from './run-config.ts';
 import type { StagedConfig } from './staged-config.ts';
 import { CONFIG_METADATA_ENV, VITEST_VERSION } from './utils/constants.ts';
+import { VITEST_RESOLVER_PACKAGES } from './utils/vitest-ecosystem.ts';
 
 declare module 'vite' {
   interface UserConfig {
@@ -148,10 +150,9 @@ const vitePlusModuleFile = fileURLToPath(import.meta.url);
 
 /**
  * Absolute path to the bundled `vitest` package's `package.json`, used as a
- * second `this.resolve` importer. The nested `@vitest/*` family (`@vitest/expect`,
- * `@vitest/runner`, `@vitest/snapshot`, …) are dependencies of `vitest` itself —
- * not direct deps of `vite-plus` — so under pnpm's isolated layout they are
- * reachable from `vitest`'s location but not from [[vitePlusModuleFile]].
+ * second `this.resolve` importer. Supported transitive packages can be
+ * reachable from `vitest`'s location but not from [[vitePlusModuleFile]]
+ * under pnpm's isolated layout.
  * Resolving `package.json` is condition-agnostic, so this is safe with
  * `require.resolve`. Cached; `null` once an attempt has failed so we never retry.
  */
@@ -168,6 +169,23 @@ function getVitestAnchor(): string | null {
   return vitestAnchor;
 }
 
+function getVitestImportTarget(id: string): string {
+  const anchor = getVitestAnchor();
+  if (!anchor) {
+    throw new Error('Cannot resolve the bundled Vitest package. Reinstall vite-plus.');
+  }
+  const pkg = JSON.parse(readFileSync(anchor, 'utf8')) as { exports: Record<string, unknown> };
+  let target = pkg.exports[id === 'vitest' ? '.' : `.${id.slice('vitest'.length)}`];
+  while (target && typeof target === 'object') {
+    const conditions = target as Record<string, unknown>;
+    target = conditions.import ?? conditions.default;
+  }
+  if (typeof target !== 'string' || !target.startsWith('./')) {
+    throw new Error(`The bundled Vitest has no ESM export for ${id}.`);
+  }
+  return resolve(anchor, '..', target);
+}
+
 /**
  * Match the `vitest` / `@vitest/*` family of bare specifiers — the imports a
  * browser-mode Vite dev server must resolve. Any query string is stripped
@@ -180,12 +198,9 @@ export function isVitestFamilySpecifier(id: string): boolean {
   if (bare.startsWith('.') || bare.startsWith('/') || bare.startsWith('\0')) {
     return false;
   }
-  return (
-    bare === 'vitest' ||
-    bare.startsWith('vitest/') ||
-    bare === '@vitest/browser' ||
-    bare.startsWith('@vitest/')
-  );
+  const segments = bare.split('/');
+  const packageName = bare.startsWith('@') ? segments.slice(0, 2).join('/') : segments[0];
+  return VITEST_RESOLVER_PACKAGES.has(packageName);
 }
 
 /**
@@ -195,10 +210,10 @@ export function isVitestFamilySpecifier(id: string): boolean {
  * and `@vitest/browser` are transitive deps. pnpm's isolated layout only
  * exposes a package's *direct* deps, so the browser-mode Vite dev server
  * (rooted at the consumer project) cannot resolve `vitest/internal/browser`,
- * `@vitest/expect`, etc. Non-browser tests are unaffected — vitest's own
+ * `@vitest/mocker`, etc. Non-browser tests are unaffected — vitest's own
  * module runner handles resolution there.
  *
- * This plugin re-resolves the `vitest` / `@vitest/*` family through Vite's OWN
+ * This plugin re-resolves the explicit Vitest runtime allowlist through Vite's OWN
  * resolver, but ROOTED at `vite-plus`'s location ([[vitePlusModuleFile]]) and
  * then the bundled `vitest`'s location ([[getVitestAnchor]]) BEFORE the
  * project. So every such import binds to the same physical (pinned) Vitest that
@@ -242,6 +257,78 @@ function vitePlusVitestResolverPlugin(): PluginOption {
   return {
     name: 'vite-plus:vitest-resolver',
     enforce: 'pre',
+    config: {
+      order: 'post',
+      handler(config) {
+        if (!config.test?.browser?.enabled) {
+          return;
+        }
+        // The browser optimizer resolves forced includes with an alias-only
+        // resolver, without user resolveId hooks. Keep its runtime entry points
+        // on the same graph as the browser runner in isolated installs.
+        const aliases = config.resolve?.alias;
+        const entries: Alias[] = Array.isArray(aliases)
+          ? [...aliases]
+          : Object.entries(aliases ?? {}).map(([find, replacement]) => ({ find, replacement }));
+        const runtimeRequire = createRequire(getVitestAnchor()!);
+        const targets = new Map(
+          [
+            'vitest',
+            'vitest/internal/browser',
+            'vitest/internal/traces',
+            'expect-type',
+            'magic-string',
+            'chai',
+            'vite/module-runner',
+          ].map((id) => [
+            id,
+            id.startsWith('vitest') ? getVitestImportTarget(id) : runtimeRequire.resolve(id),
+          ]),
+        );
+        if (config.test.browser.provider?.name === 'preview') {
+          const previewRequire = createRequire(vitePlusRequire.resolve('@vitest/browser-preview'));
+          // Preview's forced includes need the same isolated-layout fallback.
+          // These entries may be CommonJS; the browser optimizer converts them.
+          for (const id of ['@testing-library/user-event', '@testing-library/dom']) {
+            targets.set(id, previewRequire.resolve(id));
+          }
+        }
+        for (const [id, replacement] of targets) {
+          if (
+            entries.some(({ find }) =>
+              typeof find === 'string'
+                ? id === find || id.startsWith(`${find}/`)
+                : new RegExp(find).test(id),
+            )
+          ) {
+            continue;
+          }
+          entries.push({
+            find: new RegExp(`^${id}$`),
+            replacement,
+          });
+        }
+        config.resolve ??= {};
+        config.resolve.alias = entries;
+      },
+    },
+    configResolved(config) {
+      // Vite merges plugin arrays from inherited and referenced configs. Remove
+      // duplicate Vite+ hooks before it creates the server's plugin container.
+      const seen = new Set<string>();
+      const plugins = config.plugins as Plugin[];
+      const unique = plugins.filter((plugin) => {
+        if (!VITE_PLUS_TEST_PLUGIN_NAMES.has(plugin.name)) {
+          return true;
+        }
+        if (seen.has(plugin.name)) {
+          return false;
+        }
+        seen.add(plugin.name);
+        return true;
+      });
+      plugins.splice(0, plugins.length, ...unique);
+    },
     async resolveId(id, importer, options) {
       if (!isVitestFamilySpecifier(id)) {
         return null;
@@ -284,10 +371,9 @@ function vitePlusVitestResolverPlugin(): PluginOption {
  * Absent packages are silently skipped so the server-deps optimizer never
  * tries to resolve a name that does not exist in the project's node_modules.
  *
- * The check is deferred to a `configResolved` plugin hook so that
- * `resolvedConfig.root` points at the actual project root (the value vite has
- * already normalised), rather than relying on `process.cwd()` at config-load
- * time (which can differ in workspace / monorepo setups).
+ * The environment hook adds installed packages to the module-runner options
+ * inherited by shared-server projects. The resolved-config hook also handles
+ * independent project servers, using each project's resolved root.
  *
  * Exported for unit testing.
  */
@@ -345,35 +431,44 @@ export function computeAutoInlineList(
 }
 
 function vitePlusAutoInlineMatcherPlugin(): PluginOption {
+  let projectRoot = '';
+  type TestConfig = Pick<VitestInlineConfig, 'server'>;
+  const inlineMatchers = (testConfig: TestConfig, root: string) => {
+    const merged = computeAutoInlineList(testConfig.server?.deps?.inline, root);
+    if (merged !== null) {
+      testConfig.server ??= {};
+      testConfig.server.deps ??= {};
+      testConfig.server.deps.inline = merged;
+    }
+  };
   return {
     name: 'vite-plus:auto-inline-matcher-deps',
     enforce: 'pre',
-    configResolved(resolvedConfig) {
-      // Access the vitest test config via the augmented field. Vitest augments
-      // vite's `UserConfig` but not `ResolvedConfig`, so we use `any` here.
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const testConfig = (resolvedConfig as any).test as
-        | { server?: { deps?: { inline?: (string | RegExp)[] | true } } }
-        | undefined;
-      const merged = computeAutoInlineList(testConfig?.server?.deps?.inline, resolvedConfig.root);
-      if (merged === null) {
-        return;
-      }
-      // Mutate the resolved config so the finalised inline list is visible
-      // to vitest when it reads test.server.deps.inline.
-      if (!testConfig) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        (resolvedConfig as any).test = { server: { deps: { inline: merged } } };
-      } else {
-        if (!testConfig.server) {
-          testConfig.server = {};
-        }
-        if (!testConfig.server.deps) {
-          testConfig.server.deps = {};
-        }
-        testConfig.server.deps.inline = merged;
+    config(config) {
+      // Environment hooks run after this config hook, with Vite's root option
+      // available. Vitest shares their externalization rules with child projects.
+      projectRoot = resolve(config.root ?? '.');
+    },
+    configEnvironment(_name, config) {
+      const existing = config.resolve?.noExternal;
+      const merged = computeAutoInlineList(
+        existing === true
+          ? true
+          : typeof existing === 'string' || existing instanceof RegExp
+            ? [existing]
+            : existing,
+        projectRoot,
+      );
+      if (merged !== null) {
+        config.resolve ??= {};
+        config.resolve.noExternal = merged;
       }
     },
+    configResolved(resolvedConfig) {
+      const config = resolvedConfig as { root: string; test?: TestConfig };
+      config.test ??= {};
+      inlineMatchers(config.test, config.root);
+    },
   };
 }
 
@@ -605,6 +700,26 @@ function vitePlusCoverageVersionGuardPlugin(): PluginOption {
  * an optional `test.server.deps.inline`), so a shared helper keeps the
  * wiring consistent.
  */
+const VITE_PLUS_TEST_PLUGIN_NAMES: ReadonlySet<string> = new Set([
+  'vite-plus:vitest-resolver',
+  'vite-plus:auto-inline-matcher-deps',
+  'vite-plus:coverage-version-guard',
+]);
+
+function withoutVitePlusTestPlugins(plugin: PluginOption): PluginOption {
+  if (Array.isArray(plugin)) {
+    return plugin.filter(keepUserPlugin).map(withoutVitePlusTestPlugins);
+  }
+  if (plugin instanceof Promise) {
+    return plugin.then(withoutVitePlusTestPlugins);
+  }
+  return plugin && VITE_PLUS_TEST_PLUGIN_NAMES.has(plugin.name) ? false : plugin;
+}
+
+function keepUserPlugin(plugin: PluginOption): boolean {
+  return !plugin || !('name' in plugin) || !VITE_PLUS_TEST_PLUGIN_NAMES.has(plugin.name);
+}
+
 function injectPluginIntoInlineConfig<
   T extends {
     plugins?: UserConfig['plugins'];
@@ -617,16 +732,14 @@ function injectPluginIntoInlineConfig<
       vitePlusVitestResolverPlugin(),
       vitePlusAutoInlineMatcherPlugin(),
       vitePlusCoverageVersionGuardPlugin(),
-      ...(config.plugins ?? []),
+      ...(config.plugins ?? []).filter(keepUserPlugin).map(withoutVitePlusTestPlugins),
     ],
   };
 }
 
 /**
- * Walk `config.test?.projects` and inject the vite-plus plugins into each
- * project entry. Vitest spins up an independent Vite pipeline per project, so
- * root-level plugins do NOT propagate — without this, files matched by a
- * project's `include` glob never get the vitest resolver / auto-inline plugins.
+ * Inline projects inherit root plugins by default in Vitest v5. Only projects
+ * with inheritance disabled or an external base need their own injection.
  *
  * Entry shapes (from `TestProjectConfiguration`):
  *   - string  (glob path like `'./packages/*'`)  → passed through unchanged.
@@ -651,22 +764,30 @@ function injectPluginIntoProject(project: TestProjectConfiguration): TestProject
     const wrapped: UserProjectConfigFn = (env: ConfigEnv) => {
       const result = project(env);
       if (result instanceof Promise) {
-        return result.then(injectPluginIntoInlineConfig);
+        return result.then(injectIndependentProject);
       }
-      return injectPluginIntoInlineConfig(result);
+      return injectIndependentProject(result);
     };
     return wrapped;
   }
   if (project instanceof Promise) {
-    return project.then(injectPluginIntoInlineConfig);
+    return project.then(injectIndependentProject);
   }
   if (typeof project === 'object' && project !== null) {
-    return injectPluginIntoInlineConfig(project);
+    return injectIndependentProject(project);
   }
   return project;
 }
 
-function injectPlugin(config: UserConfig): UserConfig {
+function injectIndependentProject(
+  config: UserWorkspaceConfig & { extends?: string | boolean },
+): UserWorkspaceConfig {
+  return config.extends === false || typeof config.extends === 'string'
+    ? injectPlugin(config)
+    : config;
+}
+
+function injectPlugin<T extends UserConfig>(config: T): T {
   const injected = injectPluginIntoInlineConfig(config);
   const projects = injected.test?.projects;
   if (!projects || projects.length === 0) {
@@ -709,23 +830,21 @@ export function defineConfig(config: ViteUserConfigExport): ViteUserConfigExport
 
 /**
  * Inject the vite-plus plugins into a `defineProject` export. A project config
- * (`UserWorkspaceConfig`) cannot itself nest `test.projects`, so this only
- * touches the top-level `plugins` array (no project recursion like
- * [[injectPluginIntoConfig]] does).
+ * (`UserWorkspaceConfig`) can itself declare nested projects in v5. Referenced
+ * configs own a Vite server, so inject at their root and apply inheritance rules
+ * to their inline children.
  */
 function injectPluginIntoProjectExport(config: UserProjectConfigExport): UserProjectConfigExport {
   if (typeof config === 'function') {
     return (env: ConfigEnv) => {
       const result = config(env);
-      return result instanceof Promise
-        ? result.then(injectPluginIntoInlineConfig)
-        : injectPluginIntoInlineConfig(result);
+      return result instanceof Promise ? result.then(injectPlugin) : injectPlugin(result);
     };
   }
   if (config instanceof Promise) {
-    return config.then(injectPluginIntoInlineConfig);
+    return config.then(injectPlugin);
   }
-  return injectPluginIntoInlineConfig(config);
+  return injectPlugin(config);
 }
 
 /**
diff --git a/packages/cli/src/migration/__tests__/migrator.spec.ts b/packages/cli/src/migration/__tests__/migrator.spec.ts
index c07158b82b..3e9f7ba8e4 100644
--- a/packages/cli/src/migration/__tests__/migrator.spec.ts
+++ b/packages/cli/src/migration/__tests__/migrator.spec.ts
@@ -12,6 +12,7 @@ import {
   SETUP_VP_VERSION,
   VITE_PLUS_OVERRIDE_PACKAGES,
   VITEST_VERSION,
+  VITEST_WEBDRIVERIO_RANGE,
 } from '../../utils/constants.js';
 import { createMigrationReport } from '../report.js';
 
@@ -740,7 +741,10 @@ describe('rewritePackageJson', () => {
     };
     rewritePackageJson(pkg, PackageManager.pnpm);
     // Standalone (supportCatalog=false) → concrete pinned spec.
-    expect(pkg.devDependencies).toHaveProperty('@vitest/browser-webdriverio', VITEST_VERSION);
+    expect(pkg.devDependencies).toHaveProperty(
+      '@vitest/browser-webdriverio',
+      VITEST_WEBDRIVERIO_RANGE,
+    );
     expect(pkg.devDependencies).toHaveProperty('webdriverio', '*');
     expect(pkg.devDependencies).not.toHaveProperty('@vitest/browser');
   });
@@ -5983,7 +5987,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       allowBuilds: Record<string, boolean>;
       catalog: Record<string, string>;
     };
-    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_WEBDRIVERIO_RANGE);
     expect(yaml.allowBuilds.edgedriver).toBe(true);
     expect(yaml.allowBuilds.geckodriver).toBe(true);
   });
@@ -6069,7 +6073,9 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       const workspace = readYamlObject(path.join(tmpDir, 'pnpm-workspace.yaml')) as {
         catalog: Record<string, string>;
       };
-      expect(workspace.catalog[`@vitest/browser-${provider}`]).toBe(VITEST_VERSION);
+      expect(workspace.catalog[`@vitest/browser-${provider}`]).toBe(
+        provider === 'webdriverio' ? VITEST_WEBDRIVERIO_RANGE : VITEST_VERSION,
+      );
       expect(fs.readFileSync(path.join(tmpDir, 'vite.config.ts'), 'utf8')).toContain(
         `from 'vite-plus/test/${subpath}'`,
       );
@@ -6201,7 +6207,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       allowBuilds: Record<string, boolean>;
       catalog: Record<string, string>;
     };
-    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_WEBDRIVERIO_RANGE);
     expect(yaml.allowBuilds.edgedriver).toBe(true);
     expect(yaml.allowBuilds.geckodriver).toBe(true);
   });
@@ -6238,7 +6244,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       allowBuilds: Record<string, boolean>;
       catalog: Record<string, string>;
     };
-    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_WEBDRIVERIO_RANGE);
     expect(yaml.allowBuilds.edgedriver).toBe(true);
     expect(yaml.allowBuilds.geckodriver).toBe(true);
   });
@@ -6285,7 +6291,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
       catalog: Record<string, string>;
       allowBuilds: Record<string, boolean>;
     };
-    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(yaml.catalog['@vitest/browser-webdriverio']).toBe(VITEST_WEBDRIVERIO_RANGE);
     expect(yaml.catalog.vitest).toBe(VITEST_VERSION);
     expect(yaml.allowBuilds.edgedriver).toBe(true);
     expect(yaml.allowBuilds.geckodriver).toBe(true);
@@ -6314,7 +6320,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     expect(overrides['some-other-pkg']).toBe('1.0.0');
     // Provider normalized to the bundled vitest version, peer ensured.
     const devDeps = pkg.devDependencies as Record<string, string>;
-    expect(devDeps['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(devDeps['@vitest/browser-webdriverio']).toBe(VITEST_WEBDRIVERIO_RANGE);
     expect(devDeps.webdriverio).toBe('*');
   });
 
@@ -6368,7 +6374,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     // Unrelated comparator-range override preserved.
     expect(overrides['some-other-pkg@>=1']).toBe('1.0.0');
     const devDeps = pkg.devDependencies as Record<string, string>;
-    expect(devDeps['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(devDeps['@vitest/browser-webdriverio']).toBe(VITEST_WEBDRIVERIO_RANGE);
     expect(devDeps.webdriverio).toBe('*');
   });
 
@@ -6396,7 +6402,7 @@ describe('rewriteStandaloneProject pnpm workspace yaml', () => {
     const yarnrc = readYamlObject(path.join(tmpDir, '.yarnrc.yml')) as {
       catalog?: Record<string, string>;
     };
-    expect(yarnrc.catalog?.['@vitest/browser-webdriverio']).toBe(VITEST_VERSION);
+    expect(yarnrc.catalog?.['@vitest/browser-webdriverio']).toBe(VITEST_WEBDRIVERIO_RANGE);
   });
 
   it('drops only global/glob/vite-plus-parent yarn SELECTOR-shaped @vitest/browser-webdriverio resolutions', () => {
diff --git a/packages/cli/src/migration/__tests__/vitest-v5.spec.ts b/packages/cli/src/migration/__tests__/vitest-v5.spec.ts
new file mode 100644
index 0000000000..ffaf79ba44
--- /dev/null
+++ b/packages/cli/src/migration/__tests__/vitest-v5.spec.ts
@@ -0,0 +1,1142 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { parse } from '@babel/parser';
+import { afterEach, describe, expect, it } from 'vitest';
+
+import { PackageManager } from '../../types/index.ts';
+import {
+  applyVitestV5Migration,
+  createVitestV5CompatibilityConfig,
+  finishVitestV5Migration,
+  formatVitestV5Findings,
+  planVitestV5Migration,
+} from '../migrator.ts';
+import { migrateVitestV5Command } from '../vitest-v5/commands.ts';
+import { migrateVitestV5Config } from '../vitest-v5/config.ts';
+import { migrateVitestV5Source } from '../vitest-v5/source.ts';
+
+const v4 = { preserveV4: true, browser: true };
+const directories: string[] = [];
+afterEach(() => {
+  for (const directory of directories.splice(0)) {
+    fs.rmSync(directory, { recursive: true, force: true });
+  }
+});
+function project(files: Record<string, string> = {}) {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'vp-vitest-v5-'));
+  directories.push(root);
+  const all = {
+    'package.json': JSON.stringify({ devDependencies: { vitest: '^4.1.0' } }),
+    ...files,
+  };
+  for (const [name, content] of Object.entries(all)) {
+    const file = path.join(root, name);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, content);
+  }
+  return root;
+}
+const planProject = (rootDir: string) =>
+  planVitestV5Migration({ rootDir, packageManager: PackageManager.pnpm });
+function config(source: string, preserveV4 = true) {
+  const result = migrateVitestV5Config('vite.config.ts', source, { preserveV4 });
+  parse(result.content, { sourceType: 'module', plugins: ['typescript'] });
+  return result;
+}
+function source(input: string, options = v4) {
+  const result = migrateVitestV5Source('example.test.ts', input, options);
+  parse(result.content, { sourceType: 'module', plugins: ['typescript'] });
+  return result;
+}
+
+describe('Vitest v5 config compatibility', () => {
+  it('keeps Node jest-dom matchers separate from browser matchers in one package', () => {
+    const nodeTest = `import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');`;
+    const root = project({
+      'vite.config.ts': `export default { test: { projects: [
+        { test: { environment: 'jsdom', include: ['node.test.ts'] } },
+        { test: { browser: { enabled: true }, include: ['browser.test.ts'] } },
+      ] } };`,
+      'node.test.ts': nodeTest,
+      'browser.test.ts': nodeTest,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file.endsWith('/node.test.ts'))).toBe(false);
+    expect(plan.changes.find(({ file }) => file.endsWith('/browser.test.ts'))?.after).toContain(
+      "expect(element).toMatchTextContent('partial')",
+    );
+    expect(plan.findings.some(({ code }) => code === 'text-content-project')).toBe(false);
+  });
+
+  it.each([
+    `export default { test: { projects: [
+      { test: { include: ['shared.test.ts'] } },
+      { test: { browser: { enabled: true }, include: ['shared.test.ts'] } },
+    ] } };`,
+    `export default () => ({ test: { browser: { enabled: true } } });`,
+    `import { defineConfig } from 'vitest/config';
+export default wrapper(defineConfig({ test: { browser: { enabled: true } } }));`,
+    `export default { test: { projects: ['unknown-config.ts',
+      { test: { browser: { enabled: true } } },
+    ] } };`,
+    `export default { test: { browser: { enabled: enabledAtRuntime },
+      projects: [{ extends: true, test: {} }],
+    } };`,
+    `export default { test: { browser: { enabled: true },
+      include: ['**/*.test.ts', '!shared.test.ts'],
+    } };`,
+    `import { defineConfig } from 'vitest/config';
+module.exports = wrapper(defineConfig({ test: { browser: { enabled: true } } }));`,
+  ])(
+    'reports ambiguous browser ownership without changing a Node-compatible matcher: %s',
+    (configuration) => {
+      const root = project({
+        'vite.config.ts': configuration,
+        'shared.test.ts': `import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');`,
+      });
+      const plan = planProject(root);
+      expect(plan.changes.some(({ file }) => file.endsWith('/shared.test.ts'))).toBe(false);
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+      );
+    },
+  );
+
+  it('renames expect.element matchers even when project ownership is dynamic', () => {
+    const root = project({
+      'vite.config.ts': `export default () => ({ test: { browser: { enabled: true } } });`,
+      'browser.test.ts': `import { expect } from 'vitest';\nawait expect.element(element).toHaveTextContent('partial');`,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.find(({ file }) => file.endsWith('/browser.test.ts'))?.after).toContain(
+      "expect.element(element).toMatchTextContent('partial')",
+    );
+  });
+
+  it('resolves a named config helper and referenced raw project configs', () => {
+    const input = `import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');`;
+    const root = project({
+      'vite.config.ts': `import { defineConfig } from 'vitest/config';
+const config = defineConfig({ test: { projects: ['./node-project.ts', './browser-project.ts'] } });
+export default config;`,
+      'node-project.ts': `export default { test: { include: ['node.test.ts'] } };`,
+      'browser-project.ts': `export default { test: { browser: { enabled: true }, include: ['browser.test.ts'] } };`,
+      'node.test.ts': input,
+      'browser.test.ts': input,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file.endsWith('/node.test.ts'))).toBe(false);
+    expect(plan.changes.find(({ file }) => file.endsWith('/browser.test.ts'))?.after).toContain(
+      'toMatchTextContent',
+    );
+  });
+
+  it('does not infer helper-module ownership from default test globs', () => {
+    const root = project({
+      'vite.config.ts': 'export default { test: { browser: { enabled: true } } };',
+      'assertions.ts': `import { expect } from 'vitest';\nexport function check(element) { expect(element).toHaveTextContent('partial'); }`,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file.endsWith('/assertions.ts'))).toBe(false);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+    );
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toContainEqual(
+      expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+    );
+    expect(planProject(root).findings).toContainEqual(
+      expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+    );
+  });
+
+  it('does not infer a Node-only assertion when scripts override browser mode', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        scripts: { test: 'vitest', 'test:browser': 'vitest --browser' },
+      }),
+      'vite.config.ts': 'export default { test: {} };',
+      'shared.test.ts': `import { expect } from 'vitest';\nexpect(element).toHaveTextContent('partial');`,
+    });
+    const plan = planProject(root);
+    expect(plan.changes.some(({ file }) => file.endsWith('/shared.test.ts'))).toBe(false);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'text-content-project', severity: 'review' }),
+    );
+  });
+
+  it('retains multiline indentation and comments when adding defaults', () => {
+    const result = config(
+      'export default {\r\n  test: {\r\n    // Keep this comment.\r\n    globals: true,\r\n  },\r\n};',
+    );
+    expect(result.content).toBe(
+      'export default {\r\n  test: {\r\n    clearMocks: false,\r\n    // Keep this comment.\r\n    globals: true,\r\n  },\r\n};',
+    );
+    expect(config(result.content).content).toBe(result.content);
+  });
+  it('preserves raw CommonJS config defaults', () => {
+    const result = migrateVitestV5Config('vitest.config.cjs', 'module.exports = { test: {} };', v4);
+    expect(result.content).toContain('clearMocks: false');
+    expect(result.findings).toEqual([]);
+  });
+  it('preserves root and non-inheriting project defaults without overriding explicit choices', () => {
+    const result = config(`import { defineConfig } from 'vite-plus';
+export default defineConfig({ test: { projects: [
+  { test: { browser: { enabled: true } } },
+  { extends: true, test: {} },
+  { extends: './base.ts', test: { clearMocks: true, browser: { locators: { exact: true } } } },
+] } });`);
+    expect(result.content).toContain('sharedViteServer: false');
+    expect(result.content.match(/clearMocks: false/g)).toHaveLength(2);
+    expect(result.content).toContain('clearMocks: true');
+    expect(result.content).toContain('exact: false');
+    expect(result.content).toContain('exact: true');
+    expect(result.content.match(/extends: false/g)).toHaveLength(1);
+    expect(config(result.content).content).toBe(result.content);
+  });
+
+  it('does not apply v4 defaults to v5 configs', () => {
+    const input = `export default { test: { projects: [{ test: {} }] } };`;
+    expect(config(input, false).content).toBe(input);
+  });
+
+  it('does not guess dynamic projects or spread options', () => {
+    const result = config(`export default { test: { ...shared, projects: [() => project] } };`);
+    expect(result.content).not.toContain('clearMocks');
+    expect(result.findings.map((finding) => finding.code)).toContain('dynamic-config');
+    const dynamic = config(
+      `export default { test: { projects: [() => project, Promise.resolve(project), project] } };`,
+    );
+    expect(dynamic.findings.filter((finding) => finding.code === 'dynamic-project')).toHaveLength(
+      3,
+    );
+  });
+
+  it('moves browser.api without removing adjacent comments or properties', () => {
+    for (const props of [
+      'api: { port: 4444 }, /* keep, this */ enabled: true',
+      'enabled: true, /* keep, this */ api: { port: 4444 }',
+      '/* keep, this */ api: { port: 4444 },',
+    ]) {
+      const result = config(`export default { test: { browser: { ${props} } } };`);
+      expect(result.content).toContain('api: { port: 4444 }');
+      expect(result.content.match(/api:/g)).toHaveLength(1);
+      expect(result.content).toContain('/* keep, this */');
+      expect(result.findings).toEqual([]);
+    }
+  });
+
+  it('blocks conflicting API settings', () => {
+    const result = config(
+      `export default { test: { api: { port: 1 }, browser: { api: { port: 2 } } } };`,
+    );
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ code: 'api-conflict', severity: 'block' }),
+    );
+  });
+
+  it('copies screenshots, glob perFile, and stdout defaults', () => {
+    const result = config(`export default { test: {
+browser: { screenshotDirectory: 'screens', expect: { toMatchScreenshot: { threshold: 0.1 } } },
+coverage: { include: ['src'], thresholds: { perFile: true, 'src/**': { lines: 90 }, 'lib/**': { perFile: false } } },
+reporters: ['default', 'json', ['junit', {}], ['html', { outputFile: 'reports/index.html' }]],
+} };`);
+    expect(result.content.match(/screenshotDirectory: 'screens'/g)).toHaveLength(2);
+    expect(result.content.match(/perFile: true/g)).toHaveLength(2);
+    expect(result.content).toContain('perFile: false');
+    expect(result.content.match(/stdout: true/g)).toHaveLength(2);
+    expect(result.content).toContain('outputDir: "reports"');
+    expect(result.findings.map((finding) => finding.code)).toEqual(['coverage-patterns']);
+    expect(config(result.content).content).toBe(result.content);
+  });
+
+  it('keeps explicit report destinations and reviews non-index HTML files', () => {
+    const result = config(
+      `export default { test: { outputFile: { json: 'report.json' }, reporters: ['json', ['junit', { stdout: false }], ['html', { outputFile: 'custom.html' }]] } };`,
+    );
+    expect(result.content).not.toContain('stdout: true');
+    expect(result.content).toContain('stdout: false');
+    expect(result.findings.map((finding) => finding.code)).toContain('html-output');
+  });
+
+  it.each([true, false])('retains supported benchmark options (preserveV4=%s)', (preserveV4) => {
+    const input = `export default { test: { clearMocks: false, benchmark: {
+      enabled: true, include: ['**/*.bench.ts'], exclude: [], retainSamples: true,
+    } } };`;
+    expect(config(input, preserveV4)).toEqual({ content: input, findings: [] });
+  });
+
+  it.each(['reporters', 'outputFile', 'compare', 'outputJson'])(
+    'blocks the removed benchmark.%s option',
+    (key) => {
+      const result = config(`export default { test: { benchmark: { ${key}: 'old' } } };`);
+      expect(result.findings).toEqual([
+        expect.objectContaining({ code: 'benchmark-api', severity: 'block' }),
+      ]);
+      expect(result.findings[0].message).toContain(`benchmark.${key}`);
+    },
+  );
+
+  it('reports dynamic benchmark options for review', () => {
+    expect(config('export default { test: { benchmark: options } };').findings).toEqual([
+      expect.objectContaining({ code: 'benchmark-api', severity: 'review' }),
+    ]);
+  });
+
+  it('preserves an installed Temporal polyfill only when toNotFake was omitted', () => {
+    const result = migrateVitestV5Config('vite.config.ts', 'export default { test: {} };', {
+      preserveV4: true,
+      temporalPolyfill: true,
+    });
+    expect(result.content).toContain("toNotFake: ['Temporal']");
+    const explicit = migrateVitestV5Config(
+      'vite.config.ts',
+      'export default { test: { fakeTimers: { toNotFake: [] } } };',
+      { preserveV4: true, temporalPolyfill: true },
+    );
+    expect(explicit.content).toContain('toNotFake: []');
+  });
+});
+
+describe('Vitest v5 source migration', () => {
+  it.each(['./runners', '../runners', 'custom/runners'])(
+    'leaves unrelated %s modules unchanged',
+    (specifier) => {
+      const input = `export { helper } from '${specifier}';
+export * from '${specifier}';
+const dynamic = await import('${specifier}');
+const commonjs = require('${specifier}');
+type Runner = import('${specifier}').Runner;`;
+      expect(source(input)).toEqual({ content: input, findings: [] });
+    },
+  );
+
+  it.each(['vitest/runners', 'vite-plus/test/runners'])(
+    'still reports removed %s re-exports and indirect imports',
+    (specifier) => {
+      const result = source(`export { VitestTestRunner } from '${specifier}';
+export * from '${specifier}';
+const dynamic = await import('${specifier}');
+const commonjs = require('${specifier}');
+type Runner = import('${specifier}').VitestTestRunner;`);
+      expect(result.findings.filter(({ severity }) => severity === 'block')).toHaveLength(4);
+      expect(result.findings.filter(({ severity }) => severity === 'review')).toHaveLength(1);
+      expect(result.findings.every(({ code }) => code === 'removed-api')).toBe(true);
+    },
+  );
+
+  it('preserves computed matcher keys and remains idempotent', () => {
+    const result = source(`import { test, expect } from 'vitest';
+test('text', async () => {
+  await expect.element(el)['toHaveTextContent']('partial');
+  await expect.element(el)["toHaveTextContent"](/partial/);
+});`);
+    expect(result.content).toContain('["toMatchTextContent"](\'partial\')');
+    expect(result.content).toContain('["toMatchTextContent"](/partial/)');
+    expect(result.findings).toEqual([]);
+    expect(source(result.content).content).toBe(result.content);
+  });
+
+  it('does not report matcher declarations that already use both v5 parameters', () => {
+    const input = `declare module 'vite-plus/test' {
+  interface Matchers<R extends void | Promise<void> = void | Promise<void>, T = unknown> {
+    toEqualReceived(value: T): R;
+  }
+}`;
+    expect(source(input, { preserveV4: false, browser: false })).toEqual({
+      content: input,
+      findings: [],
+    });
+    expect(source('interface Assertion<T> {}').findings).toEqual([
+      expect.objectContaining({ code: 'assertion-types', severity: 'review' }),
+    ]);
+  });
+
+  it('handles namespace imports without touching a shadowed namespace', () => {
+    const result = source(`import * as v from 'vitest';
+v.test.sequential('works', () => { v.expect(Promise.resolve(1)).resolves.toBe(1); });
+v.test('mock', () => v.vi.mock('./a'));
+function helper(v) { v.test.sequential('local', () => {}); }`);
+    expect(result.content).toContain("v.test('works', { concurrent: false }, async () =>");
+    expect(result.content).toContain('await v.expect(Promise.resolve(1)).resolves.toBe(1)');
+    expect(result.content).toContain("v.test.sequential('local', () => {})");
+    expect(result.findings.map((finding) => finding.code)).toContain('nested-hoisted-mock');
+  });
+
+  it('reports type imports without blocking runtime migration', () => {
+    const result = source(`type Runner = import('vitest/internal/module-runner').ModuleRunner;`);
+    expect(result.findings).toEqual([
+      expect.objectContaining({ severity: 'review', code: 'removed-api' }),
+    ]);
+  });
+
+  it('does not add constructor warnings for ordinary function mocks', () => {
+    expect(
+      source(`import { vi } from 'vitest'; const fn = vi.fn(() => 1); vi.spyOn(console, 'log');`)
+        .findings,
+    ).toEqual([]);
+  });
+  it('rewrites safe sequential calls and assertions together', () => {
+    const result = source(`import { test as check, expect } from 'vitest';
+check.sequential('works', () => { expect(Promise.resolve(1)).resolves.toBe(1); });
+check('options', { sequential: true }, () => {});
+expect(() => {}).toThrow('');
+expect.element(el).toHaveTextContent('partial');
+expect.element(el).toHaveTextContent(/partial/);`);
+    expect(result.content).toContain("check('works', { concurrent: false }, async () =>");
+    expect(result.content).toContain('await expect(Promise.resolve(1)).resolves.toBe(1)');
+    expect(result.content).toContain('toThrow(/^$/)');
+    expect(result.content.match(/toMatchTextContent/g)).toHaveLength(2);
+    expect(source(result.content).content).toBe(result.content);
+  });
+
+  it('respects local aliases and shadowed bindings', () => {
+    const input = `import { test, expect as assert } from 'vitest';
+function helper(test, assert) { test.sequential('x', () => {}); assert(() => {}).toThrow(''); }
+test('x', () => assert(() => {}).toThrow(''));`;
+    const result = source(input);
+    expect(result.content).toContain("test.sequential('x', () => {})");
+    expect(result.content).toContain("assert(() => {}).toThrow('')");
+    expect(result.content).toContain('toThrow(/^$/)');
+  });
+
+  it('only makes async-compatible callbacks async', () => {
+    const result = source(`import { test, describe, expect } from 'vitest';
+import { render as mount } from 'vitest-browser-vue';
+test('component', () => { const screen = mount(Component); expect(Promise.resolve(1)).resolves.toBe(1); });
+describe('suite', () => { mount(Component); });
+function publicSync() { return { screen: mount(Component) }; }`);
+    expect(result.content).toContain("test('component', async () =>");
+    expect(result.content).toContain('(await mount(Component))');
+    expect(result.content).toContain("describe('suite', () => { mount(Component); })");
+    expect(result.findings.filter((finding) => finding.code === 'async-render')).toHaveLength(2);
+  });
+
+  it('migrates runner aliases and preserves unsupported type-only imports for review', () => {
+    const result =
+      source(`import { test as check, getFn as lookup, type File as MyFile, type SuiteHooks } from '@vitest/runner';
+import { createExpect as makeExpect } from '@vitest/expect';
+lookup(task);`);
+    expect(result.content).toContain('test as check');
+    expect(result.content).toContain('type RunnerTestFile as MyFile');
+    expect(result.content).toContain('const lookup = _VitestTestRunner.getTestFn');
+    expect(result.content).toContain('createExpect as makeExpect');
+    expect(result.findings).toContainEqual(
+      expect.objectContaining({ severity: 'review', code: 'removed-api' }),
+    );
+    expect(result.findings.some((finding) => finding.severity === 'block')).toBe(false);
+  });
+
+  it('blocks unsupported active internals and benchmarks', () => {
+    const result = source(`import { startTests } from '@vitest/runner';
+import * as internals from 'vitest/internal/module-runner';
+import { bench } from 'vitest';
+bench('old', () => {});`);
+    expect(result.findings.filter((finding) => finding.severity === 'block')).toHaveLength(3);
+  });
+
+  it('blocks global benchmarks but preserves the new test-context fixture', () => {
+    const result = migrateVitestV5Source(
+      'example.test.ts',
+      `bench('old', () => {});
+test('new', ({ bench }) => { bench('new', () => {}); });`,
+      { ...v4, globals: true },
+    );
+    expect(result.findings.filter((finding) => finding.code === 'benchmark-api')).toEqual([
+      expect.objectContaining({ severity: 'block', line: 1 }),
+    ]);
+  });
+
+  it('rewrites resolveConfig destructuring with aliases and collect options', () => {
+    const result = source(`import { resolveConfig as resolve, createVitest } from 'vitest/node';
+const { viteConfig: vite, vitestConfig: test } = await resolve();
+const runner = await createVitest('test', {});
+await runner.collect();
+await runner.collect(['unit'], {});
+await runner.collect([], { staticParse: true });
+other.collect(options);`);
+    expect(result.content).toContain('const vite = await resolve(), test = vite.test');
+    expect(result.content).toContain('runner.collect(undefined, { staticParse: false })');
+    expect(result.content).toContain("runner.collect(['unit'], { staticParse: false })");
+    expect(result.content).toContain('staticParse: true');
+    expect(result.findings.map((finding) => finding.code)).toEqual(['static-collect']);
+    expect(source(result.content).content).toBe(result.content);
+  });
+
+  it('reports manual migration risks with line locations', () => {
+    const result = source(`import { vi, test, expect } from 'vitest';
+import '@vitest/ws-client';
+test('mock', () => { vi.mock('./a'); vi.fn(class {}); });
+process.env.VITEST_POOL_ID;
+globalThis.navigator = value;
+globalThis.foo = originals.get('foo');
+Temporal.Now.instant(); vi.setSystemTime(0);
+const ui = 'http://localhost:51204/__vitest__/';
+const browser = 'http://localhost:63315/__vitest_test__/';
+interface Assertion<T> {}
+expect.poll(() => 1).toBe(1);`);
+    expect(result.findings.map((finding) => finding.code)).toEqual(
+      expect.arrayContaining([
+        'ws-client',
+        'nested-hoisted-mock',
+        'browser-automock',
+        'class-mock',
+        'worker-id',
+        'dom-global',
+        'global-descriptors',
+        'temporal-system-time',
+        'ui-token',
+        'browser-session',
+        'assertion-types',
+        'poll-timeout',
+        'unawaited-assertion',
+      ]),
+    );
+    expect(result.findings.every((finding) => finding.line > 1)).toBe(true);
+  });
+});
+
+describe('Vitest v5 command migration', () => {
+  it.each([
+    'vitest list',
+    'pnpm exec vitest list',
+    'npm exec -- vitest list',
+    'npx vitest list',
+    'vp test list',
+  ])('preserves runtime collection for %s', (command) => {
+    const result = migrateVitestV5Command('package.json', `${command} 'unit tests'`, true);
+    expect(result.content).toBe(`${command} --no-static-parse 'unit tests'`);
+    expect(migrateVitestV5Command('package.json', result.content, true).content).toBe(
+      result.content,
+    );
+  });
+  it.each([
+    'vitest list --static-parse',
+    'vitest list --no-static-parse',
+    'vitest list --static-parse=false',
+  ])('keeps explicit flags: %s', (command) => {
+    expect(migrateVitestV5Command('package.json', command, true).content).toBe(command);
+  });
+  it.each([
+    'vitest list | jq .',
+    'NODE_ENV=test vitest list',
+    'vitest list "$FILTER"',
+    'wrapper vitest list',
+    'vitest list && echo done',
+  ])('reports uncertain commands: %s', (command) => {
+    const result = migrateVitestV5Command('ci.yml', command, true);
+    expect(result.content).toBe(command);
+    expect(result.findings).toContainEqual(expect.objectContaining({ code: 'static-list' }));
+  });
+  it('does not interpret filter arguments after -- as options', () => {
+    expect(
+      migrateVitestV5Command('package.json', 'vitest list -- --static-parse', true).content,
+    ).toBe('vitest list --no-static-parse -- --static-parse');
+  });
+});
+
+describe('Vitest v5 versioned preflight', () => {
+  it.each([
+    `import { defineConfig } from 'vitest/config';
+export default defineConfig(CONFIG);`,
+    `const config = CONFIG; export default config;`,
+    `module.exports = CONFIG;`,
+  ])('does not treat plugin projects or extends as Vitest config references: %s', (wrapper) => {
+    const root = project({
+      'vite.config.ts': wrapper.replace(
+        'CONFIG',
+        `{
+        plugins: [paths({ projects: ['./tsconfig.json', './plugin-options.ts'], extends: './plugin-base.ts' })],
+        test: { projects: [{ extends: './test-base.ts', test: { projects: ['./checks.ts'] } }] },
+      }`,
+      ),
+      'tsconfig.json': '{ "compilerOptions": {} }',
+      'plugin-options.ts': 'export default { test: {} };',
+      'plugin-base.ts': 'export default { test: {} };',
+      'test-base.ts': 'export default { test: {} };',
+      'checks.ts': 'export default { test: {} };',
+    });
+    const plan = planProject(root);
+    expect([...plan.projects[0].configFiles].map((file) => path.basename(file)).toSorted()).toEqual(
+      ['checks.ts', 'test-base.ts', 'vite.config.ts'],
+    );
+    expect(plan.findings.some(({ code }) => code === 'source-parse')).toBe(false);
+    expect(plan.changes.some(({ file }) => /plugin-(?:options|base)\.ts$/.test(file))).toBe(false);
+  });
+
+  it('reports the Jest-only DOM type entry without guessing mixed test configuration', () => {
+    const root = project({
+      'vite.config.ts': 'export default { test: {} };',
+      'tsconfig.json':
+        '{ // inherited setup files need review\n"compilerOptions": { "types": ["@testing-library/jest-dom", "vitest/globals"] } }',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'jest-dom-types', severity: 'review' }),
+    );
+    expect(plan.changes.some(({ file }) => file.endsWith('/tsconfig.json'))).toBe(false);
+    fs.writeFileSync(
+      path.join(root, 'tsconfig.json'),
+      JSON.stringify({
+        compilerOptions: {
+          types: [
+            '@testing-library/jest-dom',
+            '@testing-library/jest-dom/vitest',
+            'vitest/globals',
+          ],
+        },
+      }),
+    );
+    expect(planProject(root).findings.some(({ code }) => code === 'jest-dom-types')).toBe(false);
+  });
+
+  it('does not mistake ambient config declarations or type imports for a config', () => {
+    const root = project({
+      'types.ts':
+        "import type { UserConfig } from 'vitest/config';\ndeclare module 'vitest/config' { const config: UserConfig; export default config; }",
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].configFiles.size).toBe(0);
+    expect(plan.findings.map((finding) => finding.code)).toEqual(['configless-defaults']);
+  });
+
+  it('retains the Yarn catalog resolver when scanning after dependency updates', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { '@vitest/ui': '^4.1.11' } }),
+      '.yarnrc.yml': 'catalog:\n  vitest: 5.0.0\n',
+    });
+    const plan = planVitestV5Migration({ rootDir: root, packageManager: PackageManager.yarn });
+    expect(plan.projects[0].active).toBe(false);
+    applyVitestV5Migration(plan);
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: 'catalog:' } }),
+    );
+    expect(finishVitestV5Migration(plan)).toEqual([]);
+  });
+  it('migrates raw referenced configs with custom filenames and nested references', () => {
+    const root = project({
+      'vitest.config.ts': "export default { test: { projects: ['./node-tests.ts'] } };",
+      'node-tests.ts': "export default { test: { projects: ['./browser-tests.ts'] } };",
+      'browser-tests.ts': 'export default { test: { browser: { enabled: true } } };',
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].configFiles.size).toBe(3);
+    applyVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'node-tests.ts'), 'utf8')).toContain(
+      'clearMocks: false',
+    );
+    expect(fs.readFileSync(path.join(root, 'browser-tests.ts'), 'utf8')).toContain('exact: false');
+  });
+
+  it('follows project globs across workspace package boundaries', () => {
+    const root = project({
+      'vitest.config.ts': "export default { test: { projects: ['./packages/*/checks.ts'] } };",
+      'packages/unit/package.json': '{}',
+      'packages/unit/checks.ts': 'export default { test: {} };',
+    });
+    const plan = planVitestV5Migration({
+      rootDir: root,
+      packageManager: PackageManager.pnpm,
+      packages: [{ name: 'unit', path: 'packages/unit' }],
+    });
+    expect(plan.projects[1].configFiles.size).toBe(1);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'packages/unit/checks.ts'), 'utf8')).toContain(
+      'clearMocks: false',
+    );
+    const state = JSON.parse(
+      fs.readFileSync(path.join(root, '.vite-plus/migrations.json'), 'utf8'),
+    );
+    expect(state.vitest5['packages/unit'].configless).toBe(false);
+  });
+
+  it('rejects runtime input changes between preflight and application', () => {
+    const root = project({
+      '.node-version': '22.18.0',
+      'vite.config.ts': 'export default { test: {} };',
+    });
+    const plan = planProject(root);
+    fs.writeFileSync(path.join(root, '.node-version'), '20.19.0');
+    expect(() => applyVitestV5Migration(plan)).toThrow('Migration input changed');
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).not.toContain('clearMocks');
+  });
+
+  it('does not require a Vitest source version for a Vite+-only build project', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { 'vite-plus': '0.2.0' } }),
+      'vite.config.ts':
+        "import { defineConfig } from 'vite-plus'; export default defineConfig({});",
+    });
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).projects[0].active).toBe(false);
+  });
+
+  it('does not mistake a parameter named test for Vitest usage', () => {
+    const root = project({
+      'package.json': '{}',
+      'business.ts': 'export function run(test: string) { return test; }',
+    });
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).projects[0].active).toBe(false);
+  });
+
+  it('does not rewrite new v5 assertions in a previously migrated configless project', () => {
+    const root = project();
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    fs.writeFileSync(
+      path.join(root, 'new.test.ts'),
+      "import { expect } from 'vite-plus/test'; expect(() => {}).toThrow('');",
+    );
+    expect(planProject(root).changes).toEqual([]);
+  });
+  it('does not treat stale overrides or transitive lockfile packages as active tests', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { 'vite-plus': 'latest' },
+        overrides: { vitest: 'npm:@voidzero-dev/vite-plus-test@latest' },
+      }),
+      'pnpm-lock.yaml': "packages:\n  '@vitest/spy@4.1.11': {}\n",
+    });
+    expect(planProject(root).findings).toEqual([]);
+    expect(planProject(root).projects[0].active).toBe(false);
+  });
+
+  it.each([
+    ['vitest', '4.1.11', '4.1.11', {}],
+    [
+      'vitest',
+      'npm:@voidzero-dev/vite-plus-test@latest',
+      '@voidzero-dev/vite-plus-test@0.1.14',
+      {},
+    ],
+    [
+      'vite-plus',
+      '^0.1.11',
+      '0.1.14(peer@1.0.0)',
+      {
+        'vite-plus@0.1.14(peer@1.0.0)': {
+          dependencies: { '@voidzero-dev/vite-plus-test': '0.1.14' },
+        },
+      },
+    ],
+    [
+      'vite-plus',
+      '^0.2.0',
+      '0.2.0',
+      {
+        'vite-plus@0.2.0': { dependencies: { vitest: '4.1.11' } },
+      },
+    ],
+  ])(
+    'reads the original %s runner through pnpm lockfile edges (%s)',
+    (name, spec, version, snapshots) => {
+      const root = project({
+        'package.json': JSON.stringify({
+          scripts: { test: 'vp test' },
+          devDependencies: { [name]: spec },
+        }),
+        // JSON is YAML: retain exact peer-suffixed snapshot keys in this fixture.
+        'pnpm-lock.yaml': JSON.stringify({
+          lockfileVersion: '9.0',
+          importers: { '.': { devDependencies: { [name]: { specifier: spec, version } } } },
+          packages: {
+            '@voidzero-dev/vite-plus-test@0.1.14': { peerDependencies: { '@vitest/ui': '4.1.11' } },
+            'vitest@5.0.0': {},
+          },
+          snapshots: { 'vitest@5.0.0': {}, ...snapshots },
+        }),
+      });
+      expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+      expect(planProject(root).findings.some(({ severity }) => severity === 'block')).toBe(false);
+    },
+  );
+
+  it('does not infer a source runner from stale or unrelated lockfile entries', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        scripts: { test: 'vp test' },
+        devDependencies: { 'vite-plus': '^0.2.0' },
+      }),
+      'pnpm-lock.yaml': JSON.stringify({
+        importers: {
+          '.': { devDependencies: { 'vite-plus': { specifier: '^0.1.0', version: '0.1.0' } } },
+        },
+        snapshots: {
+          'vite-plus@0.1.0': { dependencies: { vitest: '4.1.11' } },
+          'vitest@5.0.0': {},
+        },
+      }),
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBeUndefined();
+    expect(planProject(root).findings).toContainEqual(
+      expect.objectContaining({ code: 'source-version', severity: 'block' }),
+    );
+  });
+
+  it.each(['^4.1.0 || ^5.0.0', '>=4', '*', '4 || 5.0.0-beta.1'])(
+    'requires installed or locked evidence for the ambiguous runner range %s',
+    (range) => {
+      const root = project({
+        'package.json': JSON.stringify({ devDependencies: { vitest: range } }),
+        'vite.config.ts': 'export default { test: {} };',
+      });
+      const plan = planProject(root);
+      expect(plan.projects[0].sourceVersion).toBeUndefined();
+      expect(plan.projects[0].options.preserveV4).toBe(false);
+      expect(plan.changes).toEqual([]);
+      expect(plan.findings).toContainEqual(
+        expect.objectContaining({ code: 'source-version', severity: 'block' }),
+      );
+    },
+  );
+
+  it.each(['4.1.11', '5.0.0'])(
+    'uses installed runner %s to disambiguate a cross-major range',
+    (version) => {
+      const root = project({
+        'package.json': JSON.stringify({ devDependencies: { vitest: '^4.1.0 || ^5.0.0' } }),
+        'node_modules/vitest/package.json': JSON.stringify({ name: 'vitest', version }),
+      });
+      const plan = planProject(root);
+      expect(plan.projects[0].sourceVersion).toBe(version);
+      expect(plan.projects[0].options.preserveV4).toBe(version.startsWith('4.'));
+      expect(plan.findings.some(({ severity }) => severity === 'block')).toBe(false);
+    },
+  );
+
+  it('uses the installed bundled runner before an ambiguous Vite+ dependency range', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { 'vite-plus': '0.2.0' },
+        scripts: { test: 'vp test' },
+      }),
+      'node_modules/vite-plus/package.json': JSON.stringify({
+        name: 'vite-plus',
+        version: '0.2.0',
+        dependencies: { vitest: '^4.1.0 || ^5.0.0' },
+      }),
+      'node_modules/vite-plus/node_modules/vitest/package.json': JSON.stringify({
+        name: 'vitest',
+        version: '5.0.0',
+      }),
+    });
+    const plan = planProject(root);
+    expect(plan.projects[0].sourceVersion).toBe('5.0.0');
+    expect(plan.projects[0].options.preserveV4).toBe(false);
+    expect(plan.findings.some(({ severity }) => severity === 'block')).toBe(false);
+  });
+
+  it('reads the upstream version from an installed legacy wrapper UI peer', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { 'vite-plus': '0.1.14' },
+        scripts: { test: 'vp test' },
+      }),
+      'node_modules/vite-plus/package.json': JSON.stringify({
+        name: 'vite-plus',
+        version: '0.1.14',
+        dependencies: { '@voidzero-dev/vite-plus-test': '0.1.14' },
+      }),
+      'node_modules/@voidzero-dev/vite-plus-test/package.json': JSON.stringify({
+        name: '@voidzero-dev/vite-plus-test',
+        version: '0.1.14',
+        peerDependencies: { '@vitest/ui': '4.1.11' },
+      }),
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+  });
+  it('uses an installed Vite+ runner version before an unrelated hoisted runner', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { 'vite-plus': '0.2.0' } }),
+      'node_modules/vite-plus/package.json': JSON.stringify({
+        name: 'vite-plus',
+        version: '0.2.0',
+        dependencies: { vitest: '4.1.11' },
+      }),
+      'node_modules/vitest/package.json': JSON.stringify({ name: 'vitest', version: '5.0.0' }),
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+  });
+  it('is read-only and blocks the entire plan before applying any safe edit', () => {
+    const root = project({
+      '.node-version': '20.19.0\n',
+      'vite.config.ts': 'export default { test: {} };',
+      'old.test.ts': "import { startTests } from '@vitest/runner'; startTests([]);",
+    });
+    const plan = planProject(root);
+    expect(
+      plan.findings
+        .filter((finding) => finding.severity === 'block')
+        .map((finding) => finding.code),
+    ).toEqual(['node-runtime', 'removed-api']);
+    expect(plan.changes.length).toBeGreaterThan(0);
+    expect(() => applyVitestV5Migration(plan)).toThrow('blocking');
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toBe(
+      'export default { test: {} };',
+    );
+    expect(fs.existsSync(path.join(root, '.vite-plus'))).toBe(false);
+  });
+
+  it('checks nvmrc, runtime metadata, public engines, CI matrices, and container images', () => {
+    const root = project({
+      '.nvmrc': '25',
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        engines: { node: '>=18' },
+        devEngines: { runtime: { name: 'node', version: '22.12.0' } },
+      }),
+      '.github/workflows/test.yml':
+        'jobs:\n  test:\n    strategy:\n      matrix:\n        node: [20, 22, 24, 25, 26]\n',
+      Dockerfile: 'FROM node:20-alpine\n',
+    });
+    const findings = planProject(root).findings.filter(
+      (finding) => finding.code === 'node-runtime',
+    );
+    expect(findings.filter((finding) => finding.severity === 'block')).toHaveLength(5);
+    expect(findings).toContainEqual(
+      expect.objectContaining({
+        severity: 'review',
+        message: expect.stringContaining('public engine contract'),
+      }),
+    );
+  });
+
+  it('does not treat source properties, comments, or Dev Container feature tags as Node images', () => {
+    const root = project({
+      'worker.js': 'export const options = { node:2 };',
+      Dockerfile: '# FROM node:20\nFROM custom/node:1\nRUN echo node:2\n',
+      'compose.yml': 'services:\n  web:\n    image: custom/node:1\n    command: echo node:2\n',
+      '.devcontainer/devcontainer.json': `{
+        // The feature tag is not the Node runtime version.
+        "features": { "ghcr.io/devcontainers/features/node:1": { "version": "lts" } }
+      }`,
+    });
+    const findings = planProject(root).findings.filter(({ code }) => code === 'node-runtime');
+    expect(findings).toEqual([
+      expect.objectContaining({
+        severity: 'review',
+        message: expect.stringContaining('Dev Container Node feature (lts)'),
+      }),
+    ]);
+  });
+
+  it.each([
+    ['Dockerfile', 'FROM --platform=linux/amd64 node:20-alpine AS build\n'],
+    ['Dockerfile.test', 'FROM docker.io/library/node:25.9.0@sha256:abc\n'],
+    ['Containerfile', 'FROM library/node:20\n'],
+    ['compose.yaml', 'services:\n  test:\n    image: node:20-alpine\n'],
+    ['.github/workflows/test.yml', 'jobs:\n  test:\n    container: node:25\n'],
+    [
+      '.github/workflows/test.yml',
+      'jobs:\n  test:\n    container:\n      image: docker.io/node:20\n',
+    ],
+    ['.devcontainer/devcontainer.json', '{ "image": "node:20" }'],
+    [
+      '.devcontainer/devcontainer.json',
+      '{ "features": { "ghcr.io/devcontainers/features/node:1": { "version": "20" } } }',
+    ],
+  ])('checks a Node runtime in %s', (file, content) => {
+    const findings = planProject(project({ [file]: content })).findings.filter(
+      ({ code }) => code === 'node-runtime',
+    );
+    expect(findings).toEqual([expect.objectContaining({ severity: 'block' })]);
+  });
+
+  it('keeps a library public engine contract separate from its test runtime pin', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        engines: { node: '20.x' },
+      }),
+      '.node-version': '22.18.0',
+    });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(
+      expect.objectContaining({ code: 'node-runtime', severity: 'review' }),
+    );
+    expect(plan.findings.some(({ severity }) => severity === 'block')).toBe(false);
+  });
+
+  it('checks Volta before its pin is migrated, but respects a higher-priority pin file', () => {
+    const root = project({
+      'package.json': JSON.stringify({
+        devDependencies: { vitest: '4.1.11' },
+        volta: { node: '20.19.0' },
+      }),
+    });
+    expect(planProject(root).findings).toContainEqual(
+      expect.objectContaining({
+        code: 'node-runtime',
+        severity: 'block',
+        message: expect.stringContaining('volta.node'),
+      }),
+    );
+    fs.writeFileSync(path.join(root, '.nvmrc'), '24.11.0');
+    expect(planProject(root).findings.some(({ severity }) => severity === 'block')).toBe(false);
+  });
+
+  it('keeps configless projects configless and records completion', () => {
+    const root = project({ '.gitignore': '.vitest-reports/\n__screenshots__/\n' });
+    const plan = planProject(root);
+    expect(plan.findings.some((finding) => finding.code === 'configless-defaults')).toBe(true);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    expect(fs.existsSync(path.join(root, 'vite.config.ts'))).toBe(false);
+    expect(fs.readFileSync(path.join(root, '.gitignore'), 'utf8')).toBe(
+      '.vitest-reports/\n__screenshots__/\n.vitest/\n',
+    );
+    expect(
+      JSON.parse(fs.readFileSync(path.join(root, '.vite-plus/migrations.json'), 'utf8')).vitest5[
+        '.'
+      ].configless,
+    ).toBe(true);
+    expect(
+      planProject(root).findings.some((finding) => finding.code === 'configless-defaults'),
+    ).toBe(true);
+  });
+
+  it('preserves defaults in a config created by another migration step', () => {
+    const root = project();
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    fs.writeFileSync(
+      path.join(root, 'vite.config.ts'),
+      "import { defineConfig } from 'vite-plus'; export default defineConfig({});",
+    );
+    finishVitestV5Migration(plan);
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toContain(
+      'clearMocks: false',
+    );
+  });
+
+  it('offers a separate creation action and never overwrites an existing config', () => {
+    const root = project();
+    const plan = planProject(root);
+    const file = createVitestV5CompatibilityConfig(plan, root);
+    expect(fs.readFileSync(file, 'utf8')).toContain('clearMocks: false');
+    expect(() => createVitestV5CompatibilityConfig(plan, root)).toThrow('already exists');
+  });
+
+  it('does not reapply compatibility defaults after the user adopts v5 defaults', () => {
+    const root = project({ 'vite.config.ts': 'export default { test: {} };' });
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    fs.writeFileSync(path.join(root, 'vite.config.ts'), 'export default { test: {} };');
+    fs.writeFileSync(
+      path.join(root, 'package.json'),
+      JSON.stringify({ devDependencies: { vitest: '5.0.0' } }),
+    );
+    const next = planProject(root);
+    expect(next.projects[0].options.preserveV4).toBe(false);
+    applyVitestV5Migration(next);
+    finishVitestV5Migration(next);
+    expect(fs.readFileSync(path.join(root, 'vite.config.ts'), 'utf8')).toBe(
+      'export default { test: {} };',
+    );
+  });
+
+  it('resolves v4 catalogs and leaves already-v5 projects on new defaults', () => {
+    const root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: 'catalog:testing' } }),
+      'pnpm-workspace.yaml': 'catalogs:\n  testing:\n    vitest: ^4.1.11\n',
+      'vite.config.ts': 'export default { test: {} };',
+    });
+    expect(planProject(root).projects[0].sourceVersion).toBe('4.1.11');
+    const v5root = project({
+      'package.json': JSON.stringify({ devDependencies: { vitest: '5.0.0' } }),
+      'vite.config.ts': 'export default { test: {} };',
+    });
+    expect(planProject(v5root).changes).toEqual([]);
+  });
+
+  it('retains unresolved findings on later scans and groups them by file', () => {
+    const root = project({
+      'mock.test.ts': "import { test, vi } from 'vitest'; test('mock', () => vi.mock('./a'));",
+    });
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    const after = finishVitestV5Migration(plan);
+    expect(after.some((finding) => finding.code === 'nested-hoisted-mock')).toBe(true);
+    expect(
+      planProject(root).findings.some((finding) => finding.code === 'nested-hoisted-mock'),
+    ).toBe(true);
+    const report = formatVitestV5Findings(plan);
+    expect(report).toContain('Vitest v5:');
+    expect(report).toContain('mock.test.ts\n  1:');
+  });
+
+  it('retains deferred resolveConfig reviews without reapplying v4 source edits', () => {
+    const input = `import { resolveConfig } from 'vitest/node';
+const pair = await resolveConfig();
+export const config = pair.viteConfig;`;
+    const root = project({ 'runner.ts': input });
+    const plan = planProject(root);
+    expect(plan.findings).toContainEqual(expect.objectContaining({ code: 'resolve-config' }));
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan)).toContainEqual(
+      expect.objectContaining({ code: 'resolve-config' }),
+    );
+    const repeated = planProject(root);
+    expect(repeated.findings).toContainEqual(expect.objectContaining({ code: 'resolve-config' }));
+    expect(repeated.changes).toEqual([]);
+    expect(fs.readFileSync(path.join(root, 'runner.ts'), 'utf8')).toBe(input);
+    fs.writeFileSync(path.join(root, 'runner.ts'), 'export const config = {};');
+    expect(planProject(root).findings.some(({ code }) => code === 'resolve-config')).toBe(false);
+  });
+
+  it('does not retain a resolveConfig warning for a successful automatic rewrite', () => {
+    const root = project({
+      'runner.ts': `import { resolveConfig } from 'vitest/node';\nconst { viteConfig } = await resolveConfig();`,
+    });
+    const plan = planProject(root);
+    applyVitestV5Migration(plan);
+    expect(finishVitestV5Migration(plan).some(({ code }) => code === 'resolve-config')).toBe(false);
+    expect(planProject(root).findings.some(({ code }) => code === 'resolve-config')).toBe(false);
+  });
+
+  it('uses portable workspace keys in the committed migration state', () => {
+    const root = project({
+      'packages/a/package.json': JSON.stringify({ devDependencies: { vitest: '4.1.11' } }),
+      'packages/a/vite.config.ts': 'export default { test: {} };',
+    });
+    const workspace = {
+      rootDir: root,
+      packageManager: PackageManager.pnpm,
+      packages: [{ name: 'a', path: 'packages/a' }],
+    };
+    const plan = planVitestV5Migration(workspace);
+    applyVitestV5Migration(plan);
+    finishVitestV5Migration(plan);
+    const state = JSON.parse(
+      fs.readFileSync(path.join(root, '.vite-plus/migrations.json'), 'utf8'),
+    );
+    expect(Object.keys(state.vitest5).toSorted()).toEqual(['.', 'packages/a']);
+    expect(
+      planVitestV5Migration(workspace).projects.every(({ options }) => !options.preserveV4),
+    ).toBe(true);
+  });
+
+  it('refuses to overwrite files changed since preflight', () => {
+    const root = project({ 'vite.config.ts': 'export default { test: {} };' });
+    const plan = planProject(root);
+    fs.writeFileSync(path.join(root, 'vite.config.ts'), '// changed by editor\nexport default {};');
+    expect(() => applyVitestV5Migration(plan)).toThrow('Migration input changed');
+  });
+
+  it('does not follow symlinks or edit fixtures under nested package boundaries', () => {
+    const root = project({
+      'nested/package.json': '{}',
+      'nested/vite.config.ts': 'export default { test: {} };',
+      'node_modules/ignored/vite.config.ts': 'export default { test: {} };',
+    });
+    expect(planProject(root).changes).toEqual([]);
+  });
+});
diff --git a/packages/cli/src/migration/bin.ts b/packages/cli/src/migration/bin.ts
index b43647875e..3d3f3f358b 100644
--- a/packages/cli/src/migration/bin.ts
+++ b/packages/cli/src/migration/bin.ts
@@ -38,9 +38,11 @@ import { checkRolldownCompatibility } from './compat/runner.ts';
 import { canFormatWithOxfmt, collectChangedFormatPaths, formatMigratedProject } from './format.ts';
 import {
   addFrameworkShim,
+  applyVitestV5Migration,
   checkVitestVersion,
   checkViteVersion,
   collectToolchainVersionChanges,
+  createVitestV5CompatibilityConfig,
   confirmPrettierMigration,
   detectEslintProject,
   detectFramework,
@@ -52,6 +54,8 @@ import {
   detectYarnPnpMode,
   ensureVitePlusBootstrap,
   finalizeCoreMigrationForExistingVitePlus,
+  finishVitestV5Migration,
+  formatVitestV5Findings,
   hasFrameworkShim,
   detectLegacyGitHooksMigrationCandidate,
   injectLintTypeCheckDefaults,
@@ -66,10 +70,14 @@ import {
   configureYarnNodeModulesMode,
   rewriteMonorepo,
   rewriteStandaloneProject,
+  planVitestV5Migration,
   shouldSkipStagedMigrationForHooks,
   warnPackageLevelPrettier,
+  vitestV5ConfiglessProjects,
+  vitestV5NeedsMigration,
   type Framework,
   type NodeVersionManagerDetection,
+  type VitestV5MigrationPlan,
 } from './migrator.ts';
 import { prepareNpmViteAliasReinstall } from './npm-reinstall.ts';
 import type { MigrationOptions } from './options.ts';
@@ -687,10 +695,38 @@ async function downloadSupportedPackageManager(options: {
   return downloadResult;
 }
 
+async function completeVitestV5Migration(
+  plan: VitestV5MigrationPlan,
+  interactive: boolean,
+  report: MigrationReport,
+) {
+  if (interactive) {
+    for (const directory of vitestV5ConfiglessProjects(plan)) {
+      const confirmed = await prompts.confirm({
+        message: `Create a minimal Vitest v4 compatibility config in ${displayRelative(directory, plan.rootDir) || '.'}? A new config can change config discovery and project structure.`,
+        initialValue: false,
+      });
+      if (prompts.isCancel(confirmed)) {
+        cancelAndExit();
+      }
+      if (confirmed) {
+        createVitestV5CompatibilityConfig(plan, directory);
+      }
+    }
+  }
+  const findings = finishVitestV5Migration(plan);
+  report.warnings = report.warnings.filter((warning) => !warning.startsWith('Vitest v5:'));
+  const summary = formatVitestV5Findings({ rootDir: plan.rootDir, findings });
+  if (summary) {
+    addMigrationWarning(report, summary);
+  }
+}
+
 async function executeMigrationPlan(
   workspaceInfoOptional: WorkspaceInfoOptional,
   plan: MigrationPlan,
   interactive: boolean,
+  vitestV5Plan: VitestV5MigrationPlan,
   preExistingChangedPaths?: ReadonlySet<string>,
 ): Promise<{
   installDurationMs: number;
@@ -699,6 +735,7 @@ async function executeMigrationPlan(
   report: MigrationReport;
 }> {
   const report = createMigrationReport();
+  applyVitestV5Migration(vitestV5Plan);
   const migrationProgress = interactive ? prompts.spinner({ indicator: 'timer' }) : undefined;
   let migrationProgressStarted = false;
   const updateMigrationProgress = (message: string) => {
@@ -857,6 +894,9 @@ async function executeMigrationPlan(
   }
 
   // 8. Install git hooks
+  clearMigrationProgress();
+  await completeVitestV5Migration(vitestV5Plan, interactive, report);
+
   if (plan.shouldSetupHooks) {
     updateMigrationProgress('Configuring git hooks');
     installGitHooks(
@@ -978,6 +1018,17 @@ async function main() {
   const initialChangedPaths = await collectChangedFormatPaths(workspaceInfoOptional.rootDir);
   const preExistingChangedPaths = initialChangedPaths ? new Set(initialChangedPaths) : undefined;
   const resolvedPackageManager = workspaceInfoOptional.packageManager ?? 'unknown';
+  const vitestV5Plan = planVitestV5Migration(workspaceInfoOptional);
+  const vitestV5Preflight = formatVitestV5Findings(vitestV5Plan);
+  if (vitestV5Preflight) {
+    prompts.log.warn(vitestV5Preflight);
+  }
+  if (vitestV5Plan.findings.some((finding) => finding.severity === 'block')) {
+    cancelAndExit(
+      'Resolve the blocking Vitest v5 findings, then re-run `vp migrate`. No project files were changed.',
+      1,
+    );
+  }
 
   // Early return if already using Vite+ (only finalization/setup migrations may be needed)
   // In force-override mode (file: tgz overrides), skip this check and run full migration
@@ -995,11 +1046,15 @@ async function main() {
       workspaceInfoOptional.packageManagerVersion,
       options.interactive,
     );
-    let didMigrate = false;
+    let didMigrate = vitestV5NeedsMigration(vitestV5Plan);
+    applyVitestV5Migration(vitestV5Plan);
     let installDurationMs = 0;
     let finalInstallOk = true;
     let canFormatMigratedProject = !process.env.VP_SKIP_INSTALL;
     const report = createMigrationReport();
+    // Preflight findings were already printed. Add the remaining findings
+    // after actual edits; review-only items must not force an otherwise
+    // up-to-date project through dependency reconciliation on every run.
     const migrationProgress = options.interactive
       ? prompts.spinner({ indicator: 'timer' })
       : undefined;
@@ -1388,6 +1443,8 @@ async function main() {
     }
 
     if (needsInstall) {
+      clearMigrationProgress();
+      await completeVitestV5Migration(vitestV5Plan, options.interactive, report);
       const resolved = await ensureExistingPackageManager();
       updateMigrationProgress('Installing dependencies');
       const resolvedVersion = resolved?.version ?? packageManagerVersion;
@@ -1461,6 +1518,10 @@ async function main() {
     }
 
     // Check for Rolldown-incompatible config patterns (root + workspace packages)
+    if (!needsInstall) {
+      clearMigrationProgress();
+      await completeVitestV5Migration(vitestV5Plan, options.interactive, report);
+    }
     await checkWorkspaceRolldownCompatibility(
       workspaceInfoOptional,
       report,
@@ -1521,6 +1582,7 @@ async function main() {
     workspaceInfoOptional,
     plan,
     options.interactive,
+    vitestV5Plan,
     preExistingChangedPaths,
   );
   showMigrationSummary({
diff --git a/packages/cli/src/migration/migrator.ts b/packages/cli/src/migration/migrator.ts
index d5d5f122b7..1c745797e0 100644
--- a/packages/cli/src/migration/migrator.ts
+++ b/packages/cli/src/migration/migrator.ts
@@ -5,6 +5,7 @@ export * from './migrator/tsup.ts';
 export * from './migrator/tsconfig.ts';
 export * from './migrator/framework-shim.ts';
 export * from './migrator/vitest-ecosystem.ts';
+export * from './migrator/vitest-v5.ts';
 export * from './migrator/catalog.ts';
 export * from './migrator/yarn.ts';
 export * from './migrator/source-scan.ts';
diff --git a/packages/cli/src/migration/migrator/README.md b/packages/cli/src/migration/migrator/README.md
index c7bd615944..6c04b5eaae 100644
--- a/packages/cli/src/migration/migrator/README.md
+++ b/packages/cli/src/migration/migrator/README.md
@@ -26,6 +26,7 @@ Pick the file by what a function _does_, not by where it happens to be called.
 | `vite-plus-bootstrap.ts` | "Already on Vite+" detection and the bootstrap/reconcile path: `detectVitePlusBootstrapPending`, `ensureVitePlusBootstrap`, `reconcileVitePlusBootstrapPackage`, the `ensure*`/`*Pending`/`*SatisfiesVitePlus` helpers. |
 | `catalog.ts`             | `pnpm-workspace.yaml` / catalog / overrides / build-allowance writers and catalog-dependency resolvers; bun catalog; `rewriteRootWorkspacePackageJson`; pnpm workspace-settings migration.                              |
 | `vitest-ecosystem.ts`    | Detecting direct vitest usage, the override-key ("dependency selector") parsing/dropping logic, managed-override sets, ecosystem alignment, legacy `vite-plus-test` wrapper-alias pruning.                              |
+| `vitest-v5.ts`           | Versioned Vitest v5 preflight, compatibility edits, review findings, and completion state. Pure AST and command transforms live under `../vitest-v5/`.                                                                  |
 | `yarn.ts`                | `.yarnrc.yml`, Yarn PnP detection, workspace-hoisting fix, webdriverio detection.                                                                                                                                       |
 | `source-scan.ts`         | Scanning a project's source tree for signals (browser-mode, opt-in providers, `@nuxt/test-utils`, retained upstream-vitest references).                                                                                 |
 | `vite-config.ts`         | `vite.config.ts` merging, default-config injection, staged-config merge, lazy-plugin wrapping, import rewriting (`rewriteAllImports`), migrated-oxlint-config sanitization, lint-staged removal.                        |
diff --git a/packages/cli/src/migration/migrator/catalog.ts b/packages/cli/src/migration/migrator/catalog.ts
index a5aefd7718..a4c3928798 100644
--- a/packages/cli/src/migration/migrator/catalog.ts
+++ b/packages/cli/src/migration/migrator/catalog.ts
@@ -14,6 +14,7 @@ import {
   isForceOverrideMode,
 } from '../../utils/constants.ts';
 import { editJsonFile, readJsonFile } from '../../utils/json.ts';
+import { vitestEcosystemVersion } from '../../utils/vitest-ecosystem.ts';
 import { type NpmWorkspaces } from '../../utils/workspace.ts';
 import { editYamlFile, readYamlFile, scalarString, type YamlDocument } from '../../utils/yaml.ts';
 import {
@@ -1010,7 +1011,7 @@ function rewriteYamlCatalogAtPath(
       : catalogAdditions;
     for (const name of additions) {
       if (isAlignableVitestEcosystemPackage(name)) {
-        catalog.set(scalarString(name), scalarString(VITEST_VERSION));
+        catalog.set(scalarString(name), scalarString(vitestEcosystemVersion(name)));
       }
     }
   }
@@ -1036,7 +1037,7 @@ function rewriteVitestEcosystemYamlCatalog(
       vitestEcosystemPackages.has(name) &&
       isAlignableVitestEcosystemPackage(name)
     ) {
-      catalog.set(item.key, scalarString(VITEST_VERSION));
+      catalog.set(item.key, scalarString(vitestEcosystemVersion(name)));
     }
   }
 }
@@ -1068,7 +1069,7 @@ function rewriteCatalogObject(
   if (VITEST_IS_MANAGED_OVERRIDE) {
     for (const name of Object.keys(catalog)) {
       if (vitestEcosystemPackages.has(name) && isAlignableVitestEcosystemPackage(name)) {
-        catalog[name] = VITEST_VERSION;
+        catalog[name] = vitestEcosystemVersion(name);
       }
     }
   }
diff --git a/packages/cli/src/migration/migrator/package-json.ts b/packages/cli/src/migration/migrator/package-json.ts
index 070ceeb0f0..2c2ee21d82 100644
--- a/packages/cli/src/migration/migrator/package-json.ts
+++ b/packages/cli/src/migration/migrator/package-json.ts
@@ -7,6 +7,7 @@ import {
   VITE_PLUS_VERSION,
   isForceOverrideMode,
 } from '../../utils/constants.ts';
+import { vitestEcosystemVersion } from '../../utils/vitest-ecosystem.ts';
 import {
   VITEST_DIRECT_USAGE_EXCLUDED,
   alignVitestEcosystemPackages,
@@ -246,7 +247,7 @@ export function rewritePackageJson(
       pkg.devDependencies ??= {};
       pkg.devDependencies[provider] = getCatalogDependencySpec(
         undefined,
-        VITEST_VERSION,
+        vitestEcosystemVersion(provider),
         supportCatalog && packageManager !== PackageManager.bun,
         { preferredCatalogSpec: catalogDependencyResolver?.preferredCatalogSpec },
       );
diff --git a/packages/cli/src/migration/migrator/vite-plus-bootstrap.ts b/packages/cli/src/migration/migrator/vite-plus-bootstrap.ts
index 4a327f91e9..785cf7c553 100644
--- a/packages/cli/src/migration/migrator/vite-plus-bootstrap.ts
+++ b/packages/cli/src/migration/migrator/vite-plus-bootstrap.ts
@@ -10,6 +10,7 @@ import {
   isForceOverrideMode,
 } from '../../utils/constants.ts';
 import { editJsonFile, readJsonFile } from '../../utils/json.ts';
+import { vitestEcosystemVersion } from '../../utils/vitest-ecosystem.ts';
 import { type NpmWorkspaces } from '../../utils/workspace.ts';
 import { editYamlFile, readYamlFile, type YamlDocument } from '../../utils/yaml.ts';
 import {
@@ -399,7 +400,7 @@ function reconcileVitePlusBootstrapPackage(
       pkg.devDependencies ??= {};
       pkg.devDependencies[provider] = getCatalogDependencySpec(
         undefined,
-        VITEST_VERSION,
+        vitestEcosystemVersion(provider),
         supportCatalog && packageManager !== PackageManager.bun,
         { preferredCatalogSpec: catalogDependencyResolver?.preferredCatalogSpec },
       );
@@ -1412,7 +1413,7 @@ export async function collectToolchainVersionChanges(
     }
   }
   for (const name of [...scopedVitestNames].toSorted()) {
-    pushChange(name, VITEST_VERSION, fromFor(name));
+    pushChange(name, vitestEcosystemVersion(name), fromFor(name));
   }
 
   return changes;
diff --git a/packages/cli/src/migration/migrator/vitest-ecosystem.ts b/packages/cli/src/migration/migrator/vitest-ecosystem.ts
index 88467d5c9a..04016da8a6 100644
--- a/packages/cli/src/migration/migrator/vitest-ecosystem.ts
+++ b/packages/cli/src/migration/migrator/vitest-ecosystem.ts
@@ -4,15 +4,14 @@ import path from 'node:path';
 import { YAMLMap } from 'yaml';
 
 import { PackageManager, type WorkspacePackage } from '../../types/index.ts';
-import {
-  VITEST_VERSION,
-  VITE_PLUS_NAME,
-  VITE_PLUS_OVERRIDE_PACKAGES,
-} from '../../utils/constants.ts';
+import { VITE_PLUS_NAME, VITE_PLUS_OVERRIDE_PACKAGES } from '../../utils/constants.ts';
 import { readJsonFile } from '../../utils/json.ts';
 import { extractOverrideTargetName } from '../../utils/package-overrides.ts';
 import { detectPackageMetadata } from '../../utils/package.ts';
-import { isAlignableVitestEcosystemPackage } from '../../utils/vitest-ecosystem.ts';
+import {
+  isAlignableVitestEcosystemPackage,
+  vitestEcosystemVersion,
+} from '../../utils/vitest-ecosystem.ts';
 import {
   bootstrapProjectPaths,
   getCatalogDependencySpec,
@@ -623,7 +622,7 @@ export function getAlignedVitestEcosystemDependencySpec(
   // catalog-ized — so the toolchain and its ecosystem share one catalog source
   // of truth. rewriteCatalog adds the matching catalog entry (keyed on the
   // catalog owning `vitest`), keeping the two writers consistent and idempotent.
-  return getCatalogDependencySpec(current, VITEST_VERSION, supportCatalog, {
+  return getCatalogDependencySpec(current, vitestEcosystemVersion(dependencyName), supportCatalog, {
     dependencyField,
     dependencyName,
     packageManager,
@@ -695,7 +694,7 @@ export function vitestEcosystemCatalogReferencesPending(
       if (
         isAlignableVitestEcosystemPackage(name) &&
         spec.startsWith('catalog:') &&
-        catalogDependencyResolver(spec, name) !== VITEST_VERSION
+        catalogDependencyResolver(spec, name) !== vitestEcosystemVersion(name)
       ) {
         return true;
       }
diff --git a/packages/cli/src/migration/migrator/vitest-v5.ts b/packages/cli/src/migration/migrator/vitest-v5.ts
new file mode 100644
index 0000000000..a9760a5dfd
--- /dev/null
+++ b/packages/cli/src/migration/migrator/vitest-v5.ts
@@ -0,0 +1,1012 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { parse as parseJsonc } from 'jsonc-parser';
+import semver from 'semver';
+import { isNode, isScalar, parseDocument, visit } from 'yaml';
+
+import cliPackage from '../../../package.json' with { type: 'json' };
+import { PackageManager, type WorkspaceInfoOptional } from '../../types/index.ts';
+import { detectPackageMetadata } from '../../utils/package.ts';
+import { createCatalogDependencyResolver } from '../migrator.ts';
+import { type SourceOptions, type VitestV5Finding } from '../vitest-v5/ast.ts';
+import { migrateVitestV5Command } from '../vitest-v5/commands.ts';
+import {
+  findVitestV5ConfigFiles,
+  migrateVitestV5Config,
+  resolveVitestV5BrowserModes,
+} from '../vitest-v5/config.ts';
+import { migrateVitestV5Source } from '../vitest-v5/source.ts';
+
+const STATE_PATH = '.vite-plus/migrations.json';
+const SKIP_DIRS = new Set([
+  'node_modules',
+  '.git',
+  '.vite',
+  '.vitest',
+  '.vite-plus',
+  '.cache',
+  'dist',
+  'build',
+  'out',
+  'coverage',
+  '.next',
+  '.nuxt',
+  '.svelte-kit',
+]);
+const CODE_FILE = /\.[cm]?[jt]sx?$/;
+const VITEST_SIGNAL =
+  /(?:['"](?:vitest(?:\/[^'"]*)?|@vitest\/[^'"]+|vite-plus\/test[^'"]*)['"]|\bvp\s+test\b|\bvitest\s+(?:run|list|bench))/;
+const VITEST_COMMAND = /\b(?:vp\s+test|vitest)(?:\s|$)/;
+const BROWSER_SIGNAL =
+  /@vitest\/browser|(?:vitest|vite-plus\/test)\/browser|vitest-browser-|browser\s*:\s*\{|--browser(?:[.=\s'"]|$)/;
+const LEGACY_RUNNER = '@voidzero-dev/vite-plus-test';
+
+interface ProjectState {
+  sourceVersion: string;
+  configless: boolean;
+  pendingSourceReviews?: Record<string, string[]>;
+}
+interface MigrationState {
+  version: 1;
+  vitest5?: Record<string, ProjectState>;
+}
+interface ProjectPlan {
+  directory: string;
+  sourceVersion?: string;
+  active: boolean;
+  options: SourceOptions;
+  configFiles: Set<string>;
+  pendingSourceReviews?: Record<string, string[]>;
+}
+
+const DEFERRED_SOURCE_REVIEWS = new Set(['resolve-config', 'overlapping-edits', 'unsafe-syntax']);
+interface FileChange {
+  file: string;
+  before: string;
+  after: string;
+}
+export interface VitestV5MigrationPlan {
+  rootDir: string;
+  packageManager?: PackageManager;
+  projects: ProjectPlan[];
+  findings: VitestV5Finding[];
+  changes: FileChange[];
+  inputs: ReadonlyMap<string, string | null>;
+  state: MigrationState;
+}
+
+function readJson(file: string): Record<string, unknown> {
+  return JSON.parse(fs.readFileSync(file, 'utf8').replace(/^\uFEFF/, ''));
+}
+function record(value: unknown): Record<string, unknown> | undefined {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : undefined;
+}
+function dependency(pkg: Record<string, unknown>, name: string): string | undefined {
+  for (const field of [
+    'dependencies',
+    'devDependencies',
+    'optionalDependencies',
+    'peerDependencies',
+  ]) {
+    const spec = record(pkg[field])?.[name];
+    if (typeof spec === 'string') {
+      return spec;
+    }
+  }
+  return undefined;
+}
+
+function projectStateKey(root: string, directory: string): string {
+  return path.relative(root, directory).replaceAll('\\', '/') || '.';
+}
+
+function filesInProject(directory: string): string[] {
+  const files: string[] = [];
+  const walk = (current: string) => {
+    if (current !== directory && fs.existsSync(path.join(current, 'package.json'))) {
+      return;
+    }
+    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+      const file = path.join(current, entry.name);
+      // Never follow symlinks into another package or outside the workspace.
+      if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
+        walk(file);
+      } else if (
+        entry.isFile() &&
+        (CODE_FILE.test(file) ||
+          /\.(?:json|ya?ml|sh)$/.test(file) ||
+          /^Dockerfile(?:\.|$)|^Containerfile(?:\.|$)/.test(entry.name) ||
+          ['.node-version', '.nvmrc', '.gitignore'].includes(entry.name))
+      ) {
+        files.push(file);
+      }
+    }
+  };
+  walk(directory);
+  return files.toSorted();
+}
+
+function finding(
+  file: string,
+  code: string,
+  message: string,
+  severity: VitestV5Finding['severity'] = 'review',
+  source = '',
+  offset = 0,
+): VitestV5Finding {
+  const prefix = source.slice(0, offset);
+  return {
+    file,
+    line: prefix.split('\n').length,
+    column: offset - prefix.lastIndexOf('\n'),
+    code,
+    severity,
+    message,
+  };
+}
+
+/** Follow this project's dependency edges, never an unrelated transitive runner. */
+function lockedSourceVersion(
+  directory: string,
+  root: string,
+  pkg: Record<string, unknown>,
+  manager?: PackageManager,
+): string | undefined {
+  if (manager !== undefined && manager !== PackageManager.pnpm) {
+    return undefined;
+  }
+  const lockfile = path.join(root, 'pnpm-lock.yaml');
+  if (!fs.existsSync(lockfile)) {
+    return undefined;
+  }
+  try {
+    const document = parseDocument(fs.readFileSync(lockfile, 'utf8'));
+    if (document.errors.length) {
+      return undefined;
+    }
+    const lock = record(document.toJS());
+    const importer = record(
+      record(lock?.importers)?.[path.relative(root, directory).replaceAll('\\', '/') || '.'],
+    );
+    if (!importer) {
+      return undefined;
+    }
+    const name = dependency(pkg, 'vitest') ? 'vitest' : 'vite-plus';
+    const spec = dependency(pkg, name);
+    if (!spec) {
+      return undefined;
+    }
+    const entry = ['dependencies', 'devDependencies', 'optionalDependencies']
+      .map((field) => record(importer[field])?.[name])
+      .find((value) => value !== undefined);
+    const metadata = record(entry);
+    if (typeof metadata?.specifier === 'string' && metadata.specifier !== spec) {
+      return undefined;
+    }
+    const follow = (name: string, value: unknown, depth = 0): string | undefined => {
+      const reference = typeof value === 'string' ? value : record(value)?.version;
+      if (typeof reference !== 'string' || depth > 3) {
+        return undefined;
+      }
+      if (reference.startsWith(`${LEGACY_RUNNER}@`)) {
+        return follow(LEGACY_RUNNER, reference.slice(LEGACY_RUNNER.length + 1), depth + 1);
+      }
+      const version = reference.split('(')[0];
+      if (!semver.valid(version)) {
+        return undefined;
+      }
+      if (name === 'vitest') {
+        return version;
+      }
+      if (name === LEGACY_RUNNER) {
+        // The wrapper has a Vite+ version; its exact UI peer records the
+        // upstream runner version, including when the optional UI is absent.
+        const legacy = record(record(lock?.packages)?.[`${name}@${version}`]);
+        const runnerVersion = record(legacy?.peerDependencies)?.['@vitest/ui'];
+        return typeof runnerVersion === 'string'
+          ? (semver.valid(runnerVersion) ?? undefined)
+          : undefined;
+      }
+      const snapshot = record(record(lock?.snapshots)?.[`${name}@${reference}`]);
+      const dependencies = record(snapshot?.dependencies);
+      return (
+        follow('vitest', dependencies?.vitest, depth + 1) ??
+        follow(LEGACY_RUNNER, dependencies?.[LEGACY_RUNNER], depth + 1)
+      );
+    };
+    return follow(name, entry);
+  } catch {
+    // An unreadable or unsupported lockfile is not evidence of a v4 runner.
+    return undefined;
+  }
+}
+
+function unambiguousRunnerVersion(range: string): string | undefined {
+  if (
+    !semver.validRange(range) ||
+    (!semver.subset(range, '<5.0.0-0', { includePrerelease: true }) &&
+      !semver.subset(range, '>=5.0.0-0', { includePrerelease: true }))
+  ) {
+    // A range that crosses the v4/v5 boundary cannot establish which defaults
+    // the project used. Require its installed runner or an exact lockfile edge.
+    return undefined;
+  }
+  return semver.minVersion(range)?.version;
+}
+
+function installedSourceVersion(directory: string, name: string): string | undefined {
+  const installed = detectPackageMetadata(directory, name);
+  if (!installed) {
+    return undefined;
+  }
+  if (installed.name === 'vitest') {
+    return semver.valid(installed.version) ?? undefined;
+  }
+  const pkg = readJson(path.join(installed.path, 'package.json'));
+  if (installed.name === LEGACY_RUNNER) {
+    const version = record(pkg.peerDependencies)?.['@vitest/ui'];
+    return typeof version === 'string' ? (semver.valid(version) ?? undefined) : undefined;
+  }
+  if (installed.name !== 'vite-plus') {
+    return undefined;
+  }
+  const bundled = dependency(pkg, 'vitest');
+  if (bundled && semver.validRange(bundled)) {
+    const version = installedSourceVersion(installed.path, 'vitest');
+    return version && semver.satisfies(version, bundled, { includePrerelease: true })
+      ? version
+      : unambiguousRunnerVersion(bundled);
+  }
+  return dependency(pkg, LEGACY_RUNNER)
+    ? installedSourceVersion(installed.path, LEGACY_RUNNER)
+    : undefined;
+}
+
+function sourceVersion(
+  directory: string,
+  root: string,
+  pkg: Record<string, unknown>,
+  manager?: PackageManager,
+): string | undefined {
+  const catalog = createCatalogDependencyResolver(root, manager ?? PackageManager.pnpm);
+  let spec = dependency(pkg, 'vitest');
+  if (spec?.startsWith('catalog:')) {
+    spec = catalog?.(spec, 'vitest');
+  }
+  const legacyAlias = spec?.startsWith(`npm:${LEGACY_RUNNER}@`);
+  if (spec?.startsWith('npm:vitest@')) {
+    spec = spec.slice('npm:vitest@'.length);
+  }
+  if (!spec && dependency(pkg, 'vite-plus')) {
+    const bundled = installedSourceVersion(directory, 'vite-plus');
+    if (bundled) {
+      return bundled;
+    }
+  }
+  const locked = lockedSourceVersion(directory, root, pkg, manager);
+  if (
+    locked &&
+    (!spec ||
+      legacyAlias ||
+      !semver.validRange(spec) ||
+      semver.satisfies(locked, spec, { includePrerelease: true }))
+  ) {
+    return locked;
+  }
+  const installed = installedSourceVersion(directory, 'vitest');
+  if (
+    installed &&
+    (!spec || legacyAlias || semver.satisfies(installed, spec, { includePrerelease: true }))
+  ) {
+    return installed;
+  }
+  if (legacyAlias) {
+    // This removed wrapper only shipped the v4 runner. Prefer its exact
+    // version from the original install or lockfile when one is available.
+    return '4.0.0';
+  }
+  if (spec && semver.validRange(spec)) {
+    return unambiguousRunnerVersion(spec);
+  }
+  if (dependency(pkg, 'vite-plus')) {
+    const bundled = installedSourceVersion(directory, 'vite-plus');
+    if (bundled) {
+      return bundled;
+    }
+  }
+  // A workspace member commonly uses the root's test command and dependencies.
+  if (directory !== root) {
+    return sourceVersion(root, root, readJson(path.join(root, 'package.json')), manager);
+  }
+  return undefined;
+}
+
+function checkNodeRange(
+  file: string,
+  value: string,
+  label: string,
+  findings: VitestV5Finding[],
+  publicContract = false,
+  source = '',
+  offset = 0,
+) {
+  const range = semver.validRange(value);
+  if (!range) {
+    findings.push(
+      finding(
+        file,
+        'node-runtime',
+        `Resolve ${label} (${value}) and select Node ${cliPackage.engines.node}.`,
+        'review',
+        source,
+        offset,
+      ),
+    );
+  } else if (!publicContract && !semver.intersects(range, cliPackage.engines.node)) {
+    findings.push(
+      finding(
+        file,
+        'node-runtime',
+        `${label} (${value}) cannot run Vite+ with Vitest v5. Select Node ${cliPackage.engines.node}; use vp env pin 22 --force for a runtime pin. Do not widen a library's engines.node contract automatically.`,
+        'block',
+        source,
+        offset,
+      ),
+    );
+  } else if (
+    !semver.subset(range, cliPackage.engines.node) &&
+    (publicContract || /[<>|*]/.test(value))
+  ) {
+    findings.push(
+      finding(
+        file,
+        'node-runtime',
+        `${label} (${value}) includes unsupported test runtimes. Pin the test/CI runtime to Node ${cliPackage.engines.node}; keep the library's public engine contract separate.`,
+        'review',
+        source,
+        offset,
+      ),
+    );
+  }
+}
+
+function scanNode(file: string, source: string, findings: VitestV5Finding[]) {
+  const base = path.basename(file);
+  const checkImage = (image: unknown, offset = 0) => {
+    if (typeof image !== 'string') {
+      return;
+    }
+    // Only the official Node image has a tag that identifies the runtime.
+    // Feature versions and custom image tags have a different meaning.
+    const match = /^(?:docker\.io\/)?(?:library\/)?node(?::([^@\s]+))?(?:@\S+)?$/.exec(image);
+    if (match) {
+      const tag = match[1] ?? 'latest';
+      const version = /^(\d+(?:\.\d+){0,2})(?:-[\w.-]+)?$/.exec(tag)?.[1] ?? tag;
+      checkNodeRange(file, version, 'Node container image', findings, false, source, offset);
+    }
+  };
+  if (base === '.node-version' || base === '.nvmrc') {
+    checkNodeRange(file, source.trim().replace(/^v/, ''), base, findings);
+  }
+  if (base === 'package.json') {
+    const pkg = JSON.parse(source);
+    if (typeof pkg.engines?.node === 'string') {
+      checkNodeRange(file, pkg.engines.node, 'engines.node', findings, true);
+    }
+    const runtime = pkg.devEngines?.runtime;
+    for (const entry of Array.isArray(runtime) ? runtime : [runtime]) {
+      if (entry?.name === 'node' && typeof entry.version === 'string') {
+        checkNodeRange(file, entry.version, 'devEngines.runtime', findings);
+      }
+    }
+    // The existing setup migration uses Volta only when neither pin file
+    // exists. Check that future .node-version before any project edits.
+    if (
+      typeof pkg.volta?.node === 'string' &&
+      !['.node-version', '.nvmrc'].some((name) =>
+        fs.existsSync(path.join(path.dirname(file), name)),
+      )
+    ) {
+      checkNodeRange(file, pkg.volta.node, 'volta.node', findings);
+    }
+  }
+  if (/\.ya?ml$/.test(file)) {
+    const document = parseDocument(source);
+    visit(document, {
+      Pair(_key, pair) {
+        if (!isScalar(pair.key)) {
+          return;
+        }
+        const key = String(pair.key.value);
+        const value = isNode(pair.value) ? pair.value.toJSON() : undefined;
+        if (key === 'image' || key === 'container') {
+          checkImage(value, pair.key.range?.[0] ?? 0);
+        }
+        if (!['node', 'node-version', 'nodejs'].includes(key)) {
+          return;
+        }
+        for (const item of Array.isArray(value) ? value : [value]) {
+          if (typeof item === 'number' || typeof item === 'string') {
+            checkNodeRange(
+              file,
+              String(item),
+              key,
+              findings,
+              false,
+              source,
+              pair.key.range?.[0] ?? 0,
+            );
+          }
+        }
+      },
+    });
+  }
+  if (/^(?:Dockerfile|Containerfile)(?:\.|$)/.test(base)) {
+    for (const match of source.matchAll(/^\s*FROM[\t ]+(?:--platform=\S+[\t ]+)?(\S+)/gim)) {
+      checkImage(match[1], match.index);
+    }
+  }
+  if (base === 'devcontainer.json' || base === '.devcontainer.json') {
+    const config = record(parseJsonc(source));
+    checkImage(config?.image);
+    for (const [feature, options] of Object.entries(record(config?.features) ?? {})) {
+      if (/^ghcr\.io\/devcontainers\/features\/node(?::[^/]+)?$/.test(feature)) {
+        const version = record(options)?.version;
+        if (typeof version === 'string') {
+          checkNodeRange(file, version, 'Dev Container Node feature', findings);
+        }
+      }
+    }
+  }
+}
+
+function scanAndRewriteFile(
+  file: string,
+  source: string,
+  project: ProjectPlan,
+  browserMode: boolean | undefined,
+): { content: string; findings: VitestV5Finding[] } {
+  const findings: VitestV5Finding[] = [];
+  scanNode(file, source, findings);
+  if (!project.active) {
+    return { content: source, findings };
+  }
+  let content = source;
+  if (
+    CODE_FILE.test(file) &&
+    (VITEST_SIGNAL.test(source) || /\.(?:test|spec)\./.test(file) || project.configFiles.has(file))
+  ) {
+    try {
+      // Canonical and symbol-specific rules run before the native generic import
+      // pass. Config and source edits are separate AST passes to avoid overlap.
+      const sourceResult = migrateVitestV5Source(file, content, {
+        ...project.options,
+        browser: browserMode,
+      });
+      content = sourceResult.content;
+      findings.push(...sourceResult.findings);
+      const pending =
+        project.pendingSourceReviews?.[
+          path.relative(project.directory, file).replaceAll('\\', '/')
+        ];
+      if (!project.options.preserveV4 && pending?.length) {
+        // Re-evaluate deferred v4 findings without applying v4 edits again.
+        // Successfully migrated files have no pending entry, so valid v5
+        // resolveConfig consumers do not gain a warning after migration.
+        const review = migrateVitestV5Source(file, content, {
+          ...project.options,
+          browser: browserMode,
+          preserveV4: true,
+        });
+        findings.push(...review.findings.filter(({ code }) => pending.includes(code)));
+      }
+      if (project.configFiles.has(file)) {
+        const configResult = migrateVitestV5Config(file, content, project.options);
+        content = configResult.content;
+        findings.push(...configResult.findings);
+      }
+    } catch (error) {
+      content = source;
+      findings.push(
+        finding(
+          file,
+          'source-parse',
+          `Parse and review this file before migration: ${error instanceof Error ? error.message : String(error)}`,
+        ),
+      );
+      if (
+        /['"](?:@vitest\/(?:runner|expect)|(?:vitest|vite-plus\/test)\/(?:runners|suite|internal\/module-runner))/.test(
+          source,
+        )
+      ) {
+        findings.push(
+          finding(
+            file,
+            'removed-api',
+            'This unparsed file references removed APIs. Resolve it before changing dependencies.',
+            'block',
+          ),
+        );
+      }
+    }
+  } else if (path.basename(file) === 'package.json') {
+    const pkg = JSON.parse(source);
+    let changed = false;
+    for (const [name, command] of Object.entries(pkg.scripts ?? {})) {
+      if (typeof command !== 'string') {
+        continue;
+      }
+      const result = migrateVitestV5Command(
+        file,
+        command,
+        project.options.preserveV4,
+        source.slice(0, source.indexOf(JSON.stringify(name))).split('\n').length,
+      );
+      findings.push(...result.findings);
+      if (result.content !== command) {
+        pkg.scripts[name] = result.content;
+        changed = true;
+      }
+    }
+    if (changed) {
+      content = `${JSON.stringify(pkg, null, /\n([ \t]+)"/.exec(source)?.[1] ?? 2)}\n`;
+    }
+    for (const name of ['@vitest/ws-client', '@vitest/runner', '@vitest/expect']) {
+      if (dependency(pkg, name)) {
+        findings.push(
+          finding(
+            file,
+            'legacy-dependency',
+            `Review the direct ${name} dependency after migrating its imports; it is no longer part of the bundled Vitest graph.`,
+          ),
+        );
+      }
+    }
+  } else if (/^tsconfig(?:\..+)?\.json$/.test(path.basename(file))) {
+    const types = record(record(parseJsonc(source))?.compilerOptions)?.types;
+    if (
+      Array.isArray(types) &&
+      types.includes('@testing-library/jest-dom') &&
+      !types.includes('@testing-library/jest-dom/vitest')
+    ) {
+      findings.push(
+        finding(
+          file,
+          'jest-dom-types',
+          'If this config checks Vitest tests, load @testing-library/jest-dom/vitest in compilerOptions.types or an included TypeScript setup file. The root jest-dom type entry augments Jest, not Vitest v5.',
+        ),
+      );
+    }
+  } else if (/\.ya?ml$/.test(file)) {
+    const document = parseDocument(source);
+    let changed = false;
+    visit(document, {
+      Pair(_key, pair) {
+        if (
+          !isScalar(pair.key) ||
+          !['run', 'script', 'command'].includes(String(pair.key.value)) ||
+          !isScalar(pair.value) ||
+          typeof pair.value.value !== 'string'
+        ) {
+          return;
+        }
+        const value = pair.value.value;
+        // A multiline shell block can contain functions or continued commands;
+        // report it as one compound command, not independent argv lines.
+        const result = migrateVitestV5Command(
+          file,
+          value.includes('\n') ? `(${value})` : value,
+          project.options.preserveV4,
+          source.slice(0, pair.key.range?.[0] ?? 0).split('\n').length,
+        );
+        findings.push(...result.findings);
+        if (!value.includes('\n') && result.content !== value) {
+          pair.value.value = result.content;
+          changed = true;
+        }
+      },
+    });
+    if (changed) {
+      content = document.toString();
+    }
+  } else if (file.endsWith('.sh')) {
+    findings.push(
+      ...migrateVitestV5Command(file, `(${source})`, project.options.preserveV4).findings,
+    );
+  }
+  // CI upload paths and tools that consume reports may not invoke Vitest.
+  if (!CODE_FILE.test(file) && path.basename(file) !== '.gitignore') {
+    for (const match of source.matchAll(
+      /\.vitest-attachements\/?|\.vitest-reports\/?|__screenshots__\/?|html\/index\.html/g,
+    )) {
+      findings.push(
+        finding(
+          file,
+          'artifact-paths',
+          'Review this consumer of old output paths. Artifacts now use .vitest/attachments, .vitest/blob, and .vitest/index.html.',
+          'review',
+          source,
+          match.index,
+        ),
+      );
+    }
+  }
+  return { content, findings };
+}
+
+/** Read-only preflight. Call before package-manager conversion, installs,
+ * catalog updates, or generic import rewrites can erase the source version. */
+export function planVitestV5Migration(
+  workspace: Pick<WorkspaceInfoOptional, 'rootDir' | 'packageManager'> &
+    Partial<Pick<WorkspaceInfoOptional, 'packages'>>,
+): VitestV5MigrationPlan {
+  const stateFile = path.join(workspace.rootDir, STATE_PATH);
+  let state: MigrationState = { version: 1 };
+  const findings: VitestV5Finding[] = [];
+  if (fs.existsSync(stateFile)) {
+    try {
+      state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+      if (
+        state.version !== 1 ||
+        (state.vitest5 &&
+          (!record(state.vitest5) ||
+            Object.values(state.vitest5).some(
+              (project) =>
+                !project ||
+                typeof project.sourceVersion !== 'string' ||
+                !semver.valid(project.sourceVersion) ||
+                typeof project.configless !== 'boolean' ||
+                (project.pendingSourceReviews !== undefined &&
+                  (!record(project.pendingSourceReviews) ||
+                    Object.values(project.pendingSourceReviews).some(
+                      (codes) =>
+                        !Array.isArray(codes) || codes.some((code) => typeof code !== 'string'),
+                    ))),
+            )))
+      ) {
+        throw new Error('Unsupported state format');
+      }
+    } catch {
+      findings.push(
+        finding(
+          stateFile,
+          'migration-state',
+          'Repair the existing migration state before upgrading; it will not be overwritten.',
+          'block',
+        ),
+      );
+      state = { version: 1 };
+    }
+  }
+  const directories = [
+    workspace.rootDir,
+    ...(workspace.packages ?? []).map((pkg) => path.resolve(workspace.rootDir, pkg.path)),
+  ];
+  const projects: ProjectPlan[] = [];
+  const changes: FileChange[] = [];
+  const projectSources = new Map(
+    [...new Set(directories)].map((directory) => [
+      directory,
+      new Map(filesInProject(directory).map((file) => [file, fs.readFileSync(file, 'utf8')])),
+    ]),
+  );
+  const allSources = new Map<string, string>();
+  for (const sources of projectSources.values()) {
+    for (const [file, source] of sources) {
+      allSources.set(file, source);
+    }
+  }
+  const allConfigs = findVitestV5ConfigFiles(allSources);
+  const browserPossible = [...allSources.values()].some((source) => BROWSER_SIGNAL.test(source));
+  const browserCliOverride = [...allSources].some(
+    ([file, source]) =>
+      /\.(?:json|ya?ml|sh)$/.test(file) &&
+      /\b(?:vitest|vp\s+test)\b[^\n]*--(?:no-)?browser(?:[.=\s'"]|$)/.test(source),
+  );
+  const browserModesByVersion = new Map<boolean, Map<string, boolean | undefined>>();
+  const inputs = new Map<string, string | null>(allSources);
+  inputs.set(stateFile, fs.existsSync(stateFile) ? fs.readFileSync(stateFile, 'utf8') : null);
+  for (const [directory, sources] of projectSources) {
+    const pkg = readJson(path.join(directory, 'package.json'));
+    const configFiles = new Set([...allConfigs].filter((file) => sources.has(file)));
+    const previous = state.vitest5?.[projectStateKey(workspace.rootDir, directory)];
+    const version =
+      previous?.sourceVersion ??
+      sourceVersion(directory, workspace.rootDir, pkg, workspace.packageManager);
+    const active =
+      !!previous ||
+      !!dependency(pkg, 'vitest') ||
+      Object.values(record(pkg.scripts) ?? {}).some(
+        (command) => typeof command === 'string' && VITEST_COMMAND.test(command),
+      ) ||
+      [...sources].some(
+        ([file, source]) =>
+          (CODE_FILE.test(file) && VITEST_SIGNAL.test(source)) ||
+          (configFiles.has(file) && /\btest\s*:/.test(source)),
+      );
+    const options: SourceOptions = {
+      preserveV4: !previous && !!version && semver.major(version) < 5,
+      reviewV4: !!version && semver.major(version) < 5,
+      browser: [...sources.values()].some((source) => BROWSER_SIGNAL.test(source)),
+      browserPossible,
+      globals: [...sources].some(
+        ([file, source]) => configFiles.has(file) && /\bglobals\s*:\s*true\b/.test(source),
+      ),
+      temporalPolyfill: [...sources.values()].some((source) =>
+        /(?:['"]temporal-polyfill\/global['"]|(?:globalThis|global)\.Temporal\s*=|Object\.(?:assign|defineProperty)\(globalThis,\s*(?:\{\s*Temporal|['"]Temporal['"]))/.test(
+          source,
+        ),
+      ),
+    };
+    if (active && !version) {
+      findings.push(
+        finding(
+          path.join(directory, 'package.json'),
+          'source-version',
+          'Cannot determine the original Vitest version. Install the original lockfile, then re-run migration so v4 defaults are not applied to a v5 project.',
+          'block',
+        ),
+      );
+    }
+    if (active && version && semver.major(version) < 4) {
+      findings.push(
+        finding(
+          path.join(directory, 'package.json'),
+          'source-version',
+          'Upgrade the original project to Vitest 4 before running this migration.',
+          'block',
+        ),
+      );
+    }
+    const project = {
+      directory,
+      sourceVersion: version,
+      active,
+      options,
+      configFiles,
+      pendingSourceReviews: previous?.pendingSourceReviews,
+    };
+    projects.push(project);
+    let browserModes = browserModesByVersion.get(options.preserveV4);
+    if (!browserModes) {
+      browserModes = resolveVitestV5BrowserModes(allSources, allConfigs, options.preserveV4);
+      browserModesByVersion.set(options.preserveV4, browserModes);
+    }
+    for (const [file, source] of sources) {
+      // Ignore lockfile package snapshots; runtime and source checks belong to
+      // project files, not thousands of transitive package metadata entries.
+      if (/[/\\](?:pnpm-lock\.yaml|package-lock\.json|yarn\.lock|bun\.lock)$/.test(file)) {
+        continue;
+      }
+      const result = scanAndRewriteFile(
+        file,
+        source,
+        project,
+        browserCliOverride ? undefined : browserModes.get(file),
+      );
+      findings.push(...result.findings);
+      if (source !== result.content) {
+        changes.push({ file, before: source, after: result.content });
+      }
+    }
+    if (active && (options.preserveV4 || previous?.configless) && configFiles.size === 0) {
+      findings.push(
+        finding(
+          path.join(directory, 'package.json'),
+          'configless-defaults',
+          `No test config exists. Vitest v5 clears mocks by default${options.browser ? ' and uses exact browser locators' : ''}. A separate confirmed action can create compatibility config, but a new config can change config discovery and project structure.`,
+        ),
+      );
+    }
+  }
+  return {
+    rootDir: workspace.rootDir,
+    packageManager: workspace.packageManager,
+    projects,
+    findings,
+    changes,
+    inputs,
+    state,
+  };
+}
+
+export function formatVitestV5Findings(
+  plan: Pick<VitestV5MigrationPlan, 'rootDir' | 'findings'>,
+): string {
+  const unique = [
+    ...new Map(
+      plan.findings.map((item) => [
+        `${item.file}:${item.line}:${item.column}:${item.code}:${item.message}`,
+        item,
+      ]),
+    ).values(),
+  ];
+  if (!unique.length) {
+    return '';
+  }
+  const blocks = unique.filter((item) => item.severity === 'block').length;
+  const lines = [
+    `Vitest v5: ${unique.length} review item${unique.length === 1 ? '' : 's'}${blocks ? ` (${blocks} block dependency updates)` : ''}`,
+  ];
+  let previous = '';
+  for (const item of unique.toSorted(
+    (a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column,
+  )) {
+    if (item.file !== previous) {
+      lines.push(`\n${path.relative(plan.rootDir, item.file) || '.'}`);
+      previous = item.file;
+    }
+    lines.push(
+      `  ${item.line}:${item.column} ${item.severity === 'block' ? 'BLOCK' : 'REVIEW'} [${item.code}] ${item.message}`,
+    );
+  }
+  return lines.join('\n');
+}
+
+/** Apply a fully checked plan before the existing generic migration. Refuse
+ * stale input so an editor change cannot be overwritten between phases. */
+export function applyVitestV5Migration(plan: VitestV5MigrationPlan): number {
+  if (plan.findings.some((item) => item.severity === 'block')) {
+    throw new Error('Vitest v5 preflight has blocking findings. No migration edits were applied.');
+  }
+  for (const [file, before] of plan.inputs) {
+    const current = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : null;
+    if (current !== before) {
+      throw new Error(`Migration input changed: ${file}. Re-run vp migrate.`);
+    }
+  }
+  for (const change of plan.changes) {
+    fs.writeFileSync(change.file, change.after);
+  }
+  return plan.changes.length;
+}
+
+export function vitestV5NeedsMigration(plan: VitestV5MigrationPlan): boolean {
+  return (
+    plan.changes.length > 0 ||
+    plan.projects.some(
+      (project) =>
+        project.active && !plan.state.vitest5?.[projectStateKey(plan.rootDir, project.directory)],
+    )
+  );
+}
+
+export function vitestV5ConfiglessProjects(plan: VitestV5MigrationPlan): string[] {
+  const configs = currentProjectConfigs(plan);
+  return plan.projects
+    .filter(
+      (project) =>
+        project.active &&
+        (project.options.preserveV4 ||
+          plan.state.vitest5?.[projectStateKey(plan.rootDir, project.directory)]?.configless) &&
+        configs.get(project.directory)!.length === 0,
+    )
+    .map((project) => project.directory);
+}
+
+function currentProjectConfigs(plan: VitestV5MigrationPlan): Map<string, string[]> {
+  const filesByProject = new Map(
+    plan.projects.map((project) => [project.directory, filesInProject(project.directory)]),
+  );
+  const configs = findVitestV5ConfigFiles(
+    new Map(
+      [...filesByProject.values()].flat().map((file) => [file, fs.readFileSync(file, 'utf8')]),
+    ),
+  );
+  return new Map(
+    [...filesByProject].map(([directory, files]) => [
+      directory,
+      files.filter((file) => configs.has(file)),
+    ]),
+  );
+}
+
+/** Run after other migration steps create or merge configs. Do not create a
+ * config here. Record completion even for configless projects. */
+export function finishVitestV5Migration(plan: VitestV5MigrationPlan): VitestV5Finding[] {
+  const findings: VitestV5Finding[] = [];
+  const state = structuredClone(plan.state);
+  const projectConfigs = currentProjectConfigs(plan);
+  for (const project of plan.projects) {
+    if (!project.active || !project.sourceVersion) {
+      continue;
+    }
+    const configs = projectConfigs.get(project.directory)!;
+    for (const file of configs) {
+      const before = fs.readFileSync(file, 'utf8');
+      try {
+        const result = migrateVitestV5Config(file, before, project.options);
+        findings.push(...result.findings);
+        if (
+          !result.findings.some((finding) => finding.severity === 'block') &&
+          result.content !== before
+        ) {
+          fs.writeFileSync(file, result.content);
+        }
+      } catch (error) {
+        findings.push(finding(file, 'source-parse', `Review this config: ${String(error)}`));
+      }
+    }
+    const ignore = path.join(project.directory, '.gitignore');
+    const ignored = fs.existsSync(ignore) ? fs.readFileSync(ignore, 'utf8') : '';
+    if (!ignored.split(/\r?\n/).some((line) => /^\/?\.vitest\/?$/.test(line.trim()))) {
+      fs.writeFileSync(
+        ignore,
+        `${ignored}${ignored && !ignored.endsWith('\n') ? '\n' : ''}.vitest/\n`,
+      );
+    }
+    state.vitest5 ??= {};
+    const pendingSourceReviews: Record<string, string[]> = {};
+    for (const item of plan.findings) {
+      if (
+        !DEFERRED_SOURCE_REVIEWS.has(item.code) ||
+        !item.file.startsWith(`${project.directory}${path.sep}`)
+      ) {
+        continue;
+      }
+      if (
+        plan.projects.some(
+          (other) =>
+            other !== project &&
+            other.directory.startsWith(`${project.directory}${path.sep}`) &&
+            item.file.startsWith(`${other.directory}${path.sep}`),
+        )
+      ) {
+        continue;
+      }
+      const relative = path.relative(project.directory, item.file).replaceAll('\\', '/');
+      pendingSourceReviews[relative] ??= [];
+      if (!pendingSourceReviews[relative].includes(item.code)) {
+        pendingSourceReviews[relative].push(item.code);
+      }
+    }
+    state.vitest5[projectStateKey(plan.rootDir, project.directory)] = {
+      sourceVersion: project.sourceVersion,
+      configless: configs.length === 0,
+      ...(Object.keys(pendingSourceReviews).length ? { pendingSourceReviews } : {}),
+    };
+  }
+  if (state.vitest5) {
+    const stateFile = path.join(plan.rootDir, STATE_PATH);
+    fs.mkdirSync(path.dirname(stateFile), { recursive: true });
+    fs.writeFileSync(stateFile, `${JSON.stringify(state, null, 2)}\n`);
+  }
+  // A fresh scan keeps unresolved source risks visible after successful edits.
+  const after = planVitestV5Migration({
+    rootDir: plan.rootDir,
+    packages: plan.projects
+      .slice(1)
+      .map((project) => ({ name: '', path: path.relative(plan.rootDir, project.directory) })),
+    packageManager: plan.packageManager,
+  });
+  return [...findings, ...after.findings];
+}
+
+/** The caller must obtain a separate explicit confirmation. This is never a
+ * default side effect of the versioned pass or noninteractive --yes mode. */
+export function createVitestV5CompatibilityConfig(
+  plan: VitestV5MigrationPlan,
+  directory: string,
+): string {
+  const project = plan.projects.find((project) => project.directory === directory);
+  if (!project?.active || !project.sourceVersion || semver.major(project.sourceVersion) >= 5) {
+    throw new Error('This project does not need a v4 compatibility config.');
+  }
+  if (currentProjectConfigs(plan).get(directory)!.length > 0) {
+    throw new Error('A test config already exists; it will not be overwritten.');
+  }
+  const file = path.join(directory, 'vite.config.ts');
+  const browser = project.options.browser ? ', browser: { locators: { exact: false } }' : '';
+  const temporal = project.options.temporalPolyfill
+    ? ", fakeTimers: { toNotFake: ['Temporal'] }"
+    : '';
+  fs.writeFileSync(
+    file,
+    `import { defineConfig } from 'vite-plus';\n\nexport default defineConfig({ test: { clearMocks: false${browser}${temporal} } });\n`,
+    { flag: 'wx' },
+  );
+  return file;
+}
diff --git a/packages/cli/src/migration/vitest-v5/ast.ts b/packages/cli/src/migration/vitest-v5/ast.ts
new file mode 100644
index 0000000000..a90446a66d
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/ast.ts
@@ -0,0 +1,281 @@
+import { parse } from '@babel/parser';
+import traverseModule, { type NodePath } from '@babel/traverse';
+import type * as t from '@babel/types';
+
+// Babel 7's CommonJS default has one extra level under native Node ESM.
+export const traverse: typeof traverseModule.default =
+  typeof traverseModule === 'function' ? traverseModule : traverseModule.default;
+
+export interface VitestV5Finding {
+  file: string;
+  line: number;
+  column: number;
+  code: string;
+  severity: 'review' | 'block';
+  message: string;
+}
+
+export interface SourceOptions {
+  preserveV4: boolean;
+  reviewV4?: boolean;
+  browser?: boolean;
+  browserPossible?: boolean;
+  globals?: boolean;
+  temporalPolyfill?: boolean;
+}
+
+export function propertyName(node: t.Node | null | undefined): string | undefined {
+  if (node?.type === 'Identifier') {
+    return node.name;
+  }
+  if (node?.type === 'StringLiteral') {
+    return node.value;
+  }
+  return undefined;
+}
+
+export function memberName(node: t.Node | null | undefined): string | undefined {
+  if (node?.type !== 'MemberExpression' && node?.type !== 'OptionalMemberExpression') {
+    return undefined;
+  }
+  if (node.computed && node.property.type !== 'StringLiteral') {
+    return undefined;
+  }
+  return propertyName(node.property);
+}
+
+export function objectProperty(
+  object: t.ObjectExpression,
+  key: string,
+): t.ObjectProperty | undefined {
+  return object.properties.find(
+    (prop): prop is t.ObjectProperty =>
+      prop.type === 'ObjectProperty' && !prop.computed && propertyName(prop.key) === key,
+  );
+}
+
+export function staticObject(node: t.Node | null | undefined): node is t.ObjectExpression {
+  if (node?.type !== 'ObjectExpression') {
+    return false;
+  }
+  const names = new Set<string>();
+  return node.properties.every((prop) => {
+    if (prop.type !== 'ObjectProperty' || prop.computed) {
+      return false;
+    }
+    const name = propertyName(prop.key);
+    if (name === undefined || names.has(name)) {
+      return false;
+    }
+    names.add(name);
+    return true;
+  });
+}
+
+export function importedName(
+  path: NodePath,
+  node: t.Node | null | undefined,
+  sources: ReadonlySet<string>,
+): string | undefined {
+  if (node?.type === 'MemberExpression' && !node.computed && node.object.type === 'Identifier') {
+    const binding = path.scope.getBinding(node.object.name);
+    if (
+      binding?.path.isImportNamespaceSpecifier() &&
+      binding.path.parentPath.isImportDeclaration() &&
+      sources.has(binding.path.parentPath.node.source.value)
+    ) {
+      return propertyName(node.property);
+    }
+  }
+  if (node?.type !== 'Identifier') {
+    return undefined;
+  }
+  const binding = path.scope.getBinding(node.name);
+  if (!binding?.path.isImportSpecifier() || !binding.path.parentPath.isImportDeclaration()) {
+    return undefined;
+  }
+  if (
+    binding.path.node.importKind === 'type' ||
+    binding.path.parentPath.node.importKind === 'type'
+  ) {
+    return undefined;
+  }
+  if (sources.has(binding.path.parentPath.node.source.value)) {
+    return propertyName(binding.path.node.imported);
+  }
+  return undefined;
+}
+
+export const ROOT_TEST_SOURCES = new Set(['vitest', 'vite-plus/test', '@vitest/runner']);
+export const CONFIG_SOURCES = new Set([
+  'vitest/config',
+  'vite-plus',
+  'vite-plus/test/config',
+  'vite',
+]);
+export const NODE_SOURCES = new Set(['vitest/node', 'vite-plus/test/node']);
+
+function parseSource(file: string, source: string) {
+  return parse(source, {
+    sourceType: 'unambiguous',
+    plugins: [/\.[cm]?tsx?$/.test(file) ? 'typescript' : 'flow', 'jsx', 'decorators-legacy'],
+    tokens: true,
+  });
+}
+
+export function testApiName(
+  path: NodePath,
+  node: t.Node | null | undefined,
+  globals = false,
+): string | undefined {
+  const imported = importedName(path, node, ROOT_TEST_SOURCES);
+  if (imported) {
+    return imported;
+  }
+  if (globals && node?.type === 'Identifier' && !path.scope.getBinding(node.name)) {
+    return node.name;
+  }
+  return undefined;
+}
+
+/** Offset edits retain comments and formatting outside the precise changed span. */
+export class SourceEditor {
+  readonly ast: ReturnType<typeof parse>;
+  readonly findings: VitestV5Finding[] = [];
+  private readonly edits: Array<{ start: number; end: number; text: string }> = [];
+  private readonly additions = new Map<t.ObjectExpression, Map<string, string>>();
+
+  constructor(
+    readonly file: string,
+    readonly source: string,
+  ) {
+    this.ast = parseSource(file, source);
+  }
+
+  text(node: t.Node) {
+    return this.source.slice(node.start!, node.end!);
+  }
+
+  replace(node: t.Node, text: string) {
+    this.edit(node.start!, node.end!, text);
+  }
+
+  edit(start: number, end: number, text: string) {
+    const same = this.edits.find((edit) => edit.start === start && edit.end === end);
+    if (same?.text === text) {
+      return;
+    }
+    if (same && start === end) {
+      same.text += text;
+      return;
+    }
+    this.edits.push({ start, end, text });
+  }
+
+  add(object: t.ObjectExpression, key: string, value: string) {
+    if (objectProperty(object, key)) {
+      return;
+    }
+    let additions = this.additions.get(object);
+    if (!additions) {
+      this.additions.set(object, (additions = new Map()));
+    }
+    additions.set(key, value);
+  }
+
+  remove(object: t.ObjectExpression, prop: t.ObjectProperty) {
+    const index = object.properties.indexOf(prop);
+    const nextStart = object.properties[index + 1]?.start ?? object.end! - 1;
+    const previousEnd = object.properties[index - 1]?.end ?? object.start! + 1;
+    // Use punctuation tokens, not a text search that could consume a comment.
+    const tokens = this.ast.tokens ?? [];
+    const followingComma = tokens.find(
+      (token) =>
+        token.start >= prop.end! &&
+        token.end <= nextStart &&
+        this.source.slice(token.start, token.end) === ',',
+    );
+    const precedingComma = tokens.find(
+      (token) =>
+        token.start >= previousEnd &&
+        token.end <= prop.start! &&
+        this.source.slice(token.start, token.end) === ',',
+    );
+    this.replace(prop, '');
+    const comma = followingComma ?? precedingComma;
+    if (comma) {
+      this.edit(comma.start, comma.end, '');
+    }
+  }
+
+  report(
+    node: t.Node | undefined,
+    code: string,
+    message: string,
+    severity: VitestV5Finding['severity'] = 'review',
+  ) {
+    const line = node?.loc?.start.line ?? 1;
+    const column = (node?.loc?.start.column ?? 0) + 1;
+    if (
+      !this.findings.some(
+        (item) =>
+          item.line === line &&
+          item.column === column &&
+          item.code === code &&
+          item.message === message,
+      )
+    ) {
+      this.findings.push({ file: this.file, line, column, code, severity, message });
+    }
+  }
+
+  finish() {
+    for (const [object, additions] of this.additions) {
+      const start = object.start! + 1;
+      const first = object.properties[0]?.start ?? object.end! - 1;
+      const prefix = this.source.slice(start, first);
+      const newline = prefix.includes('\r\n') ? '\r\n' : '\n';
+      const multiline = prefix.indexOf('\n') !== -1;
+      const indent =
+        this.source.slice(this.source.lastIndexOf('\n', first) + 1, first).match(/^[\t ]*/)?.[0] ??
+        '';
+      const propertyIndent = object.properties.length ? indent : `${indent}  `;
+      const entries = [...additions].map(([key, value]) => `${key}: ${value}`);
+      this.edit(
+        start,
+        start,
+        multiline
+          ? `${newline}${propertyIndent}${entries.join(`,${newline}${propertyIndent}`)}${object.properties.length ? ',' : ''}`
+          : ` ${entries.join(', ')}${object.properties.length ? ',' : ''} `,
+      );
+    }
+    const edits = this.edits.toSorted((a, b) => b.start - a.start || b.end - a.end);
+    let result = this.source;
+    let previousStart = this.source.length + 1;
+    for (const edit of edits) {
+      if (edit.end > previousStart) {
+        this.report(
+          undefined,
+          'overlapping-edits',
+          'Review the overlapping Vitest transformations; this file was not changed.',
+        );
+        return { content: this.source, findings: this.findings };
+      }
+      result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
+      previousStart = edit.start;
+    }
+    if (result !== this.source) {
+      try {
+        parseSource(this.file, result);
+      } catch {
+        this.report(
+          undefined,
+          'unsafe-syntax',
+          'The proposed transform did not parse. Review this file manually; it was not changed.',
+        );
+        return { content: this.source, findings: this.findings };
+      }
+    }
+    return { content: result, findings: this.findings };
+  }
+}
diff --git a/packages/cli/src/migration/vitest-v5/commands.ts b/packages/cli/src/migration/vitest-v5/commands.ts
new file mode 100644
index 0000000000..d0c91e85cb
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/commands.ts
@@ -0,0 +1,139 @@
+import type { VitestV5Finding } from './ast.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: string): Array<{ value: string; end: number }> | undefined {
+  const tokens: Array<{ value: string; end: number }> = [];
+  let value = '';
+  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 undefined;
+      } else {
+        value += character;
+      }
+    } else if (character === "'" || character === '"') {
+      quote = character;
+      active = true;
+    } else if (character === '\n' || character === '\r') {
+      return undefined;
+    } else if (/\s/.test(character)) {
+      if (active) {
+        tokens.push({ value, end: i });
+      }
+      active = false;
+      value = '';
+    } else if (/[|&;<>($`\\)]/.test(character)) {
+      return undefined;
+    } else {
+      value += character;
+      active = true;
+    }
+  }
+  if (quote) {
+    return undefined;
+  }
+  if (active) {
+    tokens.push({ value, end: command.length });
+  }
+  return tokens;
+}
+
+export function migrateVitestV5Command(
+  file: string,
+  command: string,
+  preserveV4: boolean,
+  line = 1,
+) {
+  const findings: VitestV5Finding[] = [];
+  const report = (
+    code: string,
+    message: string,
+    severity: VitestV5Finding['severity'] = 'review',
+  ) => findings.push({ file, line, column: 1, code, message, severity });
+  if (!/\bvitest\b|\bvp\s+test\b/.test(command)) {
+    return { content: command, findings };
+  }
+  if (/--reporter[= ](?:json|junit)/.test(command) && !/--outputFile(?:=|\s)/.test(command)) {
+    report(
+      'reporter-stdout',
+      'JSON/JUnit now write to .vitest/json/output.json or .vitest/junit/output.xml. Configure reporter stdout: true if this command needs the old stdout output.',
+    );
+  }
+  if (/(?:^|\s)(?:-t|--testNamePattern)(?:\s|=)/.test(command)) {
+    report(
+      'test-name-pattern',
+      'Review test-name patterns across suite boundaries; full names now use > separators.',
+    );
+  }
+  if (/(?:^|\s)(?:bench|--compare|--outputJson)(?:\s|=|$)/.test(command)) {
+    report(
+      'benchmark-api',
+      'Replace benchmark commands and removed --compare/--outputJson flags with tests using the bench context fixture.',
+      'block',
+    );
+  }
+  if (
+    /\.vitest-attachements|\.vitest-reports|__screenshots__|html\/index\.html|--reporter[= ](?:json|junit).*\|/.test(
+      command,
+    )
+  ) {
+    report(
+      'artifact-paths',
+      'Review artifact paths and JSON/JUnit stdout consumers; output defaults moved under .vitest.',
+    );
+  }
+  if (!/\blist\b/.test(command)) {
+    return { content: command, findings };
+  }
+  const argv = literalArgv(command);
+  if (!argv) {
+    report(
+      'static-list',
+      'Review this wrapped or compound list command and explicitly choose --no-static-parse to retain runtime collection.',
+    );
+    return { content: command, findings };
+  }
+  const values = argv.map((token) => token.value);
+  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 list =
+    values[start] === 'vitest'
+      ? start + 1
+      : values[start] === 'vp' && values[start + 1] === 'test'
+        ? start + 2
+        : -1;
+  if (list < 0 || values[list] !== 'list') {
+    report(
+      'static-list',
+      'Resolve this list command wrapper and explicitly choose a static-parse setting.',
+    );
+    return { content: command, findings };
+  }
+  const optionsEnd = values.indexOf('--', list + 1);
+  const args = values.slice(list + 1, optionsEnd < 0 ? undefined : optionsEnd);
+  if (!preserveV4 || args.some((arg) => /^--(?:no-)?static-parse(?:=|$)/.test(arg))) {
+    return { content: command, findings };
+  }
+  const offset = argv[list].end;
+  return {
+    content: `${command.slice(0, offset)} --no-static-parse${command.slice(offset)}`,
+    findings,
+  };
+}
diff --git a/packages/cli/src/migration/vitest-v5/config.ts b/packages/cli/src/migration/vitest-v5/config.ts
new file mode 100644
index 0000000000..a89c680ba6
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/config.ts
@@ -0,0 +1,763 @@
+import path from 'node:path';
+
+import type * as t from '@babel/types';
+import { minimatch } from 'minimatch';
+
+import {
+  CONFIG_SOURCES,
+  SourceEditor,
+  importedName,
+  objectProperty,
+  propertyName,
+  staticObject,
+  traverse,
+  type SourceOptions,
+} from './ast.ts';
+
+const isTrue = (node: t.Node | undefined) => node?.type === 'BooleanLiteral' && node.value;
+
+const CONFIG_FILENAME = /(?:^|[/\\])(?:vite|vitest)(?:\.[\w-]+)?\.config\.[cm]?[jt]s$/;
+const CONFIG_HELPER_IMPORT = /['"](?:vitest\/config|vite-plus(?:\/test\/config)?)['"]/;
+
+function importsConfigHelper(file: string, source: string): boolean {
+  if (!CONFIG_HELPER_IMPORT.test(source)) {
+    return false;
+  }
+  try {
+    const editor = new SourceEditor(file, source);
+    return editor.ast.program.body.some(
+      (node) =>
+        node.type === 'ImportDeclaration' &&
+        node.importKind !== 'type' &&
+        CONFIG_SOURCES.has(node.source.value) &&
+        node.specifiers.some(
+          (specifier) =>
+            specifier.type === 'ImportNamespaceSpecifier' ||
+            (specifier.type === 'ImportSpecifier' &&
+              specifier.importKind !== 'type' &&
+              ['defineConfig', 'defineProject', 'mergeConfig'].includes(
+                propertyName(specifier.imported) ?? '',
+              )),
+        ),
+    );
+  } catch {
+    // Keep candidate configs in the normal parse-diagnostic path.
+    return true;
+  }
+}
+
+/** Include literal referenced configs even when they use a custom filename and
+ * export a raw object. Candidate files come from the owning package's scan. */
+export function findVitestV5ConfigFiles(sources: ReadonlyMap<string, string>): Set<string> {
+  const files = new Set(
+    [...sources]
+      .filter(
+        ([file, source]) =>
+          /\.[cm]?[jt]sx?$/.test(file) &&
+          (CONFIG_FILENAME.test(file) || importsConfigHelper(file, source)),
+      )
+      .map(([file]) => file),
+  );
+  for (const file of files) {
+    try {
+      const editor = new SourceEditor(file, sources.get(file)!);
+      const addReference = (reference: string) => {
+        if (reference.startsWith('!')) {
+          return;
+        }
+        const target = path.resolve(path.dirname(file), reference);
+        if (sources.has(target) && /\.[cm]?[jt]sx?$/.test(target)) {
+          files.add(target);
+        } else {
+          for (const candidate of sources.keys()) {
+            const relative = path.relative(path.dirname(file), candidate).replaceAll('\\', '/');
+            const pattern = reference.replaceAll('\\', '/').replace(/^\.\//, '');
+            if (
+              /\.[cm]?[jt]sx?$/.test(candidate) &&
+              (minimatch(relative, pattern, { dot: true }) ||
+                (CONFIG_FILENAME.test(candidate) &&
+                  minimatch(path.posix.dirname(relative), pattern, { dot: true })))
+            ) {
+              files.add(candidate);
+            }
+          }
+        }
+      };
+      const collectReferences = (config: t.Node | undefined) => {
+        if (config?.type !== 'ObjectExpression') {
+          return;
+        }
+        const base = objectProperty(config, 'extends')?.value;
+        if (base?.type === 'StringLiteral') {
+          addReference(base.value);
+        }
+        const test = objectProperty(config, 'test')?.value;
+        const projects =
+          test?.type === 'ObjectExpression' ? objectProperty(test, 'projects')?.value : undefined;
+        if (projects?.type !== 'ArrayExpression') {
+          return;
+        }
+        for (const project of projects.elements) {
+          if (project?.type === 'StringLiteral') {
+            addReference(project.value);
+          } else {
+            collectReferences(project ?? undefined);
+          }
+        }
+      };
+      traverse(editor.ast, {
+        ExportDefaultDeclaration(p) {
+          const declaration = p.node.declaration;
+          if (declaration.type === 'Identifier') {
+            const binding = p.scope.getBinding(declaration.name);
+            if (binding?.constant && binding.path.isVariableDeclarator()) {
+              collectReferences(binding.path.node.init ?? undefined);
+            }
+          } else {
+            collectReferences(declaration);
+          }
+        },
+        CallExpression(p) {
+          if (
+            ['defineConfig', 'defineProject', 'mergeConfig'].includes(
+              importedName(p, p.node.callee, CONFIG_SOURCES) ?? '',
+            )
+          ) {
+            for (const argument of p.node.arguments) {
+              collectReferences(argument);
+            }
+          }
+        },
+        AssignmentExpression(p) {
+          if (
+            p.node.left.type === 'MemberExpression' &&
+            !p.node.left.computed &&
+            p.node.left.object.type === 'Identifier' &&
+            p.node.left.object.name === 'module' &&
+            propertyName(p.node.left.property) === 'exports' &&
+            !p.scope.getBinding('module')
+          ) {
+            collectReferences(p.node.right);
+          }
+        },
+      });
+    } catch {
+      // The migration's normal parse diagnostic owns reporting this file.
+    }
+  }
+  return files;
+}
+
+interface BrowserTestScope {
+  root?: string;
+  include?: string[];
+  exclude?: string[];
+  browser?: boolean;
+}
+
+const DEFAULT_TEST_INCLUDE = ['**/*.{test,spec}.?(c|m)[jt]s?(x)'];
+
+function staticPatterns(node: t.Node | undefined): string[] | undefined {
+  return node?.type === 'ArrayExpression' &&
+    node.elements.every((entry) => entry?.type === 'StringLiteral' && !entry.value.startsWith('!'))
+    ? node.elements.map((entry) => (entry as t.StringLiteral).value)
+    : undefined;
+}
+
+/** Resolve only literal project ownership. A file shared by Node and browser
+ * projects, or covered by dynamic config, needs review before a matcher rename. */
+export function resolveVitestV5BrowserModes(
+  sources: ReadonlyMap<string, string>,
+  configFiles: ReadonlySet<string>,
+  preserveV4: boolean,
+): Map<string, boolean | undefined> {
+  const scopes: BrowserTestScope[] = [];
+
+  for (const file of configFiles) {
+    let found = false;
+    const visited = new Set<t.ObjectExpression>();
+    const unknown = () => {
+      found = true;
+      scopes.push({});
+    };
+    const walk = (object: t.Node | undefined, base?: BrowserTestScope) => {
+      found = true;
+      if (!staticObject(object)) {
+        unknown();
+        return;
+      }
+      if (visited.has(object)) {
+        return;
+      }
+      visited.add(object);
+      const test = objectProperty(object, 'test')?.value;
+      if (test && !staticObject(test)) {
+        unknown();
+        return;
+      }
+      const root = objectProperty(object, 'root')?.value;
+      const testRoot = test && objectProperty(test, 'root')?.value;
+      if (
+        (root && root.type !== 'StringLiteral') ||
+        (testRoot && testRoot.type !== 'StringLiteral')
+      ) {
+        unknown();
+        return;
+      }
+      const directory = path.resolve(
+        path.dirname(file),
+        root?.type === 'StringLiteral' ? root.value : (base?.root ?? '.'),
+        testRoot?.type === 'StringLiteral' ? testRoot.value : '.',
+      );
+      const include = test && objectProperty(test, 'include')?.value;
+      const exclude = test && objectProperty(test, 'exclude')?.value;
+      if ((include && !staticPatterns(include)) || (exclude && !staticPatterns(exclude))) {
+        unknown();
+        return;
+      }
+      const browser = test && objectProperty(test, 'browser')?.value;
+      const enabled = staticObject(browser) ? objectProperty(browser, 'enabled')?.value : undefined;
+      let browserMode = base ? base.browser : false;
+      if (browser) {
+        if (!staticObject(browser) || (enabled && enabled.type !== 'BooleanLiteral')) {
+          browserMode = undefined;
+        } else if (enabled?.type === 'BooleanLiteral') {
+          browserMode = enabled.value;
+        }
+      }
+      const scope: BrowserTestScope = {
+        root: directory,
+        include: include ? staticPatterns(include) : (base?.include ?? DEFAULT_TEST_INCLUDE),
+        exclude: exclude ? staticPatterns(exclude) : base?.exclude,
+        browser: browserMode,
+      };
+      // Inherited arrays can merge. Preserve all possible includes and avoid
+      // assuming that an exclusion removes a file from both configurations.
+      if (base && include) {
+        scope.include = base.include ? [...base.include, ...scope.include!] : undefined;
+        scope.exclude = [];
+      }
+      const projects = test && objectProperty(test, 'projects')?.value;
+      if (!projects) {
+        scopes.push(scope);
+        return;
+      }
+      if (projects.type !== 'ArrayExpression') {
+        unknown();
+        return;
+      }
+      for (const project of projects.elements) {
+        if (project?.type === 'StringLiteral') {
+          // Referenced config files have their own scope in configFiles.
+          if (!project.value.startsWith('!')) {
+            const pattern = project.value.replaceAll('\\', '/').replace(/^\.\//, '');
+            const referenced = [...configFiles].some((candidate) => {
+              const relative = path.relative(path.dirname(file), candidate).replaceAll('\\', '/');
+              return (
+                minimatch(relative, pattern, { dot: true }) ||
+                minimatch(path.posix.dirname(relative), pattern, { dot: true })
+              );
+            });
+            if (!referenced) {
+              unknown();
+            }
+          }
+          continue;
+        }
+        if (!staticObject(project)) {
+          unknown();
+          continue;
+        }
+        const extendsValue = objectProperty(project, 'extends')?.value;
+        if (extendsValue && extendsValue.type !== 'BooleanLiteral') {
+          unknown();
+          continue;
+        }
+        const inherits = extendsValue?.type === 'BooleanLiteral' ? extendsValue.value : !preserveV4;
+        walk(project, inherits ? scope : undefined);
+      }
+    };
+    try {
+      const editor = new SourceEditor(file, sources.get(file)!);
+      traverse(editor.ast, {
+        ExportDefaultDeclaration(p) {
+          const declaration = p.node.declaration;
+          if (declaration.type === 'CallExpression') {
+            if (
+              !['defineConfig', 'defineProject'].includes(
+                importedName(p, declaration.callee, CONFIG_SOURCES) ?? '',
+              )
+            ) {
+              unknown();
+            }
+            return;
+          }
+          if (declaration.type === 'Identifier') {
+            const binding = p.scope.getBinding(declaration.name);
+            const initializer =
+              binding?.constant && binding.path.isVariableDeclarator()
+                ? binding.path.node.init
+                : undefined;
+            if (
+              initializer?.type === 'CallExpression' &&
+              ['defineConfig', 'defineProject'].includes(
+                importedName(binding!.path, initializer.callee, CONFIG_SOURCES) ?? '',
+              )
+            ) {
+              walk(initializer.arguments[0]);
+            } else {
+              walk(initializer ?? undefined);
+            }
+          } else {
+            walk(declaration);
+          }
+        },
+        CallExpression(p) {
+          if (
+            ['defineConfig', 'defineProject'].includes(
+              importedName(p, p.node.callee, CONFIG_SOURCES) ?? '',
+            )
+          ) {
+            walk(p.node.arguments[0]);
+          }
+        },
+        AssignmentExpression(p) {
+          if (
+            p.node.left.type === 'MemberExpression' &&
+            !p.node.left.computed &&
+            p.node.left.object.type === 'Identifier' &&
+            p.node.left.object.name === 'module' &&
+            propertyName(p.node.left.property) === 'exports' &&
+            !p.scope.getBinding('module')
+          ) {
+            if (p.node.right.type === 'CallExpression') {
+              if (
+                !['defineConfig', 'defineProject'].includes(
+                  importedName(p, p.node.right.callee, CONFIG_SOURCES) ?? '',
+                )
+              ) {
+                unknown();
+              }
+            } else {
+              walk(p.node.right);
+            }
+          }
+        },
+      });
+    } catch {
+      unknown();
+    }
+    if (!found) {
+      unknown();
+    }
+  }
+  return new Map(
+    [...sources.keys()].map((file) => {
+      const matching = scopes.filter((scope) => {
+        if (!scope.root) {
+          return true;
+        }
+        const relative = path.relative(scope.root, file).replaceAll('\\', '/');
+        if (relative.startsWith('../') || path.isAbsolute(relative)) {
+          return false;
+        }
+        return (
+          (!scope.include ||
+            scope.include.some((pattern) => minimatch(relative, pattern, { dot: true }))) &&
+          !scope.exclude?.some((pattern) => minimatch(relative, pattern, { dot: true }))
+        );
+      });
+      const modes = new Set(matching.map((scope) => scope.browser));
+      return [file, modes.size === 1 ? matching[0].browser : undefined];
+    }),
+  );
+}
+
+export function migrateVitestV5Config(file: string, source: string, options: SourceOptions) {
+  const editor = new SourceEditor(file, source);
+  const visited = new Set<t.ObjectExpression>();
+
+  function nested(
+    object: t.ObjectExpression,
+    key: string,
+    additions: string,
+    apply: (node: t.ObjectExpression) => void,
+  ) {
+    const prop = objectProperty(object, key);
+    if (!prop) {
+      editor.add(object, key, `{ ${additions} }`);
+    } else if (staticObject(prop.value)) {
+      apply(prop.value);
+    } else {
+      editor.report(
+        prop,
+        'dynamic-config',
+        `Resolve ${key} before applying Vitest v5 compatibility options.`,
+      );
+    }
+  }
+
+  function reporters(test: t.ObjectExpression) {
+    const prop = objectProperty(test, 'reporters');
+    if (!prop) {
+      return;
+    }
+    const output = objectProperty(test, 'outputFile');
+    const entries = prop.value.type === 'ArrayExpression' ? prop.value.elements : [prop.value];
+    for (const entry of entries) {
+      const name = entry?.type === 'ArrayExpression' ? entry.elements[0] : entry;
+      if (name?.type !== 'StringLiteral') {
+        editor.report(
+          entry ?? prop,
+          'reporter-options',
+          'Review dynamic reporter options and JSON/JUnit stdout consumers.',
+        );
+        continue;
+      }
+      const opts = entry?.type === 'ArrayExpression' ? entry.elements[1] : undefined;
+      if (name.value === 'html' && staticObject(opts)) {
+        const old = objectProperty(opts, 'outputFile');
+        if (old) {
+          if (objectProperty(opts, 'outputDir')) {
+            editor.report(
+              old,
+              'html-output',
+              'Review HTML outputFile and outputDir; both are configured.',
+            );
+          } else if (
+            old.value.type === 'StringLiteral' &&
+            /(^|[/\\])index\.html$/.test(old.value.value)
+          ) {
+            editor.replace(old.key, 'outputDir');
+            editor.replace(
+              old.value,
+              JSON.stringify(path.posix.dirname(old.value.value.replaceAll('\\', '/'))),
+            );
+          } else {
+            editor.report(
+              old,
+              'html-output',
+              'Replace the HTML outputFile with an outputDir. The v5 file name is index.html.',
+            );
+          }
+        }
+      }
+      if (!options.preserveV4 || !['json', 'junit'].includes(name.value)) {
+        continue;
+      }
+      if (output && (!staticObject(output.value) || objectProperty(output.value, name.value))) {
+        continue;
+      }
+      if (opts && !staticObject(opts)) {
+        editor.report(
+          opts,
+          'reporter-options',
+          `Review ${name.value} output: v5 writes a file unless stdout is true.`,
+        );
+      } else if (staticObject(opts)) {
+        if (!objectProperty(opts, 'outputFile')) {
+          editor.add(opts, 'stdout', 'true');
+        }
+      } else {
+        const tuple = `[${editor.text(name)}, { stdout: true }]`;
+        editor.replace(entry!, prop.value.type === 'ArrayExpression' ? tuple : `[${tuple}]`);
+      }
+    }
+    if (
+      output &&
+      entries.some((entry) => entry?.type === 'StringLiteral' && entry.value === 'html')
+    ) {
+      editor.report(
+        output,
+        'html-output',
+        'Move the HTML outputFile into reporter outputDir options; retain other reporter output files.',
+      );
+    }
+  }
+
+  function testOptions(test: t.ObjectExpression, inherits: boolean) {
+    if (options.preserveV4 && !inherits) {
+      editor.add(test, 'clearMocks', 'false');
+    }
+    const browser = objectProperty(test, 'browser');
+    if (browser && staticObject(browser.value)) {
+      const value = browser.value;
+      if (options.preserveV4) {
+        nested(value, 'locators', 'exact: false', (locators) =>
+          editor.add(locators, 'exact', 'false'),
+        );
+      }
+      const api = objectProperty(value, 'api');
+      if (api) {
+        const target = objectProperty(test, 'api');
+        if (target && editor.text(target.value) !== editor.text(api.value)) {
+          editor.report(
+            api,
+            'api-conflict',
+            'Resolve conflicting test.api and test.browser.api values before upgrading.',
+            'block',
+          );
+        } else {
+          editor.add(test, 'api', editor.text(api.value));
+          editor.remove(value, api);
+        }
+      }
+      const screenshot = objectProperty(value, 'screenshotDirectory');
+      if (screenshot) {
+        const setting = `screenshotDirectory: ${editor.text(screenshot.value)}`;
+        nested(value, 'expect', `toMatchScreenshot: { ${setting} }`, (expect) => {
+          nested(expect, 'toMatchScreenshot', setting, (match) =>
+            editor.add(match, 'screenshotDirectory', editor.text(screenshot.value)),
+          );
+        });
+      }
+      if (objectProperty(value, 'commands')) {
+        editor.report(
+          browser,
+          'locator-commands',
+          'Review browser command parameters: locators are SerializedLocator objects, not selector strings.',
+        );
+      }
+    } else if (browser) {
+      editor.report(
+        browser,
+        'dynamic-project',
+        'Review dynamic browser options and preserve locators.exact: false when migrating v4.',
+      );
+    }
+
+    if (options.preserveV4 && options.temporalPolyfill) {
+      nested(test, 'fakeTimers', "toNotFake: ['Temporal']", (timers) =>
+        editor.add(timers, 'toNotFake', "['Temporal']"),
+      );
+    }
+    const coverage = objectProperty(test, 'coverage');
+    if (coverage && staticObject(coverage.value)) {
+      for (const key of ['include', 'exclude']) {
+        const pattern = objectProperty(coverage.value, key);
+        if (pattern) {
+          editor.report(
+            pattern,
+            'coverage-patterns',
+            `Compare v4/v5 resolved coverage.${key} file sets; v5 matches relative paths more precisely.`,
+          );
+        }
+      }
+      const thresholds = objectProperty(coverage.value, 'thresholds');
+      if (
+        options.preserveV4 &&
+        thresholds &&
+        staticObject(thresholds.value) &&
+        isTrue(objectProperty(thresholds.value, 'perFile')?.value)
+      ) {
+        for (const threshold of thresholds.value.properties) {
+          if (
+            threshold.type !== 'ObjectProperty' ||
+            [
+              'perFile',
+              'lines',
+              'branches',
+              'functions',
+              'statements',
+              'autoUpdate',
+              '100',
+            ].includes(propertyName(threshold.key) ?? '')
+          ) {
+            continue;
+          }
+          if (staticObject(threshold.value)) {
+            editor.add(threshold.value, 'perFile', 'true');
+          } else {
+            editor.report(
+              threshold,
+              'coverage-thresholds',
+              'Set perFile: true on this dynamic glob threshold to retain v4 enforcement.',
+            );
+          }
+        }
+      }
+    }
+    reporters(test);
+    const benchmark = objectProperty(test, 'benchmark');
+    if (benchmark) {
+      if (staticObject(benchmark.value)) {
+        for (const key of ['reporters', 'outputFile', 'compare', 'outputJson']) {
+          const removed = objectProperty(benchmark.value, key);
+          if (removed) {
+            editor.report(
+              removed,
+              'benchmark-api',
+              `Replace removed benchmark.${key} with regular test reporters and the bench test-context fixture.`,
+              'block',
+            );
+          }
+        }
+      } else {
+        editor.report(
+          benchmark,
+          'benchmark-api',
+          'Review dynamic benchmark options for removed reporters, outputFile, compare, and outputJson settings.',
+        );
+      }
+    }
+
+    const projects = objectProperty(test, 'projects');
+    if (!projects) {
+      return;
+    }
+    if (projects.value.type !== 'ArrayExpression') {
+      editor.report(
+        projects,
+        'dynamic-project',
+        'Resolve dynamic projects and review inheritance and sharedViteServer before upgrading.',
+      );
+      return;
+    }
+    const hasInline = projects.value.elements.some((item) => item && item.type !== 'StringLiteral');
+    if (hasInline && options.preserveV4) {
+      editor.add(test, 'sharedViteServer', 'false');
+    }
+    for (const project of projects.value.elements) {
+      if (!project || project.type === 'StringLiteral') {
+        continue;
+      }
+      if (!staticObject(project)) {
+        editor.report(
+          project,
+          'dynamic-project',
+          'Review this function, promise, or dynamic inline project. Set explicit inheritance and v4 compatibility options.',
+        );
+        continue;
+      }
+      const extendsValue = objectProperty(project, 'extends');
+      if (options.preserveV4) {
+        editor.add(project, 'extends', 'false');
+      }
+      config(project, isTrue(extendsValue?.value));
+    }
+  }
+
+  function config(object: t.ObjectExpression, inherits = false) {
+    if (visited.has(object)) {
+      return;
+    }
+    visited.add(object);
+    const test = objectProperty(object, 'test');
+    if (!test) {
+      if (options.preserveV4 && !inherits) {
+        editor.add(
+          object,
+          'test',
+          `{ clearMocks: false${options.temporalPolyfill ? ", fakeTimers: { toNotFake: ['Temporal'] }" : ''} }`,
+        );
+      }
+    } else if (staticObject(test.value)) {
+      testOptions(test.value, inherits);
+    } else {
+      editor.report(
+        test,
+        'dynamic-config',
+        'Review dynamic test options; v4 defaults cannot be preserved automatically.',
+      );
+    }
+  }
+
+  traverse(editor.ast, {
+    AssignmentExpression(p) {
+      const left = p.node.left;
+      if (
+        left.type === 'MemberExpression' &&
+        !left.computed &&
+        left.object.type === 'Identifier' &&
+        left.object.name === 'module' &&
+        propertyName(left.property) === 'exports' &&
+        !p.scope.getBinding('module')
+      ) {
+        if (staticObject(p.node.right)) {
+          config(p.node.right);
+        } else if (p.node.right.type !== 'CallExpression') {
+          editor.report(
+            p.node,
+            'dynamic-config',
+            'Review the effective CommonJS test config and its v4 defaults.',
+          );
+        }
+      }
+    },
+    ExportDefaultDeclaration(p) {
+      if (staticObject(p.node.declaration)) {
+        config(p.node.declaration);
+      } else if (p.node.declaration.type === 'Identifier') {
+        const binding = p.scope.getBinding(p.node.declaration.name);
+        if (
+          binding?.constant &&
+          binding.path.isVariableDeclarator() &&
+          staticObject(binding.path.node.init)
+        ) {
+          config(binding.path.node.init);
+        } else {
+          editor.report(
+            p.node,
+            'dynamic-config',
+            'Review the effective exported test config and its v4 defaults.',
+          );
+        }
+      } else if (p.node.declaration.type !== 'CallExpression') {
+        editor.report(
+          p.node,
+          'dynamic-config',
+          'Review the effective function or promise config and its v4 defaults.',
+        );
+      }
+    },
+    CallExpression(p) {
+      const name = importedName(p, p.node.callee, CONFIG_SOURCES);
+      if (name === 'defineConfig' || name === 'defineProject') {
+        const object = p.node.arguments[0];
+        if (staticObject(object)) {
+          config(object);
+        } else {
+          editor.report(
+            object,
+            'dynamic-config',
+            'Review this dynamic config; explicit v4 compatibility settings need manual insertion.',
+          );
+        }
+      }
+      if (name === 'mergeConfig') {
+        editor.report(
+          p.node,
+          'nested-project-merge',
+          'Check merged root configs for test.projects; v5 permits nested projects and can recurse or duplicate them.',
+        );
+      }
+    },
+    ObjectMethod(p) {
+      if (
+        ['config', 'configResolved', 'configureServer', 'configureVitest'].includes(
+          propertyName(p.node.key) ?? '',
+        )
+      ) {
+        editor.report(
+          p.node,
+          'project-server-lifecycle',
+          'Review this plugin hook for per-project config execution or Vite server state.',
+        );
+      }
+    },
+    ObjectProperty(p) {
+      if (
+        ['config', 'configResolved', 'configureServer', 'configureVitest'].includes(
+          propertyName(p.node.key) ?? '',
+        )
+      ) {
+        editor.report(
+          p.node,
+          'project-server-lifecycle',
+          'Review this plugin hook for per-project config execution or Vite server state.',
+        );
+      }
+    },
+  });
+  return editor.finish();
+}
diff --git a/packages/cli/src/migration/vitest-v5/source.ts b/packages/cli/src/migration/vitest-v5/source.ts
new file mode 100644
index 0000000000..52fa20141b
--- /dev/null
+++ b/packages/cli/src/migration/vitest-v5/source.ts
@@ -0,0 +1,777 @@
+import type { NodePath } from '@babel/traverse';
+import type * as t from '@babel/types';
+
+import entryPoints from '../../vitest-v5-entry-points.json' with { type: 'json' };
+import {
+  NODE_SOURCES,
+  ROOT_TEST_SOURCES,
+  SourceEditor,
+  importedName,
+  memberName,
+  objectProperty,
+  propertyName,
+  staticObject,
+  testApiName,
+  traverse,
+  type SourceOptions,
+} from './ast.ts';
+
+const RUNNER_SYMBOLS: Record<string, string> = {
+  test: 'test',
+  it: 'it',
+  describe: 'describe',
+  suite: 'suite',
+  recordArtifact: 'recordArtifact',
+  TestAPI: 'TestAPI',
+  SuiteAPI: 'SuiteAPI',
+  SuiteCollector: 'SuiteCollector',
+  TestArtifact: 'TestArtifact',
+  File: 'RunnerTestFile',
+  Suite: 'RunnerTestSuite',
+  Test: 'RunnerTestCase',
+  Task: 'RunnerTask',
+  VitestRunner: 'VitestTestRunner',
+  VitestRunnerConfig: 'TestRunnerConfig',
+};
+const RUNNER_METHODS: Record<string, string> = {
+  getCurrentSuite: 'getCurrentSuite',
+  getCurrentTest: 'getCurrentTest',
+  createTaskCollector: 'createTaskCollector',
+  getFn: 'getTestFn',
+  getHooks: 'getSuiteHooks',
+  setFn: 'setTestFn',
+  setHooks: 'setSuiteHooks',
+};
+const EXPECT_SYMBOLS = new Set([
+  'expect',
+  'assert',
+  'should',
+  'createExpect',
+  'Assertion',
+  'AsymmetricMatchersContaining',
+  'ExpectStatic',
+  'JestAssertion',
+  'Matcher',
+  'Matchers',
+  'MatchersObject',
+  'MatcherState',
+]);
+const RUNNER_SOURCES = new Set([
+  '@vitest/runner',
+  'vitest/suite',
+  'vite-plus/test/suite',
+  'vite-plus/test/plugins/runner',
+]);
+const EXPECT_SOURCES = new Set(['@vitest/expect', 'vite-plus/test/plugins/expect']);
+const RUNNERS_SOURCES = new Set(['vitest/runners', 'vite-plus/test/runners']);
+const REMOVED_SOURCES = new Set([
+  'vitest/internal/module-runner',
+  'vite-plus/test/internal/module-runner',
+  '@vitest/runner/utils',
+  '@vitest/runner/types',
+  'vite-plus/test/plugins/runner-utils',
+  'vite-plus/test/plugins/runner-types',
+]);
+const RENDER_SOURCES = new Set(['vitest-browser-vue', 'vitest-browser-svelte']);
+const REGISTRATIONS = new Set(['test', 'it', 'describe', 'suite']);
+const ASYNC_CALLBACKS = new Set(['test', 'it', 'beforeEach', 'afterEach', 'beforeAll', 'afterAll']);
+const DOM_GLOBALS = new Set([
+  'window',
+  'document',
+  'navigator',
+  'location',
+  'matchMedia',
+  'innerWidth',
+  'innerHeight',
+  'screen',
+  'Element',
+  'HTMLElement',
+  'Node',
+  'Event',
+  'MutationObserver',
+  'ResizeObserver',
+  'requestAnimationFrame',
+  'cancelAnimationFrame',
+  'getComputedStyle',
+]);
+
+function looksLikeConstructorMock(p: NodePath<t.CallExpression>): boolean {
+  if (
+    p.node.arguments.some(
+      (argument) => argument.type === 'ClassExpression' || argument.type === 'FunctionExpression',
+    )
+  ) {
+    return true;
+  }
+  if (
+    memberName(p.node.callee) === 'spyOn' &&
+    p.node.arguments[1]?.type === 'StringLiteral' &&
+    /^[A-Z]/.test(p.node.arguments[1].value)
+  ) {
+    return true;
+  }
+  if (p.parentPath.isVariableDeclarator() && p.parentPath.node.id.type === 'Identifier') {
+    const name = p.parentPath.node.id.name;
+    const binding = p.scope.getBinding(name);
+    return (
+      /^[A-Z]/.test(name) ||
+      !!binding?.referencePaths.some((ref) => ref.parentPath?.isNewExpression())
+    );
+  }
+  return false;
+}
+
+function chain(
+  node: t.Node,
+  isApi: (node: t.Node) => boolean,
+): { root: t.Node; members: string[]; calls: t.CallExpression[] } {
+  const members: string[] = [];
+  const calls: t.CallExpression[] = [];
+  while (node.type === 'MemberExpression' || node.type === 'CallExpression') {
+    if (isApi(node)) {
+      break;
+    }
+    if (node.type === 'MemberExpression') {
+      const name = memberName(node);
+      if (name === undefined) {
+        break;
+      }
+      members.push(name);
+      node = node.object;
+    } else {
+      calls.push(node);
+      node = node.callee;
+    }
+  }
+  return { root: node, members, calls };
+}
+
+export function migrateVitestV5Source(file: string, source: string, options: SourceOptions) {
+  const editor = new SourceEditor(file, source);
+  const asyncFunctions = new Set<t.Node>();
+  const apiName = (p: NodePath, node: t.Node) => testApiName(p, node, options.globals);
+  const canAwait = (p: NodePath) => {
+    const fn = p.getFunctionParent();
+    if (!fn) {
+      return false;
+    }
+    if (fn.node.async) {
+      return true;
+    }
+    if (
+      (!fn.isArrowFunctionExpression() && !fn.isFunctionExpression()) ||
+      fn.node.generator ||
+      fn.node.returnType
+    ) {
+      return false;
+    }
+    const parent = fn.parentPath;
+    if (!parent.isCallExpression() || !parent.node.arguments.includes(fn.node)) {
+      return false;
+    }
+    const { root, members } = chain(parent.node.callee, (node) => !!apiName(parent, node));
+    if (!ASYNC_CALLBACKS.has(apiName(parent, root) ?? '') || members.includes('extend')) {
+      return false;
+    }
+    if (!asyncFunctions.has(fn.node)) {
+      editor.edit(fn.node.start!, fn.node.start!, 'async ');
+      asyncFunctions.add(fn.node);
+    }
+    return true;
+  };
+
+  function unsupported(node: t.Node, source: string, symbol: string, typeOnly: boolean) {
+    editor.report(
+      node,
+      'removed-api',
+      `Migrate ${symbol} from ${source} manually; no reviewed root v5 replacement exists.`,
+      typeOnly ? 'review' : 'block',
+    );
+  }
+
+  traverse(editor.ast, {
+    ImportDeclaration(p) {
+      const source = p.node.source.value;
+      if (ROOT_TEST_SOURCES.has(source)) {
+        for (const specifier of p.node.specifiers) {
+          if (
+            specifier.type === 'ImportSpecifier' &&
+            propertyName(specifier.imported) === 'bench' &&
+            p.node.importKind !== 'type' &&
+            specifier.importKind !== 'type'
+          ) {
+            editor.report(
+              specifier,
+              'benchmark-api',
+              'Replace the removed top-level bench import with the bench test-context fixture.',
+              'block',
+            );
+          }
+        }
+      }
+      if (source === '@vitest/ws-client') {
+        editor.report(
+          p.node,
+          'ws-client',
+          'Replace direct @vitest/ws-client use; it does not receive Vitest v5 features.',
+        );
+        return;
+      }
+      if (source in entryPoints) {
+        editor.replace(
+          p.node.source,
+          JSON.stringify(entryPoints[source as keyof typeof entryPoints]),
+        );
+        return;
+      }
+      const runners = RUNNERS_SOURCES.has(source);
+      const runner = RUNNER_SOURCES.has(source);
+      const expect = EXPECT_SOURCES.has(source);
+      if (!runner && !runners && !expect && !REMOVED_SOURCES.has(source)) {
+        return;
+      }
+      const imports: string[] = [];
+      const constants: string[] = [];
+      const remaining: string[] = [];
+      let runnerName: string | undefined;
+      for (const specifier of p.node.specifiers) {
+        const typeOnly =
+          p.node.importKind === 'type' ||
+          (specifier.type === 'ImportSpecifier' && specifier.importKind === 'type');
+        const name = specifier.type === 'ImportSpecifier' ? propertyName(specifier.imported)! : '*';
+        const target = runner
+          ? RUNNER_SYMBOLS[name]
+          : runners && name === 'VitestTestRunner'
+            ? 'TestRunner'
+            : expect && EXPECT_SYMBOLS.has(name)
+              ? name
+              : undefined;
+        if (target) {
+          imports.push(
+            `${typeOnly ? 'type ' : ''}${target}${specifier.local.name === target ? '' : ` as ${specifier.local.name}`}`,
+          );
+        } else if (runner && RUNNER_METHODS[name] && !typeOnly) {
+          if (!runnerName) {
+            runnerName = p.scope.generateUidIdentifier('VitestTestRunner').name;
+            imports.push(`TestRunner as ${runnerName}`);
+          }
+          // Static fields are the original functions, so aliases retain function
+          // identity and also work as callback values (not only direct calls).
+          constants.push(`const ${specifier.local.name} = ${runnerName}.${RUNNER_METHODS[name]};`);
+        } else {
+          unsupported(specifier, source, name, typeOnly);
+          remaining.push(editor.text(specifier));
+        }
+      }
+      if (!p.node.specifiers.length) {
+        unsupported(p.node, source, 'side-effect import', false);
+      }
+      if (imports.length) {
+        const kept = remaining.length
+          ? `import ${p.node.importKind === 'type' ? 'type ' : ''}{ ${remaining.join(', ')} } from ${JSON.stringify(source)};\n`
+          : '';
+        editor.replace(
+          p.node,
+          `${kept}import { ${imports.join(', ')} } from 'vite-plus/test';${constants.length ? `\n${constants.join('\n')}` : ''}`,
+        );
+      }
+    },
+    ExportNamedDeclaration(p) {
+      const source = p.node.source?.value;
+      if (!source) {
+        return;
+      }
+      if (source in entryPoints) {
+        editor.replace(
+          p.node.source!,
+          JSON.stringify(entryPoints[source as keyof typeof entryPoints]),
+        );
+      } else if (
+        RUNNER_SOURCES.has(source) ||
+        EXPECT_SOURCES.has(source) ||
+        REMOVED_SOURCES.has(source) ||
+        RUNNERS_SOURCES.has(source)
+      ) {
+        // Re-exports can expose a library contract. Do not silently replace it.
+        for (const specifier of p.node.specifiers) {
+          unsupported(
+            specifier,
+            source,
+            're-export',
+            p.node.exportKind === 'type' ||
+              (specifier.type === 'ExportSpecifier' && specifier.exportKind === 'type'),
+          );
+        }
+      }
+    },
+    ExportAllDeclaration(p) {
+      const source = p.node.source.value;
+      if (
+        RUNNER_SOURCES.has(source) ||
+        EXPECT_SOURCES.has(source) ||
+        REMOVED_SOURCES.has(source) ||
+        RUNNERS_SOURCES.has(source)
+      ) {
+        unsupported(p.node, source, 'export *', p.node.exportKind === 'type');
+      }
+    },
+    CallExpression(p) {
+      const { root, members } = chain(p.node.callee, (node) => !!apiName(p, node));
+      const name = apiName(p, root);
+      if (name === 'bench' && (root.type !== 'Identifier' || !p.scope.getBinding(root.name))) {
+        editor.report(
+          p.node,
+          'benchmark-api',
+          'Replace the removed top-level bench API with the bench test-context fixture.',
+          'block',
+        );
+      }
+
+      if (REGISTRATIONS.has(name ?? '')) {
+        const seqMember =
+          p.node.callee.type === 'MemberExpression' && memberName(p.node.callee) === 'sequential'
+            ? p.node.callee
+            : undefined;
+        const opts = p.node.arguments[1];
+        if (seqMember && p.node.arguments.length >= 2) {
+          if (
+            staticObject(opts) &&
+            !objectProperty(opts, 'concurrent') &&
+            !objectProperty(opts, 'sequential')
+          ) {
+            editor.edit(seqMember.object.end!, seqMember.end!, '');
+            editor.add(opts, 'concurrent', 'false');
+          } else if (
+            opts?.type === 'ArrowFunctionExpression' ||
+            opts?.type === 'FunctionExpression'
+          ) {
+            editor.edit(seqMember.object.end!, seqMember.end!, '');
+            editor.edit(opts.start!, opts.start!, '{ concurrent: false }, ');
+          } else {
+            editor.report(
+              p.node,
+              'sequential-api',
+              'Replace sequential with concurrent: false after resolving the options and callback.',
+            );
+          }
+        } else if (members.includes('sequential')) {
+          editor.report(
+            p.node,
+            'sequential-api',
+            'Review the sequential modifier chain and replace it with concurrent: false.',
+          );
+        }
+        for (const argument of p.node.arguments.slice(1)) {
+          if (!staticObject(argument)) {
+            continue;
+          }
+          const sequential = objectProperty(argument, 'sequential');
+          if (!sequential) {
+            continue;
+          }
+          if (
+            sequential.value.type === 'BooleanLiteral' &&
+            sequential.value.value &&
+            !objectProperty(argument, 'concurrent')
+          ) {
+            editor.replace(sequential.key, 'concurrent');
+            editor.replace(sequential.value, 'false');
+          } else {
+            editor.report(
+              sequential,
+              'sequential-api',
+              'Resolve sequential/concurrent options explicitly before removing sequential.',
+            );
+          }
+        }
+        if (members.includes('each') || members.includes('for')) {
+          editor.report(
+            p.node,
+            'formatted-titles',
+            'Review generated test-title snapshots; v5 uses pretty-format and different string placeholders.',
+          );
+        }
+      }
+
+      if (name === 'vi' || name === 'vitest') {
+        const method = memberName(p.node.callee);
+        if (
+          ['mock', 'unmock', 'hoisted'].includes(method ?? '') &&
+          !p.parentPath.isExpressionStatement()
+        ) {
+          // A top-level variable initializer for vi.hoisted is valid too.
+          const statement = p.getStatementParent();
+          if (p.getFunctionParent() || !statement?.parentPath.isProgram()) {
+            editor.report(
+              p.node,
+              'nested-hoisted-mock',
+              'Move this hoisted mock to the top level after reviewing captured scope.',
+            );
+          }
+        } else if (
+          ['mock', 'unmock', 'hoisted'].includes(method ?? '') &&
+          !p.parentPath.parentPath?.isProgram()
+        ) {
+          editor.report(
+            p.node,
+            'nested-hoisted-mock',
+            'Move this hoisted mock to the top level after reviewing captured scope.',
+          );
+        }
+        if (
+          (options.browser || (options.browser === undefined && options.browserPossible)) &&
+          method === 'mock' &&
+          p.node.arguments.length === 1
+        ) {
+          editor.report(
+            p.node,
+            'browser-automock',
+            'Browser automocks now keep mock defaults; choose { spy: true } if real implementations are required.',
+          );
+        }
+        if ((method === 'fn' || method === 'spyOn') && looksLikeConstructorMock(p)) {
+          editor.report(
+            p.node,
+            'class-mock',
+            'If this mock replaces a constructor, review its prototype, methods, and instanceof behavior.',
+          );
+        }
+        if (method === 'setSystemTime' && /\bTemporal\b/.test(source)) {
+          editor.report(
+            p.node,
+            'temporal-system-time',
+            'vi.setSystemTime now changes Temporal even without fake timers; toNotFake does not preserve this behavior.',
+          );
+        }
+      }
+      if (memberName(p.node.callee) === 'mockImplementation' && looksLikeConstructorMock(p)) {
+        editor.report(
+          p.node,
+          'class-mock',
+          'Review constructor mock implementations and their inherited prototypes.',
+        );
+      }
+
+      if (name === 'expect') {
+        const matcher = memberName(p.node.callee);
+        const first = p.node.arguments[0];
+        if (
+          options.preserveV4 &&
+          ['toThrow', 'toThrowError'].includes(matcher ?? '') &&
+          first?.type === 'StringLiteral' &&
+          first.value === ''
+        ) {
+          editor.replace(first, '/^$/');
+        }
+        if ((options.preserveV4 || options.reviewV4) && matcher === 'toHaveTextContent') {
+          const browserAssertion = members.includes('element') || options.browser === true;
+          const literal = first?.type === 'StringLiteral' || first?.type === 'RegExpLiteral';
+          if (options.preserveV4 && browserAssertion && literal) {
+            const callee = p.node.callee as t.MemberExpression;
+            editor.replace(
+              callee.property,
+              callee.computed ? JSON.stringify('toMatchTextContent') : 'toMatchTextContent',
+            );
+          } else if (browserAssertion && !literal) {
+            editor.report(
+              p.node,
+              'text-content',
+              'Choose toMatchTextContent for v4 partial/regex matching after resolving the expected value.',
+            );
+          } else if (options.browser === undefined && options.browserPossible) {
+            editor.report(
+              p.node,
+              'text-content-project',
+              "Resolve this assertion's test project: browser assertions need toMatchTextContent for v4 partial matching; keep Node jest-dom assertions unchanged.",
+            );
+          }
+        }
+        if (members.includes('poll') && matcher !== 'poll') {
+          editor.report(
+            p.node,
+            'poll-timeout',
+            'Review the configured expect.poll timeout; v5 rejects assertions that finish after it.',
+          );
+        }
+        const asynchronous = members.some((member) =>
+          [
+            'resolves',
+            'rejects',
+            'poll',
+            'element',
+            'toMatchFileSnapshot',
+            'toMatchScreenshot',
+          ].includes(member),
+        );
+        if (asynchronous && p.parentPath.isExpressionStatement()) {
+          if (canAwait(p)) {
+            editor.edit(p.node.start!, p.node.start!, 'await ');
+          } else {
+            editor.report(
+              p.node,
+              'unawaited-assertion',
+              'Await or return this asynchronous assertion in an async-compatible function.',
+            );
+          }
+        } else if (
+          asynchronous &&
+          !p.parentPath.isMemberExpression() &&
+          !p.parentPath.isAwaitExpression() &&
+          !p.parentPath.isReturnStatement()
+        ) {
+          editor.report(
+            p.node,
+            'unawaited-assertion',
+            'Check that the result of this asynchronous assertion is awaited or returned.',
+          );
+        }
+      }
+
+      if (
+        importedName(p, p.node.callee, RENDER_SOURCES) === 'render' &&
+        !p.parentPath.isAwaitExpression() &&
+        !p.parentPath.isReturnStatement()
+      ) {
+        if (canAwait(p)) {
+          editor.edit(p.node.start!, p.node.start!, '(await ');
+          editor.edit(p.node.end!, p.node.end!, ')');
+        } else {
+          editor.report(
+            p.node,
+            'async-render',
+            'Await render from vitest-browser-vue/svelte after making the enclosing contract async-compatible.',
+          );
+        }
+      }
+
+      if (importedName(p, p.node.callee, NODE_SOURCES) === 'resolveConfig' && options.preserveV4) {
+        const awaitPath = p.parentPath;
+        const declaration = awaitPath.parentPath;
+        if (
+          awaitPath.isAwaitExpression() &&
+          declaration?.isVariableDeclarator() &&
+          declaration.node.id.type === 'ObjectPattern'
+        ) {
+          const props = declaration.node.id.properties;
+          if (
+            props.every(
+              (prop) =>
+                prop.type === 'ObjectProperty' &&
+                !prop.computed &&
+                prop.value.type === 'Identifier' &&
+                ['viteConfig', 'vitestConfig'].includes(propertyName(prop.key) ?? ''),
+            )
+          ) {
+            const vite = props.find(
+              (prop) => prop.type === 'ObjectProperty' && propertyName(prop.key) === 'viteConfig',
+            ) as t.ObjectProperty | undefined;
+            const vitest = props.find(
+              (prop) => prop.type === 'ObjectProperty' && propertyName(prop.key) === 'vitestConfig',
+            ) as t.ObjectProperty | undefined;
+            const local = vite
+              ? editor.text(vite.value)
+              : declaration.scope.generateUidIdentifier('viteConfig').name;
+            editor.replace(declaration.node.id, local);
+            if (vitest) {
+              editor.edit(
+                declaration.node.end!,
+                declaration.node.end!,
+                `, ${editor.text(vitest.value)} = ${local}.test`,
+              );
+            }
+          } else {
+            editor.report(
+              declaration.node,
+              'resolve-config',
+              'Replace resolveConfig pair destructuring with the Vite config return value and its .test property.',
+            );
+          }
+        } else {
+          editor.report(
+            p.node,
+            'resolve-config',
+            'Review resolveConfig consumers; the v5 return value is the Vite config with Vitest options under .test.',
+          );
+        }
+      }
+
+      if (memberName(p.node.callee) === 'collect') {
+        const object = (p.node.callee as t.MemberExpression).object;
+        const binding = object.type === 'Identifier' ? p.scope.getBinding(object.name) : undefined;
+        let initializer =
+          binding?.constant && binding.path.isVariableDeclarator()
+            ? binding.path.node.init
+            : undefined;
+        if (initializer?.type === 'AwaitExpression') {
+          initializer = initializer.argument;
+        }
+        const known =
+          initializer?.type === 'CallExpression' &&
+          ['createVitest', 'startVitest'].includes(
+            importedName(binding!.path, initializer.callee, NODE_SOURCES) ?? '',
+          );
+        // collect(filters?, options?) places staticParse in the second argument.
+        const opts = p.node.arguments[1];
+        if (
+          known &&
+          options.preserveV4 &&
+          p.node.arguments.length <= 2 &&
+          !p.node.arguments.some((argument) => argument.type === 'SpreadElement') &&
+          (!opts || staticObject(opts))
+        ) {
+          if (staticObject(opts)) {
+            editor.add(opts, 'staticParse', 'false');
+          } else {
+            editor.edit(
+              p.node.end! - 1,
+              p.node.end! - 1,
+              `${p.node.arguments.length ? ', ' : 'undefined, '}{ staticParse: false }`,
+            );
+          }
+        } else if (
+          !known ||
+          p.node.arguments.some((argument) => argument.type === 'SpreadElement') ||
+          (opts && !staticObject(opts))
+        ) {
+          editor.report(
+            p.node,
+            'static-collect',
+            'If this is Vitest.collect(), review staticParse and set it to false to retain runtime collection.',
+          );
+        }
+      }
+      if (
+        (p.node.callee.type === 'Import' ||
+          (p.node.callee.type === 'Identifier' &&
+            p.node.callee.name === 'require' &&
+            !p.scope.getBinding('require'))) &&
+        p.node.arguments[0]?.type === 'StringLiteral'
+      ) {
+        const source = p.node.arguments[0].value;
+        if (
+          REMOVED_SOURCES.has(source) ||
+          RUNNER_SOURCES.has(source) ||
+          EXPECT_SOURCES.has(source) ||
+          RUNNERS_SOURCES.has(source)
+        ) {
+          unsupported(p.node, source, 'dynamic/CommonJS import', false);
+        }
+        if (source === '@vitest/ws-client') {
+          editor.report(
+            p.node,
+            'ws-client',
+            'Replace direct @vitest/ws-client use; it does not receive Vitest v5 features.',
+          );
+        }
+      }
+    },
+    MemberExpression(p) {
+      if (['VITEST_POOL_ID', 'VITEST_WORKER_ID'].includes(memberName(p.node) ?? '')) {
+        editor.report(
+          p.node,
+          'worker-id',
+          'Review worker/pool ID arithmetic and indexing: IDs now start at 1, not 0.',
+        );
+      }
+    },
+    VariableDeclarator(p) {
+      if (p.node.id.type === 'ObjectPattern') {
+        for (const prop of p.node.id.properties) {
+          if (
+            prop.type === 'ObjectProperty' &&
+            ['VITEST_POOL_ID', 'VITEST_WORKER_ID'].includes(propertyName(prop.key) ?? '')
+          ) {
+            editor.report(
+              prop,
+              'worker-id',
+              'Review worker/pool ID arithmetic and indexing: IDs now start at 1, not 0.',
+            );
+          }
+        }
+      }
+    },
+    AssignmentExpression(p) {
+      if (/\boriginals\b/.test(editor.text(p.node.right))) {
+        editor.report(
+          p.node,
+          'global-descriptors',
+          'populateGlobal().originals stores descriptors; restore them with Object.defineProperty, not assignment.',
+        );
+      }
+      const left = p.node.left;
+      if (
+        (left.type === 'MemberExpression' &&
+          ['window', 'globalThis', 'global'].includes(editor.text(left.object)) &&
+          DOM_GLOBALS.has(memberName(left) ?? '')) ||
+        (left.type === 'Identifier' && DOM_GLOBALS.has(left.name))
+      ) {
+        editor.report(
+          p.node,
+          'dom-global',
+          'In jsdom/happy-dom, global assignment also updates the window; review this DOM override.',
+        );
+      }
+    },
+    TSInterfaceDeclaration(p) {
+      if (
+        ['Assertion', 'Matchers'].includes(p.node.id.name) &&
+        (p.node.typeParameters?.params.length ?? 0) < 2
+      ) {
+        editor.report(
+          p.node,
+          'assertion-types',
+          'Update custom matcher declarations for the v5 return and received type parameters; review jest.Matchers augmentations.',
+        );
+      }
+    },
+    TSTypeReference(p) {
+      const name = editor.text(p.node.typeName);
+      if (
+        ['Assertion', 'Matchers', 'jest.Matchers'].includes(name) &&
+        (p.node.typeParameters?.params.length ?? 0) < 2
+      ) {
+        editor.report(
+          p.node,
+          'assertion-types',
+          'Review old assertion generics; v5 includes return and received types.',
+        );
+      }
+    },
+    TSImportType(p) {
+      const source = p.node.argument.value;
+      if (
+        RUNNER_SOURCES.has(source) ||
+        EXPECT_SOURCES.has(source) ||
+        REMOVED_SOURCES.has(source) ||
+        RUNNERS_SOURCES.has(source)
+      ) {
+        unsupported(p.node, source, 'type import', true);
+      }
+    },
+    StringLiteral(p) {
+      const value = p.node.value;
+      if (/\/__vitest__\//.test(value) && !/[?&]token=/.test(value)) {
+        editor.report(
+          p.node,
+          'ui-token',
+          'Use the authenticated UI URL printed by Vitest, including its token.',
+        );
+      }
+      if (/\/__vitest_test__\//.test(value) && !/[?&]sessionId=/.test(value)) {
+        editor.report(
+          p.node,
+          'browser-session',
+          'Use the browser orchestrator URL opened by Vitest, including its sessionId.',
+        );
+      }
+      if (/\.vitest-attachements|\.vitest-reports|__screenshots__|html\/index\.html/.test(value)) {
+        editor.report(
+          p.node,
+          'artifact-paths',
+          'Review this old artifact/report path. Generated output moved under .vitest; reference screenshots remain separate.',
+        );
+      }
+    },
+  });
+  return editor.finish();
+}
diff --git a/packages/cli/src/oxlint-plugin.ts b/packages/cli/src/oxlint-plugin.ts
index 135f449209..bf91950ad9 100644
--- a/packages/cli/src/oxlint-plugin.ts
+++ b/packages/cli/src/oxlint-plugin.ts
@@ -4,11 +4,13 @@ import path from 'node:path';
 import { definePlugin, defineRule } from '@oxlint/plugins';
 import type { Context, ESTree } from '@oxlint/plugins';
 
+import cliPackage from '../package.json' with { type: 'json' };
 import {
   PREFER_VITE_PLUS_IMPORTS_RULE_NAME,
   VITE_PLUS_OXLINT_PLUGIN_NAME,
 } from './oxlint-plugin-config.ts';
 import viteConfigEntryBasenames from './vite-config-entry-basenames.json' with { type: 'json' };
+import vitestV5EntryPoints from './vitest-v5-entry-points.json' with { type: 'json' };
 
 // `declare module 'vitest…'` and `declare module '@vitest/browser…'` are
 // intentionally preserved by `vp migrate` (see migration's import_rewriter and
@@ -73,7 +75,11 @@ function rewriteVitePlusImportSpecifier(specifier: string): string | null {
   }
 
   if (specifier.startsWith('vitest/')) {
-    return `vite-plus/test/${specifier.slice('vitest/'.length)}`;
+    if (specifier in vitestV5EntryPoints) {
+      return vitestV5EntryPoints[specifier as keyof typeof vitestV5EntryPoints];
+    }
+    const subpath = `./test/${specifier.slice('vitest/'.length)}`;
+    return subpath in cliPackage.exports ? `vite-plus${subpath.slice(1)}` : null;
   }
 
   if (specifier === '@vitest/browser') {
diff --git a/packages/cli/src/resolve-test.ts b/packages/cli/src/resolve-test.ts
index 42e4d6f850..d089afb726 100644
--- a/packages/cli/src/resolve-test.ts
+++ b/packages/cli/src/resolve-test.ts
@@ -10,8 +10,8 @@
  * Used for: `vite-plus test` command
  */
 
-import { readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
 
 import { DEFAULT_ENVS, resolveBundled } from './utils/constants.ts';
 
@@ -19,6 +19,52 @@ interface VitestPackageJson {
   bin?: string | Record<string, string>;
 }
 
+/** Explain v5's directory-local config lookup without changing runner arguments. */
+export function parentTestConfigDiagnostic(cwd: string, args: readonly string[]): string | null {
+  const options = args.slice(0, args.includes('--') ? args.indexOf('--') : args.length);
+  if (
+    options.some(
+      (arg) =>
+        ['--help', '-h', '--version', '-v', '--config', '-c'].includes(arg) ||
+        arg.startsWith('--config=') ||
+        /^-c.+/.test(arg),
+    )
+  ) {
+    return null;
+  }
+  let root = cwd;
+  for (let index = 0; index < options.length; index++) {
+    const arg = options[index];
+    if (arg === '--root' || arg === '-r') {
+      if (!options[index + 1]) {
+        return null;
+      }
+      root = resolve(cwd, options[++index]);
+    } else if (arg.startsWith('--root=')) {
+      root = resolve(cwd, arg.slice('--root='.length));
+    }
+  }
+  const names = ['vitest', 'vite'].flatMap((name) =>
+    ['ts', 'mts', 'cts', 'js', 'mjs', 'cjs'].map((ext) => `${name}.config.${ext}`),
+  );
+  const findConfig = (dir: string) => names.find((name) => existsSync(join(dir, name)));
+  if (findConfig(root)) {
+    return null;
+  }
+  for (let parent = dirname(root); parent !== root; root = parent, parent = dirname(parent)) {
+    const name = findConfig(parent);
+    if (name) {
+      const config = relative(cwd, join(parent, name)).replaceAll('\\', '/');
+      const quoted = /[\s'"$`]/.test(config) ? `'${config.replaceAll("'", "'\\''")}'` : config;
+      return (
+        `No test config was found in this directory.\n` +
+        `A config exists at ${config}. Run \`vp test --config ${quoted} --dir .\`.`
+      );
+    }
+  }
+  return null;
+}
+
 /**
  * Resolves the Vitest binary path and environment variables.
  *
diff --git a/packages/cli/src/utils/constants.ts b/packages/cli/src/utils/constants.ts
index 2cecc402dd..ab24bb6031 100644
--- a/packages/cli/src/utils/constants.ts
+++ b/packages/cli/src/utils/constants.ts
@@ -15,7 +15,11 @@ export const VITE_CONFIG_FILES = [
   'vite.config.cts',
 ] as const;
 
-export const VITEST_VERSION = '4.1.11';
+export const VITEST_VERSION = '5.0.0';
+
+// Community-maintained provider: its releases do not track the official runner.
+export const VITEST_WEBDRIVERIO_VERSION = '5.0.0-rc.1';
+export const VITEST_WEBDRIVERIO_RANGE = '^5.0.0-beta.5 || >=5.0.0';
 
 // Exact action release used by generated workflows and the @v1 migration.
 // The Renovate custom manager keeps this value current.
@@ -28,10 +32,9 @@ export const VITE_PLUS_OVERRIDE_PACKAGES: Record<string, string> = process.env.V
   ? JSON.parse(process.env.VP_OVERRIDE_PACKAGES)
   : {
       vite: `npm:@voidzero-dev/vite-plus-core@${VITE_PLUS_VERSION}`,
-      // Pin `vitest` only. The `@vitest/*` family (expect, runner, snapshot, spy,
-      // utils, mocker, pretty-format) are EXACT (`4.1.9`) dependencies of `vitest`
-      // itself, so a single `vitest` override cascades one consistent version to
-      // the whole tree — overriding the indirect deps individually is redundant.
+      // The runner inlines its assertion and runner state. Its remaining
+      // official dependencies use exact versions; community providers and
+      // Istanbul internals have their own version ranges.
       // Coverage providers (`@vitest/coverage-v8` / `-istanbul`) are vitest PEER
       // deps the project installs and versions itself — vite-plus never adds,
       // pins, or overrides them. The runtime guard in `define-config.ts` only
diff --git a/packages/cli/src/utils/vitest-ecosystem.ts b/packages/cli/src/utils/vitest-ecosystem.ts
index f950cf3ee8..222378099d 100644
--- a/packages/cli/src/utils/vitest-ecosystem.ts
+++ b/packages/cli/src/utils/vitest-ecosystem.ts
@@ -1,10 +1,32 @@
-const VITEST_ALIGN_EXCLUDED = new Set([
-  '@vitest/eslint-plugin',
-  // Deprecated at 0.33.0 and replaced by @vitest/coverage-v8. It does not
-  // publish versions on Vitest's current release line.
-  '@vitest/coverage-c8',
+import { VITEST_VERSION, VITEST_WEBDRIVERIO_RANGE } from './constants.ts';
+
+/** Official packages that share the bundled runner's release version. */
+export const VITEST_EXACT_VERSION_PACKAGES: ReadonlySet<string> = new Set([
+  '@vitest/browser',
+  '@vitest/browser-playwright',
+  '@vitest/browser-preview',
+  '@vitest/coverage-v8',
+  '@vitest/coverage-istanbul',
+  '@vitest/mocker',
+  '@vitest/pretty-format',
+  '@vitest/snapshot',
+  '@vitest/spy',
+  '@vitest/ui',
+  '@vitest/utils',
+  '@vitest/web-worker',
+]);
+
+/** Optional peers fall back to the project; unrelated @vitest packages do not redirect. */
+export const VITEST_RESOLVER_PACKAGES: ReadonlySet<string> = new Set([
+  'vitest',
+  ...VITEST_EXACT_VERSION_PACKAGES,
+  '@vitest/browser-webdriverio',
 ]);
 
 export function isAlignableVitestEcosystemPackage(name: string): boolean {
-  return name.startsWith('@vitest/') && !VITEST_ALIGN_EXCLUDED.has(name);
+  return VITEST_EXACT_VERSION_PACKAGES.has(name) || name === '@vitest/browser-webdriverio';
+}
+
+export function vitestEcosystemVersion(name: string): string {
+  return name === '@vitest/browser-webdriverio' ? VITEST_WEBDRIVERIO_RANGE : VITEST_VERSION;
 }
diff --git a/packages/cli/src/vitest-v5-entry-points.json b/packages/cli/src/vitest-v5-entry-points.json
new file mode 100644
index 0000000000..347d1c7d64
--- /dev/null
+++ b/packages/cli/src/vitest-v5-entry-points.json
@@ -0,0 +1,7 @@
+{
+  "vitest/coverage": "vite-plus/test/node",
+  "vitest/reporters": "vite-plus/test/node",
+  "vitest/environments": "vite-plus/test/runtime",
+  "vitest/snapshot": "vite-plus/test/runtime",
+  "vitest/mocker": "vite-plus/test/mocker"
+}
diff --git a/packages/tools/src/__tests__/sync-remote-deps.spec.ts b/packages/tools/src/__tests__/sync-remote-deps.spec.ts
index 82ef13c409..b6bd801de6 100644
--- a/packages/tools/src/__tests__/sync-remote-deps.spec.ts
+++ b/packages/tools/src/__tests__/sync-remote-deps.spec.ts
@@ -1,12 +1,176 @@
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
 import * as semver from 'semver';
 import { describe, expect, test } from 'vitest';
 
 import {
+  alignVendoredVitestDependencies,
   mergePnpmWorkspaces,
   syncCargoOxcVersions,
   syncViteDevtoolsDependencies,
 } from '../sync-remote-deps.ts';
 
+describe('vendored Vitest v5 bridge', () => {
+  test('resolves the reviewed Vitest major catalog conflict', () => {
+    const merged = mergePnpmWorkspaces(
+      { catalog: { vitest: '5.0.0' } },
+      { catalog: { vitest: '^4.1.6' } },
+      { catalog: { vitest: '^4.1.10' } },
+      semver,
+    );
+    expect(merged.catalog?.vitest).toBe('5.0.0');
+  });
+
+  test.each(['=4.1.11', '^5.1.0', '5.2.0', '^6.0.0'])(
+    'preserves the selected exact runner version against upstream %s',
+    (upstream) => {
+      const merged = mergePnpmWorkspaces(
+        { catalog: { vitest: '5.0.0' } },
+        { catalog: { vitest: upstream } },
+        {},
+        semver,
+      );
+      expect(merged.catalog?.vitest).toBe('5.0.0');
+    },
+  );
+
+  test('aligns official catalog entries to the selected runner and preserves the community provider', () => {
+    const merged = mergePnpmWorkspaces(
+      {
+        catalog: {
+          vitest: '5.1.2',
+          '@vitest/browser': '5.0.0',
+          '@vitest/browser-webdriverio': '5.0.0-rc.1',
+        },
+      },
+      {
+        catalog: {
+          vitest: '^4.1.6',
+          '@vitest/browser': '^5.2.0',
+          '@vitest/browser-webdriverio': '5.3.0',
+          '@vitest/utils': '4.1.11',
+          '@vitest/expect': '4.1.11',
+          '@vitest/runner': '4.1.11',
+          '@vitest/eslint-plugin': '^1.0.0',
+        },
+      },
+      {
+        catalog: {
+          '@vitest/coverage-v8': '4.1.11',
+          '@vitest/coverage-istanbul': '^4.1.11',
+          '@vitest/ui': '^5.2.0',
+          '@vitest/web-worker': '4.1.11',
+        },
+      },
+      semver,
+    );
+    expect(merged.catalog).toEqual({
+      vitest: '5.1.2',
+      '@vitest/browser': '5.1.2',
+      '@vitest/browser-webdriverio': '5.0.0-rc.1',
+      '@vitest/utils': '5.1.2',
+      '@vitest/coverage-v8': '5.1.2',
+      '@vitest/coverage-istanbul': '5.1.2',
+      '@vitest/ui': '5.1.2',
+      '@vitest/web-worker': '5.1.2',
+      '@vitest/eslint-plugin': '^1.0.0',
+    });
+  });
+
+  test.each(['^5.0.0', '=5.0.0', '4.1.11', '6.0.0', '5.1.0-beta.1'])(
+    'rejects an unreviewed root runner version %s',
+    (vitest) => {
+      expect(() => mergePnpmWorkspaces({ catalog: { vitest } }, {}, {}, semver)).toThrow(
+        'The root Vitest catalog entry must be an exact stable v5 version',
+      );
+    },
+  );
+
+  test('does not infer a missing root pin from an upstream catalog', () => {
+    expect(() => mergePnpmWorkspaces({}, { catalog: { vitest: '^4.1.6' } }, {}, semver)).toThrow(
+      'The root Vitest catalog entry must be an exact stable v5 version',
+    );
+  });
+
+  test('still resolves tinybench to the higher major version', () => {
+    const merged = mergePnpmWorkspaces(
+      { catalog: { tinybench: '^6.0.0' } },
+      { catalog: { tinybench: '^2.9.0' } },
+      {},
+      semver,
+    );
+    expect(merged.catalog?.tinybench).toBe('^6.0.0');
+  });
+
+  test.each(['@vitest/expect', '@vitest/runner'])(
+    'rejects actual dependencies on removed package %s',
+    (name) => {
+      const root = mkdtempSync(join(tmpdir(), 'vp-vendored-vitest-'));
+      try {
+        mkdirSync(join(root, 'vite', 'packages'), { recursive: true });
+        writeFileSync(
+          join(root, 'vite', 'package.json'),
+          JSON.stringify({ devDependencies: { [name]: 'catalog:' } }),
+        );
+        expect(() => alignVendoredVitestDependencies(root, '5.0.0')).toThrow(
+          `Migrate removed ${name} use`,
+        );
+      } finally {
+        rmSync(root, { recursive: true, force: true });
+      }
+    },
+  );
+
+  test('aligns direct workspace dependencies and leaves fixture manifests alone', () => {
+    const root = mkdtempSync(join(tmpdir(), 'vp-vendored-vitest-'));
+    try {
+      for (const vendor of ['vite', 'rolldown']) {
+        mkdirSync(join(root, vendor, 'packages', 'test', 'fixtures'), { recursive: true });
+        writeFileSync(
+          join(root, vendor, 'package.json'),
+          JSON.stringify({
+            devDependencies: { vitest: '^4.0.0', '@vitest/eslint-plugin': '^1.0.0' },
+          }),
+        );
+        writeFileSync(
+          join(root, vendor, 'packages', 'test', 'package.json'),
+          JSON.stringify({
+            devDependencies: {
+              vitest: 'catalog:',
+              '@vitest/utils': '4.1.10',
+              '@vitest/web-worker': 'catalog:legacy',
+              '@vitest/browser-webdriverio': '^5.0.0-beta.5',
+            },
+          }),
+        );
+        writeFileSync(
+          join(root, vendor, 'packages', 'test', 'fixtures', 'package.json'),
+          '\ufeff{}',
+        );
+      }
+      alignVendoredVitestDependencies(root, '5.0.0');
+      for (const vendor of ['vite', 'rolldown']) {
+        expect(
+          JSON.parse(readFileSync(join(root, vendor, 'package.json'), 'utf8')).devDependencies,
+        ).toEqual({ vitest: '5.0.0', '@vitest/eslint-plugin': '^1.0.0' });
+        expect(
+          JSON.parse(readFileSync(join(root, vendor, 'packages', 'test', 'package.json'), 'utf8'))
+            .devDependencies,
+        ).toEqual({
+          vitest: 'catalog:',
+          '@vitest/utils': '5.0.0',
+          '@vitest/web-worker': '5.0.0',
+          '@vitest/browser-webdriverio': '^5.0.0-beta.5',
+        });
+      }
+    } finally {
+      rmSync(root, { recursive: true, force: true });
+    }
+  });
+});
+
 describe('syncViteDevtoolsDependencies()', () => {
   test('uses the DevTools ranges declared by Vite', () => {
     const corePackage = {
diff --git a/packages/tools/src/__tests__/sync-remote-yaml.spec.ts b/packages/tools/src/__tests__/sync-remote-yaml.spec.ts
index a417ee215a..102f1f7fd6 100644
--- a/packages/tools/src/__tests__/sync-remote-yaml.spec.ts
+++ b/packages/tools/src/__tests__/sync-remote-yaml.spec.ts
@@ -2,6 +2,7 @@ import * as semver from 'semver';
 import { describe, expect, test } from 'vitest';
 import * as yaml from 'yaml';
 
+import { findLatestStableVersionForMajor } from '../../../../.github/scripts/upgrade-deps-utils.ts';
 import { mergePnpmWorkspaces, mergeWorkspaceYaml } from '../sync-remote-deps.ts';
 
 // `pnpm tool sync-remote` rewrites the whole pnpm-workspace.yaml. It must merge
@@ -38,6 +39,34 @@ const VITE_SRC = `catalog:
 `;
 
 describe('mergeWorkspaceYaml()', () => {
+  test('preserves the latest supported pin across repeated upstream syncs', () => {
+    const version = findLatestStableVersionForMajor(['5.0.0', '5.1.2', '5.2.0-beta.1', '6.0.0'], 5);
+    expect(version).toBe('5.1.2');
+    const main = `catalog:
+  # Keep the runner and official packages on the selected release.
+  vitest: ${version}
+  '@vitest/browser': ${version}
+`;
+    const rolldown = `catalog:
+  vitest: '=4.1.11'
+  '@vitest/utils': '^4.1.11'
+`;
+    const vite = `catalog:
+  vitest: '^5.2.0'
+  '@vitest/browser': '^5.2.0'
+`;
+
+    const output = mergeWorkspaceYaml(main, rolldown, vite, yaml, semver);
+
+    expect(yaml.parse(output).catalog).toEqual({
+      vitest: '5.1.2',
+      '@vitest/browser': '5.1.2',
+      '@vitest/utils': '5.1.2',
+    });
+    expect(output).toContain('# Keep the runner and official packages on the selected release.');
+    expect(mergeWorkspaceYaml(output, rolldown, vite, yaml, semver)).toBe(output);
+  });
+
   test('preserves comments from the main workspace', () => {
     const output = mergeWorkspaceYaml(MAIN_SRC, ROLLDOWN_SRC, VITE_SRC, yaml, semver);
 
diff --git a/packages/tools/src/__tests__/test-vendored-vitest.spec.ts b/packages/tools/src/__tests__/test-vendored-vitest.spec.ts
new file mode 100644
index 0000000000..e7e567cf45
--- /dev/null
+++ b/packages/tools/src/__tests__/test-vendored-vitest.spec.ts
@@ -0,0 +1,27 @@
+import { describe, expect, test } from 'vitest';
+
+import { adaptBrandedViteAssertions } from '../test-vendored-vitest.ts';
+
+describe('vendored Vitest bridge', () => {
+  test('checks the deliberate branding changes and retains unrelated assertions', () => {
+    const source = [
+      ...Array.from(
+        { length: 8 },
+        () =>
+          'expect(messages).toMatchInlineSnapshot(`"VITE_CONFIG_NATIVE_IGNORE_WARNING: \\`native\\`"`)',
+      ),
+      'expect(messages).toMatchInlineSnapshot(`"unrelated warning"`)',
+      'expect(config).toMatchInlineSnapshot(`{ "jsonValue": "vite" }`)',
+    ].join('\n');
+    const result = adaptBrandedViteAssertions(source);
+    expect(result.match(/expect\(messages\)\.toEqual\(\[\]\)/g)).toHaveLength(8);
+    expect(result).toContain('"jsonValue": "@voidzero-dev/vite-plus-core"');
+    expect(result).toContain('expect(messages).toMatchInlineSnapshot(`"unrelated warning"`)');
+  });
+
+  test('requires a new review if the upstream tests change', () => {
+    expect(() => adaptBrandedViteAssertions('expect(messages).toEqual([])')).toThrow(
+      'Review the vendored Vite branding assertions',
+    );
+  });
+});
diff --git a/packages/tools/src/sync-remote-deps.ts b/packages/tools/src/sync-remote-deps.ts
index 28e96c2876..0e039ce3a9 100755
--- a/packages/tools/src/sync-remote-deps.ts
+++ b/packages/tools/src/sync-remote-deps.ts
@@ -1,5 +1,5 @@
 import { execSync, spawnSync } from 'node:child_process';
-import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { parseArgs } from 'node:util';
 
@@ -370,11 +370,68 @@ const OXC_PACKAGES = new Set([
   'oxlint',
   'oxlint-tsgolint',
 ]);
-const VITEST_DEPS = new Set(['tinybench']);
+// These official packages share the runner version selected by upgrade-deps.ts.
+// Community packages, such as browser-webdriverio, have independent versions.
+const VITEST_EXACT_VERSION_PACKAGES = new Set([
+  'vitest',
+  '@vitest/browser',
+  '@vitest/browser-playwright',
+  '@vitest/browser-preview',
+  '@vitest/coverage-v8',
+  '@vitest/coverage-istanbul',
+  '@vitest/mocker',
+  '@vitest/pretty-format',
+  '@vitest/snapshot',
+  '@vitest/spy',
+  '@vitest/ui',
+  '@vitest/utils',
+  '@vitest/web-worker',
+]);
+const REMOVED_VITEST_PACKAGES = new Set(['@vitest/runner', '@vitest/expect']);
+
+export function alignVendoredVitestDependencies(rootDir: string, version: string): void {
+  for (const vendor of [VITE_DIR, ROLLDOWN_DIR]) {
+    const packagesDir = join(rootDir, vendor, 'packages');
+    const dirs = [
+      join(rootDir, vendor),
+      ...readdirSync(packagesDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => join(packagesDir, entry.name)),
+    ];
+    for (const dir of dirs) {
+      const file = join(dir, 'package.json');
+      if (!existsSync(file)) {
+        continue;
+      }
+      const source = readFileSync(file, 'utf8');
+      const pkg = JSON.parse(source) as Record<string, Record<string, string>>;
+      let changed = false;
+      for (const field of ['dependencies', 'devDependencies', 'optionalDependencies']) {
+        for (const name of Object.keys(pkg[field] ?? {})) {
+          if (REMOVED_VITEST_PACKAGES.has(name)) {
+            throw new Error(`Migrate removed ${name} use in ${file} before synchronizing Vitest`);
+          }
+          if (!VITEST_EXACT_VERSION_PACKAGES.has(name)) {
+            continue;
+          }
+          // Only the default catalog is aligned during sync; named catalogs can still use v4.
+          if (pkg[field][name] !== version && pkg[field][name] !== 'catalog:') {
+            pkg[field][name] = version;
+            changed = true;
+          }
+        }
+      }
+      if (changed) {
+        writeFileSync(file, `${JSON.stringify(pkg, null, 2)}\n`);
+        log(`Aligned Vitest dependencies in ${file} to ${version}`);
+      }
+    }
+  }
+}
 
 // These packages should always use the highest version
 function syncedPackages(packageName: string): boolean {
-  if (OXC_PACKAGES.has(packageName) || VITEST_DEPS.has(packageName)) {
+  if (OXC_PACKAGES.has(packageName) || packageName === 'tinybench') {
     return true;
   }
   return OXC_PACKAGE_PREFIXES.some((prefix) => packageName.startsWith(prefix));
@@ -531,26 +588,34 @@ export function mergePnpmWorkspaces(
   packagesSet.add(`${VITE_DIR}/packages/*`);
   result.packages = Array.from(packagesSet);
 
-  // Merge catalog
-  const catalog: Record<string, string> = { ...main.catalog };
-
-  // Add all entries from rolldown catalog
-  for (const [pkg, version] of Object.entries(rolldown.catalog || {})) {
-    if (catalog[pkg]) {
-      // Merge versions
-      catalog[pkg] = mergeSemverVersions(catalog[pkg], version, pkg, semver);
-    } else {
-      catalog[pkg] = version;
-    }
-  }
-
-  // Add all entries from vite catalog (if it has one)
-  for (const [pkg, version] of Object.entries(rolldownVite.catalog || {})) {
-    if (catalog[pkg]) {
-      // Merge versions
-      catalog[pkg] = mergeSemverVersions(catalog[pkg], version, pkg, semver);
-    } else {
-      catalog[pkg] = version;
+  // The upgrade script selects the latest supported Vitest release and updates
+  // the runtime constant with it. Upstream catalogs must not replace that pin.
+  const vitestVersion = main.catalog?.vitest;
+  const catalog: Record<string, string> = {};
+  for (const workspace of [main, rolldown, rolldownVite]) {
+    for (const [pkg, version] of Object.entries(workspace.catalog || {})) {
+      if (REMOVED_VITEST_PACKAGES.has(pkg)) {
+        // Unused upstream entries are harmless; actual dependency uses fail in
+        // alignVendoredVitestDependencies instead of reinstalling removed packages.
+        continue;
+      }
+      if (VITEST_EXACT_VERSION_PACKAGES.has(pkg)) {
+        if (
+          !vitestVersion ||
+          !/^5\.\d+\.\d+$/.test(vitestVersion) ||
+          semver.valid(vitestVersion) !== vitestVersion
+        ) {
+          throw new Error('The root Vitest catalog entry must be an exact stable v5 version');
+        }
+        catalog[pkg] = vitestVersion;
+      } else if (pkg === '@vitest/browser-webdriverio' && main.catalog?.[pkg]) {
+        // This community provider does not share the official release schedule.
+        catalog[pkg] = main.catalog[pkg];
+      } else {
+        catalog[pkg] = catalog[pkg]
+          ? mergeSemverVersions(catalog[pkg], version, pkg, semver)
+          : version;
+      }
     }
   }
 
@@ -902,7 +967,12 @@ export async function syncRemote() {
   // Merge upstream catalogs into the main workspace while preserving its comments.
   const yamlContent = mergeWorkspaceYaml(mainSrc, rolldownSrc, rolldownViteSrc, yaml, semver);
 
+  const vitestVersion = (yaml.parse(yamlContent) as PnpmWorkspace).catalog?.vitest;
+  if (!vitestVersion || !semver.valid(vitestVersion)) {
+    throw new Error('The Vitest catalog entry must be an exact version');
+  }
   writeFileSync(mainWorkspacePath, yamlContent, 'utf-8');
+  alignVendoredVitestDependencies(rootDir, vitestVersion);
 
   log('✓ pnpm-workspace.yaml updated successfully!');
 
diff --git a/packages/tools/src/test-vendored-vitest.ts b/packages/tools/src/test-vendored-vitest.ts
new file mode 100644
index 0000000000..d8bd372e86
--- /dev/null
+++ b/packages/tools/src/test-vendored-vitest.ts
@@ -0,0 +1,125 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { configDefaults } from 'vitest/config';
+import { createVitest, type TestUserConfig } from 'vitest/node';
+
+/** The branded checkout deliberately suppresses this notice and aliases Vite's
+ * package name. Check those contracts without changing the upstream checkout
+ * or accepting unrelated snapshot changes. Fail if the pinned tests drift. */
+export function adaptBrandedViteAssertions(source: string): string {
+  let notices = 0;
+  const result = source.replace(
+    /expect\(messages\)\.toMatchInlineSnapshot\(`(?:\\[\s\S]|[^`\\])*`\)/g,
+    (snapshot) => {
+      if (!snapshot.includes('VITE_CONFIG_NATIVE_IGNORE_WARNING')) {
+        return snapshot;
+      }
+      notices++;
+      return 'expect(messages).toEqual([])';
+    },
+  );
+  const packageNames = result.match(/"jsonValue": "vite"/g)?.length ?? 0;
+  if (notices !== 8 || packageNames !== 1) {
+    throw new Error('Review the vendored Vite branding assertions after updating its revision.');
+  }
+  return result.replace('"jsonValue": "vite"', '"jsonValue": "@voidzero-dev/vite-plus-core"');
+}
+
+const suites: Record<string, { directory: string; config: string; options?: TestUserConfig }> = {
+  vite: { directory: 'vite', config: 'vitest.config.ts' },
+  rolldown: {
+    directory: 'rolldown/packages/rolldown/tests',
+    config: 'vitest.config.mts',
+    options: { exclude: [...configDefaults.exclude, '**/watch.test.ts', '**/dev-watch.test.ts'] },
+  },
+  'rolldown-watch': {
+    directory: 'rolldown/packages/rolldown/tests',
+    config: 'vitest.config.mts',
+    options: { include: ['**/watch.test.ts', '**/dev-watch.test.ts'] },
+  },
+  'rolldown-dev-server': {
+    directory: 'rolldown/packages/test-dev-server/tests',
+    config: 'vitest.config.fixtures.mts',
+  },
+};
+
+async function main() {
+  const root = fileURLToPath(new URL('../../../', import.meta.url));
+  const selected = process.argv.slice(2);
+  for (const name of selected.length ? selected : Object.keys(suites)) {
+    const suite = suites[name];
+    if (!suite) {
+      throw new Error(`Unknown vendored suite: ${name}. Use ${Object.keys(suites).join(', ')}.`);
+    }
+    const directory = path.join(root, suite.directory);
+    process.chdir(directory);
+    console.log(`\nRunning vendored ${name} with the synchronized Vitest v5 graph`);
+    const runner = await createVitest(
+      {
+        config: suite.config,
+        watch: false,
+        maxWorkers: 4,
+        // The upstream configs predate v5. Keep their explicit v4 mock history
+        // contract in this test-only bridge until upstream adopts the default.
+        clearMocks: false,
+        env: {
+          ROLLDOWN_TEST: '1',
+          RUST_BACKTRACE: '1',
+          // The root install already supplies the v5 bridge. A nested pnpm
+          // command must not reinstall the vendored workspace's v4 catalog.
+          PNPM_CONFIG_VERIFY_DEPS_BEFORE_RUN: 'false',
+          pnpm_config_verify_deps_before_run: 'false',
+          NPM_CONFIG_WORKSPACE_DIR: root,
+          // Match the package-local PATH supplied by the upstream pnpm scripts.
+          PATH: [
+            path.join(directory, 'node_modules/.bin'),
+            path.join(root, 'node_modules/.bin'),
+            // pnpm scripts expose the real manager here. Keep child commands
+            // off user-installed vp/Corepack shims with independent runtimes.
+            process.env.npm_execpath && path.dirname(process.env.npm_execpath),
+            process.env.PATH,
+          ]
+            .filter(Boolean)
+            .join(path.delimiter),
+        },
+        ...suite.options,
+      },
+      {
+        plugins:
+          name === 'vite'
+            ? [
+                {
+                  name: 'vite-plus:vendored-branding-assertions',
+                  enforce: 'pre',
+                  transform(source, id) {
+                    if (
+                      id.split('?')[0] ===
+                      path
+                        .join(directory, 'packages/vite/src/node/__tests__/config.spec.ts')
+                        .replaceAll('\\', '/')
+                    ) {
+                      return { code: adaptBrandedViteAssertions(source), map: null };
+                    }
+                    return null;
+                  },
+                },
+              ]
+            : [],
+      },
+    );
+    try {
+      const result = await runner.start();
+      if (result.unhandledErrors.length || runner.state.getCountOfFailedTests()) {
+        process.exitCode = 1;
+      }
+    } finally {
+      await runner.close();
+      process.chdir(root);
+    }
+  }
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  await main();
+}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 15383c0ed5..56e23b38b7 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -9,12 +9,21 @@ catalogs:
     '@babel/core':
       specifier: ^7.29.7
       version: 7.29.7
+    '@babel/parser':
+      specifier: ^7.29.8
+      version: 7.29.8
     '@babel/preset-env':
       specifier: ^7.29.7
       version: 7.29.7
     '@babel/preset-typescript':
       specifier: ^7.29.7
       version: 7.29.7
+    '@babel/traverse':
+      specifier: ^7.29.8
+      version: 7.29.8
+    '@babel/types':
+      specifier: ^7.29.8
+      version: 7.29.8
     '@clack/core':
       specifier: ^1.0.0
       version: 1.4.3
@@ -24,6 +33,9 @@ catalogs:
     '@emnapi/runtime':
       specifier: 2.0.0-alpha.4
       version: 2.0.0-alpha.4
+    '@jridgewell/trace-mapping':
+      specifier: ^0.3.31
+      version: 0.3.31
     '@napi-rs/cli':
       specifier: ^3.8.2
       version: 3.8.2
@@ -66,6 +78,9 @@ catalogs:
     '@types/babel__core':
       specifier: 7.20.5
       version: 7.20.5
+    '@types/babel__traverse':
+      specifier: ^7.28.0
+      version: 7.28.0
     '@types/connect':
       specifier: ^3.4.38
       version: 3.4.38
@@ -94,38 +109,32 @@ catalogs:
       specifier: 7.0.0-dev.20260605.1
       version: 7.0.0-dev.20260605.1
     '@vitest/browser':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     '@vitest/browser-playwright':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     '@vitest/browser-preview':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     '@vitest/browser-webdriverio':
-      specifier: 4.1.11
-      version: 4.1.11
-    '@vitest/expect':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0-rc.1
+      version: 5.0.0-rc.1
     '@vitest/mocker':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     '@vitest/pretty-format':
-      specifier: 4.1.11
-      version: 4.1.11
-    '@vitest/runner':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     '@vitest/snapshot':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     '@vitest/spy':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     '@vitest/utils':
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     bingo:
       specifier: ^0.9.3
       version: 0.9.3
@@ -159,6 +168,9 @@ catalogs:
     execa:
       specifier: ^9.2.0
       version: 9.6.1
+    fast-glob:
+      specifier: ^3.3.3
+      version: 3.3.3
     fresh-import:
       specifier: ^0.2.1
       version: 0.2.1
@@ -243,6 +255,9 @@ catalogs:
     tsdown:
       specifier: ^0.23.0
       version: 0.23.0
+    tsx:
+      specifier: ^4.22.0
+      version: 4.23.12
     typescript:
       specifier: ^6.0.0
       version: 6.0.3
@@ -253,8 +268,8 @@ catalogs:
       specifier: ^7.0.2
       version: 7.0.2
     vitest:
-      specifier: 4.1.11
-      version: 4.1.11
+      specifier: 5.0.0
+      version: 5.0.0
     vue:
       specifier: ^3.5.35
       version: 3.5.40
@@ -319,7 +334,7 @@ importers:
         version: link:packages/cli
       vitest:
         specifier: 'catalog:'
-        version: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+        version: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
 
   packages/cli:
     dependencies:
@@ -331,31 +346,25 @@ importers:
         version: 1.79.0
       '@vitest/browser':
         specifier: 'catalog:'
-        version: 4.1.11(vite@packages+core)(vitest@4.1.11)
+        version: 5.0.0(vite@packages+core)(vitest@5.0.0)
       '@vitest/browser-preview':
         specifier: 'catalog:'
-        version: 4.1.11(vite@packages+core)(vitest@4.1.11)
-      '@vitest/expect':
-        specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.0(vite@packages+core)(vitest@5.0.0)
       '@vitest/mocker':
         specifier: 'catalog:'
-        version: 4.1.11(vite@packages+core)
+        version: 5.0.0(vite@packages+core)
       '@vitest/pretty-format':
         specifier: 'catalog:'
-        version: 4.1.11
-      '@vitest/runner':
-        specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.0
       '@vitest/snapshot':
         specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.0
       '@vitest/spy':
         specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.0
       '@vitest/utils':
         specifier: 'catalog:'
-        version: 4.1.11
+        version: 5.0.0
       oxfmt:
         specifier: 'catalog:'
         version: 0.66.0(vite-plus@packages+cli)
@@ -370,8 +379,17 @@ importers:
         version: link:../core
       vitest:
         specifier: 'catalog:'
-        version: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+        version: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
     devDependencies:
+      '@babel/parser':
+        specifier: 'catalog:'
+        version: 7.29.8
+      '@babel/traverse':
+        specifier: 'catalog:'
+        version: 7.29.8(supports-color@8.1.1)
+      '@babel/types':
+        specifier: 'catalog:'
+        version: 7.29.8
       '@emnapi/core':
         specifier: 'catalog:'
         version: 2.0.0-alpha.4
@@ -384,6 +402,9 @@ importers:
       '@nkzw/safe-word-list':
         specifier: 'catalog:'
         version: 3.1.0
+      '@types/babel__traverse':
+        specifier: 'catalog:'
+        version: 7.28.0
       '@types/cross-spawn':
         specifier: 'catalog:'
         version: 6.0.6
@@ -395,10 +416,10 @@ importers:
         version: 4.0.2
       '@vitest/browser-playwright':
         specifier: 'catalog:'
-        version: 4.1.11(playwright@1.62.1)(vite@packages+core)(vitest@4.1.11)
+        version: 5.0.0(playwright@1.62.1)(vite@packages+core)(vitest@5.0.0)
       '@vitest/browser-webdriverio':
         specifier: 'catalog:'
-        version: 4.1.11(vite@packages+core)(vitest@4.1.11)(webdriverio@9.20.1(supports-color@8.1.1))
+        version: 5.0.0-rc.1(vite@packages+core)(vitest@5.0.0)(webdriverio@9.20.1(supports-color@8.1.1))
       '@voidzero-dev/vite-plus-prompts':
         specifier: workspace:*
         version: link:../prompts
@@ -647,7 +668,7 @@ importers:
         version: 7.8.5
       vitest:
         specifier: 'catalog:'
-        version: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+        version: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
       yaml:
         specifier: 'catalog:'
         version: 2.9.0
@@ -837,6 +858,67 @@ importers:
         specifier: 'catalog:'
         version: 1.4.2(typescript@6.0.3)
 
+  rolldown/packages/rolldown/tests:
+    dependencies:
+      rolldown:
+        specifier: workspace:rolldown@*
+        version: link:..
+      vite:
+        specifier: workspace:@voidzero-dev/vite-plus-core@*
+        version: link:../../../../packages/core
+      vitest:
+        specifier: 'catalog:'
+        version: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+    devDependencies:
+      '@jridgewell/trace-mapping':
+        specifier: 'catalog:'
+        version: 0.3.31
+      '@rolldown/test-dev-server':
+        specifier: workspace:*
+        version: link:../../test-dev-server
+      '@rolldown/test-dual-format':
+        specifier: link:./package-fixtures/test-dual-format
+        version: link:package-fixtures/test-dual-format
+      '@rolldown/test-side-effects-field':
+        specifier: link:./package-fixtures/test-side-effects-field
+        version: link:package-fixtures/test-side-effects-field
+      '@rolldown/test-side-effects-field-glob':
+        specifier: file:./package-fixtures/test-side-effects-field-glob
+        version: file:rolldown/packages/rolldown/tests/package-fixtures/test-side-effects-field-glob
+      '@types/node':
+        specifier: 'catalog:'
+        version: 24.10.3
+      source-map-js:
+        specifier: ^1.2.1
+        version: 1.2.1
+      tsx:
+        specifier: 'catalog:'
+        version: 4.23.12
+
+  rolldown/packages/rolldown/tests/fixtures/resolve/issue-5846:
+    dependencies:
+      rolldown-tests:
+        specifier: workspace:*
+        version: link:../../..
+
+  rolldown/packages/rolldown/tests/fixtures/resolve/issue-5846-2:
+    dependencies:
+      rolldown-tests:
+        specifier: workspace:*
+        version: link:../../..
+
+  rolldown/packages/rolldown/tests/fixtures/tree-shake/module-side-effects-precedence/hook-side-effects-overrides-package-json:
+    dependencies:
+      rolldown-tests:
+        specifier: workspace:*
+        version: link:../../../..
+
+  rolldown/packages/rolldown/tests/fixtures/tree-shake/module-side-effects-precedence/option-over-package-json:
+    dependencies:
+      rolldown-tests:
+        specifier: workspace:*
+        version: link:../../../..
+
   rolldown/packages/test-dev-server:
     dependencies:
       '@types/ws':
@@ -862,6 +944,34 @@ importers:
         specifier: 'catalog:'
         version: 2.2.0
 
+  rolldown/packages/test-dev-server/tests:
+    dependencies:
+      '@rolldown/test-dev-server':
+        specifier: workspace:*
+        version: link:..
+      execa:
+        specifier: ^9.2.0
+        version: 9.6.1
+      fast-glob:
+        specifier: 'catalog:'
+        version: 3.3.3
+      kill-port:
+        specifier: ^1.6.1
+        version: 1.6.1
+      rimraf:
+        specifier: ^6.0.1
+        version: 6.1.3
+      vitest:
+        specifier: 'catalog:'
+        version: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      ws:
+        specifier: 'catalog:'
+        version: 8.21.1
+    devDependencies:
+      playwright:
+        specifier: ^1.62.0
+        version: 1.62.1
+
   rolldown/packages/vite-tests:
     devDependencies:
       '@oxc-node/cli':
@@ -964,8 +1074,8 @@ importers:
         specifier: workspace:@voidzero-dev/vite-plus-core@*
         version: link:../packages/core
       vitest:
-        specifier: ^4.1.10
-        version: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.13.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+        specifier: 5.0.0
+        version: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.13.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
 
   vite/packages/create-vite:
     devDependencies:
@@ -1119,8 +1229,8 @@ importers:
         specifier: ^0.4.12
         version: 0.4.12(crossws@0.4.10(srvx@0.12.7))(srvx@0.12.7)(typescript@6.0.3)(valibot@1.4.2(typescript@6.0.3))(vite@packages+core)
       '@vitest/utils':
-        specifier: 4.1.10
-        version: 4.1.10
+        specifier: 5.0.0
+        version: 5.0.0
       '@voidzero-dev/vite-task-client':
         specifier: ^0.2.0
         version: 0.2.0
@@ -1258,6 +1368,143 @@ importers:
         specifier: ~2.3.3
         version: 2.3.3
 
+  vite/packages/vite/src/node/__tests__:
+    dependencies:
+      '@vitejs/cjs-ssr-dep':
+        specifier: link:./fixtures/cjs-ssr-dep
+        version: link:fixtures/cjs-ssr-dep
+      '@vitejs/parent':
+        specifier: link:./packages/parent
+        version: link:packages/parent
+      '@vitejs/test-dep-conditions':
+        specifier: file:./fixtures/test-dep-conditions
+        version: file:vite/packages/vite/src/node/__tests__/fixtures/test-dep-conditions
+      vue:
+        specifier: ^3.5.18
+        version: 3.5.40(typescript@6.0.3)
+
+  vite/packages/vite/src/node/__tests__/fixtures/cjs-ssr-dep: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/cjs-module-vars-in-esm: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/entry:
+    dependencies:
+      '@vite/test-config-plugin-module-condition':
+        specifier: link:../plugin-module-condition
+        version: link:../plugin-module-condition
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/import-meta: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/native-compat: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/native-compat/esm-in-commonjs-pkg: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/native-compat/mts-config: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/native-import: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/plugin-module-condition: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/shebang: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/shebang-crlf: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/config/siblings:
+    devDependencies:
+      '@types/lodash':
+        specifier: ^4.17.16
+        version: 4.17.21
+      lodash:
+        specifier: ^4.17.21
+        version: 4.17.21
+
+  vite/packages/vite/src/node/__tests__/fixtures/file-url: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/scan-subpath-import-glob: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/test-dep-conditions: {}
+
+  vite/packages/vite/src/node/__tests__/fixtures/watch-rebuild-manifest: {}
+
+  vite/packages/vite/src/node/__tests__/packages: {}
+
+  vite/packages/vite/src/node/__tests__/packages/child: {}
+
+  vite/packages/vite/src/node/__tests__/packages/module: {}
+
+  vite/packages/vite/src/node/__tests__/packages/name: {}
+
+  vite/packages/vite/src/node/__tests__/packages/noname: {}
+
+  vite/packages/vite/src/node/__tests__/packages/parent:
+    dependencies:
+      '@vitejs/child':
+        specifier: link:../child
+        version: link:../child
+
+  vite/packages/vite/src/node/__tests__/plugins/fixtures/license:
+    dependencies:
+      '@vitejs/test-dep-licence-cc0':
+        specifier: file:./dep-licence-cc0
+        version: file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-licence-cc0
+      '@vitejs/test-dep-license-mit':
+        specifier: file:./dep-license-mit
+        version: file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-license-mit
+
+  vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-licence-cc0: {}
+
+  vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-license-mit:
+    dependencies:
+      '@vitejs/test-dep-nested-license-isc':
+        specifier: file:../dep-nested-license-isc
+        version: file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-nested-license-isc
+
+  vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-nested-license-isc: {}
+
+  vite/packages/vite/src/node/server/__tests__/fixtures/deno/nested: {}
+
+  vite/packages/vite/src/node/server/__tests__/fixtures/lerna/nested: {}
+
+  vite/packages/vite/src/node/server/__tests__/fixtures/none/nested: {}
+
+  vite/packages/vite/src/node/server/__tests__/fixtures/pnpm: {}
+
+  vite/packages/vite/src/node/server/__tests__/fixtures/pnpm/nested: {}
+
+  vite/packages/vite/src/node/server/__tests__/fixtures/watcher: {}
+
+  vite/packages/vite/src/node/server/__tests__/fixtures/yarn: {}
+
+  vite/packages/vite/src/node/server/__tests__/fixtures/yarn/nested: {}
+
+  vite/packages/vite/src/node/ssr/runtime/__tests__:
+    dependencies:
+      '@vitejs/cjs-external':
+        specifier: link:./fixtures/cjs-external
+        version: link:fixtures/cjs-external
+      '@vitejs/esm-external':
+        specifier: link:./fixtures/esm-external
+        version: link:fixtures/esm-external
+      birpc:
+        specifier: ^0.2.19
+        version: 0.2.19
+      test-dep-invalid-exports:
+        specifier: file:./fixtures/invalid-package/deps/test-dep-invalid-exports
+        version: file:vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/invalid-package/deps/test-dep-invalid-exports
+      tinyspy:
+        specifier: 2.2.0
+        version: 2.2.0
+
+  vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/cjs-external: {}
+
+  vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/cyclic2: {}
+
+  vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/esm-external: {}
+
+  vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/invalid-package/deps/test-dep-invalid-exports: {}
+
+  vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/live-binding: {}
+
 packages:
 
   '@acemir/cssom@0.9.24':
@@ -1869,8 +2116,8 @@ packages:
     resolution: {integrity: sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==}
     engines: {node: '>=6.9.0'}
 
-  '@blazediff/core@1.9.1':
-    resolution: {integrity: sha512-ehg3jIkYKulZh+8om/O25vkvSsXXwC+skXmyA87FFx6A/45eqOkZsBltMw/TVteb0mloiGT8oGRTcjRAz66zaA==}
+  '@blazediff/core@1.10.0':
+    resolution: {integrity: sha512-AOQff0zgR7cGsZL+4E7hVkmujoPUpm0J9xzWGWZj5wCjd3gmxESXAPfKyuzs93VdpQNFhHlBhfOjrcZ+XTERtQ==}
 
   '@braidai/lang@1.1.2':
     resolution: {integrity: sha512-qBcknbBufNHlui137Hft8xauQMTZDKdophmLFv05r2eNmdIv/MlPuP4TdUknHG68UdWLgVZwgxVe735HzJNIwA==}
@@ -3013,6 +3260,18 @@ packages:
   '@nkzw/safe-word-list@3.1.0':
     resolution: {integrity: sha512-yU6NAne/aU8n4BnYwlOu451PD/FH9AVKsOsQbITxAPYg4HEcBMv7v13woPOpxAS0lC87N2TOQdBZ7OjiK+5sIA==}
 
+  '@nodelib/fs.scandir@2.1.5':
+    resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
+    engines: {node: '>= 8'}
+
+  '@nodelib/fs.stat@2.0.5':
+    resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==}
+    engines: {node: '>= 8'}
+
+  '@nodelib/fs.walk@1.2.8':
+    resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
+    engines: {node: '>= 8'}
+
   '@octokit/app@16.1.2':
     resolution: {integrity: sha512-8j7sEpUYVj18dxvh0KWj6W/l6uAiVRBl1JBDVRqH1VHKAO/G5eRVl4yEoYACjakWers1DjUkcCHyJNQK47JqyQ==}
     engines: {node: '>= 20'}
@@ -4106,6 +4365,9 @@ packages:
   '@rolldown/pluginutils@1.0.1':
     resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==}
 
+  '@rolldown/test-side-effects-field-glob@file:rolldown/packages/rolldown/tests/package-fixtures/test-side-effects-field-glob':
+    resolution: {directory: rolldown/packages/rolldown/tests/package-fixtures/test-side-effects-field-glob, type: directory}
+
   '@rollup/plugin-alias@6.0.0':
     resolution: {integrity: sha512-tPCzJOtS7uuVZd+xPhoy5W4vThe6KWXNmsFCNktaAh5RTqcLiSfT4huPQIXkgJ6YCOjJHvecOAzQxLFhPxKr+g==}
     engines: {node: '>=20.19.0'}
@@ -4319,8 +4581,8 @@ packages:
     resolution: {integrity: sha512-o4PXJQidqJl82ckFaXUeoAW+XysPLauYI43Abki5hABd853iMhitooc6znOnczgbTYmEP6U6/y1ZyKAIsvMKGg==}
     engines: {node: '>=18'}
 
-  '@testing-library/user-event@14.6.1':
-    resolution: {integrity: sha512-vq7fv0rnt+QTXgPxr5Hjc210p6YKq2kmdziLgnsZGgLJ9e6VAShx1pACLuRjd/AS/sr7phAR58OIIpf0LlmQNw==}
+  '@testing-library/user-event@14.6.7':
+    resolution: {integrity: sha512-MPCpX8bxe8zS+JmmTwLp8jd0dy1rAm60Te/SL8JrQM3qvQJcBOs1d7IefJMyZzqM3EWBrDn/LWDt1BCGu4ASfg==}
     engines: {node: '>=12', npm: '>=6'}
     peerDependencies:
       '@testing-library/dom': '>=7.21.4'
@@ -4771,33 +5033,43 @@ packages:
   '@vitejs/release-scripts@1.9.2':
     resolution: {integrity: sha512-MIvAic70ulFycMdhJiXLBQS8xcsjOcD2kZMtYzPYPfWI+2ruhEzFYbAbdFLUZ82zXGReqQBRn04tWfS4as63+g==}
 
-  '@vitest/browser-playwright@4.1.11':
-    resolution: {integrity: sha512-riLBxPqwnJ0lWs2DN2WeUfYeKLoAjbP2Xx8cLQdSddzMi20sksIa6K2mPz79DyMZKKVKH2ksOC2yJvtNcZg8cg==}
+  '@vitejs/test-dep-conditions@file:vite/packages/vite/src/node/__tests__/fixtures/test-dep-conditions':
+    resolution: {directory: vite/packages/vite/src/node/__tests__/fixtures/test-dep-conditions, type: directory}
+
+  '@vitejs/test-dep-licence-cc0@file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-licence-cc0':
+    resolution: {directory: vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-licence-cc0, type: directory}
+
+  '@vitejs/test-dep-license-mit@file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-license-mit':
+    resolution: {directory: vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-license-mit, type: directory}
+
+  '@vitejs/test-dep-nested-license-isc@file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-nested-license-isc':
+    resolution: {directory: vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-nested-license-isc, type: directory}
+
+  '@vitest/browser-playwright@5.0.0':
+    resolution: {integrity: sha512-N+gED9y4/8pypaHjz/x0ah3CjoBr+N0hWWT+Gq4VXtMzyB+rUIdHni0ulzpD1j4H77iWy5Jg8PRMlVn6kjxo6g==}
     peerDependencies:
       playwright: '*'
-      vitest: 4.1.11
+      vitest: 5.0.0
 
-  '@vitest/browser-preview@4.1.11':
-    resolution: {integrity: sha512-iPKSE6Ibayey6HFgK1V1/aHgyhx7HSRk1YMi+lnBZGmlIiNV5Uc7xRkD9Su8RDylTxDECK23t7kTHdRKoqSYDQ==}
+  '@vitest/browser-preview@5.0.0':
+    resolution: {integrity: sha512-16jOg+O7J1iEUvuXLxHvQmYeHaUMVrAZ4HEqkwdJb2yO8xRJZKuRbNno7dKuI90i63ThoGwCswuSAG7vC76xFQ==}
     peerDependencies:
-      vitest: 4.1.11
+      vitest: 5.0.0
 
-  '@vitest/browser-webdriverio@4.1.11':
-    resolution: {integrity: sha512-utftie0XLjhATDCCRAaCZFVlosjQX6mF8UK+mo0q2yTn+XASUdz21tqvAA6fYRgLDiHAIVI06cBaKAklRp4UVA==}
+  '@vitest/browser-webdriverio@5.0.0-rc.1':
+    resolution: {integrity: sha512-drDDPcIu4pMJgp4EwaAmEgcxMVF6SvFvspL+1UAS7nIvfwPyBdb3ERU1C6eufDZtxN7Yeh9Dsq5Flad9hlAJxQ==}
+    engines: {node: ^20.0.0 || ^22.0.0 || >=24.0.0}
     peerDependencies:
-      vitest: 4.1.11
+      vitest: ^5.0.0-beta.5
       webdriverio: '*'
 
-  '@vitest/browser@4.1.11':
-    resolution: {integrity: sha512-bwMovvAeuTFOK5kIFevw4VEf+1gVEICv4SYK4k3knJOxl6b1zEWud8mYKD73e1B0odAn174h1MofURy2TPWf3w==}
+  '@vitest/browser@5.0.0':
+    resolution: {integrity: sha512-JC9FG5xIRxPHXJPcdCaluIJcEoeM0IwGQ3xneuJk09LXKHRNs40BqWDWymQikbb20yOpYvzpKzmYgPRuSzKmvg==}
     peerDependencies:
-      vitest: 4.1.11
-
-  '@vitest/expect@4.1.11':
-    resolution: {integrity: sha512-VX2x5vNJXET47KAFzwERI+KRMtTTCSWTfSMKsW7JsUsXV4psq++e3DvZpuTDOpHcxytiDs6p2nhVb2tVDiiUYw==}
+      vitest: 5.0.0
 
-  '@vitest/mocker@4.1.11':
-    resolution: {integrity: sha512-2XJVD55d1o5AZous5CCGKS74g/riOj9odEt2bQpCVZeblHyHdnMeFl4jl0XjU21stf4mbjUkew2eXQZt65g5CQ==}
+  '@vitest/mocker@5.0.0':
+    resolution: {integrity: sha512-66PGTMIiVJP3t4a5yxU9qPtf7MdTBs8jmToMvy+HVflB3Yy13WJZTtPePdvU+wjRV02SKK5doLbSA6o9pwOmiA==}
     peerDependencies:
       msw: ^2.4.9
       vite: workspace:@voidzero-dev/vite-plus-core@*
@@ -4807,26 +5079,22 @@ packages:
       vite:
         optional: true
 
-  '@vitest/pretty-format@4.1.10':
-    resolution: {integrity: sha512-W1HsjSH4MXQ9YfmmhLAoIYf1HRfekQCGngeIgcei6MP5QQGWUe0gkopdZQaVCFO+JDJMrAJGwa5pRpNpvy4P8Q==}
+  '@vitest/pretty-format@5.0.0':
+    resolution: {integrity: sha512-PVRNuB3wpReb4SQEs4zTKM4KWFhQ5pw3spE8naoDJNB5T5aWRzGKHwXcLUllr0WeOTXpB6bSr3CJLo5+7XQSSQ==}
 
-  '@vitest/pretty-format@4.1.11':
-    resolution: {integrity: sha512-yiZzPbGTS9Sr/JpFl8zHrcIkAofNbFV6k21vIgQN/cY/oxZeXhJv5sc/MBJ5jFKWmWs+oJHw0UXLZjmf931+Vw==}
+  '@vitest/snapshot@5.0.0':
+    resolution: {integrity: sha512-zBKUvF6pBae3YO8dSqAvZAReIGIx3ZEgPIcsD/wsQHayulUX46YqSDvLzDqTYuZxBQV1/0AOGgmqHF/NzTvFnA==}
 
-  '@vitest/runner@4.1.11':
-    resolution: {integrity: sha512-LztvUgdwMNJMIkj3hQnnxiC2Xy1zNxq928W/xhjCLaNCzqTZOudjwbQf6v9IntZGPw132i2Lq2rgTRZHD3JHNw==}
+  '@vitest/spy@5.0.0':
+    resolution: {integrity: sha512-uy+luWBAPw9XfthoHi5AkfHUnuPYEESjl0p/r+meoBnU8bxg5GDQ3Ey8MjcJ6sqahkL4PFyrvfMJJBw7LbU06g==}
 
-  '@vitest/snapshot@4.1.11':
-    resolution: {integrity: sha512-pN7ikn1ON7h8ee4gIAp4AzyK+zBtJPzVbqOgu5LCEh4VaJVbPQcgYQYJIMGQPXVeJJq1fnfazis7a5pFNPahog==}
-
-  '@vitest/spy@4.1.11':
-    resolution: {integrity: sha512-apNa/prQy2qCeywhnixOHPRCgGNhvg7T4Dapfl1GahLp/R+uhBm5cPyFoNVyqsNd2h1nJxL6BqqdIjiABL60YA==}
-
-  '@vitest/utils@4.1.10':
-    resolution: {integrity: sha512-fy9am/HWxbaGt/Sawrp90vt6Y6jQwf1RX77cz3uwoJwJVMli/e1IEwRPnMNJ7vKfPTwo0diXifkpPvwH9v7nGA==}
+  '@vitest/ui@5.0.0':
+    resolution: {integrity: sha512-h2FIFwggCY2GxUd2UdQoYNVQkOIqEQLPhNREcl3FUiRsdzQep7NWwYbSmhGEA9nFLPDq5pXzRMcBZQU8Py83sg==}
+    peerDependencies:
+      vitest: 5.0.0
 
-  '@vitest/utils@4.1.11':
-    resolution: {integrity: sha512-zTCVGpyFsGWBhllOyKlTw/vnr6D9qxsfSDyfbyZmTyjHw5N/VuvzHpHoQjm2ZJzn4RJgx5w4r7V0er69CmLgPQ==}
+  '@vitest/utils@5.0.0':
+    resolution: {integrity: sha512-dO++xL3vDfvhTAVimfkuQUA3k+JClIF1i1vAkPqpcGAthRmeWnXmHB7YPViPvgCwviX8u7Y5W1u2N//AaQr3fw==}
 
   '@voidzero-dev/vite-task-client@0.2.0':
     resolution: {integrity: sha512-y932hw4I0qrdlqbDhOC4VS7mtLad+MtXToSVJIZ79Cd7Ib6p4bRuoTRrx6OeedhdPm2yf9+r8ndlhJjn8LbsxQ==}
@@ -5516,6 +5784,9 @@ packages:
     engines: {node: '>=18'}
     hasBin: true
 
+  birpc@0.2.19:
+    resolution: {integrity: sha512-5WeXXAvTmitV1RqJFppT5QtUiz2p1mRSYU000Jkft5ZUCLJIk4uQriYNO50HknxKwM6jd8utNc66K1qGIwwWBQ==}
+
   birpc@2.9.0:
     resolution: {integrity: sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw==}
 
@@ -6057,6 +6328,9 @@ packages:
   es-module-lexer@2.3.1:
     resolution: {integrity: sha512-shc1dbU90Yl/xq1QrC7QRtfcwURZuVRfPhZbDoldJ1cn1gzDvBaBWlv0eFolj5+0znnPJz5TXLxsN77X/12KTA==}
 
+  es-module-lexer@2.3.2:
+    resolution: {integrity: sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw==}
+
   es-toolkit@1.47.1:
     resolution: {integrity: sha512-5RAqEwf4P4E17p+W75KLOWw/nOvKZzSQpxM32IpI2KZLaVonjTrZ0Ai5ghMaVI9eKC2p8eoQgcBdkEDgzFk6+Q==}
 
@@ -6223,8 +6497,8 @@ packages:
     resolution: {integrity: sha512-9Be3ZoN4LmYR90tUoVu2te2BsbzHfhJyfEiAVfz7N5/zv+jduIfLrV2xdQXOHbaD6KgpGdO9PRPM1Y4Q9QkPkA==}
     engines: {node: ^18.19.0 || >=20.5.0}
 
-  expect-type@1.3.0:
-    resolution: {integrity: sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==}
+  expect-type@1.4.0:
+    resolution: {integrity: sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==}
     engines: {node: '>=12.0.0'}
 
   exsolve@1.0.8:
@@ -6247,6 +6521,10 @@ packages:
   fast-fifo@1.3.2:
     resolution: {integrity: sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==}
 
+  fast-glob@3.3.3:
+    resolution: {integrity: sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==}
+    engines: {node: '>=8.6.0'}
+
   fast-json-stable-stringify@2.1.0:
     resolution: {integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==}
 
@@ -6272,6 +6550,9 @@ packages:
     resolution: {integrity: sha512-n8v8b6p4Z1sMgqRmqLJm3awW4NX7NkaKPfb3uJIBTSH7Pdvufi3PQ3/lJLQrvxcMYl7JI2jnDO90siPEpD8JBA==}
     hasBin: true
 
+  fastq@1.20.3:
+    resolution: {integrity: sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==}
+
   fd-package-json@2.0.0:
     resolution: {integrity: sha512-jKmm9YtsNXN789RS/0mSzOC1NUq9mkVd65vbSSVsKdjGvYXBuE4oWe2QOEoFeRmJg+lPuZxpmrfFclNhoRMneQ==}
 
@@ -6291,8 +6572,8 @@ packages:
     resolution: {integrity: sha512-7yAQpD2UMJzLi1Dqv7qFYnPbaPx7ZfFK6PiIxQ4PfkGPyNyl2Ugx+a/umUonmKqjhM4DnfbMvdX6otXq83soQQ==}
     engines: {node: ^12.20 || >= 14.13}
 
-  fflate@0.8.2:
-    resolution: {integrity: sha512-cPJU47OaAoCbg0pBvzsgpTPhmhqI5eJjh/JIu8tPj5q+T7iLvW/JAYUqmE7KOB4R1ZyEhzBaIQpQpardBF5z8A==}
+  fflate@0.8.3:
+    resolution: {integrity: sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==}
 
   figures@6.1.0:
     resolution: {integrity: sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg==}
@@ -6325,6 +6606,9 @@ packages:
   flatted@3.4.2:
     resolution: {integrity: sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==}
 
+  flatted@3.4.4:
+    resolution: {integrity: sha512-5+ybhBZANEJxaH3X5evAFatUxLfEHSr7n6kYJ+1Qd0mUqr4eu9gIf6GDbWHf8RJijHrjjO8G+la14SlL2SeS1Q==}
+
   follow-redirects@1.16.0:
     resolution: {integrity: sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==}
     engines: {node: '>=4.0'}
@@ -6404,6 +6688,9 @@ packages:
     resolution: {integrity: sha512-kVCxPF3vQM/N0B1PmoqVUqgHP+EeVjmZSQn+1oCRPxd2P21P2F19lIgbR3HBosbB1PUhOAoctJnfEn2GbN2eZA==}
     engines: {node: '>=18'}
 
+  get-them-args@1.3.2:
+    resolution: {integrity: sha512-LRn8Jlk+DwZE4GTlDbT3Hikd1wSHgLMme/+7ddlqKd7ldwR6LjJgTVWzBnR01wnYGe4KgrXjg287RaI22UHmAw==}
+
   get-tsconfig@4.14.1:
     resolution: {integrity: sha512-Dz/6HxkrxgNehhxLVeyv8sad9UzF2xBVeaKBQNDfJ5XiSXmp2gTR0eO0RWiT2NCKS5aGP9jjkOMggTN90qU50A==}
 
@@ -6442,6 +6729,10 @@ packages:
     resolution: {integrity: sha512-tvZgpqk6fz4BaNZ66ZsRaZnbHvP/jG3uKJvAZOwEVUL4RTA5nJeeLYfyN9/VA8NX/V3IBG+hkeuGpKjvELkVhA==}
     engines: {node: 20 || >=22}
 
+  glob@13.0.6:
+    resolution: {integrity: sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==}
+    engines: {node: 18 || 20 || >=22}
+
   globals@14.0.0:
     resolution: {integrity: sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==}
     engines: {node: '>=18'}
@@ -6763,6 +7054,10 @@ packages:
   keyv@4.5.4:
     resolution: {integrity: sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==}
 
+  kill-port@1.6.1:
+    resolution: {integrity: sha512-un0Y55cOM7JKGaLnGja28T38tDDop0AQ8N0KlAdyh+B1nmMoX8AnNmqPNZbS3mUMgiST51DCVqmbFT1gNJpVNw==}
+    hasBin: true
+
   kleur@3.0.3:
     resolution: {integrity: sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==}
     engines: {node: '>=6'}
@@ -6961,6 +7256,9 @@ packages:
   magic-string@1.2.1:
     resolution: {integrity: sha512-vCfXkt3lIJha02CjPT1igeysyHVfCsEpIeD20O+X9aJ2hML3/kKx8E9Iv1FB+aMSAlDOEAtpRWzuooQCrYwdUg==}
 
+  magic-string@1.2.3:
+    resolution: {integrity: sha512-Bpb0W2TbLKOZ7vJnOUnVRGq3WL2p+ISV29M6hYPL1AFCpyKZpdr5ytiXoTSSxRVhg8YW7f65+6gbG8WG6PCa/g==}
+
   make-dir@2.1.0:
     resolution: {integrity: sha512-LS9X+dc8KLxXCb8dni79fLIIUA5VyZoyjSMCwTluaXA0o27cCK0bhXkpgw+sTXVpPy/lSO57ilRixqk0vDmtRA==}
     engines: {node: '>=6'}
@@ -6972,6 +7270,10 @@ packages:
     resolution: {integrity: sha512-pxQJQzB6djGPXh08dacEloMFopsOqGVRKFPYvPOt9XDZ1HasbgDZA74CJGreSU4G3Ak7EFJGoiH2auq+yXISgA==}
     engines: {node: '>=18'}
 
+  merge2@1.4.1:
+    resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==}
+    engines: {node: '>= 8'}
+
   micromatch@4.0.8:
     resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
     engines: {node: '>=8.6'}
@@ -7012,6 +7314,10 @@ packages:
     resolution: {integrity: sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==}
     engines: {node: '>=16 || 14 >=14.17'}
 
+  minipass@7.1.3:
+    resolution: {integrity: sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==}
+    engines: {node: '>=16 || 14 >=14.17'}
+
   mitt@3.0.1:
     resolution: {integrity: sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==}
 
@@ -7307,6 +7613,10 @@ packages:
     resolution: {integrity: sha512-oWyT4gICAu+kaA7QWk/jvCHWarMKNs6pXOGWKDTr7cw4IGcUbW+PeTfbaQiLGheFRpjo6O9J0PmyMfQPjH71oA==}
     engines: {node: 20 || >=22}
 
+  path-scurry@2.0.2:
+    resolution: {integrity: sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==}
+    engines: {node: 18 || 20 || >=22}
+
   pathe@2.0.3:
     resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
 
@@ -7502,6 +7812,9 @@ packages:
   query-selector-shadow-dom@1.0.1:
     resolution: {integrity: sha512-lT5yCqEBgfoMYpf3F2xQRK7zEr1rhIIZuceDK6+xRkJQ4NMbHTwXqk4NkwDwQMNqXgG9r9fyHnzwNVs6zV5KRw==}
 
+  queue-microtask@1.2.3:
+    resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}
+
   range-parser@1.2.1:
     resolution: {integrity: sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==}
     engines: {node: '>= 0.6'}
@@ -7619,12 +7932,21 @@ packages:
     resolution: {integrity: sha512-I1XxrZSQ+oErkRR4jYbAyEEu2I0avBvvMM5JN+6EBprOGRCs63ENqZ3vjavq8fBw2+62G5LF5XelKwuJpcvcxw==}
     engines: {node: '>=10'}
 
+  reusify@1.1.0:
+    resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
+    engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
+
   rfdc@1.4.1:
     resolution: {integrity: sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==}
 
   rgb2hex@0.2.5:
     resolution: {integrity: sha512-22MOP1Rh7sAo1BZpDG6R5RFYzR2lYEgwq7HEmyW2qcsOqR2lQKmn+O//xV3YG/0rrhMC6KVX2hU+ZXuaw9a5bw==}
 
+  rimraf@6.1.3:
+    resolution: {integrity: sha512-LKg+Cr2ZF61fkcaK1UdkH2yEBBKnYjTyWzTJT6KNPcSPaiT7HSdhtMXQuN5wkTX0Xu72KQ1l8S42rlmexS2hSA==}
+    engines: {node: 20 || >=22}
+    hasBin: true
+
   rolldown-plugin-dts@0.27.13:
     resolution: {integrity: sha512-DeVZJbbB0ajp5q6vABqC8ZCJzxftlxbiV60Bk96GFdQaysGVpgTTVjQu0lUt4Lb+aRCtejfOixtQKDRol7IuVQ==}
     engines: {node: ^22.18.0 || >=24.11.0}
@@ -7703,6 +8025,9 @@ packages:
     resolution: {integrity: sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==}
     engines: {node: '>=18'}
 
+  run-parallel@1.2.0:
+    resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}
+
   rxjs@7.8.2:
     resolution: {integrity: sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA==}
 
@@ -7909,6 +8234,9 @@ packages:
     resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==}
     engines: {node: '>=8'}
 
+  shell-exec@1.0.2:
+    resolution: {integrity: sha512-jyVd+kU2X+mWKMmGhx4fpWbPsjvD53k9ivqetutVW/BQ+WIZoDoP4d8vUMGezV6saZsiNoW2f9GIhg9Dondohg==}
+
   shell-quote@1.8.4:
     resolution: {integrity: sha512-VsC6n6vz1ihYYyZZwX7YZSF5l5x36ca17OC+a69h94YqB7X6XLwf+5MOgynYir2SLFUbl8gIYvBo8K8RoNQ6bQ==}
     engines: {node: '>= 0.4'}
@@ -8038,8 +8366,8 @@ packages:
     resolution: {integrity: sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==}
     engines: {node: '>= 0.8'}
 
-  std-env@4.0.0:
-    resolution: {integrity: sha512-zUMPtQ/HBY3/50VbpkupYHbRroTRZJPRLvreamgErJVys0ceuzMkD44J/QjqhHjOzK42GQ3QZIeFG1OYfOtKqQ==}
+  std-env@4.2.0:
+    resolution: {integrity: sha512-oCUKSupKTHX53EyjDtuZQ64pjLJ6yYCtpmEw0goYxtjG9KpbRe8KAsl2tBUGU9DyMcJ0RwJ8GqJAFzMXcXW1Rw==}
 
   streamx@2.23.0:
     resolution: {integrity: sha512-kn+e44esVfn2Fa/O0CPFcex27fjIL6MkVae0Mm6q+E6f0hWv578YCERbv+4m02cjxvDsPKLnmxral/rR6lBMAg==}
@@ -8155,20 +8483,28 @@ packages:
     engines: {node: '>=10'}
     hasBin: true
 
+  test-dep-invalid-exports@file:vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/invalid-package/deps/test-dep-invalid-exports:
+    resolution: {directory: vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/invalid-package/deps/test-dep-invalid-exports, type: directory}
+
   text-decoder@1.2.3:
     resolution: {integrity: sha512-3/o9z3X0X0fTupwsYvR03pJ/DjWuqqrfwBgTQzdWDiQSm9KitAyz/9WqsT2JQW7KV2m+bC2ol/zqpW37NHxLaA==}
 
-  tinybench@2.9.0:
-    resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==}
-
   tinybench@6.0.0:
     resolution: {integrity: sha512-BWlWpVbbZXaYjRV0twGLNQO00Zj4HA/sjLOQP2IvzQqGwRGp+2kh7UU3ijyJ3ywFRogYDRbiHDMrUOfaMnN56g==}
     engines: {node: '>=20.0.0'}
 
+  tinybench@6.1.4:
+    resolution: {integrity: sha512-9APumHG7r4yOk4X4WlkmE71aZcv1gvin1czO3OQ1U9iJcFA5Ja/ygyb0vPOVHTthFozUYs8CLoLUlM8grb2lTQ==}
+    engines: {node: '>=20.0.0'}
+
   tinyexec@1.2.4:
     resolution: {integrity: sha512-SHf/r48b7vOrjve9PxJo3MN5v5yuyjHvdUcrQffT3WXMUfnGmHDVbC4k3sHJaJTgZCwpUplIaAo5ANtMyp3YHg==}
     engines: {node: '>=18'}
 
+  tinyexec@1.3.0:
+    resolution: {integrity: sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==}
+    engines: {node: '>=18'}
+
   tinyexec@1.3.1:
     resolution: {integrity: sha512-GCvB3aoys96IuDFBMcTB46JOR6mdMtAToqwiW8JlWhsoh1mhHi/xn9ss/Dg7N555GiJyEt2qzoG/NHCwM6h1EA==}
     engines: {node: '>=18'}
@@ -8181,8 +8517,12 @@ packages:
     resolution: {integrity: sha512-Pugqs6M0m7Lv1I7FtxN4aoyToKg1C4tu+/381vH35y8oENM/Ai7f7C4StcoK4/+BSw9ebcS8jRiVrORFKCALLw==}
     engines: {node: ^20.0.0 || >=22.0.0}
 
-  tinyrainbow@3.1.0:
-    resolution: {integrity: sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==}
+  tinyrainbow@3.1.1:
+    resolution: {integrity: sha512-yau8yJdTt989Mm0Bd/236QnzEiPf2xLLTqUZRUJOo/3CB078LSwzei343DgtJVmfJKJE3TMINY1u42SQsP6mXw==}
+    engines: {node: '>=14.0.0'}
+
+  tinyspy@2.2.0:
+    resolution: {integrity: sha512-d2eda04AN/cPOR89F7Xv5bK/jrQEhmcLFe6HFldoeO9AJtps+fqEnh486vnT/8y4bw38pSyxDcTCAq+Ks2aJTg==}
     engines: {node: '>=14.0.0'}
 
   tldts-core@7.0.19:
@@ -8515,20 +8855,20 @@ packages:
     resolution: {integrity: sha512-sXMwN6DMHeouPfCxkxWkKAmxphWKEenHYY5H1nIBzU3PmDsmJp6kBXJdshjVdpMZuWCmL9SH7KFRx29AylpP6g==}
     engines: {node: '>=18.12.0'}
 
-  vitest@4.1.11:
-    resolution: {integrity: sha512-fhACrNXUidIbGSBr5FlbuBkO7VWC1ZyLl0DO4CU2DrQoAPxX84Ysxs+HeGQpii5lZWV1Q4gBZTTu49mF+A6Edw==}
-    engines: {node: ^20.0.0 || ^22.0.0 || >=24.0.0}
+  vitest@5.0.0:
+    resolution: {integrity: sha512-gpsMNoRhMjMktVxPtstOH4/PJuPyovVaMDr4oDilXaGH1EcqM2OE96SoHT2VIQ6fTGtTjqmHDrEu2X9RQiXf8Q==}
+    engines: {node: ^22.12.0 || ^24.0.0 || >=26.0.0}
     hasBin: true
     peerDependencies:
       '@edge-runtime/vm': '*'
       '@opentelemetry/api': ^1.9.0
-      '@types/node': ^20.0.0 || ^22.0.0 || >=24.0.0
-      '@vitest/browser-playwright': 4.1.11
-      '@vitest/browser-preview': 4.1.11
-      '@vitest/browser-webdriverio': 4.1.11
-      '@vitest/coverage-istanbul': 4.1.11
-      '@vitest/coverage-v8': 4.1.11
-      '@vitest/ui': 4.1.11
+      '@types/node': ^22.0.0 || >=24.0.0
+      '@vitest/browser-playwright': 5.0.0
+      '@vitest/browser-preview': 5.0.0
+      '@vitest/browser-webdriverio': ^5.0.0-beta.5 || >=5.0.0
+      '@vitest/coverage-istanbul': 5.0.0
+      '@vitest/coverage-v8': 5.0.0
+      '@vitest/ui': 5.0.0
       happy-dom: '*'
       jsdom: '*'
       vite: workspace:@voidzero-dev/vite-plus-core@*
@@ -8802,7 +9142,7 @@ snapshots:
       '@andrewbranch/untar.js': 1.0.3
       '@loaderkit/resolve': 1.0.4
       cjs-module-lexer: 1.4.3
-      fflate: 0.8.2
+      fflate: 0.8.3
       lru-cache: 11.2.7
       semver: 7.8.5
       typescript: 5.6.1-rc
@@ -9563,7 +9903,7 @@ snapshots:
       '@babel/helper-string-parser': 7.29.7
       '@babel/helper-validator-identifier': 7.29.7
 
-  '@blazediff/core@1.9.1': {}
+  '@blazediff/core@1.10.0': {}
 
   '@braidai/lang@1.1.2': {}
 
@@ -10633,6 +10973,18 @@ snapshots:
 
   '@nkzw/safe-word-list@3.1.0': {}
 
+  '@nodelib/fs.scandir@2.1.5':
+    dependencies:
+      '@nodelib/fs.stat': 2.0.5
+      run-parallel: 1.2.0
+
+  '@nodelib/fs.stat@2.0.5': {}
+
+  '@nodelib/fs.walk@1.2.8':
+    dependencies:
+      '@nodelib/fs.scandir': 2.1.5
+      fastq: 1.20.3
+
   '@octokit/app@16.1.2':
     dependencies:
       '@octokit/auth-app': 8.1.2
@@ -11344,6 +11696,8 @@ snapshots:
 
   '@rolldown/pluginutils@1.0.1': {}
 
+  '@rolldown/test-side-effects-field-glob@file:rolldown/packages/rolldown/tests/package-fixtures/test-side-effects-field-glob': {}
+
   '@rollup/plugin-alias@6.0.0(rollup@4.63.1)':
     optionalDependencies:
       rollup: 4.63.1
@@ -11494,7 +11848,7 @@ snapshots:
       picocolors: 1.1.1
       pretty-format: 27.5.1
 
-  '@testing-library/user-event@14.6.1(@testing-library/dom@10.4.1)':
+  '@testing-library/user-event@14.6.7(@testing-library/dom@10.4.1)':
     dependencies:
       '@testing-library/dom': 10.4.1
 
@@ -11963,35 +12317,45 @@ snapshots:
       semver: 7.8.5
       tinyexec: 1.3.1
 
-  '@vitest/browser-playwright@4.1.11(playwright@1.62.1)(vite@packages+core)(vitest@4.1.11)':
+  '@vitejs/test-dep-conditions@file:vite/packages/vite/src/node/__tests__/fixtures/test-dep-conditions': {}
+
+  '@vitejs/test-dep-licence-cc0@file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-licence-cc0': {}
+
+  '@vitejs/test-dep-license-mit@file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-license-mit':
     dependencies:
-      '@vitest/browser': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      '@vitest/mocker': 4.1.11(vite@packages+core)
+      '@vitejs/test-dep-nested-license-isc': file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-nested-license-isc
+
+  '@vitejs/test-dep-nested-license-isc@file:vite/packages/vite/src/node/__tests__/plugins/fixtures/license/dep-nested-license-isc': {}
+
+  '@vitest/browser-playwright@5.0.0(playwright@1.62.1)(vite@packages+core)(vitest@5.0.0)':
+    dependencies:
+      '@vitest/browser': 5.0.0(vite@packages+core)(vitest@5.0.0)
+      '@vitest/mocker': 5.0.0(vite@packages+core)
       playwright: 1.62.1
-      tinyrainbow: 3.1.0
-      vitest: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      tinyrainbow: 3.1.1
+      vitest: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
     transitivePeerDependencies:
       - bufferutil
       - msw
       - utf-8-validate
       - vite
 
-  '@vitest/browser-preview@4.1.11(vite@packages+core)(vitest@4.1.11)':
+  '@vitest/browser-preview@5.0.0(vite@packages+core)(vitest@5.0.0)':
     dependencies:
       '@testing-library/dom': 10.4.1
-      '@testing-library/user-event': 14.6.1(@testing-library/dom@10.4.1)
-      '@vitest/browser': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      vitest: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      '@testing-library/user-event': 14.6.7(@testing-library/dom@10.4.1)
+      '@vitest/browser': 5.0.0(vite@packages+core)(vitest@5.0.0)
+      vitest: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
     transitivePeerDependencies:
       - bufferutil
       - msw
       - utf-8-validate
       - vite
 
-  '@vitest/browser-webdriverio@4.1.11(vite@packages+core)(vitest@4.1.11)(webdriverio@9.20.1(supports-color@8.1.1))':
+  '@vitest/browser-webdriverio@5.0.0-rc.1(vite@packages+core)(vitest@5.0.0)(webdriverio@9.20.1(supports-color@8.1.1))':
     dependencies:
-      '@vitest/browser': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      vitest: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      '@vitest/browser': 5.0.0(vite@packages+core)(vitest@5.0.0)
+      vitest: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
       webdriverio: 9.20.1(supports-color@8.1.1)
     transitivePeerDependencies:
       - bufferutil
@@ -11999,16 +12363,17 @@ snapshots:
       - utf-8-validate
       - vite
 
-  '@vitest/browser@4.1.11(vite@packages+core)(vitest@4.1.11)':
+  '@vitest/browser@5.0.0(vite@packages+core)(vitest@5.0.0)':
     dependencies:
-      '@blazediff/core': 1.9.1
-      '@vitest/mocker': 4.1.11(vite@packages+core)
-      '@vitest/utils': 4.1.11
-      magic-string: 0.30.21
+      '@blazediff/core': 1.10.0
+      '@vitest/mocker': 5.0.0(vite@packages+core)
+      '@vitest/ui': 5.0.0(vitest@5.0.0)
+      '@vitest/utils': 5.0.0
+      magic-string: 1.2.3
       pngjs: 7.0.0
       sirv: 3.0.2(patch_hash=c07c56eb72faea34341d465cde2314e89db472106ed378181e3447893af6bf95)
-      tinyrainbow: 3.1.0
-      vitest: 4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
+      tinyrainbow: 3.1.1
+      vitest: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
       ws: 8.21.3
     transitivePeerDependencies:
       - bufferutil
@@ -12016,56 +12381,43 @@ snapshots:
       - utf-8-validate
       - vite
 
-  '@vitest/expect@4.1.11':
+  '@vitest/mocker@5.0.0(vite@packages+core)':
     dependencies:
-      '@standard-schema/spec': 1.1.0
-      '@types/chai': 5.2.3
-      '@vitest/spy': 4.1.11
-      '@vitest/utils': 4.1.11
-      chai: 6.2.2
-      tinyrainbow: 3.1.0
-
-  '@vitest/mocker@4.1.11(vite@packages+core)':
-    dependencies:
-      '@vitest/spy': 4.1.11
+      '@jridgewell/trace-mapping': 0.3.31
+      '@vitest/spy': 5.0.0
       estree-walker: 3.0.3
-      magic-string: 0.30.21
+      magic-string: 1.2.3
     optionalDependencies:
       vite: link:packages/core
 
-  '@vitest/pretty-format@4.1.10':
+  '@vitest/pretty-format@5.0.0':
     dependencies:
-      tinyrainbow: 3.1.0
+      tinyrainbow: 3.1.1
 
-  '@vitest/pretty-format@4.1.11':
+  '@vitest/snapshot@5.0.0':
     dependencies:
-      tinyrainbow: 3.1.0
-
-  '@vitest/runner@4.1.11':
-    dependencies:
-      '@vitest/utils': 4.1.11
-      pathe: 2.0.3
-
-  '@vitest/snapshot@4.1.11':
-    dependencies:
-      '@vitest/pretty-format': 4.1.11
-      '@vitest/utils': 4.1.11
-      magic-string: 0.30.21
+      '@vitest/pretty-format': 5.0.0
+      '@vitest/utils': 5.0.0
+      magic-string: 1.2.3
       pathe: 2.0.3
 
-  '@vitest/spy@4.1.11': {}
+  '@vitest/spy@5.0.0': {}
 
-  '@vitest/utils@4.1.10':
+  '@vitest/ui@5.0.0(vitest@5.0.0)':
     dependencies:
-      '@vitest/pretty-format': 4.1.10
-      convert-source-map: 2.0.0
-      tinyrainbow: 3.1.0
+      '@vitest/utils': 5.0.0
+      fflate: 0.8.3
+      flatted: 3.4.4
+      pathe: 2.0.3
+      sirv: 3.0.2(patch_hash=c07c56eb72faea34341d465cde2314e89db472106ed378181e3447893af6bf95)
+      tinyrainbow: 3.1.1
+      vitest: 5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core)
 
-  '@vitest/utils@4.1.11':
+  '@vitest/utils@5.0.0':
     dependencies:
-      '@vitest/pretty-format': 4.1.11
+      '@vitest/pretty-format': 5.0.0
       convert-source-map: 2.0.0
-      tinyrainbow: 3.1.0
+      tinyrainbow: 3.1.1
 
   '@voidzero-dev/vite-task-client@0.2.0': {}
 
@@ -12638,6 +12990,8 @@ snapshots:
       without-undefined-properties: 0.1.2
       zod: 3.25.76
 
+  birpc@0.2.19: {}
+
   birpc@2.9.0: {}
 
   birpc@4.1.0: {}
@@ -13133,6 +13487,8 @@ snapshots:
 
   es-module-lexer@2.3.1: {}
 
+  es-module-lexer@2.3.2: {}
+
   es-toolkit@1.47.1: {}
 
   esbuild@0.28.1:
@@ -13378,7 +13734,7 @@ snapshots:
       strip-final-newline: 4.0.0
       yoctocolors: 2.1.2
 
-  expect-type@1.3.0: {}
+  expect-type@1.4.0: {}
 
   exsolve@1.0.8: {}
 
@@ -13400,6 +13756,14 @@ snapshots:
 
   fast-fifo@1.3.2: {}
 
+  fast-glob@3.3.3:
+    dependencies:
+      '@nodelib/fs.stat': 2.0.5
+      '@nodelib/fs.walk': 1.2.8
+      glob-parent: 5.1.2
+      merge2: 1.4.1
+      micromatch: 4.0.8
+
   fast-json-stable-stringify@2.1.0: {}
 
   fast-levenshtein@2.0.6: {}
@@ -13424,6 +13788,10 @@ snapshots:
     dependencies:
       strnum: 2.1.1
 
+  fastq@1.20.3:
+    dependencies:
+      reusify: 1.1.0
+
   fd-package-json@2.0.0:
     dependencies:
       walk-up-path: 4.0.0
@@ -13445,7 +13813,7 @@ snapshots:
       node-domexception: 1.0.0
       web-streams-polyfill: 3.3.3
 
-  fflate@0.8.2: {}
+  fflate@0.8.3: {}
 
   figures@6.1.0:
     dependencies:
@@ -13485,6 +13853,8 @@ snapshots:
 
   flatted@3.4.2: {}
 
+  flatted@3.4.4: {}
+
   follow-redirects@1.16.0(debug@4.4.3(supports-color@8.1.1)):
     optionalDependencies:
       debug: 4.4.3(supports-color@8.1.1)
@@ -13553,6 +13923,8 @@ snapshots:
       '@sec-ant/readable-stream': 0.4.1
       is-stream: 4.0.1
 
+  get-them-args@1.3.2: {}
+
   get-tsconfig@4.14.1:
     dependencies:
       resolve-pkg-maps: 1.0.0
@@ -13605,6 +13977,12 @@ snapshots:
       minipass: 7.1.2
       path-scurry: 2.0.1
 
+  glob@13.0.6:
+    dependencies:
+      minimatch: 10.2.4
+      minipass: 7.1.3
+      path-scurry: 2.0.2
+
   globals@14.0.0: {}
 
   globals@15.15.0: {}
@@ -13890,6 +14268,11 @@ snapshots:
     dependencies:
       json-buffer: 3.0.1
 
+  kill-port@1.6.1:
+    dependencies:
+      get-them-args: 1.3.2
+      shell-exec: 1.0.2
+
   kleur@3.0.3: {}
 
   knip@6.32.2:
@@ -14089,6 +14472,10 @@ snapshots:
     dependencies:
       '@jridgewell/sourcemap-codec': 1.5.5
 
+  magic-string@1.2.3:
+    dependencies:
+      '@jridgewell/sourcemap-codec': 1.5.5
+
   make-dir@2.1.0:
     dependencies:
       pify: 4.0.1
@@ -14100,11 +14487,12 @@ snapshots:
 
   meow@13.2.0: {}
 
+  merge2@1.4.1: {}
+
   micromatch@4.0.8:
     dependencies:
       braces: 3.0.3
       picomatch: 2.3.1
-    optional: true
 
   mime-db@1.54.0: {}
 
@@ -14135,6 +14523,8 @@ snapshots:
 
   minipass@7.1.2: {}
 
+  minipass@7.1.3: {}
+
   mitt@3.0.1: {}
 
   mlly@1.8.2:
@@ -14526,6 +14916,11 @@ snapshots:
       lru-cache: 11.2.7
       minipass: 7.1.2
 
+  path-scurry@2.0.2:
+    dependencies:
+      lru-cache: 11.2.7
+      minipass: 7.1.2
+
   pathe@2.0.3: {}
 
   pend@1.2.0: {}
@@ -14706,6 +15101,8 @@ snapshots:
 
   query-selector-shadow-dom@1.0.1: {}
 
+  queue-microtask@1.2.3: {}
+
   range-parser@1.2.1: {}
 
   react-dom@19.2.0(react@19.2.0):
@@ -14829,10 +15226,17 @@ snapshots:
 
   ret@0.5.0: {}
 
+  reusify@1.1.0: {}
+
   rfdc@1.4.1: {}
 
   rgb2hex@0.2.5: {}
 
+  rimraf@6.1.3:
+    dependencies:
+      glob: 13.0.6
+      package-json-from-dist: 1.0.1
+
   rolldown-plugin-dts@0.27.13(@typescript/native-preview@7.0.0-dev.20260605.1)(oxc-resolver@11.24.2)(rolldown@rolldown+packages+rolldown)(typescript@6.0.3):
     dependencies:
       dts-resolver: 3.0.0(oxc-resolver@11.24.2)
@@ -14944,6 +15348,10 @@ snapshots:
 
   run-applescript@7.1.0: {}
 
+  run-parallel@1.2.0:
+    dependencies:
+      queue-microtask: 1.2.3
+
   rxjs@7.8.2:
     dependencies:
       tslib: 2.8.1
@@ -15123,6 +15531,8 @@ snapshots:
 
   shebang-regex@3.0.0: {}
 
+  shell-exec@1.0.2: {}
+
   shell-quote@1.8.4: {}
 
   siginfo@2.0.0: {}
@@ -15233,7 +15643,7 @@ snapshots:
 
   statuses@2.0.2: {}
 
-  std-env@4.0.0: {}
+  std-env@4.2.0: {}
 
   streamx@2.23.0:
     dependencies:
@@ -15366,18 +15776,22 @@ snapshots:
       commander: 2.20.3
       source-map-support: 0.5.21
 
+  test-dep-invalid-exports@file:vite/packages/vite/src/node/ssr/runtime/__tests__/fixtures/invalid-package/deps/test-dep-invalid-exports: {}
+
   text-decoder@1.2.3:
     dependencies:
       b4a: 1.7.3
     transitivePeerDependencies:
       - react-native-b4a
 
-  tinybench@2.9.0: {}
-
   tinybench@6.0.0: {}
 
+  tinybench@6.1.4: {}
+
   tinyexec@1.2.4: {}
 
+  tinyexec@1.3.0: {}
+
   tinyexec@1.3.1: {}
 
   tinyglobby@0.2.17:
@@ -15387,7 +15801,9 @@ snapshots:
 
   tinypool@2.1.0: {}
 
-  tinyrainbow@3.1.0: {}
+  tinyrainbow@3.1.1: {}
+
+  tinyspy@2.2.0: {}
 
   tldts-core@7.0.19:
     optional: true
@@ -15730,69 +16146,59 @@ snapshots:
 
   verkit@0.4.0: {}
 
-  vitest@4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core):
-    dependencies:
-      '@vitest/expect': 4.1.11
-      '@vitest/mocker': 4.1.11(vite@packages+core)
-      '@vitest/pretty-format': 4.1.11
-      '@vitest/runner': 4.1.11
-      '@vitest/snapshot': 4.1.11
-      '@vitest/spy': 4.1.11
-      '@vitest/utils': 4.1.11
-      es-module-lexer: 2.3.1
-      expect-type: 1.3.0
-      magic-string: 0.30.21
+  vitest@5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.10.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core):
+    dependencies:
+      '@types/chai': 5.2.3
+      '@vitest/mocker': 5.0.0(vite@packages+core)
+      chai: 6.2.2
+      es-module-lexer: 2.3.2
+      expect-type: 1.4.0
+      magic-string: 1.2.3
       obug: 2.1.4
-      pathe: 2.0.3
       picomatch: 4.0.7
-      std-env: 4.0.0
-      tinybench: 2.9.0
-      tinyexec: 1.3.1
+      std-env: 4.2.0
+      tinybench: 6.1.4
+      tinyexec: 1.3.0
       tinyglobby: 0.2.17
-      tinyrainbow: 3.1.0
       vite: link:packages/core
       why-is-node-running: 2.3.0
     optionalDependencies:
       '@edge-runtime/vm': 5.0.0
       '@opentelemetry/api': 1.9.0
       '@types/node': 24.10.3
-      '@vitest/browser-playwright': 4.1.11(playwright@1.62.1)(vite@packages+core)(vitest@4.1.11)
-      '@vitest/browser-preview': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      '@vitest/browser-webdriverio': 4.1.11(vite@packages+core)(vitest@4.1.11)(webdriverio@9.20.1(supports-color@8.1.1))
+      '@vitest/browser-playwright': 5.0.0(playwright@1.62.1)(vite@packages+core)(vitest@5.0.0)
+      '@vitest/browser-preview': 5.0.0(vite@packages+core)(vitest@5.0.0)
+      '@vitest/browser-webdriverio': 5.0.0-rc.1(vite@packages+core)(vitest@5.0.0)(webdriverio@9.20.1(supports-color@8.1.1))
+      '@vitest/ui': 5.0.0(vitest@5.0.0)
       happy-dom: 20.0.10
       jsdom: 27.2.0(supports-color@8.1.1)
     transitivePeerDependencies:
       - msw
 
-  vitest@4.1.11(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.13.3)(@vitest/browser-playwright@4.1.11)(@vitest/browser-preview@4.1.11)(@vitest/browser-webdriverio@4.1.11)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core):
-    dependencies:
-      '@vitest/expect': 4.1.11
-      '@vitest/mocker': 4.1.11(vite@packages+core)
-      '@vitest/pretty-format': 4.1.11
-      '@vitest/runner': 4.1.11
-      '@vitest/snapshot': 4.1.11
-      '@vitest/spy': 4.1.11
-      '@vitest/utils': 4.1.11
-      es-module-lexer: 2.3.1
-      expect-type: 1.3.0
-      magic-string: 0.30.21
+  vitest@5.0.0(@edge-runtime/vm@5.0.0)(@opentelemetry/api@1.9.0)(@types/node@24.13.3)(@vitest/browser-playwright@5.0.0)(@vitest/browser-preview@5.0.0)(@vitest/browser-webdriverio@5.0.0-rc.1)(@vitest/ui@5.0.0)(happy-dom@20.0.10)(jsdom@27.2.0(supports-color@8.1.1))(vite@packages+core):
+    dependencies:
+      '@types/chai': 5.2.3
+      '@vitest/mocker': 5.0.0(vite@packages+core)
+      chai: 6.2.2
+      es-module-lexer: 2.3.2
+      expect-type: 1.4.0
+      magic-string: 1.2.3
       obug: 2.1.4
-      pathe: 2.0.3
       picomatch: 4.0.7
-      std-env: 4.0.0
-      tinybench: 2.9.0
-      tinyexec: 1.3.1
+      std-env: 4.2.0
+      tinybench: 6.1.4
+      tinyexec: 1.3.0
       tinyglobby: 0.2.17
-      tinyrainbow: 3.1.0
       vite: link:packages/core
       why-is-node-running: 2.3.0
     optionalDependencies:
       '@edge-runtime/vm': 5.0.0
       '@opentelemetry/api': 1.9.0
       '@types/node': 24.13.3
-      '@vitest/browser-playwright': 4.1.11(playwright@1.62.1)(vite@packages+core)(vitest@4.1.11)
-      '@vitest/browser-preview': 4.1.11(vite@packages+core)(vitest@4.1.11)
-      '@vitest/browser-webdriverio': 4.1.11(vite@packages+core)(vitest@4.1.11)(webdriverio@9.20.1(supports-color@8.1.1))
+      '@vitest/browser-playwright': 5.0.0(playwright@1.62.1)(vite@packages+core)(vitest@5.0.0)
+      '@vitest/browser-preview': 5.0.0(vite@packages+core)(vitest@5.0.0)
+      '@vitest/browser-webdriverio': 5.0.0-rc.1(vite@packages+core)(vitest@5.0.0)(webdriverio@9.20.1(supports-color@8.1.1))
+      '@vitest/ui': 5.0.0(vitest@5.0.0)
       happy-dom: 20.0.10
       jsdom: 27.2.0(supports-color@8.1.1)
     transitivePeerDependencies:
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index e419b38aa2..44679b1b77 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -2,12 +2,26 @@ packages:
   - packages/*
   - rolldown
   - rolldown/packages/*
+  # Run the vendored Node suites against the same reviewed Vitest graph.
+  - rolldown/packages/rolldown/tests
+  - rolldown/packages/test-dev-server/tests
+  - rolldown/packages/rolldown/tests/fixtures/resolve/issue-5846
+  - rolldown/packages/rolldown/tests/fixtures/resolve/issue-5846-2
+  - rolldown/packages/rolldown/tests/fixtures/tree-shake/module-side-effects-precedence/hook-side-effects-overrides-package-json
+  - rolldown/packages/rolldown/tests/fixtures/tree-shake/module-side-effects-precedence/option-over-package-json
   - '!rolldown/packages/browser-tests'
   - '!rolldown/packages/rollup-tests'
   - vite
   - vite/packages/*
+  - vite/packages/**/__tests__/**
+# Preserve upstream file: fixture copies instead of replacing them with links.
+# License and SSR externalization tests depend on the node_modules boundary.
+dedupeInjectedDeps: false
 catalog:
   '@babel/core': ^7.29.7
+  '@babel/parser': ^7.29.8
+  '@babel/traverse': ^7.29.8
+  '@babel/types': ^7.29.8
   '@babel/preset-env': ^7.29.7
   '@babel/preset-typescript': ^7.29.7
   '@clack/core': ^1.0.0
@@ -31,6 +45,7 @@ catalog:
   '@tsdown/css': ^0.23.0
   '@tsdown/exe': ^0.23.0
   '@types/babel__core': 7.20.5
+  '@types/babel__traverse': ^7.28.0
   '@types/connect': ^3.4.38
   '@types/cross-spawn': ^6.0.6
   '@types/fs-extra': ^11.0.4
@@ -47,17 +62,15 @@ catalog:
   '@types/ws': ^8.18.0
   '@typescript/native-preview': 7.0.0-dev.20260605.1
   '@vitejs/plugin-react': ^5.1.2
-  '@vitest/browser': 4.1.11
-  '@vitest/browser-playwright': 4.1.11
-  '@vitest/browser-preview': 4.1.11
-  '@vitest/browser-webdriverio': 4.1.11
-  '@vitest/expect': 4.1.11
-  '@vitest/mocker': 4.1.11
-  '@vitest/pretty-format': 4.1.11
-  '@vitest/runner': 4.1.11
-  '@vitest/snapshot': 4.1.11
-  '@vitest/spy': 4.1.11
-  '@vitest/utils': 4.1.11
+  '@vitest/browser': 5.0.0
+  '@vitest/browser-playwright': 5.0.0
+  '@vitest/browser-preview': 5.0.0
+  '@vitest/browser-webdriverio': 5.0.0-rc.1
+  '@vitest/mocker': 5.0.0
+  '@vitest/pretty-format': 5.0.0
+  '@vitest/snapshot': 5.0.0
+  '@vitest/spy': 5.0.0
+  '@vitest/utils': 5.0.0
   '@voidzero-dev/vitepress-theme': 4.8.4
   '@vueuse/core': ^14.0.0
   acorn: ^8.17.0
@@ -132,7 +145,7 @@ catalog:
   vitepress-plugin-group-icons: ^1.7.1
   vitepress-plugin-llms: ^1.1.0
   vitepress-plugin-og: ^0.0.5
-  vitest: 4.1.11
+  vitest: 5.0.0
   vue: ^3.5.35
   web-tree-sitter: ^0.26.0
   ws: ^8.20.1
diff --git a/rfcs/vitest-v5-upgrade.md b/rfcs/vitest-v5-upgrade.md
new file mode 100644
index 0000000000..1c4d766d64
--- /dev/null
+++ b/rfcs/vitest-v5-upgrade.md
@@ -0,0 +1,443 @@
+# RFC: Upgrade the Bundled Vitest to v5
+
+- Status: Proposed
+- Tracking issue: [#2405](https://github.com/voidzero-dev/vite-plus/issues/2405)
+- Upstream baseline: [`v5.0.0`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0)
+- Release target: Vite+ before `1.0`
+
+## Decision
+
+Upgrade `vp test` and the `vite-plus/test*` API to Vitest `5.0.0` before Vite+ 1.0. Pin the official Vitest packages to the final release.
+
+The upgrade has four parts:
+
+1. Update the bundled runner, browser packages, public shims, resolver, and Vite config integration as one versioned unit.
+2. Add a Vitest v5 pass to `vp migrate`. It preserves v4 behavior where a config option can do so, applies safe source rewrites, and reports changes that need review.
+3. Raise the `vite-plus` Node.js range to the intersection of the current Vite+ range and the Vitest v5 range: `^22.18.0 || ^24.11.0 || >=26.0.0`.
+4. Release the change through a Vite+ prerelease and run the compatibility matrix in this RFC before a stable release.
+
+New projects use the Vitest v5 defaults. Migrated projects get explicit compatibility options. A user can remove those options later to adopt the new defaults one at a time.
+
+## Context
+
+Vite+ currently pins `vitest` and the managed `@vitest/*` family to `4.1.11` in `pnpm-workspace.yaml`. The `vite-plus` package:
+
+- resolves and starts its bundled Vitest binary from `packages/cli/src/resolve-test.ts`;
+- generates `vite-plus/test*` exports from the installed Vitest export map in `packages/cli/build.ts`;
+- projects browser providers and selected `@vitest/*` packages into extra compatibility paths;
+- forces Vitest-family imports to the bundled package graph in `packages/cli/src/define-config.ts`;
+- injects resolver, dependency-inline, and coverage-version plugins into the root and each inline test project;
+- rewrites Vitest imports and aligns Vitest ecosystem packages during `vp migrate`.
+
+These parts enforce one physical Vitest instance. That property must remain. Mock state, assertion state, browser types, coverage providers, and runner state can fail when a project loads two copies.
+
+Vitest v5 changes the package graph and project configuration model. A version-only catalog update would create invalid exports, duplicate Vite+ plugins in inline projects, retain removed packages, and keep migration rules that emit paths which no longer exist.
+
+## Goals
+
+- Keep `vp test`, `vite-plus/test*`, browser mode, coverage, and config helpers on one compatible Vitest v5 graph.
+- Preserve v4 behavior for existing projects when a v5 option provides an exact compatibility setting.
+- Give a file and an action for each change that cannot be automated safely.
+- Keep useful Vite+ legacy aliases through the Vite+ 1.x line when they have an exact v5 target.
+- Test Node, package manager, project, browser, coverage, reporter, and programmatic API boundaries before release.
+
+## Non-goals
+
+- Reimplement removed Vitest internals.
+- Make the v5 benchmark rewrite automatic.
+- Hide new Vitest behavior inside the runner after migration.
+- Support Vitest v5 on Node 20 or Node 25.
+- Require the community WebDriverIO provider to publish in lockstep with Vitest.
+
+## Upstream audit
+
+The audit covers every v5 prerelease, the final [`v5.0.0` release](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0), and the complete [Vitest v5 migration guide](https://vitest.dev/guide/migration#vitest-5). Vitest v5 introduced breaking changes in these groups:
+
+| Release                                                                     | Breaking-change themes                                                                                                                                 |
+| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [`beta.1`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.1) | `pretty-format` output, title formatting, browser iframe scaling, coverage glob matching, and `toThrow('')                                             |
+| [`beta.2`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.2) | artifact paths, removed sequential APIs, browser automocks, serialized locators, inlined expect, blob reports, and removed entry points                |
+| [`beta.3`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.3) | Node and Vite prerequisites, and strict `expect.poll` timeout handling                                                                                 |
+| [`beta.4`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.4) | top-level hoisted mocks, strict browser assertions and locators, and the benchmark rewrite                                                             |
+| [`beta.5`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.5) | config lookup, runner packaging, DOM globals, worker IDs, browser sessions, and per-file coverage thresholds                                           |
+| [`beta.6`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.6) | screenshot config, fake timers, WebDriverIO ownership, mock clearing, report defaults, UI authentication, and worker-start failure handling            |
+| [`beta.7`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-beta.7) | the `resolveConfig` return value                                                                                                                       |
+| [`rc.1`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-rc.1)     | project inheritance, nested projects, shared servers, test-name separators, async assertions, failure screenshots, class mocks, and assertion generics |
+| [`rc.2`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-rc.2)     | no new breaking change                                                                                                                                 |
+| [`rc.3`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-rc.3)     | no new breaking change; Istanbul coverage moved to the `@vitest/istanbul-lib-*` packages                                                               |
+| [`rc.4`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0-rc.4)     | `vitest list` and the programmatic `collect()` API use static parsing by default                                                                       |
+| [`v5.0.0`](https://github.com/vitest-dev/vitest/releases/tag/v5.0.0)        | no new breaking change after `rc.4`                                                                                                                    |
+
+Vitest published `v5.0.0` on September 3, 2026. The comparison from `rc.4` to the final tag contains fixes, documentation, dependency updates, and performance work. It contains no additional breaking commit. The final package manifests retain the audited Node, Vite, export, browser-provider, and Istanbul dependency contracts.
+
+## Compatibility design
+
+### 1. Runtime and dependency graph
+
+Pin the official Vitest packages to the exact version `5.0.0`. Keep the existing coverage-provider version guard. Coverage packages remain project-installed peers and must match the bundled runner exactly.
+
+| Package group                                                                                 | Policy                                                                                                                                                                                                                                |
+| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `vitest`                                                                                      | Exact dependency and the only runner started by `vp test`                                                                                                                                                                             |
+| `@vitest/browser`, `@vitest/browser-playwright`, `@vitest/browser-preview`                    | Exact version equal to the runner                                                                                                                                                                                                     |
+| `@vitest/mocker`, `@vitest/pretty-format`, `@vitest/snapshot`, `@vitest/spy`, `@vitest/utils` | Keep only when a public Vite+ shim needs the standalone package; pin exactly                                                                                                                                                          |
+| `@vitest/expect`                                                                              | Remove from the bundled graph; route Vitest assertions through the root `vitest` entry so assertion state stays shared                                                                                                                |
+| `@vitest/runner`                                                                              | Remove from catalogs, dependencies, shims, migration alignment, and resolver assumptions; v5 no longer publishes it with the runner                                                                                                   |
+| `@vitest/ws-client`                                                                           | Do not add a Vite+ shim; report direct use because upstream deprecated it and will not add v5 features                                                                                                                                |
+| `@vitest/browser-webdriverio`                                                                 | Keep as an optional compatibility peer backed by the [community repository](https://github.com/vitest-community/vitest-webdriverio); use a compatible range and test a selected version instead of forcing the runner's exact version |
+| `@vitest/coverage-v8`, `@vitest/coverage-istanbul`, `@vitest/ui`                              | Project-installed optional packages; require the exact runner version                                                                                                                                                                 |
+| `@vitest/web-worker`                                                                          | Project-installed optional package; keep its exact Vitest peer aligned without adding a Vite+ shim                                                                                                                                    |
+
+Replace the resolver's broad `@vitest/*` rule with an explicit supported-package set. In particular, do not redirect a user's standalone `@vitest/expect` to a Vite+ copy. Keep bundle-first resolution for the root `vitest` package, its public subpaths, the official browser packages, and other packages that share runner state. Keep the project fallback for optional peers.
+
+Provide Vitest's required `vite` peer through a published dependency alias to the matching `@voidzero-dev/vite-plus-core` version. Test a Yarn install with no project `vite` or `vitest` dependency; Yarn does not install a missing peer for the bundled runner.
+
+The repository vendors Vite and Rolldown workspaces. Their catalogs still request Vitest v4, and `sync-remote` rejects the v4/v5 major conflict. Prefer upstream v5 updates. If release timing requires a local bridge, add `vitest` to the sync tool's reviewed major-conflict set, align direct `@vitest/*` dependencies in the vendored workspaces, and run their test suites with the resolved v5 graph. Do not leave a hidden mix of v4 and v5 packages in the development lockfile.
+
+Run the bridge with `pnpm test:vendored` after building the upstream packages. It preserves the upstream suites' v4 mock-history setting and checks nine existing Vite+ branding differences without editing the vendored test files. Keep upstream Vite's `dedupeInjectedDeps: false` setting so pnpm retains `file:` dependency placement for the SSR externalization and license tests.
+
+Vitest `5.0.0` uses packages from the `vitest-dev/istanbuljs` repository for Istanbul internals: `@vitest/istanbul-lib-coverage`, `@vitest/istanbul-lib-instrument`, `@vitest/istanbul-lib-report`, and `@vitest/istanbul-lib-source-maps`. Keep those packages on the project-installed `@vitest/coverage-istanbul` dependency edge. The resolver allowlist must not redirect them to a missing Vite+ copy.
+
+### 2. Node.js and Vite prerequisites
+
+Vitest v5 supports Node `^22.12.0 || ^24.0.0 || >=26.0.0` and Vite `^6.4.0 || ^7.0.0 || ^8.0.0`. The bundled Vite satisfies the Vite range.
+
+Set the published `vite-plus` engine to `^22.18.0 || ^24.11.0 || >=26.0.0`. This removes Node 20 and Node 25 from the CLI package. Do not raise the standalone core package's engine only because of Vitest.
+
+Before the global CLI delegates `vp test` to a local CLI, validate the selected project runtime against the local `vite-plus` engine. On failure, stop before loading Vitest and print an action such as:
+
+```text
+vp test requires Node ^22.18.0 || ^24.11.0 || >=26.0.0.
+This project selects Node 20.19.0. Run `vp env pin 22 --force`, or update the project's runtime range.
+```
+
+The migration preflight must inspect `.node-version`, `.nvmrc`, `devEngines.runtime`, `engines.node`, CI matrices, and common container images. It may update a Vite+ runtime pin after confirmation. It must not silently widen a library's public `engines.node` contract.
+
+Read official Node image tags from Dockerfile `FROM` instructions, YAML `image` or `container` fields, and Dev Container image settings. Read the Node feature's `version` option separately; its feature tag does not identify the runtime. Ignore `node:2` properties in application code and comments that mention images.
+
+### 3. Public `vite-plus/test*` exports
+
+Continue to generate the main test surface from the v5 `vitest` export map, then add a reviewed compatibility map. Snapshot the final export keys in a test so an upstream export change cannot alter the Vite+ package by accident.
+
+Keep these aliases through the Vite+ 1.x line because each has an exact public target:
+
+| Vite+ compatibility path      | v5 target        |
+| ----------------------------- | ---------------- |
+| `vite-plus/test/coverage`     | `vitest/node`    |
+| `vite-plus/test/reporters`    | `vitest/node`    |
+| `vite-plus/test/environments` | `vitest/runtime` |
+| `vite-plus/test/snapshot`     | `vitest/runtime` |
+| `vite-plus/test/mocker`       | `@vitest/mocker` |
+
+Do not create partial shims for `vite-plus/test/runners`, `vite-plus/test/suite`, `vite-plus/test/plugins/runner`, `vite-plus/test/plugins/expect`, or `vite-plus/test/internal/module-runner`. Their old symbols do not have a complete one-to-one v5 implementation with the required shared state. The migration reports them and directs users to `expect`, `TestRunner`, and its static methods from `vite-plus/test` where possible.
+
+Keep the Playwright and Preview provider aliases. Keep the WebDriverIO aliases only when the community peer is installed and compatible. Update `packages/cli/BUNDLING.md` to state which paths mirror upstream and which paths are Vite+ compatibility contracts.
+
+Route the existing browser-context runtime aliases to `vitest/browser`. This includes provider `/context` paths, `vite-plus/test/browser/context`, `vite-plus/test/context`, and `vite-plus/test/plugins/browser-context`. Keep their upstream type declarations and augmentations. In v5, the `@vitest/browser/context` JavaScript export is an error stub; the browser plugin resolves only `vitest/browser` as its virtual context module.
+
+At the time of the final Vitest release, the latest community WebDriverIO provider is `5.0.0-rc.1`. The final Vitest manifest accepts `@vitest/browser-webdriverio` versions `^5.0.0-beta.5 || >=5.0.0`. Test the selected community version against Vitest `5.0.0`; do not hold the official package graph at an earlier release candidate.
+
+### 4. Config integration and project inheritance
+
+Vitest v4 inline projects did not inherit root plugins. The current Vite+ wrapper therefore prepends its three plugins to the root and every inline project. Vitest v5 sets `extends: true` by default and merges plugin arrays. The current wrapper would register each Vite+ plugin twice.
+
+Change the injection algorithm as follows:
+
+1. Inject the resolver, dependency-inline, and coverage-version plugins into the root config.
+2. For an inline project that inherits the declaring config, rely on the inherited plugins.
+3. For `extends: false` or an explicit external base config, inject the plugins into that project.
+4. Apply the same rule after resolving function and promise project entries.
+5. Make each Vite+ plugin idempotent by name as a defense against user merges and nested referenced configs.
+6. Keep the coverage guard keyed by the shared Vitest instance because `configureVitest` can run for several projects.
+
+Referenced config files and directories still resolve their own Vite config. Their `defineConfig` or `defineProject` call injects the Vite+ plugins. Add fixtures for raw config files that do not use the Vite+ helpers and give them the existing soft fallback behavior.
+
+Do not restore Vitest's removed parent-directory config lookup inside the runner. If `vp test` starts below a parent config and no explicit config was passed, inspect parents only to produce this diagnostic:
+
+```text
+No test config was found in this directory.
+A config exists at ../vite.config.ts. Run `vp test --config ../vite.config.ts --dir .`.
+```
+
+This keeps Vite+ aligned with the v5 CLI while giving the user a direct repair.
+
+## Migration design
+
+Add a versioned Vitest v5 migration pass. Run its preflight before package changes. Print the report again after edits with unresolved items grouped by file.
+
+Determine the source runner version before updating dependencies, including catalog and installed Vite+ dependencies. Record completion of the v4 compatibility pass in the migration state, including configless projects. A repeated migration must retain explicit v5 settings and must not apply v4 defaults to projects that already use v5. Unresolved findings remain visible on subsequent scans.
+
+Require installed or lockfile evidence when a dependency range spans both v4 and v5. Use portable workspace paths in the committed migration state. Retain deferred source-review findings without applying v4 edits again to a completed project.
+
+### Behavior-preserving config edits
+
+For an existing project, write these options when the related v4 option was absent:
+
+```ts
+export default defineConfig({
+  test: {
+    clearMocks: false,
+    sharedViteServer: false,
+    projects: [
+      {
+        extends: false,
+        test: {
+          clearMocks: false,
+          browser: {
+            locators: { exact: false },
+          },
+        },
+      },
+    ],
+  },
+});
+```
+
+Only write `sharedViteServer: false` when the config has inline projects. Only write `extends: false` on inline object projects that omitted it. Write `clearMocks: false` into each effective project that does not inherit the root setting. Only write `browser.locators.exact: false` for browser projects. Preserve explicit v5 settings.
+
+Many v4 projects have no Vite or Vitest config. The Vitest v5 migration pass must not create `vite.config.ts` for these projects by default. It must report the `clearMocks` default change and each other applicable default change. If another Vite+ migration step creates a config, write the compatibility options into that config.
+
+Offer a separate config-creation action after user confirmation. That action writes a minimal Vite+ config with the applicable compatibility options. Its output must state that a new config can change config discovery and project structure.
+
+Also apply these edits when no conflict exists:
+
+- move `browser.api` to top-level `api`;
+- copy a custom `browser.screenshotDirectory` to `browser.expect.toMatchScreenshot.screenshotDirectory`;
+- add `perFile: true` to glob threshold objects that inherited a top-level `coverage.thresholds.perFile: true` in v4;
+- set `{ stdout: true }` for configured JSON or JUnit reporters that had no `outputFile` and therefore wrote to stdout in v4;
+- add `.vitest/` to `.gitignore`, but retain old artifact entries until their directories are empty;
+- add `Temporal` to `fakeTimers.toNotFake` when the project installs a global Temporal polyfill and did not configure the option.
+
+The `toNotFake` option only preserves behavior while fake timers run. It does not preserve the v4 behavior of `vi.setSystemTime()` without fake timers.
+
+### Safe source and config rewrites
+
+Apply AST or structured command rewrites for these forms:
+
+- `test.sequential`, `describe.sequential`, and `{ sequential: true }` to `{ concurrent: false }` forms;
+- all v4 browser `toHaveTextContent` calls with a string or regular expression to `toMatchTextContent`;
+- `await render(...)` for `vitest-browser-vue` and `vitest-browser-svelte` when the enclosing callback can become `async` without changing its contract;
+- `resolveConfig` pair destructuring to the v5 return value and `.test` access;
+- deprecated Vitest entry points to the canonical Vite+ v5 paths;
+- root-safe `@vitest/expect` imports to `vite-plus/test`;
+- supported `@vitest/runner` uses to `TestRunner` from `vite-plus/test`;
+- direct `vitest list` commands without a static-parse flag to include `--no-static-parse`;
+- direct calls to the programmatic `Vitest.collect()` API to pass `{ staticParse: false }` when the options are absent or are a static object without `staticParse`;
+- HTML reporter `outputFile` directory settings to `outputDir`.
+
+Run specific mappings before the current generic `vitest/<subpath>` rewrite. The generic rule must only emit a path present in the final `vite-plus` export map.
+
+Do not infer exact text-match intent from a v4 browser `toHaveTextContent` call. A string used partial matching in v4, even when the current fixture contains the same complete string. A browser project can keep `toHaveTextContent` only when the user chooses v5 assertion behavior.
+
+Preserve Node `@testing-library/jest-dom` calls. Determine file ownership from static project roots and include/exclude patterns before renaming a plain `expect()` matcher. Report shared files, dynamic project settings, and browser CLI overrides for review. An `expect.element()` call identifies a browser assertion even when the config is dynamic.
+
+Follow `projects` and `extends` references within test configs, excluding plugin options with those names. Report the root jest-dom type entry for review in Vitest TypeScript configs. Users must load `@testing-library/jest-dom/vitest` through `compilerOptions.types` or an included TypeScript setup file; a JavaScript runtime setup alone does not prove type coverage.
+
+Use an explicit symbol allowlist for `@vitest/runner` migrations:
+
+| v4 runner symbol                                                                                                       | v5 migration                                                                                                                                |
+| ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test`, `it`, `describe`, `suite`, `recordArtifact`, `TestAPI`, `SuiteAPI`, `SuiteCollector`, `TestArtifact`           | import the same name from `vite-plus/test`                                                                                                  |
+| `File`, `Suite`, `Test`, `Task`, `VitestRunner`, `VitestRunnerConfig`                                                  | import `RunnerTestFile`, `RunnerTestSuite`, `RunnerTestCase`, `RunnerTask`, `VitestTestRunner`, or `TestRunnerConfig` from `vite-plus/test` |
+| `getCurrentSuite`, `getCurrentTest`, `createTaskCollector`                                                             | use `TestRunner.getCurrentSuite`, `TestRunner.getCurrentTest`, or `TestRunner.createTaskCollector` from `vite-plus/test`                    |
+| `getFn`, `getHooks`, `setFn`, `setHooks`                                                                               | use `TestRunner.getTestFn`, `TestRunner.getSuiteHooks`, `TestRunner.setTestFn`, or `TestRunner.setSuiteHooks` from `vite-plus/test`         |
+| `FileSpecification`, `SuiteHooks`, `TaskUpdateEvent`, `startTests`, `collectTests`, `updateTask`, and unlisted symbols | report the use and require manual migration                                                                                                 |
+
+The migration must preserve local import aliases when it applies a supported rewrite. An unsupported runtime use blocks the package update. An unsupported type-only use produces a review-required finding.
+
+### Review-required findings
+
+This list is the authoritative scanner checklist. Report each item with a file location. Do not claim that the scanner migrated these items:
+
+- `-t` patterns that may span a suite boundary;
+- nested `vi.mock`, `vi.unmock`, or `vi.hoisted` calls;
+- factory-free `vi.mock()` calls in browser tests;
+- class constructor mocks created with `vi.fn`, `vi.spyOn`, or `mockImplementation`;
+- the v4 benchmark API and removed benchmark CLI flags;
+- unawaited `resolves`, `rejects`, file-snapshot, poll, or browser assertions;
+- custom matcher declarations that use the old `Assertion<T>`, `Matchers<T>`, or `jest.Matchers` shape;
+- custom browser commands that receive a locator string;
+- scripts, CI jobs, or tools that read old artifact and report paths or pipe JSON/JUnit stdout;
+- code that uses `VITEST_POOL_ID` or `VITEST_WORKER_ID` as a zero-based value;
+- custom environments that restore `populateGlobal().originals` with assignment;
+- assignments to DOM globals in jsdom or happy-dom tests;
+- Temporal use in a file or setup scope that also calls `vi.setSystemTime()`;
+- direct UI or browser-orchestrator URLs without a token or session ID;
+- referenced config files that merge a root config containing `test.projects`;
+- dynamic, function, or promise inline projects whose effective config cannot be determined from source;
+- plugins that depend on one Vite server or config execution per project;
+- `vitest list` commands or programmatic `collect()` calls whose static-parse setting cannot be determined or rewritten safely;
+- configured `coverage.include` or `coverage.exclude` when a v4/v5 resolved file-set comparison is unavailable;
+- imports from removed runner, suite, or internal module-runner APIs that have no direct replacement;
+- direct `@vitest/ws-client` use and `@vitest/expect` or `@vitest/runner` symbols that are not available from the root v5 API.
+
+The command should exit successfully after safe edits but print a high-visibility review count. It should stop before package updates for an unsupported Node range, a conflicting `api` move, or a removed API with no replacement and active runtime use.
+
+### Exact output and removed-API reference
+
+Migration and documentation must use the exact v5 defaults:
+
+| Surface               | v4                              | v5                                                     |
+| --------------------- | ------------------------------- | ------------------------------------------------------ |
+| Attachments           | `.vitest-attachements/`         | `.vitest/attachments/`                                 |
+| Failure screenshots   | `__screenshots__/`              | `.vitest/attachments/failure-screenshots/`             |
+| Blob reporter         | `.vitest-reports/blob-*.json`   | `.vitest/blob/blob-*.json`                             |
+| HTML reporter         | `html/index.html`; `outputFile` | `.vitest/index.html`; `outputDir`                      |
+| JSON reporter         | stdout                          | `.vitest/json/output.json`                             |
+| JUnit reporter        | stdout                          | `.vitest/junit/output.xml`                             |
+| Reference screenshots | `browser.screenshotDirectory`   | `browser.expect.toMatchScreenshot.screenshotDirectory` |
+
+JSON and JUnit can retain stdout with `{ stdout: true }`. An explicit reporter `outputFile` remains valid except for the HTML reporter's renamed directory option.
+
+The benchmark migration removes the top-level `bench` API; `bench.skip`, `bench.only`, and `bench.todo`; `benchmark.reporters`; `benchmark.outputFile`; `benchmark.compare`; `benchmark.outputJson`; `--compare`; and `--outputJson`. The replacement is the `bench` test-context fixture, regular test modifiers, and the JSON reporter. `Vitest.mode` is always `test`.
+
+Retain supported benchmark options, including `benchmark.enabled` and `benchmark.include`. Block the removed options listed above; report dynamic benchmark settings for review.
+
+The entry-point migration uses these exact mappings:
+
+| Removed v4 entry point                   | v5 action                                      |
+| ---------------------------------------- | ---------------------------------------------- |
+| `vitest/coverage`, `vitest/reporters`    | import from `vite-plus/test/node`              |
+| `vitest/environments`, `vitest/snapshot` | import from `vite-plus/test/runtime`           |
+| `vitest/runners`                         | import `TestRunner` from `vite-plus/test`      |
+| `vitest/suite`                           | use static methods on `TestRunner`             |
+| `vitest/mocker`                          | import from `vite-plus/test/mocker`            |
+| `vitest/internal/module-runner`          | no public replacement; require manual redesign |
+
+## Complete incompatible-change and risk matrix
+
+This matrix tracks every v5 migration-guide item and the extra breaking entries in the release notes. “Scan” refers to the versioned `vp migrate` pass.
+
+| Change                                                       | Upgrade risk                                                                                                                                    | Vite+ handling                                                                                                              |
+| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| Node `>=22.12` and Vite `>=6.4`                              | The local CLI can fail before tests start.                                                                                                      | Raise the CLI engine, validate the selected runtime, and keep bundled Vite in range.                                        |
+| `clearMocks: true` default                                   | Setup-file, top-level, `beforeAll`, and cross-test mock history disappears.                                                                     | Add `clearMocks: false` for existing configs; use `true` for new projects.                                                  |
+| Configless v4 projects                                       | New defaults apply without a config file that the migration can edit.                                                                           | Report applicable changes. Do not create a config without a separate action and user confirmation.                          |
+| Full test names use `>`                                      | `-t 'suite test'` no longer matches across the boundary.                                                                                        | Scan scripts and CI strings; recommend one segment or `suite.*test`.                                                        |
+| Test listing uses static parsing                             | Runtime-generated tests and collection side effects can be absent from `vitest list` and `Vitest.collect()` results.                            | Add `--no-static-parse` or `{ staticParse: false }` to direct migrated uses; report dynamic wrappers.                       |
+| Browser iframe scaling changed                               | Headed browser UI and screenshot dimensions can differ from v4.                                                                                 | Run headed and headless screenshot fixtures at fixed viewports; refresh baselines only after review.                        |
+| Inline projects inherit root config                          | Plugins, aliases, setup files, and arrays can apply twice or begin applying.                                                                    | Add `extends: false` to static entries, report dynamic entries, and make plugin injection inheritance-aware.                |
+| Referenced configs can define nested projects                | A merged root `projects` field can recurse, duplicate projects, or resolve paths from a new base.                                               | Scan referenced configs and root-config merges; require manual extraction of a shared config.                               |
+| Inline projects share a Vite server                          | Config files and plugin hooks run fewer times; stateful plugins can change behavior.                                                            | Add `sharedViteServer: false` for migrated inline-project configs; new projects use sharing.                                |
+| Hoisted mock calls must be top-level                         | A prior warning becomes a startup error.                                                                                                        | Report each nested call; do not move it automatically because scope dependencies may change.                                |
+| Browser automocks remain mocked                              | Exports that called real code now return mock defaults.                                                                                         | Report factory-free browser mocks; suggest `{ spy: true }` when real behavior is required.                                  |
+| Class mocks inherit implementation prototypes                | Methods and `instanceof` results change.                                                                                                        | Add focused release tests; report class constructor mocks as review items.                                                  |
+| Benchmark API rewrite                                        | `bench`, benchmark modes, reporters, output, and compare options are removed.                                                                   | Block on active benchmark APIs and link the new test-context fixture design.                                                |
+| UI token authentication                                      | Stored or proxied bare UI URLs stop working.                                                                                                    | Preserve the token URL in CLI output; report hard-coded `/__vitest__/` URLs.                                                |
+| Fake timers mock `Temporal`                                  | Time tests with a global polyfill change.                                                                                                       | Preserve v4 fake-timer behavior with `toNotFake: ['Temporal']` when detected.                                               |
+| `vi.setSystemTime()` mocks `Temporal`                        | Code can observe mocked Temporal time without enabling fake timers.                                                                             | Report scopes that contain both Temporal use and `vi.setSystemTime()`; do not rewrite them.                                 |
+| `toThrow('')` matches any message                            | Assertions for an empty error message become too broad.                                                                                         | Rewrite `toThrow('')` and `toThrowError('')` to `/^$/`.                                                                     |
+| Assertion types add return and received parameters           | Custom matcher declarations and direct assertion types fail type checking.                                                                      | Report old generic forms, update Vite+ examples, and add type fixtures.                                                     |
+| `expect.poll` rejects at timeout                             | Polls that completed late now fail.                                                                                                             | Report configured polls and ask users to review the timeout; do not raise it automatically.                                 |
+| Unawaited async assertions fail                              | Tests that passed with a warning now fail.                                                                                                      | Detect expression statements and add `await` only when the transform is safe; report the rest.                              |
+| Titles and inspected values use `pretty-format`              | Snapshots, `test.each` titles, and reporter consumers can change.                                                                               | Run snapshot suites and report title snapshots; do not retain the v4 formatter.                                             |
+| Sequential APIs and options are removed                      | Test collection fails or concurrency changes.                                                                                                   | Apply the documented `{ concurrent: false }` rewrite.                                                                       |
+| Browser command locators serialize as objects                | Custom commands receive an object instead of a selector string.                                                                                 | Report locator-typed command parameters and suggest `SerializedLocator`.                                                    |
+| Browser locators are exact by default                        | Partial or case-insensitive text lookups stop matching.                                                                                         | Add `browser.locators.exact: false` to migrated browser projects.                                                           |
+| `toHaveTextContent` is strict                                | Partial strings and regular expressions fail.                                                                                                   | Rewrite all v4 string and regular-expression calls to `toMatchTextContent` unless the user chooses v5 semantics.            |
+| Vue and Svelte browser `render` are async                    | Immediate queries can race or access a promise.                                                                                                 | Add `await` where safe and report non-async call sites.                                                                     |
+| Glob thresholds no longer inherit `perFile`                  | Coverage enforcement can become weaker.                                                                                                         | Copy `perFile: true` into existing glob threshold objects.                                                                  |
+| `coverage.thresholds.perFile` also accepts an object         | Config libraries that assume a boolean can reject or misread the new shape.                                                                     | Update Vite+ config types and serializers; the old boolean form needs no migration.                                         |
+| Coverage include/exclude matching is precise                 | The measured file set can shrink or change.                                                                                                     | Compare resolved v4/v5 file sets. If comparison is unavailable, report all configured patterns for review.                  |
+| Parent config lookup is removed                              | Running below the config root can ignore configuration.                                                                                         | Give a parent-config diagnostic with `--config` and `--dir`; do not change v5 lookup rules.                                 |
+| DOM global assignment updates the window                     | `matchMedia` and other DOM APIs can observe new values.                                                                                         | Cover jsdom and happy-dom fixtures; report assignments to known DOM globals.                                                |
+| `populateGlobal().originals` contains descriptors            | Custom environment teardown can restore descriptor objects as values.                                                                           | Report assignments from `originals`; recommend `Object.defineProperty`.                                                     |
+| Browser orchestrator URLs need a session                     | Direct `/__vitest_test__/` links fail.                                                                                                          | Report hard-coded URLs and retain the URL printed or opened by Vitest.                                                      |
+| `browser.api` moves to `api`                                 | Custom ports are ignored.                                                                                                                       | Move the option when no top-level conflict exists; stop on conflict.                                                        |
+| Reports and artifacts move under `.vitest`                   | CI uploads, merges, ignores, and stdout pipes can break.                                                                                        | Update known config and ignore files; report scripts that reference the old defaults.                                       |
+| Screenshot references use a dedicated option                 | Existing baselines can be read from the wrong directory.                                                                                        | Copy the old custom directory to the new expectation option and retain files.                                               |
+| Worker and concurrency IDs are 1-based                       | Array indexes, ports, and database names shift.                                                                                                 | Report environment-variable reads and require project-specific review.                                                      |
+| Worker-start failures are reported gracefully                | Wrappers that match the old thrown error or localStorage warning can observe different diagnostics.                                             | Snapshot the Vite+ failure path and preserve Vitest's exit status; no project source migration is needed.                   |
+| `resolveConfig` returns resolved Vite config                 | Destructuring returns `undefined`; consumers miss `.test`.                                                                                      | Apply a targeted AST rewrite and add a programmatic API fixture.                                                            |
+| Runner, expect, WebSocket, and WebDriverIO package migration | Removed runner publication, deprecated WebSocket APIs, split expect state, and community provider ownership cause resolution or state failures. | Use the runner symbol allowlist, report unsupported APIs, route assertions through root `vitest`, and decouple WebDriverIO. |
+| Deprecated entry points are removed                          | Generated Vite+ shims and current generic migration output can become invalid.                                                                  | Keep exact compatibility aliases, rewrite to canonical paths, and block unsupported internals.                              |
+
+## Rollout
+
+### Phase 1: compatibility branch
+
+- Pin the official Vitest packages to `5.0.0` in a development branch.
+- Update the package graph, export generator, resolver, project plugin injection, and migration package set.
+- Add export snapshots and unit fixtures before accepting generated package changes.
+- Resolve the vendored Vite and Rolldown catalog conflict without a mixed Vitest family.
+
+### Phase 2: migration support
+
+- Implement the versioned scan, safe rewrites, compatibility config options, and Node preflight.
+- Add before-and-after fixtures for configless projects, configured projects, workspaces, and browser projects.
+- Publish the migration guide with each item in the risk matrix.
+
+### Phase 3: Vite+ prerelease
+
+- Confirm that the lockfile resolves the final official `5.0.0` package graph.
+- Verify one compatible community WebDriverIO provider against Vitest `5.0.0`.
+- Publish a Vite+ prerelease and run ecosystem CI against real projects.
+- Keep the v4-based Vite+ release available for Node 20 and for any WebDriverIO user blocked by community-provider timing.
+
+### Phase 4: stable release
+
+Release only after the gates below pass. State the Node requirement and the `vp migrate` command in the release notes. Do not remove the exact legacy aliases listed in this RFC during the Vite+ 1.x line.
+
+## Validation and release gates
+
+The earlier investigation spike used `5.0.0-rc.2`. It removed the unavailable runner package, built the CLI and 60 generated test exports, and passed the focused config/resolver tests. The complete TypeScript unit run passed 63 files and 1,029 tests. The spike also reproduced the vendored Rolldown catalog conflict, which confirms that dependency synchronization needs an explicit solution. Repeat these checks against final `5.0.0`; the `rc.4` static-collection change was not present in the spike.
+
+The implementation must pass these gates:
+
+1. `pnpm tsgo`, `vp check`, `pnpm test:unit`, Rust checks for changed global-CLI code, and the CLI snapshot suite.
+2. Package export tests that resolve every generated `vite-plus/test*` path under its published conditions and compile all typed paths with TypeScript. Import Node-facing APIs under Node ESM, test-facing APIs inside Vitest, and browser-only APIs inside a browser test. Type-only exports and upstream context-error stubs must retain their upstream behavior; importing a browser-only API in plain Node is not a success condition.
+3. Identity tests that prove `vp test`, `vite-plus/test`, browser providers, custom matchers, and coverage use one runner and assertion state.
+4. Node 22.18, 24.11, and 26 jobs, plus actionable rejection tests for Node 20 and 25 project pins.
+5. npm, pnpm, Yarn, and Bun install and test fixtures. Vite+ does not support Yarn PnP runtime resolution. Start the Yarn fixture with PnP, run the documented `vp migrate` conversion to `node_modules`, then execute its tests. Adding PnP runtime support is outside this upgrade.
+6. Configless, single-project, inherited inline-project, `extends: false`, referenced-config, nested-project, and shared-server fixtures. Add a fixture that combines `extends: false` with `sharedViteServer: false`. Assert independent server and plugin-hook behavior without extra inheritance.
+7. Playwright and Preview browser suites. Run the WebDriverIO suite against a verified community release without requiring an exact Vitest patch version.
+8. V8 and Istanbul coverage with matching providers, mismatched-provider rejection, glob threshold checks, and v4/v5 file-list comparison. Verify the final `@vitest/istanbul-lib-*` dependency graph.
+9. JSON, JUnit, HTML, blob merge, attachments, failure screenshots, and reference-screenshot path fixtures.
+10. UI token, browser session, custom command locator, jsdom, happy-dom, Temporal, custom environment, worker ID, `resolveConfig`, `vitest list`, `Vitest.collect()`, custom matcher, and benchmark migration fixtures.
+11. `ecosystem-ci` cases for `vite-plus-vitest-global-type-minimal-repro`, `vitest-playwright-repro`, and `vite-plus-vitest-type-aug`, followed by the broader ecosystem set.
+12. Vendored Vite and Rolldown tests under the final synchronized dependency graph.
+
+### Implementation validation (2026-09-06)
+
+Local checks on macOS covered the following:
+
+- Node `22.18.0`, `24.11.0`, and `26.0.0`: 70 unit-test files, with 1,240 tests passed and one skipped on each runtime. Type checking, `vp check`, and the docs build passed.
+- Rust: 314 migration tests, the global-CLI Node-range test, and 24 snapshot-redaction tests passed. `cargo fmt --all --check` and Clippy with warnings denied passed for the changed migration and global-CLI crates.
+- `pnpm test:vendored`: 1,904 tests passed and 19 skipped across Vite, Rolldown, Rolldown watch, and dev-server fixture suites. This command does not cover the separate upstream browser playground suites.
+- The full CLI snapshot rerun passed after the closing migration and dependency fixes: 774 cases passed and one was ignored. Three upstream-failure regression cases added during that run passed separate comparison runs. They verify the failures below, not successful browser behavior. The suite includes five package-manager installation cases and covers mixed Node/browser assertions, plugin config references, container runtime pins, jest-dom type guidance, and Yarn without project `vite` or `vitest` dependencies.
+- The three required ecosystem projects passed their prescribed test or type-check commands against the packed checkout. Additional runs covered `vite-plus-jest-dom-repro`, `viteplus-ws-repro`, `vp-config`, and `vite-vue-vercel`. The complete `oxlint-plugin-complexity` workflow passed with lint warnings, including 494 tests. The `vite-plus-monorepo-overrides` check and verification workflow also passed.
+- `tanstack-start-helloworld` passed eight browser tests and its build. `bun-vite-template` passed its validation workflow after the fixture applied the reported jest-dom type-entry repair. On Node `22.18.0`, `rollipop` passed its builds, formatting, and 24 tests; its report-only lint and type-check steps still reported errors.
+- On Node `24.11.0`, `vibe-dashboard` passed formatting, five browser tests, and its build. `nuxt-devtools` passed its build, type check, and 67 tests. Its migration reported an automatic-formatting failure; the prescribed workflow does not include formatting.
+- `reactive-resume` passed formatting, type-aware lint, its build, and 196 tests on Node `24.11.0`. On the same runtime, `vitepress` passed formatting, its build, 69 unit tests, 35 development-mode browser tests, 34 production-mode browser tests, and six initialization tests; one production-mode test was skipped.
+- `frm-stack` passed lint, formatting, type checking, and 24 Docker-backed database tests on Node `24.11.0`. `tiptap` passed its package and demo builds, lint, and 1,920 tests on that runtime. On Node `22.18.0`, `varlet` passed its bootstrap and 921 Istanbul coverage tests; its report-only lint step still reported the documented ambient `declare` error.
+- `vinext` passed its build and checks on Node `24.11.0`. Its unit shard passed 4,615 tests with two skipped on Node `24.20.0`, with loopback requests excluded from the local proxy. The earlier `24.11.0` run exposed Node glob and React stream differences; tests that use `localhost` also failed until the proxy exclusion was set.
+- `dify` passed its build and 41 tests in two files selected by the prescribed test filters. Its build skips type validation; the separate type check failed on the Node/browser matcher conflict below. `npmx.dev` passed formatting, type checking, and 1,652 Node tests. Its browser run passed 819 tests, failed 254, and skipped five; malformed translation-resource URLs reproduced the browser `define` issue below. Its lint step remains report-only.
+- The WebDriverIO fixture passed with community provider `5.0.0-rc.1`. Preview passed with fake timers; locator clicks with real timers still reproduce the upstream failure below.
+
+The stable release gate remains open. Of the 25 active ecosystem projects, 20 passed their prescribed workflows. Preflight blocked `decoders` on its Node `20.x` CI pin, `vue-mini` on its Node `25.9.0` runtime pin, and `yaak` on its Node `20` pin before changing project files. Their maintainers must choose supported test runtimes. `dify` and `npmx.dev` still fail required checks. External Linux and Windows jobs and a published Vite+ prerelease still need validation. Resolve the upstream failures below before the stable rollout.
+
+## Alternatives
+
+### Adopt all v5 defaults for existing projects
+
+This keeps migrated configs smaller but makes an ordinary package update change mock history, project inheritance, plugin lifetimes, and locator matching at once. New projects still get these defaults. Existing projects should opt in after their current suite passes.
+
+### Force v4 defaults inside `vp test`
+
+This avoids config edits but makes Vite+ behavior differ from the Vitest v5 documentation and programmatic API. Explicit migration options are visible and removable.
+
+### Mirror every v4 package and entry point
+
+Several removed runner and suite APIs do not have a complete v5 target. Partial shims would fail later and with less useful errors. Keep only aliases with exact public replacements.
+
+### Drop WebDriverIO support
+
+The provider kept its package name and moved to community maintenance. An optional peer and compatibility shim preserve current Vite+ imports without coupling release versions. Drop the shim only if the community package cannot pass the v5 browser contract before the Vite+ stable release.
+
+## Release-blocking questions
+
+1. Does the final community `@vitest/browser-webdriverio` release pass the Vite+ browser suite with final Vitest v5? If not, document the provider exception and keep affected users on the v4-based Vite+ release.
+2. Will the vendored Vite and Rolldown revisions move to Vitest v5 before the Vite+ release branch? If not, the temporary sync override and all affected upstream suites must land in the same change.
+3. Does Preview support locator clicks with real timers? The final `5.0.0` packages currently fail because the Preview user-event adapter calls `vi.advanceTimersByTimeAsync()` without checking whether fake timers are enabled. A clean npm project with only upstream Vitest and Preview reproduces the failure. The `test_v5_preview` fixture records the failure separately from the passing fake-timer integration case. Do not treat that expected failure as a passed release gate.
+4. Do browser globals receive decoded `define` values? Vitest `5.0.0` assigns JSON-encoded Vite values to browser globals. A string becomes `'"/messages"'` instead of `'/messages'`, and `'false'` remains a string. A clean upstream Preview project reproduces this without Vite+. `npmx.dev` requests quoted translation-resource URLs and fails browser assertions. The `upstream_browser_defines` fixture records the failure; an upstream fix or an approved compatibility patch is required.
+5. Can Node jest-dom and browser matcher declarations coexist? With Vitest and Preview `5.0.0`, importing `vitest/browser` before the jest-dom augmentation rejects Node regex text assertions and CSS custom-property assertions. Reversing the imports passes the same type checks. The `test_v5_upstream_types` fixture verifies both orders with `@testing-library/jest-dom` versions `6.9.1` and `7.0.1`, without Vite+ installed. `dify` still fails its type check even with an explicit jest-dom type entry. Resolve the declaration conflict before enabling the upgrade for affected projects.