Update tsdown 0.20.1 → 0.21.6 (major)

[depfu]

Here is everything you need to know about this upgrade. Please take a good look at what changed and the test results before merging this pull request.

What changed?

✳️ tsdown (0.20.1 → 0.21.6) · Repo

Release Notes

0.21.6

   🚀 Features

• Upgrade rolldown to v1.0.0-rc.12  -  by @sxzz (51292)
• config:
  • Pass root config to workspace config functions  -  by @sxzz (76169)
  • Use mergeConfig for workspace config merging and support variadic overrides  -  by @sxzz (148aa)
• dts:
  • Add cjsReexport option to eliminate dual module type hazard  -  by @mandarini and @sxzz in #856 (875c1)
• exports:
  • Add bin option to auto-generate package.json bin field  -  by @sxzz in #869 (7ebd6)

   🐞 Bug Fixes

• css:
  • Compile preprocessor langs in virtual CSS modules  -  by @sxzz in #865 (7b2e0)
  • Strip .module from CSS output filenames  -  by @sxzz in #866 (03ade)
  • Default splitting to true in unbundle mode for CSS inject  -  by @sxzz in #867 (a4da6)
  • Split CSS plugin into pre/post phases for scoped CSS support  -  by @sxzz in #870 (ff0c4)
• entry:
  • Correctly output relative paths in logger output  -  by @sxzz (00050)

    View changes on GitHub

0.21.5

   🚀 Features

• Update rolldown to 1.0.0-rc.10  -  by @wChenonly in #845 (41411)
• Support typescript v6  -  by @ocavue in #858 (bffc4)

   🐞 Bug Fixes

• css:
  • Run final minification on merged CSS output  -  by @sxzz in #853 (475df)
  • Don't override internal importer  -  by @Laupetin in #860 (af40e)
  • Use aliased exports for CSS module keys  -  by @wChenonly and @sxzz in #840 (bb6de)
• deps:
  • External optionalDependencies by default  -  by @sxzz (cd24d)
  • Resolve subpath extensions for packages without exports field  -  by @sxzz in #863 (c5150)
  • Correctly resolve root @types packages for dts deep imports  -  by @brc-dd and @sxzz in #852 (0b276)

    View changes on GitHub

0.21.4

   🚀 Features

• css: Add CSS modules support  -  by @sxzz in #834 (2a88a)

   🐞 Bug Fixes

• exports: Preserve CRLF line endings in package.json  -  by @sxzz (a4d4e)

    View changes on GitHub

0.21.3

   🚀 Features

• copy: Add support for watching copy source files  -  by @schplitt in #721 (7c23a)

   🐞 Bug Fixes

• css: Watch inline CSS files in watch mode  -  by @sxzz (2051a)
• exports: Sort inlined dependencies by package name  -  by @sxzz (0ec71)
• publint: Support Yarn v1  -  by @sxzz (4a291)
• unbundle: Root should be lowest common ancestor of entry files  -  by @sxzz (f1823)

    View changes on GitHub

0.21.2

   🚨 Breaking Changes

• exe: Add exe.outDir for separate executable output dir, defaults to build  -  by @sxzz (d49ef)

Note: Executable is still an experimental feature and does not follow SemVer. Breaking changes may occur in any release.

   🚀 Features

• Add root option for controlling output directory structure  -  by @sxzz (bad2d)
• deps: Rename onlyAllowBundle to onlyBundle  -  by @peaklabs-dev and @sxzz in #819 (cbd7b)

   🐞 Bug Fixes

• css: Skip data URIs and external URLs in CSS url() rebasing  -  by @sxzz (13907)

    View changes on GitHub

0.21.1

   🚨 Breaking Changes

• css: Move all CSS support to @tsdown/css package  -  by @sxzz in #809 (1b1a1)

Important

If you are using CSS features (e.g., CSS imports), you now need to manually install the @tsdown/css package:

npm install @tsdown/css -D
# or
pnpm add @tsdown/css -D

Note: CSS support is still an experimental feature and does not follow SemVer. Breaking changes may occur in any release.

   🚀 Features

• css:
  • Add css.inject option to preserve CSS imports in JS output  -  by @sxzz and Claude Haiku 4.5 in #808 (ad745)
  • Support ?inline query for CSS imports  -  by @sxzz in #810 (b7379)
  • Support node_modules package resolution  -  by @sxzz and Claude Haiku 4.5 in #812 (b06b4)

   🐞 Bug Fixes

• Generate correct filename for sass files when dts is enabled  -  by @ocavue in #802 (848a7)
• css:
  • Handle virtual module IDs from framework plugins  -  by @sxzz (c421f)
  • Ignore css imports with URL query  -  by @ocavue and @sxzz in #806 (c1d23)

    View changes on GitHub

0.21.0

v0.21.0 - Notable Changes

Breaking Changes

Dependency options renamed to deps namespace

The dependency-related options have been moved under a new deps namespace with clearer names:

• external -> deps.neverBundle
• noExternal -> deps.alwaysBundle
• inlineOnly -> deps.onlyAllowBundle
• skipNodeModulesBundle -> deps.skipNodeModulesBundle

Before:

export default defineConfig({
  external: ['vue'],
  noExternal: ['lodash'],
})

After:

export default defineConfig({
  deps: {
    neverBundle: ['vue'],
    alwaysBundle: ['lodash'],
  },
})

The old options still work but are deprecated and will emit warnings.

failOnWarn default changed from 'ci-only' to false

If you relied on the previous behavior where warnings would fail the build in CI environments, you now need to explicitly set failOnWarn: true or failOnWarn: 'ci-only' in your config.

Node.js < 22.18.0 deprecated

tsdown now emits a deprecation warning when running on Node.js versions below 22.18.0. Plan to upgrade your Node.js version accordingly.

New Features

Experimental Node.js SEA executable bundling (exe)

tsdown can now bundle your TypeScript project into a standalone executable using Node.js Single Executable Applications (SEA). A new @tsdown/exe package provides cross-platform executable building support. See the exe documentation for details.

export default defineConfig({
  exe: true, // or { useCodeCache: true, useSnapshot: true }
})

Full CSS pipeline with @tsdown/css

CSS handling has been reimplemented as a native Rolldown plugin and extracted into the @tsdown/css package, providing a complete CSS pipeline with Lightning CSS and PostCSS support via the css.transformer option. See the CSS documentation for details.

inlinedDependencies field in package.json

When using the exports feature, tsdown now auto-generates an inlinedDependencies field in your package.json, listing dependencies that are bundled into the output.

Object option for customExports

customExports now supports an object format for more fine-grained control over the generated exports field.

Migration Guide

1. Update dependency options: Rename external -> deps.neverBundle, noExternal -> deps.alwaysBundle, etc.
2. Check failOnWarn: If you need warnings to fail the build in CI, explicitly set failOnWarn: 'ci-only' or failOnWarn: true.
3. Upgrade Node.js: Ensure you're running Node.js >= 22.18.0 to avoid deprecation warnings.

Links

• tsdown Documentation
• v0.21.0-beta.1 Release
• v0.21.0-beta.2 Release
• v0.21.0-beta.3 Release
• v0.21.0-beta.4 Release
• v0.21.0-beta.5 Release
• Full diff from v0.20.3

---

   🚨 Breaking Changes

• Change failOnWarn default from 'ci-only' to false  -  by @sxzz (ad8db)
• exe: Require Node >=25.7 and default format to esm  -  by @sxzz in #798 (0173c)

   🚀 Features

• Rename dependency options to deps namespace  -  by @sxzz (7f509)
• Upgrade rolldown  -  by @sxzz (7a528)
• Deprecate Node.js versions below 22.18.0  -  by @sxzz (439f1)
• Support bundling .node files by default  -  by @sxzz (944e9)
• css:
  • Implement full CSS pipeline as Rolldown plugin  -  by @sxzz in #787 (dbe3c)
  • Extract CSS pipeline into @tsdown/css package  -  by @sxzz in #790 (e4cbe)
  • Add PostCSS support with css.transformer option  -  by @sxzz in #791 (35bef)
  • Default css.transformer to lightningcss  -  by @sxzz in #797 (288a5)
• exe:
  • Add experimental Node.js SEA executable bundling  -  by @sxzz in #777 (418d5)
  • Add cross-platform executable building via @tsdown/exe  -  by @sxzz in #786 (b6833)
  • Support latest and latest-lts for nodeVersion  -  by @sxzz (ce7ab)
• exports:
  • Support object option for customExports  -  by @Joery-M and @sxzz in #769 (7fb72)
  • Add inlinedDependencies field to package.json  -  by @sxzz in #785 (5c71f)
• migrate:
  • Migrate external/noExternal to deps namespace  -  by @sxzz (c59e7)

   🐞 Bug Fixes

• Apply failOnWarn to rolldown logs  -  by @sxzz (149dc)
• Debounce onSuccess in watch mode to prevent duplicate execution  -  by @sxzz (af748)
• Don't fail on PLUGIN_TIMINGS warnings when failOnWarn is enabled  -  by @sxzz (9872a)
• Resolve css files in node_modules  -  by @ocavue, @sxzz and Rei in #795 (d8a1f)
• config: Handle known Node.js bug in nativeImport error handling  -  by @sxzz (e4230)
• copy: Don't warn if no files specified  -  by @adamlohner, @cursoragent and @sxzz in #780 (afaab)
• css: Remove empty js chunks  -  by @ocavue and @sxzz in #799 (1183a)
• exe: Use runtime semver check for ESM SEA default format  -  by @sxzz (5321c)
• exports: Include non-entry chunks in exports when all is true  -  by @sxzz (79492)
• hooks: Set cwd for onSuccess  -  by @sxzz (c114a)
• node-protocol: Respect alias and tsconfig paths when stripping node: prefix  -  by @lazuee in #773 (b1dd2)
• watch: Re-glob entry files on create/delete events  -  by @sxzz (a1969)

    View changes on GitHub

0.20.3

   🐞 Bug Fixes

• package: Ignore scripts when packing  -  by @sxzz (0b10b)

    View changes on GitHub

0.20.2

   🚀 Features

• Upgrade rolldown to 1.0.0-rc.3  -  by @sxzz (0beea)
• dep: Keep inlineOnly clean with hint message on unused  -  by @jycouet and @sxzz in #725 (13f1c)
• pkg: Optimize attw and publint packing  -  by @sxzz in #736 (375cf)

   🐞 Bug Fixes

• Throw error when skipNodeModulesBundle and noExternal are used together  -  by @sxzz in #746 (656d5)
• External type only packages @types/*  -  by @kalvenschraut (0be7c)
• exports: Move import before require  -  by @sxzz (3027a)

    View changes on GitHub

Does any of this look wrong? Please let us know.

Commits

See the full diff on Github. The new version differs by more commits than we can show here.

---

Depfu will automatically keep this PR conflict-free, as long as you don't add any commits to this branch yourself. You can also trigger a rebase manually by commenting with @depfu rebase.

All Depfu comment commands

@​depfu rebase

Rebases against your default branch and redoes this update

@​depfu recreate

Recreates this PR, overwriting any edits that you've made to it

@​depfu merge

Merges this PR once your tests are passing and conflicts are resolved

@​depfu cancel merge

Cancels automatic merging of this PR

@​depfu close

Closes this PR and deletes the branch

@​depfu reopen

Restores the branch and reopens this PR (if it's closed)

@​depfu pause

Ignores all future updates for this dependency and closes this PR

@​depfu pause [minor|major]

Ignores all future minor/major updates for this dependency and closes this PR

@​depfu resume

Future versions of this dependency will create PRs again (leaves this PR as is)

[changeset-bot]

⚠️ No Changeset found

Latest commit: 5248f2b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[depfu]

Closed in favor of #163.