@volar/source-map

Creating Source Maps

This feature allows you to create a new source map. The code sample demonstrates how to generate a source map and add a mapping to it.

const { SourceMapGenerator } = require('@volar/source-map');

const map = new SourceMapGenerator({ file: 'output.js' });
map.addMapping({
  generated: { line: 1, column: 5 },
  source: 'input.js',
  original: { line: 1, column: 5 },
  name: 'example'
});
console.log(map.toString());

Parsing Source Maps

This feature allows you to parse an existing source map. The code sample demonstrates how to use the SourceMapConsumer to read and interpret a raw source map.

const { SourceMapConsumer } = require('@volar/source-map');

const rawSourceMap = {
  version: 3,
  file: 'min.js',
  sources: ['one.js', 'two.js'],
  names: ['foo', 'bar'],
  mappings: 'AAgBC,SAAQ,CAAEA'
};

SourceMapConsumer.with(rawSourceMap, null, consumer => {
  console.log(consumer.sources);
  console.log(consumer.originalPositionFor({ line: 1, column: 5 }));
});

Combining Source Maps

This feature allows you to combine multiple source maps into one. The code sample demonstrates how to create two source maps and then combine them into a single source map.

const { SourceMapGenerator, SourceMapConsumer } = require('@volar/source-map');

const map1 = new SourceMapGenerator({ file: 'output1.js' });
map1.addMapping({
  generated: { line: 1, column: 5 },
  source: 'input1.js',
  original: { line: 1, column: 5 },
  name: 'example1'
});

const map2 = new SourceMapGenerator({ file: 'output2.js' });
map2.addMapping({
  generated: { line: 2, column: 10 },
  source: 'input2.js',
  original: { line: 2, column: 10 },
  name: 'example2'
});

const combinedMap = SourceMapGenerator.fromSourceMap(new SourceMapConsumer(map1.toString()));
combinedMap.applySourceMap(new SourceMapConsumer(map2.toString()));
console.log(combinedMap.toString());