js-build-tools 4.0.12 → 4.1.0

package/dist/partials/tsFor.js

@@ -1,34 +1,85 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-require("core-js/modules/web.dom-collections.iterator.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.tsFor = void 0;
-var _gulp = require("gulp");
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _gulpTypescript = _interopRequireDefault(require("gulp-typescript"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.tsFor = void 0;
+var _gulp = require("gulp");
+var _nodePath = _interopRequireDefault(require("node:path"));
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _typescript = _interopRequireDefault(require("typescript"));
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// gulp-ts-compile ships ESM-only (no CJS build - see its own package.json) since it's meant to be consumed by
+// gulpfiles running under a real ESM loader, same as this project's own gulpfile.mjs does. This project also
+// compiles itself to a CommonJS build (dist/*.js, this file's own compiled counterpart) for consumers using
+// require() though, and even a dynamic `import()` gets downleveled by babel's CommonJS transform into a
+// require() call - which can't load a real ES module. Hiding the import() call inside a Function constructor is
+// the standard escape hatch: babel can't see (and so can't rewrite) an import expression that only exists as a
+// runtime-evaluated string, so it survives as a genuine dynamic import, capable of loading gulp-ts-compile from
+// either build.
+const importGulpTsCompile = new Function('return import(\'gulp-ts-compile\')');
+
+/**
+ * Wrap a stream in a promise that resolves once it finishes writing.
+ * @memberOf module:partials
+ * @param {import('node:stream').Stream} stream
+ * @returns {Promise<void>}
+ */
+const streamToPromise = stream => new Promise((resolve, reject) => {
+  stream.on('finish', resolve);
+  stream.on('error', reject);
+});
+
+/**
+ * Read a tsconfig.json file into real typescript.CompilerOptions values, using only TypeScript's stable, current,
+ * public config-reading API (the same one `tsc --project` itself uses internally) - never
+ * `ts.convertCompilerOptionsFromJson`, which is exactly the kind of internal/legacy surface that broke
+ * gulp-typescript when a removed API call started throwing under TypeScript 7.
+ * @memberOf module:partials
+ * @param {string} configPath - Path to a tsconfig.json file.
+ * @returns {import('typescript').CompilerOptions}
+ */
+const readCompilerOptions = configPath => {
+  const configFile = _typescript.default.readConfigFile(configPath, _typescript.default.sys.readFile);
+  const parsedConfig = _typescript.default.parseJsonConfigFileContent(configFile.config, _typescript.default.sys, _nodePath.default.dirname(configPath));
+  return parsedConfig.options;
+};
+
 /**
  * Starting at the source directory, find all the ts files and convert them into the distribution directory.
  * @memberOf module:partials
  * @param {string|array} [srcPath='']
  * @param {string} [distPath='']
+ * @param {function(): Promise<Function>} [loadTsCompile] - Resolves the `gulp-ts-compile` default export. Real
+ * callers should never need to pass this - it exists so tests can inject a stand-in compiler, sidestepping the
+ * genuine dynamic `import()` above that this project's current CommonJS-transform-based Jest setup cannot
+ * execute without a broader (and riskier) migration to Jest's native ESM support. gulp-ts-compile's own test
+ * suite already covers real TypeScript-compile correctness - this function's own tests only need to verify its
+ * config resolution and stream wiring.
  * @returns {Function}
- * @see `https://www.typescriptlang.org/docs/handbook/gulp.html` for more info
- */
-const tsFor = function () {
-  let srcPath = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : gulpConfig.get('typescript.from');
-  let distPath = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : gulpConfig.get('typescript.to');
-  if (gulpConfig.get('typescript.enabled') === false) {
-    return () => {};
-  }
-  const declarationProject = _gulpTypescript.default.createProject(gulpConfig.get('typescript.config'));
-  const tsProject = _gulpTypescript.default.createProject(gulpConfig.get('typescript.config'));
-  const makeDeclarations = () => (0, _gulp.src)(srcPath).pipe(declarationProject()).dts.pipe((0, _gulp.dest)(distPath));
-  const compileJS = () => (0, _gulp.src)(srcPath).pipe(tsProject()).js.pipe((0, _gulp.dest)(distPath));
-  return (0, _gulp.parallel)(makeDeclarations, compileJS);
-};
+ */
+const tsFor = (srcPath = gulpConfig.get('typescript.from'), distPath = gulpConfig.get('typescript.to'), loadTsCompile = () => importGulpTsCompile().then(({
+  default: tsCompile
+}) => tsCompile)) => {
+  if (gulpConfig.get('typescript.enabled') === false) {
+    return () => {};
+  }
+  const configPath = gulpConfig.get('typescript.config');
+  const compilerOptions = configPath ? readCompilerOptions(configPath) : {
+    declaration: true
+  };
+  // Accepts gulp's own callback-style task convention (an optional `done`, called once finished) rather than
+  // just returning a Promise, since callers may invoke the returned function directly with a callback instead
+  // of relying on gulp's own runner to observe a returned Promise.
+  return done => {
+    const compile = async () => {
+      const tsCompile = await loadTsCompile();
+      const tsResult = (0, _gulp.src)(srcPath).pipe(tsCompile(compilerOptions));
+      await Promise.all([streamToPromise(tsResult.dts.pipe((0, _gulp.dest)(distPath))), streamToPromise(tsResult.js.pipe((0, _gulp.dest)(distPath)))]);
+    };
+    return typeof done === 'function' ? compile().then(() => done(), done) : compile();
+  };
+};
 exports.tsFor = tsFor;

package/dist/test-helpers/setUp.js

@@ -1,7 +1,6 @@
 "use strict";
 
 require("core-js/modules/esnext.weak-map.delete-all.js");
-require("core-js/modules/web.dom-collections.iterator.js");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -56,41 +55,40 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 // Import the configurations and override some of them to direct to the temp directory.
 
 let tempDir = 'test-temp/';
-let srcPath = "".concat(tempDir, "src");
+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 = function () {
-  let testDir = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'test-temp';
-  tempDir = "".concat(testDir, "/");
-  srcPath = "".concat(tempDir, "src");
+const setDefaults = (testDir = 'test-temp') => {
+  tempDir = `${testDir}/`;
+  srcPath = `${tempDir}src`;
   _testFilesystem.setUp.setDefaults(tempDir);
-  const distPath = "".concat(tempDir, "dist");
-  const browserPath = "".concat(tempDir, "browser");
-  const sassPath = "".concat(tempDir, "sass");
-  gulpConfig.set('browser.from', "".concat(distPath, "/**/*.js"));
+  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', "".concat(srcPath, "/**/!(*.test).js"));
-  gulpConfig.set('dist.main', "".concat(distPath, "/main"));
+  gulpConfig.set('dist.from', `${srcPath}/**/!(*.test).js`);
+  gulpConfig.set('dist.main', `${distPath}/main`);
   gulpConfig.set('dist.to', distPath);
-  gulpConfig.set('fonts.from', "".concat(srcPath, "/fonts/**/*"));
-  gulpConfig.set('fonts.to', "".concat(browserPath, "/fonts"));
-  gulpConfig.set('images.from', "".concat(srcPath, "/img/**/*.+(png|jpg|jpeg|gif|svg)"));
-  gulpConfig.set('images.to', "".concat(browserPath, "/img"));
-  gulpConfig.set('readme.template', "".concat(tempDir, "MAIN.md"));
+  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', "".concat(srcPath, "/**/!(*.test).js"));
+  gulpConfig.set('readme.from', `${srcPath}/**/!(*.test).js`);
   gulpConfig.set('rootPath', tempDir);
-  gulpConfig.set('sass.from', "".concat(sassPath, "/**/*.+(scss|sass)"));
+  gulpConfig.set('sass.from', `${sassPath}/**/*.+(scss|sass)`);
   gulpConfig.set('sass.path', sassPath);
-  gulpConfig.set('sass.to', "".concat(browserPath, "/css"));
+  gulpConfig.set('sass.to', `${browserPath}/css`);
   gulpConfig.set('srcPath', srcPath);
-  gulpConfig.set('typescript.from', "".concat(srcPath, "/**/*.ts"));
+  gulpConfig.set('typescript.from', `${srcPath}/**/*.ts`);
   gulpConfig.set('typescript.to', distPath);
-  gulpConfig.set('test.watch', "".concat(srcPath, "/**/*.js"));
+  gulpConfig.set('test.watch', `${srcPath}/**/*.js`);
 };
 exports.setDefaults = setDefaults;

package/dist/testFull.js

@@ -1,7 +1,6 @@
 'use strict'
 
 require('core-js/modules/esnext.weak-map.delete-all.js')
-require('core-js/modules/web.dom-collections.iterator.js')
 Object.defineProperty(exports, '__esModule', {
   value: true
 })

package/dist/testFull.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),require("core-js/modules/web.dom-collections.iterator.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.testFull=void 0;var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_jest=_interopRequireDefault(require("jest"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,o=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var u,i,n={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return n;if(u=t?o:r){if(u.has(e))return u.get(e);u.set(e,n)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((i=(u=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(i.get||i.set)?u(n,t,i):n[t]=e[t]);return n})(e,t)}const testFull=()=>{let e=gulpConfig.get("test.path");return Array.isArray(e)||(e=[e]),_jest.default.runCLI(gulpConfig.get("test.options"),e)};exports.testFull=testFull;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.testFull=void 0;var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_jest=_interopRequireDefault(require("jest"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,u=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var n,o,i={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return i;if(n=t?u:r){if(n.has(e))return n.get(e);n.set(e,i)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((o=(n=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(o.get||o.set)?n(i,t,o):i[t]=e[t]);return i})(e,t)}const testFull=()=>{let e=gulpConfig.get("test.path");return Array.isArray(e)||(e=[e]),_jest.default.runCLI(gulpConfig.get("test.options"),e)};exports.testFull=testFull;

package/dist/testHelpers.js

@@ -1,7 +1,6 @@
 'use strict'
 
 require('core-js/modules/esnext.weak-map.delete-all.js')
-require('core-js/modules/web.dom-collections.iterator.js')
 Object.defineProperty(exports, '__esModule', {
   value: true
 })

package/dist/testHelpers.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),require("core-js/modules/web.dom-collections.iterator.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.testHelpers=void 0;var _testHelpers=_interopRequireWildcard(require("./test-helpers/setUp.js"));function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,o=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var s,i,n={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return n;if(s=t?o:r){if(s.has(e))return s.get(e);s.set(e,n)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((i=(s=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(i.get||i.set)?s(n,t,i):n[t]=e[t]);return n})(e,t)}exports.testHelpers=_testHelpers;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.testHelpers=void 0;var _testHelpers=_interopRequireWildcard(require("./test-helpers/setUp.js"));function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,s=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var o,n,i={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return i;if(o=t?s:r){if(o.has(e))return o.get(e);o.set(e,i)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((n=(o=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(n.get||n.set)?o(i,t,n):i[t]=e[t]);return i})(e,t)}exports.testHelpers=_testHelpers;

package/dist/testQuick.js

@@ -1,7 +1,6 @@
 'use strict'
 
 require('core-js/modules/esnext.weak-map.delete-all.js')
-require('core-js/modules/web.dom-collections.iterator.js')
 Object.defineProperty(exports, '__esModule', {
   value: true
 })

package/dist/testQuick.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),require("core-js/modules/web.dom-collections.iterator.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.testQuick=void 0;var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_jest=_interopRequireDefault(require("jest"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,u=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var i,o,n={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return n;if(i=t?u:r){if(i.has(e))return i.get(e);i.set(e,n)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((o=(i=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(o.get||o.set)?i(n,t,o):n[t]=e[t]);return n})(e,t)}const testQuick=()=>{let e=gulpConfig.get("test.path");return Array.isArray(e)||(e=[e]),_jest.default.runCLI({onlyChanged:!0},e)};exports.testQuick=testQuick;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.testQuick=void 0;var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_jest=_interopRequireDefault(require("jest"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,u=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var i,n,o={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return o;if(i=t?u:r){if(i.has(e))return i.get(e);i.set(e,o)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((n=(i=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(n.get||n.set)?i(o,t,n):o[t]=e[t]);return o})(e,t)}const testQuick=()=>{let e=gulpConfig.get("test.path");return Array.isArray(e)||(e=[e]),_jest.default.runCLI({onlyChanged:!0},e)};exports.testQuick=testQuick;

package/dist/utilities/dotGet.js

@@ -15,10 +15,7 @@ var _strBefore = require("./strBefore.js");
  * @param {string|null} [defaultValue=null] - The default value to return if the property is not found
  * @returns {*} The value of the property
  */
-const dotGet = function () {
-  let arrayObject = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  let dotNotation = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
-  let defaultValue = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
+const dotGet = (arrayObject = {}, dotNotation = '', defaultValue = null) => {
   if (!dotNotation) {
     return arrayObject;
   }
@@ -43,8 +40,7 @@ const dotGet = function () {
     return result;
   }
   if (lastKey) {
-    var _arrayObject$dotNotat;
-    return (_arrayObject$dotNotat = arrayObject[dotNotation]) !== null && _arrayObject$dotNotat !== void 0 ? _arrayObject$dotNotat : defaultValue;
+    return arrayObject[dotNotation] ?? defaultValue;
   }
   if (typeof arrayObject[key] === 'undefined') {
     return defaultValue;

package/dist/utilities/dotNotate.js

@@ -4,9 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.dotNotate = void 0;
-require("core-js/modules/es.regexp.constructor.js");
-require("core-js/modules/es.regexp.exec.js");
-require("core-js/modules/es.string.replace.js");
 require("core-js/modules/esnext.iterator.constructor.js");
 require("core-js/modules/esnext.iterator.map.js");
 var _isObject = require("./isObject.js");
@@ -15,8 +12,7 @@ var _isObject = require("./isObject.js");
  * @param {Array.<string>} [retainObjects=[]] - An array of keys to retain as objects
  * @returns {Function} The dot-notated array
  */
-const handleRetainObjects = function () {
-  let retainObjects = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+const handleRetainObjects = (retainObjects = []) => {
   if (!retainObjects.length) {
     /**
      * Bypass the test function if there are no retainObjects.
@@ -25,7 +21,7 @@ const handleRetainObjects = function () {
     return (currentKey, value, results) => false;
   }
   retainObjects = retainObjects.map(key => key.replace('\.', '\\.'));
-  const retainRegex = new RegExp("(".concat(retainObjects.join('|'), ")$"));
+  const retainRegex = new RegExp(`(${retainObjects.join('|')})$`);
   /**
    * Test if a key should be retained as an object.
    * @param {string} currentKey - The key to test
@@ -50,17 +46,15 @@ const handleRetainObjects = function () {
  * @param {Object<string, *>} [results={}] - The final notated object to return
  * @returns {Object<string, *>} The dot-notated object
  */
-const performDotNotate = function (arrayObject, didRetain) {
-  let prepend = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : '';
-  let results = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
+const performDotNotate = (arrayObject, didRetain, prepend = '', results = {}) => {
   for (let key in arrayObject) {
     const value = arrayObject[key];
-    const currentKey = "".concat(prepend).concat(key);
+    const currentKey = `${prepend}${key}`;
     if (didRetain(currentKey, value, results)) {
       continue;
     }
     if ((0, _isObject.isObject)(value)) {
-      performDotNotate(value, didRetain, "".concat(currentKey, "."), results);
+      performDotNotate(value, didRetain, `${currentKey}.`, results);
       continue;
     }
     results[currentKey] = value;
@@ -75,8 +69,5 @@ const performDotNotate = function (arrayObject, didRetain) {
  * @param {Array.<string>} [retainObjects=[]] - An array of keys to retain as objects
  * @returns {Object<string, *>} The dot-notated object
  */
-const dotNotate = function (arrayObject) {
-  let retainObjects = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-  return performDotNotate(arrayObject, handleRetainObjects(retainObjects));
-};
+const dotNotate = (arrayObject, retainObjects = []) => performDotNotate(arrayObject, handleRetainObjects(retainObjects));
 exports.dotNotate = dotNotate;

package/dist/utilities/dotSet.js

@@ -15,9 +15,7 @@ var _strBefore = require("./strBefore.js");
  * @param {*} value - The default value to return if the property is not found
  * @returns {Object} The modified object
  */
-const dotSet = function (arrayObject, dotNotation) {
-  var _arrayObject$key;
-  let value = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
+const dotSet = (arrayObject, dotNotation, value = null) => {
   let key = (0, _strBefore.strBefore)(dotNotation, '.');
   const lastKey = !key;
   if (lastKey) {
@@ -40,7 +38,7 @@ const dotSet = function (arrayObject, dotNotation) {
     arrayObject[dotNotation] = value;
     return arrayObject;
   }
-  const next = (_arrayObject$key = arrayObject[key]) !== null && _arrayObject$key !== void 0 ? _arrayObject$key : [];
+  const next = arrayObject[key] ?? [];
   arrayObject[key] = dotSet(next, (0, _strAfter.strAfter)(dotNotation, '.'), value);
   return arrayObject;
 };

package/dist/watchTest.js

@@ -1,7 +1,6 @@
 'use strict'
 
 require('core-js/modules/esnext.weak-map.delete-all.js')
-require('core-js/modules/web.dom-collections.iterator.js')
 Object.defineProperty(exports, '__esModule', {
   value: true
 })

package/dist/watchTest.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),require("core-js/modules/web.dom-collections.iterator.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.watchTest=void 0;var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_gulp=require("gulp"),_testQuick=require("./testQuick.js");function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,i=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var o,u,n={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return n;if(o=t?i:r){if(o.has(e))return o.get(e);o.set(e,n)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((u=(o=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(u.get||u.set)?o(n,t,u):n[t]=e[t]);return n})(e,t)}const watchTest=()=>(0,_gulp.watch)(gulpConfig.get("test.watch"),{ignoreInitial:!1},_testQuick.testQuick);exports.watchTest=watchTest;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.watchTest=void 0;var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_gulp=require("gulp"),_testQuick=require("./testQuick.js");function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,i=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var u,n,o={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return o;if(u=t?i:r){if(u.has(e))return u.get(e);u.set(e,o)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((n=(u=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(n.get||n.set)?u(o,t,n):o[t]=e[t]);return o})(e,t)}const watchTest=()=>(0,_gulp.watch)(gulpConfig.get("test.watch"),{ignoreInitial:!1},_testQuick.testQuick);exports.watchTest=watchTest;

package/functions/build.test.mjs

@@ -12,6 +12,30 @@ const genericFunction = () => Promise.resolve(true)
 
 jest.mock('./partials/clean.mjs', () => ({ clean: jest.fn(genericFunction) }))
 jest.mock('./testFull.mjs', () => ({ testFull: 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
+// just fail cleanly, it segfaults the whole Jest worker. Replace the whole module here with a fake that does
+// real (not mocked-away) TypeScript transpilation via `ts.transpileModule`, so the typescript.enabled tests
+// below still exercise genuine compile behavior end to end - gulp-ts-compile's own test suite separately covers
+// its whole-program/cross-file-import behavior.
+jest.mock('./partials/tsFor.mjs', () => ({
+  tsFor: (srcPath, distPath) => (done) => {
+    const nodeFs = require('fs')
+    const nodePath = require('path')
+    const glob = require('glob')
+    const ts = require('typescript')
+    nodeFs.mkdirSync(distPath, { recursive: true })
+    for (const file of glob.globSync(srcPath)) {
+      const contents = nodeFs.readFileSync(file).toString()
+      const { outputText } = ts.transpileModule(contents, { compilerOptions: { declaration: true } })
+      const base = nodePath.basename(file).replace(/\.tsx?$/, '')
+      nodeFs.writeFileSync(`${distPath}/${base}.js`, outputText)
+      nodeFs.writeFileSync(`${distPath}/${base}.d.ts`, '')
+    }
+    done()
+  }
+}))
 
 const file1Contents = '/**\n' +
   ' * Console log out a greeting with given input.\n' +

package/functions/partials/distFor.test.mjs

@@ -1,9 +1,39 @@
 import fs from 'fs'
+import { Transform, PassThrough } from 'node:stream'
+import ts from 'typescript'
+import File from 'vinyl'
 import * as setUp from '../test-helpers/setUp.mjs'
 import { distFor } from './distFor.mjs'
 import { countMatches, fileExists } from 'test-filesystem'
 import { tsFor } from './tsFor.mjs'
 
+// 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 cannot execute a real dynamic import at all: it doesn't
+// just fail cleanly, it segfaults the whole Jest worker. This fake stands in for it here, doing real (not
+// mocked-away) TypeScript transpilation via `ts.transpileModule` so this test still exercises genuine compile
+// behavior - gulp-ts-compile's own test suite separately covers its whole-program/cross-file-import behavior.
+const fakeLoadTsCompile = () => Promise.resolve((options) => {
+  const transform = new Transform({
+    objectMode: true,
+    transform (file, enc, callback) {
+      const { outputText } = ts.transpileModule(file.contents.toString(), { compilerOptions: options })
+      jsStream.push(new File({ cwd: file.cwd, base: file.base, path: file.path.replace(/\.tsx?$/, '.js'), contents: Buffer.from(outputText) }))
+      callback()
+    },
+    flush (callback) {
+      jsStream.end()
+      dtsStream.end()
+      callback()
+    }
+  })
+  const jsStream = new PassThrough({ objectMode: true })
+  const dtsStream = new PassThrough({ objectMode: true })
+  transform.js = jsStream
+  transform.dts = dtsStream
+  return transform
+})
+
 setUp.setDefaults('test-dist-for')
 const gulpConfig = setUp.gulpConfig
 
@@ -86,7 +116,7 @@ describe('distFor', () => {
     const srcPath = gulpConfig.get('srcPath')
     const srcFile = `${srcPath}/distFor.js`
     fs.writeFileSync(srcFile, rawContents)
-    expect.assertions(5)
+    expect.assertions(3)
     const oldContents = fs.readFileSync(srcFile).toString()
     expect(countMatches(oldContents, 'const ')).toEqual(7)
     const distPath = gulpConfig.get('dist.to')
@@ -94,14 +124,12 @@ describe('distFor', () => {
       .on('finish', () => {
         expect(fileExists(distPath)).toBeTruthy()
         const babelifiedContents = fs.readFileSync(`${distPath}/distFor.js`).toString()
-        expect(countMatches(babelifiedContents, '"use strict"')).toEqual(1)
-        /* There used to be a nice check here where `const` and `let` would be swapped to `var`, but that no longer
-           happens.
-           It would be nice if it still happened, but due to 'browserlist' supposedly, most browsers support
-           `const` and `let` now.
+        /* There used to be checks here for `const`/`let` being swapped to `var`, and for arrow functions being
+           compiled down to `function`/`arguments`, but neither happens anymore now that 'browserslist' resolves to
+           targets that natively support this syntax - there's nothing stable left to count. What still matters -
+           that babel actually ran and produced a valid CommonJS module - is confirmed by the "use strict" check.
          */
-        expect(countMatches(babelifiedContents, 'function')).toEqual(1)
-        expect(countMatches(babelifiedContents, 'arguments')).toEqual(6)
+        expect(countMatches(babelifiedContents, '"use strict"')).toEqual(1)
         done()
       })
       .on('error', error => {
@@ -122,7 +150,7 @@ describe('distFor', () => {
     const distPath = gulpConfig.get('dist.to')
     const tsFrom = gulpConfig.get('typescript.from')
     const tsTo = gulpConfig.get('typescript.to')
-    tsFor(tsFrom, tsTo)(() => {
+    tsFor(tsFrom, tsTo, fakeLoadTsCompile)(() => {
       distFor()
         .on('finish', () => {
           expect(fileExists(distPath)).toBeTruthy()
@@ -153,7 +181,10 @@ describe('distFor', () => {
       .on('finish', () => {
         expect(fileExists(distPath)).toBeTruthy()
         const babelifiedContents = fs.readFileSync(`${distPath}/distFor.js`).toString()
-        expect(countMatches(babelifiedContents, '.js')).toEqual(4)
+        // A total '.js' substring count is too fragile - it drifts with whichever core-js polyfill modules babel
+        // happens to pull in. Check specifically for the thing this test is about: the .mjs import extension in
+        // the source (./distForSrc.mjs) got rewritten to .js in the compiled require path.
+        expect(countMatches(babelifiedContents, 'distForSrc.js')).toEqual(1)
         done()
       })
       .on('error', error => {

package/functions/partials/tsFor.mjs

@@ -1,22 +1,79 @@
-import { dest, parallel, src } from 'gulp'
+import { dest, src } from 'gulp'
+import path from 'node:path'
 import * as gulpConfig from '../../gulp.config.mjs'
-import ts from 'gulp-typescript'
+import ts from 'typescript'
+
+// gulp-ts-compile ships ESM-only (no CJS build - see its own package.json) since it's meant to be consumed by
+// gulpfiles running under a real ESM loader, same as this project's own gulpfile.mjs does. This project also
+// compiles itself to a CommonJS build (dist/*.js, this file's own compiled counterpart) for consumers using
+// require() though, and even a dynamic `import()` gets downleveled by babel's CommonJS transform into a
+// require() call - which can't load a real ES module. Hiding the import() call inside a Function constructor is
+// the standard escape hatch: babel can't see (and so can't rewrite) an import expression that only exists as a
+// runtime-evaluated string, so it survives as a genuine dynamic import, capable of loading gulp-ts-compile from
+// either build.
+const importGulpTsCompile = new Function('return import(\'gulp-ts-compile\')')
+
+/**
+ * Wrap a stream in a promise that resolves once it finishes writing.
+ * @memberOf module:partials
+ * @param {import('node:stream').Stream} stream
+ * @returns {Promise<void>}
+ */
+const streamToPromise = (stream) => new Promise((resolve, reject) => {
+  stream.on('finish', resolve)
+  stream.on('error', reject)
+})
+
+/**
+ * Read a tsconfig.json file into real typescript.CompilerOptions values, using only TypeScript's stable, current,
+ * public config-reading API (the same one `tsc --project` itself uses internally) - never
+ * `ts.convertCompilerOptionsFromJson`, which is exactly the kind of internal/legacy surface that broke
+ * gulp-typescript when a removed API call started throwing under TypeScript 7.
+ * @memberOf module:partials
+ * @param {string} configPath - Path to a tsconfig.json file.
+ * @returns {import('typescript').CompilerOptions}
+ */
+const readCompilerOptions = (configPath) => {
+  const configFile = ts.readConfigFile(configPath, ts.sys.readFile)
+  const parsedConfig = ts.parseJsonConfigFileContent(configFile.config, ts.sys, path.dirname(configPath))
+  return parsedConfig.options
+}
 
 /**
  * Starting at the source directory, find all the ts files and convert them into the distribution directory.
  * @memberOf module:partials
  * @param {string|array} [srcPath='']
  * @param {string} [distPath='']
+ * @param {function(): Promise<Function>} [loadTsCompile] - Resolves the `gulp-ts-compile` default export. Real
+ * callers should never need to pass this - it exists so tests can inject a stand-in compiler, sidestepping the
+ * genuine dynamic `import()` above that this project's current CommonJS-transform-based Jest setup cannot
+ * execute without a broader (and riskier) migration to Jest's native ESM support. gulp-ts-compile's own test
+ * suite already covers real TypeScript-compile correctness - this function's own tests only need to verify its
+ * config resolution and stream wiring.
  * @returns {Function}
- * @see `https://www.typescriptlang.org/docs/handbook/gulp.html` for more info
  */
-export const tsFor = (srcPath = gulpConfig.get('typescript.from'), distPath = gulpConfig.get('typescript.to')) => {
+export const tsFor = (
+  srcPath = gulpConfig.get('typescript.from'),
+  distPath = gulpConfig.get('typescript.to'),
+  loadTsCompile = () => importGulpTsCompile().then(({ default: tsCompile }) => tsCompile)
+) => {
   if (gulpConfig.get('typescript.enabled') === false) {
     return () => {}
   }
-  const declarationProject = ts.createProject(gulpConfig.get('typescript.config'))
-  const tsProject = ts.createProject(gulpConfig.get('typescript.config'))
-  const makeDeclarations = () => src(srcPath).pipe(declarationProject()).dts.pipe(dest(distPath))
-  const compileJS = () => src(srcPath).pipe(tsProject()).js.pipe(dest(distPath))
-  return parallel(makeDeclarations, compileJS)
+  const configPath = gulpConfig.get('typescript.config')
+  const compilerOptions = configPath ? readCompilerOptions(configPath) : { declaration: true }
+  // Accepts gulp's own callback-style task convention (an optional `done`, called once finished) rather than
+  // just returning a Promise, since callers may invoke the returned function directly with a callback instead
+  // of relying on gulp's own runner to observe a returned Promise.
+  return (done) => {
+    const compile = async () => {
+      const tsCompile = await loadTsCompile()
+      const tsResult = src(srcPath).pipe(tsCompile(compilerOptions))
+      await Promise.all([
+        streamToPromise(tsResult.dts.pipe(dest(distPath))),
+        streamToPromise(tsResult.js.pipe(dest(distPath)))
+      ])
+    }
+    return typeof done === 'function' ? compile().then(() => done(), done) : compile()
+  }
 }

package/functions/partials/tsFor.test.mjs

@@ -1,4 +1,7 @@
 import fs from 'fs'
+import { Transform, PassThrough } from 'node:stream'
+import ts from 'typescript'
+import File from 'vinyl'
 import * as setUp from '../test-helpers/setUp.mjs'
 import { tsFor } from './tsFor.mjs'
 import { countMatches } from 'test-filesystem'
@@ -10,6 +13,33 @@ const rawContents = 'export function sayHello(name: string) {\n' +
   '  return `Hello from ${name}`;\n' +
   '}'
 
+// 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 not
+// something this project's current CommonJS-transform-based Jest setup can execute without a much bigger
+// migration to Jest's native ESM support. This fake stands in for it here, doing real (not mocked-away)
+// TypeScript transpilation via `ts.transpileModule` so this test still exercises genuine compile behavior -
+// gulp-ts-compile's own test suite separately covers its whole-program/cross-file-import compile behavior.
+const fakeLoadTsCompile = () => Promise.resolve((options) => {
+  const transform = new Transform({
+    objectMode: true,
+    transform (file, enc, callback) {
+      const { outputText } = ts.transpileModule(file.contents.toString(), { compilerOptions: options })
+      jsStream.push(new File({ cwd: file.cwd, base: file.base, path: file.path.replace(/\.ts$/, '.js'), contents: Buffer.from(outputText) }))
+      callback()
+    },
+    flush (callback) {
+      jsStream.end()
+      dtsStream.end()
+      callback()
+    }
+  })
+  const jsStream = new PassThrough({ objectMode: true })
+  const dtsStream = new PassThrough({ objectMode: true })
+  transform.js = jsStream
+  transform.dts = dtsStream
+  return transform
+})
+
 beforeEach(
   () => setUp.beforeEach()
     .then(
@@ -31,7 +61,7 @@ describe('tsFor', () => {
     expect.assertions(3)
     const oldContents = fs.readFileSync(srcFile).toString()
     expect(countMatches(oldContents, 'sayHello(name: string)')).toEqual(1)
-    tsFor(srcFile, distPath)(() => {
+    tsFor(srcFile, distPath, fakeLoadTsCompile)(() => {
       expect(fs.existsSync(distPath)).toBeTruthy()
       const compiledContents = fs.readFileSync(`${distPath}/typeScript.js`).toString()
       expect(countMatches(compiledContents, 'sayHello(name)')).toEqual(1)