Simple JavaScript utility that combines Source Map files while concatenating JavaScript source files
JavaScript CoffeeScript Shell
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
example
lib
src
test
.gitignore
Makefile
README.md
package.json

README.md

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!

WebKit Source Map support shows in developer tools

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');