weboptimizer 4.0.103 → 4.0.104

package/dist/plugins/RemoveStyleOnlyScripts.d.ts

@@ -0,0 +1,39 @@
+import type { Chunk, Compilation, Compiler, Module } from 'webpack';
+import type { RemoveStyleOnlyScriptsOptions } from '../type';
+/**
+ * Module type of modules representing extracted style sheets.
+ */
+export declare const EXTRACTED_STYLE_MODULE_TYPE = "css/mini-extract";
+/**
+ * Removes java script files of initial chunks which only consist of style
+ * sheets extracted into separate files like a dedicated "styles" entry. The
+ * remaining java script file would be (nearly) empty and useless.
+ */
+export declare class RemoveStyleOnlyScripts {
+    private defaultOptions;
+    private options;
+    constructor(options?: Partial<RemoveStyleOnlyScriptsOptions>);
+    /**
+     * Determines whether given module is an extracted style sheet or its
+     * empty java script counterpart created by the extraction loader.
+     * NOTE: Style sheet modules export their class name mapping which has to
+     * be kept.
+     * @param module - Module to check.
+     * @param compilation - Current compilation.
+     * @returns Indicator.
+     */
+    isExtractedStyle(module: Module, compilation: Compilation): boolean;
+    /**
+     * Determines whether java script files of given chunk can be removed
+     * safely.
+     * NOTE: Asynchronous chunks are still needed to load their style sheets
+     * and chunks hosting a runtime for other chunks are needed as well. Hot
+     * module replacement adds client modules so affected chunks are kept.
+     * @param chunk - Chunk to check.
+     * @param compilation - Current compilation.
+     * @returns Indicator.
+     */
+    isStyleOnly(chunk: Chunk, compilation: Compilation): boolean;
+    apply(compiler: Compiler): void;
+}
+export default RemoveStyleOnlyScripts;

package/dist/plugins/RemoveStyleOnlyScripts.js

@@ -0,0 +1,101 @@
+// #!/usr/bin/env babel-node
+// -*- coding: utf-8 -*-
+/** @module RemoveStyleOnlyScripts */
+'use strict';
+
+/* !
+    region header
+    Copyright Torben Sickert (info["~at~"]tsickert.com) 16.12.2012
+
+    License
+    -------
+
+    This library written by Torben Sickert stands under a creative commons
+    naming 3.0 unported license.
+    See https://creativecommons.org/licenses/by/3.0/deed.de
+    endregion
+*/
+// region imports
+function _defineProperty(r, t, o) { return (t = _toPropertyKey(t)) in r ? Object.defineProperty(r, t, { value: o, enumerable: !0, configurable: !0, writable: !0 }) : r[t] = o, r; }
+function _toPropertyKey(r) { var o = _toPrimitive(r, "string"); return "symbol" == typeof o ? o : o + ""; }
+function _toPrimitive(t, e) { if ("object" != typeof t || !t) return t; var r; if ("undefined" != typeof Symbol && void 0 !== (r = t[Symbol.toPrimitive])) { var i = r.call(t, e || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === e ? String : Number)(t); }
+// endregion
+/**
+ * Module type of modules representing extracted style sheets.
+ */
+export const EXTRACTED_STYLE_MODULE_TYPE = 'css/mini-extract';
+/**
+ * Removes java script files of initial chunks which only consist of style
+ * sheets extracted into separate files like a dedicated "styles" entry. The
+ * remaining java script file would be (nearly) empty and useless.
+ */
+export class RemoveStyleOnlyScripts {
+  constructor(options = {}) {
+    _defineProperty(this, "defaultOptions", {
+      javaScriptFilePattern: /\.[cm]?js(?:\?.*)?$/
+    });
+    _defineProperty(this, "options", void 0);
+    this.options = {
+      ...this.defaultOptions,
+      ...options
+    };
+  }
+  /**
+   * Determines whether given module is an extracted style sheet or its
+   * empty java script counterpart created by the extraction loader.
+   * NOTE: Style sheet modules export their class name mapping which has to
+   * be kept.
+   * @param module - Module to check.
+   * @param compilation - Current compilation.
+   * @returns Indicator.
+   */
+  isExtractedStyle(module, compilation) {
+    if (module.type === EXTRACTED_STYLE_MODULE_TYPE) return true;
+    const loaders = module.loaders;
+    if (!(Array.isArray(loaders) && loaders.some(({
+      loader
+    }) => loader === this.options.loader))) return false;
+    const providedExports = compilation.moduleGraph.getProvidedExports(module);
+    return Array.isArray(providedExports) && providedExports.length === 0;
+  }
+  /**
+   * Determines whether java script files of given chunk can be removed
+   * safely.
+   * NOTE: Asynchronous chunks are still needed to load their style sheets
+   * and chunks hosting a runtime for other chunks are needed as well. Hot
+   * module replacement adds client modules so affected chunks are kept.
+   * @param chunk - Chunk to check.
+   * @param compilation - Current compilation.
+   * @returns Indicator.
+   */
+  isStyleOnly(chunk, compilation) {
+    if (!chunk.isOnlyInitial()) return false;
+    for (const group of chunk.groupsIterable) if (group.chunks.length !== 1) return false;
+    for (const entrypoint of compilation.entrypoints.values()) if (entrypoint.getRuntimeChunk() === chunk && !chunk.isInGroup(entrypoint)) return false;
+    const {
+      chunkGraph
+    } = compilation;
+    if (chunkGraph.getNumberOfChunkModules(chunk) === 0) return false;
+    for (const module of chunkGraph.getChunkModulesIterable(chunk)) if (!this.isExtractedStyle(module, compilation)) return false;
+    return true;
+  }
+  apply(compiler) {
+    const name = 'RemoveStyleOnlyScripts';
+    compiler.hooks.thisCompilation.tap(name, compilation => {
+      compilation.hooks.processAssets.tap({
+        name,
+        /*
+            NOTE: Has to run before html plugins determine
+            their asset tags and source maps are generated.
+        */
+        stage: compiler.webpack.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE
+      }, () => {
+        for (const chunk of compilation.chunks) if (this.isStyleOnly(chunk, compilation)) for (const file of Array.from(chunk.files)) if (this.options.javaScriptFilePattern.test(file)) {
+          chunk.files.delete(file);
+          compilation.deleteAsset(file);
+        }
+      });
+    });
+  }
+}
+export default RemoveStyleOnlyScripts;

package/dist/type.d.ts

@@ -87,6 +87,10 @@ export interface InPlaceAssetsIntoHTMLOptions {
     javaScript: InPlaceAssetConfiguration | null;
     htmlPlugin: typeof HtmlWebpackPlugin;
 }
+export interface RemoveStyleOnlyScriptsOptions {
+    javaScriptFilePattern: RegExp;
+    loader: string;
+}
 export interface AssetPathConfiguration {
     base: string;
     cascadingStyleSheet: string;

package/dist/webpackConfigurator.js

@@ -38,6 +38,7 @@ import getConfiguration from "./configurator.js";
 import { determineAssetType, determineExternalRequest, determineModuleFilePath, getClosestPackageDescriptor, isFilePathInLocation, normalizePaths, stripLoader } from "./helper.js";
 import InPlaceAssetsIntoHTML from "./plugins/InPlaceAssetsIntoHTML.js";
 import HTMLTransformation from "./plugins/HTMLTransformation.js";
+import RemoveStyleOnlyScripts from "./plugins/RemoveStyleOnlyScripts.js";
 
 // Wait until optional filesystem modules have been loaded.
 await importFilesystemAPI();
@@ -206,9 +207,18 @@ if (!(configuration.needed.javaScript || configuration.needed.javaScriptExtensio
 ///// endregion
 ///// region extract cascading style sheets
 const cssOutputPath = configuration.files.compose.cascadingStyleSheet;
-if (cssOutputPath && plugins.MiniCSSExtract) pluginInstances.push(new plugins.MiniCSSExtract({
-  filename: typeof cssOutputPath === 'string' ? relative(configuration.path.target.base, cssOutputPath) : cssOutputPath
-}));
+if (cssOutputPath && plugins.MiniCSSExtract) {
+  pluginInstances.push(new plugins.MiniCSSExtract({
+    filename: typeof cssOutputPath === 'string' ? relative(configuration.path.target.base, cssOutputPath) : cssOutputPath
+  }));
+  /*
+      NOTE: Chunks consisting of extracted style sheets only would result in
+      nearly empty and useless java script files.
+  */
+  pluginInstances.push(new RemoveStyleOnlyScripts({
+    loader: plugins.MiniCSSExtract.loader
+  }));
+}
 ///// endregion
 ///// region performs implicit external logic
 if (configuration.injection.external.modules === '__implicit__')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weboptimizer",
-  "version": "4.0.103",
+  "version": "4.0.104",
   "description": "A generic web optimizer, (module) bundler and development environment.",
   "keywords": [
     "webpack",
@@ -69,7 +69,7 @@
     "lint:base": "eslint --config dist/eslint.config.js --no-warn-ignored src/*.ts src/*/*.ts src/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 --noStackTrace --root-dir './' --test-regex '/dist/test/.+\\\\.js$' dist/test/browser.js dist/test/configurator.js dist/test/ejsLoader.js dist/test/helper.js dist/test/HTMLTransformation.js dist/test/InPlaceAssetsIntoHTML.js dist/test/stylelintConfigurator.js dist/test/index.js dist/test/webpackConfigurator.js",
+    "test": "yarn build:test && node --experimental-vm-modules node_modules/.bin/jest --config ./weboptimizerJest.json --noStackTrace --root-dir './' --test-regex '/dist/test/.+\\\\.js$' dist/test/browser.js dist/test/configurator.js dist/test/ejsLoader.js dist/test/helper.js dist/test/HTMLTransformation.js dist/test/InPlaceAssetsIntoHTML.js dist/test/RemoveStyleOnlyScripts.js dist/test/stylelintConfigurator.js dist/test/index.js dist/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",