/rollup-plugin-multi-entry

Use multiple entry points in your rollup bundle.

Primary LanguageJavaScript

rollup-plugin-multi-entry

Use multiple entry points in your rollup bundle. This is particularly useful for tests, but can also be used to package a library. The exports from all the entry points will be combined, e.g.

// a.js
export const a = 1;

// b.js
export const b = 2;

// c.js
export const c = 3;

Using all three files above as entry points will yield a bundle with exports for a, b, and c.

Note: Only named exports are allowed. Default exports like export default class Foo {...} will not be exported unless you use the exports: 'array' option.

Install

# Install via npm:
$ npm install [--save-dev] rollup-plugin-multi-entry
# Or use yarn:
$ yarn add [--dev] rollup-plugin-multi-entry

Usage

This plugin requires at least v0.48.0 of rollup. In rollup.config.js:

import multiEntry from "rollup-plugin-multi-entry";

export default {
  input: "test/**/*.js",
  plugins: [multiEntry()]
};

The entry above is the simplest form which simply takes a glob string. If you wish, you may pass an array of glob strings or, for finer control, an object with include and exclude properties each taking an array of glob strings, e.g.

// The usual rollup entry configuration works.
export default {
  input: 'just/one/file.js',
  plugins: [multiEntry()]
  // ...
};

// As does a glob of files.
export default {
  input: 'a/glob/of/files/**/*.js',
  plugins: [multiEntry()]
  // ...
};

// Or an array of files and globs.
export default {
  input: ['an/array.js', 'of/files.js', 'or/globs/**/*.js'],
  plugins: [multiEntry()]
  // ...
};

// For maximum control, arrays of globs to include and exclude.
export default {
  input: {
    include: ['files.js', 'and/globs/**/*.js', 'to/include.js'],
    exclude: ['those/files.js', 'and/globs/*.to.be.excluded.js']
  },
  plugins: [multiEntry()]
  // ...
};

Sometimes you may not want to export anything from the rolled-up bundle. In such cases, use the exports: false option like so:

export default {
  input: "src/*.js",
  plugins: [multiEntry({ exports: false })]
};

If you want to create an array of values from the default exports of each source module, use the exports: 'array' option. This array will be assigned to the default export of the bundled module. When using this option, all source modules must have a default export or else a compiler error will be emitted. Example:

export default {
  input: "src/*.js",
  plugins: [multiEntry({ exports: 'array' })]
};

License

MIT