feat(napi/parser): export visitor keys

[overlookmotel]

Add visitor keys export to oxc-parser NPM package. This is useful in itself, but also the first step towards an ESTree walker.

Visitor keys are based on @typescript-eslint/visitor-keys.

It'd be ideal to generate visitor keys direct from Oxc's own types, but that's proving difficult due to all the custom serializers we use to translate to ESTree. So using the shortcut of borrowing from TS-ESLint for now.

Oxc's AST is slightly different from TS-ESTree (notably Oxc's AST adds ParenthesizedExpression). But apart from those few differences, TS-ESLint's AST and Oxc's are identical, and I made a PR to TS-ESLint earlier this year (typescript-eslint/typescript-eslint#11279) to ensure visitor key order is correct, and matches Oxc.

To avoid adding a runtime dependency on @typescript-eslint/visitor-keys, extract the data from TS-ESLint in oxc_ast_tools, amend for Oxc/TS-ESTree differences, and re-output it as a simple object literal.

This approach will be faster at runtime, as the object's shape is consistent, and also avoids a dependency.

[overlookmotel]

• feat(linter/plugins): add defineRule API #13945
• feat(linter/plugins): add createOnce API #13944
• feat(linter/plugins): ESTree-compatible AST for JS plugins #13942
• feat(napi/parser): add deserializeProgramOnly deserializer function #13940
• feat(napi/parser): add AST walker #13930
• feat(napi/parser): export visitor keys #13927 👈 (View in Graphite)
• fix(napi/parser): raw transfer preserveParens option apply to TSParenthesizedType #13964
• 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 #13927 will not alter performance

_{Comparing 09-17-feat_napi_parser_export_visitor_keys (4ee94a3) with main (605621d)¹}

Summary

✅ 37 untouched

Footnotes

1. No successful run was found on main (4ee94a3) during the generation of this report, so 605621d 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 visitor keys export to the oxc-parser NPM package by generating them from TypeScript ESLint's visitor keys with modifications for Oxc-specific AST nodes. This functionality will enable ESTree walker support for Oxc's AST.

Key changes:

• Creates a new generator that extracts visitor keys from @typescript-eslint/visitor-keys
• Adds Oxc-specific AST nodes like ParenthesizedExpression and V8IntrinsicExpression
• Exports visitor keys through the parser package's main index

Reviewed Changes

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

Show a summary per file

File	Description
tasks/ast_tools/src/generators/estree_visit.rs	New generator that creates visitor keys by running a Node.js script and processing the output
tasks/ast_tools/src/utils.rs	Adds string! macro for creating String instances
napi/parser/scripts/visitor-keys.mjs	Node.js script that extracts visitor keys from TypeScript ESLint
napi/parser/src-js/index.mjs	Exports the generated visitor keys
napi/parser/test/parse.test.ts	Adds tests for the visitor keys functionality
.github/workflows/ci.yml	Adds Node.js setup for CI workflow

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

---

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

[overlookmotel]

Needs to be changed after #13978.

[overlookmotel]

Needs to be changed after #13978.

Done.

[overlookmotel]

Merge activity

• Sep 22, 11:08 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 22, 11:08 AM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Sep 22, 11:14 AM UTC: Merged by the Graphite merge queue.