fix(cli): prevent download progress from overwriting terminal output by fengmk2 · Pull Request #2741 · voidzero-dev/vite-plus

fengmk2 · 2026-09-18T12:26:31Z

Node.js and package-manager downloads can erase earlier terminal output when the progress display moves the cursor upward.

Both downloaders now fit the entire progress display to one terminal row. When space is limited, the display uses compact statistics and shortens the download name as needed. The layout uses the current terminal width on each redraw and clears the row when the download ends.

Narrow terminal fix

The video compares 7c51cc1 with 6bfe6c4 at 40, 60, 80, and 138 columns. It shows downloads with and without a known total size.

vp-download-progress-widths-before-after.mp4

Original terminal output fix

This video compares the reported recording with the first fix in 7c51cc1.

vp-download-progress-before-after.mp4

github-actions · 2026-09-18T12:34:56Z

CLI artifact sizes (`6224e9f`)

Final release artifacts built by the canonical build-upstream and build-windows-cli actions.
The dist rows use the Linux build. The core total excludes .node files to match the release artifact.

Artifact	Format	Base	PR	Change
`packages/cli/dist`	Directory total	2.15 MiB	2.15 MiB	0 B (0.00%)
`packages/core/dist`	Directory total	3.95 MiB	3.95 MiB	0 B (0.00%)
Combined package dist	Directory total	6.09 MiB	6.09 MiB	0 B (0.00%)
`vp` (Linux x64)	Binary	11.23 MiB	11.24 MiB	+12.00 KiB (+0.10%)
`vp` (Linux x64)	gzip -9	4.86 MiB	4.86 MiB	+3.99 KiB (+0.08%)
NAPI (Linux x64)	Binary	32.03 MiB	32.04 MiB	+12.00 KiB (+0.04%)
NAPI (Linux x64)	gzip -9	12.70 MiB	12.70 MiB	+4.71 KiB (+0.04%)
`vp` (macOS ARM64)	Binary	8.38 MiB	8.38 MiB	0 B (0.00%)
`vp` (macOS ARM64)	gzip -9	4.24 MiB	4.24 MiB	+5.57 KiB (+0.13%)
NAPI (macOS ARM64)	Binary	39.66 MiB	39.66 MiB	0 B (0.00%)
NAPI (macOS ARM64)	gzip -9	17.01 MiB	17.02 MiB	+7.11 KiB (+0.04%)
`vp` (Windows x64)	Binary	9.11 MiB	9.12 MiB	+15.50 KiB (+0.17%)
`vp` (Windows x64)	gzip -9	3.97 MiB	3.99 MiB	+14.25 KiB (+0.35%)
NAPI (Windows x64)	Binary	27.00 MiB	27.01 MiB	+12.00 KiB (+0.04%)
NAPI (Windows x64)	gzip -9	10.81 MiB	10.81 MiB	+6.05 KiB (+0.05%)
Trampoline (Windows x64)	Binary	13.50 KiB	13.50 KiB	0 B (0.00%)
Trampoline (Windows x64)	gzip -9	7.03 KiB	7.03 KiB	-1 B (-0.01%)
Installer (Windows x64)	Binary	4.54 MiB	4.55 MiB	+9.00 KiB (+0.19%)
Installer (Windows x64)	gzip -9	2.12 MiB	2.13 MiB	+4.90 KiB (+0.23%)

cloudflare-workers-and-pages · 2026-09-18T12:35:41Z

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://fix-download-progress-terminal-viteplus-dev.voidzero-docs.workers.dev (commit `6224e9f`)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status	Deployment URL	Commit	Updated (UTC)	See this deployment's details
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://d3df4b0e-viteplus-dev.voidzero-docs.workers.dev	`6224e9f`	2026-09-19T05:28:14.586Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://fa33d600-viteplus-dev.voidzero-docs.workers.dev	`e64c347`	2026-09-19T05:09:40.718Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://81d396fc-viteplus-dev.voidzero-docs.workers.dev	`03fe831`	2026-09-18T14:26:51.729Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://0c42c64b-viteplus-dev.voidzero-docs.workers.dev	`6bfe6c4`	2026-09-18T13:07:18.491Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://0f38e4db-viteplus-dev.voidzero-docs.workers.dev	`7c51cc1`	2026-09-18T12:38:44.154Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://07059c21-viteplus-dev.voidzero-docs.workers.dev	`a22afb6`	2026-09-18T12:27:03.657Z	Visit the dashboard ↗

github-actions · 2026-09-18T14:14:33Z

Registry bridge build (`03fe831`)

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

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

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/voidzero-dev/vite-plus/03fe831cd59553f5c606a16ed5826a702898a267/packages/cli/install.sh | VP_PR_VERSION=2741 VP_LEGACY_INSTALLER_URL=https://raw.githubusercontent.com/voidzero-dev/vite-plus/03fe831cd59553f5c606a16ed5826a702898a267/packages/cli/install-legacy.sh bash

# Windows (PowerShell)
$env:VP_PR_VERSION="2741"; $env:VP_LEGACY_INSTALLER_URL="https://raw.githubusercontent.com/voidzero-dev/vite-plus/03fe831cd59553f5c606a16ed5826a702898a267/packages/cli/install-legacy.ps1"; irm https://raw.githubusercontent.com/voidzero-dev/vite-plus/03fe831cd59553f5c606a16ed5826a702898a267/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.03fe831cd59553f5c606a16ed5826a702898a267" --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.03fe831cd59553f5c606a16ed5826a702898a267",
    "vite": "npm:@voidzero-dev/vite-plus-core@0.0.0-commit.03fe831cd59553f5c606a16ed5826a702898a267"
  }
}

github-actions · 2026-09-18T14:15:48Z

🐳 Docker preview image

Built from this PR's registry bridge build:

Image	Compressed size
`ghcr.io/voidzero-dev/vite-plus:pr-2741`	223MB

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

Quick check:

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

See docs/guide/docker.md for usage.

@fengmk2

…2780) Vite+ now uses Vitest 5, and `vp migrate` helps Vitest 4 projects adopt the new APIs and defaults. Standalone installs and upgrades now require verified npm provenance for release binaries. ### Breaking Changes #### Vitest 5 `vp test` and the public `vite-plus/test*` exports now use `vitest@5.0.1` ([#2551](#2551)), by @fengmk2. | Area | Old | New | | --- | --- | --- | | Test runner | `vitest@4.1.11` | `vitest@5.0.1` | | CLI Node.js range | `^20.19.0 \|\| ^22.18.0 \|\| >=24.11.0` | `^22.18.0 \|\| ^24.11.0 \|\| >=26.0.0` | | `vite-plus/test/runners` and `vite-plus/test/suite` | Vite+ compatibility exports | Use supported APIs from `vite-plus/test`; review unsupported runner and expect plugins | | `vite-plus/test/browser-webdriverio` | Bundled export | Use the community `@vitest/browser-webdriverio` package | Run `vp migrate` from the workspace root before you install the new dependencies. The migrator updates supported config, source, benchmark, command, and import changes. It reports manual work as `BLOCK` or `REVIEW` items. See the [Vitest 5 migration guide](https://viteplus.dev/guide/vitest-v5) for the full process. Projects can stay on the prior release until their runtimes and tests are ready. #### `vp staged` runtime requirements `vp staged` now uses `lint-staged@17.5.1` ([#2754](#2754)), by @fengmk2. | Requirement | Old | New | | --- | --- | --- | | Node.js for `vp staged` | The Vite+ CLI runtime range | `^22.22.1 \|\| ^24.11.0 \|\| >=26.0.0` | | Git | No separate documented minimum | `>=2.32.0` | Update Node.js and Git on developer machines and CI runners that execute `vp staged` or its pre-commit hook. Other workflows do not use these extra requirements. ### Highlights - Standalone installers, `vp upgrade`, and `vp-setup.exe` now reject release binaries without supported SLSA provenance ([#2440](#2440)), by @kazupon. - Installers now show progress and the exact shell activation command. Download progress preserves earlier terminal output ([#2744](#2744), [#2741](#2741)), by @fengmk2. - System-first runtime and package-manager shims now use a fallback directory at the end of `PATH`. Setup restores missing package-manager preferences ([#2758](#2758), [#2763](#2763)), by @liangmiQwQ and @fengmk2. - `vp run` now finishes when background processes remain. Large file traces run without caching instead of killing the task ([#2767](#2767), [vite-task#675](voidzero-dev/vite-task#675)), by @wan9chi. ### Features - `vp add` now supports shared install options such as `--offline`, `--frozen-lockfile`, and `--lockfile-only` ([#2722](#2722)), by @jong-kyung. - `vp pm patch` and `vp pm patch-commit` now use the native commands in npm 12 and later ([#2736](#2736)), by @jong-kyung. - `vp rebuild` now supports Yarn Berry and forwards package names and extra arguments ([#2761](#2761)), by @jong-kyung. - The bundled tools update `oxlint` `1.83.0` -> `1.85.0`, `oxlint-tsgolint` `7.0.2001` -> `7.0.2002`, and `oxfmt` `0.68.0` -> `0.70.0` ([#2745](#2745), [#2773](#2773), [#2778](#2778)), by @voidzero-guard[bot]. These versions can flag or format code that passed before. Run `vp fmt` after upgrading if CI runs `vp check`. ### Fixes & Enhancements - `oxlint` and `oxfmt` no longer expose bin wrappers that conflict with upstream packages. Editors must use `vp lint --lsp`, `vp fmt --lsp`, or `vp fmt --stdin-filepath` ([#2672](#2672)), by @fengmk2. - `vp create vite:generator` now replaces catalog references for package managers that do not support catalogs ([#2720](#2720)), by @SaKaNa-Y. - Unpinned npm projects now use the npm version bundled with the selected Node.js runtime. The same policy works during migration ([#2742](#2742), [#2748](#2748)), by @liangmiQwQ. - The CLI now loads its local versions module through a file URL, including on Windows paths ([#2749](#2749)), by @YanChenBai. - Package-manager commands now use pnpm when the project has no detected package manager ([#2750](#2750)), by @liangmiQwQ. - `vp migrate` now removes unused `@oxlint/plugins` dependencies after it rewrites plugin imports ([#2751](#2751)), by @fengmk2. - `vp update --no-save` now warns that Yarn Classic and Yarn Berry do not support the option ([#2762](#2762)), by @jong-kyung. - `vp migrate` now explains its `tsdown@0.23` compatibility settings and links to removal guidance ([#2769](#2769)), by @fengmk2. - Environment setup now installs and diagnoses the official `pn` and `pnx` aliases for pnpm ([#2770](#2770)), by @iruoy. - Cached tasks now receive GitHub Actions OIDC variables, so npm Trusted Publishing works through `vp run` ([vite-task#691](voidzero-dev/vite-task#691)), by @naokihaba. - Automatic task input tracking now records file access from signal handlers ([vite-task#687](voidzero-dev/vite-task#687)), by @wan9chi. ### Refactor - `vp lint`, `vp fmt`, and `vp check` now use native config discovery. Package commands keep matching workspace-root settings, while explicit config flags take precedence ([#2731](#2731)), by @fengmk2. ### Chore - Generated workflows and `vp migrate` now use `setup-vp@v1.21.1`, including its installation fixes ([#2760](#2760), [#2772](#2772)), by @renovate[bot] and @fengmk2. ### Bundled Versions | Tool | Version | Source | | --- | --- | --- | | vite | `8.3.0` | [`434e8e9`](vitejs/vite@434e8e9) | | rolldown | `1.2.9` | [`5b4746e`](rolldown/rolldown@5b4746e) | | tsdown | `0.23.0` | [npm](https://npmx.dev/package/tsdown/v/0.23.0) | | vitest | `5.0.1` | [npm](https://npmx.dev/package/vitest/v/5.0.1) | | oxlint | `1.85.0` | [npm](https://npmx.dev/package/oxlint/v/1.85.0) | | oxlint-tsgolint | `7.0.2002` | [npm](https://npmx.dev/package/oxlint-tsgolint/v/7.0.2002) | | oxfmt | `0.70.0` | [npm](https://npmx.dev/package/oxfmt/v/0.70.0) | ### Upgrade ```bash vp upgrade ``` ### New Contributors @YanChenBai, @iruoy **Full Changelog**: v0.3.3...v1.0.0-rc.0 --- 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>

fengmk2 force-pushed the fix/download-progress-terminal branch from a22afb6 to 7c51cc1 Compare September 18, 2026 12:37

fengmk2 self-assigned this Sep 18, 2026

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 18, 2026

fengmk2 marked this pull request as ready for review September 18, 2026 14:36

fengmk2 requested review from Brooooooklyn, camc314 and cpojer September 18, 2026 14:37

cpojer approved these changes Sep 18, 2026

View reviewed changes

fengmk2 force-pushed the fix/download-progress-terminal branch from 03fe831 to e64c347 Compare September 19, 2026 05:08

fengmk2 added 3 commits September 19, 2026 13:26

fix(cli): keep download progress on one row

879dc03

fix(cli): fit download progress to narrow terminals

c142239

refactor(cli): simplify download progress rendering and tests

6224e9f

fengmk2 force-pushed the fix/download-progress-terminal branch from e64c347 to 6224e9f Compare September 19, 2026 05:27

fengmk2 merged commit 604f904 into main Sep 19, 2026
137 of 139 checks passed

fengmk2 deleted the fix/download-progress-terminal branch September 19, 2026 05:48

fengmk2 mentioned this pull request Sep 22, 2026

release: v1.0.0-rc.0: Vitest 5 migration and npm provenance checks #2780

Merged

Navigation Menu

fix(cli): prevent download progress from overwriting terminal output - #2741

fix(cli): prevent download progress from overwriting terminal output#2741
fengmk2 merged 3 commits into
mainfrom
fix/download-progress-terminal

fengmk2 commented Sep 18, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Sep 18, 2026 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages Bot commented Sep 18, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Sep 18, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Sep 18, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

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

Uh oh!

Uh oh!

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

Uh oh!

CLI artifact sizes (6224e9f)

Uh oh!

cloudflare-workers-and-pages Bot commented Sep 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://fix-download-progress-terminal-viteplus-dev.voidzero-docs.workers.dev (commit 6224e9f)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Uh oh!

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

Uh oh!

Registry bridge build (03fe831)

Uh oh!

github-actions Bot commented Sep 18, 2026

🐳 Docker preview image

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

fengmk2 commented Sep 18, 2026 •

edited

Loading

github-actions Bot commented Sep 18, 2026 •

edited

Loading

CLI artifact sizes (`6224e9f`)

cloudflare-workers-and-pages Bot commented Sep 18, 2026 •

edited

Loading

Preview URL: https://fix-download-progress-terminal-viteplus-dev.voidzero-docs.workers.dev (commit `6224e9f`)

github-actions Bot commented Sep 18, 2026 •

edited

Loading

Registry bridge build (`03fe831`)