Skip to content

Comments

docs: improve comments for export star side effects handling#7730

Merged
graphite-app[bot] merged 1 commit intomainfrom
01-01-refactor_polish_the_doc_after_fixing_race_condition
Jan 1, 2026
Merged

docs: improve comments for export star side effects handling#7730
graphite-app[bot] merged 1 commit intomainfrom
01-01-refactor_polish_the_doc_after_fixing_race_condition

Conversation

@IWANABETHATGUY
Copy link
Member

@IWANABETHATGUY IWANABETHATGUY commented Jan 1, 2026

Copy link
Member Author


How to use the Graphite Merge Queue

Add the label graphite: merge-when-ready to this PR to add it to the merge queue.

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.

@IWANABETHATGUY IWANABETHATGUY changed the title refactor: polish the doc after fixing race condition docs: improve comments for export star side effects handling Jan 1, 2026
@IWANABETHATGUY IWANABETHATGUY marked this pull request as ready for review January 1, 2026 14:32
Copilot AI review requested due to automatic review settings January 1, 2026 14:32
@netlify
Copy link

netlify bot commented Jan 1, 2026

Deploy Preview for rolldown-rs canceled.

Name Link
🔨 Latest commit d7b8bcb
🔍 Latest deploy log https://app.netlify.com/projects/rolldown-rs/deploys/6956dd58d2196e0008102e49

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 enhances the documentation for export star side effects handling in the tree-shaking logic by expanding and clarifying comments that explain when side effects are needed to preserve __reExport calls.

  • Removes a redundant comment line and replaces it with a more comprehensive explanation
  • Adds a detailed code example illustrating how export * statements interact with different module wrap kinds
  • Clarifies the specific runtime helpers (init_xxx for ESM, require_xxx for CJS) used for wrapped module initialization

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

@github-actions
Copy link
Contributor

github-actions bot commented Jan 1, 2026

Benchmarks Rust

  • target: main(39e687a)
  • pr: 01-01-refactor_polish_the_doc_after_fixing_race_condition(d7b8bcb)
group                                                        pr                                     target
-----                                                        --                                     ------
bundle/bundle@multi-duplicated-top-level-symbol              1.00     61.1±1.09ms        ? ?/sec    1.01     61.4±1.14ms        ? ?/sec
bundle/bundle@multi-duplicated-top-level-symbol-sourcemap    1.00     67.2±1.12ms        ? ?/sec    1.00     67.5±1.07ms        ? ?/sec
bundle/bundle@rome_ts                                        1.00    104.4±1.45ms        ? ?/sec    1.01    105.1±1.29ms        ? ?/sec
bundle/bundle@rome_ts-sourcemap                              1.00    116.5±2.52ms        ? ?/sec    1.00    116.9±1.40ms        ? ?/sec
bundle/bundle@threejs                                        1.00     36.9±0.96ms        ? ?/sec    1.00     37.0±0.90ms        ? ?/sec
bundle/bundle@threejs-sourcemap                              1.00     41.7±0.56ms        ? ?/sec    1.01     42.0±0.45ms        ? ?/sec
bundle/bundle@threejs10x                                     1.00    387.3±3.01ms        ? ?/sec    1.00    385.5±2.61ms        ? ?/sec
bundle/bundle@threejs10x-sourcemap                           1.01    449.2±3.17ms        ? ?/sec    1.00    446.3±4.16ms        ? ?/sec
scan/scan@rome_ts                                            1.00     82.7±1.40ms        ? ?/sec    1.00     82.7±2.33ms        ? ?/sec
scan/scan@threejs                                            1.01     28.1±0.80ms        ? ?/sec    1.00     27.9±0.38ms        ? ?/sec
scan/scan@threejs10x                                         1.00    288.7±3.32ms        ? ?/sec    1.00    288.6±3.92ms        ? ?/sec

@IWANABETHATGUY IWANABETHATGUY force-pushed the 01-01-refactor_polish_the_doc_after_fixing_race_condition branch from 1bb83c1 to cdf7911 Compare January 1, 2026 14:54
@IWANABETHATGUY IWANABETHATGUY requested a review from hyf0 January 1, 2026 14:54
@graphite-app
Copy link
Contributor

graphite-app bot commented Jan 1, 2026

Merge activity

@graphite-app graphite-app bot force-pushed the 01-01-refactor_polish_the_doc_after_fixing_race_condition branch from cdf7911 to d7b8bcb Compare January 1, 2026 20:47
@graphite-app graphite-app bot merged commit d7b8bcb into main Jan 1, 2026
33 checks passed
@graphite-app graphite-app bot deleted the 01-01-refactor_polish_the_doc_after_fixing_race_condition branch January 1, 2026 20:56
This was referenced Jan 7, 2026
shulaoda added a commit that referenced this pull request Jan 7, 2026
## [1.0.0-beta.59] - 2026-01-07

⚡ Inline Dynamic Imports for Statically Imported Modules

- When a module is already statically imported, dynamic imports to that same module are now inlined instead of creating a separate chunk

### 🚀 Features

- plugin_timings: add 3s threshold and doc link to warning message (#7741) by @shulaoda
- improve treeshaking logic to handle empty parameter list in dynamic import .then() callbacks (#7781) by @Copilot
- dev/lazy: don't include already executed modules (#7745) by @hyf0
- dev/lazy: support dynamic `import(..)` (#7726) by @hyf0
- inline dynamic imports that imports statically imported modules (#7742) by @IWANABETHATGUY
- option: add experimental option to control chunk optimization (#7738) by @IWANABETHATGUY

### 🐛 Bug Fixes

- inline dynamic entry to user defined entry with esm wrap kind (#7783) by @IWANABETHATGUY
- use canonical namespace reference for property access (#7777) by @IWANABETHATGUY
- dynamic entry merged into common chunk with cjs and esm wrap kind (#7771) by @IWANABETHATGUY
- tla: should not await non-tla-related modules (#7768) by @hyf0
- dynamic entry captured by common chunk with CJS format (#7757) by @IWANABETHATGUY
- module_loader: mark emitted chunks as user-defined entry when already loaded (#7765) by @shulaoda
- normalize preserveModulesRoot path (#7737) by @IWANABETHATGUY
- linker: resolve race condition in side effects computation for export-star (#7728) by @camc314

### 🚜 Refactor

- plugin_timings: filter out plugins with duration < 1s from timing warnings (#7785) by @shulaoda
- module_loader: remove unnecessary collect before extend (#7769) by @shulaoda
- rename _id suffixes to _idx for oxc_index types (#7767) by @IWANABETHATGUY
- remove duplicate `preserve_entry_signatures` from `AddEntryModuleMsg` (#7762) by @shulaoda
- module_loader: pass `user_defined_entries` by reference (#7756) by @shulaoda
- dev/lazy: get proxy entry's `ResolvedId` correctly (#7746) by @hyf0
- simplify try_rewrite_import_expression control flow (#7753) by @IWANABETHATGUY
- module_loader: remove unnecessary dynamic import handling for runtime module (#7754) by @shulaoda
- inline __toDynamicImportESM  (#7747) by @IWANABETHATGUY
- use From impl for ModuleLoaderOutput conversion (#7732) by @shulaoda
- remove duplicate fields from `ModuleLoader` (#7731) by @shulaoda
- tweak `resolve_user_defined_entries` (#7727) by @shulaoda

### 📚 Documentation

- add rolldown-string reference to native MagicString compatibility section (#7778) by @Copilot
- improve comments for export star side effects handling (#7730) by @IWANABETHATGUY

### 🧪 Testing

- use assertion instead of console.log for some testcase (#7744) by @IWANABETHATGUY

### ⚙️ Miscellaneous Tasks

- tweak some `output.dynamicImportInCjs` related rollup test results (#7776) by @sapphi-red
- mark esbuild/dce/dce_of_symbol_ctor_call as passed (#7775) by @sapphi-red
- deps: update oxc apps (#7772) by @renovate[bot]
- vite-tests: allow running on PRs with `test: vite-tests` label (#7770) by @shulaoda
- deps: update oxc apps (#7760) by @renovate[bot]
- deps: update rollup submodule for tests to v4.55.1 (#7763) by @sapphi-red
- deps: update test262 submodule for tests (#7764) by @sapphi-red
- deps: update oxc to v0.107.0 (#7758) by @camc314
- deps: update taiki-e/install-action action to v2.65.13 (#7751) by @renovate[bot]
- deps: update rust crates (#7750) by @renovate[bot]
- deps: update npm packages (#7749) by @renovate[bot]
- deps: update github-actions (#7748) by @renovate[bot]
- deps: update dependency oxlint-tsgolint to v0.10.1 (#7729) by @renovate[bot]
- deps: update crate-ci/typos action to v1.41.0 (#7725) by @renovate[bot]

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants