deps: upgrade npm to 10.8.0

PR-URL: nodejs#53014
Reviewed-By: Luke Karrys <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: Marco Ippolito <[email protected]>
Reviewed-By: Trivikram Kamat <[email protected]>

Author: npm-cli-bot

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

@@ -27,7 +27,7 @@ packages will *also* show the paths to the specified packages.  For
 example, running `npm ls promzard` in npm's source tree will show:
 
 ```bash
-npm@10.7.0 /path/to/npm
+npm@10.8.0 /path/to/npm
 └─┬ [email protected]
   └── [email protected]
 ```

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

@@ -14,7 +14,7 @@ Note: This command is unaware of workspaces.
 
 ### Version
 
-10.7.0
+10.8.0
 
 ### Description
 

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

@@ -368,7 +368,7 @@ For example, myapp could have this:
 ```json
 {
   "bin": {
-    "myapp": "./cli.js"
+    "myapp": "bin/cli.js"
   }
 }
 ```
@@ -385,7 +385,7 @@ package, then you can just supply it as a string.  For example:
 {
   "name": "my-program",
   "version": "1.2.5",
-  "bin": "./path/to/program"
+  "bin": "path/to/program"
 }
 ```
 
@@ -396,7 +396,7 @@ would be the same as this:
   "name": "my-program",
   "version": "1.2.5",
   "bin": {
-    "my-program": "./path/to/program"
+    "my-program": "path/to/program"
   }
 }
 ```
@@ -497,7 +497,7 @@ walking the folder.
 ### repository
 
 Specify the place where your code lives. This is helpful for people who
-want to contribute.  If the git repo is on GitHub, then the `npm docs`
+want to contribute.  If the git repo is on GitHub, then the `npm repo`
 command will be able to find you.
 
 Do it like this:
@@ -818,11 +818,12 @@ to express this. If you depend on features introduced in 1.5.2, use
 
 ### peerDependenciesMeta
 
-When a user installs your package, npm will emit warnings if packages
-specified in `peerDependencies` are not already installed. The
-`peerDependenciesMeta` field serves to provide npm more information on how
+The `peerDependenciesMeta` field serves to provide npm more information on how
 your peer dependencies are to be used. Specifically, it allows peer
-dependencies to be marked as optional.
+dependencies to be marked as optional. Npm will not automatically install
+optional peer dependencies. This allows you to
+integrate and interact with a variety of host packages without requiring
+all of them to be installed.
 
 For example:
 
@@ -842,11 +843,6 @@ For example:
 }
 ```
 
-Marking a peer dependency as optional ensures npm will not emit a warning
-if the `soy-milk` package is not installed on the host. This allows you to
-integrate and interact with a variety of host packages without requiring
-all of them to be installed.
-
 ### bundleDependencies
 
 This defines an array of package names that will be bundled when publishing

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

@@ -1217,7 +1217,7 @@ a semver. Like the `rc` in `1.2.0-rc.8`.
 * Type: Boolean
 
 When set to `true`, npm will display a progress bar during time intensive
-operations, if `process.stderr` is a TTY.
+operations, if `process.stderr` and `process.stdout` are a TTY.
 
 Set to `false` to suppress the progress bar.
 

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

@@ -12,11 +12,7 @@ So sad to see you go.
 sudo npm uninstall npm -g
 ```
 
-Or, if that fails, get the npm source code, and do:
-
-```bash
-sudo make uninstall
-```
+Or, if that fails, please proceed to more severe uninstalling methods.
 
 ### More Severe Uninstalling
 

deps/npm/docs/lib/index.js

@@ -157,7 +157,7 @@ const replaceHelpLinks = (src) => {
 
 const transformMan = (src, { data, unified, remarkParse, remarkMan }) => unified()
   .use(remarkParse)
-  .use(remarkMan)
+  .use(remarkMan, { version: `NPM@${version}` })
   .processSync(`# ${data.title}(${data.section}) - ${data.description}\n\n${src}`)
   .toString()
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-access">npm-access</h1>
+<h1 id="----npm-access----1080">
+    <span>npm-access</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Set access level on published packages</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-adduser">npm-adduser</h1>
+<h1 id="----npm-adduser----1080">
+    <span>npm-adduser</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Add a registry user account</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-audit">npm-audit</h1>
+<h1 id="----npm-audit----1080">
+    <span>npm-audit</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Run a security audit</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-bugs">npm-bugs</h1>
+<h1 id="----npm-bugs----1080">
+    <span>npm-bugs</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Report bugs for a package in a web browser</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-cache">npm-cache</h1>
+<h1 id="----npm-cache----1080">
+    <span>npm-cache</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Manipulates packages cache</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-ci">npm-ci</h1>
+<h1 id="----npm-ci----1080">
+    <span>npm-ci</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Clean install a project</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-completion">npm-completion</h1>
+<h1 id="----npm-completion----1080">
+    <span>npm-completion</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Tab Completion for npm</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-config">npm-config</h1>
+<h1 id="----npm-config----1080">
+    <span>npm-config</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Manage the npm configuration files</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-dedupe">npm-dedupe</h1>
+<h1 id="----npm-dedupe----1080">
+    <span>npm-dedupe</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Reduce duplication in the package tree</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-deprecate">npm-deprecate</h1>
+<h1 id="----npm-deprecate----1080">
+    <span>npm-deprecate</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">Deprecate a version of a package</span>
 </header>
 

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

@@ -113,6 +113,11 @@
     line-height: 1;
 }
 
+header.title .version {
+    font-size: 0.8em;
+    color: #666666;
+}
+
 footer#edit {
     border-top: solid 1px #e1e4e8;
     margin: 3em 0 4em 0;
@@ -136,7 +141,10 @@
 
 <section id="content">
 <header class="title">
-<h1 id="npm-diff">npm-diff</h1>
+<h1 id="----npm-diff----1080">
+    <span>npm-diff</span>
+    <span class="version">@10.8.0</span>
+</h1>
 <span class="description">The registry diff command</span>
 </header>