js-build-tools 6.5.0 → 6.7.0

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) {

package/dist/utilities/dotGet.js

@@ -1,55 +1,55 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.dotGet = void 0;
-var _isObject = require("./isObject.js");
-var _strAfter = require("./strAfter.js");
-var _strBefore = require("./strBefore.js");
-/**
- * Get a nested property value from an object.
- * Original source concepts from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/objects/dotGet.ts Sí, funciona}
- * @param {Object} [arrayObject={}] - The array or object to get the property from
- * @param {string} [dotNotation=''] - The path to the property
- * @param {string|null} [defaultValue=null] - The default value to return if the property is not found
- * @returns {*} The value of the property
- * @private
- */
-const dotGet = (arrayObject = {}, dotNotation = '', defaultValue = null) => {
-  if (!dotNotation) {
-    return arrayObject;
-  }
-  let key = (0, _strBefore.strBefore)(dotNotation, '.');
-  const lastKey = !key;
-  if (lastKey) {
-    key = dotNotation;
-  }
-  if (key === '*') {
-    const result = [];
-    for (const wildKey in arrayObject) {
-      const wildValue = arrayObject[wildKey];
-      if (lastKey) {
-        result[wildKey] = wildValue;
-        continue;
-      }
-      if (!(0, _isObject.isObject)(wildValue)) {
-        continue;
-      }
-      result[wildKey] = dotGet(wildValue, (0, _strAfter.strAfter)(dotNotation, '.'), defaultValue);
-    }
-    return result;
-  }
-  if (lastKey) {
-    return arrayObject[dotNotation] ?? defaultValue;
-  }
-  if (typeof arrayObject[key] === 'undefined') {
-    return defaultValue;
-  }
-  const next = arrayObject[key];
-  if (!(0, _isObject.isObject)(next)) {
-    return defaultValue;
-  }
-  return dotGet(next, (0, _strAfter.strAfter)(dotNotation, '.'), defaultValue);
-};
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.dotGet = void 0;
+var _isObject = require("./isObject.js");
+var _strAfter = require("./strAfter.js");
+var _strBefore = require("./strBefore.js");
+/**
+ * Get a nested property value from an object.
+ * Original source concepts from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/objects/dotGet.ts Sí, funciona}
+ * @param {Object} [arrayObject={}] - The array or object to get the property from
+ * @param {string} [dotNotation=''] - The path to the property
+ * @param {string|null} [defaultValue=null] - The default value to return if the property is not found
+ * @returns {*} The value of the property
+ * @private
+ */
+const dotGet = (arrayObject = {}, dotNotation = '', defaultValue = null) => {
+  if (!dotNotation) {
+    return arrayObject;
+  }
+  let key = (0, _strBefore.strBefore)(dotNotation, '.');
+  const lastKey = !key;
+  if (lastKey) {
+    key = dotNotation;
+  }
+  if (key === '*') {
+    const result = [];
+    for (const wildKey in arrayObject) {
+      const wildValue = arrayObject[wildKey];
+      if (lastKey) {
+        result[wildKey] = wildValue;
+        continue;
+      }
+      if (!(0, _isObject.isObject)(wildValue)) {
+        continue;
+      }
+      result[wildKey] = dotGet(wildValue, (0, _strAfter.strAfter)(dotNotation, '.'), defaultValue);
+    }
+    return result;
+  }
+  if (lastKey) {
+    return arrayObject[dotNotation] ?? defaultValue;
+  }
+  if (typeof arrayObject[key] === 'undefined') {
+    return defaultValue;
+  }
+  const next = arrayObject[key];
+  if (!(0, _isObject.isObject)(next)) {
+    return defaultValue;
+  }
+  return dotGet(next, (0, _strAfter.strAfter)(dotNotation, '.'), defaultValue);
+};
 exports.dotGet = dotGet;

package/dist/utilities/dotNotate.js

@@ -1,80 +1,80 @@
-"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
- * @private
- */
-const handleRetainObjects = (retainObjects = []) => {
-  if (!retainObjects.length) {
-    /**
-     * Bypass the test function if there are no retainObjects.
-     * @returns {false}
-     * @private
-     */
-    return (currentKey, value, results) => false;
-  }
-  retainObjects = retainObjects.map(key => key.replaceAll('.', '\\.'));
-  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}
-   * @private
-   */
-  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
- * @param {Function} didRetain - The test function to see if a key should be retained
- * @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
- * @private
- */
-const performDotNotate = (arrayObject, didRetain, prepend = '', results = {}) => {
-  for (const 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
- * @private
- */
-const dotNotate = (arrayObject, retainObjects = []) => performDotNotate(arrayObject, handleRetainObjects(retainObjects));
+"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
+ * @private
+ */
+const handleRetainObjects = (retainObjects = []) => {
+  if (!retainObjects.length) {
+    /**
+     * Bypass the test function if there are no retainObjects.
+     * @returns {false}
+     * @private
+     */
+    return (currentKey, value, results) => false;
+  }
+  retainObjects = retainObjects.map(key => key.replaceAll('.', '\\.'));
+  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}
+   * @private
+   */
+  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
+ * @param {Function} didRetain - The test function to see if a key should be retained
+ * @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
+ * @private
+ */
+const performDotNotate = (arrayObject, didRetain, prepend = '', results = {}) => {
+  for (const 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
+ * @private
+ */
+const dotNotate = (arrayObject, retainObjects = []) => performDotNotate(arrayObject, handleRetainObjects(retainObjects));
 exports.dotNotate = dotNotate;

package/dist/utilities/dotSet.js

@@ -1,46 +1,46 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.dotSet = void 0;
-var _isObject = require("./isObject.js");
-var _strAfter = require("./strAfter.js");
-var _strBefore = require("./strBefore.js");
-/**
- * Set a nested property value an object.
- * Original source concepts from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/objects/dotSet.ts Sí, funciona}
- * @param {Object} arrayObject - The array or object to set the property on
- * @param {string} dotNotation - The path for the property
- * @param {*} value - The default value to return if the property is not found
- * @returns {Object} The modified object
- * @private
- */
-const dotSet = (arrayObject, dotNotation, value = null) => {
-  let key = (0, _strBefore.strBefore)(dotNotation, '.');
-  const lastKey = !key;
-  if (lastKey) {
-    key = dotNotation;
-  }
-  if (key === '*') {
-    for (const wildKey in arrayObject) {
-      if (lastKey) {
-        arrayObject[wildKey] = value;
-        continue;
-      }
-      if (!(0, _isObject.isObject)(arrayObject[wildKey])) {
-        continue;
-      }
-      dotSet(arrayObject[wildKey], (0, _strAfter.strAfter)(dotNotation, '.'), value);
-    }
-    return arrayObject;
-  }
-  if (lastKey) {
-    arrayObject[dotNotation] = value;
-    return arrayObject;
-  }
-  const next = arrayObject[key] ?? [];
-  arrayObject[key] = dotSet(next, (0, _strAfter.strAfter)(dotNotation, '.'), value);
-  return arrayObject;
-};
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.dotSet = void 0;
+var _isObject = require("./isObject.js");
+var _strAfter = require("./strAfter.js");
+var _strBefore = require("./strBefore.js");
+/**
+ * Set a nested property value an object.
+ * Original source concepts from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/objects/dotSet.ts Sí, funciona}
+ * @param {Object} arrayObject - The array or object to set the property on
+ * @param {string} dotNotation - The path for the property
+ * @param {*} value - The default value to return if the property is not found
+ * @returns {Object} The modified object
+ * @private
+ */
+const dotSet = (arrayObject, dotNotation, value = null) => {
+  let key = (0, _strBefore.strBefore)(dotNotation, '.');
+  const lastKey = !key;
+  if (lastKey) {
+    key = dotNotation;
+  }
+  if (key === '*') {
+    for (const wildKey in arrayObject) {
+      if (lastKey) {
+        arrayObject[wildKey] = value;
+        continue;
+      }
+      if (!(0, _isObject.isObject)(arrayObject[wildKey])) {
+        continue;
+      }
+      dotSet(arrayObject[wildKey], (0, _strAfter.strAfter)(dotNotation, '.'), value);
+    }
+    return arrayObject;
+  }
+  if (lastKey) {
+    arrayObject[dotNotation] = value;
+    return arrayObject;
+  }
+  const next = arrayObject[key] ?? [];
+  arrayObject[key] = dotSet(next, (0, _strAfter.strAfter)(dotNotation, '.'), value);
+  return arrayObject;
+};
 exports.dotSet = dotSet;

package/dist/utilities/esmNamedExportsToCjs.js

@@ -4,21 +4,21 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.esmNamedExportsToCjs = void 0;
-/**
- * Rewrites named `export const`/`export function`/`export class` declarations to plain declarations plus a
- * trailing `module.exports = { ... }` - the same shape jsdoc-to-markdown already documents cleanly (a plain
- * declaration with its own `@memberOf` tag, exported all at once at the bottom), rather than the "exports.name"
- * longname jsdoc-to-markdown's own ESM-compat layer produces for an inline `export const name = ...`.
- *
- * This is a narrow, text-level rewrite for documentation purposes only - it does not execute the module, so it
- * only has to look enough like the real thing for jsdoc-to-markdown's parser. It handles the common named-export
- * forms (`export const`, `export function`, `export class`) and leaves everything else (including `export
- * default`, re-exports, and `export { a, b }` lists) untouched in place - a file using one of those keeps its
- * own export line as-is, which jsdoc-to-markdown will document however it already does for ESM.
- * @memberOf module:utilities
- * @param {string} source - The raw ESM source text (never executed, just rewritten as text).
- * @returns {string} The rewritten text, safe to write out with a `.js` extension for jsdoc-to-markdown to read.
- * @private
+/**
+ * Rewrites named `export const`/`export function`/`export class` declarations to plain declarations plus a
+ * trailing `module.exports = { ... }` - the same shape jsdoc-to-markdown already documents cleanly (a plain
+ * declaration with its own `@memberOf` tag, exported all at once at the bottom), rather than the "exports.name"
+ * longname jsdoc-to-markdown's own ESM-compat layer produces for an inline `export const name = ...`.
+ *
+ * This is a narrow, text-level rewrite for documentation purposes only - it does not execute the module, so it
+ * only has to look enough like the real thing for jsdoc-to-markdown's parser. It handles the common named-export
+ * forms (`export const`, `export function`, `export class`) and leaves everything else (including `export
+ * default`, re-exports, and `export { a, b }` lists) untouched in place - a file using one of those keeps its
+ * own export line as-is, which jsdoc-to-markdown will document however it already does for ESM.
+ * @memberOf module:utilities
+ * @param {string} source - The raw ESM source text (never executed, just rewritten as text).
+ * @returns {string} The rewritten text, safe to write out with a `.js` extension for jsdoc-to-markdown to read.
+ * @private
  */
 const esmNamedExportsToCjs = source => {
   const exportedNames = [];

package/dist/utilities/getBundleConfigs.js

@@ -10,15 +10,15 @@ 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
- * any additional bundles from browser.bundles - each falling back to the primary's main / ignore /
- * exclude whenever its own isn't given, so a render-only (or any other variant) bundle only has to
- * specify what's actually different about it.
- * @memberOf module:utilities
- * @returns {Array<{name: string, main: string, ignore: Array, exclude: Array}>}
- * @private
+/**
+ * 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
+ * any additional bundles from browser.bundles - each falling back to the primary's main / ignore /
+ * exclude whenever its own isn't given, so a render-only (or any other variant) bundle only has to
+ * specify what's actually different about it.
+ * @memberOf module:utilities
+ * @returns {Array<{name: string, main: string, ignore: Array, exclude: Array}>}
+ * @private
  */
 const getBundleConfigs = () => {
   const primary = {

package/dist/utilities/isObject.js

@@ -4,12 +4,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.isObject = void 0;
-/**
- * Check if the provided thing is an object / array.
- * Original source concepts from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/objects/isObject.ts Sí, funciona}
- * @param {*} object
- * @returns {boolean}
- * @private
+/**
+ * Check if the provided thing is an object / array.
+ * Original source concepts from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/objects/isObject.ts Sí, funciona}
+ * @param {*} object
+ * @returns {boolean}
+ * @private
  */
 const isObject = object => typeof object === 'object' && object !== null;
 exports.isObject = isObject;

package/dist/utilities/strAfter.js

@@ -4,13 +4,13 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.strAfter = void 0;
-/**
- * Retrieve the string part after the search match.
- * Original source from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/strings/strAfter.ts Sí, funciona}
- * @param {string} str
- * @param {string} search
- * @returns {string}
- * @private
+/**
+ * Retrieve the string part after the search match.
+ * Original source from {@link https://github.com/jheagle/si-funciona/blob/main/src/helpers/strings/strAfter.ts Sí, funciona}
+ * @param {string} str
+ * @param {string} search
+ * @returns {string}
+ * @private
  */
 const strAfter = (str, search) => {
   const index = str.indexOf(search);