multi-stage-sourcemap

WebJar for multi-stage-sourcemap

License	MIT
GroupId	org.webjars.npm
ArtifactId	multi-stage-sourcemap
Last Version	0.2.1
Release Date	May 13, 2016
Type	jar
Description	multi-stage-sourcemap WebJar for multi-stage-sourcemap
Project URL	http://webjars.org
Source Code Management	https://github.com/azu/multi-stage-sourcemap

Download multi-stage-sourcemap

Filename	Size
multi-stage-sourcemap-0.2.1.pom
multi-stage-sourcemap-0.2.1.jar	87 KB
multi-stage-sourcemap-0.2.1-sources.jar	22 bytes
multi-stage-sourcemap-0.2.1-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/multi-stage-sourcemap/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>multi-stage-sourcemap</artifactId>
    <version>0.2.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/multi-stage-sourcemap/
implementation 'org.webjars.npm:multi-stage-sourcemap:0.2.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/multi-stage-sourcemap/
implementation ("org.webjars.npm:multi-stage-sourcemap:0.2.1")

Apache Buildr

'org.webjars.npm:multi-stage-sourcemap:jar:0.2.1'

Apache Ivy

<dependency org="org.webjars.npm" name="multi-stage-sourcemap" rev="0.2.1">
  <artifact name="multi-stage-sourcemap" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='multi-stage-sourcemap', version='0.2.1')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "multi-stage-sourcemap" % "0.2.1"

Leiningen

[org.webjars.npm/multi-stage-sourcemap "0.2.1"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.webjars.npm : source-map	jar	[0.1.34,0.2)

Project Modules

There are no modules declared in this project.

multi-stage-sourcemap

This library provide re-mapping function for multi-level sourcemap.

Installation

npm install multi-stage-sourcemap

Concept

Basic SourceMap

well-know basic sourcemap is no problem.

Multi-level SourceMap

Multi-level SourceMap has a problem.

Source Map Revision 3 Proposal doens't provide the way of mapping Minified Code to Original Code in the following figure.

Example:

A.js -> B.js     -> C.js
        B.js.map -> C.js.map

We can't see from C.js to A.js.

multi-stage-sourcemap <= THIS LIBRARY

multi-stage-sourcemap can mapping C.js to A.js

The easy but lossy way is to ignore the intermediate steps in the process for the purposes of debugging, the source location information from the translation is either ignored (the intermediate translation is considered the “Original Source”) or the source location information is carried through (the intermediate translation hidden). -- Source Map Revision 3 Proposal

multi-stage-sourcemap does that!

C.js -> ... -> A.js

Code:

var transfer = require("multi-stage-sourcemap").transfer;
var cToAMap = transfer({fromSourceMap: cMap, toSourceMap: bMap});

Usage

transfer

Return the re-mapped rawSourceMap string.

The only argument is an object with the following properties:

• fromSourceMap : Object - rawSourceMap or String - JSON.stringify(rawSourceMap)
• toSourceMap : Object - rawSourceMap or String - JSON.stringify(rawSourceMap)

rawSourceMap is like below object.

var rawSourceMap = {
  version: 3,
  file: 'min.js',
  names: ['bar', 'baz', 'n'],
  sources: ['one.js', 'two.js'],
  sourceRoot: 'http://exammuple.com/www/js/',
  mappings: 'CAAC,IAAI,IAAM,SAAUA,GAClB,OAAOC,IAAID;CCDb,IAAI,IAAM,SAAUE,GAClB,OAAOA'
};

For details, please see mozilla/source-map.

Use Case

• AltJS -> JavaScript -> minify
• AltJS -> JavaScript -> power-assert
  • power-assert supports multi-level sourcemaps using this module.
  • twada/battlefield-sourcemaps
  • power-assert 多段 SourceMap 対応の方針

etc...

AltJS is languages that compile to JS. (It's contain ES6 with Traceur. )

Related library

• Rich-Harris/sorcery

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

License

MIT

Versions

Version
0.2.1 May 13, 2016