docs(allocator): correct and expand safety comments on Allocator methods

[overlookmotel]

Correct safety comments on unsafe methods of Allocator, as suggested by AI in #13134 (review).

Also expand the safety comments for Allocator::set_data_ptr, and add comments on how its invariants are upheld at call sites.

Also correct typos and improve comment formatting.

[overlookmotel]

• feat(napi/oxlint): run JS plugins on multiple threads #13244
• feat(allocator, linter): store worker thread flags in FixedSizeAllocator #13136
• refactor(allocator, linter): add ref counter to FixedSizeAllocator #13135
• docs(allocator): correct and expand safety comments on Allocator methods #13139 👈 (View in Graphite)
• 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.

[Copilot]

Pull Request Overview

This PR improves and corrects safety documentation for the Allocator trait methods. The changes focus on clarifying safety invariants and adding detailed comments about proper usage patterns to prevent undefined behavior.

• Corrects safety comments on safe methods of Allocator as suggested by code review
• Expands safety documentation for Allocator::set_data_ptr with detailed invariants
• Adds comments explaining how invariants are maintained at call sites

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
crates/oxc_allocator/src/pool_fixed_size.rs	Adds clarifying safety comment about restoring original data pointer
crates/oxc_allocator/src/from_raw_parts.rs	Expands safety documentation and corrects grammar in multiple method comments

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[codspeed-hq]

CodSpeed Instrumentation Performance Report

Merging #13139 will not alter performance

_{Comparing 08-16-docs_allocator_correct_and_expand_safety_comments_on_allocator_methods (33ce529) with main (5887053)¹}

Summary

✅ 34 untouched benchmarks

Footnotes

1. No successful run was found on main (02c779f) during the generation of this report, so 5887053 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

[Dunqing]

Merge activity

• Aug 17, 1:23 PM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Aug 17, 1:24 PM UTC: Dunqing added this pull request to the Graphite merge queue.
• Aug 17, 1:29 PM UTC: Merged by the Graphite merge queue.