# @gulp-sourcemaps/map-sources [![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][travis-image]][travis-url] [![AppVeyor Build Status][appveyor-image]][appveyor-url] [![Coveralls Status][coveralls-image]][coveralls-url] Gulp plugin for mapping sources of a sourcemap. ## Strict No LLM / No AI Policy No LLMs for issues. No LLMs for patches / pull requests. No LLMs for comments on the bug tracker, including translation. English is encouraged, but not required. You are welcome to post in your native language and rely on others to have their own translation tools of choice to interpret your words. ## Example ```js var mapSources = require('@gulp-sourcemaps/map-sources'); gulp.src(...) .pipe(sourcemaps.init()) .pipe(mapSources(function(sourcePath, file) { return '../' + sourcePath; })) .pipe(sourcemaps.write()) .pipe(gulp.dest(...)) ``` ## API ### `mapSources(mapFn)` Takes a map function as the only argument. Returns an `objectMode` Transform stream. #### `mapFn(sourcePath, file)` The map function is called once per value of the `sources` array of a `sourceMap` attached to each [`Vinyl`][vinyl-url] object passed through the stream. The map function is called with the `sourcePath` string from the `sources` array and the `file` object it originated from. The return value replaces the original value in the array. If a `Vinyl` object doesn't have a `sourceMap` or `sourceMap.sources` property, the file is passed through the stream without having the `mapFn` called. All `sources` are normalized to use `/` instead of `\\` as path separators. ## License MIT [vinyl-url]: https://github.com/gulpjs/vinyl [downloads-image]: http://img.shields.io/npm/dm/@gulp-sourcemaps/map-sources.svg [npm-url]: https://npmjs.org/package/@gulp-sourcemaps/map-sources [npm-image]: http://img.shields.io/npm/v/@gulp-sourcemaps/map-sources.svg [travis-url]: https://travis-ci.org/gulp-sourcemaps/map-sources [travis-image]: http://img.shields.io/travis/gulp-sourcemaps/map-sources.svg?label=travis-ci [appveyor-url]: https://ci.appveyor.com/project/phated/map-sources [appveyor-image]: https://img.shields.io/appveyor/ci/phated/map-sources.svg?label=appveyor [coveralls-url]: https://coveralls.io/r/gulp-sourcemaps/map-sources [coveralls-image]: http://img.shields.io/coveralls/gulp-sourcemaps/map-sources.svg