js-build-tools 5.4.0 → 5.6.0

package/dist/bundle.js

@@ -5,19 +5,28 @@ Object.defineProperty(exports, '__esModule', {
   value: true
 })
 exports.bundle = void 0
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.map.js')
 const _browserify = _interopRequireDefault(require('browserify'))
 const _gulp = require('gulp')
+const _mergeStream = _interopRequireDefault(require('merge-stream'))
 const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
 const _vinylSourceStream = _interopRequireDefault(require('vinyl-source-stream'))
+const _getBundleConfigs = require('./utilities/getBundleConfigs.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) }
 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.
+ * Starting at each bundle's own entry point (dist.main for the primary bundle, or its own
+ * override from browser.bundles), bundle all the reachable files into a single file per bundle and
+ * store them in the specified output directory. A project with no browser.bundles entries gets
+ * exactly the one bundle it always did; each additional entry produces its own separate bundle
+ * (for example, a render-only variant built from a different entry point than the full bundle).
  *
- * 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.
+ * A bundle's name does double duty: it names the output file (name.js) and, via browserify's
+ * `standalone` option, is also the name its 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
@@ -26,18 +35,25 @@ function _interopRequireDefault (e) { return e && e.__esModule ? e : { default:
  * @memberOf module:js-build-tools
  * @returns {stream.Stream}
  */
-const bundle = () => {
-  const bundler = (0, _browserify.default)(gulpConfig.get('dist.main'), {
-    standalone: gulpConfig.get('browser.name')
+const bundle = () => (0, _mergeStream.default)((0, _getBundleConfigs.getBundleConfigs)().map(({
+  name,
+  main,
+  ignore,
+  exclude
+}) => {
+  const bundler = (0, _browserify.default)(main, {
+    standalone: 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')))
-}
+  return bundler.bundle().pipe((0, _vinylSourceStream.default)(`${name}.js`))
+})
+// One shared dest() for every bundle, not one per bundle - vinyl-fs's dest() races against
+// itself (a real "write after end" failure) when two separate dest() streams target the same
+// directory concurrently, which every additional bundle's own dest() call otherwise would.
+).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,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;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundle=void 0,require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.map.js");var _browserify=_interopRequireDefault(require("browserify")),_gulp=require("gulp"),_mergeStream=_interopRequireDefault(require("merge-stream")),gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_vinylSourceStream=_interopRequireDefault(require("vinyl-source-stream")),_getBundleConfigs=require("./utilities/getBundleConfigs.js");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=()=>(0,_mergeStream.default)((0,_getBundleConfigs.getBundleConfigs)().map(({name:e,main:r,ignore:t,exclude:u})=>{const n=(0,_browserify.default)(r,{standalone:e});return t&&t.length&&n.ignore(t),u&&u.length&&n.exclude(u),n.bundle().pipe((0,_vinylSourceStream.default)(`${e}.js`))})).pipe((0,_gulp.dest)(gulpConfig.get("browser.to")));exports.bundle=bundle;

package/dist/bundleLint.js

@@ -1,20 +1,28 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.bundleLint = void 0
-const _gulp = require('gulp')
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _standardLint = require('./partials/standardLint.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.bundleLint = void 0
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.map.js')
+const _gulp = require('gulp')
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _standardLint = require('./partials/standardLint.js')
+const _getBundleConfigs = require('./utilities/getBundleConfigs.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) }
 /**
- * Applies Standard code style linting to bundled file.
+ * Applies Standard code style linting to every bundled file (the primary bundle, plus any
+ * additional ones from browser.bundles). The lint step itself never varies per bundle, so this is
+ * one shared src()/dest() pipeline fed every bundle's filename at once, rather than one pipeline
+ * per bundle - gulp's src()/dest() both accept an array of paths natively.
  * @memberOf module:js-build-tools
  * @returns {stream.Stream}
- */
-const bundleLint = () => (0, _gulp.src)(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`).pipe((0, _standardLint.standardLint)({
-  fix: true
-})).pipe((0, _gulp.dest)(gulpConfig.get('browser.to')))
-exports.bundleLint = bundleLint
+ */
+const bundleLint = () => (0, _gulp.src)((0, _getBundleConfigs.getBundleConfigs)().map(({
+  name
+}) => `${gulpConfig.get('browser.to')}/${name}.js`)).pipe((0, _standardLint.standardLint)({
+  fix: true
+})).pipe((0, _gulp.dest)(gulpConfig.get('browser.to')))
+exports.bundleLint = bundleLint

package/dist/bundleLint.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundleLint=void 0;var _gulp=require("gulp"),gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_standardLint=require("./partials/standardLint.js");function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,n=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var i,o,u={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return u;if(i=t?n:r){if(i.has(e))return i.get(e);i.set(e,u)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((o=(i=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(o.get||o.set)?i(u,t,o):u[t]=e[t]);return u})(e,t)}const bundleLint=()=>(0,_gulp.src)(`${gulpConfig.get("browser.to")}/${gulpConfig.get("browser.name")}.js`).pipe((0,_standardLint.standardLint)({fix:!0})).pipe((0,_gulp.dest)(gulpConfig.get("browser.to")));exports.bundleLint=bundleLint;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundleLint=void 0,require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.map.js");var _gulp=require("gulp"),gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_standardLint=require("./partials/standardLint.js"),_getBundleConfigs=require("./utilities/getBundleConfigs.js");function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,n=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var i,o,u={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return u;if(i=t?n:r){if(i.has(e))return i.get(e);i.set(e,u)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((o=(i=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(o.get||o.set)?i(u,t,o):u[t]=e[t]);return u})(e,t)}const bundleLint=()=>(0,_gulp.src)((0,_getBundleConfigs.getBundleConfigs)().map(({name:e})=>`${gulpConfig.get("browser.to")}/${e}.js`)).pipe((0,_standardLint.standardLint)({fix:!0})).pipe((0,_gulp.dest)(gulpConfig.get("browser.to")));exports.bundleLint=bundleLint;

package/dist/bundleMinify.js

@@ -1,17 +1,25 @@
-'use strict'
-
-require('core-js/modules/esnext.weak-map.delete-all.js')
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.bundleMinify = void 0
-const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
-const _minifyFor = require('./partials/minifyFor.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.bundleMinify = void 0
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.map.js')
+const gulpConfig = _interopRequireWildcard(require('../gulp.config.js'))
+const _minifyFor = require('./partials/minifyFor.js')
+const _getBundleConfigs = require('./utilities/getBundleConfigs.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) }
 /**
- * Creates the minified bundle file.
+ * Creates the minified file for every bundle (the primary bundle, plus any additional ones from
+ * browser.bundles). The minify step itself never varies per bundle, so this is one shared
+ * src()/dest() pipeline (inside minifyFor) fed every bundle's filename at once, rather than one
+ * pipeline per bundle - gulp's src() accepts an array of paths natively.
  * @memberOf module:js-build-tools
  * @returns {*}
- */
-const bundleMinify = () => (0, _minifyFor.minifyFor)(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`, gulpConfig.get('browser.to'))
-exports.bundleMinify = bundleMinify
+ */
+const bundleMinify = () => (0, _minifyFor.minifyFor)((0, _getBundleConfigs.getBundleConfigs)().map(({
+  name
+}) => `${gulpConfig.get('browser.to')}/${name}.js`), gulpConfig.get('browser.to'))
+exports.bundleMinify = bundleMinify

package/dist/bundleMinify.min.js

@@ -1 +1 @@
-"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundleMinify=void 0;var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_minifyFor=require("./partials/minifyFor.js");function _interopRequireWildcard(e,r){if("function"==typeof WeakMap)var i=new WeakMap,t=new WeakMap;return(_interopRequireWildcard=function(e,r){if(!r&&e&&e.__esModule)return e;var n,o,u={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return u;if(n=r?t:i){if(n.has(e))return n.get(e);n.set(e,u)}for(const r in e)"default"!==r&&{}.hasOwnProperty.call(e,r)&&((o=(n=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,r))&&(o.get||o.set)?n(u,r,o):u[r]=e[r]);return u})(e,r)}const bundleMinify=()=>(0,_minifyFor.minifyFor)(`${gulpConfig.get("browser.to")}/${gulpConfig.get("browser.name")}.js`,gulpConfig.get("browser.to"));exports.bundleMinify=bundleMinify;
+"use strict";require("core-js/modules/esnext.weak-map.delete-all.js"),Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundleMinify=void 0,require("core-js/modules/esnext.iterator.constructor.js"),require("core-js/modules/esnext.iterator.map.js");var gulpConfig=_interopRequireWildcard(require("../gulp.config.js")),_minifyFor=require("./partials/minifyFor.js"),_getBundleConfigs=require("./utilities/getBundleConfigs.js");function _interopRequireWildcard(e,r){if("function"==typeof WeakMap)var i=new WeakMap,t=new WeakMap;return(_interopRequireWildcard=function(e,r){if(!r&&e&&e.__esModule)return e;var n,o,u={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return u;if(n=r?t:i){if(n.has(e))return n.get(e);n.set(e,u)}for(const r in e)"default"!==r&&{}.hasOwnProperty.call(e,r)&&((o=(n=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,r))&&(o.get||o.set)?n(u,r,o):u[r]=e[r]);return u})(e,r)}const bundleMinify=()=>(0,_minifyFor.minifyFor)((0,_getBundleConfigs.getBundleConfigs)().map(({name:e})=>`${gulpConfig.get("browser.to")}/${e}.js`),gulpConfig.get("browser.to"));exports.bundleMinify=bundleMinify;

package/dist/utilities/getBundleConfigs.js

@@ -0,0 +1,36 @@
+"use strict";
+
+require("core-js/modules/esnext.weak-map.delete-all.js");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getBundleConfigs = void 0;
+require("core-js/modules/esnext.iterator.constructor.js");
+require("core-js/modules/esnext.iterator.map.js");
+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); }
+/**
+ * Build the full list of bundles to produce for this project: the primary bundle (browser.name /
+ * dist.main / browser.ignore / browser.exclude, exactly as before browser.bundles existed) plus
+ * any additional bundles from browser.bundles - each falling back to the primary's main / ignore /
+ * exclude whenever its own isn't given, so a render-only (or any other variant) bundle only has to
+ * specify what's actually different about it.
+ * @memberOf module:utilities
+ * @returns {Array<{name: string, main: string, ignore: Array, exclude: Array}>}
+ */
+const getBundleConfigs = () => {
+  const primary = {
+    name: gulpConfig.get('browser.name'),
+    main: gulpConfig.get('dist.main'),
+    ignore: gulpConfig.get('browser.ignore'),
+    exclude: gulpConfig.get('browser.exclude')
+  };
+  const additional = gulpConfig.get('browser.bundles') || [];
+  return [primary, ...additional.map(bundleConfig => ({
+    name: bundleConfig.name,
+    main: bundleConfig.main || primary.main,
+    ignore: bundleConfig.ignore || primary.ignore,
+    exclude: bundleConfig.exclude || primary.exclude
+  }))];
+};
+exports.getBundleConfigs = getBundleConfigs;

package/functions/bundle.mjs

@@ -1,15 +1,22 @@
 import browserify from 'browserify'
 import { dest } from 'gulp'
+import mergeStream from 'merge-stream'
 import * as gulpConfig from '../gulp.config.mjs'
 import source from 'vinyl-source-stream'
+import { getBundleConfigs } from './utilities/getBundleConfigs.mjs'
 
 /**
- * Starting at the distribution entry point, bundle all the files into a single file and store them in the specified output directory.
+ * Starting at each bundle's own entry point (dist.main for the primary bundle, or its own
+ * override from browser.bundles), bundle all the reachable files into a single file per bundle and
+ * store them in the specified output directory. A project with no browser.bundles entries gets
+ * exactly the one bundle it always did; each additional entry produces its own separate bundle
+ * (for example, a render-only variant built from a different entry point than the full bundle).
  *
- * 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.
+ * A bundle's name does double duty: it names the output file (name.js) and, via browserify's
+ * `standalone` option, is also the name its 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
@@ -18,18 +25,20 @@ import source from 'vinyl-source-stream'
  * @memberOf module:js-build-tools
  * @returns {stream.Stream}
  */
-export const bundle = () => {
-  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) {
-    bundler.ignore(ignore)
-  }
-  if (exclude && exclude.length) {
-    bundler.exclude(exclude)
-  }
-  return bundler
-    .bundle()
-    .pipe(source(`${gulpConfig.get('browser.name')}.js`))
-    .pipe(dest(gulpConfig.get('browser.to')))
-}
+export const bundle = () => mergeStream(
+  getBundleConfigs().map(({ name, main, ignore, exclude }) => {
+    const bundler = browserify(main, { standalone: name })
+    if (ignore && ignore.length) {
+      bundler.ignore(ignore)
+    }
+    if (exclude && exclude.length) {
+      bundler.exclude(exclude)
+    }
+    return bundler
+      .bundle()
+      .pipe(source(`${name}.js`))
+  })
+  // One shared dest() for every bundle, not one per bundle - vinyl-fs's dest() races against
+  // itself (a real "write after end" failure) when two separate dest() streams target the same
+  // directory concurrently, which every additional bundle's own dest() call otherwise would.
+).pipe(dest(gulpConfig.get('browser.to')))

package/functions/bundle.test.mjs

@@ -88,6 +88,63 @@ describe('bundle', () => {
   })
 })
 
+describe('bundle with additional bundles', () => {
+  const renderOnlyFileContents = 'const file1 = require(\'./sources/file1\')\n' +
+    '\n' +
+    'module.exports = {\n' +
+    '  file1,\n' +
+    '}\n'
+
+  afterEach(() => gulpConfig.set('browser.bundles', []))
+
+  test('produces one file per additional bundle, each from its own entry point', done => {
+    const distPath = gulpConfig.get('dist.to')
+    const renderOnlyMain = `${distPath}/renderOnly`
+    fs.writeFileSync(`${renderOnlyMain}.js`, renderOnlyFileContents)
+    gulpConfig.set('browser.bundles', [{ name: 'renderOnly', main: renderOnlyMain }])
+
+    const destPath = gulpConfig.get('browser.to')
+    const primaryFile = `${destPath}/${gulpConfig.get('browser.name')}.js`
+    const renderOnlyFile = `${destPath}/renderOnly.js`
+    expect.assertions(4)
+    bundle()
+      .on('finish', () => {
+        // The primary bundle is unaffected - still built from dist.main, still has both files.
+        const primaryContents = fs.readFileSync(primaryFile).toString()
+        expect(primaryContents).toContain('Hello from file1')
+        expect(primaryContents).toContain('Good-bye from file2')
+
+        // The additional bundle came from its own entry point - file1 only, never file2.
+        const renderOnlyContents = fs.readFileSync(renderOnlyFile).toString()
+        expect(renderOnlyContents).toContain('Hello from file1')
+        expect(renderOnlyContents).not.toContain('Good-bye from file2')
+        done()
+      })
+      .on('error', error => done(error))
+  })
+
+  test('an additional bundle exposes its own name as its standalone export', done => {
+    const distPath = gulpConfig.get('dist.to')
+    const renderOnlyMain = `${distPath}/renderOnly`
+    fs.writeFileSync(`${renderOnlyMain}.js`, renderOnlyFileContents)
+    gulpConfig.set('browser.bundles', [{ name: 'renderOnly', main: renderOnlyMain }])
+
+    const destPath = gulpConfig.get('browser.to')
+    const renderOnlyFile = `${destPath}/renderOnly.js`
+    expect.assertions(2)
+    bundle()
+      .on('finish', () => {
+        const resolved = path.resolve(renderOnlyFile)
+        delete require.cache[resolved]
+        const loaded = require(resolved)
+        expect(typeof loaded.file1).toBe('function')
+        expect(loaded.file2).toBeUndefined()
+        done()
+      })
+      .on('error', error => done(error))
+  })
+})
+
 describe('bundle ignore / exclude', () => {
   const optionalDepMarker = 'MARKER_FROM_THE_OPTIONAL_DEPENDENCY_CODE'
 

package/functions/bundleLint.mjs

@@ -1,12 +1,18 @@
 import { dest, src } from 'gulp'
 import * as gulpConfig from '../gulp.config.mjs'
 import { standardLint } from './partials/standardLint.mjs'
+import { getBundleConfigs } from './utilities/getBundleConfigs.mjs'
 
 /**
- * Applies Standard code style linting to bundled file.
+ * Applies Standard code style linting to every bundled file (the primary bundle, plus any
+ * additional ones from browser.bundles). The lint step itself never varies per bundle, so this is
+ * one shared src()/dest() pipeline fed every bundle's filename at once, rather than one pipeline
+ * per bundle - gulp's src()/dest() both accept an array of paths natively.
  * @memberOf module:js-build-tools
  * @returns {stream.Stream}
  */
-export const bundleLint = () => src(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`)
+export const bundleLint = () => src(
+  getBundleConfigs().map(({ name }) => `${gulpConfig.get('browser.to')}/${name}.js`)
+)
   .pipe(standardLint({ fix: true }))
   .pipe(dest(gulpConfig.get('browser.to')))

package/functions/bundleLint.test.mjs

@@ -62,4 +62,24 @@ describe('bundleLint', () => {
         done()
       })
   }, 10000)
+
+  test('lints every additional bundle too, not just the primary one', done => {
+    const browserPath = gulpConfig.get('browser.to')
+    const renderOnlyFile = `${browserPath}/renderOnly.js`
+    fs.writeFileSync(renderOnlyFile, lintableContents)
+    gulpConfig.set('browser.bundles', [{ name: 'renderOnly' }])
+    expect.assertions(2)
+    bundleLint()
+      .on('finish', () => {
+        const lintedContents = fs.readFileSync(renderOnlyFile).toString()
+        expect(countMatches(lintedContents, '"')).toEqual(0)
+        expect(countMatches(lintedContents, ';')).toEqual(0)
+        gulpConfig.set('browser.bundles', [])
+        done()
+      })
+      .on('error', error => {
+        console.error('Encountered error', error)
+        done(error)
+      })
+  }, 10000)
 })

package/functions/bundleMinify.mjs

@@ -1,9 +1,16 @@
 import * as gulpConfig from '../gulp.config.mjs'
 import { minifyFor } from './partials/minifyFor.mjs'
+import { getBundleConfigs } from './utilities/getBundleConfigs.mjs'
 
 /**
- * Creates the minified bundle file.
+ * Creates the minified file for every bundle (the primary bundle, plus any additional ones from
+ * browser.bundles). The minify step itself never varies per bundle, so this is one shared
+ * src()/dest() pipeline (inside minifyFor) fed every bundle's filename at once, rather than one
+ * pipeline per bundle - gulp's src() accepts an array of paths natively.
  * @memberOf module:js-build-tools
  * @returns {*}
  */
-export const bundleMinify = () => minifyFor(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`, gulpConfig.get('browser.to'))
+export const bundleMinify = () => minifyFor(
+  getBundleConfigs().map(({ name }) => `${gulpConfig.get('browser.to')}/${name}.js`),
+  gulpConfig.get('browser.to')
+)

package/functions/bundleMinify.test.mjs

@@ -7,9 +7,31 @@ const gulpConfig = testHelpers.gulpConfig
 jest.mock('./partials/minifyFor.mjs', () => ({ minifyFor: jest.fn(() => Promise.resolve(true)) }))
 
 describe('bundleMinify', () => {
-  test('calls minifyFor with configurations', () => {
+  afterEach(() => {
+    gulpConfig.set('browser.bundles', [])
+    minifyFor.mockClear()
+  })
+
+  test('calls minifyFor with the primary bundle', () => {
     expect.assertions(1)
     bundleMinify()
-    expect(minifyFor).toHaveBeenCalledWith(`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`, gulpConfig.get('browser.to'))
+    expect(minifyFor).toHaveBeenCalledWith(
+      [`${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`],
+      gulpConfig.get('browser.to')
+    )
+  })
+
+  test('calls minifyFor once, with every additional bundle included in the same array', () => {
+    gulpConfig.set('browser.bundles', [{ name: 'renderOnly' }])
+    expect.assertions(2)
+    bundleMinify()
+    expect(minifyFor).toHaveBeenCalledTimes(1)
+    expect(minifyFor).toHaveBeenCalledWith(
+      [
+        `${gulpConfig.get('browser.to')}/${gulpConfig.get('browser.name')}.js`,
+        `${gulpConfig.get('browser.to')}/renderOnly.js`
+      ],
+      gulpConfig.get('browser.to')
+    )
   })
 })

package/functions/gulpConfigEntries.test.mjs

@@ -0,0 +1,23 @@
+import { execFileSync } from 'child_process'
+import path from 'path'
+import * as esmConfig from '../gulp.config.mjs'
+
+const root = path.resolve(__dirname, '..')
+const readFromCjs = (dotPath) => JSON.parse(execFileSync(process.execPath, [
+  '-e',
+  `console.log(JSON.stringify(require('./gulp.config.js').get(${JSON.stringify(dotPath)})))`
+], { cwd: root }).toString())
+
+describe('gulp.config entries', () => {
+  test('the CommonJS entry exposes the same configuration as the ESM source', () => {
+    for (const dotPath of ['docs', 'browser', 'dist', 'typescript']) {
+      expect(readFromCjs(dotPath)).toEqual(JSON.parse(JSON.stringify(esmConfig.get(dotPath))))
+    }
+  })
+
+  test('the CommonJS entry carries browser.bundles and browser.ignore/exclude', () => {
+    for (const dotPath of ['browser.bundles', 'browser.ignore', 'browser.exclude']) {
+      expect(readFromCjs(dotPath)).toEqual(JSON.parse(JSON.stringify(esmConfig.get(dotPath))))
+    }
+  })
+})

package/functions/utilities/getBundleConfigs.mjs

@@ -0,0 +1,29 @@
+import * as gulpConfig from '../../gulp.config.mjs'
+
+/**
+ * Build the full list of bundles to produce for this project: the primary bundle (browser.name /
+ * dist.main / browser.ignore / browser.exclude, exactly as before browser.bundles existed) plus
+ * any additional bundles from browser.bundles - each falling back to the primary's main / ignore /
+ * exclude whenever its own isn't given, so a render-only (or any other variant) bundle only has to
+ * specify what's actually different about it.
+ * @memberOf module:utilities
+ * @returns {Array<{name: string, main: string, ignore: Array, exclude: Array}>}
+ */
+export const getBundleConfigs = () => {
+  const primary = {
+    name: gulpConfig.get('browser.name'),
+    main: gulpConfig.get('dist.main'),
+    ignore: gulpConfig.get('browser.ignore'),
+    exclude: gulpConfig.get('browser.exclude')
+  }
+  const additional = gulpConfig.get('browser.bundles') || []
+  return [
+    primary,
+    ...additional.map((bundleConfig) => ({
+      name: bundleConfig.name,
+      main: bundleConfig.main || primary.main,
+      ignore: bundleConfig.ignore || primary.ignore,
+      exclude: bundleConfig.exclude || primary.exclude
+    }))
+  ]
+}

package/gulp.config.js

@@ -1,255 +1,4 @@
-/**
- * Modify these configurations to match your project specifications.
- * @file
- * @author Joshua Heagle <joshuaheagle@gmail.com>
- * @version 3.0.0
- * @module gulpConfig
- * @memberOf module:js-build-tools
- */
-const { fileExists } = require('test-filesystem')
-
-/**
- * A setting that may be an array of strings or a string only.
- * @typedef {Array<string>|string} module:gulpConfig~ArrayableSetting
- */
-
-/**
- * A setting that may be true or false.
- * @typedef {boolean} module:gulpConfig~BooleanSetting
- */
-
-/**
- * A setting that may be flag 'false' or provide a StringSetting
- * @typedef {false|StringSetting} module:gulpConfig~FlagStringSetting
- */
-
-/**
- * An object of boolean settings used as flags.
- * @typedef {Object<string, BooleanSetting>} module:gulpConfig~FlagsSetting
- */
-
-/**
- * Configure cli options for running Jest.
- * @typedef {FlagsSetting} module:gulpConfig~JestTestFlags
- * @property {BooleanSetting} clearCache
- * @property {BooleanSetting} debug
- * @property {BooleanSetting} ignoreProjects:
- * @property {BooleanSetting} json
- * @property {BooleanSetting} selectProjects
- * @property {BooleanSetting} showConfig
- * @property {BooleanSetting} useStderr
- * @property {BooleanSetting} watch
- * @property {BooleanSetting} watchAll
- */
-
-/**
- * A setting that may only be a string.
- * @typedef {string} module:gulpConfig~StringSetting
- */
-
-/**
- * Any single configuration option is a Setting.
- * @typedef {ArrayableSetting|BooleanSetting|FlagsSetting|StringSetting} Setting
- */
-
-/**
- * Configurations for building the browser files.
- * @typedef {Object<string, Setting>} module:gulpConfig~BrowserConfig
- * @property {BooleanSetting} enabled - 'true' to generate browser bundled files; 'false' for node environment only
- * @property {StringSetting} from - The name to use for the browser-bundled output file (.js will be appended).
- * @property {StringSetting} name - The search pattern used for retrieving compiled distribution files.
- * @property {StringSetting} to - The output directory for browser-bundled files.
- */
-
-/**
- * Configurations for building the node distribution files.
- * @typedef {Object<string, Setting>} module:gulpConfig~DistConfig
- * @property {StringSetting} from - The search pattern used for gathering source files for distribution.
- * @property {StringSetting} main - Name of the entry the distribution file.
- * @property {StringSetting} to - The output directory for the distribution files.
- */
-
-/**
- * Configurations for copying the font files.
- * @typedef {Object<string, Setting>} module:gulpConfig~FontConfig
- * @property {BooleanSetting} enabled - Toggle copy directory of fonts on.
- * @property {StringSetting} from - Path to search for fonts.
- * @property {StringSetting} to - Path to output fonts.
- */
-
-/**
- * Configurations to minify and copy the images.
- * @typedef {Object<string, Setting>} module:gulpConfig~ImageConfig
- * @property {BooleanSetting} enabled - Toggle image minify and copy process.
- * @property {StringSetting} from - Path to search for images.
- * @property {StringSetting} to - Path to output images.
- */
-
-/**
- * Configurations to compile and generate the Readme file.
- * @typedef {Object<string, Setting>} module:gulpConfig~ReadmeConfig
- * @property {StringSetting} file - The name of the output documentation markdown file.
- * @property {StringSetting} from - Location of files to use for compiling documentation into the readme.
- * @property {ArrayableSetting} options - Options for formatting the output readme.
- * @property {StringSetting} template - The file which will be pre-fixed to your README.md output.
- * @property {StringSetting} to - The directory to output the readme file in.
- */
-
-/**
- * Configurations to compile and copy the sass files into css.
- * @typedef {Object<string, Setting>} module:gulpConfig~SassConfig
- * @property {BooleanSetting} enabled - Toggle SASS to CSS process on.
- * @property {StringSetting} from - The pattern for finding all sass files.
- * @property {StringSetting} path - The directory were sass files will be stored.
- * @property {StringSetting} to - The destination path for where generated CSS (from SASS files) should go.
- */
-
-/**
- * Configurations for running the test suite.
- * @typedef {Object<string, Setting>} module:gulpConfig~TestConfig
- * @property {JestTestFlags} options - Additional flags for programmatically running Jest Cli.
- * @property {ArrayableSetting} path - The directory where Jest test files are stored.
- * By default, stored as *.test.js adjacent to the files they are testing.
- * @property {ArrayableSetting} watch - The search pattern for watching files for changes.
- */
-
-/**
- * Configurations for compiling typescript into JS files.
- * @typedef {Object<string, Setting>} module:gulpConfig~TsConfig
- * @property {FlagStringSetting} config - The path the tsconfig file for running typescript or false if no ts file given.
- * @property {BooleanSetting} enabled - Toggle usage of typescript parsing.
- * @property {StringSetting} from - Pattern for finding the TypeScript files.
- * @property {StringSetting} to - Directory where parsed typescript files go.
- */
-
-/**
- * A set of Configurations options defined by Settings.
- * @typedef {Object<string, Setting>} module:gulpConfig~Configurations
- * @property {BrowserConfig} browser - Browser bundling configuration group.
- * @property {ArrayableSetting} cleanPaths - The paths for directories to delete before build.
- * @property {DistConfig} dist - Distribution file generation configuration group.
- * @property {FontConfig} fonts - Fonts copy configuration group.
- * @property {ImageConfig} images - Minify and copy the images configuration.
- * @property {ReadmeConfig} readme - Build readme files configuration.
- * @property {StringSetting} rootPath - Base directory of the project.
- * @property {SassConfig} sass - Compile CSS from SASS configuration.
- * @property {StringSetting} srcPath - The directory where your source files are stored (the files you manually created).
- * @property {TestConfig} test - Run test suite configuration.
- * @property {TsConfig} typescript - Compile from typescript configuration.
- */
-
-const { dotGet } = require('./dist/utilities/dotGet')
-const { dotSet } = require('./dist/utilities/dotSet')
-const { dotNotate } = require('./dist/utilities/dotNotate')
-const { readFileSync } = require('fs')
-
-const setDefaults = {
-  browser: {
-    enabled: true,
-    from: 'dist/**/*.js',
-    name: 'default',
-    to: 'browser',
-  },
-  cleanPaths: ['dist', 'browser'],
-  dist: {
-    from: 'src/**/!(*.test).js',
-    main: 'dist/main',
-    to: 'dist',
-  },
-  fonts: {
-    enabled: false,
-    from: 'src/fonts/**/*',
-    to: 'browser/fonts',
-  },
-  images: {
-    enabled: false,
-    from: 'src/img/**/*.+(png|jpg|jpeg|gif|svg)',
-    to: 'browser/img',
-  },
-  readme: {
-    file: 'README.md',
-    from: 'src/**/!(*.test).js',
-    options: 'utf8',
-    template: 'MAIN.md',
-    to: './'
-  },
-  rootPath: './',
-  sass: {
-    enabled: false,
-    from: 'sass/**/*.+(scss|sass)',
-    path: 'sass',
-    to: 'browser/css',
-  },
-  srcPath: 'src',
-  test: {
-    options: {
-      clearCache: false,
-      debug: false,
-      ignoreProjects: false,
-      json: false,
-      selectProjects: false,
-      showConfig: false,
-      useStderr: false,
-      watch: false,
-      watchAll: false,
-    },
-    path: ['src'],
-    watch: 'src/**/*.js'
-  },
-  typescript: {
-    config: false,
-    enabled: false,
-    from: 'src/**/*.ts',
-    to: 'dist',
-  },
-}
-/**
- * All the available configuration setting options for running the build.
- * @memberOf module:gulpConfig` `
- * @type {Configurations}
- */
-let gulpConfigurations = {}
-if (fileExists(process.cwd() + '/build-tools.config.json')) {
-  gulpConfigurations = JSON.parse(readFileSync(process.cwd() + '/build-tools.config.json').toString())
-} else {
-  if (fileExists('./build-tools.config.json')) {
-    gulpConfigurations = JSON.parse(readFileSync('./build-tools.config.json').toString())
-  } else {
-    console.warn('Missing config path, ensure you have a build-tools.config.js file in you project root')
-  }
-}
-
-const notation = dotNotate(setDefaults)
-for (let notationKey in notation) {
-  const arrayEnding = /(\.\d+)$/
-  if (arrayEnding.test(notationKey)) {
-    // ends in number a key then it must be an array; use the entire array
-    notationKey = notationKey.replace(arrayEnding, '')
-  }
-  const defaultValue = dotGet(setDefaults, notationKey)
-  const existingConfig = dotGet(gulpConfigurations, notationKey, defaultValue)
-  dotSet(gulpConfigurations, notationKey, existingConfig)
-}
-
-/**
- * Retrieve a value from the configurations, default may be returned.
- * @memberOf module:gulpConfig
- * @param {string|null} path
- * @param {*} defaultValue
- * @returns {*|null}
- */
-const get = (path = null, defaultValue = null) => dotGet(gulpConfigurations, path, defaultValue)
-
-/**
- * Specify a value for the configurations to use.
- * @memberOf module:gulpConfig
- * @param path
- * @param value
- * @returns {*}
- */
-const set = (path, value) => dotSet(gulpConfigurations, path, value)
-
-module.exports = {
-  get,
-  set
-}
+// gulp.config.mjs is the single source of truth. This CommonJS entry re-exports it, so CommonJS consumers
+// (dist/*.js, jsdoc.base.js, require('js-build-tools/gulp.config')) read exactly the same configuration.
+// Relies on require(esm), which Node 22.12+ supports natively.
+module.exports = require('./gulp.config.mjs')

package/gulp.config.mjs

@@ -60,6 +60,20 @@ import { fileExists } from 'test-filesystem'
  * @property {ArrayableSetting} exclude - Module names or file paths left out of the bundle entirely; requiring one at
  * runtime throws unless something else provides it (for example a script tag loading it separately). See
  * browserify's b.exclude(file).
+ * @property {Array<module:gulpConfig~AdditionalBundleConfig>} bundles - Additional bundles to produce alongside the
+ * primary one (name/dist.main/ignore/exclude above) - for example a render-only variant built from a different
+ * entry point than the full bundle. Empty by default: a project that never sets this gets exactly the one bundle it
+ * always did.
+ */
+/**
+ * One additional bundle - everything but `name` falls back to the primary bundle's own value when omitted, so an
+ * additional bundle only has to specify what's actually different about it.
+ * @typedef {Object<string, Setting>} module:gulpConfig~AdditionalBundleConfig
+ * @property {StringSetting} name - The name for this bundle's output file and standalone export - must be unique
+ * among all of a project's bundles.
+ * @property {StringSetting} [main] - This bundle's own entry point. Falls back to dist.main when omitted.
+ * @property {ArrayableSetting} [ignore] - This bundle's own ignore list. Falls back to browser.ignore when omitted.
+ * @property {ArrayableSetting} [exclude] - This bundle's own exclude list. Falls back to browser.exclude when omitted.
  */
 /**
  * Configurations for building the node distribution files.
@@ -150,6 +164,7 @@ import { readFileSync } from 'fs'
 
 const setDefaults = {
   browser: {
+    bundles: [],
     enabled: true,
     exclude: [],
     from: 'dist/**/*.js',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-build-tools",
-  "version": "5.4.0",
+  "version": "5.6.0",
   "description": "Standardised build process with gulp.",
   "main": "gulpfile.base.js",
   "exports": {
@@ -68,6 +68,7 @@
     "jest": "^30.5.2",
     "jest-environment-jsdom": "^30.5.2",
     "jsdoc-to-markdown": "^9.1.3",
+    "merge-stream": "^2.0.0",
     "postcss": "^8.5.28",
     "regenerator-runtime": "^0.14.1",
     "sass": "^1.105.0",
@@ -107,5 +108,8 @@
     "gulp-imagemin": "github:jheagle/gulp-imagemin#common-js-compatibility",
     "typedoc": "^0.28.20",
     "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=22.12.0"
   }
 }