README
@rollup/plugin-legacy
🍣 A Rollup plugin which adds export declarations to legacy non-module scripts.
Requirements
This plugin requires an LTS Node version (v8.0.0+) and Rollup v1.20.0+.
Install
Using npm:
npm install @rollup/plugin-legacy --save-dev
Usage
Create a rollup.config.js configuration file and import the plugin:
import legacy from '@rollup/plugin-legacy';
export default {
entry: 'src/main.js',
output: {
dir: 'output',
format: 'cjs'
},
plugins: [legacy({ 'vendor/some-library.js': 'someLibrary' })]
};
Then call rollup either via the CLI or the API.
Options
Type: Object
Default: null
Specifies an Object which defines exports used when importing corresponding scripts. The Object allows specifying script paths as a key, and the corresponding value as the exports for that script. For example:
Object Format
The Object format allows specifying aliases as a key, and the corresponding value as the actual import value. For example:
legacy({
'vendor/some-library.js': 'someLibrary',
'vendor/another-library.js': {
foo: 'anotherLib.foo',
bar: 'anotherLib.bar',
baz: 'anotherLib.baz'
}
});
The configuration above will create a default export when importing 'vendor/some-library.js' that corresponds with the someLibrary variable that it creates. It will also create named exports when importing 'vendor/another-library.js'.
Motivation
Occasionally you'll find a useful snippet of code from the Old Days, before newfangled technology like npm. These scripts will typically expose themselves as var someLibrary = ... or window.someLibrary = ..., the expectation being that other scripts will grab a reference to the library from the global namespace.
It's usually easy enough to convert these to modules. But why bother? You can just add the legacy plugin, configure it accordingly, and it will be turned into a module automatically. With the example config below, the following code...
// vendor/some-library.js
var someLibrary = {
square: function (n) {
return n * n;
},
cube: function (n) {
return n * n * n;
}
};
...will have a default export appended to it, allowing other modules to access it:
export default someLibrary;
It can also handle named exports. Using the same config, this...
// vendor/another-library.js
var anotherLibrary = {
foo: ...,
bar: ...,
baz: ...
};
...will get the following appended:
var __export0 = anotherLibrary.foo;
export { __export0 as foo };
var __export0 = anotherLibrary.bar;
export { __export0 as bar };
var __export0 = anotherLibrary.baz;
export { __export0 as baz };