mapcat is a simple utility that concatenates JavaScript files while also consolidating the corresponding source map files. It is useful if you use compile-to-JS languages whose compiler emits source map files. This is the case for CoffeeScript "transpiler" version 1.6 or later.
It's very easy to use:
bin/mapcat input1.map input2.map -m output.map -j output.js
You specify the input by specifying the associated source map files - mapcat
will find the actual JavaScript source files. Use -m to specify one output
source map file and -j to specify one output JavaScript file. Invoke without
any argument to see the (short) full help.
Example
There is a simple example project in the example folder. Run bash build.sh
to build the project. Then open index.html with Webkit Nightly or Chrome with
Source Map support turned on in the Developer Tools. If you have Scripts panel
enabled, refresh the page and you will see the program pause at a predefined
debugger line, and you are looking at, CoffeeScript!
API
You can also use the simple API. It exposes one simple function:
var cat = require('mapcat').cat;
cat(['input1.map', 'input2.map'], 'output.js', 'out.map');
