# @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. ## 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