webpack 5.85.0 → 5.88.1

package/lib/Generator.js

@@ -45,6 +45,10 @@
  *
  */
 class Generator {
+	/**
+	 * @param {Record<string, Generator>} map map of types
+	 * @returns {ByTypeGenerator} generator by type
+	 */
 	static byType(map) {
 		return new ByTypeGenerator(map);
 	}
@@ -106,6 +110,9 @@ class Generator {
 }
 
 class ByTypeGenerator extends Generator {
+	/**
+	 * @param {Record<string, Generator>} map map of types
+	 */
 	constructor(map) {
 		super();
 		this.map = map;

package/lib/HotModuleReplacementPlugin.js

@@ -189,6 +189,10 @@ class HotModuleReplacementPlugin {
 			return true;
 		};
 
+		/**
+		 * @param {JavascriptParser} parser the parser
+		 * @returns {void}
+		 */
 		const applyModuleHot = parser => {
 			parser.hooks.evaluateIdentifier.for("module.hot").tap(
 				{
@@ -221,6 +225,10 @@ class HotModuleReplacementPlugin {
 				.tap(PLUGIN_NAME, createHMRExpressionHandler(parser));
 		};
 
+		/**
+		 * @param {JavascriptParser} parser the parser
+		 * @returns {void}
+		 */
 		const applyImportMetaHot = parser => {
 			parser.hooks.evaluateIdentifier
 				.for("import.meta.webpackHot")

package/lib/InitFragment.js

@@ -10,17 +10,21 @@ const makeSerializable = require("./util/makeSerializable");
 
 /** @typedef {import("webpack-sources").Source} Source */
 /** @typedef {import("./Generator").GenerateContext} GenerateContext */
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 
 /**
- * @param {InitFragment} fragment the init fragment
+ * @template T
+ * @param {InitFragment<T>} fragment the init fragment
  * @param {number} index index
- * @returns {[InitFragment, number]} tuple with both
+ * @returns {[InitFragment<T>, number]} tuple with both
  */
 const extractFragmentIndex = (fragment, index) => [fragment, index];
 
 /**
- * @param {[InitFragment, number]} a first pair
- * @param {[InitFragment, number]} b second pair
+ * @template T
+ * @param {[InitFragment<T>, number]} a first pair
+ * @param {[InitFragment<T>, number]} b second pair
  * @returns {number} sort value
  */
 const sortFragmentWithIndex = ([a, i], [b, j]) => {
@@ -66,6 +70,14 @@ class InitFragment {
 		return this.endContent;
 	}
 
+	/**
+	 * @template Context
+	 * @template T
+	 * @param {Source} source sources
+	 * @param {InitFragment<T>[]} initFragments init fragments
+	 * @param {Context} context context
+	 * @returns {Source} source
+	 */
 	static addToSource(source, initFragments, context) {
 		if (initFragments.length > 0) {
 			// Sort fragments by position. If 2 fragments have the same position,
@@ -77,7 +89,12 @@ class InitFragment {
 			// Deduplicate fragments. If a fragment has no key, it is always included.
 			const keyedFragments = new Map();
 			for (const [fragment] of sortedFragments) {
-				if (typeof fragment.mergeAll === "function") {
+				if (
+					typeof (
+						/** @type {InitFragment<T> & { mergeAll?: (fragments: InitFragment[]) => InitFragment[] }} */
+						(fragment).mergeAll
+					) === "function"
+				) {
 					if (!fragment.key) {
 						throw new Error(
 							`InitFragment with mergeAll function must have a valid key: ${fragment.constructor.name}`
@@ -125,6 +142,9 @@ class InitFragment {
 		}
 	}
 
+	/**
+	 * @param {ObjectSerializerContext} context context
+	 */
 	serialize(context) {
 		const { write } = context;
 
@@ -135,6 +155,9 @@ class InitFragment {
 		write(this.endContent);
 	}
 
+	/**
+	 * @param {ObjectDeserializerContext} context context
+	 */
 	deserialize(context) {
 		const { read } = context;
 

package/lib/JavascriptMetaInfoPlugin.js

@@ -13,6 +13,7 @@ const {
 const InnerGraph = require("./optimize/InnerGraph");
 
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./Module").BuildInfo} BuildInfo */
 /** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
 
 const PLUGIN_NAME = "JavascriptMetaInfoPlugin";
@@ -33,8 +34,11 @@ class JavascriptMetaInfoPlugin {
 				 */
 				const handler = parser => {
 					parser.hooks.call.for("eval").tap(PLUGIN_NAME, () => {
-						parser.state.module.buildInfo.moduleConcatenationBailout = "eval()";
-						parser.state.module.buildInfo.usingEval = true;
+						const buildInfo =
+							/** @type {BuildInfo} */
+							(parser.state.module.buildInfo);
+						buildInfo.moduleConcatenationBailout = "eval()";
+						buildInfo.usingEval = true;
 						const currentSymbol = InnerGraph.getTopLevelSymbol(parser.state);
 						if (currentSymbol) {
 							InnerGraph.addUsage(parser.state, null, currentSymbol);
@@ -43,11 +47,12 @@ class JavascriptMetaInfoPlugin {
 						}
 					});
 					parser.hooks.finish.tap(PLUGIN_NAME, () => {
-						let topLevelDeclarations =
-							parser.state.module.buildInfo.topLevelDeclarations;
+						const buildInfo =
+							/** @type {BuildInfo} */
+							(parser.state.module.buildInfo);
+						let topLevelDeclarations = buildInfo.topLevelDeclarations;
 						if (topLevelDeclarations === undefined) {
-							topLevelDeclarations =
-								parser.state.module.buildInfo.topLevelDeclarations = new Set();
+							topLevelDeclarations = buildInfo.topLevelDeclarations = new Set();
 						}
 						for (const name of parser.scope.definitions.asSet()) {
 							const freeInfo = parser.getFreeInfoFromVariable(name);

package/lib/LibManifestPlugin.js

@@ -12,15 +12,29 @@ const { compareModulesById } = require("./util/comparators");
 const { dirname, mkdirp } = require("./util/fs");
 
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./Module").BuildMeta} BuildMeta */
 
 /**
  * @typedef {Object} ManifestModuleData
  * @property {string | number} id
- * @property {Object} buildMeta
- * @property {boolean | string[]} exports
+ * @property {BuildMeta} buildMeta
+ * @property {boolean | string[] | undefined} exports
+ */
+
+/**
+ * @typedef {Object} LibManifestPluginOptions
+ * @property {string=} context Context of requests in the manifest file (defaults to the webpack context).
+ * @property {boolean=} entryOnly If true, only entry points will be exposed (default: true).
+ * @property {boolean=} format If true, manifest json file (output) will be formatted.
+ * @property {string=} name Name of the exposed dll function (external name, use value of 'output.library').
+ * @property {string} path Absolute path to the manifest json file (output).
+ * @property {string=} type Type of the dll bundle (external type, use value of 'output.libraryTarget').
  */
 
 class LibManifestPlugin {
+	/**
+	 * @param {LibManifestPluginOptions} options the options
+	 */
 	constructor(options) {
 		this.options = options;
 	}
@@ -67,7 +81,9 @@ class LibManifestPlugin {
 								continue;
 							}
 							const ident = module.libIdent({
-								context: this.options.context || compiler.options.context,
+								context:
+									this.options.context ||
+									/** @type {string} */ (compiler.options.context),
 								associatedObjectForCache: compiler.root
 							});
 							if (ident) {
@@ -76,7 +92,7 @@ class LibManifestPlugin {
 								/** @type {ManifestModuleData} */
 								const data = {
 									id: chunkGraph.getModuleId(module),
-									buildMeta: module.buildMeta,
+									buildMeta: /** @type {BuildMeta} */ (module.buildMeta),
 									exports: Array.isArray(providedExports)
 										? providedExports
 										: undefined

package/lib/Module.js

@@ -107,6 +107,12 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /** @typedef {KnownBuildMeta & Record<string, any>} BuildMeta */
+/** @typedef {Record<string, any>} BuildInfo */
+
+/**
+ * @typedef {Object} FactoryMeta
+ * @property {boolean=} sideEffectFree
+ */
 
 const EMPTY_RESOLVE_OPTIONS = {};
 
@@ -116,6 +122,11 @@ const DEFAULT_TYPES_UNKNOWN = new Set(["unknown"]);
 const DEFAULT_TYPES_JS = new Set(["javascript"]);
 
 const deprecatedNeedRebuild = util.deprecate(
+	/**
+	 * @param {Module} module the module
+	 * @param {NeedBuildContext} context context info
+	 * @returns {boolean} true, when rebuild is needed
+	 */
 	(module, context) => {
 		return module.needRebuild(
 			context.fileSystemInfo.getDeprecatedFileTimestamps(),
@@ -153,7 +164,7 @@ class Module extends DependenciesBlock {
 		// Info from Factory
 		/** @type {ResolveOptions | undefined} */
 		this.resolveOptions = EMPTY_RESOLVE_OPTIONS;
-		/** @type {object | undefined} */
+		/** @type {FactoryMeta | undefined} */
 		this.factoryMeta = undefined;
 		// TODO refactor this -> options object filled from Factory
 		// TODO webpack 6: use an enum
@@ -169,7 +180,7 @@ class Module extends DependenciesBlock {
 		this._errors = undefined;
 		/** @type {BuildMeta | undefined} */
 		this.buildMeta = undefined;
-		/** @type {Record<string, any> | undefined} */
+		/** @type {BuildInfo | undefined} */
 		this.buildInfo = undefined;
 		/** @type {Dependency[] | undefined} */
 		this.presentationalDependencies = undefined;
@@ -433,7 +444,7 @@ class Module extends DependenciesBlock {
 
 	/**
 	 * @param {ModuleGraph} moduleGraph the module graph
-	 * @param {boolean} strict the importing module is strict
+	 * @param {boolean | undefined} strict the importing module is strict
 	 * @returns {"namespace" | "default-only" | "default-with-named" | "dynamic"} export type
 	 * "namespace": Exports is already a namespace object. namespace = exports.
 	 * "dynamic": Check at runtime if __esModule is set. When set: namespace = { ...exports, default: exports }. When not set: namespace = { default: exports }.

package/lib/ModuleDependencyError.js

@@ -23,7 +23,7 @@ class ModuleDependencyError extends WebpackError {
 		this.name = "ModuleDependencyError";
 		this.details =
 			err && !(/** @type {any} */ (err).hideStack)
-				? err.stack.split("\n").slice(1).join("\n")
+				? /** @type {string} */ (err.stack).split("\n").slice(1).join("\n")
 				: undefined;
 		this.module = module;
 		this.loc = loc;
@@ -32,7 +32,9 @@ class ModuleDependencyError extends WebpackError {
 
 		if (err && /** @type {any} */ (err).hideStack) {
 			this.stack =
-				err.stack.split("\n").slice(1).join("\n") + "\n\n" + this.stack;
+				/** @type {string} */ (err.stack).split("\n").slice(1).join("\n") +
+				"\n\n" +
+				this.stack;
 		}
 	}
 }

package/lib/ModuleDependencyWarning.js

@@ -23,7 +23,7 @@ class ModuleDependencyWarning extends WebpackError {
 		this.name = "ModuleDependencyWarning";
 		this.details =
 			err && !(/** @type {any} */ (err).hideStack)
-				? err.stack.split("\n").slice(1).join("\n")
+				? /** @type {string} */ (err.stack).split("\n").slice(1).join("\n")
 				: undefined;
 		this.module = module;
 		this.loc = loc;
@@ -32,7 +32,9 @@ class ModuleDependencyWarning extends WebpackError {
 
 		if (err && /** @type {any} */ (err).hideStack) {
 			this.stack =
-				err.stack.split("\n").slice(1).join("\n") + "\n\n" + this.stack;
+				/** @type {string} */ (err.stack).split("\n").slice(1).join("\n") +
+				"\n\n" +
+				this.stack;
 		}
 	}
 }

package/lib/ModuleGraph.js

@@ -35,14 +35,15 @@ const getConnectionsByOriginModule = set => {
 	const map = new Map();
 	/** @type {Module | 0} */
 	let lastModule = 0;
-	/** @type {ModuleGraphConnection[]} */
+	/** @type {ModuleGraphConnection[] | undefined} */
 	let lastList = undefined;
 	for (const connection of set) {
 		const { originModule } = connection;
 		if (lastModule === originModule) {
-			lastList.push(connection);
+			/** @type {ModuleGraphConnection[]} */
+			(lastList).push(connection);
 		} else {
-			lastModule = originModule;
+			lastModule = /** @type {Module} */ (originModule);
 			const list = map.get(originModule);
 			if (list !== undefined) {
 				lastList = list;
@@ -65,12 +66,13 @@ const getConnectionsByModule = set => {
 	const map = new Map();
 	/** @type {Module | 0} */
 	let lastModule = 0;
-	/** @type {ModuleGraphConnection[]} */
+	/** @type {ModuleGraphConnection[] | undefined} */
 	let lastList = undefined;
 	for (const connection of set) {
 		const { module } = connection;
 		if (lastModule === module) {
-			lastList.push(connection);
+			/** @type {ModuleGraphConnection[]} */
+			(lastList).push(connection);
 		} else {
 			lastModule = module;
 			const list = map.get(module);
@@ -99,13 +101,13 @@ class ModuleGraphModule {
 		this.optimizationBailout = [];
 		/** @type {ExportsInfo} */
 		this.exports = new ExportsInfo();
-		/** @type {number} */
+		/** @type {number | null} */
 		this.preOrderIndex = null;
-		/** @type {number} */
+		/** @type {number | null} */
 		this.postOrderIndex = null;
-		/** @type {number} */
+		/** @type {number | null} */
 		this.depth = null;
-		/** @type {ModuleProfile} */
+		/** @type {ModuleProfile | undefined | null} */
 		this.profile = undefined;
 		/** @type {boolean} */
 		this.async = false;
@@ -116,20 +118,20 @@ class ModuleGraphModule {
 
 class ModuleGraph {
 	constructor() {
-		/** @type {WeakMap<Dependency, ModuleGraphConnection>} */
+		/** @type {WeakMap<Dependency, ModuleGraphConnection | null>} */
 		this._dependencyMap = new WeakMap();
 		/** @type {Map<Module, ModuleGraphModule>} */
 		this._moduleMap = new Map();
 		/** @type {WeakMap<any, Object>} */
 		this._metaMap = new WeakMap();
 
-		/** @type {WeakTupleMap<any[], any>} */
+		/** @type {WeakTupleMap<any[], any> | undefined} */
 		this._cache = undefined;
 
 		/** @type {Map<Module, WeakTupleMap<any, any>>} */
 		this._moduleMemCaches = undefined;
 
-		/** @type {string} */
+		/** @type {string | undefined} */
 		this._cacheStage = undefined;
 	}
 
@@ -221,7 +223,9 @@ class ModuleGraph {
 	 * @returns {void}
 	 */
 	updateModule(dependency, module) {
-		const connection = this.getConnection(dependency);
+		const connection =
+			/** @type {ModuleGraphConnection} */
+			(this.getConnection(dependency));
 		if (connection.module === module) return;
 		const newConnection = connection.clone();
 		newConnection.module = module;
@@ -375,7 +379,7 @@ class ModuleGraph {
 
 	/**
 	 * @param {Dependency} dependency the dependency to look for a referenced module
-	 * @returns {Module} the referenced module
+	 * @returns {Module | null} the referenced module
 	 */
 	getResolvedModule(dependency) {
 		const connection = this.getConnection(dependency);
@@ -398,7 +402,10 @@ class ModuleGraph {
 				) {
 					let foundConnection;
 					for (const connection of mgm._unassignedConnections) {
-						this._dependencyMap.set(connection.dependency, connection);
+						this._dependencyMap.set(
+							/** @type {Dependency} */ (connection.dependency),
+							connection
+						);
 						if (connection.dependency === dependency)
 							foundConnection = connection;
 					}
@@ -416,7 +423,7 @@ class ModuleGraph {
 
 	/**
 	 * @param {Dependency} dependency the dependency to look for a referenced module
-	 * @returns {Module} the referenced module
+	 * @returns {Module | null} the referenced module
 	 */
 	getModule(dependency) {
 		const connection = this.getConnection(dependency);
@@ -425,7 +432,7 @@ class ModuleGraph {
 
 	/**
 	 * @param {Dependency} dependency the dependency to look for a referencing module
-	 * @returns {Module} the referencing module
+	 * @returns {Module | null} the referencing module
 	 */
 	getOrigin(dependency) {
 		const connection = this.getConnection(dependency);
@@ -434,7 +441,7 @@ class ModuleGraph {
 
 	/**
 	 * @param {Dependency} dependency the dependency to look for a referencing module
-	 * @returns {Module} the original referencing module
+	 * @returns {Module | null} the original referencing module
 	 */
 	getResolvedOrigin(dependency) {
 		const connection = this.getConnection(dependency);
@@ -604,7 +611,7 @@ class ModuleGraph {
 
 	/**
 	 * @param {Module} module the module
-	 * @returns {number} the index of the module
+	 * @returns {number | null} the index of the module
 	 */
 	getPreOrderIndex(module) {
 		const mgm = this._getModuleGraphModule(module);
@@ -613,7 +620,7 @@ class ModuleGraph {
 
 	/**
 	 * @param {Module} module the module
-	 * @returns {number} the index of the module
+	 * @returns {number | null} the index of the module
 	 */
 	getPostOrderIndex(module) {
 		const mgm = this._getModuleGraphModule(module);
@@ -670,7 +677,7 @@ class ModuleGraph {
 
 	/**
 	 * @param {Module} module the module
-	 * @returns {number} the depth of the module
+	 * @returns {number | null} the depth of the module
 	 */
 	getDepth(module) {
 		const mgm = this._getModuleGraphModule(module);
@@ -727,14 +734,14 @@ class ModuleGraph {
 		let meta = this._metaMap.get(thing);
 		if (meta === undefined) {
 			meta = Object.create(null);
-			this._metaMap.set(thing, meta);
+			this._metaMap.set(thing, /** @type {Object} */ (meta));
 		}
-		return meta;
+		return /** @type {Object} */ (meta);
 	}
 
 	/**
 	 * @param {any} thing any thing
-	 * @returns {Object} metadata
+	 * @returns {Object | undefined} metadata
 	 */
 	getMetaIfExisting(thing) {
 		return this._metaMap.get(thing);

package/lib/ModuleGraphConnection.js

@@ -74,9 +74,9 @@ class ModuleGraphConnection {
 		this.weak = weak;
 		this.conditional = !!condition;
 		this._active = condition !== false;
-		/** @type {function(ModuleGraphConnection, RuntimeSpec): ConnectionState} */
+		/** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState) | undefined} */
 		this.condition = condition || undefined;
-		/** @type {Set<string>} */
+		/** @type {Set<string> | undefined} */
 		this.explanations = undefined;
 		if (explanation) {
 			this.explanations = new Set();
@@ -107,7 +107,9 @@ class ModuleGraphConnection {
 	 */
 	addCondition(condition) {
 		if (this.conditional) {
-			const old = this.condition;
+			const old =
+				/** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState)} */
+				(this.condition);
 			this.condition = (c, r) =>
 				intersectConnectionStates(old(c, r), condition(c, r));
 		} else if (this._active) {
@@ -143,7 +145,12 @@ class ModuleGraphConnection {
 	 */
 	isActive(runtime) {
 		if (!this.conditional) return this._active;
-		return this.condition(this, runtime) !== false;
+
+		return (
+			/** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState)} */ (
+				this.condition
+			)(this, runtime) !== false
+		);
 	}
 
 	/**
@@ -152,7 +159,11 @@ class ModuleGraphConnection {
 	 */
 	isTargetActive(runtime) {
 		if (!this.conditional) return this._active;
-		return this.condition(this, runtime) === true;
+		return (
+			/** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState)} */ (
+				this.condition
+			)(this, runtime) === true
+		);
 	}
 
 	/**
@@ -161,7 +172,9 @@ class ModuleGraphConnection {
 	 */
 	getActiveState(runtime) {
 		if (!this.conditional) return this._active;
-		return this.condition(this, runtime);
+		return /** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState)} */ (
+			this.condition
+		)(this, runtime);
 	}
 
 	/**

package/lib/ModuleInfoHeaderPlugin.js

@@ -15,10 +15,16 @@ const JavascriptModulesPlugin = require("./javascript/JavascriptModulesPlugin");
 /** @typedef {import("./ExportsInfo")} ExportsInfo */
 /** @typedef {import("./ExportsInfo").ExportInfo} ExportInfo */
 /** @typedef {import("./Module")} Module */
+/** @typedef {import("./Module").BuildMeta} BuildMeta */
 /** @typedef {import("./ModuleGraph")} ModuleGraph */
 /** @typedef {import("./ModuleTemplate")} ModuleTemplate */
 /** @typedef {import("./RequestShortener")} RequestShortener */
 
+/**
+ * @template T
+ * @param {Iterable<T>} iterable iterable
+ * @returns {string} joined with comma
+ */
 const joinIterableWithComma = iterable => {
 	// This is more performant than Array.from().join(", ")
 	// as it doesn't create an array
@@ -139,7 +145,7 @@ const printExportsInfoToSource = (
 	}
 };
 
-/** @type {WeakMap<RequestShortener, WeakMap<Module, { header: RawSource, full: WeakMap<Source, CachedSource> }>>} */
+/** @type {WeakMap<RequestShortener, WeakMap<Module, { header: RawSource | undefined, full: WeakMap<Source, CachedSource> }>>} */
 const caches = new WeakMap();
 
 class ModuleInfoHeaderPlugin {
@@ -197,7 +203,8 @@ class ModuleInfoHeaderPlugin {
 					}
 					source.add(header);
 					if (verbose) {
-						const exportsType = module.buildMeta.exportsType;
+						const exportsType = /** @type {BuildMeta} */ (module.buildMeta)
+							.exportsType;
 						source.add(
 							Template.toComment(
 								exportsType

package/lib/ModuleNotFoundError.js

@@ -43,7 +43,7 @@ const previouslyPolyfilledBuiltinModules = {
 
 class ModuleNotFoundError extends WebpackError {
 	/**
-	 * @param {Module} module module tied to dependency
+	 * @param {Module | null} module module tied to dependency
 	 * @param {Error&any} err error thrown
 	 * @param {DependencyLocation} loc location of dependency
 	 */
@@ -54,7 +54,10 @@ class ModuleNotFoundError extends WebpackError {
 		const match = err.message.match(/Can't resolve '([^']+)'/);
 		if (match) {
 			const request = match[1];
-			const alias = previouslyPolyfilledBuiltinModules[request];
+			const alias =
+				previouslyPolyfilledBuiltinModules[
+					/** @type {keyof previouslyPolyfilledBuiltinModules} */ (request)
+				];
 			if (alias) {
 				const pathIndex = alias.indexOf("/");
 				const dependency = pathIndex > 0 ? alias.slice(0, pathIndex) : alias;

package/lib/ModuleProfile.js

@@ -34,6 +34,7 @@ class ModuleProfile {
 		this.storing = 0;
 		this.storingParallelismFactor = 0;
 
+		/** @type {{ start: number, end: number }[] | undefined } */
 		this.additionalFactoryTimes = undefined;
 		this.additionalFactories = 0;
 		this.additionalFactoriesParallelismFactor = 0;

package/lib/ModuleRestoreError.js

@@ -16,6 +16,7 @@ class ModuleRestoreError extends WebpackError {
 	 */
 	constructor(module, err) {
 		let message = "Module restore failed: ";
+		/** @type {string | undefined} */
 		let details = undefined;
 		if (err !== null && typeof err === "object") {
 			if (typeof err.stack === "string" && err.stack) {
@@ -33,6 +34,7 @@ class ModuleRestoreError extends WebpackError {
 		super(message);
 
 		this.name = "ModuleRestoreError";
+		/** @type {string | undefined} */
 		this.details = details;
 		this.module = module;
 		this.error = err;

package/lib/ModuleStoreError.js

@@ -16,6 +16,7 @@ class ModuleStoreError extends WebpackError {
 	 */
 	constructor(module, err) {
 		let message = "Module storing failed: ";
+		/** @type {string | undefined} */
 		let details = undefined;
 		if (err !== null && typeof err === "object") {
 			if (typeof err.stack === "string" && err.stack) {
@@ -33,7 +34,7 @@ class ModuleStoreError extends WebpackError {
 		super(message);
 
 		this.name = "ModuleStoreError";
-		this.details = details;
+		this.details = /** @type {string | undefined} */ (details);
 		this.module = module;
 		this.error = err;
 	}

package/lib/ModuleTypeConstants.js

@@ -60,6 +60,12 @@ const CSS_MODULE_TYPE_GLOBAL = "css/global";
  */
 const CSS_MODULE_TYPE_MODULE = "css/module";
 
+/**
+ * @type {Readonly<"css/auto">}
+ * This is the module type used for CSS files, the module will be parsed as CSS modules if it's filename contains `.module.` or `.modules.`.
+ */
+const CSS_MODULE_TYPE_AUTO = "css/auto";
+
 /**
  * @type {Readonly<"asset">}
  * This is the module type used for automatically choosing between `asset/inline`, `asset/resource` based on asset size limit (8096).
@@ -152,6 +158,7 @@ exports.WEBASSEMBLY_MODULE_TYPE_SYNC = WEBASSEMBLY_MODULE_TYPE_SYNC;
 exports.CSS_MODULE_TYPE = CSS_MODULE_TYPE;
 exports.CSS_MODULE_TYPE_GLOBAL = CSS_MODULE_TYPE_GLOBAL;
 exports.CSS_MODULE_TYPE_MODULE = CSS_MODULE_TYPE_MODULE;
+exports.CSS_MODULE_TYPE_AUTO = CSS_MODULE_TYPE_AUTO;
 exports.WEBPACK_MODULE_TYPE_RUNTIME = WEBPACK_MODULE_TYPE_RUNTIME;
 exports.WEBPACK_MODULE_TYPE_FALLBACK = WEBPACK_MODULE_TYPE_FALLBACK;
 exports.WEBPACK_MODULE_TYPE_REMOTE = WEBPACK_MODULE_TYPE_REMOTE;

package/lib/MultiWatching.js

@@ -27,6 +27,10 @@ class MultiWatching {
 		this.compiler = compiler;
 	}
 
+	/**
+	 * @param {Callback<void>=} callback signals when the build has completed again
+	 * @returns {void}
+	 */
 	invalidate(callback) {
 		if (callback) {
 			asyncLib.each(