feat(ast, parser, codegen): add CommentKind::MultilineBlock

[Dunqing]

Add CommentKind::MultilineBlock to indicate a block comment that has at least one linebreak, which would be useful in the Codegen and Formatter

Examples:

CommentKind::Block:

/* single line block comment */

CommentKind::MultilineBlock

/* multiline 
block
 comment */

Maybe it would be better to rename CommentKind::Block to CommentKind::SinglelineBlock. as well

[Dunqing]

• refactor(ast): change capitalization of CommentKind variants #16640
• feat(ast, parser, linter, codegen, formatter)!: rename CommentKind::Block to CommentKind::SinglelineBlock #16501
• refactor(formatter): simplify checking multiline block comment #16481
• feat(ast, parser, codegen): add CommentKind::MultilineBlock #16479 👈 (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.

[codspeed-hq]

CodSpeed Performance Report

Merging #16479 will not alter performance

_{Comparing 12-04-feat_ast_parser_codegen_add_commentkind_multineblock (2bdaad6) with main (2c275bf)}

Summary

✅ 42 untouched
⏩ 3 skipped¹

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. ↩

[Copilot]

Pull request overview

This PR adds a new CommentKind::MultilineBlock variant to distinguish between single-line block comments (/* comment */) and multi-line block comments that contain line breaks. This distinction is useful for formatters and code generators to preserve the original comment style.

Key changes:

• Added CommentKind::MultilineBlock = 2 enum variant with ESTree serialization to "Block" for compatibility
• Updated parser to detect line breaks in block comments and assign the appropriate kind
• Modified codegen to handle multiline block comments with proper indentation
• Updated all pattern matches across formatter, linter, and NAPI bindings to handle the new variant

Reviewed changes

Copilot reviewed 7 out of 18 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
crates/oxc_ast/src/ast/comment.rs	Added MultilineBlock variant, is_multiline_block() helper, and updated is_block() and content_span() to handle both block variants
crates/oxc_ast/src/generated/derive_estree.rs	Added serialization for MultilineBlock to "Block" for ESTree compatibility
crates/oxc_parser/src/lexer/comment.rs	Updated lexer logic to detect line breaks and create MultilineBlock comments when appropriate
crates/oxc_parser/src/lexer/trivia_builder.rs	Modified add_block_comment() to accept CommentKind parameter and updated test expectations
crates/oxc_codegen/src/comment.rs	Split block comment handling: single-line blocks printed as-is, multiline blocks with proper indentation; removed unused is_line_terminator import
crates/oxc_formatter/src/formatter/trivia.rs	Updated pattern match to handle both Block and MultilineBlock variants together
crates/oxc_napi/src/lib.rs	Updated pattern match to serialize both block variants to "Block"
crates/oxc_linter/src/rules/typescript/prefer_function_type.rs	Updated pattern match to handle both block comment variants
Generated JS files (9 files)	Updated deserializers to map discriminant 2 to "Block" for ESTree compatibility

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[overlookmotel]

I pushed 1 commit to just maintain "correct" import order.

2nd PR in this stack is awaiting review by @leaysgur, so I've not merged this PR - I assume better we merge the whole stack in one go, rather than just this commit getting included in today's release.

[graphite-app]

Merge activity

• Dec 9, 2:01 AM UTC: Dunqing added this pull request to the Graphite merge queue.
• Dec 9, 2:08 AM UTC: Merged by the Graphite merge queue.