plugin-externals

Rollup plugin to declare dependencies external with reasonable defaults and customizable logic.

Uses is-builtin-module to check for builtin modules.

Changelog

Installation

Using npm:

npm install --save-dev @rollup-extras/plugin-externals

Example

Normal usage:

1import externals from '@rollup-extras/plugin-externals';
2
3export default {
4	input: 'src/index.js',
5
6    output: {
7        format: 'cjs',
8        dir: 'dest'
9    },
10
11	plugins: [externals()],
12}

Options

pluginName

Optional, string.

For debugging purposes, so many instances of a plugin can be differentiated in debugging output.

verbose

Optional, boolean.

Bumps loglevel so more messages go through the default logger filter.

external

Optional, (id: string, external: boolean) => boolean.

Default: id.includes('node_modules') || isBuiltinModule(id) || isOutsideProjectDirectory(id, importer)

Receives in external argument result of default function.

Configuration

1type ExternalsPluginOptions = {
2    pluginName?: string,
3    verbose?: boolean,
4    external?: (id: string, external: boolean) => boolean
5};

Prior Art

• https://github.com/Septh/rollup-plugin-node-externals

License

MIT