Registry / devops / rollup-plugin-generate-declarations

rollup-plugin-generate-declarations

library1.1.2jsnpmunverified

A simple Rollup plugin that runs `tsc --emitDeclarationOnly` during build to generate `.d.ts` declaration files, solving the common problem of missing declarations when using Babel to transpile TypeScript. Current stable version is 1.1.2. Releases are infrequent. Key differentiator: integrates declaraton generation directly into Rollup pipeline, avoiding separate `tsc` step. Alternatives like `rollup-plugin-dts` generate declarations from compiled bundles; this plugin uses TypeScript compiler directly for more accurate declarations.

devops

npm install rollup-plugin-generate-declarations

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-GENE

rollup-plugin-generate-declarations

devopsjavascriptv1.1.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

generateDeclarations

✓ import generateDeclarations from 'rollup-plugin-generate-declarations'

✗ import { generateDeclarations } from 'rollup-plugin-generate-declarations'

Package uses default export only; named import will fail.

generateDeclarations

✓ const generateDeclarations = require('rollup-plugin-generate-declarations')

✗ const { generateDeclarations } = require('rollup-plugin-generate-declarations')

CommonJS require use default; destructuring named export returns undefined.

RollupPluginGenerateDeclarations (type)

✓ import type GenerateDeclarations from 'rollup-plugin-generate-declarations'

No explicit type export; use typeof generateDeclarations if needed.

Shows basic usage with @rollup/plugin-typescript; generates .d.ts files for TypeScript source.

import generateDeclarations from 'rollup-plugin-generate-declarations'; import typescript from '@rollup/plugin-typescript'; export default { input: 'src/index.ts', output: { dir: 'dist', format: 'esm' }, plugins: [ typescript(), generateDeclarations() ] };

Debug

Known issues

gotchaPlugin runs `tsc --emitDeclarationOnly` after rollup bundle, potentially overwriting declarations from other plugin if ordering is incorrect.

fix

Ensure generateDeclarations is placed after typescript compilation plugins in plugins array.

affects: >=1.0.0

breakingVersion 1.0.0 changed from CJS to ESM; require() may fail without wrapper.

fix

Use dynamic import or set "type": "module" in package.json for Node.js.

affects: >=1.0.0

deprecatedPlugin does not support Rollup's watch mode; declarations may not regenerate on file changes.

fix

For watch mode, use tsc separately or combine with @rollup/plugin-typescript's declaration setting.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'rollup-plugin-generate-declarations'

Missing or incomplete install; missing peer deps.

fix

Run `npm install rollup-plugin-generate-declarations --save-dev` and ensure rollup and typescript are installed.

TypeError: generateDeclarations is not a function

Used named import instead of default import (e.g., import { generateDeclarations }).

fix

Use default import: `import generateDeclarations from ...`

Error: The 'rollup' version (x.x.x) does not satisfy the peer dependency requirement (>=2.30.0)

Incompatible Rollup version.

fix

Upgrade Rollup to >=2.30.0.

Upgrade

Version history

1.1.2latest on npm

Audit

Dependencies

rolluprequiredpeer dependency required for plugin API (>=2.30.0)

typescriptrequiredpeer dependency required for tsc execution (>=4.0.0)

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/keysh/rollup-plugin-generate-declarations ↗

packagehttps://www.npmjs.com/package/rollup-plugin-generate-declarations ↗