release: v0.2.3: config extraction, create, and vp run reliability fixes

[voidzero-guard]

Release vite-plus v0.2.3: config extraction, create, and vp run reliability fixes.

A patch release that restores static config extraction for projects importing defineConfig from vite, fixes vp create for org templates on registries that strip custom package fields, cleans up terminal output after Ctrl-C during vp run, and updates bundled Vite to 8.1.3.

Highlights

• Custom VP_HOME is honored on every run: the global vp now respects a user-set VP_HOME for its home directory instead of falling back to ~/.vite-plus, and persists it in the generated env files, so a custom install location no longer produces multiple instances or unusable packages (#2029), by @liangmiQwQ

Features

• Upgrade bundled Vite from 8.1.2 to 8.1.3 (inlined CSS after the shebang line, CSS preload for nested dynamic imports, SSR stacktrace column fix) (#2042), by @voidzero-guard[bot]

Fixes & Enhancements

• vp run no longer misreads a vite.config.ts when its defineConfig comes from a preset or a custom wrapper instead of vite-plus or vite. Such configs are now evaluated at runtime rather than assumed to be Vite+'s own, so projects that use them no longer wrongly report Task "build" not found (#2060, #2075), by @liangmiQwQ and @fengmk2
• Killing a vp run task with Ctrl-C no longer leaves odd OSC escape sequences in the terminal; vp defers its own Ctrl-C handling until the child process exits (#2079), by @forehalo
• vp migrate: rewriting a package.json prettier script now emits a single --check, so scripts that combined --check with --list-different / -l / -c no longer produce a duplicated vp fmt --check --check (#2044), by @shulaoda
• vp create @org:name: read the org template catalog (createConfig) from the published tarball when the registry (e.g. GitHub Packages) strips custom fields from packument metadata (#2063), by @hiro-daikin
• vp run: missing env vars requested through @voidzero-dev/vite-task-client now return undefined instead of null, preserving Vite production NODE_ENV semantics when builds run through vp run (vite-task#508, via #2076), by @wan9chi

Refactor

• static_config: drop the unreachable vite.config.json branch (#2045), and remove unused exported CLI helpers (#2046), by @shulaoda

Docs

• Update the announcement links and callout for the beta release (#2027), remove the stale Dockerfile.alpine comment (#2068), by @fengmk2
• Add the missing pnpm-workspace.yaml to the docs Dockerfile (#2059), by @wan-kong
• Refresh the root agent guide (#2072), by @jong-kyung

Chore

• Cross-compile Windows tests and CLI binaries on Linux with cargo-xwin (#1824), install local vite-plus builds through a local npm registry (#2021), fast docs format check for docs-only PRs (#2028), pack local dirs for the registry bridge instead of pkg.pr.new (#2038), remove the stale create workflow updater (#2061), and add PTY-based interactive CLI snapshot tests (#2052), by @fengmk2
• Cache vp run output for docs builds (#2006), by @wan9chi
• Remove legacy completion cleanup (#2050), by @nekomoyi
• Update the crate-ci/typos action (#2039) and GitHub Actions (#2055, #1905), by @renovate[bot]
• Refresh the Node.js release keyring (#2058) and the docs trusted-stack stats (#2064), by @voidzero-guard[bot]

Bundled Versions

Tool	Version	Source
vite	8.1.3	578ffb8
rolldown	1.1.4	6cbd233
tsdown	0.22.3	npm
vitest	4.1.9	npm
oxlint	1.72.0	npm
oxlint-tsgolint	0.24.0	npm
oxfmt	0.57.0	npm

Upgrade

vp upgrade

New Contributors

@wan-kong and @hiro-daikin made their first contributions.

Full Changelog: v0.2.2...v0.2.3

---

Merging this PR will trigger the release workflow.

[netlify]

✅ Deploy Preview for viteplus-preview canceled.

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

[github-actions]

Registry bridge build (fd1ae7e)

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

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

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

# Windows (PowerShell)
$env:VP_PR_VERSION="2081"; 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.fd1ae7eab160c92f3907a20e80e92d2e87403c20",
    "vite": "npm:@voidzero-dev/vite-plus-core@0.0.0-commit.fd1ae7eab160c92f3907a20e80e92d2e87403c20"
  }
}

[github-actions]

🐳 Docker preview image

Built from this PR's registry bridge build:

Image	Compressed size
ghcr.io/voidzero-dev/vite-plus:pr-2081	240MB

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

Quick check:

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

See docs/guide/docker.md for usage.

[wan9chi]

Discord announcement draft for v0.2.3 (copy-paste into the releases channel). Fenced so @mentions don't ping and emoji shortcodes stay literal.

:viteplus: **vite-plus v0.2.3 is out** :tada:

A reliability patch for config loading, project creation, and `vp run` output, on Vite 8.1.3.

**Highlights**
:hammer_and_wrench: `vp` reads `vite.config.ts` correctly when `defineConfig` comes from a preset or custom wrapper (no more false `Task "build" not found`)
:sparkles: Ctrl-C during `vp run` no longer leaves stray escape sequences in your terminal
:hammer_and_wrench: Custom `VP_HOME` is honored on every run
:package: Bundled Vite updated to 8.1.3

**Also in this release**
- `vp create @org:name` works on registries that strip custom package fields (e.g. GitHub Packages)
- `vp migrate` emits a single `--check` when rewriting prettier scripts
- Env vars missing at runtime return `undefined` instead of `null` under `vp run`

**Bundled versions**
vite `8.1.3`, rolldown `1.1.4`, tsdown `0.22.3`, vitest `4.1.9`, oxlint `1.72.0`, oxlint-tsgolint `0.24.0`, oxfmt `0.57.0`

**Upgrade**: `vp upgrade`

Full notes: <https://github.com/voidzero-dev/vite-plus/releases/tag/v0.2.3>
Thanks to new contributors [@wan-kong](https://github.com/wan-kong) and [@hiro-daikin](https://github.com/hiro-daikin) :wave: