Skip to content
This repository has been archived by the owner on Jan 9, 2023. It is now read-only.

Apply plugins according to special output option, reduce config and save time.

Notifications You must be signed in to change notification settings

wmzy/rollup-plugin-by-output

Repository files navigation

Build Status Coverage Status

rollup-plugin-by-output

Apply Rollup Plugin by OutputOptions

Install

npm i -D rollup-plugin-by-output

Usage

// rollup.config.js
import babel from 'rollup-plugin-babel';
import terser from 'rollup-plugin-terser';
import plugins, {file} from 'rollup-plugin-by-output';


export default {
  // ...
  plugins: plugins(babel(), [file(pkg.browser), terser()]),
  output: [
    {
      globals: {
        lodash: '_'
      },
      name: pkg.name,
      file: pkg.browser,
      format: 'umd'
    },
    {
      file: pkg.main,
      format: 'cjs'
    },
    {
      file: pkg.module,
      format: 'es'
    }
  ]
};

What

Rollup support multiple outputs with the same input. But sometime we want to apply different plugins for these outputs. The most common scenario is apply the terser plugin for a minify bundle. Before we can write a config array, but there are a lot of duplicate code and operations.

This plugin (maybe not a plugin) gives you a slightly elegant and efficient solution for this scene.

APIs

import plugins, {when, whenAll, prop, format, file} from 'rollup-plugin-by-output';

Plugins

{
  //...
  plugins: [pluginA, when(filter, pluginB), pluginsC, ..., ...whenAll(anotherFilter, pluginD, pluginE)]
}

same as:

{
  // ...
  plugins: plugins(pluginA,
    [filter, pluginB],// same as when
    pluginsC, ..., 
    [anotherFilter, pluginD, pluginE] // same as whenAll and flat
  )
}

The filter is a predicate function, the parameter is an output config object. If the filter return a truthy value, the rest plugins will be apply for the output.

when and whenAll is convenient for few filters and plugins is convenient for multiple filters.

Filter helpers

There are three simple but useful filter helpers: prop, format, file.

With them you can write like:

// output 
[
  {
    name: pkg.name,
    file: pkg.browser,
    format: 'umd'
    }
]

when(format('umd'), pluginA)
// same as
when(format(/^umd$/), pluginA)
// same as
when(format(f => f === 'umd'), pluginA)

when(file(pkg.browser), pluginA)

format = filter => prop('format', filter)
file = filter => prop('file', filter)

Examples

Workflow

# develop
npm start

# build
npm run build

# test
npm test

# commit changes
npm run commit

# publish
npm publish

License

MIT

About

Apply plugins according to special output option, reduce config and save time.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published