Stackline maintained package · v1.0.0

Resolve source maps without changing the contract.

The seven-function CommonJS API of [email protected], with real ESM, first-party types, and tested browser builds.

01 / Install

A narrow migration path

npm install @stackline/source-map-resolve

Or retain the historical import through an npm alias:

npm install source-map-resolve@npm:@stackline/source-map-resolve
Runtime contract: Node.js 12 or newer. A package promising Node 10 must raise its floor before migration.

02 / Browser artifact

Try the shipped resolver

This workbench imports the same self-contained ESM browser file distributed in the package.

Ready.

03 / Contract

Compatibility has a boundary

Primary baseline

[email protected] defines runtime behavior, callback scheduling, error metadata, and the seven CommonJS exports.

0.5.x consumers

[email protected] is separately characterized for shared APIs and ordinary cases. Old UMD bytes and dependency topology are not reproduced.

Intentional correction

Windows reader paths retain their drive designator. POSIX and network URL behavior stays aligned with 0.6.0.

Known limitation

Comment-like text inside strings may match. Inputs requiring grammar-level certainty should use a language-aware parser.

04 / API

Seven functions, additive packaging

FunctionPurpose
resolveSourceMapFind and read a map with a callback reader.
resolveSourceMapSyncSynchronous map lookup and parsing.
resolveSourcesResolve and optionally read every source.
resolveSourcesSyncSynchronous source resolution.
resolveResolve a map and its sources asynchronously.
resolveSyncSynchronous combined resolver.
parseMapToJSONStrip the XSSI prefix and parse map JSON.