buxlabs / es6-to-amd

convert es6 to amd

ES to AMD converter

ES (EcmaScript) Module to AMD (Asynchronous Module Definition) converter

Table of Contents

• Background
• Install
• Usage
• Examples
• Maintainers
• Contributing
• License

Background

The import/export syntax is becoming more and more popular. Given a huge, legacy AMD application it's not trivial to migrate it all at once. The converter can help you transpile the modules into the AMD syntax temporarily for backwards compatibility.

Install

npm install @buxlabs/es6-to-amd

Usage

node

Convert a single file with:

const es6toamd = require('@buxlabs/es6-to-amd');
const source = 'export default { hello: 'world' }';
const result = es6toamd(source); // define({ hello: 'world' });

Examples

ES

import Backbone from 'backbone';

export default Backbone.Model.extend({});

AMD

define(['backbone'], function (Backbone) {
    'use strict';
    return Backbone.Model.extend({});
});

There are more examples in the test/fixture directory.

Maintainers

@emilos.

Contributing

All contributions are highly appreciated! Open an issue or submit a PR.

License

MIT © buxlabs

es6-to-amd's Issues

wrong parsing of named function expression

var Foo = function (code, message) {
    this.code = code;
    this.name = message;
}

Foo.prototype = Error.prototype;

export default Foo;

results in

var Foo = function (code, message) {
    this.code = code;
    this.name = message || "";
}

Foo.prototype = Error.prototype;

define(Foo);

export default array bug

export default ["foo", "bar"];

results with

define(["foo", "bar"]);

and the expected result is:

define(function () { return ["foo", "bar"]; });

Bug in import / export conversion

import foo from "foo";
import "bar";
import plugin from "bar.plugin";

results in

define([
    "foo",
    "bar",
    "bar.plugin"
], function (foo, plugin) {
  
});

the expected result is:

define([
    "foo",
    "bar",
    "bar.plugin"
], function (foo, /* any free var name */, plugin) {
  
});

Generate free identifier for ImportSpecifier

in:

import { Model } from 'backbone';

export default Model.extend({});

out:

define(['backbone'], function (a) {
    'use strict';
    return a.Model.extend({});
});

The above works, however if we use multiple ImportSpecifiers then the new variable new will not be assigned properly https://github.com/buxlabs/es6-to-amd/blob/master/src/class/Module.js#L41.

e.g. this will break:

import { Model } from 'backbone';
import { each } from 'underscore';

export default Model.extend({
    hello() {
        _.each([1, 2, 3], () => {});
    }
});

Speed up generateFreeIdentifier

Check out Map/Set