feat(napi/parser): preserveParens option for raw transfer

[overlookmotel]

Partial fix for #13851.

Add a preserveParens argument to raw transfer deserialize functions. This is not useful in oxc-parser, but these generated files will be duplicated in oxlint, where this option is required to remove ParenthesizedExpressions from AST, to align with ESLint and TS-ESLint.

[overlookmotel]

• feat(napi/parser): preserveParens option for raw transfer #13855 👈 (View in Graphite)
• refactor(napi/parser): export functions directly #13854
• 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 Instrumentation Performance Report

Merging #13855 will not alter performance

_{Comparing 09-17-feat_napi_parser_preserveparens_option_for_raw_transfer (24a21b3) with main (5c3645b)¹}

Summary

✅ 37 untouched

Footnotes

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

[Copilot]

Pull Request Overview

This PR adds a preserveParens option to raw transfer deserialize functions to control whether ParenthesizedExpression nodes are included in the generated AST. This change prepares the codebase for use in oxlint where the option is needed to align with ESLint and TS-ESLint behavior.

• Adds preserveParens parameter to deserialize functions in the raw transfer generator
• Updates deserialize function calls to pass true for preserveParens to maintain current behavior
• Implements custom converter for ParenthesizedExpression that conditionally creates nodes based on the preserveParens flag

Reviewed Changes

Copilot reviewed 5 out of 8 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
tasks/ast_tools/src/generators/raw_transfer.rs	Adds preserveParens parameter to generated deserialize function template
napi/parser/raw-transfer/eager.mjs	Updates deserialize calls to pass preserveParens: true with explanatory comments
napi/parser/bench.bench.mjs	Updates benchmark deserialize call to include new preserveParens parameter
crates/oxc_ast/src/serialize/js.rs	Implements custom ParenthesizedExpressionConverter with conditional node creation
crates/oxc_ast/src/ast/js.rs	Configures ParenthesizedExpression to use the new converter

---

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

[overlookmotel]

Merge activity

• Sep 17, 11:22 AM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Sep 17, 11:27 AM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Sep 17, 11:32 AM UTC: The Graphite merge queue couldn't merge this PR because it was in draft mode.
• Sep 17, 11:33 AM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Sep 17, 11:38 AM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Sep 17, 11:43 AM UTC: Merged by the Graphite merge queue.