rollup-plugin-external-globals

rollup-plugin-external-globals

Transform external imports into global variables like Rollup's output.globals option. See rollup/rollup#2374

Installation

npm install -D rollup-plugin-external-globals

Usage

import externalGlobals from "rollup-plugin-external-globals";

export default {
  input: ["entry.js"],
  output: {
    dir: "dist",
    format: "es"
  },
  plugins: [
    externalGlobals({
      jquery: "$"
    })
  ]
};

The above config transforms

import jq from "jquery";

console.log(jq(".test"));

into

console.log($(".test"));

API

This module exports a single function.

createPlugin

const plugin = createPlugin(
  globals: Object,
  {
    include?: Array,
    exclude?: Array
  } = {}
);

globals is a moduleId/variableName map. For example, to map jquery module to $:

{
  jquery: "$"
}

include is an array of glob patterns. If defined, only matched files would be transformed.

exclude is an array of glob patterns. Matched files would not be transformed.

Changelog

• 0.2.1 (Oct 2, 2018)

  • Fix: don't skip export statement.

• 0.2.0 (Sep 12, 2018)

  • Change: use transform hook.
  • Add: rewrite conflicted variable names.
  • Add: handle export from.

• 0.1.0 (Aug 5, 2018)

  • Initial release.