https://github.com/benhatsor/rollup-dts-bundler
Rollup plugin for bundling .d.ts declarations via @microsoft/api-extractor.
https://github.com/benhatsor/rollup-dts-bundler
rolldown rollup typescript
Last synced: about 2 months ago
JSON representation
Rollup plugin for bundling .d.ts declarations via @microsoft/api-extractor.
- Host: GitHub
- URL: https://github.com/benhatsor/rollup-dts-bundler
- Owner: benhatsor
- License: mit
- Created: 2026-04-16T13:04:51.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-01T18:30:45.000Z (3 months ago)
- Last Synced: 2026-05-01T20:13:32.549Z (3 months ago)
- Topics: rolldown, rollup, typescript
- Language: TypeScript
- Homepage:
- Size: 201 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rollup-dts-bundler
[![npm version][npm-version-src]][npm-version-href]
[![CI][ci-src]][ci-href]
[![Coverage Status][coverage-src]][coverage-href]
Rollup plugin for accurate `.d.ts` bundling via [@microsoft/api-extractor].
## Why?
[@microsoft/api-extractor] is Microsoft's official `.d.ts` bundler. Unlike common alternatives ([rollup-plugin-dts], [rolldown-plugin-dts], [dts-bundle-generator]), it doesn't mangle type names or drop re-exports. Problem is, it was designed as a monolithic CLI with verbose config files. This plugin exposes it as a simple Rollup interface.
## Usage
Install the package from `npm`:
```sh
npm install --save-dev rollup-dts-bundler
```
Add it to your `rollup.config.js`:
```js
import { dts } from 'rollup-dts-bundler'
export default [
// …
{
input: 'src/index.ts',
output: { file: 'dist/index.d.ts', format: 'es' },
plugins: [dts()],
}
]
```
Then point your `package.json` at the output:
```json
"types": "dist/index.d.ts",
```
> External libraries (e.g. `@types/*`) are automatically excluded from bundling.
## Options
```ts
dts({
// Path to tsconfig.json (relative to cwd or absolute).
// When omitted, walks up from the entry's directory to find the nearest tsconfig.
tsconfig: 'tsconfig.build.json',
// npm package names whose declarations should be inlined into the output
// instead of left as external imports. Useful for re-exporting types from
// an internal workspace package.
bundledPackages: ['@my-scope/internal-types'],
})
```
## How it works
The entry point is stubbed out so Rollup only provides the input/output config. All real work happens in the `generateBundle` hook: declarations are emitted via tsc, fed to api-extractor, and the result is output as an asset.
## Releases
Releases publish to npm with OIDC provenance after the test suite passes at 100% coverage. Renovate dependency updates on `main` release automatically; `npm run release` cuts a manual release. See [RELEASING.md](/RELEASING.md) for details.
## License
[MIT](/LICENSE)
[@microsoft/api-extractor]: https://github.com/microsoft/rushstack/tree/main/apps/api-extractor
[rollup-plugin-dts]: https://github.com/Swatinem/rollup-plugin-dts
[rolldown-plugin-dts]: https://github.com/sxzz/rolldown-plugin-dts
[dts-bundle-generator]: https://github.com/timocov/dts-bundle-generator
[npm-version-src]: https://img.shields.io/npm/v/rollup-dts-bundler.svg
[npm-version-href]: https://npmjs.com/package/rollup-dts-bundler
[ci-src]: https://github.com/benhatsor/rollup-dts-bundler/actions/workflows/ci.yml/badge.svg
[ci-href]: https://github.com/benhatsor/rollup-dts-bundler/actions/workflows/ci.yml
[coverage-src]: https://coveralls.io/repos/github/benhatsor/rollup-dts-bundler/badge.svg?branch=main
[coverage-href]: https://coveralls.io/github/benhatsor/rollup-dts-bundler?branch=main