release: v0.2.5: Cleaner environments and more reliable workflows

[voidzero-guard]

Release vite-plus v0.2.5: Cleaner environments and more reliable workflows.

This release adds cleanup and package version commands, reduces the standalone binary size, and hardens task tracking, CLI output, package-manager routing, Docker workflows, and project scaffolding.

Highlights

• Add vp env clean to remove unused managed Node.js runtimes and package-manager caches (#2003), by @liangmiQwQ
• Add vp pm version, forwarding native version commands to npm, pnpm, Yarn, and Bun (#2127), by @jong-kyung
• Reduce standalone vp binary sizes by about 5% on Linux and macOS and 19% on Windows (#2043), by @fengmk2
• Improve automatic task input tracking for Bun on macOS, Linux containers with constrained /dev/shm, and Windows process images, reduce Windows backing-file allocation, and clarify task wait failures (vite-task#515, vite-task#518, vite-task#523, vite-task#524, vite-task#542, #2126, #2167), by @wan9chi
• Prevent CLI diagnostics from truncating or panicking when inherited standard output or error is nonblocking (#2172, #2173), by @wan9chi

Features

• Upgrade the bundled toolchain from vite 8.1.3 to 8.1.4, rolldown 1.1.4 to 1.1.5, tsdown 0.22.3 to 0.22.7, oxlint 1.72.0 to 1.73.0, and oxfmt 0.57.0 to 0.58.0, including TypeScript 7 support and new tsdown warning controls (#2104, #2168), by @voidzero-guard[bot]

Fixes & Enhancements

• Keep the Docker image non-root by default while allowing passwordless sudo for Playwright browser dependencies and system packages (#2088), by @fengmk2
• Ignore .env and .env.* in generated projects while keeping .env.example trackable (#2095), by @forehalo
• Create vp-use.cmd after the Windows environment bin directory is ready and document its Command Prompt-only usage (#2128), by @liangmiQwQ
• Render user-facing process statuses and paths without Rust debug wrappers (#2130), by @liangmiQwQ
• Make vp dedupe fall back to yarn install with a warning on Yarn Classic (#2139), by @jong-kyung
• Ensure package-manager child processes, including Bun, can always find the managed Node.js runtime (#2158), by @BlankParticle

Docs

• Update the release-manager post-release guidance (#2096), by @wan9chi
• Add Windows to the Namespace sponsor credit (#2108), by @fengmk2
• Document installer and runtime environment variables, registry settings, TLS options, and precedence rules (#2114), by @yukinoshi
• Mark shell examples in CONTRIBUTING.md as Bash code blocks (#2159), by @BlankParticle

Chore

• Assign prepared release PRs to the workflow actor (#2094), by @wan9chi
• Complete the PTY snapshot migration and harden the runner, fixtures, redaction, registry teardown, timeouts, and Linux parallelism (#2071, #2080, #2084, #2099, #2102, #2103, #2107, #2109, #2115, #2117, #2118, #2119, #2120, #2121, #2131, #2132, #2134, #2137, #2138, #2141, #2143, #2145), by @fengmk2
• Expose Vite+ managed binaries consistently inside snapshot fixtures (#2110), by @liangmiQwQ
• Exclude PTY snapshot configuration from Vitest discovery and remove the legacy snapshot infrastructure (#2135, #2146), by @jong-kyung
• Modernize Windows runners, registry bridge publishing, native size reporting, merge-base comparisons, and package-manager installation CI (#2083, #2100, #2105, #2106, #2112, #2133), by @fengmk2
• Verify that created monorepo libraries emit declarations in CI (#2171), by @wan9chi

Bundled Versions

Tool	Version	Source
vite	8.1.4	a477454
rolldown	1.1.5	f09947a
tsdown	0.22.7	npm
vitest	4.1.10	npm
oxlint	1.73.0	npm
oxlint-tsgolint	0.24.0	npm
oxfmt	0.58.0	npm

Upgrade

vp upgrade

New Contributors

Welcome @yukinoshi and @BlankParticle.

Full Changelog: v0.2.4...v0.2.5

---

Merging this PR will trigger the release workflow.

[netlify]

✅ Deploy Preview for viteplus-preview canceled.

Name	Link
🔨 Latest commit	d4d375a
🔍 Latest deploy log	https://app.netlify.com/projects/viteplus-preview/deploys/6a57a839c6c5720007d4604b

[github-actions]

Native binary sizes (d4d375a)

Final release artifacts built by the canonical build-upstream and build-windows-cli actions.

Artifact	Format	Base	PR	Change
vp (Linux x64)	Binary	10.32 MiB	10.32 MiB	0 B (0.00%)
vp (Linux x64)	gzip -9	4.42 MiB	4.42 MiB	+3.31 KiB (+0.07%)
NAPI (Linux x64)	Binary	33.46 MiB	33.46 MiB	0 B (0.00%)
NAPI (Linux x64)	gzip -9	12.80 MiB	12.80 MiB	+1.03 KiB (+0.01%)
vp (macOS ARM64)	Binary	7.65 MiB	7.65 MiB	0 B (0.00%)
vp (macOS ARM64)	gzip -9	3.83 MiB	3.83 MiB	-1.69 KiB (-0.04%)
NAPI (macOS ARM64)	Binary	40.73 MiB	40.73 MiB	0 B (0.00%)
NAPI (macOS ARM64)	gzip -9	17.03 MiB	17.03 MiB	-61 B (-0.00%)
vp (Windows x64)	Binary	8.37 MiB	8.37 MiB	0 B (0.00%)
vp (Windows x64)	gzip -9	3.64 MiB	3.64 MiB	+21 B (+0.00%)
NAPI (Windows x64)	Binary	27.78 MiB	27.78 MiB	0 B (0.00%)
NAPI (Windows x64)	gzip -9	10.74 MiB	10.74 MiB	+1.22 KiB (+0.01%)
Trampoline (Windows x64)	Binary	203.00 KiB	203.00 KiB	0 B (0.00%)
Trampoline (Windows x64)	gzip -9	97.91 KiB	97.91 KiB	-1 B (-0.00%)
Installer (Windows x64)	Binary	4.46 MiB	4.46 MiB	0 B (0.00%)
Installer (Windows x64)	gzip -9	2.08 MiB	2.08 MiB	+1 B (+0.00%)

[github-actions]

Registry bridge build (d4d375a)

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.d4d375a43dff97441f9b3f69d58fcee5ca402aba
@voidzero-dev/vite-plus-core	0.0.0-commit.d4d375a43dff97441f9b3f69d58fcee5ca402aba

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

# macOS / Linux
curl -fsSL https://vite.plus | VP_PR_VERSION=2180 bash

# Windows (PowerShell)
$env:VP_PR_VERSION="2180"; irm https://vite.plus/ps1 | iex

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.d4d375a43dff97441f9b3f69d58fcee5ca402aba",
    "vite": "npm:@voidzero-dev/vite-plus-core@0.0.0-commit.d4d375a43dff97441f9b3f69d58fcee5ca402aba"
  }
}

[github-actions]

🐳 Docker preview image

Built from this PR's registry bridge build:

Image	Compressed size
ghcr.io/voidzero-dev/vite-plus:pr-2180	243MB

# remove any stale local copy from a previous run, then pull fresh
docker rmi ghcr.io/voidzero-dev/vite-plus:pr-2180 2>/dev/null; docker pull ghcr.io/voidzero-dev/vite-plus:pr-2180

Quick check:

docker run --rm ghcr.io/voidzero-dev/vite-plus:pr-2180 vp --version

See docs/guide/docker.md for usage.