webpack 5.106.0 → 5.106.2

package/lib/ModuleTemplate.js

@@ -20,6 +20,7 @@ const memoize = require("./util/memoize");
 /** @typedef {import("./util/Hash")} Hash */
 
 /**
+ * Defines the if set type used by this module.
  * @template T
  * @typedef {import("tapable").IfSet<T>} IfSet
  */
@@ -31,6 +32,7 @@ const getJavascriptModulesPlugin = memoize(() =>
 // TODO webpack 6: remove this class
 class ModuleTemplate {
 	/**
+	 * Creates an instance of ModuleTemplate.
 	 * @param {RuntimeTemplate} runtimeTemplate the runtime template
 	 * @param {Compilation} compilation the compilation
 	 */
@@ -41,6 +43,7 @@ class ModuleTemplate {
 			content: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(source: Source, module: Module, moduleRenderContext: ModuleRenderContext, dependencyTemplates: DependencyTemplates) => Source} fn fn
@@ -66,6 +69,7 @@ class ModuleTemplate {
 			module: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(source: Source, module: Module, moduleRenderContext: ModuleRenderContext, dependencyTemplates: DependencyTemplates) => Source} fn fn
@@ -91,6 +95,7 @@ class ModuleTemplate {
 			render: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(source: Source, module: Module, chunkRenderContext: ChunkRenderContext, dependencyTemplates: DependencyTemplates) => Source} fn fn
@@ -116,6 +121,7 @@ class ModuleTemplate {
 			package: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(source: Source, module: Module, chunkRenderContext: ChunkRenderContext, dependencyTemplates: DependencyTemplates) => Source} fn fn
@@ -141,6 +147,7 @@ class ModuleTemplate {
 			hash: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(hash: Hash) => void} fn fn
@@ -159,6 +166,7 @@ class ModuleTemplate {
 Object.defineProperty(ModuleTemplate.prototype, "runtimeTemplate", {
 	get: util.deprecate(
 		/**
+		 * Returns output options.
 		 * @this {ModuleTemplate}
 		 * @returns {RuntimeTemplate} output options
 		 */

package/lib/ModuleWarning.js

@@ -14,6 +14,7 @@ const makeSerializable = require("./util/makeSerializable");
 
 class ModuleWarning extends WebpackError {
 	/**
+	 * Creates an instance of ModuleWarning.
 	 * @param {Error} warning error thrown
 	 * @param {{ from?: string | null }} info additional info
 	 */
@@ -40,6 +41,7 @@ class ModuleWarning extends WebpackError {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -51,6 +53,7 @@ class ModuleWarning extends WebpackError {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/MultiCompiler.js

@@ -15,10 +15,12 @@ const WebpackError = require("./WebpackError");
 const ArrayQueue = require("./util/ArrayQueue");
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {import("tapable").AsyncSeriesHook<T>} AsyncSeriesHook<T>
  */
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @template R
  * @typedef {import("tapable").SyncBailHook<T, R>} SyncBailHook<T, R>
@@ -27,6 +29,7 @@ const ArrayQueue = require("./util/ArrayQueue");
 /** @typedef {import("../declarations/WebpackOptions").WatchOptions} WatchOptions */
 /** @typedef {import("./Compiler")} Compiler */
 /**
+ * Defines the callback type used by this module.
  * @template T
  * @template [R=void]
  * @typedef {import("./webpack").Callback<T, R>} Callback
@@ -40,6 +43,7 @@ const ArrayQueue = require("./util/ArrayQueue");
 /** @typedef {import("./util/fs").WatchFileSystem} WatchFileSystem */
 
 /**
+ * Defines the run with dependencies handler callback.
  * @callback RunWithDependenciesHandler
  * @param {Compiler} compiler
  * @param {Callback<MultiStats>} callback
@@ -47,6 +51,7 @@ const ArrayQueue = require("./util/ArrayQueue");
  */
 
 /**
+ * Defines the multi compiler options type used by this module.
  * @typedef {object} MultiCompilerOptions
  * @property {number=} parallelism how many Compilers are allows to run at the same time in parallel
  */
@@ -57,6 +62,7 @@ const CLASS_NAME = "MultiCompiler";
 
 module.exports = class MultiCompiler {
 	/**
+	 * Creates an instance of MultiCompiler.
 	 * @param {Compiler[] | Record<string, Compiler>} compilers child compilers
 	 * @param {MultiCompilerOptions} options options
 	 */
@@ -129,6 +135,7 @@ module.exports = class MultiCompiler {
 	_validateCompilersOptions() {
 		if (this.compilers.length < 2) return;
 		/**
+		 * Adds the provided compiler to the multi compiler.
 		 * @param {Compiler} compiler compiler
 		 * @param {WebpackError} warning warning
 		 */
@@ -187,6 +194,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Sets input file system.
 	 * @param {InputFileSystem} value the new input file system
 	 */
 	set inputFileSystem(value) {
@@ -200,6 +208,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Sets output file system.
 	 * @param {OutputFileSystem} value the new output file system
 	 */
 	set outputFileSystem(value) {
@@ -213,6 +222,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Sets watch file system.
 	 * @param {WatchFileSystem} value the new watch file system
 	 */
 	set watchFileSystem(value) {
@@ -222,6 +232,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Sets intermediate file system.
 	 * @param {IntermediateFileSystem} value the new intermediate file system
 	 */
 	set intermediateFileSystem(value) {
@@ -235,6 +246,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Gets infrastructure logger.
 	 * @param {string | (() => string)} name name of the logger, or function called once to get the logger name
 	 * @returns {Logger} a logger with that name
 	 */
@@ -243,6 +255,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Updates dependencies using the provided compiler.
 	 * @param {Compiler} compiler the child compiler
 	 * @param {string[]} dependencies its dependencies
 	 * @returns {void}
@@ -252,6 +265,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Validate dependencies.
 	 * @param {Callback<MultiStats>} callback signals when the validation is complete
 	 * @returns {boolean} true if the dependencies are valid
 	 */
@@ -261,6 +275,7 @@ module.exports = class MultiCompiler {
 		/** @type {string[]} */
 		const missing = [];
 		/**
+		 * Returns target was found.
 		 * @param {Compiler} compiler compiler
 		 * @returns {boolean} target was found
 		 */
@@ -273,6 +288,7 @@ module.exports = class MultiCompiler {
 			return false;
 		};
 		/**
+		 * Returns result.
 		 * @param {{ source: Compiler, target: Compiler }} e1 edge 1
 		 * @param {{ source: Compiler, target: Compiler }} e2 edge 2
 		 * @returns {number} result
@@ -333,6 +349,7 @@ module.exports = class MultiCompiler {
 
 	// TODO webpack 6 remove
 	/**
+	 * Run with dependencies.
 	 * @deprecated This method should have been private
 	 * @param {Compiler[]} compilers the child compilers
 	 * @param {RunWithDependenciesHandler} fn a handler to run for each compiler
@@ -344,11 +361,13 @@ module.exports = class MultiCompiler {
 		const fulfilledNames = new Set();
 		let remainingCompilers = compilers;
 		/**
+		 * Checks whether this multi compiler is dependency fulfilled.
 		 * @param {string} d dependency
 		 * @returns {boolean} when dependency was fulfilled
 		 */
 		const isDependencyFulfilled = (d) => fulfilledNames.has(d);
 		/**
+		 * Gets ready compilers.
 		 * @returns {Compiler[]} compilers
 		 */
 		const getReadyCompilers = () => {
@@ -369,6 +388,7 @@ module.exports = class MultiCompiler {
 			return readyCompilers;
 		};
 		/**
+		 * Processes the provided stat.
 		 * @param {Callback<Stats[]>} callback callback
 		 * @returns {void}
 		 */
@@ -392,6 +412,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Returns result of setup.
 	 * @template SetupResult
 	 * @param {(compiler: Compiler, index: number, doneCallback: Callback<Stats>, isBlocked: () => boolean, setChanged: () => void, setInvalid: () => void) => SetupResult} setup setup a single compiler
 	 * @param {(compiler: Compiler, setupResult: SetupResult, callback: Callback<Stats>) => void} run run/continue a single compiler
@@ -448,6 +469,7 @@ module.exports = class MultiCompiler {
 		let running = 0;
 		const parallelism = /** @type {number} */ (this._options.parallelism);
 		/**
+		 * Processes the provided node.
 		 * @param {Node} node node
 		 * @param {(Error | null)=} err error
 		 * @param {Stats=} stats result
@@ -483,6 +505,7 @@ module.exports = class MultiCompiler {
 			processQueue();
 		};
 		/**
+		 * Node invalid from parent.
 		 * @param {Node} node node
 		 * @returns {void}
 		 */
@@ -497,6 +520,7 @@ module.exports = class MultiCompiler {
 			}
 		};
 		/**
+		 * Processes the provided node.
 		 * @param {Node} node node
 		 * @returns {void}
 		 */
@@ -511,6 +535,7 @@ module.exports = class MultiCompiler {
 			}
 		};
 		/**
+		 * Processes the provided node.
 		 * @param {Node} node node
 		 * @returns {void}
 		 */
@@ -589,6 +614,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Returns a compiler watcher.
 	 * @param {WatchOptions | WatchOptions[]} watchOptions the watcher's options
 	 * @param {Callback<MultiStats>} handler signals when the call finishes
 	 * @returns {MultiWatching | undefined} a compiler watcher
@@ -627,6 +653,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Processes the provided multi stat.
 	 * @param {Callback<MultiStats>} callback signals when the call finishes
 	 * @returns {void}
 	 */
@@ -661,6 +688,7 @@ module.exports = class MultiCompiler {
 	}
 
 	/**
+	 * Processes the provided error callback.
 	 * @param {ErrorCallback} callback signals when the compiler closes
 	 * @returns {void}
 	 */

package/lib/MultiStats.js

@@ -17,6 +17,7 @@ const identifierUtils = require("./util/identifier");
 /** @typedef {import("./stats/DefaultStatsFactoryPlugin").StatsError} StatsError */
 
 /**
+ * Returns indent.
  * @param {string} str string
  * @param {string} prefix pref
  * @returns {string} indent
@@ -31,6 +32,7 @@ const indent = (str, prefix) => {
 
 class MultiStats {
 	/**
+	 * Creates an instance of MultiStats.
 	 * @param {Stats[]} stats the child stats
 	 */
 	constructor(stats) {
@@ -42,6 +44,7 @@ class MultiStats {
 	}
 
 	/**
+	 * Checks whether this multi stats has errors.
 	 * @returns {boolean} true if a child compilation encountered an error
 	 */
 	hasErrors() {
@@ -49,6 +52,7 @@ class MultiStats {
 	}
 
 	/**
+	 * Checks whether this multi stats has warnings.
 	 * @returns {boolean} true if a child compilation had a warning
 	 */
 	hasWarnings() {
@@ -56,6 +60,7 @@ class MultiStats {
 	}
 
 	/**
+	 * Create child options.
 	 * @param {undefined | StatsValue} options stats options
 	 * @param {CreateStatsOptionsContext} context context
 	 * @returns {ChildOptions} context context
@@ -109,6 +114,7 @@ class MultiStats {
 	}
 
 	/**
+	 * Returns json output.
 	 * @param {StatsValue=} options stats options
 	 * @returns {StatsCompilation} json output
 	 */
@@ -138,6 +144,7 @@ class MultiStats {
 			obj.hash = obj.children.map((j) => j.hash).join("");
 		}
 		/**
+		 * Returns result.
 		 * @param {StatsCompilation} j stats error
 		 * @param {StatsError} obj Stats error
 		 * @returns {StatsError} result
@@ -184,6 +191,7 @@ class MultiStats {
 	}
 
 	/**
+	 * Returns a string representation.
 	 * @param {StatsValue=} options stats options
 	 * @returns {string} string output
 	 */

package/lib/MultiWatching.js

@@ -13,6 +13,7 @@ const asyncLib = require("neo-async");
 
 class MultiWatching {
 	/**
+	 * Creates an instance of MultiWatching.
 	 * @param {Watching[]} watchings child compilers' watchers
 	 * @param {MultiCompiler} compiler the compiler
 	 */
@@ -22,6 +23,7 @@ class MultiWatching {
 	}
 
 	/**
+	 * Processes the provided error callback.
 	 * @param {ErrorCallback=} callback signals when the build has completed again
 	 * @returns {void}
 	 */
@@ -54,6 +56,7 @@ class MultiWatching {
 	}
 
 	/**
+	 * Processes the provided error callback.
 	 * @param {ErrorCallback} callback signals when the watcher is closed
 	 * @returns {void}
 	 */

package/lib/NoEmitOnErrorsPlugin.js

@@ -11,7 +11,7 @@ const PLUGIN_NAME = "NoEmitOnErrorsPlugin";
 
 class NoEmitOnErrorsPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/NodeStuffInWebError.js

@@ -12,6 +12,7 @@ const makeSerializable = require("./util/makeSerializable");
 
 class NodeStuffInWebError extends WebpackError {
 	/**
+	 * Creates an instance of NodeStuffInWebError.
 	 * @param {DependencyLocation} loc loc
 	 * @param {string} expression expression
 	 * @param {string} description description

package/lib/NodeStuffPlugin.js

@@ -36,6 +36,7 @@ const URL_MODULE_CONSTANT_FUNCTION_NAME = "__webpack_fileURLToPath__";
 
 class NodeStuffPlugin {
 	/**
+	 * Creates an instance of NodeStuffPlugin.
 	 * @param {NodeOptions} options options
 	 */
 	constructor(options) {
@@ -43,7 +44,7 @@ class NodeStuffPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -63,12 +64,14 @@ class NodeStuffPlugin {
 				);
 
 				/**
+				 * Processes the provided parser.
 				 * @param {JavascriptParser} parser the parser
 				 * @param {NodeOptions} nodeOptions options
 				 * @returns {void}
 				 */
 				const globalHandler = (parser, nodeOptions) => {
 					/**
+					 * Returns const dependency.
 					 * @param {Expression} expr expression
 					 * @returns {ConstDependency} const dependency
 					 */
@@ -116,6 +119,7 @@ class NodeStuffPlugin {
 				const hooks = ImportMetaPlugin.getCompilationHooks(compilation);
 
 				/**
+				 * Sets module constant.
 				 * @param {JavascriptParser} parser the parser
 				 * @param {"__filename" | "__dirname" | "import.meta.filename" | "import.meta.dirname"} expressionName expression name
 				 * @param {(module: NormalModule) => string} fn function
@@ -149,6 +153,7 @@ class NodeStuffPlugin {
 				};
 
 				/**
+				 * Sets cached module constant.
 				 * @param {JavascriptParser} parser the parser
 				 * @param {"__filename" | "__dirname" | "import.meta.filename" | "import.meta.dirname"} expressionName expression name
 				 * @param {(module: NormalModule) => string} fn function
@@ -207,6 +212,7 @@ class NodeStuffPlugin {
 				};
 
 				/**
+				 * Updates constant using the provided parser.
 				 * @param {JavascriptParser} parser the parser
 				 * @param {"__filename" | "__dirname" | "import.meta.filename" | "import.meta.dirname"} expressionName expression name
 				 * @param {string} value value
@@ -230,6 +236,7 @@ class NodeStuffPlugin {
 					);
 
 				/**
+				 * Sets url module constant.
 				 * @param {JavascriptParser} parser the parser
 				 * @param {"__filename" | "__dirname" | "import.meta.filename" | "import.meta.dirname"} expressionName expression name
 				 * @param {"dirname" | "filename"} property property
@@ -344,6 +351,7 @@ class NodeStuffPlugin {
 				};
 
 				/**
+				 * Dirname and filename handler.
 				 * @param {JavascriptParser} parser the parser
 				 * @param {NodeOptions} nodeOptions options
 				 * @param {{ dirname: "__dirname" | "import.meta.dirname", filename: "__filename" | "import.meta.filename" }} identifiers options
@@ -516,6 +524,7 @@ class NodeStuffPlugin {
 				};
 
 				/**
+				 * Handles the hook callback for this code path.
 				 * @param {JavascriptParser} parser the parser
 				 * @param {JavascriptParserOptions} parserOptions the javascript parser options
 				 * @param {boolean} a true when we need to handle `__filename` and `__dirname`, otherwise false

package/lib/NormalModule.js

@@ -6,7 +6,6 @@
 "use strict";
 
 const querystring = require("querystring");
-const parseJson = require("json-parse-even-better-errors");
 const { getContext, runLoaders } = require("loader-runner");
 const {
 	AsyncSeriesBailHook,
@@ -53,6 +52,7 @@ const {
 } = require("./util/identifier");
 const makeSerializable = require("./util/makeSerializable");
 const memoize = require("./util/memoize");
+const parseJson = require("./util/parseJson");
 
 /** @typedef {import("enhanced-resolve").ResolveContext} ResolveContext */
 /** @typedef {import("enhanced-resolve").ResolveRequest} ResolveRequest */
@@ -440,6 +440,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Returns the unique identifier used to reference this module.
 	 * @returns {string} a unique identifier of the module
 	 */
 	identifier() {
@@ -453,6 +454,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Returns a human-readable identifier for this module.
 	 * @param {RequestShortener} requestShortener the request shortener
 	 * @returns {string} a user readable identifier of the module
 	 */
@@ -468,6 +470,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Gets the library identifier.
 	 * @param {LibIdentOptions} options options
 	 * @returns {LibIdent | null} an identifier for library inclusion
 	 */
@@ -482,6 +485,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * 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() {
@@ -722,7 +726,9 @@ class NormalModule extends Module {
 				if (typeof options === "string") {
 					if (options.startsWith("{") && options.endsWith("}")) {
 						try {
-							options = parseJson(options);
+							options =
+								/** @type {LoaderItem["options"]} */
+								(parseJson(options));
 						} catch (err) {
 							throw new Error(
 								`Cannot parse string options: ${/** @type {Error} */ (err).message}`,
@@ -1245,6 +1251,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Builds the module using the provided compilation context.
 	 * @param {WebpackOptions} options webpack options
 	 * @param {Compilation} compilation the compilation
 	 * @param {ResolverWithOptions} resolver the resolver
@@ -1448,6 +1455,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * 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
 	 */
@@ -1458,6 +1466,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * 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
 	 */
@@ -1506,6 +1515,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Returns the source types this module can generate.
 	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
@@ -1518,6 +1528,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Generates code and runtime requirements for this module.
 	 * @param {CodeGenerationContext} context context for code generation
 	 * @returns {CodeGenerationResult} result
 	 */
@@ -1596,6 +1607,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Gets the original source.
 	 * @returns {Source | null} the original source for the module before webpack transformation
 	 */
 	originalSource() {
@@ -1603,6 +1615,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Invalidates the cached state associated with this value.
 	 * @returns {void}
 	 */
 	invalidateBuild() {
@@ -1610,6 +1623,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * 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}
@@ -1669,6 +1683,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @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)
 	 */
@@ -1690,6 +1705,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * 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
@@ -1723,6 +1739,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * 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}
@@ -1733,6 +1750,15 @@ class NormalModule extends Module {
 			/** @type {string} */
 			(buildInfo.hash)
 		);
+		// Clear cached source types and re-compute so that changes in incoming
+		// connections (e.g. asset module newly referenced from JS via lazy
+		// compilation) are reflected in the hash and trigger code generation
+		// cache invalidation.
+		// https://github.com/webpack/webpack/issues/20800
+		this._sourceTypes = undefined;
+		for (const type of this.getSourceTypes()) {
+			hash.update(type);
+		}
 		/** @type {Generator} */
 		(this.generator).updateHash(hash, {
 			module: this,
@@ -1742,6 +1768,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -1784,6 +1811,7 @@ class NormalModule extends Module {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {