webpack 5.106.1 → 5.106.2

package/lib/ChunkGroup.js

@@ -24,6 +24,9 @@ const {
 /** @typedef {{ module: Module | null, loc: DependencyLocation, request: string }} OriginRecord */
 
 /**
+ * Describes the scheduling hints that can be attached to a chunk group.
+ * These values influence how child groups are ordered for preload/prefetch
+ * and how their fetch priority is exposed to runtime code.
  * @typedef {object} RawChunkGroupOptions
  * @property {number=} preloadOrder
  * @property {number=} prefetchOrder
@@ -35,6 +38,8 @@ const {
 let debugId = 5000;
 
 /**
+ * Materializes a sortable set as an array without changing its current order.
+ * Used with `SortableSet` caches that expect a stable array result.
  * @template T
  * @param {SortableSet<T>} set set to convert to array.
  * @returns {T[]} the array format of existing set
@@ -54,6 +59,8 @@ const sortById = (a, b) => {
 };
 
 /**
+ * Orders origin records by referencing module and then by source location.
+ * This keeps origin metadata deterministic for hashing and diagnostics.
  * @param {OriginRecord} a the first comparator in sort
  * @param {OriginRecord} b the second comparator in sort
  * @returns {1 | -1 | 0} returns sorting order as index
@@ -66,9 +73,14 @@ const sortOrigin = (a, b) => {
 	return compareLocations(a.loc, b.loc);
 };
 
+/**
+ * Represents a connected group of chunks along with the parent/child
+ * relationships, async blocks, and traversal metadata webpack tracks for it.
+ */
 class ChunkGroup {
 	/**
-	 * Creates an instance of ChunkGroup.
+	 * Creates a chunk group and initializes the relationship sets and ordering
+	 * metadata used while building and optimizing the chunk graph.
 	 * @param {string | ChunkGroupOptions=} options chunk group options passed to chunkGroup
 	 */
 	constructor(options) {
@@ -113,7 +125,9 @@ class ChunkGroup {
 	}
 
 	/**
-	 * when a new chunk is added to a chunkGroup, addingOptions will occur.
+	 * Merges additional options into the chunk group.
+	 * Order-based options are combined by taking the higher priority, while
+	 * unsupported conflicts surface as an explicit error.
 	 * @param {ChunkGroupOptions} options the chunkGroup options passed to addOptions
 	 * @returns {void}
 	 */
@@ -146,7 +160,7 @@ class ChunkGroup {
 	}
 
 	/**
-	 * returns the name of current ChunkGroup
+	 * Returns the configured name of the chunk group, if one was assigned.
 	 * @returns {ChunkGroupOptions["name"]} returns the ChunkGroup name
 	 */
 	get name() {
@@ -154,7 +168,7 @@ class ChunkGroup {
 	}
 
 	/**
-	 * sets a new name for current ChunkGroup
+	 * Updates the configured name of the chunk group.
 	 * @param {string | undefined} value the new name for ChunkGroup
 	 * @returns {void}
 	 */
@@ -164,7 +178,8 @@ class ChunkGroup {
 
 	/* istanbul ignore next */
 	/**
-	 * get a uniqueId for ChunkGroup, made up of its member Chunk debugId's
+	 * Returns a debug-only identifier derived from the group's member chunk
+	 * debug ids. This is primarily useful in diagnostics and assertions.
 	 * @returns {string} a unique concatenation of chunk debugId's
 	 */
 	get debugId() {
@@ -172,7 +187,8 @@ class ChunkGroup {
 	}
 
 	/**
-	 * get a unique id for ChunkGroup, made up of its member Chunk id's
+	 * Returns an identifier derived from the ids of the chunks currently in
+	 * the group.
 	 * @returns {string} a unique concatenation of chunk ids
 	 */
 	get id() {
@@ -180,7 +196,8 @@ class ChunkGroup {
 	}
 
 	/**
-	 * Performs an unshift of a specific chunk
+	 * Moves a chunk to the front of the group or inserts it when it is not
+	 * already present.
 	 * @param {Chunk} chunk chunk being unshifted
 	 * @returns {boolean} returns true if attempted chunk shift is accepted
 	 */
@@ -197,7 +214,8 @@ class ChunkGroup {
 	}
 
 	/**
-	 * inserts a chunk before another existing chunk in group
+	 * Inserts a chunk directly before another chunk that already belongs to the
+	 * group, preserving the rest of the ordering.
 	 * @param {Chunk} chunk Chunk being inserted
 	 * @param {Chunk} before Placeholder/target chunk marking new chunk insertion point
 	 * @returns {boolean} return true if insertion was successful
@@ -219,7 +237,7 @@ class ChunkGroup {
 	}
 
 	/**
-	 * add a chunk into ChunkGroup. Is pushed on or prepended
+	 * Appends a chunk to the group when it is not already a member.
 	 * @param {Chunk} chunk chunk being pushed into ChunkGroupS
 	 * @returns {boolean} returns true if chunk addition was successful.
 	 */
@@ -233,6 +251,8 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Replaces one member chunk with another while preserving the group's
+	 * ordering and avoiding duplicates.
 	 * @param {Chunk} oldChunk chunk to be replaced
 	 * @param {Chunk} newChunk New chunk that will be replaced with
 	 * @returns {boolean | undefined} returns true if the replacement was successful
@@ -256,6 +276,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Removes a chunk from this group.
 	 * @param {Chunk} chunk chunk to remove
 	 * @returns {boolean} returns true if chunk was removed
 	 */
@@ -269,6 +290,8 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Indicates whether this chunk group is loaded as part of the initial page
+	 * load instead of being created lazily.
 	 * @returns {boolean} true, when this chunk group will be loaded on initial page load
 	 */
 	isInitial() {
@@ -276,6 +299,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Adds a child chunk group to the current group.
 	 * @param {ChunkGroup} group chunk group to add
 	 * @returns {boolean} returns true if chunk group was added
 	 */
@@ -286,6 +310,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Returns the child chunk groups reachable from this group.
 	 * @returns {ChunkGroup[]} returns the children of this group
 	 */
 	getChildren() {
@@ -301,6 +326,8 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Removes a child chunk group and clears the corresponding parent link on
+	 * the removed child.
 	 * @param {ChunkGroup} group the chunk group to remove
 	 * @returns {boolean} returns true if the chunk group was removed
 	 */
@@ -315,6 +342,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Records a parent chunk group relationship.
 	 * @param {ChunkGroup} parentChunk the parent group to be added into
 	 * @returns {boolean} returns true if this chunk group was added to the parent group
 	 */
@@ -327,6 +355,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Returns the parent chunk groups that can lead to this group.
 	 * @returns {ChunkGroup[]} returns the parents of this group
 	 */
 	getParents() {
@@ -338,6 +367,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Checks whether the provided group is registered as a parent.
 	 * @param {ChunkGroup} parent the parent group
 	 * @returns {boolean} returns true if the parent group contains this group
 	 */
@@ -350,6 +380,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Removes a parent chunk group and clears the reverse child relationship.
 	 * @param {ChunkGroup} chunkGroup the parent group
 	 * @returns {boolean} returns true if this group has been removed from the parent
 	 */
@@ -362,6 +393,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Registers an async entrypoint that is rooted in this chunk group.
 	 * @param {Entrypoint} entrypoint entrypoint to add
 	 * @returns {boolean} returns true if entrypoint was added
 	 */
@@ -376,6 +408,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Returns the async dependency blocks that create or reference this group.
 	 * @returns {AsyncDependenciesBlock[]} an array containing the blocks
 	 */
 	getBlocks() {
@@ -387,6 +420,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Checks whether an async dependency block is associated with this group.
 	 * @param {AsyncDependenciesBlock} block block
 	 * @returns {boolean} true, if block exists
 	 */
@@ -395,6 +429,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Exposes the group's async dependency blocks as an iterable.
 	 * @returns {Iterable<AsyncDependenciesBlock>} blocks
 	 */
 	get blocksIterable() {
@@ -402,6 +437,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Associates an async dependency block with this chunk group.
 	 * @param {AsyncDependenciesBlock} block a block
 	 * @returns {boolean} false, if block was already added
 	 */
@@ -414,6 +450,8 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Records where this chunk group originated from in user code.
+	 * The origin is used for diagnostics, ordering, and reporting.
 	 * @param {Module | null} module origin module
 	 * @param {DependencyLocation} loc location of the reference in the origin module
 	 * @param {string} request request name of the reference
@@ -428,6 +466,7 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Collects the emitted files produced by every chunk in the group.
 	 * @returns {string[]} the files contained this chunk group
 	 */
 	getFiles() {
@@ -444,6 +483,9 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Disconnects this group from its parents, children, and chunks.
+	 * Child groups are reconnected to this group's parents so the surrounding
+	 * graph remains intact after removal.
 	 * @returns {void}
 	 */
 	remove() {
@@ -503,6 +545,8 @@ class ChunkGroup {
 	}
 
 	/**
+	 * Groups child chunk groups by their `*Order` options and sorts each group
+	 * by descending order and deterministic chunk-group comparison.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @returns {Record<string, ChunkGroup[]>} mapping from children type to ordered list of ChunkGroups
@@ -543,7 +587,7 @@ class ChunkGroup {
 	}
 
 	/**
-	 * Sets the top-down index of a module in this ChunkGroup
+	 * Stores the module's top-down traversal index within this group.
 	 * @param {Module} module module for which the index should be set
 	 * @param {number} index the index of the module
 	 * @returns {void}
@@ -553,7 +597,7 @@ class ChunkGroup {
 	}
 
 	/**
-	 * Gets the top-down index of a module in this ChunkGroup
+	 * Returns the module's top-down traversal index within this group.
 	 * @param {Module} module the module
 	 * @returns {number | undefined} index
 	 */
@@ -562,7 +606,7 @@ class ChunkGroup {
 	}
 
 	/**
-	 * Sets the bottom-up index of a module in this ChunkGroup
+	 * Stores the module's bottom-up traversal index within this group.
 	 * @param {Module} module module for which the index should be set
 	 * @param {number} index the index of the module
 	 * @returns {void}
@@ -572,7 +616,7 @@ class ChunkGroup {
 	}
 
 	/**
-	 * Gets the bottom-up index of a module in this ChunkGroup
+	 * Returns the module's bottom-up traversal index within this group.
 	 * @param {Module} module the module
 	 * @returns {number | undefined} index
 	 */

package/lib/ChunkTemplate.js

@@ -20,6 +20,7 @@ const memoize = require("./util/memoize");
 /** @typedef {import("./ModuleTemplate")} ModuleTemplate */
 /** @typedef {import("./javascript/JavascriptModulesPlugin").RenderContext} RenderContext */
 /**
+ * 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 ChunkTemplate {
 	/**
+	 * Creates an instance of ChunkTemplate.
 	 * @param {OutputOptions} outputOptions output options
 	 * @param {Compilation} compilation the compilation
 	 */
@@ -40,6 +42,7 @@ class ChunkTemplate {
 			renderManifest: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(renderManifestEntries: RenderManifestEntry[], renderManifestOptions: RenderManifestOptions) => RenderManifestEntry[]} fn function
@@ -60,6 +63,7 @@ class ChunkTemplate {
 			modules: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(source: Source, moduleTemplate: ModuleTemplate, renderContext: RenderContext) => Source} fn function
@@ -82,6 +86,7 @@ class ChunkTemplate {
 			render: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(source: Source, moduleTemplate: ModuleTemplate, renderContext: RenderContext) => Source} fn function
@@ -104,6 +109,7 @@ class ChunkTemplate {
 			renderWithEntry: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(source: Source, chunk: Chunk) => Source} fn function
@@ -130,6 +136,7 @@ class ChunkTemplate {
 			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 function
@@ -144,6 +151,7 @@ class ChunkTemplate {
 			hashForChunk: {
 				tap: util.deprecate(
 					/**
+					 * Handles the callback logic for this hook.
 					 * @template AdditionalOptions
 					 * @param {string | Tap & IfSet<AdditionalOptions>} options options
 					 * @param {(hash: Hash, chunk: Chunk, chunkHashContext: ChunkHashContext) => void} fn function
@@ -167,6 +175,7 @@ class ChunkTemplate {
 Object.defineProperty(ChunkTemplate.prototype, "outputOptions", {
 	get: util.deprecate(
 		/**
+		 * Returns output options.
 		 * @this {ChunkTemplate}
 		 * @returns {OutputOptions} output options
 		 */

package/lib/CleanPlugin.js

@@ -22,11 +22,13 @@ const processAsyncTree = require("./util/processAsyncTree");
 /** @typedef {Map<string, number>} Assets */
 
 /**
+ * Defines the clean plugin compilation hooks type used by this module.
  * @typedef {object} CleanPluginCompilationHooks
  * @property {SyncBailHook<[string], boolean | void>} keep when returning true the file/directory will be kept during cleaning, returning false will clean it and ignore the following plugins and config
  */
 
 /**
+ * Defines the keep fn callback.
  * @callback KeepFn
  * @param {string} path path
  * @returns {boolean | undefined} true, if the path should be kept
@@ -50,6 +52,7 @@ const mergeAssets = (as1, as2) => {
 /** @typedef {Map<string, number>} CurrentAssets */
 
 /**
+ * Returns set of directory paths.
  * @param {CurrentAssets} assets current assets
  * @returns {Set<string>} Set of directory paths
  */
@@ -57,6 +60,7 @@ function getDirectories(assets) {
 	/** @type {Set<string>} */
 	const directories = new Set();
 	/**
+	 * Adds the provided filename to this object.
 	 * @param {string} filename asset filename
 	 */
 	const addDirectory = (filename) => {
@@ -77,6 +81,7 @@ function getDirectories(assets) {
 /** @typedef {Set<string>} Diff */
 
 /**
+ * Returns diff to fs.
  * @param {OutputFileSystem} fs filesystem
  * @param {string} outputPath output path
  * @param {CurrentAssets} currentAssets filename of the current assets (must not start with .. or ., must only use / as path separator)
@@ -123,6 +128,7 @@ const getDiffToFs = (fs, outputPath, currentAssets, callback) => {
 };
 
 /**
+ * Gets diff to old assets.
  * @param {Assets} currentAssets assets list
  * @param {Assets} oldAssets old assets list
  * @returns {Diff} diff
@@ -139,6 +145,7 @@ const getDiffToOldAssets = (currentAssets, oldAssets) => {
 };
 
 /**
+ * Processes the provided f.
  * @param {OutputFileSystem} fs filesystem
  * @param {string} filename path to file
  * @param {StatsCallback} callback callback for provided filename
@@ -154,6 +161,7 @@ const doStat = (fs, filename, callback) => {
 };
 
 /**
+ * Processes the provided f.
  * @param {OutputFileSystem} fs filesystem
  * @param {string} outputPath output path
  * @param {boolean} dry only log instead of fs modification
@@ -165,6 +173,7 @@ const doStat = (fs, filename, callback) => {
  */
 const applyDiff = (fs, outputPath, dry, logger, diff, isKept, callback) => {
 	/**
+	 * Processes the provided msg.
 	 * @param {string} msg message
 	 */
 	const log = (msg) => {
@@ -189,6 +198,7 @@ const applyDiff = (fs, outputPath, dry, logger, diff, isKept, callback) => {
 		({ type, filename, parent }, push, callback) => {
 			const path = join(fs, outputPath, filename);
 			/**
+			 * Describes how this handle error operation behaves.
 			 * @param {Error & { code?: string }} err error
 			 * @returns {void}
 			 */
@@ -331,6 +341,7 @@ const PLUGIN_NAME = "CleanPlugin";
 
 class CleanPlugin {
 	/**
+	 * Returns the attached hooks.
 	 * @param {Compilation} compilation the compilation
 	 * @returns {CleanPluginCompilationHooks} the attached hooks
 	 */
@@ -357,7 +368,7 @@ class CleanPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -445,6 +456,7 @@ class CleanPlugin {
 				const outputPath = compilation.getPath(compiler.outputPath, {});
 
 				/**
+				 * Checks whether this clean plugin is kept.
 				 * @param {string} path path
 				 * @returns {boolean | undefined} true, if needs to be kept
 				 */
@@ -455,6 +467,7 @@ class CleanPlugin {
 				};
 
 				/**
+				 * Processes the provided err.
 				 * @param {(Error | null)=} err err
 				 * @param {Diff=} diff diff
 				 */

package/lib/CodeGenerationResults.js

@@ -20,8 +20,14 @@ const { RuntimeSpecMap, runtimeToString } = require("./util/runtime");
 /** @typedef {import("./util/Hash").HashFunction} HashFunction */
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
 
+/**
+ * Stores code generation results keyed by module and runtime so later stages
+ * can retrieve emitted sources, metadata, and derived hashes.
+ */
 class CodeGenerationResults {
 	/**
+	 * Initializes an empty result store and remembers which hash function should
+	 * be used when a result hash needs to be derived lazily.
 	 * @param {HashFunction} hashFunction the hash function to use
 	 */
 	constructor(hashFunction = DEFAULTS.HASH_FUNCTION) {
@@ -32,6 +38,8 @@ class CodeGenerationResults {
 	}
 
 	/**
+	 * Returns the code generation result for a module/runtime pair, rejecting
+	 * ambiguous lookups where no unique runtime-independent result exists.
 	 * @param {Module} module the module
 	 * @param {RuntimeSpec} runtime runtime(s)
 	 * @returns {CodeGenerationResult} the CodeGenerationResult
@@ -77,6 +85,8 @@ Caller might not support runtime-dependent code generation (opt-out via optimiza
 	}
 
 	/**
+	 * Reports whether a module has a stored result for the requested runtime, or
+	 * a single unambiguous result when no runtime is specified.
 	 * @param {Module} module the module
 	 * @param {RuntimeSpec} runtime runtime(s)
 	 * @returns {boolean} true, when we have data for this
@@ -96,6 +106,8 @@ Caller might not support runtime-dependent code generation (opt-out via optimiza
 	}
 
 	/**
+	 * Returns a generated source of the requested source type from a stored code
+	 * generation result.
 	 * @param {Module} module the module
 	 * @param {RuntimeSpec} runtime runtime(s)
 	 * @param {SourceType} sourceType the source type
@@ -108,6 +120,8 @@ Caller might not support runtime-dependent code generation (opt-out via optimiza
 	}
 
 	/**
+	 * Returns the runtime requirements captured during code generation for the
+	 * requested module/runtime pair.
 	 * @param {Module} module the module
 	 * @param {RuntimeSpec} runtime runtime(s)
 	 * @returns {ReadOnlyRuntimeRequirements | null} runtime requirements
@@ -117,6 +131,7 @@ Caller might not support runtime-dependent code generation (opt-out via optimiza
 	}
 
 	/**
+	 * Returns an arbitrary metadata entry recorded during code generation.
 	 * @param {Module} module the module
 	 * @param {RuntimeSpec} runtime runtime(s)
 	 * @param {string} key data key
@@ -128,6 +143,8 @@ Caller might not support runtime-dependent code generation (opt-out via optimiza
 	}
 
 	/**
+	 * Returns a stable hash for the generated sources and runtime requirements,
+	 * computing and caching it on first access.
 	 * @param {Module} module the module
 	 * @param {RuntimeSpec} runtime runtime(s)
 	 * @returns {string} hash of the code generation
@@ -147,6 +164,8 @@ Caller might not support runtime-dependent code generation (opt-out via optimiza
 	}
 
 	/**
+	 * Stores a code generation result for a module/runtime pair, creating the
+	 * per-module runtime map when needed.
 	 * @param {Module} module the module
 	 * @param {RuntimeSpec} runtime runtime(s)
 	 * @param {CodeGenerationResult} result result from module

package/lib/CommentCompilationWarning.js

@@ -10,8 +10,14 @@ const makeSerializable = require("./util/makeSerializable");
 
 /** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
 
+/**
+ * Warning used for comment-related compilation issues, such as malformed magic
+ * comments that webpack can parse but wants to report.
+ */
 class CommentCompilationWarning extends WebpackError {
 	/**
+	 * Captures a warning message together with the dependency location that
+	 * triggered it.
 	 * @param {string} message warning message
 	 * @param {DependencyLocation} loc affected lines of code
 	 */

package/lib/CompatibilityPlugin.js

@@ -21,6 +21,8 @@ const ConstDependency = require("./dependencies/ConstDependency");
 /** @typedef {import("./javascript/JavascriptParser").Range} Range */
 
 /**
+ * Captures the source range of a renamed compatibility binding so it can be
+ * rewritten exactly once.
  * @typedef {object} CompatibilitySettingsDeclaration
  * @property {boolean} updated
  * @property {DependencyLocation} loc
@@ -28,6 +30,8 @@ const ConstDependency = require("./dependencies/ConstDependency");
  */
 
 /**
+ * Stores the replacement variable name and the declaration metadata tracked
+ * for a compatibility rewrite.
  * @typedef {object} CompatibilitySettings
  * @property {string} name
  * @property {CompatibilitySettingsDeclaration} declaration
@@ -36,9 +40,14 @@ const ConstDependency = require("./dependencies/ConstDependency");
 const nestedWebpackIdentifierTag = Symbol("nested webpack identifier");
 const PLUGIN_NAME = "CompatibilityPlugin";
 
+/**
+ * Adds parser-time compatibility rewrites for legacy runtime patterns that
+ * webpack still needs to recognize in user and generated code.
+ */
 class CompatibilityPlugin {
 	/**
-	 * Apply the plugin
+	 * Installs parser hooks that preserve compatibility with legacy patterns
+	 * such as nested `__webpack_require__` bindings and hashbang handling.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -64,6 +73,9 @@ class CompatibilityPlugin {
 						parser.hooks.call.for("require").tap(
 							PLUGIN_NAME,
 							/**
+							 * Rewrites browserify-style delegated `require` calls into a
+							 * plain webpack require reference and removes the synthetic
+							 * context dependency created for the delegator pattern.
 							 * @param {CallExpression} expr call expression
 							 * @returns {boolean | void} true when need to handle
 							 */
@@ -103,6 +115,8 @@ class CompatibilityPlugin {
 					});
 
 				/**
+				 * Attaches the compatibility rewrites for a JavaScript parser
+				 * instance.
 				 * @param {JavascriptParser} parser the parser
 				 * @returns {void}
 				 */