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

package/README.md

@@ -13,26 +13,24 @@ npm install @depup/webpack
 
 | Field | Value |
 |-------|-------|
-| Original | [webpack](https://www.npmjs.com/package/webpack) @ 5.106.1 |
-| Processed | 2026-04-10 |
+| Original | [webpack](https://www.npmjs.com/package/webpack) @ 5.109.2 |
+| Processed | 2026-08-02 |
 | Smoke test | passed |
-| Deps updated | 11 |
+| Deps updated | 9 |
 
 ## Dependency Changes
 
 | Dependency | From | To |
 |------------|------|-----|
-| @types/eslint-scope | ^3.7.7 | ^9.1.0 |
-| acorn-import-phases | ^1.0.3 | ^1.0.4 |
-| browserslist | ^4.28.1 | ^4.28.2 |
+| @types/estree | ^1.0.8 | ^1.0.9 |
+| acorn | ^8.16.0 | ^8.18.0 |
+| browserslist | ^4.28.1 | ^4.28.7 |
 | chrome-trace-event | ^1.0.2 | ^1.0.4 |
-| enhanced-resolve | ^5.20.0 | ^5.20.1 |
+| enhanced-resolve | ^5.24.4 | ^5.24.5 |
+| es-module-lexer | ^2.1.0 | ^2.3.1 |
 | eslint-scope | 5.1.1 | ^9.1.2 |
 | events | ^3.2.0 | ^3.3.0 |
-| json-parse-even-better-errors | ^2.3.1 | ^5.0.0 |
-| mime-types | ^2.1.27 | ^3.0.2 |
-| tapable | ^2.3.0 | ^2.3.2 |
-| terser-webpack-plugin | ^5.3.17 | ^5.4.0 |
+| tapable | ^2.3.0 | ^2.3.3 |
 
 ---
 

package/bin/webpack.js

@@ -2,6 +2,18 @@
 
 "use strict";
 
+// Cache compiled module bytecode on disk (available since Node.js 22.8)
+// eslint-disable-next-line n/no-unsupported-features/node-builtins
+const { enableCompileCache } = require("module");
+
+if (enableCompileCache) {
+	try {
+		enableCompileCache();
+	} catch (_error) {
+		// Nothing
+	}
+}
+
 /**
  * @param {string} command process to run
  * @param {string[]} args command line arguments

package/changes.json

@@ -1,24 +1,28 @@
 {
   "bumped": {
-    "@types/eslint-scope": {
-      "from": "^3.7.7",
-      "to": "^9.1.0"
+    "@types/estree": {
+      "from": "^1.0.8",
+      "to": "^1.0.9"
     },
-    "acorn-import-phases": {
-      "from": "^1.0.3",
-      "to": "^1.0.4"
+    "acorn": {
+      "from": "^8.16.0",
+      "to": "^8.18.0"
     },
     "browserslist": {
       "from": "^4.28.1",
-      "to": "^4.28.2"
+      "to": "^4.28.7"
     },
     "chrome-trace-event": {
       "from": "^1.0.2",
       "to": "^1.0.4"
     },
     "enhanced-resolve": {
-      "from": "^5.20.0",
-      "to": "^5.20.1"
+      "from": "^5.24.4",
+      "to": "^5.24.5"
+    },
+    "es-module-lexer": {
+      "from": "^2.1.0",
+      "to": "^2.3.1"
     },
     "eslint-scope": {
       "from": "5.1.1",
@@ -28,23 +32,11 @@
       "from": "^3.2.0",
       "to": "^3.3.0"
     },
-    "json-parse-even-better-errors": {
-      "from": "^2.3.1",
-      "to": "^5.0.0"
-    },
-    "mime-types": {
-      "from": "^2.1.27",
-      "to": "^3.0.2"
-    },
     "tapable": {
       "from": "^2.3.0",
-      "to": "^2.3.2"
-    },
-    "terser-webpack-plugin": {
-      "from": "^5.3.17",
-      "to": "^5.4.0"
+      "to": "^2.3.3"
     }
   },
-  "timestamp": "2026-04-10T12:22:59.376Z",
-  "totalUpdated": 11
+  "timestamp": "2026-08-02T00:59:09.770Z",
+  "totalUpdated": 9
 }

package/hot/dev-server.js

@@ -3,6 +3,8 @@
 	Author Tobias Koppers @sokra
 */
 /* globals __webpack_hash__ */
+// Universal regular-HMR client (web + Node): runs `module.hot.check` whenever a
+// `webpackHotUpdate` signal arrives on ./emitter (pushed by the dev-server).
 if (module.hot) {
 	/** @type {undefined|string} */
 	var lastHash;

package/lib/APIPlugin.js

@@ -14,10 +14,10 @@ const {
 	JAVASCRIPT_MODULE_TYPE_ESM
 } = require("./ModuleTypeConstants");
 const RuntimeGlobals = require("./RuntimeGlobals");
-const WebpackError = require("./WebpackError");
 const ConstDependency = require("./dependencies/ConstDependency");
 const ModuleInitFragmentDependency = require("./dependencies/ModuleInitFragmentDependency");
 const RuntimeRequirementsDependency = require("./dependencies/RuntimeRequirementsDependency");
+const WebpackError = require("./errors/WebpackError");
 const BasicEvaluatedExpression = require("./javascript/BasicEvaluatedExpression");
 const JavascriptModulesPlugin = require("./javascript/JavascriptModulesPlugin");
 const {
@@ -30,10 +30,25 @@ const GetFullHashRuntimeModule = require("./runtime/GetFullHashRuntimeModule");
 /** @typedef {import("./Compiler")} Compiler */
 /** @typedef {import("./Dependency").DependencyLocation} DependencyLocation */
 /** @typedef {import("./Module").BuildInfo} BuildInfo */
+/** @typedef {import("./javascript/JavascriptModule").JavascriptModuleBuildInfo} JavascriptModuleBuildInfo */
+/** @typedef {import("./Compilation")} Compilation */
 /** @typedef {import("./javascript/JavascriptParser")} JavascriptParser */
 /** @typedef {import("./javascript/JavascriptParser").Range} Range */
 
+// Compilations where a module reassigns `__webpack_public_path__` at runtime.
+// A baked analyzable specifier can't reflect that, so those forms fall back.
+/** @type {WeakSet<Compilation>} */
+const runtimePublicPathOverride = new WeakSet();
+
 /**
+ * @param {Compilation} compilation compilation
+ * @returns {boolean} true when a module reassigns `__webpack_public_path__` at runtime
+ */
+const usesRuntimePublicPathOverride = (compilation) =>
+	runtimePublicPathOverride.has(compilation);
+
+/**
+ * Returns the replacement definitions used for webpack API identifiers.
  * @returns {Record<string, { expr: string, req: string[] | null, type?: string, assign: boolean }>} replacements
  */
 function getReplacements() {
@@ -140,7 +155,7 @@ const PLUGIN_NAME = "APIPlugin";
 
 class APIPlugin {
 	/**
-	 * Apply the plugin
+	 * Applies the plugin by registering its hooks on the compiler.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -189,7 +204,10 @@ class APIPlugin {
 				hooks.renderModuleContent.tap(
 					PLUGIN_NAME,
 					(source, module, renderContext) => {
-						if (/** @type {BuildInfo} */ (module.buildInfo).needCreateRequire) {
+						if (
+							/** @type {JavascriptModuleBuildInfo} */ (module.buildInfo)
+								.needCreateRequire
+						) {
 							const chunkInitFragments = [
 								getExternalModuleNodeCommonjsInitFragment(
 									renderContext.runtimeTemplate
@@ -204,6 +222,7 @@ class APIPlugin {
 				);
 
 				/**
+				 * Handles the hook callback for this code path.
 				 * @param {JavascriptParser} parser the parser
 				 */
 				const handler = (parser) => {
@@ -219,27 +238,28 @@ class APIPlugin {
 						}
 					});
 
-					parser.hooks.preStatement.tap(PLUGIN_NAME, (statement) => {
-						if (parser.scope.topLevelScope === true) {
-							if (
-								statement.type === "FunctionDeclaration" &&
-								statement.id &&
-								statement.id.name === "module"
-							) {
-								/** @type {BuildInfo} */
-								(parser.state.module.buildInfo).moduleArgument =
-									"__webpack_module__";
-							} else if (
-								statement.type === "ClassDeclaration" &&
-								statement.id &&
-								statement.id.name === "module"
-							) {
-								/** @type {BuildInfo} */
-								(parser.state.module.buildInfo).moduleArgument =
-									"__webpack_module__";
-							}
+					/**
+					 * @param {import("estree").Statement | import("estree").ModuleDeclaration | import("estree").MaybeNamedFunctionDeclaration | import("estree").MaybeNamedClassDeclaration} statement statement
+					 */
+					const moduleDeclarationHandler = (statement) => {
+						if (
+							parser.scope.topLevelScope === true &&
+							(statement.type === "FunctionDeclaration" ||
+								statement.type === "ClassDeclaration") &&
+							statement.id &&
+							statement.id.name === "module"
+						) {
+							/** @type {BuildInfo} */
+							(parser.state.module.buildInfo).moduleArgument =
+								"__webpack_module__";
 						}
-					});
+					};
+					parser.hooks.preStatementByType
+						.for("FunctionDeclaration")
+						.tap(PLUGIN_NAME, moduleDeclarationHandler);
+					parser.hooks.preStatementByType
+						.for("ClassDeclaration")
+						.tap(PLUGIN_NAME, moduleDeclarationHandler);
 
 					for (const key of Object.keys(REPLACEMENTS)) {
 						const info = REPLACEMENTS[key];
@@ -248,15 +268,13 @@ class APIPlugin {
 
 							if (key === "__non_webpack_require__" && moduleOutput) {
 								if (nodeTarget) {
-									/** @type {BuildInfo} */
+									/** @type {JavascriptModuleBuildInfo} */
 									(parser.state.module.buildInfo).needCreateRequire = true;
 								} else {
 									const warning = new WebpackError(
 										`${PLUGIN_NAME}\n__non_webpack_require__ is only allowed in target node`
 									);
-									warning.loc = /** @type {DependencyLocation} */ (
-										expression.loc
-									);
+									warning.loc = parser.getLocation(expression);
 									warning.module = parser.state.module;
 									compilation.warnings.push(warning);
 								}
@@ -267,9 +285,15 @@ class APIPlugin {
 						if (info.assign === false) {
 							parser.hooks.assign.for(key).tap(PLUGIN_NAME, (expr) => {
 								const err = new WebpackError(`${key} must not be assigned`);
-								err.loc = /** @type {DependencyLocation} */ (expr.loc);
+								err.loc = parser.getLocation(expr);
 								throw err;
 							});
+						} else if (key === "__webpack_public_path__") {
+							// Flag the runtime override (still let the default handler emit
+							// `__webpack_require__.p = …`); returning nothing keeps that path.
+							parser.hooks.assign.for(key).tap(PLUGIN_NAME, () => {
+								runtimePublicPathOverride.add(compilation);
+							});
 						}
 						if (info.type) {
 							parser.hooks.evaluateTypeof
@@ -285,7 +309,7 @@ class APIPlugin {
 								JSON.stringify(parser.state.module.layer),
 								/** @type {Range} */ (expr.range)
 							);
-							dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+							dep.loc = parser.getLocation(expr);
 							parser.state.module.addPresentationalDependency(dep);
 							return true;
 						});
@@ -312,7 +336,7 @@ class APIPlugin {
 					parser.hooks.expression
 						.for("__webpack_module__.id")
 						.tap(PLUGIN_NAME, (expr) => {
-							/** @type {BuildInfo} */
+							/** @type {JavascriptModuleBuildInfo} */
 							(parser.state.module.buildInfo).moduleConcatenationBailout =
 								"__webpack_module__.id";
 							const moduleArgument = parser.state.module.moduleArgument;
@@ -320,7 +344,7 @@ class APIPlugin {
 								const dep = new RuntimeRequirementsDependency([
 									RuntimeGlobals.moduleId
 								]);
-								dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+								dep.loc = parser.getLocation(expr);
 								parser.state.module.addPresentationalDependency(dep);
 							} else {
 								const initDep = new ModuleInitFragmentDependency(
@@ -334,7 +358,7 @@ class APIPlugin {
 									/** @type {Range} */ (expr.range),
 									[]
 								);
-								dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+								dep.loc = parser.getLocation(expr);
 								parser.state.module.addPresentationalDependency(dep);
 							}
 							return true;
@@ -343,7 +367,7 @@ class APIPlugin {
 					parser.hooks.expression
 						.for("__webpack_module__")
 						.tap(PLUGIN_NAME, (expr) => {
-							/** @type {BuildInfo} */
+							/** @type {JavascriptModuleBuildInfo} */
 							(parser.state.module.buildInfo).moduleConcatenationBailout =
 								"__webpack_module__";
 							const moduleArgument = parser.state.module.moduleArgument;
@@ -351,7 +375,7 @@ class APIPlugin {
 								const dep = new RuntimeRequirementsDependency([
 									RuntimeGlobals.module
 								]);
-								dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+								dep.loc = parser.getLocation(expr);
 								parser.state.module.addPresentationalDependency(dep);
 							} else {
 								const initDep = new ModuleInitFragmentDependency(
@@ -365,7 +389,7 @@ class APIPlugin {
 									/** @type {Range} */ (expr.range),
 									[]
 								);
-								dep.loc = /** @type {DependencyLocation} */ (expr.loc);
+								dep.loc = parser.getLocation(expr);
 								parser.state.module.addPresentationalDependency(dep);
 							}
 							return true;
@@ -390,3 +414,4 @@ class APIPlugin {
 }
 
 module.exports = APIPlugin;
+module.exports.usesRuntimePublicPathOverride = usesRuntimePublicPathOverride;

package/lib/AsyncDependenciesBlock.js

@@ -71,6 +71,7 @@ class AsyncDependenciesBlock extends DependenciesBlock {
 	}
 
 	/**
+	 * Updates the hash with the data contributed by this instance.
 	 * @param {Hash} hash the hash used to track dependencies
 	 * @param {UpdateHashContext} context context
 	 * @returns {void}
@@ -88,6 +89,7 @@ class AsyncDependenciesBlock extends DependenciesBlock {
 	}
 
 	/**
+	 * Serializes this instance into the provided serializer context.
 	 * @param {ObjectSerializerContext} context context
 	 */
 	serialize(context) {
@@ -99,6 +101,7 @@ class AsyncDependenciesBlock extends DependenciesBlock {
 	}
 
 	/**
+	 * Restores this instance from the provided deserializer context.
 	 * @param {ObjectDeserializerContext} context context
 	 */
 	deserialize(context) {

package/lib/AutomaticPrefetchPlugin.js

@@ -13,9 +13,14 @@ const PrefetchDependency = require("./dependencies/PrefetchDependency");
 
 const PLUGIN_NAME = "AutomaticPrefetchPlugin";
 
+/**
+ * Records modules from one compilation and adds them back as prefetch
+ * dependencies in the next compilation.
+ */
 class AutomaticPrefetchPlugin {
 	/**
-	 * Apply the plugin
+	 * Registers hooks that remember previously built normal modules and enqueue
+	 * them as `PrefetchDependency` requests during the next make phase.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */

package/lib/BannerPlugin.js

@@ -13,14 +13,15 @@ const Template = require("./Template");
 /** @typedef {import("webpack-sources").Source} Source */
 /** @typedef {import("../declarations/plugins/BannerPlugin").BannerPluginArgument} BannerPluginArgument */
 /** @typedef {import("../declarations/plugins/BannerPlugin").BannerPluginOptions} BannerPluginOptions */
-/** @typedef {import("./Compilation").PathData} PathData */
+/** @typedef {import("./Compilation").PathDataChunk} PathDataChunk */
 /** @typedef {import("./Compiler")} Compiler */
 /** @typedef {import("./Chunk")} Chunk */
-/** @typedef {import("./TemplatedPathPlugin").TemplatePath} TemplatePath */
 
 /** @typedef {(data: { hash?: string, chunk: Chunk, filename: string }) => string} BannerFunction */
 
 /**
+ * Wraps banner text in a JavaScript block comment, preserving multi-line
+ * formatting and escaping accidental comment terminators.
  * @param {string} str string to wrap
  * @returns {string} wrapped string
  */
@@ -38,8 +39,14 @@ const wrapComment = (str) => {
 
 const PLUGIN_NAME = "BannerPlugin";
 
+/**
+ * Prepends or appends banner text to emitted assets that match the configured
+ * file filters.
+ */
 class BannerPlugin {
 	/**
+	 * Normalizes banner options and compiles the configured banner source into a
+	 * function that can render per-asset banner text.
 	 * @param {BannerPluginArgument} options options object
 	 */
 	constructor(options) {
@@ -69,7 +76,8 @@ class BannerPlugin {
 	}
 
 	/**
-	 * Apply the plugin
+	 * Validates the configured options and injects rendered banner comments into
+	 * matching compilation assets at the configured process-assets stage.
 	 * @param {Compiler} compiler the compiler instance
 	 * @returns {void}
 	 */
@@ -108,11 +116,11 @@ class BannerPlugin {
 							continue;
 						}
 
-						/** @type {PathData} */
+						/** @type {PathDataChunk} */
 						const data = { chunk, filename: file };
 
 						const comment = compilation.getPath(
-							/** @type {TemplatePath} */
+							/** @type {string | import("./TemplatedPathPlugin").TemplatePathFn<PathDataChunk>} */
 							(banner),
 							data
 						);

package/lib/Cache.js

@@ -9,19 +9,20 @@ const { AsyncParallelHook, AsyncSeriesBailHook, SyncHook } = require("tapable");
 const {
 	makeWebpackError,
 	makeWebpackErrorCallback
-} = require("./HookWebpackError");
-
-/** @typedef {import("./WebpackError")} WebpackError */
+} = require("./errors/HookWebpackError");
 
 /**
+ * Cache validation token whose string representation identifies the build
+ * inputs associated with a cached value.
  * @typedef {object} Etag
  * @property {() => string} toString
  */
 
 /**
+ * Completion callback used by cache operations that either fail with a `Error` or resolve with a typed result.
  * @template T
  * @callback CallbackCache
- * @param {WebpackError | null} err
+ * @param {Error | null} err
  * @param {T=} result
  * @returns {void}
  */
@@ -29,6 +30,8 @@ const {
 /** @typedef {EXPECTED_ANY} Data */
 
 /**
+ * Handler invoked after a cache read succeeds so additional cache layers can
+ * react to the retrieved value.
  * @template T
  * @callback GotHandler
  * @param {T} result
@@ -37,6 +40,8 @@ const {
  */
 
 /**
+ * Creates a callback wrapper that waits for a fixed number of completions and
+ * forwards the first error immediately.
  * @param {number} times times
  * @param {(err?: Error | null) => void} callback callback
  * @returns {(err?: Error | null) => void} callback
@@ -51,7 +56,14 @@ const needCalls = (times, callback) => (err) => {
 	}
 };
 
+/**
+ * Abstract cache interface backed by tapable hooks for reading, writing, idle
+ * transitions, and shutdown across webpack cache implementations.
+ */
 class Cache {
+	/**
+	 * Initializes the cache lifecycle hooks implemented by cache backends.
+	 */
 	constructor() {
 		this.hooks = {
 			/** @type {AsyncSeriesBailHook<[string, Etag | null, GotHandler<EXPECTED_ANY>[]], Data>} */
@@ -70,6 +82,8 @@ class Cache {
 	}
 
 	/**
+	 * Retrieves a cached value and lets registered `gotHandlers` observe the
+	 * result before the caller receives it.
 	 * @template T
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag
@@ -103,6 +117,8 @@ class Cache {
 	}
 
 	/**
+	 * Stores a cache entry for the identifier and etag through the registered
+	 * cache backend hooks.
 	 * @template T
 	 * @param {string} identifier the cache identifier
 	 * @param {Etag | null} etag the etag
@@ -120,7 +136,8 @@ class Cache {
 	}
 
 	/**
-	 * After this method has succeeded the cache can only be restored when build dependencies are
+	 * Persists the set of build dependencies required to determine whether the
+	 * cache can be restored in a future compilation.
 	 * @param {Iterable<string>} dependencies list of all build dependencies
 	 * @param {CallbackCache<void>} callback signals when the dependencies are stored
 	 * @returns {void}
@@ -133,6 +150,8 @@ class Cache {
 	}
 
 	/**
+	 * Signals that webpack is entering an idle phase and cache backends may flush
+	 * or compact pending work.
 	 * @returns {void}
 	 */
 	beginIdle() {
@@ -140,6 +159,8 @@ class Cache {
 	}
 
 	/**
+	 * Signals that webpack is leaving the idle phase and waits for cache
+	 * backends to finish any asynchronous resume work.
 	 * @param {CallbackCache<void>} callback signals when the call finishes
 	 * @returns {void}
 	 */
@@ -150,6 +171,7 @@ class Cache {
 	}
 
 	/**
+	 * Shuts down every registered cache backend and waits for cleanup to finish.
 	 * @param {CallbackCache<void>} callback signals when the call finishes
 	 * @returns {void}
 	 */