webpack 5.106.1 → 5.106.2

package/lib/serialization/FileMiddleware.js

@@ -48,6 +48,7 @@ const WRITE_LIMIT_TOTAL = 0x7fff0000;
 const WRITE_LIMIT_CHUNK = 511 * 1024 * 1024;
 
 /**
+ * Returns hash.
  * @param {Buffer[]} buffers buffers
  * @param {HashFunction} hashFunction hash function to use
  * @returns {string} hash
@@ -85,6 +86,7 @@ const readUInt64LE = Buffer.prototype.readBigUInt64LE
 /** @typedef {Promise<void | void[]>} BackgroundJob */
 
 /**
+ * Defines the serialize result type used by this module.
  * @typedef {object} SerializeResult
  * @property {string | false} name
  * @property {number} size
@@ -93,10 +95,12 @@ const readUInt64LE = Buffer.prototype.readBigUInt64LE
 
 /** @typedef {{ name: string, size: number }} LazyOptions */
 /**
+ * Defines the lazy function type used by this module.
  * @typedef {import("./SerializerMiddleware").LazyFunction<BufferSerializableType[], Buffer, FileMiddleware, LazyOptions>} LazyFunction
  */
 
 /**
+ * Serializes this instance into the provided serializer context.
  * @param {FileMiddleware} middleware this
  * @param {(BufferSerializableType | LazyFunction)[]} data data to be serialized
  * @param {string | boolean} name file base name
@@ -243,6 +247,7 @@ const serialize = async (
 };
 
 /**
+ * Restores this instance from the provided deserializer context.
  * @param {FileMiddleware} middleware this
  * @param {string | false} name filename
  * @param {(name: string | false) => Promise<Buffer[]>} readFile read content of a file
@@ -263,6 +268,7 @@ const deserialize = async (middleware, name, readFile) => {
 		contentPosition = 0;
 	};
 	/**
+	 * Processes the provided n.
 	 * @param {number} n number of bytes to ensure
 	 */
 	const ensureData = (n) => {
@@ -294,6 +300,7 @@ const deserialize = async (middleware, name, readFile) => {
 		}
 	};
 	/**
+	 * Returns value value.
 	 * @returns {number} value value
 	 */
 	const readUInt32LE = () => {
@@ -303,6 +310,7 @@ const deserialize = async (middleware, name, readFile) => {
 		return value;
 	};
 	/**
+	 * Returns value value.
 	 * @returns {number} value value
 	 */
 	const readInt32LE = () => {
@@ -312,6 +320,7 @@ const deserialize = async (middleware, name, readFile) => {
 		return value;
 	};
 	/**
+	 * Returns buffer.
 	 * @param {number} l length
 	 * @returns {Buffer} buffer
 	 */
@@ -429,10 +438,12 @@ const deserialize = async (middleware, name, readFile) => {
 /** @typedef {{ filename: string, extension?: string }} Context */
 
 /**
+ * Represents FileMiddleware.
  * @extends {SerializerMiddleware<DeserializedType, SerializedType, Context>}
  */
 class FileMiddleware extends SerializerMiddleware {
 	/**
+	 * Creates an instance of FileMiddleware.
 	 * @param {IntermediateFileSystem} fs filesystem
 	 * @param {HashFunction} hashFunction hash function to use
 	 */
@@ -445,6 +456,7 @@ class FileMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {DeserializedType} data data
 	 * @param {Context} context context object
 	 * @returns {SerializedType | Promise<SerializedType> | null} serialized data
@@ -460,6 +472,7 @@ class FileMiddleware extends SerializerMiddleware {
 				/** @type {Set<string>} */
 				const allWrittenFiles = new Set();
 				/**
+				 * Processes the provided name.
 				 * @param {string | false} name name
 				 * @param {Buffer[]} content content
 				 * @param {number} size size
@@ -471,6 +484,7 @@ class FileMiddleware extends SerializerMiddleware {
 						: filename;
 					await new Promise(
 						/**
+						 * Handles the callback logic for this hook.
 						 * @param {(value?: undefined) => void} resolve resolve
 						 * @param {(reason?: Error | null) => void} reject reject
 						 */
@@ -518,6 +532,7 @@ class FileMiddleware extends SerializerMiddleware {
 							const len = chunks.length;
 							let i = 0;
 							/**
+							 * Processes the provided err.
 							 * @param {(Error | null)=} err err
 							 */
 							const batchWrite = (err) => {
@@ -557,6 +572,7 @@ class FileMiddleware extends SerializerMiddleware {
 							// Rename the index file to disallow access during inconsistent file state
 							await new Promise(
 								/**
+								 * Handles the callback logic for this hook.
 								 * @param {(value?: undefined) => void} resolve resolve
 								 */
 								(resolve) => {
@@ -573,6 +589,7 @@ class FileMiddleware extends SerializerMiddleware {
 									(file) =>
 										new Promise(
 											/**
+											 * Handles the callback logic for this hook.
 											 * @param {(value?: undefined) => void} resolve resolve
 											 * @param {(reason?: Error | null) => void} reject reject
 											 * @returns {void}
@@ -590,6 +607,7 @@ class FileMiddleware extends SerializerMiddleware {
 							// As final step automatically update the index file to have a consistent pack again
 							await new Promise(
 								/**
+								 * Handles the callback logic for this hook.
 								 * @param {(value?: undefined) => void} resolve resolve
 								 * @returns {void}
 								 */
@@ -609,6 +627,7 @@ class FileMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {SerializedType} data data
 	 * @param {Context} context context object
 	 * @returns {DeserializedType | Promise<DeserializedType>} deserialized data
@@ -616,6 +635,7 @@ class FileMiddleware extends SerializerMiddleware {
 	deserialize(data, context) {
 		const { filename, extension = "" } = context;
 		/**
+		 * Returns result.
 		 * @param {string | boolean} name name
 		 * @returns {Promise<Buffer[]>} result
 		 */
@@ -663,6 +683,7 @@ class FileMiddleware extends SerializerMiddleware {
 								}),
 								new Promise(
 									/**
+									 * Handles the chunk size callback for this hook.
 									 * @param {(value?: undefined) => void} resolve resolve
 									 * @param {(reason?: Error) => void} reject reject
 									 */

package/lib/serialization/MapObjectSerializer.js

@@ -9,6 +9,7 @@
 
 class MapObjectSerializer {
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @template K, V
 	 * @param {Map<K, V>} obj map
 	 * @param {ObjectSerializerContext} context context
@@ -24,6 +25,7 @@ class MapObjectSerializer {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @template K, V
 	 * @param {ObjectDeserializerContext} context context
 	 * @returns {Map<K, V>} map

package/lib/serialization/NullPrototypeObjectSerializer.js

@@ -11,6 +11,7 @@
 
 class NullPrototypeObjectSerializer {
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @template {object} T
 	 * @param {T} obj null object
 	 * @param {ObjectSerializerContext} context context
@@ -28,6 +29,7 @@ class NullPrototypeObjectSerializer {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @template {object} T
 	 * @param {ObjectDeserializerContext} context context
 	 * @returns {T} null object

package/lib/serialization/ObjectMiddleware.js

@@ -48,6 +48,7 @@ Technically any value can be used.
 */
 
 /**
+ * Defines the object serializer snapshot type used by this module.
  * @typedef {object} ObjectSerializerSnapshot
  * @property {number} length
  * @property {number} cycleStackSize
@@ -60,6 +61,7 @@ Technically any value can be used.
 /** @typedef {EXPECTED_OBJECT | string} ReferenceableItem */
 
 /**
+ * Defines the object serializer context type used by this module.
  * @typedef {object} ObjectSerializerContext
  * @property {(value: EXPECTED_ANY) => void} write
  * @property {(value: ReferenceableItem) => void} setCircularReference
@@ -70,18 +72,21 @@ Technically any value can be used.
  */
 
 /**
+ * Defines the object deserializer context type used by this module.
  * @typedef {object} ObjectDeserializerContext
  * @property {() => EXPECTED_ANY} read
  * @property {(value: ReferenceableItem) => void} setCircularReference
  */
 
 /**
+ * Defines the object serializer type used by this module.
  * @typedef {object} ObjectSerializer
  * @property {(value: EXPECTED_ANY, context: ObjectSerializerContext) => void} serialize
  * @property {(context: ObjectDeserializerContext) => EXPECTED_ANY} deserialize
  */
 
 /**
+ * Updates set size using the provided set.
  * @template T
  * @param {Set<T>} set set
  * @param {number} size count of items to keep
@@ -96,6 +101,7 @@ const setSetSize = (set, size) => {
 };
 
 /**
+ * Updates map size using the provided map.
  * @template K, X
  * @param {Map<K, X>} map map
  * @param {number} size count of items to keep
@@ -110,6 +116,7 @@ const setMapSize = (map, size) => {
 };
 
 /**
+ * Returns hash.
  * @param {Buffer} buffer buffer
  * @param {HashFunction} hashFunction hash function to use
  * @returns {string} hash
@@ -210,10 +217,12 @@ const loaders = new Map();
 /** @typedef {(context: ObjectSerializerContext | ObjectDeserializerContext) => void} ExtendContext */
 
 /**
+ * Represents ObjectMiddleware.
  * @extends {SerializerMiddleware<DeserializedType, SerializedType, Context>}
  */
 class ObjectMiddleware extends SerializerMiddleware {
 	/**
+	 * Creates an instance of ObjectMiddleware.
 	 * @param {ExtendContext} extendContext context extensions
 	 * @param {HashFunction} hashFunction hash function to use
 	 */
@@ -226,6 +235,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Processes the provided reg exp.
 	 * @param {RegExp} regExp RegExp for which the request is tested
 	 * @param {(request: string) => boolean} loader loader to load the request, returns true when successful
 	 * @returns {void}
@@ -235,6 +245,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Processes the provided constructor.
 	 * @param {Constructor} Constructor the constructor
 	 * @param {string} request the request which will be required when deserializing
 	 * @param {string | null} name the name to make multiple serializer unique when sharing a request
@@ -266,6 +277,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Register not serializable.
 	 * @param {Constructor} Constructor the constructor
 	 * @returns {void}
 	 */
@@ -280,6 +292,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Gets serializer for.
 	 * @param {EXPECTED_ANY} object for serialization
 	 * @returns {SerializerConfigWithSerializer} Serializer config
 	 */
@@ -311,6 +324,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Gets deserializer for.
 	 * @param {string} request request
 	 * @param {string} name name
 	 * @returns {ObjectSerializer} serializer
@@ -327,6 +341,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Get deserializer for without error.
 	 * @param {string} request request
 	 * @param {string} name name
 	 * @returns {ObjectSerializer | undefined} serializer
@@ -338,6 +353,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {DeserializedType} data data
 	 * @param {Context} context context object
 	 * @returns {SerializedType | Promise<SerializedType> | null} serialized data
@@ -349,6 +365,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 		/** @type {Map<ReferenceableItem, number>} */
 		let referenceable = new Map();
 		/**
+		 * Adds referenceable.
 		 * @param {ReferenceableItem} item referenceable item
 		 */
 		const addReferenceable = (item) => {
@@ -357,6 +374,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 		/** @type {Map<number, Buffer | [Buffer, Buffer] | Map<string, Buffer>>} */
 		let bufferDedupeMap = new Map();
 		/**
+		 * Returns deduped buffer.
 		 * @param {Buffer} buf buffer
 		 * @returns {Buffer} deduped buffer
 		 */
@@ -426,6 +444,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 		/** @type {Set<ComplexSerializableType>} */
 		const cycleStack = new Set();
 		/**
+		 * Returns stack.
 		 * @param {ComplexSerializableType} item item to stack
 		 * @returns {string} stack
 		 */
@@ -531,6 +550,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 		};
 		this.extendContext(ctx);
 		/**
+		 * Processes the provided item.
 		 * @param {ComplexSerializableType} item item to serialize
 		 */
 		const process = (item) => {
@@ -681,6 +701,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {SerializedType} data data
 	 * @param {Context} context context object
 	 * @returns {DeserializedType | Promise<DeserializedType>} deserialized data
@@ -703,6 +724,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 		/** @type {ReferenceableItem[]} */
 		let referenceable = [];
 		/**
+		 * Adds referenceable.
 		 * @param {ReferenceableItem} item referenceable item
 		 */
 		const addReferenceable = (item) => {
@@ -726,6 +748,7 @@ class ObjectMiddleware extends SerializerMiddleware {
 		};
 		this.extendContext(ctx);
 		/**
+		 * Decodes the provided value.
 		 * @returns {ComplexSerializableType} deserialize value
 		 */
 		const decodeValue = () => {

package/lib/serialization/PlainObjectSerializer.js

@@ -10,12 +10,14 @@
 /** @typedef {EXPECTED_FUNCTION} CacheAssoc */
 
 /**
+ * Defines the shared type used by this module.
  * @template T
  * @typedef {WeakMap<CacheAssoc, ObjectStructure<T>>}
  */
 const cache = new WeakMap();
 
 /**
+ * Represents ObjectStructure.
  * @template T
  */
 class ObjectStructure {
@@ -27,6 +29,7 @@ class ObjectStructure {
 	}
 
 	/**
+	 * Returns keys.
 	 * @param {keyof T[]} keys keys
 	 * @returns {keyof T[]} keys
 	 */
@@ -36,6 +39,7 @@ class ObjectStructure {
 	}
 
 	/**
+	 * Returns object structure.
 	 * @param {keyof T} key key
 	 * @returns {ObjectStructure<T>} object structure
 	 */
@@ -50,6 +54,7 @@ class ObjectStructure {
 }
 
 /**
+ * Returns keys.
  * @template T
  * @param {(keyof T)[]} keys keys
  * @param {CacheAssoc} cacheAssoc cache assoc fn
@@ -70,6 +75,7 @@ const getCachedKeys = (keys, cacheAssoc) => {
 
 class PlainObjectSerializer {
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @template {object} T
 	 * @param {T} obj plain object
 	 * @param {ObjectSerializerContext} context context
@@ -98,6 +104,7 @@ class PlainObjectSerializer {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @template {object} T
 	 * @param {ObjectDeserializerContext} context context
 	 * @returns {T} plain object

package/lib/serialization/RegExpObjectSerializer.js

@@ -9,6 +9,7 @@
 
 class RegExpObjectSerializer {
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {RegExp} obj regexp
 	 * @param {ObjectSerializerContext} context context
 	 */
@@ -18,6 +19,7 @@ class RegExpObjectSerializer {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 * @returns {RegExp} regexp
 	 */

package/lib/serialization/Serializer.js

@@ -5,17 +5,20 @@
 "use strict";
 
 /**
+ * Defines the serializer middleware type used by this module.
  * @template T, K, C
  * @typedef {import("./SerializerMiddleware")<T, K, C>} SerializerMiddleware
  */
 
 /**
+ * Represents Serializer.
  * @template DeserializedValue
  * @template SerializedValue
  * @template Context
  */
 class Serializer {
 	/**
+	 * Creates an instance of Serializer.
 	 * @param {SerializerMiddleware<EXPECTED_ANY, EXPECTED_ANY, EXPECTED_ANY>[]} middlewares serializer middlewares
 	 * @param {Context=} context context
 	 */
@@ -26,6 +29,7 @@ class Serializer {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @template ExtendedContext
 	 * @param {DeserializedValue | Promise<DeserializedValue>} obj object
 	 * @param {Context & ExtendedContext} context context object
@@ -57,6 +61,7 @@ class Serializer {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @template ExtendedContext
 	 * @param {SerializedValue | Promise<SerializedValue>} value value
 	 * @param {Context & ExtendedContext} context object

package/lib/serialization/SerializerMiddleware.js

@@ -13,6 +13,7 @@ const LAZY_SERIALIZED_VALUE = Symbol("lazy serialization data");
 /** @typedef {Record<string, EXPECTED_ANY>} LazyOptions */
 
 /**
+ * Defines the lazy function type used by this module.
  * @template InputValue
  * @template OutputValue
  * @template {LazyTarget} InternalLazyTarget
@@ -21,6 +22,7 @@ const LAZY_SERIALIZED_VALUE = Symbol("lazy serialization data");
  */
 
 /**
+ * Represents SerializerMiddleware.
  * @template DeserializedType
  * @template SerializedType
  * @template Context
@@ -28,6 +30,7 @@ const LAZY_SERIALIZED_VALUE = Symbol("lazy serialization data");
 class SerializerMiddleware {
 	/* istanbul ignore next */
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @abstract
 	 * @param {DeserializedType} data data
 	 * @param {Context} context context object
@@ -41,6 +44,7 @@ class SerializerMiddleware {
 
 	/* istanbul ignore next */
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @abstract
 	 * @param {SerializedType} data data
 	 * @param {Context} context context object
@@ -53,6 +57,7 @@ class SerializerMiddleware {
 	}
 
 	/**
+	 * Creates a lazy from the provided value.
 	 * @template TLazyInputValue
 	 * @template TLazyOutputValue
 	 * @template {LazyTarget} TLazyTarget
@@ -80,6 +85,7 @@ class SerializerMiddleware {
 	}
 
 	/**
+	 * Checks whether this serializer middleware is lazy.
 	 * @template {LazyTarget} TLazyTarget
 	 * @param {EXPECTED_ANY} fn lazy function
 	 * @param {TLazyTarget=} target target middleware
@@ -92,6 +98,7 @@ class SerializerMiddleware {
 	}
 
 	/**
+	 * Returns options.
 	 * @template TLazyInputValue
 	 * @template TLazyOutputValue
 	 * @template {LazyTarget} TLazyTarget
@@ -105,6 +112,7 @@ class SerializerMiddleware {
 	}
 
 	/**
+	 * Gets lazy serialized value.
 	 * @template TLazyInputValue
 	 * @template TLazyOutputValue
 	 * @template {LazyTarget} TLazyTarget
@@ -118,6 +126,7 @@ class SerializerMiddleware {
 	}
 
 	/**
+	 * Sets lazy serialized value.
 	 * @template TLazyInputValue
 	 * @template TLazyOutputValue
 	 * @template {LazyTarget} TLazyTarget
@@ -131,6 +140,7 @@ class SerializerMiddleware {
 	}
 
 	/**
+	 * Returns new lazy.
 	 * @template TLazyInputValue DeserializedValue
 	 * @template TLazyOutputValue SerializedValue
 	 * @template {LazyTarget} TLazyTarget
@@ -165,6 +175,7 @@ class SerializerMiddleware {
 	}
 
 	/**
+	 * Returns new lazy.
 	 * @template TLazyInputValue SerializedValue
 	 * @template TLazyOutputValue DeserializedValue
 	 * @template {LazyTarget} TLazyTarget
@@ -198,6 +209,7 @@ class SerializerMiddleware {
 	}
 
 	/**
+	 * Returns new lazy.
 	 * @template TLazyInputValue
 	 * @template TLazyOutputValue
 	 * @template {LazyTarget} TLazyTarget

package/lib/serialization/SetObjectSerializer.js

@@ -9,6 +9,7 @@
 
 class SetObjectSerializer {
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @template T
 	 * @param {Set<T>} obj set
 	 * @param {ObjectSerializerContext} context context
@@ -21,6 +22,7 @@ class SetObjectSerializer {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @template T
 	 * @param {ObjectDeserializerContext} context context
 	 * @returns {Set<T>} date

package/lib/serialization/SingleItemMiddleware.js

@@ -11,10 +11,12 @@ const SerializerMiddleware = require("./SerializerMiddleware");
 /** @typedef {EXPECTED_OBJECT} Context */
 
 /**
+ * Represents SingleItemMiddleware.
  * @extends {SerializerMiddleware<DeserializedType, SerializedType, Context>}
  */
 class SingleItemMiddleware extends SerializerMiddleware {
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {DeserializedType} data data
 	 * @param {Context} context context object
 	 * @returns {SerializedType | Promise<SerializedType> | null} serialized data
@@ -24,6 +26,7 @@ class SingleItemMiddleware extends SerializerMiddleware {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {SerializedType} data data
 	 * @param {Context} context context object
 	 * @returns {DeserializedType | Promise<DeserializedType>} deserialized data

package/lib/sharing/ConsumeSharedFallbackDependency.js

@@ -10,6 +10,7 @@ const makeSerializable = require("../util/makeSerializable");
 
 class ConsumeSharedFallbackDependency extends ModuleDependency {
 	/**
+	 * Creates an instance of ConsumeSharedFallbackDependency.
 	 * @param {string} request the request
 	 */
 	constructor(request) {