webpack 5.106.1 → 5.107.0

package/lib/prefetch/ChunkPrefetchFunctionRuntimeModule.js

@@ -24,6 +24,7 @@ class ChunkPrefetchFunctionRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/prefetch/ChunkPrefetchPreloadPlugin.js

@@ -15,8 +15,14 @@ const ChunkPreloadTriggerRuntimeModule = require("./ChunkPreloadTriggerRuntimeMo
 
 const PLUGIN_NAME = "ChunkPrefetchPreloadPlugin";
 
+/**
+ * Adds runtime support for chunk prefetch and preload relationships discovered
+ * in the chunk graph.
+ */
 class ChunkPrefetchPreloadPlugin {
 	/**
+	 * Registers compilation hooks that emit the runtime modules responsible for
+	 * scheduling chunk prefetch and preload requests.
 	 * @param {Compiler} compiler the compiler
 	 * @returns {void}
 	 */

package/lib/prefetch/ChunkPrefetchStartupRuntimeModule.js

@@ -23,6 +23,7 @@ class ChunkPrefetchStartupRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/prefetch/ChunkPrefetchTriggerRuntimeModule.js

@@ -22,6 +22,7 @@ class ChunkPrefetchTriggerRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {
@@ -38,10 +39,13 @@ class ChunkPrefetchTriggerRuntimeModule extends RuntimeModule {
 				`${
 					RuntimeGlobals.ensureChunkHandlers
 				}.prefetch = ${runtimeTemplate.expressionFunction(
+					// Prefetch is best-effort; silence rejections so a failed chunk
+					// load (e.g. chunkLoadTimeout) doesn't surface as an unhandled
+					// rejection through this dangling Promise.all chain.
 					`Promise.all(promises).then(${runtimeTemplate.basicFunction(
 						"",
 						body
-					)})`,
+					)}, ${runtimeTemplate.basicFunction("", "")})`,
 					"chunkId, promises"
 				)};`
 			])

package/lib/prefetch/ChunkPreloadTriggerRuntimeModule.js

@@ -22,6 +22,7 @@ class ChunkPreloadTriggerRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/rules/BasicEffectRulePlugin.js

@@ -9,6 +9,7 @@
 /** @typedef {import("./RuleSetCompiler")} RuleSetCompiler */
 
 /**
+ * Defines the keys of types type used by this module.
  * @template T
  * @template {T[keyof T]} V
  * @typedef {import("./RuleSetCompiler").KeysOfTypes<T, V>} KeysOfTypes
@@ -20,6 +21,7 @@ const PLUGIN_NAME = "BasicEffectRulePlugin";
 
 class BasicEffectRulePlugin {
 	/**
+	 * Creates an instance of BasicEffectRulePlugin.
 	 * @param {BasicEffectRuleKeys} ruleProperty the rule property
 	 * @param {string=} effectType the effect type
 	 */
@@ -31,6 +33,7 @@ class BasicEffectRulePlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {RuleSetCompiler} ruleSetCompiler the rule set compiler
 	 * @returns {void}
 	 */

package/lib/rules/BasicMatcherRulePlugin.js

@@ -11,6 +11,7 @@
 /** @typedef {import("./RuleSetCompiler")} RuleSetCompiler */
 
 /**
+ * Defines the keys of types type used by this module.
  * @template T
  * @template {T[keyof T]} V
  * @typedef {import("./RuleSetCompiler").KeysOfTypes<T, V>} KeysOfTypes
@@ -22,6 +23,7 @@ const PLUGIN_NAME = "BasicMatcherRulePlugin";
 
 class BasicMatcherRulePlugin {
 	/**
+	 * Creates an instance of BasicMatcherRulePlugin.
 	 * @param {BasicMatcherRuleKeys} ruleProperty the rule property
 	 * @param {string=} dataProperty the data property
 	 * @param {boolean=} invert if true, inverts the condition
@@ -36,6 +38,7 @@ class BasicMatcherRulePlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {RuleSetCompiler} ruleSetCompiler the rule set compiler
 	 * @returns {void}
 	 */

package/lib/rules/ObjectMatcherRulePlugin.js

@@ -12,6 +12,7 @@
 /** @typedef {import("./RuleSetCompiler").RuleConditionFunction} RuleConditionFunction */
 
 /**
+ * Defines the keys of types type used by this module.
  * @template T
  * @template {T[keyof T]} V
  * @typedef {import("./RuleSetCompiler").KeysOfTypes<T, V>} KeysOfTypes
@@ -24,6 +25,7 @@ const PLUGIN_NAME = "ObjectMatcherRulePlugin";
 
 class ObjectMatcherRulePlugin {
 	/**
+	 * Creates an instance of ObjectMatcherRulePlugin.
 	 * @param {ObjectMatcherRuleKeys} ruleProperty the rule property
 	 * @param {DataProperty=} dataProperty the data property
 	 * @param {RuleConditionFunction=} additionalConditionFunction need to check
@@ -38,6 +40,7 @@ class ObjectMatcherRulePlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {RuleSetCompiler} ruleSetCompiler the rule set compiler
 	 * @returns {void}
 	 */

package/lib/rules/RuleSetCompiler.js

@@ -16,10 +16,12 @@ const { SyncHook } = require("tapable");
 /** @typedef {(Falsy | RuleSetRule)[]} RuleSetRules */
 
 /**
+ * Defines the rule condition function type used by this module.
  * @typedef {(value: EffectData[keyof EffectData]) => boolean} RuleConditionFunction
  */
 
 /**
+ * Defines the rule condition type used by this module.
  * @typedef {object} RuleCondition
  * @property {string | string[]} property
  * @property {boolean} matchWhenEmpty
@@ -27,12 +29,14 @@ const { SyncHook } = require("tapable");
  */
 
 /**
+ * Defines the condition type used by this module.
  * @typedef {object} Condition
  * @property {boolean} matchWhenEmpty
  * @property {RuleConditionFunction} fn
  */
 
 /**
+ * Defines the effect data type used by this module.
  * @typedef {object} EffectData
  * @property {string=} resource
  * @property {string=} realResource
@@ -50,6 +54,7 @@ const { SyncHook } = require("tapable");
  */
 
 /**
+ * Defines the compiled rule type used by this module.
  * @typedef {object} CompiledRule
  * @property {RuleCondition[]} conditions
  * @property {(Effect | ((effectData: EffectData) => Effect[]))[]} effects
@@ -60,12 +65,14 @@ const { SyncHook } = require("tapable");
 /** @typedef {"use" | "use-pre" | "use-post"} EffectUseType */
 
 /**
+ * Defines the effect use type used by this module.
  * @typedef {object} EffectUse
  * @property {EffectUseType} type
  * @property {{ loader: string, options?: string | null | Record<string, EXPECTED_ANY>, ident?: string }} value
  */
 
 /**
+ * Defines the effect basic type used by this module.
  * @typedef {object} EffectBasic
  * @property {string} type
  * @property {EXPECTED_ANY} value
@@ -76,12 +83,14 @@ const { SyncHook } = require("tapable");
 /** @typedef {Map<string, RuleSetLoaderOptions>} References */
 
 /**
+ * Defines the rule set type used by this module.
  * @typedef {object} RuleSet
  * @property {References} references map of references in the rule set (may grow over time)
  * @property {(effectData: EffectData) => Effect[]} exec execute the rule set
  */
 
 /**
+ * Defines the keys of types type used by this module.
  * @template T
  * @template {T[keyof T]} V
  * @typedef {({ [key in keyof Required<T>]: Required<T>[key] extends V ? key : never })[keyof T]} KeysOfTypes
@@ -96,6 +105,7 @@ const { SyncHook } = require("tapable");
 
 class RuleSetCompiler {
 	/**
+	 * Creates an instance of RuleSetCompiler.
 	 * @param {RuleSetPlugin[]} plugins plugins
 	 */
 	constructor(plugins) {
@@ -117,6 +127,7 @@ class RuleSetCompiler {
 	}
 
 	/**
+	 * Returns compiled RuleSet.
 	 * @param {RuleSetRules} ruleSet raw user provided rules
 	 * @returns {RuleSet} compiled RuleSet
 	 */
@@ -126,6 +137,7 @@ class RuleSetCompiler {
 		const rules = this.compileRules("ruleSet", ruleSet, refs);
 
 		/**
+		 * Returns true, if the rule has matched.
 		 * @param {EffectData} data data passed in
 		 * @param {CompiledRule} rule the compiled rule
 		 * @param {Effect[]} effects an array where effects are pushed to
@@ -203,6 +215,7 @@ class RuleSetCompiler {
 	}
 
 	/**
+	 * Returns rules.
 	 * @param {string} path current path
 	 * @param {RuleSetRules} rules the raw rules provided by user
 	 * @param {References} refs references
@@ -221,6 +234,7 @@ class RuleSetCompiler {
 	}
 
 	/**
+	 * Returns normalized and compiled rule for processing.
 	 * @param {string} path current path
 	 * @param {RuleSetRule} rule the raw rule provided by user
 	 * @param {References} refs references
@@ -274,6 +288,7 @@ class RuleSetCompiler {
 	}
 
 	/**
+	 * Returns compiled condition.
 	 * @param {string} path current path
 	 * @param {RuleSetLoaderOptions} condition user provided condition value
 	 * @returns {Condition} compiled condition
@@ -395,6 +410,7 @@ class RuleSetCompiler {
 	}
 
 	/**
+	 * Combine conditions or.
 	 * @param {Condition[]} conditions some conditions
 	 * @returns {Condition} merged condition
 	 */
@@ -414,6 +430,7 @@ class RuleSetCompiler {
 	}
 
 	/**
+	 * Combine conditions and.
 	 * @param {Condition[]} conditions some conditions
 	 * @returns {Condition} merged condition
 	 */
@@ -433,6 +450,7 @@ class RuleSetCompiler {
 	}
 
 	/**
+	 * Returns an error object.
 	 * @param {string} path current path
 	 * @param {EXPECTED_ANY} value value at the error location
 	 * @param {string} message message explaining the problem

package/lib/rules/UseEffectRulePlugin.js

@@ -13,6 +13,7 @@ const util = require("util");
 /** @typedef {import("../../declarations/WebpackOptions").RuleSetRule} RuleSetRule */
 /** @typedef {import("../../declarations/WebpackOptions").RuleSetUse} RuleSetUse */
 /** @typedef {import("../../declarations/WebpackOptions").RuleSetUseItem} RuleSetUseItem */
+/** @typedef {import("../../declarations/WebpackOptions").RuleSetUseFunction} RuleSetUseFunction */
 /** @typedef {import("./RuleSetCompiler")} RuleSetCompiler */
 /** @typedef {import("./RuleSetCompiler").Effect} Effect */
 /** @typedef {import("./RuleSetCompiler").EffectData} EffectData */
@@ -22,6 +23,7 @@ const PLUGIN_NAME = "UseEffectRulePlugin";
 
 class UseEffectRulePlugin {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {RuleSetCompiler} ruleSetCompiler the rule set compiler
 	 * @returns {void}
 	 */
@@ -30,6 +32,7 @@ class UseEffectRulePlugin {
 			PLUGIN_NAME,
 			(path, rule, unhandledProperties, result, references) => {
 				/**
+				 * Processes the provided property.
 				 * @param {keyof RuleSetRule} property property
 				 * @param {string} correctProperty correct property
 				 */
@@ -58,6 +61,7 @@ class UseEffectRulePlugin {
 						(enforce ? `use-${enforce}` : "use");
 
 					/**
+					 * Returns effect.
 					 * @param {string} path options path
 					 * @param {string} defaultIdent default ident when none is provided
 					 * @param {RuleSetUseItem} item user provided use value
@@ -76,9 +80,10 @@ class UseEffectRulePlugin {
 					};
 
 					/**
+					 * Returns effect.
 					 * @param {string} path options path
 					 * @param {string} defaultIdent default ident when none is provided
-					 * @param {Exclude<NonNullable<RuleSetUseItem>, EXPECTED_FUNCTION>} item user provided use value
+					 * @param {Exclude<NonNullable<RuleSetUseItem>, RuleSetUseFunction>} item user provided use value
 					 * @returns {Effect} effect
 					 */
 					const useToEffectRaw = (path, defaultIdent, item) => {
@@ -117,6 +122,7 @@ class UseEffectRulePlugin {
 					};
 
 					/**
+					 * Use to effects without ident.
 					 * @param {string} path options path
 					 * @param {RuleSetUseItem | (Falsy | RuleSetUseItem)[]} items user provided use value
 					 * @returns {Effect[]} effects
@@ -127,7 +133,7 @@ class UseEffectRulePlugin {
 								useToEffectRaw(
 									`${path}[${idx}]`,
 									"[[missing ident]]",
-									/** @type {Exclude<RuleSetUseItem, EXPECTED_FUNCTION>} */
+									/** @type {Exclude<RuleSetUseItem, RuleSetUseFunction>} */
 									(item)
 								)
 							);
@@ -136,13 +142,14 @@ class UseEffectRulePlugin {
 							useToEffectRaw(
 								path,
 								"[[missing ident]]",
-								/** @type {Exclude<RuleSetUseItem, EXPECTED_FUNCTION>} */
+								/** @type {Exclude<RuleSetUseItem, RuleSetUseFunction>} */
 								(items)
 							)
 						];
 					};
 
 					/**
+					 * Returns effects.
 					 * @param {string} path current path
 					 * @param {RuleSetUse} items user provided use value
 					 * @returns {(Effect | ((effectData: EffectData) => Effect[]))[]} effects

package/lib/runtime/AsyncModuleRuntimeModule.js

@@ -21,6 +21,7 @@ class AsyncModuleRuntimeModule extends HelperRuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/AutoPublicPathRuntimeModule.js

@@ -19,6 +19,7 @@ class AutoPublicPathRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/BaseUriRuntimeModule.js

@@ -17,6 +17,7 @@ class BaseUriRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/ChunkNameRuntimeModule.js

@@ -18,6 +18,7 @@ class ChunkNameRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/CompatGetDefaultExportRuntimeModule.js

@@ -16,6 +16,7 @@ class CompatGetDefaultExportRuntimeModule extends HelperRuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/CompatRuntimeModule.js

@@ -19,6 +19,7 @@ class CompatRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {
@@ -72,6 +73,7 @@ class CompatRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Returns true, if the runtime module should get it's own scope.
 	 * @returns {boolean} true, if the runtime module should get it's own scope
 	 */
 	shouldIsolate() {

package/lib/runtime/CreateFakeNamespaceObjectRuntimeModule.js

@@ -16,6 +16,7 @@ class CreateFakeNamespaceObjectRuntimeModule extends HelperRuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/CreateScriptRuntimeModule.js

@@ -16,6 +16,7 @@ class CreateScriptRuntimeModule extends HelperRuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/CreateScriptUrlRuntimeModule.js

@@ -16,6 +16,7 @@ class CreateScriptUrlRuntimeModule extends HelperRuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/DefinePropertyGettersRuntimeModule.js

@@ -16,6 +16,7 @@ class DefinePropertyGettersRuntimeModule extends HelperRuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/EnsureChunkRuntimeModule.js

@@ -22,6 +22,7 @@ class EnsureChunkRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/GetChunkFilenameRuntimeModule.js

@@ -39,6 +39,7 @@ class GetChunkFilenameRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/GetFullHashRuntimeModule.js

@@ -17,6 +17,7 @@ class GetFullHashRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/GetMainFilenameRuntimeModule.js

@@ -26,6 +26,7 @@ class GetMainFilenameRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/GetTrustedTypesPolicyRuntimeModule.js

@@ -22,6 +22,7 @@ class GetTrustedTypesPolicyRuntimeModule extends HelperRuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/GlobalRuntimeModule.js

@@ -14,6 +14,7 @@ class GlobalRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/HasOwnPropertyRuntimeModule.js

@@ -17,6 +17,7 @@ class HasOwnPropertyRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/runtime/HelperRuntimeModule.js

@@ -6,8 +6,13 @@
 
 const RuntimeModule = require("../RuntimeModule");
 
+/**
+ * Base class for runtime modules that only emit helper functions and do not
+ * need special staging or attachment behavior beyond `RuntimeModule`.
+ */
 class HelperRuntimeModule extends RuntimeModule {
 	/**
+	 * Creates a helper runtime module with the provided readable name.
 	 * @param {string} name a readable name
 	 */
 	constructor(name) {

package/lib/runtime/LoadScriptRuntimeModule.js

@@ -54,6 +54,7 @@ class LoadScriptRuntimeModule extends HelperRuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {