vite-plus 1.5.0 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/binding/index.cjs +117 -55
- package/binding/index.d.cts +9 -0
- package/dist/{agent-DkQD3xqe.js → agent-CTG3B-ec.js} +2 -2
- package/dist/bin.js +36 -7
- package/dist/{comparison-CmVirWIW-UlEf2maz.js → comparison-CmVirWIW-Z8p6CfWL.js} +4 -1
- package/dist/config/bin.js +2 -2
- package/dist/constants-DXqV1vWL.js +77 -0
- package/dist/create/bin.js +30 -35
- package/dist/{define-config-wR57OZG_.js → define-config-CeYkQCqG.js} +1 -1
- package/dist/{define-config-CwtQqYC1.cjs → define-config-jt2Hyhp2.cjs} +1 -1
- package/dist/define-config.cjs +1 -1
- package/dist/define-config.js +1 -1
- package/dist/{editor-aOy1T15H.js → editor-C0U0Ymqk.js} +213 -83
- package/dist/index.cjs +1 -1
- package/dist/index.js +1 -1
- package/dist/lint-plugins.cjs +1 -1
- package/dist/migration/bin.js +9 -8
- package/dist/{oxlint-plugin-config-CHsI_zKo.js → oxlint-plugin-config-DvBRM_Se.js} +1 -1
- package/dist/oxlint-plugin.js +2 -2
- package/dist/pack-bin.js +1 -1
- package/dist/{package-DfFo6-E-.js → package-CK48ZXBV.js} +1 -1
- package/dist/{constants-D2P2aVKb.js → package-Cc9gI1u1.js} +2 -77
- package/dist/{package-overrides-Ci8GXouY.js → package-overrides-nw4zcITi.js} +1 -1
- package/dist/{prompts-C7DI63WP.js → prompts-JkuWOV60.js} +9 -5
- package/dist/{resolve-vite-config-33bzSaeT.js → resolve-vite-config-CfUvxuCo.js} +1 -1
- package/dist/{resolve-vite-config-Cx3cnVVI.js → resolve-vite-config-x5QVnaf4.js} +2 -2
- package/dist/staged/bin.js +1 -1
- package/dist/sync-versions/bin.js +1 -1
- package/dist/toolchain.js +9 -9
- package/dist/toolchain.json +9 -9
- package/dist/{tsconfig-BE3Wj9OX.js → tsconfig-CZlh956U.js} +1 -1
- package/dist/{tsconfig-shNmmCE_.js → tsconfig-DUR3fhIX.js} +2 -2
- package/dist/user-agent-CpEaSTwI.js +6 -0
- package/dist/version.js +3 -2
- package/dist/versions.js +5 -5
- package/dist/vpx-bin.js +2 -0
- package/docs/config/run.md +8 -7
- package/docs/guide/automatic-data-tracking.md +138 -0
- package/docs/guide/check.md +13 -0
- package/docs/guide/global-cli.md +13 -3
- package/docs/guide/index.md +4 -4
- package/docs/guide/local-cli.md +1 -1
- package/docs/guide/migrate-rules.md +3 -1
- package/docs/guide/migrate.md +4 -4
- package/docs/guide/package-management/add.md +84 -0
- package/docs/guide/package-management/approve-builds.md +48 -0
- package/docs/guide/package-management/audit.md +39 -0
- package/docs/guide/package-management/cache.md +53 -0
- package/docs/guide/package-management/ci.md +28 -0
- package/docs/guide/package-management/config.md +119 -0
- package/docs/guide/package-management/dedupe.md +32 -0
- package/docs/guide/package-management/deprecate.md +39 -0
- package/docs/guide/package-management/dist-tag.md +61 -0
- package/docs/guide/package-management/dlx.md +40 -0
- package/docs/guide/package-management/fund.md +32 -0
- package/docs/guide/package-management/global-packages.md +32 -0
- package/docs/guide/package-management/index.md +78 -0
- package/docs/guide/package-management/info.md +35 -0
- package/docs/guide/package-management/install.md +89 -0
- package/docs/guide/package-management/licenses.md +42 -0
- package/docs/guide/package-management/link.md +29 -0
- package/docs/guide/package-management/list.md +60 -0
- package/docs/guide/package-management/login.md +34 -0
- package/docs/guide/package-management/logout.md +34 -0
- package/docs/guide/package-management/outdated.md +60 -0
- package/docs/guide/package-management/owner.md +79 -0
- package/docs/guide/package-management/pack.md +40 -0
- package/docs/guide/package-management/package-manager-selection.md +60 -0
- package/docs/guide/package-management/patch-commit.md +27 -0
- package/docs/guide/package-management/patch.md +29 -0
- package/docs/guide/package-management/ping.md +32 -0
- package/docs/guide/package-management/pkg.md +88 -0
- package/docs/guide/package-management/prune.md +34 -0
- package/docs/guide/package-management/publish.md +61 -0
- package/docs/guide/package-management/rebuild.md +31 -0
- package/docs/guide/package-management/remove.md +47 -0
- package/docs/guide/package-management/search.md +38 -0
- package/docs/guide/package-management/stage.md +175 -0
- package/docs/guide/package-management/team.md +140 -0
- package/docs/guide/package-management/token.md +87 -0
- package/docs/guide/package-management/unlink.md +33 -0
- package/docs/guide/package-management/update.md +62 -0
- package/docs/guide/package-management/version.md +36 -0
- package/docs/guide/package-management/whoami.md +30 -0
- package/docs/guide/package-management/why.md +55 -0
- package/docs/guide/run.md +22 -0
- package/docs/guide/vpx.md +1 -1
- package/package.json +18 -18
- package/docs/guide/package-management.md +0 -269
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Global Packages
|
|
2
|
+
|
|
3
|
+
Global package operations require the [global CLI](/guide/global-cli). Use `-g` to manage tools independently of a project's dependencies:
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp install -g typescript
|
|
7
|
+
vp install -g --node 22 typescript
|
|
8
|
+
vp uninstall -g typescript
|
|
9
|
+
vp update -g
|
|
10
|
+
vp list -g
|
|
11
|
+
vp outdated -g
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Storage and Node.js
|
|
15
|
+
|
|
16
|
+
Vite+ stores global packages in `packages/` under its resolved data directory, not in the underlying package manager's global installation directory.
|
|
17
|
+
|
|
18
|
+
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).
|
|
19
|
+
|
|
20
|
+
`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`.
|
|
21
|
+
|
|
22
|
+
## Updating Packages
|
|
23
|
+
|
|
24
|
+
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.
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
vp update -g some-pkg
|
|
28
|
+
vp update -g some-pkg@latest
|
|
29
|
+
vp update -g --latest
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
With --latest, future updates follow the latest tag instead of the original tag or version range.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# Package Management
|
|
2
|
+
|
|
3
|
+
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.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp install
|
|
7
|
+
vp add react
|
|
8
|
+
vp add -D typescript
|
|
9
|
+
vp remove react
|
|
10
|
+
vp update
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Getting Started
|
|
14
|
+
|
|
15
|
+
- [Package Manager Selection](./package-manager-selection) explains detection, version ranges, and package-manager shims.
|
|
16
|
+
- [Global Packages](./global-packages) explains the separate Vite+ global package store.
|
|
17
|
+
|
|
18
|
+
## Commands
|
|
19
|
+
|
|
20
|
+
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.
|
|
21
|
+
|
|
22
|
+
## Native Arguments
|
|
23
|
+
|
|
24
|
+
Put native arguments after `--` to pass them through without translation:
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
vp install -- --registry=https://registry.npmjs.org
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## Core Commands
|
|
31
|
+
|
|
32
|
+
- [install](./install)
|
|
33
|
+
- [add](./add)
|
|
34
|
+
- [remove](./remove)
|
|
35
|
+
- [update](./update)
|
|
36
|
+
- [dedupe](./dedupe)
|
|
37
|
+
- [outdated](./outdated)
|
|
38
|
+
- [list](./list)
|
|
39
|
+
- [why](./why)
|
|
40
|
+
- [info](./info)
|
|
41
|
+
- [link](./link)
|
|
42
|
+
- [unlink](./unlink)
|
|
43
|
+
- [rebuild](./rebuild)
|
|
44
|
+
- [dlx](./dlx)
|
|
45
|
+
|
|
46
|
+
## Forwarded Commands
|
|
47
|
+
|
|
48
|
+
- **Install and cleanup**
|
|
49
|
+
- [pm ci](./ci)
|
|
50
|
+
- [pm prune](./prune)
|
|
51
|
+
- **Inspection and diagnostics**
|
|
52
|
+
- [pm licenses](./licenses)
|
|
53
|
+
- [pm search](./search)
|
|
54
|
+
- [pm audit](./audit)
|
|
55
|
+
- [pm fund](./fund)
|
|
56
|
+
- [pm ping](./ping)
|
|
57
|
+
- **Local development**
|
|
58
|
+
- [pm approve-builds](./approve-builds)
|
|
59
|
+
- [pm patch](./patch)
|
|
60
|
+
- [pm patch-commit](./patch-commit)
|
|
61
|
+
- **Publishing**
|
|
62
|
+
- [pm pack](./pack)
|
|
63
|
+
- [pm version](./version)
|
|
64
|
+
- [pm publish](./publish)
|
|
65
|
+
- [pm stage](./stage)
|
|
66
|
+
- [pm dist-tag](./dist-tag)
|
|
67
|
+
- [pm deprecate](./deprecate)
|
|
68
|
+
- **Registry and accounts**
|
|
69
|
+
- [pm login](./login)
|
|
70
|
+
- [pm logout](./logout)
|
|
71
|
+
- [pm whoami](./whoami)
|
|
72
|
+
- [pm token](./token)
|
|
73
|
+
- [pm owner](./owner)
|
|
74
|
+
- [pm team](./team)
|
|
75
|
+
- **Configuration and maintenance**
|
|
76
|
+
- [pm config](./config)
|
|
77
|
+
- [pm pkg](./pkg)
|
|
78
|
+
- [pm cache](./cache)
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# vp info
|
|
2
|
+
|
|
3
|
+
Read package metadata from the registry. Aliases: `vp view`, `vp show`, `vp pm view`, `vp pm info`, and `vp pm show`.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp info react
|
|
7
|
+
vp info react versions --json
|
|
8
|
+
vp info react@19 dist.tarball
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Options
|
|
12
|
+
|
|
13
|
+
Supply a package name with an optional version, followed by an optional field name.
|
|
14
|
+
|
|
15
|
+
| Option | Description | Notes |
|
|
16
|
+
| -------- | --------------------------- | --------------------------------- |
|
|
17
|
+
| `--json` | Request native JSON output. | Output retains the native schema. |
|
|
18
|
+
|
|
19
|
+
## Compatibility
|
|
20
|
+
|
|
21
|
+
- **npm:** `npm view`.
|
|
22
|
+
- **pnpm:** `pnpm view`.
|
|
23
|
+
- **Yarn Classic:** `yarn info`.
|
|
24
|
+
- **Yarn Modern:** `yarn npm info`. A requested field is passed as `--fields`.
|
|
25
|
+
- **Bun:** `bun info`.
|
|
26
|
+
|
|
27
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
28
|
+
| -------- | --- | ---- | ------------ | ----------- | --- | ----- |
|
|
29
|
+
| `--json` | Yes | Yes | Yes | Yes | Yes | |
|
|
30
|
+
|
|
31
|
+
This command queries registry metadata, not the local dependency tree. Use [list](./list) or [why](./why) to inspect installed packages.
|
|
32
|
+
|
|
33
|
+
## Native Options
|
|
34
|
+
|
|
35
|
+
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).
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# vp install
|
|
2
|
+
|
|
3
|
+
Install the dependencies declared by the project. Alias: `vp i`. Supplying package names switches to [add](./add) behavior.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp install
|
|
7
|
+
vp install --frozen-lockfile
|
|
8
|
+
vp install --lockfile-only
|
|
9
|
+
vp install --filter web
|
|
10
|
+
vp install react
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Options
|
|
14
|
+
|
|
15
|
+
| Option | Description | Notes |
|
|
16
|
+
| ------------------------ | --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
|
|
17
|
+
| `-P, --prod` | Select production dependencies or save added packages to dependencies. | |
|
|
18
|
+
| `-D, --dev` | Include development dependencies or save added packages to devDependencies. | |
|
|
19
|
+
| `--no-optional` | Do not install optionalDependencies. | |
|
|
20
|
+
| `--frozen-lockfile` | Prevent lockfile changes. | Overrides an earlier `--no-frozen-lockfile`. |
|
|
21
|
+
| `--no-frozen-lockfile` | Explicitly allow lockfile updates. | Overrides an earlier `--frozen-lockfile`. |
|
|
22
|
+
| `--lockfile-only` | Update the lockfile without a full install. | |
|
|
23
|
+
| `--prefer-offline` | Use cached packages when available. | |
|
|
24
|
+
| `--offline` | Only use packages already in cache. | |
|
|
25
|
+
| `-f, --force` | Request a forced reinstall. | |
|
|
26
|
+
| `--ignore-scripts` | Do not run lifecycle scripts. | |
|
|
27
|
+
| `--no-lockfile` | Skip reading or generating a lockfile. | |
|
|
28
|
+
| `--fix-lockfile` | Repair lockfile entries. | Cannot be combined with package names. |
|
|
29
|
+
| `--shamefully-hoist` | Create a flat `node_modules` layout. | |
|
|
30
|
+
| `--resolution-only` | Re-run dependency resolution for analysis. | Cannot be combined with package names. |
|
|
31
|
+
| `--silent` | Suppress Vite+ output and request native quiet output. | |
|
|
32
|
+
| `--filter <pattern>` | Select workspaces by pattern. | Can be repeated. |
|
|
33
|
+
| `-w, --workspace-root` | Select the workspace root. | |
|
|
34
|
+
| `-E, --save-exact` | Save an exact dependency version. | Requires package names. |
|
|
35
|
+
| `--save-peer` | Request the manager's peer-dependency save behavior. | Requires package names. |
|
|
36
|
+
| `-O, --save-optional` | Save to optionalDependencies. | Requires package names. |
|
|
37
|
+
| `--save-catalog` | Save the dependency to the default catalog. | Requires package names. |
|
|
38
|
+
| `-g, --global` | Install globally. | Requires the global CLI. Uses the [global package store](./global-packages). Requires package names. |
|
|
39
|
+
| `--node <version>` | Node.js version to use for global installation. | Requires --global. |
|
|
40
|
+
| `--concurrency <number>` | Number of global package installs to run in parallel. | Requires --global. Must be a positive integer. |
|
|
41
|
+
|
|
42
|
+
## Compatibility
|
|
43
|
+
|
|
44
|
+
The commands below describe project operations. Global mode is described under [Options](#options).
|
|
45
|
+
|
|
46
|
+
- **npm:** `npm install`, or `npm ci` with `--frozen-lockfile` and no package names. With package names: `npm install`.
|
|
47
|
+
- **pnpm:** `pnpm install`. With package names: `pnpm add`.
|
|
48
|
+
- **Yarn Classic:** `yarn install`. With package names: `yarn add`.
|
|
49
|
+
- **Yarn Modern:** `yarn install`. With package names: `yarn add`.
|
|
50
|
+
- **Bun:** `bun install`. With package names: `bun add`.
|
|
51
|
+
|
|
52
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
53
|
+
| ------------------------ | ------------------------- | --------------------- | --------------------- | --------------------- | -------------------------------- | -------------------------------------------------- |
|
|
54
|
+
| `-P, --prod` | Yes | Yes | Yes | With package names | Yes | Yarn Modern only warns in install mode. |
|
|
55
|
+
| `-D, --dev` | Yes | Yes | Yes | With package names | Yes | |
|
|
56
|
+
| `--no-optional` | Yes | Yes | Yes | No | Yes | |
|
|
57
|
+
| `--frozen-lockfile` | Without package names | Without package names | Yes | Without package names | Yes | |
|
|
58
|
+
| `--no-frozen-lockfile` | Without package names | Without package names | Without package names | Without package names | Yes | |
|
|
59
|
+
| `--lockfile-only` | Without --frozen-lockfile | Yes | No | 3 or later | Yes | npm ignores this in CI mode. |
|
|
60
|
+
| `--prefer-offline` | Yes | Yes | Yes | No | 1.4.1 or later | |
|
|
61
|
+
| `--offline` | Yes | Yes | Yes | No | 1.4.1 or later | |
|
|
62
|
+
| `-f, --force` | Without --frozen-lockfile | Yes | Yes | No | Yes | npm ignores this in CI mode. |
|
|
63
|
+
| `--ignore-scripts` | Yes | Yes | Yes | 2.4 or later | Yes | On Yarn Modern, lockfile-only mode takes priority. |
|
|
64
|
+
| `--no-lockfile` | Without --frozen-lockfile | Yes | Yes | No | No | npm ignores this in CI mode. |
|
|
65
|
+
| `--fix-lockfile` | No | Yes | No | 4 or later | No | |
|
|
66
|
+
| `--shamefully-hoist` | No | Yes | No | No | No | |
|
|
67
|
+
| `--resolution-only` | No | Yes | No | No | No | |
|
|
68
|
+
| `--silent` | Yes | Yes | Yes | No | Yes | |
|
|
69
|
+
| `--filter <pattern>` | 7.14.0 or later | Yes | No | Yes | Install: Yes. Add: 1.4 or later. | |
|
|
70
|
+
| `-w, --workspace-root` | 8.1.0 or later | Yes | With package names | No | No | |
|
|
71
|
+
| `-E, --save-exact` | Yes | Yes | Yes | Yes | Yes | |
|
|
72
|
+
| `--save-peer` | Yes | Yes | Yes | Yes | Yes | |
|
|
73
|
+
| `-O, --save-optional` | Yes | Yes | Yes | Yes | Yes | |
|
|
74
|
+
| `--save-catalog` | No | 10.12.0 or later | No | No | 1.4 or later | |
|
|
75
|
+
| `-g, --global` | Yes | Yes | Yes | Yes | Yes | |
|
|
76
|
+
| `--node <version>` | Yes | Yes | Yes | Yes | Yes | |
|
|
77
|
+
| `--concurrency <number>` | Yes | Yes | Yes | Yes | Yes | |
|
|
78
|
+
|
|
79
|
+
With package names, [add](./add) compatibility rules apply.
|
|
80
|
+
|
|
81
|
+
### Git and Remote Tarball Dependencies
|
|
82
|
+
|
|
83
|
+
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.
|
|
84
|
+
|
|
85
|
+
For dependency build-script approval, see [approve-builds](./approve-builds).
|
|
86
|
+
|
|
87
|
+
## Native Options
|
|
88
|
+
|
|
89
|
+
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).
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# vp pm licenses
|
|
2
|
+
|
|
3
|
+
List licenses reported for installed dependencies.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp pm licenses list
|
|
7
|
+
vp pm licenses list --json
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
## Options
|
|
11
|
+
|
|
12
|
+
`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.
|
|
13
|
+
|
|
14
|
+
### `list`
|
|
15
|
+
|
|
16
|
+
| Option | Description | Notes |
|
|
17
|
+
| -------- | --------------------------- | --------------------------------- |
|
|
18
|
+
| `--json` | Request native JSON output. | Output retains the native schema. |
|
|
19
|
+
|
|
20
|
+
## Compatibility
|
|
21
|
+
|
|
22
|
+
### `list`
|
|
23
|
+
|
|
24
|
+
- **npm:** No command. Warns and exits successfully without performing the operation.
|
|
25
|
+
- **pnpm:** 7.17.0 or later: `pnpm licenses list`. Earlier versions warn and skip.
|
|
26
|
+
- **Yarn Classic:** `yarn licenses list`.
|
|
27
|
+
- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
|
|
28
|
+
- **Bun:** 1.4.0 or later: `bun pm licenses`. Earlier versions warn and skip.
|
|
29
|
+
|
|
30
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
31
|
+
| -------- | --- | --------------- | ------------ | ----------- | -------------- | ----- |
|
|
32
|
+
| `--json` | No | 7.17.0 or later | Yes | No | 1.4.0 or later | |
|
|
33
|
+
|
|
34
|
+
## Native Options
|
|
35
|
+
|
|
36
|
+
For example, a pnpm project can use:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
vp pm licenses list -- --prod --long
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
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).
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# vp link
|
|
2
|
+
|
|
3
|
+
Create local development links through the selected package manager. Alias: `vp ln`.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp link ../my-library
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
## Options
|
|
10
|
+
|
|
11
|
+
An optional package name or directory is passed to the manager.
|
|
12
|
+
|
|
13
|
+
There are no command-specific options.
|
|
14
|
+
|
|
15
|
+
## Compatibility
|
|
16
|
+
|
|
17
|
+
- **npm:** `npm link`.
|
|
18
|
+
- **pnpm:** `pnpm link`.
|
|
19
|
+
- **Yarn Classic:** `yarn link`.
|
|
20
|
+
- **Yarn Modern:** `yarn link`.
|
|
21
|
+
- **Bun:** `bun link`.
|
|
22
|
+
|
|
23
|
+
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.
|
|
24
|
+
|
|
25
|
+
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.
|
|
26
|
+
|
|
27
|
+
## Native Options
|
|
28
|
+
|
|
29
|
+
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).
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# vp list
|
|
2
|
+
|
|
3
|
+
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`.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp list
|
|
7
|
+
vp list react --depth 2
|
|
8
|
+
vp list --json
|
|
9
|
+
vp list -g
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Options
|
|
13
|
+
|
|
14
|
+
| Option | Description | Notes |
|
|
15
|
+
| ------------------------- | --------------------------------- | ---------------------------------------------------------------------------- |
|
|
16
|
+
| `--depth <depth>` | Maximum depth of dependency tree. | |
|
|
17
|
+
| `--json` | Request native JSON output. | Output retains the native schema. |
|
|
18
|
+
| `--long` | Show extended information. | |
|
|
19
|
+
| `--parseable` | Parseable output format. | |
|
|
20
|
+
| `-P, --prod` | Only production dependencies. | |
|
|
21
|
+
| `-D, --dev` | Include dev dependencies. | |
|
|
22
|
+
| `--no-optional` | Exclude optional dependencies. | |
|
|
23
|
+
| `--exclude-peers` | Exclude peer dependencies. | |
|
|
24
|
+
| `--only-projects` | Show only project packages. | |
|
|
25
|
+
| `--find-by <finder_name>` | Use a finder function. | |
|
|
26
|
+
| `-r, --recursive` | List across all workspaces. | |
|
|
27
|
+
| `--filter <pattern>` | Select workspaces by pattern. | Can be repeated. |
|
|
28
|
+
| `-g, --global` | List global packages. | Requires the global CLI. Uses the [global package store](./global-packages). |
|
|
29
|
+
|
|
30
|
+
## Compatibility
|
|
31
|
+
|
|
32
|
+
The commands below describe project operations. Global mode is described under [Options](#options).
|
|
33
|
+
|
|
34
|
+
- **npm:** `npm list`.
|
|
35
|
+
- **pnpm:** `pnpm list`.
|
|
36
|
+
- **Yarn Classic:** `yarn list`.
|
|
37
|
+
- **Yarn Modern:** No command. Warns and exits successfully without performing the operation.
|
|
38
|
+
- **Bun:** `bun pm ls`.
|
|
39
|
+
|
|
40
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
41
|
+
| ------------------------- | --------------- | ---------------- | ------------ | ----------- | --- | ----------------------------------------------------------------- |
|
|
42
|
+
| `--depth <depth>` | Yes | Yes | Yes | No | No | |
|
|
43
|
+
| `--json` | Yes | Yes | Yes | No | No | |
|
|
44
|
+
| `--long` | Yes | Yes | No | No | No | |
|
|
45
|
+
| `--parseable` | Yes | Yes | No | No | No | |
|
|
46
|
+
| `-P, --prod` | Yes | Yes | Yes | No | No | npm 6 uses `--production`, which also excludes peer dependencies. |
|
|
47
|
+
| `-D, --dev` | Yes | Yes | Yes | No | No | |
|
|
48
|
+
| `--no-optional` | 7 or later | Yes | No | No | No | |
|
|
49
|
+
| `--exclude-peers` | 7 or later | Yes | No | No | No | |
|
|
50
|
+
| `--only-projects` | No | Yes | No | No | No | |
|
|
51
|
+
| `--find-by <finder_name>` | No | 10.16.0 or later | No | No | No | |
|
|
52
|
+
| `-r, --recursive` | 7.14.0 or later | Yes | No | No | No | |
|
|
53
|
+
| `--filter <pattern>` | 7.14.0 or later | Yes | No | No | No | |
|
|
54
|
+
| `-g, --global` | Yes | Yes | Yes | Yes | Yes | |
|
|
55
|
+
|
|
56
|
+
These results describe installed packages, not Vite+'s bundled tools. Use `vp toolchain [tool]` to inspect bundled Vite, Rolldown, Oxc, and other tool versions.
|
|
57
|
+
|
|
58
|
+
## Native Options
|
|
59
|
+
|
|
60
|
+
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).
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# vp pm login
|
|
2
|
+
|
|
3
|
+
Authenticate with a package registry. Alias: `vp pm adduser`.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp pm login
|
|
7
|
+
vp pm login --scope @my-org
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
## Options
|
|
11
|
+
|
|
12
|
+
| Option | Description | Notes |
|
|
13
|
+
| ------------------ | -------------------- | ----- |
|
|
14
|
+
| `--registry <url>` | Select the registry. | |
|
|
15
|
+
| `--scope <scope>` | Scope for the login. | |
|
|
16
|
+
|
|
17
|
+
## Compatibility
|
|
18
|
+
|
|
19
|
+
- **npm:** `npm login`.
|
|
20
|
+
- **pnpm:** 11 or later: `pnpm login`. Earlier versions use `npm login` as a fallback.
|
|
21
|
+
- **Yarn Classic:** `yarn login`.
|
|
22
|
+
- **Yarn Modern:** `yarn npm login`.
|
|
23
|
+
- **Bun:** Fallback: `npm login`.
|
|
24
|
+
|
|
25
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
26
|
+
| ------------------ | --- | -------------------------- | ------------ | ----------- | --- | ---------------------------------------- |
|
|
27
|
+
| `--registry <url>` | Yes | Yes | No | No | Yes | Configure the registry in Yarn settings. |
|
|
28
|
+
| `--scope <scope>` | Yes | Before 11 or 11.2 or later | No | Yes | Yes | |
|
|
29
|
+
|
|
30
|
+
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.
|
|
31
|
+
|
|
32
|
+
## Native Options
|
|
33
|
+
|
|
34
|
+
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).
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# vp pm logout
|
|
2
|
+
|
|
3
|
+
Log out from a package registry.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp pm logout
|
|
7
|
+
vp pm logout --scope @my-org
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
## Options
|
|
11
|
+
|
|
12
|
+
| Option | Description | Notes |
|
|
13
|
+
| ------------------ | --------------------- | ----- |
|
|
14
|
+
| `--registry <url>` | Select the registry. | |
|
|
15
|
+
| `--scope <scope>` | Scope for the logout. | |
|
|
16
|
+
|
|
17
|
+
## Compatibility
|
|
18
|
+
|
|
19
|
+
- **npm:** `npm logout`.
|
|
20
|
+
- **pnpm:** 11 or later: `pnpm logout`. Earlier versions use `npm logout` as a fallback.
|
|
21
|
+
- **Yarn Classic:** `yarn logout`.
|
|
22
|
+
- **Yarn Modern:** `yarn npm logout`.
|
|
23
|
+
- **Bun:** Fallback: `npm logout`.
|
|
24
|
+
|
|
25
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
26
|
+
| ------------------ | --- | --------- | ------------ | ----------- | --- | ---------------------------------------- |
|
|
27
|
+
| `--registry <url>` | Yes | Yes | No | No | Yes | Configure the registry in Yarn settings. |
|
|
28
|
+
| `--scope <scope>` | Yes | Before 11 | No | Yes | Yes | |
|
|
29
|
+
|
|
30
|
+
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.
|
|
31
|
+
|
|
32
|
+
## Native Options
|
|
33
|
+
|
|
34
|
+
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).
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# vp outdated
|
|
2
|
+
|
|
3
|
+
Check which dependencies have newer versions available.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp outdated
|
|
7
|
+
vp outdated react
|
|
8
|
+
vp outdated --format json
|
|
9
|
+
vp outdated -g
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Options
|
|
13
|
+
|
|
14
|
+
| Option | Description | Notes |
|
|
15
|
+
| ------------------------------ | --------------------------------------------------- | ---------------------------------------------------------------------------- |
|
|
16
|
+
| `--long` | Show extended information. | |
|
|
17
|
+
| `--format <table\|list\|json>` | Select the output format. | |
|
|
18
|
+
| `-r, --recursive` | Check recursively across all workspaces. | |
|
|
19
|
+
| `--filter <pattern>` | Select workspaces by pattern. | Can be repeated. |
|
|
20
|
+
| `-w, --workspace-root` | Include workspace root. | |
|
|
21
|
+
| `-P, --prod` | Only production and optional dependencies. | |
|
|
22
|
+
| `-D, --dev` | Include dev dependencies. | |
|
|
23
|
+
| `--no-optional` | Exclude optional dependencies. | |
|
|
24
|
+
| `--compatible` | Show only versions within compatible ranges. | |
|
|
25
|
+
| `--sort-by <field>` | Sort results by field. | |
|
|
26
|
+
| `-g, --global` | Check globally installed packages. | Requires the global CLI. Uses the [global package store](./global-packages). |
|
|
27
|
+
| `--concurrency <number>` | Number of global package checks to run in parallel. | Requires --global. Must be a positive integer. |
|
|
28
|
+
|
|
29
|
+
## Compatibility
|
|
30
|
+
|
|
31
|
+
The commands below describe project operations. Global mode is described under [Options](#options).
|
|
32
|
+
|
|
33
|
+
- **npm:** `npm outdated`.
|
|
34
|
+
- **pnpm:** `pnpm outdated`.
|
|
35
|
+
- **Yarn Classic:** `yarn outdated`.
|
|
36
|
+
- **Yarn Modern:** Alternative: `yarn upgrade-interactive`.
|
|
37
|
+
- **Bun:** `bun outdated`.
|
|
38
|
+
|
|
39
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
40
|
+
| ------------------------------ | ----------------- | ----------------- | ------------ | ----------- | --- | ------------------------------------------------------------------------- |
|
|
41
|
+
| `--long` | Yes | Yes | No | No | No | |
|
|
42
|
+
| `--format <table\|list\|json>` | table, list, json | table, list, json | table, json | No | No | |
|
|
43
|
+
| `-r, --recursive` | 7.14.0 or later | Yes | No | No | Yes | npm uses `--workspaces` to check workspaces, not transitive dependencies. |
|
|
44
|
+
| `--filter <pattern>` | 7.14.0 or later | Yes | No | No | Yes | |
|
|
45
|
+
| `-w, --workspace-root` | 8.1.0 or later | Yes | No | No | No | |
|
|
46
|
+
| `-P, --prod` | 7 or later | Yes | No | No | Yes | |
|
|
47
|
+
| `-D, --dev` | Yes | Yes | No | No | No | |
|
|
48
|
+
| `--no-optional` | 7 or later | Yes | No | No | Yes | |
|
|
49
|
+
| `--compatible` | No | Yes | No | No | No | |
|
|
50
|
+
| `--sort-by <field>` | No | Yes | No | No | No | |
|
|
51
|
+
| `-g, --global` | Yes | Yes | Yes | Yes | Yes | |
|
|
52
|
+
| `--concurrency <number>` | Yes | Yes | Yes | Yes | Yes | |
|
|
53
|
+
|
|
54
|
+
Yarn Modern does not forward positional package names. Its interactive updater can change dependencies, unlike a read-only outdated query.
|
|
55
|
+
|
|
56
|
+
Native output and exit codes differ. A nonzero exit can indicate outdated dependencies rather than a failure to query the registry.
|
|
57
|
+
|
|
58
|
+
## Native Options
|
|
59
|
+
|
|
60
|
+
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).
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# vp pm owner
|
|
2
|
+
|
|
3
|
+
Manage package owners. Alias: `vp pm author`.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp pm owner list my-package
|
|
7
|
+
vp pm owner add alice my-package
|
|
8
|
+
vp pm owner rm alice my-package
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Options
|
|
12
|
+
|
|
13
|
+
- `list <package>` lists owners. Alias: `ls`.
|
|
14
|
+
- `add <user> <package>` grants ownership.
|
|
15
|
+
- `rm <user> <package>` removes ownership.
|
|
16
|
+
|
|
17
|
+
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.
|
|
18
|
+
|
|
19
|
+
### `list`
|
|
20
|
+
|
|
21
|
+
| Option | Description | Notes |
|
|
22
|
+
| ------------- | --------------------------- | ----- |
|
|
23
|
+
| `--otp <otp>` | Supply a one-time password. | |
|
|
24
|
+
|
|
25
|
+
### `add`
|
|
26
|
+
|
|
27
|
+
| Option | Description | Notes |
|
|
28
|
+
| ------------- | --------------------------- | ----- |
|
|
29
|
+
| `--otp <otp>` | Supply a one-time password. | |
|
|
30
|
+
|
|
31
|
+
### `rm`
|
|
32
|
+
|
|
33
|
+
| Option | Description | Notes |
|
|
34
|
+
| ------------- | --------------------------- | ----- |
|
|
35
|
+
| `--otp <otp>` | Supply a one-time password. | |
|
|
36
|
+
|
|
37
|
+
## Compatibility
|
|
38
|
+
|
|
39
|
+
### `list`
|
|
40
|
+
|
|
41
|
+
- **npm:** `npm owner list`.
|
|
42
|
+
- **pnpm:** 11.1 or later: `pnpm owner list`. Earlier versions use `npm owner list` as a fallback.
|
|
43
|
+
- **Yarn Classic:** `yarn owner list`.
|
|
44
|
+
- **Yarn Modern:** Fallback: `npm owner list`.
|
|
45
|
+
- **Bun:** Fallback: `npm owner list`.
|
|
46
|
+
|
|
47
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
48
|
+
| ------------- | --- | ---- | --------------- | ----------- | --- | ----- |
|
|
49
|
+
| `--otp <otp>` | Yes | Yes | 1.12.1 or later | Yes | Yes | |
|
|
50
|
+
|
|
51
|
+
### `add`
|
|
52
|
+
|
|
53
|
+
- **npm:** `npm owner add`.
|
|
54
|
+
- **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.
|
|
55
|
+
- **Yarn Classic:** `yarn owner add`. Keeps the user before the package.
|
|
56
|
+
- **Yarn Modern:** Fallback: `npm owner add`.
|
|
57
|
+
- **Bun:** Fallback: `npm owner add`.
|
|
58
|
+
|
|
59
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
60
|
+
| ------------- | --- | ---- | --------------- | ----------- | --- | ----- |
|
|
61
|
+
| `--otp <otp>` | Yes | Yes | 1.12.1 or later | Yes | Yes | |
|
|
62
|
+
|
|
63
|
+
### `rm`
|
|
64
|
+
|
|
65
|
+
- **npm:** `npm owner rm`.
|
|
66
|
+
- **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.
|
|
67
|
+
- **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.
|
|
68
|
+
- **Yarn Modern:** Fallback: `npm owner rm`.
|
|
69
|
+
- **Bun:** Fallback: `npm owner rm`.
|
|
70
|
+
|
|
71
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
72
|
+
| ------------- | --- | ---- | --------------- | ----------- | --- | ----- |
|
|
73
|
+
| `--otp <otp>` | Yes | Yes | 1.12.1 or later | Yes | Yes | |
|
|
74
|
+
|
|
75
|
+
Registry credentials and authorization follow the command that runs.
|
|
76
|
+
|
|
77
|
+
## Native Options
|
|
78
|
+
|
|
79
|
+
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.
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# vp pm pack
|
|
2
|
+
|
|
3
|
+
Create a package tarball from the project. This is different from [`vp pack`](/guide/pack), which builds libraries with tsdown.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
vp pm pack
|
|
7
|
+
vp pm pack --pack-destination ./artifacts
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
## Options
|
|
11
|
+
|
|
12
|
+
| Option | Description | Notes |
|
|
13
|
+
| --------------------------------------- | -------------------------------------------------- | --------------------------------- |
|
|
14
|
+
| `-r, --recursive` | Pack all workspace packages. | |
|
|
15
|
+
| `--filter <pattern>` | Select workspaces by pattern. | Can be repeated. |
|
|
16
|
+
| `--out <out>` | Choose the tarball output path. | |
|
|
17
|
+
| `--pack-destination <pack-destination>` | Choose the tarball output directory. | |
|
|
18
|
+
| `--pack-gzip-level <pack-gzip-level>` | Request a gzip compression level from 0 through 9. | |
|
|
19
|
+
| `--json` | Request native JSON output. | Output retains the native schema. |
|
|
20
|
+
|
|
21
|
+
## Compatibility
|
|
22
|
+
|
|
23
|
+
- **npm:** `npm pack`.
|
|
24
|
+
- **pnpm:** `pnpm pack`.
|
|
25
|
+
- **Yarn Classic:** `yarn pack`.
|
|
26
|
+
- **Yarn Modern:** `yarn pack`.
|
|
27
|
+
- **Bun:** `bun pm pack`.
|
|
28
|
+
|
|
29
|
+
| Option | npm | pnpm | Yarn Classic | Yarn Modern | Bun | Notes |
|
|
30
|
+
| --------------------------------------- | --------------- | ---------------- | ------------ | ----------- | --- | ------------------------------------ |
|
|
31
|
+
| `-r, --recursive` | 7.9.0 or later | 10.11.0 or later | No | Yes | No | |
|
|
32
|
+
| `--filter <pattern>` | 7.9.0 or later | 10.11.0 or later | No | Yes | No | |
|
|
33
|
+
| `--out <out>` | No | 10.0.0 or later | Yes | Yes | Yes | |
|
|
34
|
+
| `--pack-destination <pack-destination>` | 7.18.0 or later | Yes | No | No | Yes | Vite+ creates the directory for npm. |
|
|
35
|
+
| `--pack-gzip-level <pack-gzip-level>` | No | 8.3.0 or later | No | No | Yes | |
|
|
36
|
+
| `--json` | Yes | 9.14.0 or later | Yes | Yes | No | |
|
|
37
|
+
|
|
38
|
+
## Native Options
|
|
39
|
+
|
|
40
|
+
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).
|