webpack 5.106.1 → 5.106.2

package/lib/TemplatedPathPlugin.js

@@ -7,10 +7,12 @@
 
 const { basename, extname } = require("path");
 const util = require("util");
-const mime = require("mime-types");
 const Chunk = require("./Chunk");
 const Module = require("./Module");
 const { parseResource } = require("./util/identifier");
+const memoize = require("./util/memoize");
+
+const getMimeTypes = memoize(() => require("./util/mimeTypes"));
 
 /** @typedef {import("./ChunkGraph")} ChunkGraph */
 /** @typedef {import("./ChunkGraph").ModuleId} ModuleId */
@@ -36,6 +38,7 @@ const prepareId = (id) => {
 };
 
 /**
+ * Defines the replacer function callback.
  * @callback ReplacerFunction
  * @param {string} match
  * @param {string | undefined} arg
@@ -43,6 +46,7 @@ const prepareId = (id) => {
  */
 
 /**
+ * Returns hash replacer function.
  * @param {ReplacerFunction} replacer replacer
  * @param {((arg0: number) => string) | undefined} handler handler
  * @param {AssetInfo | undefined} assetInfo asset info
@@ -82,6 +86,7 @@ const hashLength = (replacer, handler, assetInfo, hashName) => {
 /** @typedef {(match: string, arg: string | undefined, input: string) => string} Replacer */
 
 /**
+ * Returns replacer.
  * @param {string | number | null | undefined | (() => string | number | null | undefined)} value value
  * @param {boolean=} allowEmpty allow empty
  * @returns {Replacer} replacer
@@ -112,6 +117,7 @@ const replacer = (value, allowEmpty) => {
 const deprecationCache = new Map();
 const deprecatedFunction = (() => () => {})();
 /**
+ * Returns function with deprecation output.
  * @template {(...args: EXPECTED_ANY[]) => EXPECTED_ANY} T
  * @param {T} fn function
  * @param {string} message message
@@ -136,6 +142,7 @@ const deprecated = (fn, message, code) => {
 /** @typedef {string | TemplatePathFn} TemplatePath */
 
 /**
+ * Returns the interpolated path.
  * @param {TemplatePath} path the raw path
  * @param {PathData} data context data
  * @param {AssetInfo=} assetInfo extra info about the asset (will be written to)
@@ -163,7 +170,7 @@ const interpolate = (path, data, assetInfo) => {
 		// check that filename is data uri
 		const match = data.filename.match(/^data:([^;,]+)/);
 		if (match) {
-			const ext = mime.extension(match[1]);
+			const ext = getMimeTypes().extension(match[1]);
 			const emptyReplacer = replacer("", true);
 			// "XXXX" used for `updateHash`, so we don't need it here
 			const contentHash =
@@ -386,7 +393,7 @@ const plugin = "TemplatedPathPlugin";
 
 class TemplatedPathPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/UnhandledSchemeError.js

@@ -8,8 +8,14 @@
 const WebpackError = require("./WebpackError");
 const makeSerializable = require("./util/makeSerializable");
 
+/**
+ * Error raised when webpack encounters a resource URI scheme that no installed
+ * plugin knows how to read.
+ */
 class UnhandledSchemeError extends WebpackError {
 	/**
+	 * Creates an error explaining that the current resource scheme is not
+	 * supported by the active plugin set.
 	 * @param {string} scheme scheme
 	 * @param {string} resource resource
 	 */

package/lib/UnsupportedFeatureWarning.js

@@ -12,6 +12,7 @@ const makeSerializable = require("./util/makeSerializable");
 
 class UnsupportedFeatureWarning extends WebpackError {
 	/**
+	 * Creates an instance of UnsupportedFeatureWarning.
 	 * @param {string} message description of warning
 	 * @param {DependencyLocation} loc location start and end positions of the module
 	 */

package/lib/UseStrictPlugin.js

@@ -23,7 +23,7 @@ const PLUGIN_NAME = "UseStrictPlugin";
 
 class UseStrictPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -32,6 +32,7 @@ class UseStrictPlugin {
 			PLUGIN_NAME,
 			(compilation, { normalModuleFactory }) => {
 				/**
+				 * Handles the hook callback for this code path.
 				 * @param {JavascriptParser} parser the parser
 				 * @param {JavascriptParserOptions} parserOptions the javascript parser options
 				 */

package/lib/WarnCaseSensitiveModulesPlugin.js

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

package/lib/WarnDeprecatedOptionPlugin.js

@@ -25,7 +25,7 @@ class WarnDeprecatedOptionPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/WarnNoModeSetPlugin.js

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

package/lib/WatchIgnorePlugin.js

@@ -18,6 +18,7 @@ const IGNORE_TIME_ENTRY = "ignore";
 
 class IgnoringWatchFileSystem {
 	/**
+	 * Creates an instance of IgnoringWatchFileSystem.
 	 * @param {WatchFileSystem} wfs original file system
 	 * @param {WatchIgnorePluginOptions["paths"]} paths ignored paths
 	 */
@@ -31,6 +32,7 @@ class IgnoringWatchFileSystem {
 		files = [...files];
 		dirs = [...dirs];
 		/**
+		 * Returns true, if path is ignored.
 		 * @param {string} path path to check
 		 * @returns {boolean} true, if path is ignored
 		 */
@@ -119,6 +121,7 @@ const PLUGIN_NAME = "WatchIgnorePlugin";
 
 class WatchIgnorePlugin {
 	/**
+	 * Creates an instance of WatchIgnorePlugin.
 	 * @param {WatchIgnorePluginOptions} options options
 	 */
 	constructor(options) {
@@ -127,7 +130,7 @@ class WatchIgnorePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/Watching.js

@@ -18,6 +18,7 @@ const Stats = require("./Stats");
 /** @typedef {import("./util/fs").Watcher} Watcher */
 
 /**
+ * Defines the callback type used by this module.
  * @template T
  * @template [R=void]
  * @typedef {import("./webpack").Callback<T, R>} Callback
@@ -27,6 +28,7 @@ const Stats = require("./Stats");
 
 class Watching {
 	/**
+	 * Creates an instance of Watching.
 	 * @param {Compiler} compiler the compiler
 	 * @param {WatchOptions} watchOptions options
 	 * @param {Callback<Stats>} handler completion handler
@@ -82,6 +84,7 @@ class Watching {
 	}
 
 	/**
+	 * Merge with collected.
 	 * @param {ReadonlySet<string> | undefined | null} changedFiles changed files
 	 * @param {ReadonlySet<string> | undefined | null} removedFiles removed files
 	 */
@@ -105,6 +108,7 @@ class Watching {
 	}
 
 	/**
+	 * Processes the provided file time info entries.
 	 * @param {TimeInfoEntries=} fileTimeInfoEntries info for files
 	 * @param {TimeInfoEntries=} contextTimeInfoEntries info for directories
 	 * @param {ReadonlySet<string>=} changedFiles changed files
@@ -183,6 +187,7 @@ class Watching {
 			this.compiler.hooks.watchRun.callAsync(this.compiler, (err) => {
 				if (err) return this._done(err);
 				/**
+				 * Processes the provided err.
 				 * @param {Error | null} err error
 				 * @param {Compilation=} _compilation compilation
 				 * @returns {void}
@@ -242,6 +247,7 @@ class Watching {
 	}
 
 	/**
+	 * Returns the compilation stats.
 	 * @param {Compilation} compilation the compilation
 	 * @returns {Stats} the compilation stats
 	 */
@@ -251,6 +257,7 @@ class Watching {
 	}
 
 	/**
+	 * Processes the provided err.
 	 * @param {(Error | null)=} err an optional error
 	 * @param {Compilation=} compilation the compilation
 	 * @returns {void}
@@ -266,6 +273,7 @@ class Watching {
 		let stats;
 
 		/**
+		 * Processes the provided err.
 		 * @param {Error} err error
 		 * @param {ErrorCallback[]=} cbs callbacks
 		 */
@@ -349,6 +357,7 @@ class Watching {
 	}
 
 	/**
+	 * Processes the provided file.
 	 * @param {Iterable<string>} files watched files
 	 * @param {Iterable<string>} dirs watched directories
 	 * @param {Iterable<string>} missing watched existence entries
@@ -398,6 +407,7 @@ class Watching {
 	}
 
 	/**
+	 * Processes the provided error callback.
 	 * @param {ErrorCallback=} callback signals when the build has completed again
 	 * @returns {void}
 	 */
@@ -414,6 +424,7 @@ class Watching {
 	}
 
 	/**
+	 * Processes the provided file time info entries.
 	 * @param {TimeInfoEntries=} fileTimeInfoEntries info for files
 	 * @param {TimeInfoEntries=} contextTimeInfoEntries info for directories
 	 * @param {ReadonlySet<string>=} changedFiles changed files
@@ -456,6 +467,7 @@ class Watching {
 	}
 
 	/**
+	 * Processes the provided error callback.
 	 * @param {ErrorCallback} callback signals when the watcher is closed
 	 * @returns {void}
 	 */
@@ -467,6 +479,7 @@ class Watching {
 			return;
 		}
 		/**
+		 * Processes the provided err.
 		 * @param {WebpackError | null} err error if any
 		 * @param {Compilation=} compilation compilation if any
 		 */
@@ -481,6 +494,7 @@ class Watching {
 			this.compiler.contextTimestamps = undefined;
 			this.compiler.fsStartTime = undefined;
 			/**
+			 * Processes the provided err.
 			 * @param {WebpackError | null} err error if any
 			 */
 			const shutdown = (err) => {

package/lib/WebpackError.js

@@ -38,6 +38,7 @@ class WebpackError extends Error {
 	}
 
 	/**
+	 * Returns inspect message.
 	 * @returns {string} inspect message
 	 */
 	[inspect]() {
@@ -49,6 +50,7 @@ class WebpackError extends Error {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write }) {
@@ -62,6 +64,7 @@ class WebpackError extends Error {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize({ read }) {

package/lib/WebpackIsIncludedPlugin.js

@@ -25,6 +25,7 @@ const PLUGIN_NAME = "WebpackIsIncludedPlugin";
 
 class WebpackIsIncludedPlugin {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -42,6 +43,7 @@ class WebpackIsIncludedPlugin {
 				);
 
 				/**
+				 * Handles the hook callback for this code path.
 				 * @param {JavascriptParser} parser the parser
 				 * @returns {void}
 				 */

package/lib/WebpackOptionsApply.js

@@ -90,6 +90,7 @@ class WebpackOptionsApply extends OptionsApply {
 	}
 
 	/**
+	 * Returns options object.
 	 * @param {WebpackOptions} options options object
 	 * @param {Compiler} compiler compiler object
 	 * @param {WebpackOptionsInterception=} interception intercepted options

package/lib/WebpackOptionsDefaulter.js

@@ -13,6 +13,7 @@ const { getNormalizedWebpackOptions } = require("./config/normalization");
 
 class WebpackOptionsDefaulter {
 	/**
+	 * Returns normalized webpack options.
 	 * @param {WebpackOptions} options webpack options
 	 * @returns {WebpackOptionsNormalized} normalized webpack options
 	 */

package/lib/asset/AssetBytesGenerator.js

@@ -29,6 +29,7 @@ const RuntimeGlobals = require("../RuntimeGlobals");
 
 class AssetSourceGenerator extends Generator {
 	/**
+	 * Creates an instance of AssetSourceGenerator.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 */
 	constructor(moduleGraph) {
@@ -38,6 +39,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Generates generated code for this runtime module.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
@@ -97,6 +99,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Generates fallback output for the provided error condition.
 	 * @param {Error} error the error
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
@@ -115,6 +118,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the reason this module cannot be concatenated, when one exists.
 	 * @param {NormalModule} module module for which the bailout reason should be determined
 	 * @param {ConcatenationBailoutReasonContext} context context
 	 * @returns {string | undefined} reason why this module can't be concatenated, undefined when it can be concatenated
@@ -124,6 +128,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the source types available for this module.
 	 * @param {NormalModule} module fresh module
 	 * @returns {SourceTypes} available types (do not mutate)
 	 */
@@ -153,6 +158,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @param {NormalModule} module the module
 	 * @param {SourceType=} type source type
 	 * @returns {number} estimate size of the module

package/lib/asset/AssetBytesParser.js

@@ -14,6 +14,7 @@ const Parser = require("../Parser");
 
 class AssetBytesParser extends Parser {
 	/**
+	 * Parses the provided source and updates the parser state.
 	 * @param {string | Buffer | PreparsedAst} source the source to parse
 	 * @param {ParserState} state the parser state
 	 * @returns {ParserState} the parser state

package/lib/asset/AssetGenerator.js

@@ -30,7 +30,7 @@ const { makePathsRelative } = require("../util/identifier");
 const memoize = require("../util/memoize");
 const nonNumericOnlyHash = require("../util/nonNumericOnlyHash");
 
-const getMimeTypes = memoize(() => require("mime-types"));
+const getMimeTypes = memoize(() => require("../util/mimeTypes"));
 
 /** @typedef {import("webpack-sources").Source} Source */
 /** @typedef {import("../../declarations/WebpackOptions").AssetGeneratorDataUrlOptions} AssetGeneratorDataUrlOptions */
@@ -58,6 +58,7 @@ const getMimeTypes = memoize(() => require("mime-types"));
 /** @typedef {(source: string | Buffer, context: { filename: string, module: Module }) => string} DataUrlFunction */
 
 /**
+ * Merges maybe arrays.
  * @template T
  * @template U
  * @param {null | string | T[] | Set<T> | undefined} a a
@@ -75,6 +76,7 @@ const mergeMaybeArrays = (a, b) => {
 };
 
 /**
+ * Merges the provided values into a single result.
  * @param {AssetInfo} a a
  * @param {AssetInfo} b b
  * @returns {AssetInfo} object
@@ -115,6 +117,7 @@ const mergeAssetInfo = (a, b) => {
 };
 
 /**
+ * Merges related info.
  * @param {NonNullable<AssetInfo["related"]>} a a
  * @param {NonNullable<AssetInfo["related"]>} b b
  * @returns {NonNullable<AssetInfo["related"]>} object
@@ -131,6 +134,7 @@ const mergeRelatedInfo = (a, b) => {
 };
 
 /**
+ * Encodes the provided encoding.
  * @param {"base64" | false} encoding encoding
  * @param {Source} source source
  * @returns {string} encoded data
@@ -169,6 +173,7 @@ const encodeDataUri = (encoding, source) => {
 };
 
 /**
+ * Decodes data uri content.
  * @param {"base64" | false} encoding encoding
  * @param {string} content content
  * @returns {Buffer} decoded content
@@ -192,6 +197,7 @@ const DEFAULT_ENCODING = "base64";
 
 class AssetGenerator extends Generator {
 	/**
+	 * Creates an instance of AssetGenerator.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @param {AssetGeneratorOptions["dataUrl"]=} dataUrlOptions the options for the data url
 	 * @param {AssetModuleFilename=} filename override for output.assetModuleFilename
@@ -223,6 +229,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Gets source file name.
 	 * @param {NormalModule} module module
 	 * @param {RuntimeTemplate} runtimeTemplate runtime template
 	 * @returns {string} source file name
@@ -237,6 +244,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Gets full content hash.
 	 * @param {NormalModule} module module
 	 * @param {RuntimeTemplate} runtimeTemplate runtime template
 	 * @returns {[string, string]} return full hash and non-numeric full hash
@@ -271,6 +279,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Gets filename with info.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {Pick<AssetResourceGeneratorOptions, "filename" | "outputPath">} generatorOptions generator options
 	 * @param {{ runtime: RuntimeSpec, runtimeTemplate: RuntimeTemplate, chunkGraph: ChunkGraph }} generateContext context for generate
@@ -322,6 +331,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Gets asset path with info.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {Pick<AssetResourceGeneratorOptions, "publicPath">} generatorOptions generator options
 	 * @param {GenerateContext} generateContext context for generate
@@ -401,6 +411,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the reason this module cannot be concatenated, when one exists.
 	 * @param {NormalModule} module module for which the bailout reason should be determined
 	 * @param {ConcatenationBailoutReasonContext} context context
 	 * @returns {string | undefined} reason why this module can't be concatenated, undefined when it can be concatenated
@@ -410,6 +421,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Returns mime type.
 	 * @param {NormalModule} module module
 	 * @returns {string} mime type
 	 */
@@ -420,7 +432,7 @@ class AssetGenerator extends Generator {
 			);
 		}
 
-		/** @type {string | boolean | undefined} */
+		/** @type {string | undefined} */
 		let mimeType =
 			/** @type {AssetGeneratorDataUrlOptions} */
 			(this.dataUrlOptions).mimetype;
@@ -462,6 +474,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Generates data uri.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @returns {string} DataURI
 	 */
@@ -522,6 +535,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Generates generated code for this runtime module.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
@@ -643,6 +657,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Generates fallback output for the provided error condition.
 	 * @param {Error} error the error
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
@@ -664,6 +679,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the source types available for this module.
 	 * @param {NormalModule} module fresh module
 	 * @returns {SourceTypes} available types (do not mutate)
 	 */
@@ -706,6 +722,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @param {NormalModule} module the module
 	 * @param {SourceType=} type source type
 	 * @returns {number} estimate size of the module
@@ -742,6 +759,7 @@ class AssetGenerator extends Generator {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash hash that will be modified
 	 * @param {UpdateHashContext} updateHashContext context for updating hash
 	 */

package/lib/asset/AssetModulesPlugin.js

@@ -29,6 +29,7 @@ const memoize = require("../util/memoize");
 /** @typedef {import("../NormalModule").NormalModuleCreateData} NormalModuleCreateData */
 
 /**
+ * Returns definition.
  * @param {string} name name of definitions
  * @returns {Schema} definition
  */
@@ -60,12 +61,14 @@ const type = ASSET_MODULE_TYPE;
 const PLUGIN_NAME = "AssetModulesPlugin";
 
 /**
+ * Represents the asset modules plugin runtime component.
  * @typedef {object} AssetModulesPluginOptions
  * @property {boolean=} sideEffectFree
  */
 
 class AssetModulesPlugin {
 	/**
+	 * Creates an instance of AssetModulesPlugin.
 	 * @param {AssetModulesPluginOptions} options options
 	 */
 	constructor(options) {
@@ -73,7 +76,7 @@ class AssetModulesPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/asset/AssetParser.js

@@ -19,6 +19,7 @@ const Parser = require("../Parser");
 
 class AssetParser extends Parser {
 	/**
+	 * Creates an instance of AssetParser.
 	 * @param {AssetParserOptions["dataUrlCondition"] | boolean} dataUrlCondition condition for inlining as DataUrl
 	 */
 	constructor(dataUrlCondition) {
@@ -28,6 +29,7 @@ class AssetParser extends Parser {
 	}
 
 	/**
+	 * Parses the provided source and updates the parser state.
 	 * @param {string | Buffer | PreparsedAst} source the source to parse
 	 * @param {ParserState} state the parser state
 	 * @returns {ParserState} the parser state

package/lib/asset/AssetSourceGenerator.js

@@ -29,6 +29,7 @@ const RuntimeGlobals = require("../RuntimeGlobals");
 
 class AssetSourceGenerator extends Generator {
 	/**
+	 * Creates an instance of AssetSourceGenerator.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 */
 	constructor(moduleGraph) {
@@ -38,6 +39,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Generates generated code for this runtime module.
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
@@ -96,6 +98,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Generates fallback output for the provided error condition.
 	 * @param {Error} error the error
 	 * @param {NormalModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
@@ -114,6 +117,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the reason this module cannot be concatenated, when one exists.
 	 * @param {NormalModule} module module for which the bailout reason should be determined
 	 * @param {ConcatenationBailoutReasonContext} context context
 	 * @returns {string | undefined} reason why this module can't be concatenated, undefined when it can be concatenated
@@ -123,6 +127,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the source types available for this module.
 	 * @param {NormalModule} module fresh module
 	 * @returns {SourceTypes} available types (do not mutate)
 	 */
@@ -152,6 +157,7 @@ class AssetSourceGenerator extends Generator {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @param {NormalModule} module the module
 	 * @param {SourceType=} type source type
 	 * @returns {number} estimate size of the module

package/lib/asset/AssetSourceParser.js

@@ -14,6 +14,7 @@ const Parser = require("../Parser");
 
 class AssetSourceParser extends Parser {
 	/**
+	 * Parses the provided source and updates the parser state.
 	 * @param {string | Buffer | PreparsedAst} source the source to parse
 	 * @param {ParserState} state the parser state
 	 * @returns {ParserState} the parser state