webpack 5.106.1 → 5.107.0

package/lib/dependencies/AMDPlugin.js

@@ -46,6 +46,7 @@ const PLUGIN_NAME = "AMDPlugin";
 
 class AMDPlugin {
 	/**
+	 * Creates an instance of AMDPlugin.
 	 * @param {AmdOptions} amdOptions the AMD options
 	 */
 	constructor(amdOptions) {
@@ -53,7 +54,7 @@ class AMDPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -133,6 +134,7 @@ class AMDPlugin {
 					});
 
 				/**
+				 * Handles the hook callback for this code path.
 				 * @param {Parser} parser parser parser
 				 * @param {JavascriptParserOptions} parserOptions parserOptions
 				 * @returns {void}
@@ -141,6 +143,7 @@ class AMDPlugin {
 					if (parserOptions.amd !== undefined && !parserOptions.amd) return;
 
 					/**
+					 * Processes the provided option expr.
 					 * @param {string} optionExpr option expression
 					 * @param {string} rootName root name
 					 * @param {GetMembers} getMembers callback

package/lib/dependencies/AMDRequireArrayDependency.js

@@ -20,6 +20,7 @@ const NullDependency = require("./NullDependency");
 
 class AMDRequireArrayDependency extends NullDependency {
 	/**
+	 * Creates an instance of AMDRequireArrayDependency.
 	 * @param {(string | LocalModuleDependency | AMDRequireItemDependency)[]} depsArray deps array
 	 * @param {Range} range range
 	 */
@@ -39,6 +40,7 @@ class AMDRequireArrayDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -51,6 +53,7 @@ class AMDRequireArrayDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -72,6 +75,7 @@ AMDRequireArrayDependency.Template = class AMDRequireArrayDependencyTemplate ext
 	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
@@ -84,6 +88,7 @@ AMDRequireArrayDependency.Template = class AMDRequireArrayDependencyTemplate ext
 	}
 
 	/**
+	 * Returns content.
 	 * @param {AMDRequireArrayDependency} dep the dependency for which the template should be applied
 	 * @param {DependencyTemplateContext} templateContext the context object
 	 * @returns {string} content
@@ -96,6 +101,7 @@ AMDRequireArrayDependency.Template = class AMDRequireArrayDependencyTemplate ext
 	}
 
 	/**
+	 * Content for dependency.
 	 * @param {string | LocalModuleDependency | AMDRequireItemDependency} dep the dependency for which the template should be applied
 	 * @param {DependencyTemplateContext} templateContext the context object
 	 * @returns {string} content

package/lib/dependencies/AMDRequireContextDependency.js

@@ -15,6 +15,7 @@ const ContextDependency = require("./ContextDependency");
 
 class AMDRequireContextDependency extends ContextDependency {
 	/**
+	 * Creates an instance of AMDRequireContextDependency.
 	 * @param {ContextDependencyOptions} options options
 	 * @param {Range} range range
 	 * @param {Range} valueRange value range
@@ -35,6 +36,7 @@ class AMDRequireContextDependency extends ContextDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -47,6 +49,7 @@ class AMDRequireContextDependency extends ContextDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/dependencies/AMDRequireDependenciesBlock.js

@@ -12,6 +12,7 @@ const makeSerializable = require("../util/makeSerializable");
 
 class AMDRequireDependenciesBlock extends AsyncDependenciesBlock {
 	/**
+	 * Creates an instance of AMDRequireDependenciesBlock.
 	 * @param {DependencyLocation} loc location info
 	 * @param {string=} request request
 	 */

package/lib/dependencies/AMDRequireDependenciesBlockParserPlugin.js

@@ -6,7 +6,7 @@
 "use strict";
 
 const RuntimeGlobals = require("../RuntimeGlobals");
-const UnsupportedFeatureWarning = require("../UnsupportedFeatureWarning");
+const UnsupportedFeatureWarning = require("../errors/UnsupportedFeatureWarning");
 const AMDRequireArrayDependency = require("./AMDRequireArrayDependency");
 const AMDRequireContextDependency = require("./AMDRequireContextDependency");
 const AMDRequireDependenciesBlock = require("./AMDRequireDependenciesBlock");
@@ -36,6 +36,7 @@ const PLUGIN_NAME = "AMDRequireDependenciesBlockParserPlugin";
 
 class AMDRequireDependenciesBlockParserPlugin {
 	/**
+	 * Creates an instance of AMDRequireDependenciesBlockParserPlugin.
 	 * @param {JavascriptParserOptions} options parserOptions
 	 */
 	constructor(options) {
@@ -43,6 +44,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Process function argument.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {Expression | SpreadElement} expression expression
 	 * @returns {boolean} need bind this
@@ -78,6 +80,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {JavascriptParser} parser the parser
 	 * @returns {void}
 	 */
@@ -88,6 +91,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -140,6 +144,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -209,6 +214,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -235,6 +241,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Process array for request string.
 	 * @param {BasicEvaluatedExpression} param param
 	 * @returns {string | undefined} result
 	 */
@@ -250,6 +257,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Process item for request string.
 	 * @param {BasicEvaluatedExpression} param param
 	 * @returns {string | undefined} result
 	 */
@@ -265,6 +273,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Process call require.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @returns {boolean | undefined} result
@@ -375,6 +384,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * New require dependencies block.
 	 * @param {DependencyLocation} loc location
 	 * @param {string=} request request
 	 * @returns {AMDRequireDependenciesBlock} AMDRequireDependenciesBlock
@@ -384,6 +394,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * New require dependency.
 	 * @param {Range} outerRange outer range
 	 * @param {Range} arrayRange array range
 	 * @param {Range | null} functionRange function range
@@ -405,6 +416,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * New require item dependency.
 	 * @param {string} request request
 	 * @param {Range=} range range
 	 * @returns {AMDRequireItemDependency} AMDRequireItemDependency
@@ -414,6 +426,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * New require array dependency.
 	 * @param {(string | LocalModuleDependency | AMDRequireItemDependency)[]} depsArray deps array
 	 * @param {Range} range range
 	 * @returns {AMDRequireArrayDependency} AMDRequireArrayDependency

package/lib/dependencies/AMDRequireDependency.js

@@ -19,6 +19,7 @@ const NullDependency = require("./NullDependency");
 
 class AMDRequireDependency extends NullDependency {
 	/**
+	 * Creates an instance of AMDRequireDependency.
 	 * @param {Range} outerRange outer range
 	 * @param {Range} arrayRange array range
 	 * @param {Range | null} functionRange function range
@@ -40,6 +41,7 @@ class AMDRequireDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -56,6 +58,7 @@ class AMDRequireDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -81,6 +84,7 @@ AMDRequireDependency.Template = class AMDRequireDependencyTemplate 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/AMDRequireItemDependency.js

@@ -13,6 +13,7 @@ const ModuleDependencyTemplateAsRequireId = require("./ModuleDependencyTemplateA
 
 class AMDRequireItemDependency extends ModuleDependency {
 	/**
+	 * Creates an instance of AMDRequireItemDependency.
 	 * @param {string} request the request string
 	 * @param {Range=} range location in source code
 	 */

package/lib/dependencies/AMDRuntimeModules.js

@@ -16,6 +16,7 @@ class AMDDefineRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {
@@ -29,6 +30,7 @@ class AMDDefineRuntimeModule extends RuntimeModule {
 
 class AMDOptionsRuntimeModule extends RuntimeModule {
 	/**
+	 * Creates an instance of AMDOptionsRuntimeModule.
 	 * @param {AmdOptions} options the AMD options
 	 */
 	constructor(options) {
@@ -37,6 +39,7 @@ class AMDOptionsRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/dependencies/CachedConstDependency.js

@@ -21,6 +21,7 @@ const NullDependency = require("./NullDependency");
 
 class CachedConstDependency extends NullDependency {
 	/**
+	 * Creates an instance of CachedConstDependency.
 	 * @param {string} expression expression
 	 * @param {Range | null} range range
 	 * @param {string} identifier identifier
@@ -43,6 +44,7 @@ class CachedConstDependency extends NullDependency {
 	}
 
 	/**
+	 * Create hash update.
 	 * @returns {string} hash update
 	 */
 	_createHashUpdate() {
@@ -50,7 +52,7 @@ class CachedConstDependency 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}
@@ -63,6 +65,7 @@ class CachedConstDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -77,6 +80,7 @@ class CachedConstDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -103,6 +107,7 @@ CachedConstDependency.Template = class CachedConstDependencyTemplate extends (
 	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/CommonJsDependencyHelpers.js

@@ -6,12 +6,74 @@
 "use strict";
 
 const RuntimeGlobals = require("../RuntimeGlobals");
+const { propertyAccess } = require("../util/property");
 
 /** @typedef {import("../Module")} Module */
 /** @typedef {import("../Module").RuntimeRequirements} RuntimeRequirements */
+/** @typedef {import("../ModuleGraph")} ModuleGraph */
+/** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
 /** @typedef {"exports" | "module.exports" | "this" | "Object.defineProperty(exports)" | "Object.defineProperty(module.exports)" | "Object.defineProperty(this)"} CommonJSDependencyBaseKeywords */
 
 /**
+ * The well-known name of the ESM named export that, when present, is unwrapped
+ * by CommonJS `require()` to match Node.js v23+ `require(esm)` semantics:
+ * https://nodejs.org/docs/latest/api/modules.html#loading-ecmascript-modules-using-require
+ */
+const ESM_MODULE_EXPORTS_NAME = "module.exports";
+
+/**
+ * Whether `require()` of `importedModule` would trigger Node.js's
+ * `require(esm)` `"module.exports"` named-export unwrap. This is the
+ * usage-independent eligibility check: it only looks at module type and
+ * whether the export is declared, so it can be safely used from
+ * `getReferencedExports` before usage info is finalized (otherwise the
+ * check would be circular — we'd need `"module.exports"` to already be
+ * marked used in order to ask whether to mark it used).
+ * @param {Module} importedModule the imported module
+ * @param {ModuleGraph} moduleGraph the module graph
+ * @returns {boolean} true if `require()` should unwrap `"module.exports"`
+ */
+const isRequireEsmModuleExportsModule = (importedModule, moduleGraph) => {
+	if (importedModule.getExportsType(moduleGraph, false) !== "namespace") {
+		return false;
+	}
+	const exportsInfo = moduleGraph.getExportsInfo(importedModule);
+	const exportInfo = exportsInfo.getReadOnlyExportInfo(ESM_MODULE_EXPORTS_NAME);
+	return exportInfo.provided === true;
+};
+
+/**
+ * When CommonJS `require()` resolves to an ES module that has a named export
+ * with the literal string name `"module.exports"`, Node.js returns the value of
+ * that export instead of the namespace object. Returns the property-access
+ * expression to apply to the require result for that unwrapping, or `null` if
+ * the imported module is not eligible (not strictly ESM, or no such export,
+ * or the export was tree-shaken away).
+ * @param {Module} importedModule the imported module
+ * @param {ModuleGraph} moduleGraph the module graph
+ * @param {RuntimeSpec} runtime the runtime for which the module is analysed
+ * @returns {string | null} property-access expression (e.g. `["module.exports"]`), or `null`
+ */
+const getRequireEsmModuleExportsAccess = (
+	importedModule,
+	moduleGraph,
+	runtime
+) => {
+	if (!isRequireEsmModuleExportsModule(importedModule, moduleGraph)) {
+		return null;
+	}
+	const exportsInfo = moduleGraph.getExportsInfo(importedModule);
+	const usedName = exportsInfo.getUsedName([ESM_MODULE_EXPORTS_NAME], runtime);
+	if (usedName === false) return null;
+	return propertyAccess(/** @type {readonly string[]} */ (usedName));
+};
+
+module.exports.ESM_MODULE_EXPORTS_NAME = ESM_MODULE_EXPORTS_NAME;
+module.exports.getRequireEsmModuleExportsAccess =
+	getRequireEsmModuleExportsAccess;
+
+/**
+ * Returns type and base.
  * @param {CommonJSDependencyBaseKeywords} depBase commonjs dependency base
  * @param {Module} module module
  * @param {RuntimeRequirements} runtimeRequirements runtime requirements
@@ -63,3 +125,5 @@ module.exports.handleDependencyBase = (
 
 	return [type, base];
 };
+module.exports.isRequireEsmModuleExportsModule =
+	isRequireEsmModuleExportsModule;

package/lib/dependencies/CommonJsExportRequireDependency.js

@@ -11,7 +11,12 @@ const Template = require("../Template");
 const { equals } = require("../util/ArrayHelpers");
 const makeSerializable = require("../util/makeSerializable");
 const { propertyAccess } = require("../util/property");
-const { handleDependencyBase } = require("./CommonJsDependencyHelpers");
+const {
+	ESM_MODULE_EXPORTS_NAME,
+	getRequireEsmModuleExportsAccess,
+	handleDependencyBase,
+	isRequireEsmModuleExportsModule
+} = require("./CommonJsDependencyHelpers");
 const ModuleDependency = require("./ModuleDependency");
 const processExportInfo = require("./processExportInfo");
 
@@ -43,6 +48,7 @@ const EMPTY_OBJECT = {};
 
 class CommonJsExportRequireDependency extends ModuleDependency {
 	/**
+	 * Creates an instance of CommonJsExportRequireDependency.
 	 * @param {Range} range range
 	 * @param {Range | null} valueRange value range
 	 * @param {CommonJSDependencyBaseKeywords} base base
@@ -72,6 +78,7 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Could affect referencing module.
 	 * @returns {boolean | TRANSITIVE} true, when changes to the referenced module could affect the referencing module; TRANSITIVE, when changes to the referenced module could affect referencing modules of the referencing module
 	 */
 	couldAffectReferencingModule() {
@@ -79,6 +86,7 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Returns the imported id.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @returns {ExportInfoName[]} the imported id
 	 */
@@ -87,6 +95,7 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Updates ids using the provided module graph.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @param {ExportInfoName[]} ids the imported ids
 	 * @returns {void}
@@ -103,6 +112,16 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 	 */
 	getReferencedExports(moduleGraph, runtime) {
 		const ids = this.getIds(moduleGraph);
+		const importedModule = moduleGraph.getModule(this);
+		if (
+			importedModule &&
+			isRequireEsmModuleExportsModule(importedModule, moduleGraph)
+		) {
+			// `require(esm)` unwraps the "module.exports" named export; any
+			// further property access lands on that value (which webpack does
+			// not model), so only the "module.exports" export is observable.
+			return [[ESM_MODULE_EXPORTS_NAME]];
+		}
 		const getFullResult = () => {
 			if (ids.length === 0) {
 				return Dependency.EXPORTS_OBJECT_REFERENCED;
@@ -155,17 +174,26 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 	 * @returns {ExportsSpec | undefined} export names
 	 */
 	getExports(moduleGraph) {
+		const importedModule = moduleGraph.getModule(this);
+		const esmUnwrap =
+			importedModule &&
+			isRequireEsmModuleExportsModule(importedModule, moduleGraph);
 		if (this.names.length === 1) {
 			const ids = this.getIds(moduleGraph);
 			const name = this.names[0];
 			const from = moduleGraph.getConnection(this);
 			if (!from) return;
+			const exportChain = esmUnwrap
+				? [ESM_MODULE_EXPORTS_NAME, ...ids]
+				: ids.length === 0
+					? null
+					: ids;
 			return {
 				exports: [
 					{
 						name,
 						from,
-						export: ids.length === 0 ? null : ids,
+						export: exportChain,
 						// we can't mangle names that are in an empty object
 						// because one could access the prototype property
 						// when export isn't set yet
@@ -191,6 +219,17 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 		}
 		const from = moduleGraph.getConnection(this);
 		if (!from) return;
+		if (esmUnwrap) {
+			// Full re-export `module.exports = require("./esm")` of a module
+			// with a `"module.exports"` named export: the wrapping module's
+			// `module.exports` becomes the unwrapped value, whose own
+			// properties webpack cannot enumerate statically.
+			return {
+				exports: true,
+				canMangle: false,
+				dependencies: [from.module]
+			};
+		}
 		const reexportInfo = this.getStarReexports(
 			moduleGraph,
 			undefined,
@@ -222,6 +261,7 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Gets star reexports.
 	 * @param {ModuleGraph} moduleGraph the module graph
 	 * @param {RuntimeSpec} runtime the runtime
 	 * @param {Module} importedModule the imported module (optional)
@@ -308,6 +348,7 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -323,6 +364,7 @@ class CommonJsExportRequireDependency extends ModuleDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -347,6 +389,7 @@ CommonJsExportRequireDependency.Template = class CommonJsExportRequireDependency
 	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
@@ -385,14 +428,23 @@ CommonJsExportRequireDependency.Template = class CommonJsExportRequireDependency
 		});
 		if (importedModule) {
 			const ids = dep.getIds(moduleGraph);
-			const usedImported = moduleGraph
-				.getExportsInfo(importedModule)
-				.getUsedName(ids, runtime);
-			if (usedImported) {
-				const comment = equals(usedImported, ids)
-					? ""
-					: `${Template.toNormalComment(propertyAccess(ids))} `;
-				requireExpr += `${comment}${propertyAccess(usedImported)}`;
+			const esmRequireAccess = getRequireEsmModuleExportsAccess(
+				importedModule,
+				moduleGraph,
+				runtime
+			);
+			if (esmRequireAccess !== null) {
+				requireExpr += `${esmRequireAccess}${propertyAccess(ids)}`;
+			} else {
+				const usedImported = moduleGraph
+					.getExportsInfo(importedModule)
+					.getUsedName(ids, runtime);
+				if (usedImported) {
+					const comment = equals(usedImported, ids)
+						? ""
+						: `${Template.toNormalComment(propertyAccess(ids))} `;
+					requireExpr += `${comment}${propertyAccess(usedImported)}`;
+				}
 			}
 		}
 

package/lib/dependencies/CommonJsExportsDependency.js

@@ -26,6 +26,7 @@ const EMPTY_OBJECT = {};
 
 class CommonJsExportsDependency extends NullDependency {
 	/**
+	 * Creates an instance of CommonJsExportsDependency.
 	 * @param {Range} range range
 	 * @param {Range | null} valueRange value range
 	 * @param {CommonJSDependencyBaseKeywords} base base
@@ -65,6 +66,7 @@ class CommonJsExportsDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -77,6 +79,7 @@ class CommonJsExportsDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -98,6 +101,7 @@ CommonJsExportsDependency.Template = class CommonJsExportsDependencyTemplate ext
 	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/CommonJsExportsParserPlugin.js

@@ -6,8 +6,8 @@
 "use strict";
 
 const RuntimeGlobals = require("../RuntimeGlobals");
-const formatLocation = require("../formatLocation");
 const { evaluateToString } = require("../javascript/JavascriptParserHelpers");
+const formatLocation = require("../util/formatLocation");
 const { propertyAccess } = require("../util/property");
 const CommonJsExportRequireDependency = require("./CommonJsExportRequireDependency");
 const CommonJsExportsDependency = require("./CommonJsExportsDependency");
@@ -94,6 +94,7 @@ const isFalsyLiteral = (expr) => {
 };
 
 /**
+ * Parses require call.
  * @param {JavascriptParser} parser the parser
  * @param {Expression} expr expression
  * @returns {{ argument: BasicEvaluatedExpression, ids: ExportInfoName[] } | undefined} parsed call
@@ -132,6 +133,7 @@ const PLUGIN_NAME = "CommonJsExportsParserPlugin";
 
 class CommonJsExportsParserPlugin {
 	/**
+	 * Creates an instance of CommonJsExportsParserPlugin.
 	 * @param {ModuleGraph} moduleGraph module graph
 	 */
 	constructor(moduleGraph) {
@@ -139,6 +141,7 @@ class CommonJsExportsParserPlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {JavascriptParser} parser the parser
 	 * @returns {void}
 	 */
@@ -148,6 +151,7 @@ class CommonJsExportsParserPlugin {
 		};
 
 		/**
+		 * Checks namespace.
 		 * @param {boolean} topLevel true, when the export is on top level
 		 * @param {Members} members members of the export
 		 * @param {Expression | undefined} valueExpr expression for the value
@@ -164,6 +168,7 @@ class CommonJsExportsParserPlugin {
 			}
 		};
 		/**
+		 * Processes the provided reason.
 		 * @param {string=} reason reason
 		 */
 		const bailout = (reason) => {
@@ -171,6 +176,7 @@ class CommonJsExportsParserPlugin {
 			if (reason) bailoutHint(reason);
 		};
 		/**
+		 * Processes the provided reason.
 		 * @param {string} reason reason
 		 */
 		const bailoutHint = (reason) => {
@@ -190,6 +196,7 @@ class CommonJsExportsParserPlugin {
 		// exporting //
 
 		/**
+		 * Handle assign export.
 		 * @param {AssignmentExpression} expr expression
 		 * @param {CommonJSDependencyBaseKeywords} base commonjs base keywords
 		 * @param {Members} members members of the export
@@ -313,6 +320,7 @@ class CommonJsExportsParserPlugin {
 		// Self reference //
 
 		/**
+		 * Handle access export.
 		 * @param {Expression | Super} expr expression
 		 * @param {CommonJSDependencyBaseKeywords} base commonjs base keywords
 		 * @param {Members} members members of the export