gulp-es6-module-to-closure

compile ES6 import/export => Google Closure goog.require/goog.provide

Attention: For supporting ES6 features, some special rules are introduced. See examples below, especially if you use translated library from existing code.

Install

npm install gulp-es6-module-to-closure --save-dev

Usage

var es6ModuleToClosure = require("gulp-es6-module-to-closure");

gulp.src("./src/**/*.js")
  .pipe(es6ModuleToClosure({
    root: 'src',
    namespace: "prefix.name.space"
  }))
  .pipe(gulp.dest("./dist"));

Example

export

• Compiling ${srcDir}/ns/file-name.js

export var foo = 'FOO';

  with namespace `com.xxx` will generate
  ```javascript
goog.provide("com.xxx.ns.filename.foo");
goog.scope(function() {
    com.xxx.ns.filename.foo = 'FOO';
});

at ${distDir}/ns/file-name.js.

• Compiling ${srcDir}/ns/file-name.js

export default 'FOO';

  with namespace `com.xxx` will generate
  ```javascript
goog.provide("com.xxx.ns.filename.default");
goog.scope(function() {
    com.xxx.ns.filename.default = 'FOO';
});

at ${distDir}/ns/file-name.js.

import

• Compiling ${srcDir}/ns/app.js

import {foo} from './file-name.js';

  with namespace `com.xxx` will generate
  ```javascript
goog.require("com.xxx.ns.filename.foo");
goog.scope(function() {
    var foo = com.xxx.ns.filename.foo;
});

at ${distDir}/ns/app.js.

• Compiling ${srcDir}/ns/app.js

import foo from './file-name.js';

  with namespace `com.xxx` will generate
  ```javascript
goog.require("com.xxx.ns.filename.default");
goog.scope(function() {
    var foo = com.xxx.ns.filename.default;
});

at ${distDir}/ns/app.js.

Supported Syntax

Following table is made from Draft October 14, 2014.

https://people.mozilla.org/~jorendorff/es6-draft.html#sec-static-and-runtme-semantics-module-records

import

| Syntax | supported | |:--------------------------------------------------|:---------:| | import v from "mod"; | ✓ | | import * as ns from "mod"; | ✓ | | import {x} from "mod"; | ✓ | | import {x as v} from "mod"; {x} from "mod"; | ✓ |

export

| Syntax | supported | |:--------------------------------------------------|:---------:| | export var v; | ✓ | | export default function f(){}; | ✓ | | export default function(){}; | ✓ | | export default 42; | ✓ | | export {x}; | ✓ | | export {v as x}; | ✓ | | export {x} from "mod"; | | | export {v as x} from "mod"; | | | export * from "mod"; | |

Migration

v0.x.x => v1.x.x

Reference from manual code to generated code is changed.

Before:

goog.require('name.space.varName');

After:

goog.require('name.space.fileName.varName');