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

package/lib/util/findGraphRoots.js

@@ -11,18 +11,22 @@ const DONE_MARKER = 2;
 const CANDIDATE_MARKER = 3;
 
 /**
+ * Defines the nodes type used by this module.
  * @template T
  * @typedef {Set<Node<T>>} Nodes
  */
 
 /**
+ * Represents the node runtime component.
  * @template T
  */
 class Node {
 	/**
+	 * Creates an instance of Node.
 	 * @param {T} item the value of the node
 	 */
 	constructor(item) {
+		/** @type {T} */
 		this.item = item;
 		/** @type {Nodes<T>} */
 		this.dependencies = new Set();
@@ -43,11 +47,13 @@ class SCC {
 	constructor() {
 		/** @type {Nodes<T>} */
 		this.nodes = new Set();
+		/** @type {number} */
 		this.marker = NO_MARKER;
 	}
 }
 
 /**
+ * Defines the stack entry type used by this module.
  * @template T
  * @typedef {object} StackEntry
  * @property {Node<T>} node
@@ -55,6 +61,7 @@ class SCC {
  */
 
 /**
+ * Returns graph roots of the items.
  * @template T
  * @param {Iterable<T>} items list of items
  * @param {(item: T) => Iterable<T>} getDependencies function to get dependencies of an item (items that are not in list are ignored)

package/lib/{formatLocation.js → util/formatLocation.js}

@@ -5,10 +5,11 @@
 
 "use strict";
 
-/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
-/** @typedef {import("./Dependency").SourcePosition} SourcePosition */
+/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("../Dependency").SourcePosition} SourcePosition */
 
 /**
+ * Returns formatted position.
  * @param {SourcePosition} pos position
  * @returns {string} formatted position
  */
@@ -24,6 +25,7 @@ const formatPosition = (pos) => {
 };
 
 /**
+ * Returns formatted location.
  * @param {DependencyLocation} loc location
  * @returns {string} formatted location
  */

package/lib/{SizeFormatHelpers.js → util/formatSize.js}

@@ -6,10 +6,11 @@
 "use strict";
 
 /**
+ * Returns the formatted size.
  * @param {number=} size the size in bytes
  * @returns {string} the formatted size
  */
-module.exports.formatSize = (size) => {
+const formatSize = (size) => {
 	if (typeof size !== "number" || Number.isNaN(size) === true) {
 		return "unknown size";
 	}
@@ -18,8 +19,14 @@ module.exports.formatSize = (size) => {
 		return "0 bytes";
 	}
 
-	const abbreviations = ["bytes", "KiB", "MiB", "GiB"];
-	const index = Math.floor(Math.log(size) / Math.log(1024));
+	const abbreviations = ["bytes", "KiB", "MiB", "GiB", "TiB", "PiB"];
+	// clamp so sizes beyond the largest unit don't index past the table
+	const index = Math.min(
+		Math.floor(Math.log(size) / Math.log(1024)),
+		abbreviations.length - 1
+	);
 
 	return `${Number((size / 1024 ** index).toPrecision(3))} ${abbreviations[index]}`;
 };
+
+module.exports = formatSize;

package/lib/util/fs.js

@@ -6,6 +6,7 @@
 "use strict";
 
 const path = require("path");
+const { ABSOLUTE_PATH_REGEXP } = require("./identifier");
 
 /** @typedef {import("../../declarations/WebpackOptions").WatchOptions} WatchOptions */
 /** @typedef {import("watchpack").Entry} Entry */
@@ -13,6 +14,7 @@ const path = require("path");
 /** @typedef {import("watchpack").ExistenceOnlyTimeEntry} ExistenceOnlyTimeEntry */
 
 /**
+ * Defines the i stats base type used by this module.
  * @template T
  * @typedef {object} IStatsBase
  * @property {() => boolean} isFile
@@ -43,14 +45,17 @@ const path = require("path");
  */
 
 /**
+ * Defines the i stats type used by this module.
  * @typedef {IStatsBase<number>} IStats
  */
 
 /**
+ * Defines the i big int stats type used by this module.
  * @typedef {IStatsBase<bigint> & { atimeNs: bigint, mtimeNs: bigint, ctimeNs: bigint, birthtimeNs: bigint }} IBigIntStats
  */
 
 /**
+ * Defines the dirent type used by this module.
  * @template {string | Buffer} [T=string]
  * @typedef {object} Dirent
  * @property {() => boolean} isFile true when is file, otherwise false
@@ -91,6 +96,7 @@ const path = require("path");
 /** @typedef {Set<string>} Removals */
 
 /**
+ * Defines the watcher info type used by this module.
  * @typedef {object} WatcherInfo
  * @property {Changes | null} changes get current aggregated changes that have not yet send to callback
  * @property {Removals | null} removals get current aggregated removals that have not yet send to callback
@@ -100,6 +106,7 @@ const path = require("path");
 
 // TODO webpack 6 deprecate missing getInfo
 /**
+ * Defines the watcher type used by this module.
  * @typedef {object} Watcher
  * @property {() => void} close closes the watcher and all underlying file watchers
  * @property {() => void} pause closes the watcher, but keeps underlying file watchers alive until the next watch call
@@ -111,6 +118,7 @@ const path = require("path");
  */
 
 /**
+ * Defines the watch method callback.
  * @callback WatchMethod
  * @param {Iterable<string>} files watched files
  * @param {Iterable<string>} directories watched directories
@@ -125,19 +133,23 @@ const path = require("path");
 // TODO webpack 6 make optional methods required and avoid using non standard methods like `join`, `relative`, `dirname`, move IntermediateFileSystemExtras methods to InputFilesystem or OutputFilesystem
 
 /**
+ * Defines the path like type used by this module.
  * @typedef {string | Buffer | URL} PathLike
  */
 
 /**
+ * Defines the path or file descriptor type used by this module.
  * @typedef {PathLike | number} PathOrFileDescriptor
  */
 
 /**
+ * Defines the object encoding options type used by this module.
  * @typedef {object} ObjectEncodingOptions
  * @property {BufferEncoding | null | undefined=} encoding
  */
 
 /**
+ * Describes the read file shape.
  * @typedef {{
  * (path: PathOrFileDescriptor, options: ({ encoding?: null | undefined, flag?: string | undefined } & import("events").Abortable) | undefined | null, callback: BufferCallback): void,
  * (path: PathOrFileDescriptor, options: ({ encoding: BufferEncoding, flag?: string | undefined } & import("events").Abortable) | BufferEncoding, callback: StringCallback): void,
@@ -147,6 +159,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the read file sync shape.
  * @typedef {{
  * (path: PathOrFileDescriptor, options?: { encoding?: null | undefined, flag?: string | undefined } | null): Buffer,
  * (path: PathOrFileDescriptor, options: { encoding: BufferEncoding, flag?: string | undefined } | BufferEncoding): string,
@@ -155,25 +168,30 @@ const path = require("path");
  */
 
 /**
+ * Defines the encoding option type used by this module.
  * @typedef {ObjectEncodingOptions | BufferEncoding | undefined | null} EncodingOption
  */
 
 /**
+ * Defines the buffer encoding option type used by this module.
  * @typedef {"buffer" | { encoding: "buffer" }} BufferEncodingOption
  */
 
 /**
+ * Defines the stat options type used by this module.
  * @typedef {object} StatOptions
  * @property {(boolean | undefined)=} bigint
  */
 
 /**
+ * Defines the stat sync options type used by this module.
  * @typedef {object} StatSyncOptions
  * @property {(boolean | undefined)=} bigint
  * @property {(boolean | undefined)=} throwIfNoEntry
  */
 
 /**
+ * Describes the readlink shape.
  * @typedef {{
  * (path: PathLike, options: EncodingOption, callback: StringCallback): void,
  * (path: PathLike, options: BufferEncodingOption, callback: BufferCallback): void,
@@ -183,6 +201,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the readlink sync shape.
  * @typedef {{
  * (path: PathLike, options?: EncodingOption): string,
  * (path: PathLike, options: BufferEncodingOption): Buffer,
@@ -191,6 +210,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the readdir shape.
  * @typedef {{
  * (path: PathLike, options: { encoding: BufferEncoding | null, withFileTypes?: false | undefined, recursive?: boolean | undefined } | BufferEncoding | undefined | null, callback: (err: NodeJS.ErrnoException | null, files?: string[]) => void): void,
  * (path: PathLike, options: { encoding: "buffer", withFileTypes?: false | undefined, recursive?: boolean | undefined } | "buffer", callback: (err: NodeJS.ErrnoException | null, files?: Buffer[]) => void): void,
@@ -202,6 +222,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the readdir sync shape.
  * @typedef {{
  * (path: PathLike, options?: { encoding: BufferEncoding | null, withFileTypes?: false | undefined, recursive?: boolean | undefined } | BufferEncoding | null): string[],
  * (path: PathLike, options: { encoding: "buffer", withFileTypes?: false | undefined, recursive?: boolean | undefined } | "buffer"): Buffer[],
@@ -212,6 +233,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the stat shape.
  * @typedef {{
  * (path: PathLike, callback: StatsCallback): void,
  * (path: PathLike, options: (StatOptions & { bigint?: false | undefined }) | undefined, callback: StatsCallback): void,
@@ -221,18 +243,20 @@ const path = require("path");
  */
 
 /**
+ * Describes the stat sync shape.
  * @typedef {{
- * (path: PathLike, options?: undefined): IStats,
+ * (path: PathLike): IStats,
+ * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry?: true | undefined }): IStats,
+ * (path: PathLike, options: StatSyncOptions & { bigint: true, throwIfNoEntry?: true | undefined }): IBigIntStats,
  * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry: false }): IStats | undefined,
  * (path: PathLike, options: StatSyncOptions & { bigint: true, throwIfNoEntry: false }): IBigIntStats | undefined,
- * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined }): IStats,
- * (path: PathLike, options: StatSyncOptions & { bigint: true }): IBigIntStats,
- * (path: PathLike, options: StatSyncOptions & { bigint: boolean, throwIfNoEntry?: false | undefined }): IStats | IBigIntStats,
+ * (path: PathLike, options: StatSyncOptions & { bigint: boolean, throwIfNoEntry?: true | undefined }): IStats | IBigIntStats,
  * (path: PathLike, options?: StatSyncOptions): IStats | IBigIntStats | undefined,
  * }} StatSync
  */
 
 /**
+ * Describes the l stat shape.
  * @typedef {{
  * (path: PathLike, callback: StatsCallback): void,
  * (path: PathLike, options: (StatOptions & { bigint?: false | undefined }) | undefined, callback: StatsCallback): void,
@@ -242,18 +266,20 @@ const path = require("path");
  */
 
 /**
+ * Describes the l stat sync shape.
  * @typedef {{
- * (path: PathLike, options?: undefined): IStats,
+ * (path: PathLike): IStats,
+ * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry?: true | undefined }): IStats,
+ * (path: PathLike, options: StatSyncOptions & { bigint: true, throwIfNoEntry?: true | undefined }): IBigIntStats,
  * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry: false }): IStats | undefined,
  * (path: PathLike, options: StatSyncOptions & { bigint: true, throwIfNoEntry: false }): IBigIntStats | undefined,
- * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined }): IStats,
- * (path: PathLike, options: StatSyncOptions & { bigint: true }): IBigIntStats,
- * (path: PathLike, options: StatSyncOptions & { bigint: boolean, throwIfNoEntry?: false | undefined }): IStats | IBigIntStats,
+ * (path: PathLike, options: StatSyncOptions & { bigint: boolean, throwIfNoEntry?: true | undefined }): IStats | IBigIntStats,
  * (path: PathLike, options?: StatSyncOptions): IStats | IBigIntStats | undefined,
  * }} LStatSync
  */
 
 /**
+ * Describes the real path shape.
  * @typedef {{
  * (path: PathLike, options: EncodingOption, callback: StringCallback): void,
  * (path: PathLike, options: BufferEncodingOption, callback: BufferCallback): void,
@@ -263,6 +289,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the real path sync shape.
  * @typedef {{
  * (path: PathLike, options?: EncodingOption): string,
  * (path: PathLike, options: BufferEncodingOption): Buffer,
@@ -271,18 +298,27 @@ const path = require("path");
  */
 
 /**
+ * Defines the read json type used by this module.
  * @typedef {(pathOrFileDescriptor: PathOrFileDescriptor, callback: ReadJsonCallback) => void} ReadJson
  */
 
 /**
+ * Defines the read json sync type used by this module.
  * @typedef {(pathOrFileDescriptor: PathOrFileDescriptor) => JsonObject} ReadJsonSync
  */
 
 /**
- * @typedef {(value?: string | string[] | Set<string>) => void} Purge
+ * Defines the purge type used by this module.
+ *
+ * `options.exact` (supported by enhanced-resolve's `CachedInputFileSystem`
+ * from v5.22.0): when true, only entries whose key exactly matches `value`
+ * are invalidated; cached entries for descendants are preserved. Default
+ * is false (legacy prefix-match behavior).
+ * @typedef {(value?: string | string[] | Set<string>, options?: { exact?: boolean }) => void} Purge
  */
 
 /**
+ * Defines the input file system type used by this module.
  * @typedef {object} InputFileSystem
  * @property {ReadFile} readFile
  * @property {ReadFileSync=} readFileSync
@@ -305,14 +341,17 @@ const path = require("path");
  */
 
 /**
+ * Defines the mode type used by this module.
  * @typedef {number | string} Mode
  */
 
 /**
+ * Defines the write file options type used by this module.
  * @typedef {(ObjectEncodingOptions & import("events").Abortable & { mode?: Mode | undefined, flag?: string | undefined, flush?: boolean | undefined }) | BufferEncoding | null} WriteFileOptions
  */
 
 /**
+ * Describes the write file shape.
  * @typedef {{
  * (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options: WriteFileOptions, callback: NoParamCallback): void,
  * (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, callback: NoParamCallback): void,
@@ -320,10 +359,12 @@ const path = require("path");
  */
 
 /**
+ * Defines the make directory options type used by this module.
  * @typedef {{ recursive?: boolean | undefined, mode?: Mode | undefined }} MakeDirectoryOptions
  */
 
 /**
+ * Describes the mkdir shape.
  * @typedef {{
  * (file: PathLike, options: MakeDirectoryOptions & { recursive: true }, callback: StringCallback): void,
  * (file: PathLike, options: Mode | (MakeDirectoryOptions & { recursive?: false | undefined }) | null | undefined, callback: NoParamCallback): void,
@@ -333,26 +374,32 @@ const path = require("path");
  */
 
 /**
+ * Defines the rmdir type used by this module.
  * @typedef {{ (file: PathLike, callback: NoParamCallback): void }} Rmdir
  */
 
 /**
+ * Defines the unlink type used by this module.
  * @typedef {(pathLike: PathLike, callback: NoParamCallback) => void} Unlink
  */
 
 /**
+ * Defines the create read stream fs implementation type used by this module.
  * @typedef {FSImplementation & { read: (...args: EXPECTED_ANY[]) => EXPECTED_ANY }} CreateReadStreamFSImplementation
  */
 
 /**
+ * Defines the read stream options type used by this module.
  * @typedef {StreamOptions & { fs?: CreateReadStreamFSImplementation | null | undefined, end?: number | undefined }} ReadStreamOptions
  */
 
 /**
+ * Defines the create read stream type used by this module.
  * @typedef {(path: PathLike, options?: BufferEncoding | ReadStreamOptions) => NodeJS.ReadableStream} CreateReadStream
  */
 
 /**
+ * Defines the output file system type used by this module.
  * @typedef {object} OutputFileSystem
  * @property {Mkdir} mkdir
  * @property {Readdir=} readdir
@@ -369,11 +416,13 @@ const path = require("path");
  */
 
 /**
+ * Defines the watch file system type used by this module.
  * @typedef {object} WatchFileSystem
  * @property {WatchMethod} watch
  */
 
 /**
+ * Describes the mkdir sync shape.
  * @typedef {{
  * (path: PathLike, options: MakeDirectoryOptions & { recursive: true }): string | undefined,
  * (path: PathLike, options?: Mode | (MakeDirectoryOptions & { recursive?: false | undefined }) | null): void,
@@ -382,6 +431,7 @@ const path = require("path");
  */
 
 /**
+ * Defines the stream options type used by this module.
  * @typedef {object} StreamOptions
  * @property {(string | undefined)=} flags
  * @property {(BufferEncoding | undefined)} encoding
@@ -394,28 +444,34 @@ const path = require("path");
  */
 
 /**
+ * Defines the fs implementation type used by this module.
  * @typedef {object} FSImplementation
  * @property {((...args: EXPECTED_ANY[]) => EXPECTED_ANY)=} open
  * @property {((...args: EXPECTED_ANY[]) => EXPECTED_ANY)=} close
  */
 
 /**
+ * Defines the create write stream fs implementation type used by this module.
  * @typedef {FSImplementation & { write: (...args: EXPECTED_ANY[]) => EXPECTED_ANY, close?: (...args: EXPECTED_ANY[]) => EXPECTED_ANY }} CreateWriteStreamFSImplementation
  */
 
 /**
+ * Defines the write stream options type used by this module.
  * @typedef {StreamOptions & { fs?: CreateWriteStreamFSImplementation | null | undefined, flush?: boolean | undefined }} WriteStreamOptions
  */
 
 /**
+ * Defines the create write stream type used by this module.
  * @typedef {(pathLike: PathLike, result?: BufferEncoding | WriteStreamOptions) => NodeJS.WritableStream} CreateWriteStream
  */
 
 /**
+ * Defines the open mode type used by this module.
  * @typedef {number | string} OpenMode
  */
 
 /**
+ * Describes the open shape.
  * @typedef {{
  * (file: PathLike, flags: OpenMode | undefined, mode: Mode | undefined | null, callback: NumberCallback): void,
  * (file: PathLike, flags: OpenMode | undefined, callback: NumberCallback): void,
@@ -424,10 +480,12 @@ const path = require("path");
  */
 
 /**
+ * Defines the read position type used by this module.
  * @typedef {number | bigint} ReadPosition
  */
 
 /**
+ * Defines the read sync options type used by this module.
  * @typedef {object} ReadSyncOptions
  * @property {(number | undefined)=} offset
  * @property {(number | undefined)=} length
@@ -435,6 +493,7 @@ const path = require("path");
  */
 
 /**
+ * Defines the read async options type used by this module.
  * @template {NodeJS.ArrayBufferView} TBuffer
  * @typedef {object} ReadAsyncOptions
  * @property {(number | undefined)=} offset
@@ -444,6 +503,7 @@ const path = require("path");
  */
 
 /**
+ * Defines the shared type used by this module.
  * @template {NodeJS.ArrayBufferView} [TBuffer=NodeJS.ArrayBufferView]
  * @typedef {{
  * (fd: number, buffer: TBuffer, offset: number, length: number, position: ReadPosition | null, callback: (err: NodeJS.ErrnoException | null, bytesRead: number, buffer: TBuffer) => void): void,
@@ -457,6 +517,7 @@ const path = require("path");
 /** @typedef {(a: PathLike, b: PathLike, callback: NoParamCallback) => void} Rename */
 
 /**
+ * Defines the intermediate file system extras type used by this module.
  * @typedef {object} IntermediateFileSystemExtras
  * @property {MkdirSync} mkdirSync
  * @property {CreateWriteStream} createWriteStream
@@ -469,6 +530,7 @@ const path = require("path");
 /** @typedef {InputFileSystem & OutputFileSystem & IntermediateFileSystemExtras} IntermediateFileSystem */
 
 /**
+ * Returns location of targetPath relative to rootPath.
  * @param {InputFileSystem | OutputFileSystem | undefined} fs a file system
  * @param {string} rootPath the root path
  * @param {string} targetPath the target path
@@ -488,6 +550,7 @@ const relative = (fs, rootPath, targetPath) => {
 };
 
 /**
+ * Returns the joined path.
  * @param {InputFileSystem | OutputFileSystem | undefined} fs a file system
  * @param {string} rootPath a path
  * @param {string} filename a filename
@@ -507,6 +570,7 @@ const join = (fs, rootPath, filename) => {
 };
 
 /**
+ * Returns the parent directory of the absolute path.
  * @param {InputFileSystem | OutputFileSystem | undefined} fs a file system
  * @param {string} absPath an absolute path
  * @returns {string} the parent directory of the absolute path
@@ -525,6 +589,7 @@ const dirname = (fs, absPath) => {
 };
 
 /**
+ * Processes the provided f.
  * @param {OutputFileSystem} fs a file system
  * @param {string} p an absolute path
  * @param {(err?: Error) => void} callback callback function for the error
@@ -546,7 +611,9 @@ const mkdirp = (fs, p, callback) => {
 					}
 					fs.mkdir(p, (err) => {
 						if (err) {
-							if (err.code === "EEXIST") {
+							// EEXIST: parent already created it; EISDIR: memfs/BSD for an
+							// existing dir such as the root "/" (#10544)
+							if (err.code === "EEXIST" || err.code === "EISDIR") {
 								callback();
 								return;
 							}
@@ -557,7 +624,7 @@ const mkdirp = (fs, p, callback) => {
 					});
 				});
 				return;
-			} else if (err.code === "EEXIST") {
+			} else if (err.code === "EEXIST" || err.code === "EISDIR") {
 				callback();
 				return;
 			}
@@ -569,6 +636,7 @@ const mkdirp = (fs, p, callback) => {
 };
 
 /**
+ * Processes the provided f.
  * @param {IntermediateFileSystem} fs a file system
  * @param {string} p an absolute path
  * @returns {void}
@@ -586,7 +654,10 @@ const mkdirpSync = (fs, p) => {
 				mkdirpSync(fs, dir);
 				fs.mkdirSync(p);
 				return;
-			} else if (/** @type {NodeJS.ErrnoException} */ (err).code === "EEXIST") {
+			} else if (
+				/** @type {NodeJS.ErrnoException} */ (err).code === "EEXIST" ||
+				/** @type {NodeJS.ErrnoException} */ (err).code === "EISDIR"
+			) {
 				return;
 			}
 			throw err;
@@ -595,6 +666,7 @@ const mkdirpSync = (fs, p) => {
 };
 
 /**
+ * Processes the provided f.
  * @param {InputFileSystem} fs a file system
  * @param {string} p an absolute path
  * @param {ReadJsonCallback} callback callback
@@ -620,6 +692,7 @@ const readJson = (fs, p, callback) => {
 };
 
 /**
+ * Lstat readlink absolute.
  * @param {InputFileSystem} fs a file system
  * @param {string} p an absolute path
  * @param {(err: NodeJS.ErrnoException | Error | null, stats?: IStats | string) => void} callback callback
@@ -659,11 +732,11 @@ const lstatReadlinkAbsolute = (fs, p, callback) => {
 };
 
 /**
+ * Checks whether this object is absolute.
  * @param {string} pathname a path
  * @returns {boolean} is absolute
  */
-const isAbsolute = (pathname) =>
-	path.posix.isAbsolute(pathname) || path.win32.isAbsolute(pathname);
+const isAbsolute = (pathname) => ABSOLUTE_PATH_REGEXP.test(pathname);
 
 module.exports.dirname = dirname;
 module.exports.isAbsolute = isAbsolute;

package/lib/util/generateDebugId.js

@@ -8,6 +8,7 @@
 const createHash = require("./createHash");
 
 /**
+ * Returns generated debug id.
  * @param {string | Buffer} content content
  * @param {string} file file
  * @returns {string} generated debug id