@depup/webpack 5.106.0-depup.0 → 5.109.0-depup.0

package/lib/Module.js

@@ -33,11 +33,9 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./ConcatenationScope")} ConcatenationScope */
 /** @typedef {import("./Dependency")} Dependency */
 /** @typedef {import("./Dependency").UpdateHashContext} UpdateHashContext */
-/** @typedef {import("./DependencyTemplate").CssData} CssData */
 /** @typedef {import("./DependencyTemplates")} DependencyTemplates */
 /** @typedef {import("./ModuleSourceTypeConstants").AllTypes} AllTypes */
 /** @typedef {import("./FileSystemInfo")} FileSystemInfo */
-/** @typedef {import("./FileSystemInfo").Snapshot} Snapshot */
 /** @typedef {import("./ModuleGraphConnection").ConnectionState} ConnectionState */
 /** @typedef {import("./ModuleTypeConstants").ModuleTypes} ModuleTypes */
 /** @typedef {import("./ModuleGraph").OptimizationBailouts} OptimizationBailouts */
@@ -47,11 +45,11 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {import("./ResolverFactory").ResolverWithOptions} ResolverWithOptions */
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
 /**
+ * Defines the init fragment type used by this module.
  * @template T
  * @typedef {import("./InitFragment")<T>} InitFragment
  */
-/** @typedef {import("./WebpackError")} WebpackError */
-/** @typedef {import("./json/JsonData")} JsonData */
+/** @typedef {import("./errors/WebpackError")} WebpackError */
 /** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
 /** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 /** @typedef {import("./util/Hash")} Hash */
@@ -65,11 +63,13 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {"namespace" | "default-only" | "default-with-named" | "dynamic"} ExportsType */
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("./util/LazySet")<T>} LazySet<T>
  */
 
 /**
+ * Defines the source context type used by this module.
  * @typedef {object} SourceContext
  * @property {DependencyTemplates} dependencyTemplates the dependency templates
  * @property {RuntimeTemplate} runtimeTemplate the runtime template
@@ -87,6 +87,7 @@ const makeSerializable = require("./util/makeSerializable");
 
 // TODO webpack 6: compilation will be required in CodeGenerationContext
 /**
+ * Defines the code generation context type used by this module.
  * @typedef {object} CodeGenerationContext
  * @property {DependencyTemplates} dependencyTemplates the dependency templates
  * @property {RuntimeTemplate} runtimeTemplate the runtime template
@@ -101,34 +102,37 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /**
+ * Defines the concatenation bailout reason context type used by this module.
  * @typedef {object} ConcatenationBailoutReasonContext
  * @property {ModuleGraph} moduleGraph the module graph
  * @property {ChunkGraph} chunkGraph the chunk graph
+ * @property {boolean=} concatenateCommonJsModules whether eligible CommonJS modules may be concatenated
  */
 
 /** @typedef {Set<string>} RuntimeRequirements */
 /** @typedef {ReadonlySet<string>} ReadOnlyRuntimeRequirements */
 
 /**
+ * Defines the all code generation schemas type used by this module.
  * @typedef {object} AllCodeGenerationSchemas
  * @property {Set<string>} topLevelDeclarations top level declarations for javascript modules
+ * @property {Set<string>} freeNames free identifier names in the rendered source for javascript modules
  * @property {InitFragment<EXPECTED_ANY>[]} chunkInitFragments chunk init fragments for javascript modules
- * @property {{ javascript?: string, ["css-url"]?: string }} url url for css and javascript modules
+ * @property {{ javascript?: string, ["asset-url"]?: string }} url url for asset modules
  * @property {string} filename a filename for asset modules
  * @property {AssetInfo} assetInfo an asset info for asset modules
  * @property {string} fullContentHash a full content hash for asset modules
  * @property {[{ shareScope: string, initStage: number, init: string }]} share-init share-init for modules federation
  */
 
-/* eslint-disable jsdoc/type-formatting */
 /**
+ * Defines the code gen value type used by this module.
  * @template {string} K
- * @typedef {K extends keyof AllCodeGenerationSchemas ? AllCodeGenerationSchemas[K] : EXPECTED_ANY} CodeGenValue
+ * @typedef {K extends (keyof AllCodeGenerationSchemas) ? AllCodeGenerationSchemas[K] : EXPECTED_ANY} CodeGenValue
  */
-/* eslint-enable jsdoc/type-formatting */
 
-/* eslint-disable jsdoc/require-template */
 /**
+ * Defines the code gen map overloads type used by this module.
  * @typedef {object} CodeGenMapOverloads
  * @property {<K extends string>(key: K) => CodeGenValue<K> | undefined} get
  * @property {<K extends string>(key: K, value: CodeGenValue<K>) => CodeGenerationResultData} set
@@ -137,12 +141,14 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /**
+ * Defines the code generation result data type used by this module.
  * @typedef {Omit<Map<string, EXPECTED_ANY>, "get" | "set" | "has" | "delete"> & CodeGenMapOverloads} CodeGenerationResultData
  */
 
 /** @typedef {Map<SourceType, Source>} Sources */
 
 /**
+ * Defines the code generation result type used by this module.
  * @typedef {object} CodeGenerationResult
  * @property {Sources} sources the resulting sources for all source types
  * @property {CodeGenerationResultData=} data the resulting data for all source types
@@ -151,59 +157,45 @@ const makeSerializable = require("./util/makeSerializable");
  */
 
 /**
+ * Defines the lib ident options type used by this module.
  * @typedef {object} LibIdentOptions
  * @property {string} context absolute context path to which lib ident is relative to
  * @property {AssociatedObjectForCache=} associatedObjectForCache object for caching
  */
 
 /**
+ * Defines the build meta properties common to all module types.
+ * Module type specific properties live in the `Known*BuildMeta` typedef of the dedicated module class.
  * @typedef {object} KnownBuildMeta
  * @property {("default" | "namespace" | "flagged" | "dynamic")=} exportsType
  * @property {(false | "redirect" | "redirect-warn")=} defaultObject
- * @property {boolean=} strictHarmonyModule
- * @property {boolean=} treatAsCommonJs
  * @property {boolean=} async
  * @property {boolean=} sideEffectFree
- * @property {boolean=} isCSSModule
- * @property {Record<string, string>=} jsIncompatibleExports
- * @property {Map<string, Record<string, string>>=} exportsFinalNameByRuntime
- * @property {Map<string, string>=} exportsSourceByRuntime
+ * @property {Map<string, Record<string, string>>=} exportsFinalNameByRuntime using in ModuleLibraryPlugin
+ * @property {Map<string, string>=} exportsSourceByRuntime using in ModuleLibraryPlugin
  */
 
 /**
+ * Defines the build info properties common to all module types.
+ * Module type specific properties live in the `Known*BuildInfo` typedef of the dedicated module class.
  * @typedef {object} KnownBuildInfo
  * @property {boolean=} cacheable
- * @property {boolean=} parsed
+ * @property {string[]=} notCacheableReasons reasons why the module is not cacheable (e.g. paths of loaders that marked it)
  * @property {boolean=} strict
- * @property {string=} moduleArgument using in AMD
- * @property {string=} exportsArgument using in AMD
- * @property {string=} moduleConcatenationBailout using in CommonJs
- * @property {boolean=} needCreateRequire using in APIPlugin
- * @property {string=} resourceIntegrity using in HttpUriPlugin
- * @property {FileSystemDependencies=} fileDependencies using in NormalModule
- * @property {FileSystemDependencies=} contextDependencies using in NormalModule
- * @property {FileSystemDependencies=} missingDependencies using in NormalModule
- * @property {FileSystemDependencies=} buildDependencies using in NormalModule
- * @property {ValueCacheVersions=} valueDependencies using in NormalModule
- * @property {Record<string, Source>=} assets using in NormalModule
- * @property {Map<string, AssetInfo | undefined>=} assetsInfo using in NormalModule
- * @property {string=} hash using in NormalModule
- * @property {(Snapshot | null)=} snapshot using in ContextModule
- * @property {string=} fullContentHash for assets modules
- * @property {string=} filename for assets modules
- * @property {boolean=} dataUrl for assets modules
- * @property {AssetInfo=} assetInfo for assets modules
- * @property {boolean=} javascriptModule for external modules
- * @property {boolean=} active for lazy compilation modules
- * @property {CssData=} cssData for css modules
- * @property {JsonData=} jsonData for json modules
+ * @property {string=} moduleArgument
+ * @property {string=} exportsArgument
+ * @property {Record<string, Source>=} assets assets added by loaders or plugins
+ * @property {Map<string, AssetInfo | undefined>=} assetsInfo
  * @property {Set<string>=} topLevelDeclarations top level declaration names
+ * @property {boolean=} isCircular true when the module is part of a circular dependency chain
+ * @property {boolean=} usesTopLevelAwaitForOf module uses top-level `for await…of`, which can't be lowered to a generator
  */
 
 /** @typedef {string | Set<string>} ValueCacheVersion */
 /** @typedef {Map<string, ValueCacheVersion>} ValueCacheVersions */
 
 /**
+ * Defines the need build context type used by this module.
  * @typedef {object} NeedBuildContext
  * @property {Compilation} compilation
  * @property {FileSystemInfo} fileSystemInfo
@@ -218,6 +210,7 @@ const makeSerializable = require("./util/makeSerializable");
 /** @typedef {KnownBuildInfo & Record<string, EXPECTED_ANY>} BuildInfo */
 
 /**
+ * Defines the factory meta type used by this module.
  * @typedef {object} FactoryMeta
  * @property {boolean=} sideEffectFree
  */
@@ -231,6 +224,7 @@ const DEFAULT_TYPES_UNKNOWN = new Set([UNKNOWN_TYPE]);
 
 const deprecatedNeedRebuild = util.deprecate(
 	/**
+	 * Handles the callback logic for this hook.
 	 * @param {Module} module the module
 	 * @param {NeedBuildContext} context context info
 	 * @returns {boolean} true, when rebuild is needed
@@ -251,6 +245,7 @@ const deprecatedNeedRebuild = util.deprecate(
 
 class Module extends DependenciesBlock {
 	/**
+	 * Creates an instance of Module.
 	 * @param {ModuleTypes | ""} type the module type, when deserializing the type is not known and is an empty string
 	 * @param {(string | null)=} context an optional context
 	 * @param {(string | null)=} layer an optional layer in which the module is
@@ -283,15 +278,12 @@ class Module extends DependenciesBlock {
 		/** @type {boolean} */
 		this.useSimpleSourceMap = false;
 
-		// Is in hot context, i.e. HotModuleReplacementPlugin.js enabled
-		// TODO do we need hot here?
-		/** @type {boolean} */
-		this.hot = false;
 		// Info from Build
-		/** @type {WebpackError[] | undefined} */
+		/** @type {Error[] | undefined} */
 		this._warnings = undefined;
-		/** @type {WebpackError[] | undefined} */
+		/** @type {Error[] | undefined} */
 		this._errors = undefined;
+		// Subclasses with type specific build info/meta redeclare these with a narrowed type
 		/** @type {BuildMeta | undefined} */
 		this.buildMeta = undefined;
 		/** @type {BuildInfo | undefined} */
@@ -305,6 +297,7 @@ class Module extends DependenciesBlock {
 	// TODO remove in webpack 6
 	// BACKWARD-COMPAT START
 	/**
+	 * Returns the module id assigned by the chunk graph.
 	 * @deprecated
 	 * @returns {ModuleId | null} module id
 	 */
@@ -317,6 +310,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Updates the module id using the provided value.
 	 * @deprecated
 	 * @param {ModuleId} value value
 	 */
@@ -333,6 +327,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns the hash of the module.
 	 * @deprecated
 	 * @returns {string} the hash of the module
 	 */
@@ -345,6 +340,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns the rendered hash of the module.
 	 * @deprecated
 	 * @returns {string} the shortened hash of the module
 	 */
@@ -381,6 +377,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns the pre-order index.
 	 * @deprecated
 	 * @returns {number | null} the pre order index
 	 */
@@ -393,6 +390,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Updates the pre-order index using the provided value.
 	 * @deprecated
 	 * @param {number} value the pre order index
 	 */
@@ -405,6 +403,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns the post-order index.
 	 * @deprecated
 	 * @returns {number | null} the post order index
 	 */
@@ -417,6 +416,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Updates the post-order index using the provided value.
 	 * @deprecated
 	 * @param {number} value the post order index
 	 */
@@ -429,6 +429,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns the depth.
 	 * @deprecated
 	 * @returns {number | null} the depth
 	 */
@@ -441,6 +442,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Updates the depth using the provided value.
 	 * @deprecated
 	 * @param {number} value the depth
 	 */
@@ -453,6 +455,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns the issuer.
 	 * @deprecated
 	 * @returns {Module | null | undefined} issuer
 	 */
@@ -465,6 +468,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Updates the issuer using the provided value.
 	 * @deprecated
 	 * @param {Module | null} value issuer
 	 */
@@ -489,6 +493,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Gets optimization bailout.
 	 * @deprecated
 	 * @returns {OptimizationBailouts} list
 	 */
@@ -515,6 +520,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Adds the provided chunk to the module.
 	 * @deprecated
 	 * @param {Chunk} chunk the chunk
 	 * @returns {boolean} true, when the module was added
@@ -531,6 +537,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Removes the provided chunk from the module.
 	 * @deprecated
 	 * @param {Chunk} chunk the chunk
 	 * @returns {void}
@@ -544,6 +551,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether this module is in the provided chunk.
 	 * @deprecated
 	 * @param {Chunk} chunk the chunk
 	 * @returns {boolean} true, when the module is in the chunk
@@ -605,6 +613,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether this module provides the specified export.
 	 * @deprecated
 	 * @param {string} exportName a name of an export
 	 * @returns {boolean | null} true, if the export is provided why the module.
@@ -621,6 +630,7 @@ class Module extends DependenciesBlock {
 	// BACKWARD-COMPAT END
 
 	/**
+	 * Gets exports argument.
 	 * @returns {string} name of the exports argument
 	 */
 	get exportsArgument() {
@@ -628,6 +638,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Gets module argument.
 	 * @returns {string} name of the module argument
 	 */
 	get moduleArgument() {
@@ -635,6 +646,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns export type.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @param {boolean | undefined} strict the importing module is strict
 	 * @returns {ExportsType} export type
@@ -705,6 +717,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Adds presentational dependency.
 	 * @param {Dependency} presentationalDependency dependency being tied to module.
 	 * This is a Dependency without edge in the module graph. It's only for presentation.
 	 * @returns {void}
@@ -717,6 +730,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Adds code generation dependency.
 	 * @param {Dependency} codeGenerationDependency dependency being tied to module.
 	 * This is a Dependency where the code generation result of the referenced module is needed during code generation.
 	 * The Dependency should also be added to normal dependencies via addDependency.
@@ -730,7 +744,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
-	 * Removes all dependencies and blocks
+	 * Clear dependencies and blocks.
 	 * @returns {void}
 	 */
 	clearDependenciesAndBlocks() {
@@ -744,7 +758,8 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
-	 * @param {WebpackError} warning the warning
+	 * Adds the provided warning to the module.
+	 * @param {Error} warning the warning
 	 * @returns {void}
 	 */
 	addWarning(warning) {
@@ -755,13 +770,15 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
-	 * @returns {Iterable<WebpackError> | undefined} list of warnings if any
+	 * Returns list of warnings if any.
+	 * @returns {Error[] | undefined} list of warnings if any
 	 */
 	getWarnings() {
 		return this._warnings;
 	}
 
 	/**
+	 * Gets number of warnings.
 	 * @returns {number} number of warnings
 	 */
 	getNumberOfWarnings() {
@@ -769,7 +786,8 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
-	 * @param {WebpackError} error the error
+	 * Adds the provided error to the module.
+	 * @param {Error} error the error
 	 * @returns {void}
 	 */
 	addError(error) {
@@ -780,13 +798,15 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
-	 * @returns {Iterable<WebpackError> | undefined} list of errors if any
+	 * Returns list of errors if any.
+	 * @returns {Error[] | undefined} list of errors if any
 	 */
 	getErrors() {
 		return this._errors;
 	}
 
 	/**
+	 * Gets number of errors.
 	 * @returns {number} number of errors
 	 */
 	getNumberOfErrors() {
@@ -807,6 +827,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether this module is optional.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @returns {boolean} true, if the module is optional
 	 */
@@ -826,6 +847,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether this module is accessible in chunk.
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @param {Chunk} chunk a chunk
 	 * @param {Chunk=} ignoreChunk chunk to be ignored
@@ -840,6 +862,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether this module is accessible in chunk group.
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @param {ChunkGroup} chunkGroup a chunk group
 	 * @param {Chunk=} ignoreChunk chunk to be ignored
@@ -867,6 +890,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether this module contains the chunk.
 	 * @param {Chunk} chunk a chunk
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @param {ChunkGraph} chunkGraph the chunk graph
@@ -892,6 +916,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether this module contains the module graph.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @param {RuntimeSpec} runtime the runtime
 	 * @returns {boolean} true if at least one other module depends on this module
@@ -904,6 +929,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns a string representation.
 	 * @returns {string} for debugging
 	 */
 	toString() {
@@ -911,6 +937,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether the module needs to be rebuilt for the current build state.
 	 * @param {NeedBuildContext} context context info
 	 * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild
 	 * @returns {void}
@@ -925,6 +952,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Checks whether it needs rebuild.
 	 * @deprecated Use needBuild instead
 	 * @param {Map<string, number | null>} fileTimestamps timestamps of files
 	 * @param {Map<string, number | null>} contextTimestamps timestamps of directories
@@ -935,6 +963,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash the hash used to track dependencies
 	 * @param {UpdateHashContext} context context
 	 * @returns {void}
@@ -961,6 +990,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Invalidates the cached state associated with this value.
 	 * @returns {void}
 	 */
 	invalidateBuild() {
@@ -969,29 +999,32 @@ class Module extends DependenciesBlock {
 
 	/* istanbul ignore next */
 	/**
+	 * Returns the unique identifier used to reference this module.
 	 * @abstract
 	 * @returns {string} a unique identifier of the module
 	 */
 	identifier() {
-		const AbstractMethodError = require("./AbstractMethodError");
+		const AbstractMethodError = require("./errors/AbstractMethodError");
 
 		throw new AbstractMethodError();
 	}
 
 	/* istanbul ignore next */
 	/**
+	 * Returns a human-readable identifier for this module.
 	 * @abstract
 	 * @param {RequestShortener} requestShortener the request shortener
 	 * @returns {string} a user readable identifier of the module
 	 */
 	readableIdentifier(requestShortener) {
-		const AbstractMethodError = require("./AbstractMethodError");
+		const AbstractMethodError = require("./errors/AbstractMethodError");
 
 		throw new AbstractMethodError();
 	}
 
 	/* istanbul ignore next */
 	/**
+	 * Builds the module using the provided compilation context.
 	 * @abstract
 	 * @param {WebpackOptions} options webpack options
 	 * @param {Compilation} compilation the compilation
@@ -1001,12 +1034,13 @@ class Module extends DependenciesBlock {
 	 * @returns {void}
 	 */
 	build(options, compilation, resolver, fs, callback) {
-		const AbstractMethodError = require("./AbstractMethodError");
+		const AbstractMethodError = require("./errors/AbstractMethodError");
 
 		throw new AbstractMethodError();
 	}
 
 	/**
+	 * Returns the source types this module can generate.
 	 * @abstract
 	 * @returns {SourceTypes} types available (do not mutate)
 	 */
@@ -1018,6 +1052,14 @@ class Module extends DependenciesBlock {
 		return JAVASCRIPT_TYPES;
 	}
 
+	/**
+	 * Freshly recomputed source types when they depend on incoming connections, for chunk-graph cache invalidation; undefined otherwise. #20800
+	 * @returns {SourceTypes | undefined} source types or undefined
+	 */
+	getReferencedSourceTypes() {
+		return undefined;
+	}
+
 	/**
 	 * Basic source types are high-level categories like javascript, css, webassembly, etc.
 	 * We only have built-in knowledge about the javascript basic type here; other basic types may be
@@ -1032,6 +1074,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns generated source.
 	 * @abstract
 	 * @deprecated Use codeGeneration() instead
 	 * @param {DependencyTemplates} dependencyTemplates the dependency templates
@@ -1041,7 +1084,7 @@ class Module extends DependenciesBlock {
 	 */
 	source(dependencyTemplates, runtimeTemplate, type = JAVASCRIPT_TYPE) {
 		if (this.codeGeneration === Module.prototype.codeGeneration) {
-			const AbstractMethodError = require("./AbstractMethodError");
+			const AbstractMethodError = require("./errors/AbstractMethodError");
 
 			throw new AbstractMethodError();
 		}
@@ -1071,17 +1114,19 @@ class Module extends DependenciesBlock {
 
 	/* istanbul ignore next */
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @abstract
 	 * @param {string=} type the source type for which the size should be estimated
 	 * @returns {number} the estimated size of the module (must be non-zero)
 	 */
 	size(type) {
-		const AbstractMethodError = require("./AbstractMethodError");
+		const AbstractMethodError = require("./errors/AbstractMethodError");
 
 		throw new AbstractMethodError();
 	}
 
 	/**
+	 * Gets the library identifier.
 	 * @param {LibIdentOptions} options options
 	 * @returns {LibIdent | null} an identifier for library inclusion
 	 */
@@ -1090,6 +1135,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns the path used when matching this module against rule conditions.
 	 * @returns {NameForCondition | null} absolute path which should be used for condition matching (usually the resource path)
 	 */
 	nameForCondition() {
@@ -1097,6 +1143,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns the reason this module cannot be concatenated, when one exists.
 	 * @param {ConcatenationBailoutReasonContext} context context
 	 * @returns {string | undefined} reason why this module can't be concatenated, undefined when it can be concatenated
 	 */
@@ -1105,6 +1152,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Gets side effects connection state.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @returns {ConnectionState} how this module should be connected to referencing modules when consumed for side-effects only
 	 */
@@ -1113,6 +1161,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Generates code and runtime requirements for this module.
 	 * @param {CodeGenerationContext} context context for code generation
 	 * @returns {CodeGenerationResult} result
 	 */
@@ -1143,6 +1192,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Returns true if the module can be placed in the chunk.
 	 * @param {Chunk} chunk the chunk which condition should be checked
 	 * @param {Compilation} compilation the compilation
 	 * @returns {boolean} true if the module can be placed in the chunk
@@ -1201,6 +1251,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Gets the original source.
 	 * @returns {Source | null} the original source for the module before webpack transformation
 	 */
 	originalSource() {
@@ -1208,6 +1259,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Adds the provided file dependencies to the module.
 	 * @param {FileSystemDependencies} fileDependencies set where file dependencies are added to
 	 * @param {FileSystemDependencies} contextDependencies set where context dependencies are added to
 	 * @param {FileSystemDependencies} missingDependencies set where missing dependencies are added to
@@ -1221,6 +1273,7 @@ class Module extends DependenciesBlock {
 	) {}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -1232,7 +1285,6 @@ class Module extends DependenciesBlock {
 		write(this.factoryMeta);
 		write(this.useSourceMap);
 		write(this.useSimpleSourceMap);
-		write(this.hot);
 		write(
 			this._warnings !== undefined && this._warnings.length === 0
 				? undefined
@@ -1251,6 +1303,7 @@ class Module extends DependenciesBlock {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -1262,7 +1315,6 @@ class Module extends DependenciesBlock {
 		this.factoryMeta = read();
 		this.useSourceMap = read();
 		this.useSimpleSourceMap = read();
-		this.hot = read();
 		this._warnings = read();
 		this._errors = read();
 		this.buildMeta = read();
@@ -1274,6 +1326,7 @@ class Module extends DependenciesBlock {
 
 	// TODO remove in webpack 6
 	/**
+	 * Gets source basic types.
 	 * @deprecated In webpack 6, call getSourceBasicTypes() directly on the module instance instead of using this static method.
 	 * @param {Module} module the module
 	 * @returns {ReturnType<Module["getSourceBasicTypes"]>} the source types of the module
@@ -1293,6 +1346,7 @@ makeSerializable(Module, "webpack/lib/Module");
 // TODO remove in webpack 6
 Object.defineProperty(Module.prototype, "hasEqualsChunks", {
 	/**
+	 * Gets has equals chunks.
 	 * @deprecated
 	 * @returns {EXPECTED_ANY} throw an error
 	 */
@@ -1306,6 +1360,7 @@ Object.defineProperty(Module.prototype, "hasEqualsChunks", {
 // TODO remove in webpack 6
 Object.defineProperty(Module.prototype, "isUsed", {
 	/**
+	 * Returns throw an error.
 	 * @deprecated
 	 * @returns {EXPECTED_ANY} throw an error
 	 */
@@ -1319,13 +1374,15 @@ Object.defineProperty(Module.prototype, "isUsed", {
 // TODO remove in webpack 6
 Object.defineProperty(Module.prototype, "errors", {
 	/**
+	 * Returns errors.
 	 * @deprecated
-	 * @returns {WebpackError[]} errors
+	 * @returns {Error[]} errors
 	 */
 	get: util.deprecate(
 		/**
+		 * Returns errors.
 		 * @this {Module}
-		 * @returns {WebpackError[]} errors
+		 * @returns {Error[]} errors
 		 */
 		function errors() {
 			if (this._errors === undefined) {
@@ -1341,13 +1398,15 @@ Object.defineProperty(Module.prototype, "errors", {
 // TODO remove in webpack 6
 Object.defineProperty(Module.prototype, "warnings", {
 	/**
+	 * Returns warnings.
 	 * @deprecated
-	 * @returns {WebpackError[]} warnings
+	 * @returns {Error[]} warnings
 	 */
 	get: util.deprecate(
 		/**
+		 * Returns warnings.
 		 * @this {Module}
-		 * @returns {WebpackError[]} warnings
+		 * @returns {Error[]} warnings
 		 */
 		function warnings() {
 			if (this._warnings === undefined) {
@@ -1363,6 +1422,7 @@ Object.defineProperty(Module.prototype, "warnings", {
 // TODO remove in webpack 6
 Object.defineProperty(Module.prototype, "used", {
 	/**
+	 * Returns throw an error.
 	 * @deprecated
 	 * @returns {EXPECTED_ANY} throw an error
 	 */
@@ -1372,6 +1432,7 @@ Object.defineProperty(Module.prototype, "used", {
 		);
 	},
 	/**
+	 * Updates used using the provided value.
 	 * @param {EXPECTED_ANY} value value
 	 */
 	set(value) {