git: 9bf095fffe - main - [phb][Uses]: Add npm

The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/doc/commit/?id=9bf095fffe66d74555595b2915f9f46d49609a13

commit 9bf095fffe66d74555595b2915f9f46d49609a13
Author:     Fernando Apesteguía <fernape@FreeBSD.org>
AuthorDate: 2026-07-10 18:03:20 +0000
Commit:     Fernando Apesteguía <fernape@FreeBSD.org>
CommitDate: 2026-07-10 18:03:20 +0000

    [phb][Uses]: Add npm
    
    Following
    https://cgit.freebsd.org/ports/commit/?id=ed6a84c1c9793271c9cf948458808b47b2622d21
---
 .../en/books/porters-handbook/uses/_index.adoc     | 36 ++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc
index 2bc70fab43..e30285d720 100644
--- a/documentation/content/en/books/porters-handbook/uses/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc
@@ -1954,6 +1954,42 @@ specified then `run` and/or `build` must be specified too.
 The `env` argument sets the environment variables `NODEJS_VERSION` and `NODEJS_SUFFIX`.
 Currently `lts` is an alias for 24 and `current` is an alias for 26.
 
+[[uses-npm]]
+== `npm`
+
+Possible arguments: `<npm-name>`, `fetch`, `extract`, `build`, `run`, `test`
+
+`<npm-name>` can take the following values:
+
+`npm`::
+The port uses NPM as package manager.
+
+`yarn1`::
+The port uses Yarn (v1) as package manager.
+
+`yarn2`::
+The port uses Yarn (v2 or v3) as package manager.
+
+`yarn4`::
+The port uses Yarn (v4+) as package manager.
+
+`pnpm`::
+The port uses PNPM as package manager.
+
+The following variables can be set by the port:
+
+`NPM_VER`::
+A version of node package manager the port uses.
+
+`NPM_PREFETCH`::
+Downloads node modules the port uses according to the pre-stored
+[.filename]#package.json# (and [.filename]#package-lock.json#,
+[.filename]#yarn.lock#, or [.filename]#pnpm-lock.yaml# depending
+on the node package manager used) in `PKGJSONSDIR`. 
+
+`NPM_EXTRACT`::
+Installs the prefetched node modules into the port's working source directory.
+
 [[uses-objc]]
 == `objc`