[yxshee]

The repo's PR template only asks for benchmark results on considerable changes. This is a docs-only change, so I did not run the benchmark.

I checked the README against the current code on main and found five places where it no longer matches. I made the edits in README_js.md and regenerated README.md with npm run docs, as CONTRIBUTING.md asks.

Changes

1. v1() options.nsecs unit. The table said it is a number of nanoseconds, 0-10,000. The code treats it as 100-nanosecond intervals (t = msecs * 10000 + nsecs). I checked this by running:

   const base = { node: Uint8Array.of(1, 2, 3, 4, 5, 6), clockseq: 0x1234 };
   const msecs = new Date('2011-11-01').getTime();
   v1({ ...base, msecs, nsecs: 10000 }); // '710ba710-041c-11e1-9234-010203040506'
   v1({ ...base, msecs: msecs + 1, nsecs: 0 }); // '710ba710-041c-11e1-9234-010203040506'

   Both calls return the same UUID, so 10,000 is a full millisecond. I changed the text to "100-nanosecond intervals, should be 0-9,999".

2. v1() _throws_ row. The table said v1 throws if more than 10M UUIDs/sec are requested. That stopped being true in uuid@11 (see the comment in updateV1State: it now resets the node on nsecs overflow). I stubbed Date.now to a fixed value and called v1() 20,001 times. Nothing threw. I removed the row.

3. v6() options example. It passed node as a plain array. Version1Options.node is a Uint8Array, so the example does not type-check:

   error TS2345: Argument of type '{ node: number[]; ... }' is not assignable to parameter of type 'Version1Options'.
     Types of property 'node' are incompatible.
   

   I changed it to Uint8Array.of(...), the same as the v1() example. With that change tsc --strict passes, and the generated output in the README stays the same.

4. v7() description. It said "Create an RFC version 7 (random) UUID". v7 is the Unix Epoch time-based version, and the API summary table already says so. I made the heading match.

5. uuid --help output. The README copy did not have the uuid v6 line. node dist-node/bin/uuid --help prints it, and uuid v6 works.

Other diffs from regenerating

• The uuidv6() example output changed from ...-504d... to ...-514d.... That example uses the seeded fake RNG from the top of README_js.md. The new value has the multicast bit set on the random node, which is what fix(v1): set the multicast bit on v1Bytes's own randomly-generated node #973 changed. The README had not been regenerated since then.
• The Node support paragraph was edited only in README.md (b9ed7c7). I copied that wording into README_js.md so that npm run docs keeps it. The only difference in README.md is one double space that became a single space, which Prettier also asks for.

Checks

• npm run docs runs without errors
• npm test: 84 passed, 0 failed
• npx prettier --check README_js.md passes
• The commitlint hook passed

[broofa]

Good catches. Thanks for the contribution!