Skip to content

Comments

docs(parser): add note about falling back to parse TSType in TSImportType#16119

Merged
graphite-app[bot] merged 1 commit intomainfrom
c/11-25-docs_parser_add_note_about_falling_back_to_parse_tstype
Nov 25, 2025
Merged

docs(parser): add note about falling back to parse TSType in TSImportType#16119
graphite-app[bot] merged 1 commit intomainfrom
c/11-25-docs_parser_add_note_about_falling_back_to_parse_tstype

Conversation

@camc314
Copy link
Contributor

@camc314 camc314 commented Nov 25, 2025

No description provided.

@github-actions github-actions bot added A-parser Area - Parser C-docs Category - Documentation. Related to user-facing or internal documentation labels Nov 25, 2025
Copy link
Contributor Author

camc314 commented Nov 25, 2025


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.

@camc314 camc314 changed the title docs(parser): add note about falling back to parse TSType docs(parser): add note about falling back to parse TSType in TSImportType Nov 25, 2025
@camc314 camc314 marked this pull request as ready for review November 25, 2025 19:01
Copilot AI review requested due to automatic review settings November 25, 2025 19:01
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds documentation comments to clarify the fallback behavior in the TypeScript import type parser. The comments explain that when parsing fails, the parser falls back to parsing a TypeScript type to provide better error spans, with a note about handling invalid spans.

Key Changes

  • Added inline documentation explaining the fallback mechanism from string literal to TSType parsing
  • Documented the span validation logic that handles invalid span cases

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

You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.

@codspeed-hq
Copy link

codspeed-hq bot commented Nov 25, 2025

CodSpeed Performance Report

Merging #16119 will not alter performance

Comparing c/11-25-docs_parser_add_note_about_falling_back_to_parse_tstype (ff2f208) with main (5233d73)

Summary

✅ 42 untouched
⏩ 3 skipped1

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.

@overlookmotel overlookmotel force-pushed the c/11-25-docs_parser_add_note_about_falling_back_to_parse_tstype branch from 1b9977a to ff2f208 Compare November 25, 2025 22:50
@overlookmotel overlookmotel self-assigned this Nov 25, 2025
@overlookmotel overlookmotel added the 0-merge Merge with Graphite Merge Queue label Nov 25, 2025
Copy link
Member

overlookmotel commented Nov 25, 2025

Merge activity

@graphite-app graphite-app bot force-pushed the c/11-25-docs_parser_add_note_about_falling_back_to_parse_tstype branch from ff2f208 to 891e0b4 Compare November 25, 2025 22:58
@graphite-app graphite-app bot merged commit 891e0b4 into main Nov 25, 2025
21 checks passed
@graphite-app graphite-app bot deleted the c/11-25-docs_parser_add_note_about_falling_back_to_parse_tstype branch November 25, 2025 23:04
@graphite-app graphite-app bot removed the 0-merge Merge with Graphite Merge Queue label Nov 25, 2025
overlookmotel pushed a commit that referenced this pull request Dec 1, 2025
### 💥 BREAKING CHANGES

- 74cf572 ast: [**BREAKING**] Make `source` field of `TSImportType` a
`StringLiteral` (#16114) (copilot-swe-agent)
- 43156ae ast: [**BREAKING**] Rename `TSImportType` `argument` field to
`source` (#16110) (overlookmotel)
- 934d873 napi: [**BREAKING**] Drop `armv7-unknown-linux-musleabihf`
support (#16105) (Boshen)

### 🚀 Features

- 669afe0 ast: Add `Expression::is_jsx` method (#16154) (Dunqing)
- 17a8caa parser: Add diagnostic for JSX identifiers with hyphens
(#16133) (camchenry)
- 0549ae5 parser: Add diagnostic for expected ident after optional chain
(#16132) (camchenry)
- db839ae parser: Improve diagnostic for unexpected optional
declarations (#16131) (camchenry)
- bab4bc8 napi/parser: Add type annotations to parse-raw-worker test
(#15998) (camc314)

### 🐛 Bug Fixes

- 35ed36c traverse: Fix panic when truncating non-ASCII variable names
(#16265) (peter)
- 9149a26 linter/plugins, napi/parser: Deep freeze visitor keys (#16293)
(overlookmotel)
- 6b54dab minifier: Incorrect non-null object condition simplification
with `&&` and `||` (#16161) (sapphi-red)
- 9cc20a1 minifier: Avoid merging side effectful expressions to next
assignment statement if the side effect may change the left hand side
reference (#16165) (sapphi-red)
- 91eb3f2 ast/estree: Convert `TSImportType` `argument` field to
`Literal` (#16109) (overlookmotel)
- 1199cee parser: Reject invalid modifiers on parameter properties with
binding patterns (#16083) (camc314)
- f376325 traverse: Remove `console.log` from build script (#16049)
(overlookmotel)

### ⚡ Performance

- 82d784f lexer: Reduce bounds checks in `Lexer::get_string` (#16317)
(overlookmotel)
- cc2f352 span: Add `#[inline]` to `Atom` methods (#16311)
(overlookmotel)
- ffca070 span: Add `#[repr(transparent)]` to `Atom` (#16310)
(overlookmotel)
- 02bdf90 linter/plugins, napi/parser: Reuse arrays in visitor keys
(#16294) (overlookmotel)

### 📚 Documentation

- 891e0b4 parser: Add note about falling back to parse TSType in
TSImportType (#16119) (camc314)

Co-authored-by: Boshen <[email protected]>
taearls pushed a commit to taearls/oxc that referenced this pull request Dec 11, 2025
taearls pushed a commit to taearls/oxc that referenced this pull request Dec 11, 2025
### 💥 BREAKING CHANGES

- 74cf572 ast: [**BREAKING**] Make `source` field of `TSImportType` a
`StringLiteral` (oxc-project#16114) (copilot-swe-agent)
- 43156ae ast: [**BREAKING**] Rename `TSImportType` `argument` field to
`source` (oxc-project#16110) (overlookmotel)
- 934d873 napi: [**BREAKING**] Drop `armv7-unknown-linux-musleabihf`
support (oxc-project#16105) (Boshen)

### 🚀 Features

- 669afe0 ast: Add `Expression::is_jsx` method (oxc-project#16154) (Dunqing)
- 17a8caa parser: Add diagnostic for JSX identifiers with hyphens
(oxc-project#16133) (camchenry)
- 0549ae5 parser: Add diagnostic for expected ident after optional chain
(oxc-project#16132) (camchenry)
- db839ae parser: Improve diagnostic for unexpected optional
declarations (oxc-project#16131) (camchenry)
- bab4bc8 napi/parser: Add type annotations to parse-raw-worker test
(oxc-project#15998) (camc314)

### 🐛 Bug Fixes

- 35ed36c traverse: Fix panic when truncating non-ASCII variable names
(oxc-project#16265) (peter)
- 9149a26 linter/plugins, napi/parser: Deep freeze visitor keys (oxc-project#16293)
(overlookmotel)
- 6b54dab minifier: Incorrect non-null object condition simplification
with `&&` and `||` (oxc-project#16161) (sapphi-red)
- 9cc20a1 minifier: Avoid merging side effectful expressions to next
assignment statement if the side effect may change the left hand side
reference (oxc-project#16165) (sapphi-red)
- 91eb3f2 ast/estree: Convert `TSImportType` `argument` field to
`Literal` (oxc-project#16109) (overlookmotel)
- 1199cee parser: Reject invalid modifiers on parameter properties with
binding patterns (oxc-project#16083) (camc314)
- f376325 traverse: Remove `console.log` from build script (oxc-project#16049)
(overlookmotel)

### ⚡ Performance

- 82d784f lexer: Reduce bounds checks in `Lexer::get_string` (oxc-project#16317)
(overlookmotel)
- cc2f352 span: Add `#[inline]` to `Atom` methods (oxc-project#16311)
(overlookmotel)
- ffca070 span: Add `#[repr(transparent)]` to `Atom` (oxc-project#16310)
(overlookmotel)
- 02bdf90 linter/plugins, napi/parser: Reuse arrays in visitor keys
(oxc-project#16294) (overlookmotel)

### 📚 Documentation

- 891e0b4 parser: Add note about falling back to parse TSType in
TSImportType (oxc-project#16119) (camc314)

Co-authored-by: Boshen <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-parser Area - Parser C-docs Category - Documentation. Related to user-facing or internal documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants