webpack 5.76.1 → 5.88.0

package/lib/ModuleGraphConnection.js

@@ -74,9 +74,9 @@ class ModuleGraphConnection {
 		this.weak = weak;
 		this.conditional = !!condition;
 		this._active = condition !== false;
-		/** @type {function(ModuleGraphConnection, RuntimeSpec): ConnectionState} */
+		/** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState) | undefined} */
 		this.condition = condition || undefined;
-		/** @type {Set<string>} */
+		/** @type {Set<string> | undefined} */
 		this.explanations = undefined;
 		if (explanation) {
 			this.explanations = new Set();
@@ -107,7 +107,9 @@ class ModuleGraphConnection {
 	 */
 	addCondition(condition) {
 		if (this.conditional) {
-			const old = this.condition;
+			const old =
+				/** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState)} */
+				(this.condition);
 			this.condition = (c, r) =>
 				intersectConnectionStates(old(c, r), condition(c, r));
 		} else if (this._active) {
@@ -143,7 +145,12 @@ class ModuleGraphConnection {
 	 */
 	isActive(runtime) {
 		if (!this.conditional) return this._active;
-		return this.condition(this, runtime) !== false;
+
+		return (
+			/** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState)} */ (
+				this.condition
+			)(this, runtime) !== false
+		);
 	}
 
 	/**
@@ -152,7 +159,11 @@ class ModuleGraphConnection {
 	 */
 	isTargetActive(runtime) {
 		if (!this.conditional) return this._active;
-		return this.condition(this, runtime) === true;
+		return (
+			/** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState)} */ (
+				this.condition
+			)(this, runtime) === true
+		);
 	}
 
 	/**
@@ -161,7 +172,9 @@ class ModuleGraphConnection {
 	 */
 	getActiveState(runtime) {
 		if (!this.conditional) return this._active;
-		return this.condition(this, runtime);
+		return /** @type {(function(ModuleGraphConnection, RuntimeSpec): ConnectionState)} */ (
+			this.condition
+		)(this, runtime);
 	}
 
 	/**

package/lib/ModuleInfoHeaderPlugin.js

@@ -15,10 +15,16 @@ const JavascriptModulesPlugin = require("./javascript/JavascriptModulesPlugin");
 /** @typedef {import("./ExportsInfo")} ExportsInfo */
 /** @typedef {import("./ExportsInfo").ExportInfo} ExportInfo */
 /** @typedef {import("./Module")} Module */
+/** @typedef {import("./Module").BuildMeta} BuildMeta */
 /** @typedef {import("./ModuleGraph")} ModuleGraph */
 /** @typedef {import("./ModuleTemplate")} ModuleTemplate */
 /** @typedef {import("./RequestShortener")} RequestShortener */
 
+/**
+ * @template T
+ * @param {Iterable<T>} iterable iterable
+ * @returns {string} joined with comma
+ */
 const joinIterableWithComma = iterable => {
 	// This is more performant than Array.from().join(", ")
 	// as it doesn't create an array
@@ -139,7 +145,7 @@ const printExportsInfoToSource = (
 	}
 };
 
-/** @type {WeakMap<RequestShortener, WeakMap<Module, { header: RawSource, full: WeakMap<Source, CachedSource> }>>} */
+/** @type {WeakMap<RequestShortener, WeakMap<Module, { header: RawSource | undefined, full: WeakMap<Source, CachedSource> }>>} */
 const caches = new WeakMap();
 
 class ModuleInfoHeaderPlugin {
@@ -197,7 +203,8 @@ class ModuleInfoHeaderPlugin {
 					}
 					source.add(header);
 					if (verbose) {
-						const exportsType = module.buildMeta.exportsType;
+						const exportsType = /** @type {BuildMeta} */ (module.buildMeta)
+							.exportsType;
 						source.add(
 							Template.toComment(
 								exportsType

package/lib/ModuleNotFoundError.js

@@ -43,7 +43,7 @@ const previouslyPolyfilledBuiltinModules = {
 
 class ModuleNotFoundError extends WebpackError {
 	/**
-	 * @param {Module} module module tied to dependency
+	 * @param {Module | null} module module tied to dependency
 	 * @param {Error&any} err error thrown
 	 * @param {DependencyLocation} loc location of dependency
 	 */
@@ -54,7 +54,10 @@ class ModuleNotFoundError extends WebpackError {
 		const match = err.message.match(/Can't resolve '([^']+)'/);
 		if (match) {
 			const request = match[1];
-			const alias = previouslyPolyfilledBuiltinModules[request];
+			const alias =
+				previouslyPolyfilledBuiltinModules[
+					/** @type {keyof previouslyPolyfilledBuiltinModules} */ (request)
+				];
 			if (alias) {
 				const pathIndex = alias.indexOf("/");
 				const dependency = pathIndex > 0 ? alias.slice(0, pathIndex) : alias;

package/lib/ModuleParseError.js

@@ -8,6 +8,9 @@
 const WebpackError = require("./WebpackError");
 const makeSerializable = require("./util/makeSerializable");
 
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+
 const WASM_HEADER = Buffer.from([0x00, 0x61, 0x73, 0x6d]);
 
 class ModuleParseError extends WebpackError {
@@ -87,6 +90,9 @@ class ModuleParseError extends WebpackError {
 		this.error = err;
 	}
 
+	/**
+	 * @param {ObjectSerializerContext} context context
+	 */
 	serialize(context) {
 		const { write } = context;
 
@@ -95,6 +101,9 @@ class ModuleParseError extends WebpackError {
 		super.serialize(context);
 	}
 
+	/**
+	 * @param {ObjectDeserializerContext} context context
+	 */
 	deserialize(context) {
 		const { read } = context;
 

package/lib/ModuleProfile.js

@@ -34,6 +34,7 @@ class ModuleProfile {
 		this.storing = 0;
 		this.storingParallelismFactor = 0;
 
+		/** @type {{ start: number, end: number }[] | undefined } */
 		this.additionalFactoryTimes = undefined;
 		this.additionalFactories = 0;
 		this.additionalFactoriesParallelismFactor = 0;

package/lib/ModuleRestoreError.js

@@ -16,6 +16,7 @@ class ModuleRestoreError extends WebpackError {
 	 */
 	constructor(module, err) {
 		let message = "Module restore failed: ";
+		/** @type {string | undefined} */
 		let details = undefined;
 		if (err !== null && typeof err === "object") {
 			if (typeof err.stack === "string" && err.stack) {
@@ -33,6 +34,7 @@ class ModuleRestoreError extends WebpackError {
 		super(message);
 
 		this.name = "ModuleRestoreError";
+		/** @type {string | undefined} */
 		this.details = details;
 		this.module = module;
 		this.error = err;

package/lib/ModuleStoreError.js

@@ -16,6 +16,7 @@ class ModuleStoreError extends WebpackError {
 	 */
 	constructor(module, err) {
 		let message = "Module storing failed: ";
+		/** @type {string | undefined} */
 		let details = undefined;
 		if (err !== null && typeof err === "object") {
 			if (typeof err.stack === "string" && err.stack) {
@@ -33,7 +34,7 @@ class ModuleStoreError extends WebpackError {
 		super(message);
 
 		this.name = "ModuleStoreError";
-		this.details = details;
+		this.details = /** @type {string | undefined} */ (details);
 		this.module = module;
 		this.error = err;
 	}

package/lib/ModuleTypeConstants.js

@@ -0,0 +1,169 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Sean Larkin @TheLarkInn
+*/
+
+"use strict";
+
+/**
+ * @type {Readonly<"javascript/auto">}
+ */
+const JAVASCRIPT_MODULE_TYPE_AUTO = "javascript/auto";
+
+/**
+ * @type {Readonly<"javascript/dynamic">}
+ */
+const JAVASCRIPT_MODULE_TYPE_DYNAMIC = "javascript/dynamic";
+
+/**
+ * @type {Readonly<"javascript/esm">}
+ * This is the module type used for _strict_ ES Module syntax. This means that all legacy formats
+ * that webpack supports (CommonJS, AMD, SystemJS) are not supported.
+ */
+const JAVASCRIPT_MODULE_TYPE_ESM = "javascript/esm";
+
+/**
+ * @type {Readonly<"json">}
+ * This is the module type used for JSON files. JSON files are always parsed as ES Module.
+ */
+const JSON_MODULE_TYPE = "json";
+
+/**
+ * @type {Readonly<"webassembly/async">}
+ * This is the module type used for WebAssembly modules. In webpack 5 they are always treated as async modules.
+ *
+ */
+const WEBASSEMBLY_MODULE_TYPE_ASYNC = "webassembly/async";
+
+/**
+ * @type {Readonly<"webassembly/sync">}
+ * This is the module type used for WebAssembly modules. In webpack 4 they are always treated as sync modules.
+ * There is a legacy option to support this usage in webpack 5 and up.
+ */
+const WEBASSEMBLY_MODULE_TYPE_SYNC = "webassembly/sync";
+
+/**
+ * @type {Readonly<"css">}
+ * This is the module type used for CSS files.
+ */
+const CSS_MODULE_TYPE = "css";
+
+/**
+ * @type {Readonly<"css/global">}
+ * This is the module type used for CSS modules files where you need to use `:local` in selector list to hash classes.
+ */
+const CSS_MODULE_TYPE_GLOBAL = "css/global";
+
+/**
+ * @type {Readonly<"css/module">}
+ * This is the module type used for CSS modules files, by default all classes are hashed.
+ */
+const CSS_MODULE_TYPE_MODULE = "css/module";
+
+/**
+ * @type {Readonly<"css/auto">}
+ * This is the module type used for CSS files, the module will be parsed as CSS modules if it's filename contains `.module.` or `.modules.`.
+ */
+const CSS_MODULE_TYPE_AUTO = "css/auto";
+
+/**
+ * @type {Readonly<"asset">}
+ * This is the module type used for automatically choosing between `asset/inline`, `asset/resource` based on asset size limit (8096).
+ */
+const ASSET_MODULE_TYPE = "asset";
+
+/**
+ * @type {Readonly<"asset/inline">}
+ * This is the module type used for assets that are inlined as a data URI. This is the equivalent of `url-loader`.
+ */
+const ASSET_MODULE_TYPE_INLINE = "asset/inline";
+
+/**
+ * @type {Readonly<"asset/resource">}
+ * This is the module type used for assets that are copied to the output directory. This is the equivalent of `file-loader`.
+ */
+const ASSET_MODULE_TYPE_RESOURCE = "asset/resource";
+
+/**
+ * @type {Readonly<"asset/source">}
+ * This is the module type used for assets that are imported as source code. This is the equivalent of `raw-loader`.
+ */
+const ASSET_MODULE_TYPE_SOURCE = "asset/source";
+
+/**
+ * @type {Readonly<"asset/raw-data-url">}
+ * TODO: Document what this asset type is for. See css-loader tests for its usage.
+ */
+const ASSET_MODULE_TYPE_RAW_DATA_URL = "asset/raw-data-url";
+
+/**
+ * @type {Readonly<"runtime">}
+ * This is the module type used for the webpack runtime abstractions.
+ */
+const WEBPACK_MODULE_TYPE_RUNTIME = "runtime";
+
+/**
+ * @type {Readonly<"fallback-module">}
+ * This is the module type used for the ModuleFederation feature's FallbackModule class.
+ * TODO: Document this better.
+ */
+const WEBPACK_MODULE_TYPE_FALLBACK = "fallback-module";
+
+/**
+ * @type {Readonly<"remote-module">}
+ * This is the module type used for the ModuleFederation feature's RemoteModule class.
+ * TODO: Document this better.
+ */
+const WEBPACK_MODULE_TYPE_REMOTE = "remote-module";
+
+/**
+ * @type {Readonly<"provide-module">}
+ * This is the module type used for the ModuleFederation feature's ProvideModule class.
+ * TODO: Document this better.
+ */
+const WEBPACK_MODULE_TYPE_PROVIDE = "provide-module";
+
+/**
+ * @type {Readonly<"consume-shared-module">}
+ * This is the module type used for the ModuleFederation feature's ConsumeSharedModule class.
+ */
+const WEBPACK_MODULE_TYPE_CONSUME_SHARED_MODULE = "consume-shared-module";
+
+/**
+ * @type {Readonly<"lazy-compilation-proxy">}
+ * Module type used for `experiments.lazyCompilation` feature. See `LazyCompilationPlugin` for more information.
+ */
+const WEBPACK_MODULE_TYPE_LAZY_COMPILATION_PROXY = "lazy-compilation-proxy";
+
+/** @typedef {"javascript/auto" | "javascript/dynamic" | "javascript/esm"} JavaScriptModuleTypes */
+/** @typedef {"json"} JSONModuleType */
+/** @typedef {"webassembly/async" | "webassembly/sync"} WebAssemblyModuleTypes */
+/** @typedef {"css" | "css/global" | "css/module"} CSSModuleTypes */
+/** @typedef {"asset" | "asset/inline" | "asset/resource" | "asset/source" | "asset/raw-data-url"} AssetModuleTypes */
+/** @typedef {"runtime" | "fallback-module" | "remote-module" | "provide-module" | "consume-shared-module" | "lazy-compilation-proxy"} WebpackModuleTypes */
+/** @typedef {string} UnknownModuleTypes */
+/** @typedef {JavaScriptModuleTypes | JSONModuleType | WebAssemblyModuleTypes | CSSModuleTypes | AssetModuleTypes | WebpackModuleTypes | UnknownModuleTypes} ModuleTypes */
+
+exports.ASSET_MODULE_TYPE = ASSET_MODULE_TYPE;
+exports.ASSET_MODULE_TYPE_RAW_DATA_URL = ASSET_MODULE_TYPE_RAW_DATA_URL;
+exports.ASSET_MODULE_TYPE_SOURCE = ASSET_MODULE_TYPE_SOURCE;
+exports.ASSET_MODULE_TYPE_RESOURCE = ASSET_MODULE_TYPE_RESOURCE;
+exports.ASSET_MODULE_TYPE_INLINE = ASSET_MODULE_TYPE_INLINE;
+exports.JAVASCRIPT_MODULE_TYPE_AUTO = JAVASCRIPT_MODULE_TYPE_AUTO;
+exports.JAVASCRIPT_MODULE_TYPE_DYNAMIC = JAVASCRIPT_MODULE_TYPE_DYNAMIC;
+exports.JAVASCRIPT_MODULE_TYPE_ESM = JAVASCRIPT_MODULE_TYPE_ESM;
+exports.JSON_MODULE_TYPE = JSON_MODULE_TYPE;
+exports.WEBASSEMBLY_MODULE_TYPE_ASYNC = WEBASSEMBLY_MODULE_TYPE_ASYNC;
+exports.WEBASSEMBLY_MODULE_TYPE_SYNC = WEBASSEMBLY_MODULE_TYPE_SYNC;
+exports.CSS_MODULE_TYPE = CSS_MODULE_TYPE;
+exports.CSS_MODULE_TYPE_GLOBAL = CSS_MODULE_TYPE_GLOBAL;
+exports.CSS_MODULE_TYPE_MODULE = CSS_MODULE_TYPE_MODULE;
+exports.CSS_MODULE_TYPE_AUTO = CSS_MODULE_TYPE_AUTO;
+exports.WEBPACK_MODULE_TYPE_RUNTIME = WEBPACK_MODULE_TYPE_RUNTIME;
+exports.WEBPACK_MODULE_TYPE_FALLBACK = WEBPACK_MODULE_TYPE_FALLBACK;
+exports.WEBPACK_MODULE_TYPE_REMOTE = WEBPACK_MODULE_TYPE_REMOTE;
+exports.WEBPACK_MODULE_TYPE_PROVIDE = WEBPACK_MODULE_TYPE_PROVIDE;
+exports.WEBPACK_MODULE_TYPE_CONSUME_SHARED_MODULE =
+	WEBPACK_MODULE_TYPE_CONSUME_SHARED_MODULE;
+exports.WEBPACK_MODULE_TYPE_LAZY_COMPILATION_PROXY =
+	WEBPACK_MODULE_TYPE_LAZY_COMPILATION_PROXY;

package/lib/ModuleWarning.js

@@ -9,6 +9,9 @@ const { cleanUp } = require("./ErrorHelpers");
 const WebpackError = require("./WebpackError");
 const makeSerializable = require("./util/makeSerializable");
 
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+
 class ModuleWarning extends WebpackError {
 	/**
 	 * @param {Error} warning error thrown
@@ -39,6 +42,9 @@ class ModuleWarning extends WebpackError {
 				: undefined;
 	}
 
+	/**
+	 * @param {ObjectSerializerContext} context context
+	 */
 	serialize(context) {
 		const { write } = context;
 
@@ -47,6 +53,9 @@ class ModuleWarning extends WebpackError {
 		super.serialize(context);
 	}
 
+	/**
+	 * @param {ObjectDeserializerContext} context context
+	 */
 	deserialize(context) {
 		const { read } = context;
 

package/lib/MultiWatching.js

@@ -27,6 +27,10 @@ class MultiWatching {
 		this.compiler = compiler;
 	}
 
+	/**
+	 * @param {Callback<void>=} callback signals when the build has completed again
+	 * @returns {void}
+	 */
 	invalidate(callback) {
 		if (callback) {
 			asyncLib.each(

package/lib/NodeStuffPlugin.js

@@ -5,6 +5,10 @@
 
 "use strict";
 
+const {
+	JAVASCRIPT_MODULE_TYPE_AUTO,
+	JAVASCRIPT_MODULE_TYPE_DYNAMIC
+} = require("./ModuleTypeConstants");
 const NodeStuffInWebError = require("./NodeStuffInWebError");
 const RuntimeGlobals = require("./RuntimeGlobals");
 const CachedConstDependency = require("./dependencies/CachedConstDependency");
@@ -17,12 +21,23 @@ const { relative } = require("./util/fs");
 const { parseResource } = require("./util/identifier");
 
 /** @typedef {import("webpack-sources").ReplaceSource} ReplaceSource */
+/** @typedef {import("../declarations/WebpackOptions").JavascriptParserOptions} JavascriptParserOptions */
+/** @typedef {import("../declarations/WebpackOptions").NodeOptions} NodeOptions */
 /** @typedef {import("./Compiler")} Compiler */
 /** @typedef {import("./Dependency")} Dependency */
+/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
 /** @typedef {import("./DependencyTemplates")} DependencyTemplates */
+/** @typedef {import("./NormalModule")} NormalModule */
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
+/** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
+/** @typedef {import("./javascript/JavascriptParser").Range} Range */
+
+const PLUGIN_NAME = "NodeStuffPlugin";
 
 class NodeStuffPlugin {
+	/**
+	 * @param {NodeOptions} options options
+	 */
 	constructor(options) {
 		this.options = options;
 	}
@@ -35,8 +50,13 @@ class NodeStuffPlugin {
 	apply(compiler) {
 		const options = this.options;
 		compiler.hooks.compilation.tap(
-			"NodeStuffPlugin",
+			PLUGIN_NAME,
 			(compilation, { normalModuleFactory }) => {
+				/**
+				 * @param {JavascriptParser} parser the parser
+				 * @param {JavascriptParserOptions} parserOptions options
+				 * @returns {void}
+				 */
 				const handler = (parser, parserOptions) => {
 					if (parserOptions.node === false) return;
 
@@ -47,50 +67,54 @@ class NodeStuffPlugin {
 
 					if (localOptions.global !== false) {
 						const withWarning = localOptions.global === "warn";
-						parser.hooks.expression
-							.for("global")
-							.tap("NodeStuffPlugin", expr => {
-								const dep = new ConstDependency(
-									RuntimeGlobals.global,
-									expr.range,
-									[RuntimeGlobals.global]
-								);
-								dep.loc = expr.loc;
-								parser.state.module.addPresentationalDependency(dep);
+						parser.hooks.expression.for("global").tap(PLUGIN_NAME, expr => {
+							const dep = new ConstDependency(
+								RuntimeGlobals.global,
+								/** @type {Range} */ (expr.range),
+								[RuntimeGlobals.global]
+							);
+							dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+							parser.state.module.addPresentationalDependency(dep);
 
-								// TODO webpack 6 remove
-								if (withWarning) {
-									parser.state.module.addWarning(
-										new NodeStuffInWebError(
-											dep.loc,
-											"global",
-											"The global namespace object is a Node.js feature and isn't available in browsers."
-										)
-									);
-								}
-							});
-						parser.hooks.rename.for("global").tap("NodeStuffPlugin", expr => {
+							// TODO webpack 6 remove
+							if (withWarning) {
+								parser.state.module.addWarning(
+									new NodeStuffInWebError(
+										dep.loc,
+										"global",
+										"The global namespace object is a Node.js feature and isn't available in browsers."
+									)
+								);
+							}
+						});
+						parser.hooks.rename.for("global").tap(PLUGIN_NAME, expr => {
 							const dep = new ConstDependency(
 								RuntimeGlobals.global,
-								expr.range,
+								/** @type {Range} */ (expr.range),
 								[RuntimeGlobals.global]
 							);
-							dep.loc = expr.loc;
+							dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 							parser.state.module.addPresentationalDependency(dep);
 							return false;
 						});
 					}
 
+					/**
+					 * @param {string} expressionName expression name
+					 * @param {(module: NormalModule) => string} fn function
+					 * @param {string=} warning warning
+					 * @returns {void}
+					 */
 					const setModuleConstant = (expressionName, fn, warning) => {
 						parser.hooks.expression
 							.for(expressionName)
-							.tap("NodeStuffPlugin", expr => {
+							.tap(PLUGIN_NAME, expr => {
 								const dep = new CachedConstDependency(
 									JSON.stringify(fn(parser.state.module)),
-									expr.range,
+									/** @type {Range} */ (expr.range),
 									expressionName
 								);
-								dep.loc = expr.loc;
+								dep.loc = /** @type {DependencyLocation} */ (expr.loc);
 								parser.state.module.addPresentationalDependency(dep);
 
 								// TODO webpack 6 remove
@@ -104,6 +128,12 @@ class NodeStuffPlugin {
 							});
 					};
 
+					/**
+					 * @param {string} expressionName expression name
+					 * @param {string} value value
+					 * @param {string=} warning warning
+					 * @returns {void}
+					 */
 					const setConstant = (expressionName, value, warning) =>
 						setModuleConstant(expressionName, () => value, warning);
 
@@ -129,7 +159,7 @@ class NodeStuffPlugin {
 
 						parser.hooks.evaluateIdentifier
 							.for("__filename")
-							.tap("NodeStuffPlugin", expr => {
+							.tap(PLUGIN_NAME, expr => {
 								if (!parser.state.module) return;
 								const resource = parseResource(parser.state.module.resource);
 								return evaluateToString(resource.path)(expr);
@@ -156,7 +186,7 @@ class NodeStuffPlugin {
 
 						parser.hooks.evaluateIdentifier
 							.for("__dirname")
-							.tap("NodeStuffPlugin", expr => {
+							.tap(PLUGIN_NAME, expr => {
 								if (!parser.state.module) return;
 								return evaluateToString(parser.state.module.context)(expr);
 							});
@@ -164,7 +194,7 @@ class NodeStuffPlugin {
 					parser.hooks.expression
 						.for("require.extensions")
 						.tap(
-							"NodeStuffPlugin",
+							PLUGIN_NAME,
 							expressionIsUnsupported(
 								parser,
 								"require.extensions is not supported by webpack. Use a loader instead."
@@ -173,11 +203,11 @@ class NodeStuffPlugin {
 				};
 
 				normalModuleFactory.hooks.parser
-					.for("javascript/auto")
-					.tap("NodeStuffPlugin", handler);
+					.for(JAVASCRIPT_MODULE_TYPE_AUTO)
+					.tap(PLUGIN_NAME, handler);
 				normalModuleFactory.hooks.parser
-					.for("javascript/dynamic")
-					.tap("NodeStuffPlugin", handler);
+					.for(JAVASCRIPT_MODULE_TYPE_DYNAMIC)
+					.tap(PLUGIN_NAME, handler);
 			}
 		);
 	}

package/lib/NormalModule.js

@@ -22,6 +22,7 @@ const ModuleBuildError = require("./ModuleBuildError");
 const ModuleError = require("./ModuleError");
 const ModuleGraphConnection = require("./ModuleGraphConnection");
 const ModuleParseError = require("./ModuleParseError");
+const { JAVASCRIPT_MODULE_TYPE_AUTO } = require("./ModuleTypeConstants");
 const ModuleWarning = require("./ModuleWarning");
 const RuntimeGlobals = require("./RuntimeGlobals");
 const UnhandledSchemeError = require("./UnhandledSchemeError");
@@ -64,12 +65,15 @@ const memoize = require("./util/memoize");
 /** @typedef {import("./Module").NeedBuildContext} NeedBuildContext */
 /** @typedef {import("./ModuleGraph")} ModuleGraph */
 /** @typedef {import("./ModuleGraphConnection").ConnectionState} ConnectionState */
+/** @typedef {import("./ModuleTypeConstants").JavaScriptModuleTypes} JavaScriptModuleTypes */
 /** @typedef {import("./NormalModuleFactory")} NormalModuleFactory */
 /** @typedef {import("./Parser")} Parser */
 /** @typedef {import("./RequestShortener")} RequestShortener */
 /** @typedef {import("./ResolverFactory").ResolverWithOptions} ResolverWithOptions */
 /** @typedef {import("./RuntimeTemplate")} RuntimeTemplate */
 /** @typedef {import("./logging/Logger").Logger} WebpackLogger */
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 /** @typedef {import("./util/Hash")} Hash */
 /** @typedef {import("./util/fs").InputFileSystem} InputFileSystem */
 /** @typedef {import("./util/runtime").RuntimeSpec} RuntimeSpec */
@@ -198,7 +202,7 @@ makeSerializable(
 /**
  * @typedef {Object} NormalModuleCreateData
  * @property {string=} layer an optional layer in which the module is
- * @property {string} type module type
+ * @property {JavaScriptModuleTypes | ""} type module type. When deserializing, this is set to an empty string "".
  * @property {string} request request string
  * @property {string} userRequest request intended by user (without loaders from config)
  * @property {string} rawRequest request without resolving
@@ -339,7 +343,7 @@ class NormalModule extends Module {
 	 */
 	identifier() {
 		if (this.layer === null) {
-			if (this.type === "javascript/auto") {
+			if (this.type === JAVASCRIPT_MODULE_TYPE_AUTO) {
 				return this.request;
 			} else {
 				return `${this.type}|${this.request}`;
@@ -1364,6 +1368,9 @@ class NormalModule extends Module {
 		super.updateHash(hash, context);
 	}
 
+	/**
+	 * @param {ObjectSerializerContext} context context
+	 */
 	serialize(context) {
 		const { write } = context;
 		// deserialize
@@ -1398,6 +1405,9 @@ class NormalModule extends Module {
 		return obj;
 	}
 
+	/**
+	 * @param {ObjectDeserializerContext} context context
+	 */
 	deserialize(context) {
 		const { read } = context;
 		this._source = read();