js-build-tools 6.1.0 → 6.2.0

package/dist/test-helpers/setUp.js

@@ -1,100 +1,100 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "afterEach", {
-  enumerable: true,
-  get: function () {
-    return _testFilesystem.afterEach;
-  }
-});
-Object.defineProperty(exports, "beforeEach", {
-  enumerable: true,
-  get: function () {
-    return _testFilesystem.beforeEach;
-  }
-});
-Object.defineProperty(exports, "countMatches", {
-  enumerable: true,
-  get: function () {
-    return _testFilesystem.countMatches;
-  }
-});
-Object.defineProperty(exports, "createTempDir", {
-  enumerable: true,
-  get: function () {
-    return _testFilesystem.createTempDir;
-  }
-});
-Object.defineProperty(exports, "fileExists", {
-  enumerable: true,
-  get: function () {
-    return _testFilesystem.fileExists;
-  }
-});
-exports.gulpConfig = void 0;
-Object.defineProperty(exports, "logObject", {
-  enumerable: true,
-  get: function () {
-    return _testFilesystem.logObject;
-  }
-});
-Object.defineProperty(exports, "removeDirectory", {
-  enumerable: true,
-  get: function () {
-    return _testFilesystem.removeDirectory;
-  }
-});
-exports.setDefaults = void 0;
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-exports.gulpConfig = gulpConfig;
-var _testFilesystem = require("test-filesystem");
-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; }
-// Import the configurations and override some of them to direct to the temp directory.
-
-let tempDir = 'test-temp/';
-let srcPath = `${tempDir}src`;
-
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "afterEach", {
+  enumerable: true,
+  get: function () {
+    return _testFilesystem.afterEach;
+  }
+});
+Object.defineProperty(exports, "beforeEach", {
+  enumerable: true,
+  get: function () {
+    return _testFilesystem.beforeEach;
+  }
+});
+Object.defineProperty(exports, "countMatches", {
+  enumerable: true,
+  get: function () {
+    return _testFilesystem.countMatches;
+  }
+});
+Object.defineProperty(exports, "createTempDir", {
+  enumerable: true,
+  get: function () {
+    return _testFilesystem.createTempDir;
+  }
+});
+Object.defineProperty(exports, "fileExists", {
+  enumerable: true,
+  get: function () {
+    return _testFilesystem.fileExists;
+  }
+});
+exports.gulpConfig = void 0;
+Object.defineProperty(exports, "logObject", {
+  enumerable: true,
+  get: function () {
+    return _testFilesystem.logObject;
+  }
+});
+Object.defineProperty(exports, "removeDirectory", {
+  enumerable: true,
+  get: function () {
+    return _testFilesystem.removeDirectory;
+  }
+});
+exports.setDefaults = void 0;
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+exports.gulpConfig = gulpConfig;
+var _testFilesystem = require("test-filesystem");
+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; }
+// Import the configurations and override some of them to direct to the temp directory.
+
+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
- */
-const setDefaults = (testDir = 'test-temp') => {
-  tempDir = `${testDir}/`;
-  srcPath = `${tempDir}src`;
-  _testFilesystem.setUp.setDefaults(tempDir);
-  const distPath = `${tempDir}dist`;
-  const browserPath = `${tempDir}browser`;
-  const sassPath = `${tempDir}sass`;
-  gulpConfig.set('browser.from', `${distPath}/**/*.js`);
-  gulpConfig.set('browser.to', browserPath);
-  gulpConfig.set('cleanPaths', [distPath, browserPath]);
-  gulpConfig.set('dist.from', `${srcPath}/**/!(*.test).js`);
-  gulpConfig.set('dist.main', `${distPath}/main`);
-  gulpConfig.set('dist.to', distPath);
-  gulpConfig.set('fonts.from', `${srcPath}/fonts/**/*`);
-  gulpConfig.set('fonts.to', `${browserPath}/fonts`);
-  gulpConfig.set('images.from', `${srcPath}/img/**/*.+(png|jpg|jpeg|gif|svg)`);
-  gulpConfig.set('images.to', `${browserPath}/img`);
-  gulpConfig.set('readme.template', `${tempDir}MAIN.md`);
-  gulpConfig.set('readme.to', tempDir);
-  gulpConfig.set('readme.from', `${srcPath}/**/!(*.test).js`);
-  // Reset explicitly: gulpConfig is a process-wide singleton seeded once from this real project's own
-  // build-tools.config.json, so without this, this project's own real readme.fromEsm value (gulp.config.mjs)
-  // would leak into every test that exercises addToReadme/compileReadme but never sets this path itself -
-  // doing real file I/O and a real jsdoc-to-markdown parse of this project's own, much larger, config file.
-  gulpConfig.set('readme.fromEsm', []);
-  gulpConfig.set('rootPath', tempDir);
-  gulpConfig.set('sass.from', `${sassPath}/**/*.+(scss|sass)`);
-  gulpConfig.set('sass.path', sassPath);
-  gulpConfig.set('sass.to', `${browserPath}/css`);
-  gulpConfig.set('srcPath', srcPath);
-  gulpConfig.set('typescript.from', `${srcPath}/**/*.ts`);
-  gulpConfig.set('typescript.to', distPath);
-  gulpConfig.set('test.watch', `${srcPath}/**/*.js`);
-};
+ */
+const setDefaults = (testDir = 'test-temp') => {
+  tempDir = `${testDir}/`;
+  srcPath = `${tempDir}src`;
+  _testFilesystem.setUp.setDefaults(tempDir);
+  const distPath = `${tempDir}dist`;
+  const browserPath = `${tempDir}browser`;
+  const sassPath = `${tempDir}sass`;
+  gulpConfig.set('browser.from', `${distPath}/**/*.js`);
+  gulpConfig.set('browser.to', browserPath);
+  gulpConfig.set('cleanPaths', [distPath, browserPath]);
+  gulpConfig.set('dist.from', `${srcPath}/**/!(*.test).js`);
+  gulpConfig.set('dist.main', `${distPath}/main`);
+  gulpConfig.set('dist.to', distPath);
+  gulpConfig.set('fonts.from', `${srcPath}/fonts/**/*`);
+  gulpConfig.set('fonts.to', `${browserPath}/fonts`);
+  gulpConfig.set('images.from', `${srcPath}/img/**/*.+(png|jpg|jpeg|gif|svg)`);
+  gulpConfig.set('images.to', `${browserPath}/img`);
+  gulpConfig.set('readme.template', `${tempDir}MAIN.md`);
+  gulpConfig.set('readme.to', tempDir);
+  gulpConfig.set('readme.from', `${srcPath}/**/!(*.test).js`);
+  // Reset explicitly: gulpConfig is a process-wide singleton seeded once from this real project's own
+  // build-tools.config.json, so without this, this project's own real readme.fromEsm value (gulp.config.mjs)
+  // would leak into every test that exercises addToReadme/compileReadme but never sets this path itself -
+  // doing real file I/O and a real jsdoc-to-markdown parse of this project's own, much larger, config file.
+  gulpConfig.set('readme.fromEsm', []);
+  gulpConfig.set('rootPath', tempDir);
+  gulpConfig.set('sass.from', `${sassPath}/**/*.+(scss|sass)`);
+  gulpConfig.set('sass.path', sassPath);
+  gulpConfig.set('sass.to', `${browserPath}/css`);
+  gulpConfig.set('srcPath', srcPath);
+  gulpConfig.set('typescript.from', `${srcPath}/**/*.ts`);
+  gulpConfig.set('typescript.to', distPath);
+  gulpConfig.set('test.watch', `${srcPath}/**/*.js`);
+};
 exports.setDefaults = setDefaults;

package/dist/testFull.js

@@ -1,26 +1,26 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.testFull = void 0;
-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; }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.testFull = void 0;
+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<*>}
- */
-const testFull = () => {
-  let testPath = gulpConfig.get('test.path');
-  if (!Array.isArray(testPath)) {
-    // The testPath must be an array of strings
-    testPath = [testPath];
-  }
-  return (0, _jest.runCLI)(gulpConfig.get('test.options'), testPath);
-};
+ */
+const testFull = () => {
+  let testPath = gulpConfig.get('test.path');
+  if (!Array.isArray(testPath)) {
+    // The testPath must be an array of strings
+    testPath = [testPath];
+  }
+  return (0, _jest.runCLI)(gulpConfig.get('test.options'), testPath);
+};
 exports.testFull = testFull;

package/dist/testHelpers.js

@@ -1,11 +1,11 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.testHelpers = void 0;
-var _testHelpers = _interopRequireWildcard(require("./test-helpers/setUp.js"));
-exports.testHelpers = _testHelpers;
-var cache;
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.testHelpers = void 0;
+var _testHelpers = _interopRequireWildcard(require("./test-helpers/setUp.js"));
+exports.testHelpers = _testHelpers;
+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; }

package/dist/testQuick.js

@@ -1,28 +1,28 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.testQuick = void 0;
-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; }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.testQuick = void 0;
+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<*>}
- */
-const testQuick = () => {
-  let testPath = gulpConfig.get('test.path');
-  if (!Array.isArray(testPath)) {
-    // The testPath must be an array of strings
-    testPath = [testPath];
-  }
-  return (0, _jest.runCLI)({
-    onlyChanged: true
-  }, testPath);
-};
+ */
+const testQuick = () => {
+  let testPath = gulpConfig.get('test.path');
+  if (!Array.isArray(testPath)) {
+    // The testPath must be an array of strings
+    testPath = [testPath];
+  }
+  return (0, _jest.runCLI)({
+    onlyChanged: true
+  }, testPath);
+};
 exports.testQuick = testQuick;

package/dist/utilities/dotNotate.js

@@ -1,43 +1,43 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.dotNotate = void 0;
-require("core-js/modules/esnext.iterator.constructor.js");
-require("core-js/modules/esnext.iterator.map.js");
-var _isObject = require("./isObject.js");
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.dotNotate = void 0;
+require("core-js/modules/esnext.iterator.constructor.js");
+require("core-js/modules/esnext.iterator.map.js");
+var _isObject = require("./isObject.js");
 /**
  * Convert an array of keys into a regex, return a function to test if incoming keys match.
  * @param {Array.<string>} [retainObjects=[]] - An array of keys to retain as objects
  * @returns {Function} The dot-notated array
- */
-const handleRetainObjects = (retainObjects = []) => {
-  if (!retainObjects.length) {
+ */
+const handleRetainObjects = (retainObjects = []) => {
+  if (!retainObjects.length) {
     /**
      * Bypass the test function if there are no retainObjects.
      * @returns {false}
-     */
-    return (currentKey, value, results) => false;
-  }
-  retainObjects = retainObjects.map(key => key.replace('\.', '\\.'));
-  const retainRegex = new RegExp(`(${retainObjects.join('|')})$`);
+     */
+    return (currentKey, value, results) => false;
+  }
+  retainObjects = retainObjects.map(key => key.replace('\.', '\\.'));
+  const retainRegex = new RegExp(`(${retainObjects.join('|')})$`);
   /**
    * Test if a key should be retained as an object.
    * @param {string} currentKey - The key to test
    * @param {*} value - The value of the key
    * @param {Object} results - The result object to add to
    * @returns {boolean}
-   */
-  return (currentKey, value, results) => {
-    if (!currentKey.match(retainRegex)) {
-      return false;
-    }
-    results[currentKey] = value;
-    return true;
-  };
-};
-
+   */
+  return (currentKey, value, results) => {
+    if (!currentKey.match(retainRegex)) {
+      return false;
+    }
+    results[currentKey] = value;
+    return true;
+  };
+};
+
 /**
  * The underlying logic function for converting arrays to dot-notation.
  * @param {Object} arrayObject - The array or object to dot-notate
@@ -45,31 +45,31 @@ const handleRetainObjects = (retainObjects = []) => {
  * @param {string} [prepend=''] - The path for the property being processed
  * @param {Object<string, *>} [results={}] - The final notated object to return
  * @returns {Object<string, *>} The dot-notated object
- */
-const performDotNotate = (arrayObject, didRetain, prepend = '', results = {}) => {
-  for (let key in arrayObject) {
-    const value = arrayObject[key];
-    const currentKey = `${prepend}${key}`;
-    if (didRetain(currentKey, value, results)) {
-      continue;
-    }
-    // An empty object/array has no keys to flatten into - recursing into one would silently drop currentKey
-    // from the result entirely, rather than keeping it as the empty value it actually is. Treat it as a leaf.
-    if ((0, _isObject.isObject)(value) && Object.keys(value).length) {
-      performDotNotate(value, didRetain, `${currentKey}.`, results);
-      continue;
-    }
-    results[currentKey] = value;
-  }
-  return results;
-};
-
+ */
+const performDotNotate = (arrayObject, didRetain, prepend = '', results = {}) => {
+  for (let key in arrayObject) {
+    const value = arrayObject[key];
+    const currentKey = `${prepend}${key}`;
+    if (didRetain(currentKey, value, results)) {
+      continue;
+    }
+    // An empty object/array has no keys to flatten into - recursing into one would silently drop currentKey
+    // from the result entirely, rather than keeping it as the empty value it actually is. Treat it as a leaf.
+    if ((0, _isObject.isObject)(value) && Object.keys(value).length) {
+      performDotNotate(value, didRetain, `${currentKey}.`, results);
+      continue;
+    }
+    results[currentKey] = value;
+  }
+  return results;
+};
+
 /**
  * Convert an array or object to a single dimensional associative array with dot notation.
  * Original source concepts from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/objects/dotNotate.ts Sí, funciona}
  * @param {Object} arrayObject - The array or object to dot-notate
  * @param {Array.<string>} [retainObjects=[]] - An array of keys to retain as objects
  * @returns {Object<string, *>} The dot-notated object
- */
-const dotNotate = (arrayObject, retainObjects = []) => performDotNotate(arrayObject, handleRetainObjects(retainObjects));
+ */
+const dotNotate = (arrayObject, retainObjects = []) => performDotNotate(arrayObject, handleRetainObjects(retainObjects));
 exports.dotNotate = dotNotate;

package/dist/utilities/getBundleConfigs.js

@@ -1,15 +1,15 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getBundleConfigs = void 0;
-require("core-js/modules/esnext.iterator.constructor.js");
-require("core-js/modules/esnext.iterator.map.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; }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getBundleConfigs = void 0;
+require("core-js/modules/esnext.iterator.constructor.js");
+require("core-js/modules/esnext.iterator.map.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; }
 /**
  * Build the full list of bundles to produce for this project: the primary bundle (browser.name /
  * dist.main / browser.ignore / browser.exclude, exactly as before browser.bundles existed) plus
@@ -18,20 +18,20 @@ function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e;
  * specify what's actually different about it.
  * @memberOf module:utilities
  * @returns {Array<{name: string, main: string, ignore: Array, exclude: Array}>}
- */
-const getBundleConfigs = () => {
-  const primary = {
-    name: gulpConfig.get('browser.name'),
-    main: gulpConfig.get('dist.main'),
-    ignore: gulpConfig.get('browser.ignore'),
-    exclude: gulpConfig.get('browser.exclude')
-  };
-  const additional = gulpConfig.get('browser.bundles');
-  return [primary, ...additional.map(bundleConfig => ({
-    name: bundleConfig.name,
-    main: bundleConfig.main || primary.main,
-    ignore: bundleConfig.ignore || primary.ignore,
-    exclude: bundleConfig.exclude || primary.exclude
-  }))];
-};
+ */
+const getBundleConfigs = () => {
+  const primary = {
+    name: gulpConfig.get('browser.name'),
+    main: gulpConfig.get('dist.main'),
+    ignore: gulpConfig.get('browser.ignore'),
+    exclude: gulpConfig.get('browser.exclude')
+  };
+  const additional = gulpConfig.get('browser.bundles');
+  return [primary, ...additional.map(bundleConfig => ({
+    name: bundleConfig.name,
+    main: bundleConfig.main || primary.main,
+    ignore: bundleConfig.ignore || primary.ignore,
+    exclude: bundleConfig.exclude || primary.exclude
+  }))];
+};
 exports.getBundleConfigs = getBundleConfigs;

package/dist/watchTest.js

@@ -1,21 +1,21 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.watchTest = void 0;
-var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
-var _gulp = require("gulp");
-var _testQuick = require("./testQuick.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; }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.watchTest = void 0;
+var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
+var _gulp = require("gulp");
+var _testQuick = require("./testQuick.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; }
 /**
  * Watch for changes and run the tests.
  * @memberOf module:js-build-tools
  * @returns {*}
- */
-const watchTest = () => (0, _gulp.watch)(gulpConfig.get('test.watch'), {
-  ignoreInitial: false
-}, _testQuick.testQuick);
+ */
+const watchTest = () => (0, _gulp.watch)(gulpConfig.get('test.watch'), {
+  ignoreInitial: false
+}, _testQuick.testQuick);
 exports.watchTest = watchTest;

package/functions/build.mjs

@@ -3,6 +3,7 @@ import { bundleMinify } from './bundleMinify.mjs'
 import { clean, distSeries } from './partials.mjs'
 import { compileReadme } from './compileReadme.mjs'
 import { typeDocs } from './typeDocs.mjs'
+import { jsdocDocs } from './jsdocDocs.mjs'
 import { distMinify } from './distMinify.mjs'
 import { sourceLint } from './sourceLint.mjs'
 import { parallel, series } from 'gulp'
@@ -22,9 +23,13 @@ import { testFull } from './testFull.mjs'
 export const build = (done = null) => {
   const buildActions = [distSeries(), distMinify]
   const generateDocs = gulpConfig.get('docs.enabled')
+  // docs.method picks the engine explicitly; left unset (false, the default), it's inferred from
+  // typescript.enabled - every existing TypeScript project's config, which never sets method, keeps producing
+  // TypeDoc output exactly as it always has.
+  const docsMethod = gulpConfig.get('docs.method') || (gulpConfig.get('typescript.enabled') ? 'typedoc' : 'jsdoc')
   if (generateDocs) {
-    // The documentation is generated from the TypeScript source itself, the readme is written by hand
-    buildActions.push(typeDocs)
+    // The documentation is generated from the source itself, the readme is written by hand
+    buildActions.push(docsMethod === 'jsdoc' ? jsdocDocs : 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)

package/functions/build.test.mjs

@@ -4,6 +4,7 @@ import { build } from './build.mjs'
 import { clean } from './partials/clean.mjs'
 import { testFull } from './testFull.mjs'
 import { typeDocs } from './typeDocs.mjs'
+import { jsdocDocs } from './jsdocDocs.mjs'
 import { countMatches } from 'test-filesystem'
 
 // Run the real neostandard (in a subprocess) - Jest's CommonJS transform can't load the ESM-only package itself.
@@ -16,8 +17,11 @@ const genericFunction = () => Promise.resolve(true)
 
 jest.mock('./partials/clean.mjs', () => ({ clean: jest.fn(genericFunction) }))
 jest.mock('./testFull.mjs', () => ({ testFull: jest.fn(genericFunction) }))
-// The documentation is generated by TypeDoc, whose own tests cover that (see typeDocsFor.test.mjs)
+// The documentation is generated by TypeDoc or jsdoc, whose own tests cover that (see typeDocsFor.test.mjs /
+// jsdocDocsFor.test.mjs) - jsdocDocs in particular shells out to a real CLI, far too slow for a build.mjs unit
+// test to actually run.
 jest.mock('./typeDocs.mjs', () => ({ typeDocs: jest.fn(genericFunction) }))
+jest.mock('./jsdocDocs.mjs', () => ({ jsdocDocs: jest.fn(genericFunction) }))
 // tsFor's real implementation loads gulp-ts-compile (a genuine ESM-only package) via a dynamic import() hidden
 // from babel's static analysis - necessary for production correctness (see tsFor.mjs's own comments), but this
 // project's current CommonJS-transform-based Jest setup can't execute a real dynamic import at all: it doesn't
@@ -638,6 +642,7 @@ describe('build', () => {
     expect.assertions(3)
     build(() => {
       gulpConfig.set('docs.enabled', false)
+      gulpConfig.set('typescript.enabled', false)
       expect(typeDocs).toHaveBeenCalledTimes(1)
       // The readme is not generated, it is written by hand
       expect(fs.existsSync(`${readmePath}/${readmeFile}`)).toBe(false)
@@ -646,6 +651,50 @@ describe('build', () => {
     })
   }, 30000)
 
+  test('when docs.enabled is set without typescript.enabled: generates the documentation with jsdoc, inferred from docs.method being unset', done => {
+    const readmePath = gulpConfig.get('readme.to')
+    const readmeFile = gulpConfig.get('readme.file')
+    fs.rmSync(`${readmePath}/${readmeFile}`, { force: true })
+    jsdocDocs.mockClear()
+    gulpConfig.set('browser.enabled', false)
+    gulpConfig.set('typescript.enabled', false)
+    gulpConfig.set('docs.enabled', true)
+    expect.assertions(3)
+    build(() => {
+      gulpConfig.set('docs.enabled', false)
+      expect(jsdocDocs).toHaveBeenCalledTimes(1)
+      // The readme is not generated, it is written by hand - same as the TypeDoc path above
+      expect(fs.existsSync(`${readmePath}/${readmeFile}`)).toBe(false)
+      expect(testFull).toHaveBeenCalled()
+      done()
+    })
+  }, 30000)
+
+  test('docs.method overrides the typescript.enabled inference either way', done => {
+    const srcPath = gulpConfig.get('srcPath')
+    const rootPath = gulpConfig.get('rootPath')
+    const tsConfig = `${rootPath}/tsconfig.json`
+    fs.writeFileSync(`${srcPath}/main.ts`, mainTypescript)
+    fs.writeFileSync(tsConfig, tsConfigContents)
+    typeDocs.mockClear()
+    jsdocDocs.mockClear()
+    gulpConfig.set('browser.enabled', false)
+    gulpConfig.set('typescript.config', tsConfig)
+    gulpConfig.set('typescript.enabled', true)
+    gulpConfig.set('docs.enabled', true)
+    // typescript.enabled is true, which would normally infer 'typedoc' - method forces 'jsdoc' instead.
+    gulpConfig.set('docs.method', 'jsdoc')
+    expect.assertions(2)
+    build(() => {
+      gulpConfig.set('docs.enabled', false)
+      gulpConfig.set('docs.method', false)
+      gulpConfig.set('typescript.enabled', false)
+      expect(jsdocDocs).toHaveBeenCalledTimes(1)
+      expect(typeDocs).not.toHaveBeenCalled()
+      done()
+    })
+  }, 30000)
+
   test('finishes clean before starting the tasks that write into the output folders', done => {
     const srcPath = gulpConfig.get('srcPath')
     const sourcesPath = `${srcPath}/sources`