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

package/lib/dependencies/processExportInfo.js

@@ -7,18 +7,18 @@
 
 const { UsageState } = require("../ExportsInfo");
 
-/** @typedef {import("../Dependency").RawReferencedExports} RawReferencedExports */
-/** @typedef {import("../ExportsInfo").ExportInfo} ExportInfo */
-/** @typedef {import("../util/runtime").RuntimeSpec} RuntimeSpec */
+/** @import { RawReferencedExports } from "../Dependency" */
+/** @import { ExportInfo } from "../ExportsInfo" */
+/** @import { RuntimeSpec } from "../util/runtime" */
 
 /**
  * Process export info.
  * @param {RuntimeSpec} runtime the runtime
  * @param {RawReferencedExports} referencedExports list of referenced exports, will be added to
  * @param {string[]} prefix export prefix
- * @param {ExportInfo=} exportInfo the export info
+ * @param {InstanceType<ExportInfo>=} exportInfo the export info
  * @param {boolean} defaultPointsToSelf when true, using default will reference itself
- * @param {Set<ExportInfo>=} alreadyVisited already visited export info (to handle circular reexports)
+ * @param {Set<InstanceType<ExportInfo>>=} alreadyVisited already visited export info (to handle circular reexports)
  */
 const processExportInfo = (
 	runtime,

package/lib/dll/DelegatedModule.js

@@ -17,30 +17,42 @@ const DelegatedSourceDependency = require("../dependencies/DelegatedSourceDepend
 const StaticExportsDependency = require("../dependencies/StaticExportsDependency");
 const makeSerializable = require("../util/makeSerializable");
 
-/** @typedef {import("../../declarations/plugins/dll/DllReferencePlugin").DllReferencePluginOptions} DllReferencePluginOptions */
-/** @typedef {import("../config/defaults").WebpackOptionsNormalizedWithDefaults} WebpackOptions */
-/** @typedef {import("../Compilation")} Compilation */
-/** @typedef {import("../Dependency").UpdateHashContext} UpdateHashContext */
-/** @typedef {import("../Generator").SourceTypes} SourceTypes */
-/** @typedef {import("./LibManifestPlugin").ManifestModuleData} ManifestModuleData */
-/** @typedef {import("../Module").ModuleId} ModuleId */
-/** @typedef {import("../Module").BuildCallback} BuildCallback */
-/** @typedef {import("../Module").BuildMeta} BuildMeta */
-/** @typedef {import("../Module").CodeGenerationContext} CodeGenerationContext */
-/** @typedef {import("../Module").CodeGenerationResult} CodeGenerationResult */
-/** @typedef {import("../Module").LibIdentOptions} LibIdentOptions */
-/** @typedef {import("../Module").LibIdent} LibIdent */
-/** @typedef {import("../Module").NeedBuildCallback} NeedBuildCallback */
-/** @typedef {import("../Module").NeedBuildContext} NeedBuildContext */
-/** @typedef {import("../Module").Sources} Sources */
-/** @typedef {import("../Module").RuntimeRequirements} RuntimeRequirements */
-/** @typedef {import("../RequestShortener")} RequestShortener */
-/** @typedef {import("../ResolverFactory").ResolverWithOptions} ResolverWithOptions */
+/**
+ * @import {
+ * 	DllReferencePluginOptions
+ * } from "../../declarations/plugins/dll/DllReferencePlugin"
+ */
+/** @import { ModuleId } from "../ChunkGraph" */
+/**
+ * @import {
+ * 	WebpackOptionsNormalizedWithDefaults as WebpackOptions
+ * } from "../config/defaults"
+ */
+/** @import Compilation from "../Compilation" */
+/** @import { UpdateHashContext } from "../Dependency" */
+/** @import { ManifestModuleData } from "./LibManifestPlugin" */
+/**
+ * @import {
+ * 	BuildCallback,
+ * 	BuildMeta,
+ * 	CodeGenerationContext,
+ * 	CodeGenerationResult,
+ * 	LibIdentOptions,
+ * 	LibIdent,
+ * 	NeedBuildCallback,
+ * 	NeedBuildContext,
+ * 	Sources,
+ * 	RuntimeRequirements,
+ * 	SourceTypes
+ * } from "../Module"
+ */
+/** @import RequestShortener from "../RequestShortener" */
+/** @import { ResolverWithOptions } from "../ResolverFactory" */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<[DelegatedModuleSourceRequest, DelegatedModuleData, DelegatedModuleType, string, string | Module]>} ObjectDeserializerContext */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext<[DelegatedModuleSourceRequest, DelegatedModuleData, DelegatedModuleType, string, string | Module]>} ObjectSerializerContext */
-/** @typedef {import("../dependencies/StaticExportsDependency").Exports} Exports */
-/** @typedef {import("../util/Hash")} Hash */
-/** @typedef {import("../util/fs").InputFileSystem} InputFileSystem */
+/** @import { Exports } from "../dependencies/StaticExportsDependency" */
+/** @import Hash from "../util/Hash" */
+/** @import { InputFileSystem } from "../util/fs" */
 
 /** @typedef {string} DelegatedModuleSourceRequest */
 

package/lib/dll/DelegatedModuleFactoryPlugin.js

@@ -7,13 +7,21 @@
 
 const DelegatedModule = require("./DelegatedModule");
 
-/** @typedef {import("../../declarations/plugins/dll/DllReferencePlugin").DllReferencePluginOptions} DllReferencePluginOptions */
-/** @typedef {import("../../declarations/plugins/dll/DllReferencePlugin").DllReferencePluginOptionsContent} DllReferencePluginOptionsContent */
-/** @typedef {import("./DelegatedModule").DelegatedModuleData} DelegatedModuleData */
-/** @typedef {import("./DelegatedModule").DelegatedModuleSourceRequest} DelegatedModuleSourceRequest */
-/** @typedef {import("./DelegatedModule").DelegatedModuleType} DelegatedModuleType */
-/** @typedef {import("../NormalModuleFactory")} NormalModuleFactory */
-/** @typedef {import("../util/identifier").AssociatedObjectForCache} AssociatedObjectForCache */
+/**
+ * @import {
+ * 	DllReferencePluginOptions,
+ * 	DllReferencePluginOptionsContent
+ * } from "../../declarations/plugins/dll/DllReferencePlugin"
+ */
+/**
+ * @import {
+ * 	DelegatedModuleData,
+ * 	DelegatedModuleSourceRequest,
+ * 	DelegatedModuleType
+ * } from "./DelegatedModule"
+ */
+/** @import NormalModuleFactory from "../NormalModuleFactory" */
+/** @import { AssociatedObjectForCache } from "../util/identifier" */
 
 /**
  * Defines the options type used by this module.

package/lib/dll/DelegatedPlugin.js

@@ -8,8 +8,8 @@
 const DelegatedSourceDependency = require("../dependencies/DelegatedSourceDependency");
 const DelegatedModuleFactoryPlugin = require("./DelegatedModuleFactoryPlugin");
 
-/** @typedef {import("../Compiler")} Compiler */
-/** @typedef {import("./DelegatedModuleFactoryPlugin").Options} Options */
+/** @import Compiler from "../Compiler" */
+/** @import { Options } from "./DelegatedModuleFactoryPlugin" */
 
 const PLUGIN_NAME = "DelegatedPlugin";
 

package/lib/dll/DllEntryPlugin.js

@@ -9,8 +9,8 @@ const DllEntryDependency = require("../dependencies/DllEntryDependency");
 const EntryDependency = require("../dependencies/EntryDependency");
 const DllModuleFactory = require("./DllModuleFactory");
 
-/** @typedef {import("../Compiler")} Compiler */
-/** @typedef {import("../Entrypoint").EntryOptions} EntryOptions */
+/** @import Compiler from "../Compiler" */
+/** @import { EntryOptions } from "../Entrypoint" */
 
 /** @typedef {string[]} Entries */
 /** @typedef {EntryOptions & { name: string }} Options */

package/lib/dll/DllModule.js

@@ -15,23 +15,30 @@ const { JAVASCRIPT_MODULE_TYPE_DYNAMIC } = require("../ModuleTypeConstants");
 const RuntimeGlobals = require("../RuntimeGlobals");
 const makeSerializable = require("../util/makeSerializable");
 
-/** @typedef {import("../config/defaults").WebpackOptionsNormalizedWithDefaults} WebpackOptions */
-/** @typedef {import("../Compilation")} Compilation */
-/** @typedef {import("../Dependency")} Dependency */
-/** @typedef {import("../Dependency").UpdateHashContext} UpdateHashContext */
-/** @typedef {import("../Generator").SourceTypes} SourceTypes */
-/** @typedef {import("../Module").BuildCallback} BuildCallback */
-/** @typedef {import("../Module").CodeGenerationContext} CodeGenerationContext */
-/** @typedef {import("../Module").CodeGenerationResult} CodeGenerationResult */
-/** @typedef {import("../Module").NeedBuildCallback} NeedBuildCallback */
-/** @typedef {import("../Module").NeedBuildContext} NeedBuildContext */
-/** @typedef {import("../Module").Sources} Sources */
-/** @typedef {import("../RequestShortener")} RequestShortener */
-/** @typedef {import("../ResolverFactory").ResolverWithOptions} ResolverWithOptions */
+/**
+ * @import {
+ * 	WebpackOptionsNormalizedWithDefaults as WebpackOptions
+ * } from "../config/defaults"
+ */
+/** @import Compilation from "../Compilation" */
+/** @import Dependency, { UpdateHashContext } from "../Dependency" */
+/**
+ * @import {
+ * 	BuildCallback,
+ * 	CodeGenerationContext,
+ * 	CodeGenerationResult,
+ * 	NeedBuildCallback,
+ * 	NeedBuildContext,
+ * 	Sources,
+ * 	SourceTypes
+ * } from "../Module"
+ */
+/** @import RequestShortener from "../RequestShortener" */
+/** @import { ResolverWithOptions } from "../ResolverFactory" */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext<[string]>} ObjectDeserializerContext */
 /** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext<[string]>} ObjectSerializerContext */
-/** @typedef {import("../util/Hash")} Hash */
-/** @typedef {import("../util/fs").InputFileSystem} InputFileSystem */
+/** @import Hash from "../util/Hash" */
+/** @import { InputFileSystem } from "../util/fs" */
 
 const RUNTIME_REQUIREMENTS = new Set([
 	RuntimeGlobals.require,

package/lib/dll/DllModuleFactory.js

@@ -8,9 +8,13 @@
 const ModuleFactory = require("../ModuleFactory");
 const DllModule = require("./DllModule");
 
-/** @typedef {import("../ModuleFactory").ModuleFactoryCallback} ModuleFactoryCallback */
-/** @typedef {import("../ModuleFactory").ModuleFactoryCreateData} ModuleFactoryCreateData */
-/** @typedef {import("../dependencies/DllEntryDependency")} DllEntryDependency */
+/**
+ * @import {
+ * 	ModuleFactoryCallback,
+ * 	ModuleFactoryCreateData
+ * } from "../ModuleFactory"
+ */
+/** @import DllEntryDependency from "../dependencies/DllEntryDependency" */
 
 class DllModuleFactory extends ModuleFactory {
 	constructor() {

package/lib/dll/DllPlugin.js

@@ -9,11 +9,13 @@ const FlagAllModulesAsUsedPlugin = require("../FlagAllModulesAsUsedPlugin");
 const DllEntryPlugin = require("./DllEntryPlugin");
 const LibManifestPlugin = require("./LibManifestPlugin");
 
-/** @typedef {import("../../declarations/plugins/dll/DllPlugin").DllPluginOptions} DllPluginOptions */
-/** @typedef {import("../Compiler")} Compiler */
-/** @typedef {import("../Module").FactoryMeta} FactoryMeta */
-/** @typedef {import("./DllEntryPlugin").Entries} Entries */
-/** @typedef {import("./DllEntryPlugin").Options} Options */
+/**
+ * @import {
+ * 	DllPluginOptions
+ * } from "../../declarations/plugins/dll/DllPlugin"
+ */
+/** @import Compiler from "../Compiler" */
+/** @import { Entries, Options } from "./DllEntryPlugin" */
 
 const PLUGIN_NAME = "DllPlugin";
 

package/lib/dll/DllReferencePlugin.js

@@ -12,13 +12,16 @@ const { makePathsRelative } = require("../util/identifier");
 const parseJson = require("../util/parseJson");
 const DelegatedModuleFactoryPlugin = require("./DelegatedModuleFactoryPlugin");
 
-/** @typedef {import("../../declarations/WebpackOptions").Externals} Externals */
-/** @typedef {import("../../declarations/plugins/dll/DllReferencePlugin").DllReferencePluginOptions} DllReferencePluginOptions */
-/** @typedef {import("../../declarations/plugins/dll/DllReferencePlugin").DllReferencePluginOptionsContent} DllReferencePluginOptionsContent */
-/** @typedef {import("../../declarations/plugins/dll/DllReferencePlugin").DllReferencePluginOptionsManifest} DllReferencePluginOptionsManifest */
-/** @typedef {import("../Compiler")} Compiler */
-/** @typedef {import("../Compiler").CompilationParams} CompilationParams */
-/** @typedef {import("../util/fs").InputFileSystem} InputFileSystem */
+/** @import { Externals } from "../../declarations/WebpackOptions" */
+/**
+ * @import {
+ * 	DllReferencePluginOptions,
+ * 	DllReferencePluginOptionsContent,
+ * 	DllReferencePluginOptionsManifest
+ * } from "../../declarations/plugins/dll/DllReferencePlugin"
+ */
+/** @import Compiler, { CompilationParams } from "../Compiler" */
+/** @import { InputFileSystem } from "../util/fs" */
 
 /** @typedef {{ path: string, data: DllReferencePluginOptionsManifest | undefined, error: Error | undefined }} CompilationDataItem */
 

package/lib/dll/LibManifestPlugin.js

@@ -11,11 +11,11 @@ const { someInIterable } = require("../util/IterableHelpers");
 const { compareModulesById } = require("../util/comparators");
 const { dirname, mkdirp } = require("../util/fs");
 
-/** @typedef {import("../ChunkGraph").ModuleId} ModuleId */
-/** @typedef {import("../Compiler")} Compiler */
-/** @typedef {import("../Compiler").IntermediateFileSystem} IntermediateFileSystem */
-/** @typedef {import("../Module").BuildMeta} BuildMeta */
-/** @typedef {import("../ExportsInfo").ExportInfoName} ExportInfoName */
+/** @import { ModuleId } from "../ChunkGraph" */
+/** @import Compiler from "../Compiler" */
+/** @import { ExportInfoName } from "../Dependency" */
+/** @import { BuildMeta } from "../Module" */
+/** @import { IntermediateFileSystem } from "../util/fs" */
 
 /**
  * Defines the manifest module data type used by this module.

package/lib/electron/ElectronTargetPlugin.js

@@ -7,14 +7,49 @@
 
 const ExternalsPlugin = require("../ExternalsPlugin");
 
-/** @typedef {import("../../declarations/WebpackOptions").ExternalsType} ExternalsType */
-/** @typedef {import("../Compiler")} Compiler */
-/** @typedef {import("../Dependency")} Dependency */
+/** @import { ExternalsType } from "../../declarations/WebpackOptions" */
+/** @import Compiler from "../Compiler" */
+/** @import Dependency from "../Dependency" */
 /** @typedef {"main" | "preload" | "renderer"} ElectronContext */
 
+const SHARED_MODULES = [
+	"clipboard",
+	"crash-reporter",
+	"electron",
+	"ipc",
+	"native-image",
+	"original-fs",
+	"screen",
+	"shell"
+];
+
+const MAIN_MODULES = [
+	"app",
+	"auto-updater",
+	"browser-window",
+	"content-tracing",
+	"dialog",
+	"global-shortcut",
+	"ipc-main",
+	"menu",
+	"menu-item",
+	"power-monitor",
+	"power-save-blocker",
+	"protocol",
+	"session",
+	"tray",
+	"web-contents"
+];
+
+const RENDERER_MODULES = [
+	"desktop-capturer",
+	"ipc-renderer",
+	"remote",
+	"web-frame"
+];
+
 class ElectronTargetPlugin {
 	/**
-	 * Creates an instance of ElectronTargetPlugin.
 	 * @param {ElectronContext=} context in main, preload or renderer context?
 	 * @param {ExternalsType=} type default external type
 	 */
@@ -23,6 +58,15 @@ class ElectronTargetPlugin {
 		this._context = context;
 		/** @type {ExternalsType} */
 		this.type = type;
+
+		/**
+		 * @param {Dependency} dependency the dependency
+		 * @returns {ExternalsType} the external type
+		 */
+		this._externalType = (dependency) =>
+			// When `require`-ing electron built-in modules with module output
+			// we should still emit `node-commonjs` for compatibility
+			dependency.category === "commonjs" ? "node-commonjs" : this.type;
 	}
 
 	/**
@@ -31,59 +75,19 @@ class ElectronTargetPlugin {
 	 * @returns {void}
 	 */
 	apply(compiler) {
-		/**
-		 * @param {Dependency} dependency the dependency
-		 * @returns {ExternalsType} the external type
-		 */
-		const externalType = (dependency) => {
-			// When `require` electron built-in modules with module output
-			// we should still emit `node-commonjs` for compatibility
-			if (dependency.category === "commonjs") {
-				return "node-commonjs";
-			}
+		const externals = [...SHARED_MODULES];
 
-			return this.type;
-		};
-		new ExternalsPlugin(externalType, [
-			"clipboard",
-			"crash-reporter",
-			"electron",
-			"ipc",
-			"native-image",
-			"original-fs",
-			"screen",
-			"shell"
-		]).apply(compiler);
 		switch (this._context) {
 			case "main":
-				new ExternalsPlugin(externalType, [
-					"app",
-					"auto-updater",
-					"browser-window",
-					"content-tracing",
-					"dialog",
-					"global-shortcut",
-					"ipc-main",
-					"menu",
-					"menu-item",
-					"power-monitor",
-					"power-save-blocker",
-					"protocol",
-					"session",
-					"tray",
-					"web-contents"
-				]).apply(compiler);
+				externals.push(...MAIN_MODULES);
 				break;
 			case "preload":
 			case "renderer":
-				new ExternalsPlugin(externalType, [
-					"desktop-capturer",
-					"ipc-renderer",
-					"remote",
-					"web-frame"
-				]).apply(compiler);
+				externals.push(...RENDERER_MODULES);
 				break;
 		}
+
+		new ExternalsPlugin(this._externalType, externals).apply(compiler);
 	}
 }
 

package/lib/errors/AsyncChunkWaterfallWarning.js

@@ -0,0 +1,36 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Alexander Akait @alexander-akait
+*/
+
+"use strict";
+
+const WebpackError = require("./WebpackError");
+
+/**
+ * @typedef {object} WaterfallDetails
+ * @property {string[]} chain the chunk groups making up the chain, outermost first
+ * @property {number} size the bytes the chain loads in total
+ */
+
+class AsyncChunkWaterfallWarning extends WebpackError {
+	/**
+	 * Creates an instance of AsyncChunkWaterfallWarning.
+	 * @param {WaterfallDetails[]} waterfalls the chains that are too deep
+	 * @param {number} depth the depth the deepest of them reaches
+	 */
+	constructor(waterfalls, depth) {
+		const list = waterfalls
+			.map((it) => `\n  ${it.chain.join(" → ")} (${it.size} bytes)`)
+			.join("");
+
+		super(
+			`async chunk waterfall: ${waterfalls.length} ${waterfalls.length === 1 ? "chain loads" : "chains load"} ${depth} levels deep:${list}\nA chunk cannot be requested until the one importing it has arrived and run, so each level costs a round trip before anything below it starts. Importing the deeper modules from the entry, or giving them one 'webpackPrefetch' hint, lets them be fetched together.\nFor more info visit https://webpack.js.org/api/module-methods/#magic-comments`
+		);
+
+		/** @type {string} */
+		this.name = "AsyncChunkWaterfallWarning";
+	}
+}
+
+module.exports = AsyncChunkWaterfallWarning;

package/lib/errors/AsyncDependencyToInitialChunkError.js

@@ -7,8 +7,8 @@
 
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
-/** @typedef {import("../Module")} Module */
+/** @import { DependencyLocation } from "../Dependency" */
+/** @import Module from "../Module" */
 
 /**
  * Error raised when webpack detects an attempt to lazy-load a chunk name that

package/lib/errors/BroadContextsWarning.js

@@ -0,0 +1,43 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Alexander Akait @alexander-akait
+*/
+
+"use strict";
+
+const formatSize = require("../util/formatSize");
+const WebpackError = require("./WebpackError");
+
+/**
+ * @typedef {object} BroadContextDetails
+ * @property {string} name the context as written, shortened for the report
+ * @property {number} modules how many distinct modules it matched
+ * @property {number} size bytes those modules contribute
+ */
+
+class BroadContextsWarning extends WebpackError {
+	/**
+	 * Creates an instance of BroadContextsWarning.
+	 * @param {BroadContextDetails[]} contexts the worst offenders, largest first
+	 * @param {number} total how many broad contexts there are in all
+	 */
+	constructor(contexts, total) {
+		const list = contexts
+			.map(
+				(context) =>
+					`\n  ${context.name} (${context.modules} modules, ${formatSize(
+						context.size
+					)})`
+			)
+			.join("");
+
+		super(
+			`broad contexts: ${total} ${total === 1 ? "context matches" : "contexts match"} every file under a directory:${list}\nA pattern opening with a bare wildcard takes whatever the directory holds, including files nothing ever requests — a sync context bundles them all, a lazy one gives each its own chunk. Narrowing the pattern, or 'ContextReplacementPlugin', limits it to what is reachable.\nFor more info visit https://webpack.js.org/plugins/context-replacement-plugin/`
+		);
+
+		/** @type {string} */
+		this.name = "BroadContextsWarning";
+	}
+}
+
+module.exports = BroadContextsWarning;

package/lib/errors/BuildCycleError.js

@@ -7,7 +7,7 @@
 
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("../Module")} Module */
+/** @import Module from "../Module" */
 
 class BuildCycleError extends WebpackError {
 	/**

package/lib/errors/CacheEffectivenessWarning.js

@@ -0,0 +1,55 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Alexander Akait @alexander-akait
+*/
+
+"use strict";
+
+const WebpackError = require("./WebpackError");
+
+/**
+ * @typedef {object} CacheEffectiveness
+ * @property {number} total how many modules the compilation holds
+ * @property {number} rebuilt how many of them were built rather than reused
+ * @property {number} uncacheable how many can never be reused
+ * @property {string[]} reasons why they cannot, most frequent first
+ */
+
+class CacheEffectivenessWarning extends WebpackError {
+	/**
+	 * Creates an instance of CacheEffectivenessWarning.
+	 * @param {CacheEffectiveness} effectiveness what the compilation reused
+	 */
+	constructor({ total, rebuilt, uncacheable, reasons }) {
+		const lines = [];
+
+		// Only stated when something was reused, which is what proves the cache was
+		// warm — a cold build rebuilds everything by design.
+		if (rebuilt < total) {
+			lines.push(
+				`${rebuilt} of ${total} modules were rebuilt although the cache was warm.`
+			);
+		}
+
+		if (uncacheable > 0) {
+			lines.push(
+				`${uncacheable} ${
+					uncacheable === 1 ? "module is" : "modules are"
+				} not cacheable, so ${
+					uncacheable === 1 ? "it rebuilds" : "they rebuild"
+				} on every build: ${reasons.join(", ")}.`
+			);
+		}
+
+		super(
+			`module caching: ${lines.join(
+				" "
+			)}\nA loader calling 'this.cacheable(false)', or a value that changes every build, prevents reuse. Stats list the modules individually as '[not cacheable]'.\nFor more info visit https://webpack.js.org/configuration/cache/`
+		);
+
+		/** @type {string} */
+		this.name = "CacheEffectivenessWarning";
+	}
+}
+
+module.exports = CacheEffectivenessWarning;

package/lib/errors/ChunkRenderError.js

@@ -7,7 +7,7 @@
 
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("../Chunk")} Chunk */
+/** @import Chunk from "../Chunk" */
 
 class ChunkRenderError extends WebpackError {
 	/**

package/lib/errors/CircularDependenciesWarning.js

@@ -0,0 +1,38 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Alexander Akait @alexander-akait
+*/
+
+"use strict";
+
+const WebpackError = require("./WebpackError");
+
+/**
+ * @typedef {object} CircularDependencyDetails
+ * @property {number} size how many modules can all reach each other
+ * @property {string} cycle the shortest cycle through one of them
+ */
+
+class CircularDependenciesWarning extends WebpackError {
+	/**
+	 * Creates an instance of CircularDependenciesWarning.
+	 * @param {CircularDependencyDetails[]} groups the largest groups, biggest first
+	 * @param {number} total how many groups of modules import each other
+	 */
+	constructor(groups, total) {
+		const list = groups
+			.map((group) => `\n  ${group.size} modules: ${group.cycle}`)
+			.join("");
+
+		super(
+			`circular dependencies: ${total} ${
+				total === 1 ? "group of modules imports" : "groups of modules import"
+			} each other synchronously, shortest cycle of each shown:${list}\nOne module of a cycle runs before the others finished, so it reads their exports as 'undefined' — or throws for a 'const' or 'class' export. Moving the shared part into a module both sides import breaks the cycle.`
+		);
+
+		/** @type {string} */
+		this.name = "CircularDependenciesWarning";
+	}
+}
+
+module.exports = CircularDependenciesWarning;

package/lib/errors/CodeGenerationError.js

@@ -7,7 +7,7 @@
 
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("../Module")} Module */
+/** @import Module from "../Module" */
 
 class CodeGenerationError extends WebpackError {
 	/**

package/lib/errors/CommentCompilationWarning.js

@@ -8,7 +8,7 @@
 const makeSerializable = require("../util/makeSerializable");
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
+/** @import { DependencyLocation } from "../Dependency" */
 
 /**
  * Warning used for comment-related compilation issues, such as malformed magic