Skip to content

perf(ast): #[ast] macro use #[repr(transparent)] for single-field structs#17052

Merged
graphite-app[bot] merged 1 commit intomainfrom
12-18-perf_ast_ast_macro_use_repr_transparent_for_single-field_structs
Dec 18, 2025
Merged

perf(ast): #[ast] macro use #[repr(transparent)] for single-field structs#17052
graphite-app[bot] merged 1 commit intomainfrom
12-18-perf_ast_ast_macro_use_repr_transparent_for_single-field_structs

Conversation

@overlookmotel
Copy link
Member

@overlookmotel overlookmotel commented Dec 18, 2025

#[ast] macro adds #[repr(C)] to structs. For structs with a single field, use #[repr(transparent)] instead. This does not alter memory layout, but can change the ABI, which can make it more performant to pass such structs to functions in some cases, as it can change the registers used for passing.

This will help with making lexer tokens serializable (#17025), since Token will have #[ast] added to it, and we need it to continue to be #[repr(transparent)].

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 the C-performance Category - Solution not expected to change functional behavior, only performance label Dec 18, 2025
@overlookmotel overlookmotel marked this pull request as ready for review December 18, 2025 11:18
Copilot AI review requested due to automatic review settings December 18, 2025 11:18
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 optimizes the #[ast] procedural macro to use #[repr(transparent)] instead of #[repr(C)] for single-field structs. This optimization can improve performance by changing the ABI for passing these structs to functions, potentially using more efficient register allocation.

Key Changes

  • The macro now checks the field count and applies #[repr(transparent)] for single-field structs
  • Multi-field structs continue to use #[repr(C)] as before
  • Updated documentation comment to reflect the new behavior

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

@codspeed-hq
Copy link

codspeed-hq bot commented Dec 18, 2025

CodSpeed Performance Report

Merging #17052 will not alter performance

Comparing 12-18-perf_ast_ast_macro_use_repr_transparent_for_single-field_structs (a499d27) with main (b5f3c91)

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
Copy link
Member Author

I'm confident that benchmark changes are just noise.

@overlookmotel overlookmotel added the 0-merge Merge with Graphite Merge Queue label Dec 18, 2025
Copy link
Member Author

overlookmotel commented Dec 18, 2025

Merge activity

… structs (#17052)

`#[ast]` macro adds `#[repr(C)]` to structs. For structs with a single field, use `#[repr(transparent)]` instead. This does not alter memory layout, but can change the ABI, which can make it more performant to pass such structs to functions in some cases, as it can change the registers used for passing.

This will help with making lexer tokens serializable (#17025), since `Token` will have `#[ast]` added to it, and we need it to continue to be `#[repr(transparent)]`.
@graphite-app graphite-app bot force-pushed the 12-18-perf_ast_ast_macro_use_repr_transparent_for_single-field_structs branch from a499d27 to 1f3b19b Compare December 18, 2025 11:51
@graphite-app graphite-app bot merged commit 1f3b19b into main Dec 18, 2025
20 checks passed
@graphite-app graphite-app bot deleted the 12-18-perf_ast_ast_macro_use_repr_transparent_for_single-field_structs branch December 18, 2025 11:57
@graphite-app graphite-app bot removed the 0-merge Merge with Graphite Merge Queue label Dec 18, 2025
overlookmotel added a commit that referenced this pull request Dec 19, 2025
### 🚀 Features

- d209c21 allocator: Add cap to FixedSizeAllocatorPool and block when
exhausted (#17023) (Cameron)
- fb2af91 allocator: Add bitset utils (#17042) (zhaoting zhou)
- c16082c tasks/compat_data: Integrate `node-compat-table` (#16831)
(Boshen)
- 5586823 span: Extract TS declaration file check to its own function
(#17037) (camchenry)
- 3d2b492 minifier: Fold iife arrow functions in call expressions
(#16477) (Armano)
- 67e9f9e codegen: Keep comments on the export specifiers (#16943)
(夕舞八弦)
- cb515fa parser: Improve error message for `yield` as identifier usage
(#16950) (sapphi-red)
- dcc856b parser: Add help for `new_dynamic_import` error (#16949)
(sapphi-red)
- c3c79f8 parser: Improve import attribute value error message (#16948)
(sapphi-red)
- 291b57b ast_tools: Generate TS declaration files for deserializer and
walk files (#16912) (camc314)
- 74eae13 minifier: Remove unused import specifiers (#16797) (camc314)

### 🐛 Bug Fixes

- fb9e193 linter: OOM problems with custom plugins (#17082)
(overlookmotel)
- e59132b parser/napi: Fix lazy deser (#17069) (overlookmotel)
- a92faf0 ast_tools: Support `u128` in `assert_layouts` generator
(#17050) (overlookmotel)
- 47b4c2f minifier/docs: Correct hyperlink path in OPTIMIZATIONS.md
(#16986) (GRK)
- 3002649 transformer/typescript: Remove unused import equals
declaration (#16776) (Dunqing)
- 5a2af88 regular_expression: Correct named capture group reference
error (#16952) (sapphi-red)

### ⚡ Performance

- b657bb6 allocator: Reduce time `Mutex` lock is held in
`FixedSizeAllocatorPool::get` (#17079) (overlookmotel)
- 1f3b19b ast: `#[ast]` macro use `#[repr(transparent)]` for
single-field structs (#17052) (overlookmotel)
- 225f229 parser: Use SmallVec for duplicate default export detection
(#16801) (camc314)

### 📚 Documentation

- a9c419f traverse: Update safety comments (#16944) (overlookmotel)

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

Labels

A-ast Area - AST C-performance Category - Solution not expected to change functional behavior, only performance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

Comments