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

package/lib/ModuleFactory.js

@@ -10,6 +10,7 @@
 /** @typedef {import("./Module")} Module */
 
 /**
+ * Defines the module factory result type used by this module.
  * @typedef {object} ModuleFactoryResult
  * @property {Module=} module the created module or unset if no module was created
  * @property {Set<string>=} fileDependencies
@@ -21,6 +22,7 @@
 /** @typedef {string | null} IssuerLayer */
 
 /**
+ * Defines the module factory create data context info type used by this module.
  * @typedef {object} ModuleFactoryCreateDataContextInfo
  * @property {string} issuer
  * @property {IssuerLayer} issuerLayer
@@ -28,6 +30,7 @@
  */
 
 /**
+ * Defines the module factory create data type used by this module.
  * @typedef {object} ModuleFactoryCreateData
  * @property {ModuleFactoryCreateDataContextInfo} contextInfo
  * @property {ResolveOptions=} resolveOptions
@@ -36,19 +39,21 @@
  */
 
 /**
+ * Represents the module factory runtime component.
  * @typedef {(err?: Error | null, result?: ModuleFactoryResult) => void} ModuleFactoryCallback
  */
 
 class ModuleFactory {
 	/* istanbul ignore next */
 	/**
+	 * Processes the provided data.
 	 * @abstract
 	 * @param {ModuleFactoryCreateData} data data object
 	 * @param {ModuleFactoryCallback} callback callback
 	 * @returns {void}
 	 */
 	create(data, callback) {
-		const AbstractMethodError = require("./AbstractMethodError");
+		const AbstractMethodError = require("./errors/AbstractMethodError");
 
 		throw new AbstractMethodError();
 	}

package/lib/ModuleFilenameHelpers.js

@@ -90,6 +90,7 @@ const getHash =
 	};
 
 /**
+ * Returns the lazy access object.
  * @template T
  * Returns a lazy object. The object is lazy in the sense that the properties are
  * only evaluated when they are accessed. This is only obtained by setting a function as the value for each key.
@@ -118,6 +119,7 @@ const lazyObject = (obj) => {
 
 const SQUARE_BRACKET_TAG_REGEXP = /\[\\*([\w-]+)\\*\]/g;
 /**
+ * Defines the module filename template context type used by this module.
  * @typedef {object} ModuleFilenameTemplateContext
  * @property {string} identifier the identifier of the module
  * @property {string} shortIdentifier the shortened identifier of the module
@@ -135,6 +137,7 @@ const SQUARE_BRACKET_TAG_REGEXP = /\[\\*([\w-]+)\\*\]/g;
 /** @typedef {string | ModuleFilenameTemplateFunction} ModuleFilenameTemplate */
 
 /**
+ * Returns the filename.
  * @param {Module | string} module the module
  * @param {{ namespace?: string, moduleFilenameTemplate?: ModuleFilenameTemplate }} options options
  * @param {{ requestShortener: RequestShortener, chunkGraph: ChunkGraph, hashFunction?: HashFunction }} contextInfo context info
@@ -166,11 +169,14 @@ ModuleFilenameHelpers.createFilename = (
 	let moduleId;
 	/** @type {ReturnStringCallback} */
 	let shortIdentifier;
+	/** @type {ReturnStringCallback} */
+	let resourceIdentifier;
 	if (typeof module === "string") {
 		shortIdentifier =
 			/** @type {ReturnStringCallback} */
 			(memoize(() => requestShortener.shorten(module)));
 		identifier = shortIdentifier;
+		resourceIdentifier = shortIdentifier;
 		moduleId = () => "";
 		absoluteResourcePath = () =>
 			/** @type {string} */ (module.split("!").pop());
@@ -179,6 +185,14 @@ ModuleFilenameHelpers.createFilename = (
 		shortIdentifier = memoize(() =>
 			module.readableIdentifier(requestShortener)
 		);
+		// `[resource]` and `[loaders]` must stay request paths: a subclass's
+		// readable identifier may carry display-only decorations (e.g. CssModule's
+		// `css ` prefix)
+		resourceIdentifier = memoize(() =>
+			module instanceof NormalModule
+				? /** @type {string} */ (requestShortener.shorten(module.userRequest))
+				: module.readableIdentifier(requestShortener)
+		);
 		identifier =
 			/** @type {ReturnStringCallback} */
 			(memoize(() => requestShortener.shorten(module.identifier())));
@@ -193,9 +207,9 @@ ModuleFilenameHelpers.createFilename = (
 	}
 	const resource =
 		/** @type {ReturnStringCallback} */
-		(memoize(() => shortIdentifier().split("!").pop()));
+		(memoize(() => resourceIdentifier().split("!").pop()));
 
-	const loaders = getBefore(shortIdentifier, "!");
+	const loaders = getBefore(resourceIdentifier, "!");
 	const allLoaders = getBefore(identifier, "!");
 	const query = getAfter(resource, "?");
 	const resourcePath = () => {
@@ -324,9 +338,9 @@ ModuleFilenameHelpers.replaceDuplicates = (array, fn, comparator) => {
  * ```js
  * ModuleFilenameHelpers.matchPart("foo.js", "foo"); // true
  * ModuleFilenameHelpers.matchPart("foo.js", "foo.js"); // true
- * ModuleFilenameHelpers.matchPart("foo.js", "foo."); // false
+ * ModuleFilenameHelpers.matchPart("foo.js", "foo."); // true
  * ModuleFilenameHelpers.matchPart("foo.js", "foo*"); // false
- * ModuleFilenameHelpers.matchPart("foo.js", "foo.*"); // true
+ * ModuleFilenameHelpers.matchPart("foo.js", "foo.*"); // false
  * ModuleFilenameHelpers.matchPart("foo.js", /^foo/); // true
  * ModuleFilenameHelpers.matchPart("foo.js", [/^foo/, "bar"]); // true
  * ModuleFilenameHelpers.matchPart("foo.js", [/^foo/, "bar"]); // true

package/lib/ModuleGraph.js

@@ -28,6 +28,7 @@ const { sortWithSourceOrder } = require("./util/comparators");
 /** @typedef {import("./util/comparators").DependencySourceOrder} DependencySourceOrder */
 
 /**
+ * Defines the optimization bailout function callback.
  * @callback OptimizationBailoutFunction
  * @param {RequestShortener} requestShortener
  * @returns {string}
@@ -37,6 +38,7 @@ const { sortWithSourceOrder } = require("./util/comparators");
 const EMPTY_SET = new Set();
 
 /**
+ * Gets connections by key.
  * @template {Module | null | undefined} T
  * @param {SortableSet<ModuleGraphConnection>} set input
  * @param {(connection: ModuleGraphConnection) => T} getKey function to extract key from connection
@@ -71,6 +73,7 @@ const getConnectionsByKey = (set, getKey) => {
 };
 
 /**
+ * Gets connections by origin module.
  * @param {SortableSet<ModuleGraphConnection>} set input
  * @returns {ReadonlyMap<Module | undefined | null, ReadonlyArray<ModuleGraphConnection>>} mapped by origin module
  */
@@ -78,6 +81,7 @@ const getConnectionsByOriginModule = (set) =>
 	getConnectionsByKey(set, (connection) => connection.originModule);
 
 /**
+ * Gets connections by module.
  * @param {SortableSet<ModuleGraphConnection>} set input
  * @returns {ReadonlyMap<Module | undefined, ReadonlyArray<ModuleGraphConnection>>} mapped by module
  */
@@ -125,6 +129,7 @@ class ModuleGraphModule {
 /** @typedef {import("./dependencies/HarmonyExportImportedSpecifierDependency").idsSymbol} HarmonyExportImportedSpecifierDependencyIDsSymbol */
 
 /**
+ * Defines the known meta type used by this module.
  * @typedef {object} KnownMeta
  * @property {Map<Module, string>=} importVarMap
  * @property {Map<Module, string>=} deferredImportVarMap
@@ -180,6 +185,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Get module graph module.
 	 * @param {Module} module the module
 	 * @returns {ModuleGraphModule} the internal module
 	 */
@@ -193,6 +199,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Updates parents using the provided dependency.
 	 * @param {Dependency} dependency the dependency
 	 * @param {DependenciesBlock} block parent block
 	 * @param {Module} module parent module
@@ -206,6 +213,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Sets parent dependencies block index.
 	 * @param {Dependency} dependency the dependency
 	 * @param {number} index the index
 	 * @returns {void}
@@ -215,6 +223,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets parent module.
 	 * @param {Dependency} dependency the dependency
 	 * @returns {Module | undefined} parent module
 	 */
@@ -223,6 +232,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns parent block.
 	 * @param {Dependency} dependency the dependency
 	 * @returns {DependenciesBlock | undefined} parent block
 	 */
@@ -231,6 +241,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets parent block index.
 	 * @param {Dependency} dependency the dependency
 	 * @returns {number} index
 	 */
@@ -239,6 +250,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Sets resolved module.
 	 * @param {Module | null} originModule the referencing module
 	 * @param {Dependency} dependency the referencing dependency
 	 * @param {Module} module the referenced module
@@ -250,7 +262,8 @@ class ModuleGraph {
 			dependency,
 			module,
 			undefined,
-			dependency.weak,
+			// weak is defined on ModuleDependency; undefined for other dependency kinds
+			/** @type {{ weak?: boolean }} */ (dependency).weak,
 			dependency.getCondition(this)
 		);
 		const connections = this._getModuleGraphModule(module).incomingConnections;
@@ -271,6 +284,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Updates module using the provided dependency.
 	 * @param {Dependency} dependency the referencing dependency
 	 * @param {Module} module the referenced module
 	 * @returns {void}
@@ -294,6 +308,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Updates parent using the provided dependency.
 	 * @param {Dependency} dependency the need update dependency
 	 * @param {ModuleGraphConnection=} connection the target connection
 	 * @param {Module=} parentModule the parent module
@@ -342,6 +357,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Finish update parent.
 	 * @returns {void}
 	 */
 	finishUpdateParent() {
@@ -361,6 +377,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Removes connection.
 	 * @param {Dependency} dependency the referencing dependency
 	 * @returns {void}
 	 */
@@ -379,6 +396,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Adds the provided dependency to the module graph.
 	 * @param {Dependency} dependency the referencing dependency
 	 * @param {string} explanation an explanation
 	 * @returns {void}
@@ -391,6 +409,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Clones module attributes.
 	 * @param {Module} sourceModule the source module
 	 * @param {Module} targetModule the target module
 	 * @returns {void}
@@ -406,6 +425,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Removes module attributes.
 	 * @param {Module} module the module
 	 * @returns {void}
 	 */
@@ -418,6 +438,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Removes all module attributes.
 	 * @returns {void}
 	 */
 	removeAllModuleAttributes() {
@@ -430,6 +451,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Move module connections.
 	 * @param {Module} oldModule the old referencing module
 	 * @param {Module} newModule the new referencing module
 	 * @param {FilterConnection} filterConnection filter predicate for replacement
@@ -467,6 +489,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Copies outgoing module connections.
 	 * @param {Module} oldModule the old referencing module
 	 * @param {Module} newModule the new referencing module
 	 * @param {FilterConnection} filterConnection filter predicate for replacement
@@ -498,6 +521,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Adds the provided module to the module graph.
 	 * @param {Module} module the referenced module
 	 * @param {string} explanation an explanation why it's referenced
 	 * @returns {void}
@@ -508,6 +532,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets resolved module.
 	 * @param {Dependency} dependency the dependency to look for a referenced module
 	 * @returns {Module | null} the referenced module
 	 */
@@ -517,6 +542,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns the connection.
 	 * @param {Dependency} dependency the dependency to look for a referenced module
 	 * @returns {ModuleGraphConnection | undefined} the connection
 	 */
@@ -554,6 +580,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns the referenced module.
 	 * @param {Dependency} dependency the dependency to look for a referenced module
 	 * @returns {Module | null} the referenced module
 	 */
@@ -563,6 +590,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns the referencing module.
 	 * @param {Dependency} dependency the dependency to look for a referencing module
 	 * @returns {Module | null} the referencing module
 	 */
@@ -572,6 +600,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets resolved origin.
 	 * @param {Dependency} dependency the dependency to look for a referencing module
 	 * @returns {Module | null} the original referencing module
 	 */
@@ -581,6 +610,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets incoming connections.
 	 * @param {Module} module the module
 	 * @returns {Iterable<ModuleGraphConnection>} reasons why a module is included
 	 */
@@ -590,6 +620,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets outgoing connections.
 	 * @param {Module} module the module
 	 * @returns {Iterable<ModuleGraphConnection>} list of outgoing connections
 	 */
@@ -599,6 +630,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets incoming connections by origin module.
 	 * @param {Module} module the module
 	 * @returns {ReadonlyMap<Module | undefined | null, ReadonlyArray<ModuleGraphConnection>>} reasons why a module is included, in a map by source module
 	 */
@@ -608,6 +640,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets outgoing connections by module.
 	 * @param {Module} module the module
 	 * @returns {ReadonlyMap<Module | undefined, ReadonlyArray<ModuleGraphConnection>> | undefined} connections to modules, in a map by module
 	 */
@@ -619,6 +652,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns the module profile.
 	 * @param {Module} module the module
 	 * @returns {ModuleProfile | undefined} the module profile
 	 */
@@ -628,6 +662,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Updates profile using the provided module.
 	 * @param {Module} module the module
 	 * @param {ModuleProfile | undefined} profile the module profile
 	 * @returns {void}
@@ -638,6 +673,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns the issuer module.
 	 * @param {Module} module the module
 	 * @returns {Issuer} the issuer module
 	 */
@@ -647,6 +683,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Updates issuer using the provided module.
 	 * @param {Module} module the module
 	 * @param {Module | null} issuer the issuer module
 	 * @returns {void}
@@ -657,6 +694,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Sets issuer if unset.
 	 * @param {Module} module the module
 	 * @param {Module | null} issuer the issuer module
 	 * @returns {void}
@@ -667,6 +705,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets optimization bailout.
 	 * @param {Module} module the module
 	 * @returns {OptimizationBailouts} optimization bailouts
 	 */
@@ -676,6 +715,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets provided exports.
 	 * @param {Module} module the module
 	 * @returns {null | true | ExportInfoName[]} the provided exports
 	 */
@@ -685,6 +725,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Checks whether this module graph is export provided.
 	 * @param {Module} module the module
 	 * @param {ExportInfoName | ExportInfoName[]} exportName a name of an export
 	 * @returns {boolean | null} true, if the export is provided by the module.
@@ -698,6 +739,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns info about the exports.
 	 * @param {Module} module the module
 	 * @returns {ExportsInfo} info about the exports
 	 */
@@ -707,6 +749,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns info about the export.
 	 * @param {Module} module the module
 	 * @param {string} exportName the export
 	 * @returns {ExportInfo} info about the export
@@ -717,6 +760,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets read only export info.
 	 * @param {Module} module the module
 	 * @param {string} exportName the export
 	 * @returns {ExportInfo} info about the export (do not modify)
@@ -727,6 +771,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns the used exports.
 	 * @param {Module} module the module
 	 * @param {RuntimeSpec} runtime the runtime
 	 * @returns {false | true | SortableSet<string> | null} the used exports
@@ -742,6 +787,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets pre order index.
 	 * @param {Module} module the module
 	 * @returns {number | null} the index of the module
 	 */
@@ -751,6 +797,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets post order index.
 	 * @param {Module} module the module
 	 * @returns {number | null} the index of the module
 	 */
@@ -760,6 +807,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Sets pre order index.
 	 * @param {Module} module the module
 	 * @param {number} index the index of the module
 	 * @returns {void}
@@ -770,6 +818,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Sets pre order index if unset.
 	 * @param {Module} module the module
 	 * @param {number} index the index of the module
 	 * @returns {boolean} true, if the index was set
@@ -784,6 +833,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Sets post order index.
 	 * @param {Module} module the module
 	 * @param {number} index the index of the module
 	 * @returns {void}
@@ -794,6 +844,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Sets post order index if unset.
 	 * @param {Module} module the module
 	 * @param {number} index the index of the module
 	 * @returns {boolean} true, if the index was set
@@ -808,6 +859,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns the depth of the module.
 	 * @param {Module} module the module
 	 * @returns {number | null} the depth of the module
 	 */
@@ -817,6 +869,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Updates depth using the provided module.
 	 * @param {Module} module the module
 	 * @param {number} depth the depth of the module
 	 * @returns {void}
@@ -827,6 +880,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Sets depth if lower.
 	 * @param {Module} module the module
 	 * @param {number} depth the depth of the module
 	 * @returns {boolean} true, if the depth was set
@@ -841,6 +895,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Checks whether this module graph is async.
 	 * @param {Module} module the module
 	 * @returns {boolean} true, if the module is async
 	 */
@@ -850,6 +905,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Checks whether this module graph is deferred.
 	 * @param {Module} module the module
 	 * @returns {boolean} true, if the module is used as a deferred module at least once
 	 */
@@ -869,6 +925,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Updates async using the provided module.
 	 * @param {Module} module the module
 	 * @returns {void}
 	 */
@@ -878,6 +935,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns metadata.
 	 * @param {MetaKey} thing any thing
 	 * @returns {Meta} metadata
 	 */
@@ -891,6 +949,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Gets meta if existing.
 	 * @param {MetaKey} thing any thing
 	 * @returns {Meta | undefined} metadata
 	 */
@@ -899,6 +958,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Processes the provided cache stage.
 	 * @param {string=} cacheStage a persistent stage name for caching
 	 */
 	freeze(cacheStage) {
@@ -912,6 +972,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Returns computed value or cached.
 	 * @template {EXPECTED_ANY[]} T
 	 * @template R
 	 * @param {(moduleGraph: ModuleGraph, ...args: T) => R} fn computer
@@ -920,10 +981,11 @@ class ModuleGraph {
 	 */
 	cached(fn, ...args) {
 		if (this._cache === undefined) return fn(this, ...args);
-		return this._cache.provide(fn, ...args, () => fn(this, ...args));
+		return this._cache.cachedProvide(fn, this, args);
 	}
 
 	/**
+	 * Sets module mem caches.
 	 * @param {ModuleMemCaches} moduleMemCaches mem caches for modules for better caching
 	 */
 	setModuleMemCaches(moduleMemCaches) {
@@ -931,6 +993,7 @@ class ModuleGraph {
 	}
 
 	/**
+	 * Dependency cache provide.
 	 * @template {Dependency} D
 	 * @template {EXPECTED_ANY[]} ARGS
 	 * @template R
@@ -961,6 +1024,7 @@ class ModuleGraph {
 
 	// TODO remove in webpack 6
 	/**
+	 * Gets module graph for module.
 	 * @deprecated
 	 * @param {Module} module the module
 	 * @param {string} deprecateMessage message for the deprecation message
@@ -972,6 +1036,7 @@ class ModuleGraph {
 		if (fn) return fn(module);
 		const newFn = util.deprecate(
 			/**
+			 * Handles the callback logic for this hook.
 			 * @param {Module} module the module
 			 * @returns {ModuleGraph} the module graph
 			 */
@@ -995,6 +1060,7 @@ class ModuleGraph {
 
 	// TODO remove in webpack 6
 	/**
+	 * Sets module graph for module.
 	 * @deprecated
 	 * @param {Module} module the module
 	 * @param {ModuleGraph} moduleGraph the module graph
@@ -1006,6 +1072,7 @@ class ModuleGraph {
 
 	// TODO remove in webpack 6
 	/**
+	 * Clear module graph for module.
 	 * @deprecated
 	 * @param {Module} module the module
 	 * @returns {void}

package/lib/ModuleGraphConnection.js

@@ -23,6 +23,7 @@ const CIRCULAR_CONNECTION = Symbol("circular connection");
 /** @typedef {boolean | typeof TRANSITIVE_ONLY | typeof CIRCULAR_CONNECTION} ConnectionState */
 
 /**
+ * Adds connection states.
  * @param {ConnectionState} a first
  * @param {ConnectionState} b second
  * @returns {ConnectionState} merged
@@ -37,6 +38,7 @@ const addConnectionStates = (a, b) => {
 };
 
 /**
+ * Intersect connection states.
  * @param {ConnectionState} a first
  * @param {ConnectionState} b second
  * @returns {ConnectionState} intersected
@@ -52,6 +54,7 @@ const intersectConnectionStates = (a, b) => {
 
 class ModuleGraphConnection {
 	/**
+	 * Creates an instance of ModuleGraphConnection.
 	 * @param {Module | null} originModule the referencing module
 	 * @param {Dependency | null} dependency the referencing dependency
 	 * @param {Module} module the referenced module
@@ -111,6 +114,7 @@ class ModuleGraphConnection {
 	}
 
 	/**
+	 * Adds the provided condition to the module graph connection.
 	 * @param {GetConditionFn} condition condition for the connection
 	 * @returns {void}
 	 */
@@ -129,6 +133,7 @@ class ModuleGraphConnection {
 	}
 
 	/**
+	 * Adds the provided explanation to the module graph connection.
 	 * @param {string} explanation the explanation to add
 	 * @returns {void}
 	 */
@@ -145,6 +150,7 @@ class ModuleGraphConnection {
 	}
 
 	/**
+	 * Checks whether this module graph connection is active.
 	 * @param {RuntimeSpec} runtime the runtime
 	 * @returns {boolean} true, if the connection is active
 	 */
@@ -157,6 +163,7 @@ class ModuleGraphConnection {
 	}
 
 	/**
+	 * Checks whether this module graph connection is target active.
 	 * @param {RuntimeSpec} runtime the runtime
 	 * @returns {boolean} true, if the connection is active
 	 */
@@ -168,6 +175,7 @@ class ModuleGraphConnection {
 	}
 
 	/**
+	 * Returns true: fully active, false: inactive, TRANSITIVE: direct module inactive, but transitive connection maybe active.
 	 * @param {RuntimeSpec} runtime the runtime
 	 * @returns {ConnectionState} true: fully active, false: inactive, TRANSITIVE: direct module inactive, but transitive connection maybe active
 	 */
@@ -177,6 +185,7 @@ class ModuleGraphConnection {
 	}
 
 	/**
+	 * Updates active using the provided value.
 	 * @param {boolean} value active or not
 	 * @returns {void}
 	 */