js-build-tools 6.6.0 → 6.7.0

package/dist/partials.js

@@ -1,177 +1,177 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "addToReadme", {
-  enumerable: true,
-  get: function () {
-    return _addToReadme.addToReadme;
-  }
-});
-Object.defineProperty(exports, "beginWatcher", {
-  enumerable: true,
-  get: function () {
-    return _beginWatcher.beginWatcher;
-  }
-});
-Object.defineProperty(exports, "clean", {
-  enumerable: true,
-  get: function () {
-    return _clean.clean;
-  }
-});
-Object.defineProperty(exports, "copyFor", {
-  enumerable: true,
-  get: function () {
-    return _copyFor.copyFor;
-  }
-});
-Object.defineProperty(exports, "distFor", {
-  enumerable: true,
-  get: function () {
-    return _distFor.distFor;
-  }
-});
-Object.defineProperty(exports, "distForSrc", {
-  enumerable: true,
-  get: function () {
-    return _distForSrc.distForSrc;
-  }
-});
-Object.defineProperty(exports, "distSeries", {
-  enumerable: true,
-  get: function () {
-    return _distSeries.distSeries;
-  }
-});
-Object.defineProperty(exports, "imagesFor", {
-  enumerable: true,
-  get: function () {
-    return _imagesFor.imagesFor;
-  }
-});
-Object.defineProperty(exports, "importModule", {
-  enumerable: true,
-  get: function () {
-    return _loadPeer.importModule;
-  }
-});
-Object.defineProperty(exports, "importPeer", {
-  enumerable: true,
-  get: function () {
-    return _loadPeer.importPeer;
-  }
-});
-Object.defineProperty(exports, "jsdocDocsFor", {
-  enumerable: true,
-  get: function () {
-    return _jsdocDocsFor.jsdocDocsFor;
-  }
-});
-Object.defineProperty(exports, "launchBrowser", {
-  enumerable: true,
-  get: function () {
-    return _loadPlaywright.launchBrowser;
-  }
-});
-Object.defineProperty(exports, "lintSource", {
-  enumerable: true,
-  get: function () {
-    return _lintSource.lintSource;
-  }
-});
-Object.defineProperty(exports, "loadPlaywright", {
-  enumerable: true,
-  get: function () {
-    return _loadPlaywright.loadPlaywright;
-  }
-});
-Object.defineProperty(exports, "minifyFor", {
-  enumerable: true,
-  get: function () {
-    return _minifyFor.minifyFor;
-  }
-});
-Object.defineProperty(exports, "neostandardLint", {
-  enumerable: true,
-  get: function () {
-    return _neostandardLint.neostandardLint;
-  }
-});
-Object.defineProperty(exports, "readmeTemplate", {
-  enumerable: true,
-  get: function () {
-    return _readmeTemplate.readmeTemplate;
-  }
-});
-Object.defineProperty(exports, "removeDirectory", {
-  enumerable: true,
-  get: function () {
-    return _removeDirectory.removeDirectory;
-  }
-});
-Object.defineProperty(exports, "requirePeer", {
-  enumerable: true,
-  get: function () {
-    return _loadPeer.requirePeer;
-  }
-});
-Object.defineProperty(exports, "resolveDocsMethod", {
-  enumerable: true,
-  get: function () {
-    return _resolveDocsMethod.resolveDocsMethod;
-  }
-});
-Object.defineProperty(exports, "runOnChange", {
-  enumerable: true,
-  get: function () {
-    return _runOnChange.runOnChange;
-  }
-});
-Object.defineProperty(exports, "sassFor", {
-  enumerable: true,
-  get: function () {
-    return _sassFor.sassFor;
-  }
-});
-Object.defineProperty(exports, "serveStatic", {
-  enumerable: true,
-  get: function () {
-    return _serveStatic.serveStatic;
-  }
-});
-Object.defineProperty(exports, "tsFor", {
-  enumerable: true,
-  get: function () {
-    return _tsFor.tsFor;
-  }
-});
-Object.defineProperty(exports, "typeDocsFor", {
-  enumerable: true,
-  get: function () {
-    return _typeDocsFor.typeDocsFor;
-  }
-});
-var _addToReadme = require("./partials/addToReadme.js");
-var _beginWatcher = require("./partials/beginWatcher.js");
-var _clean = require("./partials/clean.js");
-var _copyFor = require("./partials/copyFor.js");
-var _distFor = require("./partials/distFor.js");
-var _distForSrc = require("./partials/distForSrc.js");
-var _distSeries = require("./partials/distSeries.js");
-var _imagesFor = require("./partials/imagesFor.js");
-var _loadPeer = require("./partials/loadPeer.js");
-var _jsdocDocsFor = require("./partials/jsdocDocsFor.js");
-var _loadPlaywright = require("./partials/loadPlaywright.js");
-var _lintSource = require("./partials/lintSource.js");
-var _minifyFor = require("./partials/minifyFor.js");
-var _neostandardLint = require("./partials/neostandardLint.js");
-var _readmeTemplate = require("./partials/readmeTemplate.js");
-var _removeDirectory = require("./partials/removeDirectory.js");
-var _resolveDocsMethod = require("./partials/resolveDocsMethod.js");
-var _runOnChange = require("./partials/runOnChange.js");
-var _sassFor = require("./partials/sassFor.js");
-var _serveStatic = require("./partials/serveStatic.js");
-var _tsFor = require("./partials/tsFor.js");
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "addToReadme", {
+  enumerable: true,
+  get: function () {
+    return _addToReadme.addToReadme;
+  }
+});
+Object.defineProperty(exports, "beginWatcher", {
+  enumerable: true,
+  get: function () {
+    return _beginWatcher.beginWatcher;
+  }
+});
+Object.defineProperty(exports, "clean", {
+  enumerable: true,
+  get: function () {
+    return _clean.clean;
+  }
+});
+Object.defineProperty(exports, "copyFor", {
+  enumerable: true,
+  get: function () {
+    return _copyFor.copyFor;
+  }
+});
+Object.defineProperty(exports, "distFor", {
+  enumerable: true,
+  get: function () {
+    return _distFor.distFor;
+  }
+});
+Object.defineProperty(exports, "distForSrc", {
+  enumerable: true,
+  get: function () {
+    return _distForSrc.distForSrc;
+  }
+});
+Object.defineProperty(exports, "distSeries", {
+  enumerable: true,
+  get: function () {
+    return _distSeries.distSeries;
+  }
+});
+Object.defineProperty(exports, "imagesFor", {
+  enumerable: true,
+  get: function () {
+    return _imagesFor.imagesFor;
+  }
+});
+Object.defineProperty(exports, "importModule", {
+  enumerable: true,
+  get: function () {
+    return _loadPeer.importModule;
+  }
+});
+Object.defineProperty(exports, "importPeer", {
+  enumerable: true,
+  get: function () {
+    return _loadPeer.importPeer;
+  }
+});
+Object.defineProperty(exports, "jsdocDocsFor", {
+  enumerable: true,
+  get: function () {
+    return _jsdocDocsFor.jsdocDocsFor;
+  }
+});
+Object.defineProperty(exports, "launchBrowser", {
+  enumerable: true,
+  get: function () {
+    return _loadPlaywright.launchBrowser;
+  }
+});
+Object.defineProperty(exports, "lintSource", {
+  enumerable: true,
+  get: function () {
+    return _lintSource.lintSource;
+  }
+});
+Object.defineProperty(exports, "loadPlaywright", {
+  enumerable: true,
+  get: function () {
+    return _loadPlaywright.loadPlaywright;
+  }
+});
+Object.defineProperty(exports, "minifyFor", {
+  enumerable: true,
+  get: function () {
+    return _minifyFor.minifyFor;
+  }
+});
+Object.defineProperty(exports, "neostandardLint", {
+  enumerable: true,
+  get: function () {
+    return _neostandardLint.neostandardLint;
+  }
+});
+Object.defineProperty(exports, "readmeTemplate", {
+  enumerable: true,
+  get: function () {
+    return _readmeTemplate.readmeTemplate;
+  }
+});
+Object.defineProperty(exports, "removeDirectory", {
+  enumerable: true,
+  get: function () {
+    return _removeDirectory.removeDirectory;
+  }
+});
+Object.defineProperty(exports, "requirePeer", {
+  enumerable: true,
+  get: function () {
+    return _loadPeer.requirePeer;
+  }
+});
+Object.defineProperty(exports, "resolveDocsMethod", {
+  enumerable: true,
+  get: function () {
+    return _resolveDocsMethod.resolveDocsMethod;
+  }
+});
+Object.defineProperty(exports, "runOnChange", {
+  enumerable: true,
+  get: function () {
+    return _runOnChange.runOnChange;
+  }
+});
+Object.defineProperty(exports, "sassFor", {
+  enumerable: true,
+  get: function () {
+    return _sassFor.sassFor;
+  }
+});
+Object.defineProperty(exports, "serveStatic", {
+  enumerable: true,
+  get: function () {
+    return _serveStatic.serveStatic;
+  }
+});
+Object.defineProperty(exports, "tsFor", {
+  enumerable: true,
+  get: function () {
+    return _tsFor.tsFor;
+  }
+});
+Object.defineProperty(exports, "typeDocsFor", {
+  enumerable: true,
+  get: function () {
+    return _typeDocsFor.typeDocsFor;
+  }
+});
+var _addToReadme = require("./partials/addToReadme.js");
+var _beginWatcher = require("./partials/beginWatcher.js");
+var _clean = require("./partials/clean.js");
+var _copyFor = require("./partials/copyFor.js");
+var _distFor = require("./partials/distFor.js");
+var _distForSrc = require("./partials/distForSrc.js");
+var _distSeries = require("./partials/distSeries.js");
+var _imagesFor = require("./partials/imagesFor.js");
+var _loadPeer = require("./partials/loadPeer.js");
+var _jsdocDocsFor = require("./partials/jsdocDocsFor.js");
+var _loadPlaywright = require("./partials/loadPlaywright.js");
+var _lintSource = require("./partials/lintSource.js");
+var _minifyFor = require("./partials/minifyFor.js");
+var _neostandardLint = require("./partials/neostandardLint.js");
+var _readmeTemplate = require("./partials/readmeTemplate.js");
+var _removeDirectory = require("./partials/removeDirectory.js");
+var _resolveDocsMethod = require("./partials/resolveDocsMethod.js");
+var _runOnChange = require("./partials/runOnChange.js");
+var _sassFor = require("./partials/sassFor.js");
+var _serveStatic = require("./partials/serveStatic.js");
+var _tsFor = require("./partials/tsFor.js");
 var _typeDocsFor = require("./partials/typeDocsFor.js");

package/dist/sourceLint.js

@@ -1,19 +1,19 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.sourceLint = void 0;
-var _lintSource = require("./partials/lintSource.js");
-/**
- * Applies neostandard linting (js-build-tools' chosen style) to the real, hand-written source - not the compiled
- * dist/browser output, which is generated and so was never going to pass a hand-authored-code style check (every
- * compiler/bundler emits its own boilerplate - import aliasing, interop headers - that only looks like a style
- * violation). Includes test files: there is no reason to hold tests to a lower style bar than the rest of the
- * source. When typescript.enabled, the real TypeScript source is linted too, with type-aware rules. Runs as part of
- * `build`, where remaining errors are reported but never fail it.
- * @memberOf module:js-build-tools
- * @returns {*}
- */
-const sourceLint = () => (0, _lintSource.lintSource)();
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sourceLint = void 0;
+var _lintSource = require("./partials/lintSource.js");
+/**
+ * Applies neostandard linting (js-build-tools' chosen style) to the real, hand-written source - not the compiled
+ * dist/browser output, which is generated and so was never going to pass a hand-authored-code style check (every
+ * compiler/bundler emits its own boilerplate - import aliasing, interop headers - that only looks like a style
+ * violation). Includes test files: there is no reason to hold tests to a lower style bar than the rest of the
+ * source. When typescript.enabled, the real TypeScript source is linted too, with type-aware rules. Runs as part of
+ * `build`, where remaining errors are reported but never fail it.
+ * @memberOf module:js-build-tools
+ * @returns {*}
+ */
+const sourceLint = () => (0, _lintSource.lintSource)();
 exports.sourceLint = sourceLint;

package/dist/test-helpers/isolateGulpCache.js

@@ -1,25 +1,25 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isolateGulpCache = void 0;
-var _gulpCache = _interopRequireDefault(require("gulp-cache"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Give this test file its own gulp-cache folder, and return a function that clears only that folder. gulp-cache
- * otherwise keeps one cache in os.tmpdir() for every process, so a cache.clearAll() in one Jest worker could wipe it
- * while another worker's images task was still using it, and gulp-cache then silently dropped that worker's
- * images. Jest loads gulp-cache separately for each test file, so this only changes the copy that file uses.
- * @memberOf module:testHelpers
- * @param {string} name - Unique per test file, used in the cache folder name.
- * @returns {function(): Promise<void>} Clears this test file's cache.
- */
-const isolateGulpCache = name => {
-  const fileCache = new _gulpCache.default.Cache({
-    cacheDirName: `js-build-tools-test-${name}`
-  });
-  _gulpCache.default.defaultOptions.fileCache = fileCache;
-  return () => new Promise((resolve, reject) => fileCache.clear(null, error => error ? reject(error) : resolve()));
-};
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isolateGulpCache = void 0;
+var _gulpCache = _interopRequireDefault(require("gulp-cache"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Give this test file its own gulp-cache folder, and return a function that clears only that folder. gulp-cache
+ * otherwise keeps one cache in os.tmpdir() for every process, so a cache.clearAll() in one Jest worker could wipe it
+ * while another worker's images task was still using it, and gulp-cache then silently dropped that worker's
+ * images. Jest loads gulp-cache separately for each test file, so this only changes the copy that file uses.
+ * @memberOf module:testHelpers
+ * @param {string} name - Unique per test file, used in the cache folder name.
+ * @returns {function(): Promise<void>} Clears this test file's cache.
+ */
+const isolateGulpCache = name => {
+  const fileCache = new _gulpCache.default.Cache({
+    cacheDirName: `js-build-tools-test-${name}`
+  });
+  _gulpCache.default.defaultOptions.fileCache = fileCache;
+  return () => new Promise((resolve, reject) => fileCache.clear(null, error => error ? reject(error) : resolve()));
+};
 exports.isolateGulpCache = isolateGulpCache;

package/dist/test-helpers/setUp.js

@@ -58,10 +58,10 @@ function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e;
 let tempDir = 'test-temp/';
 let srcPath = `${tempDir}src`;
 
-/**
- * Update the gulp configurations with the test data. Set the test directory where temp files will be created for testing.
- * @memberOf module:testHelpers
- * @param {string} testDir
+/**
+ * Update the gulp configurations with the test data. Set the test directory where temp files will be created for testing.
+ * @memberOf module:testHelpers
+ * @param {string} testDir
  */
 const setDefaults = (testDir = 'test-temp') => {
   tempDir = `${testDir}/`;

package/dist/testFull.js

@@ -9,11 +9,11 @@ var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
 var _jest = require("jest");
 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; }
-/**
- * Run all tests with jest.
- * Configure where tests are located by using 'testPath'.
- * @memberOf module:js-build-tools
- * @returns {Promise<*>}
+/**
+ * Run all tests with jest.
+ * Configure where tests are located by using 'testPath'.
+ * @memberOf module:js-build-tools
+ * @returns {Promise<*>}
  */
 const testFull = () => {
   let testPath = gulpConfig.get('test.path');

package/dist/testQuick.js

@@ -9,11 +9,11 @@ var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
 var _jest = require("jest");
 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; }
-/**
- * Run the Jest tests for files which have been modified (based on git status).
- * Configure where tests are located by using 'testPath'.
- * @memberOf module:js-build-tools
- * @returns {Promise<*>}
+/**
+ * Run the Jest tests for files which have been modified (based on git status).
+ * Configure where tests are located by using 'testPath'.
+ * @memberOf module:js-build-tools
+ * @returns {Promise<*>}
  */
 const testQuick = () => {
   let testPath = gulpConfig.get('test.path');

package/dist/typeDocs.js

@@ -5,10 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.typeDocs = void 0;
 var _typeDocsFor = require("./partials/typeDocsFor.js");
-/**
- * Generate the HTML documentation of a TypeScript project from its source, with the modules mirroring the source
- * folders. Turn it on with docs.enabled, see {@link module:partials.typeDocsFor}.
- * @memberOf module:js-build-tools
- * @returns {Function}
+/**
+ * Generate the HTML documentation of a TypeScript project from its source, with the modules mirroring the source
+ * folders. Turn it on with docs.enabled, see {@link module:partials.typeDocsFor}.
+ * @memberOf module:js-build-tools
+ * @returns {Function}
  */
 const typeDocs = exports.typeDocs = (0, _typeDocsFor.typeDocsFor)();

package/dist/typeScript.js

@@ -5,9 +5,9 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.typeScript = void 0;
 var _tsFor = require("./partials/tsFor.js");
-/**
- * Simplified typescript task using tsFor.
- * @memberOf module:js-build-tools
- * @returns {Function}
+/**
+ * Simplified typescript task using tsFor.
+ * @memberOf module:js-build-tools
+ * @returns {Function}
  */
 const typeScript = exports.typeScript = (0, _tsFor.tsFor)();

package/dist/utilities/convertMjsFilesForDocs.js

@@ -11,18 +11,18 @@ var _os = _interopRequireDefault(require("os"));
 var _path = _interopRequireDefault(require("path"));
 var _esmNamedExportsToCjs = require("./esmNamedExportsToCjs.js");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Writes a rewritten (see {@link esmNamedExportsToCjs}) copy of each given `.mjs` file into a fresh, unique
- * directory under the OS temp directory, with a `.js` extension - jsdoc-to-markdown only recognizes `.js` as a
- * documentable file, regardless of whether its contents are actually CommonJS or ESM (it parses the real ESM
- * syntax of the rest of a file fine; the extension is the only thing it filters on). Writing outside the project
- * tree means there is nothing to gitignore and nothing left behind in the project - call the returned `cleanUp`
- * once done (for example, right after jsdoc-to-markdown has read the files) to remove the temp directory.
- * @memberOf module:utilities
- * @param {Array<string>} mjsFilePaths - Real `.mjs` files to convert. An empty array is a safe, cheap no-op.
- * @returns {{filePaths: Array<string>, cleanUp: function(): void}} The temp `.js` file paths to pass to
- * jsdoc-to-markdown instead of the real `.mjs` ones, and a function to remove the temp directory afterward.
- * @private
+/**
+ * Writes a rewritten (see {@link esmNamedExportsToCjs}) copy of each given `.mjs` file into a fresh, unique
+ * directory under the OS temp directory, with a `.js` extension - jsdoc-to-markdown only recognizes `.js` as a
+ * documentable file, regardless of whether its contents are actually CommonJS or ESM (it parses the real ESM
+ * syntax of the rest of a file fine; the extension is the only thing it filters on). Writing outside the project
+ * tree means there is nothing to gitignore and nothing left behind in the project - call the returned `cleanUp`
+ * once done (for example, right after jsdoc-to-markdown has read the files) to remove the temp directory.
+ * @memberOf module:utilities
+ * @param {Array<string>} mjsFilePaths - Real `.mjs` files to convert. An empty array is a safe, cheap no-op.
+ * @returns {{filePaths: Array<string>, cleanUp: function(): void}} The temp `.js` file paths to pass to
+ * jsdoc-to-markdown instead of the real `.mjs` ones, and a function to remove the temp directory afterward.
+ * @private
  */
 const convertMjsFilesForDocs = (mjsFilePaths = []) => {
   if (mjsFilePaths.length === 0) {