webpack 5.106.1 → 5.107.0

package/lib/{ModuleDependencyError.js → errors/ModuleDependencyError.js}

@@ -7,8 +7,8 @@
 
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
-/** @typedef {import("./Module")} Module */
+/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("../Module")} Module */
 /** @typedef {import("./ModuleBuildError").ErrorWithHideStack} ErrorWithHideStack */
 
 class ModuleDependencyError extends WebpackError {

package/lib/{ModuleDependencyWarning.js → errors/ModuleDependencyWarning.js}

@@ -5,15 +5,16 @@
 
 "use strict";
 
+const makeSerializable = require("../util/makeSerializable");
 const WebpackError = require("./WebpackError");
-const makeSerializable = require("./util/makeSerializable");
 
-/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
-/** @typedef {import("./Module")} Module */
+/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("../Module")} Module */
 /** @typedef {import("./ModuleDependencyError").ErrorWithHideStack} ErrorWithHideStack */
 
 class ModuleDependencyWarning extends WebpackError {
 	/**
+	 * Creates an instance of ModuleDependencyWarning.
 	 * @param {Module} module module tied to dependency
 	 * @param {ErrorWithHideStack} err error thrown
 	 * @param {DependencyLocation} loc location of dependency
@@ -43,7 +44,7 @@ class ModuleDependencyWarning extends WebpackError {
 
 makeSerializable(
 	ModuleDependencyWarning,
-	"webpack/lib/ModuleDependencyWarning"
+	"webpack/lib/errors/ModuleDependencyWarning"
 );
 
 module.exports = ModuleDependencyWarning;

package/lib/{ModuleError.js → errors/ModuleError.js}

@@ -5,12 +5,12 @@
 
 "use strict";
 
-const { cleanUp } = require("./ErrorHelpers");
+const { cleanUp } = require("../ErrorHelpers");
+const makeSerializable = require("../util/makeSerializable");
 const WebpackError = require("./WebpackError");
-const makeSerializable = require("./util/makeSerializable");
 
-/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 
 class ModuleError extends WebpackError {
 	/**
@@ -42,6 +42,7 @@ class ModuleError extends WebpackError {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -53,6 +54,7 @@ class ModuleError extends WebpackError {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -64,6 +66,6 @@ class ModuleError extends WebpackError {
 	}
 }
 
-makeSerializable(ModuleError, "webpack/lib/ModuleError");
+makeSerializable(ModuleError, "webpack/lib/errors/ModuleError");
 
 module.exports = ModuleError;

package/lib/{ModuleHashingError.js → errors/ModuleHashingError.js}

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

package/lib/{ModuleNotFoundError.js → errors/ModuleNotFoundError.js}

@@ -7,8 +7,8 @@
 
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
-/** @typedef {import("./Module")} Module */
+/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("../Module")} Module */
 
 const previouslyPolyfilledBuiltinModules = {
 	assert: "assert/",
@@ -43,6 +43,7 @@ const previouslyPolyfilledBuiltinModules = {
 
 class ModuleNotFoundError extends WebpackError {
 	/**
+	 * Creates an instance of ModuleNotFoundError.
 	 * @param {Module | null} module module tied to dependency
 	 * @param {Error & { details?: string }} err error thrown
 	 * @param {DependencyLocation} loc location of dependency

package/lib/{ModuleParseError.js → errors/ModuleParseError.js}

@@ -5,18 +5,19 @@
 
 "use strict";
 
+const makeSerializable = require("../util/makeSerializable");
 const WebpackError = require("./WebpackError");
-const makeSerializable = require("./util/makeSerializable");
 
-/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
-/** @typedef {import("./Dependency").SourcePosition} SourcePosition */
-/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("../Dependency").SourcePosition} SourcePosition */
+/** @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 {
 	/**
+	 * Creates an instance of ModuleParseError.
 	 * @param {string | Buffer} source source code
 	 * @param {Error & { loc?: SourcePosition }} err the parse error
 	 * @param {string[]} loaders the loaders used
@@ -93,11 +94,14 @@ class ModuleParseError extends WebpackError {
 
 		/** @type {string} */
 		this.name = "ModuleParseError";
+		/** @type {undefined | DependencyLocation} */
 		this.loc = loc;
+		/** @type {Error} */
 		this.error = err;
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -109,6 +113,7 @@ class ModuleParseError extends WebpackError {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -120,6 +125,6 @@ class ModuleParseError extends WebpackError {
 	}
 }
 
-makeSerializable(ModuleParseError, "webpack/lib/ModuleParseError");
+makeSerializable(ModuleParseError, "webpack/lib/errors/ModuleParseError");
 
 module.exports = ModuleParseError;

package/lib/{ModuleRestoreError.js → errors/ModuleRestoreError.js}

@@ -7,10 +7,11 @@
 
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("./Module")} Module */
+/** @typedef {import("../Module")} Module */
 
 class ModuleRestoreError extends WebpackError {
 	/**
+	 * Creates an instance of ModuleRestoreError.
 	 * @param {Module} module module tied to dependency
 	 * @param {string | Error} err error thrown
 	 */

package/lib/{ModuleStoreError.js → errors/ModuleStoreError.js}

@@ -7,10 +7,11 @@
 
 const WebpackError = require("./WebpackError");
 
-/** @typedef {import("./Module")} Module */
+/** @typedef {import("../Module")} Module */
 
 class ModuleStoreError extends WebpackError {
 	/**
+	 * Creates an instance of ModuleStoreError.
 	 * @param {Module} module module tied to dependency
 	 * @param {string | Error} err error thrown
 	 */

package/lib/{ModuleWarning.js → errors/ModuleWarning.js}

@@ -5,15 +5,16 @@
 
 "use strict";
 
-const { cleanUp } = require("./ErrorHelpers");
+const { cleanUp } = require("../ErrorHelpers");
+const makeSerializable = require("../util/makeSerializable");
 const WebpackError = require("./WebpackError");
-const makeSerializable = require("./util/makeSerializable");
 
-/** @typedef {import("./serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
-/** @typedef {import("./serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
 
 class ModuleWarning extends WebpackError {
 	/**
+	 * Creates an instance of ModuleWarning.
 	 * @param {Error} warning error thrown
 	 * @param {{ from?: string | null }} info additional info
 	 */
@@ -40,6 +41,7 @@ class ModuleWarning extends WebpackError {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -51,6 +53,7 @@ class ModuleWarning extends WebpackError {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {
@@ -62,7 +65,7 @@ class ModuleWarning extends WebpackError {
 	}
 }
 
-makeSerializable(ModuleWarning, "webpack/lib/ModuleWarning");
+makeSerializable(ModuleWarning, "webpack/lib/errors/ModuleWarning");
 
 /** @type {typeof ModuleWarning} */
 module.exports = ModuleWarning;

package/lib/{NodeStuffInWebError.js → errors/NodeStuffInWebError.js}

@@ -1,17 +1,18 @@
 /*
 	MIT License http://www.opensource.org/licenses/mit-license.php
-	Author Ivan Kopeykin @vankop
+	Author Tobias Koppers @sokra
 */
 
 "use strict";
 
-const WebpackError = require("./WebpackError");
-const makeSerializable = require("./util/makeSerializable");
+/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
 
-/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
+const makeSerializable = require("../util/makeSerializable");
+const WebpackError = require("./WebpackError");
 
 class NodeStuffInWebError extends WebpackError {
 	/**
+	 * Creates an instance of NodeStuffInWebError.
 	 * @param {DependencyLocation} loc loc
 	 * @param {string} expression expression
 	 * @param {string} description description

package/lib/errors/NonErrorEmittedError.js

@@ -0,0 +1,28 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Tobias Koppers @sokra
+*/
+
+"use strict";
+
+const makeSerializable = require("../util/makeSerializable");
+const WebpackError = require("./WebpackError");
+
+class NonErrorEmittedError extends WebpackError {
+	/**
+	 * @param {EXPECTED_ANY} error value which is not an instance of Error
+	 */
+	constructor(error) {
+		super();
+
+		this.name = "NonErrorEmittedError";
+		this.message = `(Emitted value instead of an instance of Error) ${error}`;
+	}
+}
+
+makeSerializable(
+	NonErrorEmittedError,
+	"webpack/lib/errors/NonErrorEmittedError"
+);
+
+module.exports = NonErrorEmittedError;

package/lib/{UnhandledSchemeError.js → errors/UnhandledSchemeError.js}

@@ -5,11 +5,17 @@
 
 "use strict";
 
+const makeSerializable = require("../util/makeSerializable");
 const WebpackError = require("./WebpackError");
-const makeSerializable = require("./util/makeSerializable");
 
+/**
+ * Error raised when webpack encounters a resource URI scheme that no installed
+ * plugin knows how to read.
+ */
 class UnhandledSchemeError extends WebpackError {
 	/**
+	 * Creates an error explaining that the current resource scheme is not
+	 * supported by the active plugin set.
 	 * @param {string} scheme scheme
 	 * @param {string} resource resource
 	 */
@@ -27,7 +33,7 @@ class UnhandledSchemeError extends WebpackError {
 
 makeSerializable(
 	UnhandledSchemeError,
-	"webpack/lib/UnhandledSchemeError",
+	"webpack/lib/errors/UnhandledSchemeError",
 	"UnhandledSchemeError"
 );
 

package/lib/{UnsupportedFeatureWarning.js → errors/UnsupportedFeatureWarning.js}

@@ -5,13 +5,14 @@
 
 "use strict";
 
+const makeSerializable = require("../util/makeSerializable");
 const WebpackError = require("./WebpackError");
-const makeSerializable = require("./util/makeSerializable");
 
-/** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
 
 class UnsupportedFeatureWarning extends WebpackError {
 	/**
+	 * Creates an instance of UnsupportedFeatureWarning.
 	 * @param {string} message description of warning
 	 * @param {DependencyLocation} loc location start and end positions of the module
 	 */
@@ -29,7 +30,7 @@ class UnsupportedFeatureWarning extends WebpackError {
 
 makeSerializable(
 	UnsupportedFeatureWarning,
-	"webpack/lib/UnsupportedFeatureWarning"
+	"webpack/lib/errors/UnsupportedFeatureWarning"
 );
 
 module.exports = UnsupportedFeatureWarning;

package/lib/errors/WebpackError.js

@@ -0,0 +1,84 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Jarid Margolin @jaridmargolin
+*/
+
+"use strict";
+
+const inspect = require("util").inspect.custom;
+const makeSerializable = require("../util/makeSerializable");
+
+/** @typedef {import("../Chunk")} Chunk */
+/** @typedef {import("../Dependency").DependencyLocation} DependencyLocation */
+/** @typedef {import("../Module")} Module */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectDeserializerContext} ObjectDeserializerContext */
+/** @typedef {import("../serialization/ObjectMiddleware").ObjectSerializerContext} ObjectSerializerContext */
+
+class WebpackError extends Error {
+	/**
+	 * Creates an instance of WebpackError.
+	 * @param {string=} message error message
+	 * @param {{ cause?: unknown }} options error options
+	 */
+	constructor(message, options = {}) {
+		super(message, options);
+
+		/** @type {string=} */
+		this.details = undefined;
+		/** @type {(Module | null)=} */
+		this.module = undefined;
+		/** @type {DependencyLocation=} */
+		this.loc = undefined;
+		/** @type {boolean=} */
+		this.hideStack = undefined;
+		/** @type {Chunk=} */
+		this.chunk = undefined;
+		/** @type {string=} */
+		this.file = undefined;
+	}
+
+	/**
+	 * Returns inspect message.
+	 * @returns {string} inspect message
+	 */
+	[inspect]() {
+		return (
+			this.stack +
+			(this.details ? `\n${this.details}` : "") +
+			(this.cause ? `\n${this.cause}` : "")
+		);
+	}
+
+	/**
+	 * Serializes this instance into the provided serializer context.
+	 * @param {ObjectSerializerContext} context context
+	 */
+	serialize({ write }) {
+		write(this.name);
+		write(this.message);
+		write(this.stack);
+		write(this.cause);
+		write(this.details);
+		write(this.loc);
+		write(this.hideStack);
+	}
+
+	/**
+	 * Restores this instance from the provided deserializer context.
+	 * @param {ObjectDeserializerContext} context context
+	 */
+	deserialize({ read }) {
+		this.name = read();
+		this.message = read();
+		this.stack = read();
+		this.cause = read();
+		this.details = read();
+		this.loc = read();
+		this.hideStack = read();
+	}
+}
+
+makeSerializable(WebpackError, "webpack/lib/errors/WebpackError");
+
+/** @type {typeof WebpackError} */
+module.exports = WebpackError;

package/lib/esm/ExportWebpackRequireRuntimeModule.js

@@ -13,6 +13,7 @@ class ExportWebpackRequireRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Returns true, if the runtime module should get it's own scope.
 	 * @returns {boolean} true, if the runtime module should get it's own scope
 	 */
 	shouldIsolate() {
@@ -20,6 +21,7 @@ class ExportWebpackRequireRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/esm/ModuleChunkFormatPlugin.js

@@ -29,6 +29,7 @@ const { getUndoPath } = require("../util/identifier");
 /** @typedef {import("../Entrypoint")} Entrypoint */
 
 /**
+ * Gets relative path.
  * @param {Compilation} compilation the compilation instance
  * @param {Chunk} chunk the chunk
  * @param {Chunk} runtimeChunk the runtime chunk
@@ -69,6 +70,7 @@ const getRelativePath = (compilation, chunk, runtimeChunk) => {
 };
 
 /**
+ * Renders chunk import.
  * @param {Compilation} compilation the compilation instance
  * @param {Chunk} chunk the chunk to render the import for
  * @param {string=} namedImport the named import to use for the import
@@ -82,6 +84,7 @@ function renderChunkImport(compilation, chunk, namedImport, runtimeChunk) {
 }
 
 /**
+ * Gets chunk named import.
  * @param {number} index the index of the chunk
  * @returns {string} the named import to use for the import
  */
@@ -93,7 +96,7 @@ const PLUGIN_NAME = "ModuleChunkFormatPlugin";
 
 class ModuleChunkFormatPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -111,6 +114,7 @@ class ModuleChunkFormatPlugin {
 			);
 			const hooks = getCompilationHooks(compilation);
 			/**
+			 * With dependent chunks.
 			 * @param {Iterable<Chunk>} chunks the chunks to render
 			 * @param {ChunkGraph} chunkGraph the chunk graph
 			 * @param {Chunk=} runtimeChunk the runtime chunk

package/lib/esm/ModuleChunkLoadingPlugin.js

@@ -17,7 +17,7 @@ const PLUGIN_NAME = "ModuleChunkLoadingPlugin";
 
 class ModuleChunkLoadingPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -25,6 +25,7 @@ class ModuleChunkLoadingPlugin {
 		compiler.hooks.thisCompilation.tap(PLUGIN_NAME, (compilation) => {
 			const globalChunkLoading = compilation.outputOptions.chunkLoading;
 			/**
+			 * Checks whether this module chunk loading plugin is enabled for chunk.
 			 * @param {Chunk} chunk chunk to check
 			 * @returns {boolean} true, when the plugin is enabled for the chunk
 			 */
@@ -39,6 +40,7 @@ class ModuleChunkLoadingPlugin {
 			/** @type {WeakSet<Chunk>} */
 			const onceForChunkSet = new WeakSet();
 			/**
+			 * Handles the hook callback for this code path.
 			 * @param {Chunk} chunk chunk to check
 			 * @param {RuntimeRequirements} set runtime requirements
 			 */

package/lib/esm/ModuleChunkLoadingRuntimeModule.js

@@ -25,6 +25,7 @@ const { getUndoPath } = require("../util/identifier");
 /** @typedef {import("../Module").ReadOnlyRuntimeRequirements} ReadOnlyRuntimeRequirements */
 
 /**
+ * Defines the jsonp compilation plugin hooks type used by this module.
  * @typedef {object} JsonpCompilationPluginHooks
  * @property {SyncWaterfallHook<[string, Chunk]>} linkPreload
  * @property {SyncWaterfallHook<[string, Chunk]>} linkPrefetch
@@ -35,6 +36,7 @@ const compilationHooksMap = new WeakMap();
 
 class ModuleChunkLoadingRuntimeModule extends RuntimeModule {
 	/**
+	 * Returns hooks.
 	 * @param {Compilation} compilation the compilation
 	 * @returns {JsonpCompilationPluginHooks} hooks
 	 */
@@ -56,6 +58,7 @@ class ModuleChunkLoadingRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Creates an instance of ModuleChunkLoadingRuntimeModule.
 	 * @param {ReadOnlyRuntimeRequirements} runtimeRequirements runtime requirements
 	 */
 	constructor(runtimeRequirements) {
@@ -65,6 +68,7 @@ class ModuleChunkLoadingRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Returns generated code.
 	 * @private
 	 * @param {Chunk} chunk chunk
 	 * @param {string} rootOutputDir root output directory
@@ -85,6 +89,7 @@ class ModuleChunkLoadingRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/hmr/HotModuleReplacementRuntimeModule.js

@@ -15,6 +15,7 @@ class HotModuleReplacementRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {

package/lib/hmr/JavascriptHotModuleReplacementHelper.js

@@ -10,6 +10,7 @@ const RuntimeGlobals = require("../RuntimeGlobals");
 const Template = require("../Template");
 
 /**
+ * Generates javascript hmr.
  * @param {string} type unique identifier used for HMR runtime properties
  * @returns {string} HMR runtime code
  */