gem-hunter
Language: JavaScript
Generate a standard rollup config, so that plugins don't need the same script in every repository.
Currently rollup configs are the same for most plugins, but when the default config changes a bit, every repository has to be updated since it is a static file. This package will provide the standard config as a module, so that updates can be deployed much easier.
Lead Maintainer: Brandon Casey @brandonocasey
Maintenance Status: Stable
Table of Contents
Note: version 3+ support rollup ^1.0.0. If you need older rollup support please use version 2.
$ npm install --save-dev rollup videojs-generate-rollup-config
Then in your rollup config do
const generateRollupConfig = require('videojs-generate-rollup-config'); const config = generateRollupConfig(); /** * Now you have: * - config.settings: An object containing the settings used to generate the builds. * - config.builds: An object containing the generated builds, with the name of the build as the key: * - cjs * - es * - test * - browser * - minBrowser, this will be excluded by default in watch mode. See the `checkWatch` option. */ // Note that you have to take the values from config.builds, since rollup takes an array. export default Object.values(config.builds);
Before you exports you can customize the builds, and you can also pass options (outlined below) to customize the builds.
These can be passed via rollup's --environment or just setting an environment variable
Type:
BooleanDefault: false
Set this to any JavaScript truthy value, to only create a test build target. If this option is present NO_TEST_BUNDLE will be ignored.
Type:
BooleanDefault: false
Set this to any JavaScript truthy value, to create all build targets except test. This option will be ignored if TEST_BUNDLE_ONLY is set.
options that are passed as an object to the generateRollupConfig function.
Type:
stringDefault:src/plugin.js
The entry point for your build.
Type:
stringDefault:uglify
The name of the primed plugin to use when minifying
Type:
stringDefault:test/**/*.test.js
The entry point for tests.
Type:
stringDefault: Your package name minus scope.
Determines the dist file names for your build. IE:
@thing/videojs-foo-bar would have a distName of videojs-foo-bar and build to dist/videojs-foo-var.js etc.
Type:
stringDefault: Your package name minus scope in camel case.
Determines the export name for browser and test dist files of your build. IE:
@thing/videojs-foo-bar would have a exportName of videojsFooBar.browser/minBrowser dist would be exported to window as window.videojsFooBar.test dist would be exported to window as window.videojsFooBarTests.Type:
FunctionDefault: no default
A callback to change the files that are excluded from test coverage.
This function takes one argument and will be passed the default files that are excluded from coverage, see below. This function must return the final list of files that should be excluded from coverage.
Defaults are as follows:
NOTE: __dirname refers to the directory of
videojs-generate-rollup-config. This is used because some rollup plugins insert special transforms.
['test/**', path.join(__dirname, '**'), 'node_modules/**', 'package.json']
Type:
BooleanDefault: true
Whether to include istanbul for the unit test bundle. By default it is included.
Type:
string|ArrayDefault: ['defaults', 'ie 11']
What browser syntax should be supported in the browser/test dist files. Can also be specified in the package.json as a top level browserslist key/value. See the browserslist repo for more information.
Type:
booleanDefault:true
Determines if we should check if rollup is in watch mode. If it is we exclude the minBrowser build to save development time.
Type:
stringDefault:/*! @name ${pkg.name} @version ${pkg.version} @license ${pkg.license} */
The banner that should be inserted to the top of all bundles. You probably should not change this from the default!
Type:
FunctionDefault: no default
A callback to change the default settings for rollup-plugin-babel.
This function takes one argument, the default babel config. This function must return
the final babel config that should be used for rollup-plugin-babel.
default babel config:
{ babelrc: false, exclude: path.join(process.cwd(), 'node_modules/**'), presets: [ [presetEnv, {loose: true, modules: false, targets: {browsers: settings.browserslist}}] ], plugins: [ transformObjectAssign ] };
Example:
const config = generateRollupConfig({ babel(default) { default.plugins.push('babel-plugin-lodash'); return default; } })
Type:
FunctionDefault: no default
A callback to change the build globals for the rollup build before they are used.
This function takes one argument and will be passed the defaultGlobals. This function must return the final globals that should be used to create the rollup build list.
Example:
const config = generateRollupConfig({ globals(defaults) { return { browser: Object.assign(defaults.browser, { 'foo-bar': 'foo', }), module: Object.assign(defaults.module, { 'foo-bar': 'foo' }), test: Object.assign(defaults.test, { 'foo-bar': 'foo' }), }; } }) };
Type:
FunctionDefault: no default
A callback to change the build externals for the rollup build before they are used.
This function takes one argument and will be passed the defaultExternals. This function must return the final externals that should be used to create the rollup build list.
NOTE: You do not have to re-list globals in this list, all globals will be added as external automatically!
Example:
const config = generateRollupConfig({ externals(defaults) { return { browser: defaults.browser.concat([ 'foo', ]), module: defaults.module.concat([ 'foo' ], test: defaults.test.concat([ 'foo' ], }; } });
Type:
FunctionDefault: no default
A callback to change the build plugins and plugin order for the rollup build before they are used.
This function takes one argument and will be passed the defaultPlugins. This function must return the final plugins that should be used to create the rollup build list.
NOTE: Plugins can be "primed", here or in the
primedPluginsoption. By default all plugins are primed later and referenced by their key inprimedPlugins.
Example:
const config = generateRollupConfig({ plugins(defaults) { return { browser: defaults.browser.concat([ 'foo', ]), module: defaults.module.concat([ 'foo' ], test: defaults.test.concat([ 'foo' ], }; } });
Type:
FunctionDefault: no default
A callback to change the primed plugins for the rollup build before they are used.
This function takes one argument and will be passed the defaultPrimedPlugins. This function must return the final primed plugins that should be used to create the rollup build list.
Example:
const fooPlugin = require('rollup-plugin-foo'); const config = generateRollupConfig({ primedPlugins(defaults) { return Object.assign(defaults, { foo: fooPlugin(); }); } });
An object that contains keys for browser, module, and test globals that will be used by default. See the code for the more info.
const defaultGlobals = { browser: { 'video.js': 'videojs', 'global': 'window', 'global/window': 'window', 'global/document': 'document' }, module: { 'video.js': 'videojs' }, test: { 'qunit': 'QUnit', 'qunitjs': 'QUnit', 'sinon': 'sinon', 'video.js': 'videojs' } };
An object that contains keys for browser, module, and test externals that will be used by default.
NOTE: that we automatically add on any of globals provided into this list, as that is the default rollup behavior.
const defaultExternals = { browser: [], module: [ 'global', 'global/document', 'global/window' ], test: [] };
An object that contains keys for browser, module, and test plugins that will be used by default.
NOTE: The plugins are referenced as strings that will be the keys in the primedPlugins that generateRollupConfig uses.
const defaultPlugins = { // note that for the minBrowser build uglify will be inserted before // babel. browser: [ 'resolve', 'json', 'commonjs', 'babel' ], module: [ 'resolve', 'json', 'commonjs', 'babel' ], test: [ 'multiEntry', 'resolve', 'json', 'commonjs', 'babel' ] };
An object that contains primed rollup plugins
const defaultPrimedPlugins = { babel: babel({ babelrc: false, exclude: 'node_modules/**', presets: [ [presetEnv, {loose: true, modules: false, targets: {browsers: settings.browserslist}}] ], plugins: [ externalHelpers, transformObjectAssign ] }), commonjs: commonjs({sourceMap: false}), json: json(), multiEntry: multiEntry({exports: false}), resolve: resolve({browser: true, main: true, jsnext: true}), uglify: uglify({output: {comments: 'some'}}, minify) };