tc39/source-map

Source map specification, RFCs and new proposals.

Source Map Specification

This repository contains the different revisions of the source map specification.

The first and second revision of the spec are provided for historical context. These revisions don't have widespread adoption in tools.

What's here

The most recent specification is the v3 revision. It's converted into MarkDown format for this repository.

• Revision 3

There is an ongoing initiative to harden the specification, clarify it and to convert it into a stronger standard. The draft of this initiative can be found here:

• Draft Source
• Rendered Draft
• RFC and Discussions

Older revisions:

• Revision 2
• Revision 1

Generating the draft specification

1. Install pipx (installation instructions)
2. Run pipx run bikeshed from this repository's root folder
3. Open source-map.html in your browser

Current Proposals

Proposal	Author	Stage
Scopes	Holger Benl, Simon Zünd	Stage 3
Range Mappings	Tobias Koppers	Stage 2
Debug ID	Luca Forstner	Stage 1
Env	Nick Fitzgerald	Stage 1

License

The source map specifications are published under CC BY-SA 3.0.

Original Locations

These documents have previously been hosted on Google Docs:

• Revision 1: Source Mapping
• Revision 2: Closure Compiler Source Map 2.0
• Revision 3: Source Map Revision 3 Proposal