vite-plus 1.5.0 → 1.5.1

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

@@ -0,0 +1,119 @@
+# vp pm config
+
+Read and write package-manager configuration. Alias: `vp pm c`. This is distinct from `vp config`, which configures project tooling.
+
+```bash
+vp pm config list
+vp pm config get registry
+vp pm config set registry https://registry.npmjs.org --location project
+vp pm config delete registry --location project
+```
+
+Configuration keys are manager-specific. The registry examples use npm or pnpm keys, not Yarn 2 configuration keys.
+
+## Options
+
+- `list` displays configuration.
+- `get <key>` reads a value.
+- `set <key> <value>` writes a value.
+- `delete <key>` removes a value.
+
+Here `--global` selects configuration scope, not Vite+'s global package store.
+
+These subcommands do not accept additional native arguments after `--`.
+
+### `list`
+
+| Option                               | Description                     | Notes                             |
+| ------------------------------------ | ------------------------------- | --------------------------------- |
+| `--json`                             | Request native JSON output.     | Output retains the native schema. |
+| `-g, --global`                       | Use global config.              | Overrides `--location`.           |
+| `--location <project\|user\|global>` | Choose the configuration scope. |                                   |
+
+### `get`
+
+| Option                               | Description                     | Notes                             |
+| ------------------------------------ | ------------------------------- | --------------------------------- |
+| `--json`                             | Request native JSON output.     | Output retains the native schema. |
+| `-g, --global`                       | Use global config.              | Overrides `--location`.           |
+| `--location <project\|user\|global>` | Choose the configuration scope. |                                   |
+
+### `set`
+
+| Option                               | Description                     | Notes                             |
+| ------------------------------------ | ------------------------------- | --------------------------------- |
+| `--json`                             | Request native JSON output.     | Output retains the native schema. |
+| `-g, --global`                       | Use global config.              | Overrides `--location`.           |
+| `--location <project\|user\|global>` | Choose the configuration scope. |                                   |
+
+### `delete`
+
+| Option                               | Description                     | Notes                   |
+| ------------------------------------ | ------------------------------- | ----------------------- |
+| `-g, --global`                       | Use global config.              | Overrides `--location`. |
+| `--location <project\|user\|global>` | Choose the configuration scope. |                         |
+
+## Compatibility
+
+### `list`
+
+- **npm:** `npm config list`.
+- **pnpm:** `pnpm config list`.
+- **Yarn Classic:** `yarn config list`.
+- **Yarn Modern:** `yarn config`.
+- **Bun:** Fallback: `npm config list`. Uses npm configuration, not `bunfig.toml`.
+
+| Option                               | npm                   | pnpm                  | Yarn Classic | Yarn Modern           | Bun                   | Notes                              |
+| ------------------------------------ | --------------------- | --------------------- | ------------ | --------------------- | --------------------- | ---------------------------------- |
+| `--json`                             | Yes                   | Yes                   | Yes          | Yes                   | Yes                   |                                    |
+| `-g, --global`                       | Yes                   | Yes                   | Yes          | Yes                   | Yes                   |                                    |
+| `--location <project\|user\|global>` | project, user, global | project, user, global | user, global | project, user, global | project, user, global | Reads retain merged configuration. |
+
+### `get`
+
+- **npm:** `npm config get`.
+- **pnpm:** `pnpm config get`.
+- **Yarn Classic:** `yarn config get`.
+- **Yarn Modern:** `yarn config get`.
+- **Bun:** Fallback: `npm config get`. Uses npm configuration, not `bunfig.toml`.
+
+| Option                               | npm                   | pnpm                  | Yarn Classic | Yarn Modern           | Bun                   | Notes                              |
+| ------------------------------------ | --------------------- | --------------------- | ------------ | --------------------- | --------------------- | ---------------------------------- |
+| `--json`                             | Yes                   | Yes                   | Yes          | Yes                   | Yes                   |                                    |
+| `-g, --global`                       | Yes                   | Yes                   | Yes          | Yes                   | Yes                   |                                    |
+| `--location <project\|user\|global>` | project, user, global | project, user, global | user, global | project, user, global | project, user, global | Reads retain merged configuration. |
+
+### `set`
+
+- **npm:** `npm config set`.
+- **pnpm:** `pnpm config set`.
+- **Yarn Classic:** `yarn config set`.
+- **Yarn Modern:** `yarn config set`.
+- **Bun:** Fallback: `npm config set`. Uses npm configuration, not `bunfig.toml`.
+
+| Option                               | npm                   | pnpm                  | Yarn Classic | Yarn Modern           | Bun                   | Notes |
+| ------------------------------------ | --------------------- | --------------------- | ------------ | --------------------- | --------------------- | ----- |
+| `--json`                             | Yes                   | Yes                   | Yes          | Yes                   | Yes                   |       |
+| `-g, --global`                       | Yes                   | Yes                   | Yes          | Yes                   | Yes                   |       |
+| `--location <project\|user\|global>` | project, user, global | project, user, global | user, global | project, user, global | project, user, global |       |
+
+### `delete`
+
+- **npm:** `npm config delete`.
+- **pnpm:** `pnpm config delete`.
+- **Yarn Classic:** `yarn config delete`.
+- **Yarn Modern:** `yarn config unset`.
+- **Bun:** Fallback: `npm config delete`. Uses npm configuration, not `bunfig.toml`.
+
+| Option                               | npm                   | pnpm                  | Yarn Classic | Yarn Modern           | Bun                   | Notes |
+| ------------------------------------ | --------------------- | --------------------- | ------------ | --------------------- | --------------------- | ----- |
+| `-g, --global`                       | Yes                   | Yes                   | Yes          | Yes                   | Yes                   |       |
+| `--location <project\|user\|global>` | project, user, global | project, user, global | user, global | project, user, global | project, user, global |       |
+
+Yarn Classic user writes use native defaults.
+
+## Native Options
+
+For native options, see [npm config](https://docs.npmjs.com/cli/v11/commands/npm-config), [pnpm config](https://pnpm.io/cli/config), [Yarn config](https://yarnpkg.com/cli/config), [Yarn config get](https://yarnpkg.com/cli/config/get), [Yarn config set](https://yarnpkg.com/cli/config/set), [Yarn config unset](https://yarnpkg.com/cli/config/unset), and [Yarn Classic config](https://classic.yarnpkg.com/en/docs/cli/config). Native options outside this interface require the native command.
+
+For `bunfig.toml` settings, see [Bun configuration](https://bun.com/docs/runtime/bunfig).

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

@@ -0,0 +1,32 @@
+# vp dedupe
+
+Reduce duplicate dependency entries using the selected package manager.
+
+```bash
+vp dedupe
+vp dedupe --check
+```
+
+## Options
+
+| Option    | Description                                | Notes |
+| --------- | ------------------------------------------ | ----- |
+| `--check` | Check if deduplication would make changes. |       |
+
+## Compatibility
+
+- **npm:** `npm dedupe`.
+- **pnpm:** `pnpm dedupe`.
+- **Yarn Classic:** Fallback: `yarn install`.
+- **Yarn Modern:** `yarn dedupe`.
+- **Bun:** 1.4 or later: `bun dedupe`. Earlier versions use `bun install` as a fallback.
+
+| Option    | npm | pnpm | Yarn Classic | Yarn Modern | Bun          | Notes |
+| --------- | --- | ---- | ------------ | ----------- | ------------ | ----- |
+| `--check` | Yes | Yes  | No           | Yes         | 1.4 or later |       |
+
+A fallback install is not a read-only check. Unsupported `--check` requests fail before the fallback runs.
+
+## Native Options
+
+For native options, see [npm dedupe](https://docs.npmjs.com/cli/v11/commands/npm-dedupe), [pnpm dedupe](https://pnpm.io/cli/dedupe), [Yarn dedupe](https://yarnpkg.com/cli/dedupe), [Yarn Classic install](https://classic.yarnpkg.com/en/docs/cli/install), and [Bun dedupe](https://bun.com/docs/pm/cli/dedupe). For the Bun fallback, see [Bun install](https://bun.com/docs/pm/cli/install). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,39 @@
+# vp pm deprecate
+
+Set a deprecation message for a published package version or version range.
+
+```bash
+vp pm deprecate 'my-package@<2.0.0' 'Upgrade to version 2 or later'
+```
+
+## Options
+
+A package specification and a message are required.
+
+Deprecation warns consumers; it does not unpublish the package.
+
+| Option             | Description                 | Notes |
+| ------------------ | --------------------------- | ----- |
+| `--otp <otp>`      | Supply a one-time password. |       |
+| `--registry <url>` | Select the registry.        |       |
+
+## Compatibility
+
+- **npm:** `npm deprecate`.
+- **pnpm:** 11 or later: `pnpm deprecate`. Earlier versions use `npm deprecate` as a fallback.
+- **Yarn Classic:** Fallback: `npm deprecate`.
+- **Yarn Modern:** Fallback: `npm deprecate`.
+- **Bun:** Fallback: `npm deprecate`.
+
+| Option             | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
+| ------------------ | --- | ---- | ------------ | ----------- | --- | ----- |
+| `--otp <otp>`      | Yes | Yes  | Yes          | Yes         | Yes |       |
+| `--registry <url>` | Yes | Yes  | Yes          | Yes         | Yes |       |
+
+Bun emits a fallback warning. Registry configuration and authentication follow the command that runs.
+
+An empty message is forwarded unchanged. Native pnpm rejects it; Vite+ does not translate it to `undeprecate`.
+
+## Native Options
+
+For native options, see [npm deprecate](https://docs.npmjs.com/cli/v11/commands/npm-deprecate) and [pnpm deprecate](https://pnpm.io/cli/deprecate). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/dist-tag.md

@@ -0,0 +1,61 @@
+# vp pm dist-tag
+
+Manage the tags that map package names such as `my-package@next` to a published version.
+
+```bash
+vp pm dist-tag list my-package
+vp pm dist-tag add my-package@2.0.0 next
+vp pm dist-tag rm my-package next
+```
+
+## Options
+
+- `list [package]` lists tags. Alias: `ls`.
+- `add <package@version> <tag>` assigns a tag.
+- `rm <package> <tag>` removes a tag.
+
+There are no additional Vite+ options or native pass-through arguments on these subcommands. Changing a tag changes what future installs of that tag resolve to; it does not delete the published version.
+
+### `list`
+
+There are no command-specific options.
+
+### `add`
+
+There are no command-specific options.
+
+### `rm`
+
+There are no command-specific options.
+
+## Compatibility
+
+### `list`
+
+- **npm:** `npm dist-tag list`.
+- **pnpm:** 11 or later: `pnpm dist-tag list`. Earlier versions use `npm dist-tag list` as a fallback.
+- **Yarn Classic:** `yarn tag list`.
+- **Yarn Modern:** `yarn npm tag list`.
+- **Bun:** Fallback: `npm dist-tag list`.
+
+### `add`
+
+- **npm:** `npm dist-tag add`.
+- **pnpm:** 11 or later: `pnpm dist-tag add`. Earlier versions use `npm dist-tag add` as a fallback.
+- **Yarn Classic:** `yarn tag add`.
+- **Yarn Modern:** `yarn npm tag add`.
+- **Bun:** Fallback: `npm dist-tag add`.
+
+### `rm`
+
+- **npm:** `npm dist-tag rm`.
+- **pnpm:** 11 or later: `pnpm dist-tag rm`. Earlier versions use `npm dist-tag rm` as a fallback.
+- **Yarn Classic:** `yarn tag rm`.
+- **Yarn Modern:** `yarn npm tag rm`.
+- **Bun:** Fallback: `npm dist-tag rm`.
+
+On the native pnpm path, Vite+ does not fill in a missing package for `list`, resolve version ranges for `add`, or bypass restrictions on removing `latest`. pnpm validates these requests and returns its own errors.
+
+## Native Options
+
+For native options, see [npm dist-tag](https://docs.npmjs.com/cli/v11/commands/npm-dist-tag), [pnpm dist-tag](https://pnpm.io/cli/dist-tag), [Yarn npm tag list](https://yarnpkg.com/cli/npm/tag/list), [Yarn npm tag add](https://yarnpkg.com/cli/npm/tag/add), [Yarn npm tag remove](https://yarnpkg.com/cli/npm/tag/remove), and [Yarn Classic tag](https://classic.yarnpkg.com/en/docs/cli/tag). The upstream commands may expose additional options not accepted by this Vite+ interface.

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

@@ -0,0 +1,40 @@
+# vp dlx
+
+Download and run a package without adding it to the project's dependencies.
+
+```bash
+vp dlx create-vite my-app
+vp dlx --silent create-vite my-app
+```
+
+## Options
+
+Put Vite+ options before the package or command:
+
+Arguments after the command are passed to the executed program, not parsed as Vite+ options. Shell mode interprets shell syntax; use it only with trusted command strings.
+
+| Option                 | Description                                                            | Notes            |
+| ---------------------- | ---------------------------------------------------------------------- | ---------------- |
+| `-p, --package <name>` | Make the selected package available to the executed command.           | Can be repeated. |
+| `-c, --shell-mode`     | Execute within a shell environment.                                    |                  |
+| `-s, --silent`         | Suppress Vite+ output and request native quiet output where available. |                  |
+
+## Compatibility
+
+- **npm:** `npm exec --yes`.
+- **pnpm:** `pnpm dlx`.
+- **Yarn Classic:** Fallback: `npx --yes`.
+- **Yarn Modern:** `yarn dlx`.
+- **Bun:** `bun x`.
+
+| Option                 | npm | pnpm            | Yarn Classic | Yarn Modern | Bun | Notes                             |
+| ---------------------- | --- | --------------- | ------------ | ----------- | --- | --------------------------------- |
+| `-p, --package <name>` | Yes | Yes             | Yes          | Yes         | Yes |                                   |
+| `-c, --shell-mode`     | Yes | 7.21.0 or later | Yes          | No          | No  |                                   |
+| `-s, --silent`         | Yes | Yes             | Yes          | Yes         | Yes | Bun only suppresses Vite+ output. |
+
+For installed project binaries, use `vp exec` or `vpx` instead. See [Running Binaries](/guide/vpx) for those workflows.
+
+## Native Options
+
+For native options, see [npm exec](https://docs.npmjs.com/cli/v11/commands/npm-exec), [pnpm dlx](https://pnpm.io/cli/dlx), [Yarn dlx](https://yarnpkg.com/cli/dlx), and [Bun x](https://bun.com/docs/pm/bunx). For the Yarn Classic fallback, see [npx](https://docs.npmjs.com/cli/v11/commands/npx). For argument handling, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,32 @@
+# vp pm fund
+
+Show funding information for installed dependencies.
+
+```bash
+vp pm fund
+vp pm fund --json
+```
+
+## Options
+
+| Option   | Description                 | Notes                             |
+| -------- | --------------------------- | --------------------------------- |
+| `--json` | Request native JSON output. | Output retains the native schema. |
+
+## Compatibility
+
+- **npm:** `npm fund`.
+- **pnpm:** Fallback: `npm fund`.
+- **Yarn Classic:** Fallback: `npm fund`.
+- **Yarn Modern:** Fallback: `npm fund`.
+- **Bun:** Fallback: `npm fund`.
+
+| Option   | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
+| -------- | --- | ---- | ------------ | ----------- | --- | ----- |
+| `--json` | Yes | Yes  | Yes          | Yes         | Yes |       |
+
+Bun emits a fallback warning. Results follow npm's view of the installed dependencies.
+
+## Native Options
+
+For native options, see [npm fund](https://docs.npmjs.com/cli/v11/commands/npm-fund), which Vite+ uses for all package managers. To pass these options through Vite+, see [Native Arguments](./#native-arguments).

package/docs/guide/package-management/global-packages.md

@@ -0,0 +1,32 @@
+# Global Packages
+
+Global package operations require the [global CLI](/guide/global-cli). Use `-g` to manage tools independently of a project's dependencies:
+
+```bash
+vp install -g typescript
+vp install -g --node 22 typescript
+vp uninstall -g typescript
+vp update -g
+vp list -g
+vp outdated -g
+```
+
+## Storage and Node.js
+
+Vite+ stores global packages in `packages/` under its resolved data directory, not in the underlying package manager's global installation directory.
+
+Without `--node`, a global install uses the Node.js version resolved for the current directory. A project's pin therefore takes precedence over `vp env default`. See [Node.js Selection](/guide/env#node-js-selection).
+
+`vp link` uses native package-manager links. It does not modify Vite+'s global package store, and those links do not appear in `vp list -g`.
+
+## Updating Packages
+
+Updates preserve the version specification recorded at installation. A package installed with `some-pkg@nightly` updates to the newest version of that tag. A version range stays within the range.
+
+```bash
+vp update -g some-pkg
+vp update -g some-pkg@latest
+vp update -g --latest
+```
+
+With --latest, future updates follow the latest tag instead of the original tag or version range.

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

@@ -0,0 +1,78 @@
+# Package Management
+
+Vite+ provides one command interface for npm, pnpm, Yarn, and Bun. `vp` detects the workspace's package manager, downloads the selected version when needed, and translates commands and supported options for it.
+
+```bash
+vp install
+vp add react
+vp add -D typescript
+vp remove react
+vp update
+```
+
+## Getting Started
+
+- [Package Manager Selection](./package-manager-selection) explains detection, version ranges, and package-manager shims.
+- [Global Packages](./global-packages) explains the separate Vite+ global package store.
+
+## Commands
+
+Core commands such as `vp add` run directly under `vp`. Forwarded Commands use `vp pm` to delegate operations to the detected package manager, translating commands and supported options just as core commands do. The `vp pm` prefix keeps names such as `pack` available for Vite+ commands. For example, `vp pm pack` creates a package tarball, but [`vp pack`](/guide/pack) builds a library.
+
+## Native Arguments
+
+Put native arguments after `--` to pass them through without translation:
+
+```bash
+vp install -- --registry=https://registry.npmjs.org
+```
+
+## Core Commands
+
+- [install](./install)
+- [add](./add)
+- [remove](./remove)
+- [update](./update)
+- [dedupe](./dedupe)
+- [outdated](./outdated)
+- [list](./list)
+- [why](./why)
+- [info](./info)
+- [link](./link)
+- [unlink](./unlink)
+- [rebuild](./rebuild)
+- [dlx](./dlx)
+
+## Forwarded Commands
+
+- **Install and cleanup**
+  - [pm ci](./ci)
+  - [pm prune](./prune)
+- **Inspection and diagnostics**
+  - [pm licenses](./licenses)
+  - [pm search](./search)
+  - [pm audit](./audit)
+  - [pm fund](./fund)
+  - [pm ping](./ping)
+- **Local development**
+  - [pm approve-builds](./approve-builds)
+  - [pm patch](./patch)
+  - [pm patch-commit](./patch-commit)
+- **Publishing**
+  - [pm pack](./pack)
+  - [pm version](./version)
+  - [pm publish](./publish)
+  - [pm stage](./stage)
+  - [pm dist-tag](./dist-tag)
+  - [pm deprecate](./deprecate)
+- **Registry and accounts**
+  - [pm login](./login)
+  - [pm logout](./logout)
+  - [pm whoami](./whoami)
+  - [pm token](./token)
+  - [pm owner](./owner)
+  - [pm team](./team)
+- **Configuration and maintenance**
+  - [pm config](./config)
+  - [pm pkg](./pkg)
+  - [pm cache](./cache)

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

@@ -0,0 +1,35 @@
+# vp info
+
+Read package metadata from the registry. Aliases: `vp view`, `vp show`, `vp pm view`, `vp pm info`, and `vp pm show`.
+
+```bash
+vp info react
+vp info react versions --json
+vp info react@19 dist.tarball
+```
+
+## Options
+
+Supply a package name with an optional version, followed by an optional field name.
+
+| Option   | Description                 | Notes                             |
+| -------- | --------------------------- | --------------------------------- |
+| `--json` | Request native JSON output. | Output retains the native schema. |
+
+## Compatibility
+
+- **npm:** `npm view`.
+- **pnpm:** `pnpm view`.
+- **Yarn Classic:** `yarn info`.
+- **Yarn Modern:** `yarn npm info`. A requested field is passed as `--fields`.
+- **Bun:** `bun info`.
+
+| Option   | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
+| -------- | --- | ---- | ------------ | ----------- | --- | ----- |
+| `--json` | Yes | Yes  | Yes          | Yes         | Yes |       |
+
+This command queries registry metadata, not the local dependency tree. Use [list](./list) or [why](./why) to inspect installed packages.
+
+## Native Options
+
+For native options, see [npm view](https://docs.npmjs.com/cli/v11/commands/npm-view), [pnpm view](https://pnpm.io/cli/view), [Yarn npm info](https://yarnpkg.com/cli/npm/info), [Yarn Classic info](https://classic.yarnpkg.com/en/docs/cli/info), and [Bun info](https://bun.com/docs/pm/cli/info). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,89 @@
+# vp install
+
+Install the dependencies declared by the project. Alias: `vp i`. Supplying package names switches to [add](./add) behavior.
+
+```bash
+vp install
+vp install --frozen-lockfile
+vp install --lockfile-only
+vp install --filter web
+vp install react
+```
+
+## Options
+
+| Option                   | Description                                                                 | Notes                                                                                                |
+| ------------------------ | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| `-P, --prod`             | Select production dependencies or save added packages to dependencies.      |                                                                                                      |
+| `-D, --dev`              | Include development dependencies or save added packages to devDependencies. |                                                                                                      |
+| `--no-optional`          | Do not install optionalDependencies.                                        |                                                                                                      |
+| `--frozen-lockfile`      | Prevent lockfile changes.                                                   | Overrides an earlier `--no-frozen-lockfile`.                                                         |
+| `--no-frozen-lockfile`   | Explicitly allow lockfile updates.                                          | Overrides an earlier `--frozen-lockfile`.                                                            |
+| `--lockfile-only`        | Update the lockfile without a full install.                                 |                                                                                                      |
+| `--prefer-offline`       | Use cached packages when available.                                         |                                                                                                      |
+| `--offline`              | Only use packages already in cache.                                         |                                                                                                      |
+| `-f, --force`            | Request a forced reinstall.                                                 |                                                                                                      |
+| `--ignore-scripts`       | Do not run lifecycle scripts.                                               |                                                                                                      |
+| `--no-lockfile`          | Skip reading or generating a lockfile.                                      |                                                                                                      |
+| `--fix-lockfile`         | Repair lockfile entries.                                                    | Cannot be combined with package names.                                                               |
+| `--shamefully-hoist`     | Create a flat `node_modules` layout.                                        |                                                                                                      |
+| `--resolution-only`      | Re-run dependency resolution for analysis.                                  | Cannot be combined with package names.                                                               |
+| `--silent`               | Suppress Vite+ output and request native quiet output.                      |                                                                                                      |
+| `--filter <pattern>`     | Select workspaces by pattern.                                               | Can be repeated.                                                                                     |
+| `-w, --workspace-root`   | Select the workspace root.                                                  |                                                                                                      |
+| `-E, --save-exact`       | Save an exact dependency version.                                           | Requires package names.                                                                              |
+| `--save-peer`            | Request the manager's peer-dependency save behavior.                        | Requires package names.                                                                              |
+| `-O, --save-optional`    | Save to optionalDependencies.                                               | Requires package names.                                                                              |
+| `--save-catalog`         | Save the dependency to the default catalog.                                 | Requires package names.                                                                              |
+| `-g, --global`           | Install globally.                                                           | Requires the global CLI. Uses the [global package store](./global-packages). Requires package names. |
+| `--node <version>`       | Node.js version to use for global installation.                             | Requires --global.                                                                                   |
+| `--concurrency <number>` | Number of global package installs 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 install`, or `npm ci` with `--frozen-lockfile` and no package names. With package names: `npm install`.
+- **pnpm:** `pnpm install`. With package names: `pnpm add`.
+- **Yarn Classic:** `yarn install`. With package names: `yarn add`.
+- **Yarn Modern:** `yarn install`. With package names: `yarn add`.
+- **Bun:** `bun install`. With package names: `bun add`.
+
+| Option                   | npm                       | pnpm                  | Yarn Classic          | Yarn Modern           | Bun                              | Notes                                              |
+| ------------------------ | ------------------------- | --------------------- | --------------------- | --------------------- | -------------------------------- | -------------------------------------------------- |
+| `-P, --prod`             | Yes                       | Yes                   | Yes                   | With package names    | Yes                              | Yarn Modern only warns in install mode.            |
+| `-D, --dev`              | Yes                       | Yes                   | Yes                   | With package names    | Yes                              |                                                    |
+| `--no-optional`          | Yes                       | Yes                   | Yes                   | No                    | Yes                              |                                                    |
+| `--frozen-lockfile`      | Without package names     | Without package names | Yes                   | Without package names | Yes                              |                                                    |
+| `--no-frozen-lockfile`   | Without package names     | Without package names | Without package names | Without package names | Yes                              |                                                    |
+| `--lockfile-only`        | Without --frozen-lockfile | Yes                   | No                    | 3 or later            | Yes                              | npm ignores this in CI mode.                       |
+| `--prefer-offline`       | Yes                       | Yes                   | Yes                   | No                    | 1.4.1 or later                   |                                                    |
+| `--offline`              | Yes                       | Yes                   | Yes                   | No                    | 1.4.1 or later                   |                                                    |
+| `-f, --force`            | Without --frozen-lockfile | Yes                   | Yes                   | No                    | Yes                              | npm ignores this in CI mode.                       |
+| `--ignore-scripts`       | Yes                       | Yes                   | Yes                   | 2.4 or later          | Yes                              | On Yarn Modern, lockfile-only mode takes priority. |
+| `--no-lockfile`          | Without --frozen-lockfile | Yes                   | Yes                   | No                    | No                               | npm ignores this in CI mode.                       |
+| `--fix-lockfile`         | No                        | Yes                   | No                    | 4 or later            | No                               |                                                    |
+| `--shamefully-hoist`     | No                        | Yes                   | No                    | No                    | No                               |                                                    |
+| `--resolution-only`      | No                        | Yes                   | No                    | No                    | No                               |                                                    |
+| `--silent`               | Yes                       | Yes                   | Yes                   | No                    | Yes                              |                                                    |
+| `--filter <pattern>`     | 7.14.0 or later           | Yes                   | No                    | Yes                   | Install: Yes. Add: 1.4 or later. |                                                    |
+| `-w, --workspace-root`   | 8.1.0 or later            | Yes                   | With package names    | No                    | No                               |                                                    |
+| `-E, --save-exact`       | Yes                       | Yes                   | Yes                   | Yes                   | Yes                              |                                                    |
+| `--save-peer`            | Yes                       | Yes                   | Yes                   | Yes                   | Yes                              |                                                    |
+| `-O, --save-optional`    | Yes                       | Yes                   | Yes                   | Yes                   | Yes                              |                                                    |
+| `--save-catalog`         | No                        | 10.12.0 or later      | No                    | No                    | 1.4 or later                     |                                                    |
+| `-g, --global`           | Yes                       | Yes                   | Yes                   | Yes                   | Yes                              |                                                    |
+| `--node <version>`       | Yes                       | Yes                   | Yes                   | Yes                   | Yes                              |                                                    |
+| `--concurrency <number>` | Yes                       | Yes                   | Yes                   | Yes                   | Yes                              |                                                    |
+
+With package names, [add](./add) compatibility rules apply.
+
+### Git and Remote Tarball Dependencies
+
+npm 12 disables git dependencies and remote tarball URLs by default. Installs can fail with `EALLOWGIT` or `EALLOWREMOTE`. Opt in through npm's project `allow-git` or `allow-remote` configuration only when those sources are intended.
+
+For dependency build-script approval, see [approve-builds](./approve-builds).
+
+## Native Options
+
+For native options, see [npm install](https://docs.npmjs.com/cli/v11/commands/npm-install), [pnpm install](https://pnpm.io/cli/install), [Yarn install](https://yarnpkg.com/cli/install), [Yarn Classic install](https://classic.yarnpkg.com/en/docs/cli/install), and [Bun install](https://bun.com/docs/pm/cli/install). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,42 @@
+# vp pm licenses
+
+List licenses reported for installed dependencies.
+
+```bash
+vp pm licenses list
+vp pm licenses list --json
+```
+
+## Options
+
+`list`, also spelled `ls`, is the supported subcommand. `--json` requests the package manager's native JSON output. Vite+ does not normalize the output into a shared schema.
+
+### `list`
+
+| Option   | Description                 | Notes                             |
+| -------- | --------------------------- | --------------------------------- |
+| `--json` | Request native JSON output. | Output retains the native schema. |
+
+## Compatibility
+
+### `list`
+
+- **npm:** No command. Warns and exits successfully without performing the operation.
+- **pnpm:** 7.17.0 or later: `pnpm licenses list`. Earlier versions warn and skip.
+- **Yarn Classic:** `yarn licenses list`.
+- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
+- **Bun:** 1.4.0 or later: `bun pm licenses`. Earlier versions warn and skip.
+
+| Option   | npm | pnpm            | Yarn Classic | Yarn Modern | Bun            | Notes |
+| -------- | --- | --------------- | ------------ | ----------- | -------------- | ----- |
+| `--json` | No  | 7.17.0 or later | Yes          | No          | 1.4.0 or later |       |
+
+## Native Options
+
+For example, a pnpm project can use:
+
+```bash
+vp pm licenses list -- --prod --long
+```
+
+For native options, see [pnpm licenses](https://pnpm.io/cli/licenses), [Yarn Classic licenses](https://classic.yarnpkg.com/en/docs/cli/licenses), and [Bun pm licenses](https://bun.com/docs/pm/cli/pm). To pass these options through Vite+, see [Native Arguments](./#native-arguments).

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

@@ -0,0 +1,29 @@
+# vp link
+
+Create local development links through the selected package manager. Alias: `vp ln`.
+
+```bash
+vp link ../my-library
+```
+
+## Options
+
+An optional package name or directory is passed to the manager.
+
+There are no command-specific options.
+
+## Compatibility
+
+- **npm:** `npm link`.
+- **pnpm:** `pnpm link`.
+- **Yarn Classic:** `yarn link`.
+- **Yarn Modern:** `yarn link`.
+- **Bun:** `bun link`.
+
+The meaning of a directory, package name, or omitted argument follows that manager's native linking workflow. In particular, Yarn 2 and later link projects differently from Yarn Classic's package registration workflow.
+
+These links do not use Vite+'s [global package store](./global-packages) and do not appear in `vp list -g`. Use [unlink](./unlink) to remove native links.
+
+## Native Options
+
+For native options, see [npm link](https://docs.npmjs.com/cli/v11/commands/npm-link), [pnpm link](https://pnpm.io/cli/link), [Yarn link](https://yarnpkg.com/cli/link), [Yarn Classic link](https://classic.yarnpkg.com/en/docs/cli/link), and [Bun link](https://bun.com/docs/pm/cli/link). To pass these options through Vite+, see [Native Arguments](./#native-arguments).