From bda33fc40d5cbc464752dfbc986625c90aff053e Mon Sep 17 00:00:00 2001 From: npm CLI robot Date: Fri, 24 Jun 2022 18:21:50 -0700 Subject: [PATCH] deps: upgrade npm to 8.13.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR-URL: https://github.com/nodejs/node/pull/43552 Reviewed-By: Luigi Pinca Reviewed-By: Tobias Nießen Reviewed-By: Mohammed Keyvanzadeh --- deps/npm/docs/content/commands/npm-cache.md | 7 +- deps/npm/docs/content/commands/npm-ci.md | 2 +- .../docs/content/commands/npm-deprecate.md | 7 +- .../npm/docs/content/commands/npm-dist-tag.md | 17 +- deps/npm/docs/content/commands/npm-explain.md | 10 +- deps/npm/docs/content/commands/npm-fund.md | 25 +- deps/npm/docs/content/commands/npm-init.md | 37 ++- .../content/commands/npm-install-ci-test.md | 2 +- .../docs/content/commands/npm-install-test.md | 11 +- deps/npm/docs/content/commands/npm-install.md | 11 +- deps/npm/docs/content/commands/npm-link.md | 14 +- deps/npm/docs/content/commands/npm-ls.md | 3 +- .../npm/docs/content/commands/npm-outdated.md | 3 +- deps/npm/docs/content/commands/npm-owner.md | 7 +- deps/npm/docs/content/commands/npm-pack.md | 3 +- deps/npm/docs/content/commands/npm-publish.md | 51 ++-- deps/npm/docs/content/commands/npm-rebuild.md | 8 +- deps/npm/docs/content/commands/npm-restart.md | 2 +- .../docs/content/commands/npm-run-script.md | 2 +- deps/npm/docs/content/commands/npm-star.md | 3 +- deps/npm/docs/content/commands/npm-start.md | 2 +- deps/npm/docs/content/commands/npm-stop.md | 2 +- deps/npm/docs/content/commands/npm-test.md | 2 +- .../docs/content/commands/npm-unpublish.md | 3 +- deps/npm/docs/content/commands/npm-unstar.md | 2 +- deps/npm/docs/content/commands/npm-view.md | 3 +- .../content/configuring-npm/package-json.md | 2 +- deps/npm/docs/content/using-npm/config.md | 2 +- .../docs/content/using-npm/package-spec.md | 106 ++++++++ deps/npm/docs/output/commands/npm-cache.html | 7 +- deps/npm/docs/output/commands/npm-ci.html | 2 +- .../docs/output/commands/npm-deprecate.html | 3 +- .../docs/output/commands/npm-dist-tag.html | 17 +- .../npm/docs/output/commands/npm-explain.html | 9 +- deps/npm/docs/output/commands/npm-fund.html | 25 +- deps/npm/docs/output/commands/npm-init.html | 29 +- .../output/commands/npm-install-ci-test.html | 2 +- .../output/commands/npm-install-test.html | 11 +- .../npm/docs/output/commands/npm-install.html | 11 +- deps/npm/docs/output/commands/npm-link.html | 14 +- deps/npm/docs/output/commands/npm-ls.html | 5 +- .../docs/output/commands/npm-outdated.html | 3 +- deps/npm/docs/output/commands/npm-owner.html | 7 +- deps/npm/docs/output/commands/npm-pack.html | 3 +- .../npm/docs/output/commands/npm-publish.html | 62 ++--- .../npm/docs/output/commands/npm-rebuild.html | 8 +- .../npm/docs/output/commands/npm-restart.html | 2 +- .../docs/output/commands/npm-run-script.html | 2 +- deps/npm/docs/output/commands/npm-star.html | 3 +- deps/npm/docs/output/commands/npm-start.html | 2 +- deps/npm/docs/output/commands/npm-stop.html | 2 +- deps/npm/docs/output/commands/npm-test.html | 2 +- .../docs/output/commands/npm-unpublish.html | 3 +- deps/npm/docs/output/commands/npm-unstar.html | 2 +- deps/npm/docs/output/commands/npm-view.html | 3 +- deps/npm/docs/output/commands/npm.html | 2 +- .../output/configuring-npm/package-json.html | 2 +- deps/npm/docs/output/using-npm/config.html | 2 +- .../docs/output/using-npm/package-spec.html | 254 ++++++++++++++++++ deps/npm/lib/auth/legacy.js | 12 +- deps/npm/lib/commands/cache.js | 6 +- deps/npm/lib/commands/deprecate.js | 2 +- deps/npm/lib/commands/dist-tag.js | 8 +- deps/npm/lib/commands/explain.js | 2 +- deps/npm/lib/commands/fund.js | 2 +- deps/npm/lib/commands/init.js | 4 +- deps/npm/lib/commands/install.js | 13 +- deps/npm/lib/commands/link.js | 3 +- deps/npm/lib/commands/ls.js | 2 +- deps/npm/lib/commands/outdated.js | 2 +- deps/npm/lib/commands/owner.js | 6 +- deps/npm/lib/commands/pack.js | 2 +- deps/npm/lib/commands/publish.js | 2 +- deps/npm/lib/commands/rebuild.js | 2 +- deps/npm/lib/commands/star.js | 2 +- deps/npm/lib/commands/unpublish.js | 2 +- deps/npm/lib/commands/view.js | 11 +- deps/npm/lib/utils/config/definitions.js | 6 +- deps/npm/lib/utils/open-url-prompt.js | 69 +++++ deps/npm/man/man1/npm-cache.1 | 8 +- deps/npm/man/man1/npm-ci.1 | 2 +- deps/npm/man/man1/npm-deprecate.1 | 8 +- deps/npm/man/man1/npm-dist-tag.1 | 18 +- deps/npm/man/man1/npm-explain.1 | 11 +- deps/npm/man/man1/npm-fund.1 | 26 +- deps/npm/man/man1/npm-init.1 | 41 ++- deps/npm/man/man1/npm-install-ci-test.1 | 2 +- deps/npm/man/man1/npm-install-test.1 | 11 +- deps/npm/man/man1/npm-install.1 | 11 +- deps/npm/man/man1/npm-link.1 | 15 +- deps/npm/man/man1/npm-ls.1 | 6 +- deps/npm/man/man1/npm-outdated.1 | 4 +- deps/npm/man/man1/npm-owner.1 | 8 +- deps/npm/man/man1/npm-pack.1 | 4 +- deps/npm/man/man1/npm-publish.1 | 49 ++-- deps/npm/man/man1/npm-rebuild.1 | 9 +- deps/npm/man/man1/npm-restart.1 | 2 +- deps/npm/man/man1/npm-run-script.1 | 2 +- deps/npm/man/man1/npm-star.1 | 4 +- deps/npm/man/man1/npm-start.1 | 2 +- deps/npm/man/man1/npm-stop.1 | 2 +- deps/npm/man/man1/npm-test.1 | 2 +- deps/npm/man/man1/npm-unpublish.1 | 4 +- deps/npm/man/man1/npm-unstar.1 | 2 +- deps/npm/man/man1/npm-view.1 | 4 +- deps/npm/man/man1/npm.1 | 2 +- deps/npm/man/man5/package-json.5 | 2 +- deps/npm/man/man7/config.7 | 2 +- deps/npm/man/man7/package-spec.7 | 145 ++++++++++ .../arborist/lib/arborist/build-ideal-tree.js | 2 +- .../@npmcli/arborist/package.json | 6 +- .../@npmcli/run-script/lib/escape.js | 71 +++++ .../@npmcli/run-script/lib/make-spawn-args.js | 92 ++++++- .../@npmcli/run-script/lib/run-script-pkg.js | 13 +- .../@npmcli/run-script/package.json | 6 +- .../node_modules/cacache/lib/content/read.js | 10 +- deps/npm/node_modules/cacache/package.json | 6 +- deps/npm/node_modules/libnpmdiff/package.json | 4 +- deps/npm/node_modules/libnpmexec/package.json | 6 +- deps/npm/node_modules/libnpmpack/package.json | 6 +- .../node_modules/libnpmversion/package.json | 4 +- .../make-fetch-happen/lib/agent.js | 5 +- .../make-fetch-happen/package.json | 4 +- .../npm/node_modules/npm-profile/lib/index.js | 23 +- .../npm/node_modules/npm-profile/package.json | 6 +- deps/npm/node_modules/pacote/package.json | 4 +- .../socks-proxy-agent/package.json | 48 ++-- deps/npm/package.json | 12 +- .../test/lib/load-all-commands.js.test.cjs | 83 ++---- .../tap-snapshots/test/lib/npm.js.test.cjs | 83 ++---- .../lib/utils/config/definitions.js.test.cjs | 2 +- .../lib/utils/config/describe-all.js.test.cjs | 2 +- .../lib/utils/open-url-prompt.js.test.cjs | 25 ++ deps/npm/test/lib/auth/legacy.js | 2 +- deps/npm/test/lib/commands/edit.js | 31 ++- deps/npm/test/lib/commands/restart.js | 12 +- deps/npm/test/lib/commands/start.js | 13 +- deps/npm/test/lib/commands/stop.js | 12 +- deps/npm/test/lib/commands/test.js | 12 +- deps/npm/test/lib/commands/view.js | 9 + deps/npm/test/lib/utils/open-url-prompt.js | 150 +++++++++++ 141 files changed, 1566 insertions(+), 612 deletions(-) create mode 100644 deps/npm/docs/content/using-npm/package-spec.md create mode 100644 deps/npm/docs/output/using-npm/package-spec.html create mode 100644 deps/npm/lib/utils/open-url-prompt.js create mode 100644 deps/npm/man/man7/package-spec.7 create mode 100644 deps/npm/node_modules/@npmcli/run-script/lib/escape.js create mode 100644 deps/npm/tap-snapshots/test/lib/utils/open-url-prompt.js.test.cjs create mode 100644 deps/npm/test/lib/utils/open-url-prompt.js diff --git a/deps/npm/docs/content/commands/npm-cache.md b/deps/npm/docs/content/commands/npm-cache.md index 091e26e8a71..b5eddd46c05 100644 --- a/deps/npm/docs/content/commands/npm-cache.md +++ b/deps/npm/docs/content/commands/npm-cache.md @@ -11,11 +11,7 @@ description: Manipulates packages cache ```bash -npm cache add -npm cache add -npm cache add -npm cache add -npm cache add @ +npm cache add npm cache clean [] npm cache ls [@] npm cache verify @@ -101,6 +97,7 @@ cache`](/commands/npm-cache) ### See Also +* [package spec](/using-npm/package-spec) * [npm folders](/configuring-npm/folders) * [npm config](/commands/npm-config) * [npmrc](/configuring-npm/npmrc) diff --git a/deps/npm/docs/content/commands/npm-ci.md b/deps/npm/docs/content/commands/npm-ci.md index 3374bf1e251..9b8238d05a3 100644 --- a/deps/npm/docs/content/commands/npm-ci.md +++ b/deps/npm/docs/content/commands/npm-ci.md @@ -133,7 +133,7 @@ will *not* run any pre- or post-scripts. * Type: null or String The shell to use for scripts run with the `npm exec`, `npm run` and `npm -init ` commands. +init ` commands. diff --git a/deps/npm/docs/content/commands/npm-deprecate.md b/deps/npm/docs/content/commands/npm-deprecate.md index 4345120d374..20f65140fc7 100644 --- a/deps/npm/docs/content/commands/npm-deprecate.md +++ b/deps/npm/docs/content/commands/npm-deprecate.md @@ -11,7 +11,7 @@ description: Deprecate a version of a package ```bash -npm deprecate [@] +npm deprecate ``` @@ -45,8 +45,8 @@ In this case, a version `my-thing@1.0.0-beta.0` will also be deprecated. You must be the package owner to deprecate something. See the `owner` and `adduser` help topics. -To un-deprecate a package, specify an empty string (`""`) for the `message` -argument. Note that you must use double quotes with no space between them to +To un-deprecate a package, specify an empty string (`""`) for the `message` +argument. Note that you must use double quotes with no space between them to format an empty string. ### Configuration @@ -82,6 +82,7 @@ password, npm will prompt on the command line for one. ### See Also +* [package spec](/using-npm/package-spec) * [npm publish](/commands/npm-publish) * [npm registry](/using-npm/registry) * [npm owner](/commands/npm-owner) diff --git a/deps/npm/docs/content/commands/npm-dist-tag.md b/deps/npm/docs/content/commands/npm-dist-tag.md index b9caf1fbe7f..123e67dbf3b 100644 --- a/deps/npm/docs/content/commands/npm-dist-tag.md +++ b/deps/npm/docs/content/commands/npm-dist-tag.md @@ -11,9 +11,9 @@ description: Modify package distribution tags ```bash -npm dist-tag add @ [] -npm dist-tag rm -npm dist-tag ls [] +npm dist-tag add [] +npm dist-tag rm +npm dist-tag ls [] alias: dist-tags ``` @@ -27,11 +27,11 @@ alias: dist-tags Add, remove, and enumerate distribution tags on a package: -* add: Tags the specified version of the package with the specified tag, or - the `--tag` config if not specified. If you have two-factor - authentication on auth-and-writes then you’ll need to include a one-time - password on the command line with `--otp `, or at the - OTP prompt. +* add: Tags the specified version of the package with the specified tag, + or the `--tag` config if not specified. If you have two-factor + authentication on auth-and-writes then you’ll need to include a + one-time password on the command line with + `--otp `, or at the OTP prompt. * rm: Clear a tag that is no longer in use from the package. If you have two-factor authentication on auth-and-writes then you’ll need to include @@ -168,6 +168,7 @@ This value is not exported to the environment for child processes. ### See Also +* [package spec](/using-npm/package-spec) * [npm publish](/commands/npm-publish) * [npm install](/commands/npm-install) * [npm dedupe](/commands/npm-dedupe) diff --git a/deps/npm/docs/content/commands/npm-explain.md b/deps/npm/docs/content/commands/npm-explain.md index 76522105658..5ba2fe8206b 100644 --- a/deps/npm/docs/content/commands/npm-explain.md +++ b/deps/npm/docs/content/commands/npm-explain.md @@ -11,7 +11,7 @@ description: Explain installed packages ```bash -npm explain +npm explain alias: why ``` @@ -26,9 +26,10 @@ alias: why This command will print the chain of dependencies causing a given package to be installed in the current project. -Positional arguments can be either folders within `node_modules`, or -`name@version-range` specifiers, which will select the dependency -relationships to explain. +If one or more package specs are provided, then only packages matching +one of the specifiers will have their relationships explained. + +The package spec can also refer to a folder within `./node_modules` For example, running `npm explain glob` within npm's source tree will show: @@ -110,6 +111,7 @@ This value is not exported to the environment for child processes. ### See Also +* [package spec](/using-npm/package-spec) * [npm config](/commands/npm-config) * [npmrc](/configuring-npm/npmrc) * [npm folders](/configuring-npm/folders) diff --git a/deps/npm/docs/content/commands/npm-fund.md b/deps/npm/docs/content/commands/npm-fund.md index 5b96e91ab8c..8db0ce910de 100644 --- a/deps/npm/docs/content/commands/npm-fund.md +++ b/deps/npm/docs/content/commands/npm-fund.md @@ -11,7 +11,7 @@ description: Retrieve funding information ```bash -npm fund [[<@scope>/]] +npm fund [] ``` @@ -23,22 +23,22 @@ npm fund [[<@scope>/]] This command retrieves information on how to fund the dependencies of a given project. If no package name is provided, it will list all -dependencies that are looking for funding in a tree structure, listing the -type of funding and the url to visit. If a package name is provided then it -tries to open its funding url using the `--browser` config param; if there -are multiple funding sources for the package, the user will be instructed -to pass the `--which` option to disambiguate. +dependencies that are looking for funding in a tree structure, listing +the type of funding and the url to visit. If a package name is provided +then it tries to open its funding url using the `--browser` config +param; if there are multiple funding sources for the package, the user +will be instructed to pass the `--which` option to disambiguate. The list will avoid duplicated entries and will stack all packages that -share the same url as a single entry. Thus, the list does not have the same -shape of the output from `npm ls`. +share the same url as a single entry. Thus, the list does not have the +same shape of the output from `npm ls`. #### Example ### Workspaces support -It's possible to filter the results to only include a single workspace and its -dependencies using the `workspace` config option. +It's possible to filter the results to only include a single workspace +and its dependencies using the `workspace` config option. #### Example: @@ -58,8 +58,8 @@ test-workspaces-fund@1.0.0 `-- bar@2.0.0 ``` -And here is an example of the expected result when filtering only by -a specific workspace `a` in the same project: +And here is an example of the expected result when filtering only by a +specific workspace `a` in the same project: ```bash $ npm fund -w a @@ -156,6 +156,7 @@ If there are multiple funding sources, which 1-indexed source URL to open. ## See Also +* [package spec](/using-npm/package-spec) * [npm install](/commands/npm-install) * [npm docs](/commands/npm-docs) * [npm ls](/commands/npm-ls) diff --git a/deps/npm/docs/content/commands/npm-init.md b/deps/npm/docs/content/commands/npm-init.md index 35343cceb4a..cd0be4643e0 100644 --- a/deps/npm/docs/content/commands/npm-init.md +++ b/deps/npm/docs/content/commands/npm-init.md @@ -11,9 +11,8 @@ description: Create a package.json file ```bash -npm init [--force|-f|--yes|-y|--scope] +npm init (same as `npx ) npm init <@scope> (same as `npx <@scope>/create`) -npm init [<@scope>/] (same as `npx [<@scope>/]create-`) aliases: create, innit ``` @@ -204,6 +203,39 @@ mistakes, unnecessary performance degradation, and malicious input. If you don't have a clear idea of what you want to do, it is strongly recommended that you do not use this option! + + + +#### `scope` + +* Default: the scope of the current project, if any, or "" +* Type: String + +Associate an operation with a scope for a scoped registry. + +Useful when logging in to or out of a private registry: + +``` +# log in, linking the scope to the custom registry +npm login --scope=@mycorp --registry=https://registry.mycorp.com + +# log out, removing the link and the auth token +npm logout --scope=@mycorp +``` + +This will cause `@mycorp` to be mapped to the registry for future +installation of packages specified according to the pattern +`@mycorp/package`. + +This will also cause `npm init` to create a scoped package. + +``` +# accept all defaults, and create a package named "@foo/whatever", +# instead of just named "whatever" +npm init --scope=@foo --yes +``` + + @@ -284,6 +316,7 @@ This value is not exported to the environment for child processes. ### See Also +* [package spec](/using-npm/package-spec) * [init-package-json module](http://npm.im/init-package-json) * [package.json](/configuring-npm/package-json) * [npm version](/commands/npm-version) diff --git a/deps/npm/docs/content/commands/npm-install-ci-test.md b/deps/npm/docs/content/commands/npm-install-ci-test.md index 0d9470acf58..74ed4667e81 100644 --- a/deps/npm/docs/content/commands/npm-install-ci-test.md +++ b/deps/npm/docs/content/commands/npm-install-ci-test.md @@ -79,7 +79,7 @@ will *not* run any pre- or post-scripts. * Type: null or String The shell to use for scripts run with the `npm exec`, `npm run` and `npm -init ` commands. +init ` commands. diff --git a/deps/npm/docs/content/commands/npm-install-test.md b/deps/npm/docs/content/commands/npm-install-test.md index 3dd860ea5c6..d27686e731c 100644 --- a/deps/npm/docs/content/commands/npm-install-test.md +++ b/deps/npm/docs/content/commands/npm-install-test.md @@ -11,16 +11,7 @@ description: Install package(s) and run tests ```bash -npm install-test [<@scope>/] -npm install-test [<@scope>/]@ -npm install-test [<@scope>/]@ -npm install-test [<@scope>/]@ -npm install-test @npm: -npm install-test -npm install-test -npm install-test -npm install-test -npm install-test / +npm install-test [ ...] alias: it ``` diff --git a/deps/npm/docs/content/commands/npm-install.md b/deps/npm/docs/content/commands/npm-install.md index d6668a2c2bd..7e5544f85e3 100644 --- a/deps/npm/docs/content/commands/npm-install.md +++ b/deps/npm/docs/content/commands/npm-install.md @@ -11,16 +11,7 @@ description: Install a package ```bash -npm install [<@scope>/] -npm install [<@scope>/]@ -npm install [<@scope>/]@ -npm install [<@scope>/]@ -npm install @npm: -npm install -npm install -npm install -npm install -npm install / +npm install [ ...] aliases: add, i, in, ins, inst, insta, instal, isnt, isnta, isntal, isntall ``` diff --git a/deps/npm/docs/content/commands/npm-link.md b/deps/npm/docs/content/commands/npm-link.md index 975c807c38b..8c1b422493b 100644 --- a/deps/npm/docs/content/commands/npm-link.md +++ b/deps/npm/docs/content/commands/npm-link.md @@ -11,8 +11,7 @@ description: Symlink a package folder ```bash -npm link (in package dir) -npm link [<@scope>/][@] +npm link [] alias: ln ``` @@ -29,11 +28,11 @@ test iteratively without having to continually rebuild. Package linking is a two-step process. -First, `npm link` in a package folder will create a symlink in the global -folder `{prefix}/lib/node_modules/` that links to the package -where the `npm link` command was executed. It will also link any bins in -the package to `{prefix}/bin/{name}`. Note that `npm link` uses the global -prefix (see `npm prefix -g` for its value). +First, `npm link` in a package folder with no arguments will create a +symlink in the global folder `{prefix}/lib/node_modules/` that +links to the package where the `npm link` command was executed. It will +also link any bins in the package to `{prefix}/bin/{name}`. Note that +`npm link` uses the global prefix (see `npm prefix -g` for its value). Next, in some other location, `npm link package-name` will create a symbolic link from globally-installed `package-name` to `node_modules/` of @@ -399,6 +398,7 @@ symlink. This option has no effect on workspaces. ### See Also +* [package spec](/using-npm/package-spec) * [npm developers](/using-npm/developers) * [package.json](/configuring-npm/package-json) * [npm install](/commands/npm-install) diff --git a/deps/npm/docs/content/commands/npm-ls.md b/deps/npm/docs/content/commands/npm-ls.md index ded8c0c0d26..a97c5168e6e 100644 --- a/deps/npm/docs/content/commands/npm-ls.md +++ b/deps/npm/docs/content/commands/npm-ls.md @@ -11,7 +11,7 @@ description: List installed packages ```bash -npm ls [[<@scope>/] ...] +npm ls alias: list ``` @@ -301,6 +301,7 @@ symlink. This option has no effect on workspaces. ### See Also +* [package spec](/using-npm/package-spec) * [npm explain](/commands/npm-explain) * [npm config](/commands/npm-config) * [npmrc](/configuring-npm/npmrc) diff --git a/deps/npm/docs/content/commands/npm-outdated.md b/deps/npm/docs/content/commands/npm-outdated.md index 6fa026550e7..c4e07a0cd36 100644 --- a/deps/npm/docs/content/commands/npm-outdated.md +++ b/deps/npm/docs/content/commands/npm-outdated.md @@ -11,7 +11,7 @@ description: Check for outdated packages ```bash -npm outdated [[<@scope>/] ...] +npm outdated [ ...] ``` @@ -192,6 +192,7 @@ This value is not exported to the environment for child processes. ### See Also +* [package spec](/using-npm/package-spec) * [npm update](/commands/npm-update) * [npm dist-tag](/commands/npm-dist-tag) * [npm registry](/using-npm/registry) diff --git a/deps/npm/docs/content/commands/npm-owner.md b/deps/npm/docs/content/commands/npm-owner.md index 72dfe6a22d0..ebc29ef6939 100644 --- a/deps/npm/docs/content/commands/npm-owner.md +++ b/deps/npm/docs/content/commands/npm-owner.md @@ -11,9 +11,9 @@ description: Manage package owners ```bash -npm owner add [<@scope>/] -npm owner rm [<@scope>/] -npm owner ls [<@scope>/] +npm owner add +npm owner rm +npm owner ls alias: author ``` @@ -123,6 +123,7 @@ This value is not exported to the environment for child processes. ### See Also +* [package spec](/using-npm/package-spec) * [npm profile](/commands/npm-profile) * [npm publish](/commands/npm-publish) * [npm registry](/using-npm/registry) diff --git a/deps/npm/docs/content/commands/npm-pack.md b/deps/npm/docs/content/commands/npm-pack.md index fa6c005e9d2..7921042eae8 100644 --- a/deps/npm/docs/content/commands/npm-pack.md +++ b/deps/npm/docs/content/commands/npm-pack.md @@ -11,7 +11,7 @@ description: Create a tarball from a package ```bash -npm pack [[<@scope>/]...] +npm pack ``` @@ -144,6 +144,7 @@ If no arguments are supplied, then npm packs the current package folder. ### See Also +* [package spec](/using-npm/package-spec) * [npm-packlist package](http://npm.im/npm-packlist) * [npm cache](/commands/npm-cache) * [npm publish](/commands/npm-publish) diff --git a/deps/npm/docs/content/commands/npm-publish.md b/deps/npm/docs/content/commands/npm-publish.md index 2995f6bc815..536d04988e6 100644 --- a/deps/npm/docs/content/commands/npm-publish.md +++ b/deps/npm/docs/content/commands/npm-publish.md @@ -11,7 +11,7 @@ description: Publish a package ```bash -npm publish [] +npm publish ``` @@ -23,42 +23,26 @@ npm publish [] Publishes a package to the registry so that it can be installed by name. -By default npm will publish to the public registry. This can be overridden -by specifying a different default registry or using a -[`scope`](/using-npm/scope) in the name (see +By default npm will publish to the public registry. This can be +overridden by specifying a different default registry or using a +[`scope`](/using-npm/scope) in the name, combined with a +scope-configured registry (see [`package.json`](/configuring-npm/package-json)). -* ``: A folder containing a package.json file -* ``: A url or file path to a gzipped tar archive containing a - single folder with a package.json file inside. +A `package` is interpreted the same way as other commands (like +`npm install` and can be: -* `[--tag ]`: Registers the published package with the given tag, such - that `npm install @` will install this version. By default, - `npm publish` updates and `npm install` installs the `latest` tag. See - [`npm-dist-tag`](npm-dist-tag) for details about tags. - -* `[--access ]`: Tells the registry whether this package - should be published as public or restricted. Only applies to scoped - packages, which default to `restricted`. If you don't have a paid - account, you must publish with `--access public` to publish scoped - packages. - -* `[--otp ]`: If you have two-factor authentication enabled in - `auth-and-writes` mode then you can provide a code from your - authenticator with this. If you don't include this and you're running - from a TTY then you'll be prompted. - -* `[--dry-run]`: As of `npm@6`, does everything publish would do except - actually publishing to the registry. Reports the details of what would - have been published. - -* `[--workspaces]`: Enables workspace context while publishing. All - workspace packages will be published. - -* `[--workspace]`: Enables workspaces context and limits results to only - those specified by this config item. Only the packages in the - workspaces given will be published. +* a) a folder containing a program described by a + [`package.json`](/configuring-npm/package-json) file +* b) a gzipped tarball containing (a) +* c) a url that resolves to (b) +* d) a `@` that is published on the registry (see + [`registry`](/using-npm/registry)) with (c) +* e) a `@` (see [`npm dist-tag`](/commands/npm-dist-tag)) that + points to (d) +* f) a `` that has a "latest" tag satisfying (e) +* g) a `` that resolves to (a) The publish will fail if the package name and version combination already exists in the specified registry. @@ -247,6 +231,7 @@ This value is not exported to the environment for child processes. ### See Also +* [package spec](/using-npm/package-spec) * [npm-packlist package](http://npm.im/npm-packlist) * [npm registry](/using-npm/registry) * [npm scope](/using-npm/scope) diff --git a/deps/npm/docs/content/commands/npm-rebuild.md b/deps/npm/docs/content/commands/npm-rebuild.md index 52c368c8c51..6a396421213 100644 --- a/deps/npm/docs/content/commands/npm-rebuild.md +++ b/deps/npm/docs/content/commands/npm-rebuild.md @@ -11,7 +11,7 @@ description: Rebuild a package ```bash -npm rebuild [[<@scope>/][@] ...] +npm rebuild [] ...] alias: rb ``` @@ -29,9 +29,8 @@ C++ addons with the new binary. It is also useful when installing with `--ignore-scripts` and `--no-bin-links`, to explicitly choose which packages to build and/or link bins. -If one or more package names (and optionally version ranges) are provided, -then only packages with a name and version matching one of the specifiers -will be rebuilt. +If one or more package specs are provided, then only packages with a +name and version matching one of the specifiers will be rebuilt. ### Configuration @@ -178,4 +177,5 @@ symlink. This option has no effect on workspaces. ### See Also +* [package spec](/using-npm/package-spec) * [npm install](/commands/npm-install) diff --git a/deps/npm/docs/content/commands/npm-restart.md b/deps/npm/docs/content/commands/npm-restart.md index f01cd014e74..048bebb1659 100644 --- a/deps/npm/docs/content/commands/npm-restart.md +++ b/deps/npm/docs/content/commands/npm-restart.md @@ -69,7 +69,7 @@ will *not* run any pre- or post-scripts. * Type: null or String The shell to use for scripts run with the `npm exec`, `npm run` and `npm -init ` commands. +init ` commands. diff --git a/deps/npm/docs/content/commands/npm-run-script.md b/deps/npm/docs/content/commands/npm-run-script.md index 73c4b1c7a74..d94040f1a21 100644 --- a/deps/npm/docs/content/commands/npm-run-script.md +++ b/deps/npm/docs/content/commands/npm-run-script.md @@ -246,7 +246,7 @@ will *not* run any pre- or post-scripts. * Type: null or String The shell to use for scripts run with the `npm exec`, `npm run` and `npm -init ` commands. +init ` commands. diff --git a/deps/npm/docs/content/commands/npm-star.md b/deps/npm/docs/content/commands/npm-star.md index 00ef17a816b..3e81c6a55bb 100644 --- a/deps/npm/docs/content/commands/npm-star.md +++ b/deps/npm/docs/content/commands/npm-star.md @@ -11,7 +11,7 @@ description: Mark your favorite packages ```bash -npm star [...] +npm star [...] ``` @@ -87,6 +87,7 @@ password, npm will prompt on the command line for one. ### See Also +* [package spec](/using-npm/package-spec) * [npm unstar](/commands/npm-unstar) * [npm stars](/commands/npm-stars) * [npm view](/commands/npm-view) diff --git a/deps/npm/docs/content/commands/npm-start.md b/deps/npm/docs/content/commands/npm-start.md index 8dd874b3c7d..148f92606d8 100644 --- a/deps/npm/docs/content/commands/npm-start.md +++ b/deps/npm/docs/content/commands/npm-start.md @@ -80,7 +80,7 @@ will *not* run any pre- or post-scripts. * Type: null or String The shell to use for scripts run with the `npm exec`, `npm run` and `npm -init ` commands. +init ` commands. diff --git a/deps/npm/docs/content/commands/npm-stop.md b/deps/npm/docs/content/commands/npm-stop.md index 9a3a55cf3f2..a3084e8432b 100644 --- a/deps/npm/docs/content/commands/npm-stop.md +++ b/deps/npm/docs/content/commands/npm-stop.md @@ -73,7 +73,7 @@ will *not* run any pre- or post-scripts. * Type: null or String The shell to use for scripts run with the `npm exec`, `npm run` and `npm -init ` commands. +init ` commands. diff --git a/deps/npm/docs/content/commands/npm-test.md b/deps/npm/docs/content/commands/npm-test.md index 8a343ab299b..72bb899d0b9 100644 --- a/deps/npm/docs/content/commands/npm-test.md +++ b/deps/npm/docs/content/commands/npm-test.md @@ -70,7 +70,7 @@ will *not* run any pre- or post-scripts. * Type: null or String The shell to use for scripts run with the `npm exec`, `npm run` and `npm -init ` commands. +init ` commands. diff --git a/deps/npm/docs/content/commands/npm-unpublish.md b/deps/npm/docs/content/commands/npm-unpublish.md index a4c481ea5af..9ad99e72a5a 100644 --- a/deps/npm/docs/content/commands/npm-unpublish.md +++ b/deps/npm/docs/content/commands/npm-unpublish.md @@ -11,7 +11,7 @@ description: Remove a package from the registry ```bash -npm unpublish [<@scope>/][@] +npm unpublish [] ``` @@ -146,6 +146,7 @@ This value is not exported to the environment for child processes. ### See Also +* [package spec](/using-npm/package-spec) * [npm deprecate](/commands/npm-deprecate) * [npm publish](/commands/npm-publish) * [npm registry](/using-npm/registry) diff --git a/deps/npm/docs/content/commands/npm-unstar.md b/deps/npm/docs/content/commands/npm-unstar.md index 76202190da8..636e1b6ac0a 100644 --- a/deps/npm/docs/content/commands/npm-unstar.md +++ b/deps/npm/docs/content/commands/npm-unstar.md @@ -11,7 +11,7 @@ description: Remove an item from your favorite packages ```bash -npm unstar [...] +npm unstar [...] ``` diff --git a/deps/npm/docs/content/commands/npm-view.md b/deps/npm/docs/content/commands/npm-view.md index 0ef17d8adfb..d9d1daac0cd 100644 --- a/deps/npm/docs/content/commands/npm-view.md +++ b/deps/npm/docs/content/commands/npm-view.md @@ -11,7 +11,7 @@ description: View registry info ```bash -npm view [<@scope>/][@] [[.subfield]...] +npm view [] [[.subfield]...] aliases: info, show, v ``` @@ -203,6 +203,7 @@ the field name. ### See Also +* [package spec](/using-npm/package-spec) * [npm search](/commands/npm-search) * [npm registry](/using-npm/registry) * [npm config](/commands/npm-config) diff --git a/deps/npm/docs/content/configuring-npm/package-json.md b/deps/npm/docs/content/configuring-npm/package-json.md index 8b188cfb0b9..64081350af2 100644 --- a/deps/npm/docs/content/configuring-npm/package-json.md +++ b/deps/npm/docs/content/configuring-npm/package-json.md @@ -222,7 +222,7 @@ npm also sets a top-level "maintainers" field with your npm user info. ### funding -You can specify an object containing an URL that provides up-to-date +You can specify an object containing a URL that provides up-to-date information about ways to help fund development of your package, or a string URL, or an array of these: diff --git a/deps/npm/docs/content/using-npm/config.md b/deps/npm/docs/content/using-npm/config.md index 6ef854eb6e0..3fb43140266 100644 --- a/deps/npm/docs/content/using-npm/config.md +++ b/deps/npm/docs/content/using-npm/config.md @@ -1518,7 +1518,7 @@ npm init --scope=@foo --yes * Type: null or String The shell to use for scripts run with the `npm exec`, `npm run` and `npm -init ` commands. +init ` commands. diff --git a/deps/npm/docs/content/using-npm/package-spec.md b/deps/npm/docs/content/using-npm/package-spec.md new file mode 100644 index 00000000000..0d3741018f0 --- /dev/null +++ b/deps/npm/docs/content/using-npm/package-spec.md @@ -0,0 +1,106 @@ +--- +title: package-spec +section: 7 +description: Package name specifier +--- + + +### Description + +Commands like `npm install` and the dependency sections in the +`package.json` use a package name specifier. This can be many different +things that all refer to a "package". Examples include a package name, +git url, tarball, or local directory. These will generally be referred +to as `` in the help output for the npm commands that use +this package name specifier. + +### Package name + +* `[<@scope>/]` +* `[<@scope>/]@` +* `[<@scope>/]@` +* `[<@scope>/]@` + +Refers to a package by name, with or without a scope, and optionally +tag, version, or version range. This is typically used in combination +with the [registry](/using-npm/config#registry) config to refer to a +package in a registry. + +Examples: +* `npm` +* `@npmcli/arborist` +* `@npmcli/arborist@latest` +* `npm@6.13.1` +* `npm@^4.0.0` + +### Aliases + +* `@npm:` + +Primarily used by commands like `npm install` and in the dependency +sections in the `package.json`, this refers to a package by an alias. +The `` is the name of the package as it is reified in the +`node_modules` folder, and the `` refers to a package name as +found in the configured registry. + +See `Package name` above for more info on referring to a package by +name, and [registry](/using-npm/config#registry) for configuring which +registry is used when referring to a package by name. + +Examples: +* `semver:@npm:@npmcli/semver-with-patch` +* `semver:@npm:semver@7.2.2` +* `semver:@npm:semver@legacy` + +### Folders + +* `` + +This refers to a package on the local filesystem. Specifically this is +a folder with a `package.json` file in it. This *should* always be +prefixed with a `/` or `./` (or your OS equivalent) to reduce confusion. +npm currently will parse a string with more than one `/` in it as a +folder, but this is legacy behavior that may be removed in a future +version. + +Examples: + +* `./my-package` +* `/opt/npm/my-package` + +### Tarballs + +* `` +* `` + +Examples: + +* `./my-package.tgz` +* `https://registry.npmjs.org/semver/-/semver-1.0.0.tgz` + +Refers to a package in a tarball format, either on the local filesystem +or remotely via url. This is the format that packages exist in when +uploaded to a registry. + +### git urls + +* `` +* `/` + +Refers to a package in a git repo. This can be a full git url, git +shorthand, or a username/package on GitHub. You can specify a +git tag, branch, or other git ref by appending `#ref`. + +Examples: + +* `https://github.com/npm/cli.git` +* `git@github.com:npm/cli.git` +* `git+ssh://git@github.com/npm/cli#v6.0.0` +* `github:npm/cli#HEAD` +* `npm/cli#c12ea07` + +### See also + +[npm-package-arg](https://npm.im/npm-package-arg) +[scope](/using-npm/scope) +[config](/using-npm/config) diff --git a/deps/npm/docs/output/commands/npm-cache.html b/deps/npm/docs/output/commands/npm-cache.html index c5d6869b343..ad29cc73819 100644 --- a/deps/npm/docs/output/commands/npm-cache.html +++ b/deps/npm/docs/output/commands/npm-cache.html @@ -149,11 +149,7 @@

Table of contents

-
npm cache add <tarball file>
-npm cache add <folder>
-npm cache add <tarball url>
-npm cache add <git url>
-npm cache add <name>@<version>
+
npm cache add <package-spec>
 npm cache clean [<key>]
 npm cache ls [<name>@<version>]
 npm cache verify
@@ -224,6 +220,7 @@ 
cache

 
 
See Also

 
    
+
  • package spec
    • 
 
  • npm folders
    • 
 
  • npm config
    • 
 
  • npmrc
    • 
diff --git a/deps/npm/docs/output/commands/npm-ci.html b/deps/npm/docs/output/commands/npm-ci.html
index 4f9a194ae57..abc8ce6deb0 100644
--- a/deps/npm/docs/output/commands/npm-ci.html
+++ b/deps/npm/docs/output/commands/npm-ci.html
@@ -245,7 +245,7 @@ 
    script-shell
    
 
  • Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
    • 
 
  • Type: null or String
    • 
 

-
The shell to use for scripts run with the npm exec, npm run and npm init <pkg> commands.

+
The shell to use for scripts run with the npm exec, npm run and npm init <package-spec> commands.

 
 
 
diff --git a/deps/npm/docs/output/commands/npm-deprecate.html b/deps/npm/docs/output/commands/npm-deprecate.html
index 52a9ef82c30..5b1d3489ca6 100644
--- a/deps/npm/docs/output/commands/npm-deprecate.html
+++ b/deps/npm/docs/output/commands/npm-deprecate.html
@@ -149,7 +149,7 @@ 
Table of contents

 
 
 
-
npm deprecate <pkg>[@<version>] <message>
+
npm deprecate <package-spec> <message>
 

 
 
@@ -198,6 +198,7 @@ 
otp

 
 
See Also

 
    
+
  • package spec
    • 
 
  • npm publish
    • 
 
  • npm registry
    • 
 
  • npm owner
    • 
diff --git a/deps/npm/docs/output/commands/npm-dist-tag.html b/deps/npm/docs/output/commands/npm-dist-tag.html
index 8615aec686f..a6cdc6230b2 100644
--- a/deps/npm/docs/output/commands/npm-dist-tag.html
+++ b/deps/npm/docs/output/commands/npm-dist-tag.html
@@ -149,9 +149,9 @@ 
    Table of contents
    
 
 
 
-
    npm dist-tag add <pkg>@<version> [<tag>]
-npm dist-tag rm <pkg> <tag>
-npm dist-tag ls [<pkg>]
+
    npm dist-tag add <package-spec (with version)> [<tag>]
+npm dist-tag rm <package-spec> <tag>
+npm dist-tag ls [<package-spec>]
 
 alias: dist-tags
 
    
@@ -162,11 +162,11 @@ 
    Description
    
 
    Add, remove, and enumerate distribution tags on a package:
    
 
      
 
    • 
-
      add: Tags the specified version of the package with the specified tag, or
-the --tag config if not specified. If you have two-factor
-authentication on auth-and-writes then you’ll need to include a one-time
-password on the command line with --otp <one-time password>, or at the
-OTP prompt.
      
+
      add: Tags the specified version of the package with the specified tag,
+or the --tag config if not specified. If you have two-factor
+authentication on auth-and-writes then you’ll need to include a
+one-time password on the command line with
+--otp <one-time password>, or at the OTP prompt.
      
 
      • 
 
    • 
 
      rm: Clear a tag that is no longer in use from the package. If you have
@@ -273,6 +273,7 @@ 
      include-workspace-root
      
 
 
      See Also
      
 
        
+
      • package spec
        • 
 
      • npm publish
        • 
 
      • npm install
        • 
 
      • npm dedupe
        • 
diff --git a/deps/npm/docs/output/commands/npm-explain.html b/deps/npm/docs/output/commands/npm-explain.html
index caf5ab1506f..612e18676b4 100644
--- a/deps/npm/docs/output/commands/npm-explain.html
+++ b/deps/npm/docs/output/commands/npm-explain.html
@@ -149,7 +149,7 @@ 
        Table of contents
        
 
 
 
-
        npm explain <folder | specifier>
+
        npm explain <package-spec>
 
 alias: why
 
        
@@ -159,9 +159,9 @@ 
        Table of contents
        
 
        Description
        
 
        This command will print the chain of dependencies causing a given package
 to be installed in the current project.
        
-
        Positional arguments can be either folders within node_modules, or
-name@version-range specifiers, which will select the dependency
-relationships to explain.
        
+
        If one or more package specs are provided, then only packages matching
+one of the specifiers will have their relationships explained.
        
+
        The package spec can also refer to a folder within ./node_modules
        
 
        For example, running npm explain glob within npm's source tree will show:
        
 
        glob@7.1.6
 node_modules/glob
@@ -229,6 +229,7 @@ 
        workspace
        
 
 
        See Also
        
 
          
+
        • package spec
          • 
 
        • npm config
          • 
 
        • npmrc
          • 
 
        • npm folders
          • 
diff --git a/deps/npm/docs/output/commands/npm-fund.html b/deps/npm/docs/output/commands/npm-fund.html
index ba88e461c60..08389cb45ba 100644
--- a/deps/npm/docs/output/commands/npm-fund.html
+++ b/deps/npm/docs/output/commands/npm-fund.html
@@ -149,7 +149,7 @@ 
          Table of contents
          
 
 
 
-
          npm fund [[<@scope>/]<pkg>]
+
          npm fund [<package-spec>]
 
          
 
 
@@ -157,18 +157,18 @@ 
          Table of contents
          
 
          Description
          
 
          This command retrieves information on how to fund the dependencies of a
 given project. If no package name is provided, it will list all
-dependencies that are looking for funding in a tree structure, listing the
-type of funding and the url to visit. If a package name is provided then it
-tries to open its funding url using the --browser config param; if there
-are multiple funding sources for the package, the user will be instructed
-to pass the --which option to disambiguate.
          
+dependencies that are looking for funding in a tree structure, listing
+the type of funding and the url to visit. If a package name is provided
+then it tries to open its funding url using the --browser config
+param; if there are multiple funding sources for the package, the user
+will be instructed to pass the --which option to disambiguate.
          
 
          The list will avoid duplicated entries and will stack all packages that
-share the same url as a single entry. Thus, the list does not have the same
-shape of the output from npm ls.
          
+share the same url as a single entry. Thus, the list does not have the
+same shape of the output from npm ls.
          
 
          Example
          
 
          Workspaces support
          
-
          It's possible to filter the results to only include a single workspace and its
-dependencies using the workspace config option.
          
+
          It's possible to filter the results to only include a single workspace
+and its dependencies using the workspace config option.
          
 
          Example:
          
 
          Here's an example running npm fund in a project with a configured
 workspace a:
          
@@ -183,8 +183,8 @@ 
          Example:
          
 `-- https://example.com/org
     `-- bar@2.0.0
 
          
-
          And here is an example of the expected result when filtering only by
-a specific workspace a in the same project:
          
+
          And here is an example of the expected result when filtering only by a
+specific workspace a in the same project:
          
 
          $ npm fund -w a
 test-workspaces-fund@1.0.0
 `-- https://example.com/a
@@ -262,6 +262,7 @@ 
          which
          
 
 
          See Also
          
 
            
+
          • package spec
            • 
 
          • npm install
            • 
 
          • npm docs
            • 
 
          • npm ls
            • 
diff --git a/deps/npm/docs/output/commands/npm-init.html b/deps/npm/docs/output/commands/npm-init.html
index b25bfec2d4f..c7c00b3531b 100644
--- a/deps/npm/docs/output/commands/npm-init.html
+++ b/deps/npm/docs/output/commands/npm-init.html
@@ -142,16 +142,15 @@ 
            npm-init
            
 
 
            
 
            Table of contents
            
-
            
+
            
 
            
 
 
            Synopsis
            
 
 
 
-
            npm init [--force|-f|--yes|-y|--scope]
+
            npm init <package-spec> (same as `npx <package-spec>)
 npm init <@scope> (same as `npx <@scope>/create`)
-npm init [<@scope>/]<name> (same as `npx [<@scope>/]create-<name>`)
 
 aliases: create, innit
 
            
@@ -300,6 +299,29 @@ 
            force
            
 recommended that you do not use this option!
            
 
 
+
            scope
            
+
              
+
            • Default: the scope of the current project, if any, or ""
              • 
+
            • Type: String
              • 
+
            
+
            Associate an operation with a scope for a scoped registry.
            
+
            Useful when logging in to or out of a private registry:
            
+
            # log in, linking the scope to the custom registry
+npm login --scope=@mycorp --registry=https://registry.mycorp.com
+
+# log out, removing the link and the auth token
+npm logout --scope=@mycorp
+
            
+
            This will cause @mycorp to be mapped to the registry for future
+installation of packages specified according to the pattern
+@mycorp/package.
            
+
            This will also cause npm init to create a scoped package.
            
+
            # accept all defaults, and create a package named "@foo/whatever",
+# instead of just named "whatever"
+npm init --scope=@foo --yes
+
            
+
+
 
            workspace
            
 
              
 
            • Default:
              • 
@@ -363,6 +385,7 @@ 
              include-workspace-root
              
 
 
              See Also
              
 
                
+
              • package spec
                • 
 
              • init-package-json module
                • 
 
              • package.json
                • 
 
              • npm version
                • 
diff --git a/deps/npm/docs/output/commands/npm-install-ci-test.html b/deps/npm/docs/output/commands/npm-install-ci-test.html
index b414f090278..8d3d9541421 100644
--- a/deps/npm/docs/output/commands/npm-install-ci-test.html
+++ b/deps/npm/docs/output/commands/npm-install-ci-test.html
@@ -202,7 +202,7 @@ 
                script-shell
                
 
              • Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
                • 
 
              • Type: null or String
                • 
 
              
-
              The shell to use for scripts run with the npm exec, npm run and npm init <pkg> commands.
              
+
              The shell to use for scripts run with the npm exec, npm run and npm init <package-spec> commands.
              
 
 
 
diff --git a/deps/npm/docs/output/commands/npm-install-test.html b/deps/npm/docs/output/commands/npm-install-test.html
index 6306ceb5938..bf2ad29400f 100644
--- a/deps/npm/docs/output/commands/npm-install-test.html
+++ b/deps/npm/docs/output/commands/npm-install-test.html
@@ -149,16 +149,7 @@ 
              Table of contents
              
 
 
 
-
              npm install-test [<@scope>/]<pkg>
-npm install-test [<@scope>/]<pkg>@<tag>
-npm install-test [<@scope>/]<pkg>@<version>
-npm install-test [<@scope>/]<pkg>@<version range>
-npm install-test <alias>@npm:<name>
-npm install-test <folder>
-npm install-test <tarball file>
-npm install-test <tarball url>
-npm install-test <git:// url>
-npm install-test <github username>/<github project>
+
              npm install-test [<package-spec> ...]
 
 alias: it
 
              
diff --git a/deps/npm/docs/output/commands/npm-install.html b/deps/npm/docs/output/commands/npm-install.html
index 509702b5bd4..48f62f9e482 100644
--- a/deps/npm/docs/output/commands/npm-install.html
+++ b/deps/npm/docs/output/commands/npm-install.html
@@ -149,16 +149,7 @@ 
              Table of contents
              
 
 
 
-
              npm install [<@scope>/]<pkg>
-npm install [<@scope>/]<pkg>@<tag>
-npm install [<@scope>/]<pkg>@<version>
-npm install [<@scope>/]<pkg>@<version range>
-npm install <alias>@npm:<name>
-npm install <folder>
-npm install <tarball file>
-npm install <tarball url>
-npm install <git:// url>
-npm install <github username>/<github project>
+
              npm install [<package-spec> ...]
 
 aliases: add, i, in, ins, inst, insta, instal, isnt, isnta, isntal, isntall
 
              
diff --git a/deps/npm/docs/output/commands/npm-link.html b/deps/npm/docs/output/commands/npm-link.html
index f7d5f66a9e2..cd31a3ee0df 100644
--- a/deps/npm/docs/output/commands/npm-link.html
+++ b/deps/npm/docs/output/commands/npm-link.html
@@ -149,8 +149,7 @@ 
              Table of contents
              
 
 
 
-
              npm link (in package dir)
-npm link [<@scope>/]<pkg>[@<version>]
+
              npm link [<package-spec>]
 
 alias: ln
 
              
@@ -161,11 +160,11 @@ 
              Description
              
 
              This is handy for installing your own stuff, so that you can work on it and
 test iteratively without having to continually rebuild.
              
 
              Package linking is a two-step process.
              
-
              First, npm link in a package folder will create a symlink in the global
-folder {prefix}/lib/node_modules/<package> that links to the package
-where the npm link command was executed. It will also link any bins in
-the package to {prefix}/bin/{name}.  Note that npm link uses the global
-prefix (see npm prefix -g for its value).
              
+
              First, npm link in a package folder with no arguments will create a
+symlink in the global folder {prefix}/lib/node_modules/<package> that
+links to the package where the npm link command was executed. It will
+also link any bins in the package to {prefix}/bin/{name}.  Note that
+npm link uses the global prefix (see npm prefix -g for its value).
              
 
              Next, in some other location, npm link package-name will create a
 symbolic link from globally-installed package-name to node_modules/ of
 the current folder.
              
@@ -452,6 +451,7 @@ 
 
 
              See Also
              
 
                
+
              • package spec
                • 
 
              • npm developers
                • 
 
              • package.json
                • 
 
              • npm install
                • 
diff --git a/deps/npm/docs/output/commands/npm-ls.html b/deps/npm/docs/output/commands/npm-ls.html
index 7b1c29f9a80..4363442ef3d 100644
--- a/deps/npm/docs/output/commands/npm-ls.html
+++ b/deps/npm/docs/output/commands/npm-ls.html
@@ -149,7 +149,7 @@ 
                Table of contents
                
 
 
 
-
                npm ls [[<@scope>/]<pkg> ...]
+
                npm ls <package-spec>
 
 alias: list
 
                
@@ -166,7 +166,7 @@ 
                Description
                
 the results to only the paths to the packages named.  Note that nested
 packages will also show the paths to the specified packages.  For
 example, running npm ls promzard in npm's source tree will show:
                
-
                npm@8.12.1 /path/to/npm
+
                npm@8.13.1 /path/to/npm
 └─┬ init-package-json@0.0.4
   └── promzard@0.1.5
 
                
@@ -379,6 +379,7 @@ 
 
 
                See Also
                
 
                  
+
                • package spec
                  • 
 
                • npm explain
                  • 
 
                • npm config
                  • 
 
                • npmrc
                  • 
diff --git a/deps/npm/docs/output/commands/npm-outdated.html b/deps/npm/docs/output/commands/npm-outdated.html
index 0bdb9f9a66a..57740228c48 100644
--- a/deps/npm/docs/output/commands/npm-outdated.html
+++ b/deps/npm/docs/output/commands/npm-outdated.html
@@ -149,7 +149,7 @@ 
                  Table of contents
                  
 
 
 
-
                  npm outdated [[<@scope>/]<pkg> ...]
+
                  npm outdated [<package-spec> ...]
 
                  
 
 
@@ -304,6 +304,7 @@ 
                  workspace
                  
 
 
                  See Also
                  
 
                    
+
                  • package spec
                    • 
 
                  • npm update
                    • 
 
                  • npm dist-tag
                    • 
 
                  • npm registry
                    • 
diff --git a/deps/npm/docs/output/commands/npm-owner.html b/deps/npm/docs/output/commands/npm-owner.html
index 744f7821408..bf47a0ce04f 100644
--- a/deps/npm/docs/output/commands/npm-owner.html
+++ b/deps/npm/docs/output/commands/npm-owner.html
@@ -149,9 +149,9 @@ 
                    Table of contents
                    
 
 
 
-
                    npm owner add <user> [<@scope>/]<pkg>
-npm owner rm <user> [<@scope>/]<pkg>
-npm owner ls [<@scope>/]<pkg>
+
                    npm owner add <user> <package-spec>
+npm owner rm <user> <package-spec>
+npm owner ls <package-spec>
 
 alias: author
 
                    
@@ -240,6 +240,7 @@ 
                    workspaces
                    
 
 
                    See Also
                    
 
                      
+
                    • package spec
                      • 
 
                    • npm profile
                      • 
 
                    • npm publish
                      • 
 
                    • npm registry
                      • 
diff --git a/deps/npm/docs/output/commands/npm-pack.html b/deps/npm/docs/output/commands/npm-pack.html
index 86e45cb303a..387becd8c1f 100644
--- a/deps/npm/docs/output/commands/npm-pack.html
+++ b/deps/npm/docs/output/commands/npm-pack.html
@@ -149,7 +149,7 @@ 
                      Table of contents
                      
 
 
 
-
                      npm pack [[<@scope>/]<pkg>...]
+
                      npm pack <package-spec>
 
                      
 
 
@@ -255,6 +255,7 @@ 
                      Description
                      
 
                      If no arguments are supplied, then npm packs the current package folder.
                      
 
                      See Also
                      
 
                        
+
                      • package spec
                        • 
 
                      • npm-packlist package
                        • 
 
                      • npm cache
                        • 
 
                      • npm publish
                        • 
diff --git a/deps/npm/docs/output/commands/npm-publish.html b/deps/npm/docs/output/commands/npm-publish.html
index 23e5f11ea0e..019295ab1f0 100644
--- a/deps/npm/docs/output/commands/npm-publish.html
+++ b/deps/npm/docs/output/commands/npm-publish.html
@@ -149,58 +149,31 @@ 
                        Table of contents
                        
 
 
 
-
                        npm publish [<folder>]
+
                        npm publish <package-spec>
 
                        
 
 
 
 
                        Description
                        
 
                        Publishes a package to the registry so that it can be installed by name.
                        
-
                        By default npm will publish to the public registry. This can be overridden
-by specifying a different default registry or using a
-scope in the name (see
+
                        By default npm will publish to the public registry. This can be
+overridden by specifying a different default registry or using a
+scope in the name, combined with a
+scope-configured registry (see
 package.json).
                        
+
                        A package is interpreted the same way as other commands (like
+npm install and can be:
                        
 
                          
-
                        • 
-
                          <folder>: A folder containing a package.json file
                          
-
                          • 
-
                        • 
-
                          <tarball>: A url or file path to a gzipped tar archive containing a
-single folder with a package.json file inside.
                          
-
                          • 
-
                        • 
-
                          [--tag <tag>]: Registers the published package with the given tag, such
-that npm install <name>@<tag> will install this version.  By default,
-npm publish updates and npm install installs the latest tag. See
-npm-dist-tag for details about tags.
                          
-
                          • 
-
                        • 
-
                          [--access <public|restricted>]: Tells the registry whether this package
-should be published as public or restricted. Only applies to scoped
-packages, which default to restricted.  If you don't have a paid
-account, you must publish with --access public to publish scoped
-packages.
                          
-
                          • 
-
                        • 
-
                          [--otp <otpcode>]: If you have two-factor authentication enabled in
-auth-and-writes mode then you can provide a code from your
-authenticator with this. If you don't include this and you're running
-from a TTY then you'll be prompted.
                          
-
                          • 
-
                        • 
-
                          [--dry-run]: As of npm@6, does everything publish would do except
-actually publishing to the registry. Reports the details of what would
-have been published.
                          
-
                          • 
-
                        • 
-
                          [--workspaces]: Enables workspace context while publishing. All
-workspace packages will be published.
                          
-
                          • 
-
                        • 
-
                          [--workspace]: Enables workspaces context and limits results to only
-those specified by this config item.  Only the packages in the
-workspaces given will be published.
                          
-
                          • 
+
                        • a) a folder containing a program described by a
+package.json file
                          • 
+
                        • b) a gzipped tarball containing (a)
                          • 
+
                        • c) a url that resolves to (b)
                          • 
+
                        • d) a <name>@<version> that is published on the registry (see
+registry) with (c)
                          • 
+
                        • e) a <name>@<tag> (see npm dist-tag) that
+points to (d)
                          • 
+
                        • f) a <name> that has a "latest" tag satisfying (e)
                          • 
+
                        • g) a <git remote url> that resolves to (a)
                          • 
 
                        
 
                        The publish will fail if the package name and version combination already
 exists in the specified registry.
                        
@@ -361,6 +334,7 @@ 
                        include-workspace-root
                        
 
 
                        See Also
                        
 
                          
+
                        • package spec
                          • 
 
                        • npm-packlist package
                          • 
 
                        • npm registry
                          • 
 
                        • npm scope
                          • 
diff --git a/deps/npm/docs/output/commands/npm-rebuild.html b/deps/npm/docs/output/commands/npm-rebuild.html
index f4524f1a4f0..2fdd821d592 100644
--- a/deps/npm/docs/output/commands/npm-rebuild.html
+++ b/deps/npm/docs/output/commands/npm-rebuild.html
@@ -149,7 +149,7 @@ 
                          Table of contents
                          
 
 
 
-
                          npm rebuild [[<@scope>/]<name>[@<version>] ...]
+
                          npm rebuild [<package-spec>] ...]
 
 alias: rb
 
                          
@@ -162,9 +162,8 @@ 
                          Description
                          
 C++ addons with the new binary.  It is also useful when installing with
 --ignore-scripts and --no-bin-links, to explicitly choose which
 packages to build and/or link bins.
                          
-
                          If one or more package names (and optionally version ranges) are provided,
-then only packages with a name and version matching one of the specifiers
-will be rebuilt.
                          
+
                          If one or more package specs are provided, then only packages with a
+name and version matching one of the specifiers will be rebuilt.
                          
 
                          Configuration
                          
 
 
@@ -285,6 +284,7 @@ 
 
 
                          See Also
                          
 
 
            
diff --git a/deps/npm/docs/output/commands/npm-restart.html b/deps/npm/docs/output/commands/npm-restart.html
index f65a170d538..0e39072664a 100644
--- a/deps/npm/docs/output/commands/npm-restart.html
+++ b/deps/npm/docs/output/commands/npm-restart.html
@@ -196,7 +196,7 @@ 
            script-shell
            
 
          • Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
            • 
 
          • Type: null or String
            • 
 
          
-
          The shell to use for scripts run with the npm exec, npm run and npm init <pkg> commands.
          
+
          The shell to use for scripts run with the npm exec, npm run and npm init <package-spec> commands.
          
 
 
 
diff --git a/deps/npm/docs/output/commands/npm-run-script.html b/deps/npm/docs/output/commands/npm-run-script.html
index 6211c2b55ef..d74acb05644 100644
--- a/deps/npm/docs/output/commands/npm-run-script.html
+++ b/deps/npm/docs/output/commands/npm-run-script.html
@@ -324,7 +324,7 @@ 
          script-shell
          
 
        • Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
          • 
 
        • Type: null or String
          • 
 
        
-
        The shell to use for scripts run with the npm exec, npm run and npm init <pkg> commands.
        
+
        The shell to use for scripts run with the npm exec, npm run and npm init <package-spec> commands.
        
 
 
 
diff --git a/deps/npm/docs/output/commands/npm-star.html b/deps/npm/docs/output/commands/npm-star.html
index bc1f7ae7699..d442e391108 100644
--- a/deps/npm/docs/output/commands/npm-star.html
+++ b/deps/npm/docs/output/commands/npm-star.html
@@ -149,7 +149,7 @@ 
        Table of contents
        
 
 
 
-
        npm star [<pkg>...]
+
        npm star [<package-spec>...]
 
        
 
 
@@ -202,6 +202,7 @@ 
        otp
        
 
 
        See Also
        
 
          
+
        • package spec
          • 
 
        • npm unstar
          • 
 
        • npm stars
          • 
 
        • npm view
          • 
diff --git a/deps/npm/docs/output/commands/npm-start.html b/deps/npm/docs/output/commands/npm-start.html
index 8cedd9855d8..4f300f37ade 100644
--- a/deps/npm/docs/output/commands/npm-start.html
+++ b/deps/npm/docs/output/commands/npm-start.html
@@ -200,7 +200,7 @@ 
          script-shell
          
 
        • Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
          • 
 
        • Type: null or String
          • 
 
        
-
        The shell to use for scripts run with the npm exec, npm run and npm init <pkg> commands.
        
+
        The shell to use for scripts run with the npm exec, npm run and npm init <package-spec> commands.
        
 
 
 
diff --git a/deps/npm/docs/output/commands/npm-stop.html b/deps/npm/docs/output/commands/npm-stop.html
index 87b7d30fd8f..8c91c7321a5 100644
--- a/deps/npm/docs/output/commands/npm-stop.html
+++ b/deps/npm/docs/output/commands/npm-stop.html
@@ -195,7 +195,7 @@ 
        script-shell
        
 
      • Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
        • 
 
      • Type: null or String
        • 
 
      
-
      The shell to use for scripts run with the npm exec, npm run and npm init <pkg> commands.
      
+
      The shell to use for scripts run with the npm exec, npm run and npm init <package-spec> commands.
      
 
 
 
diff --git a/deps/npm/docs/output/commands/npm-test.html b/deps/npm/docs/output/commands/npm-test.html
index 5c403b94eb9..c4d71b30f51 100644
--- a/deps/npm/docs/output/commands/npm-test.html
+++ b/deps/npm/docs/output/commands/npm-test.html
@@ -193,7 +193,7 @@ 
      script-shell
      
 
    • Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
      • 
 
    • Type: null or String
      • 
 
    
-
    The shell to use for scripts run with the npm exec, npm run and npm init <pkg> commands.
    
+
    The shell to use for scripts run with the npm exec, npm run and npm init <package-spec> commands.
    
 
 
 
diff --git a/deps/npm/docs/output/commands/npm-unpublish.html b/deps/npm/docs/output/commands/npm-unpublish.html
index 21fafc89eba..ab5858f2666 100644
--- a/deps/npm/docs/output/commands/npm-unpublish.html
+++ b/deps/npm/docs/output/commands/npm-unpublish.html
@@ -149,7 +149,7 @@ 
    Table of contents
    
 
 
 
-
    npm unpublish [<@scope>/]<pkg>[@<version>]
+
    npm unpublish [<package-spec>]
 
    
 
 
@@ -257,6 +257,7 @@ 
    workspaces
    
 
 
    See Also
    
 
      
+
    • package spec
      • 
 
    • npm deprecate
      • 
 
    • npm publish
      • 
 
    • npm registry
      • 
diff --git a/deps/npm/docs/output/commands/npm-unstar.html b/deps/npm/docs/output/commands/npm-unstar.html
index a332f857e6b..c8b057f8e2d 100644
--- a/deps/npm/docs/output/commands/npm-unstar.html
+++ b/deps/npm/docs/output/commands/npm-unstar.html
@@ -149,7 +149,7 @@ 
      Table of contents
      
 
 
 
-
      npm unstar [<pkg>...]
+
      npm unstar [<package-spec>...]
 
      
 
 
diff --git a/deps/npm/docs/output/commands/npm-view.html b/deps/npm/docs/output/commands/npm-view.html
index 0eb17026a77..2b74e28f3b9 100644
--- a/deps/npm/docs/output/commands/npm-view.html
+++ b/deps/npm/docs/output/commands/npm-view.html
@@ -149,7 +149,7 @@ 
      Table of contents
      
 
 
 
-
      npm view [<@scope>/]<pkg>[@<version>] [<field>[.subfield]...]
+
      npm view [<package-spec>] [<field>[.subfield]...]
 
 aliases: info, show, v
 
      
@@ -285,6 +285,7 @@ 
      Output
      
 the field name.
      
 
      See Also
      
 
        
+
      • package spec
        • 
 
      • npm search
        • 
 
      • npm registry
        • 
 
      • npm config
        • 
diff --git a/deps/npm/docs/output/commands/npm.html b/deps/npm/docs/output/commands/npm.html
index 040166af65c..c7b7dd5dc7a 100644
--- a/deps/npm/docs/output/commands/npm.html
+++ b/deps/npm/docs/output/commands/npm.html
@@ -149,7 +149,7 @@ 
        Table of contents
        
 
 
 
        Version
        
-
        8.12.1
        
+
        8.13.1
        
 
        Description
        
 
        npm is the package manager for the Node JavaScript platform.  It puts
 modules in place so that node can find them, and manages dependency
diff --git a/deps/npm/docs/output/configuring-npm/package-json.html b/deps/npm/docs/output/configuring-npm/package-json.html
index d5860ee6e29..a3bcd299c5b 100644
--- a/deps/npm/docs/output/configuring-npm/package-json.html
+++ b/deps/npm/docs/output/configuring-npm/package-json.html
@@ -304,7 +304,7 @@ 
        people fields: author, contributorsBoth email and url are optional either way.
        
 
        npm also sets a top-level "maintainers" field with your npm user info.
        
 
        funding
        
-
        You can specify an object containing an URL that provides up-to-date
+
        You can specify an object containing a URL that provides up-to-date
 information about ways to help fund development of your package, or a
 string URL, or an array of these:
        
 
        {
diff --git a/deps/npm/docs/output/using-npm/config.html b/deps/npm/docs/output/using-npm/config.html
index 4ec52124ffe..42789d96b79 100644
--- a/deps/npm/docs/output/using-npm/config.html
+++ b/deps/npm/docs/output/using-npm/config.html
@@ -1360,7 +1360,7 @@ 
        script-shell
        
 
      • Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
        • 
 
      • Type: null or String
        • 
 
      
-
      The shell to use for scripts run with the npm exec, npm run and npm init <pkg> commands.
      
+
      The shell to use for scripts run with the npm exec, npm run and npm init <package-spec> commands.
      
 
 
 
      searchexclude
      
diff --git a/deps/npm/docs/output/using-npm/package-spec.html b/deps/npm/docs/output/using-npm/package-spec.html
new file mode 100644
index 00000000000..2b0855737bc
--- /dev/null
+++ b/deps/npm/docs/output/using-npm/package-spec.html
@@ -0,0 +1,254 @@
+
+
+package-spec
+
+
+
+
+
+
      
+
      
+
      package-spec
      
+Package name specifier
+
      
+
+
      
+
      Table of contents
      
+
      
+
      
+
+
      Description
      
+
      Commands like npm install and the dependency sections in the
+package.json use a package name specifier.  This can be many different
+things that all refer to a "package".  Examples include a package name,
+git url, tarball, or local directory.  These will generally be referred
+to as <package-spec> in the help output for the npm commands that use
+this package name specifier.
      
+
      Package name
      
+
        
+
      • [<@scope>/]<pkg>
        • 
+
      • [<@scope>/]<pkg>@<tag>
        • 
+
      • [<@scope>/]<pkg>@<version>
        • 
+
      • [<@scope>/]<pkg>@<version range>
        • 
+
      
+
      Refers to a package by name, with or without a scope, and optionally
+tag, version, or version range.  This is typically used in combination
+with the registry config to refer to a
+package in a registry.
      
+
      Examples:
      
+
        
+
      • npm
        • 
+
      • @npmcli/arborist
        • 
+
      • @npmcli/arborist@latest
        • 
+
      • npm@6.13.1
        • 
+
      • npm@^4.0.0
        • 
+
      
+
      Aliases
      
+
        
+
      • <alias>@npm:<name>
        • 
+
      
+
      Primarily used by commands like npm install and in the dependency
+sections in the package.json, this refers to a package by an alias.
+The <alias> is the name of the package as it is reified in the
+node_modules folder, and the <name> refers to a package name as
+found in the configured registry.
      
+
      See Package name above for more info on referring to a package by
+name, and registry for configuring which
+registry is used when referring to a package by name.
      
+
      Examples:
      
+
        
+
      • semver:@npm:@npmcli/semver-with-patch
        • 
+
      • semver:@npm:semver@7.2.2
        • 
+
      • semver:@npm:semver@legacy
        • 
+
      
+
      Folders
      
+
        
+
      • <folder>
        • 
+
      
+
      This refers to a package on the local filesystem.  Specifically this is
+a folder with a package.json file in it.  This should always be
+prefixed with a / or ./ (or your OS equivalent) to reduce confusion.
+npm currently will parse a string with more than one / in it as a
+folder, but this is legacy behavior that may be removed in a future
+version.
      
+
      Examples:
      
+
        
+
      • ./my-package
        • 
+
      • /opt/npm/my-package
        • 
+
      
+
      Tarballs
      
+
        
+
      • <tarball file>
        • 
+
      • <tarball url>
        • 
+
      
+
      Examples:
      
+
        
+
      • ./my-package.tgz
        • 
+
      • https://registry.npmjs.org/semver/-/semver-1.0.0.tgz
        • 
+
      
+
      Refers to a package in a tarball format, either on the local filesystem
+or remotely via url.  This is the format that packages exist in when
+uploaded to a registry.
      
+
      git urls
      
+
        
+
      • <git:// url>
        • 
+
      • <github username>/<github project>
        • 
+
      
+
      Refers to a package in a git repo.  This can be a full git url, git
+shorthand, or a username/package on GitHub.  You can specify a
+git tag, branch, or other git ref by appending #ref.
      
+
      Examples:
      
+
        
+
      • https://github.com/npm/cli.git
        • 
+
      • git@github.com:npm/cli.git
        • 
+
      • git+ssh://git@github.com/npm/cli#v6.0.0
        • 
+
      • github:npm/cli#HEAD
        • 
+
      • npm/cli#c12ea07
        • 
+
      
+
      See also
      
+
      npm-package-arg
+scope
+config
      
+
      
+
+
+
      
+
+
+
+
\ No newline at end of file
diff --git a/deps/npm/lib/auth/legacy.js b/deps/npm/lib/auth/legacy.js
index d1401ce14b9..9aed12f3926 100644
--- a/deps/npm/lib/auth/legacy.js
+++ b/deps/npm/lib/auth/legacy.js
@@ -1,6 +1,6 @@
 const profile = require('npm-profile')
 const log = require('../utils/log-shim')
-const openUrl = require('../utils/open-url.js')
+const openUrlPrompt = require('../utils/open-url-prompt.js')
 const read = require('../utils/read-user-info.js')
 
 const loginPrompter = async (creds) => {
@@ -47,7 +47,15 @@ const login = async (npm, opts) => {
     return newUser
   }
 
-  const openerPromise = (url) => openUrl(npm, url, 'to complete your login please visit')
+  const openerPromise = (url, emitter) =>
+    openUrlPrompt(
+      npm,
+      url,
+      'Authenticate your account at',
+      'Press ENTER to open in the browser...',
+      emitter
+    )
+
   try {
     res = await profile.login(openerPromise, loginPrompter, opts)
   } catch (err) {
diff --git a/deps/npm/lib/commands/cache.js b/deps/npm/lib/commands/cache.js
index 862f346adb4..bc52889c000 100644
--- a/deps/npm/lib/commands/cache.js
+++ b/deps/npm/lib/commands/cache.js
@@ -68,11 +68,7 @@ class Cache extends BaseCommand {
   static name = 'cache'
   static params = ['cache']
   static usage = [
-    'add ',
-    'add ',
-    'add ',
-    'add ',
-    'add @',
+    'add ',
     'clean []',
     'ls [@]',
     'verify',
diff --git a/deps/npm/lib/commands/deprecate.js b/deps/npm/lib/commands/deprecate.js
index 0ae88f1921f..862c214dbe5 100644
--- a/deps/npm/lib/commands/deprecate.js
+++ b/deps/npm/lib/commands/deprecate.js
@@ -9,7 +9,7 @@ const BaseCommand = require('../base-command.js')
 class Deprecate extends BaseCommand {
   static description = 'Deprecate a version of a package'
   static name = 'deprecate'
-  static usage = ['[@] ']
+  static usage = [' ']
   static params = [
     'registry',
     'otp',
diff --git a/deps/npm/lib/commands/dist-tag.js b/deps/npm/lib/commands/dist-tag.js
index a207e422cb5..e74a3f1d435 100644
--- a/deps/npm/lib/commands/dist-tag.js
+++ b/deps/npm/lib/commands/dist-tag.js
@@ -12,9 +12,9 @@ class DistTag extends BaseCommand {
   static params = ['workspace', 'workspaces', 'include-workspace-root']
   static name = 'dist-tag'
   static usage = [
-    'add @ []',
-    'rm  ',
-    'ls []',
+    'add  []',
+    'rm  ',
+    'ls []',
   ]
 
   static ignoreImplicitWorkspace = false
@@ -90,7 +90,7 @@ class DistTag extends BaseCommand {
     log.verbose('dist-tag add', defaultTag, 'to', spec.name + '@' + version)
 
     if (!spec.name || !version || !defaultTag) {
-      throw this.usageError()
+      throw this.usageError('must provide a spec with a name and version, and a tag to add')
     }
 
     const t = defaultTag.trim()
diff --git a/deps/npm/lib/commands/explain.js b/deps/npm/lib/commands/explain.js
index ca6ee7540bc..c0ef04548a4 100644
--- a/deps/npm/lib/commands/explain.js
+++ b/deps/npm/lib/commands/explain.js
@@ -10,7 +10,7 @@ const ArboristWorkspaceCmd = require('../arborist-cmd.js')
 class Explain extends ArboristWorkspaceCmd {
   static description = 'Explain installed packages'
   static name = 'explain'
-  static usage = ['']
+  static usage = ['']
   static params = [
     'json',
     'workspace',
diff --git a/deps/npm/lib/commands/fund.js b/deps/npm/lib/commands/fund.js
index 09ca81653b0..9690cbc32e0 100644
--- a/deps/npm/lib/commands/fund.js
+++ b/deps/npm/lib/commands/fund.js
@@ -20,7 +20,7 @@ class Fund extends ArboristWorkspaceCmd {
   static description = 'Retrieve funding information'
   static name = 'fund'
   static params = ['json', 'browser', 'unicode', 'workspace', 'which']
-  static usage = ['[[<@scope>/]]']
+  static usage = ['[]']
 
   // TODO
   /* istanbul ignore next */
diff --git a/deps/npm/lib/commands/init.js b/deps/npm/lib/commands/init.js
index 4c299e65137..b8b6bd5d53e 100644
--- a/deps/npm/lib/commands/init.js
+++ b/deps/npm/lib/commands/init.js
@@ -18,6 +18,7 @@ class Init extends BaseCommand {
   static params = [
     'yes',
     'force',
+    'scope',
     'workspace',
     'workspaces',
     'workspaces-update',
@@ -26,9 +27,8 @@ class Init extends BaseCommand {
 
   static name = 'init'
   static usage = [
-    '[--force|-f|--yes|-y|--scope]',
+    ' (same as `npx )',
     '<@scope> (same as `npx <@scope>/create`)',
-    '[<@scope>/] (same as `npx [<@scope>/]create-`)',
   ]
 
   static ignoreImplicitWorkspace = false
diff --git a/deps/npm/lib/commands/install.js b/deps/npm/lib/commands/install.js
index 4cda3644831..ecc0727a2ef 100644
--- a/deps/npm/lib/commands/install.js
+++ b/deps/npm/lib/commands/install.js
@@ -34,18 +34,7 @@ class Install extends ArboristWorkspaceCmd {
     ...super.params,
   ]
 
-  static usage = [
-    '[<@scope>/]',
-    '[<@scope>/]@',
-    '[<@scope>/]@',
-    '[<@scope>/]@',
-    '@npm:',
-    '',
-    '',
-    '',
-    '',
-    '/',
-  ]
+  static usage = ['[ ...]']
 
   async completion (opts) {
     const { partialWord } = opts
diff --git a/deps/npm/lib/commands/link.js b/deps/npm/lib/commands/link.js
index 80a60d36e32..b0b889ea787 100644
--- a/deps/npm/lib/commands/link.js
+++ b/deps/npm/lib/commands/link.js
@@ -15,8 +15,7 @@ class Link extends ArboristWorkspaceCmd {
   static description = 'Symlink a package folder'
   static name = 'link'
   static usage = [
-    '(in package dir)',
-    '[<@scope>/][@]',
+    '[]',
   ]
 
   static params = [
diff --git a/deps/npm/lib/commands/ls.js b/deps/npm/lib/commands/ls.js
index cfd9cb5a505..d3932072b7d 100644
--- a/deps/npm/lib/commands/ls.js
+++ b/deps/npm/lib/commands/ls.js
@@ -27,7 +27,7 @@ const localeCompare = require('@isaacs/string-locale-compare')('en')
 class LS extends ArboristWorkspaceCmd {
   static description = 'List installed packages'
   static name = 'ls'
-  static usage = ['[[<@scope>/] ...]']
+  static usage = ['']
   static params = [
     'all',
     'json',
diff --git a/deps/npm/lib/commands/outdated.js b/deps/npm/lib/commands/outdated.js
index 081e75a2c61..042b776f71e 100644
--- a/deps/npm/lib/commands/outdated.js
+++ b/deps/npm/lib/commands/outdated.js
@@ -15,7 +15,7 @@ const ArboristWorkspaceCmd = require('../arborist-cmd.js')
 class Outdated extends ArboristWorkspaceCmd {
   static description = 'Check for outdated packages'
   static name = 'outdated'
-  static usage = ['[[<@scope>/] ...]']
+  static usage = ['[ ...]']
   static params = [
     'all',
     'json',
diff --git a/deps/npm/lib/commands/owner.js b/deps/npm/lib/commands/owner.js
index 4797e9c7ec8..732bb40a300 100644
--- a/deps/npm/lib/commands/owner.js
+++ b/deps/npm/lib/commands/owner.js
@@ -27,9 +27,9 @@ class Owner extends BaseCommand {
   ]
 
   static usage = [
-    'add  [<@scope>/]',
-    'rm  [<@scope>/]',
-    'ls [<@scope>/]',
+    'add  ',
+    'rm  ',
+    'ls ',
   ]
 
   static ignoreImplicitWorkspace = false
diff --git a/deps/npm/lib/commands/pack.js b/deps/npm/lib/commands/pack.js
index 8190ceecaf9..c6a74804642 100644
--- a/deps/npm/lib/commands/pack.js
+++ b/deps/npm/lib/commands/pack.js
@@ -17,7 +17,7 @@ class Pack extends BaseCommand {
     'include-workspace-root',
   ]
 
-  static usage = ['[[<@scope>/]...]']
+  static usage = ['']
   static ignoreImplicitWorkspace = false
 
   async exec (args) {
diff --git a/deps/npm/lib/commands/publish.js b/deps/npm/lib/commands/publish.js
index da6437fa9c5..579f5d6e74e 100644
--- a/deps/npm/lib/commands/publish.js
+++ b/deps/npm/lib/commands/publish.js
@@ -37,7 +37,7 @@ class Publish extends BaseCommand {
     'include-workspace-root',
   ]
 
-  static usage = ['[]']
+  static usage = ['']
   static ignoreImplicitWorkspace = false
 
   async exec (args) {
diff --git a/deps/npm/lib/commands/rebuild.js b/deps/npm/lib/commands/rebuild.js
index 3e6046d8df2..d06313ce483 100644
--- a/deps/npm/lib/commands/rebuild.js
+++ b/deps/npm/lib/commands/rebuild.js
@@ -16,7 +16,7 @@ class Rebuild extends ArboristWorkspaceCmd {
     ...super.params,
   ]
 
-  static usage = ['[[<@scope>/][@] ...]']
+  static usage = ['[] ...]']
 
   // TODO
   /* istanbul ignore next */
diff --git a/deps/npm/lib/commands/star.js b/deps/npm/lib/commands/star.js
index 7b76be3c163..20039bf8938 100644
--- a/deps/npm/lib/commands/star.js
+++ b/deps/npm/lib/commands/star.js
@@ -7,7 +7,7 @@ const BaseCommand = require('../base-command.js')
 class Star extends BaseCommand {
   static description = 'Mark your favorite packages'
   static name = 'star'
-  static usage = ['[...]']
+  static usage = ['[...]']
   static params = [
     'registry',
     'unicode',
diff --git a/deps/npm/lib/commands/unpublish.js b/deps/npm/lib/commands/unpublish.js
index f27be2e41c1..ab929d98cad 100644
--- a/deps/npm/lib/commands/unpublish.js
+++ b/deps/npm/lib/commands/unpublish.js
@@ -20,7 +20,7 @@ class Unpublish extends BaseCommand {
   static description = 'Remove a package from the registry'
   static name = 'unpublish'
   static params = ['dry-run', 'force', 'workspace', 'workspaces']
-  static usage = ['[<@scope>/][@]']
+  static usage = ['[]']
   static ignoreImplicitWorkspace = false
 
   async getKeysOfVersions (name, opts) {
diff --git a/deps/npm/lib/commands/view.js b/deps/npm/lib/commands/view.js
index efb298a03bc..3b8524ad3fc 100644
--- a/deps/npm/lib/commands/view.js
+++ b/deps/npm/lib/commands/view.js
@@ -33,7 +33,7 @@ class View extends BaseCommand {
 
   static ignoreImplicitWorkspace = false
 
-  static usage = ['[<@scope>/][@] [[.subfield]...]']
+  static usage = ['[] [[.subfield]...]']
 
   async completion (opts) {
     if (opts.conf.argv.remain.length <= 2) {
@@ -236,6 +236,15 @@ class View extends BaseCommand {
       }
     })
 
+    // No data has been pushed because no data is matching the specified version
+    if (data.length === 0 && version !== 'latest') {
+      const er = new Error(`No match found for version ${version}`)
+      er.statusCode = 404
+      er.code = 'E404'
+      er.pkgid = `${pckmnt._id}@${version}`
+      throw er
+    }
+
     if (
       !this.npm.config.get('json') &&
       args.length === 1 &&
diff --git a/deps/npm/lib/utils/config/definitions.js b/deps/npm/lib/utils/config/definitions.js
index 4c77e375c5c..6b35e7d4d05 100644
--- a/deps/npm/lib/utils/config/definitions.js
+++ b/deps/npm/lib/utils/config/definitions.js
@@ -535,7 +535,7 @@ define('dev', {
 
 define('diff', {
   default: [],
-  hint: '',
+  hint: '',
   type: [String, Array],
   description: `
     Define arguments to compare in \`npm diff\`.
@@ -1458,7 +1458,7 @@ define('otp', {
 
 define('package', {
   default: [],
-  hint: '[@]',
+  hint: '',
   type: [String, Array],
   description: `
     The package to install for [\`npm exec\`](/commands/npm-exec)
@@ -1867,7 +1867,7 @@ define('script-shell', {
   type: [null, String],
   description: `
     The shell to use for scripts run with the \`npm exec\`,
-    \`npm run\` and \`npm init \` commands.
+    \`npm run\` and \`npm init \` commands.
   `,
   flatten (key, obj, flatOptions) {
     flatOptions.scriptShell = obj[key] || undefined
diff --git a/deps/npm/lib/utils/open-url-prompt.js b/deps/npm/lib/utils/open-url-prompt.js
new file mode 100644
index 00000000000..3eb3ac288c0
--- /dev/null
+++ b/deps/npm/lib/utils/open-url-prompt.js
@@ -0,0 +1,69 @@
+const readline = require('readline')
+const opener = require('opener')
+
+function print (npm, title, url) {
+  const json = npm.config.get('json')
+
+  const message = json ? JSON.stringify({ title, url }) : `${title}:\n${url}`
+
+  npm.output(message)
+}
+
+// Prompt to open URL in browser if possible
+const promptOpen = async (npm, url, title, prompt, emitter) => {
+  const browser = npm.config.get('browser')
+  const isInteractive = process.stdin.isTTY === true && process.stdout.isTTY === true
+
+  try {
+    if (!/^https?:$/.test(new URL(url).protocol)) {
+      throw new Error()
+    }
+  } catch (_) {
+    throw new Error('Invalid URL: ' + url)
+  }
+
+  print(npm, title, url)
+
+  if (browser === false || !isInteractive) {
+    return
+  }
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  })
+
+  const tryOpen = await new Promise(resolve => {
+    rl.question(prompt, () => {
+      resolve(true)
+    })
+
+    if (emitter && emitter.addListener) {
+      emitter.addListener('abort', () => {
+        rl.close()
+
+        // clear the prompt line
+        npm.output('')
+
+        resolve(false)
+      })
+    }
+  })
+
+  if (!tryOpen) {
+    return
+  }
+
+  const command = browser === true ? null : browser
+  await new Promise((resolve, reject) => {
+    opener(url, { command }, err => {
+      if (err) {
+        return reject(err)
+      }
+
+      return resolve()
+    })
+  })
+}
+
+module.exports = promptOpen
diff --git a/deps/npm/man/man1/npm-cache.1 b/deps/npm/man/man1/npm-cache.1
index 42e1998371c..30b4947bd0b 100644
--- a/deps/npm/man/man1/npm-cache.1
+++ b/deps/npm/man/man1/npm-cache.1
@@ -5,11 +5,7 @@
 .P
 .RS 2
 .nf
-npm cache add 
-npm cache add 
-npm cache add 
-npm cache add 
-npm cache add @
+npm cache add 
 npm cache clean []
 npm cache ls [@]
 npm cache verify
@@ -85,6 +81,8 @@ cache\fP
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help folders
 .IP \(bu 2
 npm help config
diff --git a/deps/npm/man/man1/npm-ci.1 b/deps/npm/man/man1/npm-ci.1
index 533ec910058..5c92d5d9ba7 100644
--- a/deps/npm/man/man1/npm-ci.1
+++ b/deps/npm/man/man1/npm-ci.1
@@ -133,7 +133,7 @@ Type: null or String
 .RE
 .P
 The shell to use for scripts run with the \fBnpm exec\fP, \fBnpm run\fP and \fBnpm
-init \fP commands\.
+init \fP commands\.
 .SS See Also
 .RS 0
 .IP \(bu 2
diff --git a/deps/npm/man/man1/npm-deprecate.1 b/deps/npm/man/man1/npm-deprecate.1
index e9ab9bae71a..7f9fe808f50 100644
--- a/deps/npm/man/man1/npm-deprecate.1
+++ b/deps/npm/man/man1/npm-deprecate.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm deprecate [@] 
+npm deprecate  
 .fi
 .RE
 .P
@@ -38,8 +38,8 @@ In this case, a version \fBmy\-thing@1\.0\.0\-beta\.0\fP will also be deprecated
 You must be the package owner to deprecate something\.  See the \fBowner\fP and
 \fBadduser\fP help topics\.
 .P
-To un\-deprecate a package, specify an empty string (\fB""\fP) for the \fBmessage\fP 
-argument\. Note that you must use double quotes with no space between them to 
+To un\-deprecate a package, specify an empty string (\fB""\fP) for the \fBmessage\fP
+argument\. Note that you must use double quotes with no space between them to
 format an empty string\.
 .SS Configuration
 .SS \fBregistry\fP
@@ -69,6 +69,8 @@ password, npm will prompt on the command line for one\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help publish
 .IP \(bu 2
 npm help registry
diff --git a/deps/npm/man/man1/npm-dist-tag.1 b/deps/npm/man/man1/npm-dist-tag.1
index 7e1c1453954..7334c059d4d 100644
--- a/deps/npm/man/man1/npm-dist-tag.1
+++ b/deps/npm/man/man1/npm-dist-tag.1
@@ -5,9 +5,9 @@
 .P
 .RS 2
 .nf
-npm dist\-tag add @ []
-npm dist\-tag rm  
-npm dist\-tag ls []
+npm dist\-tag add  []
+npm dist\-tag rm  
+npm dist\-tag ls []
 
 alias: dist\-tags
 .fi
@@ -17,11 +17,11 @@ alias: dist\-tags
 Add, remove, and enumerate distribution tags on a package:
 .RS 0
 .IP \(bu 2
-add: Tags the specified version of the package with the specified tag, or
-the \fB\-\-tag\fP config if not specified\. If you have two\-factor
-authentication on auth\-and\-writes then you’ll need to include a one\-time
-password on the command line with \fB\-\-otp \fP, or at the
-OTP prompt\.
+add: Tags the specified version of the package with the specified tag,
+or the \fB\-\-tag\fP config if not specified\. If you have two\-factor
+authentication on auth\-and\-writes then you’ll need to include a
+one\-time password on the command line with
+\fB\-\-otp \fP, or at the OTP prompt\.
 .IP \(bu 2
 rm: Clear a tag that is no longer in use from the package\. If you have
 two\-factor authentication on auth\-and\-writes then you’ll need to include
@@ -164,6 +164,8 @@ This value is not exported to the environment for child processes\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help publish
 .IP \(bu 2
 npm help install
diff --git a/deps/npm/man/man1/npm-explain.1 b/deps/npm/man/man1/npm-explain.1
index 9a3eec6756d..fc7c2f2343b 100644
--- a/deps/npm/man/man1/npm-explain.1
+++ b/deps/npm/man/man1/npm-explain.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm explain 
+npm explain 
 
 alias: why
 .fi
@@ -15,9 +15,10 @@ alias: why
 This command will print the chain of dependencies causing a given package
 to be installed in the current project\.
 .P
-Positional arguments can be either folders within \fBnode_modules\fP, or
-\fBname@version\-range\fP specifiers, which will select the dependency
-relationships to explain\.
+If one or more package specs are provided, then only packages matching
+one of the specifiers will have their relationships explained\.
+.P
+The package spec can also refer to a folder within \fB\|\./node_modules\fP
 .P
 For example, running \fBnpm explain glob\fP within npm's source tree will show:
 .P
@@ -106,6 +107,8 @@ This value is not exported to the environment for child processes\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help config
 .IP \(bu 2
 npm help npmrc
diff --git a/deps/npm/man/man1/npm-fund.1 b/deps/npm/man/man1/npm-fund.1
index ef77df60ce8..3f48fda912c 100644
--- a/deps/npm/man/man1/npm-fund.1
+++ b/deps/npm/man/man1/npm-fund.1
@@ -5,27 +5,27 @@
 .P
 .RS 2
 .nf
-npm fund [[<@scope>/]]
+npm fund []
 .fi
 .RE
 .SS Description
 .P
 This command retrieves information on how to fund the dependencies of a
 given project\. If no package name is provided, it will list all
-dependencies that are looking for funding in a tree structure, listing the
-type of funding and the url to visit\. If a package name is provided then it
-tries to open its funding url using the \fB\-\-browser\fP config param; if there
-are multiple funding sources for the package, the user will be instructed
-to pass the \fB\-\-which\fP option to disambiguate\.
+dependencies that are looking for funding in a tree structure, listing
+the type of funding and the url to visit\. If a package name is provided
+then it tries to open its funding url using the \fB\-\-browser\fP config
+param; if there are multiple funding sources for the package, the user
+will be instructed to pass the \fB\-\-which\fP option to disambiguate\.
 .P
 The list will avoid duplicated entries and will stack all packages that
-share the same url as a single entry\. Thus, the list does not have the same
-shape of the output from \fBnpm ls\fP\|\.
+share the same url as a single entry\. Thus, the list does not have the
+same shape of the output from \fBnpm ls\fP\|\.
 .SS Example
 .SS Workspaces support
 .P
-It's possible to filter the results to only include a single workspace and its
-dependencies using the \fBworkspace\fP config option\.
+It's possible to filter the results to only include a single workspace
+and its dependencies using the \fBworkspace\fP config option\.
 .SS Example:
 .P
 Here's an example running \fBnpm fund\fP in a project with a configured
@@ -46,8 +46,8 @@ test\-workspaces\-fund@1\.0\.0
 .fi
 .RE
 .P
-And here is an example of the expected result when filtering only by
-a specific workspace \fBa\fP in the same project:
+And here is an example of the expected result when filtering only by a
+specific workspace \fBa\fP in the same project:
 .P
 .RS 2
 .nf
@@ -148,6 +148,8 @@ If there are multiple funding sources, which 1\-indexed source URL to open\.
 .SH See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help install
 .IP \(bu 2
 npm help docs
diff --git a/deps/npm/man/man1/npm-init.1 b/deps/npm/man/man1/npm-init.1
index 51e9f42f824..c49b0c7ac4c 100644
--- a/deps/npm/man/man1/npm-init.1
+++ b/deps/npm/man/man1/npm-init.1
@@ -5,9 +5,8 @@
 .P
 .RS 2
 .nf
-npm init [\-\-force|\-f|\-\-yes|\-y|\-\-scope]
+npm init  (same as `npx )
 npm init <@scope> (same as `npx <@scope>/create`)
-npm init [<@scope>/] (same as `npx [<@scope>/]create\-`)
 
 aliases: create, innit
 .fi
@@ -232,6 +231,42 @@ Allow unpublishing of entire packages (not just a single version)\.
 .P
 If you don't have a clear idea of what you want to do, it is strongly
 recommended that you do not use this option!
+.SS \fBscope\fP
+.RS 0
+.IP \(bu 2
+Default: the scope of the current project, if any, or ""
+.IP \(bu 2
+Type: String
+
+.RE
+.P
+Associate an operation with a scope for a scoped registry\.
+.P
+Useful when logging in to or out of a private registry:
+.P
+.RS 2
+.nf
+# log in, linking the scope to the custom registry
+npm login \-\-scope=@mycorp \-\-registry=https://registry\.mycorp\.com
+
+# log out, removing the link and the auth token
+npm logout \-\-scope=@mycorp
+.fi
+.RE
+.P
+This will cause \fB@mycorp\fP to be mapped to the registry for future
+installation of packages specified according to the pattern
+\fB@mycorp/package\fP\|\.
+.P
+This will also cause \fBnpm init\fP to create a scoped package\.
+.P
+.RS 2
+.nf
+# accept all defaults, and create a package named "@foo/whatever",
+# instead of just named "whatever"
+npm init \-\-scope=@foo \-\-yes
+.fi
+.RE
 .SS \fBworkspace\fP
 .RS 0
 .IP \(bu 2
@@ -316,6 +351,8 @@ This value is not exported to the environment for child processes\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 init\-package\-json module \fIhttp://npm\.im/init\-package\-json\fR
 .IP \(bu 2
 npm help package\.json
diff --git a/deps/npm/man/man1/npm-install-ci-test.1 b/deps/npm/man/man1/npm-install-ci-test.1
index e50f7e90aec..8f153e1366e 100644
--- a/deps/npm/man/man1/npm-install-ci-test.1
+++ b/deps/npm/man/man1/npm-install-ci-test.1
@@ -67,7 +67,7 @@ Type: null or String
 .RE
 .P
 The shell to use for scripts run with the \fBnpm exec\fP, \fBnpm run\fP and \fBnpm
-init \fP commands\.
+init \fP commands\.
 .SS See Also
 .RS 0
 .IP \(bu 2
diff --git a/deps/npm/man/man1/npm-install-test.1 b/deps/npm/man/man1/npm-install-test.1
index 1e6ece0f47b..02f9603e259 100644
--- a/deps/npm/man/man1/npm-install-test.1
+++ b/deps/npm/man/man1/npm-install-test.1
@@ -5,16 +5,7 @@
 .P
 .RS 2
 .nf
-npm install\-test [<@scope>/]
-npm install\-test [<@scope>/]@
-npm install\-test [<@scope>/]@
-npm install\-test [<@scope>/]@
-npm install\-test @npm:
-npm install\-test 
-npm install\-test 
-npm install\-test 
-npm install\-test 
-npm install\-test /
+npm install\-test [ \.\.\.]
 
 alias: it
 .fi
diff --git a/deps/npm/man/man1/npm-install.1 b/deps/npm/man/man1/npm-install.1
index 9d720117819..f99ad884255 100644
--- a/deps/npm/man/man1/npm-install.1
+++ b/deps/npm/man/man1/npm-install.1
@@ -5,16 +5,7 @@
 .P
 .RS 2
 .nf
-npm install [<@scope>/]
-npm install [<@scope>/]@
-npm install [<@scope>/]@
-npm install [<@scope>/]@
-npm install @npm:
-npm install 
-npm install 
-npm install 
-npm install 
-npm install /
+npm install [ \.\.\.]
 
 aliases: add, i, in, ins, inst, insta, instal, isnt, isnta, isntal, isntall
 .fi
diff --git a/deps/npm/man/man1/npm-link.1 b/deps/npm/man/man1/npm-link.1
index d748d168451..e138490e1b3 100644
--- a/deps/npm/man/man1/npm-link.1
+++ b/deps/npm/man/man1/npm-link.1
@@ -5,8 +5,7 @@
 .P
 .RS 2
 .nf
-npm link (in package dir)
-npm link [<@scope>/][@]
+npm link []
 
 alias: ln
 .fi
@@ -18,11 +17,11 @@ test iteratively without having to continually rebuild\.
 .P
 Package linking is a two\-step process\.
 .P
-First, \fBnpm link\fP in a package folder will create a symlink in the global
-folder \fB{prefix}/lib/node_modules/\fP that links to the package
-where the \fBnpm link\fP command was executed\. It will also link any bins in
-the package to \fB{prefix}/bin/{name}\fP\|\.  Note that \fBnpm link\fP uses the global
-prefix (see \fBnpm prefix \-g\fP for its value)\.
+First, \fBnpm link\fP in a package folder with no arguments will create a
+symlink in the global folder \fB{prefix}/lib/node_modules/\fP that
+links to the package where the \fBnpm link\fP command was executed\. It will
+also link any bins in the package to \fB{prefix}/bin/{name}\fP\|\.  Note that
+\fBnpm link\fP uses the global prefix (see \fBnpm prefix \-g\fP for its value)\.
 .P
 Next, in some other location, \fBnpm link package\-name\fP will create a
 symbolic link from globally\-installed \fBpackage\-name\fP to \fBnode_modules/\fP of
@@ -401,6 +400,8 @@ symlink\. This option has no effect on workspaces\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help developers
 .IP \(bu 2
 npm help package\.json
diff --git a/deps/npm/man/man1/npm-ls.1 b/deps/npm/man/man1/npm-ls.1
index 2308cc16016..a24c524909f 100644
--- a/deps/npm/man/man1/npm-ls.1
+++ b/deps/npm/man/man1/npm-ls.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm ls [[<@scope>/] \.\.\.]
+npm ls 
 
 alias: list
 .fi
@@ -26,7 +26,7 @@ example, running \fBnpm ls promzard\fP in npm's source tree will show:
 .P
 .RS 2
 .nf
-npm@8\.12\.1 /path/to/npm
+npm@8\.13\.1 /path/to/npm
 └─┬ init\-package\-json@0\.0\.4
   └── promzard@0\.1\.5
 .fi
@@ -301,6 +301,8 @@ symlink\. This option has no effect on workspaces\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help explain
 .IP \(bu 2
 npm help config
diff --git a/deps/npm/man/man1/npm-outdated.1 b/deps/npm/man/man1/npm-outdated.1
index 3d5025e0e04..80ec0928a2b 100644
--- a/deps/npm/man/man1/npm-outdated.1
+++ b/deps/npm/man/man1/npm-outdated.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm outdated [[<@scope>/] \.\.\.]
+npm outdated [ \.\.\.]
 .fi
 .RE
 .SS Description
@@ -208,6 +208,8 @@ This value is not exported to the environment for child processes\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help update
 .IP \(bu 2
 npm help dist\-tag
diff --git a/deps/npm/man/man1/npm-owner.1 b/deps/npm/man/man1/npm-owner.1
index 312bf22942d..85ab4077b21 100644
--- a/deps/npm/man/man1/npm-owner.1
+++ b/deps/npm/man/man1/npm-owner.1
@@ -5,9 +5,9 @@
 .P
 .RS 2
 .nf
-npm owner add  [<@scope>/]
-npm owner rm  [<@scope>/]
-npm owner ls [<@scope>/]
+npm owner add  
+npm owner rm  
+npm owner ls 
 
 alias: author
 .fi
@@ -119,6 +119,8 @@ This value is not exported to the environment for child processes\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help profile
 .IP \(bu 2
 npm help publish
diff --git a/deps/npm/man/man1/npm-pack.1 b/deps/npm/man/man1/npm-pack.1
index 028fab69b1a..a46bf5c7526 100644
--- a/deps/npm/man/man1/npm-pack.1
+++ b/deps/npm/man/man1/npm-pack.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm pack [[<@scope>/]\.\.\.]
+npm pack 
 .fi
 .RE
 .SS Configuration
@@ -138,6 +138,8 @@ If no arguments are supplied, then npm packs the current package folder\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm\-packlist package \fIhttp://npm\.im/npm\-packlist\fR
 .IP \(bu 2
 npm help cache
diff --git a/deps/npm/man/man1/npm-publish.1 b/deps/npm/man/man1/npm-publish.1
index dc914cf75cc..d64a144447f 100644
--- a/deps/npm/man/man1/npm-publish.1
+++ b/deps/npm/man/man1/npm-publish.1
@@ -5,50 +5,39 @@
 .P
 .RS 2
 .nf
-npm publish []
+npm publish 
 .fi
 .RE
 .SS Description
 .P
 Publishes a package to the registry so that it can be installed by name\.
 .P
-By default npm will publish to the public registry\. This can be overridden
-by specifying a different default registry or using a
-npm help \fBscope\fP in the name (see
+By default npm will publish to the public registry\. This can be
+overridden by specifying a different default registry or using a
+npm help \fBscope\fP in the name, combined with a
+scope\-configured registry (see
 npm help \fBpackage\.json\fP)\.
+.P
+A \fBpackage\fP is interpreted the same way as other commands (like
+\fBnpm install\fP and can be:
 .RS 0
 .IP \(bu 2
-\fB\fP: A folder containing a package\.json file
-.IP \(bu 2
-\fB\fP: A url or file path to a gzipped tar archive containing a
-single folder with a package\.json file inside\.
+a) a folder containing a program described by a
+npm help \fBpackage\.json\fP file
 .IP \(bu 2
-\fB[\-\-tag ]\fP: Registers the published package with the given tag, such
-that \fBnpm install @\fP will install this version\.  By default,
-\fBnpm publish\fP updates and \fBnpm install\fP installs the \fBlatest\fP tag\. See
-\fBnpm\-dist\-tag\fP \fInpm\-dist\-tag\fR for details about tags\.
+b) a gzipped tarball containing (a)
 .IP \(bu 2
-\fB[\-\-access ]\fP: Tells the registry whether this package
-should be published as public or restricted\. Only applies to scoped
-packages, which default to \fBrestricted\fP\|\.  If you don't have a paid
-account, you must publish with \fB\-\-access public\fP to publish scoped
-packages\.
+c) a url that resolves to (b)
 .IP \(bu 2
-\fB[\-\-otp ]\fP: If you have two\-factor authentication enabled in
-\fBauth\-and\-writes\fP mode then you can provide a code from your
-authenticator with this\. If you don't include this and you're running
-from a TTY then you'll be prompted\.
+d) a \fB@\fP that is published on the registry (see
+npm help \fBregistry\fP) with (c)
 .IP \(bu 2
-\fB[\-\-dry\-run]\fP: As of \fBnpm@6\fP, does everything publish would do except
-actually publishing to the registry\. Reports the details of what would
-have been published\.
+e) a \fB@\fP (see npm help \fBdist\-tag\fP) that
+points to (d)
 .IP \(bu 2
-\fB[\-\-workspaces]\fP: Enables workspace context while publishing\. All
-workspace packages will be published\.
+f) a \fB\fP that has a "latest" tag satisfying (e)
 .IP \(bu 2
-\fB[\-\-workspace]\fP: Enables workspaces context and limits results to only
-those specified by this config item\.  Only the packages in the
-workspaces given will be published\.
+g) a \fB\fP that resolves to (a)
 
 .RE
 .P
@@ -241,6 +230,8 @@ This value is not exported to the environment for child processes\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm\-packlist package \fIhttp://npm\.im/npm\-packlist\fR
 .IP \(bu 2
 npm help registry
diff --git a/deps/npm/man/man1/npm-rebuild.1 b/deps/npm/man/man1/npm-rebuild.1
index 8d6d90b10f0..f4e4c56118d 100644
--- a/deps/npm/man/man1/npm-rebuild.1
+++ b/deps/npm/man/man1/npm-rebuild.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm rebuild [[<@scope>/][@] \.\.\.]
+npm rebuild [] \.\.\.]
 
 alias: rb
 .fi
@@ -18,9 +18,8 @@ C++ addons with the new binary\.  It is also useful when installing with
 \fB\-\-ignore\-scripts\fP and \fB\-\-no\-bin\-links\fP, to explicitly choose which
 packages to build and/or link bins\.
 .P
-If one or more package names (and optionally version ranges) are provided,
-then only packages with a name and version matching one of the specifiers
-will be rebuilt\.
+If one or more package specs are provided, then only packages with a
+name and version matching one of the specifiers will be rebuilt\.
 .SS Configuration
 .SS \fBglobal\fP
 .RS 0
@@ -174,6 +173,8 @@ symlink\. This option has no effect on workspaces\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help install
 
 .RE
diff --git a/deps/npm/man/man1/npm-restart.1 b/deps/npm/man/man1/npm-restart.1
index 2f99ee51ed4..460a94350f1 100644
--- a/deps/npm/man/man1/npm-restart.1
+++ b/deps/npm/man/man1/npm-restart.1
@@ -72,7 +72,7 @@ Type: null or String
 .RE
 .P
 The shell to use for scripts run with the \fBnpm exec\fP, \fBnpm run\fP and \fBnpm
-init \fP commands\.
+init \fP commands\.
 .SS See Also
 .RS 0
 .IP \(bu 2
diff --git a/deps/npm/man/man1/npm-run-script.1 b/deps/npm/man/man1/npm-run-script.1
index fc26c71e031..c9dc22f4eb6 100644
--- a/deps/npm/man/man1/npm-run-script.1
+++ b/deps/npm/man/man1/npm-run-script.1
@@ -256,7 +256,7 @@ Type: null or String
 .RE
 .P
 The shell to use for scripts run with the \fBnpm exec\fP, \fBnpm run\fP and \fBnpm
-init \fP commands\.
+init \fP commands\.
 .SS See Also
 .RS 0
 .IP \(bu 2
diff --git a/deps/npm/man/man1/npm-star.1 b/deps/npm/man/man1/npm-star.1
index 2ccd4046e42..2e91f78bdc9 100644
--- a/deps/npm/man/man1/npm-star.1
+++ b/deps/npm/man/man1/npm-star.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm star [\.\.\.]
+npm star [\.\.\.]
 .fi
 .RE
 .P
@@ -67,6 +67,8 @@ password, npm will prompt on the command line for one\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help unstar
 .IP \(bu 2
 npm help stars
diff --git a/deps/npm/man/man1/npm-start.1 b/deps/npm/man/man1/npm-start.1
index 589ecea4a24..af45de89f3f 100644
--- a/deps/npm/man/man1/npm-start.1
+++ b/deps/npm/man/man1/npm-start.1
@@ -71,7 +71,7 @@ Type: null or String
 .RE
 .P
 The shell to use for scripts run with the \fBnpm exec\fP, \fBnpm run\fP and \fBnpm
-init \fP commands\.
+init \fP commands\.
 .SS See Also
 .RS 0
 .IP \(bu 2
diff --git a/deps/npm/man/man1/npm-stop.1 b/deps/npm/man/man1/npm-stop.1
index 19695cc0e04..f1159699a3b 100644
--- a/deps/npm/man/man1/npm-stop.1
+++ b/deps/npm/man/man1/npm-stop.1
@@ -64,7 +64,7 @@ Type: null or String
 .RE
 .P
 The shell to use for scripts run with the \fBnpm exec\fP, \fBnpm run\fP and \fBnpm
-init \fP commands\.
+init \fP commands\.
 .SS See Also
 .RS 0
 .IP \(bu 2
diff --git a/deps/npm/man/man1/npm-test.1 b/deps/npm/man/man1/npm-test.1
index fbbe80d2638..8dd0f2f6828 100644
--- a/deps/npm/man/man1/npm-test.1
+++ b/deps/npm/man/man1/npm-test.1
@@ -61,7 +61,7 @@ Type: null or String
 .RE
 .P
 The shell to use for scripts run with the \fBnpm exec\fP, \fBnpm run\fP and \fBnpm
-init \fP commands\.
+init \fP commands\.
 .SS See Also
 .RS 0
 .IP \(bu 2
diff --git a/deps/npm/man/man1/npm-unpublish.1 b/deps/npm/man/man1/npm-unpublish.1
index ff538299e7c..57ba85fb432 100644
--- a/deps/npm/man/man1/npm-unpublish.1
+++ b/deps/npm/man/man1/npm-unpublish.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm unpublish [<@scope>/][@]
+npm unpublish []
 .fi
 .RE
 .P
@@ -149,6 +149,8 @@ This value is not exported to the environment for child processes\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help deprecate
 .IP \(bu 2
 npm help publish
diff --git a/deps/npm/man/man1/npm-unstar.1 b/deps/npm/man/man1/npm-unstar.1
index d71bfff266b..b3ece049f9b 100644
--- a/deps/npm/man/man1/npm-unstar.1
+++ b/deps/npm/man/man1/npm-unstar.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm unstar [\.\.\.]
+npm unstar [\.\.\.]
 .fi
 .RE
 .P
diff --git a/deps/npm/man/man1/npm-view.1 b/deps/npm/man/man1/npm-view.1
index efba9ebd6bd..7f83d89bf67 100644
--- a/deps/npm/man/man1/npm-view.1
+++ b/deps/npm/man/man1/npm-view.1
@@ -5,7 +5,7 @@
 .P
 .RS 2
 .nf
-npm view [<@scope>/][@] [[\.subfield]\.\.\.]
+npm view [] [[\.subfield]\.\.\.]
 
 aliases: info, show, v
 .fi
@@ -216,6 +216,8 @@ the field name\.
 .SS See Also
 .RS 0
 .IP \(bu 2
+npm help package spec
+.IP \(bu 2
 npm help search
 .IP \(bu 2
 npm help registry
diff --git a/deps/npm/man/man1/npm.1 b/deps/npm/man/man1/npm.1
index 45db3c9e537..a26c713a110 100644
--- a/deps/npm/man/man1/npm.1
+++ b/deps/npm/man/man1/npm.1
@@ -4,7 +4,7 @@
 .SS Synopsis
 .SS Version
 .P
-8\.12\.1
+8\.13\.1
 .SS Description
 .P
 npm is the package manager for the Node JavaScript platform\.  It puts
diff --git a/deps/npm/man/man5/package-json.5 b/deps/npm/man/man5/package-json.5
index 17c4c1e322c..f6477ebc015 100644
--- a/deps/npm/man/man5/package-json.5
+++ b/deps/npm/man/man5/package-json.5
@@ -246,7 +246,7 @@ Both email and url are optional either way\.
 npm also sets a top\-level "maintainers" field with your npm user info\.
 .SS funding
 .P
-You can specify an object containing an URL that provides up\-to\-date
+You can specify an object containing a URL that provides up\-to\-date
 information about ways to help fund development of your package, or a
 string URL, or an array of these:
 .P
diff --git a/deps/npm/man/man7/config.7 b/deps/npm/man/man7/config.7
index 70f6742b10a..a64db0ae281 100644
--- a/deps/npm/man/man7/config.7
+++ b/deps/npm/man/man7/config.7
@@ -1592,7 +1592,7 @@ Type: null or String
 .RE
 .P
 The shell to use for scripts run with the \fBnpm exec\fP, \fBnpm run\fP and \fBnpm
-init \fP commands\.
+init \fP commands\.
 .SS \fBsearchexclude\fP
 .RS 0
 .IP \(bu 2
diff --git a/deps/npm/man/man7/package-spec.7 b/deps/npm/man/man7/package-spec.7
new file mode 100644
index 00000000000..f86a00686b0
--- /dev/null
+++ b/deps/npm/man/man7/package-spec.7
@@ -0,0 +1,145 @@
+.TH "PACKAGE\-SPEC" "7" "June 2022" "" ""
+.SH "NAME"
+\fBpackage-spec\fR \- Package name specifier
+.SS Description
+.P
+Commands like \fBnpm install\fP and the dependency sections in the
+\fBpackage\.json\fP use a package name specifier\.  This can be many different
+things that all refer to a "package"\.  Examples include a package name,
+git url, tarball, or local directory\.  These will generally be referred
+to as \fB\fP in the help output for the npm commands that use
+this package name specifier\.
+.SS Package name
+.RS 0
+.IP \(bu 2
+\fB[<@scope>/]\fP
+.IP \(bu 2
+\fB[<@scope>/]@\fP
+.IP \(bu 2
+\fB[<@scope>/]@\fP
+.IP \(bu 2
+\fB[<@scope>/]@\fP
+
+.RE
+.P
+Refers to a package by name, with or without a scope, and optionally
+tag, version, or version range\.  This is typically used in combination
+with the npm help registry config to refer to a
+package in a registry\.
+.P
+Examples:
+.RS 0
+.IP \(bu 2
+\fBnpm\fP
+.IP \(bu 2
+\fB@npmcli/arborist\fP
+.IP \(bu 2
+\fB@npmcli/arborist@latest\fP
+.IP \(bu 2
+\fBnpm@6\.13\.1\fP
+.IP \(bu 2
+\fBnpm@^4\.0\.0\fP
+
+.RE
+.SS Aliases
+.RS 0
+.IP \(bu 2
+\fB@npm:\fP
+
+.RE
+.P
+Primarily used by commands like \fBnpm install\fP and in the dependency
+sections in the \fBpackage\.json\fP, this refers to a package by an alias\.
+The \fB\fP is the name of the package as it is reified in the
+\fBnode_modules\fP folder, and the \fB\fP refers to a package name as
+found in the configured registry\.
+.P
+See \fBPackage name\fP above for more info on referring to a package by
+name, and npm help registry for configuring which
+registry is used when referring to a package by name\.
+.P
+Examples:
+.RS 0
+.IP \(bu 2
+\fBsemver:@npm:@npmcli/semver\-with\-patch\fP
+.IP \(bu 2
+\fBsemver:@npm:semver@7\.2\.2\fP
+.IP \(bu 2
+\fBsemver:@npm:semver@legacy\fP
+
+.RE
+.SS Folders
+.RS 0
+.IP \(bu 2
+\fB\fP
+
+.RE
+.P
+This refers to a package on the local filesystem\.  Specifically this is
+a folder with a \fBpackage\.json\fP file in it\.  This \fIshould\fR always be
+prefixed with a \fB/\fP or \fB\|\./\fP (or your OS equivalent) to reduce confusion\.
+npm currently will parse a string with more than one \fB/\fP in it as a
+folder, but this is legacy behavior that may be removed in a future
+version\.
+.P
+Examples:
+.RS 0
+.IP \(bu 2
+\fB\|\./my\-package\fP
+.IP \(bu 2
+\fB/opt/npm/my\-package\fP
+
+.RE
+.SS Tarballs
+.RS 0
+.IP \(bu 2
+\fB\fP
+.IP \(bu 2
+\fB\fP
+
+.RE
+.P
+Examples:
+.RS 0
+.IP \(bu 2
+\fB\|\./my\-package\.tgz\fP
+.IP \(bu 2
+\fBhttps://registry\.npmjs\.org/semver/\-/semver\-1\.0\.0\.tgz\fP
+
+.RE
+.P
+Refers to a package in a tarball format, either on the local filesystem
+or remotely via url\.  This is the format that packages exist in when
+uploaded to a registry\.
+.SS git urls
+.RS 0
+.IP \(bu 2
+\fB\fP
+.IP \(bu 2
+\fB/\fP
+
+.RE
+.P
+Refers to a package in a git repo\.  This can be a full git url, git
+shorthand, or a username/package on GitHub\.  You can specify a
+git tag, branch, or other git ref by appending \fB#ref\fP\|\.
+.P
+Examples:
+.RS 0
+.IP \(bu 2
+\fBhttps://github\.com/npm/cli\.git\fP
+.IP \(bu 2
+\fBgit@github\.com:npm/cli\.git\fP
+.IP \(bu 2
+\fBgit+ssh://git@github\.com/npm/cli#v6\.0\.0\fP
+.IP \(bu 2
+\fBgithub:npm/cli#HEAD\fP
+.IP \(bu 2
+\fBnpm/cli#c12ea07\fP
+
+.RE
+.SS See also
+.P
+npm\-package\-arg \fIhttps://npm\.im/npm\-package\-arg\fR
+npm help scope
+npm help config
diff --git a/deps/npm/node_modules/@npmcli/arborist/lib/arborist/build-ideal-tree.js b/deps/npm/node_modules/@npmcli/arborist/lib/arborist/build-ideal-tree.js
index e6c9fe68fab..da2652c449a 100644
--- a/deps/npm/node_modules/@npmcli/arborist/lib/arborist/build-ideal-tree.js
+++ b/deps/npm/node_modules/@npmcli/arborist/lib/arborist/build-ideal-tree.js
@@ -673,7 +673,7 @@ Try using the package name instead, e.g:
           const breakingMessage = isSemVerMajor
             ? 'a SemVer major change'
             : 'outside your stated dependency range'
-          log.warn('audit', `Updating ${name} to ${version},` +
+          log.warn('audit', `Updating ${name} to ${version}, ` +
             `which is ${breakingMessage}.`)
 
           await this[_add](node, { add: [`${name}@${version}`] })
diff --git a/deps/npm/node_modules/@npmcli/arborist/package.json b/deps/npm/node_modules/@npmcli/arborist/package.json
index baae74e25ac..bfb9b4273e8 100644
--- a/deps/npm/node_modules/@npmcli/arborist/package.json
+++ b/deps/npm/node_modules/@npmcli/arborist/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@npmcli/arborist",
-  "version": "5.2.1",
+  "version": "5.2.3",
   "description": "Manage node_modules trees",
   "dependencies": {
     "@isaacs/string-locale-compare": "^1.1.0",
@@ -11,7 +11,7 @@
     "@npmcli/name-from-folder": "^1.0.1",
     "@npmcli/node-gyp": "^2.0.0",
     "@npmcli/package-json": "^2.0.0",
-    "@npmcli/run-script": "^3.0.0",
+    "@npmcli/run-script": "^4.1.3",
     "bin-links": "^3.0.0",
     "cacache": "^16.0.6",
     "common-ancestor-path": "^1.0.1",
@@ -25,7 +25,7 @@
     "npm-pick-manifest": "^7.0.0",
     "npm-registry-fetch": "^13.0.0",
     "npmlog": "^6.0.2",
-    "pacote": "^13.0.5",
+    "pacote": "^13.6.1",
     "parse-conflict-json": "^2.0.1",
     "proc-log": "^2.0.0",
     "promise-all-reject-late": "^1.0.0",
diff --git a/deps/npm/node_modules/@npmcli/run-script/lib/escape.js b/deps/npm/node_modules/@npmcli/run-script/lib/escape.js
new file mode 100644
index 00000000000..5254be24bf7
--- /dev/null
+++ b/deps/npm/node_modules/@npmcli/run-script/lib/escape.js
@@ -0,0 +1,71 @@
+'use strict'
+
+// eslint-disable-next-line max-len
+// this code adapted from: https://blogs.msdn.microsoft.com/twistylittlepassagesallalike/2011/04/23/everyone-quotes-command-line-arguments-the-wrong-way/
+const cmd = (input, doubleEscape) => {
+  if (!input.length) {
+    return '""'
+  }
+
+  let result
+  if (!/[ \t\n\v"]/.test(input)) {
+    result = input
+  } else {
+    result = '"'
+    for (let i = 0; i <= input.length; ++i) {
+      let slashCount = 0
+      while (input[i] === '\\') {
+        ++i
+        ++slashCount
+      }
+
+      if (i === input.length) {
+        result += '\\'.repeat(slashCount * 2)
+        break
+      }
+
+      if (input[i] === '"') {
+        result += '\\'.repeat(slashCount * 2 + 1)
+        result += input[i]
+      } else {
+        result += '\\'.repeat(slashCount)
+        result += input[i]
+      }
+    }
+    result += '"'
+  }
+
+  // and finally, prefix shell meta chars with a ^
+  result = result.replace(/[ !^&()<>|"]/g, '^$&')
+  if (doubleEscape) {
+    result = result.replace(/[ !^&()<>|"]/g, '^$&')
+  }
+
+  // except for % which is escaped with another %, and only once
+  result = result.replace(/%/g, '%%')
+
+  return result
+}
+
+const sh = (input) => {
+  if (!input.length) {
+    return `''`
+  }
+
+  if (!/[\t\n\r "#$&'()*;<>?\\`|~]/.test(input)) {
+    return input
+  }
+
+  // replace single quotes with '\'' and wrap the whole result in a fresh set of quotes
+  const result = `'${input.replace(/'/g, `'\\''`)}'`
+    // if the input string already had single quotes around it, clean those up
+    .replace(/^(?:'')+(?!$)/, '')
+    .replace(/\\'''/g, `\\'`)
+
+  return result
+}
+
+module.exports = {
+  cmd,
+  sh,
+}
diff --git a/deps/npm/node_modules/@npmcli/run-script/lib/make-spawn-args.js b/deps/npm/node_modules/@npmcli/run-script/lib/make-spawn-args.js
index 9cfc84b0e0d..660588e3ee9 100644
--- a/deps/npm/node_modules/@npmcli/run-script/lib/make-spawn-args.js
+++ b/deps/npm/node_modules/@npmcli/run-script/lib/make-spawn-args.js
@@ -1,8 +1,12 @@
 /* eslint camelcase: "off" */
 const isWindows = require('./is-windows.js')
 const setPATH = require('./set-path.js')
-const { resolve } = require('path')
+const { chmodSync: chmod, unlinkSync: unlink, writeFileSync: writeFile } = require('fs')
+const { tmpdir } = require('os')
+const { isAbsolute, resolve } = require('path')
+const which = require('which')
 const npm_config_node_gyp = require.resolve('node-gyp/bin/node-gyp.js')
+const escape = require('./escape.js')
 
 const makeSpawnArgs = options => {
   const {
@@ -12,29 +16,93 @@ const makeSpawnArgs = options => {
     env = {},
     stdio,
     cmd,
+    args = [],
     stdioString = false,
   } = options
 
+  const spawnEnv = setPATH(path, {
+    // we need to at least save the PATH environment var
+    ...process.env,
+    ...env,
+    npm_package_json: resolve(path, 'package.json'),
+    npm_lifecycle_event: event,
+    npm_lifecycle_script: cmd,
+    npm_config_node_gyp,
+  })
+
+  let scriptFile
+  let script = ''
+
   const isCmd = /(?:^|\\)cmd(?:\.exe)?$/i.test(scriptShell)
-  const args = isCmd ? ['/d', '/s', '/c', cmd] : ['-c', cmd]
+  if (isCmd) {
+    let initialCmd = ''
+    let insideQuotes = false
+    for (let i = 0; i < cmd.length; ++i) {
+      const char = cmd.charAt(i)
+      if (char === ' ' && !insideQuotes) {
+        break
+      }
+
+      initialCmd += char
+      if (char === '"' || char === "'") {
+        insideQuotes = !insideQuotes
+      }
+    }
+
+    let pathToInitial
+    try {
+      pathToInitial = which.sync(initialCmd, {
+        path: spawnEnv.path,
+        pathext: spawnEnv.pathext,
+      }).toLowerCase()
+    } catch (err) {
+      pathToInitial = initialCmd.toLowerCase()
+    }
+
+    const doubleEscape = pathToInitial.endsWith('.cmd') || pathToInitial.endsWith('.bat')
+
+    scriptFile = resolve(tmpdir(), `${event}-${Date.now()}.cmd`)
+    script += '@echo off\n'
+    script += cmd
+    if (args.length) {
+      script += ` ${args.map((arg) => escape.cmd(arg, doubleEscape)).join(' ')}`
+    }
+  } else {
+    const shebang = isAbsolute(scriptShell)
+      ? `#!${scriptShell}`
+      : `#!/usr/bin/env ${scriptShell}`
+    scriptFile = resolve(tmpdir(), `${event}-${Date.now()}.sh`)
+    script += `${shebang}\n`
+    script += cmd
+    if (args.length) {
+      script += ` ${args.map((arg) => escape.sh(arg)).join(' ')}`
+    }
+  }
+
+  writeFile(scriptFile, script)
+  if (!isCmd) {
+    chmod(scriptFile, '0775')
+  }
+  const spawnArgs = isCmd
+    ? ['/d', '/s', '/c', escape.cmd(scriptFile)]
+    : ['-c', escape.sh(scriptFile)]
 
   const spawnOpts = {
-    env: setPATH(path, {
-      // we need to at least save the PATH environment var
-      ...process.env,
-      ...env,
-      npm_package_json: resolve(path, 'package.json'),
-      npm_lifecycle_event: event,
-      npm_lifecycle_script: cmd,
-      npm_config_node_gyp,
-    }),
+    env: spawnEnv,
     stdioString,
     stdio,
     cwd: path,
     ...(isCmd ? { windowsVerbatimArguments: true } : {}),
   }
 
-  return [scriptShell, args, spawnOpts]
+  const cleanup = () => {
+    // delete the script, this is just a best effort
+    try {
+      unlink(scriptFile)
+    } catch (err) {}
+  }
+
+  return [scriptShell, spawnArgs, spawnOpts, cleanup]
 }
 
 module.exports = makeSpawnArgs
diff --git a/deps/npm/node_modules/@npmcli/run-script/lib/run-script-pkg.js b/deps/npm/node_modules/@npmcli/run-script/lib/run-script-pkg.js
index a6fa4d2b389..84c5e2bfe0c 100644
--- a/deps/npm/node_modules/@npmcli/run-script/lib/run-script-pkg.js
+++ b/deps/npm/node_modules/@npmcli/run-script/lib/run-script-pkg.js
@@ -31,7 +31,7 @@ const runScriptPkg = async options => {
   if (options.cmd) {
     cmd = options.cmd
   } else if (pkg.scripts && pkg.scripts[event]) {
-    cmd = pkg.scripts[event] + args.map(a => ` ${JSON.stringify(a)}`).join('')
+    cmd = pkg.scripts[event]
   } else if (
     // If there is no preinstall or install script, default to rebuilding node-gyp packages.
     event === 'install' &&
@@ -42,7 +42,7 @@ const runScriptPkg = async options => {
   ) {
     cmd = defaultGypInstallScript
   } else if (event === 'start' && await isServerPackage(path)) {
-    cmd = 'node server.js' + args.map(a => ` ${JSON.stringify(a)}`).join('')
+    cmd = 'node server.js'
   }
 
   if (!cmd) {
@@ -54,15 +54,18 @@ const runScriptPkg = async options => {
     console.log(bruce(pkg._id, event, cmd))
   }
 
-  const p = promiseSpawn(...makeSpawnArgs({
+  const [spawnShell, spawnArgs, spawnOpts, cleanup] = makeSpawnArgs({
     event,
     path,
     scriptShell,
     env: packageEnvs(env, pkg),
     stdio,
     cmd,
+    args,
     stdioString,
-  }), {
+  })
+
+  const p = promiseSpawn(spawnShell, spawnArgs, spawnOpts, {
     event,
     script: cmd,
     pkgid: pkg._id,
@@ -88,7 +91,7 @@ const runScriptPkg = async options => {
     } else {
       throw er
     }
-  })
+  }).finally(cleanup)
 }
 
 module.exports = runScriptPkg
diff --git a/deps/npm/node_modules/@npmcli/run-script/package.json b/deps/npm/node_modules/@npmcli/run-script/package.json
index 733b27e44a1..ef8b43f772d 100644
--- a/deps/npm/node_modules/@npmcli/run-script/package.json
+++ b/deps/npm/node_modules/@npmcli/run-script/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@npmcli/run-script",
-  "version": "3.0.2",
+  "version": "4.1.3",
   "description": "Run a lifecycle script for a package (descendant of npm-lifecycle)",
   "author": "GitHub Inc.",
   "license": "ISC",
@@ -23,7 +23,7 @@
   },
   "devDependencies": {
     "@npmcli/eslint-config": "^3.0.1",
-    "@npmcli/template-oss": "3.2.2",
+    "@npmcli/template-oss": "3.5.0",
     "minipass": "^3.1.6",
     "require-inject": "^1.4.4",
     "tap": "^16.0.1"
@@ -48,6 +48,6 @@
   },
   "templateOSS": {
     "//@npmcli/template-oss": "This file is partially managed by @npmcli/template-oss. Edits may be overwritten.",
-    "version": "3.2.2"
+    "version": "3.5.0"
   }
 }
diff --git a/deps/npm/node_modules/cacache/lib/content/read.js b/deps/npm/node_modules/cacache/lib/content/read.js
index f5128fe185d..8367ccb205d 100644
--- a/deps/npm/node_modules/cacache/lib/content/read.js
+++ b/deps/npm/node_modules/cacache/lib/content/read.js
@@ -13,7 +13,7 @@ async function read (cache, integrity, opts = {}) {
   const { size } = opts
   const { stat, cpath, sri } = await withContentSri(cache, integrity, async (cpath, sri) => {
     // get size
-    const stat = await fs.lstat(cpath)
+    const stat = await fs.stat(cpath)
     return { stat, cpath, sri }
   })
   if (typeof size === 'number' && stat.size !== size) {
@@ -73,8 +73,8 @@ function readStream (cache, integrity, opts = {}) {
   // Set all this up to run on the stream and then just return the stream
   Promise.resolve().then(async () => {
     const { stat, cpath, sri } = await withContentSri(cache, integrity, async (cpath, sri) => {
-      // just lstat to ensure it exists
-      const stat = await fs.lstat(cpath)
+      // just stat to ensure it exists
+      const stat = await fs.stat(cpath)
       return { stat, cpath, sri }
     })
     if (typeof size === 'number' && size !== stat.size) {
@@ -111,7 +111,7 @@ async function hasContent (cache, integrity) {
 
   try {
     return await withContentSri(cache, integrity, async (cpath, sri) => {
-      const stat = await fs.lstat(cpath)
+      const stat = await fs.stat(cpath)
       return { size: stat.size, sri, stat }
     })
   } catch (err) {
@@ -139,7 +139,7 @@ function hasContentSync (cache, integrity) {
 
   return withContentSriSync(cache, integrity, (cpath, sri) => {
     try {
-      const stat = fs.lstatSync(cpath)
+      const stat = fs.statSync(cpath)
       return { size: stat.size, sri, stat }
     } catch (err) {
       if (err.code === 'ENOENT') {
diff --git a/deps/npm/node_modules/cacache/package.json b/deps/npm/node_modules/cacache/package.json
index 8e54901b456..bb5674dafca 100644
--- a/deps/npm/node_modules/cacache/package.json
+++ b/deps/npm/node_modules/cacache/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cacache",
-  "version": "16.1.0",
+  "version": "16.1.1",
   "cache-version": {
     "content": "2",
     "index": "5"
@@ -69,7 +69,7 @@
   },
   "devDependencies": {
     "@npmcli/eslint-config": "^3.0.1",
-    "@npmcli/template-oss": "3.4.3",
+    "@npmcli/template-oss": "3.5.0",
     "tap": "^16.0.0"
   },
   "engines": {
@@ -78,7 +78,7 @@
   "templateOSS": {
     "//@npmcli/template-oss": "This file is partially managed by @npmcli/template-oss. Edits may be overwritten.",
     "windowsCI": false,
-    "version": "3.4.3"
+    "version": "3.5.0"
   },
   "author": "GitHub Inc."
 }
diff --git a/deps/npm/node_modules/libnpmdiff/package.json b/deps/npm/node_modules/libnpmdiff/package.json
index 3630980ccb3..814629dd2e2 100644
--- a/deps/npm/node_modules/libnpmdiff/package.json
+++ b/deps/npm/node_modules/libnpmdiff/package.json
@@ -1,6 +1,6 @@
 {
   "name": "libnpmdiff",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "description": "The registry diff",
   "repository": {
     "type": "git",
@@ -56,7 +56,7 @@
     "diff": "^5.0.0",
     "minimatch": "^5.0.1",
     "npm-package-arg": "^9.0.1",
-    "pacote": "^13.0.5",
+    "pacote": "^13.6.1",
     "tar": "^6.1.0"
   },
   "templateOSS": {
diff --git a/deps/npm/node_modules/libnpmexec/package.json b/deps/npm/node_modules/libnpmexec/package.json
index dfe40b0d9f7..d163103ea2b 100644
--- a/deps/npm/node_modules/libnpmexec/package.json
+++ b/deps/npm/node_modules/libnpmexec/package.json
@@ -1,6 +1,6 @@
 {
   "name": "libnpmexec",
-  "version": "4.0.6",
+  "version": "4.0.8",
   "files": [
     "bin/",
     "lib/"
@@ -57,12 +57,12 @@
   "dependencies": {
     "@npmcli/arborist": "^5.0.0",
     "@npmcli/ci-detect": "^2.0.0",
-    "@npmcli/run-script": "^3.0.0",
+    "@npmcli/run-script": "^4.1.3",
     "chalk": "^4.1.0",
     "mkdirp-infer-owner": "^2.0.0",
     "npm-package-arg": "^9.0.1",
     "npmlog": "^6.0.2",
-    "pacote": "^13.0.5",
+    "pacote": "^13.6.1",
     "proc-log": "^2.0.0",
     "read": "^1.0.7",
     "read-package-json-fast": "^2.0.2",
diff --git a/deps/npm/node_modules/libnpmpack/package.json b/deps/npm/node_modules/libnpmpack/package.json
index 02f06a8bbfa..86bec9ff1d6 100644
--- a/deps/npm/node_modules/libnpmpack/package.json
+++ b/deps/npm/node_modules/libnpmpack/package.json
@@ -1,6 +1,6 @@
 {
   "name": "libnpmpack",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "description": "Programmatic API for the bits behind npm pack",
   "author": "GitHub Inc.",
   "main": "lib/index.js",
@@ -38,9 +38,9 @@
   "bugs": "https://github.com/npm/libnpmpack/issues",
   "homepage": "https://npmjs.com/package/libnpmpack",
   "dependencies": {
-    "@npmcli/run-script": "^3.0.0",
+    "@npmcli/run-script": "^4.1.3",
     "npm-package-arg": "^9.0.1",
-    "pacote": "^13.5.0"
+    "pacote": "^13.6.1"
   },
   "engines": {
     "node": "^12.13.0 || ^14.15.0 || >=16.0.0"
diff --git a/deps/npm/node_modules/libnpmversion/package.json b/deps/npm/node_modules/libnpmversion/package.json
index 86f97378128..c5c1a0398bb 100644
--- a/deps/npm/node_modules/libnpmversion/package.json
+++ b/deps/npm/node_modules/libnpmversion/package.json
@@ -1,6 +1,6 @@
 {
   "name": "libnpmversion",
-  "version": "3.0.4",
+  "version": "3.0.6",
   "main": "lib/index.js",
   "files": [
     "bin/",
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@npmcli/git": "^3.0.0",
-    "@npmcli/run-script": "^3.0.0",
+    "@npmcli/run-script": "^4.1.3",
     "json-parse-even-better-errors": "^2.3.1",
     "proc-log": "^2.0.0",
     "semver": "^7.3.7"
diff --git a/deps/npm/node_modules/make-fetch-happen/lib/agent.js b/deps/npm/node_modules/make-fetch-happen/lib/agent.js
index f64644ff611..dd68492ed7e 100644
--- a/deps/npm/node_modules/make-fetch-happen/lib/agent.js
+++ b/deps/npm/node_modules/make-fetch-happen/lib/agent.js
@@ -171,7 +171,7 @@ const getPath = u => u.pathname + u.search + u.hash
 
 const HttpProxyAgent = require('http-proxy-agent')
 const HttpsProxyAgent = require('https-proxy-agent')
-const SocksProxyAgent = require('socks-proxy-agent')
+const { SocksProxyAgent } = require('socks-proxy-agent')
 module.exports.getProxy = getProxy
 function getProxy (proxyUrl, opts, isHttps) {
   // our current proxy agents do not support an overridden dns lookup method, so will not
@@ -198,6 +198,9 @@ function getProxy (proxyUrl, opts, isHttps) {
       return new HttpsProxyAgent(popts)
     }
   } else if (proxyUrl.protocol.startsWith('socks')) {
+    // socks-proxy-agent uses hostname not host
+    popts.hostname = popts.host
+    delete popts.host
     return new SocksProxyAgent(popts)
   } else {
     throw Object.assign(
diff --git a/deps/npm/node_modules/make-fetch-happen/package.json b/deps/npm/node_modules/make-fetch-happen/package.json
index e3d42bb2110..e04c7645c4f 100644
--- a/deps/npm/node_modules/make-fetch-happen/package.json
+++ b/deps/npm/node_modules/make-fetch-happen/package.json
@@ -1,6 +1,6 @@
 {
   "name": "make-fetch-happen",
-  "version": "10.1.6",
+  "version": "10.1.8",
   "description": "Opinionated, caching, retrying fetch client",
   "main": "lib/index.js",
   "files": [
@@ -50,7 +50,7 @@
     "minipass-pipeline": "^1.2.4",
     "negotiator": "^0.6.3",
     "promise-retry": "^2.0.1",
-    "socks-proxy-agent": "^6.1.1",
+    "socks-proxy-agent": "^7.0.0",
     "ssri": "^9.0.0"
   },
   "devDependencies": {
diff --git a/deps/npm/node_modules/npm-profile/lib/index.js b/deps/npm/node_modules/npm-profile/lib/index.js
index 74a8084292a..eb97c621dd1 100644
--- a/deps/npm/node_modules/npm-profile/lib/index.js
+++ b/deps/npm/node_modules/npm-profile/lib/index.js
@@ -2,6 +2,7 @@
 
 const fetch = require('npm-registry-fetch')
 const { HttpErrorBase } = require('npm-registry-fetch/lib/errors')
+const EventEmitter = require('events')
 const os = require('os')
 const { URL } = require('url')
 const log = require('proc-log')
@@ -59,6 +60,9 @@ const webAuth = (opener, opts, body) => {
     ...opts,
     method: 'POST',
     body,
+    headers: {
+      'npm-use-webauthn': opts.authType === 'webauthn',
+    },
   }).then(res => {
     return Promise.all([res, res.json()])
   }).then(([res, content]) => {
@@ -70,8 +74,23 @@ const webAuth = (opener, opts, body) => {
     return content
   }).then(({ doneUrl, loginUrl }) => {
     log.verbose('web auth', 'opening url pair')
-    return opener(loginUrl).then(
-      () => webAuthCheckLogin(doneUrl, { ...opts, cache: false })
+
+    const doneEmitter = new EventEmitter()
+
+    const openPromise = opener(loginUrl, doneEmitter)
+    const webAuthCheckPromise = webAuthCheckLogin(doneUrl, { ...opts, cache: false })
+      .then(authResult => {
+        log.verbose('web auth', 'done-check finished')
+
+        // cancel open prompt if it's present
+        doneEmitter.emit('abort')
+
+        return authResult
+      })
+
+    return Promise.all([openPromise, webAuthCheckPromise]).then(
+      // pick the auth result and pass it along
+      ([, authResult]) => authResult
     )
   }).catch(er => {
     if ((er.statusCode >= 400 && er.statusCode <= 499) || er.statusCode === 500) {
diff --git a/deps/npm/node_modules/npm-profile/package.json b/deps/npm/node_modules/npm-profile/package.json
index 5e8f2d2391a..4f9da95d73f 100644
--- a/deps/npm/node_modules/npm-profile/package.json
+++ b/deps/npm/node_modules/npm-profile/package.json
@@ -1,6 +1,6 @@
 {
   "name": "npm-profile",
-  "version": "6.0.3",
+  "version": "6.1.0",
   "description": "Library for updating an npmjs.com profile",
   "keywords": [],
   "author": "GitHub Inc.",
@@ -20,7 +20,7 @@
   ],
   "devDependencies": {
     "@npmcli/eslint-config": "^3.0.1",
-    "@npmcli/template-oss": "3.4.1",
+    "@npmcli/template-oss": "3.4.2",
     "nock": "^13.2.4",
     "tap": "^16.0.1"
   },
@@ -44,6 +44,6 @@
   },
   "templateOSS": {
     "//@npmcli/template-oss": "This file is partially managed by @npmcli/template-oss. Edits may be overwritten.",
-    "version": "3.4.1"
+    "version": "3.4.2"
   }
 }
diff --git a/deps/npm/node_modules/pacote/package.json b/deps/npm/node_modules/pacote/package.json
index af100fa8d6b..696c925d353 100644
--- a/deps/npm/node_modules/pacote/package.json
+++ b/deps/npm/node_modules/pacote/package.json
@@ -1,6 +1,6 @@
 {
   "name": "pacote",
-  "version": "13.6.0",
+  "version": "13.6.1",
   "description": "JavaScript package downloader",
   "author": "GitHub Inc.",
   "bin": {
@@ -45,7 +45,7 @@
     "@npmcli/git": "^3.0.0",
     "@npmcli/installed-package-contents": "^1.0.7",
     "@npmcli/promise-spawn": "^3.0.0",
-    "@npmcli/run-script": "^3.0.1",
+    "@npmcli/run-script": "^4.1.0",
     "cacache": "^16.0.0",
     "chownr": "^2.0.0",
     "fs-minipass": "^2.1.0",
diff --git a/deps/npm/node_modules/socks-proxy-agent/package.json b/deps/npm/node_modules/socks-proxy-agent/package.json
index 268b8a5b187..aa2999969c1 100644
--- a/deps/npm/node_modules/socks-proxy-agent/package.json
+++ b/deps/npm/node_modules/socks-proxy-agent/package.json
@@ -2,7 +2,7 @@
   "name": "socks-proxy-agent",
   "description": "A SOCKS proxy `http.Agent` implementation for HTTP and HTTPS",
   "homepage": "https://github.com/TooTallNate/node-socks-proxy-agent#readme",
-  "version": "6.2.0",
+  "version": "7.0.0",
   "main": "dist/index.js",
   "author": {
     "email": "nathan@tootallnate.net",
@@ -38,6 +38,10 @@
       "name": "Matheus Fernandes",
       "email": "matheus.frndes@gmail.com"
     },
+    {
+      "name": "Ricky Miller",
+      "email": "richardkazuomiller@gmail.com"
+    },
     {
       "name": "Shantanu Sharma",
       "email": "shantanu34@outlook.com"
@@ -111,12 +115,12 @@
     "@commitlint/config-conventional": "latest",
     "@types/debug": "latest",
     "@types/node": "latest",
-    "cacheable-lookup": "^6.0.4",
+    "cacheable-lookup": "latest",
     "conventional-github-releaser": "latest",
-    "dns2": "^2.0.1",
+    "dns2": "latest",
     "finepack": "latest",
     "git-authors-cli": "latest",
-    "mocha": "latest",
+    "mocha": "9",
     "nano-staged": "latest",
     "npm-check-updates": "latest",
     "prettier-standard": "latest",
@@ -136,6 +140,22 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf node_modules",
+    "contributors": "(git-authors-cli && finepack && git add package.json && git commit -m 'build: contributors' --no-verify) || true",
+    "lint": "ts-standard",
+    "postrelease": "npm run release:tags && npm run release:github && (ci-publish || npm publish --access=public)",
+    "prebuild": "rimraf dist",
+    "prepublishOnly": "npm run build",
+    "prerelease": "npm run update:check && npm run contributors",
+    "release": "standard-version -a",
+    "release:github": "conventional-github-releaser -p angular",
+    "release:tags": "git push --follow-tags origin HEAD:master",
+    "test": "mocha --reporter spec",
+    "update": "ncu -u",
+    "update:check": "ncu -- --error-level 2"
+  },
   "license": "MIT",
   "commitlint": {
     "extends": [
@@ -157,21 +177,5 @@
     "commit-msg": "npx commitlint --edit",
     "pre-commit": "npx nano-staged"
   },
-  "typings": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "clean": "rimraf node_modules",
-    "contributors": "(git-authors-cli && finepack && git add package.json && git commit -m 'build: contributors' --no-verify) || true",
-    "lint": "ts-standard",
-    "postrelease": "npm run release:tags && npm run release:github && (ci-publish || npm publish --access=public)",
-    "prebuild": "rimraf dist",
-    "prerelease": "npm run update:check && npm run contributors",
-    "release": "standard-version -a",
-    "release:github": "conventional-github-releaser -p angular",
-    "release:tags": "git push --follow-tags origin HEAD:master",
-    "test": "mocha --reporter spec",
-    "update": "ncu -u",
-    "update:check": "ncu -- --error-level 2"
-  },
-  "readme": "socks-proxy-agent\n================\n### A SOCKS proxy `http.Agent` implementation for HTTP and HTTPS\n[![Build Status](https://github.com/TooTallNate/node-socks-proxy-agent/workflows/Node%20CI/badge.svg)](https://github.com/TooTallNate/node-socks-proxy-agent/actions?workflow=Node+CI)\n\nThis module provides an `http.Agent` implementation that connects to a\nspecified SOCKS proxy server, and can be used with the built-in `http`\nand `https` modules.\n\nIt can also be used in conjunction with the `ws` module to establish a WebSocket\nconnection over a SOCKS proxy. See the \"Examples\" section below.\n\nInstallation\n------------\n\nInstall with `npm`:\n\n``` bash\nnpm install socks-proxy-agent\n```\n\n\nExamples\n--------\n\n#### TypeScript example\n\n```ts\nimport https from 'https';\nimport { SocksProxyAgent } from 'socks-proxy-agent';\n\nconst info = {\n\thostname: 'br41.nordvpn.com',\n\tuserId: 'your-name@gmail.com',\n\tpassword: 'abcdef12345124'\n};\nconst agent = new SocksProxyAgent(info);\n\nhttps.get('https://ipinfo.io', { agent }, (res) => {\n\tconsole.log(res.headers);\n\tres.pipe(process.stdout);\n});\n```\n\n#### `http` module example\n\n```js\nvar url = require('url');\nvar http = require('http');\nvar { SocksProxyAgent } = require('socks-proxy-agent');\n\n// SOCKS proxy to connect to\nvar proxy = process.env.socks_proxy || 'socks://127.0.0.1:1080';\nconsole.log('using proxy server %j', proxy);\n\n// HTTP endpoint for the proxy to connect to\nvar endpoint = process.argv[2] || 'http://nodejs.org/api/';\nconsole.log('attempting to GET %j', endpoint);\nvar opts = url.parse(endpoint);\n\n// create an instance of the `SocksProxyAgent` class with the proxy server information\nvar agent = new SocksProxyAgent(proxy);\nopts.agent = agent;\n\nhttp.get(opts, function (res) {\n\tconsole.log('\"response\" event!', res.headers);\n\tres.pipe(process.stdout);\n});\n```\n\n#### `https` module example\n\n```js\nvar url = require('url');\nvar https = require('https');\nvar { SocksProxyAgent } = require('socks-proxy-agent');\n\n// SOCKS proxy to connect to\nvar proxy = process.env.socks_proxy || 'socks://127.0.0.1:1080';\nconsole.log('using proxy server %j', proxy);\n\n// HTTP endpoint for the proxy to connect to\nvar endpoint = process.argv[2] || 'https://encrypted.google.com/';\nconsole.log('attempting to GET %j', endpoint);\nvar opts = url.parse(endpoint);\n\n// create an instance of the `SocksProxyAgent` class with the proxy server information\nvar agent = new SocksProxyAgent(proxy);\nopts.agent = agent;\n\nhttps.get(opts, function (res) {\n\tconsole.log('\"response\" event!', res.headers);\n\tres.pipe(process.stdout);\n});\n```\n\n#### `ws` WebSocket connection example\n\n``` js\nvar WebSocket = require('ws');\nvar { SocksProxyAgent } = require('socks-proxy-agent');\n\n// SOCKS proxy to connect to\nvar proxy = process.env.socks_proxy || 'socks://127.0.0.1:1080';\nconsole.log('using proxy server %j', proxy);\n\n// WebSocket endpoint for the proxy to connect to\nvar endpoint = process.argv[2] || 'ws://echo.websocket.org';\nconsole.log('attempting to connect to WebSocket %j', endpoint);\n\n// create an instance of the `SocksProxyAgent` class with the proxy server information\nvar agent = new SocksProxyAgent(proxy);\n\n// initiate the WebSocket connection\nvar socket = new WebSocket(endpoint, { agent: agent });\n\nsocket.on('open', function () {\n\tconsole.log('\"open\" event!');\n\tsocket.send('hello world');\n});\n\nsocket.on('message', function (data, flags) {\n\tconsole.log('\"message\" event! %j %j', data, flags);\n\tsocket.close();\n});\n```\n\nLicense\n-------\n\n(The MIT License)\n\nCopyright (c) 2013 Nathan Rajlich <nathan@tootallnate.net>\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n'Software'), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY\nCLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,\nTORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE\nSOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n"
-}
\ No newline at end of file
+  "typings": "dist/index.d.ts"
+}
diff --git a/deps/npm/package.json b/deps/npm/package.json
index fbfabe9365c..a9d84ab62ce 100644
--- a/deps/npm/package.json
+++ b/deps/npm/package.json
@@ -1,5 +1,5 @@
 {
-  "version": "8.12.1",
+  "version": "8.13.1",
   "name": "npm",
   "description": "a package manager for JavaScript",
   "workspaces": [
@@ -62,10 +62,10 @@
     "@npmcli/fs": "^2.1.0",
     "@npmcli/map-workspaces": "^2.0.3",
     "@npmcli/package-json": "^2.0.0",
-    "@npmcli/run-script": "^3.0.1",
+    "@npmcli/run-script": "^4.1.3",
     "abbrev": "~1.1.1",
     "archy": "~1.0.0",
-    "cacache": "^16.1.0",
+    "cacache": "^16.1.1",
     "chalk": "^4.1.2",
     "chownr": "^2.0.0",
     "cli-columns": "^4.0.0",
@@ -90,7 +90,7 @@
     "libnpmsearch": "^5.0.2",
     "libnpmteam": "^4.0.2",
     "libnpmversion": "^3.0.1",
-    "make-fetch-happen": "^10.1.6",
+    "make-fetch-happen": "^10.1.8",
     "minipass": "^3.1.6",
     "minipass-pipeline": "^1.2.4",
     "mkdirp": "^1.0.4",
@@ -102,12 +102,12 @@
     "npm-install-checks": "^5.0.0",
     "npm-package-arg": "^9.0.2",
     "npm-pick-manifest": "^7.0.1",
-    "npm-profile": "^6.0.3",
+    "npm-profile": "^6.1.0",
     "npm-registry-fetch": "^13.1.1",
     "npm-user-validate": "^1.0.1",
     "npmlog": "^6.0.2",
     "opener": "^1.5.2",
-    "pacote": "^13.6.0",
+    "pacote": "^13.6.1",
     "parse-conflict-json": "^2.0.2",
     "proc-log": "^2.0.1",
     "qrcode-terminal": "^0.12.0",
diff --git a/deps/npm/tap-snapshots/test/lib/load-all-commands.js.test.cjs b/deps/npm/tap-snapshots/test/lib/load-all-commands.js.test.cjs
index 802fa8de935..13a3b06fe33 100644
--- a/deps/npm/tap-snapshots/test/lib/load-all-commands.js.test.cjs
+++ b/deps/npm/tap-snapshots/test/lib/load-all-commands.js.test.cjs
@@ -98,11 +98,7 @@ exports[`test/lib/load-all-commands.js TAP load each command cache > must match
 Manipulates packages cache
 
 Usage:
-npm cache add 
-npm cache add 
-npm cache add 
-npm cache add 
-npm cache add @
+npm cache add 
 npm cache clean []
 npm cache ls [@]
 npm cache verify
@@ -178,7 +174,7 @@ exports[`test/lib/load-all-commands.js TAP load each command deprecate > must ma
 Deprecate a version of a package
 
 Usage:
-npm deprecate [@] 
+npm deprecate  
 
 Options:
 [--registry ] [--otp ]
@@ -193,10 +189,10 @@ Usage:
 npm diff [...]
 
 Options:
-[--diff  [--diff  ...]]
-[--diff-name-only] [--diff-unified ] [--diff-ignore-all-space]
-[--diff-no-prefix] [--diff-src-prefix ] [--diff-dst-prefix ]
-[--diff-text] [-g|--global] [--tag ]
+[--diff  [--diff  ...]] [--diff-name-only]
+[--diff-unified ] [--diff-ignore-all-space] [--diff-no-prefix]
+[--diff-src-prefix ] [--diff-dst-prefix ] [--diff-text] [-g|--global]
+[--tag ]
 [-w|--workspace  [-w|--workspace  ...]]
 [-ws|--workspaces] [--include-workspace-root]
 
@@ -207,9 +203,9 @@ exports[`test/lib/load-all-commands.js TAP load each command dist-tag > must mat
 Modify package distribution tags
 
 Usage:
-npm dist-tag add @ []
-npm dist-tag rm  
-npm dist-tag ls []
+npm dist-tag add  []
+npm dist-tag rm  
+npm dist-tag ls []
 
 Options:
 [-w|--workspace  [-w|--workspace  ...]]
@@ -270,8 +266,7 @@ npm exec -c ' [args...]'
 npm exec --package=foo -c ' [args...]'
 
 Options:
-[--package [@] [--package [@] ...]]
-[-c|--call ]
+[--package  [--package  ...]] [-c|--call ]
 [-w|--workspace  [-w|--workspace  ...]]
 [-ws|--workspaces] [--include-workspace-root]
 
@@ -284,7 +279,7 @@ exports[`test/lib/load-all-commands.js TAP load each command explain > must matc
 Explain installed packages
 
 Usage:
-npm explain 
+npm explain 
 
 Options:
 [--json] [-w|--workspace  [-w|--workspace  ...]]
@@ -326,7 +321,7 @@ exports[`test/lib/load-all-commands.js TAP load each command fund > must match s
 Retrieve funding information
 
 Usage:
-npm fund [[<@scope>/]]
+npm fund []
 
 Options:
 [--json] [--no-browser|--browser ] [--unicode]
@@ -390,12 +385,11 @@ exports[`test/lib/load-all-commands.js TAP load each command init > must match s
 Create a package.json file
 
 Usage:
-npm init [--force|-f|--yes|-y|--scope]
+npm init  (same as \`npx )
 npm init <@scope> (same as \`npx <@scope>/create\`)
-npm init [<@scope>/] (same as \`npx [<@scope>/]create-\`)
 
 Options:
-[-y|--yes] [-f|--force]
+[-y|--yes] [-f|--force] [--scope <@scope>]
 [-w|--workspace  [-w|--workspace  ...]]
 [-ws|--workspaces] [--no-workspaces-update] [--include-workspace-root]
 
@@ -408,16 +402,7 @@ exports[`test/lib/load-all-commands.js TAP load each command install > must matc
 Install a package
 
 Usage:
-npm install [<@scope>/]
-npm install [<@scope>/]@
-npm install [<@scope>/]@
-npm install [<@scope>/]@
-npm install @npm:
-npm install 
-npm install 
-npm install 
-npm install 
-npm install /
+npm install [ ...]
 
 Options:
 [-S|--save|--no-save|--save-prod|--save-dev|--save-optional|--save-peer|--save-bundle]
@@ -452,16 +437,7 @@ exports[`test/lib/load-all-commands.js TAP load each command install-test > must
 Install package(s) and run tests
 
 Usage:
-npm install-test [<@scope>/]
-npm install-test [<@scope>/]@
-npm install-test [<@scope>/]@
-npm install-test [<@scope>/]@
-npm install-test @npm:
-npm install-test 
-npm install-test 
-npm install-test 
-npm install-test 
-npm install-test /
+npm install-test [ ...]
 
 Options:
 [-S|--save|--no-save|--save-prod|--save-dev|--save-optional|--save-peer|--save-bundle]
@@ -481,8 +457,7 @@ exports[`test/lib/load-all-commands.js TAP load each command link > must match s
 Symlink a package folder
 
 Usage:
-npm link (in package dir)
-npm link [<@scope>/][@]
+npm link []
 
 Options:
 [-S|--save|--no-save|--save-prod|--save-dev|--save-optional|--save-peer|--save-bundle]
@@ -547,7 +522,7 @@ exports[`test/lib/load-all-commands.js TAP load each command ls > must match sna
 List installed packages
 
 Usage:
-npm ls [[<@scope>/] ...]
+npm ls 
 
 Options:
 [-a|--all] [--json] [-l|--long] [-p|--parseable] [-g|--global] [--depth ]
@@ -581,7 +556,7 @@ exports[`test/lib/load-all-commands.js TAP load each command outdated > must mat
 Check for outdated packages
 
 Usage:
-npm outdated [[<@scope>/] ...]
+npm outdated [ ...]
 
 Options:
 [-a|--all] [--json] [-l|--long] [-p|--parseable] [-g|--global]
@@ -594,9 +569,9 @@ exports[`test/lib/load-all-commands.js TAP load each command owner > must match
 Manage package owners
 
 Usage:
-npm owner add  [<@scope>/]
-npm owner rm  [<@scope>/]
-npm owner ls [<@scope>/]
+npm owner add  
+npm owner rm  
+npm owner ls 
 
 Options:
 [--registry ] [--otp ]
@@ -612,7 +587,7 @@ exports[`test/lib/load-all-commands.js TAP load each command pack > must match s
 Create a tarball from a package
 
 Usage:
-npm pack [[<@scope>/]...]
+npm pack 
 
 Options:
 [--dry-run] [--json] [--pack-destination ]
@@ -698,7 +673,7 @@ exports[`test/lib/load-all-commands.js TAP load each command publish > must matc
 Publish a package
 
 Usage:
-npm publish []
+npm publish 
 
 Options:
 [--tag ] [--access ] [--dry-run] [--otp ]
@@ -712,7 +687,7 @@ exports[`test/lib/load-all-commands.js TAP load each command rebuild > must matc
 Rebuild a package
 
 Usage:
-npm rebuild [[<@scope>/][@] ...]
+npm rebuild [] ...]
 
 Options:
 [-g|--global] [--no-bin-links] [--foreground-scripts] [--ignore-scripts]
@@ -829,7 +804,7 @@ exports[`test/lib/load-all-commands.js TAP load each command star > must match s
 Mark your favorite packages
 
 Usage:
-npm star [...]
+npm star [...]
 
 Options:
 [--registry ] [--unicode] [--otp ]
@@ -938,7 +913,7 @@ exports[`test/lib/load-all-commands.js TAP load each command unpublish > must ma
 Remove a package from the registry
 
 Usage:
-npm unpublish [<@scope>/][@]
+npm unpublish []
 
 Options:
 [--dry-run] [-f|--force]
@@ -952,7 +927,7 @@ exports[`test/lib/load-all-commands.js TAP load each command unstar > must match
 Remove an item from your favorite packages
 
 Usage:
-npm unstar [...]
+npm unstar [...]
 
 Options:
 [--registry ] [--unicode] [--otp ]
@@ -1001,7 +976,7 @@ exports[`test/lib/load-all-commands.js TAP load each command view > must match s
 View registry info
 
 Usage:
-npm view [<@scope>/][@] [[.subfield]...]
+npm view [] [[.subfield]...]
 
 Options:
 [--json] [-w|--workspace  [-w|--workspace  ...]]
diff --git a/deps/npm/tap-snapshots/test/lib/npm.js.test.cjs b/deps/npm/tap-snapshots/test/lib/npm.js.test.cjs
index d08935a14d1..c59252f9e81 100644
--- a/deps/npm/tap-snapshots/test/lib/npm.js.test.cjs
+++ b/deps/npm/tap-snapshots/test/lib/npm.js.test.cjs
@@ -238,11 +238,7 @@ All commands:
     cache           Manipulates packages cache
 
                     Usage:
-                    npm cache add 
-                    npm cache add 
-                    npm cache add 
-                    npm cache add 
-                    npm cache add @
+                    npm cache add 
                     npm cache clean []
                     npm cache ls [@]
                     npm cache verify
@@ -308,7 +304,7 @@ All commands:
     deprecate       Deprecate a version of a package
 
                     Usage:
-                    npm deprecate [@] 
+                    npm deprecate  
 
                     Options:
                     [--registry ] [--otp ]
@@ -321,10 +317,10 @@ All commands:
                     npm diff [...]
 
                     Options:
-                    [--diff  [--diff  ...]]
-                    [--diff-name-only] [--diff-unified ] [--diff-ignore-all-space]
-                    [--diff-no-prefix] [--diff-src-prefix ] [--diff-dst-prefix ]
-                    [--diff-text] [-g|--global] [--tag ]
+                    [--diff  [--diff  ...]] [--diff-name-only]
+                    [--diff-unified ] [--diff-ignore-all-space] [--diff-no-prefix]
+                    [--diff-src-prefix ] [--diff-dst-prefix ] [--diff-text] [-g|--global]
+                    [--tag ]
                     [-w|--workspace  [-w|--workspace  ...]]
                     [-ws|--workspaces] [--include-workspace-root]
 
@@ -333,9 +329,9 @@ All commands:
     dist-tag        Modify package distribution tags
 
                     Usage:
-                    npm dist-tag add @ []
-                    npm dist-tag rm  
-                    npm dist-tag ls []
+                    npm dist-tag add  []
+                    npm dist-tag rm  
+                    npm dist-tag ls []
 
                     Options:
                     [-w|--workspace  [-w|--workspace  ...]]
@@ -388,8 +384,7 @@ All commands:
                     npm exec --package=foo -c ' [args...]'
 
                     Options:
-                    [--package [@] [--package [@] ...]]
-                    [-c|--call ]
+                    [--package  [--package  ...]] [-c|--call ]
                     [-w|--workspace  [-w|--workspace  ...]]
                     [-ws|--workspaces] [--include-workspace-root]
 
@@ -400,7 +395,7 @@ All commands:
     explain         Explain installed packages
 
                     Usage:
-                    npm explain 
+                    npm explain 
 
                     Options:
                     [--json] [-w|--workspace  [-w|--workspace  ...]]
@@ -436,7 +431,7 @@ All commands:
     fund            Retrieve funding information
 
                     Usage:
-                    npm fund [[<@scope>/]]
+                    npm fund []
 
                     Options:
                     [--json] [--no-browser|--browser ] [--unicode]
@@ -480,12 +475,11 @@ All commands:
     init            Create a package.json file
 
                     Usage:
-                    npm init [--force|-f|--yes|-y|--scope]
+                    npm init  (same as \`npx )
                     npm init <@scope> (same as \`npx <@scope>/create\`)
-                    npm init [<@scope>/] (same as \`npx [<@scope>/]create-\`)
 
                     Options:
-                    [-y|--yes] [-f|--force]
+                    [-y|--yes] [-f|--force] [--scope <@scope>]
                     [-w|--workspace  [-w|--workspace  ...]]
                     [-ws|--workspaces] [--no-workspaces-update] [--include-workspace-root]
 
@@ -496,16 +490,7 @@ All commands:
     install         Install a package
 
                     Usage:
-                    npm install [<@scope>/]
-                    npm install [<@scope>/]@
-                    npm install [<@scope>/]@
-                    npm install [<@scope>/]@
-                    npm install @npm:
-                    npm install 
-                    npm install 
-                    npm install 
-                    npm install 
-                    npm install /
+                    npm install [ ...]
 
                     Options:
                     [-S|--save|--no-save|--save-prod|--save-dev|--save-optional|--save-peer|--save-bundle]
@@ -536,16 +521,7 @@ All commands:
     install-test    Install package(s) and run tests
 
                     Usage:
-                    npm install-test [<@scope>/]
-                    npm install-test [<@scope>/]@
-                    npm install-test [<@scope>/]@
-                    npm install-test [<@scope>/]@
-                    npm install-test @npm:
-                    npm install-test 
-                    npm install-test 
-                    npm install-test 
-                    npm install-test 
-                    npm install-test /
+                    npm install-test [ ...]
 
                     Options:
                     [-S|--save|--no-save|--save-prod|--save-dev|--save-optional|--save-peer|--save-bundle]
@@ -563,8 +539,7 @@ All commands:
     link            Symlink a package folder
 
                     Usage:
-                    npm link (in package dir)
-                    npm link [<@scope>/][@]
+                    npm link []
 
                     Options:
                     [-S|--save|--no-save|--save-prod|--save-dev|--save-optional|--save-peer|--save-bundle]
@@ -621,7 +596,7 @@ All commands:
     ls              List installed packages
 
                     Usage:
-                    npm ls [[<@scope>/] ...]
+                    npm ls 
 
                     Options:
                     [-a|--all] [--json] [-l|--long] [-p|--parseable] [-g|--global] [--depth ]
@@ -651,7 +626,7 @@ All commands:
     outdated        Check for outdated packages
 
                     Usage:
-                    npm outdated [[<@scope>/] ...]
+                    npm outdated [ ...]
 
                     Options:
                     [-a|--all] [--json] [-l|--long] [-p|--parseable] [-g|--global]
@@ -662,9 +637,9 @@ All commands:
     owner           Manage package owners
 
                     Usage:
-                    npm owner add  [<@scope>/]
-                    npm owner rm  [<@scope>/]
-                    npm owner ls [<@scope>/]
+                    npm owner add  
+                    npm owner rm  
+                    npm owner ls 
 
                     Options:
                     [--registry ] [--otp ]
@@ -678,7 +653,7 @@ All commands:
     pack            Create a tarball from a package
 
                     Usage:
-                    npm pack [[<@scope>/]...]
+                    npm pack 
 
                     Options:
                     [--dry-run] [--json] [--pack-destination ]
@@ -752,7 +727,7 @@ All commands:
     publish         Publish a package
 
                     Usage:
-                    npm publish []
+                    npm publish 
 
                     Options:
                     [--tag ] [--access ] [--dry-run] [--otp ]
@@ -764,7 +739,7 @@ All commands:
     rebuild         Rebuild a package
 
                     Usage:
-                    npm rebuild [[<@scope>/][@] ...]
+                    npm rebuild [] ...]
 
                     Options:
                     [-g|--global] [--no-bin-links] [--foreground-scripts] [--ignore-scripts]
@@ -863,7 +838,7 @@ All commands:
     star            Mark your favorite packages
 
                     Usage:
-                    npm star [...]
+                    npm star [...]
 
                     Options:
                     [--registry ] [--unicode] [--otp ]
@@ -956,7 +931,7 @@ All commands:
     unpublish       Remove a package from the registry
 
                     Usage:
-                    npm unpublish [<@scope>/][@]
+                    npm unpublish []
 
                     Options:
                     [--dry-run] [-f|--force]
@@ -968,7 +943,7 @@ All commands:
     unstar          Remove an item from your favorite packages
 
                     Usage:
-                    npm unstar [...]
+                    npm unstar [...]
 
                     Options:
                     [--registry ] [--unicode] [--otp ]
@@ -1011,7 +986,7 @@ All commands:
     view            View registry info
 
                     Usage:
-                    npm view [<@scope>/][@] [[.subfield]...]
+                    npm view [] [[.subfield]...]
 
                     Options:
                     [--json] [-w|--workspace  [-w|--workspace  ...]]
diff --git a/deps/npm/tap-snapshots/test/lib/utils/config/definitions.js.test.cjs b/deps/npm/tap-snapshots/test/lib/utils/config/definitions.js.test.cjs
index 33d6e4fb7a0..19909d8c5b3 100644
--- a/deps/npm/tap-snapshots/test/lib/utils/config/definitions.js.test.cjs
+++ b/deps/npm/tap-snapshots/test/lib/utils/config/definitions.js.test.cjs
@@ -1591,7 +1591,7 @@ exports[`test/lib/utils/config/definitions.js TAP > config description for scrip
 * Type: null or String
 
 The shell to use for scripts run with the \`npm exec\`, \`npm run\` and \`npm
-init \` commands.
+init \` commands.
 `
 
 exports[`test/lib/utils/config/definitions.js TAP > config description for searchexclude 1`] = `
diff --git a/deps/npm/tap-snapshots/test/lib/utils/config/describe-all.js.test.cjs b/deps/npm/tap-snapshots/test/lib/utils/config/describe-all.js.test.cjs
index 77f2c876841..9d95aa9528b 100644
--- a/deps/npm/tap-snapshots/test/lib/utils/config/describe-all.js.test.cjs
+++ b/deps/npm/tap-snapshots/test/lib/utils/config/describe-all.js.test.cjs
@@ -1391,7 +1391,7 @@ npm init --scope=@foo --yes
 * Type: null or String
 
 The shell to use for scripts run with the \`npm exec\`, \`npm run\` and \`npm
-init \` commands.
+init \` commands.
 
 
 
diff --git a/deps/npm/tap-snapshots/test/lib/utils/open-url-prompt.js.test.cjs b/deps/npm/tap-snapshots/test/lib/utils/open-url-prompt.js.test.cjs
new file mode 100644
index 00000000000..8af3c475c77
--- /dev/null
+++ b/deps/npm/tap-snapshots/test/lib/utils/open-url-prompt.js.test.cjs
@@ -0,0 +1,25 @@
+/* IMPORTANT
+ * This snapshot file is auto-generated, but designed for humans.
+ * It should be checked into source control and tracked carefully.
+ * Re-generate by setting TAP_SNAPSHOT=1 and running tests.
+ * Make sure to inspect the output below.  Do not ignore changes!
+ */
+'use strict'
+exports[`test/lib/utils/open-url-prompt.js TAP opens a url > must match snapshot 1`] = `
+Array [
+  Array [
+    String(
+      npm home:
+      https://www.npmjs.com
+    ),
+  ],
+]
+`
+
+exports[`test/lib/utils/open-url-prompt.js TAP prints json output > must match snapshot 1`] = `
+Array [
+  Array [
+    "{\\"title\\":\\"npm home\\",\\"url\\":\\"https://www.npmjs.com\\"}",
+  ],
+]
+`
diff --git a/deps/npm/test/lib/auth/legacy.js b/deps/npm/test/lib/auth/legacy.js
index 0c23f8ba6b3..39d977d436b 100644
--- a/deps/npm/test/lib/auth/legacy.js
+++ b/deps/npm/test/lib/auth/legacy.js
@@ -12,7 +12,7 @@ const legacy = t.mock('../../../lib/auth/legacy.js', {
     },
   },
   'npm-profile': profile,
-  '../../../lib/utils/open-url.js': (npm, url, msg) => {
+  '../../../lib/utils/open-url-prompt.js': (_npm, url) => {
     if (!url) {
       throw Object.assign(new Error('failed open url'), { code: 'ERROR' })
     }
diff --git a/deps/npm/test/lib/commands/edit.js b/deps/npm/test/lib/commands/edit.js
index 1943e8c5fb4..b2a10be135a 100644
--- a/deps/npm/test/lib/commands/edit.js
+++ b/deps/npm/test/lib/commands/edit.js
@@ -1,4 +1,5 @@
 const t = require('tap')
+const fs = require('fs')
 const path = require('path')
 const tspawk = require('../../fixtures/tspawk')
 const { load: loadMockNpm } = require('../../fixtures/mock-npm')
@@ -41,11 +42,19 @@ t.test('npm edit', async t => {
   const [scriptShell] = makeSpawnArgs({
     event: 'install',
     path: npm.prefix,
+    cmd: 'testinstall',
   })
   spawk.spawn('testeditor', [semverPath])
   spawk.spawn(
     scriptShell,
-    args => args.includes('testinstall'),
+    args => {
+      const lastArg = args[args.length - 1]
+      const rightExtension = lastArg.endsWith('.cmd') || lastArg.endsWith('.sh')
+      const rightFilename = path.basename(lastArg).startsWith('install')
+      const rightContents = fs.readFileSync(lastArg, { encoding: 'utf8' })
+        .trim().endsWith('testinstall')
+      return rightExtension && rightFilename && rightContents
+    },
     { cwd: semverPath }
   )
   await npm.exec('edit', ['semver'])
@@ -58,11 +67,19 @@ t.test('rebuild failure', async t => {
   const [scriptShell] = makeSpawnArgs({
     event: 'install',
     path: npm.prefix,
+    cmd: 'testinstall',
   })
   spawk.spawn('testeditor', [semverPath])
   spawk.spawn(
     scriptShell,
-    args => args.includes('testinstall'),
+    args => {
+      const lastArg = args[args.length - 1]
+      const rightExtension = lastArg.endsWith('.cmd') || lastArg.endsWith('.sh')
+      const rightFilename = path.basename(lastArg).startsWith('install')
+      const rightContents = fs.readFileSync(lastArg, { encoding: 'utf8' })
+        .trim().endsWith('testinstall')
+      return rightExtension && rightFilename && rightContents
+    },
     { cwd: semverPath }
   ).exit(1).stdout('test error')
   await t.rejects(
@@ -94,11 +111,19 @@ t.test('npm edit editor has flags', async t => {
   const [scriptShell] = makeSpawnArgs({
     event: 'install',
     path: npm.prefix,
+    cmd: 'testinstall',
   })
   spawk.spawn('testeditor', ['--flag', semverPath])
   spawk.spawn(
     scriptShell,
-    args => args.includes('testinstall'),
+    args => {
+      const lastArg = args[args.length - 1]
+      const rightExtension = lastArg.endsWith('.cmd') || lastArg.endsWith('.sh')
+      const rightFilename = path.basename(lastArg).startsWith('install')
+      const rightContents = fs.readFileSync(lastArg, { encoding: 'utf8' })
+        .trim().endsWith('testinstall')
+      return rightExtension && rightFilename && rightContents
+    },
     { cwd: semverPath }
   )
   await npm.exec('edit', ['semver'])
diff --git a/deps/npm/test/lib/commands/restart.js b/deps/npm/test/lib/commands/restart.js
index 84bd93d8c99..bfbe715e8c6 100644
--- a/deps/npm/test/lib/commands/restart.js
+++ b/deps/npm/test/lib/commands/restart.js
@@ -1,3 +1,5 @@
+const fs = require('fs')
+const path = require('path')
 const t = require('tap')
 const tspawk = require('../../fixtures/tspawk')
 const { load: loadMockNpm } = require('../../fixtures/mock-npm')
@@ -24,10 +26,14 @@ t.test('should run restart script from package.json', async t => {
       loglevel: 'silent',
     },
   })
-  const [scriptShell] = makeSpawnArgs({ path: npm.prefix })
+  const [scriptShell] = makeSpawnArgs({ path: npm.prefix, cmd: 'node ./test-restart.js' })
   const script = spawk.spawn(scriptShell, (args) => {
-    t.ok(args.includes('node ./test-restart.js "foo"'), 'ran restart script with extra args')
-    return true
+    const lastArg = args[args.length - 1]
+    const rightExtension = lastArg.endsWith('.cmd') || lastArg.endsWith('.sh')
+    const rightFilename = path.basename(lastArg).startsWith('restart')
+    const rightContents = fs.readFileSync(lastArg, { encoding: 'utf8' })
+      .trim().endsWith('foo')
+    return rightExtension && rightFilename && rightContents
   })
   await npm.exec('restart', ['foo'])
   t.ok(script.called, 'script ran')
diff --git a/deps/npm/test/lib/commands/start.js b/deps/npm/test/lib/commands/start.js
index 8fc73493d20..79c2133bc69 100644
--- a/deps/npm/test/lib/commands/start.js
+++ b/deps/npm/test/lib/commands/start.js
@@ -1,3 +1,5 @@
+const fs = require('fs')
+const path = require('path')
 const t = require('tap')
 const tspawk = require('../../fixtures/tspawk')
 const { load: loadMockNpm } = require('../../fixtures/mock-npm')
@@ -10,7 +12,6 @@ const spawk = tspawk(t)
 const makeSpawnArgs = require('@npmcli/run-script/lib/make-spawn-args.js')
 
 t.test('should run start script from package.json', async t => {
-  t.plan(2)
   const { npm } = await loadMockNpm(t, {
     prefixDir: {
       'package.json': JSON.stringify({
@@ -25,10 +26,14 @@ t.test('should run start script from package.json', async t => {
       loglevel: 'silent',
     },
   })
-  const [scriptShell] = makeSpawnArgs({ path: npm.prefix })
+  const [scriptShell] = makeSpawnArgs({ path: npm.prefix, cmd: 'node ./test-start.js' })
   const script = spawk.spawn(scriptShell, (args) => {
-    t.ok(args.includes('node ./test-start.js "foo"'), 'ran start script with extra args')
-    return true
+    const lastArg = args[args.length - 1]
+    const rightExtension = lastArg.endsWith('.cmd') || lastArg.endsWith('.sh')
+    const rightFilename = path.basename(lastArg).startsWith('start')
+    const rightContents = fs.readFileSync(lastArg, { encoding: 'utf8' })
+      .trim().endsWith('foo')
+    return rightExtension && rightFilename && rightContents
   })
   await npm.exec('start', ['foo'])
   t.ok(script.called, 'script ran')
diff --git a/deps/npm/test/lib/commands/stop.js b/deps/npm/test/lib/commands/stop.js
index f2aef21899f..1a4abd0b3ab 100644
--- a/deps/npm/test/lib/commands/stop.js
+++ b/deps/npm/test/lib/commands/stop.js
@@ -1,3 +1,5 @@
+const fs = require('fs')
+const path = require('path')
 const t = require('tap')
 const tspawk = require('../../fixtures/tspawk')
 const { load: loadMockNpm } = require('../../fixtures/mock-npm')
@@ -24,10 +26,14 @@ t.test('should run stop script from package.json', async t => {
       loglevel: 'silent',
     },
   })
-  const [scriptShell] = makeSpawnArgs({ path: npm.prefix })
+  const [scriptShell] = makeSpawnArgs({ path: npm.prefix, cmd: 'node ./test-stop.js' })
   const script = spawk.spawn(scriptShell, (args) => {
-    t.ok(args.includes('node ./test-stop.js "foo"'), 'ran stop script with extra args')
-    return true
+    const lastArg = args[args.length - 1]
+    const rightExtension = lastArg.endsWith('.cmd') || lastArg.endsWith('.sh')
+    const rightFilename = path.basename(lastArg).startsWith('stop')
+    const rightContents = fs.readFileSync(lastArg, { encoding: 'utf8' })
+      .trim().endsWith('foo')
+    return rightExtension && rightFilename && rightContents
   })
   await npm.exec('stop', ['foo'])
   t.ok(script.called, 'script ran')
diff --git a/deps/npm/test/lib/commands/test.js b/deps/npm/test/lib/commands/test.js
index e9ea0a3c834..c6d3f530bb6 100644
--- a/deps/npm/test/lib/commands/test.js
+++ b/deps/npm/test/lib/commands/test.js
@@ -1,3 +1,5 @@
+const fs = require('fs')
+const path = require('path')
 const t = require('tap')
 const tspawk = require('../../fixtures/tspawk')
 const { load: loadMockNpm } = require('../../fixtures/mock-npm')
@@ -24,10 +26,14 @@ t.test('should run test script from package.json', async t => {
       loglevel: 'silent',
     },
   })
-  const [scriptShell] = makeSpawnArgs({ path: npm.prefix })
+  const [scriptShell] = makeSpawnArgs({ path: npm.prefix, cmd: 'node ./test-test.js' })
   const script = spawk.spawn(scriptShell, (args) => {
-    t.ok(args.includes('node ./test-test.js "foo"'), 'ran test script with extra args')
-    return true
+    const lastArg = args[args.length - 1]
+    const rightExtension = lastArg.endsWith('.cmd') || lastArg.endsWith('.sh')
+    const rightFilename = path.basename(lastArg).startsWith('test')
+    const rightContents = fs.readFileSync(lastArg, { encoding: 'utf8' })
+      .trim().endsWith('foo')
+    return rightExtension && rightFilename && rightContents
   })
   await npm.exec('test', ['foo'])
   t.ok(script.called, 'script ran')
diff --git a/deps/npm/test/lib/commands/view.js b/deps/npm/test/lib/commands/view.js
index da823db5d75..d347bc9230e 100644
--- a/deps/npm/test/lib/commands/view.js
+++ b/deps/npm/test/lib/commands/view.js
@@ -33,6 +33,7 @@ const packument = (nv, opts) => {
       },
     },
     blue: {
+      _id: 'blue',
       name: 'blue',
       'dist-tags': {
         latest: '1.0.0',
@@ -464,6 +465,14 @@ t.test('throws when unpublished', async t => {
   )
 })
 
+t.test('throws when version not matched', async t => {
+  const { npm } = await loadMockNpm(t)
+  await t.rejects(
+    npm.exec('view', ['blue@2.0.0']),
+    { code: 'E404', pkgid: 'blue@2.0.0', message: 'No match found for version 2.0.0' }
+  )
+})
+
 t.test('workspaces', async t => {
   const prefixDir = {
     'package.json': JSON.stringify({
diff --git a/deps/npm/test/lib/utils/open-url-prompt.js b/deps/npm/test/lib/utils/open-url-prompt.js
new file mode 100644
index 00000000000..6908e36b7c8
--- /dev/null
+++ b/deps/npm/test/lib/utils/open-url-prompt.js
@@ -0,0 +1,150 @@
+const t = require('tap')
+const mockGlobals = require('../../fixtures/mock-globals.js')
+const EventEmitter = require('events')
+
+const OUTPUT = []
+const output = (...args) => OUTPUT.push(args)
+const npm = {
+  _config: {
+    json: false,
+    browser: true,
+  },
+  config: {
+    get: k => npm._config[k],
+    set: (k, v) => {
+      npm._config[k] = v
+    },
+  },
+  output,
+}
+
+let openerUrl = null
+let openerOpts = null
+let openerResult = null
+const opener = (url, opts, cb) => {
+  openerUrl = url
+  openerOpts = opts
+  return cb(openerResult)
+}
+
+let questionShouldResolve = true
+const readline = {
+  createInterface: () => ({
+    question: (_q, cb) => {
+      if (questionShouldResolve === true) {
+        cb()
+      }
+    },
+    close: () => {},
+  }),
+}
+
+const openUrlPrompt = t.mock('../../../lib/utils/open-url-prompt.js', {
+  opener,
+  readline,
+})
+
+mockGlobals(t, {
+  'process.stdin.isTTY': true,
+  'process.stdout.isTTY': true,
+})
+
+t.test('does not open a url in non-interactive environments', async t => {
+  t.teardown(() => {
+    openerUrl = null
+    openerOpts = null
+    OUTPUT.length = 0
+  })
+
+  mockGlobals(t, {
+    'process.stdin.isTTY': false,
+    'process.stdout.isTTY': false,
+  })
+
+  await openUrlPrompt(npm, 'https://www.npmjs.com', 'npm home', 'prompt')
+  t.equal(openerUrl, null, 'did not open')
+  t.same(openerOpts, null, 'did not open')
+})
+
+t.test('opens a url', async t => {
+  t.teardown(() => {
+    openerUrl = null
+    openerOpts = null
+    OUTPUT.length = 0
+    npm._config.browser = true
+  })
+
+  npm._config.browser = 'browser'
+  await openUrlPrompt(npm, 'https://www.npmjs.com', 'npm home', 'prompt')
+  t.equal(openerUrl, 'https://www.npmjs.com', 'opened the given url')
+  t.same(openerOpts, { command: 'browser' }, 'passed command as null (the default)')
+  t.matchSnapshot(OUTPUT)
+})
+
+t.test('prints json output', async t => {
+  t.teardown(() => {
+    openerUrl = null
+    openerOpts = null
+    OUTPUT.length = 0
+    npm._config.json = false
+  })
+
+  npm._config.json = true
+  await openUrlPrompt(npm, 'https://www.npmjs.com', 'npm home', 'prompt')
+  t.matchSnapshot(OUTPUT)
+})
+
+t.test('returns error for non-https url', async t => {
+  t.teardown(() => {
+    openerUrl = null
+    openerOpts = null
+    OUTPUT.length = 0
+  })
+  await t.rejects(
+    openUrlPrompt(npm, 'ftp://www.npmjs.com', 'npm home', 'prompt'),
+    /Invalid URL/,
+    'got the correct error'
+  )
+  t.equal(openerUrl, null, 'did not open')
+  t.same(openerOpts, null, 'did not open')
+  t.same(OUTPUT, [], 'printed no output')
+})
+
+t.test('does not open url if canceled', async t => {
+  t.teardown(() => {
+    openerUrl = null
+    openerOpts = null
+    OUTPUT.length = 0
+    questionShouldResolve = true
+  })
+
+  questionShouldResolve = false
+  const emitter = new EventEmitter()
+
+  const open = openUrlPrompt(npm, 'https://www.npmjs.com', 'npm home', 'prompt', emitter)
+
+  emitter.emit('abort')
+
+  await open
+
+  t.equal(openerUrl, null, 'did not open')
+  t.same(openerOpts, null, 'did not open')
+})
+
+t.test('returns error when opener errors', async t => {
+  t.teardown(() => {
+    openerUrl = null
+    openerOpts = null
+    openerResult = null
+    OUTPUT.length = 0
+  })
+
+  openerResult = new Error('Opener failed')
+
+  await t.rejects(
+    openUrlPrompt(npm, 'https://www.npmjs.com', 'npm home', 'prompt'),
+    /Opener failed/,
+    'got the correct error'
+  )
+  t.equal(openerUrl, 'https://www.npmjs.com', 'did not open')
+})