feat(env)!: manage package manager environments - #2398

liangmiQwQ · 2026-08-10T10:59:50Z

Depends on #2391. Close #1853

This PR extends vp env to manage Node.js and package managers as peer environment components.

It adds package-manager defaults, session overrides, project pins, installation lifecycle, diagnostics, listings, and scoped environment commands. Resolution follows explicit/session overrides, project declarations, lockfile or config detection, and the global default. npm, pnpm, Yarn, and Bun remain independent families, including their aliases.

Node and package-manager modes can be managed independently. Scoped commands avoid resolving excluded families, and exact integrity pins survive project resolution, vp env use, session overrides, installation, and shim execution.

It doesn't break users' daily use command, commands such as vp env default 22.19.0 still works.

Breaking changes: unscoped component commands now operate on the complete environment, and the JSON contracts for current, list, and list-remote expose Node.js and package managers as peer components.

🤖 Generated with Codex

netlify · 2026-08-10T10:59:55Z

✅ Deploy Preview for viteplus-preview canceled.

Name	Link
🔨 Latest commit	`880fea3`
🔍 Latest deploy log	https://app.netlify.com/projects/viteplus-preview/deploys/6a94cd2b64972b000764d9d6

liangmiQwQ · 2026-08-30T09:05:23Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 80e29560a3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

liangmiQwQ · 2026-08-30T10:38:59Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9c79b9d41c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…d-vp-env-to-manage-pm

liangmiQwQ · 2026-08-30T14:17:06Z

@fengmk2 I'm ready if CI is green

github-actions · 2026-08-30T14:54:37Z

Registry bridge build (`a2a87c8`)

Warning

This build is from the fork liangmiQwQ/vite-plus and has not been reviewed.
Installing it runs that code on your machine. Build log

This commit build is published to the registry bridge, which serves these as ordinary npm versions (every other package proxies to npmjs):

Package	Version
`vite-plus`	`0.0.0-commit.a2a87c8aee4071cfc6575e7a61a99dcc6a5dcf50`
`@voidzero-dev/vite-plus-core`	`0.0.0-commit.a2a87c8aee4071cfc6575e7a61a99dcc6a5dcf50`

Install the Vite+ CLI built from this commit, then migrate a project:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/liangmiQwQ/vite-plus/a2a87c8aee4071cfc6575e7a61a99dcc6a5dcf50/packages/cli/install.sh | VP_PR_VERSION=2398 bash

# Windows (PowerShell)
$env:VP_PR_VERSION="2398"; irm https://raw.githubusercontent.com/liangmiQwQ/vite-plus/a2a87c8aee4071cfc6575e7a61a99dcc6a5dcf50/packages/cli/install.ps1 | iex

Or download the standalone Windows installer built from this commit:

Architecture	Installer
x64	`vp-setup-x86_64-pc-windows-msvc.exe`
Arm64	`vp-setup-aarch64-pc-windows-msvc.exe`

GitHub requires you to sign in and downloads each installer as a ZIP artifact. Extract vp-setup.exe, then run it against this preview build:

.\vp-setup.exe --version "0.0.0-commit.a2a87c8aee4071cfc6575e7a61a99dcc6a5dcf50" --registry "https://registry-bridge.viteplus.dev/"

After installing, upgrade the current project's vite-plus to this test build with:

vp migrate

Or point your package manager at the bridge registry https://registry-bridge.viteplus.dev/:

Package manager	Registry config
npm / pnpm / Bun	`.npmrc`: `registry=https://registry-bridge.viteplus.dev/`
Yarn (v2+)	`.yarnrc.yml`: `npmRegistryServer: "https://registry-bridge.viteplus.dev/"`

Then pin the build (vite aliases to vite-plus-core; pnpm can use a catalog, npm an overrides entry):

{
  "devDependencies": {
    "vite-plus": "0.0.0-commit.a2a87c8aee4071cfc6575e7a61a99dcc6a5dcf50",
    "vite": "npm:@voidzero-dev/vite-plus-core@0.0.0-commit.a2a87c8aee4071cfc6575e7a61a99dcc6a5dcf50"
  }
}

liangmiQwQ · 2026-08-30T15:01:03Z

2c9c326 is just a test-only commit, so no behavior change, no rebuild needed.

liangmiQwQ · 2026-08-31T00:10:12Z

Screenshot

@liangmiQwQ

`vp env` now manages Node.js and package-manager versions together. This release also fixes TanStack Start routing and stale Vitest aliases. ### Breaking Changes #### Package-manager setup Vite+ replaces Corepack with managed `npm`, `pnpm`, `yarn`, and `bun` commands. It removes the `corepack` shim and legacy global package-manager installations ([#2391](#2391)), by @liangmiQwQ. Replace Corepack setup commands in shell profiles, CI jobs, and Dockerfiles: | Previous setup | Replacement | | --- | --- | | `corepack enable` | `vp env setup` | | `vp install -g pnpm@<version>` | `vp env default pnpm@<version>` | | `vp install -g yarn@<version>` | `vp env default yarn@<version>` | | `vp install -g bun@<version>` | `vp env default bun@<version>` | | `vp install -g corepack` | Use the managed package-manager commands directly | Use `vp env pin <manager>@<version>` to set a project version. #### `vp env` command scope and JSON output Unscoped `vp env` commands now operate on Node.js and package managers. Package managers support independent defaults, project pins, session overrides, and installation commands ([#2398](#2398)), by @liangmiQwQ. Add `node` to limit an operation to Node.js, for example, `vp env off node` or `vp env unpin node`. Bare versions, such as `vp env default 22.19.0`, still select Node.js. Update scripts that read JSON output: | Command | New output structure | | --- | --- | | `vp env current --json` | `node` and `package_manager` objects | | `vp env list --json`, `vp env list-remote --json` | `node` and `package_managers` groups | See the [environment guide](https://viteplus.dev/guide/env). #### `vp pack` migration to `tsdown` `0.23` `vp pack` now uses `tsdown` `0.23`, which removes deprecated options and changes defaults ([#2614](#2614)), by @fengmk2. 1. Run `vp migrate` to update supported static configurations and package scripts, including projects that already use Vite+. 2. Check migration warnings in `vite.config.*`, `tsdown.config.*`, and `package.json`. 3. Update dynamic configurations manually. Arrays built with `.map()` require manual changes, even when migration reports no warning. 4. Run `vp pack` to check the result. | Previous option | Replacement | | --- | --- | | `bundle: false` | `unbundle: true` | | `outExtension` | `outExtensions` | | `publicDir` / `--public-dir` | `copy` / `--copy` | | `removeNodeProtocol: true` | `nodeProtocol: 'strip'` | | `injectStyle` | `css.inject` | | `inlineOnly` / `deps.onlyAllowBundle` | `deps.onlyBundle` | | `noExternal` | `deps.alwaysBundle` | | `skipNodeModulesBundle: true` / `deps.skipNodeModulesBundle: true` | `deps.neverBundle: true` | | `dts.tsgo: true` / `dts.oxc: true` | `dts.generator: 'tsgo'` / `dts.generator: 'oxc'` | Migration preserves the previous defaults for dependency resolution and ATTW. `tsdown` no longer supports Node.js `25`. Use Node.js `^22.18.0`, `^24.11.0`, or `>=26.0.0`. The programmatic `build()` API now returns `{ bundles, watch }`. See the [complete migration guide](https://github.com/rolldown/tsdown/releases/tag/v0.23.0) for declaration and TypeScript module-resolution changes. #### CLI argument validation `vp staged`, `vp config`, `vp hooks`, `vp migrate`, and `vp create` now reject unsupported options and extra positional arguments ([#2523](#2523)), by @fengmk2. Remove unsupported arguments from scripts. For example, replace `vp config --hooks-only` with `vp config --no-agent`. ### Highlights - Fix TanStack Start HTTP `404` responses caused by separate Vite runtime copies ([#2617](#2617)), by @fengmk2. - Reduce the Windows `vp-shim.exe` size from `214 KiB` to `14 KiB` ([#2466](#2466)), by @fengmk2. - Add `vp check --quiet` to hide lint warning diagnostics while retaining errors and summary counts ([#2593](#2593)), by @RSS1102. ### Features - Add `vp sync-versions --json` so automation can request dependency alignment plans from manifest snapshots without changing project files ([#2600](#2600)), by @afonsojramos. - Make `vp create --git` suggest an initial commit command after Git initialization ([#2581](#2581)), by @fengmk2. - Make `vp migrate` replace frozen `voidzero-dev/setup-vp@v1` workflow references with the supported version pin ([#2540](#2540)), by @fengmk2. - Upgrade `rolldown` from `1.2.5` to `1.2.7`, `tsdown` from `0.22.14` to `0.23.0`, and Oxc from `0.146.0` to `0.148.0`. Upgrade `oxlint` from `1.79.0` to `1.81.0` and `oxfmt` from `0.64.0` to `0.66.0`. These versions can flag code that passed before. Run `vp fmt` after upgrading if CI runs `vp check` ([#2580](#2580), [#2613](#2613)), by @voidzero-guard[bot]. ### Fixes & Enhancements - Resolve package-manager versions without rewriting `package.json`. Use `vp env pin` or `vp env unpin` to change project declarations explicitly ([#2399](#2399)), by @liangmiQwQ. - Let `vp migrate` repair stale `vitest` aliases that previously prevented the CLI from starting ([#2605](#2605)), by @fengmk2. - Keep Vite DevTools within the version ranges supported by the bundled Vite ([#2559](#2559)), by @fengmk2. - Keep automatic Vitest upgrades on the supported `4.x` major ([#2612](#2612)), by @fengmk2. - Remove a deprecated `tsdown` option from the prompts package build ([#2597](#2597)), by @jong-kyung. ### Refactor - Use the updated `which` dependency to resolve relative `PATH` entries ([#2583](#2583)), by @RSS1102. - Remove the unused `async-trait` annotation from `JsRuntimeProvider` ([#2538](#2538)), by @jong-kyung. ### Docs - Add Azure Pipelines setup instructions ([#2553](#2553)), by @naokihaba. - Correct Zed Oxc formatter settings and include JSX and TSX ([#2592](#2592)), by @joschuba. - Add Wrangler deployment configuration for the documentation site ([#2596](#2596)), by @mdong1909. - Explain conflicts between pnpm and Vite+ runtime management, including the `runtimeOnFail` setting ([#2620](#2620)), by @liangmiQwQ. ### Chore - Run CLI snapshots without published release packages ([#2625](#2625)), by @fengmk2. - Update the release-manager skill with package-install checks, changelog guidance, and announcement handling ([#2548](#2548)), by @fengmk2. - Wait for npm dependencies to become available before publishing dependent release packages ([#2601](#2601)), by @fengmk2. - Remove old Docker preview images ([#2539](#2539)), by @fengmk2. - Stabilize external-tool snapshots and isolate npm network cases ([#2577](#2577), [#2604](#2604)), by @fengmk2. - Avoid unreliable Fish PPA setup in CI ([#2560](#2560)), by @fengmk2. - Update the `vinext` fixture to an upstream fix ([#2571](#2571)), by @jong-kyung. - Stabilize the pnpm snapshot and Nuxt build in CI ([#2591](#2591)), by @voidzero-guard[bot]. - Pin pnpm in project-creation build-approval fixtures ([#2616](#2616)), by @liangmiQwQ. - Remove unused documentation components, assets, and the typewriter dependency ([#2550](#2550), [#2562](#2562)), by @jong-kyung. - Remove duplicate `tempfile` dependencies, an unused runtime helper, and unused error variants. Update the `unit_bindings` lint name ([#2555](#2555), [#2558](#2558), [#2566](#2566), [#2567](#2567)), by @jong-kyung. - Update GitHub Actions dependencies, including `actions/setup-node` `v7` ([#2544](#2544), [#2545](#2545), [#2582](#2582), [#2618](#2618)), by @renovate[bot]. - Update `crate-ci/typos` through `v1.50.1` ([#2584](#2584), [#2589](#2589), [#2609](#2609)), by @renovate[bot]. - Update repository pnpm to `11.24.0` ([#2590](#2590)), by @renovate[bot]. - Update `voidzero-dev/setup-vp` to `v1.19.0` ([#2619](#2619)), by @renovate[bot]. ### Bundled Versions | Tool | Version | Source | | --- | --- | --- | | `vite` | `8.2.2` | [`de1111a`](vitejs/vite@de1111a) | | `rolldown` | `1.2.7` | [`26b4c6e`](rolldown/rolldown@26b4c6e) | | `tsdown` | `0.23.0` | [npm](https://npmx.dev/package/tsdown/v/0.23.0) | | `vitest` | `4.1.11` | [npm](https://npmx.dev/package/vitest/v/4.1.11) | | `oxlint` | `1.81.0` | [npm](https://npmx.dev/package/oxlint/v/1.81.0) | | `oxlint-tsgolint` | `7.0.2001` | [npm](https://npmx.dev/package/oxlint-tsgolint/v/7.0.2001) | | `oxfmt` | `0.66.0` | [npm](https://npmx.dev/package/oxfmt/v/0.66.0) | ### Upgrade ```bash vp upgrade ``` ### New Contributors @afonsojramos, @joschuba **Full Changelog**: v0.3.0...v0.3.1 --- Merging this PR will trigger the release workflow. --------- Co-authored-by: voidzero-guard[bot] <278573678+voidzero-guard[bot]@users.noreply.github.com> Co-authored-by: MK (fengmk2) <fengmk2@gmail.com>

liangmiQwQ force-pushed the feat-breaking/extend-vp-env-to-manage-pm branch 16 times, most recently from 7737c90 to 4d9fd9e Compare August 12, 2026 01:07

liangmiQwQ mentioned this pull request Aug 12, 2026

fix(pm): avoid implicit project writes #2399

Merged

liangmiQwQ force-pushed the feat-breaking/extend-vp-env-to-manage-pm branch 2 times, most recently from a9d9f6c to 447f600 Compare August 12, 2026 05:47

liangmiQwQ mentioned this pull request Aug 12, 2026

feat(env)!: replace Corepack with package manager shims #2391

Merged

liangmiQwQ marked this pull request as ready for review August 12, 2026 13:16

liangmiQwQ requested a review from fengmk2 August 13, 2026 01:13

liangmiQwQ force-pushed the feat-breaking/extend-vp-env-to-manage-pm branch from 0181e80 to df7f7a6 Compare August 15, 2026 12:31

liangmiQwQ marked this pull request as draft August 19, 2026 14:25

liangmiQwQ force-pushed the feat-breaking/extend-vp-env-to-manage-pm branch 3 times, most recently from f592c87 to de92623 Compare August 21, 2026 03:14

liangmiQwQ mentioned this pull request Aug 22, 2026

Enhance Vite+ package manager management #2375

Closed

liangmiQwQ force-pushed the feat-breaking/extend-vp-env-to-manage-pm branch from 2a6acd0 to a1a4538 Compare August 28, 2026 10:53

chatgpt-codex-connector Bot reviewed Aug 30, 2026

View reviewed changes

Comment thread crates/vp_global_cli/src/commands/env/config.rs

Comment thread crates/vp_global_cli/src/commands/env/mod.rs Outdated

Comment thread crates/vp_global_cli/src/commands/env/clean.rs Outdated

Comment thread crates/vp_global_cli/src/commands/env/exec.rs Outdated

fix(env): align undecided manager behavior

9c79b9d

chatgpt-codex-connector Bot reviewed Aug 30, 2026

View reviewed changes

liangmiQwQ added 4 commits August 30, 2026 20:31

fix(env): complete package manager fallback contracts

d928446

Merge remote-tracking branch 'upstream/main' into feat-breaking/exten…

6b274f0

…d-vp-env-to-manage-pm

fix(env): store per-manager default versions

f536a1e

fix(env): restore stable component contracts

a2a87c8

liangmiQwQ marked this pull request as ready for review August 30, 2026 14:16

fengmk2 added preview-build Publish this PR's commits to the registry bridge as preview builds and removed preview-build Publish this PR's commits to the registry bridge as preview builds labels Aug 30, 2026

test(env): streamline package manager snapshots

2c9c326

liangmiQwQ added 2 commits August 30, 2026 23:11

test(env): normalize doctor snapshot across platforms

3175b8b

test(env): seed npm diagnostics per platform

f5821da

fengmk2 reviewed Aug 30, 2026

View reviewed changes

Comment thread docs/guide/env.md

liangmiQwQ added 2 commits August 31, 2026 07:41

docs

d4bf2ea

docs

2db7b09

liangmiQwQ requested a review from fengmk2 August 31, 2026 00:10

push

880fea3

fengmk2 reviewed Aug 31, 2026

View reviewed changes

Comment thread crates/vp_global_cli/src/commands/env/current.rs

fengmk2 approved these changes Aug 31, 2026

View reviewed changes

fengmk2 merged commit 3124145 into voidzero-dev:main Aug 31, 2026
128 checks passed

liangmiQwQ deleted the feat-breaking/extend-vp-env-to-manage-pm branch August 31, 2026 03:14

fengmk2 mentioned this pull request Sep 7, 2026

release: v0.3.1: manage package-manager versions with vp env #2623

Merged

Uh oh!

Conversation

liangmiQwQ commented Aug 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify Bot commented Aug 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for viteplus-preview canceled.

Uh oh!

liangmiQwQ commented Aug 30, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

liangmiQwQ commented Aug 30, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

liangmiQwQ commented Aug 30, 2026

Uh oh!

github-actions Bot commented Aug 30, 2026

Registry bridge build (a2a87c8)

Uh oh!

liangmiQwQ commented Aug 30, 2026

Uh oh!

Uh oh!

liangmiQwQ commented Aug 31, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

liangmiQwQ commented Aug 10, 2026 •

edited

Loading

netlify Bot commented Aug 10, 2026 •

edited

Loading

Registry bridge build (`a2a87c8`)