js-build-tools 4.1.1 → 5.1.0

package/dist/partials/copyFor.js

@@ -1,16 +1,19 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.copyFor = void 0;
-var _gulp = require("gulp");
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.copyFor = void 0;
+var _gulp = require("gulp");
 /**
  * Copy some files to a different location.
  * @memberOf module:partials
  * @param {string|array} srcPath
  * @param {string} destPath
  * @returns {stream.Stream}
- */
-const copyFor = (srcPath, destPath) => (0, _gulp.src)(srcPath).pipe((0, _gulp.dest)(destPath));
+ */
+// encoding: false copies the bytes untouched - Gulp 5's default utf8 handling corrupts binary files such as fonts.
+const copyFor = (srcPath, destPath) => (0, _gulp.src)(srcPath, {
+  encoding: false
+}).pipe((0, _gulp.dest)(destPath));
 exports.copyFor = copyFor;

package/dist/partials/distFor.js

@@ -1,28 +1,28 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.distFor = void 0;
-var _gulpBabel = _interopRequireDefault(require("gulp-babel"));
-var _gulp = require("gulp");
-var _distForSrc = require("./distForSrc.js");
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _through = _interopRequireDefault(require("through2"));
-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 }; }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.distFor = void 0;
+var _gulpBabel = _interopRequireDefault(require("gulp-babel"));
+var _gulp = require("gulp");
+var _distForSrc = require("./distForSrc.js");
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _through = _interopRequireDefault(require("through2"));
+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 }; }
 /**
  * Build the distribution for a given source pattern.
  * @memberOf module:partials
  * @param {string|array} [srcPath='src/config/path/dist/for']
  * @param {string} [destPath='dist/config/path']
  * @returns {stream.Stream}
- */
-const distFor = (srcPath = (0, _distForSrc.distForSrc)(), destPath = gulpConfig.get('dist.to')) => (0, _gulp.src)(srcPath).pipe((0, _gulpBabel.default)()).pipe(_through.default.obj(function (file, enc, callback) {
-  const regex = /\.mjs(['"]\s*\))/gi;
-  file.contents = Buffer.from(file.contents.toString().replaceAll(regex, '.js$1'));
-  this.push(file);
-  callback();
-})).pipe((0, _gulp.dest)(destPath));
+ */
+const distFor = (srcPath = (0, _distForSrc.distForSrc)(), destPath = gulpConfig.get('dist.to')) => (0, _gulp.src)(srcPath).pipe((0, _gulpBabel.default)()).pipe(_through.default.obj(function (file, enc, callback) {
+  const regex = /\.mjs(['"]\s*\))/gi;
+  file.contents = Buffer.from(file.contents.toString().replaceAll(regex, '.js$1'));
+  this.push(file);
+  callback();
+})).pipe((0, _gulp.dest)(destPath));
 exports.distFor = distFor;

package/dist/partials/distForSrc.js

@@ -1,17 +1,17 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.distForSrc = void 0;
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.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); }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.distForSrc = void 0;
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.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); }
 /**
  * Retrieve the correct distFor search path based on TS Config.
  * @memberOf module:partials
  * @param {module:gulpConfig~FlagStringSetting} [useTs='config/for/ts']
  * @returns {string}
- */
-const distForSrc = (useTs = gulpConfig.get('typescript.enabled')) => useTs ? gulpConfig.get('browser.from') : gulpConfig.get('dist.from');
+ */
+const distForSrc = (useTs = gulpConfig.get('typescript.enabled')) => useTs ? gulpConfig.get('browser.from') : gulpConfig.get('dist.from');
 exports.distForSrc = distForSrc;

package/dist/partials/distSeries.js

@@ -1,16 +1,16 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.distSeries = void 0;
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _distFor = require("./distFor.js");
-var _distForSrc = require("./distForSrc.js");
-var _gulp = require("gulp");
-var _tsFor = require("./tsFor.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); }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.distSeries = void 0;
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _distFor = require("./distFor.js");
+var _distForSrc = require("./distForSrc.js");
+var _gulp = require("gulp");
+var _tsFor = require("./tsFor.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); }
 /**
  * When using TypeScript, ensure that we process the ts first then run babel (dist)
  * @memberOf module:partials
@@ -18,10 +18,10 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  * @param {string} [distFinalPath='dist/config/path']
  * @param {string} [tsSearch='ts/search/config/path']
  * @returns {function(null=): stream.Stream}
- */
-const distSeries = (srcPath = (0, _distForSrc.distForSrc)(), distFinalPath = gulpConfig.get('dist.to'), tsSearch = gulpConfig.get('typescript.from')) => {
-  const typescript = (0, _tsFor.tsFor)(tsSearch, distFinalPath);
-  const dist = () => (0, _distFor.distFor)(srcPath, distFinalPath);
-  return gulpConfig.get('typescript.enabled') ? (0, _gulp.series)(typescript, dist) : dist;
-};
+ */
+const distSeries = (srcPath = (0, _distForSrc.distForSrc)(), distFinalPath = gulpConfig.get('dist.to'), tsSearch = gulpConfig.get('typescript.from')) => {
+  const typescript = (0, _tsFor.tsFor)(tsSearch, distFinalPath);
+  const dist = () => (0, _distFor.distFor)(srcPath, distFinalPath);
+  return gulpConfig.get('typescript.enabled') ? (0, _gulp.series)(typescript, dist) : dist;
+};
 exports.distSeries = distSeries;

package/dist/partials/imagesFor.js

@@ -1,28 +1,63 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.imagesFor = void 0;
-var _gulpCache = _interopRequireDefault(require("gulp-cache"));
-var _gulp = require("gulp");
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _gulpImagemin = _interopRequireDefault(require("gulp-imagemin"));
-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 }; }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.loadImagemin = exports.imagesFor = void 0;
+var _gulpCache = _interopRequireDefault(require("gulp-cache"));
+var _nodeModule = require("node:module");
+var _gulp = require("gulp");
+var _nodePath = _interopRequireDefault(require("node:path"));
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.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); }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const installHint = 'Add it to your project with: npm install --save-dev github:jheagle/gulp-imagemin#common-js-compatibility ' + '(the CommonJS-compatible fork - upstream gulp-imagemin is ESM-only and cannot be require()d by this package\'s CommonJS build).';
+
+/**
+ * Load `gulp-imagemin`, an optional peer dependency: image optimization is off by default and its binary-download
+ * dependency chain is heavy, so it is only required once the images task actually runs, and it is resolved from the
+ * consuming project's own directory rather than from this package.
+ * @memberOf module:partials
+ * @param {string} [projectPath=process.cwd()] - The project directory to resolve `gulp-imagemin` from.
+ * @returns {Function} The gulp-imagemin plugin factory.
+ * @throws {Error} With install instructions when gulp-imagemin is missing or is the ESM-only upstream release.
+ */
+const loadImagemin = (projectPath = process.cwd()) => {
+  let loaded;
+  try {
+    loaded = (0, _nodeModule.createRequire)(_nodePath.default.join(projectPath, 'package.json'))('gulp-imagemin');
+  } catch (error) {
+    if (error.code === 'MODULE_NOT_FOUND' && /Cannot find module 'gulp-imagemin'/.test(error.message)) {
+      throw new Error(`The images task needs the optional peer dependency gulp-imagemin, which is not installed. ${installHint}`);
+    }
+    if (error.code === 'ERR_REQUIRE_ESM') {
+      throw new Error(`gulp-imagemin could not be loaded because it is ESM-only. ${installHint}`);
+    }
+    throw error;
+  }
+  return loaded && (loaded.__esModule || loaded.default) ? loaded.default : loaded;
+};
+
 /**
  * Move and optimize images into the browser directory.
  * @memberOf module:partials
  * @param {string|array} [imageSrc=src/images/pattern]
  * @param {string} [imageDest=dest/image/folder]
  * @return {stream.Stream}
- */
-const imagesFor = (imageSrc = gulpConfig.get('images.from'), imageDest = gulpConfig.get('images.to')) => (0, _gulp.src)(imageSrc).pipe(
-// Caching images that ran through imagemin
-(0, _gulpCache.default)((0, _gulpImagemin.default)({
-  interlaced: true,
-  silent: true,
-  verbose: false
-}))).pipe((0, _gulp.dest)(imageDest));
+ */
+exports.loadImagemin = loadImagemin;
+const imagesFor = (imageSrc = gulpConfig.get('images.from'), imageDest = gulpConfig.get('images.to')) => {
+  const imagemin = loadImagemin();
+  // Gulp 5 reads files as utf8 text unless told otherwise, which corrupts binary images (and makes gulp-cache drop them).
+  return (0, _gulp.src)(imageSrc, {
+    encoding: false
+  }).pipe(
+  // Caching images that ran through imagemin
+  (0, _gulpCache.default)(imagemin({
+    interlaced: true,
+    silent: true,
+    verbose: false
+  }))).pipe((0, _gulp.dest)(imageDest));
+};
 exports.imagesFor = imagesFor;

package/dist/partials/minifyFor.js

@@ -1,21 +1,21 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.minifyFor = void 0;
-var _gulp = require("gulp");
-var _gulpUglifyEs = _interopRequireDefault(require("gulp-uglify-es"));
-var _gulpRename = _interopRequireDefault(require("gulp-rename"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-const uglify = _gulpUglifyEs.default.hasOwnProperty('default') ? _gulpUglifyEs.default.default : _gulpUglifyEs.default;
-
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.minifyFor = void 0;
+var _gulp = require("gulp");
+var _gulpUglifyEs = _interopRequireDefault(require("gulp-uglify-es"));
+var _gulpRename = _interopRequireDefault(require("gulp-rename"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const uglify = _gulpUglifyEs.default.hasOwnProperty('default') ? _gulpUglifyEs.default.default : _gulpUglifyEs.default;
+
 /**
  * Minify files and rename the output with '.min' extension.
  * @memberOf module:partials
  * @returns {*}
- */
-const minifyFor = (srcSearch, destination) => (0, _gulp.src)(srcSearch).pipe(uglify()).pipe((0, _gulpRename.default)({
-  extname: '.min.js'
-})).pipe((0, _gulp.dest)(destination));
+ */
+const minifyFor = (srcSearch, destination) => (0, _gulp.src)(srcSearch).pipe(uglify()).pipe((0, _gulpRename.default)({
+  extname: '.min.js'
+})).pipe((0, _gulp.dest)(destination));
 exports.minifyFor = minifyFor;

package/dist/partials/readmeTemplate.js

@@ -1,19 +1,19 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.readmeTemplate = void 0;
-var _gulp = require("gulp");
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _gulpRename = _interopRequireDefault(require("gulp-rename"));
-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.readmeTemplate = void 0;
+var _gulp = require("gulp");
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _gulpRename = _interopRequireDefault(require("gulp-rename"));
+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); }
 /**
  * Copy a readme template into the README.md file.
  * @memberOf module:partials
  * @returns {*}
- */
-const readmeTemplate = () => (0, _gulp.src)(gulpConfig.get('readme.template')).pipe((0, _gulpRename.default)(gulpConfig.get('readme.file'))).pipe((0, _gulp.dest)(gulpConfig.get('readme.to')));
+ */
+const readmeTemplate = () => (0, _gulp.src)(gulpConfig.get('readme.template')).pipe((0, _gulpRename.default)(gulpConfig.get('readme.file'))).pipe((0, _gulp.dest)(gulpConfig.get('readme.to')));
 exports.readmeTemplate = readmeTemplate;

package/dist/partials/removeDirectory.js

@@ -1,17 +1,41 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.removeDirectory = void 0;
-var _fs = require("fs");
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.removeDirectory = void 0;
+var _promises = require("node:fs/promises");
+var _promises2 = require("node:timers/promises");
+const attempts = 4;
+const exists = dirPath => (0, _promises.access)(dirPath).then(() => true, () => false);
+
 /**
- * Return a promise to be completed once the specified directory is deleted.
+ * Delete a directory and everything in it, resolving only once it is really gone.
+ *
+ * A single rm can leave a directory behind - most often when something is still writing into it (a build task, a
+ * watcher, a dev server) or has it briefly locked (EBUSY/EPERM/ENOTEMPTY) - which silently leaves stale output for
+ * the next build. So: Node's own retry-with-back-off handles the transient errors, then the directory is checked and
+ * removed again if it was recreated, and a clear error is raised rather than carrying on with stale output.
  * @memberOf module:partials
  * @param {string} dirPath
- * @returns {Promise<*>}
- */
-const removeDirectory = dirPath => new Promise((resolve, reject) => (0, _fs.exists)(dirPath, doesExist => doesExist ? (0, _fs.rm)(dirPath, {
-  recursive: true
-}, error => error ? reject(error) : resolve(dirPath)) : resolve(dirPath)));
+ * @returns {Promise<string>} Resolves with dirPath once the directory no longer exists (or already didn't).
+ * @throws {Error} If the directory still exists after several attempts.
+ */
+const removeDirectory = async dirPath => {
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    await (0, _promises.rm)(dirPath, {
+      recursive: true,
+      force: true,
+      maxRetries: 5,
+      retryDelay: 100
+    });
+    if (!(await exists(dirPath))) {
+      return dirPath;
+    }
+    if (attempt < attempts) {
+      await (0, _promises2.setTimeout)(200 * attempt);
+    }
+  }
+  throw new Error(`Unable to remove "${dirPath}" - it was recreated or is locked. Stop anything that has it open or is writing ` + 'into it (watchers, dev servers, editors, other build tasks) and try again.');
+};
 exports.removeDirectory = removeDirectory;

package/dist/partials/runOnChange.js

@@ -1,16 +1,16 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.runOnChange = void 0;
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _bundle = require("../bundle.js");
-var _distSeries = require("./distSeries.js");
-var _gulp = require("gulp");
-var _testQuick = require("../testQuick.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); }
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.runOnChange = void 0;
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _bundle = require("../bundle.js");
+var _distSeries = require("./distSeries.js");
+var _gulp = require("gulp");
+var _testQuick = require("../testQuick.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); }
 /**
  * Run this function when the watched files are modified.
  * 1. Find the sub-folders within src path
@@ -35,11 +35,11 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  * @memberOf module:partials
  * @param {string} path
  * @returns {stream.Stream}
- */
-const runOnChange = path => {
-  const useTs = gulpConfig.get('typescript.enabled');
-  const distPath = gulpConfig.get('dist.to');
-  const srcPath = gulpConfig.get('srcPath');
+ */
+const runOnChange = path => {
+  const useTs = gulpConfig.get('typescript.enabled');
+  const distPath = gulpConfig.get('dist.to');
+  const srcPath = gulpConfig.get('srcPath');
   /**
    * 1. The original path comes in from src and is a .ts
    * 2. Discover the outgoing dist path where that file should go
@@ -47,14 +47,14 @@ const runOnChange = path => {
    * 4. Take the original path, convert to full file path in dist
    * 5. Use the dist path found previously in #2
    * 6. Use the full dist path and the dist outgoing path in distFor
-   */
-  const pathRegex = new RegExp(`^${srcPath}(.*\\/)(.+)\\.(js|ts)$`, 'i');
-  const distPathResult = path.replace(pathRegex, `${distPath}$1`);
-  let distSrcPath = path;
-  if (useTs) {
-    distSrcPath = path.replace(pathRegex, `${distPath}$1$2.js`);
-  }
-  const runSeries = (0, _distSeries.distSeries)(distSrcPath, distPathResult, path);
-  return gulpConfig.get('browser.enabled') ? (0, _gulp.parallel)(_testQuick.testQuick, (0, _gulp.series)(runSeries, _bundle.bundle))() : (0, _gulp.series)(_testQuick.testQuick, runSeries)();
-};
+   */
+  const pathRegex = new RegExp(`^${srcPath}(.*\\/)(.+)\\.(js|ts)$`, 'i');
+  const distPathResult = path.replace(pathRegex, `${distPath}$1`);
+  let distSrcPath = path;
+  if (useTs) {
+    distSrcPath = path.replace(pathRegex, `${distPath}$1$2.js`);
+  }
+  const runSeries = (0, _distSeries.distSeries)(distSrcPath, distPathResult, path);
+  return gulpConfig.get('browser.enabled') ? (0, _gulp.parallel)(_testQuick.testQuick, (0, _gulp.series)(runSeries, _bundle.bundle))() : (0, _gulp.series)(_testQuick.testQuick, runSeries)();
+};
 exports.runOnChange = runOnChange;

package/dist/partials/sassFor.js

@@ -1,29 +1,35 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.sassFor = void 0;
-var _gulp = require("gulp");
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _gulpCssnano = _interopRequireDefault(require("gulp-cssnano"));
-var _gulpRename = _interopRequireDefault(require("gulp-rename"));
-var sass = _interopRequireWildcard(require("sass"));
-var _gulpSass = _interopRequireDefault(require("gulp-sass"));
-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); }
-const runSass = (0, _gulpSass.default)(sass);
-
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sassFor = void 0;
+var _gulp = require("gulp");
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _autoprefixer = _interopRequireDefault(require("autoprefixer"));
+var _cssnano = _interopRequireDefault(require("cssnano"));
+var _gulpPostcss = _interopRequireDefault(require("gulp-postcss"));
+var _gulpRename = _interopRequireDefault(require("gulp-rename"));
+var sass = _interopRequireWildcard(require("sass"));
+var _gulpSass = _interopRequireDefault(require("gulp-sass"));
+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); }
+const runSass = (0, _gulpSass.default)(sass);
+
 /**
  * Build the CSS for a given source pattern.
  * @memberOf module:partials
  * @param {string|array} [srcSearch='src/config/path/sass/for']
  * @param {string} [cssPath='css/config/path']
  * @returns {stream.Stream}
- */
-const sassFor = (srcSearch = gulpConfig.get('sass.from'), cssPath = gulpConfig.get('sass.to')) => (0, _gulp.src)(srcSearch).pipe(runSass().on('error', runSass.logError)) // Passes it through a gulp-sass, log errors to console
-.pipe((0, _gulp.dest)(cssPath)).pipe((0, _gulpCssnano.default)()).pipe((0, _gulpRename.default)({
-  extname: '.min.css'
-})).pipe((0, _gulp.dest)(cssPath));
+ */
+const sassFor = (srcSearch = gulpConfig.get('sass.from'), cssPath = gulpConfig.get('sass.to')) => (0, _gulp.src)(srcSearch).pipe(runSass().on('error', runSass.logError)) // Passes it through a gulp-sass, log errors to console
+.pipe((0, _gulp.dest)(cssPath))
+// add: false - the old gulp-cssnano only ever removed obsolete vendor prefixes, never added any; keep that.
+.pipe((0, _gulpPostcss.default)([(0, _autoprefixer.default)({
+  add: false
+}), (0, _cssnano.default)()])).pipe((0, _gulpRename.default)({
+  extname: '.min.css'
+})).pipe((0, _gulp.dest)(cssPath));
 exports.sassFor = sassFor;

package/dist/partials/standardLint.js

@@ -0,0 +1,96 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.standardLint = void 0;
+require("core-js/modules/esnext.iterator.constructor.js");
+require("core-js/modules/esnext.iterator.for-each.js");
+var _nodePath = _interopRequireDefault(require("node:path"));
+var _through = _interopRequireDefault(require("through2"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// `standard` (17+) ships ESM-only, but this package also publishes a CommonJS build (dist/*.js) whose babel
+// transform would turn even a dynamic import() into a require() that cannot load an ES module. Hiding the import()
+// inside a Function constructor keeps it a genuine dynamic import that works from either build (same escape hatch
+// as tsFor.mjs uses for gulp-ts-compile).
+const importStandard = new Function('return import(\'standard\')');
+
+/**
+ * Print a file's lint messages, if it has any.
+ * @memberOf module:partials
+ * @param {import('vinyl')} file
+ * @param {{messages: Array<{line: number, column: number, message: string}>, errorCount: number, warningCount: number}} result
+ * @returns {undefined}
+ */
+const printFileReport = (file, result) => {
+  if (!result.messages.length) {
+    return;
+  }
+  console.log(_nodePath.default.relative(file.cwd, file.path));
+  result.messages.forEach(({
+    line,
+    column,
+    message
+  }) => console.log(`line ${line}:${column}\t${message}`));
+  console.log(`✖ ${result.errorCount} error\t⚠ ${result.warningCount} warning\n`);
+};
+
+/**
+ * Lint every file streaming through with JavaScript Standard Style and, unless `fix` is false, apply the automatic
+ * fixes to the file's contents so a following `dest()` writes the fixed version. Remaining problems are printed
+ * along with a summary once the stream ends; they never fail the build.
+ *
+ * Project-level Standard configuration (the `standard` field in package.json: ignore, env, globals, ...) is honored
+ * because the file's own path and cwd are handed to Standard.
+ * @memberOf module:partials
+ * @param {Object} [options={}]
+ * @param {boolean} [options.fix=true] - Apply Standard's automatic fixes to the file contents.
+ * @param {function(): Promise<{lintText: Function}>} [loadStandard] - Resolves the `standard` module. Real callers
+ * should never need to pass this - it exists so tests can supply a stand-in, since this project's
+ * CommonJS-transform-based Jest setup cannot execute a real dynamic import() of an ES module.
+ * @returns {import('stream').Transform}
+ */
+const standardLint = ({
+  fix = true
+} = {}, loadStandard = () => importStandard().then(({
+  default: standard
+}) => standard)) => {
+  const totals = {
+    errors: 0,
+    warnings: 0
+  };
+  return _through.default.obj(function (file, enc, callback) {
+    if (file.isNull()) {
+      callback(null, file);
+      return;
+    }
+    if (file.isStream()) {
+      callback(new Error('standardLint: streaming file contents are not supported.'));
+      return;
+    }
+    loadStandard().then(standard => standard.lintText(file.contents.toString(), {
+      filename: file.path,
+      cwd: file.cwd,
+      fix
+    })).then(results => {
+      // No result at all means the file is ignored by the project's Standard configuration.
+      const [result] = results;
+      if (result) {
+        if (typeof result.output === 'string') {
+          file.contents = Buffer.from(result.output);
+        }
+        totals.errors += result.errorCount;
+        totals.warnings += result.warningCount;
+        printFileReport(file, result);
+      }
+      callback(null, file);
+    }, callback);
+  }, function (callback) {
+    console.log('Standard linter results');
+    console.log('======================================');
+    console.log(`✖ Errors total: ${totals.errors}`);
+    console.log(`⚠ Warnings total: ${totals.warnings}\n`);
+    callback();
+  });
+};
+exports.standardLint = standardLint;