feat(data_structures): zero-cost NonMaxU32 type

[overlookmotel]

Introduce our own NonMaxU32 type.

This version has an advantage over nonmax's version on Linux, Mac and WASI. On those platforms, it utilizes the std::os::fd::BorrowedFd type, which is a true non-max type. Therefore, conversion to/from u32 is completely zero cost, whereas previous version stores the number as a NonZeroU32 and has to perform n ^ u32::MAX on every read/write.

NonMaxU32 has a niche, so Option<NonMaxU32> is 4 bytes.

On platforms which don't have std::os::fd::BorrowedFd (Windows), we fallback to an implementation which uses NonZeroU32 internally, same as before.

[overlookmotel]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• perf(cfg, codegen, linter, syntax): use NonMaxU32 from oxc_data_structures #9886
• feat(data_structures): zero-cost NonMaxU32 type #9883 👈 (View in Graphite)
• fix(linter/react): exhaustive-deps report longest dependency #9891
• feat(data_structures): add assert_unchecked! macro #9885
• test(data_structures): enable doc tests for oxc_data_structures crate #9884
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codspeed-hq]

CodSpeed Performance Report

Merging #9883 will not alter performance

_{Comparing 03-19-feat_data_structures_zero-cost_nonmaxu32_type (4d4a502) with main (2e023ab)}

Summary

✅ 33 untouched benchmarks