npm-dts-webpack-plugin
TypeScript icon, indicating that this package has built-in type declarations

1.3.13 • Public • Published

npm-dts-webpack-plugin

This WebPack plugin generates single index.d.ts file for whole NPM package.

It allows creating bundled NPM library packages without TypeScript sources and yet still keeping code suggestions wherever these libraries are imported.

TypeScript picks up index.d.ts automatically.


Installation

First install the plugin:

npm install --save-dev npm-dts-webpack-plugin

Then add plugin to WebPack configuration:

const NpmDtsPlugin = require('npm-dts-webpack-plugin')

module.exports = {
  ......
  plugins: [
    new NpmDtsPlugin()
  ],
  ......
}

You can also choose to customize behavior by providing options supported by "npm-dts" module:

const NpmDtsPlugin = require('npm-dts-webpack-plugin')

module.exports = {
  ......
  plugins: [
    new NpmDtsPlugin({
      logLevel: 'debug'
    })
  ],
  ......
}

Supported options

Option Description
entry Allows changing main src file from index.ts to something else. It can also be declared as a path, relative to rootDir of TSC. Note that if rootDir is not specified in tsconfig.json and all TS source code is under some sub-directory such as "src" - TSC might auto-magically set rootDir to "src".
force Ignores non-critical errors and attempts to at least partially generate typings (disabled by default).
logLevel Log level (error, warn, info, verbose, debug) (defaults to "info").
output Overrides recommended output target to a custom one (defaults to "index.d.ts").
root NPM package directory containing package.json (defaults to current working directory).
tmp Directory for storing temporary information (defaults to OS-specific temporary directory). Note that tool completely deletes this folder once finished.
tsc Passed through additional TSC options (defaults to ""). Note that they are not validated or checked for suitability.

Package Sidebar

Install

npm i npm-dts-webpack-plugin

Weekly Downloads

838

Version

1.3.13

License

MIT

Unpacked Size

6.76 kB

Total Files

5

Last publish

Collaborators

  • white-turbine
  • vytenisu