@depup/webpack 5.106.1-depup.0 → 5.109.2-depup.0

package/lib/CacheFacade.js

@@ -16,6 +16,7 @@ const mergeEtags = require("./cache/mergeEtags");
 /** @typedef {import("./util/Hash").HashFunction} HashFunction */
 
 /**
+ * Defines the callback cache callback.
  * @template T
  * @callback CallbackCache
  * @param {(Error | null)=} err
@@ -24,6 +25,7 @@ const mergeEtags = require("./cache/mergeEtags");
  */
 
 /**
+ * Defines the callback normal error cache callback.
  * @template T
  * @callback CallbackNormalErrorCache
  * @param {(Error | null)=} err
@@ -33,9 +35,11 @@ const mergeEtags = require("./cache/mergeEtags");
 
 class MultiItemCache {
 	/**
+	 * Creates an instance of MultiItemCache.
 	 * @param {ItemCacheFacade[]} items item caches
 	 */
 	constructor(items) {
+		/** @type {ItemCacheFacade[]} */
 		this._items = items;
 		// @ts-expect-error expected - returns the single ItemCacheFacade when passed an array of length 1
 		// eslint-disable-next-line no-constructor-return
@@ -43,6 +47,7 @@ class MultiItemCache {
 	}
 
 	/**
+	 * Returns value.
 	 * @template T
 	 * @param {CallbackCache<T>} callback signals when the value is retrieved
 	 * @returns {void}
@@ -52,11 +57,13 @@ class MultiItemCache {
 	}
 
 	/**
+	 * Returns promise with the data.
 	 * @template T
 	 * @returns {Promise<T>} promise with the data
 	 */
 	getPromise() {
 		/**
+		 * Returns promise with the data.
 		 * @param {number} i index
 		 * @returns {Promise<T>} promise with the data
 		 */
@@ -69,6 +76,7 @@ class MultiItemCache {
 	}
 
 	/**
+	 * Processes the provided data.
 	 * @template T
 	 * @param {T} data the value to store
 	 * @param {CallbackCache<void>} callback signals when the value is stored
@@ -83,6 +91,7 @@ class MultiItemCache {
 	}
 
 	/**
+	 * Stores the provided data.
 	 * @template T
 	 * @param {T} data the value to store
 	 * @returns {Promise<void>} promise signals when the value is stored
@@ -96,17 +105,22 @@ class MultiItemCache {
 
 class ItemCacheFacade {
 	/**
+	 * Creates an instance of ItemCacheFacade.
 	 * @param {Cache} cache the root cache
 	 * @param {string} name the child cache item name
 	 * @param {Etag | null} etag the etag
 	 */
 	constructor(cache, name, etag) {
+		/** @type {Cache} */
 		this._cache = cache;
+		/** @type {string} */
 		this._name = name;
+		/** @type {Etag | null} */
 		this._etag = etag;
 	}
 
 	/**
+	 * Returns value.
 	 * @template T
 	 * @param {CallbackCache<T>} callback signals when the value is retrieved
 	 * @returns {void}
@@ -116,6 +130,7 @@ class ItemCacheFacade {
 	}
 
 	/**
+	 * Returns promise with the data.
 	 * @template T
 	 * @returns {Promise<T>} promise with the data
 	 */
@@ -132,6 +147,7 @@ class ItemCacheFacade {
 	}
 
 	/**
+	 * Processes the provided data.
 	 * @template T
 	 * @param {T} data the value to store
 	 * @param {CallbackCache<void>} callback signals when the value is stored
@@ -142,6 +158,7 @@ class ItemCacheFacade {
 	}
 
 	/**
+	 * Stores the provided data.
 	 * @template T
 	 * @param {T} data the value to store
 	 * @returns {Promise<void>} promise signals when the value is stored
@@ -159,6 +176,7 @@ class ItemCacheFacade {
 	}
 
 	/**
+	 * Processes the provided computer.
 	 * @template T
 	 * @param {(callback: CallbackNormalErrorCache<T>) => void} computer function to compute the value if not cached
 	 * @param {CallbackNormalErrorCache<T>} callback signals when the value is retrieved
@@ -179,6 +197,7 @@ class ItemCacheFacade {
 	}
 
 	/**
+	 * Returns promise with the data.
 	 * @template T
 	 * @param {() => Promise<T> | T} computer function to compute the value if not cached
 	 * @returns {Promise<T>} promise with the data
@@ -194,17 +213,30 @@ class ItemCacheFacade {
 
 class CacheFacade {
 	/**
+	 * Creates an instance of CacheFacade.
 	 * @param {Cache} cache the root cache
 	 * @param {string} name the child cache name
 	 * @param {HashFunction=} hashFunction the hash function to use
 	 */
 	constructor(cache, name, hashFunction) {
+		/** @type {Cache} */
 		this._cache = cache;
+		/** @type {string} */
 		this._name = name;
+		/** @type {HashFunction | undefined} */
 		this._hashFunction = hashFunction;
 	}
 
 	/**
+	 * Returns whether a cache backend is active.
+	 * @returns {boolean} true, when get or store can have an effect
+	 */
+	isEnabled() {
+		return this._cache.hooks.get.isUsed() || this._cache.hooks.store.isUsed();
+	}
+
+	/**
+	 * Returns child cache.
 	 * @param {string} name the child cache name#
 	 * @returns {CacheFacade} child cache
 	 */
@@ -217,6 +249,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Returns item cache.
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag
 	 * @returns {ItemCacheFacade} item cache
@@ -230,6 +263,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Gets lazy hashed etag.
 	 * @param {HashableObject} obj an hashable object
 	 * @returns {Etag} an etag that is lazy hashed
 	 */
@@ -238,6 +272,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Merges the provided values into a single result.
 	 * @param {Etag} a an etag
 	 * @param {Etag} b another etag
 	 * @returns {Etag} an etag that represents both
@@ -247,6 +282,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Returns value.
 	 * @template T
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag
@@ -258,6 +294,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Returns promise with the data.
 	 * @template T
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag
@@ -276,6 +313,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Processes the provided identifier.
 	 * @template T
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag
@@ -288,6 +326,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Stores the provided identifier.
 	 * @template T
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag
@@ -307,6 +346,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Processes the provided identifier.
 	 * @template T
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag
@@ -329,6 +369,7 @@ class CacheFacade {
 	}
 
 	/**
+	 * Returns promise with the data.
 	 * @template T
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag

package/lib/Chunk.js

@@ -26,7 +26,9 @@ const { mergeRuntime } = require("./util/runtime");
 /** @typedef {import("./ChunkGroup").ChunkGroupOptions} ChunkGroupOptions */
 /** @typedef {import("./Entrypoint").EntryOptions} EntryOptions */
 /** @typedef {import("./Module")} Module */
-/** @typedef {import("./TemplatedPathPlugin").TemplatePath} TemplatePath */
+/** @typedef {import("./Compilation").PathDataChunk} PathDataChunk */
+/** @typedef {import("./TemplatedPathPlugin").TemplatePathFn<PathDataChunk>} ChunkFilenameTemplateFn */
+/** @typedef {string | ChunkFilenameTemplateFn} ChunkFilenameTemplate */
 /** @typedef {import("./util/Hash")} Hash */
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
 
@@ -37,6 +39,7 @@ const { mergeRuntime } = require("./util/runtime");
 const ChunkFilesSet = createArrayToSetDeprecationSet("chunk.files");
 
 /**
+ * Defines the chunk maps type used by this module.
  * @deprecated
  * @typedef {object} ChunkMaps
  * @property {Record<ChunkId, string>} hash
@@ -45,16 +48,19 @@ const ChunkFilesSet = createArrayToSetDeprecationSet("chunk.files");
  */
 
 /**
+ * Defines the chunk module id map type used by this module.
  * @deprecated
  * @typedef {Record<ChunkId, ChunkId[]>} ChunkModuleIdMap
  */
 
 /**
+ * Defines the chunk module hash map type used by this module.
  * @deprecated
  * @typedef {Record<ModuleId, string>} chunkModuleHashMap
  */
 
 /**
+ * Defines the chunk module maps type used by this module.
  * @deprecated
  * @typedef {object} ChunkModuleMaps
  * @property {ChunkModuleIdMap} id
@@ -77,6 +83,7 @@ let debugId = 1000;
  */
 class Chunk {
 	/**
+	 * Creates an instance of Chunk.
 	 * @param {ChunkName=} name of chunk being created, is optional (for subclasses)
 	 * @param {boolean} backCompat enable backward-compatibility
 	 */
@@ -93,9 +100,9 @@ class Chunk {
 		this.idNameHints = new SortableSet();
 		/** @type {boolean} */
 		this.preventIntegration = false;
-		/** @type {TemplatePath | undefined} */
+		/** @type {ChunkFilenameTemplate | undefined} */
 		this.filenameTemplate = undefined;
-		/** @type {TemplatePath | undefined} */
+		/** @type {ChunkFilenameTemplate | undefined} */
 		this.cssFilenameTemplate = undefined;
 		/**
 		 * @private
@@ -114,6 +121,10 @@ class Chunk {
 		this.hash = undefined;
 		/** @type {Record<string, string>} */
 		this.contentHash = Object.create(null);
+		// Full (untruncated) content digests, so `[contenthash:<digest>]` re-encodes
+		// from full entropy. Transient: repopulated by the `contentHash` hook each seal.
+		/** @type {Record<string, string>} */
+		this.contentHashFull = Object.create(null);
 		/** @type {string=} */
 		this.renderedHash = undefined;
 		/** @type {string=} */
@@ -125,6 +136,7 @@ class Chunk {
 	// TODO remove in webpack 6
 	// BACKWARD-COMPAT START
 	/**
+	 * Returns entry module.
 	 * @deprecated
 	 * @returns {Module | undefined} entry module
 	 */
@@ -148,6 +160,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk has an entry module.
 	 * @deprecated
 	 * @returns {boolean} true, if the chunk contains an entry module
 	 */
@@ -162,6 +175,7 @@ class Chunk {
 	}
 
 	/**
+	 * Adds the provided module to the chunk.
 	 * @deprecated
 	 * @param {Module} module the module
 	 * @returns {boolean} true, if the chunk could be added
@@ -178,6 +192,7 @@ class Chunk {
 	}
 
 	/**
+	 * Removes the provided module from the chunk.
 	 * @deprecated
 	 * @param {Module} module the module
 	 * @returns {void}
@@ -191,6 +206,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets the number of modules in this chunk.
 	 * @deprecated
 	 * @returns {number} the number of module which are contained in this chunk
 	 */
@@ -219,6 +235,7 @@ class Chunk {
 	}
 
 	/**
+	 * Compares this chunk with another chunk.
 	 * @deprecated
 	 * @param {Chunk} otherChunk the chunk to compare with
 	 * @returns {-1 | 0 | 1} the comparison result
@@ -233,6 +250,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk contains the module.
 	 * @deprecated
 	 * @param {Module} module the module
 	 * @returns {boolean} true, if the chunk contains the module
@@ -246,6 +264,7 @@ class Chunk {
 	}
 
 	/**
+	 * Returns the modules for this chunk.
 	 * @deprecated
 	 * @returns {Module[]} the modules for this chunk
 	 */
@@ -258,6 +277,7 @@ class Chunk {
 	}
 
 	/**
+	 * Removes this chunk from the chunk graph and chunk groups.
 	 * @deprecated
 	 * @returns {void}
 	 */
@@ -272,6 +292,7 @@ class Chunk {
 	}
 
 	/**
+	 * Moves a module from this chunk to another chunk.
 	 * @deprecated
 	 * @param {Module} module the module
 	 * @param {Chunk} otherChunk the target chunk
@@ -288,6 +309,7 @@ class Chunk {
 	}
 
 	/**
+	 * Integrates another chunk into this chunk when possible.
 	 * @deprecated
 	 * @param {Chunk} otherChunk the other chunk
 	 * @returns {boolean} true, if the specified chunk has been integrated
@@ -307,6 +329,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk can be integrated with another chunk.
 	 * @deprecated
 	 * @param {Chunk} otherChunk the other chunk
 	 * @returns {boolean} true, if chunks could be integrated
@@ -321,6 +344,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk is empty.
 	 * @deprecated
 	 * @returns {boolean} true, if this chunk contains no module
 	 */
@@ -334,6 +358,7 @@ class Chunk {
 	}
 
 	/**
+	 * Returns the total size of all modules in this chunk.
 	 * @deprecated
 	 * @returns {number} total size of all modules in this chunk
 	 */
@@ -347,6 +372,7 @@ class Chunk {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @deprecated
 	 * @param {ChunkSizeOptions} options options object
 	 * @returns {number} total size of this chunk
@@ -361,6 +387,7 @@ class Chunk {
 	}
 
 	/**
+	 * Returns the integrated size with another chunk.
 	 * @deprecated
 	 * @param {Chunk} otherChunk the other chunk
 	 * @param {ChunkSizeOptions} options options object
@@ -376,6 +403,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets chunk module maps.
 	 * @deprecated
 	 * @param {ModuleFilterPredicate} filterFn function used to filter modules
 	 * @returns {ChunkModuleMaps} module map information
@@ -422,6 +450,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk contains a matching module in the graph.
 	 * @deprecated
 	 * @param {ModuleFilterPredicate} filterFn predicate function used to filter modules
 	 * @param {ChunkFilterPredicate=} filterChunkFn predicate function used to filter chunks
@@ -437,6 +466,7 @@ class Chunk {
 	}
 
 	/**
+	 * Returns the chunk map information.
 	 * @deprecated
 	 * @param {boolean} realHash whether the full hash or the rendered hash is to be used
 	 * @returns {ChunkMaps} the chunk map information
@@ -474,6 +504,7 @@ class Chunk {
 	// BACKWARD-COMPAT END
 
 	/**
+	 * Checks whether this chunk has runtime.
 	 * @returns {boolean} whether or not the Chunk will have a runtime
 	 */
 	hasRuntime() {
@@ -489,6 +520,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether it can be initial.
 	 * @returns {boolean} whether or not this chunk can be an initial chunk
 	 */
 	canBeInitial() {
@@ -499,6 +531,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk is only initial.
 	 * @returns {boolean} whether this chunk can only be an initial chunk
 	 */
 	isOnlyInitial() {
@@ -510,6 +543,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets entry options.
 	 * @returns {EntryOptions | undefined} the entry options for this chunk
 	 */
 	getEntryOptions() {
@@ -522,6 +556,7 @@ class Chunk {
 	}
 
 	/**
+	 * Adds the provided chunk group to the chunk.
 	 * @param {ChunkGroup} chunkGroup the chunkGroup the chunk is being added
 	 * @returns {void}
 	 */
@@ -530,6 +565,7 @@ class Chunk {
 	}
 
 	/**
+	 * Removes the provided chunk group from the chunk.
 	 * @param {ChunkGroup} chunkGroup the chunkGroup the chunk is being removed from
 	 * @returns {void}
 	 */
@@ -538,6 +574,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk is in group.
 	 * @param {ChunkGroup} chunkGroup the chunkGroup to check
 	 * @returns {boolean} returns true if chunk has chunkGroup reference and exists in chunkGroup
 	 */
@@ -546,6 +583,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets number of groups.
 	 * @returns {number} the amount of groups that the said chunk is in
 	 */
 	getNumberOfGroups() {
@@ -553,6 +591,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets groups iterable.
 	 * @returns {SortableChunkGroups} the chunkGroups that the said chunk is referenced in
 	 */
 	get groupsIterable() {
@@ -561,6 +600,7 @@ class Chunk {
 	}
 
 	/**
+	 * Disconnects from groups.
 	 * @returns {void}
 	 */
 	disconnectFromGroups() {
@@ -570,6 +610,7 @@ class Chunk {
 	}
 
 	/**
+	 * Processes the provided new chunk.
 	 * @param {Chunk} newChunk the new chunk that will be split out of
 	 * @returns {void}
 	 */
@@ -585,6 +626,7 @@ class Chunk {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash hash (will be modified)
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @returns {void}
@@ -610,6 +652,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets all async chunks.
 	 * @returns {Chunks} a set of all the async chunks
 	 */
 	getAllAsyncChunks() {
@@ -650,6 +693,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets all initial chunks.
 	 * @returns {Chunks} a set of all the initial chunks (including itself)
 	 */
 	getAllInitialChunks() {
@@ -667,6 +711,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets all referenced chunks.
 	 * @returns {Chunks} a set of all the referenced chunks (including itself)
 	 */
 	getAllReferencedChunks() {
@@ -688,6 +733,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets all referenced async entrypoints.
 	 * @returns {Entrypoints} a set of all the referenced entrypoints
 	 */
 	getAllReferencedAsyncEntrypoints() {
@@ -709,6 +755,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk has async chunks.
 	 * @returns {boolean} true, if the chunk references async chunks
 	 */
 	hasAsyncChunks() {
@@ -740,6 +787,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets child ids by orders.
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @param {ChunkFilterPredicate=} filterFn function used to filter chunks
 	 * @returns {Record<string, ChunkId[]>} a record object of names to lists of child ids(?)
@@ -750,26 +798,21 @@ class Chunk {
 		for (const group of this.groupsIterable) {
 			if (group.chunks[group.chunks.length - 1] === this) {
 				for (const childGroup of group.childrenIterable) {
-					for (const key of Object.keys(childGroup.options)) {
-						if (key.endsWith("Order")) {
-							const name = key.slice(0, key.length - "Order".length);
-							let list = lists.get(name);
-							if (list === undefined) {
-								list = [];
-								lists.set(name, list);
-							}
-							list.push({
-								order:
-									/** @type {number} */
-									(
-										childGroup.options[
-											/** @type {keyof ChunkGroupOptions} */
-											(key)
-										]
-									),
-								group: childGroup
-							});
+					const edgeOptions = group.getChildOrderOptions(
+						childGroup,
+						chunkGraph
+					);
+					for (const key of Object.keys(edgeOptions)) {
+						const name = key.slice(0, key.length - "Order".length);
+						let list = lists.get(name);
+						if (list === undefined) {
+							list = [];
+							lists.set(name, list);
 						}
+						list.push({
+							order: edgeOptions[key],
+							group: childGroup
+						});
 					}
 				}
 			}
@@ -798,6 +841,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets children of type in order.
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @param {string} type option name
 	 * @returns {ChunkChildOfTypeInOrder[] | undefined} referenced chunks for a specific type
@@ -807,9 +851,8 @@ class Chunk {
 		const list = [];
 		for (const group of this.groupsIterable) {
 			for (const childGroup of group.childrenIterable) {
-				const order =
-					/** @type {number} */
-					(childGroup.options[/** @type {keyof ChunkGroupOptions} */ (type)]);
+				const edgeOptions = group.getChildOrderOptions(childGroup, chunkGraph);
+				const order = edgeOptions[type];
 				if (order === undefined) continue;
 				list.push({
 					order,
@@ -846,6 +889,7 @@ class Chunk {
 	}
 
 	/**
+	 * Gets child ids by orders map.
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @param {boolean=} includeDirectChildren include direct children (by default only children of async children are included)
 	 * @param {ChunkFilterPredicate=} filterFn function used to filter chunks
@@ -856,6 +900,7 @@ class Chunk {
 		const chunkMaps = Object.create(null);
 
 		/**
+		 * Adds child ids by orders to map.
 		 * @param {Chunk} chunk a chunk
 		 * @returns {void}
 		 */
@@ -891,6 +936,7 @@ class Chunk {
 	}
 
 	/**
+	 * Checks whether this chunk contains the chunk graph.
 	 * @param {ChunkGraph} chunkGraph the chunk graph
 	 * @param {string} type option name
 	 * @param {boolean=} includeDirectChildren include direct children (by default only children of async children are included)