refactor(ast_tools): remove COMMENTS variant modifier from raw transfer codegen

[overlookmotel]

Refactor. The COMMENTS flag is redundant as the AST only has a comments property in Oxlint, and we already have a LINTER flag - use that instead.

[overlookmotel]

• perf(linter/plugins): add fast path for files with no comments #20366
• fix(linter/plugins): remove hashbang property from AST #20365
• perf(linter/plugins): deserialize comments without AST #20364
• refactor(linter/plugins): move comments methods into own file #20363
• perf(linter/plugins): recycle comment objects #20362
• refactor(ast_tools): remove COMMENTS variant modifier from raw transfer codegen #20361 👈 (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 changes, fast-track this PR to the front of the merge queue

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

Refactors the raw-transfer deserializer codegen to remove the redundant COMMENTS variant flag and gate comment access via the existing LINTER flag, aligning with how Oxlint exposes Program.comments.

Changes:

• Remove the COMMENTS flag from raw-transfer variant generation and reduce the flag set from 7 to 6.
• Switch AST-id invalidation logic to key off LINTER instead of COMMENTS.
• Update the Program raw deserializer template to conditionally include the comments getter under LINTER.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
tasks/ast_tools/src/generators/raw_transfer.rs	Drops the COMMENTS flag from variant generation and adjusts related codegen paths/flags.
crates/oxc_ast/src/serialize/mod.rs	Changes the raw-deserializer template so Program.comments is included only for the LINTER variant.

[codspeed-hq]

Merging this PR will not alter performance

✅ 53 untouched benchmarks
⏩ 3 skipped benchmarks¹

---

_{Comparing om/03-13-refactor_ast_tools_remove_comments_variant_modifier_from_raw_transfer_codegen (f2c54e7) with main (6eb5b01)²}

Footnotes

1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

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

[graphite-app]

Merge activity

• Mar 14, 12:15 PM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Mar 14, 12:30 PM UTC: Merged by the Graphite merge queue.