js-build-tools 6.7.0 → 6.8.0

package/README.md

@@ -86,6 +86,8 @@ provided are the defaults):
     "to": "browser/fonts"
   },
   "images": {
+    // Where optimized images are cached between runs (an unchanged image isn't optimized again)
+    "cacheDir": "node_modules/.cache/js-build-tools/images",
     // Toggle image minify and copy process
     "enabled": false,
     // Path to search for images
@@ -437,6 +439,9 @@ Add the following to the exports in your `build-tools.config.json`:
 ```json
 {
   "images": {
+    // Where optimized images are cached between runs, so an image that hasn't changed isn't optimized again. Inside
+    // node_modules by default, so it's never committed; delete the folder to start over
+    "cacheDir": "node_modules/.cache/js-build-tools/images",
     // Enable image process
     "enabled": false,
     // Search pattern to find your images
@@ -1114,6 +1119,7 @@ Configurations to minify and copy the images.
 
 | Name | Type | Description |
 | --- | --- | --- |
+| cacheDir | <code>StringSetting</code> | Where optimized images are cached between runs, so an image that hasn't changed isn't optimized again. An upgrade of imagemin (or its plugins) or other settings starts new results. Inside node_modules by default, so it's never committed; old entries aren't pruned, so delete it now and then to start over. |
 | enabled | <code>BooleanSetting</code> | Toggle image minify and copy process. |
 | from | <code>StringSetting</code> | Path to search for images. |
 | jpegQuality | <code>FlagNumberSetting</code> | The JPEG quality (0 to 100) mozjpeg compresses to. False (the default) keeps mozjpeg's own default, 75. Raise it (85 is usually indistinguishable from the original) when 75 visibly bands smooth gradients. |

package/dist/partials/cacheFiles.js

@@ -0,0 +1,121 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.cacheFiles = void 0;
+var _crypto = require("crypto");
+var _promises = require("fs/promises");
+var _path = _interopRequireDefault(require("path"));
+var _stream = require("stream");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// Marks a file sent to the plugin with its cache file and its path, so its result is cached even if the plugin renames it
+const cacheFile = Symbol('cacheFile');
+
+/**
+ * The cache file for a file's contents: a hash of the cache name, the fingerprint and the contents, so the same file
+ * with other plugin settings or plugin versions gets a result of its own.
+ * @private
+ * @param {string} directory
+ * @param {string} name
+ * @param {string} fingerprint
+ * @param {Buffer} contents
+ * @returns {string}
+ */
+const cachePath = (directory, name, fingerprint, contents) => _path.default.join(directory, name, (0, _crypto.createHash)('sha256').update(name).update('\0').update(fingerprint).update('\0').update(contents).digest('hex'));
+
+/**
+ * Write through a temporary file and rename it, so a reader (another build or test worker) never sees a half-written
+ * result.
+ * @private
+ * @param {string} file
+ * @param {Buffer} contents
+ * @returns {Promise<void>}
+ */
+const writeAtomic = async (file, contents) => {
+  await (0, _promises.mkdir)(_path.default.dirname(file), {
+    recursive: true
+  });
+  const temporary = `${file}.${(0, _crypto.randomUUID)()}.tmp`;
+  await (0, _promises.writeFile)(temporary, contents);
+  await (0, _promises.rename)(temporary, file);
+};
+
+/**
+ * Run a gulp plugin only on files it hasn't processed before. A file whose contents (with this cache name and
+ * fingerprint) were processed by an earlier run gets that run's result from the cache instead, and skips the plugin.
+ * Replaces gulp-cache, which kept one cache for every process in the system's temp folder.
+ *
+ * A result is cached when the plugin passes on the file object it was given (as gulp plugins usually do); a plugin
+ * that makes new file objects still works, its results just aren't cached. When the plugin renames a file, the cache
+ * keeps the new name too (next to the result, as `<entry>.path`), so a cached file is renamed the same way. Entries
+ * are never pruned: delete the directory to start over.
+ * @memberOf module:partials
+ * @param {stream.Transform} plugin - The gulp plugin stream to run on uncached files (e.g. imagemin()).
+ * @param {Object} options
+ * @param {string} options.directory - Where cached results are kept (see images.cacheDir).
+ * @param {string} [options.name='default'] - The cache's folder; keeps results of different plugin settings apart.
+ * @param {string} [options.fingerprint=''] - Anything else that changes the plugin's output, such as its version and
+ * options: when it changes, earlier results are no longer used.
+ * @returns {stream.Transform}
+ */
+const cacheFiles = (plugin, {
+  directory,
+  name = 'default',
+  fingerprint = ''
+}) => {
+  const writes = [];
+  const pluginDone = new Promise((resolve, reject) => {
+    plugin.on('end', resolve);
+    plugin.on('error', reject);
+  });
+  // The error also reaches the stream (below); this only stops it from being reported a second time as unhandled
+  pluginDone.catch(() => {});
+  const stream = new _stream.Transform({
+    objectMode: true,
+    transform(file, encoding, callback) {
+      if (!file.isBuffer()) {
+        callback(null, file);
+        return;
+      }
+      const cached = cachePath(directory, name, fingerprint, file.contents);
+      (0, _promises.readFile)(cached).then(async contents => {
+        file.contents = contents;
+        // Written before the result, so it's there whenever the result is
+        const renamed = await (0, _promises.readFile)(`${cached}.path`, 'utf8').catch(() => undefined);
+        if (renamed !== undefined) {
+          file.path = _path.default.join(_path.default.dirname(file.path), renamed);
+        }
+        callback(null, file);
+      }, () => {
+        file[cacheFile] = {
+          cached,
+          from: file.path
+        };
+        plugin.write(file);
+        callback();
+      });
+    },
+    flush(callback) {
+      plugin.end();
+      pluginDone.then(() => Promise.all(writes)).then(() => callback(), callback);
+    }
+  });
+  plugin.on('data', file => {
+    const tag = file[cacheFile];
+    delete file[cacheFile];
+    if (tag && file.isBuffer()) {
+      const {
+        cached,
+        from
+      } = tag;
+      const renamed = file.path === from ? Promise.resolve() : writeAtomic(`${cached}.path`, _path.default.relative(_path.default.dirname(from), file.path));
+      // The cache only saves time: a result that can't be written is processed again next run, not a failed build
+      writes.push(renamed.then(() => writeAtomic(cached, file.contents)).catch(() => {}));
+    }
+    stream.push(file);
+  });
+  plugin.on('error', error => stream.destroy(error));
+  return stream;
+};
+exports.cacheFiles = cacheFiles;

package/dist/partials/imagesFor.js

@@ -4,8 +4,11 @@ require("core-js/modules/esnext.weak-map.delete-all.js");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.loadImageminPlugins = exports.loadImagemin = exports.imagesFor = exports.imageminPlugins = void 0;
-var _gulpCache = _interopRequireDefault(require("gulp-cache"));
+exports.loadImageminPlugins = exports.loadImagemin = exports.imagesFor = exports.imageminVersions = exports.imageminPlugins = void 0;
+require("core-js/modules/es.json.stringify.js");
+var _fs = require("fs");
+var _path = _interopRequireDefault(require("path"));
+var _cacheFiles = require("./cacheFiles.js");
 var _loadPeer = require("./loadPeer.js");
 var _gulp = require("gulp");
 var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
@@ -63,6 +66,59 @@ const imageminPlugins = (jpegQuality, plugins = loadImageminPlugins()) => defaul
   quality: jpegQuality
 }) : makePlugin()));
 
+// The packages that decide imagemin's output: the wrapper and imagemin, then each plugin with the engine it runs
+exports.imageminPlugins = imageminPlugins;
+const imageminPackages = [['gulp-imagemin'], ['imagemin'], ['imagemin-gifsicle', 'gifsicle'], ['imagemin-mozjpeg', 'mozjpeg'], ['imagemin-optipng', 'optipng-bin'], ['imagemin-svgo', 'svgo']];
+
+/**
+ * Find an installed package the way Node does, from a directory up through each node_modules folder. Reads the
+ * package.json directly, so it also works for ESM-only packages that don't export it.
+ * @private
+ * @param {string} name
+ * @param {string} fromDirectory
+ * @returns {{directory: string, version: string}|undefined}
+ */
+const findPackage = (name, fromDirectory) => {
+  for (let directory = _path.default.resolve(fromDirectory);; directory = _path.default.dirname(directory)) {
+    const file = _path.default.join(directory, 'node_modules', name, 'package.json');
+    if ((0, _fs.existsSync)(file)) {
+      return {
+        directory: _path.default.dirname(file),
+        version: JSON.parse((0, _fs.readFileSync)(file, 'utf8')).version
+      };
+    }
+    if (directory === _path.default.dirname(directory)) {
+      return undefined;
+    }
+  }
+};
+
+/**
+ * The installed versions of the packages that decide imagemin's output, so the image cache stops using results made
+ * by older versions after an upgrade (see images.cacheDir).
+ * @memberOf module:partials
+ * @param {string} [projectPath=process.cwd()] - The project directory gulp-imagemin is installed in.
+ * @returns {Object<string, string>} Each package's version by name; a package that isn't installed is left out.
+ */
+const imageminVersions = (projectPath = process.cwd()) => {
+  const gulpImagemin = findPackage('gulp-imagemin', projectPath);
+  const versions = {};
+  if (!gulpImagemin) {
+    return versions;
+  }
+  for (const [wrapper, engine] of imageminPackages) {
+    const found = findPackage(wrapper, gulpImagemin.directory);
+    if (found) {
+      versions[wrapper] = found.version;
+      const engineFound = engine && findPackage(engine, found.directory);
+      if (engineFound) {
+        versions[engine] = engineFound.version;
+      }
+    }
+  }
+  return versions;
+};
+
 /**
  * Move and optimize images into the browser directory.
  * @memberOf module:partials
@@ -70,25 +126,31 @@ const imageminPlugins = (jpegQuality, plugins = loadImageminPlugins()) => defaul
  * @param {string} [imageDest=dest/image/folder]
  * @return {stream.Stream}
  */
-exports.imageminPlugins = imageminPlugins;
+exports.imageminVersions = imageminVersions;
 const imagesFor = (imageSrc = gulpConfig.get('images.from'), imageDest = gulpConfig.get('images.to')) => {
   const imagemin = loadImagemin();
   const jpegQuality = gulpConfig.get('images.jpegQuality');
   // Left unset, imagemin runs its default plugins with their own defaults
   const plugins = jpegQuality ? imageminPlugins(jpegQuality) : undefined;
-  // 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(plugins, {
+  const options = {
     interlaced: true,
     silent: true,
     verbose: false
-  }),
-  // gulp-cache keys on the file's contents alone, so keep each quality's results apart
-  {
-    name: jpegQuality ? `jpeg-quality-${jpegQuality}` : 'default'
+  };
+  // Gulp 5 reads files as utf8 text unless told otherwise, which corrupts binary images.
+  return (0, _gulp.src)(imageSrc, {
+    encoding: false
+  }).pipe(
+  // Only images imagemin hasn't optimized before go through it; the rest come from the cache
+  (0, _cacheFiles.cacheFiles)(imagemin(plugins, options), {
+    directory: gulpConfig.get('images.cacheDir'),
+    // Each quality gets results of its own
+    name: jpegQuality ? `jpeg-quality-${jpegQuality}` : 'default',
+    // A new imagemin (or plugin, or engine) version, or other options, makes new results
+    fingerprint: JSON.stringify({
+      options,
+      versions: imageminVersions()
+    })
   })).pipe((0, _gulp.dest)(imageDest));
 };
 exports.imagesFor = imagesFor;

package/dist/partials/jsdocDocsFor.js

@@ -122,7 +122,15 @@ const jsdocDocsFor = (srcPath = gulpConfig.get('docs.from'), outPath = gulpConfi
       const themeDir = resolveJsdocTheme(theme);
       const indexFile = gulpConfig.get('docs.index');
       const title = gulpConfig.get('docs.title');
+      const basePath = gulpConfig.get('docs.basePath');
       await (0, _removeDirectory.removeDirectory)(outPath);
+      const workDir = _nodeFs.default.mkdtempSync(_nodePath.default.join(_nodeOs.default.tmpdir(), 'jsdocdocs-'));
+      // clean-jsdoc-theme 5.x writes no index.html at all without a front page, so fall back to one with the title
+      let readme = indexFile && _nodeFs.default.existsSync(indexFile) ? _nodePath.default.resolve(indexFile) : '';
+      if (!readme) {
+        readme = _nodePath.default.join(workDir, 'index.md');
+        _nodeFs.default.writeFileSync(readme, `# ${title || 'Documentation'}\n`);
+      }
       const config = {
         ..._jsdocBase.default,
         source: {
@@ -136,21 +144,26 @@ const jsdocDocsFor = (srcPath = gulpConfig.get('docs.from'), outPath = gulpConfi
           // quick-start example, which sets this explicitly, not assumed from jsdoc's own classic defaults.
           recurse: true,
           template: themeDir,
-          // clean-jsdoc-theme's own options for the name in its header and the home page's <title> (otherwise "Home").
+          // clean-jsdoc-theme 4.x's own options for the name in its header and the home page's <title> (otherwise "Home").
           // The header is given as a link: a plain-text title links to the site root ("/"), while every page is in one
           // folder, so index.html is the home page wherever they are served. Both are printed unescaped by the theme.
+          // clean-jsdoc-theme 5.x reads its options from opts itself: the name in its header and <title>, and the path
+          // its root-absolute links start from (4.x reads only theme_opts).
+          ...(title ? {
+            siteName: title
+          } : {}),
+          ...(basePath ? {
+            basePath
+          } : {}),
           ...(title ? {
             theme_opts: {
               title: `<a href="index.html" class="sidebar-title sidebar-title-anchor">${escapeHtml(title)}</a>`,
               homepageTitle: escapeHtml(title)
             }
           } : {}),
-          ...(indexFile && _nodeFs.default.existsSync(indexFile) ? {
-            readme: _nodePath.default.resolve(indexFile)
-          } : {})
+          readme
         }
       };
-      const workDir = _nodeFs.default.mkdtempSync(_nodePath.default.join(_nodeOs.default.tmpdir(), 'jsdocdocs-'));
       try {
         const configPath = _nodePath.default.join(workDir, 'jsdoc.conf.json');
         _nodeFs.default.writeFileSync(configPath, JSON.stringify(config));

package/dist/partials.js

@@ -15,6 +15,12 @@ Object.defineProperty(exports, "beginWatcher", {
     return _beginWatcher.beginWatcher;
   }
 });
+Object.defineProperty(exports, "cacheFiles", {
+  enumerable: true,
+  get: function () {
+    return _cacheFiles.cacheFiles;
+  }
+});
 Object.defineProperty(exports, "clean", {
   enumerable: true,
   get: function () {
@@ -155,6 +161,7 @@ Object.defineProperty(exports, "typeDocsFor", {
 });
 var _addToReadme = require("./partials/addToReadme.js");
 var _beginWatcher = require("./partials/beginWatcher.js");
+var _cacheFiles = require("./partials/cacheFiles.js");
 var _clean = require("./partials/clean.js");
 var _copyFor = require("./partials/copyFor.js");
 var _distFor = require("./partials/distFor.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,"jsdocDocsFor",{enumerable:!0,get:function(){return _jsdocDocsFor.jsdocDocsFor}}),Object.defineProperty(exports,"launchBrowser",{enumerable:!0,get:function(){return _loadPlaywright.launchBrowser}}),Object.defineProperty(exports,"lintSource",{enumerable:!0,get:function(){return _lintSource.lintSource}}),Object.defineProperty(exports,"loadPlaywright",{enumerable:!0,get:function(){return _loadPlaywright.loadPlaywright}}),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,"resolveDocsMethod",{enumerable:!0,get:function(){return _resolveDocsMethod.resolveDocsMethod}}),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,"serveStatic",{enumerable:!0,get:function(){return _serveStatic.serveStatic}}),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"),_jsdocDocsFor=require("./partials/jsdocDocsFor.js"),_loadPlaywright=require("./partials/loadPlaywright.js"),_lintSource=require("./partials/lintSource.js"),_minifyFor=require("./partials/minifyFor.js"),_neostandardLint=require("./partials/neostandardLint.js"),_readmeTemplate=require("./partials/readmeTemplate.js"),_removeDirectory=require("./partials/removeDirectory.js"),_resolveDocsMethod=require("./partials/resolveDocsMethod.js"),_runOnChange=require("./partials/runOnChange.js"),_sassFor=require("./partials/sassFor.js"),_serveStatic=require("./partials/serveStatic.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,"cacheFiles",{enumerable:!0,get:function(){return _cacheFiles.cacheFiles}}),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,"jsdocDocsFor",{enumerable:!0,get:function(){return _jsdocDocsFor.jsdocDocsFor}}),Object.defineProperty(exports,"launchBrowser",{enumerable:!0,get:function(){return _loadPlaywright.launchBrowser}}),Object.defineProperty(exports,"lintSource",{enumerable:!0,get:function(){return _lintSource.lintSource}}),Object.defineProperty(exports,"loadPlaywright",{enumerable:!0,get:function(){return _loadPlaywright.loadPlaywright}}),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,"resolveDocsMethod",{enumerable:!0,get:function(){return _resolveDocsMethod.resolveDocsMethod}}),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,"serveStatic",{enumerable:!0,get:function(){return _serveStatic.serveStatic}}),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"),_cacheFiles=require("./partials/cacheFiles.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"),_jsdocDocsFor=require("./partials/jsdocDocsFor.js"),_loadPlaywright=require("./partials/loadPlaywright.js"),_lintSource=require("./partials/lintSource.js"),_minifyFor=require("./partials/minifyFor.js"),_neostandardLint=require("./partials/neostandardLint.js"),_readmeTemplate=require("./partials/readmeTemplate.js"),_removeDirectory=require("./partials/removeDirectory.js"),_resolveDocsMethod=require("./partials/resolveDocsMethod.js"),_runOnChange=require("./partials/runOnChange.js"),_sassFor=require("./partials/sassFor.js"),_serveStatic=require("./partials/serveStatic.js"),_tsFor=require("./partials/tsFor.js"),_typeDocsFor=require("./partials/typeDocsFor.js");

package/dist/test-helpers/setUp.js

@@ -84,6 +84,8 @@ const setDefaults = (testDir = 'test-temp') => {
   gulpConfig.set('docs.title', '');
   gulpConfig.set('fonts.from', `${srcPath}/fonts/**/*`);
   gulpConfig.set('fonts.to', `${browserPath}/fonts`);
+  // Each test file's own cache, inside its temp directory, so beforeEach's fresh directory is also an empty cache
+  gulpConfig.set('images.cacheDir', `${tempDir}image-cache`);
   gulpConfig.set('images.from', `${srcPath}/img/**/*.+(png|jpg|jpeg|gif|svg)`);
   gulpConfig.set('images.to', `${browserPath}/img`);
   gulpConfig.set('readme.template', `${tempDir}MAIN.md`);

package/functions/build.test.mjs

@@ -8,10 +8,8 @@ import { testFull } from './testFull.mjs'
 import { typeDocs } from './typeDocs.mjs'
 import { jsdocDocs } from './jsdocDocs.mjs'
 import { countMatches } from 'test-filesystem'
-import { isolateGulpCache } from './test-helpers/isolateGulpCache.mjs'
 
 setUp.setDefaults('test-build')
-const clearImageCache = isolateGulpCache('build')
 const gulpConfig = setUp.gulpConfig
 
 const genericFunction = () => Promise.resolve(true)
@@ -255,10 +253,9 @@ const sassContents = 'html\n' +
 
 const sassPath = gulpConfig.get('sass.path')
 
-// The cache outlives a run, so clear it or a stale result from an older imagemin can pass
+// A fresh temp directory each test, which is also an empty image cache (see setUp's images.cacheDir)
 beforeEach(
-  () => clearImageCache()
-    .then(setUp.beforeEach)
+  () => setUp.beforeEach()
     .then(
       async () => {
         const srcPath = gulpConfig.get('srcPath')

package/functions/images.test.mjs

@@ -1,10 +1,8 @@
 import fs from 'fs'
 import * as setUp from './test-helpers/setUp.mjs'
 import { images } from './images.mjs'
-import { isolateGulpCache } from './test-helpers/isolateGulpCache.mjs'
 
 setUp.setDefaults('test-images')
-const clearImageCache = isolateGulpCache('images')
 const gulpConfig = setUp.gulpConfig
 
 const imageContents = '<?xml version="1.0" encoding="UTF-8" standalone="no"?>\n' +
@@ -116,8 +114,8 @@ const imageContents = '<?xml version="1.0" encoding="UTF-8" standalone="no"?>\n'
   '     inkscape:connector-curvature="0" />\n' +
   '</svg>\n'
 
-// The cache outlives a run, so clear it or a stale result from an older imagemin can pass
-beforeEach(() => clearImageCache().then(setUp.beforeEach))
+// A fresh temp directory each test, which is also an empty image cache (see setUp's images.cacheDir)
+beforeEach(() => setUp.beforeEach())
 
 afterEach(setUp.afterEach)
 

package/functions/partials/cacheFiles.mjs

@@ -0,0 +1,114 @@
+import { createHash, randomUUID } from 'crypto'
+import { mkdir, readFile, rename, writeFile } from 'fs/promises'
+import path from 'path'
+import { Transform } from 'stream'
+
+// Marks a file sent to the plugin with its cache file and its path, so its result is cached even if the plugin renames it
+const cacheFile = Symbol('cacheFile')
+
+/**
+ * The cache file for a file's contents: a hash of the cache name, the fingerprint and the contents, so the same file
+ * with other plugin settings or plugin versions gets a result of its own.
+ * @private
+ * @param {string} directory
+ * @param {string} name
+ * @param {string} fingerprint
+ * @param {Buffer} contents
+ * @returns {string}
+ */
+const cachePath = (directory, name, fingerprint, contents) => path.join(
+  directory,
+  name,
+  createHash('sha256').update(name).update('\0').update(fingerprint).update('\0').update(contents).digest('hex')
+)
+
+/**
+ * Write through a temporary file and rename it, so a reader (another build or test worker) never sees a half-written
+ * result.
+ * @private
+ * @param {string} file
+ * @param {Buffer} contents
+ * @returns {Promise<void>}
+ */
+const writeAtomic = async (file, contents) => {
+  await mkdir(path.dirname(file), { recursive: true })
+  const temporary = `${file}.${randomUUID()}.tmp`
+  await writeFile(temporary, contents)
+  await rename(temporary, file)
+}
+
+/**
+ * Run a gulp plugin only on files it hasn't processed before. A file whose contents (with this cache name and
+ * fingerprint) were processed by an earlier run gets that run's result from the cache instead, and skips the plugin.
+ * Replaces gulp-cache, which kept one cache for every process in the system's temp folder.
+ *
+ * A result is cached when the plugin passes on the file object it was given (as gulp plugins usually do); a plugin
+ * that makes new file objects still works, its results just aren't cached. When the plugin renames a file, the cache
+ * keeps the new name too (next to the result, as `<entry>.path`), so a cached file is renamed the same way. Entries
+ * are never pruned: delete the directory to start over.
+ * @memberOf module:partials
+ * @param {stream.Transform} plugin - The gulp plugin stream to run on uncached files (e.g. imagemin()).
+ * @param {Object} options
+ * @param {string} options.directory - Where cached results are kept (see images.cacheDir).
+ * @param {string} [options.name='default'] - The cache's folder; keeps results of different plugin settings apart.
+ * @param {string} [options.fingerprint=''] - Anything else that changes the plugin's output, such as its version and
+ * options: when it changes, earlier results are no longer used.
+ * @returns {stream.Transform}
+ */
+export const cacheFiles = (plugin, { directory, name = 'default', fingerprint = '' }) => {
+  const writes = []
+  const pluginDone = new Promise((resolve, reject) => {
+    plugin.on('end', resolve)
+    plugin.on('error', reject)
+  })
+  // The error also reaches the stream (below); this only stops it from being reported a second time as unhandled
+  pluginDone.catch(() => {})
+
+  const stream = new Transform({
+    objectMode: true,
+    transform (file, encoding, callback) {
+      if (!file.isBuffer()) {
+        callback(null, file)
+        return
+      }
+      const cached = cachePath(directory, name, fingerprint, file.contents)
+      readFile(cached).then(
+        async contents => {
+          file.contents = contents
+          // Written before the result, so it's there whenever the result is
+          const renamed = await readFile(`${cached}.path`, 'utf8').catch(() => undefined)
+          if (renamed !== undefined) {
+            file.path = path.join(path.dirname(file.path), renamed)
+          }
+          callback(null, file)
+        },
+        () => {
+          file[cacheFile] = { cached, from: file.path }
+          plugin.write(file)
+          callback()
+        }
+      )
+    },
+    flush (callback) {
+      plugin.end()
+      pluginDone
+        .then(() => Promise.all(writes))
+        .then(() => callback(), callback)
+    }
+  })
+
+  plugin.on('data', file => {
+    const tag = file[cacheFile]
+    delete file[cacheFile]
+    if (tag && file.isBuffer()) {
+      const { cached, from } = tag
+      const renamed = file.path === from ? Promise.resolve() : writeAtomic(`${cached}.path`, path.relative(path.dirname(from), file.path))
+      // The cache only saves time: a result that can't be written is processed again next run, not a failed build
+      writes.push(renamed.then(() => writeAtomic(cached, file.contents)).catch(() => {}))
+    }
+    stream.push(file)
+  })
+  plugin.on('error', error => stream.destroy(error))
+
+  return stream
+}

package/functions/partials/cacheFiles.test.mjs

@@ -0,0 +1,151 @@
+import fs from 'fs'
+import path from 'path'
+import { Readable, Transform } from 'stream'
+import * as setUp from '../test-helpers/setUp.mjs'
+import { cacheFiles } from './cacheFiles.mjs'
+
+setUp.setDefaults('test-cache-files')
+const gulpConfig = setUp.gulpConfig
+
+beforeEach(setUp.beforeEach)
+
+afterEach(setUp.afterEach)
+
+// Just enough of a Vinyl file for cacheFiles and the fake plugin
+const file = (filePath, text) => ({
+  path: filePath,
+  contents: text === null ? null : Buffer.from(text),
+  isBuffer () {
+    return Buffer.isBuffer(this.contents)
+  }
+})
+
+// A plugin that upper-cases each file, counting the files it's given
+const upperCase = () => {
+  const plugin = new Transform({
+    objectMode: true,
+    transform (input, encoding, callback) {
+      plugin.calls++
+      input.contents = Buffer.from(input.contents.toString().toUpperCase())
+      callback(null, input)
+    }
+  })
+  plugin.calls = 0
+  return plugin
+}
+
+// Run files through cacheFiles and collect what comes out, as text by path
+const run = (files, plugin, options) => new Promise((resolve, reject) => {
+  const out = {}
+  Readable.from(files)
+    .pipe(cacheFiles(plugin, options))
+    .on('data', output => {
+      out[path.basename(output.path)] = output.contents === null ? null : output.contents.toString()
+    })
+    .on('end', () => resolve(out))
+    .on('error', reject)
+})
+
+const cacheDir = () => `${gulpConfig.get('rootPath')}cache`
+
+describe('cacheFiles', () => {
+  test('a file it hasn\'t seen goes through the plugin, and the result is cached', async () => {
+    const plugin = upperCase()
+    expect(await run([file('/a.txt', 'one'), file('/b.txt', 'two')], plugin, { directory: cacheDir() }))
+      .toEqual({ 'a.txt': 'ONE', 'b.txt': 'TWO' })
+    expect(plugin.calls).toBe(2)
+    expect(fs.readdirSync(path.join(cacheDir(), 'default'))).toHaveLength(2)
+  })
+
+  test('the same contents again come from the cache, without the plugin', async () => {
+    await run([file('/a.txt', 'one')], upperCase(), { directory: cacheDir() })
+    const plugin = upperCase()
+    // Another path with the same contents is the same result
+    expect(await run([file('/a.txt', 'one'), file('/copy.txt', 'one')], plugin, { directory: cacheDir() }))
+      .toEqual({ 'a.txt': 'ONE', 'copy.txt': 'ONE' })
+    expect(plugin.calls).toBe(0)
+  })
+
+  test('changed contents, or another cache name, go through the plugin again', async () => {
+    await run([file('/a.txt', 'one')], upperCase(), { directory: cacheDir() })
+    const changed = upperCase()
+    expect(await run([file('/a.txt', 'one!')], changed, { directory: cacheDir() })).toEqual({ 'a.txt': 'ONE!' })
+    expect(changed.calls).toBe(1)
+    const otherName = upperCase()
+    expect(await run([file('/a.txt', 'one')], otherName, { directory: cacheDir(), name: 'other' })).toEqual({ 'a.txt': 'ONE' })
+    expect(otherName.calls).toBe(1)
+  })
+
+  test('another fingerprint (say, a new plugin version) goes through the plugin again', async () => {
+    await run([file('/a.txt', 'one')], upperCase(), { directory: cacheDir(), fingerprint: 'v1' })
+    const sameVersion = upperCase()
+    await run([file('/a.txt', 'one')], sameVersion, { directory: cacheDir(), fingerprint: 'v1' })
+    expect(sameVersion.calls).toBe(0)
+    const newVersion = upperCase()
+    await run([file('/a.txt', 'one')], newVersion, { directory: cacheDir(), fingerprint: 'v2' })
+    expect(newVersion.calls).toBe(1)
+  })
+
+  test('a plugin that renames files has its results cached, and a cached file is renamed the same way', async () => {
+    const renaming = () => {
+      const plugin = upperCase()
+      const transform = plugin._transform.bind(plugin)
+      plugin._transform = (input, encoding, callback) => transform(input, encoding, (error, output) => {
+        output.path = output.path.replace('.txt', '.md')
+        callback(error, output)
+      })
+      return plugin
+    }
+    expect(await run([file('/a.txt', 'one')], renaming(), { directory: cacheDir() })).toEqual({ 'a.md': 'ONE' })
+    const again = renaming()
+    // From the cache, renamed the same way, without the plugin
+    expect(await run([file('/a.txt', 'one')], again, { directory: cacheDir() })).toEqual({ 'a.md': 'ONE' })
+    expect(again.calls).toBe(0)
+  })
+
+  test('a plugin that makes new file objects still works; its results just aren\'t cached', async () => {
+    const copying = new Transform({
+      objectMode: true,
+      transform (input, encoding, callback) {
+        callback(null, file(input.path, input.contents.toString().toUpperCase()))
+      }
+    })
+    expect(await run([file('/a.txt', 'one')], copying, { directory: cacheDir() })).toEqual({ 'a.txt': 'ONE' })
+    expect(fs.existsSync(path.join(cacheDir(), 'default'))).toBe(false)
+  })
+
+  test('a file without contents (a directory) passes straight through', async () => {
+    const plugin = upperCase()
+    expect(await run([file('/folder', null)], plugin, { directory: cacheDir() })).toEqual({ folder: null })
+    expect(plugin.calls).toBe(0)
+  })
+
+  test('a cache that can\'t be written still gives the plugin\'s results', async () => {
+    // A file where the cache directory should be: nothing can be written inside it
+    fs.writeFileSync(cacheDir(), 'not a directory')
+    const plugin = upperCase()
+    expect(await run([file('/a.txt', 'one')], plugin, { directory: cacheDir() })).toEqual({ 'a.txt': 'ONE' })
+    expect(plugin.calls).toBe(1)
+  })
+
+  test('two runs at once into the same cache both get every result (the cache file is written whole)', async () => {
+    const files = () => Array.from({ length: 20 }, (_, index) => file(`/f${index}.txt`, `file ${index}`))
+    const expected = Object.fromEntries(Array.from({ length: 20 }, (_, index) => [`f${index}.txt`, `FILE ${index}`]))
+    const results = await Promise.all([
+      run(files(), upperCase(), { directory: cacheDir() }),
+      run(files(), upperCase(), { directory: cacheDir() })
+    ])
+    expect(results).toEqual([expected, expected])
+    expect(fs.readdirSync(path.join(cacheDir(), 'default')).filter(name => name.endsWith('.tmp'))).toEqual([])
+  })
+
+  test('a plugin error fails the stream', async () => {
+    const failing = new Transform({
+      objectMode: true,
+      transform (input, encoding, callback) {
+        callback(new Error('plugin failed'))
+      }
+    })
+    await expect(run([file('/a.txt', 'one')], failing, { directory: cacheDir() })).rejects.toThrow('plugin failed')
+  })
+})

package/functions/partials/imagesFor.mjs

@@ -1,4 +1,6 @@
-import cache from 'gulp-cache'
+import { existsSync, readFileSync } from 'fs'
+import path from 'path'
+import { cacheFiles } from './cacheFiles.mjs'
 import { requirePeer } from './loadPeer.mjs'
 import { dest, src } from 'gulp'
 import * as gulpConfig from '../../gulp.config.mjs'
@@ -53,6 +55,62 @@ export const imageminPlugins = (jpegQuality, plugins = loadImageminPlugins()) =>
   name => Promise.resolve(plugins[name]).then(makePlugin => name === 'mozjpeg' ? makePlugin({ quality: jpegQuality }) : makePlugin())
 )
 
+// The packages that decide imagemin's output: the wrapper and imagemin, then each plugin with the engine it runs
+const imageminPackages = [
+  ['gulp-imagemin'],
+  ['imagemin'],
+  ['imagemin-gifsicle', 'gifsicle'],
+  ['imagemin-mozjpeg', 'mozjpeg'],
+  ['imagemin-optipng', 'optipng-bin'],
+  ['imagemin-svgo', 'svgo']
+]
+
+/**
+ * Find an installed package the way Node does, from a directory up through each node_modules folder. Reads the
+ * package.json directly, so it also works for ESM-only packages that don't export it.
+ * @private
+ * @param {string} name
+ * @param {string} fromDirectory
+ * @returns {{directory: string, version: string}|undefined}
+ */
+const findPackage = (name, fromDirectory) => {
+  for (let directory = path.resolve(fromDirectory); ; directory = path.dirname(directory)) {
+    const file = path.join(directory, 'node_modules', name, 'package.json')
+    if (existsSync(file)) {
+      return { directory: path.dirname(file), version: JSON.parse(readFileSync(file, 'utf8')).version }
+    }
+    if (directory === path.dirname(directory)) {
+      return undefined
+    }
+  }
+}
+
+/**
+ * The installed versions of the packages that decide imagemin's output, so the image cache stops using results made
+ * by older versions after an upgrade (see images.cacheDir).
+ * @memberOf module:partials
+ * @param {string} [projectPath=process.cwd()] - The project directory gulp-imagemin is installed in.
+ * @returns {Object<string, string>} Each package's version by name; a package that isn't installed is left out.
+ */
+export const imageminVersions = (projectPath = process.cwd()) => {
+  const gulpImagemin = findPackage('gulp-imagemin', projectPath)
+  const versions = {}
+  if (!gulpImagemin) {
+    return versions
+  }
+  for (const [wrapper, engine] of imageminPackages) {
+    const found = findPackage(wrapper, gulpImagemin.directory)
+    if (found) {
+      versions[wrapper] = found.version
+      const engineFound = engine && findPackage(engine, found.directory)
+      if (engineFound) {
+        versions[engine] = engineFound.version
+      }
+    }
+  }
+  return versions
+}
+
 /**
  * Move and optimize images into the browser directory.
  * @memberOf module:partials
@@ -65,18 +123,24 @@ export const imagesFor = (imageSrc = gulpConfig.get('images.from'), imageDest =
   const jpegQuality = gulpConfig.get('images.jpegQuality')
   // Left unset, imagemin runs its default plugins with their own defaults
   const plugins = jpegQuality ? imageminPlugins(jpegQuality) : undefined
-  // Gulp 5 reads files as utf8 text unless told otherwise, which corrupts binary images (and makes gulp-cache drop them).
+  const options = {
+    interlaced: true,
+    silent: true,
+    verbose: false,
+  }
+  // Gulp 5 reads files as utf8 text unless told otherwise, which corrupts binary images.
   return src(imageSrc, { encoding: false })
     .pipe(
-      // Caching images that ran through imagemin
-      cache(
-        imagemin(plugins, {
-          interlaced: true,
-          silent: true,
-          verbose: false,
-        }),
-        // gulp-cache keys on the file's contents alone, so keep each quality's results apart
-        { name: jpegQuality ? `jpeg-quality-${jpegQuality}` : 'default' }
+      // Only images imagemin hasn't optimized before go through it; the rest come from the cache
+      cacheFiles(
+        imagemin(plugins, options),
+        {
+          directory: gulpConfig.get('images.cacheDir'),
+          // Each quality gets results of its own
+          name: jpegQuality ? `jpeg-quality-${jpegQuality}` : 'default',
+          // A new imagemin (or plugin, or engine) version, or other options, makes new results
+          fingerprint: JSON.stringify({ options, versions: imageminVersions() })
+        }
       )
     )
     .pipe(dest(imageDest))

package/functions/partials/imagesFor.test.mjs

@@ -4,11 +4,9 @@ import * as setUp from '../test-helpers/setUp.mjs'
 import os from 'os'
 import path from 'path'
 import zlib from 'zlib'
-import { imageminPlugins, imagesFor, loadImagemin } from './imagesFor.mjs'
-import { isolateGulpCache } from '../test-helpers/isolateGulpCache.mjs'
+import { imageminPlugins, imageminVersions, imagesFor, loadImagemin } from './imagesFor.mjs'
 
 setUp.setDefaults('test-images-for')
-const clearImageCache = isolateGulpCache('images-for')
 const gulpConfig = setUp.gulpConfig
 
 const imageContents = '<?xml version="1.0" encoding="UTF-8" standalone="no"?>\n' +
@@ -179,8 +177,8 @@ const optimize = (file, to) => new Promise((resolve, reject) => {
     .on('error', reject)
 })
 
-// The cache outlives a run, so clear it or a stale result from an older imagemin can pass
-beforeEach(() => clearImageCache().then(setUp.beforeEach))
+// A fresh temp directory each test, which is also an empty image cache (see setUp's images.cacheDir)
+beforeEach(() => setUp.beforeEach())
 
 afterEach(setUp.afterEach)
 
@@ -231,6 +229,32 @@ describe('imagesFor', () => {
   })
 })
 
+describe('images.cacheDir', () => {
+  test('a second run takes the optimized image from the cache in images.cacheDir', async () => {
+    const srcPath = gulpConfig.get('srcPath')
+    const imagesFile = `${srcPath}/cached.svg`
+    fs.writeFileSync(imagesFile, imageContents)
+    const browserPath = gulpConfig.get('browser.to')
+    expect((await optimize(imagesFile, browserPath)).toString()).toEqual(imageCompressed)
+    const cacheDir = path.join(gulpConfig.get('images.cacheDir'), 'default')
+    const entries = fs.readdirSync(cacheDir)
+    expect(entries).toHaveLength(1)
+    // Change the cached result: the second run can only produce this by reading the cache instead of imagemin
+    fs.writeFileSync(path.join(cacheDir, entries[0]), '<svg>from the cache</svg>')
+    expect((await optimize(imagesFile, browserPath)).toString()).toEqual('<svg>from the cache</svg>')
+  })
+
+  test('the cache key includes the installed imagemin packages\' versions', () => {
+    const versions = imageminVersions()
+    expect(Object.keys(versions)).toEqual(expect.arrayContaining(['gulp-imagemin', 'imagemin', 'imagemin-svgo', 'svgo', 'imagemin-mozjpeg', 'mozjpeg']))
+    expect(versions['gulp-imagemin']).toMatch(/^\d+\.\d+\.\d+/)
+  })
+
+  test('no gulp-imagemin to find gives no versions', () => {
+    expect(imageminVersions(os.tmpdir())).toEqual({})
+  })
+})
+
 describe('images.jpegQuality', () => {
   test('compresses JPEGs to the configured quality, never reusing another quality\'s cached result', async () => {
     expect.assertions(4)

package/functions/partials.mjs

@@ -9,6 +9,7 @@
 
 export { addToReadme } from './partials/addToReadme.mjs'
 export { beginWatcher } from './partials/beginWatcher.mjs'
+export { cacheFiles } from './partials/cacheFiles.mjs'
 export { clean } from './partials/clean.mjs'
 export { copyFor } from './partials/copyFor.mjs'
 export { distFor } from './partials/distFor.mjs'

package/functions/partials.test.mjs

@@ -2,6 +2,6 @@ import * as partials from './partials.mjs'
 
 describe('partials', () => {
   test('is object with all partial exports', () => {
-    expect(Object.keys(partials).length).toBe(25)
+    expect(Object.keys(partials).length).toBe(26)
   })
 })

package/functions/test-helpers/setUp.mjs

@@ -31,6 +31,8 @@ export const setDefaults = (testDir = 'test-temp') => {
   gulpConfig.set('docs.title', '')
   gulpConfig.set('fonts.from', `${srcPath}/fonts/**/*`)
   gulpConfig.set('fonts.to', `${browserPath}/fonts`)
+  // Each test file's own cache, inside its temp directory, so beforeEach's fresh directory is also an empty cache
+  gulpConfig.set('images.cacheDir', `${tempDir}image-cache`)
   gulpConfig.set('images.from', `${srcPath}/img/**/*.+(png|jpg|jpeg|gif|svg)`)
   gulpConfig.set('images.to', `${browserPath}/img`)
   gulpConfig.set('readme.template', `${tempDir}MAIN.md`)

package/gulp.config.mjs

@@ -105,6 +105,10 @@ import { fileExists } from 'test-filesystem'
 /**
  * Configurations to minify and copy the images.
  * @typedef {Object<string, Setting>} module:gulpConfig~ImageConfig
+ * @property {StringSetting} cacheDir - Where optimized images are cached between runs, so an image that hasn't
+ * changed isn't optimized again. An upgrade of imagemin (or its plugins) or other settings starts new results. Inside
+ * node_modules by default, so it's never committed; old entries aren't pruned, so delete it now and then to start
+ * over.
  * @property {BooleanSetting} enabled - Toggle image minify and copy process.
  * @property {StringSetting} from - Path to search for images.
  * @property {FlagNumberSetting} jpegQuality - The JPEG quality (0 to 100) mozjpeg compresses to. False (the
@@ -250,6 +254,7 @@ const setDefaults = {
     to: 'browser/fonts',
   },
   images: {
+    cacheDir: 'node_modules/.cache/js-build-tools/images',
     enabled: false,
     from: 'src/img/**/*.+(png|jpg|jpeg|gif|svg)',
     jpegQuality: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-build-tools",
-  "version": "6.7.0",
+  "version": "6.8.0",
   "description": "Standardised build process with gulp.",
   "main": "gulpfile.base.js",
   "exports": {
@@ -22,6 +22,7 @@
     "dev": "gulp",
     "docs": "gulp docs",
     "lint": "gulp lint",
+    "prepublishOnly": "npm run build",
     "readme": "gulp readme",
     "release": "release-it",
     "release:dry-run": "release-it --dry-run",
@@ -60,10 +61,9 @@
     "core-js": "^3.51.0",
     "cssnano": "^6.1.2",
     "eslint": "^10.13.0",
-    "glob": "^13.0.6",
+    "glob": "^14.0.2",
     "gulp": "^5.0.1",
     "gulp-babel": "^8.1.0",
-    "gulp-cache": "^1.1.3",
     "gulp-postcss": "^10.0.0",
     "gulp-rename": "^2.1.0",
     "gulp-sass": "^6.0.1",

package/dist/test-helpers/isolateGulpCache.js

@@ -1,25 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isolateGulpCache = void 0;
-var _gulpCache = _interopRequireDefault(require("gulp-cache"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/**
- * Give this test file its own gulp-cache folder, and return a function that clears only that folder. gulp-cache
- * otherwise keeps one cache in os.tmpdir() for every process, so a cache.clearAll() in one Jest worker could wipe it
- * while another worker's images task was still using it, and gulp-cache then silently dropped that worker's
- * images. Jest loads gulp-cache separately for each test file, so this only changes the copy that file uses.
- * @memberOf module:testHelpers
- * @param {string} name - Unique per test file, used in the cache folder name.
- * @returns {function(): Promise<void>} Clears this test file's cache.
- */
-const isolateGulpCache = name => {
-  const fileCache = new _gulpCache.default.Cache({
-    cacheDirName: `js-build-tools-test-${name}`
-  });
-  _gulpCache.default.defaultOptions.fileCache = fileCache;
-  return () => new Promise((resolve, reject) => fileCache.clear(null, error => error ? reject(error) : resolve()));
-};
-exports.isolateGulpCache = isolateGulpCache;

package/functions/test-helpers/isolateGulpCache.mjs

@@ -1,16 +0,0 @@
-import cache from 'gulp-cache'
-
-/**
- * Give this test file its own gulp-cache folder, and return a function that clears only that folder. gulp-cache
- * otherwise keeps one cache in os.tmpdir() for every process, so a cache.clearAll() in one Jest worker could wipe it
- * while another worker's images task was still using it, and gulp-cache then silently dropped that worker's
- * images. Jest loads gulp-cache separately for each test file, so this only changes the copy that file uses.
- * @memberOf module:testHelpers
- * @param {string} name - Unique per test file, used in the cache folder name.
- * @returns {function(): Promise<void>} Clears this test file's cache.
- */
-export const isolateGulpCache = name => {
-  const fileCache = new cache.Cache({ cacheDirName: `js-build-tools-test-${name}` })
-  cache.defaultOptions.fileCache = fileCache
-  return () => new Promise((resolve, reject) => fileCache.clear(null, error => error ? reject(error) : resolve()))
-}