webpack 5.106.0 → 5.106.2

package/lib/asset/RawDataUrlModule.js

@@ -36,6 +36,7 @@ const makeSerializable = require("../util/makeSerializable");
 
 class RawDataUrlModule extends Module {
 	/**
+	 * Creates an instance of RawDataUrlModule.
 	 * @param {string} url raw url
 	 * @param {string} identifier unique identifier
 	 * @param {string=} readableIdentifier readable identifier
@@ -53,6 +54,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Returns the source types this module can generate.
 	 * @returns {SourceTypes} types available (do not mutate)
 	 */
 	getSourceTypes() {
@@ -60,6 +62,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Returns the unique identifier used to reference this module.
 	 * @returns {string} a unique identifier of the module
 	 */
 	identifier() {
@@ -67,6 +70,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @param {string=} type the source type for which the size should be estimated
 	 * @returns {number} the estimated size of the module (must be non-zero)
 	 */
@@ -78,6 +82,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Returns a human-readable identifier for this module.
 	 * @param {RequestShortener} requestShortener the request shortener
 	 * @returns {string} a user readable identifier of the module
 	 */
@@ -88,6 +93,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Checks whether the module needs to be rebuilt for the current build state.
 	 * @param {NeedBuildContext} context context info
 	 * @param {NeedBuildCallback} callback callback function, returns true, if the module needs a rebuild
 	 * @returns {void}
@@ -97,6 +103,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Builds the module using the provided compilation context.
 	 * @param {WebpackOptions} options webpack options
 	 * @param {Compilation} compilation the compilation
 	 * @param {ResolverWithOptions} resolver the resolver
@@ -113,6 +120,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Generates code and runtime requirements for this module.
 	 * @param {CodeGenerationContext} context context for code generation
 	 * @returns {CodeGenerationResult} result
 	 */
@@ -138,6 +146,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash the hash used to track dependencies
 	 * @param {UpdateHashContext} context context
 	 * @returns {void}
@@ -148,6 +157,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -161,6 +171,7 @@ class RawDataUrlModule extends Module {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/async-modules/AsyncModuleHelpers.js

@@ -13,6 +13,7 @@ const HarmonyImportDependency = require("../dependencies/HarmonyImportDependency
 /** @typedef {Set<Module>} Modules */
 
 /**
+ * Gets outgoing async modules.
  * @param {ModuleGraph} moduleGraph module graph
  * @param {Module} module module
  * @returns {Modules} set of modules

package/lib/async-modules/AwaitDependenciesInitFragment.js

@@ -15,10 +15,12 @@ const Template = require("../Template");
 /** @typedef {Map<string, string>} Dependencies */
 
 /**
+ * Represents AwaitDependenciesInitFragment.
  * @extends {InitFragment<GenerateContext>}
  */
 class AwaitDependenciesInitFragment extends InitFragment {
 	/**
+	 * Creates an instance of AwaitDependenciesInitFragment.
 	 * @param {Dependencies} dependencies maps an import var to an async module that needs to be awaited
 	 */
 	constructor(dependencies) {
@@ -33,6 +35,7 @@ class AwaitDependenciesInitFragment extends InitFragment {
 	}
 
 	/**
+	 * Merges another await-dependencies fragment into this fragment.
 	 * @param {AwaitDependenciesInitFragment} other other AwaitDependenciesInitFragment
 	 * @returns {AwaitDependenciesInitFragment} AwaitDependenciesInitFragment
 	 */
@@ -45,6 +48,7 @@ class AwaitDependenciesInitFragment extends InitFragment {
 	}
 
 	/**
+	 * Returns the source code that will be included as initialization code.
 	 * @param {GenerateContext} context context
 	 * @returns {string | Source | undefined} the source code that will be included as initialization code
 	 */

package/lib/async-modules/InferAsyncModulesPlugin.js

@@ -14,7 +14,7 @@ const PLUGIN_NAME = "InferAsyncModulesPlugin";
 
 class InferAsyncModulesPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/buildChunkGraph.js

@@ -24,6 +24,7 @@ const { getEntryRuntime, mergeRuntime } = require("./util/runtime");
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
 
 /**
+ * Defines the queue item type used by this module.
  * @typedef {object} QueueItem
  * @property {number} action
  * @property {DependenciesBlock} block
@@ -34,6 +35,7 @@ const { getEntryRuntime, mergeRuntime } = require("./util/runtime");
  */
 
 /**
+ * Defines the chunk group info type used by this module.
  * @typedef {object} ChunkGroupInfo
  * @property {ChunkGroup} chunkGroup the chunk group
  * @property {RuntimeSpec} runtime the runtimes
@@ -55,6 +57,7 @@ const { getEntryRuntime, mergeRuntime } = require("./util/runtime");
  */
 
 /**
+ * Defines the block chunk group connection type used by this module.
  * @typedef {object} BlockChunkGroupConnection
  * @property {ChunkGroupInfo} originChunkGroupInfo origin chunk group
  * @property {ChunkGroup} chunkGroup referenced chunk group
@@ -74,6 +77,7 @@ const ZERO_BIGINT = BigInt(0);
 const ONE_BIGINT = BigInt(1);
 
 /**
+ * Checks whether this object is ordinal set in mask.
  * @param {bigint} mask The mask to test
  * @param {number} ordinal The ordinal of the bit to test
  * @returns {boolean} If the ordinal-th bit is set in the mask
@@ -82,6 +86,7 @@ const isOrdinalSetInMask = (mask, ordinal) =>
 	BigInt.asUintN(1, mask >> BigInt(ordinal)) !== ZERO_BIGINT;
 
 /**
+ * Gets active state of connections.
  * @param {ModuleGraphConnection[]} connections list of connections
  * @param {RuntimeSpec} runtime for which runtime
  * @returns {ConnectionState} connection state
@@ -101,6 +106,7 @@ const getActiveStateOfConnections = (connections, runtime) => {
 };
 
 /**
+ * Extract block modules.
  * @param {Module} module module
  * @param {ModuleGraph} moduleGraph module graph
  * @param {RuntimeSpec} runtime runtime
@@ -237,6 +243,7 @@ const extractBlockModules = (module, moduleGraph, runtime, blockModulesMap) => {
 };
 
 /**
+ * Processes the provided logger.
  * @param {Logger} logger a logger
  * @param {Compilation} compilation the compilation
  * @param {InputEntrypointsAndModules} inputEntrypointsAndModules chunk groups which are processed with the modules
@@ -268,6 +275,7 @@ const visitModules = (
 	const ordinalByModule = new Map();
 
 	/**
+	 * Gets module ordinal.
 	 * @param {Module} module The module to look up
 	 * @returns {number} The ordinal of the module in masks
 	 */
@@ -289,6 +297,7 @@ const visitModules = (
 	}
 
 	/**
+	 * Gets block modules.
 	 * @param {DependenciesBlock} block block
 	 * @param {RuntimeSpec} runtime runtime
 	 * @returns {BlockModulesInFlattenTuples | undefined} block modules in flatten tuples
@@ -493,6 +502,7 @@ const visitModules = (
 
 	// For each async Block in graph
 	/**
+	 * Processes the provided b.
 	 * @param {AsyncDependenciesBlock} b iterating over each Async DepBlock
 	 * @returns {void}
 	 */
@@ -699,6 +709,7 @@ const visitModules = (
 	};
 
 	/**
+	 * Processes the provided block.
 	 * @param {DependenciesBlock} block the block
 	 * @returns {void}
 	 */
@@ -791,6 +802,7 @@ const visitModules = (
 	};
 
 	/**
+	 * Process entry block.
 	 * @param {DependenciesBlock} block the block
 	 * @returns {void}
 	 */
@@ -918,6 +930,7 @@ const visitModules = (
 	};
 
 	/**
+	 * Calculate resulting available modules.
 	 * @param {ChunkGroupInfo} chunkGroupInfo The info object for the chunk group
 	 * @returns {bigint} The mask of available modules after the chunk group
 	 */
@@ -1193,6 +1206,7 @@ const visitModules = (
 			let preOrderIndex = 0;
 			let postOrderIndex = 0;
 			/**
+			 * Processes the provided current.
 			 * @param {DependenciesBlock} current current
 			 * @param {BlocksWithNestedBlocks} visited visited dependencies blocks
 			 */
@@ -1240,6 +1254,7 @@ const visitModules = (
 };
 
 /**
+ * Connects chunk groups.
  * @param {Compilation} compilation the compilation
  * @param {BlocksWithNestedBlocks} blocksWithNestedBlocks flag for blocks that have nested blocks
  * @param {BlockConnections} blockConnections connection for blocks

package/lib/cache/AddBuildDependenciesPlugin.js

@@ -11,6 +11,7 @@ const PLUGIN_NAME = "AddBuildDependenciesPlugin";
 
 class AddBuildDependenciesPlugin {
 	/**
+	 * Creates an instance of AddBuildDependenciesPlugin.
 	 * @param {Iterable<string>} buildDependencies list of build dependencies
 	 */
 	constructor(buildDependencies) {
@@ -18,7 +19,7 @@ class AddBuildDependenciesPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/AddManagedPathsPlugin.js

@@ -9,6 +9,7 @@
 
 class AddManagedPathsPlugin {
 	/**
+	 * Creates an instance of AddManagedPathsPlugin.
 	 * @param {Iterable<string | RegExp>} managedPaths list of managed paths
 	 * @param {Iterable<string | RegExp>} immutablePaths list of immutable paths
 	 * @param {Iterable<string | RegExp>} unmanagedPaths list of unmanaged paths
@@ -20,7 +21,7 @@ class AddManagedPathsPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/IdleFileCachePlugin.js

@@ -16,6 +16,7 @@ const PLUGIN_NAME = "IdleFileCachePlugin";
 
 class IdleFileCachePlugin {
 	/**
+	 * Creates an instance of IdleFileCachePlugin.
 	 * @param {PackFileCacheStrategy} strategy cache strategy
 	 * @param {number} idleTimeout timeout
 	 * @param {number} idleTimeoutForInitialStore initial timeout
@@ -34,7 +35,7 @@ class IdleFileCachePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/MemoryCachePlugin.js

@@ -13,7 +13,7 @@ const Cache = require("../Cache");
 
 class MemoryCachePlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/MemoryWithGcCachePlugin.js

@@ -12,6 +12,7 @@ const Cache = require("../Cache");
 /** @typedef {import("../Compiler")} Compiler */
 
 /**
+ * Defines the memory with gc cache plugin options type used by this module.
  * @typedef {object} MemoryWithGcCachePluginOptions
  * @property {number} maxGenerations max generations
  */
@@ -20,6 +21,7 @@ const PLUGIN_NAME = "MemoryWithGcCachePlugin";
 
 class MemoryWithGcCachePlugin {
 	/**
+	 * Creates an instance of MemoryWithGcCachePlugin.
 	 * @param {MemoryWithGcCachePluginOptions} options options
 	 */
 	constructor({ maxGenerations }) {
@@ -27,7 +29,7 @@ class MemoryWithGcCachePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/cache/PackFileCacheStrategy.js

@@ -37,6 +37,7 @@ const {
 
 class PackContainer {
 	/**
+	 * Creates an instance of PackContainer.
 	 * @param {Pack} data stored data
 	 * @param {string} version version identifier
 	 * @param {Snapshot} buildSnapshot snapshot of all build dependencies
@@ -67,6 +68,7 @@ class PackContainer {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write, writeLazy }) {
@@ -80,6 +82,7 @@ class PackContainer {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize({ read }) {
@@ -106,6 +109,7 @@ const MAX_TIME_IN_FRESH_PACK = 1 * 60 * 1000; // 1 min
 
 class PackItemInfo {
 	/**
+	 * Creates an instance of PackItemInfo.
 	 * @param {string} identifier identifier of item
 	 * @param {string | null | undefined} etag etag of item
 	 * @param {Data} value fresh value of item
@@ -126,6 +130,7 @@ class PackItemInfo {
 
 class Pack {
 	/**
+	 * Creates an instance of Pack.
 	 * @param {Logger} logger a logger
 	 * @param {number} maxAge max age of cache items
 	 */
@@ -149,6 +154,7 @@ class Pack {
 	}
 
 	/**
+	 * Adds the provided identifier to the pack.
 	 * @param {string} identifier identifier
 	 */
 	_addRequest(identifier) {
@@ -170,6 +176,7 @@ class Pack {
 	}
 
 	/**
+	 * Returns cached content.
 	 * @param {string} identifier unique name for the resource
 	 * @param {string | null} etag etag of the resource
 	 * @returns {Data} cached content
@@ -193,6 +200,7 @@ class Pack {
 	}
 
 	/**
+	 * Updates value using the provided identifier.
 	 * @param {string} identifier unique name for the resource
 	 * @param {string | null} etag etag of the resource
 	 * @param {Data} data cached content
@@ -244,6 +252,7 @@ class Pack {
 	}
 
 	/**
+	 * Returns new location of data entries.
 	 * @returns {number} new location of data entries
 	 */
 	_findLocation() {
@@ -254,6 +263,7 @@ class Pack {
 	}
 
 	/**
+	 * Gc and update location.
 	 * @private
 	 * @param {Items} items items
 	 * @param {Items} usedItems used items
@@ -604,6 +614,7 @@ class Pack {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write, writeSeparate }) {
@@ -637,6 +648,7 @@ class Pack {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext & { logger: Logger }} context context
 	 */
 	deserialize({ read, logger }) {
@@ -694,6 +706,7 @@ makeSerializable(Pack, "webpack/lib/cache/PackFileCacheStrategy", "Pack");
 
 class PackContentItems {
 	/**
+	 * Creates an instance of PackContentItems.
 	 * @param {Content} map items
 	 */
 	constructor(map) {
@@ -701,6 +714,7 @@ class PackContentItems {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext & { logger: Logger, profile: boolean | undefined }} context context
 	 */
 	serialize({ write, snapshot, rollback, logger, profile }) {
@@ -778,6 +792,7 @@ class PackContentItems {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext & { logger: Logger, profile: boolean | undefined }} context context
 	 */
 	deserialize({ read, logger, profile }) {
@@ -851,6 +866,7 @@ class PackContent {
 	*/
 
 	/**
+	 * Creates an instance of PackContent.
 	 * @param {Items} items keys
 	 * @param {Items} usedItems used keys
 	 * @param {PackContentItems | (() => Promise<PackContentItems>)} dataOrFn sync or async content
@@ -875,6 +891,7 @@ class PackContent {
 	}
 
 	/**
+	 * Returns result.
 	 * @param {string} identifier identifier
 	 * @returns {string | Promise<string>} result
 	 */
@@ -927,6 +944,7 @@ class PackContent {
 	}
 
 	/**
+	 * Returns maybe a promise if lazy.
 	 * @param {string} reason explanation why unpack is necessary
 	 * @returns {void | Promise<void>} maybe a promise if lazy
 	 */
@@ -971,6 +989,7 @@ class PackContent {
 	}
 
 	/**
+	 * Returns the estimated size for the requested source type.
 	 * @returns {number} size of the content or -1 if not known
 	 */
 	getSize() {
@@ -985,6 +1004,7 @@ class PackContent {
 	}
 
 	/**
+	 * Processes the provided identifier.
 	 * @param {string} identifier identifier
 	 */
 	delete(identifier) {
@@ -994,6 +1014,7 @@ class PackContent {
 	}
 
 	/**
+	 * Processes the provided write.
 	 * @param {(lazy: LazyFunction) => (() => PackContentItems | Promise<PackContentItems>)} write write function
 	 * @returns {void}
 	 */
@@ -1086,6 +1107,7 @@ class PackContent {
 }
 
 /**
+ * Allow collecting memory.
  * @param {Buffer} buf buffer
  * @returns {Buffer} buffer that can be collected
  */
@@ -1099,6 +1121,7 @@ const allowCollectingMemory = (buf) => {
 
 class PackFileCacheStrategy {
 	/**
+	 * Creates an instance of PackFileCacheStrategy.
 	 * @param {object} options options
 	 * @param {Compiler} options.compiler the compiler
 	 * @param {IntermediateFileSystem} options.fs the filesystem
@@ -1186,6 +1209,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Returns pack.
 	 * @returns {Promise<Pack>} pack
 	 */
 	_getPack() {
@@ -1196,6 +1220,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Returns the pack.
 	 * @returns {Promise<Pack>} the pack
 	 */
 	_openPack() {
@@ -1362,6 +1387,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Returns promise.
 	 * @param {string} identifier unique name for the resource
 	 * @param {Etag | null} etag etag of the resource
 	 * @param {Data} data cached content
@@ -1376,6 +1402,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Returns promise to the cached content.
 	 * @param {string} identifier unique name for the resource
 	 * @param {Etag | null} etag etag of the resource
 	 * @returns {Promise<Data>} promise to the cached content
@@ -1396,6 +1423,7 @@ class PackFileCacheStrategy {
 	}
 
 	/**
+	 * Stores build dependencies.
 	 * @param {FileSystemDependencies | Iterable<string>} dependencies dependencies to store
 	 */
 	storeBuildDependencies(dependencies) {
@@ -1429,6 +1457,7 @@ class PackFileCacheStrategy {
 					);
 					promise = new Promise(
 						/**
+						 * Handles the callback logic for this hook.
 						 * @param {(value?: undefined) => void} resolve resolve
 						 * @param {(reason?: Error) => void} reject reject
 						 */

package/lib/cache/ResolverCachePlugin.js

@@ -22,6 +22,7 @@ const makeSerializable = require("../util/makeSerializable");
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 
 /**
+ * Defines the sync hook type used by this module.
  * @template T
  * @typedef {import("tapable").SyncHook<T>} SyncHook
  */
@@ -30,6 +31,7 @@ const makeSerializable = require("../util/makeSerializable");
 
 class CacheEntry {
 	/**
+	 * Creates an instance of CacheEntry.
 	 * @param {ResolveRequest} result result
 	 * @param {Snapshot} snapshot snapshot
 	 */
@@ -39,6 +41,7 @@ class CacheEntry {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize({ write }) {
@@ -47,6 +50,7 @@ class CacheEntry {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize({ read }) {
@@ -58,6 +62,7 @@ class CacheEntry {
 makeSerializable(CacheEntry, "webpack/lib/cache/ResolverCachePlugin");
 
 /**
+ * Adds the provided set to the cache entry.
  * @template T
  * @param {Set<T> | LazySet<T>} set set to add items to
  * @param {Set<T> | LazySet<T> | Iterable<T>} otherSet set to add items from
@@ -74,6 +79,7 @@ const addAllToSet = (set, otherSet) => {
 };
 
 /**
+ * Returns stringified version.
  * @template {object} T
  * @param {T} object an object
  * @param {boolean} excludeContext if true, context is not included in string
@@ -98,7 +104,7 @@ const PLUGIN_NAME = "ResolverCachePlugin";
 
 class ResolverCachePlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -135,6 +141,7 @@ class ResolverCachePlugin {
 		/** @typedef {ResolveRequest & { _ResolverCachePluginCacheMiss: true }} ResolveRequestWithCacheMiss */
 
 		/**
+		 * Processes the provided item cache.
 		 * @param {ItemCacheFacade} itemCache cache
 		 * @param {Resolver} resolver the resolver
 		 * @param {ResolveContext} resolveContext context for resolving meta info
@@ -175,6 +182,7 @@ class ResolverCachePlugin {
 					(yieldResult).push(obj);
 			}
 			/**
+			 * Processes the provided key.
 			 * @param {"fileDependencies" | "contextDependencies" | "missingDependencies"} key key
 			 */
 			const propagate = (key) => {
@@ -375,6 +383,7 @@ class ResolverCachePlugin {
 										}
 									};
 							/**
+							 * Process cache result.
 							 * @param {(Error | null)=} err error if any
 							 * @param {(CacheEntry | null)=} cacheEntry cache entry
 							 * @returns {void}

package/lib/cache/getLazyHashedEtag.js

@@ -13,12 +13,14 @@ const createHash = require("../util/createHash");
 /** @typedef {import("../util/Hash").HashFunction} HashFunction */
 
 /**
+ * Represents the lazy hashed etag runtime component.
  * @typedef {object} HashableObject
  * @property {(hash: Hash) => void} updateHash
  */
 
 class LazyHashedEtag {
 	/**
+	 * Creates an instance of LazyHashedEtag.
 	 * @param {HashableObject} obj object with updateHash method
 	 * @param {HashFunction} hashFunction the hash function to use
 	 */
@@ -32,6 +34,7 @@ class LazyHashedEtag {
 	}
 
 	/**
+	 * Returns a string representation.
 	 * @returns {string} hash of object
 	 */
 	toString() {
@@ -53,6 +56,7 @@ const mapStrings = new Map();
 const mapObjects = new WeakMap();
 
 /**
+ * Returns etag.
  * @param {HashableObject} obj object with updateHash method
  * @param {HashFunction=} hashFunction the hash function to use
  * @returns {LazyHashedEtag} etag

package/lib/cache/mergeEtags.js

@@ -9,6 +9,7 @@
 
 class MergedEtag {
 	/**
+	 * Creates an instance of MergedEtag.
 	 * @param {Etag} a first
 	 * @param {Etag} b second
 	 */
@@ -28,6 +29,7 @@ const dualObjectMap = new WeakMap();
 const objectStringMap = new WeakMap();
 
 /**
+ * Merges the provided values into a single result.
  * @param {Etag} a first
  * @param {Etag} b second
  * @returns {string | MergedEtag} result