webpack 5.106.1 → 5.107.0

package/lib/ContextReplacementPlugin.js

@@ -20,6 +20,7 @@ const PLUGIN_NAME = "ContextReplacementPlugin";
 
 class ContextReplacementPlugin {
 	/**
+	 * Creates an instance of ContextReplacementPlugin.
 	 * @param {RegExp} resourceRegExp A regular expression that determines which files will be selected
 	 * @param {(string | ((context: BeforeContextResolveData | AfterContextResolveData) => void) | RegExp | boolean)=} newContentResource A new resource to replace the match
 	 * @param {(boolean | NewContentCreateContextMap | RegExp)=} newContentRecursive If true, all subdirectories are searched for matches
@@ -44,6 +45,7 @@ class ContextReplacementPlugin {
 		) {
 			this.newContentResource = newContentResource;
 			/**
+			 * Stores new content create context map.
 			 * @param {InputFileSystem} fs input file system
 			 * @param {(err: null | Error, newContentRecursive: NewContentCreateContextMap) => void} callback callback
 			 */
@@ -87,7 +89,7 @@ class ContextReplacementPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -202,6 +204,7 @@ class ContextReplacementPlugin {
 }
 
 /**
+ * Creates a resolve dependencies from context map.
  * @param {(fs: InputFileSystem, callback: (err: null | Error, map: NewContentCreateContextMap) => void) => void} createContextMap create context map function
  * @returns {(fs: InputFileSystem, options: ContextModuleOptions, callback: (err: null | Error, dependencies?: ContextElementDependency[]) => void) => void} resolve resolve dependencies from context map function
  */

package/lib/DefinePlugin.js

@@ -12,8 +12,8 @@ const {
 	JAVASCRIPT_MODULE_TYPE_ESM
 } = require("./ModuleTypeConstants");
 const RuntimeGlobals = require("./RuntimeGlobals");
-const WebpackError = require("./WebpackError");
 const ConstDependency = require("./dependencies/ConstDependency");
+const WebpackError = require("./errors/WebpackError");
 const BasicEvaluatedExpression = require("./javascript/BasicEvaluatedExpression");
 const { VariableInfo } = require("./javascript/JavascriptParser");
 const {
@@ -39,6 +39,7 @@ const createHash = require("./util/createHash");
 /** @typedef {RecursiveArrayOrRecord<CodeValuePrimitive | RuntimeValue>} CodeValue */
 
 /**
+ * Defines the runtime value options type used by this module.
  * @typedef {object} RuntimeValueOptions
  * @property {string[]=} fileDependencies
  * @property {string[]=} contextDependencies
@@ -51,6 +52,7 @@ const createHash = require("./util/createHash");
 
 class RuntimeValue {
 	/**
+	 * Creates an instance of RuntimeValue.
 	 * @param {GeneratorFn} fn generator function
 	 * @param {true | string[] | RuntimeValueOptions=} options options
 	 */
@@ -71,6 +73,7 @@ class RuntimeValue {
 	}
 
 	/**
+	 * Returns code.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {ValueCacheVersions} valueCacheVersions valueCacheVersions
 	 * @param {string} key the defined key
@@ -128,6 +131,7 @@ class RuntimeValue {
 }
 
 /**
+ * Returns used keys.
  * @param {DestructuringAssignmentProperties | undefined} properties properties
  * @returns {Set<string> | undefined} used keys
  */
@@ -140,6 +144,7 @@ function getObjKeys(properties) {
 /** @typedef {boolean | undefined | null} AsiSafe */
 
 /**
+ * Returns code converted to string that evaluates.
  * @param {EXPECTED_ANY[] | { [k: string]: EXPECTED_ANY }} obj obj
  * @param {JavascriptParser} parser Parser
  * @param {ValueCacheVersions} valueCacheVersions valueCacheVersions
@@ -287,6 +292,7 @@ const toCode = (
 };
 
 /**
+ * Returns result.
  * @param {CodeValue} code code
  * @returns {string | undefined} result
  */
@@ -313,7 +319,7 @@ const toCacheVersion = (code) => {
 		const items = Object.keys(code).map((key) => ({
 			key,
 			value: toCacheVersion(
-				/** @type {Record<string, EXPECTED_ANY>} */
+				/** @type {Record<string, CodeValue>} */
 				(code)[key]
 			)
 		}));
@@ -336,6 +342,7 @@ const WEBPACK_REQUIRE_FUNCTION_REGEXP = new RegExp(
 const WEBPACK_REQUIRE_IDENTIFIER_REGEXP = new RegExp(RuntimeGlobals.require);
 
 /**
+ * Defines the define plugin hooks type used by this module.
  * @typedef {object} DefinePluginHooks
  * @property {SyncWaterfallHook<[Record<string, CodeValue>]>} definitions
  */
@@ -347,6 +354,7 @@ const compilationHooksMap = new WeakMap();
 
 class DefinePlugin {
 	/**
+	 * Returns the attached hooks.
 	 * @param {Compilation} compilation the compilation
 	 * @returns {DefinePluginHooks} the attached hooks
 	 */
@@ -371,6 +379,7 @@ class DefinePlugin {
 	}
 
 	/**
+	 * Returns runtime value.
 	 * @param {GeneratorFn} fn generator function
 	 * @param {true | string[] | RuntimeValueOptions=} options options
 	 * @returns {RuntimeValue} runtime value
@@ -380,7 +389,7 @@ class DefinePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -419,7 +428,7 @@ class DefinePlugin {
 				);
 
 				/**
-				 * Handler
+				 * Handles the hook callback for this code path.
 				 * @param {JavascriptParser} parser Parser
 				 * @returns {void}
 				 */
@@ -440,6 +449,7 @@ class DefinePlugin {
 					});
 
 					/**
+					 * Adds value dependency.
 					 * @param {string} key key
 					 */
 					const addValueDependency = (key) => {
@@ -455,6 +465,7 @@ class DefinePlugin {
 					};
 
 					/**
+					 * With value dependency.
 					 * @template T
 					 * @param {string} key key
 					 * @param {(expression: Expression) => T} fn fn
@@ -468,7 +479,7 @@ class DefinePlugin {
 						};
 
 					/**
-					 * Walk definitions
+					 * Processes the provided definition.
 					 * @param {Definitions} definitions Definitions map
 					 * @param {string} prefix Prefix string
 					 * @returns {void}
@@ -495,7 +506,7 @@ class DefinePlugin {
 					};
 
 					/**
-					 * Apply define key
+					 * Processes the provided prefix.
 					 * @param {string} prefix Prefix
 					 * @param {string} key Key
 					 * @returns {void}
@@ -580,7 +591,7 @@ class DefinePlugin {
 					};
 
 					/**
-					 * Apply Code
+					 * Processes the provided key.
 					 * @param {string} key Key
 					 * @param {CodeValue} code Code
 					 * @returns {void}
@@ -703,7 +714,7 @@ class DefinePlugin {
 					};
 
 					/**
-					 * Apply Object
+					 * Processes the provided key.
 					 * @param {string} key Key
 					 * @param {object} obj Object
 					 * @returns {void}
@@ -788,7 +799,7 @@ class DefinePlugin {
 					.tap(PLUGIN_NAME, handler);
 
 				/**
-				 * Walk definitions
+				 * Processes the provided definition.
 				 * @param {Definitions} definitions Definitions map
 				 * @param {string} prefix Prefix string
 				 * @returns {void}
@@ -825,11 +836,13 @@ class DefinePlugin {
 				};
 
 				/**
+				 * Walk definitions for keys.
 				 * @param {Definitions} definitions Definitions map
 				 * @returns {void}
 				 */
 				const walkDefinitionsForKeys = (definitions) => {
 					/**
+					 * Adds the provided map to the define plugin.
 					 * @param {Map<string, Set<string>>} map Map
 					 * @param {string} key key
 					 * @param {string} value v

package/lib/DependenciesBlock.js

@@ -53,6 +53,7 @@ class DependenciesBlock {
 	}
 
 	/**
+	 * Adds the provided dependency to the dependencies block.
 	 * @param {Dependency} dependency dependency being tied to block.
 	 * This is an "edge" pointing to another "node" on module graph.
 	 * @returns {void}
@@ -62,6 +63,7 @@ class DependenciesBlock {
 	}
 
 	/**
+	 * Removes dependency.
 	 * @param {Dependency} dependency dependency being removed
 	 * @returns {void}
 	 */
@@ -73,7 +75,7 @@ class DependenciesBlock {
 	}
 
 	/**
-	 * Removes all dependencies and blocks
+	 * Clear dependencies and blocks.
 	 * @returns {void}
 	 */
 	clearDependenciesAndBlocks() {
@@ -82,6 +84,7 @@ class 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}
@@ -96,6 +99,7 @@ class DependenciesBlock {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write }) {
@@ -104,6 +108,7 @@ class DependenciesBlock {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize({ read }) {

package/lib/Dependency.js

@@ -14,13 +14,14 @@ const memoize = require("./util/memoize");
 /** @typedef {import("./ModuleGraphConnection")} ModuleGraphConnection */
 /** @typedef {import("./ModuleGraphConnection").ConnectionState} ConnectionState */
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
-/** @typedef {import("./WebpackError")} WebpackError */
+/** @typedef {import("./errors/WebpackError")} WebpackError */
 /** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
 /** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 /** @typedef {import("./util/Hash")} Hash */
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
 /** @typedef {import("./dependencies/ModuleDependency")} ModuleDependency */
 /**
+ * Defines the update hash context type used by this module.
  * @typedef {object} UpdateHashContext
  * @property {ChunkGraph} chunkGraph
  * @property {RuntimeSpec} runtime
@@ -28,12 +29,14 @@ const memoize = require("./util/memoize");
  */
 
 /**
+ * Defines the source position type used by this module.
  * @typedef {object} SourcePosition
  * @property {number} line
  * @property {number=} column
  */
 
 /**
+ * Defines the real dependency location type used by this module.
  * @typedef {object} RealDependencyLocation
  * @property {SourcePosition} start
  * @property {SourcePosition=} end
@@ -41,6 +44,7 @@ const memoize = require("./util/memoize");
  */
 
 /**
+ * Defines the synthetic dependency location type used by this module.
  * @typedef {object} SyntheticDependencyLocation
  * @property {string} name
  * @property {number=} index
@@ -51,6 +55,7 @@ const memoize = require("./util/memoize");
 /** @typedef {string} ExportInfoName */
 
 /**
+ * Defines the export spec type used by this module.
  * @typedef {object} ExportSpec
  * @property {ExportInfoName} name the name of the export
  * @property {boolean=} canMangle can the export be renamed (defaults to true)
@@ -65,6 +70,7 @@ const memoize = require("./util/memoize");
 /** @typedef {Set<string>} ExportsSpecExcludeExports */
 
 /**
+ * Defines the exports spec type used by this module.
  * @typedef {object} ExportsSpec
  * @property {(string | ExportSpec)[] | true | null} exports exported names, true for unknown exports or null for no exports
  * @property {ExportsSpecExcludeExports=} excludeExports when exports = true, list of unaffected exports
@@ -77,6 +83,7 @@ const memoize = require("./util/memoize");
  */
 
 /**
+ * Defines the referenced export type used by this module.
  * @typedef {object} ReferencedExport
  * @property {string[]} name name of the referenced export
  * @property {boolean=} canMangle when false, referenced export can not be mangled, defaults to true
@@ -124,6 +131,7 @@ class Dependency {
 	}
 
 	/**
+	 * Returns a display name for the type of dependency.
 	 * @returns {string} a display name for the type of dependency
 	 */
 	get type() {
@@ -131,6 +139,7 @@ class Dependency {
 	}
 
 	/**
+	 * Returns a dependency category, typical categories are "commonjs", "amd", "esm".
 	 * @returns {string} a dependency category, typical categories are "commonjs", "amd", "esm"
 	 */
 	get category() {
@@ -138,6 +147,7 @@ class Dependency {
 	}
 
 	/**
+	 * Returns location.
 	 * @returns {DependencyLocation} location
 	 */
 	get loc() {
@@ -183,6 +193,7 @@ class Dependency {
 	}
 
 	/**
+	 * Updates loc using the provided start line.
 	 * @param {number} startLine start line
 	 * @param {number} startColumn start column
 	 * @param {number} endLine end line
@@ -199,6 +210,7 @@ class Dependency {
 	}
 
 	/**
+	 * Returns a request context.
 	 * @returns {string | undefined} a request context
 	 */
 	getContext() {
@@ -206,6 +218,7 @@ class Dependency {
 	}
 
 	/**
+	 * Returns an identifier to merge equal requests.
 	 * @returns {string | null} an identifier to merge equal requests
 	 */
 	getResourceIdentifier() {
@@ -213,6 +226,7 @@ class Dependency {
 	}
 
 	/**
+	 * Could affect referencing module.
 	 * @returns {boolean | TRANSITIVE} true, when changes to the referenced module could affect the referencing module; TRANSITIVE, when changes to the referenced module could affect referencing modules of the referencing module
 	 */
 	couldAffectReferencingModule() {
@@ -242,6 +256,7 @@ class Dependency {
 	}
 
 	/**
+	 * Returns function to determine if the connection is active.
 	 * @param {ModuleGraph} moduleGraph module graph
 	 * @returns {null | false | GetConditionFn} function to determine if the connection is active
 	 */
@@ -259,7 +274,7 @@ class Dependency {
 	}
 
 	/**
-	 * Returns warnings
+	 * Returns warnings.
 	 * @param {ModuleGraph} moduleGraph module graph
 	 * @returns {WebpackError[] | null | undefined} warnings
 	 */
@@ -268,7 +283,7 @@ class Dependency {
 	}
 
 	/**
-	 * Returns errors
+	 * Returns errors.
 	 * @param {ModuleGraph} moduleGraph module graph
 	 * @returns {WebpackError[] | null | undefined} errors
 	 */
@@ -277,7 +292,7 @@ class Dependency {
 	}
 
 	/**
-	 * Update the hash
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash hash to be updated
 	 * @param {UpdateHashContext} context context
 	 * @returns {void}
@@ -293,6 +308,7 @@ class Dependency {
 	}
 
 	/**
+	 * Gets module evaluation side effects state.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @returns {ConnectionState} how this dependency connects the module to referencing modules
 	 */
@@ -301,6 +317,7 @@ class Dependency {
 	}
 
 	/**
+	 * Creates an ignored module.
 	 * @param {string} context context directory
 	 * @returns {Module} ignored module
 	 */
@@ -309,6 +326,15 @@ class Dependency {
 	}
 
 	/**
+	 * Returns true if this dependency can be concatenated
+	 * @returns {boolean} true if this dependency can be concatenated
+	 */
+	canConcatenate() {
+		return false;
+	}
+
+	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write }) {
@@ -323,6 +349,7 @@ class Dependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize({ read }) {
@@ -345,6 +372,7 @@ Dependency.EXPORTS_OBJECT_REFERENCED = [[]];
 // TODO remove in webpack 6
 Object.defineProperty(Dependency.prototype, "module", {
 	/**
+	 * Returns throws.
 	 * @deprecated
 	 * @returns {EXPECTED_ANY} throws
 	 */
@@ -355,6 +383,7 @@ Object.defineProperty(Dependency.prototype, "module", {
 	},
 
 	/**
+	 * Updates module.
 	 * @deprecated
 	 * @returns {never} throws
 	 */
@@ -366,15 +395,30 @@ Object.defineProperty(Dependency.prototype, "module", {
 });
 
 /**
+ * Returns true if the dependency is a low priority dependency.
  * @param {Dependency} dependency dep
  * @returns {boolean} true if the dependency is a low priority dependency
  */
 Dependency.isLowPriorityDependency = (dependency) =>
 	/** @type {ModuleDependency} */ (dependency).sourceOrder === Infinity;
 
+// TODO in webpack 6, call canConcatenate() directly on the dependency instance instead of using this static method.
+/**
+ * Returns true if the dependency can be concatenated (scope hoisting).
+ * @param {Dependency} dependency dep
+ * @returns {boolean} true if this dependency supports concatenation
+ */
+Dependency.canConcatenate = (dependency) => {
+	if (typeof dependency.canConcatenate === "function") {
+		return dependency.canConcatenate();
+	}
+	return false;
+};
+
 // TODO remove in webpack 6
 Object.defineProperty(Dependency.prototype, "disconnect", {
 	/**
+	 * Returns throws.
 	 * @deprecated
 	 * @returns {EXPECTED_ANY} throws
 	 */

package/lib/DependencyTemplate.js

@@ -19,11 +19,13 @@
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
 
 /**
+ * Defines the init fragment type used by this module.
  * @template T
  * @typedef {import("./InitFragment")<T>} InitFragment
  */
 
 /**
+ * Defines the dependency template context type used by this module.
  * @typedef {object} DependencyTemplateContext
  * @property {RuntimeTemplate} runtimeTemplate the runtime template
  * @property {DependencyTemplates} dependencyTemplates the dependency templates
@@ -39,15 +41,18 @@
  */
 
 /**
+ * Defines the css dependency template context extras type used by this module.
  * @typedef {object} CssDependencyTemplateContextExtras
  * @property {CssData} cssData the css exports data
  * @property {string} type the css exports data
  */
 
 /**
+ * Defines the css data type used by this module.
  * @typedef {object} CssData
  * @property {boolean} esModule whether export __esModule
  * @property {Map<string, string>} exports the css exports
+ * @property {Map<string, { line: number, column: number }>=} exportLocs source position (line is 1-based, column is 0-based) of each export's defining identifier in the original CSS, used to emit fine-grained JS-to-CSS source mappings
  */
 
 /** @typedef {DependencyTemplateContext & CssDependencyTemplateContextExtras} CssDependencyTemplateContext */
@@ -55,6 +60,7 @@
 class DependencyTemplate {
 	/* istanbul ignore next */
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @abstract
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
@@ -62,7 +68,7 @@ class DependencyTemplate {
 	 * @returns {void}
 	 */
 	apply(dependency, source, templateContext) {
-		const AbstractMethodError = require("./AbstractMethodError");
+		const AbstractMethodError = require("./errors/AbstractMethodError");
 
 		throw new AbstractMethodError();
 	}

package/lib/DependencyTemplates.js

@@ -14,6 +14,7 @@ const createHash = require("./util/createHash");
 
 class DependencyTemplates {
 	/**
+	 * Creates an instance of DependencyTemplates.
 	 * @param {HashFunction} hashFunction the hash function to use
 	 */
 	constructor(hashFunction = DEFAULTS.HASH_FUNCTION) {
@@ -26,6 +27,7 @@ class DependencyTemplates {
 	}
 
 	/**
+	 * Returns template for this dependency.
 	 * @param {DependencyConstructor} dependency Constructor of Dependency
 	 * @returns {DependencyTemplate | undefined} template for this dependency
 	 */
@@ -34,6 +36,7 @@ class DependencyTemplates {
 	}
 
 	/**
+	 * Updates value using the provided dependency.
 	 * @param {DependencyConstructor} dependency Constructor of Dependency
 	 * @param {DependencyTemplate} dependencyTemplate template for this dependency
 	 * @returns {void}
@@ -43,6 +46,7 @@ class DependencyTemplates {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {string} part additional hash contributor
 	 * @returns {void}
 	 */

package/lib/DotenvPlugin.js

@@ -214,6 +214,7 @@ const envToDefinitions = (env) => {
 
 class DotenvPlugin {
 	/**
+	 * Creates an instance of DotenvPlugin.
 	 * @param {DotenvPluginOptions=} options options object
 	 */
 	constructor(options = {}) {
@@ -222,6 +223,7 @@ class DotenvPlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -355,6 +357,7 @@ class DotenvPlugin {
 	}
 
 	/**
+	 * Loads the provided compiler.
 	 * @private
 	 * @param {Compiler} compiler compiler
 	 * @param {ItemCacheFacade} itemCache item cache facade

package/lib/DynamicEntryPlugin.js

@@ -21,6 +21,7 @@ const PLUGIN_NAME = "DynamicEntryPlugin";
 
 class DynamicEntryPlugin {
 	/**
+	 * Creates an instance of DynamicEntryPlugin.
 	 * @param {string} context the context path
 	 * @param {EntryDynamic} entry the entry value
 	 */
@@ -32,7 +33,7 @@ class DynamicEntryPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -65,6 +66,7 @@ class DynamicEntryPlugin {
 							promises.push(
 								new Promise(
 									/**
+									 * Handles the callback logic for this hook.
 									 * @param {(value?: undefined) => void} resolve resolve
 									 * @param {(reason?: Error) => void} reject reject
 									 */

package/lib/EntryOptionPlugin.js

@@ -14,6 +14,7 @@ const PLUGIN_NAME = "EntryOptionPlugin";
 
 class EntryOptionPlugin {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance one is tapping into
 	 * @returns {void}
 	 */
@@ -25,6 +26,7 @@ class EntryOptionPlugin {
 	}
 
 	/**
+	 * Apply entry option.
 	 * @param {Compiler} compiler the compiler
 	 * @param {string} context context directory
 	 * @param {Entry} entry request
@@ -56,6 +58,7 @@ class EntryOptionPlugin {
 	}
 
 	/**
+	 * Entry description to options.
 	 * @param {Compiler} compiler the compiler
 	 * @param {string} name entry name
 	 * @param {EntryDescription} desc entry description

package/lib/EntryPlugin.js

@@ -26,7 +26,7 @@ class EntryPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -52,6 +52,7 @@ class EntryPlugin {
 	}
 
 	/**
+	 * Creates a dependency.
 	 * @param {string} entry entry request
 	 * @param {EntryOptions | string} options entry options (passing string is deprecated)
 	 * @returns {EntryDependency} the dependency

package/lib/Entrypoint.js

@@ -44,6 +44,8 @@ class Entrypoint extends 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() {
@@ -90,6 +92,8 @@ class Entrypoint extends 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