Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(traverse): add JSDoc type hints to JS codegen scripts #6375

Conversation

DonIsaac
Copy link
Collaborator

@DonIsaac DonIsaac commented Oct 8, 2024

Use JSDoc comments in build.mjs and related scripts to provide type hints and better intellisense. I was having a hard time knowing what fields are available in different methods, and I found this quite helpful. I'm sure other newcomers to this part of our codegen infrastructure will find it helpful as well.

Copy link

graphite-app bot commented Oct 8, 2024

Your org has enabled the Graphite merge queue for merging into main

Add the label “0-merge” to the PR and Graphite will automatically add it to the merge queue when it’s ready to merge. Or use the label “hotfix” to add to the merge queue as a hot fix.

You must have a Graphite account and log in to Graphite in order to use the merge queue. Sign up using this link.

Copy link
Collaborator Author

DonIsaac commented Oct 8, 2024

This stack of pull requests is managed by Graphite. Learn more about stacking.

Join @DonIsaac and the rest of your teammates on Graphite Graphite

@DonIsaac DonIsaac added the C-cleanup Category - technical debt or refactoring. Solution not expected to change behavior label Oct 8, 2024 — with Graphite App
@DonIsaac DonIsaac marked this pull request as ready for review October 8, 2024 18:02
@DonIsaac
Copy link
Collaborator Author

DonIsaac commented Oct 8, 2024

I need this merged before I can complete #6350.

@DonIsaac DonIsaac force-pushed the don/10-08-chore_traverse_add_jsdoc_type_hints_to_js_codegen_scripts branch from 98bfac9 to 2696201 Compare October 8, 2024 20:25
@overlookmotel overlookmotel added the 0-merge Merge with Graphite Merge Queue label Oct 8, 2024
Copy link

graphite-app bot commented Oct 8, 2024

Merge activity

  • Oct 8, 5:00 PM EDT: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
  • Oct 8, 5:00 PM EDT: overlookmotel added this pull request to the Graphite merge queue.
  • Oct 8, 5:04 PM EDT: overlookmotel merged this pull request with the Graphite merge queue.

Use JSDoc comments in `build.mjs` and related scripts to provide type hints and better intellisense. I was having a hard time knowing what fields are available in different methods, and I found this quite helpful. I'm sure other newcomers to this part of our codegen infrastructure will find it helpful as well.
@overlookmotel overlookmotel force-pushed the don/10-08-chore_traverse_add_jsdoc_type_hints_to_js_codegen_scripts branch from 2696201 to d5cf1f8 Compare October 8, 2024 21:00
@overlookmotel
Copy link
Collaborator

Thanks Don. This codegen was written in a bit of a "quick and dirty" manner. It was never intended to live this long - it was just a proof of concept initially, and I intended to translate it to Rust and make it part of oxc_ast_tools if it worked out. But... time...

So that's why it's poorly written and lacking comments.

@graphite-app graphite-app bot merged commit d5cf1f8 into main Oct 8, 2024
16 checks passed
@graphite-app graphite-app bot deleted the don/10-08-chore_traverse_add_jsdoc_type_hints_to_js_codegen_scripts branch October 8, 2024 21:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
0-merge Merge with Graphite Merge Queue C-cleanup Category - technical debt or refactoring. Solution not expected to change behavior
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants