[1.0.0-beta.48] - 2025-11-10

💥 Breaking Changes

• this.emitFile now respects chunkFileNames for chunk type

// rolldown.config.js
export default {
  output: {
    chunkFileNames: 'chunks/[name]-[hash].js'
  }
}

// In plugin
this.emitFile({
  type: 'chunk',
  id: './my-module.js'
});

// Before: Output might not follow chunkFileNames pattern
// After: Output follows 'chunks/[name]-[hash].js' pattern

Note: If you're using rolldown-plugin-dts, please upgrade to version >=0.17.5 to ensure compatibility with this change.

• Deprecated top-level options removed

  • define → transform.define
  • inject → transform.inject
  • dropLabels → transform.dropLabels
  • keepNames → output.keepNames
  • profilerNames → output.generatedCode.profilerNames

• Stable plugins moved from experimental

// Before
import { replacePlugin, esmExternalRequirePlugin } from 'rolldown/experimental';

// After
import { replacePlugin, esmExternalRequirePlugin } from 'rolldown/plugins';

• RolldownBuild#scan is removed, now only available from rolldown/experimental

// Before: scan was a method on RolldownBuild
const build = await rolldown(config);
await build.scan();

// After: import scan from rolldown/experimental
import { scan } from 'rolldown/experimental';
await scan(config);

💥 BREAKING CHANGES

• this.emitFile does not respect chunkFileNames (fix!: this.emitFile does not respect chunkFileNames #6868) by @copilot
• remove deprecated top-level dropLabels option (refactor!: remove deprecated top-level dropLabels option #6915) by @sapphi-red
• remove deprecated top-level keepNames option (refactor!: remove deprecated top-level keepNames option #6914) by @sapphi-red
• remove deprecated top-level profilerNames option (refactor!: remove deprecated top-level profilerNames option #6913) by @sapphi-red
• remove deprecated top-level define and inject options (refactor!: remove deprecated top-level define and inject options #6912) by @sapphi-red
• move stable plugins from experimental to rolldown/plugins (refactor!: move stable plugins from experimental to rolldown/plugins #6303) by @shulaoda
• node: remove experimental RolldownBuild#scan, only expose it from rolldown/experimental (fix(node)!: remove experimental RolldownBuild#scan, only expose it from rolldown/experimental #6889) by @hyf0

🚀 Features

• add side-effect detection for global constructors with primitive arguments (feat: add side-effect detection for global constructors with primitive arguments #6898) by @IWANABETHATGUY
• rust: use BundleMode to handle incremental build exhaustively (feat(rust): use BundleMode to handle incremental build exhaustively #6894) by @hyf0
• detect side-effect-free global function calls (feat: detect side-effect-free global function calls #6897) by @IWANABETHATGUY
• expose parseSync / parseAsync function (feat: expose parseSync / parseAsync function #6866) by @sapphi-red
• skip __toESM helper when only named imports are used from CJS modules (feat: skip __toESM helper when only named imports are used from CJS modules #6850) by @copilot
• rolldown_binding: expose htmlInlineProxyPlugin (feat(rolldown_binding): expose htmlInlineProxyPlugin #6856) by @shulaoda
• rolldown_plugin_html_inline_proxy: align load hook logic (feat(rolldown_plugin_html_inline_proxy): align load hook logic #6855) by @shulaoda
• rolldown_plugin_html_inline_proxy: align resolveId hook logic (feat(rolldown_plugin_html_inline_proxy): align resolveId hook logic #6854) by @shulaoda
• rolldown_plugin_html_inline_proxy: initialize (feat(rolldown_plugin_html_inline_proxy): initialize #6853) by @shulaoda

🐛 Bug Fixes

• cli: support nested options in CLI properly (fix(cli): support nested options in CLI properly #6911) by @sapphi-red
• debug: ensure injecting hook_resolve_id_trigger correctly (fix(debug): ensure injecting hook_resolve_id_trigger correctly #6908) by @hyf0
• use chunk-specific exports for entry module export detection (fix: use chunk-specific exports for entry module export detection #6904) by @IWANABETHATGUY
• debug: ensure build get injected and add tests (fix(debug): ensure build get injected and add tests #6896) by @hyf0
• error: return friendly error for bundler already closed scenario (fix(error): return friendly error for bundler already closed scenario #6878) by @hyf0
• improve dynamic entry processing with iterative approach (fix: improve dynamic entry processing with iterative approach #6869) by @IWANABETHATGUY
• handle tsconfig option resolve error (fix: handle tsconfig option resolve error #6871) by @sapphi-red
• handle error when creating output chunk directories (fix: handle error when creating output chunk directories #6870) by @sapphi-red
• node: NormalizedOutputOptionsImpl and NormalizedInputOptionsImpl enumerable (fix(node): NormalizedOutputOptionsImpl and NormalizedInputOptionsImpl enumerable #6861) by @hyf0
• node: keys of RolldownOutput should be enumerable (fix(node): keys of RolldownOutput should be enumerable #6852) by @copilot

🚜 Refactor

• rust: rename BundleContext to BundleHandle (refactor(rust): rename BundleContext to BundleHandle #6893) by @hyf0
• rust: rename build_span to bundle_span (refactor(rust): rename build_span to bundle_span #6892) by @hyf0
• rust: introduce PluginDriverFactory to manage creation of PluginDriver (refactor(rust): introduce PluginDriverFactory to manage creation of PluginDriver #6891) by @hyf0
• crates/rolldown_binding: remove useless BindingBundlerImpl (refactor(crates/rolldown_binding): remove useless BindingBundlerImpl #6888) by @hyf0
• crates/rolldown_binding: rename Bundler to ClassicBundler and clarify the purpose (refactor(crates/rolldown_binding): rename Bundler to ClassicBundler and clarify the purpose #6887) by @hyf0
• rust: rename BuildFactory/Build to BundleFactory/Bundle (refactor(rust): rename BuildFactory/Build to BundleFactory/Bundle #6886) by @hyf0
• rust: tweak incremental build related methods of Bundler (refactor(rust): tweak incremental build related methods of Bundler #6884) by @hyf0
• rust: manage build via BuildFactory for Bundler (refactor(rust): manage build via BuildFactory for Bundler #6883) by @hyf0
• node: implement a new Bundler that satisfy the usage of RolldownBuild (refactor(node): implement a new Bundler that satisfy the usage of RolldownBuild #6877) by @hyf0
• node: remove useless nonEnumerable decorator (refactor(node): remove useless nonEnumerable decorator #6862) by @hyf0

📚 Documentation

• add documentation for native replace plugin (docs: add documentation for native replace plugin #6315) by @shulaoda
• in-depth/directives: expand description of how directives are handled (docs(in-depth/directives): expand description of how directives are handled #6882) by @sapphi-red
• in-depth/bundling-cjs: clarify the condition of default export interop (docs(in-depth/bundling-cjs): clarify the condition of default export interop #6875) by @sapphi-red
• add troubleshooting section for this in exported functions (docs: add troubleshooting section for this in exported functions #6865) by @sapphi-red
• update prebuilt binaries list based on Node 24 platform support tier (docs: update prebuilt binaries list based on Node 24 platform support tier #6864) by @sapphi-red
• remove unsupported [ext] placeholder from entryFileNames and chunkFileNames (docs: remove unsupported [ext] placeholder from entryFileNames and chunkFileNames #6859) by @copilot

⚡ Performance

• rolldown: improve sourcemap chain processing (perf(rolldown): improve sourcemap chain processing #6858) by @Brooooooklyn

🧪 Testing

• add test case for issue [Bug]: json bundling error for dynamic import with .default access #6881 with scientific notation (test: add test case for issue #6881 with scientific notation #6906) by @IWANABETHATGUY

⚙️ Miscellaneous Tasks

• deps: update npm packages (chore(deps): update npm packages #6918) by @renovate[bot]
• deps: update dependency rolldown-plugin-dts to v0.17.5 (chore(deps): update dependency rolldown-plugin-dts to v0.17.5 #6917) by @renovate[bot]
• deps: lock file maintenance (chore(deps): lock file maintenance #6907) by @renovate[bot]
• deps: update rust crates (chore(deps): update rust crates #6905) by @renovate[bot]
• deps: update npm packages (chore(deps): update npm packages #6903) by @renovate[bot]
• deps: update github-actions (chore(deps): update github-actions #6902) by @renovate[bot]
• deps: update oxc_resolver and oxc_resolver_napi (chore(deps): update oxc_resolver and oxc_resolver_napi #6901) by @shulaoda
• deps: update dependency rolldown-plugin-dts to v0.17.4 (chore(deps): update dependency rolldown-plugin-dts to v0.17.4 #6895) by @renovate[bot]
• deps: update dependency tsdown to v0.16.1 (chore(deps): update dependency tsdown to v0.16.1 #6885) by @renovate[bot]
• deps: upgrade napi to remove linker args that skip missing symbols (chore(deps): upgrade napi to remove linker args that skip missing symbols #6867) by @Boshen