Provides a single-file build for SystemJS of mixed-dependency module trees.
Builds ES6 into ES5, CommonJS, AMD and globals into a single file in a way that supports the CSP SystemJS loader as well as circular references.
app.js
import $ from "./jquery";
export var hello = 'es6';
jquery.js
define(function() {
return 'this is jquery';
});
Builds into:
// Declarative System.register (ES6)
// System.register(name, deps, declare)
System.register('app', ['./jquery'], function(deps) {
var $, hello;
return {
exports: {
get hello() {
return hello;
},
set hello(val) {
hello = val;
}
},
execute: function() {
$ = deps[0]['default'];
hello = 'es6';
}
}
});
define('jquery', function() {
return 'this is jquery';
});
It also provides a dynamic System.register variation for CommonJS and Globals. For example, CommonJS is output as:
// Dynamic module System.register
// System.register(name, deps, executingRequire, execute);
System.register("some/cjs", [], true, function(require, exports, __moduleName) {
var global = System.global;
var __define = global.define;
global.define = undefined;
var module = { exports: exports };
var process = System.get("@@nodeProcess")['default'];
exports.cjs = true;
global.define = __define;
return module.exports;
});
The true
boolean argument in the above indicates that CommonJS requires are execution driving,
as opposed to AMD which delays execution until all dependencies have been executed.
npm install systemjs-builder
var builder = require('systemjs-builder');
builder.build('myModule', {
baseURL: path.resolve('some/folder'),
// any map config
map: {
jquery: 'jquery-1.2.3/jquery'
},
// etc. any SystemJS config
}, 'outfile.js')
.then(function() {
console.log('Build complete');
})
.catch(function(err) {
console.log('Build error');
console.log(err);
});
The trace trees can be adjusted between tracing and building allowing for custom build layer creation.
Some simple trace tree operators are provided for subtraction addition and intersection.
Tree operations include addTrees
, subtractTrees
, intersectTrees
and extractTree
.
In this example we build app/core
excluding app/corelibs
:
var builder = require('systemjs-builder');
builder.config({
baseURL: '...',
map: {
}, // etc. config
});
builder.trace('app/main')
.then(function(appTree) {
return builder.trace('app/corelibs')
.then(function(coreTree) {
return builder.subtractTrees(appTree, coreTree);
});
})
.then(function(appMinusCoreTree) {
return builder.buildTree(appMinusCoreTree, 'output-file.js');
});
In this example we build app/first
and app/second
creating a separate app/shared
library:
var builder = require('systemjs-builder');
builder.config({
// ...
});
var firstTree, secondTree, commonTree;
builder.trace('app/first')
.then(function(tree) {
firstTree = tree;
return builder.trace('app/second');
})
.then(function(tree) {
secondTree = tree;
commonTree = builder.intersectTrees(firstTree, secondTree);
firstTree = builder.subtractTrees(firstTree, commonTree);
secondTree = builder.subtractTrees(secondTree, commonTree);
return builder.buildTree(firstTree, 'first-bundle.js');
})
.then(function() {
return builder.buildTree(secondTree, 'second-bundle.js');
})
.then(function() {
return builder.buildTree(commonTree, 'shared-bundle.js');
});
MIT