SourceMapper

Simple Swift implementation of the SourceMap specification: create, load, query, modify, and save source maps.

Examples

let map = try SourceMap(Data(contentsOf: mapURL))
print(map.file)

let unpackedMap = try UnpackedSourceMap(map)
let segment = unpackedMap.map(line: 12, column: 0)

var map = SourceMap()
map.sources = [.remote("a.scss")]
map.sourceRoot = "./../src/"
try map.set(segments: ..., validate: true)
let mapData = map.encode()

Documentation

• API documentation
• Dash docset

No support for:

• Extension fields
• Index map format

Requirements

• Swift 6.0
• macOS 14 (tested on macOS 14.6.1 IA64)
• Linux (tested on Ubuntu 18.04.5)
• Windows 10, Swift 6.0 (tested in CI only)

Installation

Only with Swift Package Manager, via Xcode or directly:

Package dependency:

.package(name: "SourceMapper",
         url: "https://github.com/johnfairh/SourceMapper.git",
         from: "3.0.0")

Contributions

Welcome: open an issue / johnfairh@gmail.com / @johnfairh@mastodon.social

License

Distributed under the MIT license.