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

package/lib/loaders/loadLoader.js

@@ -0,0 +1,100 @@
+/*
+	MIT License http://www.opensource.org/licenses/mit-license.php
+	Author Tobias Koppers @sokra
+*/
+
+"use strict";
+
+const { pathToFileURL } = require("url");
+const LoaderLoadingError = require("../errors/LoaderLoadingError");
+
+/** @typedef {import("./LoaderRunner").LoaderObject} LoaderObject */
+
+/**
+ * Lazily-compiled dynamic `import()`. Built on first use so this file still
+ * parses on Node versions without native `import()` (<13.2), then reused.
+ * @type {((url: URL) => Promise<EXPECTED_ANY>) | undefined}
+ */
+let importModule;
+
+/**
+ * @param {LoaderObject} loader the loader to load into
+ * @param {EXPECTED_ANY} module the loaded module
+ * @param {(err?: Error) => void} callback callback
+ * @returns {void}
+ */
+function handleResult(loader, module, callback) {
+	if (typeof module !== "function" && typeof module !== "object") {
+		return callback(
+			new LoaderLoadingError(
+				`Module '${loader.path}' is not a loader (export function or es6 module)`
+			)
+		);
+	}
+
+	loader.normal = typeof module === "function" ? module : module.default;
+	loader.pitch = module.pitch;
+	loader.raw = module.raw;
+
+	if (
+		typeof loader.normal !== "function" &&
+		typeof loader.pitch !== "function"
+	) {
+		return callback(
+			new LoaderLoadingError(
+				`Module '${loader.path}' is not a loader (must have normal or pitch function)`
+			)
+		);
+	}
+	callback();
+}
+
+/**
+ * @param {LoaderObject} loader the loader to load
+ * @param {(err?: Error) => void} callback callback
+ * @returns {void}
+ */
+function loadLoader(loader, callback) {
+	if (loader.type === "module") {
+		try {
+			if (importModule === undefined) {
+				// `eval` defers parsing `import()` to runtime, so this file stays
+				// loadable on Node versions that can't parse it (<13.2).
+				// eslint-disable-next-line no-eval
+				const dynamicImport = eval("(url) => import(url)");
+				importModule = /** @type {(url: URL) => Promise<EXPECTED_ANY>} */ (
+					dynamicImport
+				);
+			}
+
+			importModule(pathToFileURL(loader.path)).then(
+				(/** @type {EXPECTED_ANY} */ module) => {
+					handleResult(loader, module, callback);
+				},
+				callback
+			);
+		} catch (err) {
+			callback(/** @type {Error} */ (err));
+		}
+		return;
+	}
+
+	let loadedModule;
+	try {
+		loadedModule = require(loader.path);
+	} catch (err) {
+		// node can choke on require when the FD limit is hit; defer to recover.
+		if (
+			err instanceof Error &&
+			/** @type {NodeJS.ErrnoException} */ (err).code === "EMFILE"
+		) {
+			setImmediate(loadLoader, loader, callback);
+			return;
+		}
+		return callback(/** @type {Error} */ (err));
+	}
+
+	return handleResult(loader, loadedModule, callback);
+}
+
+module.exports = loadLoader;

package/lib/logging/Logger.js

@@ -42,6 +42,7 @@ const TIMERS_AGGREGATES_SYMBOL = Symbol("webpack logger aggregated times");
 
 class WebpackLogger {
 	/**
+	 * Creates an instance of WebpackLogger.
 	 * @param {LogFn} log log function
 	 * @param {GetChildLogger} getChildLogger function to create child logger
 	 */
@@ -53,6 +54,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	error(...args) {
@@ -60,6 +62,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	warn(...args) {
@@ -67,6 +70,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	info(...args) {
@@ -74,6 +78,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	log(...args) {
@@ -81,6 +86,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	debug(...args) {
@@ -88,6 +94,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided condition.
 	 * @param {boolean=} condition condition
 	 * @param {Args} args args
 	 */
@@ -106,6 +113,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	status(...args) {
@@ -113,6 +121,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	group(...args) {
@@ -120,6 +129,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided arg.
 	 * @param {Args} args args
 	 */
 	groupCollapsed(...args) {
@@ -131,6 +141,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	profile(label) {
@@ -138,6 +149,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	profileEnd(label) {
@@ -145,6 +157,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string} label label
 	 */
 	time(label) {
@@ -154,6 +167,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	timeLog(label) {
@@ -166,6 +180,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	timeEnd(label) {
@@ -180,6 +195,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Processes the provided label.
 	 * @param {string=} label label
 	 */
 	timeAggregate(label) {
@@ -209,6 +225,7 @@ class WebpackLogger {
 	}
 
 	/**
+	 * Time aggregate end.
 	 * @param {string=} label label
 	 */
 	timeAggregateEnd(label) {

package/lib/logging/createConsoleLogger.js

@@ -16,6 +16,7 @@ const { LogType } = require("./Logger");
 /** @typedef {(value: string, type: LogTypeEnum, args?: Args) => void} LoggingFunction */
 
 /**
+ * Defines the logger console type used by this module.
  * @typedef {object} LoggerConsole
  * @property {() => void} clear
  * @property {() => void} trace
@@ -34,6 +35,7 @@ const { LogType } = require("./Logger");
  */
 
 /**
+ * Defines the logger options type used by this module.
  * @typedef {object} LoggerOptions
  * @property {false | true | "none" | "error" | "warn" | "info" | "log" | "verbose"} level loglevel
  * @property {FilterTypes | boolean} debug filter for debug logging
@@ -41,6 +43,7 @@ const { LogType } = require("./Logger");
  */
 
 /**
+ * Filter to function.
  * @param {FilterItemTypes} item an input item
  * @returns {FilterFunction | undefined} filter function
  */
@@ -63,6 +66,7 @@ const filterToFunction = (item) => {
 };
 
 /**
+ * Enumerates the available values.
  * @enum {number}
  */
 const LogLevel = {
@@ -77,6 +81,7 @@ const LogLevel = {
 };
 
 /**
+ * Returns logging function.
  * @param {LoggerOptions} options options object
  * @returns {LoggingFunction} logging function
  */
@@ -93,6 +98,7 @@ module.exports = ({ level = "info", debug = false, console }) => {
 	const loglevel = LogLevel[`${level}`] || 0;
 
 	/**
+	 * Processes the provided name.
 	 * @param {string} name name of the logger
 	 * @param {LogTypeEnum} type type of the log entry
 	 * @param {Args=} args arguments of the log entry
@@ -100,6 +106,7 @@ module.exports = ({ level = "info", debug = false, console }) => {
 	 */
 	const logger = (name, type, args) => {
 		/**
+		 * Returns labeled args.
 		 * @template T
 		 * @returns {[string?, ...T[]]} labeled args
 		 */

package/lib/logging/runtime.js

@@ -18,6 +18,7 @@ const currentDefaultLoggerOptions = {
 let currentDefaultLogger = createConsoleLogger(currentDefaultLoggerOptions);
 
 /**
+ * Processes the provided create console logger.logger option.
  * @param {createConsoleLogger.LoggerOptions} options new options, merge with old options
  * @returns {void}
  */
@@ -27,6 +28,7 @@ module.exports.configureDefaultLogger = (options) => {
 };
 
 /**
+ * Returns a logger.
  * @param {string} name name of the logger
  * @returns {Logger} a logger
  */

package/lib/logging/truncateArgs.js

@@ -6,6 +6,7 @@
 "use strict";
 
 /**
+ * Returns sum of all numbers in array.
  * @param {number[]} array array of numbers
  * @returns {number} sum of all numbers in array
  */
@@ -16,6 +17,7 @@ const arraySum = (array) => {
 };
 
 /**
+ * Returns truncated args.
  * @param {string[]} args items to be truncated
  * @param {number} maxLength maximum length of args including spaces between
  * @returns {string[]} truncated args

package/lib/node/CommonJsChunkLoadingPlugin.js

@@ -13,6 +13,7 @@ const StartupChunkDependenciesPlugin = require("../runtime/StartupChunkDependenc
 /** @typedef {import("../Module").RuntimeRequirements} RuntimeRequirements */
 
 /**
+ * Defines the common js chunk loading plugin options type used by this module.
  * @typedef {object} CommonJsChunkLoadingPluginOptions
  * @property {boolean=} asyncChunkLoading enable async chunk loading
  */
@@ -21,6 +22,7 @@ const PLUGIN_NAME = "CommonJsChunkLoadingPlugin";
 
 class CommonJsChunkLoadingPlugin {
 	/**
+	 * Creates an instance of CommonJsChunkLoadingPlugin.
 	 * @param {CommonJsChunkLoadingPluginOptions=} options options
 	 */
 	constructor(options = {}) {
@@ -29,7 +31,7 @@ class CommonJsChunkLoadingPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -47,6 +49,7 @@ class CommonJsChunkLoadingPlugin {
 		compiler.hooks.thisCompilation.tap(PLUGIN_NAME, (compilation) => {
 			const globalChunkLoading = compilation.outputOptions.chunkLoading;
 			/**
+			 * Checks whether this common js chunk loading plugin is enabled for chunk.
 			 * @param {Chunk} chunk chunk
 			 * @returns {boolean} true, if wasm loading is enabled for the chunk
 			 */
@@ -61,6 +64,7 @@ class CommonJsChunkLoadingPlugin {
 			/** @type {WeakSet<Chunk>} */
 			const onceForChunkSet = new WeakSet();
 			/**
+			 * Handles the hook callback for this code path.
 			 * @param {Chunk} chunk chunk
 			 * @param {RuntimeRequirements} set runtime requirements
 			 */

package/lib/node/NodeEnvironmentPlugin.js

@@ -5,7 +5,7 @@
 
 "use strict";
 
-const CachedInputFileSystem = require("enhanced-resolve").CachedInputFileSystem;
+const { CachedInputFileSystem } = require("enhanced-resolve");
 const fs = require("graceful-fs");
 const createConsoleLogger = require("../logging/createConsoleLogger");
 const NodeWatchFileSystem = require("./NodeWatchFileSystem");
@@ -16,6 +16,7 @@ const nodeConsole = require("./nodeConsole");
 /** @typedef {import("../util/fs").InputFileSystem} InputFileSystem */
 
 /**
+ * Defines the node environment plugin options type used by this module.
  * @typedef {object} NodeEnvironmentPluginOptions
  * @property {InfrastructureLogging} infrastructureLogging infrastructure logging options
  */
@@ -24,6 +25,7 @@ const PLUGIN_NAME = "NodeEnvironmentPlugin";
 
 class NodeEnvironmentPlugin {
 	/**
+	 * Creates an instance of NodeEnvironmentPlugin.
 	 * @param {NodeEnvironmentPluginOptions} options options
 	 */
 	constructor(options) {
@@ -32,7 +34,7 @@ class NodeEnvironmentPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -48,9 +50,11 @@ class NodeEnvironmentPlugin {
 					appendOnly: infrastructureLogging.appendOnly,
 					stream:
 						/** @type {NodeJS.WritableStream} */
-						(infrastructureLogging.stream)
+						(infrastructureLogging.stream),
+					compiler
 				})
 		});
+		// @ts-expect-error need to fix on enhanced-resolve side
 		compiler.inputFileSystem = new CachedInputFileSystem(fs, 60000);
 		const inputFileSystem =
 			/** @type {InputFileSystem} */

package/lib/node/NodeSourcePlugin.js

@@ -9,7 +9,7 @@
 
 class NodeSourcePlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/node/NodeTargetPlugin.js

@@ -6,74 +6,14 @@
 "use strict";
 
 const ExternalsPlugin = require("../ExternalsPlugin");
+const { builtins } = require("./nodeBuiltins");
 
 /** @typedef {import("../../declarations/WebpackOptions").ExternalsType} ExternalsType */
 /** @typedef {import("../Compiler")} Compiler */
 
-const builtins = [
-	"assert",
-	"assert/strict",
-	"async_hooks",
-	"buffer",
-	"child_process",
-	"cluster",
-	"console",
-	"constants",
-	"crypto",
-	"dgram",
-	"diagnostics_channel",
-	"dns",
-	"dns/promises",
-	"domain",
-	"events",
-	"fs",
-	"fs/promises",
-	"http",
-	"http2",
-	"https",
-	"inspector",
-	"inspector/promises",
-	"module",
-	"net",
-	"os",
-	"path",
-	"path/posix",
-	"path/win32",
-	"perf_hooks",
-	"process",
-	"punycode",
-	"querystring",
-	"readline",
-	"readline/promises",
-	"repl",
-	"stream",
-	"stream/consumers",
-	"stream/promises",
-	"stream/web",
-	"string_decoder",
-	"sys",
-	"timers",
-	"timers/promises",
-	"tls",
-	"trace_events",
-	"tty",
-	"url",
-	"util",
-	"util/types",
-	"v8",
-	"vm",
-	"wasi",
-	"worker_threads",
-	"zlib",
-	/^node:/,
-
-	// cspell:word pnpapi
-	// Yarn PnP adds pnpapi as "builtin"
-	"pnpapi"
-];
-
 class NodeTargetPlugin {
 	/**
+	 * Creates an instance of NodeTargetPlugin.
 	 * @param {ExternalsType} type default external type
 	 */
 	constructor(type = "node-commonjs") {
@@ -82,7 +22,7 @@ class NodeTargetPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -100,3 +40,4 @@ class NodeTargetPlugin {
 }
 
 module.exports = NodeTargetPlugin;
+module.exports.builtins = builtins;

package/lib/node/NodeTemplatePlugin.js

@@ -11,12 +11,14 @@ const EnableChunkLoadingPlugin = require("../javascript/EnableChunkLoadingPlugin
 /** @typedef {import("../Compiler")} Compiler */
 
 /**
+ * Represents the node template plugin runtime component.
  * @typedef {object} NodeTemplatePluginOptions
  * @property {boolean=} asyncChunkLoading enable async chunk loading
  */
 
 class NodeTemplatePlugin {
 	/**
+	 * Creates an instance of NodeTemplatePlugin.
 	 * @param {NodeTemplatePluginOptions=} options options object
 	 */
 	constructor(options = {}) {
@@ -25,7 +27,7 @@ class NodeTemplatePlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/node/NodeWatchFileSystem.js

@@ -8,6 +8,7 @@
 const util = require("util");
 const Watchpack = require("watchpack");
 
+/** @typedef {InstanceType<import("watchpack")>} Watchpack */
 /** @typedef {import("watchpack").TimeInfoEntries} TimeInfoEntries */
 /** @typedef {import("watchpack").WatchOptions} WatchOptions */
 /** @typedef {import("../util/fs").InputFileSystem} InputFileSystem */
@@ -17,6 +18,7 @@ const Watchpack = require("watchpack");
 
 class NodeWatchFileSystem {
 	/**
+	 * Creates an instance of NodeWatchFileSystem.
 	 * @param {InputFileSystem} inputFileSystem input filesystem
 	 */
 	constructor(inputFileSystem) {
@@ -81,9 +83,45 @@ class NodeWatchFileSystem {
 			}
 			return { fileTimeInfoEntries, contextTimeInfoEntries };
 		};
+		const directoriesSet =
+			directories instanceof Set ? directories : new Set(directories);
+
+		// Watchpack reports a watched directory (a context dependency) in
+		// `changes` whenever its contents change, alongside the individual
+		// file events. The default `fs.purge(dir)` matches cache keys by
+		// prefix, so it would wipe the stat cache of every file inside the
+		// directory even though only file-level events actually invalidate
+		// file stats. For directories we explicitly watch, purge only the
+		// directory's own entry (`{ exact: true }`, enhanced-resolve >=
+		// 5.22.0); file-level events in the same aggregated batch still
+		// handle file stats and the parent readdir invalidation.
+		/**
+		 * @param {Changes | null | undefined} changes changes set
+		 * @param {Removals | null | undefined} removals removals set
+		 */
+		const purgeChanges = (changes, removals) => {
+			const fs = this.inputFileSystem;
+			if (!fs || !fs.purge) return;
+			if (changes) {
+				for (const item of changes) {
+					if (directoriesSet.has(item)) {
+						fs.purge(item, { exact: true });
+					} else {
+						fs.purge(item);
+					}
+				}
+			}
+			if (removals) {
+				for (const item of removals) {
+					fs.purge(item);
+				}
+			}
+		};
+
 		this.watcher.once(
 			"aggregated",
 			/**
+			 * Handles the callback logic for this hook.
 			 * @param {Changes} changes changes
 			 * @param {Removals} removals removals
 			 */
@@ -92,15 +130,7 @@ class NodeWatchFileSystem {
 				/** @type {Watchpack} */
 				(this.watcher).pause();
 
-				const fs = this.inputFileSystem;
-				if (fs && fs.purge) {
-					for (const item of changes) {
-						fs.purge(item);
-					}
-					for (const item of removals) {
-						fs.purge(item);
-					}
-				}
+				purgeChanges(changes, removals);
 				const { fileTimeInfoEntries, contextTimeInfoEntries } = fetchTimeInfo();
 				callback(
 					null,
@@ -170,19 +200,7 @@ class NodeWatchFileSystem {
 			getInfo: () => {
 				const removals = this.watcher && this.watcher.aggregatedRemovals;
 				const changes = this.watcher && this.watcher.aggregatedChanges;
-				const fs = this.inputFileSystem;
-				if (fs && fs.purge) {
-					if (removals) {
-						for (const item of removals) {
-							fs.purge(item);
-						}
-					}
-					if (changes) {
-						for (const item of changes) {
-							fs.purge(item);
-						}
-					}
-				}
+				purgeChanges(changes, removals);
 				const { fileTimeInfoEntries, contextTimeInfoEntries } = fetchTimeInfo();
 				return {
 					changes,

package/lib/node/ReadFileChunkLoadingRuntimeModule.js

@@ -26,6 +26,7 @@ const { getUndoPath } = require("../util/identifier");
 
 class ReadFileChunkLoadingRuntimeModule extends RuntimeModule {
 	/**
+	 * Creates an instance of ReadFileChunkLoadingRuntimeModule.
 	 * @param {ReadOnlyRuntimeRequirements} runtimeRequirements runtime requirements
 	 */
 	constructor(runtimeRequirements) {
@@ -35,6 +36,7 @@ class ReadFileChunkLoadingRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Returns generated code.
 	 * @private
 	 * @param {Chunk} chunk chunk
 	 * @param {string} rootOutputDir root output directory
@@ -55,6 +57,7 @@ class ReadFileChunkLoadingRuntimeModule extends RuntimeModule {
 	}
 
 	/**
+	 * Generates runtime code for this runtime module.
 	 * @returns {string | null} runtime code
 	 */
 	generate() {
@@ -99,6 +102,11 @@ class ReadFileChunkLoadingRuntimeModule extends RuntimeModule {
 		const stateExpression = withHmr
 			? `${RuntimeGlobals.hmrRuntimeStatePrefix}_readFileVm`
 			: undefined;
+		const installedChunksObject = `{\n${Template.indent(
+			Array.from(initialChunkIds, (id) => `${JSON.stringify(id)}: 0`).join(
+				",\n"
+			)
+		)}\n}`;
 
 		return Template.asString([
 			withBaseURI
@@ -108,14 +116,10 @@ class ReadFileChunkLoadingRuntimeModule extends RuntimeModule {
 			"// object to store loaded chunks",
 			'// "0" means "already loaded", Promise means loading',
 			`var installedChunks = ${
-				stateExpression ? `${stateExpression} = ${stateExpression} || ` : ""
-			}{`,
-			Template.indent(
-				Array.from(initialChunkIds, (id) => `${JSON.stringify(id)}: 0`).join(
-					",\n"
-				)
-			),
-			"};",
+				stateExpression
+					? runtimeTemplate.assignOr(stateExpression, installedChunksObject)
+					: installedChunksObject
+			};`,
 			"",
 			withOnChunkLoad
 				? `${
@@ -234,7 +238,7 @@ class ReadFileChunkLoadingRuntimeModule extends RuntimeModule {
 										`if(${RuntimeGlobals.hasOwnProperty}(updatedModules, moduleId)) {`,
 										Template.indent([
 											"currentUpdate[moduleId] = updatedModules[moduleId];",
-											"if(updatedModulesList) updatedModulesList.push(moduleId);"
+											`${runtimeTemplate.optionalChaining("updatedModulesList", "push(moduleId)")};`
 										]),
 										"}"
 									]),