🧭 Migration Guide

Most users can upgrade directly. Before upgrading, run one final build with tsdown@0.22.14 and resolve all deprecation warnings.

• config:
  • bundle: false → unbundle: true; bundle: true can be removed
  • outExtension → outExtensions
  • publicDir / --public-dir → copy / --copy
  • removeNodeProtocol: true → nodeProtocol: 'strip'
  • injectStyle → css.inject
• deps:
  • inlineOnly / deps.onlyAllowBundle → deps.onlyBundle
  • skipNodeModulesBundle: true → deps.neverBundle: true
  • resolveDepSubpath now defaults to false; set it to true to preserve the previous behavior
• dts:
  • rolldown-plugin-dts was upgraded from 0.27.13 to 0.28.5
  • dts.oxc: true → dts.generator: 'oxc'
  • dts.tsgo: true → dts.generator: 'tsgo'; oxc and tsgo objects now only configure their respective generators
  • dts.volarPlugins → dts.customLanguages; rename each language's create hook to createVolarPlugins
  • Custom languages, including vue, now throw when combined with an incompatible generator
  • dts.cjsReexport was removed; dual-format builds now generate CJS declarations in a separate pass
• attw:
  • The default profile changed from strict to esm-only; set profile: 'strict' to preserve the previous checks
• programmatic API:
  • build() now returns { bundles, watch }; replace const bundles = await build() with const { bundles } = await build()
• requirements:
  • Node.js 25 is no longer supported; use ^22.18.0, ^24.11.0, or >=26.0.0
  • rolldown-plugin-dts now requires Rolldown 1.2.x
  • Legacy types and typesVersions fallbacks were removed; use TypeScript's bundler, node16, or nodenext module resolution

   🚨 Breaking Changes

• Drop support for Node.js 25  -  by @sxzz (26950)
• Remove deprecated tsup compatibility options  -  by @sxzz (50766)
• Drop types and typesVersionsfields  -  by @sxzz (be3ea)
• attw:
  • Change default profile to esm-only  -  by @sxzz (9b3cf)
• deps:
  • Remove deprecated deps.onlyAllowBundle  -  by @sxzz (30c55)
  • Disable resolveDepSubpath by default  -  by @sxzz (d300f)
  • Remove deprecated skipNodeModulesBundle  -  by @sxzz (f2a3d)
• dts:
  • Remove dts.cjsReexport option  -  by @sxzz (9c70f)
  • Make dts.generator the only way to select generator  -  by @sxzz (eb75f)

   🚀 Features

• Expose programmatic watch controls  -  by @sxzz in #1062 (96a40)
• css: Support function form for css.modules.localsConvention  -  by @sxzz and @lazerg (b566f)
• report: Add summary option to skip per-file size logs  -  by @lazerg in #1036 (020e9)

   🐞 Bug Fixes

• Allow unplugin-unused v0.5+  -  by @sxzz (53c78)
• Ignore optional dependencies in type definitions  -  by @sxzz (94622)
• cli:
  • Camel-case nested flag keys  -  by @sxzz (bf53f)
• css:
  • Watch files imported via @import  -  by @lazerg in #1038 (ebee5)
• deps:
  • Apply resolveDepSubpath when neverBundle is true  -  by @lazerg in #1053 (4943c)
• exports:
  • Scope inlined dependencies to configs with exports  -  by @lazerg in #1040 (d5b80)
• migrate:
  • Pin migrated projects to tsdown 0.22.14  -  by @sxzz (113fb)
  • Support non-interactive environments  -  by @sxzz (51e41)

   🏎 Performance

• Remove asyncDispose polyfill  -  by @sxzz (82675)
• Replace ansis with util.styleText  -  by @sxzz (be6bf)

    View changes on GitHub