weboptimizer 4.0.44 → 4.0.46

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weboptimizer",
-  "version": "4.0.44",
+  "version": "4.0.46",
   "description": "A generic web optimizer, (module) bundler and development environment.",
   "keywords": [
     "webpack",
@@ -77,7 +77,7 @@
     "lint:base": "eslint --no-warn-ignored *.ts */*.ts test/*/*.ts",
     "prepare": "yarn build",
     "prettify": "yarn lint:base --fix || true",
-    "test": "yarn build:test && node --experimental-vm-modules node_modules/.bin/jest --config ./weboptimizerJest.json --root-dir './' --test-regex '/test/.+\\\\.js$' test/browser.js test/configurator.js test/ejsLoader.js test/helper.js test/stylelintConfigurator.js test/index.js test/webpackConfigurator.js",
+    "test": "yarn build:test && node --experimental-vm-modules node_modules/.bin/jest --config ./weboptimizerJest.json --noStackTrace --root-dir './' --test-regex '/test/.+\\\\.js$' test/browser.js test/configurator.js test/ejsLoader.js test/helper.js test/stylelintConfigurator.js test/index.js test/webpackConfigurator.js",
     "test:coverage": "yarn test --ci --coverage --coverageReporters=text --coverageReporters=text-summary --silent --testLocationInResults",
     "test:coverage:report": "yarn test:coverage --coverageDirectory=.coverage --coverageReporters=lcov --outputFile=lcov.info",
     "test:watch": "yarn test --watch",
@@ -94,7 +94,7 @@
     "babel-loader": "^10.1.1",
     "babel-plugin-polyfill-corejs3": "^1.0.0",
     "babel-plugin-transform-rewrite-imports": "^1.5.4",
-    "clientnode": "4.0.1477",
+    "clientnode": "4.0.1480",
     "core-js": "^3.49.0",
     "ejs": "^6.0.1",
     "exports-loader": "^5.0.0",
@@ -108,8 +108,8 @@
     "rimraf": "^6.1.3",
     "script-loader": "^0.7.2",
     "typescript": "^6.0.3",
-    "webpack": "^5.109.1",
-    "webpack-cli": "^7.2.1",
+    "webpack": "^5.109.2",
+    "webpack-cli": "^7.2.2",
     "webpack-sources": "^3.5.1"
   },
   "devDependencies": {
@@ -132,7 +132,7 @@
     "cssnano": "^8.0.2",
     "eslint": "^10.8.0",
     "eslint-config-google": "^0.14.0",
-    "eslint-plugin-jsdoc": "^63.3.1",
+    "eslint-plugin-jsdoc": "^63.3.2",
     "favicons": "^7.3.1",
     "favicons-webpack-plugin": "^6.0.1",
     "globals": "^17.8.0",
@@ -142,7 +142,7 @@
     "mini-css-extract-plugin": "^2.10.2",
     "mkdirp": "^3.0.1",
     "node-fetch": "^3.3.2",
-    "postcss": "^8.5.23",
+    "postcss": "^8.5.25",
     "postcss-fontpath": "^1.0.0",
     "postcss-import": "^16.1.1",
     "postcss-loader": "^8.2.1",
@@ -157,7 +157,7 @@
     "terser-webpack-plugin": "^5.6.1",
     "typescript-eslint": "^8.65.0",
     "typescript-plugin-css-modules": "^5.2.0",
-    "web-documentation": "^1.0.43",
+    "web-documentation": "^1.0.44",
     "workbox-webpack-plugin": "^7.4.1"
   },
   "peerDependencies": {

package/webpackConfigurator.js

@@ -17,6 +17,7 @@
 */
 // region imports
 import { convertToValidVariableName, evaluate, escapeRegularExpressions, extend, importFilesystemAPI, isFileSync, isObject, isPlainObject, Logger, mask, optionalImport, represent, UTILITY_SCOPE } from 'clientnode';
+import { rm, writeFile } from 'fs/promises';
 import { extname, join, relative, resolve } from 'path';
 import util from 'util';
 import webpack from 'webpack';
@@ -762,6 +763,60 @@ if (configuration.path.configuration.json) try {
 } catch {
   log.debug('Optional configuration file', `"${configuration.path.configuration.json}" not available.`);
 }
+
+// region collapse multi-module ("multi-main") entry chunks into a barrel
+/*
+    NOTE: Webpack awaits a single (async) entry module before completing the
+    startup evaluation but does NOT await async modules that are referenced as
+    part of an array ("multi-main") entry chunk. As a consequence any
+    top-level "await" (async module) reachable from such an entry - and every
+    side effect depending on it, like jest's synchronous "describe" / "test"
+    registration - would run only after the synchronous startup phase already
+    finished (leading for example to "Cannot nest a describe inside a test").
+
+    To keep evaluation deterministic we collapse every chunk which bundles
+    more than one module into a single generated barrel module which webpack
+    treats (and, when async, awaits) as a whole. Re-exporting via "export *"
+    preserves the (named) exports of all bundled modules while guaranteeing
+    each one is evaluated in the given order.
+*/
+const generatedBarrelModuleFilePaths = [];
+const normalizedEntryInjection = {};
+for (const [chunkName, moduleIDs] of Object.entries(configuration.injection.entry.normalized)) if (Array.isArray(moduleIDs) && moduleIDs.length > 1) {
+  const barrelModuleFilePath = resolve(configuration.path.context, `.__${convertToValidVariableName(chunkName)}__.barrel.mjs`);
+  await writeFile(barrelModuleFilePath, moduleIDs.map(moduleID => {
+    const specifier = stripLoader(moduleID);
+    return `export * from ${JSON.stringify(specifier.startsWith('.') || specifier.startsWith('/') ? specifier : `./${specifier}`)}`;
+  }).join('\n') + '\n', {
+    encoding: configuration.encoding
+  });
+  generatedBarrelModuleFilePaths.push(barrelModuleFilePath);
+  normalizedEntryInjection[chunkName] = [`./${relative(configuration.path.context, barrelModuleFilePath)}`];
+} else normalizedEntryInjection[chunkName] = moduleIDs;
+if (generatedBarrelModuleFilePaths.length) pluginInstances.push({
+  apply: compiler => {
+    const removeGeneratedBarrelModules = async () => {
+      for (const filePath of generatedBarrelModuleFilePaths) try {
+        await rm(filePath, {
+          force: true
+        });
+      } catch (error) {
+        log.debug('Removing generated barrel entry module ' + `"${filePath}" failed:`, represent(error));
+      }
+    };
+
+    /*
+        NOTE: "shutdown" is an "AsyncSeriesHook" fired (and awaited) by
+        "compiler.close()" for both one-shot builds and watch-mode
+        teardown, so "tapPromise" guarantees the (async) removal finishes
+        before the process exits. "watchClose" would be a "SyncHook" which
+        cannot await a promise-based cleanup, hence it is not used here.
+    */
+    compiler.hooks.shutdown.tapPromise('WebOptimizerRemoveGeneratedBarrelModules', removeGeneratedBarrelModules);
+  }
+});
+// endregion
+
 export let webpackConfiguration = extend(true, {
   bail: !configuration.givenCommandLineArguments.includes('--watch'),
   context: configuration.path.context,
@@ -791,7 +846,7 @@ export let webpackConfiguration = extend(true, {
     typescript: false
   },
   // region input
-  entry: configuration.injection.entry.normalized,
+  entry: normalizedEntryInjection,
   externals: configuration.injection.external.modules,
   resolve: {
     alias: module.aliases,