js-build-tools 6.6.0 → 6.7.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);

package/dist/utilities/strBefore.js

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

package/dist/watchFull.js

@@ -5,10 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.watchFull = void 0;
 var _partials = require("./partials.js");
-/**
- * Watch for changes and run the distribution for the changed files, then bundle and test the changed files.
- * @memberOf module:js-build-tools
- * @returns {FSWatcher}
+/**
+ * Watch for changes and run the distribution for the changed files, then bundle and test the changed files.
+ * @memberOf module:js-build-tools
+ * @returns {FSWatcher}
  */
 const watchFull = () => (0, _partials.beginWatcher)().on('change', _partials.runOnChange);
 exports.watchFull = watchFull;

package/dist/watchTest.js

@@ -10,10 +10,10 @@ 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 {*}
+/**
+ * Watch for changes and run the tests.
+ * @memberOf module:js-build-tools
+ * @returns {*}
  */
 const watchTest = () => (0, _gulp.watch)(gulpConfig.get('test.watch'), {
   ignoreInitial: false