gem-hunter

Rollup plugin for high-quality .d.ts bundling via @microsoft/api-extractor.

Microsoft's official type declaration bundler, @microsoft/api-extractor, avoids common pitfalls (mangled type names, dropped re-exports) prevalent among many popular alternatives. However, it was designed as a monolithic CLI with verbose config files. This plugin exposes it as a simple Rollup interface.

Install the package from npm:

npm install --save-dev rollup-dts-bundler

Add it to your rollup.config.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:

  "types": "dist/index.d.ts",

External libraries (e.g. @types/*) are automatically excluded from bundling.

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'],
})

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 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 for details.

MIT