{"id":22036,"library":"rollup-plugin-generate-declarations","title":"rollup-plugin-generate-declarations","description":"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.","status":"active","version":"1.1.2","language":"javascript","source_language":"en","source_url":"https://github.com/keysh/rollup-plugin-generate-declarations","tags":["javascript","rollup","plugin","typescript","declarations"],"install":[{"cmd":"npm install rollup-plugin-generate-declarations","lang":"bash","label":"npm"},{"cmd":"yarn add rollup-plugin-generate-declarations","lang":"bash","label":"yarn"},{"cmd":"pnpm add rollup-plugin-generate-declarations","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency required for plugin API (>=2.30.0)","package":"rollup","optional":false},{"reason":"peer dependency required for tsc execution (>=4.0.0)","package":"typescript","optional":false}],"imports":[{"note":"Package uses default export only; named import will fail.","wrong":"import { generateDeclarations } from 'rollup-plugin-generate-declarations'","symbol":"generateDeclarations","correct":"import generateDeclarations from 'rollup-plugin-generate-declarations'"},{"note":"CommonJS require use default; destructuring named export returns undefined.","wrong":"const { generateDeclarations } = require('rollup-plugin-generate-declarations')","symbol":"generateDeclarations","correct":"const generateDeclarations = require('rollup-plugin-generate-declarations')"},{"note":"No explicit type export; use typeof generateDeclarations if needed.","wrong":null,"symbol":"RollupPluginGenerateDeclarations (type)","correct":"import type GenerateDeclarations from 'rollup-plugin-generate-declarations'"}],"quickstart":{"code":"import generateDeclarations from 'rollup-plugin-generate-declarations';\nimport typescript from '@rollup/plugin-typescript';\n\nexport default {\n  input: 'src/index.ts',\n  output: {\n    dir: 'dist',\n    format: 'esm'\n  },\n  plugins: [\n    typescript(),\n    generateDeclarations()\n  ]\n};","lang":"javascript","description":"Shows basic usage with @rollup/plugin-typescript; generates .d.ts files for TypeScript source."},"warnings":[{"fix":"Ensure generateDeclarations is placed after typescript compilation plugins in plugins array.","message":"Plugin runs `tsc --emitDeclarationOnly` after rollup bundle, potentially overwriting declarations from other plugin if ordering is incorrect.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use dynamic import or set \"type\": \"module\" in package.json for Node.js.","message":"Version 1.0.0 changed from CJS to ESM; require() may fail without wrapper.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"For watch mode, use tsc separately or combine with @rollup/plugin-typescript's declaration setting.","message":"Plugin does not support Rollup's watch mode; declarations may not regenerate on file changes.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run `npm install rollup-plugin-generate-declarations --save-dev` and ensure rollup and typescript are installed.","cause":"Missing or incomplete install; missing peer deps.","error":"Error: Cannot find module 'rollup-plugin-generate-declarations'"},{"fix":"Use default import: `import generateDeclarations from ...`","cause":"Used named import instead of default import (e.g., import { generateDeclarations }).","error":"TypeError: generateDeclarations is not a function"},{"fix":"Upgrade Rollup to >=2.30.0.","cause":"Incompatible Rollup version.","error":"Error: The 'rollup' version (x.x.x) does not satisfy the peer dependency requirement (>=2.30.0)"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}