vite-plus 1.5.0 → 1.5.1

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

@@ -0,0 +1,60 @@
+# vp list
+
+List installed dependencies. Alias: `vp ls`. These top-level commands require the global CLI. Both the global and project-local CLI accept `vp pm list` and `vp pm ls`.
+
+```bash
+vp list
+vp list react --depth 2
+vp list --json
+vp list -g
+```
+
+## Options
+
+| Option                    | Description                       | Notes                                                                        |
+| ------------------------- | --------------------------------- | ---------------------------------------------------------------------------- |
+| `--depth <depth>`         | Maximum depth of dependency tree. |                                                                              |
+| `--json`                  | Request native JSON output.       | Output retains the native schema.                                            |
+| `--long`                  | Show extended information.        |                                                                              |
+| `--parseable`             | Parseable output format.          |                                                                              |
+| `-P, --prod`              | Only production dependencies.     |                                                                              |
+| `-D, --dev`               | Include dev dependencies.         |                                                                              |
+| `--no-optional`           | Exclude optional dependencies.    |                                                                              |
+| `--exclude-peers`         | Exclude peer dependencies.        |                                                                              |
+| `--only-projects`         | Show only project packages.       |                                                                              |
+| `--find-by <finder_name>` | Use a finder function.            |                                                                              |
+| `-r, --recursive`         | List across all workspaces.       |                                                                              |
+| `--filter <pattern>`      | Select workspaces by pattern.     | Can be repeated.                                                             |
+| `-g, --global`            | List global packages.             | Requires the global CLI. Uses the [global package store](./global-packages). |
+
+## Compatibility
+
+The commands below describe project operations. Global mode is described under [Options](#options).
+
+- **npm:** `npm list`.
+- **pnpm:** `pnpm list`.
+- **Yarn Classic:** `yarn list`.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** `bun pm ls`.
+
+| Option                    | npm             | pnpm             | Yarn Classic | Yarn Modern | Bun | Notes                                                             |
+| ------------------------- | --------------- | ---------------- | ------------ | ----------- | --- | ----------------------------------------------------------------- |
+| `--depth <depth>`         | Yes             | Yes              | Yes          | No          | No  |                                                                   |
+| `--json`                  | Yes             | Yes              | Yes          | No          | No  |                                                                   |
+| `--long`                  | Yes             | Yes              | No           | No          | No  |                                                                   |
+| `--parseable`             | Yes             | Yes              | No           | No          | No  |                                                                   |
+| `-P, --prod`              | Yes             | Yes              | Yes          | No          | No  | npm 6 uses `--production`, which also excludes peer dependencies. |
+| `-D, --dev`               | Yes             | Yes              | Yes          | No          | No  |                                                                   |
+| `--no-optional`           | 7 or later      | Yes              | No           | No          | No  |                                                                   |
+| `--exclude-peers`         | 7 or later      | Yes              | No           | No          | No  |                                                                   |
+| `--only-projects`         | No              | Yes              | No           | No          | No  |                                                                   |
+| `--find-by <finder_name>` | No              | 10.16.0 or later | No           | No          | No  |                                                                   |
+| `-r, --recursive`         | 7.14.0 or later | Yes              | No           | No          | No  |                                                                   |
+| `--filter <pattern>`      | 7.14.0 or later | Yes              | No           | No          | No  |                                                                   |
+| `-g, --global`            | Yes             | Yes              | Yes          | Yes         | Yes |                                                                   |
+
+These results describe installed packages, not Vite+'s bundled tools. Use `vp toolchain [tool]` to inspect bundled Vite, Rolldown, Oxc, and other tool versions.
+
+## Native Options
+
+For native options, see [npm ls](https://docs.npmjs.com/cli/v11/commands/npm-ls), [pnpm list](https://pnpm.io/cli/list), [Yarn Classic list](https://classic.yarnpkg.com/en/docs/cli/list), and [Bun pm ls](https://bun.com/docs/pm/cli/pm). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,34 @@
+# vp pm login
+
+Authenticate with a package registry. Alias: `vp pm adduser`.
+
+```bash
+vp pm login
+vp pm login --scope @my-org
+```
+
+## Options
+
+| Option             | Description          | Notes |
+| ------------------ | -------------------- | ----- |
+| `--registry <url>` | Select the registry. |       |
+| `--scope <scope>`  | Scope for the login. |       |
+
+## Compatibility
+
+- **npm:** `npm login`.
+- **pnpm:** 11 or later: `pnpm login`. Earlier versions use `npm login` as a fallback.
+- **Yarn Classic:** `yarn login`.
+- **Yarn Modern:** `yarn npm login`.
+- **Bun:** Fallback: `npm login`.
+
+| Option             | npm | pnpm                       | Yarn Classic | Yarn Modern | Bun | Notes                                    |
+| ------------------ | --- | -------------------------- | ------------ | ----------- | --- | ---------------------------------------- |
+| `--registry <url>` | Yes | Yes                        | No           | No          | Yes | Configure the registry in Yarn settings. |
+| `--scope <scope>`  | Yes | Before 11 or 11.2 or later | No           | Yes         | Yes |                                          |
+
+Authentication prompts and credential storage belong to the native command. pnpm login does not copy credentials to npm, so commands that still use npm may require a separate login. See [whoami](./whoami) to check the selected account and [logout](./logout) to end authentication.
+
+## Native Options
+
+For native options, see [npm login](https://docs.npmjs.com/cli/v11/commands/npm-login), [pnpm login](https://pnpm.io/cli/login), [Yarn npm login](https://yarnpkg.com/cli/npm/login), and [Yarn Classic login](https://classic.yarnpkg.com/en/docs/cli/login). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,34 @@
+# vp pm logout
+
+Log out from a package registry.
+
+```bash
+vp pm logout
+vp pm logout --scope @my-org
+```
+
+## Options
+
+| Option             | Description           | Notes |
+| ------------------ | --------------------- | ----- |
+| `--registry <url>` | Select the registry.  |       |
+| `--scope <scope>`  | Scope for the logout. |       |
+
+## Compatibility
+
+- **npm:** `npm logout`.
+- **pnpm:** 11 or later: `pnpm logout`. Earlier versions use `npm logout` as a fallback.
+- **Yarn Classic:** `yarn logout`.
+- **Yarn Modern:** `yarn npm logout`.
+- **Bun:** Fallback: `npm logout`.
+
+| Option             | npm | pnpm      | Yarn Classic | Yarn Modern | Bun | Notes                                    |
+| ------------------ | --- | --------- | ------------ | ----------- | --- | ---------------------------------------- |
+| `--registry <url>` | Yes | Yes       | No           | No          | Yes | Configure the registry in Yarn settings. |
+| `--scope <scope>`  | Yes | Before 11 | No           | Yes         | Yes |                                          |
+
+Credential removal and token invalidation follow the native manager and registry. Native pnpm logout does not run npm logout or perform additional credential cleanup. Use [login](./login) to authenticate again.
+
+## Native Options
+
+For native options, see [npm logout](https://docs.npmjs.com/cli/v11/commands/npm-logout), [pnpm logout](https://pnpm.io/cli/logout), [Yarn npm logout](https://yarnpkg.com/cli/npm/logout), and [Yarn Classic logout](https://classic.yarnpkg.com/en/docs/cli/logout). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,60 @@
+# vp outdated
+
+Check which dependencies have newer versions available.
+
+```bash
+vp outdated
+vp outdated react
+vp outdated --format json
+vp outdated -g
+```
+
+## Options
+
+| Option                         | Description                                         | Notes                                                                        |
+| ------------------------------ | --------------------------------------------------- | ---------------------------------------------------------------------------- |
+| `--long`                       | Show extended information.                          |                                                                              |
+| `--format <table\|list\|json>` | Select the output format.                           |                                                                              |
+| `-r, --recursive`              | Check recursively across all workspaces.            |                                                                              |
+| `--filter <pattern>`           | Select workspaces by pattern.                       | Can be repeated.                                                             |
+| `-w, --workspace-root`         | Include workspace root.                             |                                                                              |
+| `-P, --prod`                   | Only production and optional dependencies.          |                                                                              |
+| `-D, --dev`                    | Include dev dependencies.                           |                                                                              |
+| `--no-optional`                | Exclude optional dependencies.                      |                                                                              |
+| `--compatible`                 | Show only versions within compatible ranges.        |                                                                              |
+| `--sort-by <field>`            | Sort results by field.                              |                                                                              |
+| `-g, --global`                 | Check globally installed packages.                  | Requires the global CLI. Uses the [global package store](./global-packages). |
+| `--concurrency <number>`       | Number of global package checks to run in parallel. | Requires --global. Must be a positive integer.                               |
+
+## Compatibility
+
+The commands below describe project operations. Global mode is described under [Options](#options).
+
+- **npm:** `npm outdated`.
+- **pnpm:** `pnpm outdated`.
+- **Yarn Classic:** `yarn outdated`.
+- **Yarn Modern:** Alternative: `yarn upgrade-interactive`.
+- **Bun:** `bun outdated`.
+
+| Option                         | npm               | pnpm              | Yarn Classic | Yarn Modern | Bun | Notes                                                                     |
+| ------------------------------ | ----------------- | ----------------- | ------------ | ----------- | --- | ------------------------------------------------------------------------- |
+| `--long`                       | Yes               | Yes               | No           | No          | No  |                                                                           |
+| `--format <table\|list\|json>` | table, list, json | table, list, json | table, json  | No          | No  |                                                                           |
+| `-r, --recursive`              | 7.14.0 or later   | Yes               | No           | No          | Yes | npm uses `--workspaces` to check workspaces, not transitive dependencies. |
+| `--filter <pattern>`           | 7.14.0 or later   | Yes               | No           | No          | Yes |                                                                           |
+| `-w, --workspace-root`         | 8.1.0 or later    | Yes               | No           | No          | No  |                                                                           |
+| `-P, --prod`                   | 7 or later        | Yes               | No           | No          | Yes |                                                                           |
+| `-D, --dev`                    | Yes               | Yes               | No           | No          | No  |                                                                           |
+| `--no-optional`                | 7 or later        | Yes               | No           | No          | Yes |                                                                           |
+| `--compatible`                 | No                | Yes               | No           | No          | No  |                                                                           |
+| `--sort-by <field>`            | No                | Yes               | No           | No          | No  |                                                                           |
+| `-g, --global`                 | Yes               | Yes               | Yes          | Yes         | Yes |                                                                           |
+| `--concurrency <number>`       | Yes               | Yes               | Yes          | Yes         | Yes |                                                                           |
+
+Yarn Modern does not forward positional package names. Its interactive updater can change dependencies, unlike a read-only outdated query.
+
+Native output and exit codes differ. A nonzero exit can indicate outdated dependencies rather than a failure to query the registry.
+
+## Native Options
+
+For native options, see [npm outdated](https://docs.npmjs.com/cli/v11/commands/npm-outdated), [pnpm outdated](https://pnpm.io/cli/outdated), [Yarn upgrade-interactive](https://yarnpkg.com/cli/upgrade-interactive), [Yarn Classic outdated](https://classic.yarnpkg.com/en/docs/cli/outdated), and [Bun outdated](https://bun.com/docs/pm/cli/outdated). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,79 @@
+# vp pm owner
+
+Manage package owners. Alias: `vp pm author`.
+
+```bash
+vp pm owner list my-package
+vp pm owner add alice my-package
+vp pm owner rm alice my-package
+```
+
+## Options
+
+- `list <package>` lists owners. Alias: `ls`.
+- `add <user> <package>` grants ownership.
+- `rm <user> <package>` removes ownership.
+
+Each subcommand accepts `--otp <code>`. These subcommands do not accept additional native arguments after `--`. Ownership changes affect registry permissions, not the local manifest's author field.
+
+### `list`
+
+| Option        | Description                 | Notes |
+| ------------- | --------------------------- | ----- |
+| `--otp <otp>` | Supply a one-time password. |       |
+
+### `add`
+
+| Option        | Description                 | Notes |
+| ------------- | --------------------------- | ----- |
+| `--otp <otp>` | Supply a one-time password. |       |
+
+### `rm`
+
+| Option        | Description                 | Notes |
+| ------------- | --------------------------- | ----- |
+| `--otp <otp>` | Supply a one-time password. |       |
+
+## Compatibility
+
+### `list`
+
+- **npm:** `npm owner list`.
+- **pnpm:** 11.1 or later: `pnpm owner list`. Earlier versions use `npm owner list` as a fallback.
+- **Yarn Classic:** `yarn owner list`.
+- **Yarn Modern:** Fallback: `npm owner list`.
+- **Bun:** Fallback: `npm owner list`.
+
+| Option        | npm | pnpm | Yarn Classic    | Yarn Modern | Bun | Notes |
+| ------------- | --- | ---- | --------------- | ----------- | --- | ----- |
+| `--otp <otp>` | Yes | Yes  | 1.12.1 or later | Yes         | Yes |       |
+
+### `add`
+
+- **npm:** `npm owner add`.
+- **pnpm:** 11.1 or later: `pnpm owner add`. Earlier versions use `npm owner add` as a fallback. Native pnpm takes the package before the user.
+- **Yarn Classic:** `yarn owner add`. Keeps the user before the package.
+- **Yarn Modern:** Fallback: `npm owner add`.
+- **Bun:** Fallback: `npm owner add`.
+
+| Option        | npm | pnpm | Yarn Classic    | Yarn Modern | Bun | Notes |
+| ------------- | --- | ---- | --------------- | ----------- | --- | ----- |
+| `--otp <otp>` | Yes | Yes  | 1.12.1 or later | Yes         | Yes |       |
+
+### `rm`
+
+- **npm:** `npm owner rm`.
+- **pnpm:** 11.1 or later: `pnpm owner rm`. Earlier versions use `npm owner rm` as a fallback. Native pnpm takes the package before the user.
+- **Yarn Classic:** `yarn owner remove`. Keeps the user before the package. Removal can fail in Yarn Classic 1.22.22 because of an upstream bug. Vite+ does not retry through npm.
+- **Yarn Modern:** Fallback: `npm owner rm`.
+- **Bun:** Fallback: `npm owner rm`.
+
+| Option        | npm | pnpm | Yarn Classic    | Yarn Modern | Bun | Notes |
+| ------------- | --- | ---- | --------------- | ----------- | --- | ----- |
+| `--otp <otp>` | Yes | Yes  | 1.12.1 or later | Yes         | Yes |       |
+
+Registry credentials and authorization follow the command that runs.
+
+## Native Options
+
+For registry requirements and native options, see [npm owner](https://docs.npmjs.com/cli/v11/commands/npm-owner), [pnpm owner](https://pnpm.io/cli/owner), and [Yarn Classic owner](https://classic.yarnpkg.com/en/docs/cli/owner). Options not exposed above must be used with the native command directly.

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

@@ -0,0 +1,40 @@
+# vp pm pack
+
+Create a package tarball from the project. This is different from [`vp pack`](/guide/pack), which builds libraries with tsdown.
+
+```bash
+vp pm pack
+vp pm pack --pack-destination ./artifacts
+```
+
+## Options
+
+| Option                                  | Description                                        | Notes                             |
+| --------------------------------------- | -------------------------------------------------- | --------------------------------- |
+| `-r, --recursive`                       | Pack all workspace packages.                       |                                   |
+| `--filter <pattern>`                    | Select workspaces by pattern.                      | Can be repeated.                  |
+| `--out <out>`                           | Choose the tarball output path.                    |                                   |
+| `--pack-destination <pack-destination>` | Choose the tarball output directory.               |                                   |
+| `--pack-gzip-level <pack-gzip-level>`   | Request a gzip compression level from 0 through 9. |                                   |
+| `--json`                                | Request native JSON output.                        | Output retains the native schema. |
+
+## Compatibility
+
+- **npm:** `npm pack`.
+- **pnpm:** `pnpm pack`.
+- **Yarn Classic:** `yarn pack`.
+- **Yarn Modern:** `yarn pack`.
+- **Bun:** `bun pm pack`.
+
+| Option                                  | npm             | pnpm             | Yarn Classic | Yarn Modern | Bun | Notes                                |
+| --------------------------------------- | --------------- | ---------------- | ------------ | ----------- | --- | ------------------------------------ |
+| `-r, --recursive`                       | 7.9.0 or later  | 10.11.0 or later | No           | Yes         | No  |                                      |
+| `--filter <pattern>`                    | 7.9.0 or later  | 10.11.0 or later | No           | Yes         | No  |                                      |
+| `--out <out>`                           | No              | 10.0.0 or later  | Yes          | Yes         | Yes |                                      |
+| `--pack-destination <pack-destination>` | 7.18.0 or later | Yes              | No           | No          | Yes | Vite+ creates the directory for npm. |
+| `--pack-gzip-level <pack-gzip-level>`   | No              | 8.3.0 or later   | No           | No          | Yes |                                      |
+| `--json`                                | Yes             | 9.14.0 or later  | Yes          | Yes         | No  |                                      |
+
+## Native Options
+
+For native options, see [npm pack](https://docs.npmjs.com/cli/v11/commands/npm-pack), [pnpm pack](https://pnpm.io/cli/pack), [Yarn pack](https://yarnpkg.com/cli/pack), [Yarn Classic pack](https://classic.yarnpkg.com/en/docs/cli/pack), and [Bun pm pack](https://bun.com/docs/pm/cli/pm). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/package-manager-selection.md

@@ -0,0 +1,60 @@
+# Package Manager Selection
+
+`vp` detects the package manager at the workspace root in this order:
+
+1. `packageManager` in `package.json`
+2. `devEngines.packageManager` in `package.json`
+3. `pnpm-workspace.yaml`
+4. `pnpm-lock.yaml`
+5. `yarn.lock` or `.yarnrc.yml`
+6. `package-lock.json`
+7. `bun.lock` or `bun.lockb`
+8. `.pnpmfile.cjs` or `pnpmfile.cjs`
+9. `bunfig.toml`
+10. `yarn.config.cjs`
+
+If none of these declarations or files is present, Vite+ defaults to pnpm. Vite+ downloads the matching package manager as needed. Detection does not rewrite `package.json`.
+
+Yarn Classic is Yarn 1. Yarn Modern is Yarn 2 or later.
+
+## Pinning a Version
+
+Use [`vp env pin`](/guide/env) to declare an exact package-manager version:
+
+```bash
+vp env pin pnpm@11.3.0
+```
+
+A `packageManager` pin can include an integrity hash, such as `yarn@4.17.1+sha512.…`. Vite+ supports Corepack-compatible integrity hashes and stops if verification fails.
+
+## Version Ranges
+
+The [`devEngines.packageManager`](https://docs.npmjs.com/cli/v11/configuring-npm/package-json#devengines) field accepts an object or an array of objects. Its `version` can be a semver range:
+
+```json
+{
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "^11.0.0",
+      "onFail": "download"
+    }
+  }
+}
+```
+
+Vite+ uses an already-downloaded satisfying version when possible. Otherwise, it resolves the latest satisfying version from the npm registry. The range remains the source of truth and is not replaced with an exact `packageManager` pin.
+
+When both fields are present, `packageManager` drives selection. Vite+ warns if it does not satisfy the `devEngines.packageManager` constraint. Run `vp env doctor` for details.
+
+## Package-Manager Shims
+
+An explicit `packageManager` or `devEngines.packageManager` declaration also controls matching package-manager shims. For example, `packageManager: "npm@10.9.4"` makes `npm` and `npx` use npm 10.9.4.
+
+The same applies to the generated aliases for each manager:
+
+- pnpm: `pnpm`, `pnpx`, `pn`, and `pnx`.
+- Yarn: `yarn` and `yarnpkg`.
+- Bun: `bun` and `bunx`.
+
+Mismatched tools are not translated. Running `npm` in a pnpm project still resolves npm. Use `vp` package-management commands when you want Vite+ to adapt the operation to the project's manager.

package/docs/guide/package-management/patch-commit.md

@@ -0,0 +1,27 @@
+# vp pm patch-commit
+
+Save edits prepared with [patch](./patch) as a dependency patch.
+
+```bash
+vp pm patch-commit /path/to/edited-package
+```
+
+## Options
+
+Supply the edit directory from the manager's patch workflow. There are no additional Vite+ options.
+
+There are no command-specific options.
+
+## Compatibility
+
+- **npm:** 12 or later: `npm patch commit`. Earlier versions warn and skip.
+- **pnpm:** 7.4 or later: `pnpm patch-commit`. Earlier versions warn and skip.
+- **Yarn Classic:** No command. Warns and exits successfully without performing the operation.
+- **Yarn Modern:** 3 or later: `yarn patch-commit --save`. Earlier versions warn and skip.
+- **Bun:** `bun patch --commit`.
+
+Review and commit the patch and any manifest or lockfile changes produced by the manager.
+
+## Native Options
+
+For native options, see [npm patch commit](https://docs.npmjs.com/cli/v12/commands/npm-patch), [pnpm patch-commit](https://pnpm.io/cli/patch-commit), [Yarn patch-commit](https://yarnpkg.com/cli/patch-commit), and [Bun patch --commit](https://bun.com/docs/pm/cli/patch). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,29 @@
+# vp pm patch
+
+Prepare an installed dependency for local patching.
+
+```bash
+vp pm patch my-dependency@1.0.0
+```
+
+Edit the package in the location reported by the native manager, then save the patch with [patch-commit](./patch-commit).
+
+## Options
+
+A package specification is required. There are no additional Vite+ options.
+
+There are no command-specific options.
+
+## Compatibility
+
+- **npm:** 12 or later: `npm patch add`. Earlier versions warn and skip.
+- **pnpm:** 7.4 or later: `pnpm patch`. Earlier versions warn and skip.
+- **Yarn Classic:** No command. Warns and exits successfully without performing the operation.
+- **Yarn Modern:** `yarn patch`.
+- **Bun:** `bun patch`.
+
+The edit location and patch storage format are native-manager details. Vite+ does not convert patches between managers.
+
+## Native Options
+
+For native options, see [npm patch add](https://docs.npmjs.com/cli/v12/commands/npm-patch), [pnpm patch](https://pnpm.io/cli/patch), [Yarn patch](https://yarnpkg.com/cli/patch), and [Bun patch](https://bun.com/docs/pm/cli/patch). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,32 @@
+# vp pm ping
+
+Check connectivity to a package registry.
+
+```bash
+vp pm ping
+vp pm ping --registry https://registry.npmjs.org
+```
+
+## Options
+
+| Option             | Description          | Notes |
+| ------------------ | -------------------- | ----- |
+| `--registry <url>` | Select the registry. |       |
+
+## Compatibility
+
+- **npm:** `npm ping`.
+- **pnpm:** 11 or later: `pnpm ping`. Earlier versions use `npm ping` as a fallback.
+- **Yarn Classic:** Fallback: `npm ping`.
+- **Yarn Modern:** Fallback: `npm ping`.
+- **Bun:** Fallback: `npm ping`.
+
+| Option             | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
+| ------------------ | --- | ---- | ------------ | ----------- | --- | ----- |
+| `--registry <url>` | Yes | Yes  | Yes          | Yes         | Yes |       |
+
+Registry configuration, output, and exit codes follow the command that runs. Use [whoami](./whoami) when you need to check the authenticated account rather than connectivity.
+
+## Native Options
+
+For native options, see [npm ping](https://docs.npmjs.com/cli/v11/commands/npm-ping) and [pnpm ping](https://pnpm.io/cli/ping). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,88 @@
+# vp pm pkg
+
+Read and update `package.json` fields without editing the manifest by hand.
+
+```bash
+vp pm pkg get name version
+vp pm pkg set scripts.check='vp check'
+vp pm pkg set private=true --json
+vp pm pkg delete scripts.old
+vp pm pkg fix
+```
+
+## Options
+
+- `get [key...]` reads fields, or the entire manifest if no keys are supplied. `--json` requests native JSON output.
+- `set <key=value...>` writes fields. `--json` parses values as JSON so booleans, numbers, arrays, and objects are not saved as strings.
+- `delete <key...>` removes fields.
+- `fix` asks the manager to correct common manifest errors.
+
+Field paths and normalization follow the native manager. Quote paths with brackets or shell-sensitive characters.
+
+### `get`
+
+| Option   | Description            | Notes                             |
+| -------- | ---------------------- | --------------------------------- |
+| `--json` | Output in JSON format. | Output retains the native schema. |
+
+### `set`
+
+| Option   | Description                          | Notes                                                                     |
+| -------- | ------------------------------------ | ------------------------------------------------------------------------- |
+| `--json` | Parse values as JSON before writing. | Parses booleans, numbers, arrays, and objects rather than saving strings. |
+
+### `delete`
+
+There are no command-specific options.
+
+### `fix`
+
+There are no command-specific options.
+
+## Compatibility
+
+### `get`
+
+- **npm:** 7.20.0 or later: `npm pkg get`. Earlier versions warn and skip.
+- **pnpm:** 11.3.0 or later: `pnpm pkg get`. Earlier versions warn and skip.
+- **Yarn Classic:** No command. Warns and exits successfully without performing the operation.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** 1.2.19 or later: `bun pm pkg get`. Earlier versions warn and skip.
+
+| Option   | npm             | pnpm            | Yarn Classic | Yarn Modern | Bun             | Notes |
+| -------- | --------------- | --------------- | ------------ | ----------- | --------------- | ----- |
+| `--json` | 7.20.0 or later | 11.3.0 or later | No           | No          | 1.2.19 or later |       |
+
+### `set`
+
+- **npm:** 7.20.0 or later: `npm pkg set`. Earlier versions warn and skip.
+- **pnpm:** 11.3.0 or later: `pnpm pkg set`. Earlier versions warn and skip.
+- **Yarn Classic:** No command. Warns and exits successfully without performing the operation.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** 1.2.19 or later: `bun pm pkg set`. Earlier versions warn and skip.
+
+| Option   | npm             | pnpm            | Yarn Classic | Yarn Modern | Bun             | Notes |
+| -------- | --------------- | --------------- | ------------ | ----------- | --------------- | ----- |
+| `--json` | 7.20.0 or later | 11.3.0 or later | No           | No          | 1.2.19 or later |       |
+
+### `delete`
+
+- **npm:** 7.20.0 or later: `npm pkg delete`. Earlier versions warn and skip.
+- **pnpm:** 11.3.0 or later: `pnpm pkg delete`. Earlier versions warn and skip.
+- **Yarn Classic:** No command. Warns and exits successfully without performing the operation.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** 1.2.19 or later: `bun pm pkg delete`. Earlier versions warn and skip.
+
+### `fix`
+
+- **npm:** 9.8.0 or later: `npm pkg fix`. Earlier versions warn and skip.
+- **pnpm:** 11.3.0 or later: `pnpm pkg fix`. Earlier versions warn and skip.
+- **Yarn Classic:** No command. Warns and exits successfully without performing the operation.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** 1.2.19 or later: `bun pm pkg fix`. Earlier versions warn and skip.
+
+Versions below the stated requirements warn and exit successfully without running the operation. There is no npm fallback for unsupported managers or versions.
+
+## Native Options
+
+For native options, see [npm pkg](https://docs.npmjs.com/cli/v11/commands/npm-pkg), [pnpm pkg](https://pnpm.io/cli/pkg), and [Bun pm pkg](https://bun.com/docs/pm/cli/pm). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,34 @@
+# vp pm prune
+
+Remove unnecessary installed packages.
+
+```bash
+vp pm prune
+vp pm prune --prod
+```
+
+## Options
+
+| Option          | Description                   | Notes |
+| --------------- | ----------------------------- | ----- |
+| `--prod`        | Remove devDependencies.       |       |
+| `--no-optional` | Remove optional dependencies. |       |
+
+## Compatibility
+
+- **npm:** `npm prune`.
+- **pnpm:** `pnpm prune`.
+- **Yarn Classic:** No command. Warns and exits successfully without performing the operation.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** 1.4 or later: `bun prune`. Earlier versions warn and skip.
+
+| Option          | npm        | pnpm | Yarn Classic | Yarn Modern | Bun          | Notes |
+| --------------- | ---------- | ---- | ------------ | ----------- | ------------ | ----- |
+| `--prod`        | Yes        | Yes  | No           | No          | 1.4 or later |       |
+| `--no-optional` | 7 or later | Yes  | No           | No          | 1.4 or later |       |
+
+npm 7 and later translate selection flags to `--omit=dev` and `--omit=optional`. npm 6 translates `--prod` to `--production` and does not support `--no-optional`. Bun translates `--prod` to `--production`. Yarn and older Bun remove extraneous packages during installation instead of providing a native prune command.
+
+## Native Options
+
+For native options, see [npm prune](https://docs.npmjs.com/cli/v11/commands/npm-prune), [pnpm prune](https://pnpm.io/cli/prune), and [Bun prune](https://bun.com/docs/pm/cli/prune). To pass these options through Vite+, see [Native Arguments](./#native-arguments).