Common Gulp tasks to support building web app modules.

All tasks are executed with gulp using the standard gulp syntax:

gulp <taskname>

Tasks include:

• build - Builds the inputs, drops to the output folder.
• build-watch - Watches files and auto builds on changes.
• test - Builds, and then runs tests.
• test-watch - Watches all files and auto builds/runs tests on changes.
• bundle - TBD
• serve - Spins up a localhost server that lets you browse static pages.
• nuke - Deletes build output.

For quick app development, use gulp serve. This will spin up the express server and host the content.

For quick library testing flows, use gulp test-watch.

Your gulpfile simply needs to initialize the core tasks:

'use strict';

let build = require('ms-core-build');

build.initializeTasks(
  require('gulp'), // the gulp instance to use for building
  { ... } // optional options
);

TBD

Your repo source should live under the 'src' directory. The default build will support the following formats:

/src
  **/*.ts - Typescript source files
  **/*.test.ts - Typescript test files, which should live next to sources.
  **/*.less - Less css files that get converted into AMD modules that you can require as './filename.css'
  **/*.html - Static HTML files that get minified
  **/*.png - PNGs that get minified 
  **/*.jpg - JPEGs that get minified

Building the source will drop under the 'lib' folder, preserving the directory structure from the src folder:

/lib
  **/* - All unbundled js/static resources will be dropped into lib.
  **/*.d.ts - All typescript definitions will be dropped as well.

In cases where the general build tools don't cover every scenario you have, you can use helpers to inject custom build steps into the common build task dependencies.

let build = require('ms-core-build');

// Create a custom gulp task as you normally would.
gulp.task('build-custom-stuff', () => { ... });

// Register the task to execute before "build" starts, if build things depend on this step.
build.doBefore('build', 'build-custom-stuff');

// Or, register it to execute while "build" is executing, if nothing depends on this step.
build.doDuring('build', 'build-custom-stuff');

// Or, register it to execute after "build" is complete if this step depends on build to be complete.
build.doAfter('build', 'build-custom-stuff');

// After dependencies are registered, initialize core tasks. They will make sure all of the instructions
// you've provided will be merged correctly into the gulp task dependencies.
build.initializeTasks(
  _dirname,
  require('gulp')
);