Adding a bunch of gulp utilities

This should allow a developer to write a gulpfile in TypeScript to
compile a TypeScript project.

gulp-sourcemaps/gulp-sourcemaps-tests.ts

@@ -0,0 +1,99 @@
+/// <reference path="./gulp-sourcemaps.d.ts"/>
+/// <reference path="../gulp/gulp.d.ts"/>
+import gulp = require("gulp");
+import sourcemaps = require("gulp-sourcemaps");
+
+function plugin1(): NodeJS.ReadWriteStream { return null; }
+function plugin2(): NodeJS.ReadWriteStream { return null; }
+
+gulp.task('javascript', function() {
+    gulp.src('src/**/*.js')
+        .pipe(sourcemaps.init())
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write())
+        .pipe(gulp.dest('dist'));
+});
+
+gulp.task('javascript', function() {
+    gulp.src('src/**/*.js')
+        .pipe(sourcemaps.init())
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write('../maps'))
+        .pipe(gulp.dest('dist'));
+});
+
+gulp.task('javascript', function() {
+    gulp.src('src/**/*.js')
+        .pipe(sourcemaps.init({loadMaps: true}))
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write())
+        .pipe(gulp.dest('dist'));
+});
+
+gulp.task('javascript', function() {
+    gulp.src(['src/test.js', 'src/testdir/test2.js'], { base: 'src' })
+        .pipe(sourcemaps.init())
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write('../maps'))
+        .pipe(gulp.dest('dist'));
+});
+
+gulp.task('javascript', function() {
+    var stream = gulp.src('src/**/*.js')
+        .pipe(sourcemaps.init())
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write('../maps', {addComment: false}))
+        .pipe(gulp.dest('dist'));
+});
+
+gulp.task('javascript', function() {
+    var stream = gulp.src('src/**/*.js')
+        .pipe(sourcemaps.init())
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write({includeContent: false, sourceRoot: '/src'}))
+        .pipe(gulp.dest('dist'));
+});
+
+gulp.task('javascript', function() {
+    var stream = gulp.src('src/**/*.js')
+        .pipe(sourcemaps.init())
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write({
+            includeContent: false,
+            sourceRoot: function(file) {
+                return '/src';
+            }
+        }))
+        .pipe(gulp.dest('dist'));
+});
+
+gulp.task('javascript', function() {
+    var stream = gulp.src('src/**/*.js')
+        .pipe(sourcemaps.init())
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write('../maps', {
+            sourceMappingURLPrefix: 'https://asset-host.example.com/assets'
+        }))
+        .pipe(gulp.dest('public/scripts'));
+});
+
+gulp.task('javascript', function() {
+    var stream = gulp.src('src/**/*.js')
+        .pipe(sourcemaps.init())
+        .pipe(plugin1())
+        .pipe(plugin2())
+        .pipe(sourcemaps.write('../maps', {
+            sourceMappingURLPrefix: function(file) {
+                return 'https://asset-host.example.com/assets'
+            }
+        }))
+        .pipe(gulp.dest('public/scripts'));
+});

gulp-sourcemaps/gulp-sourcemaps.d.ts

@@ -0,0 +1,28 @@
+// Type definitions for gulp-sourcemaps
+// Project: https://github.com/floridoo/gulp-sourcemaps
+// Definitions by: Asana <https://asana.com>
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
+/// <reference path="../node/node.d.ts"/>
+
+declare module "gulp-sourcemaps" {
+    interface InitOptions {
+        loadMaps?: boolean;
+        debug?: boolean;
+    }
+
+    interface WriteMapper {
+        (file: string): string;
+    }
+
+    interface WriteOptions {
+        addComment?: boolean;
+        includeContext?: boolean;
+        sourceRoot?: string | WriteMapper;
+        sourceMappingURLPrefix?: string | WriteMapper;
+    }
+
+    export function init(opts?: InitOptions): NodeJS.ReadWriteStream;
+    export function write(opts?: WriteOptions): NodeJS.ReadWriteStream;
+    export function write(path?: string, opts?: WriteOptions): NodeJS.ReadWriteStream;
+}