tsdown

Verified·Scanned 2/18/2026

Use when bundling TypeScript libraries - provides tsdown configuration, dual ESM/CJS output, .d.ts generation, package validation, and plugin authoring

by onmax·v6205807·17.8 KB·231 installs
Scanned from main at 6205807 · Transparency log ↗
$ vett add onmax/nuxt-skills/tsdown

tsdown

Rolldown + Oxc powered TypeScript bundler. Drop-in tsup replacement.

When to Use

  • Building TypeScript libraries
  • Generating .d.ts declarations
  • Publishing npm packages
  • Dual ESM/CJS output
  • Vue/React component libraries

Quick Start

npm i -D tsdown typescript
// tsdown.config.ts
import { defineConfig } from 'tsdown'

export default defineConfig({
  entry: 'src/index.ts',
  format: 'esm',
  dts: true,
  exports: true,
})
tsdown           # Build
tsdown --watch   # Watch mode

Reference Files

TaskFile
Config file, CLI, entry pointsconfig.md
Format, target, dts, exports, validationoutput.md
Shims, unbundle, watch, frameworks, WASMfeatures.md
Plugins, hooks, lint, programmatic, migrationadvanced.md

Loading Files

Consider loading these reference files based on your task:

  • references/config.md - if setting up tsdown.config.ts, CLI, or entry points
  • references/output.md - if configuring output format, target, .d.ts, exports, or validation
  • references/features.md - if using shims, unbundle, watch mode, framework integrations, or WebAssembly
  • references/advanced.md - if writing plugins, using linting/validation, programmatic API, or migrating from tsup

DO NOT load all files at once. Load only what's relevant to your current task.

Cross-Skill References

  • Library patterns → Use ts-library skill
  • Vue component libs → Use vue skill
  • Package management → Use pnpm skill