feat: add `experimental.lazyBarrel` option by shulaoda · Pull Request #7908 · rolldown/rolldown

shulaoda · 2026-01-15T10:24:04Z

No description provided.

shulaoda · 2026-01-15T10:24:28Z

test: add lazy barrel optimization test cases #7967 : 2 dependent PRs (#7969 , #7979 )
feat: support lazy barrel optimization #7933
feat: add experimental.lazyBarrel option #7908 👈 (View in Graphite)
refactor(import_record): make resolved_module optional #7907
main

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.

github-actions · 2026-01-15T16:41:01Z

Benchmarks Rust

target: main(9e35ade)
pr: 01-15-feat_support_barrel_module_optimization(94bf52d)

group                                                        pr                                     target
-----                                                        --                                     ------
bundle/bundle@multi-duplicated-top-level-symbol              1.05     77.2±2.23ms        ? ?/sec    1.00     73.6±4.24ms        ? ?/sec
bundle/bundle@multi-duplicated-top-level-symbol-sourcemap    1.04     85.7±3.17ms        ? ?/sec    1.00     82.2±3.18ms        ? ?/sec
bundle/bundle@rome_ts                                        1.00    107.1±2.40ms        ? ?/sec    1.00    107.4±3.28ms        ? ?/sec
bundle/bundle@rome_ts-sourcemap                              1.01    120.1±3.62ms        ? ?/sec    1.00    118.8±2.69ms        ? ?/sec
bundle/bundle@threejs                                        1.04     39.1±2.22ms        ? ?/sec    1.00     37.6±1.00ms        ? ?/sec
bundle/bundle@threejs-sourcemap                              1.02     43.6±1.50ms        ? ?/sec    1.00     42.6±1.02ms        ? ?/sec
bundle/bundle@threejs10x                                     1.05    395.1±7.27ms        ? ?/sec    1.00    376.7±6.29ms        ? ?/sec
bundle/bundle@threejs10x-sourcemap                           1.03    445.1±7.50ms        ? ?/sec    1.00    433.9±5.13ms        ? ?/sec
scan/scan@rome_ts                                            1.02     84.6±2.43ms        ? ?/sec    1.00     83.2±1.99ms        ? ?/sec
scan/scan@threejs                                            1.00     28.9±0.43ms        ? ?/sec    1.01     29.1±1.70ms        ? ?/sec
scan/scan@threejs10x                                         1.01    295.3±5.71ms        ? ?/sec    1.00    293.3±5.01ms        ? ?/sec

Copilot

Pull request overview

This PR adds a new experimental configuration option lazyBarrel to enable lazy barrel optimization in Rolldown. The change introduces a boolean flag that can be set under the experimental configuration to control this optimization feature, which is disabled by default.

Changes:

Added lazyBarrel option to TypeScript types and validation schemas
Added lazy_barrel field to Rust structs with accessor method is_lazy_barrel_enabled()
Added lazyBarrel to test configuration schema

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
packages/rolldown/src/options/input-options.ts	Added TypeScript interface definition and JSDoc documentation for the `lazyBarrel` option
packages/rolldown/src/utils/validator.ts	Added validation schema entry for the boolean `lazyBarrel` option
packages/rolldown/src/utils/bindingify-input-options.ts	Added mapping to pass `lazyBarrel` from TypeScript to Rust bindings
packages/rolldown/src/binding.d.cts	Added `lazyBarrel` field to the binding options interface
crates/rolldown_testing/_config.schema.json	Added `lazyBarrel` to the test configuration JSON schema
crates/rolldown_common/src/inner_bundler_options/types/experimental_options.rs	Added `lazy_barrel` field to `ExperimentalOptions` struct, added `is_lazy_barrel_enabled()` accessor method, and reorganized imports
crates/rolldown_binding/src/options/binding_input_options/binding_experimental_options.rs	Added `lazy_barrel` field to binding struct and mapping in `TryFrom` implementation

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

packages/rolldown/src/options/input-options.ts

netlify · 2026-01-20T12:08:00Z

✅ Deploy Preview for rolldown-rs ready!

Name	Link
🔨 Latest commit	`b157b0c`
🔍 Latest deploy log	https://app.netlify.com/projects/rolldown-rs/deploys/6970794110cee500089997d0
😎 Deploy Preview	https://deploy-preview-7908--rolldown-rs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated no new comments.

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

graphite-app · 2026-01-21T06:58:45Z

Merge activity

Jan 21, 6:58 AM UTC: hyf0 added this pull request to the Graphite merge queue.
Jan 21, 7:09 AM UTC: Merged by the Graphite merge queue.

Copilot

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@IWANABETHATGUY

## [1.0.0-rc.1] - 2026-01-22 ### 🚀 Features - debug_info: add facade chunk elimination reason (#7980) by @IWANABETHATGUY - support lazy barrel optimization (#7933) by @shulaoda - add `experimental.lazyBarrel` option (#7908) by @shulaoda - skip unused external modules from IIFE parameter list (#7978) by @sapphi-red - add custom panic hook for better crash reporting (#7752) by @shulaoda - treeshake: add `invalidImportSideEffects` option (#7958) by @shulaoda - merge allow-extension emitted chunks (#7940) by @IWANABETHATGUY - nativeMagicString generateMap (#7944) by @IWANABETHATGUY - Include meta.magicString in RenderChunkMeta (#7943) by @IWANABETHATGUY - debug_info: add debug info for eliminated facade chunks (#7946) by @IWANABETHATGUY - stablize `strictExecutionOrder` and move to `output.strictExecutionOrder` from `experimental.strictExecutionOrder` (#7901) by @sapphi-red - add documentation link to require() error message (#7898) by @Copilot - add `codeSplitting: boolean` and deprecate `inlineDynamicImports` (#7870) by @hyf0 - dev: change lazy module URL to `/@vite/lazy` from `/lazy` (#7884) by @sapphi-red ### 🐛 Bug Fixes - transform JS files containing `</script>` to escape template literals (#7987) by @IWANABETHATGUY - apply avoid-breaking-exported-api = false to clippy.toml and fix clippy errors (#7982) by @Boshen - pass `kind` from `this.resolve` (#7981) by @sapphi-red - rolldown_plugin_vite_resolve: ignore yarn resolution errors and fallback to other resolvers (#7968) by @sapphi-red - renamer: prevent renaming symbols when there no conflicts (#7936) by @Dunqing - correct minifyInterExports when emitted chunk got merged (#7941) by @IWANABETHATGUY - deduplicate entry points when module is both emitted and dynamically imported (#7885) by @IWANABETHATGUY - dev: add `@vite-ignore` to lazy compilation proxy module import (#7883) by @sapphi-red ### 🚜 Refactor - rust: enable clippy nursery lint group (#8002) by @Boshen - rust: fix inconsistent_struct_constructor clippy lint (#7999) by @Boshen - rust: fix needless_pass_by_ref_mut clippy lint (#7994) by @Boshen - rust: fix unnecessary_wraps clippy lint (#7993) by @Boshen - rust: fix enum_variant_names clippy lint (#7992) by @Boshen - fix single_match clippy lint (#7997) by @Boshen - rust: fix redundant_clone clippy lint (#7996) by @Boshen - rust: rename CJS to Cjs to follow upper_case_acronyms lint (#7991) by @Boshen - rust: remove unnecessary Box wrapper around Vec in MemberExprRef (#7990) by @Boshen - import_record: make resolved_module optional (#7907) by @shulaoda - remove unnecessary `.parse` (#7966) by @sapphi-red - remove unused `ImportRecordMeta::IsPlainImport` (#7948) by @shulaoda - proper set chunk meta (#7939) by @IWANABETHATGUY - module_loader: remove `try_spawn_with_cache` (#7920) by @shulaoda - link_stage: simplify `ImportStatus::NoMatch` to unit variant (#7909) by @shulaoda - improve global scope symbol reservation in chunk deconfliction (#7906) by @IWANABETHATGUY - simplify ast unwrapping in generate stage (#7900) by @IWANABETHATGUY - generate_stage: optimize cross-chunk imports computation (#7889) by @shulaoda - link_stage: move runtime require logic into match branch (#7892) by @shulaoda - link_stage: simplify runtime require reference conditions (#7891) by @shulaoda - link_stage: inline and simplify external dynamic import check (#7890) by @shulaoda - generate_stage: simplify external module import collection logic (#7887) by @shulaoda - avoid redundant module lookup in TLA computation (#7886) by @shulaoda - dev: `devEngine.compileEntry` does not return null (#7882) by @sapphi-red - dev: fix type errors for test HMR runtime (#7881) by @sapphi-red - dev: move `clientId` property to `DevRuntime` base class (#7880) by @sapphi-red - dev: generate client id in browser (#7878) by @hyf0 ### 📚 Documentation - apis: organize hook filters documentation and add composable filters section (#8003) by @sapphi-red - update `vitepress-plugin-group-icons` (#7947) by @yuyinws - add in-depth documentation for lazy barrel optimization (#7969) by @shulaoda - bump theme & update activeMatch for reference (#7963) by @mdong1909 - mark `build()` API as experimental (#7954) by @sapphi-red - enhance search functionality with improved scoring and filtering logic (#7935) by @hyf0 - add minor comments to multiple types (#7930) by @sapphi-red - refactor advanedChunks related content to adapt manual code splitting concept (#7925) by @hyf0 - apis: add content to Bundler API page (#7926) by @sapphi-red - apis: restructure plugin API related docs (#7924) by @sapphi-red - add plugin API docs (#7923) by @sapphi-red - apis: add docs to important APIs (#7913) by @sapphi-red - move the important APIs to the top of the sidebar (#7912) by @sapphi-red - apis: add more content to CLI documentation (#7911) by @sapphi-red - apis: generate CLI docs from --help output (#7910) by @sapphi-red - add fathom analytics (#7896) by @mdong1909 ### ⚡ Performance - use u32 for string indices in string_wizard and rolldown to reduce memory usage (#7989) by @IWANABETHATGUY - rust: remove all usages of `with_scope_tree_child_ids(true)` for `SemanticBuilder` (#7995) by @Dunqing - renamer: skip unnecessary nested scope symbol processing (#7899) by @Dunqing - module_loader: use ArcStr for importer_id to avoid string copy (#7922) by @shulaoda - module_loader: defer `ModuleTaskOwner` construction until needed (#7921) by @shulaoda - renamer: optimize symbol renaming by eliminating `rename_non_root_symbol` pass (#7867) by @Dunqing ### 🧪 Testing - add lazy barrel optimization test cases (#7967) by @shulaoda ### ⚙️ Miscellaneous Tasks - remove lazy barrel option (#8010) by @shulaoda - mark watch API as experimental (#8004) by @sapphi-red - deps: update dependency lodash-es to v4.17.23 [security] (#8001) by @renovate[bot] - git ignore zed local config (#7988) by @IWANABETHATGUY - setup publint for published packages (#7972) by @Copilot - enable `tagged_template_transform ` uncondionally (#7975) by @IWANABETHATGUY - deps: update oxc to v0.110.0 (#7964) by @renovate[bot] - deps: update oxc apps (#7962) by @renovate[bot] - ai: add upgrade-oxc Claude skill (#7957) by @Boshen - deps: update rollup submodule for tests to v4.55.2 (#7959) by @sapphi-red - deps: update test262 submodule for tests (#7960) by @sapphi-red - deps: update crate-ci/typos action to v1.42.1 (#7961) by @renovate[bot] - deps: update rust crates (#7951) by @renovate[bot] - deps: update npm packages (#7953) by @renovate[bot] - deps: update github-actions (#7952) by @renovate[bot] - deps: update npm packages (#7950) by @renovate[bot] - format magic-string test before write to disk (#7945) by @IWANABETHATGUY - deps: update dependency rolldown-plugin-dts to ^0.21.0 (#7915) by @renovate[bot] - deps: update dependency oxlint-tsgolint to v0.11.1 (#7914) by @renovate[bot] - deps: update dependency diff to v8.0.3 [security] (#7904) by @renovate[bot] - remove outdated TODO comment in `collect_depended_symbols` (#7888) by @shulaoda - deps: update oxc resolver to v11.16.3 (#7876) by @renovate[bot]

github-actions bot assigned shulaoda Jan 15, 2026

shulaoda mentioned this pull request Jan 15, 2026

refactor(import_record): make resolved_module optional #7907

Merged

shulaoda force-pushed the 01-15-feat_support_barrel_module_optimization branch from f5e1228 to cd0c98a Compare January 15, 2026 16:21

shulaoda marked this pull request as ready for review January 15, 2026 16:25

shulaoda marked this pull request as draft January 15, 2026 16:25

shulaoda force-pushed the 01-15-feat_support_barrel_module_optimization branch 2 times, most recently from cc320c7 to 4d483a5 Compare January 16, 2026 10:26

shulaoda force-pushed the 01-15-refactor_import_record_make_resolved_module_optional branch from f019b14 to a0ce790 Compare January 16, 2026 10:26

shulaoda force-pushed the 01-15-feat_support_barrel_module_optimization branch from 4d483a5 to 5a8ee21 Compare January 16, 2026 14:18

shulaoda mentioned this pull request Jan 16, 2026

feat: support lazy barrel optimization #7933

Merged

shulaoda changed the title ~~feat: support barrel module optimization~~ feat: add experimental.lazyBarrel option Jan 16, 2026

shulaoda force-pushed the 01-15-refactor_import_record_make_resolved_module_optional branch from a0ce790 to f2a9110 Compare January 17, 2026 20:03

shulaoda force-pushed the 01-15-feat_support_barrel_module_optimization branch 3 times, most recently from 92c0f0a to 249cefa Compare January 18, 2026 14:20

shulaoda force-pushed the 01-15-refactor_import_record_make_resolved_module_optional branch from f2a9110 to 8215b7d Compare January 18, 2026 14:20

shulaoda marked this pull request as ready for review January 18, 2026 20:41

shulaoda force-pushed the 01-15-feat_support_barrel_module_optimization branch from 249cefa to be55da4 Compare January 19, 2026 17:43

shulaoda force-pushed the 01-15-refactor_import_record_make_resolved_module_optional branch from 8215b7d to 9d55cf9 Compare January 19, 2026 17:43

graphite-app bot changed the base branch from 01-15-refactor_import_record_make_resolved_module_optional to graphite-base/7908 January 20, 2026 08:24

shulaoda marked this pull request as draft January 20, 2026 08:25

shulaoda force-pushed the graphite-base/7908 branch from 9d55cf9 to e88bacb Compare January 20, 2026 08:43

shulaoda force-pushed the 01-15-feat_support_barrel_module_optimization branch from be55da4 to d870c55 Compare January 20, 2026 08:43

shulaoda changed the base branch from graphite-base/7908 to main January 20, 2026 08:43

This was referenced Jan 20, 2026

test: add lazy barrel optimization test cases #7967

Merged

docs: add in-depth documentation for lazy barrel optimization #7969

Merged

shulaoda marked this pull request as ready for review January 20, 2026 11:49

Copilot AI review requested due to automatic review settings January 20, 2026 11:49

shulaoda requested review from IWANABETHATGUY and hyf0 January 20, 2026 11:49

Copilot started reviewing on behalf of shulaoda January 20, 2026 11:49 View session

Copilot AI reviewed Jan 20, 2026

View reviewed changes

packages/rolldown/src/options/input-options.ts Show resolved Hide resolved

shulaoda force-pushed the 01-15-feat_support_barrel_module_optimization branch from d870c55 to 7d25e43 Compare January 20, 2026 12:05

hyf0 approved these changes Jan 20, 2026

View reviewed changes

IWANABETHATGUY approved these changes Jan 20, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings January 21, 2026 03:53

sapphi-red force-pushed the 01-15-feat_support_barrel_module_optimization branch from 7d25e43 to cbf1cfd Compare January 21, 2026 03:53

Copilot started reviewing on behalf of sapphi-red January 21, 2026 03:53 View session

sapphi-red mentioned this pull request Jan 21, 2026

test: add incorrect output example #7979

Closed

Copilot AI reviewed Jan 21, 2026

View reviewed changes

shulaoda force-pushed the 01-15-feat_support_barrel_module_optimization branch from cbf1cfd to 94bf52d Compare January 21, 2026 05:35

hyf0 added the graphite: merge-when-ready label Jan 21, 2026

feat: add experimental.lazyBarrel option (#7908)

b157b0c

Copilot AI review requested due to automatic review settings January 21, 2026 06:59

graphite-app bot force-pushed the 01-15-feat_support_barrel_module_optimization branch from 94bf52d to b157b0c Compare January 21, 2026 06:59

Copilot AI reviewed Jan 21, 2026

View reviewed changes

graphite-app bot merged commit b157b0c into main Jan 21, 2026
34 checks passed

graphite-app bot deleted the 01-15-feat_support_barrel_module_optimization branch January 21, 2026 07:09

graphite-app bot removed the graphite: merge-when-ready label Jan 21, 2026

shulaoda mentioned this pull request Jan 21, 2026

feat(lazy-barrel): skip plain imports in side-effect-free modules #7986

Closed

sapphi-red mentioned this pull request Jan 22, 2026

test(lazy-barrel): should load module if it may have side effects even if it's not used 2 #8009

Closed

github-actions bot mentioned this pull request Jan 22, 2026

release: v1.0.0-rc.1 #8011

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

feat: add `experimental.lazyBarrel` option#7908

feat: add `experimental.lazyBarrel` option#7908
graphite-app[bot] merged 1 commit intomainfrom
01-15-feat_support_barrel_module_optimization

shulaoda commented Jan 15, 2026

Uh oh!

shulaoda commented Jan 15, 2026 •

edited by sapphi-red

Loading

Uh oh!

github-actions bot commented Jan 15, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

netlify bot commented Jan 20, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

graphite-app bot commented Jan 21, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Comments

Conversation

shulaoda commented Jan 15, 2026

Uh oh!

shulaoda commented Jan 15, 2026 • edited by sapphi-red Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

How to use the Graphite Merge Queue

Uh oh!

github-actions bot commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Benchmarks Rust

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

netlify bot commented Jan 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for rolldown-rs ready!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

graphite-app bot commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merge activity

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

shulaoda commented Jan 15, 2026 •

edited by sapphi-red

Loading

github-actions bot commented Jan 15, 2026 •

edited

Loading

netlify bot commented Jan 20, 2026 •

edited

Loading

graphite-app bot commented Jan 21, 2026 •

edited

Loading