js-build-tools 6.5.0 → 6.7.0

package/babel.config.js

@@ -1,28 +1,28 @@
-// Explicit targets so the compiled output does not change as browserslist / caniuse-lite data moves (the same query
-// resolved to different browsers on different installs). These are the versions that .browserslistrc
-// ("last 2 versions, > 0.25%, not dead") resolved to when they were pinned (2026-09); raise them deliberately.
-// .browserslistrc is still used by autoprefixer in the sass task.
-const targets = {
-  android: '150',
-  chrome: '109',
-  edge: '149',
-  firefox: '121',
-  ios: '16.6',
-  opera: '127',
-  opera_mobile: '80',
-  safari: '18.5',
-  samsung: '29'
-}
-
-module.exports = {
-  plugins: [
-    '@babel/plugin-transform-modules-commonjs'
-  ],
-  presets: [
-    ['@babel/preset-env', {
-      useBuiltIns: 'usage',
-      corejs: { version: '3.6', proposals: true },
-      targets
-    }]
-  ]
-}
+// Explicit targets so the compiled output does not change as browserslist / caniuse-lite data moves (the same query
+// resolved to different browsers on different installs). These are the versions that .browserslistrc
+// ("last 2 versions, > 0.25%, not dead") resolved to when they were pinned (2026-09); raise them deliberately.
+// .browserslistrc is still used by autoprefixer in the sass task.
+const targets = {
+  android: '150',
+  chrome: '109',
+  edge: '149',
+  firefox: '121',
+  ios: '16.6',
+  opera: '127',
+  opera_mobile: '80',
+  safari: '18.5',
+  samsung: '29'
+}
+
+module.exports = {
+  plugins: [
+    '@babel/plugin-transform-modules-commonjs'
+  ],
+  presets: [
+    ['@babel/preset-env', {
+      useBuiltIns: 'usage',
+      corejs: { version: '3.6', proposals: true },
+      targets
+    }]
+  ]
+}

package/dist/build.js

@@ -1,76 +1,76 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.build = void 0;
-var _bundle = require("./bundle.js");
-var _bundleMinify = require("./bundleMinify.js");
-var _partials = require("./partials.js");
-var _compileReadme = require("./compileReadme.js");
-var _typeDocs = require("./typeDocs.js");
-var _jsdocDocs = require("./jsdocDocs.js");
-var _distMinify = require("./distMinify.js");
-var _sourceLint = require("./sourceLint.js");
-var _gulp = require("gulp");
-var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
-var _copyFonts = require("./copyFonts.js");
-var _images = require("./images.js");
-var _resolveDocsMethod = require("./partials/resolveDocsMethod.js");
-var _sass = require("./sass.js");
-var _testFull = require("./testFull.js");
-var cache;
-function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Runs several processes to build and validate the project.
- * Cleans and lints the source, distributes and minifies, bundles and minifies, creates the readme, then runs the
- * tests.
- * @memberOf module:js-build-tools
- * @returns {stream.Stream}
- */
-const build = (done = null) => {
-  const buildActions = [(0, _partials.distSeries)(), _distMinify.distMinify];
-  const generateDocs = gulpConfig.get('docs.enabled');
-  const docsMethod = (0, _resolveDocsMethod.resolveDocsMethod)();
-  if (generateDocs) {
-    // The documentation is generated from the source itself, the readme is written by hand. With docs.inBuild off,
-    // generating it is left to the standalone docs task (gulp docs), so a build never rewrites it.
-    if (gulpConfig.get('docs.inBuild') !== false) {
-      buildActions.push(docsMethod === 'jsdoc' ? _jsdocDocs.jsdocDocs : _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);
-  }
-  if (gulpConfig.get('browser.enabled')) {
-    // If not 'nodeOnly' then we also want to bundle for browser after we complete the dist directory
-    buildActions.push(_bundle.bundle);
-    buildActions.push(_bundleMinify.bundleMinify);
-  }
-  const runActions = [(0, _gulp.series)(...buildActions)];
-  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);
-  }
-  runActions.push(_testFull.testFull);
-  if (gulpConfig.get('fonts.enabled')) {
-    // Conditionally add Fonts process
-    runActions.push(_copyFonts.copyFonts);
-  }
-  if (gulpConfig.get('images.enabled')) {
-    // Conditionally add Images process
-    runActions.push(_images.images);
-  }
-  if (gulpConfig.get('sass.enabled')) {
-    // Conditionally add SASS process
-    runActions.push(_sass.sass);
-  }
-  // clean has to finish before anything writes into the output folders - images, fonts and sass all write into
-  // browser/, so running clean in parallel with them races (ENOTEMPTY errors from clean, or output deleted mid-write).
-  // sourceLint fixes the real source in place before anything compiles from it (distSeries, tsFor inside it), so a
-  // build never reads a mix of pre- and post-fix content; clean only touches dist/browser output, so the two can
-  // run alongside each other.
-  return (0, _gulp.series)((0, _gulp.parallel)(_partials.clean, _sourceLint.sourceLint), (0, _gulp.parallel)(...runActions))(done);
-};
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.build = void 0;
+var _bundle = require("./bundle.js");
+var _bundleMinify = require("./bundleMinify.js");
+var _partials = require("./partials.js");
+var _compileReadme = require("./compileReadme.js");
+var _typeDocs = require("./typeDocs.js");
+var _jsdocDocs = require("./jsdocDocs.js");
+var _distMinify = require("./distMinify.js");
+var _sourceLint = require("./sourceLint.js");
+var _gulp = require("gulp");
+var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
+var _copyFonts = require("./copyFonts.js");
+var _images = require("./images.js");
+var _resolveDocsMethod = require("./partials/resolveDocsMethod.js");
+var _sass = require("./sass.js");
+var _testFull = require("./testFull.js");
+var cache;
+function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
+/**
+ * Runs several processes to build and validate the project.
+ * Cleans and lints the source, distributes and minifies, bundles and minifies, creates the readme, then runs the
+ * tests.
+ * @memberOf module:js-build-tools
+ * @returns {stream.Stream}
+ */
+const build = (done = null) => {
+  const buildActions = [(0, _partials.distSeries)(), _distMinify.distMinify];
+  const generateDocs = gulpConfig.get('docs.enabled');
+  const docsMethod = (0, _resolveDocsMethod.resolveDocsMethod)();
+  if (generateDocs) {
+    // The documentation is generated from the source itself, the readme is written by hand. With docs.inBuild off,
+    // generating it is left to the standalone docs task (gulp docs), so a build never rewrites it.
+    if (gulpConfig.get('docs.inBuild') !== false) {
+      buildActions.push(docsMethod === 'jsdoc' ? _jsdocDocs.jsdocDocs : _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);
+  }
+  if (gulpConfig.get('browser.enabled')) {
+    // If not 'nodeOnly' then we also want to bundle for browser after we complete the dist directory
+    buildActions.push(_bundle.bundle);
+    buildActions.push(_bundleMinify.bundleMinify);
+  }
+  const runActions = [(0, _gulp.series)(...buildActions)];
+  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);
+  }
+  runActions.push(_testFull.testFull);
+  if (gulpConfig.get('fonts.enabled')) {
+    // Conditionally add Fonts process
+    runActions.push(_copyFonts.copyFonts);
+  }
+  if (gulpConfig.get('images.enabled')) {
+    // Conditionally add Images process
+    runActions.push(_images.images);
+  }
+  if (gulpConfig.get('sass.enabled')) {
+    // Conditionally add SASS process
+    runActions.push(_sass.sass);
+  }
+  // clean has to finish before anything writes into the output folders - images, fonts and sass all write into
+  // browser/, so running clean in parallel with them races (ENOTEMPTY errors from clean, or output deleted mid-write).
+  // sourceLint fixes the real source in place before anything compiles from it (distSeries, tsFor inside it), so a
+  // build never reads a mix of pre- and post-fix content; clean only touches dist/browser output, so the two can
+  // run alongside each other.
+  return (0, _gulp.series)((0, _gulp.parallel)(_partials.clean, _sourceLint.sourceLint), (0, _gulp.parallel)(...runActions))(done);
+};
 exports.build = build;

package/dist/bundle.js

@@ -16,25 +16,25 @@ var _getBundleConfigs = require("./utilities/getBundleConfigs.js");
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Starting at each bundle's own entry point (dist.main for the primary bundle, or its own
- * override from browser.bundles), bundle all the reachable files into a single file per bundle and
- * store them in the specified output directory. A project with no browser.bundles entries gets
- * exactly the one bundle it always did; each additional entry produces its own separate bundle
- * (for example, a render-only variant built from a different entry point than the full bundle).
- *
- * A bundle's name does double duty: it names the output file (name.js) and, via browserify's
- * `standalone` option, is also the name its exports are exposed under - as a global when loaded
- * with a bare `<script>` tag, or as the module when required via CommonJS/AMD. Without this, a
- * bundle built from a real entry point (one that actually exports something) builds successfully
- * but exposes nothing a consumer can reach.
- *
- * Two escape hatches from browser.config.json keep an unwanted dependency (or a dependency's dependency) out of the
- * bundle: 'ignore' replaces it with an empty object (safe when your code never actually calls into it - for example
- * a library's default option value you always override with your own) and 'exclude' leaves it out entirely (your
- * code must not require it, or provide it another way, such as a separate script tag).
- * @memberOf module:js-build-tools
- * @returns {stream.Stream}
+/**
+ * Starting at each bundle's own entry point (dist.main for the primary bundle, or its own
+ * override from browser.bundles), bundle all the reachable files into a single file per bundle and
+ * store them in the specified output directory. A project with no browser.bundles entries gets
+ * exactly the one bundle it always did; each additional entry produces its own separate bundle
+ * (for example, a render-only variant built from a different entry point than the full bundle).
+ *
+ * A bundle's name does double duty: it names the output file (name.js) and, via browserify's
+ * `standalone` option, is also the name its exports are exposed under - as a global when loaded
+ * with a bare `<script>` tag, or as the module when required via CommonJS/AMD. Without this, a
+ * bundle built from a real entry point (one that actually exports something) builds successfully
+ * but exposes nothing a consumer can reach.
+ *
+ * Two escape hatches from browser.config.json keep an unwanted dependency (or a dependency's dependency) out of the
+ * bundle: 'ignore' replaces it with an empty object (safe when your code never actually calls into it - for example
+ * a library's default option value you always override with your own) and 'exclude' leaves it out entirely (your
+ * 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 = () => (0, _mergeStream.default)((0, _getBundleConfigs.getBundleConfigs)().map(({
   name,

package/dist/bundleMinify.js

@@ -12,13 +12,13 @@ var _minifyFor = require("./partials/minifyFor.js");
 var _getBundleConfigs = require("./utilities/getBundleConfigs.js");
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Creates the minified file for every bundle (the primary bundle, plus any additional ones from
- * browser.bundles). The minify step itself never varies per bundle, so this is one shared
- * src()/dest() pipeline (inside minifyFor) fed every bundle's filename at once, rather than one
- * pipeline per bundle - gulp's src() accepts an array of paths natively.
- * @memberOf module:js-build-tools
- * @returns {*}
+/**
+ * Creates the minified file for every bundle (the primary bundle, plus any additional ones from
+ * browser.bundles). The minify step itself never varies per bundle, so this is one shared
+ * src()/dest() pipeline (inside minifyFor) fed every bundle's filename at once, rather than one
+ * pipeline per bundle - gulp's src() accepts an array of paths natively.
+ * @memberOf module:js-build-tools
+ * @returns {*}
  */
 const bundleMinify = () => (0, _minifyFor.minifyFor)((0, _getBundleConfigs.getBundleConfigs)().map(({
   name

package/dist/compileReadme.js

@@ -6,9 +6,9 @@ Object.defineProperty(exports, "__esModule", {
 exports.compileReadme = void 0;
 var _partials = require("./partials.js");
 var _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}
+/**
+ * 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);

package/dist/copyFiles.js

@@ -11,23 +11,23 @@ var _copyFor = require("./partials/copyFor.js");
 var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Copy files from one place to another - any number of { from, to, base? } entries, configured via copyFiles.
- * A project with no copyFiles entries gets a task that does nothing. Meant to be run explicitly (its own script,
- * e.g. `gulp copyFiles`), not folded into the default build - a bundle (or any other file this copies) is often
- * the live, publicly-reachable version of something, so publishing it elsewhere should be a deliberate step, not
- * a side effect of every routine local build.
- *
- * Reuses copyFor (already shared with copyFonts) rather than a fresh src()/dest() pair - that keeps its existing
- * encoding: false fix (Gulp 5's default utf8 handling corrupts binary files such as fonts or a minified bundle)
- * instead of silently losing it in a parallel implementation.
- *
- * Each entry runs as its own independent copyFor(), awaited via Promise.all rather than merged into one combined
- * stream (mergeStream, the pattern bundle.mjs uses) - that pattern assumes every merged stream ends up at the
- * same shared destination; here, each entry can have a genuinely different one, and merging streams that each
- * already terminate at their own separate dest() hit a real "write after end" error in practice.
- * @memberOf module:js-build-tools
- * @returns {Promise<void>}
+/**
+ * Copy files from one place to another - any number of { from, to, base? } entries, configured via copyFiles.
+ * A project with no copyFiles entries gets a task that does nothing. Meant to be run explicitly (its own script,
+ * e.g. `gulp copyFiles`), not folded into the default build - a bundle (or any other file this copies) is often
+ * the live, publicly-reachable version of something, so publishing it elsewhere should be a deliberate step, not
+ * a side effect of every routine local build.
+ *
+ * Reuses copyFor (already shared with copyFonts) rather than a fresh src()/dest() pair - that keeps its existing
+ * encoding: false fix (Gulp 5's default utf8 handling corrupts binary files such as fonts or a minified bundle)
+ * instead of silently losing it in a parallel implementation.
+ *
+ * Each entry runs as its own independent copyFor(), awaited via Promise.all rather than merged into one combined
+ * stream (mergeStream, the pattern bundle.mjs uses) - that pattern assumes every merged stream ends up at the
+ * same shared destination; here, each entry can have a genuinely different one, and merging streams that each
+ * already terminate at their own separate dest() hit a real "write after end" error in practice.
+ * @memberOf module:js-build-tools
+ * @returns {Promise<void>}
  */
 const copyFiles = () => {
   const copies = gulpConfig.get('copyFiles', []);

package/dist/copyFonts.js

@@ -9,10 +9,10 @@ var _copyFor = require("./partials/copyFor.js");
 var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Move the font files into the browser directory.
- * @memberOf module:js-build-tools
- * @return {stream.Stream}
+/**
+ * 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;

package/dist/default.js

@@ -11,11 +11,11 @@ var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
 var _gulp = require("gulp");
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Recommended as the default task, runs the simple dist and bundle tasks.
- * @memberOf module:js-build-tools
- * @param {function} [done=null]
- * @returns {stream.Stream}
+/**
+ * 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;

package/dist/dist.js

@@ -5,10 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.dist = void 0;
 var _distFor = require("./partials/distFor.js");
-/**
- * Simplified distribution tasks which will use arguments from distFor.
- * @memberOf module:js-build-tools
- * @returns {*}
+/**
+ * Simplified distribution tasks which will use arguments from distFor.
+ * @memberOf module:js-build-tools
+ * @returns {*}
  */
 const dist = () => (0, _distFor.distFor)();
 exports.dist = dist;

package/dist/distMinify.js

@@ -9,10 +9,10 @@ var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
 var _minifyFor = require("./partials/minifyFor.js");
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Creates minified versions of the dist files.
- * @memberOf module:js-build-tools
- * @returns {*}
+/**
+ * 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;

package/dist/docs.js

@@ -7,13 +7,13 @@ exports.docs = void 0;
 var _jsdocDocs = require("./jsdocDocs.js");
 var _resolveDocsMethod = require("./partials/resolveDocsMethod.js");
 var _typeDocs = require("./typeDocs.js");
-/**
- * Generate the HTML documentation with whichever engine docs.method (or its typescript.enabled-based default)
- * resolves to - see {@link module:partials.resolveDocsMethod}. The standalone counterpart to build's own
- * internal branching, for running `gulp docs` directly instead of as part of a full build.
- * @memberOf module:js-build-tools
- * @param {Function} [done]
- * @returns {*}
+/**
+ * Generate the HTML documentation with whichever engine docs.method (or its typescript.enabled-based default)
+ * resolves to - see {@link module:partials.resolveDocsMethod}. The standalone counterpart to build's own
+ * internal branching, for running `gulp docs` directly instead of as part of a full build.
+ * @memberOf module:js-build-tools
+ * @param {Function} [done]
+ * @returns {*}
  */
 const docs = (done = null) => ((0, _resolveDocsMethod.resolveDocsMethod)() === 'jsdoc' ? _jsdocDocs.jsdocDocs : _typeDocs.typeDocs)(done);
 exports.docs = docs;

package/dist/images.js

@@ -5,10 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.images = void 0;
 var _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}
+/**
+ * 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;

package/dist/jsdocDocs.js

@@ -5,11 +5,11 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.jsdocDocs = void 0;
 var _jsdocDocsFor = require("./partials/jsdocDocsFor.js");
-/**
- * Generate the HTML documentation of a plain-JavaScript project from its source, with a modern jsdoc theme
- * instead of jsdoc's own classic default. Turn it on with docs.enabled and docs.method: 'jsdoc' (the default
- * when typescript.enabled is off), see {@link module:partials.jsdocDocsFor}.
- * @memberOf module:js-build-tools
- * @returns {Function}
+/**
+ * Generate the HTML documentation of a plain-JavaScript project from its source, with a modern jsdoc theme
+ * instead of jsdoc's own classic default. Turn it on with docs.enabled and docs.method: 'jsdoc' (the default
+ * when typescript.enabled is off), see {@link module:partials.jsdocDocsFor}.
+ * @memberOf module:js-build-tools
+ * @returns {Function}
  */
 const jsdocDocs = exports.jsdocDocs = (0, _jsdocDocsFor.jsdocDocsFor)();

package/dist/lint.js

@@ -1,17 +1,17 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.lint = void 0;
-var _lintSource = require("./partials/lintSource.js");
-/**
- * The standalone lint command (`gulp lint`, or `npm run lint`): the same linting and fixing as sourceLint, but it
- * fails (exits non-zero) when any errors remain that neostandard could not fix automatically.
- * @memberOf module:js-build-tools
- * @returns {*}
- */
-const lint = () => (0, _lintSource.lintSource)({
-  failOnError: true
-});
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.lint = void 0;
+var _lintSource = require("./partials/lintSource.js");
+/**
+ * The standalone lint command (`gulp lint`, or `npm run lint`): the same linting and fixing as sourceLint, but it
+ * fails (exits non-zero) when any errors remain that neostandard could not fix automatically.
+ * @memberOf module:js-build-tools
+ * @returns {*}
+ */
+const lint = () => (0, _lintSource.lintSource)({
+  failOnError: true
+});
 exports.lint = lint;

package/dist/partials/addToReadme.js

@@ -13,15 +13,15 @@ var _convertMjsFilesForDocs = require("../utilities/convertMjsFilesForDocs.js");
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
 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'.
- *
- * jsdoc-to-markdown only recognizes `.js` files, even though it parses real ESM syntax just fine once it reads
- * one - `readme.fromEsm` (empty by default) names `.mjs` files to include anyway, converted on the fly (see
- * {@link convertMjsFilesForDocs}) and cleaned up again once this has read them, win or lose.
- * @memberOf module:partials
- * @returns {string|Uint8Array}
+/**
+ * Appends all the jsdoc comments to the readme file. Assumes empty or templated file.
+ * Configure this with 'readmeSearch', 'readmePath', 'readmeFile', and 'readmeOptions'.
+ *
+ * jsdoc-to-markdown only recognizes `.js` files, even though it parses real ESM syntax just fine once it reads
+ * one - `readme.fromEsm` (empty by default) names `.mjs` files to include anyway, converted on the fly (see
+ * {@link convertMjsFilesForDocs}) and cleaned up again once this has read them, win or lose.
+ * @memberOf module:partials
+ * @returns {string|Uint8Array}
  */
 const addToReadme = () => {
   const {

package/dist/partials/beginWatcher.js

@@ -9,10 +9,10 @@ var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
 var _gulp = require("gulp");
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Create a chokidar instance which watches and triggers change when the globed files are modified.
- * @memberOf module:partials
- * @returns {FSWatcher}
+/**
+ * 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'));
 exports.beginWatcher = beginWatcher;

package/dist/partials/clean.js

@@ -11,11 +11,11 @@ var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
 var _removeDirectory = require("./removeDirectory.js");
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Deletes all the distribution and browser files (used before create a new build).
- * Configure array of directories to remove with 'cleanPaths'.
- * @memberOf module:partials
- * @returns {Promise<string[]> | *}
+/**
+ * Deletes all the distribution and browser files (used before create a new build).
+ * Configure array of directories to remove with 'cleanPaths'.
+ * @memberOf module:partials
+ * @returns {Promise<string[]> | *}
  */
 const clean = () => gulpConfig.get('cleanPaths').reduce((promise, path) => promise.then(() => (0, _removeDirectory.removeDirectory)(path)), Promise.resolve());
 exports.clean = clean;

package/dist/partials/copyFor.js

@@ -5,15 +5,15 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.copyFor = void 0;
 var _gulp = require("gulp");
-/**
- * Copy some files to a different location.
- * @memberOf module:partials
- * @param {string|array} srcPath
- * @param {string} destPath
- * @param {Object} [options]
- * @param {string} [options.base] - Passed through to gulp's own src(pattern, {base}), to preserve srcPath's own
- * subdirectory structure in destPath instead of flattening it.
- * @returns {stream.Stream}
+/**
+ * Copy some files to a different location.
+ * @memberOf module:partials
+ * @param {string|array} srcPath
+ * @param {string} destPath
+ * @param {Object} [options]
+ * @param {string} [options.base] - Passed through to gulp's own src(pattern, {base}), to preserve srcPath's own
+ * subdirectory structure in destPath instead of flattening it.
+ * @returns {stream.Stream}
  */
 // encoding: false copies the bytes untouched - Gulp 5's default utf8 handling corrupts binary files such as fonts.
 const copyFor = (srcPath, destPath, {

package/dist/partials/distFor.js

@@ -13,12 +13,12 @@ var _through = _interopRequireDefault(require("through2"));
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Build the distribution for a given source pattern.
- * @memberOf module:partials
- * @param {string|array} [srcPath='src/config/path/dist/for']
- * @param {string} [destPath='dist/config/path']
- * @returns {stream.Stream}
+/**
+ * Build the distribution for a given source pattern.
+ * @memberOf module:partials
+ * @param {string|array} [srcPath='src/config/path/dist/for']
+ * @param {string} [destPath='dist/config/path']
+ * @returns {stream.Stream}
  */
 const distFor = (srcPath = (0, _distForSrc.distForSrc)(), destPath = gulpConfig.get('dist.to')) => (0, _gulp.src)(srcPath).pipe((0, _gulpBabel.default)()).pipe(_through.default.obj(function (file, enc, callback) {
   const regex = /\.mjs(['"]\s*\))/gi;

package/dist/partials/distForSrc.js

@@ -8,11 +8,11 @@ exports.distForSrc = void 0;
 var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
 var cache;
 function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var r, c, a = Object.defineProperty, n = { __proto__: null, default: e }; if (Object(e) !== e) return n; if (cache || "function" != typeof WeakMap || (cache = new WeakMap()), cache) { if (cache.has(e)) return cache.get(e); cache.set(e, n); } for (c in e) "default" !== c && {}.hasOwnProperty.call(e, c) && ((r = a && Object.getOwnPropertyDescriptor(e, c)) && (r.get || r.set) ? a(n, c, r) : n[c] = e[c]); return n; }
-/**
- * Retrieve the correct distFor search path based on TS Config.
- * @memberOf module:partials
- * @param {module:gulpConfig~FlagStringSetting} [useTs='config/for/ts']
- * @returns {string}
+/**
+ * Retrieve the correct distFor search path based on TS Config.
+ * @memberOf module:partials
+ * @param {module:gulpConfig~FlagStringSetting} [useTs='config/for/ts']
+ * @returns {string}
  */
 const distForSrc = (useTs = gulpConfig.get('typescript.enabled')) => useTs ? gulpConfig.get('browser.from') : gulpConfig.get('dist.from');
 exports.distForSrc = distForSrc;