js-build-tools 5.3.2 → 5.4.0

package/dist/build.js

@@ -1,68 +1,68 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.build = void 0
-const _bundle = require('./bundle.js')
-const _bundleLint = require('./bundleLint.js')
-const _bundleMinify = require('./bundleMinify.js')
-const _partials = require('./partials.js')
-const _compileReadme = require('./compileReadme.js')
-const _typeDocs = require('./typeDocs.js')
-const _distLint = require('./distLint.js')
-const _distMinify = require('./distMinify.js')
-const _gulp = require('gulp')
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _copyFonts = require('./copyFonts.js')
-const _images = require('./images.js')
-const _sass = require('./sass.js')
-const _testFull = require('./testFull.js')
-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) }
+'use strict'
+
+require('core-js/modules/esnext.weak-map.delete-all.js')
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.build = void 0
+const _bundle = require('./bundle.js')
+const _bundleLint = require('./bundleLint.js')
+const _bundleMinify = require('./bundleMinify.js')
+const _partials = require('./partials.js')
+const _compileReadme = require('./compileReadme.js')
+const _typeDocs = require('./typeDocs.js')
+const _distLint = require('./distLint.js')
+const _distMinify = require('./distMinify.js')
+const _gulp = require('gulp')
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _copyFonts = require('./copyFonts.js')
+const _images = require('./images.js')
+const _sass = require('./sass.js')
+const _testFull = require('./testFull.js')
+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) }
 /**
  * Runs several processes to build and validate the project.
  * Cleans, distributes (lint and minify), bundles (lint and minify), creates the readme, then runs the tests.
  * @memberOf module:js-build-tools
  * @returns {stream.Stream}
- */
-const build = (done = null) => {
-  const distLintMinify = (0, _gulp.parallel)(_distLint.distLint, _distMinify.distMinify)
-  const bundleLintMinify = (0, _gulp.parallel)(_bundleLint.bundleLint, _bundleMinify.bundleMinify)
-  const buildActions = [(0, _partials.distSeries)(), distLintMinify]
-  const generateDocs = gulpConfig.get('docs.enabled')
-  if (generateDocs) {
-    // The documentation is generated from the TypeScript source itself, the readme is written by hand
-    buildActions.push(_typeDocs.typeDocs)
-  } else if (gulpConfig.get('typescript.enabled')) {
-    // For ts usage, we need to run the readme on the dist directly since that is where the .js files are located
-    buildActions.push(_compileReadme.compileReadme)
-  }
-  if (gulpConfig.get('browser.enabled')) {
-    // If not 'nodeOnly' then we also want to bundle for browser after we complete the dist directory
-    buildActions.push(_bundle.bundle)
-    buildActions.push(bundleLintMinify)
-  }
-  const runActions = [(0, _gulp.series)(...buildActions)]
-  if (!generateDocs && !gulpConfig.get('typescript.enabled')) {
-    // Since we didn't run this in series after dist because of typescript, we need to run it now. Potentially faster here.
-    runActions.push(_compileReadme.compileReadme)
-  }
-  runActions.push(_testFull.testFull)
-  if (gulpConfig.get('fonts.enabled')) {
-    // Conditionally add Fonts process
-    runActions.push(_copyFonts.copyFonts)
-  }
-  if (gulpConfig.get('images.enabled')) {
-    // Conditionally add Images process
-    runActions.push(_images.images)
-  }
-  if (gulpConfig.get('sass.enabled')) {
-    // Conditionally add SASS process
-    runActions.push(_sass.sass)
-  }
-  // clean has to finish before anything writes into the output folders - images, fonts and sass all write into
-  // browser/, so running clean in parallel with them races (ENOTEMPTY errors from clean, or output deleted mid-write).
-  return (0, _gulp.series)(_partials.clean, (0, _gulp.parallel)(...runActions))(done)
-}
-exports.build = build
+ */
+const build = (done = null) => {
+  const distLintMinify = (0, _gulp.parallel)(_distLint.distLint, _distMinify.distMinify)
+  const bundleLintMinify = (0, _gulp.parallel)(_bundleLint.bundleLint, _bundleMinify.bundleMinify)
+  const buildActions = [(0, _partials.distSeries)(), distLintMinify]
+  const generateDocs = gulpConfig.get('docs.enabled')
+  if (generateDocs) {
+    // The documentation is generated from the TypeScript source itself, the readme is written by hand
+    buildActions.push(_typeDocs.typeDocs)
+  } else if (gulpConfig.get('typescript.enabled')) {
+    // For ts usage, we need to run the readme on the dist directly since that is where the .js files are located
+    buildActions.push(_compileReadme.compileReadme)
+  }
+  if (gulpConfig.get('browser.enabled')) {
+    // If not 'nodeOnly' then we also want to bundle for browser after we complete the dist directory
+    buildActions.push(_bundle.bundle)
+    buildActions.push(bundleLintMinify)
+  }
+  const runActions = [(0, _gulp.series)(...buildActions)]
+  if (!generateDocs && !gulpConfig.get('typescript.enabled')) {
+    // Since we didn't run this in series after dist because of typescript, we need to run it now. Potentially faster here.
+    runActions.push(_compileReadme.compileReadme)
+  }
+  runActions.push(_testFull.testFull)
+  if (gulpConfig.get('fonts.enabled')) {
+    // Conditionally add Fonts process
+    runActions.push(_copyFonts.copyFonts)
+  }
+  if (gulpConfig.get('images.enabled')) {
+    // Conditionally add Images process
+    runActions.push(_images.images)
+  }
+  if (gulpConfig.get('sass.enabled')) {
+    // Conditionally add SASS process
+    runActions.push(_sass.sass)
+  }
+  // clean has to finish before anything writes into the output folders - images, fonts and sass all write into
+  // browser/, so running clean in parallel with them races (ENOTEMPTY errors from clean, or output deleted mid-write).
+  return (0, _gulp.series)(_partials.clean, (0, _gulp.parallel)(...runActions))(done)
+}
+exports.build = build

package/dist/bundle.js

@@ -1,36 +1,43 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.bundle = void 0
-const _browserify = _interopRequireDefault(require('browserify'))
-const _gulp = require('gulp')
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _vinylSourceStream = _interopRequireDefault(require('vinyl-source-stream'))
-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) }
-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.bundle = void 0
+const _browserify = _interopRequireDefault(require('browserify'))
+const _gulp = require('gulp')
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _vinylSourceStream = _interopRequireDefault(require('vinyl-source-stream'))
+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) }
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
 /**
  * Starting at the distribution entry point, bundle all the files into a single file and store them in the specified output directory.
  *
+ * browser.name does double duty: it names the output file (browser.name.js) and, via browserify's `standalone`
+ * option, is also the name the bundle's exports are exposed under - as a global when loaded with a bare <script>
+ * tag, or as the module when required via CommonJS/AMD. Without this, a bundle built from a real entry point (one
+ * that actually exports something) builds successfully but exposes nothing a consumer can reach.
+ *
  * Two escape hatches from browser.config.json keep an unwanted dependency (or a dependency's dependency) out of the
  * bundle: 'ignore' replaces it with an empty object (safe when your code never actually calls into it - for example
  * a library's default option value you always override with your own) and 'exclude' leaves it out entirely (your
  * code must not require it, or provide it another way, such as a separate script tag).
  * @memberOf module:js-build-tools
  * @returns {stream.Stream}
- */
-const bundle = () => {
-  const bundler = (0, _browserify.default)(gulpConfig.get('dist.main'))
-  const ignore = gulpConfig.get('browser.ignore')
-  const exclude = gulpConfig.get('browser.exclude')
-  if (ignore && ignore.length) {
-    bundler.ignore(ignore)
-  }
-  if (exclude && exclude.length) {
-    bundler.exclude(exclude)
-  }
-  return bundler.bundle().pipe((0, _vinylSourceStream.default)(`${gulpConfig.get('browser.name')}.js`)).pipe((0, _gulp.dest)(gulpConfig.get('browser.to')))
-}
-exports.bundle = bundle
+ */
+const bundle = () => {
+  const bundler = (0, _browserify.default)(gulpConfig.get('dist.main'), {
+    standalone: gulpConfig.get('browser.name')
+  })
+  const ignore = gulpConfig.get('browser.ignore')
+  const exclude = gulpConfig.get('browser.exclude')
+  if (ignore && ignore.length) {
+    bundler.ignore(ignore)
+  }
+  if (exclude && exclude.length) {
+    bundler.exclude(exclude)
+  }
+  return bundler.bundle().pipe((0, _vinylSourceStream.default)(`${gulpConfig.get('browser.name')}.js`)).pipe((0, _gulp.dest)(gulpConfig.get('browser.to')))
+}
+exports.bundle = bundle

package/dist/bundle.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundle=void 0;var _browserify=_interopRequireDefault(require("browserify")),_gulp=require("gulp"),gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_vinylSourceStream=_interopRequireDefault(require("vinyl-source-stream"));function _interopRequireWildcard(e,r){if("function"==typeof WeakMap)var t=new WeakMap,u=new WeakMap;return(_interopRequireWildcard=function(e,r){if(!r&&e&&e.__esModule)return e;var n,i,o={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return o;if(n=r?u:t){if(n.has(e))return n.get(e);n.set(e,o)}for(const r in e)"default"!==r&&{}.hasOwnProperty.call(e,r)&&((i=(n=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,r))&&(i.get||i.set)?n(o,r,i):o[r]=e[r]);return o})(e,r)}function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const bundle=()=>{const e=(0,_browserify.default)(gulpConfig.get("dist.main")),r=gulpConfig.get("browser.ignore"),t=gulpConfig.get("browser.exclude");return r&&r.length&&e.ignore(r),t&&t.length&&e.exclude(t),e.bundle().pipe((0,_vinylSourceStream.default)(`${gulpConfig.get("browser.name")}.js`)).pipe((0,_gulp.dest)(gulpConfig.get("browser.to")))};exports.bundle=bundle;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundle=void 0;var _browserify=_interopRequireDefault(require("browserify")),_gulp=require("gulp"),gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_vinylSourceStream=_interopRequireDefault(require("vinyl-source-stream"));function _interopRequireWildcard(e,r){if("function"==typeof WeakMap)var t=new WeakMap,n=new WeakMap;return(_interopRequireWildcard=function(e,r){if(!r&&e&&e.__esModule)return e;var u,o,i={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return i;if(u=r?n:t){if(u.has(e))return u.get(e);u.set(e,i)}for(const r in e)"default"!==r&&{}.hasOwnProperty.call(e,r)&&((o=(u=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,r))&&(o.get||o.set)?u(i,r,o):i[r]=e[r]);return i})(e,r)}function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e}}const bundle=()=>{const e=(0,_browserify.default)(gulpConfig.get("dist.main"),{standalone:gulpConfig.get("browser.name")}),r=gulpConfig.get("browser.ignore"),t=gulpConfig.get("browser.exclude");return r&&r.length&&e.ignore(r),t&&t.length&&e.exclude(t),e.bundle().pipe((0,_vinylSourceStream.default)(`${gulpConfig.get("browser.name")}.js`)).pipe((0,_gulp.dest)(gulpConfig.get("browser.to")))};exports.bundle=bundle;

package/dist/partials/imagesFor.js

@@ -1,19 +1,19 @@
-"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 _loadPeer = require("./loadPeer.js");
-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).';
-
+"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 _loadPeer = require("./loadPeer.js");
+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
@@ -22,36 +22,36 @@ const installHint = 'Add it to your project with: npm install --save-dev github:
  * @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()) => {
-  const loaded = (0, _loadPeer.requirePeer)('gulp-imagemin', {
-    task: 'images',
-    installHint,
-    esmOnlyMessage: `gulp-imagemin could not be loaded because it is ESM-only. ${installHint}`,
-    projectPath
-  });
-  return loaded && (loaded.__esModule || loaded.default) ? loaded.default : loaded;
-};
-
+ */
+const loadImagemin = (projectPath = process.cwd()) => {
+  const loaded = (0, _loadPeer.requirePeer)('gulp-imagemin', {
+    task: 'images',
+    installHint,
+    esmOnlyMessage: `gulp-imagemin could not be loaded because it is ESM-only. ${installHint}`,
+    projectPath
+  });
+  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}
- */
-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.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/loadPeer.js

@@ -1,34 +1,34 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.requirePeer = exports.importPeer = exports.importModule = void 0;
-require("core-js/modules/es.array.includes.js");
-var _nodeModule = require("node:module");
-var _nodePath = _interopRequireDefault(require("node:path"));
-var _nodeUrl = require("node:url");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// Several dependencies ship ESM-only (standard, gulp-ts-compile, typedoc), 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, because babel cannot see (and so cannot rewrite) an import expression which only exists as a runtime string.
-const dynamicImport = new Function('specifier', 'return import(specifier)');
-
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.requirePeer = exports.importPeer = exports.importModule = void 0;
+require("core-js/modules/es.array.includes.js");
+var _nodeModule = require("node:module");
+var _nodePath = _interopRequireDefault(require("node:path"));
+var _nodeUrl = require("node:url");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// Several dependencies ship ESM-only (standard, gulp-ts-compile, typedoc), 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, because babel cannot see (and so cannot rewrite) an import expression which only exists as a runtime string.
+const dynamicImport = new Function('specifier', 'return import(specifier)');
+
 /**
  * Import an ES module (or any module) with a real dynamic import(), whichever build (ESM or CommonJS) this runs from.
  * @memberOf module:partials
  * @param {string} specifier - The package name, or the URL of a file.
  * @returns {Promise<Object>} The module namespace.
- */
-const importModule = specifier => dynamicImport(specifier);
-exports.importModule = importModule;
-const isMissing = (error, name) => error.code === 'MODULE_NOT_FOUND' && error.message.includes(`'${name}'`);
-const notInstalled = (name, {
-  task,
-  installHint
-}) => new Error(`The ${task} task needs the optional peer dependency ${name}, which is not installed. ${installHint}`);
-
+ */
+const importModule = specifier => dynamicImport(specifier);
+exports.importModule = importModule;
+const isMissing = (error, name) => error.code === 'MODULE_NOT_FOUND' && error.message.includes(`'${name}'`);
+const notInstalled = (name, {
+  task,
+  installHint
+}) => new Error(`The ${task} task needs the optional peer dependency ${name}, which is not installed. ${installHint}`);
+
 /**
  * Load an optional peer dependency (one which is only needed once a task runs, so projects which never use that task
  * do not have to install it) with require(), from the project being built rather than from this package. When it is
@@ -42,29 +42,29 @@ const notInstalled = (name, {
  * @param {string} [options.projectPath=process.cwd()] - The folder of the project (which has the package.json) being built.
  * @returns {*} Whatever the package exports.
  * @throws {Error} With install instructions when the package is not installed.
- */
-const requirePeer = (name, {
-  task,
-  installHint,
-  esmOnlyMessage,
-  projectPath = process.cwd()
-}) => {
-  try {
-    return (0, _nodeModule.createRequire)(_nodePath.default.join(projectPath, 'package.json'))(name);
-  } catch (error) {
-    if (isMissing(error, name)) {
-      throw notInstalled(name, {
-        task,
-        installHint
-      });
-    }
-    if (error.code === 'ERR_REQUIRE_ESM' && esmOnlyMessage) {
-      throw new Error(esmOnlyMessage);
-    }
-    throw error;
-  }
-};
-
+ */
+const requirePeer = (name, {
+  task,
+  installHint,
+  esmOnlyMessage,
+  projectPath = process.cwd()
+}) => {
+  try {
+    return (0, _nodeModule.createRequire)(_nodePath.default.join(projectPath, 'package.json'))(name);
+  } catch (error) {
+    if (isMissing(error, name)) {
+      throw notInstalled(name, {
+        task,
+        installHint
+      });
+    }
+    if (error.code === 'ERR_REQUIRE_ESM' && esmOnlyMessage) {
+      throw new Error(esmOnlyMessage);
+    }
+    throw error;
+  }
+};
+
 /**
  * Import an optional peer dependency which ships ESM-only, from the project being built. See {@link requirePeer}.
  * @memberOf module:partials
@@ -75,25 +75,25 @@ const requirePeer = (name, {
  * @param {string} [options.projectPath=process.cwd()] - The folder of the project (which has the package.json) being built.
  * @returns {Promise<Object>} The module namespace.
  * @throws {Error} With install instructions when the package is not installed.
- */
-exports.requirePeer = requirePeer;
-const importPeer = async (name, {
-  task,
-  installHint,
-  projectPath = process.cwd()
-}) => {
-  let resolved;
-  try {
-    resolved = (0, _nodeModule.createRequire)(_nodePath.default.join(projectPath, 'package.json')).resolve(name);
-  } catch (error) {
-    if (isMissing(error, name)) {
-      throw notInstalled(name, {
-        task,
-        installHint
-      });
-    }
-    throw error;
-  }
-  return importModule((0, _nodeUrl.pathToFileURL)(resolved).href);
-};
+ */
+exports.requirePeer = requirePeer;
+const importPeer = async (name, {
+  task,
+  installHint,
+  projectPath = process.cwd()
+}) => {
+  let resolved;
+  try {
+    resolved = (0, _nodeModule.createRequire)(_nodePath.default.join(projectPath, 'package.json')).resolve(name);
+  } catch (error) {
+    if (isMissing(error, name)) {
+      throw notInstalled(name, {
+        task,
+        installHint
+      });
+    }
+    throw error;
+  }
+  return importModule((0, _nodeUrl.pathToFileURL)(resolved).href);
+};
 exports.importPeer = importPeer;

package/dist/partials/standardLint.js

@@ -1,38 +1,38 @@
-"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"));
-var _loadPeer = require("./loadPeer.js");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// `standard` (17+) ships ESM-only, see importModule for how it is imported.
-const importStandard = () => (0, _loadPeer.importModule)('standard');
-
+"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"));
+var _loadPeer = require("./loadPeer.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// `standard` (17+) ships ESM-only, see importModule for how it is imported.
+const importStandard = () => (0, _loadPeer.importModule)('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`);
-};
-
+ */
+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
@@ -47,48 +47,48 @@ const printFileReport = (file, result) => {
  * 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();
-  });
-};
+ */
+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;

package/dist/partials/tsFor.js

@@ -1,27 +1,27 @@
-"use strict";
-
-require("core-js/modules/esnext.weak-map.delete-all.js");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.tsFor = exports.loadTypescript = void 0;
-var _gulp = require("gulp");
-var _nodePath = _interopRequireDefault(require("node:path"));
-var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
-var _loadPeer = require("./loadPeer.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 }; }
-// gulp-ts-compile ships ESM-only (no CJS build - see its own package.json), see importModule for how it is imported.
-const importGulpTsCompile = () => (0, _loadPeer.importModule)('gulp-ts-compile');
-
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.tsFor = exports.loadTypescript = void 0;
+var _gulp = require("gulp");
+var _nodePath = _interopRequireDefault(require("node:path"));
+var gulpConfig = _interopRequireWildcard(require("../../gulp.config.js"));
+var _loadPeer = require("./loadPeer.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 }; }
+// gulp-ts-compile ships ESM-only (no CJS build - see its own package.json), see importModule for how it is imported.
+const importGulpTsCompile = () => (0, _loadPeer.importModule)('gulp-ts-compile');
+
 /**
  * Wrap a stream in a promise that resolves once it finishes writing.
  * @memberOf module:partials
  * @param {import('node:stream').Stream} stream
  * @returns {Promise<void>}
- */
-const installHint = 'Install it in your project with: npm install --save-dev typescript';
-
+ */
+const installHint = 'Install it in your project with: npm install --save-dev typescript';
+
 /**
  * Load the project's own copy of TypeScript (an optional peer dependency, only needed when the typescript task is
  * enabled) from the project being built, so projects which do not use TypeScript never need it installed.
@@ -29,18 +29,18 @@ const installHint = 'Install it in your project with: npm install --save-dev typ
  * @param {string} [projectPath=process.cwd()] The folder of the project (which has the package.json) being built.
  * @returns {Object} The TypeScript compiler API module.
  * @throws {Error} With install instructions when typescript is not installed.
- */
-const loadTypescript = (projectPath = process.cwd()) => (0, _loadPeer.requirePeer)('typescript', {
-  task: 'typescript',
-  installHint,
-  projectPath
-});
-exports.loadTypescript = loadTypescript;
-const streamToPromise = stream => new Promise((resolve, reject) => {
-  stream.on('finish', resolve);
-  stream.on('error', reject);
-});
-
+ */
+const loadTypescript = (projectPath = process.cwd()) => (0, _loadPeer.requirePeer)('typescript', {
+  task: 'typescript',
+  installHint,
+  projectPath
+});
+exports.loadTypescript = loadTypescript;
+const streamToPromise = stream => new Promise((resolve, reject) => {
+  stream.on('finish', resolve);
+  stream.on('error', reject);
+});
+
 /**
  * Read a tsconfig.json file into real typescript.CompilerOptions values, using only TypeScript's stable, current,
  * public config-reading API (the same one `tsc --project` itself uses internally) - never
@@ -49,13 +49,13 @@ const streamToPromise = stream => new Promise((resolve, reject) => {
  * @memberOf module:partials
  * @param {string} configPath - Path to a tsconfig.json file.
  * @returns {import('typescript').CompilerOptions}
- */
-const readCompilerOptions = (ts, configPath) => {
-  const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
-  const parsedConfig = ts.parseJsonConfigFileContent(configFile.config, ts.sys, _nodePath.default.dirname(configPath));
-  return parsedConfig.options;
-};
-
+ */
+const readCompilerOptions = (ts, configPath) => {
+  const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
+  const parsedConfig = ts.parseJsonConfigFileContent(configFile.config, ts.sys, _nodePath.default.dirname(configPath));
+  return parsedConfig.options;
+};
+
 /**
  * Starting at the source directory, find all the ts files and convert them into the distribution directory.
  * @memberOf module:partials
@@ -68,36 +68,36 @@ const readCompilerOptions = (ts, configPath) => {
  * suite already covers real TypeScript-compile correctness - this function's own tests only need to verify its
  * config resolution and stream wiring.
  * @returns {Function}
- */
-const tsFor = (srcPath = gulpConfig.get('typescript.from'), distPath = gulpConfig.get('typescript.to'), loadTsCompile = () => importGulpTsCompile().then(({
-  default: tsCompile
-}) => tsCompile)) => {
-  if (gulpConfig.get('typescript.enabled') === false) {
-    return () => {};
-  }
-  const ts = loadTypescript();
-  const configPath = gulpConfig.get('typescript.config');
-  // When no tsconfig.json is configured, target/module are pinned explicitly rather than left for TypeScript's
-  // own compiler defaults - those defaults have already shifted once across a TypeScript version bump in this
-  // project's own history (silently changing whether output keeps `const`/`let` or downlevels to `var`), and
-  // pinning them keeps this task's output stable across future TypeScript upgrades too. ES5/CommonJS matches
-  // what the downstream babel/browserify bundling pipeline has always assumed it receives.
-  const compilerOptions = configPath ? readCompilerOptions(ts, configPath) : {
-    declaration: true,
-    target: ts.ScriptTarget.ES5,
-    module: ts.ModuleKind.CommonJS,
-    esModuleInterop: false
-  };
-  // Accepts gulp's own callback-style task convention (an optional `done`, called once finished) rather than
-  // just returning a Promise, since callers may invoke the returned function directly with a callback instead
-  // of relying on gulp's own runner to observe a returned Promise.
-  return done => {
-    const compile = async () => {
-      const tsCompile = await loadTsCompile();
-      const tsResult = (0, _gulp.src)(srcPath).pipe(tsCompile(compilerOptions));
-      await Promise.all([streamToPromise(tsResult.dts.pipe((0, _gulp.dest)(distPath))), streamToPromise(tsResult.js.pipe((0, _gulp.dest)(distPath)))]);
-    };
-    return typeof done === 'function' ? compile().then(() => done(), done) : compile();
-  };
-};
+ */
+const tsFor = (srcPath = gulpConfig.get('typescript.from'), distPath = gulpConfig.get('typescript.to'), loadTsCompile = () => importGulpTsCompile().then(({
+  default: tsCompile
+}) => tsCompile)) => {
+  if (gulpConfig.get('typescript.enabled') === false) {
+    return () => {};
+  }
+  const ts = loadTypescript();
+  const configPath = gulpConfig.get('typescript.config');
+  // When no tsconfig.json is configured, target/module are pinned explicitly rather than left for TypeScript's
+  // own compiler defaults - those defaults have already shifted once across a TypeScript version bump in this
+  // project's own history (silently changing whether output keeps `const`/`let` or downlevels to `var`), and
+  // pinning them keeps this task's output stable across future TypeScript upgrades too. ES5/CommonJS matches
+  // what the downstream babel/browserify bundling pipeline has always assumed it receives.
+  const compilerOptions = configPath ? readCompilerOptions(ts, configPath) : {
+    declaration: true,
+    target: ts.ScriptTarget.ES5,
+    module: ts.ModuleKind.CommonJS,
+    esModuleInterop: false
+  };
+  // Accepts gulp's own callback-style task convention (an optional `done`, called once finished) rather than
+  // just returning a Promise, since callers may invoke the returned function directly with a callback instead
+  // of relying on gulp's own runner to observe a returned Promise.
+  return done => {
+    const compile = async () => {
+      const tsCompile = await loadTsCompile();
+      const tsResult = (0, _gulp.src)(srcPath).pipe(tsCompile(compilerOptions));
+      await Promise.all([streamToPromise(tsResult.dts.pipe((0, _gulp.dest)(distPath))), streamToPromise(tsResult.js.pipe((0, _gulp.dest)(distPath)))]);
+    };
+    return typeof done === 'function' ? compile().then(() => done(), done) : compile();
+  };
+};
 exports.tsFor = tsFor;

package/dist/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, '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')

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
+const _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/functions/bundle.mjs

@@ -6,6 +6,11 @@ import source from 'vinyl-source-stream'
 /**
  * Starting at the distribution entry point, bundle all the files into a single file and store them in the specified output directory.
  *
+ * browser.name does double duty: it names the output file (browser.name.js) and, via browserify's `standalone`
+ * option, is also the name the bundle's exports are exposed under - as a global when loaded with a bare <script>
+ * tag, or as the module when required via CommonJS/AMD. Without this, a bundle built from a real entry point (one
+ * that actually exports something) builds successfully but exposes nothing a consumer can reach.
+ *
  * Two escape hatches from browser.config.json keep an unwanted dependency (or a dependency's dependency) out of the
  * bundle: 'ignore' replaces it with an empty object (safe when your code never actually calls into it - for example
  * a library's default option value you always override with your own) and 'exclude' leaves it out entirely (your
@@ -14,7 +19,7 @@ import source from 'vinyl-source-stream'
  * @returns {stream.Stream}
  */
 export const bundle = () => {
-  const bundler = browserify(gulpConfig.get('dist.main'))
+  const bundler = browserify(gulpConfig.get('dist.main'), { standalone: gulpConfig.get('browser.name') })
   const ignore = gulpConfig.get('browser.ignore')
   const exclude = gulpConfig.get('browser.exclude')
   if (ignore && ignore.length) {

package/functions/bundle.test.mjs

@@ -1,4 +1,5 @@
 import fs from 'fs'
+import path from 'path'
 import * as setUp from './test-helpers/setUp.mjs'
 import { bundle } from './bundle.mjs'
 import { countMatches } from 'test-filesystem'
@@ -66,6 +67,25 @@ describe('bundle', () => {
         done()
       })
   })
+
+  test('exposes browser.name as the standalone export, reachable by a real consumer', done => {
+    const destPath = gulpConfig.get('browser.to')
+    const bundledFile = `${destPath}/${gulpConfig.get('browser.name')}.js`
+    expect.assertions(2)
+    bundle()
+      .on('finish', () => {
+        // A UMD bundle (browserify's `standalone` option) resolves to its CommonJS branch when
+        // required like this, and to a `window.<browser.name>` global when loaded via a bare
+        // <script> tag in a real browser - both paths hit the same exported value.
+        const resolved = path.resolve(bundledFile)
+        delete require.cache[resolved]
+        const loaded = require(resolved)
+        expect(typeof loaded.file1).toBe('function')
+        expect(typeof loaded.file2).toBe('function')
+        done()
+      })
+      .on('error', error => done(error))
+  })
 })
 
 describe('bundle ignore / exclude', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-build-tools",
-  "version": "5.3.2",
+  "version": "5.4.0",
   "description": "Standardised build process with gulp.",
   "main": "gulpfile.base.js",
   "exports": {