webpack 5.106.1 → 5.106.2

package/lib/util/findGraphRoots.js

@@ -11,15 +11,18 @@ 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) {
@@ -48,6 +51,7 @@ class SCC {
 }
 
 /**
+ * Defines the stack entry type used by this module.
  * @template T
  * @typedef {object} StackEntry
  * @property {Node<T>} node
@@ -55,6 +59,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/util/fs.js

@@ -13,6 +13,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 +44,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 +95,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 +105,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 +117,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 +132,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 +158,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 +167,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 +200,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the readlink sync shape.
  * @typedef {{
  * (path: PathLike, options?: EncodingOption): string,
  * (path: PathLike, options: BufferEncodingOption): Buffer,
@@ -191,6 +209,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 +221,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 +232,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,6 +242,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the stat sync shape.
  * @typedef {{
  * (path: PathLike, options?: undefined): IStats,
  * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry: false }): IStats | undefined,
@@ -233,6 +255,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the l stat shape.
  * @typedef {{
  * (path: PathLike, callback: StatsCallback): void,
  * (path: PathLike, options: (StatOptions & { bigint?: false | undefined }) | undefined, callback: StatsCallback): void,
@@ -242,6 +265,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the l stat sync shape.
  * @typedef {{
  * (path: PathLike, options?: undefined): IStats,
  * (path: PathLike, options?: StatSyncOptions & { bigint?: false | undefined, throwIfNoEntry: false }): IStats | undefined,
@@ -254,6 +278,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the real path shape.
  * @typedef {{
  * (path: PathLike, options: EncodingOption, callback: StringCallback): void,
  * (path: PathLike, options: BufferEncodingOption, callback: BufferCallback): void,
@@ -263,6 +288,7 @@ const path = require("path");
  */
 
 /**
+ * Describes the real path sync shape.
  * @typedef {{
  * (path: PathLike, options?: EncodingOption): string,
  * (path: PathLike, options: BufferEncodingOption): Buffer,
@@ -271,18 +297,22 @@ 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
  */
 
 /**
+ * Defines the purge type used by this module.
  * @typedef {(value?: string | string[] | Set<string>) => void} Purge
  */
 
 /**
+ * Defines the input file system type used by this module.
  * @typedef {object} InputFileSystem
  * @property {ReadFile} readFile
  * @property {ReadFileSync=} readFileSync
@@ -305,14 +335,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 +353,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 +368,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 +410,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 +425,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 +438,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 +474,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 +487,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 +497,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 +511,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 +524,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 +544,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 +564,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 +583,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
@@ -569,6 +628,7 @@ const mkdirp = (fs, p, callback) => {
 };
 
 /**
+ * Processes the provided f.
  * @param {IntermediateFileSystem} fs a file system
  * @param {string} p an absolute path
  * @returns {void}
@@ -595,6 +655,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 +681,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,6 +721,7 @@ const lstatReadlinkAbsolute = (fs, p, callback) => {
 };
 
 /**
+ * Checks whether this object is absolute.
  * @param {string} pathname a path
  * @returns {boolean} is absolute
  */

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

package/lib/util/hash/BatchedHash.js

@@ -14,6 +14,7 @@ const MAX_SHORT_STRING = require("./wasm-hash").MAX_SHORT_STRING;
 
 class BatchedHash extends Hash {
 	/**
+	 * Creates an instance of BatchedHash.
 	 * @param {Hash} hash hash
 	 */
 	constructor(hash) {

package/lib/util/hash/BulkUpdateHash.js

@@ -20,6 +20,7 @@ const digestCaches = {};
 
 class BulkUpdateHash extends Hash {
 	/**
+	 * Creates an instance of BulkUpdateHash.
 	 * @param {Hash | HashFactory} hashOrFactory function to create a hash
 	 * @param {string=} hashKey key for caching
 	 */

package/lib/util/hash/hash-digest.js

@@ -61,6 +61,7 @@ const encode = (buffer, base) => {
 };
 
 /**
+ * Returns buffer.
  * @param {string} data string
  * @param {Base} base base
  * @returns {Buffer} buffer
@@ -100,6 +101,7 @@ const decode = (data, base) => {
 // Compatibility with the old hash libraries, they can return different structures, so let's stringify them firstly
 
 /**
+ * Returns a string representation.
  * @param {string | { toString: (radix: number) => string }} value value
  * @param {string} encoding encoding
  * @returns {string} string
@@ -113,6 +115,7 @@ const toString = (value, encoding) =>
 			);
 
 /**
+ * Returns buffer.
  * @param {Buffer | { toString: (radix: number) => string }} value value
  * @returns {Buffer} buffer
  */
@@ -128,6 +131,7 @@ try {
 }
 
 /**
+ * Processes the provided hash.
  * @param {Hash} hash hash
  * @param {string | Buffer} data data
  * @param {Encoding=} encoding encoding of the return value
@@ -159,11 +163,13 @@ const update = (hash, data, encoding) => {
 };
 
 /**
+ * Returns digest.
  * @overload
  * @param {Hash} hash hash
  * @returns {Buffer} digest
  */
 /**
+ * Returns digest.
  * @overload
  * @param {Hash} hash hash
  * @param {undefined} encoding encoding of the return value
@@ -171,6 +177,7 @@ const update = (hash, data, encoding) => {
  * @returns {Buffer} digest
  */
 /**
+ * Returns digest.
  * @overload
  * @param {Hash} hash hash
  * @param {Encoding} encoding encoding of the return value
@@ -178,6 +185,7 @@ const update = (hash, data, encoding) => {
  * @returns {string} digest
  */
 /**
+ * Returns digest.
  * @param {Hash} hash hash
  * @param {Encoding=} encoding encoding of the return value
  * @param {boolean=} isSafe true when we await right types from digest(), otherwise false

package/lib/util/hash/wasm-hash.js

@@ -14,6 +14,7 @@ const Hash = require("../Hash");
 const MAX_SHORT_STRING = Math.floor((65536 - 64) / 4) & ~3;
 
 /**
+ * Represents the wasm hash runtime component.
  * @typedef {object} WasmExports
  * @property {WebAssembly.Memory} memory
  * @property {() => void} init
@@ -23,6 +24,7 @@ const MAX_SHORT_STRING = Math.floor((65536 - 64) / 4) & ~3;
 
 class WasmHash extends Hash {
 	/**
+	 * Creates an instance of WasmHash.
 	 * @param {WebAssembly.Instance} instance wasm instance
 	 * @param {WebAssembly.Instance[]} instancesPool pool of instances
 	 * @param {number} chunkSize size of data chunks passed to wasm
@@ -93,6 +95,7 @@ class WasmHash extends Hash {
 	}
 
 	/**
+	 * Update with short string.
 	 * @param {string} data data
 	 * @param {BufferEncoding=} encoding encoding
 	 * @returns {void}
@@ -143,6 +146,7 @@ class WasmHash extends Hash {
 	}
 
 	/**
+	 * Update with buffer.
 	 * @param {Buffer} data data
 	 * @returns {void}
 	 */
@@ -206,6 +210,7 @@ class WasmHash extends Hash {
 }
 
 /**
+ * Returns wasm hash.
  * @param {WebAssembly.Module} wasmModule wasm module
  * @param {WasmHash[]} instancesPool pool of instances
  * @param {number} chunkSize size of data chunks passed to wasm