webpack 5.59.0 → 5.94.0

package/lib/FlagDependencyUsagePlugin.js

@@ -24,6 +24,9 @@ const { getEntryRuntime, mergeRuntimeOwned } = require("./util/runtime");
 
 const { NO_EXPORTS_REFERENCED, EXPORTS_OBJECT_REFERENCED } = Dependency;
 
+const PLUGIN_NAME = "FlagDependencyUsagePlugin";
+const PLUGIN_LOGGER_NAME = `webpack.${PLUGIN_NAME}`;
+
 class FlagDependencyUsagePlugin {
 	/**
 	 * @param {boolean} global do a global analysis instead of per runtime
@@ -38,13 +41,10 @@ class FlagDependencyUsagePlugin {
 	 * @returns {void}
 	 */
 	apply(compiler) {
-		compiler.hooks.compilation.tap("FlagDependencyUsagePlugin", compilation => {
+		compiler.hooks.compilation.tap(PLUGIN_NAME, compilation => {
 			const moduleGraph = compilation.moduleGraph;
 			compilation.hooks.optimizeDependencies.tap(
-				{
-					name: "FlagDependencyUsagePlugin",
-					stage: STAGE_DEFAULT
-				},
+				{ name: PLUGIN_NAME, stage: STAGE_DEFAULT },
 				modules => {
 					if (compilation.moduleMemCaches) {
 						throw new Error(
@@ -52,9 +52,7 @@ class FlagDependencyUsagePlugin {
 						);
 					}
 
-					const logger = compilation.getLogger(
-						"webpack.FlagDependencyUsagePlugin"
-					);
+					const logger = compilation.getLogger(PLUGIN_LOGGER_NAME);
 					/** @type {Map<ExportsInfo, Module>} */
 					const exportInfoToModuleMap = new Map();
 
@@ -310,7 +308,7 @@ class FlagDependencyUsagePlugin {
 						}
 					};
 					/** @type {RuntimeSpec} */
-					let globalRuntime = undefined;
+					let globalRuntime;
 					for (const [
 						entryName,
 						{ dependencies: deps, includeDependencies: includeDeps, options }
@@ -334,7 +332,9 @@ class FlagDependencyUsagePlugin {
 					}
 
 					while (queue.length) {
-						const [module, runtime] = queue.dequeue();
+						const [module, runtime] = /** @type {[Module, RuntimeSpec]} */ (
+							queue.dequeue()
+						);
 						processModule(module, runtime, false);
 					}
 					logger.timeEnd("trace exports usage in graph");

package/lib/FlagEntryExportAsUsedPlugin.js

@@ -9,7 +9,13 @@ const { getEntryRuntime } = require("./util/runtime");
 
 /** @typedef {import("./Compiler")} Compiler */
 
+const PLUGIN_NAME = "FlagEntryExportAsUsedPlugin";
+
 class FlagEntryExportAsUsedPlugin {
+	/**
+	 * @param {boolean} nsObjectUsed true, if the ns object is used
+	 * @param {string} explanation explanation for the reason
+	 */
 	constructor(nsObjectUsed, explanation) {
 		this.nsObjectUsed = nsObjectUsed;
 		this.explanation = explanation;
@@ -21,32 +27,29 @@ class FlagEntryExportAsUsedPlugin {
 	 * @returns {void}
 	 */
 	apply(compiler) {
-		compiler.hooks.thisCompilation.tap(
-			"FlagEntryExportAsUsedPlugin",
-			compilation => {
-				const moduleGraph = compilation.moduleGraph;
-				compilation.hooks.seal.tap("FlagEntryExportAsUsedPlugin", () => {
-					for (const [
-						entryName,
-						{ dependencies: deps, options }
-					] of compilation.entries) {
-						const runtime = getEntryRuntime(compilation, entryName, options);
-						for (const dep of deps) {
-							const module = moduleGraph.getModule(dep);
-							if (module) {
-								const exportsInfo = moduleGraph.getExportsInfo(module);
-								if (this.nsObjectUsed) {
-									exportsInfo.setUsedInUnknownWay(runtime);
-								} else {
-									exportsInfo.setAllKnownExportsUsed(runtime);
-								}
-								moduleGraph.addExtraReason(module, this.explanation);
+		compiler.hooks.thisCompilation.tap(PLUGIN_NAME, compilation => {
+			const moduleGraph = compilation.moduleGraph;
+			compilation.hooks.seal.tap(PLUGIN_NAME, () => {
+				for (const [
+					entryName,
+					{ dependencies: deps, options }
+				] of compilation.entries) {
+					const runtime = getEntryRuntime(compilation, entryName, options);
+					for (const dep of deps) {
+						const module = moduleGraph.getModule(dep);
+						if (module) {
+							const exportsInfo = moduleGraph.getExportsInfo(module);
+							if (this.nsObjectUsed) {
+								exportsInfo.setUsedInUnknownWay(runtime);
+							} else {
+								exportsInfo.setAllKnownExportsUsed(runtime);
 							}
+							moduleGraph.addExtraReason(module, this.explanation);
 						}
 					}
-				});
-			}
-		);
+				}
+			});
+		});
 	}
 }
 

package/lib/Generator.js

@@ -7,11 +7,13 @@
 
 /** @typedef {import("webpack-sources").Source} Source */
 /** @typedef {import("./ChunkGraph")} ChunkGraph */
+/** @typedef {import("./CodeGenerationResults")} CodeGenerationResults */
 /** @typedef {import("./Compilation")} Compilation */
 /** @typedef {import("./ConcatenationScope")} ConcatenationScope */
 /** @typedef {import("./DependencyTemplate")} DependencyTemplate */
 /** @typedef {import("./DependencyTemplates")} DependencyTemplates */
 /** @typedef {import("./Module").ConcatenationBailoutReasonContext} ConcatenationBailoutReasonContext */
+/** @typedef {import("./Module").RuntimeRequirements} RuntimeRequirements */
 /** @typedef {import("./ModuleGraph")} ModuleGraph */
 /** @typedef {import("./NormalModule")} NormalModule */
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
@@ -19,29 +21,32 @@
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
 
 /**
- * @typedef {Object} GenerateContext
+ * @typedef {object} GenerateContext
  * @property {DependencyTemplates} dependencyTemplates mapping from dependencies to templates
  * @property {RuntimeTemplate} runtimeTemplate the runtime template
  * @property {ModuleGraph} moduleGraph the module graph
  * @property {ChunkGraph} chunkGraph the chunk graph
- * @property {Set<string>} runtimeRequirements the requirements for runtime
+ * @property {RuntimeRequirements} runtimeRequirements the requirements for runtime
  * @property {RuntimeSpec} runtime the runtime
  * @property {ConcatenationScope=} concatenationScope when in concatenated module, information about other concatenated modules
+ * @property {CodeGenerationResults=} codeGenerationResults code generation results of other modules (need to have a codeGenerationDependency to use that)
  * @property {string} type which kind of code should be generated
  * @property {function(): Map<string, any>=} getData get access to the code generation data
  */
 
 /**
- * @typedef {Object} UpdateHashContext
+ * @typedef {object} UpdateHashContext
  * @property {NormalModule} module the module
  * @property {ChunkGraph} chunkGraph
  * @property {RuntimeSpec} runtime
+ * @property {RuntimeTemplate=} runtimeTemplate
  */
 
-/**
- *
- */
 class Generator {
+	/**
+	 * @param {Record<string, Generator>} map map of types
+	 * @returns {ByTypeGenerator} generator by type
+	 */
 	static byType(map) {
 		return new ByTypeGenerator(map);
 	}
@@ -103,6 +108,9 @@ class Generator {
 }
 
 class ByTypeGenerator extends Generator {
+	/**
+	 * @param {Record<string, Generator>} map map of types
+	 */
 	constructor(map) {
 		super();
 		this.map = map;
@@ -122,8 +130,8 @@ class ByTypeGenerator extends Generator {
 	 * @param {string=} type source type
 	 * @returns {number} estimate size of the module
 	 */
-	getSize(module, type) {
-		const t = type || "javascript";
+	getSize(module, type = "javascript") {
+		const t = type;
 		const generator = this.map[t];
 		return generator ? generator.getSize(module, t) : 0;
 	}

package/lib/GraphHelpers.js

@@ -33,5 +33,6 @@ const connectChunkGroupParentAndChild = (parent, child) => {
 	}
 };
 
-exports.connectChunkGroupAndChunk = connectChunkGroupAndChunk;
-exports.connectChunkGroupParentAndChild = connectChunkGroupParentAndChild;
+module.exports.connectChunkGroupAndChunk = connectChunkGroupAndChunk;
+module.exports.connectChunkGroupParentAndChild =
+	connectChunkGroupParentAndChild;

package/lib/HookWebpackError.js

@@ -12,7 +12,7 @@ const WebpackError = require("./WebpackError");
 /**
  * @template T
  * @callback Callback
- * @param {Error=} err
+ * @param {Error | null} err
  * @param {T=} stats
  * @returns {void}
  */
@@ -51,22 +51,20 @@ module.exports.makeWebpackError = makeWebpackError;
 
 /**
  * @template T
- * @param {function(WebpackError=, T=): void} callback webpack error callback
+ * @param {function(WebpackError | null, T=): void} callback webpack error callback
  * @param {string} hook name of hook
  * @returns {Callback<T>} generic callback
  */
-const makeWebpackErrorCallback = (callback, hook) => {
-	return (err, result) => {
-		if (err) {
-			if (err instanceof WebpackError) {
-				callback(err);
-				return;
-			}
-			callback(new HookWebpackError(err, hook));
+const makeWebpackErrorCallback = (callback, hook) => (err, result) => {
+	if (err) {
+		if (err instanceof WebpackError) {
+			callback(err);
 			return;
 		}
-		callback(null, result);
-	};
+		callback(new HookWebpackError(err, hook));
+		return;
+	}
+	callback(null, result);
 };
 
 module.exports.makeWebpackErrorCallback = makeWebpackErrorCallback;
@@ -85,7 +83,7 @@ const tryRunOrWebpackError = (fn, hook) => {
 		if (err instanceof WebpackError) {
 			throw err;
 		}
-		throw new HookWebpackError(err, hook);
+		throw new HookWebpackError(/** @type {Error} */ (err), hook);
 	}
 	return r;
 };