vite-plus 1.5.0 → 1.6.0

package/docs/guide/package-management/team.md

@@ -0,0 +1,140 @@
+# vp pm team
+
+Manage registry organization teams and their membership.
+
+```bash
+vp pm team list my-org
+vp pm team list my-org:developers --json
+vp pm team create my-org:developers
+vp pm team add my-org:developers alice
+vp pm team rm my-org:developers alice
+vp pm team destroy my-org:developers
+```
+
+## Options
+
+- `create <scope:team>` creates a team.
+- `destroy <scope:team>` deletes a team.
+- `add <scope:team> <user>` adds a member.
+- `rm <scope:team> <user>` removes a member. Alias: `remove`.
+- `list <scope[:team]>` lists an organization's teams or a team's members. Alias: `ls`.
+
+All subcommands accept `--registry <url>`, `--otp <code>`, and `--json`. JSON output retains the native manager's schema. Registry permissions determine which changes the authenticated account may make.
+
+### `create`
+
+| Option             | Description                 | Notes                             |
+| ------------------ | --------------------------- | --------------------------------- |
+| `--otp <otp>`      | Supply a one-time password. |                                   |
+| `--json`           | Request native JSON output. | Output retains the native schema. |
+| `--registry <url>` | Select the registry.        |                                   |
+
+### `destroy`
+
+| Option             | Description                 | Notes                             |
+| ------------------ | --------------------------- | --------------------------------- |
+| `--otp <otp>`      | Supply a one-time password. |                                   |
+| `--json`           | Request native JSON output. | Output retains the native schema. |
+| `--registry <url>` | Select the registry.        |                                   |
+
+### `add`
+
+| Option             | Description                 | Notes                             |
+| ------------------ | --------------------------- | --------------------------------- |
+| `--otp <otp>`      | Supply a one-time password. |                                   |
+| `--json`           | Request native JSON output. | Output retains the native schema. |
+| `--registry <url>` | Select the registry.        |                                   |
+
+### `rm`
+
+| Option             | Description                 | Notes                             |
+| ------------------ | --------------------------- | --------------------------------- |
+| `--otp <otp>`      | Supply a one-time password. |                                   |
+| `--json`           | Request native JSON output. | Output retains the native schema. |
+| `--registry <url>` | Select the registry.        |                                   |
+
+### `list`
+
+| Option             | Description                 | Notes                             |
+| ------------------ | --------------------------- | --------------------------------- |
+| `--otp <otp>`      | Supply a one-time password. |                                   |
+| `--json`           | Request native JSON output. | Output retains the native schema. |
+| `--registry <url>` | Select the registry.        |                                   |
+
+## Compatibility
+
+Fallbacks to npm emit warnings.
+
+### `create`
+
+- **npm:** `npm team create`.
+- **pnpm:** 11.13.0 or later: `pnpm team create`. Earlier versions use `npm team create` as a fallback.
+- **Yarn Classic:** `yarn team create`.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** Fallback: `npm team create`.
+
+| Option             | npm | pnpm | Yarn Classic    | Yarn Modern | Bun | Notes                                                                       |
+| ------------------ | --- | ---- | --------------- | ----------- | --- | --------------------------------------------------------------------------- |
+| `--otp <otp>`      | Yes | Yes  | 1.12.1 or later | No          | Yes | Older Yarn Classic can ignore --otp. Vite+ does not check its version here. |
+| `--json`           | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+| `--registry <url>` | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+
+### `destroy`
+
+- **npm:** `npm team destroy`.
+- **pnpm:** 11.13.0 or later: `pnpm team destroy`. Earlier versions use `npm team destroy` as a fallback.
+- **Yarn Classic:** `yarn team destroy`.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** Fallback: `npm team destroy`.
+
+| Option             | npm | pnpm | Yarn Classic    | Yarn Modern | Bun | Notes                                                                       |
+| ------------------ | --- | ---- | --------------- | ----------- | --- | --------------------------------------------------------------------------- |
+| `--otp <otp>`      | Yes | Yes  | 1.12.1 or later | No          | Yes | Older Yarn Classic can ignore --otp. Vite+ does not check its version here. |
+| `--json`           | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+| `--registry <url>` | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+
+### `add`
+
+- **npm:** `npm team add`.
+- **pnpm:** 11.13.0 or later: `pnpm team add`. Earlier versions use `npm team add` as a fallback.
+- **Yarn Classic:** `yarn team add`.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** Fallback: `npm team add`.
+
+| Option             | npm | pnpm | Yarn Classic    | Yarn Modern | Bun | Notes                                                                       |
+| ------------------ | --- | ---- | --------------- | ----------- | --- | --------------------------------------------------------------------------- |
+| `--otp <otp>`      | Yes | Yes  | 1.12.1 or later | No          | Yes | Older Yarn Classic can ignore --otp. Vite+ does not check its version here. |
+| `--json`           | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+| `--registry <url>` | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+
+### `rm`
+
+- **npm:** `npm team rm`.
+- **pnpm:** 11.13.0 or later: `pnpm team rm`. Earlier versions use `npm team rm` as a fallback.
+- **Yarn Classic:** `yarn team remove`.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** Fallback: `npm team rm`.
+
+| Option             | npm | pnpm | Yarn Classic    | Yarn Modern | Bun | Notes                                                                       |
+| ------------------ | --- | ---- | --------------- | ----------- | --- | --------------------------------------------------------------------------- |
+| `--otp <otp>`      | Yes | Yes  | 1.12.1 or later | No          | Yes | Older Yarn Classic can ignore --otp. Vite+ does not check its version here. |
+| `--json`           | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+| `--registry <url>` | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+
+### `list`
+
+- **npm:** `npm team ls`.
+- **pnpm:** 11.13.0 or later: `pnpm team ls`. Earlier versions use `npm team ls` as a fallback.
+- **Yarn Classic:** `yarn team list`.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** Fallback: `npm team ls`.
+
+| Option             | npm | pnpm | Yarn Classic    | Yarn Modern | Bun | Notes                                                                       |
+| ------------------ | --- | ---- | --------------- | ----------- | --- | --------------------------------------------------------------------------- |
+| `--otp <otp>`      | Yes | Yes  | 1.12.1 or later | No          | Yes | Older Yarn Classic can ignore --otp. Vite+ does not check its version here. |
+| `--json`           | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+| `--registry <url>` | Yes | Yes  | Yes             | No          | Yes |                                                                             |
+
+## Native Options
+
+For native options, see [npm team](https://docs.npmjs.com/cli/v11/commands/npm-team), [pnpm team](https://pnpm.io/cli/team), and [Yarn Classic team](https://classic.yarnpkg.com/en/docs/cli/team). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/token.md

@@ -0,0 +1,87 @@
+# vp pm token
+
+Manage registry authentication tokens.
+
+```bash
+vp pm token list
+vp pm token list --json
+vp pm token revoke <token-id>
+```
+
+## Options
+
+- `list`, also spelled `ls`, lists tokens. Supports `--json` and `--registry <url>`.
+- `create` requests a new token. Supports `--json`, `--registry <url>`, `--readonly`, and repeatable `--cidr <range>` restrictions.
+- `revoke <token-or-id>` revokes a token. Supports `--registry <url>`.
+
+Treat tokens as secrets. Prefer a token ID for revocation rather than placing a raw token in shell history. Token creation and supported token types depend on the registry's current policy and the native package manager version; exposing `create` does not guarantee that a registry permits CLI token creation.
+
+### `list`
+
+| Option             | Description                 | Notes                             |
+| ------------------ | --------------------------- | --------------------------------- |
+| `--json`           | Request native JSON output. | Output retains the native schema. |
+| `--registry <url>` | Select the registry.        |                                   |
+
+### `create`
+
+| Option             | Description                           | Notes                             |
+| ------------------ | ------------------------------------- | --------------------------------- |
+| `--json`           | Request native JSON output.           | Output retains the native schema. |
+| `--registry <url>` | Select the registry.                  |                                   |
+| `--cidr <cidr>`    | CIDR ranges to restrict the token to. | Can be repeated.                  |
+| `--readonly`       | Create a read-only token.             |                                   |
+
+### `revoke`
+
+| Option             | Description          | Notes |
+| ------------------ | -------------------- | ----- |
+| `--registry <url>` | Select the registry. |       |
+
+## Compatibility
+
+### `list`
+
+- **npm:** `npm token list`.
+- **pnpm:** 12.13 or later: `pnpm token list`. Earlier versions use `npm token list` as a fallback.
+- **Yarn Classic:** Fallback: `npm token list`.
+- **Yarn Modern:** Fallback: `npm token list`.
+- **Bun:** Fallback: `npm token list`.
+
+| Option             | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
+| ------------------ | --- | ---- | ------------ | ----------- | --- | ----- |
+| `--json`           | Yes | Yes  | Yes          | Yes         | Yes |       |
+| `--registry <url>` | Yes | Yes  | Yes          | Yes         | Yes |       |
+
+### `create`
+
+- **npm:** `npm token create`.
+- **pnpm:** 12.13 or later: `pnpm token create`. Earlier versions use `npm token create` as a fallback.
+- **Yarn Classic:** Fallback: `npm token create`.
+- **Yarn Modern:** Fallback: `npm token create`.
+- **Bun:** Fallback: `npm token create`.
+
+| Option             | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
+| ------------------ | --- | ---- | ------------ | ----------- | --- | ----- |
+| `--json`           | Yes | Yes  | Yes          | Yes         | Yes |       |
+| `--registry <url>` | Yes | Yes  | Yes          | Yes         | Yes |       |
+| `--cidr <cidr>`    | Yes | Yes  | Yes          | Yes         | Yes |       |
+| `--readonly`       | Yes | Yes  | Yes          | Yes         | Yes |       |
+
+### `revoke`
+
+- **npm:** `npm token revoke`.
+- **pnpm:** 12.13 or later: `pnpm token revoke`. Earlier versions use `npm token revoke` as a fallback.
+- **Yarn Classic:** Fallback: `npm token revoke`.
+- **Yarn Modern:** Fallback: `npm token revoke`.
+- **Bun:** Fallback: `npm token revoke`.
+
+| Option             | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
+| ------------------ | --- | ---- | ------------ | ----------- | --- | ----- |
+| `--registry <url>` | Yes | Yes  | Yes          | Yes         | Yes |       |
+
+`revoke` accepts one token or ID. Authentication, password prompts, and token resolution follow the native command. Vite+ does not normalize token types or output schemas.
+
+## Native Options
+
+For native options, see [npm token](https://docs.npmjs.com/cli/v11/commands/npm-token) and [pnpm token](https://pnpm.io/cli/token). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/unlink.md

@@ -0,0 +1,33 @@
+# vp unlink
+
+Remove native package-manager links created for local development.
+
+```bash
+vp unlink my-library
+```
+
+## Options
+
+An optional package name or directory is forwarded to the manager. `-r, --recursive` requests unlinking across workspaces where supported.
+
+| Option            | Description                        | Notes |
+| ----------------- | ---------------------------------- | ----- |
+| `-r, --recursive` | Unlink in every workspace package. |       |
+
+## Compatibility
+
+- **npm:** `npm unlink`.
+- **pnpm:** `pnpm unlink`.
+- **Yarn Classic:** `yarn unlink`.
+- **Yarn Modern:** 3 or later: `yarn unlink`. Earlier versions warn and skip.
+- **Bun:** `bun unlink`.
+
+| Option            | npm            | pnpm | Yarn Classic | Yarn Modern | Bun | Notes                            |
+| ----------------- | -------------- | ---- | ------------ | ----------- | --- | -------------------------------- |
+| `-r, --recursive` | 8.1.0 or later | Yes  | No           | 3 or later  | No  | npm includes the workspace root. |
+
+Operand and manifest-update behavior follow the native manager. This does not remove packages from Vite+'s [global store](./global-packages).
+
+## Native Options
+
+For native options, see [npm unlink](https://docs.npmjs.com/cli/v11/commands/npm-uninstall), [pnpm unlink](https://pnpm.io/cli/unlink), [Yarn unlink](https://yarnpkg.com/cli/unlink), [Yarn Classic unlink](https://classic.yarnpkg.com/en/docs/cli/unlink), and [Bun unlink](https://bun.com/docs/pm/cli/link). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/update.md

@@ -0,0 +1,62 @@
+# vp update
+
+Update project dependencies using the selected manager's update rules. Alias: `vp up`.
+
+```bash
+vp update
+vp update react
+vp update --latest
+vp update -g
+```
+
+## Options
+
+| Option                      | Description                                                                      | Notes                                                                        |
+| --------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| `-L, --latest`              | Update to latest version (ignore semver range).                                  | Global mode clears recorded version ranges.                                  |
+| `-g, --global`              | Update global packages.                                                          | Requires the global CLI. Uses the [global package store](./global-packages). |
+| `--concurrency <number>`    | Number of global package updates to run in parallel.                             | Requires --global. Must be a positive integer.                               |
+| `--reinstall-node-mismatch` | Reinstall up-to-date global packages installed with a different Node.js version. | Requires --global.                                                           |
+| `--ignore-node-mismatch`    | Skip up-to-date global packages installed with a different Node.js version.      | Requires --global.                                                           |
+| `-r, --recursive`           | Update recursively in all workspace packages.                                    |                                                                              |
+| `--filter <pattern>`        | Select workspaces by pattern.                                                    | Can be repeated.                                                             |
+| `-w, --workspace-root`      | Include workspace root.                                                          |                                                                              |
+| `-D, --dev`                 | Select development dependencies.                                                 |                                                                              |
+| `-P, --prod`                | Select production dependencies.                                                  |                                                                              |
+| `-i, --interactive`         | Interactive mode.                                                                |                                                                              |
+| `--no-optional`             | Exclude optionalDependencies.                                                    |                                                                              |
+| `--no-save`                 | Request native no-save behavior.                                                 |                                                                              |
+| `--workspace`               | Update only dependencies available in the workspace.                             |                                                                              |
+
+## Compatibility
+
+The commands below describe project operations. Global mode is described under [Options](#options).
+
+- **npm:** `npm update`.
+- **pnpm:** `pnpm update`.
+- **Yarn Classic:** `yarn upgrade` or `yarn upgrade-interactive`.
+- **Yarn Modern:** `yarn up`.
+- **Bun:** `bun update`.
+
+| Option                      | npm              | pnpm | Yarn Classic | Yarn Modern                  | Bun          | Notes |
+| --------------------------- | ---------------- | ---- | ------------ | ---------------------------- | ------------ | ----- |
+| `-L, --latest`              | Global mode only | Yes  | Yes          | Yes                          | Yes          |       |
+| `-g, --global`              | Yes              | Yes  | Yes          | Yes                          | Yes          |       |
+| `--concurrency <number>`    | Yes              | Yes  | Yes          | Yes                          | Yes          |       |
+| `--reinstall-node-mismatch` | Yes              | Yes  | Yes          | Yes                          | Yes          |       |
+| `--ignore-node-mismatch`    | Yes              | Yes  | Yes          | Yes                          | Yes          |       |
+| `-r, --recursive`           | 8.1.0 or later   | Yes  | No           | Yes                          | 1.4 or later |       |
+| `--filter <pattern>`        | 7.14.0 or later  | Yes  | One filter   | No                           | 1.4 or later |       |
+| `-w, --workspace-root`      | 8.1.0 or later   | Yes  | No           | No                           | No           |       |
+| `-D, --dev`                 | Yes              | Yes  | No           | No                           | 1.4 or later |       |
+| `-P, --prod`                | 7 or later       | Yes  | Yes          | No                           | 1.4 or later |       |
+| `-i, --interactive`         | No               | Yes  | Yes          | Yes                          | Yes          |       |
+| `--no-optional`             | Yes              | Yes  | Yes          | No                           | 1.4 or later |       |
+| `--no-save`                 | Yes              | Yes  | No           | --recursive without --latest | Yes          |       |
+| `--workspace`               | No               | Yes  | No           | No                           | No           |       |
+
+To change a dependency's declared range on npm, use [add](./add) with a new version specification. Yarn Modern follows project-wide update semantics. Recursive mode without `--latest` re-resolves existing ranges without rewriting manifests; combining it with `--latest` uses ordinary `yarn up`.
+
+## Native Options
+
+For native options, see [npm update](https://docs.npmjs.com/cli/v11/commands/npm-update), [pnpm update](https://pnpm.io/cli/update), [Yarn up](https://yarnpkg.com/cli/up), [Yarn Classic upgrade](https://classic.yarnpkg.com/en/docs/cli/upgrade), [Yarn Classic upgrade-interactive](https://classic.yarnpkg.com/en/docs/cli/upgrade-interactive), and [Bun update](https://bun.com/docs/pm/cli/update). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/version.md

@@ -0,0 +1,36 @@
+# vp pm version
+
+Run the package manager's version command. This manages package versions, not the Vite+ version displayed by `vp --version`.
+
+```bash
+vp pm version patch
+vp pm version 2.0.0
+```
+
+## Options
+
+Supply a version or increment strategy such as `major`, `minor`, or `patch`. Omitting it retains the manager's native behavior, which may display information, prompt, or require a strategy.
+
+| Option   | Description                 | Notes                             |
+| -------- | --------------------------- | --------------------------------- |
+| `--json` | Request native JSON output. | Output retains the native schema. |
+
+## Compatibility
+
+- **npm:** `npm version`.
+- **pnpm:** `pnpm version`.
+- **Yarn Classic:** `yarn version`.
+- **Yarn Modern:** `yarn version`.
+- **Bun:** 1.2.18 or later: `bun pm version`. Earlier versions warn before the command is invoked.
+
+| Option   | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
+| -------- | --- | ---- | ------------ | ----------- | --- | ----- |
+| `--json` | Yes | Yes  | Yes          | No          | No  |       |
+
+Yarn Classic converts increment strategies to flags such as `--patch`. An explicit version becomes `--new-version <version>`. Other managers retain their native operand syntax.
+
+Version commands can modify manifests and lockfiles and may create Git commits or tags. Vite+ preserves the selected manager's behavior.
+
+## Native Options
+
+For native options, see [npm version](https://docs.npmjs.com/cli/v11/commands/npm-version), [pnpm version](https://pnpm.io/cli/version), [Yarn version](https://yarnpkg.com/cli/version), [Yarn Classic version](https://classic.yarnpkg.com/en/docs/cli/version), and [Bun pm version](https://bun.com/docs/pm/cli/pm). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/whoami.md

@@ -0,0 +1,30 @@
+# vp pm whoami
+
+Show the account authenticated with the registry.
+
+```bash
+vp pm whoami
+vp pm whoami --registry https://registry.npmjs.org
+```
+
+## Options
+
+| Option             | Description          | Notes |
+| ------------------ | -------------------- | ----- |
+| `--registry <url>` | Select the registry. |       |
+
+## Compatibility
+
+- **npm:** `npm whoami`.
+- **pnpm:** 11 or later: `pnpm whoami`. Earlier versions use `npm whoami` as a fallback.
+- **Yarn Classic:** No command. Warns and exits successfully without performing the operation.
+- **Yarn Modern:** `yarn npm whoami`.
+- **Bun:** `bun pm whoami`.
+
+| Option             | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes                                           |
+| ------------------ | --- | ---- | ------------ | ----------- | --- | ----------------------------------------------- |
+| `--registry <url>` | Yes | Yes  | No           | No          | Yes | Configure the registry in Yarn Modern settings. |
+
+## Native Options
+
+For native options, see [npm whoami](https://docs.npmjs.com/cli/v11/commands/npm-whoami), [pnpm whoami](https://pnpm.io/cli/whoami), [Yarn npm whoami](https://yarnpkg.com/cli/npm/whoami), and [Bun pm whoami](https://bun.com/docs/pm/cli/pm). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/why.md

@@ -0,0 +1,55 @@
+# vp why
+
+Explain why a dependency is installed. Alias: `vp explain`.
+
+```bash
+vp why react
+vp why react --json
+vp why react --filter web
+```
+
+## Options
+
+| Option                    | Description                                     | Notes                             |
+| ------------------------- | ----------------------------------------------- | --------------------------------- |
+| `--json`                  | Request native JSON output.                     | Output retains the native schema. |
+| `--long`                  | Show extended information.                      |                                   |
+| `--parseable`             | Show parseable output.                          |                                   |
+| `-r, --recursive`         | Check recursively across all workspaces.        |                                   |
+| `--filter <pattern>`      | Select workspaces by pattern.                   | Can be repeated.                  |
+| `-w, --workspace-root`    | Check in workspace root.                        |                                   |
+| `-P, --prod`              | Only production dependencies.                   |                                   |
+| `-D, --dev`               | Only dev dependencies.                          |                                   |
+| `--depth <depth>`         | Limit tree depth.                               |                                   |
+| `--no-optional`           | Exclude optional dependencies.                  |                                   |
+| `--exclude-peers`         | Exclude peer dependencies.                      |                                   |
+| `--find-by <finder_name>` | Use a finder function defined in .pnpmfile.cjs. |                                   |
+
+## Compatibility
+
+- **npm:** `npm explain`.
+- **pnpm:** `pnpm why`.
+- **Yarn Classic:** `yarn why`. With multiple package names, warns and checks only the first.
+- **Yarn Modern:** `yarn why`. With multiple package names, warns and checks only the first.
+- **Bun:** `bun why`.
+
+| Option                    | npm             | pnpm             | Yarn Classic | Yarn Modern | Bun | Notes                                  |
+| ------------------------- | --------------- | ---------------- | ------------ | ----------- | --- | -------------------------------------- |
+| `--json`                  | Yes             | Yes              | Yes          | Yes         | No  |                                        |
+| `--long`                  | No              | Yes              | No           | No          | No  |                                        |
+| `--parseable`             | No              | Yes              | No           | No          | No  |                                        |
+| `-r, --recursive`         | 7.14.0 or later | Yes              | No           | Yes         | No  |                                        |
+| `--filter <pattern>`      | 7.14.0 or later | Yes              | No           | No          | No  |                                        |
+| `-w, --workspace-root`    | No              | Yes              | No           | No          | No  |                                        |
+| `-P, --prod`              | No              | Yes              | No           | No          | No  |                                        |
+| `-D, --dev`               | No              | Yes              | No           | No          | No  |                                        |
+| `--depth <depth>`         | No              | Yes              | No           | No          | Yes |                                        |
+| `--no-optional`           | No              | Yes              | No           | No          | No  |                                        |
+| `--exclude-peers`         | No              | Yes              | No           | Yes         | No  | Yarn Modern includes peers by default. |
+| `--find-by <finder_name>` | No              | 10.16.0 or later | No           | No          | No  |                                        |
+
+The dependency graph does not include tools Vite+ bundles or compiles. For readable output, Vite+ shows a hint when it also provides the requested package. Use `vp toolchain [tool]` to inspect bundled tools.
+
+## Native Options
+
+For native options, see [npm explain](https://docs.npmjs.com/cli/v11/commands/npm-explain), [pnpm why](https://pnpm.io/cli/why), [Yarn why](https://yarnpkg.com/cli/why), [Yarn Classic why](https://classic.yarnpkg.com/en/docs/cli/why), and [Bun why](https://bun.com/docs/pm/cli/why). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/run.md

@@ -354,12 +354,34 @@ Task Details:
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
+When a task misses the cache, the summary lists every change that caused the miss. Use `-vv` (or `--verbose --verbose`) to also list each cached run's unchanged inputs, under `Unchanged:`, and the files a cache hit restores, under `Outputs:`. If a run hits the cache when you expected a miss, `-vv` shows whether the file you edited is an input at all.
+
 Use `--last-details` to show the summary from the last run without running tasks again:
 
 ```bash
 vp run --last-details
 ```
 
+## Dry Runs And JSON Output
+
+`--dry-run` shows what a run would do without running anything. It prints each command with its cache status, then the summary. Vite Task checks the cache as a real run would, but writes nothing:
+
+```bash
+vp run --dry-run -r build
+```
+
+`--json` prints JSON instead of text, for scripts and agents:
+
+- `vp run --json`, with no task or other flags, prints every package and task in the workspace, with each task's `dependsOn` resolved, and runs nothing. See the [task graph schema](https://github.com/voidzero-dev/vite-task/blob/cb1ea8d214b26a0f3ca2b2ef3b6bc471b18ffacb/crates/vt/schemas/task-graph.json).
+- `vp run --dry-run --json build` prints the plan for a run: each task it would run, the tasks each one waits for, each step's command, and whether each step would hit the cache. With a task, `--json` only works together with `--dry-run`. See the [run plan schema](https://github.com/voidzero-dev/vite-task/blob/cb1ea8d214b26a0f3ca2b2ef3b6bc471b18ffacb/crates/vt/schemas/run-plan.json).
+
+Add `-v` or `-vv` for more detail:
+
+- On its own, `--dry-run` shows the first change it finds behind each miss. With `-v`, the summary lists every change.
+- `-vv` with `--dry-run --json` adds each step's `baseline.fingerprint` and `baseline.outputs`: the inputs its cached run recorded, and the outputs a hit would restore.
+
+Put these flags before the task name. Anything after the task name is passed to the task.
+
 ## Concurrency
 
 By default, up to 4 tasks run at the same time. Use `--concurrency-limit` to change this:

package/docs/guide/vpx.md

@@ -253,7 +253,7 @@ vp exec tsc --noEmit
 
 ## `vp dlx`
 
-Use `vp dlx` for one-off package execution without adding the package to your project dependencies.
+Use `vp dlx` for one-off package execution without adding the package to your project dependencies. See the [dlx command reference](/guide/package-management/dlx) for options and package-manager compatibility.
 
 ```bash
 vp dlx <package> [args...]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plus",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "The Unified Toolchain for the Web",
   "homepage": "https://viteplus.dev/guide",
   "bugs": {
@@ -345,9 +345,9 @@
     }
   },
   "dependencies": {
-    "@oxc-project/runtime": "=0.157.0",
-    "@oxc-project/types": "=0.157.0",
-    "@oxlint/plugins": "=1.91.0",
+    "@oxc-project/runtime": "=0.158.0",
+    "@oxc-project/types": "=0.158.0",
+    "@oxlint/plugins": "=1.93.0",
     "@vitest/browser": "5.1.0",
     "@vitest/browser-preview": "5.1.0",
     "@vitest/mocker": "5.1.0",
@@ -355,22 +355,22 @@
     "@vitest/snapshot": "5.1.0",
     "@vitest/spy": "5.1.0",
     "@vitest/utils": "5.1.0",
-    "oxfmt": "=0.76.0",
-    "oxlint": "=1.91.0",
-    "oxlint-tsgolint": "=7.0.2005",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.5.0",
+    "oxfmt": "=0.78.0",
+    "oxlint": "=1.93.0",
+    "oxlint-tsgolint": "=7.0.2006",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.6.0",
     "vitest": "5.1.0"
   },
   "devDependencies": {
     "@emnapi/core": "2.0.0-beta.2",
     "@emnapi/runtime": "2.0.0-beta.2",
-    "@napi-rs/cli": "^3.10.0",
+    "@napi-rs/cli": "^3.10.12",
     "@nkzw/safe-word-list": "^3.1.0",
     "@types/cross-spawn": "^6.0.6",
     "@types/validate-npm-package-name": "^4.0.2",
     "@vitest/browser-playwright": "5.1.0",
     "@vitest/browser-webdriverio": "5.0.0",
-    "@voidzero-dev/vite-plus-prompts": "1.5.0",
+    "@voidzero-dev/vite-plus-prompts": "1.6.0",
     "@voidzero-dev/vite-task-client": "0.2.0",
     "bingo": "^0.13.2",
     "cac": "^7.1.0",
@@ -424,14 +424,14 @@
     "node": "^22.18.0 || ^24.11.0 || >=26.0.0"
   },
   "optionalDependencies": {
-    "@voidzero-dev/vite-plus-darwin-arm64": "1.5.0",
-    "@voidzero-dev/vite-plus-darwin-x64": "1.5.0",
-    "@voidzero-dev/vite-plus-linux-arm64-gnu": "1.5.0",
-    "@voidzero-dev/vite-plus-linux-arm64-musl": "1.5.0",
-    "@voidzero-dev/vite-plus-linux-x64-gnu": "1.5.0",
-    "@voidzero-dev/vite-plus-linux-x64-musl": "1.5.0",
-    "@voidzero-dev/vite-plus-win32-x64-msvc": "1.5.0",
-    "@voidzero-dev/vite-plus-win32-arm64-msvc": "1.5.0"
+    "@voidzero-dev/vite-plus-darwin-arm64": "1.6.0",
+    "@voidzero-dev/vite-plus-darwin-x64": "1.6.0",
+    "@voidzero-dev/vite-plus-linux-arm64-gnu": "1.6.0",
+    "@voidzero-dev/vite-plus-linux-arm64-musl": "1.6.0",
+    "@voidzero-dev/vite-plus-linux-x64-gnu": "1.6.0",
+    "@voidzero-dev/vite-plus-linux-x64-musl": "1.6.0",
+    "@voidzero-dev/vite-plus-win32-x64-msvc": "1.6.0",
+    "@voidzero-dev/vite-plus-win32-arm64-msvc": "1.6.0"
   },
   "scripts": {
     "build": "oxnode -C dev ./build.ts",