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

package/lib/util/nonNumericOnlyHash.js

@@ -5,14 +5,17 @@
 
 "use strict";
 
+/** @typedef {import("./Hash")} Hash */
+
 const A_CODE = "a".charCodeAt(0);
 
 /**
+ * Returns hash that has at least one non numeric char.
  * @param {string} hash hash
  * @param {number} hashLength hash length
  * @returns {string} returns hash that has at least one non numeric char
  */
-module.exports = (hash, hashLength) => {
+const nonNumericOnlyHash = (hash, hashLength) => {
 	if (hashLength < 1) return "";
 	const slice = hash.slice(0, hashLength);
 	if (/[^\d]/.test(slice)) return slice;
@@ -20,3 +23,30 @@ module.exports = (hash, hashLength) => {
 		A_CODE + (Number.parseInt(hash[0], 10) % 6)
 	)}${slice.slice(1)}`;
 };
+
+/**
+ * Digests a hash and truncates it to a content-hash string (non-numeric first char).
+ * @param {Hash} hash hash
+ * @param {string} hashDigest digest encoding
+ * @param {number} hashDigestLength hash length
+ * @returns {string} content hash string
+ */
+const digestNonNumericOnly = (hash, hashDigest, hashDigestLength) =>
+	nonNumericOnlyHash(hash.digest(hashDigest), hashDigestLength);
+
+/**
+ * Digests a hash, returning both the truncated content-hash string and the full
+ * (untruncated) digest, so `[contenthash:<digest>]` can re-encode from full entropy.
+ * @param {Hash} hash hash
+ * @param {string} hashDigest digest encoding
+ * @param {number} hashDigestLength hash length
+ * @returns {[string, string]} content hash string and full digest
+ */
+const digestNonNumericOnlyWithFull = (hash, hashDigest, hashDigestLength) => {
+	const full = /** @type {string} */ (hash.digest(hashDigest));
+	return [nonNumericOnlyHash(full, hashDigestLength), full];
+};
+
+module.exports = nonNumericOnlyHash;
+module.exports.digestNonNumericOnly = digestNonNumericOnly;
+module.exports.digestNonNumericOnlyWithFull = digestNonNumericOnlyWithFull;

package/lib/util/numberHash.js

@@ -83,8 +83,8 @@ function fnv1a64(str) {
  * @example
  * ```js
  * const numberHash = require("webpack/lib/util/numberHash");
- * numberHash("hello", 1000); // 73
- * numberHash("hello world"); // 72
+ * numberHash("hello", 1000); // 723
+ * numberHash("hello world", 1000); // 159
  * ```
  */
 module.exports = (str, range) => {

package/lib/util/parseJson.js

@@ -0,0 +1,41 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+*/
+
+"use strict";
+
+const JSONParseError = require("../errors/JSONParseError");
+
+/** @typedef {import("../util/fs").JsonValue} JsonValue */
+
+// Inspired by https://github.com/npm/json-parse-even-better-errors
+
+// Remove byte order marker. This catches EF BB BF (the UTF-8 BOM)
+// because the buffer-to-string conversion in `fs.readFileSync()`
+// translates it to FEFF, the UTF-16 BOM.
+/**
+ * @param {string | Buffer} txt text
+ * @returns {string} text without BOM
+ */
+const stripBOM = (txt) => String(txt).replace(/^\uFEFF/, "");
+
+/**
+ * @template [R=JsonValue]
+ * @callback ParseJsonFn
+ * @param {string} raw text
+ * @param {(this: EXPECTED_ANY, key: string, value: EXPECTED_ANY) => EXPECTED_ANY=} reviver reviver
+ * @returns {R} parsed JSON
+ */
+
+/** @type {ParseJsonFn} */
+const parseJson = (raw, reviver) => {
+	const txt = stripBOM(raw);
+
+	try {
+		return JSON.parse(txt, reviver);
+	} catch (err) {
+		throw new JSONParseError(/** @type {Error} */ (err), raw, txt);
+	}
+};
+
+module.exports = parseJson;

package/lib/util/processAsyncTree.js

@@ -6,6 +6,10 @@
 "use strict";
 
 /**
+ * Walks a dynamically expanding async work tree with bounded concurrency.
+ * Each processed item may enqueue more items through `push`, allowing callers
+ * to model breadth-first or depth-first discovery without managing the queue
+ * themselves.
  * @template T
  * @template {Error} E
  * @param {Iterable<T>} items initial items
@@ -22,6 +26,8 @@ const processAsyncTree = (items, concurrency, processor, callback) => {
 	let processScheduled = true;
 
 	/**
+	 * Enqueues a newly discovered item and schedules queue processing when the
+	 * current concurrency budget allows more work to start.
 	 * @param {T} item item
 	 */
 	const push = (item) => {
@@ -33,6 +39,8 @@ const processAsyncTree = (items, concurrency, processor, callback) => {
 	};
 
 	/**
+	 * Handles completion of a single processor call, propagating the first
+	 * error and scheduling more queued work when possible.
 	 * @param {E | null | undefined} err error
 	 */
 	const processorCallback = (err) => {

package/lib/util/property.js

@@ -74,7 +74,8 @@ const propertyName = (prop) => {
 };
 
 /**
- * @param {ArrayLike<string>} properties properties
+ * Returns chain of property accesses.
+ * @param {readonly string[]} properties properties
  * @param {number} start start index
  * @returns {string} chain of property accesses
  */
@@ -82,7 +83,13 @@ const propertyAccess = (properties, start = 0) => {
 	let str = "";
 	for (let i = start; i < properties.length; i++) {
 		const p = properties[i];
-		if (`${Number(p)}` === p) {
+		// Only first chars 0-9, "-", "N", "I" can begin a canonical numeric form
+		// (number, NaN, Infinity); skip the Number() round-trip otherwise.
+		const c = p.charCodeAt(0);
+		if (
+			((c >= 48 && c <= 57) || c === 45 || c === 78 || c === 73) &&
+			`${Number(p)}` === p
+		) {
 			str += `[${p}]`;
 		} else if (SAFE_IDENTIFIER.test(p) && !RESERVED_IDENTIFIER.has(p)) {
 			str += `.${p}`;

package/lib/util/publicPathPlaceholder.js

@@ -0,0 +1,64 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+*/
+
+"use strict";
+
+// Placeholders embedded into asset `url()` / HTML chunk URLs at code-generation
+// time, when the final public path can't be resolved yet, then substituted
+// later once the information is available:
+// - PUBLIC_PATH_AUTO    — stands in for `output.publicPath: "auto"`; replaced
+//   with the per-output-file undo path (relative `../` segments back to the
+//   output root) during chunk/asset render.
+// - PUBLIC_PATH_FULL_HASH — stands in for `[fullhash]`/`[hash]` in a public
+//   path before the compilation hash exists. Form: `<prefix><len>__`, where
+//   `<len>` is the requested hash length (`0` means the full hash). Replaced
+//   with the real hash (build-time, e.g. CSS `.css` files) or a runtime
+//   `__webpack_require__.h()` expression (inlined CSS in JS).
+const PUBLIC_PATH_AUTO = "__WEBPACK_CSS_PUBLIC_PATH_AUTO__";
+const PUBLIC_PATH_FULL_HASH = "__WEBPACK_CSS_PUBLIC_PATH_FULL_HASH_";
+
+/**
+ * Scan `content` for `PUBLIC_PATH_FULL_HASH` placeholders and invoke `onMatch`
+ * once per well-formed occurrence. The placeholder spans the half-open range
+ * `[start, end)` and encodes the requested hash length (`0` means the full
+ * hash). Callers substitute the build-time hash or a runtime expression
+ * depending on context.
+ * @param {string} content text to scan
+ * @param {(start: number, end: number, length: number) => void} onMatch placeholder callback
+ * @returns {void}
+ */
+const walkFullHashPlaceholders = (content, onMatch) => {
+	const prefix = PUBLIC_PATH_FULL_HASH;
+	const prefixLen = prefix.length;
+	const len = content.length;
+	let idx = content.indexOf(prefix);
+	while (idx !== -1) {
+		let digitEnd = idx + prefixLen;
+		while (digitEnd < len) {
+			const cc = content.charCodeAt(digitEnd);
+			if (cc < 48 || cc > 57) break;
+			digitEnd++;
+		}
+		// Well-formed placeholder: at least one digit followed by `__`.
+		if (
+			digitEnd > idx + prefixLen &&
+			digitEnd + 1 < len &&
+			content.charCodeAt(digitEnd) === 95 &&
+			content.charCodeAt(digitEnd + 1) === 95
+		) {
+			const length = Number.parseInt(
+				content.slice(idx + prefixLen, digitEnd),
+				10
+			);
+			onMatch(idx, digitEnd + 2, length);
+			idx = content.indexOf(prefix, digitEnd + 2);
+		} else {
+			idx = content.indexOf(prefix, idx + prefixLen);
+		}
+	}
+};
+
+module.exports.PUBLIC_PATH_AUTO = PUBLIC_PATH_AUTO;
+module.exports.PUBLIC_PATH_FULL_HASH = PUBLIC_PATH_FULL_HASH;
+module.exports.walkFullHashPlaceholders = walkFullHashPlaceholders;

package/lib/util/registerExternalSerializer.js

@@ -33,6 +33,7 @@ register(
 	"webpack-sources/CachedSource",
 	new (class CachedSourceSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {CachedSource} source the cached source to be serialized
 		 * @param {ObjectSerializerContext} context context
 		 * @returns {void}
@@ -47,6 +48,7 @@ register(
 		}
 
 		/**
+		 * Restores this instance from the provided deserializer context.
 		 * @param {ObjectDeserializerContext} context context
 		 * @returns {CachedSource} cached source
 		 */
@@ -64,6 +66,7 @@ register(
 	"webpack-sources/RawSource",
 	new (class RawSourceSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {RawSource} source the raw source to be serialized
 		 * @param {ObjectSerializerContext} context context
 		 * @returns {void}
@@ -74,6 +77,7 @@ register(
 		}
 
 		/**
+		 * Restores this instance from the provided deserializer context.
 		 * @param {ObjectDeserializerContext} context context
 		 * @returns {RawSource} raw source
 		 */
@@ -91,6 +95,7 @@ register(
 	"webpack-sources/ConcatSource",
 	new (class ConcatSourceSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {ConcatSource} source the concat source to be serialized
 		 * @param {ObjectSerializerContext} context context
 		 * @returns {void}
@@ -100,6 +105,7 @@ register(
 		}
 
 		/**
+		 * Restores this instance from the provided deserializer context.
 		 * @param {ObjectDeserializerContext} context context
 		 * @returns {ConcatSource} concat source
 		 */
@@ -117,6 +123,7 @@ register(
 	"webpack-sources/PrefixSource",
 	new (class PrefixSourceSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {PrefixSource} source the prefix source to be serialized
 		 * @param {ObjectSerializerContext} context context
 		 * @returns {void}
@@ -127,6 +134,7 @@ register(
 		}
 
 		/**
+		 * Restores this instance from the provided deserializer context.
 		 * @param {ObjectDeserializerContext} context context
 		 * @returns {PrefixSource} prefix source
 		 */
@@ -142,6 +150,7 @@ register(
 	"webpack-sources/ReplaceSource",
 	new (class ReplaceSourceSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {ReplaceSource} source the replace source to be serialized
 		 * @param {ObjectSerializerContext} context context
 		 * @returns {void}
@@ -162,6 +171,7 @@ register(
 		}
 
 		/**
+		 * Restores this instance from the provided deserializer context.
 		 * @param {ObjectDeserializerContext} context context
 		 * @returns {ReplaceSource} replace source
 		 */
@@ -193,6 +203,7 @@ register(
 	"webpack-sources/OriginalSource",
 	new (class OriginalSourceSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {OriginalSource} source the original source to be serialized
 		 * @param {ObjectSerializerContext} context context
 		 * @returns {void}
@@ -203,6 +214,7 @@ register(
 		}
 
 		/**
+		 * Restores this instance from the provided deserializer context.
 		 * @param {ObjectDeserializerContext} context context
 		 * @returns {OriginalSource} original source
 		 */
@@ -220,8 +232,9 @@ register(
 	"acorn/SourceLocation",
 	new (class SourceLocationSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {SourceLocation} loc the location to be serialized
-		 * @param {ObjectSerializerContext} context context
+		 * @param {import("../serialization/ObjectMiddleware").ObjectSerializerContext<number[]>} context context
 		 * @returns {void}
 		 */
 		serialize(loc, { write }) {
@@ -232,7 +245,8 @@ register(
 		}
 
 		/**
-		 * @param {ObjectDeserializerContext} context context
+		 * Restores this instance from the provided deserializer context.
+		 * @param {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<number[]>} context context
 		 * @returns {RealDependencyLocation} location
 		 */
 		deserialize({ read }) {
@@ -256,8 +270,9 @@ register(
 	"acorn/Position",
 	new (class PositionSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {Position} pos the position to be serialized
-		 * @param {ObjectSerializerContext} context context
+		 * @param {import("../serialization/ObjectMiddleware").ObjectSerializerContext<number[]>} context context
 		 * @returns {void}
 		 */
 		serialize(pos, { write }) {
@@ -266,7 +281,8 @@ register(
 		}
 
 		/**
-		 * @param {ObjectDeserializerContext} context context
+		 * Restores this instance from the provided deserializer context.
+		 * @param {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<number[]>} context context
 		 * @returns {SourcePosition} position
 		 */
 		deserialize({ read }) {
@@ -284,6 +300,7 @@ register(
 	"webpack-sources/SourceMapSource",
 	new (class SourceMapSourceSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {SourceMapSource} source the source map source to be serialized
 		 * @param {ObjectSerializerContext} context context
 		 * @returns {void}
@@ -293,6 +310,7 @@ register(
 		}
 
 		/**
+		 * Restores this instance from the provided deserializer context.
 		 * @param {ObjectDeserializerContext} context context
 		 * @returns {SourceMapSource} source source map source
 		 */
@@ -309,6 +327,7 @@ register(
 	"schema-utils/ValidationError",
 	new (class ValidationErrorSerializer {
 		/**
+		 * Serializes this instance into the provided serializer context.
 		 * @param {ValidationError} error the source map source to be serialized
 		 * @param {ObjectSerializerContext} context context
 		 * @returns {void}
@@ -324,6 +343,7 @@ register(
 		}
 
 		/**
+		 * Restores this instance from the provided deserializer context.
 		 * @param {ObjectDeserializerContext} context context
 		 * @returns {ValidationError} error
 		 */

package/lib/util/removeBOM.js

@@ -6,6 +6,7 @@
 "use strict";
 
 /**
+ * Returns result without BOM.
  * @param {string | Buffer} strOrBuffer string or buffer
  * @returns {string | Buffer} result without BOM
  */

package/lib/util/runtime.js

@@ -15,6 +15,7 @@ const SortableSet = require("./SortableSet");
 /** @typedef {RuntimeSpec | boolean} RuntimeCondition */
 
 /**
+ * Gets entry runtime.
  * @param {Compilation} compilation the compilation
  * @param {string} name name of the entry
  * @param {EntryOptions=} options optionally already received entry options
@@ -54,6 +55,7 @@ const getEntryRuntime = (compilation, name, options) => {
 };
 
 /**
+ * Processes the provided runtime.
  * @param {RuntimeSpec} runtime runtime
  * @param {(runtime: string | undefined) => void} fn functor
  * @param {boolean} deterministicOrder enforce a deterministic order
@@ -73,6 +75,7 @@ const forEachRuntime = (runtime, fn, deterministicOrder = false) => {
 };
 
 /**
+ * Returns runtime key.
  * @template T
  * @param {Exclude<RuntimeSpec, undefined | string>} set set
  * @returns {string} runtime key
@@ -83,6 +86,7 @@ const getRuntimesKey = (set) => {
 };
 
 /**
+ * Returns key of runtimes.
  * @param {RuntimeSpec} runtime runtime(s)
  * @returns {string} key of runtimes
  */
@@ -93,6 +97,7 @@ const getRuntimeKey = (runtime) => {
 };
 
 /**
+ * Returns runtime(s).
  * @param {string} key key of runtimes
  * @returns {RuntimeSpec} runtime(s)
  */
@@ -104,6 +109,7 @@ const keyToRuntime = (key) => {
 };
 
 /**
+ * Gets runtimes string.
  * @template T
  * @param {Exclude<RuntimeSpec, undefined | string>} set set
  * @returns {string} runtime string
@@ -114,6 +120,7 @@ const getRuntimesString = (set) => {
 };
 
 /**
+ * Returns readable version.
  * @param {RuntimeSpec} runtime runtime(s)
  * @returns {string} readable version
  */
@@ -124,6 +131,7 @@ const runtimeToString = (runtime) => {
 };
 
 /**
+ * Runtime condition to string.
  * @param {RuntimeCondition} runtimeCondition runtime condition
  * @returns {string} readable version
  */
@@ -134,6 +142,7 @@ const runtimeConditionToString = (runtimeCondition) => {
 };
 
 /**
+ * Returns true, when they are equal.
  * @param {RuntimeSpec} a first
  * @param {RuntimeSpec} b second
  * @returns {boolean} true, when they are equal
@@ -164,6 +173,7 @@ const runtimeEqual = (a, b) => {
 };
 
 /**
+ * Compares the provided values and returns their ordering.
  * @param {RuntimeSpec} a first
  * @param {RuntimeSpec} b second
  * @returns {-1 | 0 | 1} compare
@@ -184,6 +194,7 @@ const compareRuntime = (a, b) => {
 };
 
 /**
+ * Merges the provided values into a single result.
  * @param {RuntimeSpec} a first
  * @param {RuntimeSpec} b second
  * @returns {RuntimeSpec} merged
@@ -225,6 +236,7 @@ const mergeRuntime = (a, b) => {
 };
 
 /**
+ * Merges runtime condition.
  * @param {RuntimeCondition} a first
  * @param {RuntimeCondition} b second
  * @param {RuntimeSpec} runtime full runtime
@@ -246,6 +258,7 @@ const mergeRuntimeCondition = (a, b, runtime) => {
 };
 
 /**
+ * Merges runtime condition non false.
  * @param {RuntimeSpec | true} a first
  * @param {RuntimeSpec | true} b second
  * @param {RuntimeSpec} runtime full runtime
@@ -265,6 +278,7 @@ const mergeRuntimeConditionNonFalse = (a, b, runtime) => {
 };
 
 /**
+ * Merges runtime owned.
  * @param {RuntimeSpec} a first (may be modified)
  * @param {RuntimeSpec} b second
  * @returns {RuntimeSpec} merged
@@ -302,6 +316,7 @@ const mergeRuntimeOwned = (a, b) => {
 };
 
 /**
+ * Returns merged.
  * @param {RuntimeSpec} a first
  * @param {RuntimeSpec} b second
  * @returns {RuntimeSpec} merged
@@ -339,6 +354,7 @@ const intersectRuntime = (a, b) => {
 };
 
 /**
+ * Returns result.
  * @param {RuntimeSpec} a first
  * @param {RuntimeSpec} b second
  * @returns {RuntimeSpec} result
@@ -384,6 +400,7 @@ const subtractRuntime = (a, b) => {
 };
 
 /**
+ * Subtract runtime condition.
  * @param {RuntimeCondition} a first
  * @param {RuntimeCondition} b second
  * @param {RuntimeSpec} runtime runtime
@@ -398,6 +415,7 @@ const subtractRuntimeCondition = (a, b, runtime) => {
 };
 
 /**
+ * Returns true/false if filter is constant for all runtimes, otherwise runtimes that are active.
  * @param {RuntimeSpec} runtime runtime
  * @param {(runtime?: RuntimeSpec) => boolean} filter filter function
  * @returns {boolean | RuntimeSpec} true/false if filter is constant for all runtimes, otherwise runtimes that are active
@@ -424,16 +442,19 @@ const filterRuntime = (runtime, filter) => {
 };
 
 /**
+ * Defines the runtime spec map inner map type used by this module.
  * @template T
  * @typedef {Map<string, T>} RuntimeSpecMapInnerMap
  */
 
 /**
+ * Represents RuntimeSpecMap.
  * @template T
  * @template [R=T]
  */
 class RuntimeSpecMap {
 	/**
+	 * Creates an instance of RuntimeSpecMap.
 	 * @param {RuntimeSpecMap<T, R>=} clone copy form this
 	 */
 	constructor(clone) {
@@ -448,6 +469,7 @@ class RuntimeSpecMap {
 	}
 
 	/**
+	 * Returns value.
 	 * @param {RuntimeSpec} runtime the runtimes
 	 * @returns {R | undefined} value
 	 */
@@ -467,6 +489,7 @@ class RuntimeSpecMap {
 	}
 
 	/**
+	 * Returns true, when the runtime is stored.
 	 * @param {RuntimeSpec} runtime the runtimes
 	 * @returns {boolean} true, when the runtime is stored
 	 */
@@ -484,6 +507,7 @@ class RuntimeSpecMap {
 	}
 
 	/**
+	 * Updates default using the provided runtime.
 	 * @param {RuntimeSpec} runtime the runtimes
 	 * @param {R} value the value
 	 */
@@ -515,6 +539,7 @@ class RuntimeSpecMap {
 	}
 
 	/**
+	 * Returns the new value.
 	 * @param {RuntimeSpec} runtime the runtimes
 	 * @param {() => R} computer function to compute the value
 	 * @returns {R} the new value
@@ -557,6 +582,7 @@ class RuntimeSpecMap {
 	}
 
 	/**
+	 * Processes the provided runtime.
 	 * @param {RuntimeSpec} runtime the runtimes
 	 */
 	delete(runtime) {
@@ -577,6 +603,7 @@ class RuntimeSpecMap {
 	}
 
 	/**
+	 * Processes the provided runtime.
 	 * @param {RuntimeSpec} runtime the runtimes
 	 * @param {(value: R | undefined) => R} fn function to update the value
 	 */
@@ -634,6 +661,7 @@ class RuntimeSpecMap {
 	}
 
 	/**
+	 * Returns values.
 	 * @returns {IterableIterator<R>} values
 	 */
 	values() {
@@ -658,6 +686,7 @@ class RuntimeSpecMap {
 
 class RuntimeSpecSet {
 	/**
+	 * Creates an instance of RuntimeSpecSet.
 	 * @param {Iterable<RuntimeSpec>=} iterable iterable
 	 */
 	constructor(iterable) {
@@ -671,6 +700,7 @@ class RuntimeSpecSet {
 	}
 
 	/**
+	 * Processes the provided runtime.
 	 * @param {RuntimeSpec} runtime runtime
 	 */
 	add(runtime) {
@@ -678,6 +708,7 @@ class RuntimeSpecSet {
 	}
 
 	/**
+	 * Returns true, when the runtime exists.
 	 * @param {RuntimeSpec} runtime runtime
 	 * @returns {boolean} true, when the runtime exists
 	 */
@@ -686,6 +717,7 @@ class RuntimeSpecSet {
 	}
 
 	/**
+	 * Returns iterable iterator.
 	 * @returns {IterableIterator<RuntimeSpec>} iterable iterator
 	 */
 	[Symbol.iterator]() {