v18.1.0 release proposal

.github/workflows/linters.yml

@@ -70,15 +70,19 @@ jobs:
       - name: Format C/C++ files
         run: |
           make format-cpp-build
+          # The `make format-cpp` error code is intentionally ignored here
+          # because it is irrelevant. We already check if the formatter produced
+          # a diff in the next line.
+          # Refs: https://github.com/nodejs/node/pull/42764
           CLANG_FORMAT_START="$(git merge-base HEAD refs/remotes/origin/$GITHUB_BASE_REF)" \
-            make format-cpp
+            make format-cpp || true
           git --no-pager diff --exit-code && EXIT_CODE="$?" || EXIT_CODE="$?"
           if [ "$EXIT_CODE" != "0" ]
           then
             echo
             echo 'ERROR: Please run:'
             echo
-            echo '  CLANG_FORMAT_START="$(git merge-base HEAD <target-branch-name>)" make format-cpp'
+            echo "  CLANG_FORMAT_START="$\(git merge-base HEAD ${GITHUB_BASE_REF}\)" make format-cpp"
             echo
             echo 'to format the commits in your branch.'
             exit "$EXIT_CODE"

.mailmap

@@ -50,6 +50,7 @@ Ashley Maceli <[email protected]>
 Ashok Suthar <[email protected]>
 Ashutosh Kumar Singh <[email protected]>
 Atsuo Fukaya <[email protected]>
+Austin Kelleher <[email protected]> <[email protected]>
 Azard <[email protected]> <[email protected]>
 Ben Lugavere <[email protected]>
 Ben Noordhuis <[email protected]> <[email protected]>
@@ -82,6 +83,7 @@ Brian White <[email protected]> <[email protected]>
 Caleb Boyd <[email protected]>
 Calvin Metcalf <[email protected]> <[email protected]>
 Calvin Metcalf <[email protected]> <[email protected]>
+Camillo Bruni <[email protected]> <[email protected]>
 Caralyn Reisle <[email protected]>
 Charles <[email protected]> <[email protected]>
 Charles Rudolph <[email protected]>
@@ -372,6 +374,8 @@ Nils Kuhnhenn <[email protected]>
 Nitzan Uziely <[email protected]> <[email protected]>
 Nitzan Uziely <[email protected]> <[email protected]>
 Noah Rose Ledesma <[email protected]>
+npm team <[email protected]>
+npm team <[email protected]> <npm team>
 Oliver Chang <[email protected]>
 Oluwaseun Omoyajowo <[email protected]>
 Onne Gorter <[email protected]>

AUTHORS

@@ -2310,7 +2310,7 @@ Dzmitry_Prudnikau <[email protected]>
 Ian McKellar <[email protected]>
 Jennifer Bland <[email protected]>
 Kyle Fuller <[email protected]>
-Camillo Bruni <[email protected]>
+Camillo Bruni <[email protected]>
 Yongsheng Zhang <[email protected]>
 Neeraj Laad <[email protected]>
 Scott Van Gilder <[email protected]>
@@ -3288,7 +3288,7 @@ pengjie <[email protected]>
 Philip <[email protected]>
 julianjany <[email protected]>
 bl-ue <[email protected]>
-npm-robot <[email protected]>
+npm team <[email protected]>
 Shaun Keys <[email protected]>
 Simone Busoli <[email protected]>
 Derevianchenko Maksym <[email protected]>
@@ -3430,7 +3430,7 @@ Derek Wolpert <[email protected]>
 wbt <[email protected]>
 Alexandru Comanescu <[email protected]>
 madflow <[email protected]>
-Austin Kelleher <austin.kell47@gmail.com>
+Austin Kelleher <austinlkelleher@gmail.com>
 apeltop <[email protected]>
 Livia Medeiros <[email protected]>
 Nikolaos Papaspyrou <[email protected]>
@@ -3452,5 +3452,7 @@ Daeyeon Jeong <[email protected]>
 Daniel Roe <[email protected]>
 Niyas Sait <[email protected]>
 K.C.Ashish Kumar <[email protected]>
+Niklas Mischkulnig <[email protected]>
+Liviu Ionescu <[email protected]>
 
 # Generated by tools/update-authors.js

BUILDING.md

@@ -323,13 +323,14 @@ You can execute the entire suite of tests for a given subsystem
 by providing the name of a subsystem:
 
 ```text
-$ tools/test.py -J child-process
+$ tools/test.py child-process
 ```
 
-You can also execute the tests in a tests directory (such as `test/message`):
+You can also execute the tests in a test suite directory
+(such as `test/message`):
 
 ```text
-$ tools/test.py -J test/message
+$ tools/test.py test/message
 ```
 
 If you want to check the other options, please refer to the help by using

CHANGELOG.md

@@ -35,7 +35,8 @@ release.
 </tr>
 <tr>
   <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V18.md#18.0.0">18.0.0</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V18.md#18.1.0">18.1.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V18.md#18.0.0">18.0.0</a><br/>
   </td>
   <td valign="top">
 <b><a href="doc/changelogs/CHANGELOG_V17.md#17.8.0">17.8.0</a></b><br/>

README.md

@@ -180,8 +180,6 @@ For information about the governance of the Node.js project, see
   **Matteo Collina** <<[email protected]>> (he/him)
 * [mhdawson](https://github.com/mhdawson) -
   **Michael Dawson** <<[email protected]>> (he/him)
-* [mmarchini](https://github.com/mmarchini) -
-  **Mary Marchini** <<[email protected]>> (she/her)
 * [MylesBorins](https://github.com/MylesBorins) -
   **Myles Borins** <<[email protected]>> (he/him)
 * [RaisinTen](https://github.com/RaisinTen) -
@@ -227,6 +225,8 @@ For information about the governance of the Node.js project, see
   **Isaac Z. Schlueter** <<[email protected]>>
 * [joshgav](https://github.com/joshgav) -
   **Josh Gavant** <<[email protected]>>
+* [mmarchini](https://github.com/mmarchini) -
+  **Mary Marchini** <<[email protected]>> (she/her)
 * [mscdex](https://github.com/mscdex) -
   **Brian White** <<[email protected]>>
 * [nebrius](https://github.com/nebrius) -
@@ -262,8 +262,6 @@ For information about the governance of the Node.js project, see
   **Anna Henningsen** <<[email protected]>> (she/her)
 * [aduh95](https://github.com/aduh95) -
   **Antoine du Hamel** <<[email protected]>> (he/him)
-* [ak239](https://github.com/ak239) -
-  **Aleksei Koziatinskii** <<[email protected]>>
 * [antsmartian](https://github.com/antsmartian) -
   **Anto Aravinth** <<[email protected]>> (he/him)
 * [apapirovski](https://github.com/apapirovski) -
@@ -354,6 +352,8 @@ For information about the governance of the Node.js project, see
   **Juan José Arboleda** <<[email protected]>> (he/him)
 * [JungMinu](https://github.com/JungMinu) -
   **Minwoo Jung** <<[email protected]>> (he/him)
+* [kuriyosh](https://github.com/kuriyosh) -
+  **Yoshiki Kurihara** <<[email protected]>> (he/him)
 * [legendecas](https://github.com/legendecas) -
   **Chengzhong Wu** <<[email protected]>> (he/him)
 * [Leko](https://github.com/Leko) -
@@ -380,8 +380,6 @@ For information about the governance of the Node.js project, see
   **Milad Fa** <<[email protected]>> (he/him)
 * [mildsunrise](https://github.com/mildsunrise) -
   **Alba Mendez** <<[email protected]>> (she/her)
-* [mmarchini](https://github.com/mmarchini) -
-  **Mary Marchini** <<[email protected]>> (she/her)
 * [mscdex](https://github.com/mscdex) -
   **Brian White** <<[email protected]>>
 * [MylesBorins](https://github.com/MylesBorins) -
@@ -460,6 +458,8 @@ For information about the governance of the Node.js project, see
 
 ### Collaborator emeriti
 
+* [ak239](https://github.com/ak239) -
+  **Aleksei Koziatinskii** <<[email protected]>>
 * [andrasq](https://github.com/andrasq) -
   **Andras** <<[email protected]>>
 * [AnnaMag](https://github.com/AnnaMag) -
@@ -552,6 +552,8 @@ For information about the governance of the Node.js project, see
   **Mikeal Rogers** <<[email protected]>>
 * [misterdjules](https://github.com/misterdjules) -
   **Julien Gilli** <<[email protected]>>
+* [mmarchini](https://github.com/mmarchini) -
+  **Mary Marchini** <<[email protected]>> (she/her)
 * [monsanto](https://github.com/monsanto) -
   **Christopher Monsanto** <<[email protected]>>
 * [MoonBall](https://github.com/MoonBall) -

benchmark/fixtures/require-cachable.js

@@ -6,5 +6,5 @@ const {
 } = internalBinding('native_module');
 
 for (const key of canBeRequired) {
-  require(key);
+  require(`node:${key}`);
 }

configure.py

@@ -1458,6 +1458,7 @@ def configure_v8(o):
   o['variables']['v8_use_siphash'] = 0 if options.without_siphash else 1
   o['variables']['v8_enable_pointer_compression'] = 1 if options.enable_pointer_compression else 0
   o['variables']['v8_enable_31bit_smis_on_64bit_arch'] = 1 if options.enable_pointer_compression else 0
+  o['variables']['v8_enable_shared_ro_heap'] = 0 if options.enable_pointer_compression else 1
   o['variables']['v8_trace_maps'] = 1 if options.trace_maps else 0
   o['variables']['node_use_v8_platform'] = b(not options.without_v8_platform)
   o['variables']['node_use_bundled_v8'] = b(not options.without_bundled_v8)

deps/npm/README.md

@@ -1,7 +1,10 @@
-[![GitHub Workflow Status (branch)](https://img.shields.io/github/workflow/status/npm/cli/Node%20CI/latest)](https://github.com/npm/cli/actions?query=workflow%3A%22Node+CI%22+branch%3Alatest) [![Coveralls github branch](https://img.shields.io/coveralls/github/npm/cli/latest)](https://coveralls.io/github/npm/cli?branch=latest)
-
 # npm - a JavaScript package manager
 
+[![npm version](https://img.shields.io/npm/v/npm.svg)](https://npm.im/npm)
+[![license](https://img.shields.io/npm/l/npm.svg)](https://npm.im/npm)
+[![CI - cli](https://github.com/npm/cli/actions/workflows/ci.yml/badge.svg)](https://github.com/npm/cli/actions/workflows/ci.yml)
+[![Benchmark Suite](https://github.com/npm/cli/actions/workflows/benchmark.yml/badge.svg)](https://github.com/npm/cli/actions/workflows/benchmark.yml)
+
 ### Requirements
 
 One of the following versions of [Node.js](https://nodejs.org/en/download/) must be installed to run **`npm`**:

deps/npm/bin/npx

@@ -12,6 +12,9 @@ case `uname` in
 esac
 
 NODE_EXE="$basedir/node.exe"
+if ! [ -x "$NODE_EXE" ]; then
+  NODE_EXE="$basedir/node"
+fi
 if ! [ -x "$NODE_EXE" ]; then
   NODE_EXE=node
 fi

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

@@ -394,6 +394,20 @@ When false, specifying individual workspaces via the `workspace` config, or
 all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
+This value is not exported to the environment for child processes.
+
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/utils/config/definitions.js -->
+
+#### `install-links`
+
+* Default: false
+* Type: Boolean
+
+When set file: protocol dependencies that exist outside of the project root
+will be packed and installed as regular dependencies instead of creating a
+symlink. This option has no effect on workspaces.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

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

@@ -46,6 +46,14 @@ In short, the main differences between using `npm install` and `npm ci` are:
 * It will never write to `package.json` or any of the package-locks:
   installs are essentially frozen.
 
+NOTE: If you create your `package-lock.json` file by running `npm install`
+with flags that can affect the shape of your dependency tree, such as
+`--legacy-peer-deps` or `--install-links`, you _must_ provide the same
+flags to `npm ci` or you are likely to encounter errors. An easy way to do
+this is to run, for example,
+`npm config set legacy-peer-deps=true --location=project` and commit the
+`.npmrc` file to your repo.
+
 ### Example
 
 Make sure you have a package-lock and an up-to-date install:

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

@@ -80,11 +80,9 @@ result in new modules being installed.
 
 Using `npm find-dupes` will run the command in `--dry-run` mode.
 
-Note that by default `npm dedupe` will not update the semver values of direct
-dependencies in your project `package.json`, if you want to also update
-values in `package.json` you can run: `npm dedupe --save` (or add the
-`save=true` option to a [configuration file](/configuring-npm/npmrc)
-to make that the default behavior).
+Note: `npm dedupe` will never update the semver values of direct
+dependencies in your project `package.json`, if you want to update
+values in `package.json` you can run: `npm update --save` instead.
 
 ### Configuration
 
@@ -158,22 +156,6 @@ This configuration does not affect `npm ci`.
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 
-#### `save`
-
-* Default: `true` unless when using `npm update` or `npm dedupe` where it
-  defaults to `false`
-* Type: Boolean
-
-Save installed packages to a `package.json` file as dependencies.
-
-When used with the `npm rm` command, removes the dependency from
-`package.json`.
-
-Will also prevent writing to `package-lock.json` if set to `false`.
-
-<!-- automatically generated, do not edit manually -->
-<!-- see lib/utils/config/definitions.js -->
-
 #### `omit`
 
 * Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -323,6 +305,20 @@ When false, specifying individual workspaces via the `workspace` config, or
 all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
+This value is not exported to the environment for child processes.
+
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/utils/config/definitions.js -->
+
+#### `install-links`
+
+* Default: false
+* Type: Boolean
+
+When set file: protocol dependencies that exist outside of the project root
+will be packed and installed as regular dependencies instead of creating a
+symlink. This option has no effect on workspaces.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

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

@@ -335,6 +335,8 @@ When false, specifying individual workspaces via the `workspace` config, or
 all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
+This value is not exported to the environment for child processes.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

deps/npm/docs/content/commands/npm-dist-tag.md

@@ -159,6 +159,8 @@ When false, specifying individual workspaces via the `workspace` config, or
 all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
+This value is not exported to the environment for child processes.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

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

@@ -116,6 +116,8 @@ When false, specifying individual workspaces via the `workspace` config, or
 all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
+This value is not exported to the environment for child processes.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

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

@@ -205,6 +205,8 @@ When false, specifying individual workspaces via the `workspace` config, or
 all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
+This value is not exported to the environment for child processes.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

deps/npm/docs/content/commands/npm-find-dupes.md

@@ -229,6 +229,20 @@ When false, specifying individual workspaces via the `workspace` config, or
 all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
+This value is not exported to the environment for child processes.
+
+<!-- automatically generated, do not edit manually -->
+<!-- see lib/utils/config/definitions.js -->
+
+#### `install-links`
+
+* Default: false
+* Type: Boolean
+
+When set file: protocol dependencies that exist outside of the project root
+will be packed and installed as regular dependencies instead of creating a
+symlink. This option has no effect on workspaces.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->
 

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

@@ -264,6 +264,8 @@ When false, specifying individual workspaces via the `workspace` config, or
 all workspaces via the `workspaces` flag, will cause npm to operate only on
 the specified workspaces, and not on the root project.
 
+This value is not exported to the environment for child processes.
+
 <!-- automatically generated, do not edit manually -->
 <!-- see lib/utils/config/definitions.js -->