webpack 5.106.1 → 5.107.0

package/lib/dependencies/CssIcssImportDependency.js

@@ -5,7 +5,8 @@
 
 "use strict";
 
-const WebpackError = require("../WebpackError");
+const WebpackError = require("../errors/WebpackError");
+const { cssExportConvention } = require("../util/conventions");
 const makeSerializable = require("../util/makeSerializable");
 const CssImportDependency = require("./CssImportDependency");
 
@@ -13,7 +14,8 @@ const CssImportDependency = require("./CssImportDependency");
 /** @typedef {import("../Dependency")} Dependency */
 /** @typedef {import("../DependencyTemplate").CssDependencyTemplateContext} DependencyTemplateContext */
 /** @typedef {import("../Module")} Module */
-/** @typedef {import("../CssModule")} CssModule */
+/** @typedef {import("../css/CssGenerator")} CssGenerator */
+/** @typedef {import("../css/CssModule")} CssModule */
 /** @typedef {import("../ModuleGraph")} ModuleGraph */
 /** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
 /** @typedef {import("../javascript/JavascriptParser").Range} Range */
@@ -39,6 +41,26 @@ class CssIcssImportDependency extends CssImportDependency {
 		super(request, range, mode);
 		this.importName = importName;
 		this.localName = localName;
+		/** @type {undefined | string[]} */
+		this._importNameConventionNames = undefined;
+	}
+
+	/**
+	 * Memoized `cssExportConvention(this.importName, convention)`. The target
+	 * module is fixed for a given dep, so its `exportsConvention` is fixed,
+	 * so the convention-derived aliases of `importName` can be cached on the dep.
+	 * @param {CssGeneratorExportsConvention} convention convention from the target module's generator
+	 * @returns {string[]} convention results
+	 */
+	getImportNameConventionNames(convention) {
+		if (this._importNameConventionNames) {
+			return this._importNameConventionNames;
+		}
+		this._importNameConventionNames = cssExportConvention(
+			this.importName,
+			convention
+		);
+		return this._importNameConventionNames;
 	}
 
 	get type() {
@@ -61,17 +83,37 @@ class CssIcssImportDependency extends CssImportDependency {
 	}
 
 	/**
-	 * Returns warnings
+	 * Returns warnings.
 	 * @param {ModuleGraph} moduleGraph module graph
 	 * @returns {WebpackError[] | null | undefined} warnings
 	 */
 	getWarnings(moduleGraph) {
-		const module = moduleGraph.getModule(this);
+		const module = /** @type {CssModule | undefined} */ (
+			moduleGraph.getModule(this)
+		);
+
+		if (!module) return null;
+
+		// The target module stores exports under the names produced by its
+		// `exportsConvention`, so a raw `isExportProvided(this.importName)`
+		// would false-positive against `camel-case-only` / `dashes-only` (and
+		// any custom function that drops the original spelling). Expand
+		// `importName` through the *target* module's convention and accept
+		// if any alias is provided.
+		const generator =
+			/** @type {CssGenerator | undefined} */
+			(module.generator);
+		const convention =
+			generator &&
+			/** @type {CssGeneratorExportsConvention | undefined} */
+			(generator.options && generator.options.exportsConvention);
+		const exportsInfo = moduleGraph.getExportsInfo(module);
+		const names = convention
+			? this.getImportNameConventionNames(convention)
+			: [this.importName];
+		const isProvided = names.some((name) => exportsInfo.isExportProvided(name));
 
-		if (
-			module &&
-			!moduleGraph.getExportsInfo(module).isExportProvided(this.importName)
-		) {
+		if (!isProvided) {
 			const error = new WebpackError(
 				`Referenced name "${this.importName}" in "${this.userRequest}" not found`
 			);
@@ -84,6 +126,7 @@ class CssIcssImportDependency extends CssImportDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -94,6 +137,7 @@ class CssIcssImportDependency extends CssImportDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -108,6 +152,7 @@ CssIcssImportDependency.Template = class CssIcssImportDependencyTemplate extends
 	CssImportDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object

package/lib/dependencies/CssIcssSymbolDependency.js

@@ -25,17 +25,20 @@ const NullDependency = require("./NullDependency");
 
 class CssIcssSymbolDependency extends NullDependency {
 	/**
+	 * Creates an instance of CssIcssSymbolDependency.
 	 * @param {string} localName local name
 	 * @param {Range} range range
 	 * @param {string=} value value when it was defined in this module
 	 * @param {string=} importName import name when it was imported from other module
+	 * @param {string=} request request of the `@value` import that was active when this reference was parsed — used to disambiguate when the same local name is imported from multiple modules
 	 */
-	constructor(localName, range, value, importName) {
+	constructor(localName, range, value, importName, request) {
 		super();
 		this.localName = localName;
 		this.range = range;
 		this.value = value;
 		this.importName = importName;
+		this.request = request;
 		/** @type {undefined | string} */
 		this._hashUpdate = undefined;
 	}
@@ -45,19 +48,23 @@ class CssIcssSymbolDependency extends NullDependency {
 	}
 
 	/**
-	 * Update the hash
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash hash to be updated
 	 * @param {UpdateHashContext} context context
 	 * @returns {void}
 	 */
 	updateHash(hash, context) {
 		if (this._hashUpdate === undefined) {
-			this._hashUpdate = `${this.range}${this.localName}${this.value || this.importName}`;
+			// Concatenate with explicit field separators so adjacent fields
+			// can't alias each other (e.g. range `[1,11]` + localName `"foo"`
+			// vs range `[1,1]` + localName `"1foo"`).
+			this._hashUpdate = `range|${JSON.stringify(this.range)}|localName|${this.localName}|value|${this.value || ""}|importName|${this.importName || ""}|request|${this.request || ""}`;
 		}
 		hash.update(this._hashUpdate);
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -66,10 +73,12 @@ class CssIcssSymbolDependency extends NullDependency {
 		write(this.range);
 		write(this.value);
 		write(this.importName);
+		write(this.request);
 		super.serialize(context);
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -78,6 +87,7 @@ class CssIcssSymbolDependency extends NullDependency {
 		this.range = read();
 		this.value = read();
 		this.importName = read();
+		this.request = read();
 		super.deserialize(context);
 	}
 }
@@ -86,6 +96,7 @@ CssIcssSymbolDependency.Template = class CssIcssSymbolDependencyTemplate extends
 	NullDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object
@@ -99,7 +110,8 @@ CssIcssSymbolDependency.Template = class CssIcssSymbolDependencyTemplate extends
 				? CssIcssExportDependency.Template.resolve(
 						dep.localName,
 						dep.importName,
-						templateContext
+						templateContext,
+						dep.request
 					)
 				: dep.value;
 

package/lib/dependencies/CssImportDependency.js

@@ -44,6 +44,15 @@ class CssImportDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Returns true if this dependency can be concatenated
+	 * @returns {boolean} true if this dependency can be concatenated
+	 */
+	canConcatenate() {
+		return true;
+	}
+
+	/**
+	 * Returns an identifier to merge equal requests.
 	 * @returns {string | null} an identifier to merge equal requests
 	 */
 	getResourceIdentifier() {
@@ -69,6 +78,7 @@ class CssImportDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -82,6 +92,7 @@ class CssImportDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -99,6 +110,7 @@ CssImportDependency.Template = class CssImportDependencyTemplate extends (
 	ModuleDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object

package/lib/dependencies/CssUrlDependency.js

@@ -12,14 +12,17 @@ const ModuleDependency = require("./ModuleDependency");
 
 /** @typedef {import("webpack-sources").ReplaceSource} ReplaceSource */
 /** @typedef {import("../CodeGenerationResults")} CodeGenerationResults */
+/** @typedef {import("../Dependency").UpdateHashContext} UpdateHashContext */
 /** @typedef {import("../Dependency")} Dependency */
 /** @typedef {import("../DependencyTemplate").CssDependencyTemplateContext} DependencyTemplateContext */
 /** @typedef {import("../Module")} Module */
+/** @typedef {import("../Module").BuildInfo} BuildInfo */
 /** @typedef {import("../Module").CodeGenerationResult} CodeGenerationResult */
 /** @typedef {import("../Module").CodeGenerationResultData} CodeGenerationResultData */
 /** @typedef {import("../javascript/JavascriptParser").Range} Range */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+/** @typedef {import("../util/Hash")} Hash */
 /** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
 
 const getIgnoredRawDataUrlModule = memoize(
@@ -28,6 +31,7 @@ const getIgnoredRawDataUrlModule = memoize(
 
 class CssUrlDependency extends ModuleDependency {
 	/**
+	 * Creates an instance of CssUrlDependency.
 	 * @param {string} request request
 	 * @param {Range} range range of the argument
 	 * @param {"string" | "url" | "src"} urlType dependency type e.g. url() or string
@@ -47,6 +51,7 @@ class CssUrlDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Creates an ignored module.
 	 * @param {string} context context directory
 	 * @returns {Module} ignored module
 	 */
@@ -55,6 +60,28 @@ class CssUrlDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
+	 * @param {Hash} hash hash to be updated
+	 * @param {UpdateHashContext} context context
+	 * @returns {void}
+	 */
+	updateHash(hash, context) {
+		// The dependency template substitutes the referenced asset's hashed
+		// filename into the rendered CSS at code-generation time. Folding the
+		// asset module's content hash into the dependency hash ensures the
+		// CSS module's hash invalidates — and the CSS chunk's contenthash
+		// updates — whenever the referenced asset's content changes.
+		const { chunkGraph } = context;
+		const module = chunkGraph.moduleGraph.getModule(this);
+		if (!module) return;
+		const buildInfo = /** @type {BuildInfo | undefined} */ (module.buildInfo);
+		if (buildInfo && buildInfo.hash) {
+			hash.update(/** @type {string} */ (buildInfo.hash));
+		}
+	}
+
+	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -64,6 +91,7 @@ class CssUrlDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -74,6 +102,7 @@ class CssUrlDependency extends ModuleDependency {
 }
 
 /**
+ * Returns string in quotes if needed.
  * @param {string} str string
  * @returns {string} string in quotes if needed
  */
@@ -111,6 +140,7 @@ CssUrlDependency.Template = class CssUrlDependencyTemplate extends (
 	ModuleDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object
@@ -163,6 +193,7 @@ CssUrlDependency.Template = class CssUrlDependencyTemplate extends (
 	}
 
 	/**
+	 * Returns the url of the asset.
 	 * @param {object} options options object
 	 * @param {Module} options.module the module
 	 * @param {RuntimeSpec=} options.runtime runtime
@@ -185,5 +216,6 @@ CssUrlDependency.Template = class CssUrlDependencyTemplate extends (
 makeSerializable(CssUrlDependency, "webpack/lib/dependencies/CssUrlDependency");
 
 CssUrlDependency.PUBLIC_PATH_AUTO = "__WEBPACK_CSS_PUBLIC_PATH_AUTO__";
+CssUrlDependency.PUBLIC_PATH_FULL_HASH = "__WEBPACK_CSS_PUBLIC_PATH_FULL_HASH_";
 
 module.exports = CssUrlDependency;

package/lib/dependencies/DelegatedSourceDependency.js

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

package/lib/dependencies/DllEntryDependency.js

@@ -14,6 +14,7 @@ const makeSerializable = require("../util/makeSerializable");
 
 class DllEntryDependency extends Dependency {
 	/**
+	 * Creates an instance of DllEntryDependency.
 	 * @param {EntryDependency[]} dependencies dependencies
 	 * @param {string} name name
 	 */
@@ -29,6 +30,7 @@ class DllEntryDependency extends Dependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -41,6 +43,7 @@ class DllEntryDependency extends Dependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/dependencies/DynamicExports.js

@@ -12,6 +12,7 @@
 const parserStateExportsState = new WeakMap();
 
 /**
+ * Processes the provided parser state.
  * @param {JavascriptParserState} parserState parser state
  * @returns {void}
  */
@@ -26,6 +27,7 @@ module.exports.bailout = (parserState) => {
 };
 
 /**
+ * Processes the provided parser state.
  * @param {JavascriptParserState} parserState parser state
  * @returns {void}
  */
@@ -41,6 +43,7 @@ module.exports.enable = (parserState) => {
 };
 
 /**
+ * Returns true, when enabled.
  * @param {JavascriptParserState} parserState parser state
  * @returns {boolean} true, when enabled
  */
@@ -50,6 +53,7 @@ module.exports.isEnabled = (parserState) => {
 };
 
 /**
+ * Processes the provided parser state.
  * @param {JavascriptParserState} parserState parser state
  * @returns {void}
  */
@@ -61,6 +65,7 @@ module.exports.setDynamic = (parserState) => {
 };
 
 /**
+ * Processes the provided parser state.
  * @param {JavascriptParserState} parserState parser state
  * @returns {void}
  */

package/lib/dependencies/EntryDependency.js

@@ -10,6 +10,7 @@ const ModuleDependency = require("./ModuleDependency");
 
 class EntryDependency extends ModuleDependency {
 	/**
+	 * Creates an instance of EntryDependency.
 	 * @param {string} request request path for entry
 	 */
 	constructor(request) {

package/lib/dependencies/ExportsInfoDependency.js

@@ -21,11 +21,13 @@ const NullDependency = require("./NullDependency");
 /** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
 
 /**
+ * Defines the sortable set type used by this module.
  * @template T
  * @typedef {import("../util/SortableSet")<T>} SortableSet
  */
 
 /**
+ * Returns value of the property.
  * @param {ModuleGraph} moduleGraph the module graph
  * @param {Module} module the module
  * @param {ExportInfoName[] | null} exportName_ name of the export if any
@@ -89,6 +91,7 @@ const getProperty = (moduleGraph, module, exportName_, property, runtime) => {
 
 class ExportsInfoDependency extends NullDependency {
 	/**
+	 * Creates an instance of ExportsInfoDependency.
 	 * @param {Range} range range
 	 * @param {ExportInfoName[] | null} exportName export name
 	 * @param {string | null} property property
@@ -101,6 +104,7 @@ class ExportsInfoDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -112,6 +116,7 @@ class ExportsInfoDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 * @returns {ExportsInfoDependency} ExportsInfoDependency
 	 */
@@ -135,6 +140,7 @@ ExportsInfoDependency.Template = class ExportsInfoDependencyTemplate extends (
 	NullDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object

package/lib/dependencies/ExternalModuleDependency.js

@@ -19,6 +19,7 @@ const ExternalModuleInitFragment = require("./ExternalModuleInitFragment");
 
 class ExternalModuleDependency extends CachedConstDependency {
 	/**
+	 * Creates an instance of ExternalModuleDependency.
 	 * @param {string} module module
 	 * @param {ArrayImportSpecifiers} importSpecifiers import specifiers
 	 * @param {string | undefined} defaultImport default import
@@ -44,6 +45,7 @@ class ExternalModuleDependency extends CachedConstDependency {
 	}
 
 	/**
+	 * Create hash update.
 	 * @returns {string} hash update
 	 */
 	_createHashUpdate() {
@@ -53,6 +55,7 @@ class ExternalModuleDependency extends CachedConstDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -64,6 +67,7 @@ class ExternalModuleDependency extends CachedConstDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -84,6 +88,7 @@ ExternalModuleDependency.Template = class ExternalModuleDependencyTemplate exten
 	CachedConstDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object

package/lib/dependencies/ExternalModuleInitFragment.js

@@ -75,6 +75,7 @@ class ExternalModuleInitFragment 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
 	 */
@@ -107,6 +108,7 @@ class ExternalModuleInitFragment extends InitFragment {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -118,6 +120,7 @@ class ExternalModuleInitFragment extends InitFragment {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/dependencies/ExternalModuleInitFragmentDependency.js

@@ -20,6 +20,7 @@ const NullDependency = require("./NullDependency");
 
 class ExternalModuleInitFragmentDependency extends NullDependency {
 	/**
+	 * Creates an instance of ExternalModuleInitFragmentDependency.
 	 * @param {string} module module
 	 * @param {ArrayImportSpecifiers} importSpecifiers import specifiers
 	 * @param {string | undefined} defaultImport default import
@@ -32,6 +33,7 @@ class ExternalModuleInitFragmentDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -42,6 +44,7 @@ class ExternalModuleInitFragmentDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -61,6 +64,7 @@ ExternalModuleInitFragmentDependency.Template = class ExternalModuleConstDepende
 	DependencyTemplate
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object

package/lib/dependencies/HarmonyAcceptDependency.js

@@ -24,6 +24,7 @@ const NullDependency = require("./NullDependency");
 
 class HarmonyAcceptDependency extends NullDependency {
 	/**
+	 * Creates an instance of HarmonyAcceptDependency.
 	 * @param {Range} range expression range
 	 * @param {HarmonyAcceptImportDependency[]} dependencies import dependencies
 	 * @param {boolean} hasCallback true, if the range wraps an existing callback
@@ -40,6 +41,7 @@ class HarmonyAcceptDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -51,6 +53,7 @@ class HarmonyAcceptDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -71,6 +74,7 @@ HarmonyAcceptDependency.Template = class HarmonyAcceptDependencyTemplate extends
 	NullDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object
@@ -88,6 +92,7 @@ HarmonyAcceptDependency.Template = class HarmonyAcceptDependencyTemplate extends
 		} = templateContext;
 
 		/**
+		 * Gets dependency module id.
 		 * @param {Dependency} dependency the dependency to get module id for
 		 * @returns {ModuleId | null} the module id or null if not found
 		 */
@@ -97,6 +102,7 @@ HarmonyAcceptDependency.Template = class HarmonyAcceptDependencyTemplate extends
 			);
 
 		/**
+		 * Checks whether this harmony accept dependency is related harmony import dependency.
 		 * @param {Dependency} a the first dependency
 		 * @param {Dependency} b the second dependency
 		 * @returns {boolean} true if the dependencies are related

package/lib/dependencies/HarmonyAcceptImportDependency.js

@@ -12,6 +12,7 @@ const NullDependency = require("./NullDependency");
 
 class HarmonyAcceptImportDependency extends HarmonyImportDependency {
 	/**
+	 * Creates an instance of HarmonyAcceptImportDependency.
 	 * @param {string} request the request string
 	 */
 	constructor(request) {

package/lib/dependencies/HarmonyCompatibilityDependency.js

@@ -31,6 +31,7 @@ HarmonyCompatibilityDependency.Template = class HarmonyExportDependencyTemplate
 	NullDependency.Template
 ) {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Dependency} dependency the dependency for which the template should be applied
 	 * @param {ReplaceSource} source the current replace source which can be modified
 	 * @param {DependencyTemplateContext} templateContext the context object

package/lib/dependencies/HarmonyDetectionParserPlugin.js

@@ -5,8 +5,8 @@
 
 "use strict";
 
-const EnvironmentNotSupportAsyncWarning = require("../EnvironmentNotSupportAsyncWarning");
 const { JAVASCRIPT_MODULE_TYPE_ESM } = require("../ModuleTypeConstants");
+const EnvironmentNotSupportAsyncWarning = require("../errors/EnvironmentNotSupportAsyncWarning");
 const DynamicExports = require("./DynamicExports");
 const HarmonyCompatibilityDependency = require("./HarmonyCompatibilityDependency");
 const HarmonyExports = require("./HarmonyExports");
@@ -18,6 +18,7 @@ const PLUGIN_NAME = "HarmonyDetectionParserPlugin";
 
 module.exports = class HarmonyDetectionParserPlugin {
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {JavascriptParser} parser the parser
 	 * @returns {void}
 	 */
@@ -72,6 +73,7 @@ module.exports = class HarmonyDetectionParserPlugin {
 		});
 
 		/**
+		 * Returns true if in harmony.
 		 * @returns {boolean | undefined} true if in harmony
 		 */
 		const skipInHarmony = () => {
@@ -81,6 +83,7 @@ module.exports = class HarmonyDetectionParserPlugin {
 		};
 
 		/**
+		 * Returns null if in harmony.
 		 * @returns {null | undefined} null if in harmony
 		 */
 		const nullInHarmony = () => {