@depup/webpack 5.106.0-depup.0 → 5.109.0-depup.0

package/lib/FileSystemInfo.js

@@ -20,19 +20,21 @@ const processAsyncTree = require("./util/processAsyncTree");
 
 /** @typedef {import("enhanced-resolve").ResolveRequest} ResolveRequest */
 /** @typedef {import("enhanced-resolve").ResolveFunctionAsync} ResolveFunctionAsync */
-/** @typedef {import("./WebpackError")} WebpackError */
-/** @typedef {import("./logging/Logger").Logger} Logger */
-/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 /** @typedef {import("../declarations/WebpackOptions").HashFunction} HashFunction */
+/** @typedef {import("./logging/Logger").Logger} Logger */
+/** @typedef {import("./errors/WebpackError")} WebpackError */
 /** @typedef {import("./util/fs").JsonObject} JsonObject */
 /** @typedef {import("./util/fs").IStats} IStats */
 /** @typedef {import("./util/fs").InputFileSystem} InputFileSystem */
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 /**
+ * Defines the processor callback type used by this module.
  * @template T
  * @typedef {import("./util/AsyncQueue").Callback<T>} ProcessorCallback
  */
 /**
+ * Defines the processor type used by this module.
  * @template T, R
  * @typedef {import("./util/AsyncQueue").Processor<T, R>} Processor
  */
@@ -66,12 +68,14 @@ const INVALID = Symbol("invalid");
 /** @typedef {{  }} ExistenceOnlyTimeEntry */
 
 /**
+ * Defines the file system info entry type used by this module.
  * @typedef {object} FileSystemInfoEntry
  * @property {number} safeTime
  * @property {number=} timestamp
  */
 
 /**
+ * Defines the resolved context file system info entry type used by this module.
  * @typedef {object} ResolvedContextFileSystemInfoEntry
  * @property {number} safeTime
  * @property {string=} timestampHash
@@ -80,6 +84,7 @@ const INVALID = Symbol("invalid");
 /** @typedef {Set<string>} Symlinks */
 
 /**
+ * Defines the context file system info entry type used by this module.
  * @typedef {object} ContextFileSystemInfoEntry
  * @property {number} safeTime
  * @property {string=} timestampHash
@@ -88,6 +93,7 @@ const INVALID = Symbol("invalid");
  */
 
 /**
+ * Defines the timestamp and hash type used by this module.
  * @typedef {object} TimestampAndHash
  * @property {number} safeTime
  * @property {number=} timestamp
@@ -95,6 +101,7 @@ const INVALID = Symbol("invalid");
  */
 
 /**
+ * Defines the resolved context timestamp and hash type used by this module.
  * @typedef {object} ResolvedContextTimestampAndHash
  * @property {number} safeTime
  * @property {string=} timestampHash
@@ -102,6 +109,7 @@ const INVALID = Symbol("invalid");
  */
 
 /**
+ * Defines the context timestamp and hash type used by this module.
  * @typedef {object} ContextTimestampAndHash
  * @property {number} safeTime
  * @property {string=} timestampHash
@@ -111,6 +119,7 @@ const INVALID = Symbol("invalid");
  */
 
 /**
+ * Defines the context hash type used by this module.
  * @typedef {object} ContextHash
  * @property {string} hash
  * @property {string=} resolved
@@ -120,6 +129,7 @@ const INVALID = Symbol("invalid");
 /** @typedef {Set<string>} SnapshotContent */
 
 /**
+ * Defines the snapshot optimization entry type used by this module.
  * @typedef {object} SnapshotOptimizationEntry
  * @property {Snapshot} snapshot
  * @property {number} shared
@@ -134,6 +144,7 @@ const INVALID = Symbol("invalid");
 /** @typedef {Set<string>} Missing */
 
 /**
+ * Defines the resolve dependencies type used by this module.
  * @typedef {object} ResolveDependencies
  * @property {Files} files list of files
  * @property {Directories} directories list of directories
@@ -141,6 +152,7 @@ const INVALID = Symbol("invalid");
  */
 
 /**
+ * Defines the resolve build dependencies result type used by this module.
  * @typedef {object} ResolveBuildDependenciesResult
  * @property {Files} files list of files
  * @property {Directories} directories list of directories
@@ -150,6 +162,7 @@ const INVALID = Symbol("invalid");
  */
 
 /**
+ * Defines the snapshot options type used by this module.
  * @typedef {object} SnapshotOptions
  * @property {boolean=} hash should use hash to snapshot
  * @property {boolean=} timestamp should use timestamp to snapshot
@@ -163,6 +176,7 @@ const DONE_ITERATOR_RESULT = new Set().keys().next();
 
 class SnapshotIterator {
 	/**
+	 * Creates an instance of SnapshotIterator.
 	 * @param {() => IteratorResult<string>} next next
 	 */
 	constructor(next) {
@@ -171,20 +185,25 @@ class SnapshotIterator {
 }
 
 /**
+ * Defines the get maps function type used by this module.
  * @template T
  * @typedef {(snapshot: Snapshot) => T[]} GetMapsFunction
  */
 
 /**
+ * Represents SnapshotIterable.
  * @template T
  */
 class SnapshotIterable {
 	/**
+	 * Creates an instance of SnapshotIterable.
 	 * @param {Snapshot} snapshot snapshot
 	 * @param {GetMapsFunction<T>} getMaps get maps function
 	 */
 	constructor(snapshot, getMaps) {
+		/** @type {Snapshot} */
 		this.snapshot = snapshot;
+		/** @type {GetMapsFunction<T>} */
 		this.getMaps = getMaps;
 	}
 
@@ -214,7 +233,7 @@ class SnapshotIterable {
 							const map = maps.pop();
 							if (map !== undefined) {
 								it =
-									/** @type {Set<EXPECTED_ANY> | Map<string, EXPECTED_ANY>} */
+									/** @type {Set<string> | Map<string, EXPECTED_ANY>} */
 									(map).keys();
 								state = 2;
 							} else {
@@ -280,6 +299,7 @@ class SnapshotIterable {
 
 class Snapshot {
 	constructor() {
+		/** @type {number} */
 		this._flags = 0;
 		/** @type {Iterable<string> | undefined} */
 		this._cachedFileIterable = undefined;
@@ -320,6 +340,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Updates start time using the provided value.
 	 * @param {number} value start value
 	 */
 	setStartTime(value) {
@@ -328,6 +349,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets merged start time.
 	 * @param {number | undefined} value value
 	 * @param {Snapshot} snapshot snapshot
 	 */
@@ -357,6 +379,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets file timestamps.
 	 * @param {FileTimestamps} value file timestamps
 	 */
 	setFileTimestamps(value) {
@@ -369,6 +392,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Updates file hashes using the provided value.
 	 * @param {FileHashes} value file hashes
 	 */
 	setFileHashes(value) {
@@ -381,6 +405,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Updates file tshs using the provided value.
 	 * @param {FileTshs} value file tshs
 	 */
 	setFileTshs(value) {
@@ -393,6 +418,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets context timestamps.
 	 * @param {ContextTimestamps} value context timestamps
 	 */
 	setContextTimestamps(value) {
@@ -405,6 +431,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets context hashes.
 	 * @param {ContextHashes} value context hashes
 	 */
 	setContextHashes(value) {
@@ -417,6 +444,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Updates context tshs using the provided value.
 	 * @param {ContextTshs} value context tshs
 	 */
 	setContextTshs(value) {
@@ -429,6 +457,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets missing existence.
 	 * @param {MissingExistence} value context tshs
 	 */
 	setMissingExistence(value) {
@@ -441,6 +470,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets managed item info.
 	 * @param {ManagedItemInfo} value managed item info
 	 */
 	setManagedItemInfo(value) {
@@ -453,6 +483,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets managed files.
 	 * @param {ManagedFiles} value managed files
 	 */
 	setManagedFiles(value) {
@@ -465,6 +496,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets managed contexts.
 	 * @param {ManagedContexts} value managed contexts
 	 */
 	setManagedContexts(value) {
@@ -477,6 +509,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Sets managed missing.
 	 * @param {ManagedMissing} value managed missing
 	 */
 	setManagedMissing(value) {
@@ -489,6 +522,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Updates children using the provided value.
 	 * @param {Children} value children
 	 */
 	setChildren(value) {
@@ -497,6 +531,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Adds the provided child to the snapshot.
 	 * @param {Snapshot} child children
 	 */
 	addChild(child) {
@@ -508,6 +543,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write }) {
@@ -528,6 +564,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize({ read }) {
@@ -548,6 +585,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Creates an iterable from the provided get map.
 	 * @template T
 	 * @param {GetMapsFunction<T>} getMaps first
 	 * @returns {SnapshotIterable<T>} iterable
@@ -557,6 +595,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Gets file iterable.
 	 * @returns {Iterable<string>} iterable
 	 */
 	getFileIterable() {
@@ -572,6 +611,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Gets context iterable.
 	 * @returns {Iterable<string>} iterable
 	 */
 	getContextIterable() {
@@ -587,6 +627,7 @@ class Snapshot {
 	}
 
 	/**
+	 * Gets missing iterable.
 	 * @returns {Iterable<string>} iterable
 	 */
 	getMissingIterable() {
@@ -605,16 +646,19 @@ makeSerializable(Snapshot, "webpack/lib/FileSystemInfo", "Snapshot");
 const MIN_COMMON_SNAPSHOT_SIZE = 3;
 
 /**
+ * Defines the snapshot optimization value type used by this module.
  * @template U, T
  * @typedef {U extends true ? Set<string> : Map<string, T>} SnapshotOptimizationValue
  */
 
 /**
+ * Represents SnapshotOptimization.
  * @template T
  * @template {boolean} [U=false]
  */
 class SnapshotOptimization {
 	/**
+	 * Creates an instance of SnapshotOptimization.
 	 * @param {(snapshot: Snapshot) => boolean} has has value
 	 * @param {(snapshot: Snapshot) => SnapshotOptimizationValue<U, T> | undefined} get get value
 	 * @param {(snapshot: Snapshot, value: SnapshotOptimizationValue<U, T>) => void} set set value
@@ -631,14 +675,19 @@ class SnapshotOptimization {
 		this._has = has;
 		this._get = get;
 		this._set = set;
+		/** @type {boolean} */
 		this._useStartTime = useStartTime;
 		/** @type {U} */
 		this._isSet = isSet;
 		/** @type {Map<string, SnapshotOptimizationEntry>} */
 		this._map = new Map();
+		/** @type {number} */
 		this._statItemsShared = 0;
+		/** @type {number} */
 		this._statItemsUnshared = 0;
+		/** @type {number} */
 		this._statSharedSnapshots = 0;
+		/** @type {number} */
 		this._statReusedSharedSnapshots = 0;
 	}
 
@@ -663,6 +712,7 @@ class SnapshotOptimization {
 	}
 
 	/**
+	 * Processes the provided new snapshot.
 	 * @param {Snapshot} newSnapshot snapshot
 	 * @param {Set<string>} capturedFiles files to snapshot/share
 	 * @returns {void}
@@ -672,6 +722,7 @@ class SnapshotOptimization {
 			return;
 		}
 		/**
+		 * Increase shared and store optimization entry.
 		 * @param {SnapshotOptimizationEntry} entry optimization entry
 		 * @returns {void}
 		 */
@@ -685,6 +736,7 @@ class SnapshotOptimization {
 			storeOptimizationEntry(entry);
 		};
 		/**
+		 * Stores optimization entry.
 		 * @param {SnapshotOptimizationEntry} entry optimization entry
 		 * @returns {void}
 		 */
@@ -885,19 +937,125 @@ class SnapshotOptimization {
 	}
 }
 
+/** @type {Record<string, string>} */
+const ESCAPES = {
+	n: "\n",
+	r: "\r",
+	t: "\t",
+	b: "\b",
+	f: "\f",
+	v: "\v"
+};
+
 /**
- * @param {string} str input
- * @returns {string} result
+ * Cooks a JS string/template literal specifier into its evaluated value,
+ * matching ECMAScript escape semantics (sloppy-mode for string literals).
+ * @param {string} str input including the surrounding quotes
+ * @returns {string | null} result, or null when not a quoted literal
+ * @throws {Error} on a malformed escape sequence, like the JS parser would
  */
 const parseString = (str) => {
-	if (str[0] === "'" || str[0] === "`") {
-		str = `"${str.slice(1, -1).replace(/"/g, '\\"')}"`;
+	const q = str[0];
+
+	if (q !== '"' && q !== "'" && q !== "`") {
+		return null;
 	}
-	return JSON.parse(str);
+
+	const template = q === "`";
+	const inner = str.slice(1, -1);
+	const len = inner.length;
+	let result = "";
+	let i = 0;
+
+	while (i < len) {
+		const ch = inner[i];
+		if (ch !== "\\") {
+			// Template value normalizes raw <CR> and <CRLF> to <LF>
+			if (template && ch === "\r") {
+				result += "\n";
+				i += inner[i + 1] === "\n" ? 2 : 1;
+			} else {
+				result += ch;
+				i++;
+			}
+			continue;
+		}
+
+		i++;
+		if (i >= len) throw new Error("Unterminated escape sequence");
+		const esc = inner[i];
+
+		if (esc === "x") {
+			const hex = inner.slice(i + 1, i + 3);
+			if (!/^[0-9a-fA-F]{2}$/.test(hex)) {
+				throw new Error("Invalid hexadecimal escape sequence");
+			}
+			result += String.fromCharCode(Number.parseInt(hex, 16));
+			i += 3;
+		} else if (esc === "u") {
+			if (inner[i + 1] === "{") {
+				// \u{N...}
+				const closeIdx = inner.indexOf("}", i + 2);
+				const codeStr = closeIdx === -1 ? "" : inner.slice(i + 2, closeIdx);
+				const code = Number.parseInt(codeStr, 16);
+				if (!/^[0-9a-fA-F]+$/.test(codeStr) || code > 0x10ffff) {
+					throw new Error("Invalid Unicode escape sequence");
+				}
+				result += String.fromCodePoint(code);
+				i = closeIdx + 1;
+			} else {
+				// \uNNNN
+				const hex = inner.slice(i + 1, i + 5);
+				if (!/^[0-9a-fA-F]{4}$/.test(hex)) {
+					throw new Error("Invalid Unicode escape sequence");
+				}
+				result += String.fromCharCode(Number.parseInt(hex, 16));
+				i += 5;
+			}
+		} else if (esc === "\r") {
+			// Line continuation: \<CR> or \<CRLF>
+			i += inner[i + 1] === "\n" ? 2 : 1;
+		} else if (esc === "\n" || esc === "\u2028" || esc === "\u2029") {
+			// Line continuation: \<LF>, \<LS>, \<PS>
+			i++;
+		} else if (ESCAPES[esc] !== undefined) {
+			result += ESCAPES[esc];
+			i++;
+		} else if (esc >= "0" && esc <= "7") {
+			// \0 not followed by a digit is NUL, otherwise a legacy octal escape
+			const next = inner[i + 1];
+			if (esc === "0" && !(next >= "0" && next <= "9")) {
+				result += "\0";
+				i++;
+				continue;
+			}
+			if (template) throw new Error("Octal escape not allowed in template");
+			// Up to 3 octal digits, value capped at \377
+			let oct = esc;
+			i++;
+			const max = esc <= "3" ? 3 : 2;
+			while (oct.length < max && inner[i] >= "0" && inner[i] <= "7") {
+				oct += inner[i];
+				i++;
+			}
+			result += String.fromCharCode(Number.parseInt(oct, 8));
+		} else if (esc === "8" || esc === "9") {
+			if (template) throw new Error("\\8 and \\9 not allowed in template");
+			result += esc;
+			i++;
+		} else {
+			// \', \", \\, \`, and any other NonEscapeCharacter — the char itself
+			result += esc;
+			i++;
+		}
+	}
+
+	return result;
 };
 
 /* istanbul ignore next */
 /**
+ * Processes the provided mtime.
  * @param {number} mtime mtime
  */
 const applyMtime = (mtime) => {
@@ -908,6 +1066,7 @@ const applyMtime = (mtime) => {
 };
 
 /**
+ * Merges the provided values into a single result.
  * @template T
  * @template K
  * @param {Map<T, K> | undefined} a source map
@@ -926,6 +1085,7 @@ const mergeMaps = (a, b) => {
 };
 
 /**
+ * Merges the provided values into a single result.
  * @template T
  * @param {Set<T> | undefined} a source map
  * @param {Set<T> | undefined} b joining map
@@ -1027,6 +1187,7 @@ const getManagedItem = (managedPath, path) => {
 };
 
 /**
+ * Gets resolved timestamp.
  * @template {ContextFileSystemInfoEntry | ContextTimestampAndHash} T
  * @param {T | null} entry entry
  * @returns {T["resolved"] | null | undefined} the resolved entry
@@ -1038,6 +1199,7 @@ const getResolvedTimestamp = (entry) => {
 };
 
 /**
+ * Gets resolved hash.
  * @param {ContextHash | null} entry entry
  * @returns {string | null | undefined} the resolved entry
  */
@@ -1048,6 +1210,7 @@ const getResolvedHash = (entry) => {
 };
 
 /**
+ * Adds the provided source to the snapshot optimization.
  * @template T
  * @param {Set<T>} source source
  * @param {Set<T>} target target
@@ -1060,10 +1223,37 @@ const getEsModuleLexer = memoize(() => require("es-module-lexer"));
 
 /** @typedef {Set<string>} LoggedPaths */
 
-/** @typedef {FileSystemInfoEntry | "ignore" | null} FileTimestamp */
-/** @typedef {ContextFileSystemInfoEntry | "ignore" | null} ContextTimestamp */
+/** @typedef {FileSystemInfoEntry | ExistenceOnlyTimeEntry | "ignore" | null} FileTimestamp */
+/** @typedef {ContextFileSystemInfoEntry | ExistenceOnlyTimeEntry | "ignore" | null} ContextTimestamp */
 /** @typedef {ResolvedContextFileSystemInfoEntry | "ignore" | null} ResolvedContextTimestamp */
 
+/**
+ * `watchpack` may report `{}` (existence-only) for files and directories it
+ * is watching but has no time information for. Such entries cannot be used
+ * for snapshot comparison, so cache lookups treat them as "no cached value"
+ * and fall back to a fresh on-disk read.
+ * @param {FileTimestamp | ContextTimestamp | undefined} entry cache entry
+ * @returns {entry is ExistenceOnlyTimeEntry} true if the entry exists but carries no time info
+ */
+const isExistenceOnly = (entry) => {
+	if (entry === undefined || entry === null || entry === "ignore") return false;
+	return (
+		/** @type {Partial<FileSystemInfoEntry> & Partial<ContextFileSystemInfoEntry>} */
+		(entry).safeTime === undefined
+	);
+};
+
+/**
+ * Watchpack directory entries may carry `safeTime` / `timestamp` but never
+ * `timestampHash`; such object caches cannot back snapshot checks or symlink walks.
+ * @param {ContextFileSystemInfoEntry | null | "ignore" | undefined} entry cache entry
+ * @returns {boolean} true when a non-null object entry lacks `timestampHash`
+ */
+const contextCacheEntryLacksTimestampHash = (entry) =>
+	entry !== null &&
+	typeof entry === "object" &&
+	/** @type {ContextFileSystemInfoEntry} */ (entry).timestampHash === undefined;
+
 /** @typedef {(err?: WebpackError | null, result?: boolean) => void} CheckSnapshotValidCallback */
 
 /**
@@ -1071,6 +1261,7 @@ const getEsModuleLexer = memoize(() => require("es-module-lexer"));
  */
 class FileSystemInfo {
 	/**
+	 * Creates an instance of FileSystemInfo.
 	 * @param {InputFileSystem} fs file system
 	 * @param {object} options options
 	 * @param {Iterable<string | RegExp>=} options.unmanagedPaths paths that are not managed by a package manager and the contents are subject to change
@@ -1089,52 +1280,63 @@ class FileSystemInfo {
 			hashFunction = DEFAULTS.HASH_FUNCTION
 		} = {}
 	) {
+		/** @type {InputFileSystem} */
 		this.fs = fs;
 		this.logger = logger;
+		/** @type {number} */
 		this._remainingLogs = logger ? 40 : 0;
 		/** @type {LoggedPaths | undefined} */
 		this._loggedPaths = logger ? new Set() : undefined;
+		/** @type {HashFunction} */
 		this._hashFunction = hashFunction;
 		/** @type {WeakMap<Snapshot, boolean | CheckSnapshotValidCallback[]>} */
 		this._snapshotCache = new WeakMap();
+		/** @type {SnapshotOptimization<FileSystemInfoEntry | null, false>} */
 		this._fileTimestampsOptimization = new SnapshotOptimization(
 			(s) => s.hasFileTimestamps(),
 			(s) => s.fileTimestamps,
 			(s, v) => s.setFileTimestamps(v)
 		);
+		/** @type {SnapshotOptimization<string | null, false>} */
 		this._fileHashesOptimization = new SnapshotOptimization(
 			(s) => s.hasFileHashes(),
 			(s) => s.fileHashes,
 			(s, v) => s.setFileHashes(v),
 			false
 		);
+		/** @type {SnapshotOptimization<string | TimestampAndHash | null, false>} */
 		this._fileTshsOptimization = new SnapshotOptimization(
 			(s) => s.hasFileTshs(),
 			(s) => s.fileTshs,
 			(s, v) => s.setFileTshs(v)
 		);
+		/** @type {SnapshotOptimization<ResolvedContextFileSystemInfoEntry | null, false>} */
 		this._contextTimestampsOptimization = new SnapshotOptimization(
 			(s) => s.hasContextTimestamps(),
 			(s) => s.contextTimestamps,
 			(s, v) => s.setContextTimestamps(v)
 		);
+		/** @type {SnapshotOptimization<string | null, false>} */
 		this._contextHashesOptimization = new SnapshotOptimization(
 			(s) => s.hasContextHashes(),
 			(s) => s.contextHashes,
 			(s, v) => s.setContextHashes(v),
 			false
 		);
+		/** @type {SnapshotOptimization<ResolvedContextTimestampAndHash | null, false>} */
 		this._contextTshsOptimization = new SnapshotOptimization(
 			(s) => s.hasContextTshs(),
 			(s) => s.contextTshs,
 			(s, v) => s.setContextTshs(v)
 		);
+		/** @type {SnapshotOptimization<boolean, false>} */
 		this._missingExistenceOptimization = new SnapshotOptimization(
 			(s) => s.hasMissingExistence(),
 			(s) => s.missingExistence,
 			(s, v) => s.setMissingExistence(v),
 			false
 		);
+		/** @type {SnapshotOptimization<string, false>} */
 		this._managedItemInfoOptimization = new SnapshotOptimization(
 			(s) => s.hasManagedItemInfo(),
 			(s) => s.managedItemInfo,
@@ -1176,6 +1378,9 @@ class FileSystemInfo {
 		this._contextTshs = new Map();
 		/** @type {Map<string, string>} */
 		this._managedItems = new Map();
+		// memoized checkManaged results: 0 = not managed, 1 = immutable, string = managed item
+		/** @type {Map<string, 0 | 1 | string>} */
+		this._pathClassificationCache = new Map();
 		/** @type {AsyncQueue<string, string, FileSystemInfoEntry>} */
 		this.fileTimestampQueue = new AsyncQueue({
 			name: "file timestamp",
@@ -1248,22 +1453,32 @@ class FileSystemInfo {
 			(p) => typeof p !== "string"
 		);
 
+		/** @type {Map<string, number | null> | undefined} */
 		this._cachedDeprecatedFileTimestamps = undefined;
+		/** @type {Map<string, number | null> | undefined} */
 		this._cachedDeprecatedContextTimestamps = undefined;
 
+		/** @type {boolean} */
 		this._warnAboutExperimentalEsmTracking = false;
 
+		/** @type {number} */
 		this._statCreatedSnapshots = 0;
+		/** @type {number} */
 		this._statTestedSnapshotsCached = 0;
+		/** @type {number} */
 		this._statTestedSnapshotsNotCached = 0;
+		/** @type {number} */
 		this._statTestedChildrenCached = 0;
+		/** @type {number} */
 		this._statTestedChildrenNotCached = 0;
+		/** @type {number} */
 		this._statTestedEntries = 0;
 	}
 
 	logStatistics() {
 		const logger = /** @type {Logger} */ (this.logger);
 		/**
+		 * Processes the provided header.
 		 * @param {string} header header
 		 * @param {string | undefined} message message
 		 */
@@ -1351,6 +1566,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Processes the provided path.
 	 * @private
 	 * @param {string} path path
 	 * @param {string} reason reason
@@ -1394,7 +1610,7 @@ class FileSystemInfo {
 		this._contextHashes.clear();
 		this._contextTshs.clear();
 		this._managedItems.clear();
-		this._managedItems.clear();
+		this._pathClassificationCache.clear();
 
 		this._cachedDeprecatedFileTimestamps = undefined;
 		this._cachedDeprecatedContextTimestamps = undefined;
@@ -1408,64 +1624,84 @@ class FileSystemInfo {
 	}
 
 	/**
-	 * @param {ReadonlyMap<string, FileSystemInfoEntry | ExistenceOnlyTimeEntry | "ignore" | null>} map timestamps
+	 * Adds file timestamps.
+	 * @param {ReadonlyMap<string, FileTimestamp>} map timestamps
 	 * @param {boolean=} immutable if 'map' is immutable and FileSystemInfo can keep referencing it
 	 * @returns {void}
 	 */
 	addFileTimestamps(map, immutable) {
-		this._fileTimestamps.addAll(
-			/** @type {ReadonlyMap<string, FileTimestamp>} */
-			(map),
-			immutable
-		);
+		this._fileTimestamps.addAll(map, immutable);
 		this._cachedDeprecatedFileTimestamps = undefined;
 	}
 
 	/**
-	 * @param {ReadonlyMap<string, ContextFileSystemInfoEntry | ExistenceOnlyTimeEntry | "ignore" | null>} map timestamps
+	 * Adds context timestamps.
+	 * @param {ReadonlyMap<string, ContextTimestamp>} map timestamps
 	 * @param {boolean=} immutable if 'map' is immutable and FileSystemInfo can keep referencing it
 	 * @returns {void}
 	 */
 	addContextTimestamps(map, immutable) {
-		this._contextTimestamps.addAll(
-			/** @type {ReadonlyMap<string, ContextTimestamp>} */
-			(map),
-			immutable
-		);
+		this._contextTimestamps.addAll(map, immutable);
 		this._cachedDeprecatedContextTimestamps = undefined;
 	}
 
 	/**
+	 * Gets file timestamp.
 	 * @param {string} path file path
-	 * @param {(err?: WebpackError | null, fileTimestamp?: FileTimestamp) => void} callback callback function
+	 * @param {(err?: WebpackError | null, fileTimestamp?: FileSystemInfoEntry | "ignore" | null) => void} callback callback function
 	 * @returns {void}
 	 */
 	getFileTimestamp(path, callback) {
 		const cache = this._fileTimestamps.get(path);
-		if (cache !== undefined) return callback(null, cache);
+		if (cache !== undefined && !isExistenceOnly(cache)) {
+			return callback(
+				null,
+				/** @type {FileSystemInfoEntry | "ignore" | null} */ (cache)
+			);
+		}
 		this.fileTimestampQueue.add(path, callback);
 	}
 
 	/**
+	 * Gets context timestamp.
 	 * @param {string} path context path
 	 * @param {(err?: WebpackError | null, resolvedContextTimestamp?: ResolvedContextTimestamp) => void} callback callback function
 	 * @returns {void}
 	 */
 	getContextTimestamp(path, callback) {
 		const cache = this._contextTimestamps.get(path);
-		if (cache !== undefined) {
+		if (cache !== undefined && !isExistenceOnly(cache)) {
 			if (cache === "ignore") return callback(null, "ignore");
-			const resolved = getResolvedTimestamp(cache);
+			const fullEntry =
+				/** @type {ContextFileSystemInfoEntry | null} */
+				(cache);
+			const resolved = getResolvedTimestamp(fullEntry);
 			if (resolved !== undefined) return callback(null, resolved);
 			return this._resolveContextTimestamp(
-				/** @type {ResolvedContextFileSystemInfoEntry} */
-				(cache),
+				/** @type {ContextFileSystemInfoEntry} */
+				(fullEntry),
 				callback
 			);
 		}
+		this._readFreshContextTimestamp(path, callback);
+	}
+
+	/**
+	 * Reads a context timestamp directly from disk, bypassing any cached
+	 * entry. Used by `getContextTimestamp` and the snapshot validity
+	 * checks when the cached entry is missing or is an `ExistenceOnlyTimeEntry`
+	 * (`{}`) supplied by watchpack — both cases require a fresh read to
+	 * obtain the `timestampHash`.
+	 * @private
+	 * @param {string} path context path
+	 * @param {(err?: WebpackError | null, resolvedContextTimestamp?: ResolvedContextTimestamp) => void} callback callback function
+	 * @returns {void}
+	 */
+	_readFreshContextTimestamp(path, callback) {
 		this.contextTimestampQueue.add(path, (err, _entry) => {
 			if (err) return callback(err);
-			const entry = /** @type {ContextFileSystemInfoEntry} */ (_entry);
+			const entry = /** @type {ContextFileSystemInfoEntry | null} */ (_entry);
+			if (entry === null) return callback(null, null);
 			const resolved = getResolvedTimestamp(entry);
 			if (resolved !== undefined) return callback(null, resolved);
 			this._resolveContextTimestamp(entry, callback);
@@ -1473,18 +1709,33 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Get unresolved context timestamp. Existence-only cache entries (`{}`)
+	 * are bypassed so the callback always receives a complete entry, "ignore"
+	 * or null.
 	 * @private
 	 * @param {string} path context path
-	 * @param {(err?: WebpackError | null, contextTimestamp?: ContextTimestamp) => void} callback callback function
+	 * @param {(err?: WebpackError | null, contextTimestamp?: ContextFileSystemInfoEntry | "ignore" | null) => void} callback callback function
 	 * @returns {void}
 	 */
 	_getUnresolvedContextTimestamp(path, callback) {
 		const cache = this._contextTimestamps.get(path);
-		if (cache !== undefined) return callback(null, cache);
+		if (
+			cache !== undefined &&
+			!isExistenceOnly(cache) &&
+			!contextCacheEntryLacksTimestampHash(
+				/** @type {ContextFileSystemInfoEntry | null | "ignore"} */ (cache)
+			)
+		) {
+			return callback(
+				null,
+				/** @type {ContextFileSystemInfoEntry | "ignore" | null} */ (cache)
+			);
+		}
 		this.contextTimestampQueue.add(path, callback);
 	}
 
 	/**
+	 * Returns file hash.
 	 * @param {string} path file path
 	 * @param {(err?: WebpackError | null, hash?: string | null) => void} callback callback function
 	 * @returns {void}
@@ -1496,6 +1747,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Returns context hash.
 	 * @param {string} path context path
 	 * @param {(err?: WebpackError | null, contextHash?: string) => void} callback callback function
 	 * @returns {void}
@@ -1521,6 +1773,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Get unresolved context hash.
 	 * @private
 	 * @param {string} path context path
 	 * @param {(err?: WebpackError | null, contextHash?: ContextHash | null) => void} callback callback function
@@ -1533,6 +1786,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Returns context tsh.
 	 * @param {string} path context path
 	 * @param {(err?: WebpackError | null, resolvedContextTimestampAndHash?: ResolvedContextTimestampAndHash | null) => void} callback callback function
 	 * @returns {void}
@@ -1554,6 +1808,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Get unresolved context tsh.
 	 * @private
 	 * @param {string} path context path
 	 * @param {(err?: WebpackError | null, contextTimestampAndHash?: ContextTimestampAndHash | null) => void} callback callback function
@@ -1573,20 +1828,20 @@ class FileSystemInfo {
 		});
 		const resolveCjs = createResolver({
 			extensions: [".js", ".json", ".node"],
-			conditionNames: ["require", "node"],
+			conditionNames: ["require", "module-sync", "node"],
 			exportsFields: ["exports"],
 			fileSystem: this.fs
 		});
 		const resolveCjsAsChild = createResolver({
 			extensions: [".js", ".json", ".node"],
-			conditionNames: ["require", "node"],
+			conditionNames: ["require", "module-sync", "node"],
 			exportsFields: [],
 			fileSystem: this.fs
 		});
 		const resolveEsm = createResolver({
 			extensions: [".js", ".json", ".node"],
 			fullySpecified: true,
-			conditionNames: ["import", "node"],
+			conditionNames: ["import", "module-sync", "node"],
 			exportsFields: ["exports"],
 			fileSystem: this.fs
 		});
@@ -1594,6 +1849,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Resolves build dependencies.
 	 * @param {string} context context directory
 	 * @param {Iterable<string>} deps dependencies
 	 * @param {(err?: Error | null, resolveBuildDependenciesResult?: ResolveBuildDependenciesResult) => void} callback callback function
@@ -1629,6 +1885,7 @@ class FileSystemInfo {
 			missingDependencies: resolveMissing
 		};
 		/**
+		 * Expected to string.
 		 * @param {undefined | boolean | string} expected expected result
 		 * @returns {string} expected result
 		 */
@@ -1637,6 +1894,7 @@ class FileSystemInfo {
 		/** @typedef {{ type: JobType, context: string | undefined, path: string, issuer: Job | undefined, expected: undefined | boolean | string }} Job */
 
 		/**
+		 * Returns result.
 		 * @param {Job} job job
 		 * @returns {string} result
 		 */
@@ -1666,6 +1924,7 @@ class FileSystemInfo {
 			return `unknown ${job.type} ${job.path}`;
 		};
 		/**
+		 * Returns string value.
 		 * @param {Job} job job
 		 * @returns {string} string value
 		 */
@@ -1696,6 +1955,7 @@ class FileSystemInfo {
 			(job, push, callback) => {
 				const { type, context, path, expected } = job;
 				/**
+				 * Resolves directory.
 				 * @param {string} path path
 				 * @returns {void}
 				 */
@@ -1733,6 +1993,7 @@ class FileSystemInfo {
 					);
 				};
 				/**
+				 * Processes the provided path.
 				 * @param {string} path path
 				 * @param {("f" | "c" | "e")=} symbol symbol
 				 * @param {(ResolveFunctionAsync)=} resolve resolve fn
@@ -1975,19 +2236,17 @@ class FileSystemInfo {
 										const added = new Set();
 										for (const imp of imports) {
 											try {
-												/** @type {string} */
-												let dependency;
-												if (imp.d === -1) {
-													// import ... from "..."
-													dependency = parseString(
-														source.slice(imp.s - 1, imp.e + 1)
-													);
-												} else if (imp.d > -1) {
-													// import()
-													const expr = source.slice(imp.s, imp.e).trim();
-													dependency = parseString(expr);
-												} else {
-													// e.g. import.meta
+												// import.meta
+												if (imp.d === -2) {
+													continue;
+												}
+
+												/** @type {string | null} */
+												const dependency =
+													imp.n ||
+													parseString(source.slice(imp.s, imp.e).trim());
+
+												if (!dependency) {
 													continue;
 												}
 
@@ -2128,6 +2387,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Checks resolve results valid.
 	 * @param {ResolveResults} resolveResults results from resolving
 	 * @param {(err?: Error | null, result?: boolean) => void} callback callback with true when resolveResults resolve the same way
 	 * @returns {void}
@@ -2191,6 +2451,7 @@ class FileSystemInfo {
 				}
 			},
 			/**
+			 * Processes the provided err.
 			 * @param {Error | typeof INVALID=} err error or invalid flag
 			 * @returns {void}
 			 */
@@ -2209,6 +2470,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Creates a snapshot.
 	 * @param {number | null | undefined} startTime when processing the files has started
 	 * @param {Iterable<string> | null | undefined} files all files
 	 * @param {Iterable<string> | null | undefined} directories all directories
@@ -2218,30 +2480,29 @@ class FileSystemInfo {
 	 * @returns {void}
 	 */
 	createSnapshot(startTime, files, directories, missing, options, callback) {
-		/** @type {FileTimestamps} */
-		const fileTimestamps = new Map();
-		/** @type {FileHashes} */
-		const fileHashes = new Map();
-		/** @type {FileTshs} */
-		const fileTshs = new Map();
-		/** @type {ContextTimestamps} */
-		const contextTimestamps = new Map();
-		/** @type {ContextHashes} */
-		const contextHashes = new Map();
-		/** @type {ContextTshs} */
-		const contextTshs = new Map();
-		/** @type {MissingExistence} */
-		const missingExistence = new Map();
-		/** @type {ManagedItemInfo} */
-		const managedItemInfo = new Map();
+		// collections are allocated lazily to avoid per-snapshot garbage for unused modes
+		/** @type {FileTimestamps | undefined} */
+		let fileTimestamps;
+		/** @type {FileHashes | undefined} */
+		let fileHashes;
+		/** @type {FileTshs | undefined} */
+		let fileTshs;
+		/** @type {ContextTimestamps | undefined} */
+		let contextTimestamps;
+		/** @type {ContextHashes | undefined} */
+		let contextHashes;
+		/** @type {ContextTshs | undefined} */
+		let contextTshs;
+		/** @type {MissingExistence | undefined} */
+		let missingExistence;
+		/** @type {ManagedItemInfo | undefined} */
+		let managedItemInfo;
 		/** @type {ManagedFiles} */
 		const managedFiles = new Set();
 		/** @type {ManagedContexts} */
 		const managedContexts = new Set();
 		/** @type {ManagedMissing} */
 		const managedMissing = new Set();
-		/** @type {Children} */
-		const children = new Set();
 
 		const snapshot = new Snapshot();
 		if (startTime) snapshot.setStartTime(startTime);
@@ -2255,28 +2516,28 @@ class FileSystemInfo {
 		let jobs = 1;
 		const jobDone = () => {
 			if (--jobs === 0) {
-				if (fileTimestamps.size !== 0) {
+				if (fileTimestamps !== undefined && fileTimestamps.size !== 0) {
 					snapshot.setFileTimestamps(fileTimestamps);
 				}
-				if (fileHashes.size !== 0) {
+				if (fileHashes !== undefined && fileHashes.size !== 0) {
 					snapshot.setFileHashes(fileHashes);
 				}
-				if (fileTshs.size !== 0) {
+				if (fileTshs !== undefined && fileTshs.size !== 0) {
 					snapshot.setFileTshs(fileTshs);
 				}
-				if (contextTimestamps.size !== 0) {
+				if (contextTimestamps !== undefined && contextTimestamps.size !== 0) {
 					snapshot.setContextTimestamps(contextTimestamps);
 				}
-				if (contextHashes.size !== 0) {
+				if (contextHashes !== undefined && contextHashes.size !== 0) {
 					snapshot.setContextHashes(contextHashes);
 				}
-				if (contextTshs.size !== 0) {
+				if (contextTshs !== undefined && contextTshs.size !== 0) {
 					snapshot.setContextTshs(contextTshs);
 				}
-				if (missingExistence.size !== 0) {
+				if (missingExistence !== undefined && missingExistence.size !== 0) {
 					snapshot.setMissingExistence(missingExistence);
 				}
-				if (managedItemInfo.size !== 0) {
+				if (managedItemInfo !== undefined && managedItemInfo.size !== 0) {
 					snapshot.setManagedItemInfo(managedItemInfo);
 				}
 				this._managedFilesOptimization.optimize(snapshot, managedFiles);
@@ -2291,9 +2552,6 @@ class FileSystemInfo {
 				if (managedMissing.size !== 0) {
 					snapshot.setManagedMissing(managedMissing);
 				}
-				if (children.size !== 0) {
-					snapshot.setChildren(children);
-				}
 				this._snapshotCache.set(snapshot, true);
 				this._statCreatedSnapshots++;
 
@@ -2307,26 +2565,44 @@ class FileSystemInfo {
 				callback(null, null);
 			}
 		};
+		const classificationCache = this._pathClassificationCache;
 		/**
+		 * Checks true when managed.
 		 * @param {string} path path
 		 * @param {ManagedFiles} managedSet managed set
 		 * @returns {boolean} true when managed
 		 */
 		const checkManaged = (path, managedSet) => {
+			// classification is a pure function of the path, so it's shared across snapshots
+			const cached = classificationCache.get(path);
+			if (cached !== undefined) {
+				if (cached === 0) return false;
+				if (cached !== 1) managedItems.add(cached);
+				managedSet.add(path);
+				return true;
+			}
 			for (const unmanagedPath of this.unmanagedPathsRegExps) {
-				if (unmanagedPath.test(path)) return false;
+				if (unmanagedPath.test(path)) {
+					classificationCache.set(path, 0);
+					return false;
+				}
 			}
 			for (const unmanagedPath of this.unmanagedPathsWithSlash) {
-				if (path.startsWith(unmanagedPath)) return false;
+				if (path.startsWith(unmanagedPath)) {
+					classificationCache.set(path, 0);
+					return false;
+				}
 			}
 			for (const immutablePath of this.immutablePathsRegExps) {
 				if (immutablePath.test(path)) {
+					classificationCache.set(path, 1);
 					managedSet.add(path);
 					return true;
 				}
 			}
 			for (const immutablePath of this.immutablePathsWithSlash) {
 				if (path.startsWith(immutablePath)) {
+					classificationCache.set(path, 1);
 					managedSet.add(path);
 					return true;
 				}
@@ -2336,6 +2612,7 @@ class FileSystemInfo {
 				if (match) {
 					const managedItem = getManagedItem(match[1], path);
 					if (managedItem) {
+						classificationCache.set(path, managedItem);
 						managedItems.add(managedItem);
 						managedSet.add(path);
 						return true;
@@ -2346,15 +2623,18 @@ class FileSystemInfo {
 				if (path.startsWith(managedPath)) {
 					const managedItem = getManagedItem(managedPath, path);
 					if (managedItem) {
+						classificationCache.set(path, managedItem);
 						managedItems.add(managedItem);
 						managedSet.add(path);
 						return true;
 					}
 				}
 			}
+			classificationCache.set(path, 0);
 			return false;
 		};
 		/**
+		 * Capture non managed.
 		 * @param {Iterable<string>} items items
 		 * @param {Set<string>} managedSet managed set
 		 * @returns {Set<string>} result
@@ -2368,6 +2648,7 @@ class FileSystemInfo {
 			return capturedItems;
 		};
 		/**
+		 * Process captured files.
 		 * @param {ManagedFiles} capturedFiles captured files
 		 */
 		const processCapturedFiles = (capturedFiles) => {
@@ -2375,12 +2656,14 @@ class FileSystemInfo {
 				return;
 			}
 			switch (mode) {
-				case 3:
+				case 3: {
 					this._fileTshsOptimization.optimize(snapshot, capturedFiles);
+					if (fileTshs === undefined) fileTshs = new Map();
+					const fileTshsMap = fileTshs;
 					for (const path of capturedFiles) {
 						const cache = this._fileTshs.get(path);
 						if (cache !== undefined) {
-							fileTshs.set(path, cache);
+							fileTshsMap.set(path, cache);
 						} else {
 							jobs++;
 							this._getFileTimestampAndHash(path, (err, entry) => {
@@ -2392,19 +2675,25 @@ class FileSystemInfo {
 									}
 									jobError();
 								} else {
-									fileTshs.set(path, /** @type {TimestampAndHash} */ (entry));
+									fileTshsMap.set(
+										path,
+										/** @type {TimestampAndHash} */ (entry)
+									);
 									jobDone();
 								}
 							});
 						}
 					}
 					break;
-				case 2:
+				}
+				case 2: {
 					this._fileHashesOptimization.optimize(snapshot, capturedFiles);
+					if (fileHashes === undefined) fileHashes = new Map();
+					const fileHashesMap = fileHashes;
 					for (const path of capturedFiles) {
 						const cache = this._fileHashes.get(path);
 						if (cache !== undefined) {
-							fileHashes.set(path, cache);
+							fileHashesMap.set(path, cache);
 						} else {
 							jobs++;
 							this.fileHashQueue.add(path, (err, entry) => {
@@ -2416,20 +2705,26 @@ class FileSystemInfo {
 									}
 									jobError();
 								} else {
-									fileHashes.set(path, /** @type {string} */ (entry));
+									fileHashesMap.set(path, /** @type {string} */ (entry));
 									jobDone();
 								}
 							});
 						}
 					}
 					break;
-				case 1:
+				}
+				case 1: {
 					this._fileTimestampsOptimization.optimize(snapshot, capturedFiles);
+					if (fileTimestamps === undefined) fileTimestamps = new Map();
+					const fileTimestampsMap = fileTimestamps;
 					for (const path of capturedFiles) {
 						const cache = this._fileTimestamps.get(path);
-						if (cache !== undefined) {
+						if (cache !== undefined && !isExistenceOnly(cache)) {
 							if (cache !== "ignore") {
-								fileTimestamps.set(path, cache);
+								fileTimestampsMap.set(
+									path,
+									/** @type {FileSystemInfoEntry | null} */ (cache)
+								);
 							}
 						} else {
 							jobs++;
@@ -2442,7 +2737,7 @@ class FileSystemInfo {
 									}
 									jobError();
 								} else {
-									fileTimestamps.set(
+									fileTimestampsMap.set(
 										path,
 										/** @type {FileSystemInfoEntry} */
 										(entry)
@@ -2453,12 +2748,14 @@ class FileSystemInfo {
 						}
 					}
 					break;
+				}
 			}
 		};
 		if (files) {
 			processCapturedFiles(captureNonManaged(files, managedFiles));
 		}
 		/**
+		 * Process captured directories.
 		 * @param {ManagedContexts} capturedDirectories captured directories
 		 */
 		const processCapturedDirectories = (capturedDirectories) => {
@@ -2466,8 +2763,10 @@ class FileSystemInfo {
 				return;
 			}
 			switch (mode) {
-				case 3:
+				case 3: {
 					this._contextTshsOptimization.optimize(snapshot, capturedDirectories);
+					if (contextTshs === undefined) contextTshs = new Map();
+					const contextTshsMap = contextTshs;
 					for (const path of capturedDirectories) {
 						const cache = this._contextTshs.get(path);
 						/** @type {ResolvedContextTimestampAndHash | null | undefined} */
@@ -2476,10 +2775,11 @@ class FileSystemInfo {
 							cache !== undefined &&
 							(resolved = getResolvedTimestamp(cache)) !== undefined
 						) {
-							contextTshs.set(path, resolved);
+							contextTshsMap.set(path, resolved);
 						} else {
 							jobs++;
 							/**
+							 * Processes the provided err.
 							 * @param {(WebpackError | null)=} err error
 							 * @param {(ResolvedContextTimestampAndHash | null)=} entry entry
 							 * @returns {void}
@@ -2493,7 +2793,7 @@ class FileSystemInfo {
 									}
 									jobError();
 								} else {
-									contextTshs.set(
+									contextTshsMap.set(
 										path,
 										/** @type {ResolvedContextTimestampAndHash | null} */
 										(entry)
@@ -2509,11 +2809,14 @@ class FileSystemInfo {
 						}
 					}
 					break;
-				case 2:
+				}
+				case 2: {
 					this._contextHashesOptimization.optimize(
 						snapshot,
 						capturedDirectories
 					);
+					if (contextHashes === undefined) contextHashes = new Map();
+					const contextHashesMap = contextHashes;
 					for (const path of capturedDirectories) {
 						const cache = this._contextHashes.get(path);
 						/** @type {undefined | null | string} */
@@ -2522,10 +2825,11 @@ class FileSystemInfo {
 							cache !== undefined &&
 							(resolved = getResolvedHash(cache)) !== undefined
 						) {
-							contextHashes.set(path, resolved);
+							contextHashesMap.set(path, resolved);
 						} else {
 							jobs++;
 							/**
+							 * Processes the provided err.
 							 * @param {(WebpackError | null)=} err err
 							 * @param {string=} entry entry
 							 */
@@ -2538,7 +2842,7 @@ class FileSystemInfo {
 									}
 									jobError();
 								} else {
-									contextHashes.set(path, /** @type {string} */ (entry));
+									contextHashesMap.set(path, /** @type {string} */ (entry));
 									jobDone();
 								}
 							};
@@ -2550,26 +2854,38 @@ class FileSystemInfo {
 						}
 					}
 					break;
-				case 1:
+				}
+				case 1: {
 					this._contextTimestampsOptimization.optimize(
 						snapshot,
 						capturedDirectories
 					);
+					if (contextTimestamps === undefined) contextTimestamps = new Map();
+					const contextTimestampsMap = contextTimestamps;
 					for (const path of capturedDirectories) {
 						const cache = this._contextTimestamps.get(path);
 						if (cache === "ignore") continue;
+						/** @type {ContextFileSystemInfoEntry | null | undefined} */
+						const usableCache =
+							cache === undefined || isExistenceOnly(cache)
+								? undefined
+								: /** @type {ContextFileSystemInfoEntry | null} */ (cache);
+						const cacheLacksHash =
+							contextCacheEntryLacksTimestampHash(usableCache);
 						/** @type {undefined | null | ResolvedContextFileSystemInfoEntry} */
 						let resolved;
 						if (
-							cache !== undefined &&
-							(resolved = getResolvedTimestamp(cache)) !== undefined
+							usableCache !== undefined &&
+							!cacheLacksHash &&
+							(resolved = getResolvedTimestamp(usableCache)) !== undefined
 						) {
-							contextTimestamps.set(path, resolved);
+							contextTimestampsMap.set(path, resolved);
 						} else {
 							jobs++;
 							/**
-							 * @param {(Error | null)=} err error
-							 * @param {FileTimestamp=} entry entry
+							 * Processes the provided err.
+							 * @param {(WebpackError | null)=} err error
+							 * @param {ResolvedContextTimestamp=} entry entry
 							 * @returns {void}
 							 */
 							const callback = (err, entry) => {
@@ -2581,26 +2897,27 @@ class FileSystemInfo {
 									}
 									jobError();
 								} else {
-									contextTimestamps.set(
+									contextTimestampsMap.set(
 										path,
-										/** @type {FileSystemInfoEntry | null} */
+										/** @type {ResolvedContextFileSystemInfoEntry | null} */
 										(entry)
 									);
 									jobDone();
 								}
 							};
-							if (cache !== undefined) {
-								this._resolveContextTimestamp(
-									/** @type {ContextFileSystemInfoEntry} */
-									(cache),
-									callback
-								);
+							if (cacheLacksHash) {
+								this._readFreshContextTimestamp(path, callback);
+							} else if (usableCache !== undefined && usableCache !== null) {
+								this._resolveContextTimestamp(usableCache, callback);
 							} else {
-								this.getContextTimestamp(path, callback);
+								// Force a fresh on-disk read so the snapshot stores a
+								// complete entry (with `timestampHash`).
+								this._readFreshContextTimestamp(path, callback);
 							}
 						}
 					}
 					break;
+				}
 			}
 		};
 		if (directories) {
@@ -2609,6 +2926,7 @@ class FileSystemInfo {
 			);
 		}
 		/**
+		 * Process captured missing.
 		 * @param {ManagedMissing} capturedMissing captured missing
 		 */
 		const processCapturedMissing = (capturedMissing) => {
@@ -2616,11 +2934,13 @@ class FileSystemInfo {
 				return;
 			}
 			this._missingExistenceOptimization.optimize(snapshot, capturedMissing);
+			if (missingExistence === undefined) missingExistence = new Map();
+			const missingExistenceMap = missingExistence;
 			for (const path of capturedMissing) {
 				const cache = this._fileTimestamps.get(path);
-				if (cache !== undefined) {
+				if (cache !== undefined && !isExistenceOnly(cache)) {
 					if (cache !== "ignore") {
-						missingExistence.set(path, Boolean(cache));
+						missingExistenceMap.set(path, Boolean(cache));
 					}
 				} else {
 					jobs++;
@@ -2633,7 +2953,7 @@ class FileSystemInfo {
 							}
 							jobError();
 						} else {
-							missingExistence.set(path, Boolean(entry));
+							missingExistenceMap.set(path, Boolean(entry));
 							jobDone();
 						}
 					});
@@ -2644,6 +2964,10 @@ class FileSystemInfo {
 			processCapturedMissing(captureNonManaged(missing, managedMissing));
 		}
 		this._managedItemInfoOptimization.optimize(snapshot, managedItems);
+		if (managedItems.size !== 0 && managedItemInfo === undefined) {
+			managedItemInfo = new Map();
+		}
+		const managedItemInfoMap = managedItemInfo;
 		for (const path of managedItems) {
 			const cache = this._managedItems.get(path);
 			if (cache !== undefined) {
@@ -2652,7 +2976,7 @@ class FileSystemInfo {
 				} else if (cache === "*nested") {
 					managedMissing.add(join(this.fs, path, "package.json"));
 				}
-				managedItemInfo.set(path, cache);
+				/** @type {ManagedItemInfo} */ (managedItemInfoMap).set(path, cache);
 			} else {
 				jobs++;
 				this.managedItemQueue.add(path, (err, entry) => {
@@ -2669,11 +2993,15 @@ class FileSystemInfo {
 						} else if (cache === "*nested") {
 							managedMissing.add(join(this.fs, path, "package.json"));
 						}
-						managedItemInfo.set(path, entry);
+						/** @type {ManagedItemInfo} */ (managedItemInfoMap).set(
+							path,
+							entry
+						);
 						jobDone();
 					} else {
 						// Fallback to normal snapshotting
 						/**
+						 * Processes the provided set.
 						 * @param {Set<string>} set set
 						 * @param {(set: Set<string>) => void} fn fn
 						 */
@@ -2698,6 +3026,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Merges the provided values into a single result.
 	 * @param {Snapshot} snapshot1 a snapshot
 	 * @param {Snapshot} snapshot2 a snapshot
 	 * @returns {Snapshot} merged snapshot
@@ -2784,6 +3113,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Checks snapshot valid.
 	 * @param {Snapshot} snapshot the snapshot made
 	 * @param {CheckSnapshotValidCallback} callback callback function
 	 * @returns {void}
@@ -2804,6 +3134,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Check snapshot valid no cache.
 	 * @private
 	 * @param {Snapshot} snapshot the snapshot made
 	 * @param {CheckSnapshotValidCallback} callback callback function
@@ -2831,6 +3162,7 @@ class FileSystemInfo {
 			}
 		};
 		/**
+		 * Invalid with error.
 		 * @param {string} path path
 		 * @param {WebpackError} err err
 		 */
@@ -2841,6 +3173,7 @@ class FileSystemInfo {
 			invalid();
 		};
 		/**
+		 * Checks true, if ok.
 		 * @param {string} path file path
 		 * @param {string | null} current current hash
 		 * @param {string | null} snap snapshot hash
@@ -2857,6 +3190,7 @@ class FileSystemInfo {
 			return true;
 		};
 		/**
+		 * Checks true, if ok.
 		 * @param {string} path file path
 		 * @param {boolean} current current entry
 		 * @param {boolean} snap entry from snapshot
@@ -2877,6 +3211,7 @@ class FileSystemInfo {
 			return true;
 		};
 		/**
+		 * Checks true, if ok.
 		 * @param {string} path file path
 		 * @param {FileSystemInfoEntry | null} c current entry
 		 * @param {FileSystemInfoEntry | null} s entry from snapshot
@@ -2919,6 +3254,7 @@ class FileSystemInfo {
 			return true;
 		};
 		/**
+		 * Checks true, if ok.
 		 * @param {string} path file path
 		 * @param {ResolvedContextFileSystemInfoEntry | null} c current entry
 		 * @param {ResolvedContextFileSystemInfoEntry | null} s entry from snapshot
@@ -2965,6 +3301,7 @@ class FileSystemInfo {
 		};
 		if (snapshot.hasChildren()) {
 			/**
+			 * Processes the provided err.
 			 * @param {(WebpackError | null)=} err err
 			 * @param {boolean=} result result
 			 * @returns {void}
@@ -3001,8 +3338,15 @@ class FileSystemInfo {
 			this._statTestedEntries += fileTimestamps.size;
 			for (const [path, ts] of fileTimestamps) {
 				const cache = this._fileTimestamps.get(path);
-				if (cache !== undefined) {
-					if (cache !== "ignore" && !checkFile(path, cache, ts)) {
+				if (cache !== undefined && !isExistenceOnly(cache)) {
+					if (
+						cache !== "ignore" &&
+						!checkFile(
+							path,
+							/** @type {FileSystemInfoEntry | null} */ (cache),
+							ts
+						)
+					) {
 						invalid();
 						return;
 					}
@@ -3026,6 +3370,7 @@ class FileSystemInfo {
 			}
 		}
 		/**
+		 * Process file hash snapshot.
 		 * @param {string} path file path
 		 * @param {string | null} hash hash
 		 */
@@ -3062,8 +3407,16 @@ class FileSystemInfo {
 					processFileHashSnapshot(path, tsh);
 				} else {
 					const cache = this._fileTimestamps.get(path);
-					if (cache !== undefined) {
-						if (cache === "ignore" || !checkFile(path, cache, tsh, false)) {
+					if (cache !== undefined && !isExistenceOnly(cache)) {
+						if (
+							cache === "ignore" ||
+							!checkFile(
+								path,
+								/** @type {FileSystemInfoEntry | null} */ (cache),
+								tsh,
+								false
+							)
+						) {
 							processFileHashSnapshot(path, tsh && tsh.hash);
 						}
 					} else {
@@ -3095,11 +3448,24 @@ class FileSystemInfo {
 			for (const [path, ts] of contextTimestamps) {
 				const cache = this._contextTimestamps.get(path);
 				if (cache === "ignore") continue;
+				// Treat existence-only entries (`{}` from watchpack) as a cache
+				// miss — they carry no time info, so we cannot compare them to
+				// the snapshot.
+				/** @type {ContextFileSystemInfoEntry | null | undefined} */
+				const usableCache =
+					cache === undefined || isExistenceOnly(cache)
+						? undefined
+						: /** @type {ContextFileSystemInfoEntry | null} */ (cache);
+				const cacheLacksHash =
+					contextCacheEntryLacksTimestampHash(usableCache) &&
+					ts !== null &&
+					ts.timestampHash !== undefined;
 				/** @type {undefined | null | ResolvedContextFileSystemInfoEntry} */
 				let resolved;
 				if (
-					cache !== undefined &&
-					(resolved = getResolvedTimestamp(cache)) !== undefined
+					usableCache !== undefined &&
+					!cacheLacksHash &&
+					(resolved = getResolvedTimestamp(usableCache)) !== undefined
 				) {
 					if (!checkContext(path, resolved, ts)) {
 						invalid();
@@ -3108,6 +3474,7 @@ class FileSystemInfo {
 				} else {
 					jobs++;
 					/**
+					 * Processes the provided err.
 					 * @param {(WebpackError | null)=} err error
 					 * @param {ResolvedContextTimestamp=} entry entry
 					 * @returns {void}
@@ -3127,12 +3494,10 @@ class FileSystemInfo {
 							jobDone();
 						}
 					};
-					if (cache !== undefined) {
-						this._resolveContextTimestamp(
-							/** @type {ContextFileSystemInfoEntry} */
-							(cache),
-							callback
-						);
+					if (cacheLacksHash) {
+						this._readFreshContextTimestamp(path, callback);
+					} else if (usableCache !== undefined && usableCache !== null) {
+						this._resolveContextTimestamp(usableCache, callback);
 					} else {
 						this.getContextTimestamp(path, callback);
 					}
@@ -3140,6 +3505,7 @@ class FileSystemInfo {
 			}
 		}
 		/**
+		 * Process context hash snapshot.
 		 * @param {string} path path
 		 * @param {string | null} hash hash
 		 */
@@ -3157,6 +3523,7 @@ class FileSystemInfo {
 			} else {
 				jobs++;
 				/**
+				 * Processes the provided err.
 				 * @param {(WebpackError | null)=} err err
 				 * @param {string=} entry entry
 				 * @returns {void}
@@ -3194,11 +3561,22 @@ class FileSystemInfo {
 				} else {
 					const cache = this._contextTimestamps.get(path);
 					if (cache === "ignore") continue;
+					// See the matching block in `hasContextTimestamps` above.
+					/** @type {ContextFileSystemInfoEntry | null | undefined} */
+					const usableCache =
+						cache === undefined || isExistenceOnly(cache)
+							? undefined
+							: /** @type {ContextFileSystemInfoEntry | null} */ (cache);
+					const cacheLacksHash =
+						contextCacheEntryLacksTimestampHash(usableCache) &&
+						tsh !== null &&
+						tsh.timestampHash !== undefined;
 					/** @type {undefined | null | ResolvedContextFileSystemInfoEntry} */
 					let resolved;
 					if (
-						cache !== undefined &&
-						(resolved = getResolvedTimestamp(cache)) !== undefined
+						usableCache !== undefined &&
+						!cacheLacksHash &&
+						(resolved = getResolvedTimestamp(usableCache)) !== undefined
 					) {
 						if (!checkContext(path, resolved, tsh, false)) {
 							processContextHashSnapshot(path, tsh && tsh.hash);
@@ -3206,6 +3584,7 @@ class FileSystemInfo {
 					} else {
 						jobs++;
 						/**
+						 * Processes the provided err.
 						 * @param {(WebpackError | null)=} err error
 						 * @param {ResolvedContextTimestamp=} entry entry
 						 * @returns {void}
@@ -3215,7 +3594,6 @@ class FileSystemInfo {
 							if (
 								!checkContext(
 									path,
-									// TODO: test with `"ignore"`
 									/** @type {ResolvedContextFileSystemInfoEntry | null} */
 									(entry),
 									tsh,
@@ -3226,12 +3604,10 @@ class FileSystemInfo {
 							}
 							jobDone();
 						};
-						if (cache !== undefined) {
-							this._resolveContextTimestamp(
-								/** @type {ContextFileSystemInfoEntry} */
-								(cache),
-								callback
-							);
+						if (cacheLacksHash) {
+							this._readFreshContextTimestamp(path, callback);
+						} else if (usableCache !== undefined && usableCache !== null) {
+							this._resolveContextTimestamp(usableCache, callback);
 						} else {
 							this.getContextTimestamp(path, callback);
 						}
@@ -3246,7 +3622,7 @@ class FileSystemInfo {
 			this._statTestedEntries += missingExistence.size;
 			for (const [path, existence] of missingExistence) {
 				const cache = this._fileTimestamps.get(path);
-				if (cache !== undefined) {
+				if (cache !== undefined && !isExistenceOnly(cache)) {
 					if (
 						cache !== "ignore" &&
 						!checkExistence(path, Boolean(cache), Boolean(existence))
@@ -3382,12 +3758,14 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Get file timestamp and hash.
 	 * @private
 	 * @param {string} path path
 	 * @param {(err: WebpackError | null, timestampAndHash?: TimestampAndHash | string) => void} callback callback
 	 */
 	_getFileTimestampAndHash(path, callback) {
 		/**
+		 * Continue with hash.
 		 * @param {string} hash hash
 		 * @returns {void}
 		 */
@@ -3434,6 +3812,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Processes the provided object.
 	 * @private
 	 * @template T
 	 * @template ItemType
@@ -3573,8 +3952,13 @@ class FileSystemInfo {
 				fromFile: (file, stat, callback) => {
 					// Prefer the cached value over our new stat to report consistent results
 					const cache = this._fileTimestamps.get(file);
-					if (cache !== undefined) {
-						return callback(null, cache === "ignore" ? null : cache);
+					if (cache !== undefined && !isExistenceOnly(cache)) {
+						return callback(
+							null,
+							cache === "ignore"
+								? null
+								: /** @type {FileSystemInfoEntry | null} */ (cache)
+						);
 					}
 
 					const mtime = Number(stat.mtime);
@@ -3663,6 +4047,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Resolve context timestamp.
 	 * @private
 	 * @param {ContextFileSystemInfoEntry} entry entry
 	 * @param {(err?: WebpackError | null, resolvedContextTimestamp?: ResolvedContextTimestamp) => void} callback callback
@@ -3672,6 +4057,8 @@ class FileSystemInfo {
 		/** @type {string[]} */
 		const hashes = [];
 		let safeTime = 0;
+		// Skip already-visited symlink targets so cyclic pnpm/peer-variant graphs terminate (#21084).
+		const seen = new Set(entry.symlinks);
 		processAsyncTree(
 			/** @type {NonNullable<ContextHash["symlinks"]>} */ (entry.symlinks),
 			10,
@@ -3684,7 +4071,12 @@ class FileSystemInfo {
 							safeTime = Math.max(safeTime, entry.safeTime);
 						}
 						if (entry.symlinks !== undefined) {
-							for (const target of entry.symlinks) push(target);
+							for (const target of entry.symlinks) {
+								if (!seen.has(target)) {
+									seen.add(target);
+									push(target);
+								}
+							}
 						}
 					}
 					callback();
@@ -3744,8 +4136,9 @@ class FileSystemInfo {
 					});
 				},
 				/**
+				 * Returns reduced hash.
 				 * @param {string[]} files files
-				 * @param {(string | ContextHash)[]} fileHashes hashes
+				 * @param {(string | ContextHash | null)[]} fileHashes hashes
 				 * @returns {ContextHash} reduced hash
 				 */
 				reduce: (files, fileHashes) => {
@@ -3755,10 +4148,13 @@ class FileSystemInfo {
 
 					for (const file of files) hash.update(file);
 					for (const entry of fileHashes) {
-						if (typeof entry === "string") {
+						// null for unsupported entry kinds (FIFO, socket); skip like the tsh reduce
+						if (!entry) {
+							continue;
+						} else if (typeof entry === "string") {
 							hash.update(entry);
 						} else {
-							hash.update(entry.hash);
+							if (entry.hash) hash.update(entry.hash);
 							if (entry.symlinks) {
 								if (symlinks === undefined) symlinks = new Set();
 								addAll(entry.symlinks, symlinks);
@@ -3784,6 +4180,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Resolve context hash.
 	 * @private
 	 * @param {ContextHash} entry context hash
 	 * @param {(err: WebpackError | null, contextHash?: string) => void} callback callback
@@ -3792,6 +4189,8 @@ class FileSystemInfo {
 	_resolveContextHash(entry, callback) {
 		/** @type {string[]} */
 		const hashes = [];
+		// Skip already-visited symlink targets so cyclic pnpm/peer-variant graphs terminate (#21084).
+		const seen = new Set(entry.symlinks);
 		processAsyncTree(
 			/** @type {NonNullable<ContextHash["symlinks"]>} */ (entry.symlinks),
 			10,
@@ -3801,7 +4200,12 @@ class FileSystemInfo {
 					if (hash) {
 						hashes.push(hash.hash);
 						if (hash.symlinks !== undefined) {
-							for (const target of hash.symlinks) push(target);
+							for (const target of hash.symlinks) {
+								if (!seen.has(target)) {
+									seen.add(target);
+									push(target);
+								}
+							}
 						}
 					}
 					callback();
@@ -3826,6 +4230,7 @@ class FileSystemInfo {
 	 */
 	_readContextTimestampAndHash(path, callback) {
 		/**
+		 * Processes the provided timestamp.
 		 * @param {ContextTimestamp} timestamp timestamp
 		 * @param {ContextHash} hash hash
 		 */
@@ -3887,6 +4292,7 @@ class FileSystemInfo {
 						});
 					},
 					/**
+					 * Returns tsh.
 					 * @param {string[]} files files
 					 * @param {(Partial<TimestampAndHash> & Partial<ContextTimestampAndHash> | string | null)[]} results results
 					 * @returns {ContextTimestampAndHash} tsh
@@ -3951,6 +4357,7 @@ class FileSystemInfo {
 	}
 
 	/**
+	 * Resolve context tsh.
 	 * @private
 	 * @param {ContextTimestampAndHash} entry entry
 	 * @param {ProcessorCallback<ResolvedContextTimestampAndHash>} callback callback
@@ -3962,6 +4369,8 @@ class FileSystemInfo {
 		/** @type {string[]} */
 		const tsHashes = [];
 		let safeTime = 0;
+		// Skip already-visited symlink targets so cyclic pnpm/peer-variant graphs terminate (#21084).
+		const seen = new Set(entry.symlinks);
 		processAsyncTree(
 			/** @type {NonNullable<ContextHash["symlinks"]>} */ (entry.symlinks),
 			10,
@@ -3975,7 +4384,12 @@ class FileSystemInfo {
 							safeTime = Math.max(safeTime, entry.safeTime);
 						}
 						if (entry.symlinks !== undefined) {
-							for (const target of entry.symlinks) push(target);
+							for (const target of entry.symlinks) {
+								if (!seen.has(target)) {
+									seen.add(target);
+									push(target);
+								}
+							}
 						}
 					}
 					callback();
@@ -4111,7 +4525,13 @@ class FileSystemInfo {
 		/** @type {Map<string, number | null>} */
 		const map = new Map();
 		for (const [path, info] of this._fileTimestamps) {
-			if (info) map.set(path, typeof info === "object" ? info.safeTime : null);
+			if (info) {
+				const safeTime =
+					typeof info === "object"
+						? /** @type {Partial<FileSystemInfoEntry>} */ (info).safeTime
+						: undefined;
+				map.set(path, safeTime === undefined ? null : safeTime);
+			}
 		}
 		return (this._cachedDeprecatedFileTimestamps = map);
 	}
@@ -4123,7 +4543,13 @@ class FileSystemInfo {
 		/** @type {Map<string, number | null>} */
 		const map = new Map();
 		for (const [path, info] of this._contextTimestamps) {
-			if (info) map.set(path, typeof info === "object" ? info.safeTime : null);
+			if (info) {
+				const safeTime =
+					typeof info === "object"
+						? /** @type {Partial<ContextFileSystemInfoEntry>} */ (info).safeTime
+						: undefined;
+				map.set(path, safeTime === undefined ? null : safeTime);
+			}
 		}
 		return (this._cachedDeprecatedContextTimestamps = map);
 	}