feat(cli): expose dependency alignment plans by afonsojramos · Pull Request #2600 · voidzero-dev/vite-plus

afonsojramos · 2026-09-02T21:57:56Z

Summary

Vite+ releases can now tell external automation how to align Vite+, Vite+ core, Vitest, and official Vitest packages without reading or changing the project itself. This provides the release-owned compatibility contract needed to prevent dependency bots from producing mixed toolchains.

This is the first part of a three-repository integration. Containerbase installation and Renovate reconciliation follow after this contract ships in a Vite+ release.

Design

vp sync-versions --json accepts bounded manifest snapshots over stdin and returns deterministic before/after replacements.
Planning updates only existing managed declarations. It preserves catalog protocols, JSON formatting, and YAML comments, quoting, indentation, and line endings.
The command does not load project configuration, run installs or lifecycle scripts, format source, or write to the repository.
Both the npm CLI and standalone archive expose the same protocol. Release archives include the self-contained planner, toolchain manifest, and checksums needed for verified installation.

Validation

Planner, protocol, package-override, and migration suites: 395 tests passed.
Focused sync-version suites: 39 tests passed.
Global CLI Rust suite: 486 tests passed, 2 ignored.
CLI TypeScript build, optimized Rust build, npm entrypoint smoke test, and standalone archive-layout simulation passed.
Scoped formatting, lint, type checks, and git diff --check passed.

Related: #2356

Downstream drafts:

netlify · 2026-09-02T21:58:03Z

✅ Deploy Preview for viteplus-preview ready!

Name	Link
🔨 Latest commit	`2431e41`
🔍 Latest deploy log	https://app.netlify.com/projects/viteplus-preview/deploys/6a99dabe55da2600087cf38a
😎 Deploy Preview	https://deploy-preview-2600--viteplus-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

github-actions · 2026-09-03T09:59:36Z

Registry bridge build (`a70c54d`)

Warning

This build is from the fork afonsojramos/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.a70c54d67ca9b47dcfcb083ca135fd61c7d04740`
`@voidzero-dev/vite-plus-core`	`0.0.0-commit.a70c54d67ca9b47dcfcb083ca135fd61c7d04740`

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

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/afonsojramos/vite-plus/a70c54d67ca9b47dcfcb083ca135fd61c7d04740/packages/cli/install.sh | VP_PR_VERSION=2600 bash

# Windows (PowerShell)
$env:VP_PR_VERSION="2600"; irm https://raw.githubusercontent.com/afonsojramos/vite-plus/a70c54d67ca9b47dcfcb083ca135fd61c7d04740/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.a70c54d67ca9b47dcfcb083ca135fd61c7d04740" --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.a70c54d67ca9b47dcfcb083ca135fd61c7d04740",
    "vite": "npm:@voidzero-dev/vite-plus-core@0.0.0-commit.a70c54d67ca9b47dcfcb083ca135fd61c7d04740"
  }
}

fengmk2 · 2026-09-03T13:20:33Z

@afonsojramos I installed the preview build version, and when I run vp sync-versions --json, it hangs without any response.

afonsojramos · 2026-09-03T13:27:02Z

So, the command expects a JSON request on stdin, but silently waiting on an interactive terminal is definitely a bug. I’ll make it fail immediately, does that sound good @fengmk2?

fengmk2 · 2026-09-03T13:30:38Z

@afonsojramos Yes, I think it would be more appropriate to report an error in interactive mode.

afonsojramos · 2026-09-03T13:43:57Z

@fengmk2 should be good now 👌

fengmk2

@afonsojramos Thanks so much!
I will perform manual testing and verification before merging.

afonsojramos · 2026-09-03T13:48:11Z

Awesome, thanks! Feel free to check the other draft PRs to check the plan of joining it all together

fengmk2 · 2026-09-03T14:48:53Z

+}
+
+function alignedSpec(name: string, current: string, toolchain: SyncVersionsToolchain): string {
+  const target = targetVersion(name, toolchain);


https://github.com/npmx-dev/npmx.dev/blob/main/pnpm-workspace.yaml#L32

Will the overrides configuration for this dependency alias 'vite': 'npm:@voidzero-dev/vite-plus-core@0.3.0' be automatically upgraded by us?

Yes, it will now. I added support for managed npm: aliases, including this exact pnpm catalog entry. We also preserve the alias target and only replace its version. So custom aliases remain untouched.

fengmk2 · 2026-09-03T15:10:57Z

+      }
+
+      const basename = path.posix.basename(manifest.path);
+      const kindMatchesPath =


How about .yarnrc.yml file? I think we should support yarn 4.10+ catalogs in this file.

Good call, added. sync-versions now handles both default and named Yarn catalogs in .yarnrc.yml, while preserving formatting and comments.

feat(cli): add dependency alignment planner

b2de47d

This was referenced Sep 2, 2026

feat(tools): install Vite+ releases containerbase/base#7338

Draft

feat(vite-plus): align coupled package versions renovatebot/renovate#45630

Draft

fengmk2 self-assigned this Sep 3, 2026

fengmk2 reviewed Sep 3, 2026

View reviewed changes

Comment thread packages/cli/src/sync-versions/bin.ts Outdated

fix(cli): align sync-versions JSON flag (voidzero-dev#2600)

1d63253

fengmk2 added test: e2e Auto run e2e tests test: install-e2e run vite install e2e test test: create-e2e Run `vp create` e2e tests preview-build Publish this PR's commits to the registry bridge as preview builds labels Sep 3, 2026

fix(cli): reject interactive sync-version input (voidzero-dev#2600)

a70c54d

fengmk2 approved these changes Sep 3, 2026

View reviewed changes

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 Sep 3, 2026

fengmk2 reviewed Sep 3, 2026

View reviewed changes

feat(cli): align npm aliases and Yarn catalogs

2431e41

Navigation Menu

Uh oh!

feat(cli): expose dependency alignment plans - #2600

feat(cli): expose dependency alignment plans#2600
afonsojramos wants to merge 4 commits into
voidzero-dev:mainfrom
afonsojramos:feat/sync-versions-plan

afonsojramos commented Sep 2, 2026 •

edited

Loading

Uh oh!

netlify Bot commented Sep 2, 2026 •

edited

Loading

Uh oh!

Uh oh!

github-actions Bot commented Sep 3, 2026 •

edited

Loading

Uh oh!

fengmk2 commented Sep 3, 2026

Uh oh!

afonsojramos commented Sep 3, 2026

Uh oh!

fengmk2 commented Sep 3, 2026

Uh oh!

afonsojramos commented Sep 3, 2026

Uh oh!

fengmk2 left a comment •

edited

Loading

Uh oh!

afonsojramos commented Sep 3, 2026

Uh oh!

fengmk2 Sep 3, 2026

Uh oh!

afonsojramos Sep 3, 2026

Uh oh!

fengmk2 Sep 3, 2026

Uh oh!

afonsojramos Sep 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

afonsojramos commented Sep 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Design

Validation

Uh oh!

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

Uh oh!

✅ Deploy Preview for viteplus-preview ready!

Uh oh!

Uh oh!

github-actions Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Registry bridge build (a70c54d)

Uh oh!

fengmk2 commented Sep 3, 2026

Uh oh!

afonsojramos commented Sep 3, 2026

Uh oh!

fengmk2 commented Sep 3, 2026

Uh oh!

afonsojramos commented Sep 3, 2026

Uh oh!

fengmk2 left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

afonsojramos commented Sep 3, 2026

Uh oh!

fengmk2 Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

afonsojramos Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

fengmk2 Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

afonsojramos Sep 3, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

afonsojramos commented Sep 2, 2026 •

edited

Loading

netlify Bot commented Sep 2, 2026 •

edited

Loading

github-actions Bot commented Sep 3, 2026 •

edited

Loading

Registry bridge build (`a70c54d`)

fengmk2 left a comment •

edited

Loading