js-build-tools 5.4.0 → 5.5.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/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.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.5.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",