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

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,13 +36,16 @@ const PLUGIN_NAME = "AMDRequireDependenciesBlockParserPlugin";
 
 class AMDRequireDependenciesBlockParserPlugin {
 	/**
+	 * Creates an instance of AMDRequireDependenciesBlockParserPlugin.
 	 * @param {JavascriptParserOptions} options parserOptions
 	 */
 	constructor(options) {
+		/** @type {JavascriptParserOptions} */
 		this.options = options;
 	}
 
 	/**
+	 * Process function argument.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {Expression | SpreadElement} expression expression
 	 * @returns {boolean} need bind this
@@ -78,6 +81,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {JavascriptParser} parser the parser
 	 * @returns {void}
 	 */
@@ -88,6 +92,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -117,11 +122,11 @@ class AMDRequireDependenciesBlockParserPlugin {
 				} else if ((localModule = getLocalModule(parser.state, request))) {
 					localModule.flagUsed();
 					dep = new LocalModuleDependency(localModule, undefined, false);
-					dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+					dep.loc = parser.getLocation(expr);
 					parser.state.module.addPresentationalDependency(dep);
 				} else {
 					dep = this.newRequireItemDependency(request);
-					dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+					dep.loc = parser.getLocation(expr);
 					dep.optional = Boolean(parser.scope.inTry);
 					parser.state.current.addDependency(dep);
 				}
@@ -132,7 +137,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 				/** @type {Range} */
 				(param.range)
 			);
-			dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+			dep.loc = parser.getLocation(expr);
 			dep.optional = Boolean(parser.scope.inTry);
 			parser.state.module.addPresentationalDependency(dep);
 			return true;
@@ -140,6 +145,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -197,18 +203,19 @@ class AMDRequireDependenciesBlockParserPlugin {
 					(param.string),
 					param.range
 				);
-				dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+				dep.loc = parser.getLocation(expr);
 				dep.optional = Boolean(parser.scope.inTry);
 				parser.state.current.addDependency(dep);
 				return true;
 			}
-			dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+			dep.loc = parser.getLocation(expr);
 			parser.state.module.addPresentationalDependency(dep);
 			return true;
 		}
 	}
 
 	/**
+	 * Processes the provided parser.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @param {BasicEvaluatedExpression} param param
@@ -228,13 +235,14 @@ class AMDRequireDependenciesBlockParserPlugin {
 			parser
 		);
 		if (!dep) return;
-		dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+		dep.loc = parser.getLocation(expr);
 		dep.optional = Boolean(parser.scope.inTry);
 		parser.state.current.addDependency(dep);
 		return true;
 	}
 
 	/**
+	 * Process array for request string.
 	 * @param {BasicEvaluatedExpression} param param
 	 * @returns {string | undefined} result
 	 */
@@ -250,6 +258,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Process item for request string.
 	 * @param {BasicEvaluatedExpression} param param
 	 * @returns {string | undefined} result
 	 */
@@ -265,6 +274,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * Process call require.
 	 * @param {JavascriptParser} parser the parser
 	 * @param {CallExpression} expr call expression
 	 * @returns {boolean | undefined} result
@@ -286,7 +296,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 				/** @type {Expression} */ (expr.arguments[0])
 			);
 			depBlock = this.newRequireDependenciesBlock(
-				/** @type {DependencyLocation} */ (expr.loc),
+				parser.getLocation(expr),
 				this.processArrayForRequestString(param)
 			);
 			dep = this.newRequireDependency(
@@ -299,7 +309,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 					? /** @type {Range} */ (expr.arguments[2].range)
 					: null
 			);
-			dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+			dep.loc = parser.getLocation(expr);
 			depBlock.addDependency(dep);
 
 			parser.state.current = /** @type {EXPECTED_ANY} */ (depBlock);
@@ -341,13 +351,13 @@ class AMDRequireDependenciesBlockParserPlugin {
 					);
 					old.addPresentationalDependency(dep);
 					if (parser.state.module) {
+						const loc = /** @type {SourceLocation} */ (
+							parser.getLocation(expr)
+						);
 						parser.state.module.addError(
 							new UnsupportedFeatureWarning(
-								`Cannot statically analyse 'require(…, …)' in line ${
-									/** @type {SourceLocation} */ (expr.loc).start.line
-								}`,
-								/** @type {DependencyLocation} */
-								(expr.loc)
+								`Cannot statically analyse 'require(…, …)' in line ${loc.start.line}`,
+								loc
 							)
 						);
 					}
@@ -375,6 +385,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * New require dependencies block.
 	 * @param {DependencyLocation} loc location
 	 * @param {string=} request request
 	 * @returns {AMDRequireDependenciesBlock} AMDRequireDependenciesBlock
@@ -384,6 +395,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * New require dependency.
 	 * @param {Range} outerRange outer range
 	 * @param {Range} arrayRange array range
 	 * @param {Range | null} functionRange function range
@@ -405,6 +417,7 @@ class AMDRequireDependenciesBlockParserPlugin {
 	}
 
 	/**
+	 * New require item dependency.
 	 * @param {string} request request
 	 * @param {Range=} range range
 	 * @returns {AMDRequireItemDependency} AMDRequireItemDependency
@@ -414,6 +427,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

@@ -14,11 +14,12 @@ const NullDependency = require("./NullDependency");
 /** @typedef {import("../Dependency")} Dependency */
 /** @typedef {import("../DependencyTemplate").DependencyTemplateContext} DependencyTemplateContext */
 /** @typedef {import("../javascript/JavascriptParser").Range} Range */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<[Range, Range, Range | null, Range | null, boolean, boolean]>} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext<[Range, Range, Range | null, Range | null, boolean, boolean]>} ObjectSerializerContext */
 
 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
@@ -31,7 +32,9 @@ class AMDRequireDependency extends NullDependency {
 		this.arrayRange = arrayRange;
 		this.functionRange = functionRange;
 		this.errorCallbackRange = errorCallbackRange;
+		/** @type {boolean} */
 		this.functionBindThis = false;
+		/** @type {boolean} */
 		this.errorCallbackBindThis = false;
 	}
 
@@ -40,35 +43,39 @@ class AMDRequireDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
-		const { write } = context;
-
-		write(this.outerRange);
-		write(this.arrayRange);
-		write(this.functionRange);
-		write(this.errorCallbackRange);
-		write(this.functionBindThis);
-		write(this.errorCallbackBindThis);
+		context
+			.write(this.outerRange)
+			.write(this.arrayRange)
+			.write(this.functionRange)
+			.write(this.errorCallbackRange)
+			.write(this.functionBindThis)
+			.write(this.errorCallbackBindThis);
 
 		super.serialize(context);
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
-		const { read } = context;
-
-		this.outerRange = read();
-		this.arrayRange = read();
-		this.functionRange = read();
-		this.errorCallbackRange = read();
-		this.functionBindThis = read();
-		this.errorCallbackBindThis = read();
-
-		super.deserialize(context);
+		this.outerRange = context.read();
+		const c1 = context.rest;
+		this.arrayRange = c1.read();
+		const c2 = c1.rest;
+		this.functionRange = c2.read();
+		const c3 = c2.rest;
+		this.errorCallbackRange = c3.read();
+		const c4 = c3.rest;
+		this.functionBindThis = c4.read();
+		const c5 = c4.rest;
+		this.errorCallbackBindThis = c5.read();
+
+		super.deserialize(c5.rest);
 	}
 }
 
@@ -81,6 +88,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
@@ -34,15 +35,19 @@ class CachedConstDependency extends NullDependency {
 	) {
 		super();
 
+		/** @type {string} */
 		this.expression = expression;
 		this.range = range;
+		/** @type {string} */
 		this.identifier = identifier;
+		/** @type {number} */
 		this.place = place;
 		/** @type {undefined | string} */
 		this._hashUpdate = undefined;
 	}
 
 	/**
+	 * Create hash update.
 	 * @returns {string} hash update
 	 */
 	_createHashUpdate() {
@@ -50,7 +55,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 +68,7 @@ class CachedConstDependency extends NullDependency {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -77,6 +83,7 @@ class CachedConstDependency extends NullDependency {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -103,6 +110,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

@@ -5,13 +5,115 @@
 
 "use strict";
 
+const InitFragment = require("../InitFragment");
 const RuntimeGlobals = require("../RuntimeGlobals");
+const Template = require("../Template");
+const { propertyAccess } = require("../util/property");
 
+/** @typedef {import("../ConcatenationScope")} ConcatenationScope */
+/** @typedef {import("../Generator").GenerateContext} GenerateContext */
 /** @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);
+	// CJS exports are never inlined
+	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;
+
+/**
+ * Rewrites an `exports.<names>` reference of a concatenated CommonJS module to
+ * a hoisted module-scope variable and registers that variable as the export's
+ * symbol, so other concatenated modules bind to it directly.
+ * @param {ConcatenationScope} concatenationScope the concatenation scope
+ * @param {InitFragment<GenerateContext>[]} initFragments init fragments (receives the `var` declaration)
+ * @param {string[]} names full member chain of the reference (at least one entry)
+ * @returns {string} replacement expression for the whole reference
+ */
+module.exports.getConcatenatedExportAccess = (
+	concatenationScope,
+	initFragments,
+	names
+) => {
+	const name = names[0];
+	const identifier = Template.toIdentifier(name);
+	// A sanitized name could collide with another export ("a-b" vs "a_b"),
+	// so non-identifier names get a hex suffix of the raw name.
+	const symbol = `__WEBPACK_CJS_EXPORT_${
+		identifier === name
+			? name
+			: `${identifier}_${Buffer.from(name, "utf8").toString("hex")}`
+	}__`;
+	initFragments.push(
+		new InitFragment(
+			`var ${symbol};\n`,
+			InitFragment.STAGE_CONSTANTS,
+			0,
+			`cjs concatenated export ${name}`
+		)
+	);
+	concatenationScope.registerExport(name, symbol);
+	return `${symbol}${propertyAccess(names, 1)}`;
+};
+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 +165,5 @@ module.exports.handleDependencyBase = (
 
 	return [type, base];
 };
+module.exports.isRequireEsmModuleExportsModule =
+	isRequireEsmModuleExportsModule;