deps: upgrade npm to 8.12.1

PR-URL: #43301
Reviewed-By: Ruy Adorno <ruyadorno@github.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
Reviewed-By: Mohammed Keyvanzadeh <mohammadkeyvanzade94@gmail.com>
Reviewed-By: Mestery <mestery@protonmail.com>

Author: npm-cli-bot

deps/npm/docs/content/commands/npm-adduser.md

@@ -87,6 +87,20 @@ npm init --scope=@foo --yes
 ```
 
 
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/utils/config/definitions.js -->
+
+#### `auth-type`
+
+* Default: "legacy"
+* Type: "legacy", "webauthn", "sso", "saml", or "oauth"
+* DEPRECATED: The SSO/SAML/OAuth methods are deprecated and will be removed in
+  a future version of npm in favor of web-based login.
+
+What authentication strategy to use with `adduser`/`login`.
+
+Pass `webauthn` to use a web-based login.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

deps/npm/docs/content/commands/npm-bin.md

@@ -34,8 +34,6 @@ Print the folder where npm will install executables.
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-config.md

@@ -124,8 +124,6 @@ Not supported by all npm commands.
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-diff.md

@@ -248,8 +248,6 @@ Treat all files as text in `npm diff`.
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-init.md

@@ -253,6 +253,17 @@ This value is not exported to the environment for child processes.
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 
+#### `workspaces-update`
+
+* Default: true
+* Type: Boolean
+
+If set to true, the npm cli will run an update after operations that may
+possibly change the workspaces installed to the `node_modules` folder.
+
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/utils/config/definitions.js -->
+
 #### `include-workspace-root`
 
 * Default: false

deps/npm/docs/content/commands/npm-install-test.md

@@ -70,8 +70,6 @@ rather than using npm's default semver range operator.
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-install.md

@@ -460,8 +460,6 @@ rather than using npm's default semver range operator.
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-link.md

@@ -153,8 +153,6 @@ rather than using npm's default semver range operator.
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-ls.md

@@ -137,8 +137,6 @@ Output parseable results from commands that write to standard output. For
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-outdated.md

@@ -150,8 +150,6 @@ Output parseable results from commands that write to standard output. For
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-prefix.md

@@ -51,8 +51,6 @@ npm prefix -g
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-rebuild.md

@@ -42,8 +42,6 @@ will be rebuilt.
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-root.md

@@ -41,8 +41,6 @@ echo "Global packages installed in: ${global_node_modules}"
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/commands/npm-update.md

@@ -188,8 +188,6 @@ Will also prevent writing to `package-lock.json` if set to `false`.
 
 * Default: false
 * Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
 
 Operates in "global" mode, so that packages are installed into the `prefix`
 folder instead of the current working directory. See

deps/npm/docs/content/configuring-npm/package-json.md

@@ -643,6 +643,26 @@ git+https://isaacs@github.com/npm/cli.git
 git://github.com/npm/cli.git#v1.0.27
 ```
 
+When installing from a `git` repository, the presence of certain fields in the
+`package.json` will cause npm to believe it needs to perform a build. To do so
+your repository will be cloned into a temporary directory, all of its deps
+installed, relevant scripts run, and the resulting directory packed and
+installed.
+
+This flow will occur if your git dependency uses `workspaces`, or if any of the
+following scripts are present:
+
+* `build`
+* `prepare`
+* `prepack`
+* `preinstall`
+* `install`
+* `postinstall`
+
+If your git repository includes pre-built artifacts, you will likely want to
+make sure that none of the above scripts are defined, or your dependency
+will be rebuilt for every installation.
+
 #### GitHub URLs
 
 As of version 1.1.65, you can refer to GitHub urls as just "foo":

deps/npm/docs/content/using-npm/config.md

@@ -687,6 +687,23 @@ results in no commit being made at all.
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 
+#### `global`
+
+* Default: false
+* Type: Boolean
+
+Operates in "global" mode, so that packages are installed into the `prefix`
+folder instead of the current working directory. See
+[folders](/configuring-npm/folders) for more on the differences in behavior.
+
+* packages are installed into the `{prefix}/lib/node_modules` folder, instead
+  of the current working directory.
+* bin files are linked to `{prefix}/bin`
+* man pages are linked to `{prefix}/share/man`
+
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/utils/config/definitions.js -->
+
 #### `global-style`
 
 * Default: false
@@ -1891,12 +1908,14 @@ When set to `dev` or `development`, this is an alias for `--include=dev`.
 #### `auth-type`
 
 * Default: "legacy"
-* Type: "legacy", "sso", "saml", or "oauth"
-* DEPRECATED: This method of SSO/SAML/OAuth is deprecated and will be removed
-  in a future version of npm in favor of web-based login.
+* Type: "legacy", "webauthn", "sso", "saml", or "oauth"
+* DEPRECATED: The SSO/SAML/OAuth methods are deprecated and will be removed in
+  a future version of npm in favor of web-based login.
 
 What authentication strategy to use with `adduser`/`login`.
 
+Pass `webauthn` to use a web-based login.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 
@@ -1933,25 +1952,6 @@ Alias for `--include=dev`.
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 
-#### `global`
-
-* Default: false
-* Type: Boolean
-* DEPRECATED: `--global`, `--local` are deprecated. Use `--location=global`
-  instead.
-
-Operates in "global" mode, so that packages are installed into the `prefix`
-folder instead of the current working directory. See
-[folders](/configuring-npm/folders) for more on the differences in behavior.
-
-* packages are installed into the `{prefix}/lib/node_modules` folder, instead
-  of the current working directory.
-* bin files are linked to `{prefix}/bin`
-* man pages are linked to `{prefix}/share/man`
-
-<!-- automatically generated, do not edit manually -->
-<!-- see lib/utils/config/definitions.js -->
-
 #### `init.author.email`
 
 * Default: ""

deps/npm/docs/content/using-npm/scripts.md

@@ -203,6 +203,12 @@ will default the `start` command to `node server.js`.  `prestart` and
 * `test`
 * `posttest`
 
+#### [`npm version`](/commands/npm-version)
+
+* `preversion`
+* `version`
+* `postversion`
+
 #### A Note on a lack of [`npm uninstall`](/commands/npm-uninstall) scripts
 
 While npm v6 had `uninstall` lifecycle scripts, npm v7 does not. Removal of a package can happen for a wide variety of reasons, and there's no clear way to currently give the script enough context to be useful.

deps/npm/docs/output/commands/npm-adduser.html

@@ -142,7 +142,7 @@ <h1 id="npm-adduser">npm-adduser</h1>
 
 <section id="table_of_contents">
 <h2 id="table-of-contents">Table of contents</h2>
-<div id="_table_of_contents"><ul><li><a href="#synopsis">Synopsis</a></li><li><a href="#description">Description</a></li><li><a href="#configuration">Configuration</a></li><ul><li><a href="#registry"><code>registry</code></a></li><li><a href="#scope"><code>scope</code></a></li></ul><li><a href="#see-also">See Also</a></li></ul></div>
+<div id="_table_of_contents"><ul><li><a href="#synopsis">Synopsis</a></li><li><a href="#description">Description</a></li><li><a href="#configuration">Configuration</a></li><ul><li><a href="#registry"><code>registry</code></a></li><li><a href="#scope"><code>scope</code></a></li><li><a href="#auth-type"><code>auth-type</code></a></li></ul><li><a href="#see-also">See Also</a></li></ul></div>
 </section>
 
 <div id="_content"><h3 id="synopsis">Synopsis</h3>
@@ -204,6 +204,17 @@ <h4 id="scope"><code>scope</code></h4>
 </code></pre>
 <!-- raw HTML omitted -->
 <!-- raw HTML omitted -->
+<h4 id="auth-type"><code>auth-type</code></h4>
+<ul>
+<li>Default: "legacy"</li>
+<li>Type: "legacy", "webauthn", "sso", "saml", or "oauth"</li>
+<li>DEPRECATED: The SSO/SAML/OAuth methods are deprecated and will be removed in
+a future version of npm in favor of web-based login.</li>
+</ul>
+<p>What authentication strategy to use with <code>adduser</code>/<code>login</code>.</p>
+<p>Pass <code>webauthn</code> to use a web-based login.</p>
+<!-- raw HTML omitted -->
+<!-- raw HTML omitted -->
 <!-- raw HTML omitted -->
 <h3 id="see-also">See Also</h3>
 <ul>

deps/npm/docs/output/commands/npm-bin.html

@@ -165,8 +165,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See

deps/npm/docs/output/commands/npm-config.html

@@ -223,8 +223,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See

deps/npm/docs/output/commands/npm-diff.html

@@ -334,8 +334,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See

deps/npm/docs/output/commands/npm-init.html

@@ -142,7 +142,7 @@ <h1 id="npm-init">npm-init</h1>
 
 <section id="table_of_contents">
 <h2 id="table-of-contents">Table of contents</h2>
-<div id="_table_of_contents"><ul><li><a href="#synopsis">Synopsis</a></li><li><a href="#description">Description</a></li><ul><li><a href="#forwarding-additional-options">Forwarding additional options</a></li></ul><li><a href="#examples">Examples</a></li><li><a href="#workspaces-support">Workspaces support</a></li><li><a href="#configuration">Configuration</a></li><ul><li><a href="#yes"><code>yes</code></a></li><li><a href="#force"><code>force</code></a></li><li><a href="#workspace"><code>workspace</code></a></li><li><a href="#workspaces"><code>workspaces</code></a></li><li><a href="#include-workspace-root"><code>include-workspace-root</code></a></li></ul><li><a href="#see-also">See Also</a></li></ul></div>
+<div id="_table_of_contents"><ul><li><a href="#synopsis">Synopsis</a></li><li><a href="#description">Description</a></li><ul><li><a href="#forwarding-additional-options">Forwarding additional options</a></li></ul><li><a href="#examples">Examples</a></li><li><a href="#workspaces-support">Workspaces support</a></li><li><a href="#configuration">Configuration</a></li><ul><li><a href="#yes"><code>yes</code></a></li><li><a href="#force"><code>force</code></a></li><li><a href="#workspace"><code>workspace</code></a></li><li><a href="#workspaces"><code>workspaces</code></a></li><li><a href="#workspaces-update"><code>workspaces-update</code></a></li><li><a href="#include-workspace-root"><code>include-workspace-root</code></a></li></ul><li><a href="#see-also">See Also</a></li></ul></div>
 </section>
 
 <div id="_content"><h3 id="synopsis">Synopsis</h3>
@@ -339,6 +339,15 @@ <h4 id="workspaces"><code>workspaces</code></h4>
 <p>This value is not exported to the environment for child processes.</p>
 <!-- raw HTML omitted -->
 <!-- raw HTML omitted -->
+<h4 id="workspaces-update"><code>workspaces-update</code></h4>
+<ul>
+<li>Default: true</li>
+<li>Type: Boolean</li>
+</ul>
+<p>If set to true, the npm cli will run an update after operations that may
+possibly change the workspaces installed to the <code>node_modules</code> folder.</p>
+<!-- raw HTML omitted -->
+<!-- raw HTML omitted -->
 <h4 id="include-workspace-root"><code>include-workspace-root</code></h4>
 <ul>
 <li>Default: false</li>

deps/npm/docs/output/commands/npm-install-test.html

@@ -196,8 +196,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See

deps/npm/docs/output/commands/npm-install.html

@@ -522,8 +522,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See

deps/npm/docs/output/commands/npm-link.html

@@ -251,8 +251,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See

deps/npm/docs/output/commands/npm-ls.html

@@ -166,7 +166,7 @@ <h3 id="description">Description</h3>
 the results to only the paths to the packages named.  Note that nested
 packages will <em>also</em> show the paths to the specified packages.  For
 example, running <code>npm ls promzard</code> in npm's source tree will show:</p>
-<pre lang="bash"><code>npm@8.11.0 /path/to/npm
+<pre lang="bash"><code>npm@8.12.1 /path/to/npm
 └─┬ init-package-json@0.0.4
   └── promzard@0.1.5
 </code></pre>
@@ -246,8 +246,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See

deps/npm/docs/output/commands/npm-outdated.html

@@ -268,8 +268,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See

deps/npm/docs/output/commands/npm-prefix.html

@@ -176,8 +176,6 @@ <h4 id="global"><code>global</code></h4>
 <ul>
 <li>Default: false</li>
 <li>Type: Boolean</li>
-<li>DEPRECATED: <code>--global</code>, <code>--local</code> are deprecated. Use <code>--location=global</code>
-instead.</li>
 </ul>
 <p>Operates in "global" mode, so that packages are installed into the <code>prefix</code>
 folder instead of the current working directory. See