js-build-tools 5.6.0 → 6.0.0

package/dist/partials.js

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

package/dist/partials.min.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"addToReadme",{enumerable:!0,get:function(){return _addToReadme.addToReadme}}),Object.defineProperty(exports,"beginWatcher",{enumerable:!0,get:function(){return _beginWatcher.beginWatcher}}),Object.defineProperty(exports,"clean",{enumerable:!0,get:function(){return _clean.clean}}),Object.defineProperty(exports,"copyFor",{enumerable:!0,get:function(){return _copyFor.copyFor}}),Object.defineProperty(exports,"distFor",{enumerable:!0,get:function(){return _distFor.distFor}}),Object.defineProperty(exports,"distForSrc",{enumerable:!0,get:function(){return _distForSrc.distForSrc}}),Object.defineProperty(exports,"distSeries",{enumerable:!0,get:function(){return _distSeries.distSeries}}),Object.defineProperty(exports,"imagesFor",{enumerable:!0,get:function(){return _imagesFor.imagesFor}}),Object.defineProperty(exports,"importModule",{enumerable:!0,get:function(){return _loadPeer.importModule}}),Object.defineProperty(exports,"importPeer",{enumerable:!0,get:function(){return _loadPeer.importPeer}}),Object.defineProperty(exports,"minifyFor",{enumerable:!0,get:function(){return _minifyFor.minifyFor}}),Object.defineProperty(exports,"readmeTemplate",{enumerable:!0,get:function(){return _readmeTemplate.readmeTemplate}}),Object.defineProperty(exports,"removeDirectory",{enumerable:!0,get:function(){return _removeDirectory.removeDirectory}}),Object.defineProperty(exports,"requirePeer",{enumerable:!0,get:function(){return _loadPeer.requirePeer}}),Object.defineProperty(exports,"runOnChange",{enumerable:!0,get:function(){return _runOnChange.runOnChange}}),Object.defineProperty(exports,"sassFor",{enumerable:!0,get:function(){return _sassFor.sassFor}}),Object.defineProperty(exports,"standardLint",{enumerable:!0,get:function(){return _standardLint.standardLint}}),Object.defineProperty(exports,"tsFor",{enumerable:!0,get:function(){return _tsFor.tsFor}}),Object.defineProperty(exports,"typeDocsFor",{enumerable:!0,get:function(){return _typeDocsFor.typeDocsFor}});var _addToReadme=require("./partials/addToReadme.js"),_beginWatcher=require("./partials/beginWatcher.js"),_clean=require("./partials/clean.js"),_copyFor=require("./partials/copyFor.js"),_distFor=require("./partials/distFor.js"),_distForSrc=require("./partials/distForSrc.js"),_distSeries=require("./partials/distSeries.js"),_imagesFor=require("./partials/imagesFor.js"),_loadPeer=require("./partials/loadPeer.js"),_minifyFor=require("./partials/minifyFor.js"),_readmeTemplate=require("./partials/readmeTemplate.js"),_removeDirectory=require("./partials/removeDirectory.js"),_runOnChange=require("./partials/runOnChange.js"),_sassFor=require("./partials/sassFor.js"),_standardLint=require("./partials/standardLint.js"),_tsFor=require("./partials/tsFor.js"),_typeDocsFor=require("./partials/typeDocsFor.js");
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),Object.defineProperty(exports,"addToReadme",{enumerable:!0,get:function(){return _addToReadme.addToReadme}}),Object.defineProperty(exports,"beginWatcher",{enumerable:!0,get:function(){return _beginWatcher.beginWatcher}}),Object.defineProperty(exports,"clean",{enumerable:!0,get:function(){return _clean.clean}}),Object.defineProperty(exports,"copyFor",{enumerable:!0,get:function(){return _copyFor.copyFor}}),Object.defineProperty(exports,"distFor",{enumerable:!0,get:function(){return _distFor.distFor}}),Object.defineProperty(exports,"distForSrc",{enumerable:!0,get:function(){return _distForSrc.distForSrc}}),Object.defineProperty(exports,"distSeries",{enumerable:!0,get:function(){return _distSeries.distSeries}}),Object.defineProperty(exports,"imagesFor",{enumerable:!0,get:function(){return _imagesFor.imagesFor}}),Object.defineProperty(exports,"importModule",{enumerable:!0,get:function(){return _loadPeer.importModule}}),Object.defineProperty(exports,"importPeer",{enumerable:!0,get:function(){return _loadPeer.importPeer}}),Object.defineProperty(exports,"minifyFor",{enumerable:!0,get:function(){return _minifyFor.minifyFor}}),Object.defineProperty(exports,"neostandardLint",{enumerable:!0,get:function(){return _neostandardLint.neostandardLint}}),Object.defineProperty(exports,"readmeTemplate",{enumerable:!0,get:function(){return _readmeTemplate.readmeTemplate}}),Object.defineProperty(exports,"removeDirectory",{enumerable:!0,get:function(){return _removeDirectory.removeDirectory}}),Object.defineProperty(exports,"requirePeer",{enumerable:!0,get:function(){return _loadPeer.requirePeer}}),Object.defineProperty(exports,"runOnChange",{enumerable:!0,get:function(){return _runOnChange.runOnChange}}),Object.defineProperty(exports,"sassFor",{enumerable:!0,get:function(){return _sassFor.sassFor}}),Object.defineProperty(exports,"tsFor",{enumerable:!0,get:function(){return _tsFor.tsFor}}),Object.defineProperty(exports,"typeDocsFor",{enumerable:!0,get:function(){return _typeDocsFor.typeDocsFor}});var _addToReadme=require("./partials/addToReadme.js"),_beginWatcher=require("./partials/beginWatcher.js"),_clean=require("./partials/clean.js"),_copyFor=require("./partials/copyFor.js"),_distFor=require("./partials/distFor.js"),_distForSrc=require("./partials/distForSrc.js"),_distSeries=require("./partials/distSeries.js"),_imagesFor=require("./partials/imagesFor.js"),_loadPeer=require("./partials/loadPeer.js"),_minifyFor=require("./partials/minifyFor.js"),_neostandardLint=require("./partials/neostandardLint.js"),_readmeTemplate=require("./partials/readmeTemplate.js"),_removeDirectory=require("./partials/removeDirectory.js"),_runOnChange=require("./partials/runOnChange.js"),_sassFor=require("./partials/sassFor.js"),_tsFor=require("./partials/tsFor.js"),_typeDocsFor=require("./partials/typeDocsFor.js");

package/dist/sass.js

@@ -1,10 +1,10 @@
-'use strict'
+"use strict";
 
-Object.defineProperty(exports, '__esModule', {
+Object.defineProperty(exports, "__esModule", {
   value: true
-})
-exports.sass = void 0
-const _sassFor = require('./partials/sassFor.js')
+});
+exports.sass = void 0;
+var _sassFor = require("./partials/sassFor.js");
 // Compile sass into CSS & auto-inject into browsers
-const sass = () => (0, _sassFor.sassFor)()
-exports.sass = sass
+const sass = () => (0, _sassFor.sassFor)();
+exports.sass = sass;

package/dist/sourceLint.js

@@ -0,0 +1,33 @@
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sourceLint = void 0;
+var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
+var _gulp = require("gulp");
+var _neostandardLint = require("./partials/neostandardLint.js");
+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); }
+/**
+ * Applies neostandard linting (js-build-tools' chosen style) to the real, hand-written source - not the compiled
+ * dist/browser output, which is generated and so was never going to pass a hand-authored-code style check (every
+ * compiler/bundler emits its own boilerplate - import aliasing, interop headers - that only looks like a style
+ * violation). Includes test files: there is no reason to hold tests to a lower style bar than the rest of the
+ * source. When typescript.enabled, the real TypeScript source is linted too, with type-aware rules.
+ * @memberOf module:js-build-tools
+ * @returns {*}
+ */
+const sourceLint = () => {
+  const srcPath = gulpConfig.get('srcPath');
+  const ts = gulpConfig.get('typescript.enabled');
+  const patterns = [`${srcPath}/**/*.js`];
+  if (ts) {
+    patterns.push(`${srcPath}/**/*.ts`);
+  }
+  return (0, _gulp.src)(patterns).pipe((0, _neostandardLint.neostandardLint)({
+    fix: true,
+    ts
+  })).pipe((0, _gulp.dest)(srcPath));
+};
+exports.sourceLint = sourceLint;

package/dist/sourceLint.min.js

@@ -0,0 +1 @@
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.sourceLint=void 0;var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_gulp=require("gulp"),_neostandardLint=require("./partials/neostandardLint.js");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 i,o,u={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return u;if(i=t?n:r){if(i.has(e))return i.get(e);i.set(e,u)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((o=(i=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(o.get||o.set)?i(u,t,o):u[t]=e[t]);return u})(e,t)}const sourceLint=()=>{const e=gulpConfig.get("srcPath"),t=gulpConfig.get("typescript.enabled"),r=[`${e}/**/*.js`];return t&&r.push(`${e}/**/*.ts`),(0,_gulp.src)(r).pipe((0,_neostandardLint.neostandardLint)({fix:!0,ts:t})).pipe((0,_gulp.dest)(e))};exports.sourceLint=sourceLint;

package/dist/test-helpers/neostandardLintWithRealNeostandard.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.neostandardLint = exports.loadEslintViaSubprocess = void 0;
+require("core-js/modules/es.json.stringify.js");
+var _nodeChild_process = require("node:child_process");
+var _nodeFs = _interopRequireDefault(require("node:fs"));
+var _nodePath = _interopRequireDefault(require("node:path"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// Jest's CommonJS transform cannot load `neostandard` (ESM-only) or run a real dynamic import(), so tests that need
+// genuine neostandard behavior run the actual package in a plain Node subprocess instead of faking it.
+const script = 'import { readFileSync } from \'node:fs\'\n' + 'import { ESLint } from \'eslint\'\n' + 'import { neostandard } from \'neostandard\'\n' + 'const { text, filePath, cwd, fix, ts, env } = JSON.parse(readFileSync(0, \'utf8\'))\n' + 'const eslint = new ESLint({ cwd, fix, overrideConfigFile: true, baseConfig: neostandard({ ts, env }) })\n' + 'process.stdout.write(JSON.stringify(await eslint.lintText(text, { filePath })))\n';
+const readEnv = cwd => {
+  try {
+    return JSON.parse(_nodeFs.default.readFileSync(_nodePath.default.join(cwd, 'package.json'), 'utf8')).standard?.env ?? [];
+  } catch {
+    return [];
+  }
+};
+const loadEslintViaSubprocess = ({
+  cwd,
+  ts,
+  fix
+}) => Promise.resolve({
+  lintText: (text, {
+    filePath
+  }) => Promise.resolve().then(() => JSON.parse((0, _nodeChild_process.execFileSync)(process.execPath, ['--input-type=module', '--eval', script], {
+    input: JSON.stringify({
+      text,
+      filePath,
+      cwd,
+      fix,
+      ts,
+      env: readEnv(cwd)
+    }),
+    encoding: 'utf8',
+    cwd,
+    maxBuffer: 256 * 1024 * 1024
+  })))
+});
+exports.loadEslintViaSubprocess = loadEslintViaSubprocess;
+const actual = jest.requireActual('../partials/neostandardLint.js');
+
+// Drop-in replacement for the partial module (see jest.mock in the lint/build tests): same API, real neostandard.
+const neostandardLint = options => actual.neostandardLint(options, loadEslintViaSubprocess);
+exports.neostandardLint = neostandardLint;

package/dist/test-helpers/setUp.js

@@ -82,6 +82,11 @@ const setDefaults = (testDir = 'test-temp') => {
   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);

package/dist/testFull.js

@@ -1,13 +1,13 @@
-'use strict'
+"use strict";
 
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
   value: true
-})
-exports.testFull = void 0
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _jest = require('jest')
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.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) }
+});
+exports.testFull = void 0;
+var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
+var _jest = require("jest");
+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); }
 /**
  * Run all tests with jest.
  * Configure where tests are located by using 'testPath'.
@@ -15,11 +15,11 @@ function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var
  * @returns {Promise<*>}
  */
 const testFull = () => {
-  let testPath = gulpConfig.get('test.path')
+  let testPath = gulpConfig.get('test.path');
   if (!Array.isArray(testPath)) {
     // The testPath must be an array of strings
-    testPath = [testPath]
+    testPath = [testPath];
   }
-  return (0, _jest.runCLI)(gulpConfig.get('test.options'), testPath)
-}
-exports.testFull = testFull
+  return (0, _jest.runCLI)(gulpConfig.get('test.options'), testPath);
+};
+exports.testFull = testFull;

package/dist/testHelpers.js

@@ -1,10 +1,10 @@
-'use strict'
+"use strict";
 
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
   value: true
-})
-exports.testHelpers = void 0
-const _testHelpers = _interopRequireWildcard(require('./test-helpers/setUp.js'))
-exports.testHelpers = _testHelpers
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.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) }
+});
+exports.testHelpers = void 0;
+var _testHelpers = _interopRequireWildcard(require("./test-helpers/setUp.js"));
+exports.testHelpers = _testHelpers;
+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); }

package/dist/testQuick.js

@@ -1,13 +1,13 @@
-'use strict'
+"use strict";
 
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
   value: true
-})
-exports.testQuick = void 0
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _jest = require('jest')
-function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; let o; let i; const f = { __proto__: null, default: e }; if (e === null || typeof e !== 'object' && typeof e !== 'function') return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f) } for (const t in e) t !== 'default' && {}.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) }
+});
+exports.testQuick = void 0;
+var gulpConfig = _interopRequireWildcard(require("../gulp.config.js"));
+var _jest = require("jest");
+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); }
 /**
  * Run the Jest tests for files which have been modified (based on git status).
  * Configure where tests are located by using 'testPath'.
@@ -15,13 +15,13 @@ function _interopRequireWildcard (e, t) { if (typeof WeakMap === 'function') var
  * @returns {Promise<*>}
  */
 const testQuick = () => {
-  let testPath = gulpConfig.get('test.path')
+  let testPath = gulpConfig.get('test.path');
   if (!Array.isArray(testPath)) {
     // The testPath must be an array of strings
-    testPath = [testPath]
+    testPath = [testPath];
   }
   return (0, _jest.runCLI)({
     onlyChanged: true
-  }, testPath)
-}
-exports.testQuick = testQuick
+  }, testPath);
+};
+exports.testQuick = testQuick;

package/dist/typeDocs.js

@@ -1,14 +1,14 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.typeDocs = void 0
-const _typeDocsFor = require('./partials/typeDocsFor.js')
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+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}
- */
-const typeDocs = exports.typeDocs = (0, _typeDocsFor.typeDocsFor)()
+ */
+const typeDocs = exports.typeDocs = (0, _typeDocsFor.typeDocsFor)();

package/dist/typeScript.js

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

package/dist/utilities/convertMjsFilesForDocs.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.convertMjsFilesForDocs = void 0;
+require("core-js/modules/esnext.iterator.constructor.js");
+require("core-js/modules/esnext.iterator.map.js");
+var _fs = _interopRequireDefault(require("fs"));
+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.
+ */
+const convertMjsFilesForDocs = (mjsFilePaths = []) => {
+  if (mjsFilePaths.length === 0) {
+    return {
+      filePaths: [],
+      cleanUp: () => {}
+    };
+  }
+  const tempDir = _fs.default.mkdtempSync(_path.default.join(_os.default.tmpdir(), 'js-build-tools-docs-'));
+  const filePaths = mjsFilePaths.map(mjsFilePath => {
+    const tempFilePath = _path.default.join(tempDir, _path.default.basename(mjsFilePath, '.js') + '.js');
+    const source = _fs.default.readFileSync(mjsFilePath, 'utf8');
+    _fs.default.writeFileSync(tempFilePath, (0, _esmNamedExportsToCjs.esmNamedExportsToCjs)(source));
+    return tempFilePath;
+  });
+  return {
+    filePaths,
+    cleanUp: () => _fs.default.rmSync(tempDir, {
+      recursive: true,
+      force: true
+    })
+  };
+};
+exports.convertMjsFilesForDocs = convertMjsFilesForDocs;