webpack 5.112.0 → 5.112.1

package/lib/asset/AssetGenerator.js

@@ -42,6 +42,7 @@ const { updateHashFromSource } = require("../util/source");
 
 const getMimeTypes = memoize(() => require("../util/mimeTypes"));
 
+/** @import { BuiltAssetModule, AssetNormalModule } from "./AssetModule" */
 /** @import { Source } from "webpack-sources" */
 /**
  * @import {
@@ -63,9 +64,7 @@ const getMimeTypes = memoize(() => require("../util/mimeTypes"));
  * 	SourceTypes
  * } from "../module/Module"
  */
-/** @import { AssetModuleBuildInfo } from "./AssetModule" */
 /** @import ModuleGraph from "../graph/ModuleGraph" */
-/** @import NormalModule from "../module/NormalModule" */
 /** @import RuntimeTemplate from "../template/RuntimeTemplate" */
 /** @import Hash from "../util/Hash" */
 /** @import { RuntimeSpec } from "../util/runtime" */
@@ -206,6 +205,14 @@ const decodeDataUriContent = (encoding, content) => {
 
 const DEFAULT_ENCODING = "base64";
 
+/**
+ * The module type the JSDoc inherited from `Generator` names.
+ * @typedef {AssetNormalModule} TModule
+ */
+
+/**
+ * @extends {Generator<TModule>}
+ */
 class AssetGenerator extends Generator {
 	/**
 	 * Creates an instance of AssetGenerator.
@@ -245,7 +252,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Gets source file name.
-	 * @param {NormalModule} module module
+	 * @param {TModule} module module
 	 * @param {RuntimeTemplate} runtimeTemplate runtime template
 	 * @returns {string} source file name
 	 */
@@ -260,13 +267,11 @@ class AssetGenerator extends Generator {
 	/**
 	 * The resource this asset is named after, which something that re-encoded it
 	 * may have changed. Its emitted name and inlined media type both read this.
-	 * @param {NormalModule} module module
+	 * @param {TModule} module module
 	 * @returns {string} the resource
 	 */
 	static getAssetResource(module) {
-		const buildInfo = /** @type {AssetModuleBuildInfo | undefined} */ (
-			module.buildInfo
-		);
+		const buildInfo = module.buildInfo;
 
 		return /** @type {string} */ (
 			(buildInfo && buildInfo.assetResource) || module.getResource()
@@ -278,7 +283,7 @@ class AssetGenerator extends Generator {
 	 * `experiments.futureDefaults` (the next major release's default) `[path]` and `[file]` of a
 	 * module outside of `context` behave like `[containedpath]`/`[containedfile]`,
 	 * so they can't emit the asset outside of `output.path`.
-	 * @param {NormalModule} module module
+	 * @param {TModule} module module
 	 * @param {RuntimeTemplate} runtimeTemplate runtime template
 	 * @returns {string} source file name for the filename template
 	 */
@@ -291,7 +296,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Gets full content hash.
-	 * @param {NormalModule} module module
+	 * @param {TModule} module module
 	 * @param {RuntimeTemplate} runtimeTemplate runtime template
 	 * @returns {[string, string]} return full hash and non-numeric full hash
 	 */
@@ -326,7 +331,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Gets filename with info.
-	 * @param {NormalModule} module module for which the code should be generated
+	 * @param {TModule} module module for which the code should be generated
 	 * @param {Pick<AssetResourceGeneratorOptions, "filename" | "outputPath">} generatorOptions generator options
 	 * @param {{ runtime: RuntimeSpec, runtimeTemplate: RuntimeTemplate, chunkGraph: ChunkGraph }} generateContext context for generate
 	 * @param {string} contentHash the content hash
@@ -384,7 +389,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Gets asset path with info.
-	 * @param {NormalModule} module module for which the code should be generated
+	 * @param {TModule} module module for which the code should be generated
 	 * @param {Pick<AssetResourceGeneratorOptions, "publicPath">} generatorOptions generator options
 	 * @param {GenerateContext} generateContext context for generate
 	 * @param {string} filename the filename
@@ -496,7 +501,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Returns the reason this module cannot be concatenated, when one exists.
-	 * @param {NormalModule} module module for which the bailout reason should be determined
+	 * @param {TModule} module module for which the bailout reason should be determined
 	 * @param {ConcatenationBailoutReasonContext} context context
 	 * @returns {string | undefined} reason why this module can't be concatenated, undefined when it can be concatenated
 	 */
@@ -506,7 +511,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Returns mime type.
-	 * @param {NormalModule} module module
+	 * @param {TModule} module module
 	 * @returns {string} mime type
 	 */
 	getMimeType(module) {
@@ -557,14 +562,14 @@ class AssetGenerator extends Generator {
 			);
 		}
 
-		return /** @type {string} */ (mimeType);
+		return mimeType;
 	}
 
 	/**
 	 * Offer the payload to `renderEmbeddedSource` before it is encoded, so the
 	 * encoding covers what came back. Declines what names no language, and a
 	 * `dataUrl` function, which is handed the source itself.
-	 * @param {NormalModule} module the module holding the payload
+	 * @param {TModule} module the module holding the payload
 	 * @param {GenerateContext["runtimeTemplate"]} runtimeTemplate runtime template
 	 * @returns {Source | undefined} the rendered payload, when one came back
 	 */
@@ -592,7 +597,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Generates data uri.
-	 * @param {NormalModule} module module for which the code should be generated
+	 * @param {TModule} module module for which the code should be generated
 	 * @param {Source=} renderedSource the payload to encode, when a hook rendered it
 	 * @returns {string} DataURI
 	 */
@@ -650,10 +655,7 @@ class AssetGenerator extends Generator {
 					/** @type {string} */ (source.source())
 				);
 			} else {
-				encodedContent = encodeDataUri(
-					/** @type {"base64" | false} */ (encoding),
-					source
-				);
+				encodedContent = encodeDataUri(encoding, source);
 			}
 
 			encodedSource = `data:${mimeType}${
@@ -666,7 +668,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Generates generated code for this runtime module.
-	 * @param {NormalModule} module module for which the code should be generated
+	 * @param {TModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
 	 */
@@ -684,12 +686,9 @@ class AssetGenerator extends Generator {
 
 		const needContent = type === JAVASCRIPT_TYPE || type === ASSET_URL_TYPE;
 		const data = getData ? getData() : undefined;
+		const { buildInfo } = /** @type {BuiltAssetModule} */ (module);
 
-		if (
-			/** @type {AssetModuleBuildInfo} */
-			(module.buildInfo).dataUrl &&
-			needContent
-		) {
+		if (buildInfo.dataUrl && needContent) {
 			// WHY: CSS and HTML serializers offer the payload in the `url()` or
 			// attribute it lands in, but the `asset-url` value is also what an
 			// analyzable `new URL` copies into JavaScript, which nothing re-reads.
@@ -716,8 +715,7 @@ class AssetGenerator extends Generator {
 				data.set("contentHash", contentHash);
 			}
 
-			/** @type {AssetModuleBuildInfo} */
-			(module.buildInfo).fullContentHash = fullContentHash;
+			buildInfo.fullContentHash = fullContentHash;
 
 			const { originalFilename, filename, assetInfo } =
 				AssetGenerator.getFilenameWithInfo(
@@ -762,11 +760,9 @@ class AssetGenerator extends Generator {
 			// Due to code generation caching module.buildInfo.XXX can't used to store such information
 			// It need to be stored in the code generation results instead, where it's cached too
 			// TODO in the next major release: remove the back-compat writes to module.buildInfo
-			/** @type {AssetModuleBuildInfo} */
-			(module.buildInfo).filename = filename;
+			buildInfo.filename = filename;
 
-			/** @type {AssetModuleBuildInfo} */
-			(module.buildInfo).assetInfo = newAssetInfo;
+			buildInfo.assetInfo = newAssetInfo;
 
 			content = assetPath;
 		}
@@ -797,7 +793,7 @@ class AssetGenerator extends Generator {
 	/**
 	 * Generates fallback output for the provided error condition.
 	 * @param {Error} error the error
-	 * @param {NormalModule} module module for which the code should be generated
+	 * @param {TModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
 	 */
@@ -847,7 +843,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Returns the source types available for this module.
-	 * @param {NormalModule} module fresh module
+	 * @param {TModule} module fresh module
 	 * @returns {SourceTypes} available types (do not mutate)
 	 */
 	getTypes(module) {
@@ -855,10 +851,7 @@ class AssetGenerator extends Generator {
 
 		// One that emits nothing has no name to build a literal from, so expose its url.
 		const emits =
-			!(
-				module.buildInfo &&
-				/** @type {AssetModuleBuildInfo} */ (module.buildInfo).dataUrl
-			) && this.emit !== false;
+			!(module.buildInfo && module.buildInfo.dataUrl) && this.emit !== false;
 
 		// WHY: only analyzable ESM output can drop a bare `new URL()` to an asset
 		// url; without it every JS consumer needs the wrapper, so the per-connection
@@ -960,7 +953,7 @@ class AssetGenerator extends Generator {
 
 	/**
 	 * Returns the estimated size for the requested source type.
-	 * @param {NormalModule} module the module
+	 * @param {TModule} module the module
 	 * @param {SourceType=} type source type
 	 * @returns {number} estimate size of the module
 	 */
@@ -976,10 +969,7 @@ class AssetGenerator extends Generator {
 				return originalSource.size();
 			}
 			default:
-				if (
-					module.buildInfo &&
-					/** @type {AssetModuleBuildInfo} */ (module.buildInfo).dataUrl
-				) {
+				if (module.buildInfo && module.buildInfo.dataUrl) {
 					const originalSource = module.originalSource();
 
 					if (!originalSource) {
@@ -999,15 +989,13 @@ class AssetGenerator extends Generator {
 	/**
 	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash hash that will be modified
-	 * @param {UpdateHashContext} updateHashContext context for updating hash
+	 * @param {UpdateHashContext<TModule>} updateHashContext context for updating hash
 	 */
 	updateHash(hash, updateHashContext) {
 		const { module } = updateHashContext;
+		const { buildInfo } = /** @type {BuiltAssetModule} */ (module);
 
-		if (
-			/** @type {AssetModuleBuildInfo} */
-			(module.buildInfo).dataUrl
-		) {
+		if (buildInfo.dataUrl) {
 			hash.update("data-url");
 			// What a tap varies on has to reach the key, or a changed option replays.
 			const { runtimeTemplate } = updateHashContext;

package/lib/asset/AssetModule.js

@@ -8,6 +8,7 @@ const NormalModule = require("../module/NormalModule");
 const makeSerializable = require("../util/makeSerializable");
 
 /** @import { AssetInfo } from "../Compilation" */
+/** @import { BuildMeta } from "../module/Module" */
 /**
  * @import {
  * 	NormalModuleBuildInfo,
@@ -29,6 +30,16 @@ const makeSerializable = require("../util/makeSerializable");
 
 /** @typedef {NormalModuleBuildInfo & KnownAssetModuleBuildInfo} AssetModuleBuildInfo */
 
+/**
+ * An asset module before or after its build, typed with its build info.
+ * @typedef {NormalModule & { buildInfo?: AssetModuleBuildInfo }} AssetNormalModule
+ */
+
+/**
+ * A built asset module, typed with its build info and build meta.
+ * @typedef {NormalModule & { buildInfo: AssetModuleBuildInfo, buildMeta: BuildMeta }} BuiltAssetModule
+ */
+
 /**
  * Module class for all `asset/*` modules. Asset-specific properties should live here instead of `NormalModule`.
  */

package/lib/asset/AssetModulesPlugin.js

@@ -43,9 +43,8 @@ const { PUBLIC_PATH_AUTO } = require("../util/publicPathPlaceholder");
  * } from "../Compilation"
  */
 /** @import Compiler from "../Compiler" */
-/** @import { AssetModuleBuildInfo } from "./AssetModule" */
+/** @import { AssetModuleBuildInfo, BuiltAssetModule } from "./AssetModule" */
 /** @import { CodeGenerationResult } from "../module/Module" */
-/** @import NormalModule from "../module/NormalModule" */
 
 /**
  * Returns definition.
@@ -345,7 +344,9 @@ class AssetModulesPlugin {
 								let entryHash;
 
 								if (errored) {
-									const erroredModule = /** @type {NormalModule} */ (module);
+									const erroredModule = /** @type {BuiltAssetModule} */ (
+										module
+									);
 									const AssetGenerator = getAssetGenerator.loaded();
 									const [fullContentHash, contentHash] =
 										AssetGenerator.getFullContentHash(
@@ -454,7 +455,7 @@ class AssetModulesPlugin {
 								// Icon URLs resolve relative to the manifest's own location.
 								const undoPath = getUndoPath(
 									filename,
-									/** @type {string} */ (outputOptions.path),
+									outputOptions.path,
 									false
 								);
 								const content = source

package/lib/asset/AssetParser.js

@@ -7,18 +7,21 @@
 
 const Parser = require("../module/Parser");
 
+/** @import { BuiltAssetModule } from "./AssetModule" */
 /**
  * @import {
  * 	AssetParserDataUrlOptions,
  * 	AssetParserOptions
  * } from "../../declarations/WebpackOptions"
  */
-/** @import Module, { BuildMeta } from "../module/Module" */
-/** @import { AssetModuleBuildInfo } from "./AssetModule" */
+/** @import Module from "../module/Module" */
 /** @import { ParserState, PreparsedAst } from "../module/Parser" */
 
 /** @typedef {((source: string | Buffer, context: { filename: string, module: Module }) => boolean)} AssetParserDataUrlFunction */
 
+/**
+ * @extends {Parser<BuiltAssetModule>}
+ */
 class AssetParser extends Parser {
 	/**
 	 * Creates an instance of AssetParser.
@@ -41,13 +44,10 @@ class AssetParser extends Parser {
 			throw new Error("AssetParser doesn't accept preparsed AST");
 		}
 
-		const buildInfo =
-			/** @type {AssetModuleBuildInfo} */
-			(state.module.buildInfo);
+		const { buildInfo, buildMeta } = /** @type {BuiltAssetModule} */ (
+			state.module
+		);
 		buildInfo.strict = true;
-		const buildMeta =
-			/** @type {BuildMeta} */
-			(state.module.buildMeta);
 		buildMeta.exportsType = "default";
 		buildMeta.defaultObject = false;
 

package/lib/asset/AssetSourceGenerator.js

@@ -21,6 +21,7 @@ const ConcatenationScope = require("../optimize/ConcatenationScope");
 const RuntimeGlobals = require("../runtime/RuntimeGlobals");
 const { languageOfFilename } = require("../util/dataURL");
 
+/** @import { AssetNormalModule } from "./AssetModule" */
 /** @import { Source } from "webpack-sources" */
 /** @import { GenerateContext, UpdateHashContext } from "../module/Generator" */
 /** @import Hash from "../util/Hash" */
@@ -32,8 +33,15 @@ const { languageOfFilename } = require("../util/dataURL");
  * } from "../module/Module"
  */
 /** @import ModuleGraph from "../graph/ModuleGraph" */
-/** @import NormalModule from "../module/NormalModule" */
 
+/**
+ * The module type the JSDoc inherited from `Generator` names.
+ * @typedef {AssetNormalModule} TModule
+ */
+
+/**
+ * @extends {Generator<TModule>}
+ */
 class AssetSourceGenerator extends Generator {
 	/**
 	 * Creates an instance of AssetSourceGenerator.
@@ -48,7 +56,7 @@ class AssetSourceGenerator extends Generator {
 
 	/**
 	 * Generates generated code for this runtime module.
-	 * @param {NormalModule} module module for which the code should be generated
+	 * @param {TModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
 	 */
@@ -111,7 +119,7 @@ class AssetSourceGenerator extends Generator {
 	/**
 	 * Offer the file's text to `renderEmbeddedSource` before it is embedded in
 	 * JavaScript. Declines a file whose name names no language webpack knows.
-	 * @param {NormalModule} module the module holding the text
+	 * @param {TModule} module the module holding the text
 	 * @param {string} text the file's text
 	 * @param {GenerateContext["runtimeTemplate"]} runtimeTemplate runtime template
 	 * @returns {string} the rendered text, or `text` when nothing rendered it
@@ -134,7 +142,7 @@ class AssetSourceGenerator extends Generator {
 	/**
 	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash hash that will be modified
-	 * @param {UpdateHashContext} updateHashContext context for updating hash
+	 * @param {UpdateHashContext<TModule>} updateHashContext context for updating hash
 	 */
 	updateHash(hash, updateHashContext) {
 		const { module, runtimeTemplate } = updateHashContext;
@@ -151,7 +159,7 @@ class AssetSourceGenerator extends Generator {
 	/**
 	 * Generates fallback output for the provided error condition.
 	 * @param {Error} error the error
-	 * @param {NormalModule} module module for which the code should be generated
+	 * @param {TModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
 	 */
@@ -173,7 +181,7 @@ class AssetSourceGenerator extends Generator {
 
 	/**
 	 * Returns the reason this module cannot be concatenated, when one exists.
-	 * @param {NormalModule} module module for which the bailout reason should be determined
+	 * @param {TModule} module module for which the bailout reason should be determined
 	 * @param {ConcatenationBailoutReasonContext} context context
 	 * @returns {string | undefined} reason why this module can't be concatenated, undefined when it can be concatenated
 	 */
@@ -183,7 +191,7 @@ class AssetSourceGenerator extends Generator {
 
 	/**
 	 * Returns the source types available for this module.
-	 * @param {NormalModule} module fresh module
+	 * @param {TModule} module fresh module
 	 * @returns {SourceTypes} available types (do not mutate)
 	 */
 	getTypes(module) {
@@ -223,7 +231,7 @@ class AssetSourceGenerator extends Generator {
 
 	/**
 	 * Returns the estimated size for the requested source type.
-	 * @param {NormalModule} module the module
+	 * @param {TModule} module the module
 	 * @param {SourceType=} type source type
 	 * @returns {number} estimate size of the module
 	 */

package/lib/asset/AssetSourceParser.js

@@ -7,9 +7,12 @@
 
 const Parser = require("../module/Parser");
 
-/** @import { BuildInfo, BuildMeta } from "../module/Module" */
+/** @import { BuiltAssetModule } from "./AssetModule" */
 /** @import { ParserState, PreparsedAst } from "../module/Parser" */
 
+/**
+ * @extends {Parser<BuiltAssetModule>}
+ */
 class AssetSourceParser extends Parser {
 	/**
 	 * Parses the provided source and updates the parser state.
@@ -21,13 +24,12 @@ class AssetSourceParser extends Parser {
 		if (typeof source === "object" && !Buffer.isBuffer(source)) {
 			throw new Error("AssetSourceParser doesn't accept preparsed AST");
 		}
-		const { module } = state;
-		/** @type {BuildInfo} */
-		(module.buildInfo).strict = true;
-		/** @type {BuildMeta} */
-		(module.buildMeta).exportsType = "default";
-		/** @type {BuildMeta} */
-		(state.module.buildMeta).defaultObject = false;
+		const { buildInfo, buildMeta } = /** @type {BuiltAssetModule} */ (
+			state.module
+		);
+		buildInfo.strict = true;
+		buildMeta.exportsType = "default";
+		buildMeta.defaultObject = false;
 
 		return state;
 	}

package/lib/asset/WebManifestGenerator.js

@@ -19,7 +19,7 @@ const AssetGenerator = require("./AssetGenerator");
 /** @import { GenerateContext } from "../module/Generator" */
 /** @import { SourceType, SourceTypes } from "../module/Module" */
 /** @import ModuleGraph from "../graph/ModuleGraph" */
-/** @import NormalModule from "../module/NormalModule" */
+/** @import { AssetNormalModule } from "./AssetModule" */
 
 const WEBMANIFEST_TYPE = "webmanifest";
 const WEBMANIFEST_TYPES = new Set([WEBMANIFEST_TYPE]);
@@ -28,6 +28,11 @@ const WEBMANIFEST_AND_ASSET_URL_TYPES = new Set([
 	ASSET_URL_TYPE
 ]);
 
+/**
+ * The module type the JSDoc inherited from `Generator` names.
+ * @typedef {AssetNormalModule} TModule
+ */
+
 /**
  * A Web App Manifest is a "typed asset": a variant of `AssetGenerator` (reusing
  * its filename/hash and `ASSET_URL_TYPE` machinery) whose emitted content is the
@@ -46,7 +51,7 @@ class WebManifestGenerator extends AssetGenerator {
 
 	/**
 	 * Returns the source types available for this module.
-	 * @param {NormalModule} module fresh module
+	 * @param {TModule} module fresh module
 	 * @returns {SourceTypes} available types (do not mutate)
 	 */
 	getTypes(module) {
@@ -58,7 +63,7 @@ class WebManifestGenerator extends AssetGenerator {
 
 	/**
 	 * Returns the estimated size for the requested source type.
-	 * @param {NormalModule} module the module
+	 * @param {TModule} module the module
 	 * @param {SourceType=} type source type
 	 * @returns {number} estimate size of the module
 	 */
@@ -69,7 +74,7 @@ class WebManifestGenerator extends AssetGenerator {
 
 	/**
 	 * Rewrites each icon `src` in the raw manifest to its emitted asset URL.
-	 * @param {NormalModule} module the manifest module
+	 * @param {TModule} module the manifest module
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {string} the rewritten manifest content
 	 */
@@ -111,7 +116,7 @@ class WebManifestGenerator extends AssetGenerator {
 
 	/**
 	 * Generates generated code for this runtime module.
-	 * @param {NormalModule} module module for which the code should be generated
+	 * @param {TModule} module module for which the code should be generated
 	 * @param {GenerateContext} generateContext context for generate
 	 * @returns {Source | null} generated code
 	 */
@@ -133,7 +138,7 @@ class WebManifestGenerator extends AssetGenerator {
 		);
 		const contentHash = nonNumericOnlyHash(
 			fullContentHash,
-			/** @type {number} */ (outputOptions.hashDigestLength)
+			outputOptions.hashDigestLength
 		);
 		const { filename, assetInfo } = AssetGenerator.getFilenameWithInfo(
 			module,

package/lib/asset/WebManifestParser.js

@@ -51,7 +51,7 @@ class WebManifestParser extends Parser {
 			source = source.slice(1);
 			leadingBytes = binary ? BOM_BYTE_LENGTH : 1;
 		}
-		const text = /** @type {string} */ (source);
+		const text = source;
 		const asciiOnly = !binary || Buffer.byteLength(text) === text.length;
 		/**
 		 * @param {number} offset offset in UTF-16 code units into `text`
@@ -121,8 +121,8 @@ class WebManifestParser extends Parser {
 						if (!buildHttp && ABSOLUTE_URL_SCHEME_REGEXP.test(url)) continue;
 						// acorn offsets are into `(${source})`; the leading `(` and the
 						// opening quote cancel, so the inner span is [start, end - 2].
-						const { start, end } = /** @type {Positioned} */ (
-							/** @type {unknown} */ (value)
+						const { start, end } = /** @type {Expression & Positioned} */ (
+							value
 						);
 						const dep = new HtmlSourceDependency(url, [
 							toSourceOffset(start),

package/lib/async-modules/AsyncModuleHelpers.js

@@ -35,7 +35,12 @@ const getOutgoingAsyncModules = (moduleGraph, module) => {
 				// Walk the imports in source order: the spec gathers these from
 				// `[[RequestedModules]]`, and their evaluation order is observable.
 				for (const dependency of module.dependencies) {
-					if (!isDependencyKind(dependency, "esm-import")) continue;
+					if (
+						!isDependencyKind(dependency, "esm-import") &&
+						!isDependencyKind(dependency, "provided")
+					) {
+						continue;
+					}
 					const referenced = moduleGraph.getModule(dependency);
 					if (!referenced || seen.has(referenced)) continue;
 					const connections = outgoingConnectionMap.get(referenced);
@@ -44,7 +49,8 @@ const getOutgoingAsyncModules = (moduleGraph, module) => {
 						connections.some(
 							(c) =>
 								c.dependency !== null &&
-								isDependencyKind(c.dependency, "esm-import") &&
+								(isDependencyKind(c.dependency, "esm-import") ||
+									isDependencyKind(c.dependency, "provided")) &&
 								c.isTargetActive(undefined)
 						)
 					) {

package/lib/async-modules/InferAsyncModulesPlugin.js

@@ -8,7 +8,7 @@
 const isDependencyKind = require("../graph/isDependencyKind");
 
 /** @import Compiler from "../Compiler" */
-/** @import Module from "../module/Module" */
+/** @import Module, { BuildMeta } from "../module/Module" */
 
 const PLUGIN_NAME = "InferAsyncModulesPlugin";
 
@@ -39,7 +39,12 @@ class InferAsyncModulesPlugin {
 							connections.some(
 								(c) =>
 									c.dependency !== null &&
-									isDependencyKind(c.dependency, "esm-import") &&
+									(isDependencyKind(c.dependency, "esm-import") ||
+										// only an ESM module has the async wrapper to await it in
+										(isDependencyKind(c.dependency, "provided") &&
+											/** @type {BuildMeta} */
+											(/** @type {Module} */ (originModule).buildMeta)
+												.exportsType === "namespace")) &&
 									c.isTargetActive(undefined)
 							)
 						) {

package/lib/cache/CacheFacade.js

@@ -42,7 +42,7 @@ class MultiItemCache {
 		this._items = items;
 		// @ts-expect-error expected - returns the single ItemCacheFacade when passed an array of length 1
 		// eslint-disable-next-line no-constructor-return
-		if (items.length === 1) return /** @type {ItemCacheFacade} */ (items[0]);
+		if (items.length === 1) return items[0];
 	}
 
 	/**

package/lib/cache/PackFileCacheStrategy.js

@@ -215,7 +215,7 @@ class Pack {
 		if (!this.content[loc]) {
 			return;
 		}
-		return /** @type {PackContent} */ (this.content[loc]).get(identifier);
+		return this.content[loc].get(identifier);
 	}
 
 	/**
@@ -328,7 +328,9 @@ class Pack {
 			let ignoreNextTimeTick = false;
 			const createNextPack = () => {
 				const loc = this._findLocation();
-				this.content[loc] = /** @type {EXPECTED_ANY} */ (null); // reserve
+				this.content[loc] = /** @type {PackContent} */ (
+					/** @type {PackContent | null} */ (null)
+				); // reserve
 				/** @type {PackItem} */
 				const pack = {
 					items: new Set(),
@@ -1010,9 +1012,7 @@ class PackContent {
 				);
 				logger.time(timeMessage);
 			}
-			const value =
-				/** @type {PackContentItems | Promise<PackContentItems>} */
-				(this.lazy());
+			const value = this.lazy();
 			if ("then" in value) {
 				return value.then((data) => {
 					if (timeMessage) {
@@ -1789,11 +1789,7 @@ class PackFileCacheStrategy {
 				const mtimeMs = await new Promise((resolve, reject) => {
 					fs.stat(file, (err, stats) => {
 						if (err) return reject(err);
-						resolve(
-							/** @type {number} */ (
-								/** @type {import("../fs/fs").IStats} */ (stats).mtimeMs
-							)
-						);
+						resolve(/** @type {import("../fs/fs").IStats} */ (stats).mtimeMs);
 					});
 				});
 				const entry = referencedFilesCache.get(name);