js-build-tools 1.2.3 → 2.1.0

package/dist/build.js

@@ -1,23 +1,30 @@
 'use strict'
 
-const bundle = require('./bundle')
-const bundleLint = require('./bundleLint')
-const bundleMinify = require('./bundleMinify')
-const clean = require('./clean')
-const compileReadme = require('./compileReadme')
-const dist = require('./dist')
-const distLint = require('./distLint')
-const distMinify = require('./distMinify')
-const {
-  parallel,
-  series
-} = require('gulp')
-const gulpConfig = require('../gulp.config.js')
-const testFull = require('./testFull')
+var bundle = require('./bundle')
+var bundleLint = require('./bundleLint')
+var bundleMinify = require('./bundleMinify')
+var _require = require('./partials')
+var clean = _require.clean
+var distSeries = _require.distSeries
+var compileReadme = require('./compileReadme')
+var dist = require('./dist')
+var distLint = require('./distLint')
+var distMinify = require('./distMinify')
+var _require2 = require('gulp')
+var parallel = _require2.parallel
+var series = _require2.series
+var gulpConfig = require('../gulp.config.js')
+var testFull = require('./testFull')
 
 /**
  * Runs several processes to build and validate the project.
  * Cleans, distributes (lint and minify), bundles (lint and minify), creates the readme, then runs the tests.
+ * @memberOf module:js-build-tools
+ * @param {function} [done=null]
+ * @returns {stream.Stream}
  */
-const build = parallel(gulpConfig.nodeOnly ? series(clean, dist, parallel(distLint, distMinify)) : series(clean, dist, parallel(distLint, distMinify), bundle, parallel(bundleLint, bundleMinify)), compileReadme, testFull)
+var build = function build () {
+  var done = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null
+  return parallel(gulpConfig.get('nodeOnly') ? series(clean, dist, parallel(distLint, distMinify)) : series(clean, distSeries, parallel(distLint, distMinify), bundle, parallel(bundleLint, bundleMinify)), compileReadme, testFull)(done)
+}
 module.exports = build

package/dist/build.min.js

@@ -1 +1 @@
-"use strict";const bundle=require("./bundle"),bundleLint=require("./bundleLint"),bundleMinify=require("./bundleMinify"),clean=require("./clean"),compileReadme=require("./compileReadme"),dist=require("./dist"),distLint=require("./distLint"),distMinify=require("./distMinify"),{parallel:parallel,series:series}=require("gulp"),gulpConfig=require("../gulp.config.js"),testFull=require("./testFull"),build=parallel(gulpConfig.nodeOnly?series(clean,dist,parallel(distLint,distMinify)):series(clean,dist,parallel(distLint,distMinify),bundle,parallel(bundleLint,bundleMinify)),compileReadme,testFull);module.exports=build;
+"use strict";var bundle=require("./bundle"),bundleLint=require("./bundleLint"),bundleMinify=require("./bundleMinify"),_require=require("./partials"),clean=_require.clean,distSeries=_require.distSeries,compileReadme=require("./compileReadme"),dist=require("./dist"),distLint=require("./distLint"),distMinify=require("./distMinify"),_require2=require("gulp"),parallel=_require2.parallel,series=_require2.series,gulpConfig=require("../gulp.config.js"),testFull=require("./testFull"),build=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:null;return parallel(gulpConfig.get("nodeOnly")?series(clean,dist,parallel(distLint,distMinify)):series(clean,distSeries,parallel(distLint,distMinify),bundle,parallel(bundleLint,bundleMinify)),compileReadme,testFull)(e)};module.exports=build;

package/dist/bundle.js

@@ -1,15 +1,18 @@
 'use strict'
 
-const browserify = require('browserify')
-const {
-  dest
-} = require('gulp')
-const gulpConfig = require('../gulp.config.js')
-const source = require('vinyl-source-stream')
+var browserify = require('browserify')
+var _require = require('gulp')
+var dest = _require.dest
+var gulpConfig = require('../gulp.config.js')
+var source = require('vinyl-source-stream')
 
 /**
  * Starting at the distribution entry point, bundle all the files into a single file and store them in the specified output directory.
- * @returns {*}
+ * @function
+ * @memberOf module:js-build-tools
+ * @returns {stream.Stream}
  */
-const bundle = () => browserify(gulpConfig.distMain).bundle().pipe(source(''.concat(gulpConfig.browserName, '.js'))).pipe(dest(gulpConfig.browserPath))
+var bundle = function bundle () {
+  return browserify(gulpConfig.get('distMain')).bundle().pipe(source(''.concat(gulpConfig.get('browserName'), '.js'))).pipe(dest(gulpConfig.get('browserPath')))
+}
 module.exports = bundle

package/dist/bundle.min.js

@@ -1 +1 @@
-"use strict";const browserify=require("browserify"),{dest:dest}=require("gulp"),gulpConfig=require("../gulp.config.js"),source=require("vinyl-source-stream"),bundle=()=>browserify(gulpConfig.distMain).bundle().pipe(source("".concat(gulpConfig.browserName,".js"))).pipe(dest(gulpConfig.browserPath));module.exports=bundle;
+"use strict";var browserify=require("browserify"),_require=require("gulp"),dest=_require.dest,gulpConfig=require("../gulp.config.js"),source=require("vinyl-source-stream"),bundle=function(){return browserify(gulpConfig.get("distMain")).bundle().pipe(source("".concat(gulpConfig.get("browserName"),".js"))).pipe(dest(gulpConfig.get("browserPath")))};module.exports=bundle;

package/dist/bundleLint.js

@@ -1,20 +1,24 @@
 'use strict'
 
-const {
-  dest,
-  src
-} = require('gulp')
-const gulpConfig = require('../gulp.config.js')
-const standard = require('gulp-standard')
+require('core-js/modules/es.array.concat.js')
+var _require = require('gulp')
+var dest = _require.dest
+var src = _require.src
+var gulpConfig = require('../gulp.config.js')
+var standard = require('gulp-standard')
 
 /**
  * Applies Standard code style linting to bundled file.
- * @returns {*}
+ * @function
+ * @memberOf module:js-build-tools
+ * @returns {stream.Stream}
  */
-const bundleLint = () => src(''.concat(gulpConfig.browserPath, '/').concat(gulpConfig.browserName, '.js')).pipe(standard({
-  fix: true
-})).pipe(standard.reporter('default', {
-  fix: true,
-  quiet: true
-})).pipe(dest(gulpConfig.browserPath))
+var bundleLint = function bundleLint () {
+  return src(''.concat(gulpConfig.get('browserPath'), '/').concat(gulpConfig.get('browserName'), '.js')).pipe(standard({
+    fix: true
+  })).pipe(standard.reporter('default', {
+    fix: true,
+    quiet: true
+  })).pipe(dest(gulpConfig.get('browserPath')))
+}
 module.exports = bundleLint

package/dist/bundleLint.min.js

@@ -1 +1 @@
-"use strict";const{dest:dest,src:src}=require("gulp"),gulpConfig=require("../gulp.config.js"),standard=require("gulp-standard"),bundleLint=()=>src("".concat(gulpConfig.browserPath,"/").concat(gulpConfig.browserName,".js")).pipe(standard({fix:!0})).pipe(standard.reporter("default",{fix:!0,quiet:!0})).pipe(dest(gulpConfig.browserPath));module.exports=bundleLint;
+"use strict";require("core-js/modules/es.array.concat.js");var _require=require("gulp"),dest=_require.dest,src=_require.src,gulpConfig=require("../gulp.config.js"),standard=require("gulp-standard"),bundleLint=function(){return src("".concat(gulpConfig.get("browserPath"),"/").concat(gulpConfig.get("browserName"),".js")).pipe(standard({fix:!0})).pipe(standard.reporter("default",{fix:!0,quiet:!0})).pipe(dest(gulpConfig.get("browserPath")))};module.exports=bundleLint;

package/dist/bundleMinify.js

@@ -1,20 +1,16 @@
 'use strict'
 
-const {
-  dest,
-  src
-} = require('gulp')
-const gulpConfig = require('../gulp.config.js')
-const {
-  default: uglify
-} = require('gulp-uglify-es')
-const rename = require('gulp-rename')
+require('core-js/modules/es.array.concat.js')
+var gulpConfig = require('../gulp.config.js')
+var minifyFor = require('./partials/minifyFor')
 
 /**
  * Creates the minified bundle file.
+ * @function
+ * @memberOf module:js-build-tools
  * @returns {*}
  */
-const bundleMinify = () => src(''.concat(gulpConfig.browserPath, '/').concat(gulpConfig.browserName, '.js')).pipe(uglify()).pipe(rename({
-  extname: '.min.js'
-})).pipe(dest(gulpConfig.browserPath))
+var bundleMinify = function bundleMinify () {
+  return minifyFor(''.concat(gulpConfig.get('browserPath'), '/').concat(gulpConfig.get('browserName'), '.js'), gulpConfig.get('browserPath'))
+}
 module.exports = bundleMinify

package/dist/bundleMinify.min.js

@@ -1 +1 @@
-"use strict";const{dest:dest,src:src}=require("gulp"),gulpConfig=require("../gulp.config.js"),{default:uglify}=require("gulp-uglify-es"),rename=require("gulp-rename"),bundleMinify=()=>src("".concat(gulpConfig.browserPath,"/").concat(gulpConfig.browserName,".js")).pipe(uglify()).pipe(rename({extname:".min.js"})).pipe(dest(gulpConfig.browserPath));module.exports=bundleMinify;
+"use strict";require("core-js/modules/es.array.concat.js");var gulpConfig=require("../gulp.config.js"),minifyFor=require("./partials/minifyFor"),bundleMinify=function(){return minifyFor("".concat(gulpConfig.get("browserPath"),"/").concat(gulpConfig.get("browserName"),".js"),gulpConfig.get("browserPath"))};module.exports=bundleMinify;

package/dist/compileReadme.js

@@ -1,13 +1,15 @@
 'use strict'
 
-const addToReadme = require('./addToReadme')
-const readmeTemplate = require('./readmeTemplate')
-const {
-  series
-} = require('gulp')
+var _require = require('./partials')
+var addToReadme = _require.addToReadme
+var readmeTemplate = _require.readmeTemplate
+var _require2 = require('gulp')
+var series = _require2.series
 
 /**
  * Generate the README.md file based off of the template, then append the generated documentation.
+ * @memberOf module:js-build-tools
+ * @returns {stream.Stream}
  */
-const compileReadme = series(readmeTemplate, addToReadme)
+var compileReadme = series(readmeTemplate, addToReadme)
 module.exports = compileReadme

package/dist/compileReadme.min.js

@@ -1 +1 @@
-"use strict";const addToReadme=require("./addToReadme"),readmeTemplate=require("./readmeTemplate"),{series:series}=require("gulp"),compileReadme=series(readmeTemplate,addToReadme);module.exports=compileReadme;
+"use strict";var _require=require("./partials"),addToReadme=_require.addToReadme,readmeTemplate=_require.readmeTemplate,_require2=require("gulp"),series=_require2.series,compileReadme=series(readmeTemplate,addToReadme);module.exports=compileReadme;

package/dist/default.js

@@ -1,14 +1,19 @@
 'use strict'
 
-const {
-  series
-} = require('gulp')
-const dist = require('./dist')
-const bundle = require('./bundle')
-const gulpConfig = require('../gulp.config')
+var dist = require('./dist')
+var bundle = require('./bundle')
+var gulpConfig = require('../gulp.config')
+var _require = require('gulp')
+var series = _require.series
 
 /**
  * Recommended as the default task, runs the simple dist and bundle tasks.
+ * @memberOf module:js-build-tools
+ * @param {function} [done=null]
+ * @returns {stream.Stream}
  */
-const defaultCmd = gulpConfig.nodeOnly ? series(dist) : series(dist, bundle)
+var defaultCmd = function defaultCmd () {
+  var done = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null
+  return gulpConfig.get('nodeOnly') ? series(dist)(done) : series(dist, bundle)(done)
+}
 module.exports = defaultCmd

package/dist/default.min.js

@@ -1 +1 @@
-"use strict";const{series:series}=require("gulp"),dist=require("./dist"),bundle=require("./bundle"),gulpConfig=require("../gulp.config"),defaultCmd=gulpConfig.nodeOnly?series(dist):series(dist,bundle);module.exports=defaultCmd;
+"use strict";var dist=require("./dist"),bundle=require("./bundle"),gulpConfig=require("../gulp.config"),_require=require("gulp"),series=_require.series,defaultCmd=function(){var e=arguments.length>0&&void 0!==arguments[0]?arguments[0]:null;return gulpConfig.get("nodeOnly")?series(dist)(e):series(dist,bundle)(e)};module.exports=defaultCmd;

package/dist/dist.js

@@ -1,10 +1,14 @@
 'use strict'
 
-const distFor = require('./distFor.js')
+var distFor = require('./partials/distFor.js')
 
 /**
  * Simplified distribution tasks which will use arguments from distFor.
+ * @function
+ * @memberOf module:js-build-tools
  * @returns {*}
  */
-const dist = () => distFor()
+var dist = function dist () {
+  return distFor()
+}
 module.exports = dist

package/dist/dist.min.js

@@ -1 +1 @@
-"use strict";const distFor=require("./distFor.js"),dist=()=>distFor();module.exports=dist;
+"use strict";var distFor=require("./partials/distFor.js"),dist=function(){return distFor()};module.exports=dist;

package/dist/distLint.js

@@ -1,20 +1,23 @@
 'use strict'
 
-const gulpConfig = require('../gulp.config.js')
-const {
-  dest,
-  src
-} = require('gulp')
-const standard = require('gulp-standard')
+var gulpConfig = require('../gulp.config.js')
+var _require = require('gulp')
+var dest = _require.dest
+var src = _require.src
+var standard = require('gulp-standard')
 
 /**
  * Applies Standard code style linting to distribution files.
+ * @function
+ * @memberOf module:js-build-tools
  * @returns {*}
  */
-const distLint = () => src(gulpConfig.distSearch).pipe(standard({
-  fix: true
-})).pipe(standard.reporter('default', {
-  fix: true,
-  quiet: true
-})).pipe(dest(gulpConfig.distPath))
+var distLint = function distLint () {
+  return src(gulpConfig.get('distSearch')).pipe(standard({
+    fix: true
+  })).pipe(standard.reporter('default', {
+    fix: true,
+    quiet: true
+  })).pipe(dest(gulpConfig.get('distPath')))
+}
 module.exports = distLint

package/dist/distLint.min.js

@@ -1 +1 @@
-"use strict";const gulpConfig=require("../gulp.config.js"),{dest:dest,src:src}=require("gulp"),standard=require("gulp-standard"),distLint=()=>src(gulpConfig.distSearch).pipe(standard({fix:!0})).pipe(standard.reporter("default",{fix:!0,quiet:!0})).pipe(dest(gulpConfig.distPath));module.exports=distLint;
+"use strict";var gulpConfig=require("../gulp.config.js"),_require=require("gulp"),dest=_require.dest,src=_require.src,standard=require("gulp-standard"),distLint=function(){return src(gulpConfig.get("distSearch")).pipe(standard({fix:!0})).pipe(standard.reporter("default",{fix:!0,quiet:!0})).pipe(dest(gulpConfig.get("distPath")))};module.exports=distLint;

package/dist/distMinify.js

@@ -1,20 +1,15 @@
 'use strict'
 
-const {
-  dest,
-  src
-} = require('gulp')
-const gulpConfig = require('../gulp.config.js')
-const {
-  default: uglify
-} = require('gulp-uglify-es')
-const rename = require('gulp-rename')
+var gulpConfig = require('../gulp.config.js')
+var minifyFor = require('./partials/minifyFor')
 
 /**
  * Creates minified versions of the dist files.
+ * @function
+ * @memberOf module:js-build-tools
  * @returns {*}
  */
-const distMinify = () => src(gulpConfig.distSearch).pipe(uglify()).pipe(rename({
-  extname: '.min.js'
-})).pipe(dest(gulpConfig.distPath))
+var distMinify = function distMinify () {
+  return minifyFor(gulpConfig.get('distSearch'), gulpConfig.get('distPath'))
+}
 module.exports = distMinify

package/dist/distMinify.min.js

@@ -1 +1 @@
-"use strict";const{dest:dest,src:src}=require("gulp"),gulpConfig=require("../gulp.config.js"),{default:uglify}=require("gulp-uglify-es"),rename=require("gulp-rename"),distMinify=()=>src(gulpConfig.distSearch).pipe(uglify()).pipe(rename({extname:".min.js"})).pipe(dest(gulpConfig.distPath));module.exports=distMinify;
+"use strict";var gulpConfig=require("../gulp.config.js"),minifyFor=require("./partials/minifyFor"),distMinify=function(){return minifyFor(gulpConfig.get("distSearch"),gulpConfig.get("distPath"))};module.exports=distMinify;

package/dist/partials/addToReadme.js

@@ -0,0 +1,25 @@
+"use strict";
+
+var fs = require('fs');
+var gulpConfig = require('../../gulp.config.js');
+var jsdoc2md = require('jsdoc-to-markdown');
+var _require = require('glob'),
+  globSync = _require.globSync;
+
+/**
+ * Appends all the jsdoc comments to the readme file. Assumes empty or templated file.
+ * @function
+ * @memberOf module:partials
+ * @param {function|null} [done=null]
+ * @returns {string|Uint8Array}
+ */
+var addToReadme = function addToReadme() {
+  var done = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
+  var files = globSync(gulpConfig.get('readmeSearch'));
+  var readme = jsdoc2md.renderSync({
+    files: files
+  });
+  fs.appendFileSync(gulpConfig.get('readmePath') + gulpConfig.get('readmeFile'), readme, gulpConfig.get('readmeOptions'));
+  return done && done();
+};
+module.exports = addToReadme;

package/dist/partials/beginWatcher.js

@@ -0,0 +1,16 @@
+"use strict";
+
+var gulpConfig = require('../../gulp.config.js');
+var _require = require('gulp'),
+  watch = _require.watch;
+
+/**
+ * Create a chokidar instance which watches and triggers change when the globed files are modified.
+ * @function
+ * @memberOf module:partials
+ * @returns {FSWatcher}
+ */
+var beginWatcher = function beginWatcher() {
+  return watch(gulpConfig.get('watchSearch'));
+};
+module.exports = beginWatcher;

package/dist/partials/clean.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var del = require('del');
+var gulpConfig = require('../../gulp.config.js');
+
+/**
+ * Deletes all the distribution and browser files (used before create a new build).
+ * @function
+ * @memberOf module:partials
+ * @param {function} [done=null]
+ * @param {string[]} [paths=['dist/config/path', 'browser/config/path']]
+ * @returns {Promise<string[]> | *}
+ */
+var clean = function clean() {
+  var done = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
+  var paths = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [gulpConfig.get('distPath'), gulpConfig.get('browserPath')];
+  return del(paths).then(function () {
+    return done && done();
+  });
+};
+module.exports = clean;

package/dist/partials/distFor.js

@@ -0,0 +1,23 @@
+"use strict";
+
+var babel = require('gulp-babel');
+var _require = require('gulp'),
+  dest = _require.dest,
+  src = _require.src;
+var distForSrc = require('./distForSrc');
+var gulpConfig = require('../../gulp.config.js');
+
+/**
+ * Build the distribution for a given source pattern.
+ * @function
+ * @memberOf module:partials
+ * @param {string|array} [srcPath='src/config/path/dist/for']
+ * @param {string} [destPath='dist/config/path']
+ * @returns {*}
+ */
+var distFor = function distFor() {
+  var srcPath = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : distForSrc();
+  var destPath = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : gulpConfig.get('distPath');
+  return src(srcPath).pipe(babel()).pipe(dest(destPath));
+};
+module.exports = distFor;

package/dist/partials/distForSrc.js

@@ -0,0 +1,16 @@
+"use strict";
+
+var gulpConfig = require('../../gulp.config');
+
+/**
+ * Retrieve the correct distFor search path based on TS Config.
+ * @function
+ * @memberOf module:partials
+ * @param {module:gulpConfig~FlagStringSetting} [useTs='config/for/ts']
+ * @returns {string}
+ */
+var distForSrc = function distForSrc() {
+  var useTs = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : gulpConfig.get('useTsConfig');
+  return useTs ? gulpConfig.get('distSearch') : gulpConfig.get('srcSearch');
+};
+module.exports = distForSrc;

package/dist/partials/distSeries.js

@@ -0,0 +1,31 @@
+"use strict";
+
+var gulpConfig = require('../../gulp.config');
+var distFor = require('./distFor');
+var distForSrc = require('./distForSrc');
+var _require = require('gulp'),
+  series = _require.series;
+var tsFor = require('./tsFor');
+
+/**
+ * When using TypeScript, ensure that we process the ts first then run babel (dist)
+ * @function
+ * @memberOf module:partials
+ * @param {string} [srcPath='src/config/path/dist/for']
+ * @param {string} [distFinalPath='dist/config/path']
+ * @param {string} [tsSearch='ts/search/config/path']
+ * @returns {Function}
+ */
+var distSeries = function distSeries() {
+  var srcPath = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : distForSrc();
+  var distFinalPath = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : gulpConfig.get('distPath');
+  var tsSearch = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : gulpConfig.get('tsSearch');
+  return gulpConfig.get('useTsConfig') ? series(function () {
+    return tsFor(tsSearch, distFinalPath);
+  }, function () {
+    return distFor(srcPath, distFinalPath);
+  }) : function () {
+    return distFor(srcPath, distFinalPath);
+  };
+};
+module.exports = distSeries;

package/dist/partials/minifyFor.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var _require = require('gulp'),
+  dest = _require.dest,
+  src = _require.src;
+var _require2 = require('gulp-uglify-es'),
+  uglify = _require2.default;
+var rename = require('gulp-rename');
+
+/**
+ * Minify files and rename the output with '.min' extension.
+ * @function
+ * @memberOf module:partials
+ * @returns {*}
+ */
+var minifyFor = function minifyFor(srcSearch, destination) {
+  return src(srcSearch).pipe(uglify()).pipe(rename({
+    extname: '.min.js'
+  })).pipe(dest(destination));
+};
+module.exports = minifyFor;

package/dist/partials/readmeTemplate.js

@@ -0,0 +1,18 @@
+"use strict";
+
+var _require = require('gulp'),
+  dest = _require.dest,
+  src = _require.src;
+var gulpConfig = require('../../gulp.config.js');
+var rename = require('gulp-rename');
+
+/**
+ * Copy a readme template into the README.md file.
+ * @function
+ * @memberOf module:partials
+ * @returns {*}
+ */
+var readmeTemplate = function readmeTemplate() {
+  return src(gulpConfig.get('readmeTemplate')).pipe(rename(gulpConfig.get('readmeFile'))).pipe(dest(gulpConfig.get('readmePath')));
+};
+module.exports = readmeTemplate;

package/dist/partials/runOnChange.js

@@ -0,0 +1,63 @@
+"use strict";
+
+require("core-js/modules/es.regexp.constructor.js");
+require("core-js/modules/es.regexp.exec.js");
+require("core-js/modules/es.regexp.sticky.js");
+require("core-js/modules/es.regexp.to-string.js");
+require("core-js/modules/es.string.replace.js");
+var gulpConfig = require('../../gulp.config.js');
+var bundle = require('../bundle');
+var distSeries = require('./distSeries');
+var _require = require('gulp'),
+  parallel = _require.parallel,
+  series = _require.series;
+var testQuick = require('../testQuick');
+
+/**
+ * Run this function when the watched files are modified.
+ * 1. Find the sub-folders within src path
+ * 2. Maintain the folders, but use distPath for base
+ * 3. Remove base folder and return dist path with correct sub-folders
+ * @example
+ * // Configured paths
+ * distPath = 'dist'
+ * srcPath = 'functions'
+ *
+ * // Path parameter
+ * path = 'functions/some/path/file.js'
+ *
+ * // Generated regex using configured srcPath
+ * pathRegex = '/^functions(.*\/).+\.js$/i'
+ *
+ * // Replace value using the configured distPath
+ * replacePath = 'dist$1'
+ *
+ * // The resulting replaced path for the destination folder
+ * distPathResult = 'dist/some/path/'
+ * @function
+ * @memberOf module:partials
+ * @param {string} path
+ * @returns {stream.Stream}
+ */
+var runOnChange = function runOnChange(path) {
+  var useTs = gulpConfig.get('useTsConfig');
+  var distPath = gulpConfig.get('distPath');
+  var srcPath = gulpConfig.get('srcPath');
+  /**
+   * 1. The original path comes in from src and is a .ts
+   * 2. Discover the outgoing dist path where that file should go
+   * 3. Use the path and dist in tsFor
+   * 4. Take the original path, convert to full file path in dist
+   * 5. Use the dist path found previously in #2
+   * 6. Use the full dist path and the dist outgoing path in distFor
+   */
+  var pathRegex = new RegExp("^".concat(srcPath, "(.*\\/)(.+)\\.(js|ts)$"), 'i');
+  var distPathResult = path.replace(pathRegex, "".concat(distPath, "$1"));
+  var distSrcPath = path;
+  if (useTs) {
+    distSrcPath = path.replace(pathRegex, "".concat(distPath, "$1$2.js"));
+  }
+  var runSeries = distSeries(distSrcPath, distPathResult, path);
+  return gulpConfig.get('nodeOnly') ? series(testQuick, runSeries)() : parallel(testQuick, series(runSeries, bundle))();
+};
+module.exports = runOnChange;

package/dist/partials/tsFor.js

@@ -0,0 +1,24 @@
+"use strict";
+
+var _require = require('gulp'),
+  dest = _require.dest,
+  src = _require.src;
+var gulpConfig = require('../../gulp.config.js');
+var ts = require('gulp-typescript');
+var tsProject = ts.createProject(gulpConfig.get('useTsConfig'));
+
+/**
+ * Starting at the source directory, find all the ts files and convert them into the distribution directory.
+ * @function
+ * @memberOf module:partials
+ * @param {string|array} [srcPath='']
+ * @param {string} [distPath='']
+ * @returns {stream.Stream}
+ * @see `https://www.typescriptlang.org/docs/handbook/gulp.html` for more info
+ */
+var tsFor = function tsFor() {
+  var srcPath = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : gulpConfig.get('tsSearch');
+  var distPath = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : gulpConfig.get('distPath');
+  return src(srcPath).pipe(tsProject()).js.pipe(dest(distPath));
+};
+module.exports = tsFor;

package/dist/partials.js

@@ -0,0 +1,33 @@
+'use strict'
+
+/**
+ * Micro-functions used as components for the main gulp functions.
+ * @file
+ * @author Joshua Heagle <joshuaheagle@gmail.com>
+ * @version 2.0.0
+ * @module partials
+ * @memberOf module:js-build-tools
+ */
+
+var addToReadme = require('./partials/addToReadme')
+var beginWatcher = require('./partials/beginWatcher')
+var clean = require('./partials/clean')
+var distFor = require('./partials/distFor')
+var distForSrc = require('./partials/distForSrc')
+var distSeries = require('./partials/distSeries')
+var minifyFor = require('./partials/minifyFor')
+var readmeTemplate = require('./partials/readmeTemplate')
+var runOnChange = require('./partials/runOnChange')
+var tsFor = require('./partials/tsFor')
+module.exports = {
+  addToReadme: addToReadme,
+  beginWatcher: beginWatcher,
+  clean: clean,
+  distFor: distFor,
+  distForSrc: distForSrc,
+  distSeries: distSeries,
+  minifyFor: minifyFor,
+  readmeTemplate: readmeTemplate,
+  runOnChange: runOnChange,
+  tsFor: tsFor
+}

package/dist/partials.min.js

@@ -0,0 +1 @@
+"use strict";var addToReadme=require("./partials/addToReadme"),beginWatcher=require("./partials/beginWatcher"),clean=require("./partials/clean"),distFor=require("./partials/distFor"),distForSrc=require("./partials/distForSrc"),distSeries=require("./partials/distSeries"),minifyFor=require("./partials/minifyFor"),readmeTemplate=require("./partials/readmeTemplate"),runOnChange=require("./partials/runOnChange"),tsFor=require("./partials/tsFor");module.exports={addToReadme:addToReadme,beginWatcher:beginWatcher,clean:clean,distFor:distFor,distForSrc:distForSrc,distSeries:distSeries,minifyFor:minifyFor,readmeTemplate:readmeTemplate,runOnChange:runOnChange,tsFor:tsFor};