TypeScript

unplugin-dts

An unplugin for generating declaration (dts) files.

Q

qmhc

Dernière activité 23 sept. 2026
qmhc/unplugin-dts

1,5 k

étoiles

114

forks

19

issues ouvertes

dtsesbuildreactrolldownrolluprsbuildrspacksveltetsctypescriptunpluginvitevolarvuevue-tscwebpack

Ce README est souvent en anglais.

unplugin-dts

An unplugin that generates declaration files (*.d.ts) from .ts(x) or .vue source files when using library mode.

version version license

It evolved from vite-plugin-dts, and after being rewritten with unplugin, it has become more versatile.

English | 中文

Installation

Requires Node.js >= 20.

pnpm i -D unplugin-dts

Previous only for Vite (not recommend):

pnpm i -D vite-plugin-dts

Quick Start

import dts from 'unplugin-dts/vite'

export default defineConfig({
  plugins: [dts()],
})

Supports Vite, Rollup, Rolldown, Webpack, Rspack and Esbuild. See Usage for detailed bundler setup.

When moduleFormat is omitted, the plugin preserves TypeScript's declaration extensions: .ts → .d.ts, .mts → .d.mts, and .cts → .d.cts, including declaration maps.

Declaration maps preserve absolute file:// source URLs, including Windows cross-drive paths, across all output directories.

To publish declarations for both ESM and CommonJS, configure both formats explicitly:

dts({
  outDirs: [
    { dir: 'dist', moduleFormat: 'esm' },
    { dir: 'dist', moduleFormat: 'cjs' },
  ],
  bundleTypes: true,
})

moduleFormat is not inferred from the bundler's JavaScript formats. The plugin writes the configured declaration variants, while conditional exports.types entries remain package metadata that you configure in package.json.

Documentation

  • Usage - Installation and bundler configuration
  • Options - Full plugin options reference
  • FAQ - Frequently asked questions and solutions
  • Migration (v4 → v5) - Migrating from vite-plugin-dts v4

Contributors

Thanks for all the contributions!

contributors

A real project using this plugin: Vexip UI.

License

MIT License.

Projets similaires

Unified plugin system for Vite, Rollup, Webpack, esbuild, Rolldown, and more

TypeScriptesbuildrolldownrollup
Uunjs
3,6 k étoiles158

A rollup plugin to generate .d.ts rollup files for your typescript project

TypeScript
SSwatinem
875 étoiles83

Auto import APIs on-demand for Vite, Webpack and Rollup

TypeScriptrollup-pluginunpluginvite-plugin
Uunplugin
3,8 k étoiles218