@rolldown/debug
1.3.3 · 18 Nov 2026MIT312.2k / weekRepositoryHomepagenpmAtom feed
38 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
1.3.3
18 Nov 2026Show plugin timings as a table
Reset plugin module options when modules are fetched again
Prevent UMD dependencies from using host AMD loaders
Features
Show plugin timings as a table
Bug Fixes
Reset plugin module options when modules are fetched again
Prevent UMD dependencies from using host AMD loaders
Print the
urlof plugin errors and warningsKeep internal chunk exports out of dynamic import namespaces
Keep data URL modules in execution order with
chunkModulesOrder: 'module-id'Stop special-casing module ids that start with
rolldown:Join the option path in a validation warning with dots
Keep dynamic entry as the facade of its
codeSplittinggroup chunkOrder entry chunks by their first-executed module
Reject an unknown
output.esModulestringReject a
moduleSideEffectsrule withouttestandexternalInitialize an entry's re-exported modules in source order
Support function replacers in
MagicString.replace/replaceAllRelease the old name when a deduplicated asset re-picks a shorter one
Honor
output.exportsfor non-entry modules underpreserveModulesDo not treat
requirepassed as a call argument as arequire()callInclude sourcemap comments in chunk hashes
Allow plugins to be garbage collected after
bundle.close()
Performance
Keep
g/dregex flags on the fast matcherFree each module's AST as soon as it is printed
Avoid per-chunk hash sets when hashing transitive chunk dependencies
Collect cross-chunk declared symbols without a shared AppendOnlyVec
Shrink sourcemap JSON buffers before retaining them as assets
Read output chunk and asset metadata lazily in output hooks
Skip sourcemap generation in
RenderedModule::code()
1.3.2
11 Nov 2026- Removed
Drop no-op init calls from re-exports and imports
magic-string: Add a
hiresconstructor optioncjs: Provide
__dirnameand__filenameto CommonJS modules in Node ESM output
Features
magic-string: Add a
hiresconstructor optioncjs: Provide
__dirnameand__filenameto CommonJS modules in Node ESM output
Bug Fixes
strict-execution-order: Place re-export targets that no consumer selects
sourcemap: Use the
mapa hook returns with the native MagicString- Removed
Drop no-op init calls from re-exports and imports
Detect
__esModuleset withObject.defineProperty(module.exports, ...)Hoist
varin top-level catch blocks of wrapped modulesDetect top-level
awaitin top-levelcatchblockssourcemap: Keep columns when a hook returns the native MagicString
Make a module without module syntax CommonJS when it is both imported and required
Drop references in dead branches inside live functions before chunk linking
Make cross-chunk export names independent of module load order
Don't treat new URL() references as execution dependencies
Stop the options passed to hooks from keeping a build's plugins alive
strict-execution-order: Run the declaring module of an inlined constant read through a kept barrel
Hoist
varin top-level for-in and for-of heads of wrapped modulesrollup-tests: Fail the test case on assertion error in
renderErrorPreserve rendering errors when
renderErrorfailsCount emitted chunks when rendering relative-path externals
Avoid panic on
{ b: [y = 1] }destructuring in a wrapped moduletreeshaking: tree-shake statements with
instanceofthat a constant makes purerolldown: Fail the build instead of hanging when a module task panics
rolldown: Don't panic in module tasks after the build is dropped
browser: Default
cwdto/
Performance
Trace sequential sourcemap tokens with a bounded cursor
Use raw tokens when collapsing sourcemaps
magic-string: Free the index table of a MagicString returned from transform
1.3.1
9 Nov 2026inline-common-chunks: Inline chunks using
import.meta.ROLLDOWN_FILE_URL_*cli: Apply --environment before loading the binding
rolldown_plugin_vite_resolve: Escape module names in generated error stubs
Features
inline-common-chunks: Inline chunks using
import.meta.ROLLDOWN_FILE_URL_*
Bug Fixes
cli: Apply --environment before loading the binding
rolldown_plugin_vite_resolve: Escape module names in generated error stubs
Add the code location to transform logs and errors at position 0
Match sticky regexes only at the start of the string
iife/umd: Skip namespace markers when the entry has no exports
Keep a declaration's name when it clashes with an external import
Drop top-level statements made dead by imported constants before chunk linking
Keep
this.resolvecustom options apart for overlapping callstransform: Reuse TsconfigCache's answer when no tsconfig owns the file
Treat top-level
thisof a required module without module syntax as its exportsKeep side effects of a module whose exported constant is inlined
Leave same-chunk dynamic imports out of
dynamicImports
Performance
incremental: Reuse link-time facade symbols across rebuilds
incremental: Share module sourcemap chains across cache clones
chunk_optimizer: Answer runtime-merge reachability from one chunk-level graph
Send only changed chunk properties back to Rust from output hooks
1.3.0
5 Nov 2026Summary· from the note as AI read it
Read before upgrading: 7 changes to make.
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 support (experimental)
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:The same file imported with different attributes becomes different modules.
type: 'json','text'and'bytes'work without a plugin.Plugins can read the attributes in
resolveId,loadandtransform, and change them inresolveId.
// 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.
Agent-friendly build report (experimental)
With
devtools: { mode: 'report' }, Rolldown writes small Markdown and JSON files about each build tonode_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:
Packages: the largest packages, direct and transitive dependencies, and packages with more than one version.
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-kitis a new package that consumes the data fromdevtools: { 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:
A page: LCP and FCP in a throttled browser (
scan). The build needs sourcemaps.A Node.js or Deno server: the time until the server is ready (
node-scan).A Cloudflare Worker: The time in global scope (
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.
Breaking changes
preserveModulesfile names now follow Rollup (#11410, #11413)[name]now keeps non-JS extensions, sodata.jsonbecomesdata.json.jsinstead ofdata.js, andComp.vuebecomesComp.vue.jsinstead ofComp.js. Libraries that pointexportsat the old file names need to update them.CLI:
--inputcannot be used together with positional entries (#11445)rolldown 1.js --input 2.jsnow fails. Userolldown 1.js 2.jsorrolldown --input 1.js --input 2.js.Notable fixes
External imports keep their attributes correctly (#11302, #11303)
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 legacyassertkeyword 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%7Dinthis.getModuleIds().Features
Expose notify APIs
Bug Fixes
Respect
NO_COLORin error and warning diagnosticsAvoid following output directory symlinks with
output.cleanDirEscape URL in sourceMappingURL
Error when one module id resolves as both external and non-external
Give module namespace objects a
nullprototype and make them non-extensibleDerive reference ids from stable seeds for deterministic builds
Avoid inferring constants from compound CommonJS exports
Don't inline a CommonJS export that is assigned conditionally or also through
module.exportsRespect
externalLiveBindingsfor star re-exports from externals in cjsDon't export JSON keys that the finalizer inlines away from a shared chunk
Handle nullish thrown values in error summary
Don't inline a
varthat module-level code reads before its declarationTreat a repeated
vardeclaration as a reassignment
1.2.19
11 Nov 2026Update @napi-rs/cli to 3.10.12 so linux-x64-gnu runs on older CPUs
Bug Fixes
Update @napi-rs/cli to 3.10.12 so linux-x64-gnu runs on older CPUs
Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
1.2.18
9 Nov 2026rolldown_plugin_vite_resolve: Escape module names in generated error
stubs (#11585)
Tip
v1.2.17 was published to crates.io only. Its changes are released to
npm in this version.Bug Fixes
rolldown_plugin_vite_resolve: Escape module names in generated error
stubs (#11585)sourcemap: Keep only traced sources and names in module sourcemaps
(#11270) (#11587)
Miscellaneous Tasks
Co-authored-by: sapphi-red 49056869+sapphi-red@users.noreply.github.com
1.2.16
29 Oct 2026perf-kit: Check rendered output against the original build
perf-kit: node/deno server startup mode
perf-kit: Browser page-load perf harness for coding agents
Features
perf-kit: Check rendered output against the original build
perf-kit: node/deno server startup mode
perf-kit: Browser page-load perf harness for coding agents
devtools: Report mode - agent-readable build metrics report
inline-common-chunks: Print record factories parenthesized so they compile eagerly
Fold
'key' in nson namespace imports with statically known exportsinline-common-chunks: Inline chunks using
import.meta.hotin dev modeSupport
experimentalInlineCommonChunksin dev modeUse
INVALID_TLA_FORMATerror for Rollup compatibility
Bug Fixes
Await bundle.close() in loadConfig and clean up every generated config file
transform: Don't crash when the working directory has been deleted
import-glob: Follow directory symlinks on the wasm binding
tree-shaking: Preserve exported rest bindings from dynamic imports
transform: Report
tsconfigFilePathsfor a tsconfig resolved throughTsconfigCachetsconfig: Don't apply tsconfig when resolving imports from virtual modules
code-splitting: Handle emitted entries the same as
inputentries when placing the runtimeerror: Make Diagnostic::add_file idempotent
Avoid retaining callable builtin callback owners
code-splitting: Only host the runtime in a chunk that every consumer's entries load
code-splitting: Keep the source order of chunk imports
Treat
cwdas a literal path in relative glob filterschunk-import-map: Hash stable module ids so keys don't depend on the build folder
Respect CPU limits when sizing native runtime workers
Deconflict the namespace of a module without module syntax
code-splitting: Rebuild an absorbed dynamic entry's namespace from what its imports read
Escape line terminators in debug-info comments
Performance
Incremental cycle check for
avoidRedundantChunkLoadsAvoid copying module code for
renderedLengthand sharechunk.codeacross pluginsCount UTF-16 lengths with
simd-utf16-lenDon't load consola when importing rolldown
1.2.15
21 Oct 2026Mark module starts with
// <id>comments instead of#regionpairsOnly register signal-exit handler when a trace subscriber is active
Features
Mark module starts with
// <id>comments instead of#regionpairs
Bug Fixes
Only register signal-exit handler when a trace subscriber is active
1.2.14
14 Oct 2026Add
output.charsetoptionHandle
output.charset: 'ascii'+output.minify: falsetree-shake expression statements that coerce known constants
Features
Add
output.charsetoption
Bug Fixes
Handle
output.charset: 'ascii'+output.minify: falsetree-shake expression statements that coerce known constants
Report ASSIGN_TO_IMPORT for writes to re-exported namespace members
Avoid renaming entry top-level bindings onto their nested bindings
1.2.13
7 Oct 2026Sanitize preserveModules chunk names after resolving the relative path
Keep the
withclause on bare external importsHonor
externalLiveBindingsfor imported exports
Bug Fixes
Sanitize preserveModules chunk names after resolving the relative path
Keep the
withclause on bare external importsHonor
externalLiveBindingsfor imported exportsFail on chunk syntax errors and escape export names once
Escape namespace properties in IIFE and UMD output
Escape dependency paths in CJS and UMD output
Use computed access for arbitrary import names
Generate valid bindings for shimmed exports
Escape export names in
definePropertycalls
Performance
Use
concat_string!instead offormat!for plain string joinsUnwrap JSON modules with a non-object root
1.2.12
30 Sep 2026Inline common chunks containing import() and deduplicate shared code in lazy chunks
Experimental
inlineCommonChunkssupportMake entries-aware chunk merging deterministic
Features
Inline common chunks containing import() and deduplicate shared code in lazy chunks
Experimental
inlineCommonChunkssupport
Bug Fixes
Make entries-aware chunk merging deterministic
1.2.11
24 Sep 2026"perf(dev/lazy): fetch a lazy route in one request"
1.2.10
23 Sep 2026- Removed
rolldown_fs_watcher: Remove the single-path API
rolldown_plugin_esm_external_require: Prefer 'module.exports' over a namespace spread
watch: Support directories in addWatchFile
Features
rolldown_plugin_esm_external_require: Prefer 'module.exports' over a namespace spread
watch: Support directories in addWatchFile
Label code-splitting timing rows
Separate code-splitting group timing rows
Clarify callback owners in the timing report
Add checks.bundlerTimings with deprecated pluginTimings alias
Bug Fixes
code-splitting: Initialize leaves behind a re-exported namespace import
node: Record the WASI target on the WebContainer binding fallback
tree-shaking: Propagate side effects through cycles
Deconflict CJS locals that shadow a renamed require wrapper
Include group indexes in labeled
codeSplittingtiming rowsTell code-splitting timing rows apart by position
Refactor
- Removed
rolldown_fs_watcher: Remove the single-path API
Performance
Batch
sourcemapPathTransformcallsBatch
sourcemapIgnoreListcallshmr: Drop the unused kind argument from registerFactory
1.2.9
16 Sep 2026- Removed
Remove deleted property from output bundle proxy target
Add
MODULE_LEVEL_DIRECTIVEwarningHandle CommonJS exports through top-level
this
Features
Add
MODULE_LEVEL_DIRECTIVEwarning
Bug Fixes
Handle CommonJS exports through top-level
thisscripts: Make setup-vite CLI invocation work on Windows
- Removed
Remove deleted property from output bundle proxy target
Treat module-scope
await usingas top-level awaitwatch: Preserve plugin attribution in warnings
test-dev-server: Link the workspace rolldown before building vite
minify: Preserve annotation comments when minified
Performance
dev/lazy: Fetch a lazy route in one request
plugin: Reduce binding binary size
vite-reporter: Reuse emitted sourcemap sizes
1.2.8
9 Sep 2026Include external wildcard re-exports in
OutputChunk.importsCache
getModuleInfoduring code splitting
Bug Fixes
Include external wildcard re-exports in
OutputChunk.imports
Performance
Cache
getModuleInfoduring code splitting
1.2.7
2 Sep 2026rolldown_binding: Make
PreRenderedChunk.facadeModuleIdnullable like Rollupplugin_timings: Reword the warning so it does not contradict itself
Model a facade's host import in the fold cycle check
Bug Fixes
rolldown_binding: Make
PreRenderedChunk.facadeModuleIdnullable like Rollupplugin_timings: Reword the warning so it does not contradict itself
Model a facade's host import in the fold cycle check
1.2.6
26 Aug 2026minify: Support property name mangling
Add
tsconfig: stringoption totransformrolldown_plugin_vite_transform: Add
tsconfigoption
Features
minify: Support property name mangling
Add
tsconfig: stringoption totransformrolldown_plugin_vite_transform: Add
tsconfigoptionrolldown_plugin_vite_resolve: Add top-level
tsconfigoption
Bug Fixes
Name the module when a
codeSplittinggroup callback returns a wrong typeClear resolution cache when
TsconfigCache::clearis calledbinding: Replace undeclared BindingErrorsOr with BindingResult in hook types
Performance
Batch
codeSplittinggrouptest/namecallsDeduplicate used symbol ref readers
Reduce release debug formatting
Enable compiler cache via
module.enableCompileCache()Deduplicate regress codegen
1.2.5
19 Aug 2026Add armv7 android (armv7-linux-androideabi) support
Add
NAMESPACE_CONFLICTwarning for conflicting star re-exportsExclude hash placeholders from case-insensitive filename deconfliction
Features
Add armv7 android (armv7-linux-androideabi) support
Add
NAMESPACE_CONFLICTwarning for conflicting star re-exports
Bug Fixes
Exclude hash placeholders from case-insensitive filename deconfliction
Silence two wasm-only warnings
1.2.4
12 Aug 2026Only updates dependencies:vite-plus 0.2.9oxc 0.144.0
1.2.3
5 Aug 2026- Removed
Remove deprecated
watch.notifyoption Reduce finalization memory usage
chunk-naming: Build minified export names without allocating
Refactor
- Removed
Remove deprecated
watch.notifyoption
Performance
Reduce finalization memory usage
chunk-naming: Build minified export names without allocating
1.2.2
3 Aug 2026Initialize re-exported wrapped ESM modules at the entry chunk
Bug Fixes
Initialize re-exported wrapped ESM modules at the entry chunk
1.2.1
29 Jul 2026import.meta.ROLLDOWN_FILE_URL_<referenceId>_<urlId>support to pass context toresolveFileUrlhookSupport
import.meta.ROLLDOWN_FILE_URL_*Implement
resolveFileUrlplugin hook
Features
import.meta.ROLLDOWN_FILE_URL_<referenceId>_<urlId>support to pass context toresolveFileUrlhookSupport
import.meta.ROLLDOWN_FILE_URL_*Implement
resolveFileUrlplugin hook
Bug Fixes
Guarantee tokio runtime release when close rejects
Pair tokio runtime acquire and release on wasm to prevent premature shutdown
Don't body-demand modules from simulated facade chunk includes
types: Add undefined to ExistingRawSourceMap optional properties
Add EMPTY_IMPORT_META warning for non-node CJS output
Call
resolveFileUrlin a deterministic orderHandle
./foo/barglob pattern the same asfoo/bar
Performance
Use VisitJsMut in JavaScript-only AST passes
Cache the resolved glob matcher for Id/ImporterId filters
scope_hoisting: Remove
allocfield fromScopeHoistingFinalizerReduce string allocations
hmr: Remove unnecessary string allocations
Avoid allocating static strings via custom builder methods
Pass string literals to AST builder methods
Use VisitJs in JavaScript-only AST passes
Reuse normalized path buffers
1.2.0
15 Jul 2026Treat
import.meta['url']andimport.meta['ROLLUP_FILE_URL_*']as side-effect freeRewrite
import.meta['url']Add
FILE_NOT_FOUNDerror
Features
Treat
import.meta['url']andimport.meta['ROLLUP_FILE_URL_*']as side-effect freeRewrite
import.meta['url']Add
FILE_NOT_FOUNDerrorTreat
import.meta.ROLLUP_FILE_URL_*as side-effect free
Bug Fixes
format: In
*FileNamesoption for ESM format should beesinstead ofesmTreat rooted drive-less module ids as absolute in preserveModules naming
Incorrect
EMPTY_IMPORT_METAwarning forimport.meta.ROLLUP_FILE_URL_*for CJS output
Performance
Avoid redundant sourcemap string copies in collapse and minify paths
1.1.8
11 Nov 2026Build linux-x64-gnu binding for baseline x86-64 CPUs
Bug Fixes
Build linux-x64-gnu binding for baseline x86-64 CPUs
Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
1.1.6
9 Nov 2026Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
Miscellaneous Tasks
Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
1.1.5
8 Jul 2026Detect top-level import-binding reads as execution-order sensitive
sourcemap_filenames: Add a sourcemapFileNames option
binding: Record plugin hook result kind in tracing spans
Features
Detect top-level import-binding reads as execution-order sensitive
sourcemap_filenames: Add a sourcemapFileNames option
binding: Record plugin hook result kind in tracing spans
linking: Skip side-effect-free modules in per-entry reachability
Improve error message for unresolved virtual imports
Add descriptive metadata to plugin API
Add
--configLoader=nativeoption
Bug Fixes
Improve invalid annotation warnings
Keep deduplicated asset filenames stable once they can be observed
sourcemap_filenames: Use public option name in pattern errors
sourcemap_filenames: Hash prepared sourcemap content
tree-shake unused circular declarators exported via export list
Propagate errors from output.globals function
hmr: Fall back to full reload when a changed module is not registered as executed
chunk-optimizer: Follow entry facade edges in runtime placement cycle check
Emit async wrapper for TLA modules under onDemandWrapping
Gate sideEffects:false modules' side effects on body demand
rolldown_plugin_vite_resolve: Return empty object for
browser: falsemapped modulesReset the word-boundary state on newline in Hires::Boundary sourcemaps
Trim an emptied chunk's outro/intro instead of skipping past it
Test each edited chunk's own start against indent exclude ranges
Preserve sourcemap mappings for indented lines when a CJS module shares the chunk
Performance
ast_scanner: Stop order-sensitivity checks once a module is flagged
Return impl ExactSizeIterator from slice-backed accessors
binding: Box dev and watcher napi futures
Revert
"fix(hmr): fall back to full reload when a changed module is not registered as executed (#10132)"
1.1.4
1 Jul 2026Disable
experimental.lazyBarrelby defaultgenerate: Keep full JSON interface under preserveModules namespa…
Check finalize_other_specifiers in its own Debug attribute
Features
Disable
experimental.lazyBarrelby default
Bug Fixes
generate: Keep full JSON interface under preserveModules namespa…
Check finalize_other_specifiers in its own Debug attribute
Serialize the KeepAssign unused minify option as "keep_assign"
Keep fragments after the newline fragment in MagicString::last_line
generate: Undeclared JSON named exports under preserveModules
deconflict: Rename CJS-wrapped locals that shadow chunk-root bindings
rolldown: Keep entry facade when a shared chunk holds another entry's module
treeshake: Also bail JSON default split when the object escapes
Don't classify await in a strict-mode function as top-level await
Avoid spurious leading newline in addon hooks (banner/footer/intro/outro)
Handle JSON default mutation bailouts
plugin: Make lazy hook metadata enumerable
treeshake: Keep computed-key side effects on namespace member access
binding: Validate replace plugin delimiters length instead of panicking
Reconstruct nested rest patterns in into_expression
Reconstruct rest patterns as spread in into_expression
Preserve export keyword on multi-declarator exports under keepNames
Deterministically keep the shortest name for deduplicated assets
treeshake: Apply @NO_SIDE_EFFECTS to cross-chunk namespace calls
Performance
Disable preserve_parens across all parse paths
common: Inline declared_symbols with SmallVec
common: Pack TaggedSymbolRef into 8 bytes
sourcemap: Skip newline scan on the no-sourcemap join fast path
Revert
"fix(plugin): make lazy hook metadata enumerable (#9991)"
1.1.3
24 Jun 2026defer_dropcrashes the browser main threadPreserve used re-exports under preserveModules
Git for windows treats symlink files as regular files
Bug Fixes
defer_dropcrashes the browser main threadPreserve used re-exports under preserveModules
Git for windows treats symlink files as regular files
Performance
Cut two heap allocations from wrapped ESM init finalize
Drop throwaway Vec in wrapped esm init stmt
Borrow owner_filename in build-import-analysis AddDeps
1.1.2
18 Jun 2026Honor explicit non-TS extensions in
include(oxc-project/oxc-resolver#1213).compilerOptions.pathsnow resolve for importers whose extension is explicitly listed in a tsconfig'sinclude(e.g.src/**/*.vue,src/**/*.svelte). Previously oxc-resolver filtered importers by extension before evaluating theincludeglobs, so a.vue/.sveltefile listed inincludenever matched its project and itspathswere skipped. This unblocks the default create-vite Vue + TS layout (a solution-style root plus a referencedtsconfig.app.jsonthat declarespathsandinclude: ["src/**/*.ts", "src/**/*.vue"]). Matches vue-tsc and svelte-check, which register these extensions via TypeScript'sextraFileExtensions.No fallback to the outermost tsconfig in auto-discovery (oxc-project/oxc-resolver#1220). Auto-discovery no longer attaches the topmost ancestor
tsconfig.jsonto a file that no project actually owns (viafiles/include/ project references). Previously such a file inherited the outermost ancestor'spaths/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.Add option named for invalid return type errors for more places
Notable tsconfig behavior changes
These ship via the
oxc_resolver11.21.3 bump (#9841) and affectresolve.tsconfigPaths(Vite 8 resolves through oxc-resolver):Honor explicit non-TS extensions in
include(oxc-project/oxc-resolver#1213).compilerOptions.pathsnow resolve for importers whose extension is explicitly listed in a tsconfig'sinclude(e.g.src/**/*.vue,src/**/*.svelte). Previously oxc-resolver filtered importers by extension before evaluating theincludeglobs, so a.vue/.sveltefile listed inincludenever matched its project and itspathswere skipped. This unblocks the default create-vite Vue + TS layout (a solution-style root plus a referencedtsconfig.app.jsonthat declarespathsandinclude: ["src/**/*.ts", "src/**/*.vue"]). Matches vue-tsc and svelte-check, which register these extensions via TypeScript'sextraFileExtensions.No fallback to the outermost tsconfig in auto-discovery (oxc-project/oxc-resolver#1220). Auto-discovery no longer attaches the topmost ancestor
tsconfig.jsonto a file that no project actually owns (viafiles/include/ project references). Previously such a file inherited the outermost ancestor'spaths/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.
Features
Add option named for invalid return type errors for more places
Add option names for invalid return type errors
transform: Infer decorator strictNullChecks from tsconfig
tracing: Gate chrome-json trace layer behind
chrome-tracingfeature
Bug Fixes
plugin_timings: Point doc link to existing checks reference page
generator: Correct contradictory panic message in cjs cross-chunk symbol lookup
esm: Preserve with clause on export * from external
Make external_import_binding_merger deterministic
Surface invalid
manualCodeSplittinggrouptestregex as an errorAvoid panic on
output.filewithout a file nameAvoid O(N^2) rendering of high-volume diagnostics
Avoid panic on JSON numbers outside f64 range
Cache ESM evaluation errors
Wrap node require helper in pure IIFE
lazy-barrel: Load locally-used imports on a re-exported record
Avoid dangling wrapped-ESM init call across chunks
Performance
Drop unused regex unicode property tables from the binding
Drop urlencoding crate in favor of percent-encoding
Drop owo-colors supports-colors feature in vite reporter
Skip enum member value extraction for non-TypeScript modules
rolldown: Use unstable sort for itertools sorted_by at unique-key sites
Cheaper deterministic ordering in external import binding merger
Disable idna's ICU backend by pinning idna_adapter to 1.0.0 (-129 KB)
size: Use unstable sort where stability is unneeded
Remove num-format dependency from vite reporter
Reduce js callback error size
rolldown_error: Remove Debug supertrait from BuildEvent
Reduce plugin hook order code size
Reduce pluginable monomorphization size
Avoid rebuilding replace plugin values
Defer link-stage-output drop to rayon workers after output is produced
tree-shaking: Hoist already-included guard to call sites in inclusion DFS
renamer: Dedup before allocating the owned name in add_symbol_in_root_scope
1.1.1
11 Jun 2026ecmascript_utils: Introduce AstFactory for AST construction
Drop no-op init calls for empty wrapped-ESM modules
resolver: Honor package.json#type for .jsx/.tsx extensions
Features
ecmascript_utils: Introduce AstFactory for AST construction
Drop no-op init calls for empty wrapped-ESM modules
Bug Fixes
resolver: Honor package.json#type for .jsx/.tsx extensions
hmr: Report the full-reload reason for the invalidate-loop case
Explicit
moduleSideEffectsfrom a hook must take priority over thepackage.json#sideEffectsKeep the
rolldown-runtimename for the standalone runtime chunklazy-barrel: Request all exports for entry barrels on first encounter
finalizer: Skip init_*() for tree-shaken wrapped ESM owners
Order
chunk.importsby execution ordervite-resolve: Preserve slash separators for Sass partial exports
cross-chunk CJS wrapper shadowed by author-local binding
Performance
Avoid per-module join Strings in scope-hoisting concatenation
Avoid intermediate Strings in the ESM export clause
Reuse a scratch buffer for facade namespace names in the scanner
Reuse the import-matching tracker stack across named imports
Avoid cloning the per-chunk export-items map in render_chunk_exports
Avoid CompactStr allocation in sorted-exports membership check
1.1.0
3 Jun 2026Auto-discovery walk-up (oxc-resolver #1154): in auto-discovery mode (
tsconfig: true, the default), Rolldown now searches upward from the file's directory and uses the firsttsconfig.jsonthat owns the file. Atsconfig.jsonowns the file when the file matches itsfiles/include/exclude, or when one of itsreferencesmatches the file. Atsconfig.jsonthat does not own the file is skipped, and the search continues in the parent directory. When notsconfig.jsonup the tree owns the file, Rolldown falls back to the outermost (topmost) one found, not the nearest. Previously the nearesttsconfig.jsonwas used unconditionally. This mirrors how TypeScript'stsserverassigns a file to a project.Reference match priority (oxc-resolver #1151): when the root has
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'scompilerOptions.pathsnow apply.allowJs(oxc-resolver #1198): whether a.js/.jsx/.mjs/.cjsfile is included is now decided by each referenced project's ownallowJs, not the root's (again matching TypeScript). Sotsconfig.app.jsonwithallowJs: true+pathsnow resolves aliases for.jsfiles even when the root doesn't setallowJs.
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).Notable behavior changes
1.
experimental.lazyBarrelis now enabled by default (#9632)What changed.
experimental.lazyBarrelnow defaults totrue. 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.
2.
tsconfigproject-reference resolution now aligns with TypeScriptUpgrading
oxc_resolver(11.19.1→11.20.0in #9549, then→ 11.21.0in #9634) changes how Rolldown discovers and resolvestsconfig.json, in particular for a solution-style config (one that only listsreferencesand delegates the real settings totsconfig.app.json/tsconfig.node.json, as Vite scaffolds), bringing it in line with how TypeScript (tsc/tsserver) itself behaves:Auto-discovery walk-up (oxc-resolver #1154): in auto-discovery mode (
tsconfig: true, the default), Rolldown now searches upward from the file's directory and uses the firsttsconfig.jsonthat owns the file. Atsconfig.jsonowns the file when the file matches itsfiles/include/exclude, or when one of itsreferencesmatches the file. Atsconfig.jsonthat does not own the file is skipped, and the search continues in the parent directory. When notsconfig.jsonup the tree owns the file, Rolldown falls back to the outermost (topmost) one found, not the nearest. Previously the nearesttsconfig.jsonwas used unconditionally. This mirrors how TypeScript'stsserverassigns a file to a project.Reference match priority (oxc-resolver #1151): when the root has
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'scompilerOptions.pathsnow apply.allowJs(oxc-resolver #1198): whether a.js/.jsx/.mjs/.cjsfile is included is now decided by each referenced project's ownallowJs, not the root's (again matching TypeScript). Sotsconfig.app.jsonwithallowJs: true+pathsnow resolves aliases for.jsfiles even when the root doesn't setallowJs.
For most projects this is a fix (the standard Vite
pathsaliases now resolve, closes rolldown/rolldown#8468), but it is a behavior change if you relied on the previous behavior, where the root'spaths/allowJstook 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/allowJson 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 matchingreferencesentry 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.jsonshould carry thepathsyou previously declared on the root, plusallowJs: trueif it needs to claim.jsfiles (the extension is checked against each config's ownallowJs). With noinclude, 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:, onlyreferences) has no file patterns of its own, so it owns a file only when one of itsreferencesmatches it. When notsconfig.jsonowns the file (for example a file outsidetsconfig.base.json's directory), Rolldown does not fall back to thistsconfig.json. It keeps searching upward through ancestor directories. Before this release the nearesttsconfig.jsonwas used unconditionally, so such files previously stopped at this solution root.Alternatively, bypass reference resolution entirely by pointing the top-level
tsconfigoption at a single config:export default { tsconfig: './tsconfig.app.json' }.Features
Enable
experimental.lazyBarrelby defaultimport.meta.globsupportcaseSensitiveoptionAdd
SOURCEMAP_BROKENwarning for renderChunk hookAdd
SOURCEMAP_BROKENwarning for transform hookAdd
@__NO_SIDE_EFFECTS__hint for invalid@__PURE__before function declarationscode-splitting: Support group-local
includeDependenciesRecursively
Bug Fixes
Report TSCONFIG_ERROR instead of UNHANDLEABLE_ERROR for a missing tsconfig file
browser: Add missing exports and ensure consistency with
rolldownpackageShould build test-dev-server when test-node
chunk-optimizer: Refuse asymmetric merge for cyclic dynamic entries
Handle slash-normalized ids with preserveModulesRoot
json: Preserve .default access on JSON default imports
testing: Remove unintended trigger_full_build from test harness
Performance
Avoid unnecessary intermediate sourcemaps
1.0.5
11 Nov 2026Build linux-x64-gnu binding for baseline x86-64 CPUs
Bug Fixes
Build linux-x64-gnu binding for baseline x86-64 CPUs
Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
1.0.4
9 Nov 2026Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
Miscellaneous Tasks
Co-authored-by: shulaoda 165626830+shulaoda@users.noreply.github.com
1.0.3
27 May 2026Drop
deferkeywordApply transform.dropLabels before scanning
Skip JSON default-import namespace optimization for write targets
Features
Drop
deferkeyword
Bug Fixes
Apply transform.dropLabels before scanning
Skip JSON default-import namespace optimization for write targets
Performance
Reorder hot-path boolean checks to short-circuit on cheap predicates first
1.0.2
20 May 2026Allow checks.* to escalate emissions to hard errors
Emit warnings for invalid pure annotations
Call
codeSplitting.groups.namein deterministic order
Features
Allow checks.* to escalate emissions to hard errors
Emit warnings for invalid pure annotations
Bug Fixes
Call
codeSplitting.groups.namein deterministic orderDo not inherit __toESM across chunks for named-only external imports
1.0.1
13 May 2026experimental/lazy-barrel: Advice on oversized barrel modules
rolldown: Inline optional-chain enum access
chunk-optimization: Dedupe already-loaded dynamic deps
Features
experimental/lazy-barrel: Advice on oversized barrel modules
rolldown: Inline optional-chain enum access
chunk-optimization: Dedupe already-loaded dynamic deps
binding: Call moduleParsed hook in ParallelJsPlugin
Bug Fixes
transform: Enable
enum_evalfortransformSyncand vite TS transformerror: Remove severity prefix from diagnostic messages
dev/lazy: Fix exports of lazy requests in lazy chunks
rolldown_plugin_vite_resolve: Handle errors in
resolveSubpathImportscallbackrolldown_plugin_lazy_compilation: Use loadExports for fetched proxy to preserve original export names
common: Include offending index in HybridIndexVec panic message
Documentation
Add ai policy in contribution guide
Performance
binding: Enable mimalloc v3 to reduce idle memory
1.0.0
7 May 2026Implement dynamic dominator merge logic
Bug Fixes
Implement dynamic dominator merge logic
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.