js-build-tools 5.2.0 → 5.3.0

package/README.md

@@ -11,6 +11,7 @@ Using this tool suite, you can:
 * Bundle your distribution files to be used in a browser environment.
 * Run tests and watch for changes.
 * Generate jsdoc readme files.
+* Generate HTML documentation straight from your TypeScript source (with TypeDoc), with a module for each of your folders.
 
 ## Installation
 
@@ -50,6 +51,23 @@ provided are the defaults):
     // The output directory for the distribution files.
     "to": "dist"
   },
+  "docs": {
+    // Toggle generating the HTML documentation from the TypeScript source (see 'Configure TypeScript documentation').
+    // When on, the build does this instead of generating the readme from the jsdoc comments.
+    "enabled": false,
+    // The directory holding the TypeScript source, each folder in it becomes a module of the documentation.
+    "from": "src",
+    // The markdown file used as the front page of the documentation.
+    "index": "MAIN.md",
+    // How much TypeDoc reports: Verbose, Info, Warn, Error or None.
+    "logLevel": "Warn",
+    // The name of the documentation, defaults to the name in your package.json.
+    "title": "",
+    // The directory to generate the documentation in (it is cleared first).
+    "to": "docs",
+    // The tsconfig file to read the source with, false to use the one of 'typescript.config'.
+    "tsconfig": false
+  },
   "fonts": {
     // Toggle copy directory of fonts on
     "enabled": false,
@@ -130,6 +148,7 @@ For example:
 const {
   build,
   defaultCmd,
+  docs,
   partials,
   readme,
   sass,
@@ -145,6 +164,7 @@ const {
 // You can list your available tasks by running `gulp --tasks`.
 exports.build = build
 exports.default = defaultCmd
+exports.docs = docs
 exports.readme = readme
 exports.sass = sass
 exports.testFull = testFull
@@ -161,6 +181,7 @@ exports.watchTest = watchTest
 export {
   build,
   defaultCmd,
+  docs,
   partials,
   readme,
   sass,
@@ -248,6 +269,7 @@ module.exports = {
 ### Configure HTML JS Documentation (optional)
 
 It may be desirable to generate HTML documentation for your JS files.
+(For a TypeScript project, see 'Configure TypeScript documentation' instead.)
 
 Create a `.jsdoc.conf.js` file and add the following:
 
@@ -333,21 +355,29 @@ Create a `tsconfig.json` file in your project root with the following:
 
 ```json
 {
-  "files": [
-    "src/**/*.ts"
-  ],
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/**/*.test.*"],
   "compilerOptions": {
-    "noImplicitAny": true,
-    "target": "es6",
-    "moduleResolution": "node",
-    "declaration": true
+    "strict": true,
+    "target": "es2020",
+    "module": "commonjs",
+    "moduleResolution": "node10",
+    "ignoreDeprecations": "6.0",
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "declaration": true,
+    "types": []
   }
 }
 ```
 
-The pattern for `"files"` should match your .ts files, but the essential thing is that it is wrapped in an array.
-The actual pattern used comes from `build-tools.config.json` as `'typescript.from'` setting.
-To create the ts declaration files, you must add the `"declaration": true`.
+The pattern for `"include"` should match your .ts files (and leave out the tests, which can stay `.test.js` files).
+The actual pattern used to compile comes from `build-tools.config.json` as the `'typescript.from'` setting.
+To create the ts declaration files, you must add the `"declaration": true`. The `typescript` package is an optional peer
+dependency, install it in your project with `npm install --save-dev typescript` (versions 5.0 up to, but not including,
+7 are supported). When you write relative imports, leave the `.js` extension off (`import a from './a'`), because
+they stop resolving once the target is a `.ts` file. The compile only builds `.ts` files while `typescript.enabled` is
+on, so convert a whole library at once.
 
 Add the following to the exports in your `build-tools.config.json`:
 
@@ -382,6 +412,40 @@ babelConfig.presets.push('@babel/preset-typescript')
 module.exports = babelConfig
 ```
 
+### Configure TypeScript documentation (optional)
+
+`jsdoc-to-markdown` only reads `.js` files, so the types in your `.ts` files (and the comments on them) do not reach
+the readme it generates. Instead, this can generate HTML documentation straight from the TypeScript source with
+[TypeDoc](https://typedoc.org/). Every folder in your source directory becomes a module of the documentation, the default
+export of each file (one function per file) is listed under the name of the file, and everything else a file exports (for
+example the types in a `types.ts`) is listed as it is. Index files, tests and declaration files are left out. The
+comments on your code are the documentation, and the types come from the code itself, so `@module`, `@memberOf`,
+`@typedef` and the `{Type}` of `@param` are not needed.
+
+`typedoc` is an optional peer dependency (like `typescript`), install it in your project with
+`npm install --save-dev typedoc` (this needs a `typescript` version it supports).
+
+Add the following to the exports in your `build-tools.config.json`:
+
+```json
+{
+  "docs": {
+    // Generate the documentation from the TypeScript source
+    "enabled": true,
+    // The directory holding the TypeScript source, each folder in it becomes a module
+    "from": "src",
+    // The markdown file used as the front page of the documentation (a short overview of your project)
+    "index": "MAIN.md",
+    // Where the HTML is generated (the directory is cleared first)
+    "to": "docs"
+  }
+}
+```
+
+While `docs.enabled` is on, `gulp build` generates the documentation instead of the readme, so your `README.md` stays
+hand-written (a short overview which links to the documentation). If you also export `docs` from your gulpfile you can
+run it on its own with `gulp docs`, and can then add the script `"docs": "gulp docs"`.
+
 ### Configure Scripts
 
 In your `package.json` file, add the following scripts:
@@ -391,6 +455,7 @@ In your `package.json` file, add the following scripts:
   "scripts": {
     "build": "gulp build",
     "dev": "gulp",
+    "docs": "gulp docs",
     "htmldocs": "jsdoc -R MAIN.md -c ./.jsdoc.conf.js -d docs",
     "readme": "gulp readme",
     "sass": "gulp sass",

package/dist/build.js

@@ -10,6 +10,7 @@ const _bundleLint = require('./bundleLint.js')
 const _bundleMinify = require('./bundleMinify.js')
 const _partials = require('./partials.js')
 const _compileReadme = require('./compileReadme.js')
+const _typeDocs = require('./typeDocs.js')
 const _distLint = require('./distLint.js')
 const _distMinify = require('./distMinify.js')
 const _gulp = require('gulp')
@@ -29,7 +30,11 @@ const build = (done = null) => {
   const distLintMinify = (0, _gulp.parallel)(_distLint.distLint, _distMinify.distMinify)
   const bundleLintMinify = (0, _gulp.parallel)(_bundleLint.bundleLint, _bundleMinify.bundleMinify)
   const buildActions = [(0, _partials.distSeries)(), distLintMinify]
-  if (gulpConfig.get('typescript.enabled')) {
+  const generateDocs = gulpConfig.get('docs.enabled')
+  if (generateDocs) {
+    // The documentation is generated from the TypeScript source itself, the readme is written by hand
+    buildActions.push(_typeDocs.typeDocs)
+  } else if (gulpConfig.get('typescript.enabled')) {
     // For ts usage, we need to run the readme on the dist directly since that is where the .js files are located
     buildActions.push(_compileReadme.compileReadme)
   }
@@ -39,7 +44,7 @@ const build = (done = null) => {
     buildActions.push(bundleLintMinify)
   }
   const runActions = [(0, _gulp.series)(...buildActions)]
-  if (!gulpConfig.get('typescript.enabled')) {
+  if (!generateDocs && !gulpConfig.get('typescript.enabled')) {
     // Since we didn't run this in series after dist because of typescript, we need to run it now. Potentially faster here.
     runActions.push(_compileReadme.compileReadme)
   }

package/dist/build.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.build=void 0;var _bundle=require("./bundle.js"),_bundleLint=require("./bundleLint.js"),_bundleMinify=require("./bundleMinify.js"),_partials=require("./partials.js"),_compileReadme=require("./compileReadme.js"),_distLint=require("./distLint.js"),_distMinify=require("./distMinify.js"),_gulp=require("gulp"),gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_copyFonts=require("./copyFonts.js"),_images=require("./images.js"),_sass=require("./sass.js"),_testFull=require("./testFull.js");function _interopRequireWildcard(e,i){if("function"==typeof WeakMap)var s=new WeakMap,t=new WeakMap;return(_interopRequireWildcard=function(e,i){if(!i&&e&&e.__esModule)return e;var l,r,n={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return n;if(l=i?t:s){if(l.has(e))return l.get(e);l.set(e,n)}for(const i in e)"default"!==i&&{}.hasOwnProperty.call(e,i)&&((r=(l=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,i))&&(r.get||r.set)?l(n,i,r):n[i]=e[i]);return n})(e,i)}const build=(e=null)=>{const i=(0,_gulp.parallel)(_distLint.distLint,_distMinify.distMinify),s=(0,_gulp.parallel)(_bundleLint.bundleLint,_bundleMinify.bundleMinify),t=[(0,_partials.distSeries)(),i];gulpConfig.get("typescript.enabled")&&t.push(_compileReadme.compileReadme),gulpConfig.get("browser.enabled")&&(t.push(_bundle.bundle),t.push(s));const l=[(0,_gulp.series)(...t)];return gulpConfig.get("typescript.enabled")||l.push(_compileReadme.compileReadme),l.push(_testFull.testFull),gulpConfig.get("fonts.enabled")&&l.push(_copyFonts.copyFonts),gulpConfig.get("images.enabled")&&l.push(_images.images),gulpConfig.get("sass.enabled")&&l.push(_sass.sass),(0,_gulp.series)(_partials.clean,(0,_gulp.parallel)(...l))(e)};exports.build=build;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.build=void 0;var _bundle=require("./bundle.js"),_bundleLint=require("./bundleLint.js"),_bundleMinify=require("./bundleMinify.js"),_partials=require("./partials.js"),_compileReadme=require("./compileReadme.js"),_typeDocs=require("./typeDocs.js"),_distLint=require("./distLint.js"),_distMinify=require("./distMinify.js"),_gulp=require("gulp"),gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_copyFonts=require("./copyFonts.js"),_images=require("./images.js"),_sass=require("./sass.js"),_testFull=require("./testFull.js");function _interopRequireWildcard(e,i){if("function"==typeof WeakMap)var s=new WeakMap,t=new WeakMap;return(_interopRequireWildcard=function(e,i){if(!i&&e&&e.__esModule)return e;var l,r,u={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return u;if(l=i?t:s){if(l.has(e))return l.get(e);l.set(e,u)}for(const i in e)"default"!==i&&{}.hasOwnProperty.call(e,i)&&((r=(l=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,i))&&(r.get||r.set)?l(u,i,r):u[i]=e[i]);return u})(e,i)}const build=(e=null)=>{const i=(0,_gulp.parallel)(_distLint.distLint,_distMinify.distMinify),s=(0,_gulp.parallel)(_bundleLint.bundleLint,_bundleMinify.bundleMinify),t=[(0,_partials.distSeries)(),i],l=gulpConfig.get("docs.enabled");l?t.push(_typeDocs.typeDocs):gulpConfig.get("typescript.enabled")&&t.push(_compileReadme.compileReadme),gulpConfig.get("browser.enabled")&&(t.push(_bundle.bundle),t.push(s));const r=[(0,_gulp.series)(...t)];return l||gulpConfig.get("typescript.enabled")||r.push(_compileReadme.compileReadme),r.push(_testFull.testFull),gulpConfig.get("fonts.enabled")&&r.push(_copyFonts.copyFonts),gulpConfig.get("images.enabled")&&r.push(_images.images),gulpConfig.get("sass.enabled")&&r.push(_sass.sass),(0,_gulp.series)(_partials.clean,(0,_gulp.parallel)(...r))(e)};exports.build=build;

package/dist/bundle.js

@@ -1,16 +1,16 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.bundle = void 0
-const _browserify = _interopRequireDefault(require('browserify'))
-const _gulp = require('gulp')
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _vinylSourceStream = _interopRequireDefault(require('vinyl-source-stream'))
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+'use strict'
+
+require('core-js/modules/esnext.weak-map.delete-all.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.bundle = void 0
+const _browserify = _interopRequireDefault(require('browserify'))
+const _gulp = require('gulp')
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _vinylSourceStream = _interopRequireDefault(require('vinyl-source-stream'))
+function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
 /**
  * Starting at the distribution entry point, bundle all the files into a single file and store them in the specified output directory.
  *
@@ -20,17 +20,17 @@ function _interopRequireDefault (e) { return e && e.__esModule ? e : { default:
  * code must not require it, or provide it another way, such as a separate script tag).
  * @memberOf module:js-build-tools
  * @returns {stream.Stream}
- */
-const bundle = () => {
-  const bundler = (0, _browserify.default)(gulpConfig.get('dist.main'))
-  const ignore = gulpConfig.get('browser.ignore')
-  const exclude = gulpConfig.get('browser.exclude')
-  if (ignore && ignore.length) {
-    bundler.ignore(ignore)
-  }
-  if (exclude && exclude.length) {
-    bundler.exclude(exclude)
-  }
-  return bundler.bundle().pipe((0, _vinylSourceStream.default)(`${gulpConfig.get('browser.name')}.js`)).pipe((0, _gulp.dest)(gulpConfig.get('browser.to')))
-}
-exports.bundle = bundle
+ */
+const bundle = () => {
+  const bundler = (0, _browserify.default)(gulpConfig.get('dist.main'))
+  const ignore = gulpConfig.get('browser.ignore')
+  const exclude = gulpConfig.get('browser.exclude')
+  if (ignore && ignore.length) {
+    bundler.ignore(ignore)
+  }
+  if (exclude && exclude.length) {
+    bundler.exclude(exclude)
+  }
+  return bundler.bundle().pipe((0, _vinylSourceStream.default)(`${gulpConfig.get('browser.name')}.js`)).pipe((0, _gulp.dest)(gulpConfig.get('browser.to')))
+}
+exports.bundle = bundle

package/dist/bundleLint.js

@@ -1,20 +1,20 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.bundleLint = void 0
-const _gulp = require('gulp')
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _standardLint = require('./partials/standardLint.js')
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
+'use strict'
+
+require('core-js/modules/esnext.weak-map.delete-all.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.bundleLint = void 0
+const _gulp = require('gulp')
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _standardLint = require('./partials/standardLint.js')
+function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
 /**
  * Applies Standard code style linting to bundled file.
  * @memberOf module:js-build-tools
  * @returns {stream.Stream}
- */
-const bundleLint = () => (0, _gulp.src)(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`).pipe((0, _standardLint.standardLint)({
-  fix: true
-})).pipe((0, _gulp.dest)(gulpConfig.get('browser.to')))
-exports.bundleLint = bundleLint
+ */
+const bundleLint = () => (0, _gulp.src)(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`).pipe((0, _standardLint.standardLint)({
+  fix: true
+})).pipe((0, _gulp.dest)(gulpConfig.get('browser.to')))
+exports.bundleLint = bundleLint

package/dist/bundleMinify.js

@@ -1,17 +1,17 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.bundleMinify = void 0
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _minifyFor = require('./partials/minifyFor.js')
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
+'use strict'
+
+require('core-js/modules/esnext.weak-map.delete-all.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.bundleMinify = void 0
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _minifyFor = require('./partials/minifyFor.js')
+function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
 /**
  * Creates the minified bundle file.
  * @memberOf module:js-build-tools
  * @returns {*}
- */
-const bundleMinify = () => (0, _minifyFor.minifyFor)(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`, gulpConfig.get('browser.to'))
-exports.bundleMinify = bundleMinify
+ */
+const bundleMinify = () => (0, _minifyFor.minifyFor)(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`, gulpConfig.get('browser.to'))
+exports.bundleMinify = bundleMinify

package/dist/compileReadme.js

@@ -1,14 +1,14 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.compileReadme = void 0
-const _partials = require('./partials.js')
-const _gulp = require('gulp')
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.compileReadme = void 0
+const _partials = require('./partials.js')
+const _gulp = require('gulp')
 /**
  * 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 = exports.compileReadme = (0, _gulp.series)(_partials.readmeTemplate, _partials.addToReadme)
+ */
+const compileReadme = exports.compileReadme = (0, _gulp.series)(_partials.readmeTemplate, _partials.addToReadme)

package/dist/copyFonts.js

@@ -1,17 +1,17 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.copyFonts = void 0
-const _copyFor = require('./partials/copyFor.js')
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
+'use strict'
+
+require('core-js/modules/esnext.weak-map.delete-all.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.copyFonts = void 0
+const _copyFor = require('./partials/copyFor.js')
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
 /**
  * Move the font files into the browser directory.
  * @memberOf module:js-build-tools
  * @return {stream.Stream}
- */
-const copyFonts = () => (0, _copyFor.copyFor)(gulpConfig.get('fonts.from'), gulpConfig.get('fonts.to'))
-exports.copyFonts = copyFonts
+ */
+const copyFonts = () => (0, _copyFor.copyFor)(gulpConfig.get('fonts.from'), gulpConfig.get('fonts.to'))
+exports.copyFonts = copyFonts

package/dist/default.js

@@ -1,20 +1,20 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.defaultCmd = void 0
-const _dist = require('./dist.js')
-const _bundle = require('./bundle.js')
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _gulp = require('gulp')
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
+'use strict'
+
+require('core-js/modules/esnext.weak-map.delete-all.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.defaultCmd = void 0
+const _dist = require('./dist.js')
+const _bundle = require('./bundle.js')
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _gulp = require('gulp')
+function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
 /**
  * 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 = (done = null) => gulpConfig.get('browser.enabled') ? (0, _gulp.series)(_dist.dist, _bundle.bundle)(done) : (0, _gulp.series)(_dist.dist)(done)
-exports.defaultCmd = defaultCmd
+ */
+const defaultCmd = (done = null) => gulpConfig.get('browser.enabled') ? (0, _gulp.series)(_dist.dist, _bundle.bundle)(done) : (0, _gulp.series)(_dist.dist)(done)
+exports.defaultCmd = defaultCmd

package/dist/dist.js

@@ -1,14 +1,14 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.dist = void 0
-const _distFor = require('./partials/distFor.js')
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.dist = void 0
+const _distFor = require('./partials/distFor.js')
 /**
  * Simplified distribution tasks which will use arguments from distFor.
  * @memberOf module:js-build-tools
  * @returns {*}
- */
-const dist = () => (0, _distFor.distFor)()
-exports.dist = dist
+ */
+const dist = () => (0, _distFor.distFor)()
+exports.dist = dist

package/dist/distLint.js

@@ -1,20 +1,20 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.distLint = void 0
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _gulp = require('gulp')
-const _standardLint = require('./partials/standardLint.js')
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
+'use strict'
+
+require('core-js/modules/esnext.weak-map.delete-all.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.distLint = void 0
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _gulp = require('gulp')
+const _standardLint = require('./partials/standardLint.js')
+function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
 /**
  * Applies Standard code style linting to distribution files.
  * @memberOf module:js-build-tools
  * @returns {*}
- */
-const distLint = () => (0, _gulp.src)(gulpConfig.get('browser.from')).pipe((0, _standardLint.standardLint)({
-  fix: true
-})).pipe((0, _gulp.dest)(gulpConfig.get('dist.to')))
-exports.distLint = distLint
+ */
+const distLint = () => (0, _gulp.src)(gulpConfig.get('browser.from')).pipe((0, _standardLint.standardLint)({
+  fix: true
+})).pipe((0, _gulp.dest)(gulpConfig.get('dist.to')))
+exports.distLint = distLint

package/dist/distMinify.js

@@ -1,17 +1,17 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.distMinify = void 0
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _minifyFor = require('./partials/minifyFor.js')
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
+'use strict'
+
+require('core-js/modules/esnext.weak-map.delete-all.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.distMinify = void 0
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _minifyFor = require('./partials/minifyFor.js')
+function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f })(e, t) }
 /**
  * Creates minified versions of the dist files.
  * @memberOf module:js-build-tools
  * @returns {*}
- */
-const distMinify = () => (0, _minifyFor.minifyFor)(gulpConfig.get('browser.from'), gulpConfig.get('dist.to'))
-exports.distMinify = distMinify
+ */
+const distMinify = () => (0, _minifyFor.minifyFor)(gulpConfig.get('browser.from'), gulpConfig.get('dist.to'))
+exports.distMinify = distMinify

package/dist/images.js

@@ -1,14 +1,14 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.images = void 0
-const _imagesFor = require('./partials/imagesFor.js')
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.images = void 0
+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 = () => (0, _imagesFor.imagesFor)()
-exports.images = images
+ */
+const images = () => (0, _imagesFor.imagesFor)()
+exports.images = images

package/dist/partials/addToReadme.js

@@ -1,23 +1,23 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.addToReadme = void 0;
-var _fs = _interopRequireDefault(require("fs"));
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _jsdocToMarkdown = _interopRequireDefault(require("jsdoc-to-markdown"));
-var _glob = require("glob");
-function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.addToReadme = void 0;
+var _fs = _interopRequireDefault(require("fs"));
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _jsdocToMarkdown = _interopRequireDefault(require("jsdoc-to-markdown"));
+var _glob = require("glob");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * Appends all the jsdoc comments to the readme file. Assumes empty or templated file.
  * Configure this with 'readmeSearch', 'readmePath', 'readmeFile', and 'readmeOptions'.
  * @memberOf module:partials
  * @returns {string|Uint8Array}
- */
-const addToReadme = () => _jsdocToMarkdown.default.render({
-  files: (0, _glob.globSync)(gulpConfig.get('readme.from'))
-}).then(readme => _fs.default.appendFileSync(gulpConfig.get('readme.to') + gulpConfig.get('readme.file'), readme, gulpConfig.get('readmeOptions')));
+ */
+const addToReadme = () => _jsdocToMarkdown.default.render({
+  files: (0, _glob.globSync)(gulpConfig.get('readme.from'))
+}).then(readme => _fs.default.appendFileSync(gulpConfig.get('readme.to') + gulpConfig.get('readme.file'), readme, gulpConfig.get('readmeOptions')));
 exports.addToReadme = addToReadme;

package/dist/partials/beginWatcher.js

@@ -1,17 +1,17 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.beginWatcher = void 0;
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _gulp = require("gulp");
-function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.beginWatcher = void 0;
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _gulp = require("gulp");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
  * Create a chokidar instance which watches and triggers change when the globed files are modified.
  * @memberOf module:partials
  * @returns {FSWatcher}
- */
-const beginWatcher = () => (0, _gulp.watch)(gulpConfig.get('test.watch'));
+ */
+const beginWatcher = () => (0, _gulp.watch)(gulpConfig.get('test.watch'));
 exports.beginWatcher = beginWatcher;