feat!: drop node@16 support (#883)

Author: broofa

.github/workflows/ci.yml

@@ -27,7 +27,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node-version: [16.x, 18.x, 20.x, 22.x, 24.x]
+        node-version: [18.x, 20.x, 22.x, 24.x]
     steps:
       - uses: actions/checkout@v4
       - name: Use Node.js ${{ matrix.node-version }}

.gitignore

@@ -1,8 +1,9 @@
 *.tgz
 browserstack.err
 dist/
+dist-browser/
 .build/
 local.log
 logs/
 node_modules/
-examples/**/package-lock.json
+examples/**/package-lock.json

README.md

@@ -8,7 +8,6 @@ For the creation of [RFC9562](https://www.rfc-editor.org/rfc/rfc9562.html) (form
 
 - **Complete** - Support for all RFC9562 UUID versions
 - **Cross-platform** - Support for...
-  - ESM & Common JS
   - [Typescript](#support)
   - [Chrome, Safari, Firefox, and Edge](#support)
   - [NodeJS](#support)
@@ -19,10 +18,8 @@ For the creation of [RFC9562](https://www.rfc-editor.org/rfc/rfc9562.html) (form
 
 <!-- prettier-ignore -->
 > [!NOTE]
-> `uuid@11` is now available:  See the [CHANGELOG](./CHANGELOG.md) for details. TL;DR:
-> * TypeScript support is now included  (remove `@types/uuid` from your dependencies)
-> * Subtle changes to how the `options` arg is interpreted for `v1()`, `v6()`, and `v7()`. [See details](#options-handling-for-timestamp-uuids)
-> * Binary UUIDs are now `Uint8Array`s.  (May impact callers of `parse()`, `stringify()`,  or that pass an `option#buf` argument to `v1()`-`v7()`.)
+>
+> As of `uuid@12` CommonJS is no longer supported.  See [ESM Module FAQ](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
 
 ## Quickstart
 
@@ -34,18 +31,10 @@ npm install uuid
 
 **2. Create a UUID**
 
-ESM-syntax (must use named exports):
-
 ```javascript
 import { v4 as uuidv4 } from 'uuid';
-uuidv4(); // ⇨ '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d'
-```
 
-... CommonJS:
-
-```javascript
-const { v4: uuidv4 } = require('uuid');
-uuidv4(); // ⇨ '1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed'
+uuidv4(); // ⇨ '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d'
 ```
 
 For timestamp UUIDs, namespace UUIDs, and other options read on ...
@@ -198,7 +187,7 @@ Example:
 ```javascript
 import { v1 as uuidv1 } from 'uuid';
 
-uuidv1(); // ⇨ '2c5ea4c0-4067-11e9-9bdd-2b0d7b3dcb6d'
+uuidv1(); // ⇨ '2c5ea4c0-4067-11e9-9b5d-ab8dfbbd4bed'
 ```
 
 Example using `options`:
@@ -253,7 +242,7 @@ Example:
 ```javascript
 import { v4 as uuidv4 } from 'uuid';
 
-uuidv4(); // ⇨ '9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d'
+uuidv4(); // ⇨ '1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed'
 ```
 
 Example using predefined `random` values:
@@ -329,7 +318,7 @@ This method takes the same arguments as uuid.v1().
 ```javascript
 import { v6 as uuidv6 } from 'uuid';
 
-uuidv6(); // ⇨ '1e940672-c5ea-64c0-9b5d-ab8dfbbd4bed'
+uuidv6(); // ⇨ '1e940672-c5ea-64c1-9bdd-2b0d7b3dcb6d'
 ```
 
 Example using `options`:
@@ -376,7 +365,7 @@ Example:
 ```javascript
 import { v7 as uuidv7 } from 'uuid';
 
-uuidv7(); // ⇨ '01695553-c90c-705a-b56d-778dfbbd4bed'
+uuidv7(); // ⇨ '01695553-c90c-745a-b76f-770d7b3dcb6d'
 ```
 
 ### ~~uuid.v8()~~
@@ -483,7 +472,7 @@ Prior to `uuid@11`, it was possible for `options` state to interfere with the in
 
 **Browsers**: `uuid` [builds are tested](/uuidjs/uuid/blob/main/wdio.conf.js) against the latest version of desktop Chrome, Safari, Firefox, and Edge. Mobile versions of these same browsers are expected to work but aren't currently tested.
 
-**Node**: `uuid` [builds are tested](https://github.com/uuidjs/uuid/blob/main/.github/workflows/ci.yml#L26-L27) against node ([LTS releases](https://github.com/nodejs/Release)), plus one prior. E.g. `node@18` is in maintainence mode, and `node@22` is the current LTS release. So `uuid` supports `node@16`-`node@22`.
+**Node**: `uuid` [builds are tested](https://github.com/uuidjs/uuid/blob/main/.github/workflows/ci.yml#L26-L27) against node ([LTS releases](https://github.com/nodejs/Release)), plus one prior. E.g. At the time of this writing `node@20` is the "maintenance" release and `node@24` is the "current" release, so `uuid` supports `node@18`-`node@24`.
 
 **Typescript**: TS versions released within the past two years are supported. [source](https://github.com/microsoft/TypeScript/issues/49088#issuecomment-2468723715)
 

README_js.md

@@ -1,20 +1,22 @@
 ```javascript --hide
+import crypto from 'crypto';
+
 runmd.onRequire = (path) => {
   if (path == 'rng') return fun;
-  return path.replace(/^uuid/, './dist/cjs/');
+  return path.replace(/^uuid/, './dist/');
 };
 
 // Shim Date and crypto so generated ids are consistent across doc revisions
 runmd.Date.now = () => 1551914748172;
 
 let seed = 0xdefaced;
-require('crypto').randomFillSync = function (a) {
-  for (let i = 0; i < 16; i++) a[i] = (seed = (seed * 0x41a7) & 0x7fffffff) & 0xff;
+crypto.randomFillSync = function (a) {
+  for (let i = 0; i < a.length; i++) a[i] = (seed = (seed * 0x41a7) & 0x7fffffff) & 0xff;
   return a;
 };
 
 // Prevent usage of native randomUUID implementation to ensure deterministic UUIDs
-require('crypto').randomUUID = undefined;
+crypto.randomUUID = undefined;
 ```
 
 # uuid [![CI](https://github.com/uuidjs/uuid/workflows/CI/badge.svg)](https://github.com/uuidjs/uuid/actions?query=workflow%3ACI) [![Browser](https://github.com/uuidjs/uuid/workflows/Browser/badge.svg)](https://github.com/uuidjs/uuid/actions/workflows/browser.yml)
@@ -23,7 +25,6 @@ For the creation of [RFC9562](https://www.rfc-editor.org/rfc/rfc9562.html) (form
 
 - **Complete** - Support for all RFC9562 UUID versions
 - **Cross-platform** - Support for...
-  - ESM & Common JS
   - [Typescript](#support)
   - [Chrome, Safari, Firefox, and Edge](#support)
   - [NodeJS](#support)
@@ -34,10 +35,8 @@ For the creation of [RFC9562](https://www.rfc-editor.org/rfc/rfc9562.html) (form
 
 <!-- prettier-ignore -->
 > [!NOTE]
-> `uuid@11` is now available:  See the [CHANGELOG](./CHANGELOG.md) for details. TL;DR:
-> * TypeScript support is now included  (remove `@types/uuid` from your dependencies)
-> * Subtle changes to how the `options` arg is interpreted for `v1()`, `v6()`, and `v7()`. [See details](#options-handling-for-timestamp-uuids)
-> * Binary UUIDs are now `Uint8Array`s.  (May impact callers of `parse()`, `stringify()`,  or that pass an `option#buf` argument to `v1()`-`v7()`.)
+>
+> As of `uuid@12` CommonJS is no longer supported.  See [ESM Module FAQ](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
 
 ## Quickstart
 
@@ -49,17 +48,9 @@ npm install uuid
 
 **2. Create a UUID**
 
-ESM-syntax (must use named exports):
-
 ```javascript --run
 import { v4 as uuidv4 } from 'uuid';
-uuidv4(); // RESULT
-```
-
-... CommonJS:
 
-```javascript --run
-const { v4: uuidv4 } = require('uuid');
 uuidv4(); // RESULT
 ```
 
@@ -492,7 +483,7 @@ Prior to `uuid@11`, it was possible for `options` state to interfere with the in
 
 **Browsers**: `uuid` [builds are tested](/uuidjs/uuid/blob/main/wdio.conf.js) against the latest version of desktop Chrome, Safari, Firefox, and Edge. Mobile versions of these same browsers are expected to work but aren't currently tested.
 
-**Node**: `uuid` [builds are tested](https://github.com/uuidjs/uuid/blob/main/.github/workflows/ci.yml#L26-L27) against node ([LTS releases](https://github.com/nodejs/Release)), plus one prior. E.g. `node@18` is in maintainence mode, and `node@22` is the current LTS release. So `uuid` supports `node@16`-`node@22`.
+**Node**: `uuid` [builds are tested](https://github.com/uuidjs/uuid/blob/main/.github/workflows/ci.yml#L26-L27) against node ([LTS releases](https://github.com/nodejs/Release)), plus one prior. E.g. At the time of this writing `node@20` is the "maintenance" release and `node@24` is the "current" release, so `uuid` supports `node@18`-`node@24`.
 
 **Typescript**: TS versions released within the past two years are supported. [source](https://github.com/microsoft/TypeScript/issues/49088#issuecomment-2468723715)
 

examples/browser-rollup/rollup.config.js

@@ -1,8 +1,8 @@
-const { nodeResolve } = require('@rollup/plugin-node-resolve');
-const terser = require('@rollup/plugin-terser');
+import { nodeResolve } from '@rollup/plugin-node-resolve';
+import terser from '@rollup/plugin-terser';
 
 const plugins = [nodeResolve({ browser: true }), terser()];
-module.exports = [
+export default [
   {
     input: './example-all.js',
     output: {
@@ -44,47 +44,47 @@ module.exports = [
     input: './size-v1.js',
     output: {
       file: 'dist/v1-size.js',
-      format: 'cjs',
+      format: 'es',
     },
     plugins,
   },
   {
     input: './size-v3.js',
     output: {
       file: 'dist/v3-size.js',
-      format: 'cjs',
+      format: 'es',
     },
     plugins,
   },
   {
     input: './size-v4.js',
     output: {
       file: 'dist/v4-size.js',
-      format: 'cjs',
+      format: 'es',
     },
     plugins,
   },
   {
     input: './size-v5.js',
     output: {
       file: 'dist/v5-size.js',
-      format: 'cjs',
+      format: 'es',
     },
     plugins,
   },
   {
     input: './size-v6.js',
     output: {
       file: 'dist/v6-size.js',
-      format: 'cjs',
+      format: 'es',
     },
     plugins,
   },
   {
     input: './size-v7.js',
     output: {
       file: 'dist/v7-size.js',
-      format: 'cjs',
+      format: 'es',
     },
     plugins,
   },

examples/browser-webpack/example-all-require.html

@@ -5,7 +5,6 @@ module.exports = {
   },
   entry: {
     all: './example-all.js',
-    allRequire: './example-all-require.js',
     v1: './example-v1.js',
     v4: './example-v4.js',
     v7: './example-v7.js',