webpack 5.87.0 → 5.88.0

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

@@ -109,6 +109,11 @@ 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 = {};
 
 let debugId = 1000;
@@ -159,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
@@ -439,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/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/NodeStuffPlugin.js

@@ -21,14 +21,23 @@ const { relative } = require("./util/fs");
 const { parseResource } = require("./util/identifier");
 
 /** @typedef {import("webpack-sources").ReplaceSource} ReplaceSource */
+/** @typedef {import("../declarations/WebpackOptions").JavascriptParserOptions} JavascriptParserOptions */
+/** @typedef {import("../declarations/WebpackOptions").NodeOptions} NodeOptions */
 /** @typedef {import("./Compiler")} Compiler */
 /** @typedef {import("./Dependency")} Dependency */
+/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
 /** @typedef {import("./DependencyTemplates")} DependencyTemplates */
+/** @typedef {import("./NormalModule")} NormalModule */
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
+/** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
+/** @typedef {import("./javascript/JavascriptParser").Range} Range */
 
 const PLUGIN_NAME = "NodeStuffPlugin";
 
 class NodeStuffPlugin {
+	/**
+	 * @param {NodeOptions} options options
+	 */
 	constructor(options) {
 		this.options = options;
 	}
@@ -43,6 +52,11 @@ class NodeStuffPlugin {
 		compiler.hooks.compilation.tap(
 			PLUGIN_NAME,
 			(compilation, { normalModuleFactory }) => {
+				/**
+				 * @param {JavascriptParser} parser the parser
+				 * @param {JavascriptParserOptions} parserOptions options
+				 * @returns {void}
+				 */
 				const handler = (parser, parserOptions) => {
 					if (parserOptions.node === false) return;
 
@@ -56,10 +70,10 @@ class NodeStuffPlugin {
 						parser.hooks.expression.for("global").tap(PLUGIN_NAME, expr => {
 							const dep = new ConstDependency(
 								RuntimeGlobals.global,
-								expr.range,
+								/** @type {Range} */ (expr.range),
 								[RuntimeGlobals.global]
 							);
-							dep.loc = expr.loc;
+							dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 							parser.state.module.addPresentationalDependency(dep);
 
 							// TODO webpack 6 remove
@@ -76,25 +90,31 @@ class NodeStuffPlugin {
 						parser.hooks.rename.for("global").tap(PLUGIN_NAME, expr => {
 							const dep = new ConstDependency(
 								RuntimeGlobals.global,
-								expr.range,
+								/** @type {Range} */ (expr.range),
 								[RuntimeGlobals.global]
 							);
-							dep.loc = expr.loc;
+							dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 							parser.state.module.addPresentationalDependency(dep);
 							return false;
 						});
 					}
 
+					/**
+					 * @param {string} expressionName expression name
+					 * @param {(module: NormalModule) => string} fn function
+					 * @param {string=} warning warning
+					 * @returns {void}
+					 */
 					const setModuleConstant = (expressionName, fn, warning) => {
 						parser.hooks.expression
 							.for(expressionName)
 							.tap(PLUGIN_NAME, expr => {
 								const dep = new CachedConstDependency(
 									JSON.stringify(fn(parser.state.module)),
-									expr.range,
+									/** @type {Range} */ (expr.range),
 									expressionName
 								);
-								dep.loc = expr.loc;
+								dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 								parser.state.module.addPresentationalDependency(dep);
 
 								// TODO webpack 6 remove
@@ -108,6 +128,12 @@ class NodeStuffPlugin {
 							});
 					};
 
+					/**
+					 * @param {string} expressionName expression name
+					 * @param {string} value value
+					 * @param {string=} warning warning
+					 * @returns {void}
+					 */
 					const setConstant = (expressionName, value, warning) =>
 						setModuleConstant(expressionName, () => value, warning);
 

package/lib/ProvidePlugin.js

@@ -14,7 +14,11 @@ const ConstDependency = require("./dependencies/ConstDependency");
 const ProvidedDependency = require("./dependencies/ProvidedDependency");
 const { approve } = require("./javascript/JavascriptParserHelpers");
 
+/** @typedef {import("../declarations/WebpackOptions").JavascriptParserOptions} JavascriptParserOptions */
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
+/** @typedef {import("./javascript/JavascriptParser").Range} Range */
 
 const PLUGIN_NAME = "ProvidePlugin";
 
@@ -48,6 +52,11 @@ class ProvidePlugin {
 					ProvidedDependency,
 					new ProvidedDependency.Template()
 				);
+				/**
+				 * @param {JavascriptParser} parser the parser
+				 * @param {JavascriptParserOptions} parserOptions options
+				 * @returns {void}
+				 */
 				const handler = (parser, parserOptions) => {
 					Object.keys(definitions).forEach(name => {
 						const request = [].concat(definitions[name]);
@@ -67,9 +76,9 @@ class ProvidePlugin {
 								request[0],
 								nameIdentifier,
 								request.slice(1),
-								expr.range
+								/** @type {Range} */ (expr.range)
 							);
-							dep.loc = expr.loc;
+							dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 							parser.state.module.addDependency(dep);
 							return true;
 						});
@@ -82,9 +91,9 @@ class ProvidePlugin {
 								request[0],
 								nameIdentifier,
 								request.slice(1),
-								expr.callee.range
+								/** @type {Range} */ (expr.callee.range)
 							);
-							dep.loc = expr.callee.loc;
+							dep.loc = /** @type {DependencyLocation} */ (expr.callee.loc);
 							parser.state.module.addDependency(dep);
 							parser.walkExpressions(expr.arguments);
 							return true;

package/lib/RawModule.js

@@ -72,7 +72,9 @@ class RawModule extends Module {
 	 * @returns {string} a user readable identifier of the module
 	 */
 	readableIdentifier(requestShortener) {
-		return requestShortener.shorten(this.readableIdentifierStr);
+		return /** @type {string} */ (
+			requestShortener.shorten(this.readableIdentifierStr)
+		);
 	}
 
 	/**

package/lib/RequireJsStuffPlugin.js

@@ -15,7 +15,9 @@ const {
 	toConstantDependency
 } = require("./javascript/JavascriptParserHelpers");
 
+/** @typedef {import("../declarations/WebpackOptions").JavascriptParserOptions} JavascriptParserOptions */
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
 
 const PLUGIN_NAME = "RequireJsStuffPlugin";
 
@@ -33,6 +35,11 @@ module.exports = class RequireJsStuffPlugin {
 					ConstDependency,
 					new ConstDependency.Template()
 				);
+				/**
+				 * @param {JavascriptParser} parser the parser
+				 * @param {JavascriptParserOptions} parserOptions options
+				 * @returns {void}
+				 */
 				const handler = (parser, parserOptions) => {
 					if (
 						parserOptions.requireJs === undefined ||

package/lib/RuntimeModule.js

@@ -166,7 +166,7 @@ class RuntimeModule extends Module {
 	/* istanbul ignore next */
 	/**
 	 * @abstract
-	 * @returns {string} runtime code
+	 * @returns {string | null} runtime code
 	 */
 	generate() {
 		const AbstractMethodError = require("./AbstractMethodError");
@@ -174,11 +174,11 @@ class RuntimeModule extends Module {
 	}
 
 	/**
-	 * @returns {string} runtime code
+	 * @returns {string | null} runtime code
 	 */
 	getGeneratedCode() {
 		if (this._cachedGeneratedCode) {
-			return this._cachedGeneratedCode;
+			return /** @type {string | null} */ (this._cachedGeneratedCode);
 		}
 		return (this._cachedGeneratedCode = this.generate());
 	}

package/lib/RuntimePlugin.js

@@ -128,7 +128,8 @@ class RuntimePlugin {
 					});
 			}
 			for (const req of Object.keys(TREE_DEPENDENCIES)) {
-				const deps = TREE_DEPENDENCIES[req];
+				const deps =
+					TREE_DEPENDENCIES[/** @type {keyof TREE_DEPENDENCIES} */ (req)];
 				compilation.hooks.runtimeRequirementInTree
 					.for(req)
 					.tap("RuntimePlugin", (chunk, set) => {
@@ -136,7 +137,8 @@ class RuntimePlugin {
 					});
 			}
 			for (const req of Object.keys(MODULE_DEPENDENCIES)) {
-				const deps = MODULE_DEPENDENCIES[req];
+				const deps =
+					MODULE_DEPENDENCIES[/** @type {keyof MODULE_DEPENDENCIES} */ (req)];
 				compilation.hooks.runtimeRequirementInModule
 					.for(req)
 					.tap("RuntimePlugin", (chunk, set) => {

package/lib/RuntimeTemplate.js

@@ -396,7 +396,7 @@ class RuntimeTemplate {
 
 	/**
 	 * @param {Object} options options object
-	 * @param {Module} options.module the module
+	 * @param {Module | null} options.module the module
 	 * @param {ChunkGraph} options.chunkGraph the chunk graph
 	 * @param {string} options.request the request that should be printed as comment
 	 * @param {boolean=} options.weak if the dependency is weak (will create a nice error message)
@@ -439,7 +439,7 @@ class RuntimeTemplate {
 
 	/**
 	 * @param {Object} options options object
-	 * @param {Module} options.module the module
+	 * @param {Module | null} options.module the module
 	 * @param {ChunkGraph} options.chunkGraph the chunk graph
 	 * @param {string} options.request the request that should be printed as comment
 	 * @param {boolean=} options.weak if the dependency is weak (will create a nice error message)

package/lib/SourceMapDevToolModuleOptionsPlugin.js

@@ -7,9 +7,13 @@
 
 const JavascriptModulesPlugin = require("./javascript/JavascriptModulesPlugin");
 
+/** @typedef {import("../declarations/plugins/SourceMapDevToolPlugin").SourceMapDevToolPluginOptions} SourceMapDevToolPluginOptions */
 /** @typedef {import("./Compilation")} Compilation */
 
 class SourceMapDevToolModuleOptionsPlugin {
+	/**
+	 * @param {SourceMapDevToolPluginOptions} options options
+	 */
 	constructor(options) {
 		this.options = options;
 	}

package/lib/SourceMapDevToolPlugin.js

@@ -22,6 +22,7 @@ const { makePathsAbsolute } = require("./util/identifier");
 /** @typedef {import("./Cache").Etag} Etag */
 /** @typedef {import("./CacheFacade").ItemCacheFacade} ItemCacheFacade */
 /** @typedef {import("./Chunk")} Chunk */
+/** @typedef {import("./Compilation").Asset} Asset */
 /** @typedef {import("./Compilation").AssetInfo} AssetInfo */
 /** @typedef {import("./Compilation").PathData} PathData */
 /** @typedef {import("./Compiler")} Compiler */
@@ -227,7 +228,9 @@ class SourceMapDevToolPlugin {
 					asyncLib.each(
 						files,
 						(file, callback) => {
-							const asset = compilation.getAsset(file);
+							const asset =
+								/** @type {Readonly<Asset>} */
+								(compilation.getAsset(file));
 							if (asset.info.related && asset.info.related.sourceMap) {
 								fileIndex++;
 								return callback();
@@ -363,7 +366,9 @@ class SourceMapDevToolPlugin {
 							// find modules with conflicting source names
 							for (let idx = 0; idx < allModules.length; idx++) {
 								const module = allModules[idx];
-								let sourceName = moduleToSourceNameMapping.get(module);
+								let sourceName =
+									/** @type {string} */
+									(moduleToSourceNameMapping.get(module));
 								let hasName = conflictDetectionSet.has(sourceName);
 								if (!hasName) {
 									conflictDetectionSet.add(sourceName);

package/lib/UseStrictPlugin.js

@@ -13,7 +13,10 @@ const {
 const ConstDependency = require("./dependencies/ConstDependency");
 
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("./Module").BuildInfo} BuildInfo */
 /** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
+/** @typedef {import("./javascript/JavascriptParser").Range} Range */
 
 const PLUGIN_NAME = "UseStrictPlugin";
 
@@ -42,10 +45,14 @@ class UseStrictPlugin {
 							// Remove "use strict" expression. It will be added later by the renderer again.
 							// This is necessary in order to not break the strict mode when webpack prepends code.
 							// @see https://github.com/webpack/webpack/issues/1970
-							const dep = new ConstDependency("", firstNode.range);
-							dep.loc = firstNode.loc;
+							const dep = new ConstDependency(
+								"",
+								/** @type {Range} */ (firstNode.range)
+							);
+							dep.loc = /** @type {DependencyLocation} */ (firstNode.loc);
 							parser.state.module.addPresentationalDependency(dep);
-							parser.state.module.buildInfo.strict = true;
+							/** @type {BuildInfo} */
+							(parser.state.module.buildInfo).strict = true;
 						}
 					});
 				};

package/lib/WebpackIsIncludedPlugin.js

@@ -16,10 +16,12 @@ const {
 	toConstantDependency
 } = require("./javascript/JavascriptParserHelpers");
 
-/** @typedef {import("enhanced-resolve/lib/Resolver")} Resolver */
+/** @typedef {import("enhanced-resolve").Resolver} Resolver */
 /** @typedef {import("./Compiler")} Compiler */
+/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
 /** @typedef {import("./Module")} Module */
 /** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
+/** @typedef {import("./javascript/JavascriptParser").Range} Range */
 
 const PLUGIN_NAME = "WebpackIsIncludedPlugin";
 
@@ -61,10 +63,10 @@ class WebpackIsIncludedPlugin {
 							if (!request.isString()) return;
 
 							const dep = new WebpackIsIncludedDependency(
-								request.string,
-								expr.range
+								/** @type {string} */ (request.string),
+								/** @type {Range} */ (expr.range)
 							);
-							dep.loc = expr.loc;
+							dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 							parser.state.module.addDependency(dep);
 							return true;
 						});

package/lib/asset/AssetGenerator.js

@@ -181,6 +181,7 @@ class AssetGenerator extends Generator {
 			);
 		}
 
+		/** @type {string | boolean | undefined} */
 		let mimeType = this.dataUrlOptions.mimetype;
 		if (mimeType === undefined) {
 			const ext = path.extname(module.nameForCondition());
@@ -213,7 +214,7 @@ class AssetGenerator extends Generator {
 			);
 		}
 
-		return mimeType;
+		return /** @type {string} */ (mimeType);
 	}
 
 	/**

package/lib/asset/AssetParser.js

@@ -9,6 +9,8 @@ const Parser = require("../Parser");
 
 /** @typedef {import("../../declarations/WebpackOptions").AssetParserDataUrlOptions} AssetParserDataUrlOptions */
 /** @typedef {import("../../declarations/WebpackOptions").AssetParserOptions} AssetParserOptions */
+/** @typedef {import("../Module").BuildInfo} BuildInfo */
+/** @typedef {import("../Module").BuildMeta} BuildMeta */
 /** @typedef {import("../Parser").ParserState} ParserState */
 /** @typedef {import("../Parser").PreparsedAst} PreparsedAst */
 
@@ -30,22 +32,25 @@ class AssetParser extends Parser {
 		if (typeof source === "object" && !Buffer.isBuffer(source)) {
 			throw new Error("AssetParser doesn't accept preparsed AST");
 		}
-		state.module.buildInfo.strict = true;
-		state.module.buildMeta.exportsType = "default";
-		state.module.buildMeta.defaultObject = false;
+
+		const buildInfo = /** @type {BuildInfo} */ (state.module.buildInfo);
+		buildInfo.strict = true;
+		const buildMeta = /** @type {BuildMeta} */ (state.module.buildMeta);
+		buildMeta.exportsType = "default";
+		buildMeta.defaultObject = false;
 
 		if (typeof this.dataUrlCondition === "function") {
-			state.module.buildInfo.dataUrl = this.dataUrlCondition(source, {
+			buildInfo.dataUrl = this.dataUrlCondition(source, {
 				filename: state.module.matchResource || state.module.resource,
 				module: state.module
 			});
 		} else if (typeof this.dataUrlCondition === "boolean") {
-			state.module.buildInfo.dataUrl = this.dataUrlCondition;
+			buildInfo.dataUrl = this.dataUrlCondition;
 		} else if (
 			this.dataUrlCondition &&
 			typeof this.dataUrlCondition === "object"
 		) {
-			state.module.buildInfo.dataUrl =
+			buildInfo.dataUrl =
 				Buffer.byteLength(source) <=
 				/** @type {NonNullable<AssetParserDataUrlOptions["maxSize"]>} */
 				(this.dataUrlCondition.maxSize);