gulpfile.js

var gulp = require('gulp');
var del = require('del'),
  ghPages = require('gulp-gh-pages'),
  header = require('gulp-header'),
  help = require('gulp-help-four'),
  fs = require('fs'),
  moment = require('moment'),
  rename = require('gulp-rename'),
  replace = require('gulp-replace'),
  tslint = require('gulp-tslint'),
  typedoc = require("gulp-typedoc"),
  uglify = require('gulp-uglify'),
  karma = require('karma'),
  webpack = require('webpack'),
  webpackStream = require('webpack-stream'),
  webpackConfig = require('./webpack.config'),
  webpackTestConfig = require('./webpack.test.config'),
  runSequence = require('gulp4-run-sequence'),
  argv = require('yargs').argv
  ;

help(gulp, undefined);

var package = require('./package.json');
var webpackBanner = package.name + " v" + package.version + " | (c) 2016 Microsoft Corporation " + package.license;
var gulpBanner = "/*! " + webpackBanner + " */\n";

gulp.task('build', 'Build for release', function (done) {
  return runSequence(
    'tslint:build',
    'clean:dist',
    'compile:ts',
    'min',
    'generatecustomdts',
    'header',
    done
  )
});

gulp.task('test', 'Run unit tests', function (done) {
  return runSequence(
    'tslint:test',
    'clean:tmp',
    'compile:spec',
    'test:spec',
    done
  )
});

gulp.task('ghpages', 'Deploy documentation to gh-pages', ['nojekyll'], function () {
  return gulp.src(['./docs/**/*'], {
    dot: true
  })
    .pipe(ghPages({
      force: true,
      message: 'Update ' + moment().format('LLL')
    }));
});

gulp.task("docs", 'Compile documentation from src code', function () {
  return gulp
    .src([
      "typings/globals/es6-promise/index.d.ts",
      "typings/globals/route-recognizer/index.d.ts",
      "src/**/*.ts"
    ])
    .pipe(typedoc({
      mode: 'modules',
      includeDeclarations: true,

      // Output options (see typedoc docs) 
      out: "./docs",
      json: "./docs/json/" + package.name + ".json",

      // TypeDoc options (see typedoc docs) 
      ignoreCompilerErrors: true,
      version: true
    }))
    ;
});

gulp.task('nojekyll', 'Add .nojekyll file to docs directory', function (done) {
  fs.writeFile('./docs/.nojekyll', '', function (error) {
    if (error) {
      throw error;
    }

    done();
  });
});

gulp.task('compile:ts', 'Compile source files', function () {
  webpackConfig.plugins = [
    new webpack.BannerPlugin(webpackBanner)
  ];

  return gulp.src(['typings/**/*.d.ts', './src/**/*.ts'])
    .pipe(webpackStream(webpackConfig))
    .pipe(gulp.dest('./dist'));
});

gulp.task('header', 'Add header to distributed files', function () {
  return gulp.src(['./dist/*.d.ts'])
    .pipe(header(gulpBanner))
    .pipe(gulp.dest('./dist'));
});

gulp.task('min', 'Minify build files', function () {
  return gulp.src(['!./dist/*.min.js', './dist/*.js'])
    .pipe(uglify({
      preserveComments: 'license'
    }))
    .pipe(rename({
      suffix: '.min'
    }))
    .pipe(gulp.dest('./dist/'));
});

gulp.task('clean:dist', 'Clean dist folder', function () {
  return del([
    './dist/**/*'
  ]);
});

gulp.task('clean:tmp', 'Clean dist folder', function () {
  return del([
    './tmp/**/*'
  ]);
});

gulp.task('compile:spec', 'Compile typescript for tests', function () {
  return gulp.src(['./test/*.spec.ts'], { allowEmpty: true })
    .pipe(webpackStream(webpackTestConfig))
    .pipe(gulp.dest('./tmp'));
});

gulp.task('generatecustomdts', 'Generate dts with no exports', function (done) {
  return gulp.src(['./dist/*.d.ts'])
    .pipe(replace(/export\s/g, ''))
    .pipe(rename(function (path) {
      path.basename = "router-noexports.d";
    }))
    .pipe(gulp.dest('dist/'));
});

gulp.task('test:spec', 'Runs spec tests', function (done) {
  new karma.Server.start({
    configFile: __dirname + '/karma.conf.js',
    singleRun: argv.watch ? false : true,
    captureTimeout: argv.timeout || 20000
  }, done);
});

gulp.task('tslint:build', 'Run TSLint on src', function () {
  return gulp.src(["src/**/*.ts"])
    .pipe(tslint({
      formatter: "verbose"
    }))
    .pipe(tslint.report());
});

gulp.task('tslint:test', 'Run TSLint on src and tests', function () {
  return gulp.src(["src/**/*.ts", "test/**/*.ts"])
    .pipe(tslint({
      formatter: "verbose"
    }))
    .pipe(tslint.report());
});