Skip to content

feat(ast/estree): add phase field to ImportExpression in TS-ESTree AST#11193

Merged
graphite-app[bot] merged 1 commit intomainfrom
05-20-feat_ast_estree_add_phase_field_to_importexpression_in_ts-estree_ast
May 21, 2025
Merged

feat(ast/estree): add phase field to ImportExpression in TS-ESTree AST#11193
graphite-app[bot] merged 1 commit intomainfrom
05-20-feat_ast_estree_add_phase_field_to_importexpression_in_ts-estree_ast

Conversation

@overlookmotel
Copy link
Member

@overlookmotel overlookmotel commented May 20, 2025

Related to #10978. Add phase property to ImportExpression in TS-ESTree AST.

This aligns with ESTree spec, but does not align with TS-ESLint - TS-ESLint outputs a CallExpression with a MetaProperty as its callee instead.

We don't have the necessary information in our AST to match TS-ESLint, because we don't have the spans of import, defer, or import.defer, to use for the MetaProperty, or the IdentifierNames it contains.

This is not completely ideal, but I figure it's preferable to represent this syntax somehow in the AST, rather than completely ignoring it, in which case there's no way to distinguish between import("x"), import.defer("x"), and import.source("x").

Presumably TS-ESLint will change their AST shape to conform to ESTree spec once these reach stage 4, so I don't think we should expend effort changing our AST to align with them in the meantime. TypeScript doesn't even have test cases for these (we'd know if they did, as we'd be failing them) - so I doubt these are popular constructs in TS.

acorn-test262 submodule is bumped to include oxc-project/estree-conformance#36 which adds the phase field to ImportExpressions in test snapshots.

Copy link
Member Author


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.

@github-actions github-actions bot added A-ast Area - AST C-enhancement Category - New feature or request labels May 20, 2025
@codspeed-hq
Copy link

codspeed-hq bot commented May 20, 2025

CodSpeed Instrumentation Performance Report

Merging #11193 will not alter performance

Comparing 05-20-feat_ast_estree_add_phase_field_to_importexpression_in_ts-estree_ast (23182b8) with main (250e56f)

Summary

✅ 38 untouched benchmarks

@overlookmotel overlookmotel force-pushed the 05-20-feat_ast_estree_add_phase_field_to_importexpression_in_ts-estree_ast branch from 7b8edbc to ebdca5a Compare May 20, 2025 20:18
@overlookmotel overlookmotel marked this pull request as ready for review May 20, 2025 20:21
@Boshen Boshen added the 0-merge Merge with Graphite Merge Queue label May 21, 2025
Copy link
Member

Boshen commented May 21, 2025

Merge activity

…e AST (#11193)

Related to #10978. Add `phase` property to `ImportExpression` in TS-ESTree AST.

This aligns with ESTree spec, but does *not* align with TS-ESLint - TS-ESLint outputs a `CallExpression` with a `MetaProperty` as its `callee` instead.

We don't have the necessary information in our AST to match TS-ESLint, because we don't have the spans of `import`, `defer`, or `import.defer`, to use for the `MetaProperty`, or the `IdentifierName`s it contains.

This is not completely ideal, but I figure it's preferable to represent this syntax *somehow* in the AST, rather than completely ignoring it, in which case there's no way to distinguish between `import("x")`, `import.defer("x")`, and `import.source("x")`.

Presumably TS-ESLint will change their AST shape to conform to ESTree spec once these reach stage 4, so I don't think we should expend effort changing our AST to align with them in the meantime. TypeScript doesn't even have test cases for these (we'd know if they did, as we'd be failing them) - so I doubt these are popular constructs in TS.

`acorn-test262` submodule is bumped to include oxc-project/estree-conformance#36 which adds the `phase` field to `ImportExpression`s in test snapshots.
@graphite-app graphite-app bot force-pushed the 05-20-feat_ast_estree_add_phase_field_to_importexpression_in_ts-estree_ast branch from ebdca5a to 23182b8 Compare May 21, 2025 01:39
@graphite-app graphite-app bot merged commit 23182b8 into main May 21, 2025
23 of 24 checks passed
@graphite-app graphite-app bot deleted the 05-20-feat_ast_estree_add_phase_field_to_importexpression_in_ts-estree_ast branch May 21, 2025 01:45
@graphite-app graphite-app bot removed the 0-merge Merge with Graphite Merge Queue label May 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-ast Area - AST C-enhancement Category - New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants