NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
npm
npm, #1707 most downloaded on npm
Fast JavaScript/TypeScript bundler in Rust with Rollup-compatible API.
Latest stable
1.3.1
Last release 13 days ago
09 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Most releases are documented
notes for 43 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
654 releases Β· first in 2017
Drag across the ruler to compare, or tap a release to open it.
inline-common-chunks: inline chunks using import.meta.ROLLDOWN_FILE_URL_* (#11543) by @mattlewis92
import.meta.ROLLDOWN_FILE_URL_* (#11543) by @mattlewis92this.resolve custom options apart for overlapping calls (#11505) by @wan9chithis of a required module without module syntax as its exports (#11271) by @sarankumar1325dynamicImports (#11156) by @kkkhsvp first in setup commands (#11503) by @IWANABETHATGUYCodSpeedHQ/action to v5.6.3 for Ubuntu 26.04 (#11575) by @hyfdev.typos.toml (#11571) by @iiio2Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
Your coding agent can read these notes before it upgrades. Set up the MCP server β
It adds experimental support for import attributes, and some changes alter default behavior compared to 1.2.16. Please read Breaking changes before upβ¦
[!IMPORTANT] This is a minor release. It adds experimental support for import attributes, and some changes alter default behavior compared to
1.2.16. Please read Breaking changes before upgrading.
[!WARNING] Vite users: Please do not force
rolldown@1.3.0into Vite withoverridesorresolutionsyet. Vite 8.3.6 and earlier need changes to work with it. Vite pins itsrolldownversion, so a normal install is not affected. Please wait for a Vite release that supports Rolldown 1.3.
Import attributes are the with { ... } part of an import. Node.js and browsers require them for JSON and CSS module scripts, so they are common in code written for these runtimes.
import config from './config.json' with { type: 'json' };
import shader from './shader.glsl' with { type: 'text' };
import wasm from './module.wasm' with { type: 'bytes' };
With experimental.importAttributes:
type: 'json', 'text' and 'bytes' work without a plugin.resolveId, load and transform, and change them in resolveId.// rolldown.config.js
export default {
experimental: {
importAttributes: true,
},
};
The design follows Rollup 5. The option is off by default, because it changes the id of modules imported with attributes, and plugins that use the id as a file path can break.
Rolldown's dev mode and Vite do not support it yet. See the Import Attributes guide for details and plugin migration.
With devtools: { mode: 'report' }, Rolldown writes small Markdown and JSON files about each build to node_modules/.rolldown/report/. A coding agent can read the numbers directly, and does not need scripts to parse a large event log. People and CI can use them too.
// rolldown.config.js
export default {
devtools: { mode: 'report' },
};
The report shows:
transform hooks.metrics.json, and complete graphs in module-graph.json and chunk-graph.json.See the Build Report guide for how to read each file and how to use the numbers in CI.
@rolldown/perf-kit (experimental)@rolldown/perf-kit is a new package that consumes the data from devtools: { mode: 'report' } and adds its own measurements. An agent or a person can use the processed data to improve LCP, FCP and startup time. A fixed baseline and a check of the rendered output show which changes to keep.
npx @rolldown/perf-kit help
It measures 3 targets:
scan). The build needs sourcemaps.node-scan).worker-scan).See the Perf Kit guide for the agent prompts and more details.
We compared an agent alone with an agent using perf-kit on 3 open-source Cloudflare Workers. The prompts, results and steps to reproduce are in perf-kit-worker-startup.
<p> <img width="45%" alt="Worker startup per app" src="https://github.com/user-attachments/assets/e9549835-86f4-4be0-be03-b735b6688987" /> <img width="53%" alt="Cost of one agent run" src="https://github.com/user-attachments/assets/39fa9d18-00a9-47e5-9e18-737503797fdd" /> </p>
preserveModules file names now follow Rollup (#11410, #11413)[name] now keeps non-JS extensions, so data.json becomes data.json.js instead of data.js, and Comp.vue becomes Comp.vue.js instead of Comp.js. Libraries that point exports at the old file names need to update them.
--input cannot be used together with positional entries (#11445)rolldown 1.js --input 2.js now fails. Use rolldown 1.js 2.js or rolldown --input 1.js --input 2.js.
This applies to every build, with or without experimental.importAttributes. Before, two imports of one external with different attributes became one module, and one import was lost. The legacy assert keyword was also copied to the output, which Node.js 22+ cannot load.
// input (`ext` is external)
import 'ext';
import 'ext' with { type: 'json' };
import data from 'ext2' assert { type: 'json' };
// 1.2.16 output
import 'ext' with { type: 'json' };
import data from 'ext2' assert { type: 'json' };
// 1.3.0 output, with a DEPRECATED_IMPORT_ASSERTION warning
import 'ext';
import 'ext' with { type: 'json' };
import data from 'ext2' with { type: 'json' };
Plugins now see such an external with the attributes in its id, for example ext?attributes=%7B%22type%22%3A%22json%22%7D in this.getModuleIds().
--input together with positional entries like Rollup (#11445) by @IWANABETHATGUYtype import attribute beat moduleTypes in the asset and copy plugins (#11309) by @shulaodatransform hook (#11308) by @shulaodaload hook (#11307) by @shulaodathis.resolve and this.load (#11306) by @shulaodaresolveId and resolveDynamicImport hooks (#11305) by @shulaodaexperimental.importAttributes and the module id helpers to JS (#11304) by @shulaodaNO_COLOR in error and warning diagnostics (#11499) by @shulaoda** globs from the walk root (#11495) by @shulaodaoutput.cleanDir (#11494) by @sapphi-redexport * (#11423) by @magurotunaimport() of a CommonJS module to its ESM view (#11020) by @h-a-n-anull prototype and make them non-extensible (#11428) by @IWANABETHATGUYnew URL() (#11420) by @theRizwanimport() of a side-effect-free module that exports then (#11409) by @hyfdevsanitizeFileName like Rollup (#11413) by @IWANABETHATGUYexports.x write in the same CommonJS statement (#11408) by @hyfdevmodule.exports (#11404) by @hyfdevexternalLiveBindings for star re-exports from externals in cjs (#11328) by @logaretmreturn (#11402) by @hyfdevvar that module-level code reads before its declaration (#11379) by @hyfdevvar declaration as a reassignment (#11378) by @hyfdevdrain waits for every bundler's drops (#11455) by @hyfdevfirst_quasi (#11484) by @sapphi-red@rolldown/perf-kit independently (#11394) by @shulaodaCLAUDE.md symlink note from AGENTS.md (#11384) by @iiio2> v1.2.17 was published to crates.io only. Its changes are released to npm in this version.
[!TIP] v1.2.17 was published to crates.io only. Its changes are released to npm in this version.
Co-authored-by: sapphi-red 49056869+sapphi-red@users.noreply.github.com
perf-kit: check rendered output against the original build (#11140) by @IWANABETHATGUY
'key' in ns on namespace imports with statically known exports (#11333) by @danielroeimport.meta.hot in dev mode (#11339) by @hyfdevexperimentalInlineCommonChunks in dev mode (#11335) by @hyfdevINVALID_TLA_FORMAT error for Rollup compatibility (#11266) by @sapphi-redtsconfigFilePaths for a tsconfig resolved through TsconfigCache (#11346) by @cainrusinput entries when placing the runtime (#11353) by @IWANABETHATGUYcwd as a literal path in relative glob filters (#11291) by @onmax@napi-rs/wasm-runtime to 1.2.6 (#11292) by @IWANABETHATGUYavoidRedundantChunkLoads (#11320) by @IWANABETHATGUYrenderedLength and share chunk.code across plugins (#11342) by @IWANABETHATGUYsimd-utf16-len (#11259) by @IWANABETHATGUYwatch buildDelay (#11175) by @Brooooooklyncmake-core instead of the cmake metapackage on FreeBSD (#11361) by @shulaodarolldown_plugin_vite_resolve: add isBundled to pick the browser-external stub format (#11260) by @h-a-n-a
isBundled to pick the browser-external stub format (#11260) by @h-a-n-a// <id> comments instead of #region pairs (#11235) by @IWANABETHATGUYthis.resolve recursion between plugins with skipSelf: true (#11181) by @anzal1require for ssr.target: 'webworker' (#11205) by @sapphi-redadd output.charset option (#11194) by @sapphi-red
output.charset option (#11194) by @sapphi-redoutput.charset: 'ascii' + output.minify: false (#11207) by @sapphi-redthis as a wrapper parameter rolldown names (#11135) by @IWANABETHATGUYrequire() local in a CJS module off the top-level names (#11133) by @IWANABETHATGUYclose() a no-op (#11142) by @Brooooooklynrolldown_plugin_vite_import_glob: follow file creation and deletion via hotUpdate (#10550) by @shulaoda
experimental.devMode.hotUpdate option (#11123) by @h-a-n-adevtools.sessionId by @Brooooooklynthis undefined when calling an imported function in HMR patches and lazy chunks (#11126) by @h-a-n-awith clause on bare external imports (#11100) by @IWANABETHATGUYexternalLiveBindings for imported exports (#11048) by @camc314transform with a TsconfigCache (#11080) by @shulaodadefineProperty calls (#11047) by @camc314renderChunk hook filter docs (#11065) by @sapphi-redconcat_string! instead of format! for plain string joins (#11139) by @IWANABETHATGUYconcat_string! argument once (#11105) by @IWANABETHATGUYJSON.parse string with json-escape-simd (#11104) by @IWANABETHATGUY@napi-rs/wasm-runtime to ~1.2.5 (#11117) by @shulaodainline common chunks containing import() and deduplicate shared code in lazy chunks (#11034) by @hyfdev
inlineCommonChunks support (#10899) by @hyfdevimport.meta.hot.accept deps with Vite (#10997) by @h-a-n-a__internalForcePanic (#10989) by @IWANABETHATGUYCLAUDE.md (#10925) by @iiio2watch: report only file events (#10974) by @shulaoda
collapse_sourcemaps (#9486) by @eoinadd checks.bundlerTimings with deprecated pluginTimings alias (#10883) by @IWANABETHATGUY
codeSplitting timing rows (#10916) by @IWANABETHATGUYindices option (#10934) by @shulaodaResolvedId in one place (#10921) by @IWANABETHATGUYsourcemapPathTransform calls (#10763) by @IWANABETHATGUYsourcemapIgnoreList calls (#10762) by @IWANABETHATGUYban-expect-assertions JS lint with builtin no-restricted-properties (#10933) by @iskeradd MODULE_LEVEL_DIRECTIVE warning (#10791) by @sapphi-red
MODULE_LEVEL_DIRECTIVE warning (#10791) by @sapphi-redthis (#10872) by @IWANABETHATGUYawait using as top-level await (#10739) by @MarshallOfSounddev: add hotUpdate dev option to gate the hotUpdate hook (#10837) by @h-a-n-a
hotUpdate dev option to gate the hotUpdate hook (#10837) by @h-a-n-aOutputChunk.imports (#10845) by @iskergetModuleInfo during code splitting (#10838) by @hyfdevrolldown_binding: make PreRenderedChunk.facadeModuleId nullable like Rollup (#10810) by @IWANABETHATGUY
PreRenderedChunk.facadeModuleId nullable like Rollup (#10810) by @IWANABETHATGUYminify: support property name mangling (#10374) by @Dunqing
tsconfig: string option to transform (#10727) by @sapphi-redtsconfig option (#10725) by @sapphi-redtsconfig option (#10724) by @sapphi-redcodeSplitting group callback returns a wrong type (#10753) by @IWANABETHATGUYTsconfigCache::clear is called (#10726) by @sapphi-redensureLatestBuildOutput when the engine closes (#10730) by @h-a-n-acodeSplitting group loop (#10744) by @IWANABETHATGUYcodeSplitting group test / name calls (#10745) by @IWANABETHATGUYmodule.enableCompileCache() (#10678) by @bteabench: record per-suite peak memory in the node benchmark (#10704) by @IWANABETHATGUY
tracking_allocator feature (#10703) by @IWANABETHATGUYNAMESPACE_CONFLICT warning for conflicting star re-exports (#7452) by @AliceLannisterequire/__filename/__dirname bindings in CJS output (#10655) by @marcorothrename_bindings_shadowing_cjs_ambient_names (#10672) by @IWANABETHATGUYcode-splitting: widen namespace extraction for already-loaded merges (#10594) by @IWANABETHATGUY
@rolldown/browser in a real browser page (#10634) by @hyfdev@napi-rs/wasm-runtime range to ~1.2.2 (#10615) by @hyfdevremove deprecated watch.notify option (#10628) by @sapphi-red
watch.notify option (#10628) by @sapphi-redgenerate_minified_names (#10617) by @IWANABETHATGUYcode-splitting: support inlining of shared deps in dynamic entries (#10526) by @nicolo-ribaudo
cleanDir off in dev mode (#10579) by @shulaoda?rolldown-lazy proxy ids out of user resolveId hooks (#10580) by @bteabuildStart comment in ScanStageCache::merge (#10577) by @shulaoda@rolldown/pluginutils pnpm override (#10575) by @IWANABETHATGUY@napi-rs/wasm-runtime to 1.2.2 (#10570) by @shulaodadev: support hotUpdate hook (#10305) by @h-a-n-a
hotUpdate hook (#10305) by @h-a-n-adisableWatcher through the dev engine bindings (#10474) by @shulaodaimport.meta.ROLLDOWN_FILE_URL_<referenceId>_<urlId> support to pass context to resolveFileUrl hook (#10297) by @sapphi-redimport.meta.ROLLDOWN_FILE_URL_* (#10296) by @sapphi-redresolveFileUrl plugin hook (#10291) by @sapphi-red__toESM when the importing module is tree-shaken (#10516) by @IWANABETHATGUYthen (#10480) by @hyfdevexport * as ns from (#10476) by @tbvjaos510id filters (must be a RegExp) (#10412) by @IWANABETHATGUYresolveFileUrl in a deterministic order (#10330) by @sapphi-red./foo/bar glob pattern the same as foo/bar (#10313) by @sapphi-redNODE_PATH env var resolution (#10496) by @sapphi-redGetAstBuilder on visitor/pass types (#10424) by @overlookmoteldisable_old_builder feature (#10316) by @BoshenesmExternalRequirePlugin must own its externals (#10439) by @TheAlexLichteralloc field from ScopeHoistingFinalizer (#10425) by @overlookmoteljust setup-vite the only entry point that touches vite/ (#10332) by @shulaodabindings-* (#10525) by @shulaodaruntime/index.js (#10302) by @IWANABETHATGUYdev: skip shipping factories for newly imported top-level modules (#10223) by @h-a-n-a
import.meta['url'] and import.meta['ROLLUP_FILE_URL_*'] as side-effect free (#10267) by @sapphi-redimport.meta['url'] (#10251) by @sapphi-redFILE_NOT_FOUND error (#10220) by @sapphi-redimport.meta.ROLLUP_FILE_URL_* as side-effect free (#10217) by @sapphi-red[format] in *FileNames option for ESM format should be es instead of esm (#10214) by @sapphi-redimport.meta.glob (#10167) by @sapphi-redEMPTY_IMPORT_META warning for import.meta.ROLLUP_FILE_URL_* for CJS output (#10221) by @sapphi-reddist-* to .gitignore in sourcemap-filenames/hash-final-content fixture (#10216) by @sapphi-redrolldown_plugin_vite_resolve: escape module names in generated error stubs
Co-authored-by: sapphi-red 49056869+sapphi-red@users.noreply.github.com
pin @napi-rs/wasm-runtime in the wasm32-wasi binding
Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
detect top-level import-binding reads as execution-order sensitive (#10180) by @hyf0
--configLoader=native option (#10118) by @sapphi-redbrowser: false mapped modules (#10082) by @sapphi-reddisable experimental.lazyBarrel by default (#10071) by @shulaoda
experimental.lazyBarrel by default (#10071) by @shulaodadefer_drop crashes the browser main thread (#9942) by @shulaoda
defer_drop crashes the browser main thread (#9942) by @shulaodaThese ship via the oxc_resolver 11.21.3 bump (#9841) and affect resolve.tsconfigPaths (Vite 8 resolves through oxc-resolver):
These ship via the oxc_resolver 11.21.3 bump (#9841) and affect resolve.tsconfigPaths (Vite 8 resolves through oxc-resolver):
include (oxc-project/oxc-resolver#1213). compilerOptions.paths now resolve for importers whose extension is explicitly listed in a tsconfig's include (e.g. src/**/*.vue, src/**/*.svelte). Previously oxc-resolver filtered importers by extension before evaluating the include globs, so a .vue/.svelte file listed in include never matched its project and its paths were skipped. This unblocks the default create-vite Vue + TS layout (a solution-style root plus a referenced tsconfig.app.json that declares paths and include: ["src/**/*.ts", "src/**/*.vue"]). Matches vue-tsc and svelte-check, which register these extensions via TypeScript's extraFileExtensions.tsconfig.json to a file that no project actually owns (via files / include / project references). Previously such a file inherited the outermost ancestor's paths / baseUrl, leaking aliases into files that project does not own. oxc-resolver now returns no config in that case, matching tsserver / typescript-go, which route such files to an inferred project with no aliases.chrome-tracing feature (#9773) by @hyf0manualCodeSplitting group test regex as an error (#9792) by @shulaodaoutput.file without a file name (#9789) by @shulaodaArc around sourcemap sender (#9777) by @camc314napi(ts_type) (#9737) by @sapphi-redinfer default features to reduce binary size (#9765) by @BoshenAGENTS.md test guidance for agents (#9763) by @h-a-n-aassert.deepStrictEqual instead of assert.deepEqual by using assert/strict instead of assert (#9724) by @sapphi-redrolldown_plugin_vite_* is compatible for the same minor (#9774) by @sapphi-redvp fmt on Windows (#9727) by @sapphi-redassert and recommend assert/strict (#9726) by @sapphi-redtesting: migrate test harness off deprecated inlineDynamicImports (#9710) by @IWANABETHATGUY
moduleSideEffects from a hook must take priority over the package.json#sideEffects (#9688) by @sapphi-redrolldown-runtime name for the standalone runtime chunk (#9685) by @shulaodachunk.imports by execution order (#9654) by @chuganzymoduleSideEffects precedence tests (#9689) by @sapphi-redcommentWithDev option (#9638) by @btea> This is a minor release. Two changes alter default behavior compared to 1.0.3. Please read this section before upgrading. Everything else is additiv
[!IMPORTANT] This is a minor release. Two changes alter default behavior compared to
1.0.3. Please read this section before upgrading. Everything else is additive (new features, fixes, deps).
experimental.lazyBarrel is now enabled by default (#9632)What changed. experimental.lazyBarrel now defaults to true. When a barrel module is recognized as side-effect-free, Rolldown skips compiling the re-exported modules that are never actually used.
Impact. For codebases with large barrel files (component libraries such as Ant Design, @mui/icons-material, etc.) this is a meaningful build-time speedup, and for the vast majority of projects the emitted output is unchanged. In rare cases where a barrel is incorrectly treated as side-effect-free, the optimization could drop a module that was being relied on for its side effects.
How to opt out (backward compatible).
// rolldown.config.js
export default {
experimental: { lazyBarrel: false },
}
Note: this opt-out flag is planned to be removed in a future release. If you have a case where you must turn it off, please open an issue so we can fix the underlying detection instead.
tsconfig project-reference resolution now aligns with TypeScriptUpgrading oxc_resolver (11.19.1 β 11.20.0 in #9549, then β 11.21.0 in #9634) changes how Rolldown discovers and resolves tsconfig.json, in particular for a solution-style config (one that only lists references and delegates the real settings to tsconfig.app.json / tsconfig.node.json, as Vite scaffolds), bringing it in line with how TypeScript (tsc / tsserver) itself behaves:
tsconfig: true, the default), Rolldown now searches upward from the file's directory and uses the first tsconfig.json that owns the file. A tsconfig.json owns the file when the file matches its files/include/exclude, or when one of its references matches the file. A tsconfig.json that does not own the file is skipped, and the search continues in the parent directory. When no tsconfig.json up the tree owns the file, Rolldown falls back to the outermost (topmost) one found, not the nearest. Previously the nearest tsconfig.json was used unconditionally. This mirrors how TypeScript's tsserver assigns a file to a project.references, a referenced project that includes the file now takes precedence over the root, instead of the root matching it first (this is what TypeScript already does). So that project's compilerOptions.paths now apply.allowJs (oxc-resolver #1198): whether a .js/.jsx/.mjs/.cjs file is included is now decided by each referenced project's own allowJs, not the root's (again matching TypeScript). So tsconfig.app.json with allowJs: true + paths now resolves aliases for .js files even when the root doesn't set allowJs.For most projects this is a fix (the standard Vite paths aliases now resolve, closes rolldown/rolldown#8468), but it is a behavior change if you relied on the previous behavior, where the root's paths / allowJs took precedence.
If you relied on the old "root wins" behavior. There is no exact toggle back, because the old behavior was the bug being fixed. The recommended path is to align your config with TypeScript: declare the paths / allowJs on the referenced project that actually owns the files.
If you must keep the old precedence while still using references: a referenced project's match wins, and the first matching references entry takes priority (the root is only a fallback when no reference claims the file). So extract the old root settings into their own config and list it first:
// tsconfig.json (solution root)
{
"files": [],
"references": [
{ "path": "./tsconfig.base.json" }, // old root paths/allowJs β listed first, so it wins
{ "path": "./tsconfig.app.json" },
{ "path": "./tsconfig.node.json" }
]
}
tsconfig.base.json should carry the paths you previously declared on the root, plus allowJs: true if it needs to claim .js files (the extension is checked against each config's own allowJs). With no include, it defaults to **/* under its directory and claims every file first.
One consequence of the new walk-up behavior to keep in mind: this solution root (files: [], only references) has no file patterns of its own, so it owns a file only when one of its references matches it. When no tsconfig.json owns the file (for example a file outside tsconfig.base.json's directory), Rolldown does not fall back to this tsconfig.json. It keeps searching upward through ancestor directories. Before this release the nearest tsconfig.json was used unconditionally, so such files previously stopped at this solution root.
Alternatively, bypass reference resolution entirely by pointing the top-level tsconfig option at a single config: export default { tsconfig: './tsconfig.app.json' }.
experimental.lazyBarrel by default (#9632) by @shulaodaimport.meta.glob support caseSensitive option (#9594) by @bteaSOURCEMAP_BROKEN warning for renderChunk hook (#9601) by @sapphi-redSOURCEMAP_BROKEN warning for transform hook (#9600) by @sapphi-red@__NO_SIDE_EFFECTS__ hint for invalid @__PURE__ before function declarations (#9505) by @CopilotincludeDependenciesRecursively (#9587) by @hyf0rolldown package (#9629) by @sapphi-redImportStatus variants (#9606) by @BoshenRolldownBuild::close method should be called in most cases (#9619) by @sapphi-redskip Playwright browser downloads in release builds and Docs Validation
Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
transform: respect decorator strictNullChecks option (#9580) by @kylecannon
defer keyword (#9503) by @TheAlexLichteronOutput called twice when initial build fails (#9552) by @hyf0ensureCurrentBuildFinish not returning error when engine closes (#9564) by @h-a-n-arolldown dep through the workspace (#9510) by @Boshenmap: null vs map: undefined in transform hook output (#9497) by @sapphi-red_reExport construction with a direct call to avoid calling clone_in (#9501) by @Dunqingdevtools: emit package size in PackageGraphReady (#9434) by @IWANABETHATGUY
include and exclude (#9395) by @h-a-n-acodeSplitting.groups[].name in deterministic order (#9457) by @sapphi-redresolve_id idempotent when the resolved id is already a lazy entry (#9439) by @h-a-n-aThreadsafeFunction::call_async_catch (#9390) by @sapphi-redInter with system font stack in OG template SVG (#9240) by @yvbopengoutput.comments warning as all issues have been resolved (#9393) by @sapphi-redlegal_comments_inline test (#9394) by @sapphi-redtodo, unimplemented, and print_stderr clippy lints (#9412) by @Boshenpip install setuptools workaround for node-gyp on macOS (#9370) by @sapphi-redexperimental/lazy-barrel: advice on oversized barrel modules (#9236) by @shulaoda
enum_eval for transformSync and vite TS transform (#9325) by @DunqingresolveSubpathImports callback (#9355) by @sapphi-redtopLevelVar (#9380) by @IWANABETHATGUY$initial group (#9376) by @hyf0@rolldown/pluginutils to rolldown/plugins (#9317) by @shulaodaigorskyflyer/action-readfile with cat (#9369) by @sapphi-reddev/lazy: lazily compiled modules should be watched (#9301) by @h-a-n-a
optimization: default unspecified inlineConst.mode to smart (#9248) by @IWANABETHATGUY
this.emitFile chunk path synchronous to avoid deadlock (#9031) by @lazarvbrowser: false ignored modules (#9192) by @shulaoda-- separator before forwarded args in vp run (#9246) by @shulaodalink: error on missing export between TS modules (#9197) by @IWANABETHATGUY
this.resolve() returns null for bare relative paths without importer (#9142) by @CopilotRenderedModule (#9147) by @sapphi-redplayground/lazy-compilation (#7974) by @hyf0ci: windows (#9153) by @hyf0const enum cross-module inlining support (#8796) by @Dunqing
cb reference after __commonJS factory initialization (#9067) by @hyf0-agent@__NO_SIDE_EFFECTS__ wrapper should not remove dynamic imports (#9075) by @IWANABETHATGUYoptions hook behavior difference with Rollup in watch mode (#9053) by @sapphi-redgenerate_transitive_esm_init to iterative (#9046) by @IWANABETHATGUYextendedTests: false shorthand in test config (#9050) by @hyf0prevent stack overflow in generate_transitive_esm_init on circular dependencies (#9041) by @shulaoda
generate_transitive_esm_init on circular dependencies (#9041) by @shulaodarust: add disable_panic_hook feature to disable the panic hook (#9023) by @sapphi-red
disable_panic_hook feature to disable the panic hook (#9023) by @sapphi-redadd friendly error for unloadable virtual modules (#8955) by @sapphi-red
meta.chunks in renderChunk hook (#8956) by @sapphi-redvite-test-ubuntu when build is skipped (#8934) by @Copilotcreate_ecma_view return destructuring and remove redundant binding (#8932) by @shulaoda@emnapi/runtime and @emnapi/core as direct deps of @rolldown/browser (#8978) by @Copilottype-check scripts (#8957) by @sapphi-redchunk-optimizer: skip circular dependency check when strict execution order is enabled (#8886) by @hyf0
entriesAware should calculate sizes without duplication (#8887) by @hyf0is_top_level incorrectly treats strict-mode scopes as top-level (#8878) by @DunqingmagicString replace with regex (#8802) by @IWANABETHATGUY
output.sourcemapExcludeSources option (#8828) by @sapphi-redgetIndentString in MagicString (#8775) by @IWANABETHATGUYpluginName from MinimalPluginContext (#8864) by @sapphi-redvpx instead of vp exec for pkg-pr-new (#8827) by @Boshenorder for callable plugins (#8815) by @sapphi-reddervie_entries_aware_chunk_name (#8847) by @AliceLannistecollapse_sourcemaps (#8821) by @Boshenjust setup (#8846) by @AliceLannisteexamples/lazy to examples/lazy-compilation (#8789) by @shulaodaadd indentExclusionRanges property to MagicString (#8746) by @IWANABETHATGUY
oxcRuntimePlugin (#8654) by @sapphi-redyarn_pnp option where needed (#8736) by @sapphi-redcomments.annotation: false breaking tree-shaking (#8657) by @IWANABETHATGUYCrossModuleOptimizationConfig::side_effects_free_function_optimization (#8673) by @Dunqingcross_module_optimization by removing redundant scope tracking (#8672) by @DunqingBindingIdentifierExt to use BindingIdentifier::symbol_id() instead (#8667) by @Dunqinginject option is only conceptually similar to esbuild's one (#8743) by @sapphi-reddevtools.md (#8663) by @hyf0resolve.symlinks is false (#8483) by @sapphi-redreset category in MagicString.test.ts (#8749) by @IWANABETHATGUYCODE_OF_CONDUCT.md (#8706) by @sapphi-redtype-check job (#8677) by @hyf0rename exported BindingMagicString to RolldownMagicString (#8626) by @IWANABETHATGUY
false to 'dce-only' (#8620) by @shulaoda--no-run build step from cargo-test (#8623) by @Boshencargo-shear to toggle Cargo.toml [lib] test = bool (#8622) by @Boshenwatch: enable full functional fs watcher in wasm (#8575) by @hyf0
format option to directives example config (#8590) by @shulaodaoutput.strict option (#8535) by @minsoo-webβ‘ Smarter Code Generation Defaults
β‘ Smarter Code Generation Defaults
π‘ LLM-Friendly Bundle Analyzer Reports
inlineConst: { mode: 'smart', pass: 1} by default (#8444) by @IWANABETHATGUYoffset property support (#8531) by @IWANABETHATGUYoutput.strict option to control "use strict" directive emission (#8489) by @Copilotwatcher.compareContentsForPolling (#8526) by @hyf0plugins on NormalizedInputOptions for buildStart hook (#8521) by @Copilotinvoke_sync deadlock (#8518) by @IWANABETHATGUYtopLevelVar to exported const/let declarations (#8507) by @IWANABETHATGUYnew.target (#8488) by @sapphi-redreset_closed_for_watch_mode (#8530) by @hyf0vitepress-plugin-graphviz (#8498) by @sapphi-redRolldownBuild.generate and others (#8490) by @sapphi-redformatOnSave for markdown files using oxc formatter (#8536) by @minsoo-webretry workaround from output paths test fixtures (#8520) by @Copilotdeprecate output.legalComments (#8450) by @sapphi-red
css_entry_filenames , css_chunk_filenames and related code (#8402) by @hyf0PluginOrder::PinPost (#8417) by @hyf0ModuleType:Copy (#8407) by @hyf0ESTree types from rolldown/utils (#8400) by @sapphi-red.js within "type": "commonjs" as ESM for now (#8470) by @sapphi-red.cjs / .cts / .js within "type": "commonjs" as CommonJS (#8455) by @sapphi-redrender_chunk_meta run after users plugin (#8422) by @hyf0DataUriPlugin (#8418) by @hyf0jsx.preserve should also considering tsconfig json preserve (#8324) by @IWANABETHATGUYdeferred_scan_data.rs "Should have resolved id: NotFound" error (#8379) by @sapphi-red--dir/-d and --file/-o (#8378) by @Copilotrolldown_plugin_data_uri to rolldown_plugin_data_url (#8421) by @hyf0https://rolldown.rs from links in reference docs (#8454) by @sapphi-redoutput.codeSplitting docs (#8452) by @sapphi-redoutput.comments behavior a bit (#8451) by @sapphi-redExported from for values / types exported from subpath exports (#8394) by @sapphi-redsugar_path@2 (#8432) by @hyf0_test.mjs even if executeOutput is false (#8398) by @sapphi-redexpect.assertions() as it is not concurrent test friendly (#8383) by @sapphi-redmockReset option (#8382) by @sapphi-redexpect.assertions in all fixture tests (#8395) by @sapphi-redexpect.assertions in fixture tests (#8387) by @sapphi-red_config.ts files (#8386) by @sapphi-redπ‘ Smarter entriesAware for Code Splitting
π‘ Smarter entriesAware for Code Splitting
New entriesAware and entriesAwareMergeThreshold options for codeSplitting.groups[] enable entry-reachability-based chunk splitting with automatic small chunk merging.
entriesAware: true splits matched modules by entry reachability β modules reached by the same set of entries are grouped together, providing the most precise loading behavior with less over-fetchingvendor-entry-a-entry-b.js) instead of opaque hashesentriesAwareMergeThreshold sets a byte-size threshold to merge tiny subgroups into the closest sibling with the fewest extra entries, reducing micro-chunk fragmentation while preserving precisionmaxSize: merge tiny chunks first to reduce request overhead, then cap large chunks to control payload sizecodeSplitting: {
groups: [{
name: 'vendor',
test: /node_modules/,
entriesAware: true,
entriesAwareMergeThreshold: 28000, // bytes
}]
}
Visitor to rolldown/utils (#8373) by @sapphi-redinputFormat property to ModuleInfo (#8329) by @shulaodatreeshake.invalid_import_side_effects to false (#8357) by @sapphi-redIndexBitSet (#8343) by @sapphi-redawait import().then((m) => m.prop) (#8328) by @sapphi-redentriesAwareMergeThreshold (#8312) by @hyf0maxSize will split the oversized chunk with taking file relevance into account (#8277) by @hyf0entriesAware chunks (#8275) by @hyf0entriesAware (#8274) by @hyf0minify.compress: true and minify.mangle: true with minify: true (#8367) by @sapphi-redencode_hash_with_base output to fixed length to prevent slice panics (#8320) by @shulaodaxxhash_with_base skips hashing when input is exactly 16 bytes (#8319) by @shulaodaImportKind::try_from with missing variants and correct url-import to url-token (#8310) by @shulaodaexternal config (#8304) by @IWANABETHATGUYmaxSize should split chunks correctly based on sizes (#8289) by @hyf0RawMangleOptions and RawCompressOptions (#8366) by @sapphi-redapply_manual_code_splitting into ManualSplitter (#8346) by @hyf0ModuleGroupOrigin and ModuleGroupId (#8311) by @hyf0FinalizerMutableState struct (#8303) by @shulaodafinalize_modules (#8302) by @shulaodaapply_transfer_parts_mutation into its own module (#8301) by @shulaodadetermine_export_mode (#8294) by @shulaodawarnings field from GenerateContext (#8293) by @shulaodais_in_node_modules to PathExt trait in rolldown_std_utils (#8286) by @shulaoda\0rolldown/runtime.js (#8234) by @hyf0format JSDoc from 'esm' to 'es' (#8372) by @shulaodainvalidImportSideEffects option mention from lazy barrel optimization doc (#8355) by @sapphi-redminSize constraints (#8279) by @ShroXdreport_compressed_size is disabled (#8321) by @shulaodavi.waitFor and expect.poll instead of custom waitUtil function (#8369) by @sapphi-redThe output.legalComments option is now deprecated and use comments.legal instead
π‘ Granular comments Option
output.comments option provides fine-grained control over comment preservationoutput.legalComments option is now deprecated and use comments.legal insteadRolldownError from RollupError (#8262) by @sapphi-redresolve_tsconfig function for Vite (#8257) by @sapphi-redrolldown_watcher (#8161) by @hyf0comments and legalComments into a single granular comments option (#8229) by @IWANABETHATGUYtransform (#8180) by @sapphi-redother to jsdoc in comments options (#8256) by @IWANABETHATGUYparse and parseSync (#8215) by @sapphi-redparse / minify / transform from rolldown/utils (#8214) by @sapphi-red<script> escape behavior difference note from platform option (#8253) by @sapphi-redRUSTSEC-2025-0141 cargo check error (#8235) by @hyf0β‘ Remove Unnecessary Default Export Assignment
β‘ Remove Unnecessary Default Export Assignment
// index.js
var x = 42;
export default x;
// Before
var x = 42;
var entry_default = x;
export { entry_default as default };
// After
var x = 42;
export { x as default };
π Avoid Unnecessary Facade Chunks
// main.js (entry module)
import { a } from './lib.js'
console.log(a)
// lib.js
export * from './counter.js'
// counter.js (entry module)
export const a = 100
// Before
dist/
βββ main.js β import { a } from './counter-chunk.js'; console.log(a)
βββ counter.js β export { a } from './counter-chunk.js' // β facade chunk
βββ counter-chunk.js β export const a = 100
// After
dist/
βββ main.js β import { a } from './counter.js'; console.log(a)
βββ counter.js β export const a = 100
RUNTIME_MODULE_ID constant for plugin authors (#8199) by @shulaodapreserveValueImports and importsNotUsedAsValues in tsconfig.json (#8169) by @sapphi-redinputMap option to minify / minifySync functions (#8138) by @sapphi-redthis.addWatchFile (#8198) by @hyf0RuntimeModuleTask after build_start to avoid race condition (#8182) by @shulaoda\0rolldown/runtime.js will go through transform hook and add test (#8093) by @hyf0[name] in assetFileNames does not include the directory part (#8098) by @IWANABETHATGUYUnknown resolve error error message (#8111) by @sapphi-rednot(feature = "experimental") (#8110) by @coolreader18VERSION to constants directory (#8200) by @shulaodaSymbolFlags (#8193) by @shulaodaremove instead of contains_key + remove (#8123) by @shulaodaget_barrel_normal_module (#8122) by @shulaodaresolveDynamicImport hook (#8137) by @sapphi-redthis.addWatchFile dependency should be preserved after reload (#8165) by @sapphi-redtransform_runtime_module test as ignored (#8178) by @Copilottransform_runtime_module test shouldn't panic inside (#8151) by @hyf0output.dynamicImportInCjs tests as passed (#8125) by @shulaodaHashMap::new and HashSet::new by clippy (#8135) by @sapphi-redSkips compilation of unused re-export modules in side-effect-free barrel modules
β‘ Lazy Barrel Optimization
For large component libraries like Ant Design, when you import just one component:
import { Button } from 'antd';
Button;
| Metric | Without lazy barrel | With lazy barrel |
|---|---|---|
| Modules compiled | 2986 | 250 |
| Build time (macOS) | ~65ms | ~28ms |
| Build time (Windows) | ~210ms | ~50ms |
By enabling lazy barrel, Rolldown reduces the number of compiled modules by 90% and speeds up the build by 2-4x.
Enable it in your config:
export default {
experimental: {
lazyBarrel: true,
},
};
For more details, see the https://rolldown.rs/in-depth/lazy-barrel-optimization
\0rolldown/runtime in transform hook (#8068) by @hyf0rolldown:runtime to \0rolldown/runtime.js (#8067) by @hyf0this.emitFile with type: 'prebuilt-chunk' (#8062) by @sapphi-rednew URL error diagnostic (#8043) by @valadaptivenew URL imports (#8035) by @valadaptiveChunk#id to Chunk#chunk_id (#8040) by @hyf0__exportAll parameter logic to reduce default output size (#8036) by @Copilot</script tag search should be case insensitive (#8033) by @IWANABETHATGUY. (#8029) by @Copilotthis to undefined (#8020) by @hyf0output.generatedCode.preset: 'es2015' was not set by default (#8026) by @sapphi-redoutput.strictExecutionOrder by the option validator (#8022) by @sapphi-redthis from on / off methods of RolldownWatcher (#8015) by @sapphi-reduse_built_ins and use_spread from internal JSX options (#8079) by @sapphi-redexperimental.transformHiresSourcemap (#8055) by @Copilotis_data_url more consistently (#8042) by @valadaptiveFxIndexMap to store EntryPoint (#8032) by @IWANABETHATGUY{@include ./foo.md} from d.ts files (#8056) by @sapphi-redadd codeSplitting: boolean and deprecate inlineDynamicImports (#7870) by @hyf0
experimental.lazyBarrel option (#7908) by @shulaodainvalidImportSideEffects option (#7958) by @shulaodastrictExecutionOrder and move to output.strictExecutionOrder from experimental.strictExecutionOrder (#7901) by @sapphi-redcodeSplitting: boolean and deprecate inlineDynamicImports (#7870) by @hyf0/@vite/lazy from /lazy (#7884) by @sapphi-red</script> to escape template literals (#7987) by @IWANABETHATGUYkind from this.resolve (#7981) by @sapphi-red@vite-ignore to lazy compilation proxy module import (#7883) by @sapphi-red.parse (#7966) by @sapphi-redImportRecordMeta::IsPlainImport (#7948) by @shulaodatry_spawn_with_cache (#7920) by @shulaodaImportStatus::NoMatch to unit variant (#7909) by @shulaodadevEngine.compileEntry does not return null (#7882) by @sapphi-redclientId property to DevRuntime base class (#7880) by @sapphi-redvitepress-plugin-group-icons (#7947) by @yuyinwsbuild() API as experimental (#7954) by @sapphi-redwith_scope_tree_child_ids(true) for SemanticBuilder (#7995) by @DunqingModuleTaskOwner construction until needed (#7921) by @shulaodarename_non_root_symbol pass (#7867) by @Dunqingtagged_template_transform uncondionally (#7975) by @IWANABETHATGUYcollect_depended_symbols (#7888) by @shulaodaNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.