deps: upgrade npm to 11.6.4

PR-URL: https://github.com/nodejs/node/pull/60853
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>

deps/npm/README.md

@@ -31,7 +31,6 @@ npm <command>
 * [**Documentation**](https://docs.npmjs.com/) - Official docs & how-tos for all things **npm**
     * Note: you can also search docs locally with `npm help-search <query>`
 * [**Bug Tracker**](https://github.com/npm/cli/issues) - Search or submit bugs against the CLI
-* [**Roadmap**](https://github.com/orgs/github/projects/4247/views/1?filterQuery=npm) - Track & follow along with our public roadmap
 * [**Community Feedback and Discussions**](https://github.com/orgs/community/discussions/categories/npm) - Contribute ideas & discussion around the npm registry, website & CLI
 * [**RFCs**](https://github.com/npm/rfcs) - Contribute ideas & specifications for the API/design of the npm CLI
 * [**Service Status**](https://status.npmjs.org/) - Monitor the current status & see incident reports for the website & registry

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

@@ -23,7 +23,7 @@ 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:
 
 ```bash
-npm@11.6.3 /path/to/npm
+npm@11.6.4 /path/to/npm
 └─┬ init-package-json@0.0.4
   └── promzard@0.1.5
 ```

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

@@ -14,7 +14,7 @@ Note: This command is unaware of workspaces.
 
 ### Version
 
-11.6.3
+11.6.4
 
 ### Description
 
@@ -64,7 +64,7 @@ In particular, npm has two modes of operation:
   npm installs packages into the current project directory, which defaults to the current working directory.
   Packages install to `./node_modules`, and bins to `./node_modules/.bin`.
 * global mode:
-  npm installs packages into the install prefix at `$npm_config_prefix/lib/node_modules` and bins to `$npm_config_prefix/bin`.
+  npm installs packages into the install prefix at `$NPM_CONFIG_PREFIX/lib/node_modules` and bins to `$NPM_CONFIG_PREFIX/bin`.
 
 Local mode is the default.
 Use `-g` or `--global` on any command to run in global mode instead.
@@ -98,8 +98,8 @@ It reads its configuration options from 5 places.
   All keys take a value, even if they are booleans (the config parser doesn't know what the options are at the time of parsing).
   If you do not provide a value (`--key`) then the option is set to boolean `true`.
 * Environment Variables:
-  Set any config by prefixing the name in an environment variable with `npm_config_`.
-  For example, `export npm_config_key=val`.
+  Set any config by prefixing the name in an environment variable with `NPM_CONFIG_`.
+  For example, `export NPM_CONFIG_KEY=val`.
 * User Configs:
   The file at `$HOME/.npmrc` is an ini-formatted list of configs.
   If present, it is parsed.

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

@@ -65,6 +65,16 @@ Put keywords in it.
 It's an array of strings.
 This helps people discover your package as it's listed in `npm search`.
 
+Example:
+
+```json
+"keywords": [
+  "node",
+  "javascript",
+  "npm"
+]
+```
+
 ### homepage
 
 The URL to the project homepage.

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

@@ -119,6 +119,12 @@ Package descriptors have the following fields:
 
 * bin, license, engines, dependencies, optionalDependencies: fields from `package.json`
 
+* os: An array of operating systems this package is compatible with, as specified in `package.json`. This field is included when the package specifies OS restrictions.
+
+* cpu: An array of CPU architectures this package is compatible with, as specified in `package.json`. This field is included when the package specifies CPU restrictions.
+
+* funding: Funding information for the package, as specified in `package.json`. This field contains details about how to support the package maintainers.
+
 #### dependencies
 
 Legacy data for supporting versions of npm that use `lockfileVersion: 1`.

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

@@ -31,6 +31,8 @@ For details see [this issue](https://github.com/npm/npm/issues/14528).
 
 Notice that you need to use underscores instead of dashes, so `--allow-same-version` would become `npm_config_allow_same_version=true`.
 
+**Important:** When defining custom configuration keys in `.npmrc` files, use hyphens instead of underscores (e.g., `custom-key=value`). This ensures they can be overridden by environment variables, since npm automatically converts underscores to hyphens when reading environment variables. Keys with underscores in `.npmrc` files cannot be overridden via environment variables.
+
 #### npmrc Files
 
 The four relevant files are:

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

@@ -43,7 +43,7 @@ These scripts happen in addition to the `pre<event>`, `post<event>`, and
 * Runs BEFORE the package is packed, i.e.
 during `npm publish` and `npm pack`
 * Runs on local `npm install` without any arguments
-* Runs AFTER `prepublish`, but BEFORE `prepublishOnly`
+* Runs AFTER `prepublishOnly` and `prepack`, but BEFORE `postpack`
 * Runs for a package if it's being installed as a link through `npm install <folder>`
 
 * NOTE: If a package being installed through git contains a `prepare` script, its `dependencies` and `devDependencies` will be installed, and the prepare script will be run, before the package is packaged and installed.
@@ -333,7 +333,7 @@ They just have to be some kind of executable file.
 Read through [`package.json`](/configuring-npm/package-json) to see all the things that you can specify and enable by simply describing your package appropriately.
 In general, this will lead to a more robust and consistent state.
 * Inspect the env to determine where to put things.
-For instance, if the `npm_config_binroot` environment variable is set to `/home/user/bin`, then don't try to install executables into `/usr/local/bin`.
+For instance, if the `NPM_CONFIG_BINROOT` environment variable is set to `/home/user/bin`, then don't try to install executables into `/usr/local/bin`.
 The user probably set it up that way for a reason.
 * Don't prefix your script commands with "sudo".  If root permissions are required for some reason, then it'll fail with that error, and the user will sudo the npm command in question.
 * Don't use `install`.

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

@@ -86,6 +86,26 @@ If you want to add a dependency named `abbrev` from the registry as a dependency
 npm install abbrev -w a
 ```
 
+**Adding a workspace as a dependency of another workspace:**
+
+If you want to add workspace **b** as a dependency of workspace **a**, you can use the workspace protocol in the dependency specifier:
+
+```
+npm install b@workspace:* -w a
+```
+
+This will add an entry to workspace **a**'s `package.json` like:
+
+```json
+{
+  "dependencies": {
+    "b": "workspace:*"
+  }
+}
+```
+
+The `workspace:` protocol tells npm to link to the local workspace rather than fetching from the registry. The `*` version means it will use whatever version is defined in workspace **b**'s `package.json`.
+
 Note: other installing commands such as `uninstall`, `ci`, etc will also respect the provided `workspace` configuration.
 
 ### Using workspaces

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-access----1163">
+<h1 id="----npm-access----1164">
     <span>npm-access</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Set access level on published packages</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-adduser----1163">
+<h1 id="----npm-adduser----1164">
     <span>npm-adduser</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Add a registry user account</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-audit----1163">
+<h1 id="----npm-audit----1164">
     <span>npm-audit</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Run a security audit</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-bugs----1163">
+<h1 id="----npm-bugs----1164">
     <span>npm-bugs</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Report bugs for a package in a web browser</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-cache----1163">
+<h1 id="----npm-cache----1164">
     <span>npm-cache</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Manipulates packages cache</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-ci----1163">
+<h1 id="----npm-ci----1164">
     <span>npm-ci</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Clean install a project</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-completion----1163">
+<h1 id="----npm-completion----1164">
     <span>npm-completion</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Tab Completion for npm</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-config----1163">
+<h1 id="----npm-config----1164">
     <span>npm-config</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Manage the npm configuration files</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-dedupe----1163">
+<h1 id="----npm-dedupe----1164">
     <span>npm-dedupe</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Reduce duplication in the package tree</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-deprecate----1163">
+<h1 id="----npm-deprecate----1164">
     <span>npm-deprecate</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Deprecate a version of a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-diff----1163">
+<h1 id="----npm-diff----1164">
     <span>npm-diff</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">The registry diff command</span>
 </header>

deps/npm/docs/output/commands/npm-dist-tag.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-dist-tag----1163">
+<h1 id="----npm-dist-tag----1164">
     <span>npm-dist-tag</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Modify package distribution tags</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-docs----1163">
+<h1 id="----npm-docs----1164">
     <span>npm-docs</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Open documentation for a package in a web browser</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-doctor----1163">
+<h1 id="----npm-doctor----1164">
     <span>npm-doctor</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Check the health of your npm environment</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-edit----1163">
+<h1 id="----npm-edit----1164">
     <span>npm-edit</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Edit an installed package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-exec----1163">
+<h1 id="----npm-exec----1164">
     <span>npm-exec</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Run a command from a local or remote npm package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-explain----1163">
+<h1 id="----npm-explain----1164">
     <span>npm-explain</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Explain installed packages</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-explore----1163">
+<h1 id="----npm-explore----1164">
     <span>npm-explore</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Browse an installed package</span>
 </header>

deps/npm/docs/output/commands/npm-find-dupes.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-find-dupes----1163">
+<h1 id="----npm-find-dupes----1164">
     <span>npm-find-dupes</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Find duplication in the package tree</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-fund----1163">
+<h1 id="----npm-fund----1164">
     <span>npm-fund</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Retrieve funding information</span>
 </header>

deps/npm/docs/output/commands/npm-help-search.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-help-search----1163">
+<h1 id="----npm-help-search----1164">
     <span>npm-help-search</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Search npm help documentation</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-help----1163">
+<h1 id="----npm-help----1164">
     <span>npm-help</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Get help on npm</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-init----1163">
+<h1 id="----npm-init----1164">
     <span>npm-init</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Create a package.json file</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-install-ci-test----1163">
+<h1 id="----npm-install-ci-test----1164">
     <span>npm-install-ci-test</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Install a project with a clean slate and run tests</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-install-test----1163">
+<h1 id="----npm-install-test----1164">
     <span>npm-install-test</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Install package(s) and run tests</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-install----1163">
+<h1 id="----npm-install----1164">
     <span>npm-install</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Install a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-link----1163">
+<h1 id="----npm-link----1164">
     <span>npm-link</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Symlink a package folder</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-login----1163">
+<h1 id="----npm-login----1164">
     <span>npm-login</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Login to a registry user account</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-logout----1163">
+<h1 id="----npm-logout----1164">
     <span>npm-logout</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Log out of the registry</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-ls----1163">
+<h1 id="----npm-ls----1164">
     <span>npm-ls</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">List installed packages</span>
 </header>
@@ -164,7 +164,7 @@ alias: list
 <p>Positional arguments are <code>name@version-range</code> identifiers, which will limit 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><code class="language-bash">npm@11.6.3 /path/to/npm
+<pre><code class="language-bash">npm@11.6.4 /path/to/npm
 └─┬ init-package-json@0.0.4
   └── promzard@0.1.5
 </code></pre>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-org----1163">
+<h1 id="----npm-org----1164">
     <span>npm-org</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Manage orgs</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-outdated----1163">
+<h1 id="----npm-outdated----1164">
     <span>npm-outdated</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Check for outdated packages</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-owner----1163">
+<h1 id="----npm-owner----1164">
     <span>npm-owner</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Manage package owners</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-pack----1163">
+<h1 id="----npm-pack----1164">
     <span>npm-pack</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Create a tarball from a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-ping----1163">
+<h1 id="----npm-ping----1164">
     <span>npm-ping</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Ping npm registry</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-pkg----1163">
+<h1 id="----npm-pkg----1164">
     <span>npm-pkg</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Manages your package.json</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-prefix----1163">
+<h1 id="----npm-prefix----1164">
     <span>npm-prefix</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Display prefix</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-profile----1163">
+<h1 id="----npm-profile----1164">
     <span>npm-profile</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Change settings on your registry profile</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-prune----1163">
+<h1 id="----npm-prune----1164">
     <span>npm-prune</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Remove extraneous packages</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-publish----1163">
+<h1 id="----npm-publish----1164">
     <span>npm-publish</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Publish a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-query----1163">
+<h1 id="----npm-query----1164">
     <span>npm-query</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Dependency selector query</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-rebuild----1163">
+<h1 id="----npm-rebuild----1164">
     <span>npm-rebuild</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Rebuild a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-repo----1163">
+<h1 id="----npm-repo----1164">
     <span>npm-repo</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Open package repository page in the browser</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-restart----1163">
+<h1 id="----npm-restart----1164">
     <span>npm-restart</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Restart a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-root----1163">
+<h1 id="----npm-root----1164">
     <span>npm-root</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Display npm root</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-run----1163">
+<h1 id="----npm-run----1164">
     <span>npm-run</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Run arbitrary package scripts</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-sbom----1163">
+<h1 id="----npm-sbom----1164">
     <span>npm-sbom</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Generate a Software Bill of Materials (SBOM)</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-search----1163">
+<h1 id="----npm-search----1164">
     <span>npm-search</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Search for packages</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-shrinkwrap----1163">
+<h1 id="----npm-shrinkwrap----1164">
     <span>npm-shrinkwrap</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Lock down dependency versions for publication</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-star----1163">
+<h1 id="----npm-star----1164">
     <span>npm-star</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Mark your favorite packages</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-stars----1163">
+<h1 id="----npm-stars----1164">
     <span>npm-stars</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">View packages marked as favorites</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-start----1163">
+<h1 id="----npm-start----1164">
     <span>npm-start</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Start a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-stop----1163">
+<h1 id="----npm-stop----1164">
     <span>npm-stop</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Stop a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-team----1163">
+<h1 id="----npm-team----1164">
     <span>npm-team</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Manage organization teams and team memberships</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-test----1163">
+<h1 id="----npm-test----1164">
     <span>npm-test</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Test a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-token----1163">
+<h1 id="----npm-token----1164">
     <span>npm-token</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Manage your authentication tokens</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-undeprecate----1163">
+<h1 id="----npm-undeprecate----1164">
     <span>npm-undeprecate</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Undeprecate a version of a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-uninstall----1163">
+<h1 id="----npm-uninstall----1164">
     <span>npm-uninstall</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Remove a package</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-unpublish----1163">
+<h1 id="----npm-unpublish----1164">
     <span>npm-unpublish</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Remove a package from the registry</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-unstar----1163">
+<h1 id="----npm-unstar----1164">
     <span>npm-unstar</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Remove an item from your favorite packages</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-update----1163">
+<h1 id="----npm-update----1164">
     <span>npm-update</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Update packages</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-version----1163">
+<h1 id="----npm-version----1164">
     <span>npm-version</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Bump a package version</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-view----1163">
+<h1 id="----npm-view----1164">
     <span>npm-view</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">View registry info</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-whoami----1163">
+<h1 id="----npm-whoami----1164">
     <span>npm-whoami</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Display npm username</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm----1163">
+<h1 id="----npm----1164">
     <span>npm</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">javascript package manager</span>
 </header>
@@ -158,7 +158,7 @@ npm command-line interface
 </code></pre>
 <p>Note: This command is unaware of workspaces.</p>
 <h3 id="version">Version</h3>
-<p>11.6.3</p>
+<p>11.6.4</p>
 <h3 id="description">Description</h3>
 <p>npm is the package manager for the Node JavaScript platform.
 It puts modules in place so that node can find them, and manages dependency conflicts intelligently.</p>
@@ -190,7 +190,7 @@ For more information visit <a href="https://github.com/nodejs/node-gyp">the node
 npm installs packages into the current project directory, which defaults to the current working directory.
 Packages install to <code>./node_modules</code>, and bins to <code>./node_modules/.bin</code>.</li>
 <li>global mode:
-npm installs packages into the install prefix at <code>$npm_config_prefix/lib/node_modules</code> and bins to <code>$npm_config_prefix/bin</code>.</li>
+npm installs packages into the install prefix at <code>$NPM_CONFIG_PREFIX/lib/node_modules</code> and bins to <code>$NPM_CONFIG_PREFIX/bin</code>.</li>
 </ul>
 <p>Local mode is the default.
 Use <code>-g</code> or <code>--global</code> on any command to run in global mode instead.</p>
@@ -221,8 +221,8 @@ Set a config with <code>--key val</code>.
 All keys take a value, even if they are booleans (the config parser doesn't know what the options are at the time of parsing).
 If you do not provide a value (<code>--key</code>) then the option is set to boolean <code>true</code>.</li>
 <li>Environment Variables:
-Set any config by prefixing the name in an environment variable with <code>npm_config_</code>.
-For example, <code>export npm_config_key=val</code>.</li>
+Set any config by prefixing the name in an environment variable with <code>NPM_CONFIG_</code>.
+For example, <code>export NPM_CONFIG_KEY=val</code>.</li>
 <li>User Configs:
 The file at <code>$HOME/.npmrc</code> is an ini-formatted list of configs.
 If present, it is parsed.

deps/npm/docs/output/commands/npx.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npx----1163">
+<h1 id="----npx----1164">
     <span>npx</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Run a command from a local or remote npm package</span>
 </header>

deps/npm/docs/output/configuring-npm/folders.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----folders----1163">
+<h1 id="----folders----1164">
     <span>folders</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Folder Structures Used by npm</span>
 </header>

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----install----1163">
+<h1 id="----install----1164">
     <span>install</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Download and install node and npm</span>
 </header>

deps/npm/docs/output/configuring-npm/npm-global.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----folders----1163">
+<h1 id="----folders----1164">
     <span>folders</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Folder Structures Used by npm</span>
 </header>

deps/npm/docs/output/configuring-npm/npm-json.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----packagejson----1163">
+<h1 id="----packagejson----1164">
     <span>package.json</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Specifics of npm's package.json handling</span>
 </header>
@@ -200,6 +200,13 @@ This helps people discover your package, as it's listed in <code>npm search</cod
 <p>Put keywords in it.
 It's an array of strings.
 This helps people discover your package as it's listed in <code>npm search</code>.</p>
+<p>Example:</p>
+<pre><code class="language-json">"keywords": [
+  "node",
+  "javascript",
+  "npm"
+]
+</code></pre>
 <h3 id="homepage">homepage</h3>
 <p>The URL to the project homepage.</p>
 <p>Example:</p>

deps/npm/docs/output/configuring-npm/npm-shrinkwrap-json.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npm-shrinkwrapjson----1163">
+<h1 id="----npm-shrinkwrapjson----1164">
     <span>npm-shrinkwrap.json</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">A publishable lockfile</span>
 </header>

deps/npm/docs/output/configuring-npm/npmrc.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----npmrc----1163">
+<h1 id="----npmrc----1164">
     <span>npmrc</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">The npm config files</span>
 </header>

deps/npm/docs/output/configuring-npm/package-json.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----packagejson----1163">
+<h1 id="----packagejson----1164">
     <span>package.json</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Specifics of npm's package.json handling</span>
 </header>
@@ -200,6 +200,13 @@ This helps people discover your package, as it's listed in <code>npm search</cod
 <p>Put keywords in it.
 It's an array of strings.
 This helps people discover your package as it's listed in <code>npm search</code>.</p>
+<p>Example:</p>
+<pre><code class="language-json">"keywords": [
+  "node",
+  "javascript",
+  "npm"
+]
+</code></pre>
 <h3 id="homepage">homepage</h3>
 <p>The URL to the project homepage.</p>
 <p>Example:</p>

deps/npm/docs/output/configuring-npm/package-lock-json.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----package-lockjson----1163">
+<h1 id="----package-lockjson----1164">
     <span>package-lock.json</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">A manifestation of the manifest</span>
 </header>
@@ -258,6 +258,15 @@ If it is both a <code>dev</code> dependency <em>and</em> an <code>optional</code
 <li>
 <p>bin, license, engines, dependencies, optionalDependencies: fields from <code>package.json</code></p>
 </li>
+<li>
+<p>os: An array of operating systems this package is compatible with, as specified in <code>package.json</code>. This field is included when the package specifies OS restrictions.</p>
+</li>
+<li>
+<p>cpu: An array of CPU architectures this package is compatible with, as specified in <code>package.json</code>. This field is included when the package specifies CPU restrictions.</p>
+</li>
+<li>
+<p>funding: Funding information for the package, as specified in <code>package.json</code>. This field contains details about how to support the package maintainers.</p>
+</li>
 </ul>
 <h4 id="dependencies">dependencies</h4>
 <p>Legacy data for supporting versions of npm that use <code>lockfileVersion: 1</code>.

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

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----config----1163">
+<h1 id="----config----1164">
     <span>config</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">More than you probably want to know about npm configuration</span>
 </header>
@@ -171,6 +171,7 @@ Config values are case-insensitive, so <code>NPM_CONFIG_FOO=bar</code> will work
 However, please note that inside <a href="../using-npm/scripts.html"><code>scripts</code></a> npm will set its own environment variables and Node will prefer those lowercase versions over any uppercase ones that you might set.
 For details see <a href="https://github.com/npm/npm/issues/14528">this issue</a>.</p>
 <p>Notice that you need to use underscores instead of dashes, so <code>--allow-same-version</code> would become <code>npm_config_allow_same_version=true</code>.</p>
+<p><strong>Important:</strong> When defining custom configuration keys in <code>.npmrc</code> files, use hyphens instead of underscores (e.g., <code>custom-key=value</code>). This ensures they can be overridden by environment variables, since npm automatically converts underscores to hyphens when reading environment variables. Keys with underscores in <code>.npmrc</code> files cannot be overridden via environment variables.</p>
 <h4 id="npmrc-files">npmrc Files</h4>
 <p>The four relevant files are:</p>
 <ul>

deps/npm/docs/output/using-npm/dependency-selectors.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----dependency-selector-syntax--querying----1163">
+<h1 id="----dependency-selector-syntax--querying----1164">
     <span>Dependency Selector Syntax &amp; Querying</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Dependency Selector Syntax &amp; Querying</span>
 </header>

deps/npm/docs/output/using-npm/developers.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----developers----1163">
+<h1 id="----developers----1164">
     <span>developers</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Developer Guide</span>
 </header>

deps/npm/docs/output/using-npm/logging.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----logging----1163">
+<h1 id="----logging----1164">
     <span>Logging</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Why, What &amp; How We Log</span>
 </header>

deps/npm/docs/output/using-npm/orgs.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----orgs----1163">
+<h1 id="----orgs----1164">
     <span>orgs</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Working with Teams &amp; Orgs</span>
 </header>

deps/npm/docs/output/using-npm/package-spec.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----package-spec----1163">
+<h1 id="----package-spec----1164">
     <span>package-spec</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Package name specifier</span>
 </header>

deps/npm/docs/output/using-npm/registry.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----registry----1163">
+<h1 id="----registry----1164">
     <span>registry</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">The JavaScript Package Registry</span>
 </header>

deps/npm/docs/output/using-npm/removal.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----removal----1163">
+<h1 id="----removal----1164">
     <span>removal</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Cleaning the Slate</span>
 </header>

deps/npm/docs/output/using-npm/scope.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----scope----1163">
+<h1 id="----scope----1164">
     <span>scope</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Scoped packages</span>
 </header>

deps/npm/docs/output/using-npm/scripts.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----scripts----1163">
+<h1 id="----scripts----1164">
     <span>scripts</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">How npm handles the "scripts" field</span>
 </header>
@@ -190,7 +190,7 @@ during <code>npm publish</code> and <code>npm pack</code></p>
 <p>Runs on local <code>npm install</code> without any arguments</p>
 </li>
 <li>
-<p>Runs AFTER <code>prepublish</code>, but BEFORE <code>prepublishOnly</code></p>
+<p>Runs AFTER <code>prepublishOnly</code> and <code>prepack</code>, but BEFORE <code>postpack</code></p>
 </li>
 <li>
 <p>Runs for a package if it's being installed as a link through <code>npm install &lt;folder&gt;</code></p>
@@ -438,7 +438,7 @@ If the failure is minor or only will prevent some optional features, then it's b
 Read through <a href="../configuring-npm/package-json.html"><code>package.json</code></a> to see all the things that you can specify and enable by simply describing your package appropriately.
 In general, this will lead to a more robust and consistent state.</li>
 <li>Inspect the env to determine where to put things.
-For instance, if the <code>npm_config_binroot</code> environment variable is set to <code>/home/user/bin</code>, then don't try to install executables into <code>/usr/local/bin</code>.
+For instance, if the <code>NPM_CONFIG_BINROOT</code> environment variable is set to <code>/home/user/bin</code>, then don't try to install executables into <code>/usr/local/bin</code>.
 The user probably set it up that way for a reason.</li>
 <li>Don't prefix your script commands with "sudo".  If root permissions are required for some reason, then it'll fail with that error, and the user will sudo the npm command in question.</li>
 <li>Don't use <code>install</code>.

deps/npm/docs/output/using-npm/workspaces.html

@@ -141,9 +141,9 @@ npm command-line interface
 
 <section id="content">
 <header class="title">
-<h1 id="----workspaces----1163">
+<h1 id="----workspaces----1164">
     <span>workspaces</span>
-    <span class="version">@11.6.3</span>
+    <span class="version">@11.6.4</span>
 </h1>
 <span class="description">Working with workspaces</span>
 </header>
@@ -207,6 +207,18 @@ For example in a project that already has a <code>package.json</code> defined yo
 <p>If you want to add a dependency named <code>abbrev</code> from the registry as a dependency of your workspace <strong>a</strong>, you may use the workspace config to tell the npm installer that package should be added as a dependency of the provided workspace:</p>
 <pre><code>npm install abbrev -w a
 </code></pre>
+<p><strong>Adding a workspace as a dependency of another workspace:</strong></p>
+<p>If you want to add workspace <strong>b</strong> as a dependency of workspace <strong>a</strong>, you can use the workspace protocol in the dependency specifier:</p>
+<pre><code>npm install b@workspace:* -w a
+</code></pre>
+<p>This will add an entry to workspace <strong>a</strong>'s <code>package.json</code> like:</p>
+<pre><code class="language-json">{
+  "dependencies": {
+    "b": "workspace:*"
+  }
+}
+</code></pre>
+<p>The <code>workspace:</code> protocol tells npm to link to the local workspace rather than fetching from the registry. The <code>*</code> version means it will use whatever version is defined in workspace <strong>b</strong>'s <code>package.json</code>.</p>
 <p>Note: other installing commands such as <code>uninstall</code>, <code>ci</code>, etc will also respect the provided <code>workspace</code> configuration.</p>
 <h3 id="using-workspaces">Using workspaces</h3>
 <p>Given the <a href="https://nodejs.org/dist/latest-v14.x/docs/api/modules.html#modules_all_together">specifics of how Node.js handles module resolution</a> it's possible to consume any defined workspace by its declared <code>package.json</code> <code>name</code>.

deps/npm/man/man1/npm-access.1

@@ -1,4 +1,4 @@
-.TH "NPM-ACCESS" "1" "November 2025" "NPM@11.6.3" ""
+.TH "NPM-ACCESS" "1" "November 2025" "NPM@11.6.4" ""
 .SH "NAME"
 \fBnpm-access\fR - Set access level on published packages
 .SS "Synopsis"

deps/npm/man/man1/npm-adduser.1

@@ -1,4 +1,4 @@
-.TH "NPM-ADDUSER" "1" "November 2025" "NPM@11.6.3" ""
+.TH "NPM-ADDUSER" "1" "November 2025" "NPM@11.6.4" ""
 .SH "NAME"
 \fBnpm-adduser\fR - Add a registry user account
 .SS "Synopsis"

deps/npm/man/man1/npm-audit.1

@@ -1,4 +1,4 @@
-.TH "NPM-AUDIT" "1" "November 2025" "NPM@11.6.3" ""
+.TH "NPM-AUDIT" "1" "November 2025" "NPM@11.6.4" ""
 .SH "NAME"
 \fBnpm-audit\fR - Run a security audit
 .SS "Synopsis"

deps/npm/man/man1/npm-bugs.1

@@ -1,4 +1,4 @@
-.TH "NPM-BUGS" "1" "November 2025" "NPM@11.6.3" ""
+.TH "NPM-BUGS" "1" "November 2025" "NPM@11.6.4" ""
 .SH "NAME"
 \fBnpm-bugs\fR - Report bugs for a package in a web browser
 .SS "Synopsis"

deps/npm/man/man1/npm-cache.1

@@ -1,4 +1,4 @@
-.TH "NPM-CACHE" "1" "November 2025" "NPM@11.6.3" ""
+.TH "NPM-CACHE" "1" "November 2025" "NPM@11.6.4" ""
 .SH "NAME"
 \fBnpm-cache\fR - Manipulates packages cache
 .SS "Synopsis"

deps/npm/man/man1/npm-ci.1

@@ -1,4 +1,4 @@
-.TH "NPM-CI" "1" "November 2025" "NPM@11.6.3" ""
+.TH "NPM-CI" "1" "November 2025" "NPM@11.6.4" ""
 .SH "NAME"
 \fBnpm-ci\fR - Clean install a project
 .SS "Synopsis"

deps/npm/man/man1/npm-completion.1

@@ -1,4 +1,4 @@
-.TH "NPM-COMPLETION" "1" "November 2025" "NPM@11.6.3" ""
+.TH "NPM-COMPLETION" "1" "November 2025" "NPM@11.6.4" ""
 .SH "NAME"
 \fBnpm-completion\fR - Tab Completion for npm
 .SS "Synopsis"