babel-plugin-rename-umd-globals

Rename and add aliases for global module name. Can be applied after babel-plugin-transform-es2015-modules-umd to modify global module name (example below).

Installation

# With npm
$ npm install babel-plugin-rename-umd-globals --save-dev

# With yarn 
$ yarn add babel-plugin-rename-assigned-properties --dev

Tested to work with Node >= 0.10

Usage

Options

You need to define the rename mapping with plugin options. Just map of old names to new names (and their optional aliases).

Example via .babelrc

Transform global.myModule = value to global.MyM = value

{
  "plugins": [
    ["rename-umd-globals", {
      "myModule": "MyM"
    }]
  ]
}

More examples via .babelrc

You can also add aliases for global module name by providing array. It will be transformed to chained assignments of global module name.

{
  "plugins": [
    ["rename-umd-globals", {
      "coolio": ["Coolio", "C", "ArtisLeonIveyJr"]
    }]
  ]
}

Via Node API

require("babel-core").transform("code", {
  plugins: [
    ["rename-umd-globals", {
      "myModule": "MyM"
    }]
  ]
});

Together with other umd plugins

It can be combined with babel-plugin-add-module-exports and babel-plugin-transform-es2015-modules-umd. Make sure to use the same plugin order as below!

{
  "presets": ["es2015"],
  "plugins": [
    "add-module-exports",
    "transform-es2015-modules-umd",
    ["rename-umd-globals", {
      "myModule": "MyM"
    }]
  ]
}

Caveats

• Expects the global object to be named global. If your global scope object happens to be named differently, like root, then just use babel-plugin-rename-assigned-properties instead for arbitrary object property renaming.

Sponsors

Leonidas