Rolldown Release Notes

🚀 Features

• rolldown_plugin_vite_import_glob: follow file creation and deletion via hotUpdate (#10550) by @shulaoda
• inline-common-chunks: deduplicate shared code along known loading paths (#11093) by @hyfdev
• rolldown_plugin_vite_import_glob: record a matcher per glob call in dev (#10592) by @shulaoda
• rolldown_plugin_vite_import_glob: watch the directory each glob reads (#10549) by @shulaoda
• watch: hand watch.exclude to notify as its ignore filter (#11008) by @shulaoda
• dev: add experimental.devMode.hotUpdate option (#11123) by @h-a-n-a

🐛 Bug Fixes

• renamer: check the printed name of namespace-alias imports for captures (#11129) by @IWANABETHATGUY
• devtools: honor devtools.sessionId by @Brooooooklyn
• renamer: keep a renamed nested binding off its module's top-level bindings (#11128) by @IWANABETHATGUY
• dev: keep this undefined when calling an imported function in HMR patches and lazy chunks (#11126) by @h-a-n-a
• dev: read string-named imports correctly in HMR patches and lazy chunks (#11127) by @h-a-n-a
• sanitize preserveModules chunk names after resolving the relative path (#11087) by @waltuov
• keep the with clause on bare external imports (#11100) by @IWANABETHATGUY
• generator: filter DISABLE_JS_HOOK bits from generated HookUsage (#10346) by @Brooooooklyn
• dev: make the module factory async for top-level await (#11118) by @h-a-n-a
• node: give each renderChunk call its own meta object (#11115) by @Brooooooklyn …

🚀 Features

• inline common chunks containing import() and deduplicate shared code in lazy chunks (#11034) by @hyfdev
• experimental inlineCommonChunks support (#10899) by @hyfdev
• dev: ship imported bindings for HMR partial accept (#10856) by @h-a-n-a

🐛 Bug Fixes

• chunking: re-derive chunk exec orders after the runtime leaves its host chunk (#11005) by @hyfdev
• code-splitting: gate member-read init paths on the reading statement (#11039) by @hyfdev
• code-splitting: retain initialization paths through re-exported namespaces (#11037) by @hyfdev
• dev: reject non-ESM output formats in dev mode (#11038) by @h-a-n-a
• dev: align import.meta.hot.accept deps with Vite (#10997) by @h-a-n-a
• dev: clear the resolver cache when a file is created or deleted (#10986) by @waltuov
• error: name the resolved specifier in unresolved import diagnostics (#11014) by @linyiru
• make entries-aware chunk merging deterministic (#11002) by @hyfdev
• watch: avoid restarting macOS watcher for unchanged paths (#10992) by @sep2

🚜 Refactor

• dev: ship the dev runtime entry as one file (#10998) by @h-a-n-a
• binding: remove __internalForcePanic (#10989) by @IWANABETHATGUY

📚 Documentation

• fix cloudflare preview builds (#10996) by @sapphi-red
• fix build config loader warning (#10994) by @sapphi-red
• deps: use Vite 8 (#10993) by @sapphi-red

⚡ Performance

• dev: only ship rows with dynamic edges in registerGraph (#11019) by @h-a-n-a

🧪 Testing …

🚀 Features

• watch: report only file events (#10974) by @shulaoda

🐛 Bug Fixes

• sourcemap: preserve names through collapse_sourcemaps (#9486) by @eoin
• watch: map metadata events by kind and missing paths as deleted (#10973) by @shulaoda

🚜 Refactor

• rolldown_fs_watcher: hand the handler file events instead of notify results (#10980) by @shulaoda
• rolldown_fs_watcher: share one event handler adapter between the notify watchers (#10979) by @shulaoda
• rolldown_fs_watcher: register every path with one watch mode (#10978) by @shulaoda
• rolldown_fs_watcher: tweak the backend traits and the event mapping (#10977) by @shulaoda
• watch: translate notify events inside FsWatcher (#10972) by @shulaoda

📚 Documentation

• watch: update the fs watcher layout and the dev coordinator message (#10981) by @shulaoda
• watch: document the event translation in FsWatcher (#10975) by @shulaoda

◀️ Revert

• "perf(dev/lazy): fetch a lazy route in one request" (#10789) (#10982) by @h-a-n-a

❤️ New Contributors

• @eoin made their first contribution in #9486

🚀 Features

• rolldown_plugin_esm_external_require: prefer 'module.exports' over a namespace spread (#10901) by @isker
• watch: support directories in addWatchFile (#10944) by @shulaoda
• label code-splitting timing rows (#10896) by @IWANABETHATGUY
• separate code-splitting group timing rows (#10892) by @IWANABETHATGUY
• clarify callback owners in the timing report (#10890) by @IWANABETHATGUY
• add checks.bundlerTimings with deprecated pluginTimings alias (#10883) by @IWANABETHATGUY

🐛 Bug Fixes

• code-splitting: initialize leaves behind a re-exported namespace import (#10694) by @hyfdev
• node: record the WASI target on the WebContainer binding fallback (#10952) by @shulaoda
• dev: force incremental build on in DevEngine::new (#10958) by @o-alexandrov
• tree-shaking: propagate side effects through cycles (#10893) by @IWANABETHATGUY
• deconflict CJS locals that shadow a renamed require wrapper (#10793) by @logaretm
• include group indexes in labeled codeSplitting timing rows (#10916) by @IWANABETHATGUY
• docs: type-check Algolia indices option (#10934) by @shulaoda
• docs: restore Algolia search (#10929) by @isker
• tell code-splitting timing rows apart by position (#10903) by @IWANABETHATGUY

🚜 Refactor

• rolldown_fs_watcher: remove the single-path API (#10950) by @shulaoda
• dev: register watch files through FsWatcher (#10949) by @shulaoda
• watch: let FsWatcher own the watched paths (#10948) by @shulaoda …

🚀 Features

• add MODULE_LEVEL_DIRECTIVE warning (#10791) by @sapphi-red

🐛 Bug Fixes

• handle CommonJS exports through top-level this (#10872) by @IWANABETHATGUY
• scripts: make setup-vite CLI invocation work on Windows (#10885) by @shulaoda
• remove deleted property from output bundle proxy target (#10815) by @Vladexy88x
• treat module-scope await using as top-level await (#10739) by @MarshallOfSound
• watch: preserve plugin attribution in warnings (#10473) by @Nic-Polumeyv
• test-dev-server: link the workspace rolldown before building vite (#10857) by @h-a-n-a
• minify: preserve annotation comments when minified (#10854) (#10855) by @justonemorenight

⚡ Performance

• dev/lazy: fetch a lazy route in one request (#10789) by @h-a-n-a
• plugin: reduce binding binary size (#10776) by @Boshen
• vite-reporter: reuse emitted sourcemap sizes (#10841) by @hyfdev

🧪 Testing

• dev: full-bundle-mode regression test for cyclic import binding (#9946) (#9947) by @ShMcK
• cover asset option callback timings (#10870) by @IWANABETHATGUY

⚙️ Miscellaneous Tasks

• wait for npm bindings before publishing rolldown (#10866) by @shulaoda
• deps: update dependency @napi-rs/cli to v3.10.1 (#10889) by @renovate[bot]
• deps: update napi (#10888) by @renovate[bot]
• compress debug info archives with zstd (#10778) by @IWANABETHATGUY
• publish split debug info for release bindings (#10777) by @IWANABETHATGUY …

🚀 Features

• dev: add hotUpdate dev option to gate the hotUpdate hook (#10837) by @h-a-n-a
• docs: add wrangler (#10821) by @mdong1909

🐛 Bug Fixes

• dev: clean stale dynamic entry references after partial scans (#10846) by @shulaoda
• include external wildcard re-exports in OutputChunk.imports (#10845) by @isker

📚 Documentation

• document dynamic entry cache merging after partial scans (#10848) by @shulaoda

⚡ Performance

• cache getModuleInfo during code splitting (#10838) by @hyfdev

🧪 Testing

• dev: cover stale dynamic entry references after partial scans (#10847) by @shulaoda

⚙️ Miscellaneous Tasks

• deps: update dependency @napi-rs/cli to v3.9.0 (#10816) by @renovate[bot]
• deps: update dependency rolldown-plugin-dts to v0.28.5 (#10827) by @renovate[bot]
• deps: update dependency vite-plus to v0.3.1 (#10842) by @renovate[bot]
• deps: upgrade oxc to 0.149.0 (#10834) by @camc314
• deps: update rust crates (#10830) by @renovate[bot]
• deps: update npm packages (#10832) by @renovate[bot]
• deps: update crate-ci/typos action to v1.50.1 (#10824) by @renovate[bot]
• deps: update test262 submodule for tests (#10836) by @rolldown-guard[bot]
• deps: update github actions (#10831) by @renovate[bot]
• deps: update dependency rust to v1.98.1 (#10819) by @renovate[bot]

❤️ New Contributors

• @isker made their first contribution in #10845

🐛 Bug Fixes

• rolldown_binding: make PreRenderedChunk.facadeModuleId nullable like Rollup (#10810) by @IWANABETHATGUY
• plugin_timings: reword the warning so it does not contradict itself (#10788) by @IWANABETHATGUY
• model a facade's host import in the fold cycle check (#10743) by @ulrichstark

🧪 Testing

• dev: add circular reexport test (#10563) by @sapphi-red

⚙️ Miscellaneous Tasks

• deps: update npm packages (#10795) by @renovate[bot]
• deps: update rust crates (#10794) by @renovate[bot]
• deps: update dependency rolldown-plugin-dts to v0.28.3 (#10805) by @renovate[bot]
• renovate: disable oxc auto-updates (#10813) by @IWANABETHATGUY
• deps: upgrade oxc to 0.148.0 (#10809) by @camc314
• deps: update pnpm to v11.24.0 (#10803) by @renovate[bot]
• deps: update crate-ci/typos action to v1.50.0 (#10806) by @renovate[bot]
• deps: update test262 submodule for tests (#10808) by @rolldown-guard[bot]
• deps: update rollup submodule for tests to v4.63.1 (#10807) by @rolldown-guard[bot]
• deps: update crate-ci/typos action to v1.49.1 (#10796) by @renovate[bot]
• deps: update github actions (#10749) by @renovate[bot]

🚀 Features

• minify: support property name mangling (#10374) by @Dunqing
• add tsconfig: string option to transform (#10727) by @sapphi-red
• rolldown_plugin_vite_transform: add tsconfig option (#10725) by @sapphi-red
• rolldown_plugin_vite_resolve: add top-level tsconfig option (#10724) by @sapphi-red
• dev: expose module graph queries on the dev engine handle (#10716) by @h-a-n-a

🐛 Bug Fixes

• dev: assign import bindings before initializing dependencies (#10783) by @h-a-n-a
• dev: copy star re-exports before initializing dependencies (#10761) by @h-a-n-a
• dev: register an empty exports object for a module without exports (#10772) by @h-a-n-a
• name the module when a codeSplitting group callback returns a wrong type (#10753) by @IWANABETHATGUY
• dev: map dev rename events like build watch (#10758) by @shulaoda
• clear resolution cache when TsconfigCache::clear is called (#10726) by @sapphi-red
• dev: resolve in-flight ensureLatestBuildOutput when the engine closes (#10730) by @h-a-n-a
• binding: replace undeclared BindingErrorsOr with BindingResult in hook types (#10717) by @h-a-n-a

🚜 Refactor

• rolldown_fs_watcher: collapse fs-watcher backends behind a single FsWatcher (#10735) by @shulaoda
• hoist invariants out of the codeSplitting group loop (#10744) by @IWANABETHATGUY

📚 Documentation

• document shared notify rename mapping (#10759) by @shulaoda
• update watch-mode internals for unified FsWatcher (#10736) by @shulaoda …

🚀 Features

• bench: record per-suite peak memory in the node benchmark (#10704) by @IWANABETHATGUY
• binding: allocation-tracking global allocator behind the tracking_allocator feature (#10703) by @IWANABETHATGUY
• add armv7 android (armv7-linux-androideabi) support (#10691) by @shulaoda
• add NAMESPACE_CONFLICT warning for conflicting star re-exports (#7452) by @AliceLanniste

🐛 Bug Fixes

• rolldown_plugin_vite_reporter: avoid ANSI erase-line escape in non-TTY output (#10692) by @shulaoda
• rolldown_plugin_vite_resolve: preserve Yarn PnP virtual importer (#10591) by @Freakazo
• exclude hash placeholders from case-insensitive filename deconfliction (#10590) by @Nic-Polumeyv
• code-splitting: fold already-loaded side-effectful libraries into eager entries (#10645) by @JoviDeCroock
• dev: flush re-emitted assets when their content changes (#10637) by @btea
• renamer: rename nested require/__filename/__dirname bindings in CJS output (#10655) by @marcoroth
• silence two wasm-only warnings (#10668) by @IWANABETHATGUY

🚜 Refactor

• skip case folding for filenames with hash placeholders (#10689) by @hyfdev
• code-splitting: remove redundant synthetic statement owner (#10503) by @hyfdev
• renamer: move the cjs check into rename_bindings_shadowing_cjs_ambient_names (#10672) by @IWANABETHATGUY

📚 Documentation

• agents: point the never-edit list at the binding files that exist (#10719) by @melbinjp

🧪 Testing …

🚀 Features

• code-splitting: widen namespace extraction for already-loaded merges (#10594) by @IWANABETHATGUY

🐛 Bug Fixes

• binding: illegal instruction crash on Android arm64 (#10638) by @shulaoda
• code-splitting: stop negated sideEffects globs retaining modules (#10660) by @JoviDeCroock
• devtools: resolve log paths against the build cwd (#10622) by @hyfdev

📚 Documentation

• plugin-api: document sourcemap differences from Rollup (#10636) by @IWANABETHATGUY

🧪 Testing

• browser: smoke test the packed @rolldown/browser in a real browser page (#10634) by @hyfdev
• node-wasi: run the full node test suite against the WASI binding (#10616) by @hyfdev
• webcontainer: smoke test the packed WASI artifacts inside a WebContainer (#10626) by @hyfdev

⚙️ Miscellaneous Tasks

• deps: update napi (#10649) by @renovate[bot]
• deps: update esbuild for tests to 0.28.2 (#10662) by @rolldown-guard[bot]
• deps: update test262 submodule for tests (#10663) by @rolldown-guard[bot]
• deps: update npm packages (#10653) by @renovate[bot]
• deps: update github actions (#10651) by @renovate[bot]
• deps: update crate-ci/typos action to v1.49.0 (#10642) by @renovate[bot]
• deps: update dependency vite-plus to v0.2.9 (#10627) by @renovate[bot]
• deps: update rust crates (#10652) by @renovate[bot]
• deps: upgrade oxc to 0.144.0 (#10657) by @camc314
• ignore napi-rs temp files (#10658) by @camc314
• deps: tighten @napi-rs/wasm-runtime range to ~1.2.2 (#10615) by @hyfdev…

🐛 Bug Fixes

• dev: don't let a failed watch registration abort the batch (#10548) by @shulaoda

🚜 Refactor

• remove deprecated watch.notify option (#10628) by @sapphi-red

📚 Documentation

• fix the dangling spec link on generate_minified_names (#10617) by @IWANABETHATGUY

⚡ Performance

• reduce finalization memory usage (#10554) by @ericclemmons
• chunk-naming: build minified export names without allocating (#10618) by @IWANABETHATGUY

🧪 Testing

• resolve-file-url: allow a reference id to start with a digit (#10623) by @jjb
• code-splitting: pin the already-loaded namespace-extraction boundaries (#10593) by @IWANABETHATGUY

⚙️ Miscellaneous Tasks

• deps: upgrade oxc to 0.143.0 (#10603) by @camc314
• deps: update rollup submodule for tests to v4.62.4 (#10607) by @rolldown-guard[bot]
• deps: update test262 submodule for tests (#10608) by @rolldown-guard[bot]

❤️ New Contributors

• @ericclemmons made their first contribution in #10554
• @jjb made their first contribution in #10623

🚀 Features

• code-splitting: support inlining of shared deps in dynamic entries (#10526) by @nicolo-ribaudo
• plugin: time the user callbacks configured on the options (#10509) by @IWANABETHATGUY

🐛 Bug Fixes

• dev: force cleanDir off in dev mode (#10579) by @shulaoda
• dev: keep ?rolldown-lazy proxy ids out of user resolveId hooks (#10580) by @btea
• initialize re-exported wrapped ESM modules at the entry chunk (#10567) by @hyfdev
• link: resolve circular star reexports as null (#10445) by @Nic-Polumeyv
• transform: transformer gate skips newer syntax that oxc can lower (#10564) by @sekyungk
• code-splitting: materialize consumer-local barrel routing when the order-wrap plan is empty (#10544) by @hyfdev
• plugin: measure plugin hooks in JavaScript, report them from Rust (#10508) by @IWANABETHATGUY
• plugin: include external dynamic imports in chunk metadata (#10557) by @hyfdev
• plugin: report plugin timings after closeBundle has run (#10521) by @IWANABETHATGUY
• browser: avoid using node builtin modules (#10542) by @sapphi-red

🚜 Refactor

• plugin: give the build's own clocks their own type (#10520) by @shulaoda

📚 Documentation

• correct stale buildStart comment in ScanStageCache::merge (#10577) by @shulaoda
• update outdated pluginutils references (#10574) by @dogledogle

⚡ Performance

• external: drop the runtime import from chunks that never wrap (#10517) by @IWANABETHATGUY …

🚀 Features

• dev: support hotUpdate hook (#10305) by @h-a-n-a
• dev: expose disableWatcher through the dev engine bindings (#10474) by @shulaoda
• plugin: surface output-option callbacks in [PLUGIN_TIMINGS] (#10411) by @IWANABETHATGUY
• import.meta.ROLLDOWN_FILE_URL_<referenceId>_<urlId> support to pass context to resolveFileUrl hook (#10297) by @sapphi-red
• dev: skip the HMR update when a module's rebuilt output is unchanged (#10333) by @h-a-n-a
• code-splitting: wrap strict execution order modules on demand (#10104) by @hyfdev
• support import.meta.ROLLDOWN_FILE_URL_* (#10296) by @sapphi-red
• implement resolveFileUrl plugin hook (#10291) by @sapphi-red
• magic-string: support storeName on overwrite/update (#10312) by @IWANABETHATGUY

🐛 Bug Fixes

• external: keep __toESM when the importing module is tree-shaken (#10516) by @IWANABETHATGUY
• dev: resolve re-exports from externals through a real import (#10489) by @tbvjaos510
• code-splitting: route CJS barrel initialization per consumer (#10488) by @hyfdev
• error: align filename-pattern diagnostics with Rollup's wording (#10501) by @IWANABETHATGUY
• plugin: validate emitted prebuilt-chunk file names (#10399) by @IWANABETHATGUY
• code-splitting: point a two-argument dynamic import at the chunk that holds the module (#10479) by @hyfdev
• common: align is_path_fragment with Rollup's isPathFragment (#10398) by @IWANABETHATGUY …

🚀 Features

• dev: skip shipping factories for newly imported top-level modules (#10223) by @h-a-n-a
• dev: per-client ship map for HMR patch sizing (#10208) by @h-a-n-a
• dev: client-side HMR (#10164) by @h-a-n-a
• dev: send a full-reload update to clients when a tsconfig changes (#10262) by @shulaoda
• treat import.meta['url'] and import.meta['ROLLUP_FILE_URL_*'] as side-effect free (#10267) by @sapphi-red
• rewrite import.meta['url'] (#10251) by @sapphi-red
• add FILE_NOT_FOUND error (#10220) by @sapphi-red
• treat import.meta.ROLLUP_FILE_URL_* as side-effect free (#10217) by @sapphi-red

🐛 Bug Fixes

• sourcemap: preserve unmapped boundaries during composition (#10254) by @hyfdev
• [format] in *FileNames option for ESM format should be es instead of esm (#10214) by @sapphi-red
• sourcemap: preserve coarse mappings during composition (#10249) by @hyfdev
• rolldown_plugin_vite_import_glob: support tsconfig paths with import.meta.glob (#10167) by @sapphi-red
• dev: clear tsconfig caches for bare full builds (#10276) by @shulaoda
• dev: force a full rebuild when a tsconfig changes (#10261) by @shulaoda
• treat rooted drive-less module ids as absolute in preserveModules naming (#10235) by @IWANABETHATGUY
• watch: rebuild when tsconfig files change (#10258) by @shulaoda
• watch: drop tsconfig-merged transform options on each rebuild (#10257) by @shulaoda …

🚀 Features

• detect top-level import-binding reads as execution-order sensitive (#10180) by @hyf0
• sourcemap_filenames: add a sourcemapFileNames option (#9271) by @V1OL3TF0X
• binding: record plugin hook result kind in tracing spans (#10154) by @IWANABETHATGUY
• linking: skip side-effect-free modules in per-entry reachability (#10111) by @IWANABETHATGUY
• improve error message for unresolved virtual imports (#10156) by @sapphi-red
• add descriptive metadata to plugin API (#10106) by @sapphi-red
• add --configLoader=native option (#10118) by @sapphi-red

🐛 Bug Fixes

• improve invalid annotation warnings (#10185) by @hyf0
• keep deduplicated asset filenames stable once they can be observed (#10191) by @shulaoda
• sourcemap_filenames: use public option name in pattern errors (#10188) by @IWANABETHATGUY
• sourcemap_filenames: hash prepared sourcemap content (#10178) by @hyf0
• tree-shake unused circular declarators exported via export list (#10166) by @IWANABETHATGUY
• dev: don't panic when an HMR rebuild hits an unresolved import (#10162) by @shulaoda
• propagate errors from output.globals function (#9880) by @shulaoda
• dev: revert cache mutations when a partial scan fails (#10110) by @shulaoda
• dev: update importer relationships of cached modules in incremental build (#10107) by @shulaoda
• hmr: fall back to full reload when a changed module is not registered as executed (#10132) by @shulaoda …