videojs-generate-rollup-config
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
Installation
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.
Environment variables
These can be passed via rollup's --environment
or just setting an environment variable
TEST_BUNDLE_ONLY
Type:
Boolean
Default: 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.
NO_TEST_BUNDLE
Type:
Boolean
Default: 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.
Function Options
options that are passed as an object to the generateRollupConfig
function.
input
Type:
string
Default:src/plugin.js
The entry point for your build.
testInput
Type:
string
Default:test/**/*.test.js
The entry point for tests.
distName
Type:
string
Default: 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.
exportName
Type:
string
Default: 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 aexportName
ofvideojsFooBar
.- The
browser
/minBrowser
dist would be exported to window aswindow.videojsFooBar
. - The
test
dist would be exported to window aswindow.videojsFooBarTests
.
excludeCoverage
Type:
Function
Default: 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']
coverage
Type:
Boolean
Default: true
Whether to include istanbul for the unit test bundle. By default it is included.
browserslist
Type:
string|Array
Default: ['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.
checkWatch
Type:
boolean
Default:true
Determines if we should check if rollup is in watch mode. If it is we exclude the minBrowser build to save development time.
banner
Type:
string
Default:/*! @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!
babel
Type:
Function
Default: 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;
}
})
globals
Type:
Function
Default: 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'
}),
};
}
})
};
externals
Type:
Function
Default: 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'
],
};
}
});
plugins
Type:
Function
Default: 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
primedPlugins
option. 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'
],
};
}
});
primedPlugins
Type:
Function
Default: 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();
});
}
});
Defaults
defaultGlobals
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'
}
};
defaultExternals
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: []
};
defaultPlugins
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'
]
};
defaultPrimedPlugins
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)
};