js-build-tools 2.3.1 → 3.0.0

package/functions/bundleMinify.test.js

@@ -9,6 +9,6 @@ describe('bundleMinify', () => {
   test('calls minifyFor with configurations', () => {
     expect.assertions(1)
     bundleMinify()
-    expect(minifyFor).toHaveBeenCalledWith(`${gulpConfig.get('browserPath')}/${gulpConfig.get('browserName')}.js`, gulpConfig.get('browserPath'))
+    expect(minifyFor).toHaveBeenCalledWith(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`, gulpConfig.get('browser.to'))
   })
 })

package/functions/copyFonts.js

@@ -0,0 +1,11 @@
+const copyFor = require('./partials/copyFor.js')
+const gulpConfig = require('../gulp.config.js')
+
+/**
+ * Move the font files into the browser directory.
+ * @memberOf module:js-build-tools
+ * @return {stream.Stream}
+ */
+const copyFonts = () => copyFor(gulpConfig.get('fonts.from'), gulpConfig.get('fonts.to'))
+
+module.exports = copyFonts

package/functions/copyFonts.test.js

@@ -0,0 +1,31 @@
+const fs = require('fs')
+const setUp = require('./test-helpers/setUp')
+setUp.setDefaults('test-copy-fonts')
+const gulpConfig = setUp.gulpConfig
+const copyFonts = require('./copyFonts')
+
+const fontContent = 'comic sans'
+
+beforeEach(setUp.beforeEach)
+
+afterEach(setUp.afterEach)
+
+describe('copyFonts', () => {
+  test('uses the configured paths', done => {
+    const srcPath = gulpConfig.get('srcPath') + '/fonts'
+    fs.mkdirSync(srcPath, { recursive: true })
+    const fontFile = `${srcPath}/comic-sans.woff`
+    fs.writeFileSync(fontFile, fontContent)
+    const fontPath = gulpConfig.get('fonts.to')
+    expect.assertions(1)
+    copyFonts()
+      .on('finish', () => {
+        expect(fs.existsSync(fontPath)).toBeTruthy()
+        done()
+      })
+      .on('error', error => {
+        console.error('Encountered error', error)
+        done()
+      })
+  }, 10000)
+})

package/functions/default.js

@@ -9,6 +9,6 @@ const { series } = require('gulp')
  * @param {function} [done=null]
  * @returns {stream.Stream}
  */
-const defaultCmd = (done = null) => gulpConfig.get('nodeOnly') ? series(dist)(done) : series(dist, bundle)(done)
+const defaultCmd = (done = null) => gulpConfig.get('browser.enabled') ? series(dist, bundle)(done) : series(dist)(done)
 
 module.exports = defaultCmd

package/functions/default.test.js

@@ -10,7 +10,7 @@ jest.mock('./dist', () => jest.fn(genericFunction))
 
 describe('distMinify', () => {
   test('calls dist for nodeOnly true', done => {
-    gulpConfig.set('nodeOnly', true)
+    gulpConfig.set('browser.enabled', false)
     expect.assertions(1)
     defaultCmd()
     setTimeout(() => {
@@ -20,7 +20,7 @@ describe('distMinify', () => {
   })
 
   test('calls dist and bundle for nodeOnly false', done => {
-    gulpConfig.set('nodeOnly', false)
+    gulpConfig.set('browser.enabled', true)
     expect.assertions(2)
     defaultCmd()
     setTimeout(() => {

package/functions/dist.js

@@ -2,7 +2,6 @@ const distFor = require('./partials/distFor.js')
 
 /**
  * Simplified distribution tasks which will use arguments from distFor.
- * @function
  * @memberOf module:js-build-tools
  * @returns {*}
  */

package/functions/dist.test.js

@@ -28,7 +28,7 @@ afterEach(setUp.afterEach)
 
 describe('dist', () => {
   test('uses the configured paths', done => {
-    const distPath = gulpConfig.get('distPath')
+    const distPath = gulpConfig.get('dist.to')
     expect.assertions(1)
     dist()
       .on('finish', () => {

package/functions/distLint.js

@@ -4,16 +4,15 @@ const standard = require('gulp-standard')
 
 /**
  * Applies Standard code style linting to distribution files.
- * @function
  * @memberOf module:js-build-tools
  * @returns {*}
  */
-const distLint = () => src(gulpConfig.get('distSearch'))
+const distLint = () => src(gulpConfig.get('browser.from'))
   .pipe(standard({ fix: true }))
   .pipe(standard.reporter('default', {
     fix: true,
     quiet: true
   }))
-  .pipe(dest(gulpConfig.get('distPath')))
+  .pipe(dest(gulpConfig.get('dist.to')))
 
 module.exports = distLint

package/functions/distLint.test.js

@@ -3,7 +3,7 @@ const setUp = require('./test-helpers/setUp')
 setUp.setDefaults('test-dist-lint')
 const gulpConfig = setUp.gulpConfig
 const distLint = require('./distLint')
-const { countMatches } = require('./testHelpers')
+const { countMatches } = require('test-filesystem')
 
 const lintableContents = 'const gulpConfig = require("../gulp.config.js");\n' +
   'const { dest, src } = require("gulp");\n' +
@@ -27,7 +27,7 @@ beforeEach(
   () => setUp.beforeEach()
     .then(
       async () => {
-        const distPath = gulpConfig.get('distPath')
+        const distPath = gulpConfig.get('dist.to')
         await fs.mkdirSync(distPath)
         return fs.writeFileSync(`${distPath}/distLint.js`, lintableContents)
       }
@@ -38,7 +38,7 @@ afterEach(setUp.afterEach)
 
 describe('distLint', () => {
   test('copies the src directory and babelifies it into the dist directory', done => {
-    const distPath = gulpConfig.get('distPath')
+    const distPath = gulpConfig.get('dist.to')
     const oldContents = fs.readFileSync(`${distPath}/distLint.js`).toString()
     expect.assertions(4)
     expect(countMatches(oldContents, '"')).toEqual(12)

package/functions/distMinify.js

@@ -3,10 +3,9 @@ const minifyFor = require('./partials/minifyFor')
 
 /**
  * Creates minified versions of the dist files.
- * @function
  * @memberOf module:js-build-tools
  * @returns {*}
  */
-const distMinify = () => minifyFor(gulpConfig.get('distSearch'), gulpConfig.get('distPath'))
+const distMinify = () => minifyFor(gulpConfig.get('browser.from'), gulpConfig.get('dist.to'))
 
 module.exports = distMinify

package/functions/distMinify.test.js

@@ -9,6 +9,6 @@ describe('distMinify', () => {
   test('calls minifyFor with configurations', () => {
     expect.assertions(1)
     distMinify()
-    expect(minifyFor).toHaveBeenCalledWith(gulpConfig.get('distSearch'), gulpConfig.get('distPath'))
+    expect(minifyFor).toHaveBeenCalledWith(gulpConfig.get('browser.from'), gulpConfig.get('dist.to'))
   })
 })

package/functions/images.js

@@ -0,0 +1,10 @@
+const imagesFor = require('./partials/imagesFor.js')
+
+/**
+ * Move and optimize the images into the browser folder using configured settings.
+ * @memberOf module:js-build-tools
+ * @return {stream.Stream}
+ */
+const images = () => imagesFor()
+
+module.exports = images

package/functions/images.test.js

@@ -0,0 +1,138 @@
+const fs = require('fs')
+const setUp = require('./test-helpers/setUp')
+setUp.setDefaults('test-images')
+const gulpConfig = setUp.gulpConfig
+const images = require('./images')
+
+const imageContents = '<?xml version="1.0" encoding="UTF-8" standalone="no"?>\n' +
+  '<!-- Created with Inkscape (http://www.inkscape.org/) -->\n' +
+  '\n' +
+  '<svg\n' +
+  '   xmlns:dc="http://purl.org/dc/elements/1.1/"\n' +
+  '   xmlns:cc="http://creativecommons.org/ns#"\n' +
+  '   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"\n' +
+  '   xmlns:svg="http://www.w3.org/2000/svg"\n' +
+  '   xmlns="http://www.w3.org/2000/svg"\n' +
+  '   xmlns:xlink="http://www.w3.org/1999/xlink"\n' +
+  '   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"\n' +
+  '   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"\n' +
+  '   id="svg2"\n' +
+  '   version="1.1"\n' +
+  '   inkscape:version="0.91 r13725"\n' +
+  '   width="600"\n' +
+  '   height="600"\n' +
+  '   viewBox="0 0 600 600"\n' +
+  '   sodipodi:docname="logo.svg">\n' +
+  '  <metadata\n' +
+  '     id="metadata8">\n' +
+  '    <rdf:RDF>\n' +
+  '      <cc:Work\n' +
+  '         rdf:about="">\n' +
+  '        <dc:format>image/svg+xml</dc:format>\n' +
+  '        <dc:type\n' +
+  '           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />\n' +
+  '        <dc:title></dc:title>\n' +
+  '      </cc:Work>\n' +
+  '    </rdf:RDF>\n' +
+  '  </metadata>\n' +
+  '  <defs\n' +
+  '     id="defs6" />\n' +
+  '  <sodipodi:namedview\n' +
+  '     pagecolor="#ffffff"\n' +
+  '     bordercolor="#666666"\n' +
+  '     borderopacity="1"\n' +
+  '     objecttolerance="10"\n' +
+  '     gridtolerance="10"\n' +
+  '     guidetolerance="10"\n' +
+  '     inkscape:pageopacity="0"\n' +
+  '     inkscape:pageshadow="2"\n' +
+  '     inkscape:window-width="1280"\n' +
+  '     inkscape:window-height="737"\n' +
+  '     id="namedview4"\n' +
+  '     showgrid="false"\n' +
+  '     inkscape:zoom="0.39333333"\n' +
+  '     inkscape:cx="300"\n' +
+  '     inkscape:cy="300"\n' +
+  '     inkscape:window-x="-8"\n' +
+  '     inkscape:window-y="-8"\n' +
+  '     inkscape:window-maximized="1"\n' +
+  '     inkscape:current-layer="svg2" />\n' +
+  '  <image\n' +
+  '     width="600"\n' +
+  '     height="600"\n' +
+  '     preserveAspectRatio="none"\n' +
+  '     xlink:href="data:image/png;base64,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\n' +
+  'TkSuQmCC\n' +
+  '"\n' +
+  '     id="image10"\n' +
+  '     x="0"\n' +
+  '     y="0" />\n' +
+  '  <path\n' +
+  '     style="fill:#000000"\n' +
+  '     d="M 19.039097,494.38241 C 2.0018627,482.75861 -2.8301068,468.02182 5.0071177,451.587 8.2776829,444.72855 15.162733,436.35919 20.307229,432.98839 c 8.904129,-5.83422 9.948263,-5.67522 21.727331,3.30915 28.014638,21.3678 44.091105,18.882 51.54879,-7.97059 C 99.533959,406.9008 98.83533,123.18555 92.8125,115.28305 90.196335,111.85041 81.496733,108.63382 73.125,108.00381 58.734191,106.92084 58.077731,106.30388 56.961131,92.8125 L 55.797259,78.75 l 163.053411,0 163.05342,0 2.57381,11.71845 c 2.93006,13.34047 -1.71086,18.13302 -17.64754,18.22413 C 347.54041,108.80285 345,115.82292 345,169.01786 l 0,48.48214 67.5,0 67.5,0 0,-48.1688 c 0,-41.90267 -0.89209,-48.97614 -6.85778,-54.37499 C 469.37044,111.54279 462.75847,108.75 458.44894,108.75 443.44309,108.75 438.75,104.6341 438.75,91.473791 l 0,-12.723791 80.85139,0 80.85135,0 -1.16385,14.0625 c -1.13201,13.67745 -1.60515,14.09431 -17.27948,15.22432 -13.44982,0.96964 -16.73767,2.79799 -19.87627,11.0531 -5.80185,15.26002 -2.83763,249.42009 3.25016,256.74719 2.61705,3.14985 11.47643,6.80123 19.6875,8.11425 14.52533,2.32268 14.9292,2.79386 14.9292,17.41755 l 0,15.03026 -79.6875,-1.01208 -79.6875,-1.01209 -1.1367,-13.60684 c -1.13565,-13.59401 -1.11975,-13.60939 16.875,-16.30515 9.90645,-1.4841 19.25149,-4.64227 20.76679,-7.01816 1.5153,-2.37593 2.78092,-30.05423 2.8125,-61.50735 L 480,258.75 l -67.59289,0 -67.5929,0 1.0304,60.9375 1.03039,60.9375 19.6875,3.3399 c 20.4921,3.4764 22.16576,5.78036 17.32391,23.8476 -2.25337,8.40847 -2.53065,8.4375 -80.57378,8.4375 l -78.31263,0 0,-14.95567 c 0,-14.53673 0.41823,-15.02258 14.9292,-17.34297 8.21107,-1.31302 17.07044,-4.96657 19.6875,-8.11909 3.63727,-4.38139 4.7583,-35.56081 4.7583,-132.34294 0,-69.63615 -1.23091,-127.84279 -2.73535,-129.3481 -9.73748,-9.7431 -68.9232,-8.34789 -79.15408,1.86593 -3.08612,3.08097 -4.99292,46.77065 -6.52417,149.48557 -1.45514,97.60931 -3.64592,149.67975 -6.6905,159.01994 -13.55129,41.57292 -61.40288,74.9124 -111.000242,77.33685 -22.754302,1.11229 -28.166407,0.0821 -39.231561,-7.46711 z"\n' +
+  '     id="path3338"\n' +
+  '     inkscape:connector-curvature="0" />\n' +
+  '</svg>\n'
+
+beforeEach(setUp.beforeEach)
+
+afterEach(setUp.afterEach)
+
+describe('images', () => {
+  test('uses the configured paths', done => {
+    const srcPath = gulpConfig.get('srcPath') + '/img'
+    fs.mkdirSync(srcPath, { recursive: true })
+    const imageFile = `${srcPath}/imageToCopy.svg`
+    fs.writeFileSync(imageFile, imageContents)
+    const imagePath = gulpConfig.get('images.to')
+    expect.assertions(1)
+    images()
+      .on('finish', () => {
+        expect(fs.existsSync(imagePath)).toBeTruthy()
+        done()
+      })
+      .on('error', error => {
+        console.error('Encountered error', error)
+        done()
+      })
+  }, 10000)
+})

package/functions/partials/addToReadme.js

@@ -6,14 +6,13 @@ const { globSync } = require('glob')
 /**
  * Appends all the jsdoc comments to the readme file. Assumes empty or templated file.
  * Configure this with 'readmeSearch', 'readmePath', 'readmeFile', and 'readmeOptions'.
- * @function
  * @memberOf module:partials
  * @returns {string|Uint8Array}
  */
 const addToReadme = () => jsdoc2md
-  .render({ files: globSync(gulpConfig.get('readmeSearch')) })
+  .render({ files: globSync(gulpConfig.get('readme.from')) })
   .then(
-    readme => fs.appendFileSync(gulpConfig.get('readmePath') + gulpConfig.get('readmeFile'), readme, gulpConfig.get('readmeOptions'))
+    readme => fs.appendFileSync(gulpConfig.get('readme.to') + gulpConfig.get('readme.file'), readme, gulpConfig.get('readmeOptions'))
   )
 
 module.exports = addToReadme

package/functions/partials/addToReadme.test.js

@@ -2,7 +2,7 @@ const fs = require('fs')
 const setUp = require('../test-helpers/setUp')
 setUp.setDefaults('test-add-to-readme')
 const gulpConfig = setUp.gulpConfig
-gulpConfig.set('srcSearch', 'test-temp/src/addToReadme.js')
+gulpConfig.set('dist.from', 'test-temp/src/addToReadme.js')
 const addToReadme = require('./addToReadme')
 
 const rawContents = '/**\n' +
@@ -21,7 +21,7 @@ afterEach(setUp.afterEach)
 
 describe('addToReadme', () => {
   test('generates the documentation', async () => {
-    const readmeFilePath = gulpConfig.get('readmePath') + gulpConfig.get('readmeFile')
+    const readmeFilePath = gulpConfig.get('readme.to') + gulpConfig.get('readme.file')
     expect.assertions(2)
     await addToReadme()
     await expect(fs.existsSync(readmeFilePath)).toBeTruthy()

package/functions/partials/beginWatcher.js

@@ -3,10 +3,9 @@ const { watch } = require('gulp')
 
 /**
  * Create a chokidar instance which watches and triggers change when the globed files are modified.
- * @function
  * @memberOf module:partials
  * @returns {FSWatcher}
  */
-const beginWatcher = () => watch(gulpConfig.get('watchSearch'))
+const beginWatcher = () => watch(gulpConfig.get('test.watch'))
 
 module.exports = beginWatcher

package/functions/partials/beginWatcher.test.js

@@ -10,7 +10,7 @@ afterEach(setUp.afterEach)
 
 describe('beginWatcher', () => {
   test('returns instance of EventEmitter / FSWatcher', () => {
-    gulpConfig.set('watchSearch', 'test-begin-watcher/*.js')
+    gulpConfig.set('test.watch', 'test-begin-watcher/*.js')
     const fsWatcher = beginWatcher()
     expect(fsWatcher).toBeInstanceOf(EventEmitter)
     fsWatcher.close()

package/functions/partials/clean.js

@@ -4,7 +4,6 @@ const removeDirectory = require('./removeDirectory')
 /**
  * Deletes all the distribution and browser files (used before create a new build).
  * Configure array of directories to remove with 'cleanPaths'.
- * @function
  * @memberOf module:partials
  * @returns {Promise<string[]> | *}
  */

package/functions/partials/copyFor.js

@@ -0,0 +1,13 @@
+const { dest, src } = require('gulp')
+
+/**
+ * Copy some files to a different location.
+ * @memberOf module:partials
+ * @param {string|array} srcPath
+ * @param {string} destPath
+ * @returns {stream.Stream}
+ */
+const copyFor = (srcPath, destPath) => src(srcPath)
+  .pipe(dest(destPath))
+
+module.exports = copyFor

package/functions/partials/copyFor.test.js

@@ -0,0 +1,34 @@
+const fs = require('fs')
+const setUp = require('../test-helpers/setUp')
+setUp.setDefaults('test-copy-for')
+const gulpConfig = setUp.gulpConfig
+const copyFor = require('./copyFor')
+
+const fileContents = 'some file contents'
+
+beforeEach(setUp.beforeEach)
+
+afterEach(setUp.afterEach)
+
+describe('copyFor', () => {
+  test('copies the file and ', done => {
+    const srcPath = gulpConfig.get('srcPath')
+    const copyFile = `${srcPath}/fileToCopy.txt`
+    fs.writeFileSync(copyFile, fileContents)
+    expect.assertions(3)
+    const oldContents = fs.readFileSync(copyFile).toString()
+    expect(oldContents).toEqual(fileContents)
+    const browserPath = gulpConfig.get('browser.to')
+    copyFor(copyFile, browserPath)
+      .on('finish', () => {
+        expect(fs.existsSync(browserPath)).toBeTruthy()
+        const movedContents = fs.readFileSync(`${browserPath}/fileToCopy.txt`).toString()
+        expect(movedContents).toEqual(fileContents)
+        done()
+      })
+      .on('error', error => {
+        console.error('Encountered error', error)
+        done()
+      })
+  })
+})

package/functions/partials/distFor.js

@@ -5,13 +5,12 @@ const 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 {stream.Stream}
  */
-const distFor = (srcPath = distForSrc(), destPath = gulpConfig.get('distPath')) => src(srcPath)
+const distFor = (srcPath = distForSrc(), destPath = gulpConfig.get('dist.to')) => src(srcPath)
   .pipe(babel())
   .pipe(dest(destPath))
 

package/functions/partials/distFor.test.js

@@ -3,7 +3,7 @@ const setUp = require('../test-helpers/setUp')
 setUp.setDefaults('test-dist-for')
 const gulpConfig = setUp.gulpConfig
 const distFor = require('./distFor')
-const { countMatches } = require('../testHelpers')
+const { countMatches } = require('test-filesystem')
 const typeScript = require('../typeScript')
 
 const rawContents = 'const babel = require(\'gulp-babel\')\n' +
@@ -71,7 +71,7 @@ describe('distFor', () => {
     expect.assertions(5)
     const oldContents = fs.readFileSync(srcFile).toString()
     expect(countMatches(oldContents, 'const ')).toEqual(7)
-    const distPath = gulpConfig.get('distPath')
+    const distPath = gulpConfig.get('dist.to')
     distFor(srcFile)
       .on('finish', () => {
         expect(fs.existsSync(distPath)).toBeTruthy()
@@ -99,7 +99,7 @@ describe('distFor', () => {
     expect.assertions(7)
     const oldContents = fs.readFileSync(srcFile).toString()
     expect(countMatches(oldContents, 'const ')).toEqual(3)
-    const distPath = gulpConfig.get('distPath')
+    const distPath = gulpConfig.get('dist.to')
     typeScript(() => {
       distFor()
         .on('finish', () => {
@@ -109,7 +109,7 @@ describe('distFor', () => {
           expect(countMatches(babelifiedContents, 'const ')).toEqual(0)
           expect(countMatches(babelifiedContents, 'var ')).toEqual(8)
           expect(countMatches(babelifiedContents, 'function')).toEqual(1)
-          expect(countMatches(babelifiedContents, 'Object.defineProperty(exports, "__esModule", { value: true })')).toEqual(1)
+          expect(countMatches(babelifiedContents, 'Object.defineProperty(exports, "__esModule", {')).toEqual(1)
           done()
         })
         .on('error', error => {

package/functions/partials/distForSrc.js

@@ -2,13 +2,12 @@ const 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}
  */
-const distForSrc = (useTs = gulpConfig.get('useTsConfig')) => useTs
-  ? gulpConfig.get('distSearch')
-  : gulpConfig.get('srcSearch')
+const distForSrc = (useTs = gulpConfig.get('typescript.enabled')) => useTs
+  ? gulpConfig.get('browser.from')
+  : gulpConfig.get('dist.from')
 
 module.exports = distForSrc

package/functions/partials/distForSrc.test.js

@@ -3,15 +3,15 @@ const gulpConfig = setUp.gulpConfig
 const distForSrc = require('./distForSrc')
 
 describe('distForSrc', () => {
-  test('useTsConfig as false returns srcSearch', () => {
+  test('typescript.enabled as false returns srcSearch', () => {
     expect.assertions(1)
-    gulpConfig.set('useTsConfig', false)
-    expect(distForSrc()).toBe(gulpConfig.get('srcSearch'))
+    gulpConfig.set('typescript.enabled', false)
+    expect(distForSrc()).toBe(gulpConfig.get('dist.from'))
   })
 
-  test('useTsConfig as true returns distSearch', () => {
+  test('typescript.enabled as true returns distSearch', () => {
     expect.assertions(1)
-    gulpConfig.set('useTsConfig', true)
-    expect(distForSrc()).toBe(gulpConfig.get('distSearch'))
+    gulpConfig.set('typescript.enabled', true)
+    expect(distForSrc()).toBe(gulpConfig.get('browser.from'))
   })
 })

package/functions/partials/distSeries.js

@@ -6,17 +6,16 @@ const 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(null=): stream.Stream}
  */
-const distSeries = (srcPath = distForSrc(), distFinalPath = gulpConfig.get('distPath'), tsSearch = gulpConfig.get('tsSearch')) => {
+const distSeries = (srcPath = distForSrc(), distFinalPath = gulpConfig.get('dist.to'), tsSearch = gulpConfig.get('typescript.from')) => {
   const typescript = tsFor(tsSearch, distFinalPath)
   const dist = () => distFor(srcPath, distFinalPath)
-  return gulpConfig.get('useTsConfig')
+  return gulpConfig.get('typescript.enabled')
     ? series(typescript, dist)
     : dist
 }

package/functions/partials/distSeries.test.js

@@ -11,22 +11,22 @@ jest.mock('./tsFor', () => jest.fn(() => genericFunction))
 
 describe('distSeries', () => {
   test('when not using ts config only returns runnable distFor', done => {
-    gulpConfig.set('useTsConfig', false)
+    gulpConfig.set('typescript.enabled', false)
     expect.assertions(1)
     distSeries()()
     setTimeout(() => {
-      expect(distFor).toHaveBeenCalledWith(gulpConfig.get('srcSearch'), gulpConfig.get('distPath'))
+      expect(distFor).toHaveBeenCalledWith(gulpConfig.get('dist.from'), gulpConfig.get('dist.to'))
       done()
     }, 500)
   })
 
   test('when using ts config returns runnable series of tsFor and distFor', done => {
-    gulpConfig.set('useTsConfig', true)
+    gulpConfig.set('typescript.enabled', true)
     expect.assertions(2)
     distSeries()()
     setTimeout(() => {
-      expect(tsFor).toHaveBeenCalledWith(gulpConfig.get('tsSearch'), gulpConfig.get('distPath'))
-      expect(distFor).toHaveBeenCalledWith(gulpConfig.get('distSearch'), gulpConfig.get('distPath'))
+      expect(tsFor).toHaveBeenCalledWith(gulpConfig.get('typescript.from'), gulpConfig.get('dist.to'))
+      expect(distFor).toHaveBeenCalledWith(gulpConfig.get('browser.from'), gulpConfig.get('dist.to'))
       done()
     }, 500)
   })

package/functions/partials/imagesFor.js

@@ -0,0 +1,33 @@
+const cache = require('gulp-cache')
+const { dest, src } = require('gulp')
+const gulpConfig = require('../../gulp.config.js')
+
+let imagemin = (content) => content
+try {
+  imagemin = require('../../vendor/gulp-imagemin').default
+} catch (e) {
+  // It didn't get created yet
+}
+
+/**
+ * Move and optimize images into the browser directory.
+ * @memberOf module:partials
+ * @param {string|array} [imageSrc=src/images/pattern]
+ * @param {string} [imageDest=dest/image/folder]
+ * @return {stream.Stream}
+ */
+const imagesFor = (imageSrc = gulpConfig.get('images.from'), imageDest = gulpConfig.get('images.to')) =>
+  src(imageSrc)
+    .pipe(
+      // Caching images that ran through imagemin
+      cache(
+        imagemin({
+          interlaced: true,
+          silent: true,
+          verbose: false,
+        })
+      )
+    )
+    .pipe(dest(imageDest))
+
+module.exports = imagesFor