fix(linter/plugins): add comments field to TS type def for Program

[overlookmotel]

#14589 added comments field to Program in Oxlint JS plugins AST. Add this field to the TS type def for Program.

[overlookmotel]

• fix(linter/plugins): add comments field to TS type def for Program #14626 👈 (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.

[Copilot]

Pull Request Overview

This PR adds the comments field to the TypeScript type definition for Program in the Oxlint JS plugins AST, addressing a missing type definition that was causing TypeScript errors when accessing ast.comments.

• Updates the TypeScript code generator to inject a comments: Comment[] field into the Program interface
• Imports the Comment type alongside Span from the plugins types module
• Removes the @ts-expect-error suppression that was previously needed to access the comments field

Reviewed Changes

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

File	Description
tasks/ast_tools/src/generators/typescript.rs	Modifies the code generator to add comments field to Program interface and import Comment type
apps/oxlint/src-js/plugins/source_code.ts	Removes @ts-expect-error suppression now that comments field is properly typed

---

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

[overlookmotel]

Merge activity

• Oct 15, 12:40 PM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Oct 15, 12:40 PM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Oct 15, 12:46 PM UTC: Merged by the Graphite merge queue.

[overlookmotel]

@lilnasy FYI the reason we don't include Comment in TS type defs is an oddity related to how AST is transferred to JS in parser when not using raw transfer (the default). In that case Comments are sent to JS as NAPI objects, and the library NAPI-RS already generates a TS type def for types which it handles.

oxc/crates/oxc_napi/src/comment.rs

Lines 3 to 11 in 84b2605

	#[derive(Debug, Clone)]
	#[napi(object)]
	pub struct Comment {
	#[napi(ts_type = "'Line' | 'Block'")]
	pub r#type: String,
	pub value: String,
	pub start: u32,
	pub end: u32,
	}

It's the no_ts_def attribute here which tells the codegen not to create a type def for it:

oxc/crates/oxc_ast/src/ast/comment.rs

Lines 126 to 127 in 84b2605

	#[estree(add_fields(value = CommentValue), no_ts_def, no_parent)]
	pub struct Comment {

This is a bit of a messy situation, but I think it's OK for now.