webpack 5.91.0 → 5.92.0

package/bin/webpack.js

@@ -79,7 +79,6 @@ const runCli = cli => {
 	const pkg = require(pkgPath);
 
 	if (pkg.type === "module" || /\.mjs/i.test(pkg.bin[cli.binName])) {
-		// eslint-disable-next-line n/no-unsupported-features/es-syntax
 		import(path.resolve(path.dirname(pkgPath), pkg.bin[cli.binName])).catch(
 			error => {
 				console.error(error);
@@ -92,7 +91,7 @@ const runCli = cli => {
 };
 
 /**
- * @typedef {Object} CliOption
+ * @typedef {object} CliOption
  * @property {string} name display name
  * @property {string} package npm package name
  * @property {string} binName name of the executable file

package/lib/APIPlugin.js

@@ -133,7 +133,7 @@ function getReplacements(module, importMetaName) {
 const PLUGIN_NAME = "APIPlugin";
 
 /**
- * @typedef {Object} APIPluginOptions
+ * @typedef {object} APIPluginOptions
  * @property {boolean} [module] the output filename
  */
 
@@ -189,9 +189,13 @@ class APIPlugin {
 					PLUGIN_NAME,
 					(source, module, renderContext) => {
 						if (/** @type {BuildInfo} */ (module.buildInfo).needCreateRequire) {
+							const needPrefix =
+								renderContext.runtimeTemplate.supportNodePrefixForCoreModules();
 							const chunkInitFragments = [
 								new InitFragment(
-									'import { createRequire as __WEBPACK_EXTERNAL_createRequire } from "module";\n',
+									`import { createRequire as __WEBPACK_EXTERNAL_createRequire } from "${
+										needPrefix ? "node:" : ""
+									}module";\n`,
 									InitFragment.STAGE_HARMONY_IMPORTS,
 									0,
 									"external module node-commonjs"

package/lib/Cache.js

@@ -14,7 +14,7 @@ const {
 /** @typedef {import("./WebpackError")} WebpackError */
 
 /**
- * @typedef {Object} Etag
+ * @typedef {object} Etag
  * @property {function(): string} toString
  */
 

package/lib/Chunk.js

@@ -38,13 +38,13 @@ const { mergeRuntime } = require("./util/runtime");
 const ChunkFilesSet = createArrayToSetDeprecationSet("chunk.files");
 
 /**
- * @typedef {Object} WithId an object who has an id property *
+ * @typedef {object} WithId an object who has an id property *
  * @property {string | number} id the id of the object
  */
 
 /**
  * @deprecated
- * @typedef {Object} ChunkMaps
+ * @typedef {object} ChunkMaps
  * @property {Record<string|number, string>} hash
  * @property {Record<string|number, Record<string, string>>} contentHash
  * @property {Record<string|number, string>} name
@@ -52,7 +52,7 @@ const ChunkFilesSet = createArrayToSetDeprecationSet("chunk.files");
 
 /**
  * @deprecated
- * @typedef {Object} ChunkModuleMaps
+ * @typedef {object} ChunkModuleMaps
  * @property {Record<string|number, (string|number)[]>} id
  * @property {Record<string|number, string>} hash
  */
@@ -85,7 +85,10 @@ class Chunk {
 		this.filenameTemplate = undefined;
 		/** @type {(string | function(PathData, AssetInfo=): string) | undefined} */
 		this.cssFilenameTemplate = undefined;
-		/** @private @type {SortableSet<ChunkGroup>} */
+		/**
+		 * @private
+		 * @type {SortableSet<ChunkGroup>}
+		 */
 		this._groups = new SortableSet(undefined, compareChunkGroupsByIndex);
 		/** @type {RuntimeSpec} */
 		this.runtime = undefined;

package/lib/ChunkGraph.js

@@ -50,7 +50,7 @@ const compareModuleIterables = compareIterables(compareModulesByIdentifier);
 /** @typedef {[Module, Entrypoint | undefined]} EntryModuleWithChunkGroup */
 
 /**
- * @typedef {Object} ChunkSizeOptions
+ * @typedef {object} ChunkSizeOptions
  * @property {number=} chunkOverhead constant overhead for a chunk
  * @property {number=} entryChunkMultiplicator multiplicator for initial chunks
  */
@@ -187,6 +187,7 @@ const isAvailableChunk = (a, b) => {
 
 /** @typedef {Set<Chunk>} EntryInChunks */
 /** @typedef {Set<Chunk>} RuntimeInChunks */
+/** @typedef {string | number} ModuleId */
 
 class ChunkGraphModule {
 	constructor() {
@@ -238,13 +239,25 @@ class ChunkGraph {
 	 * @param {string | Hash} hashFunction the hash function to use
 	 */
 	constructor(moduleGraph, hashFunction = "md4") {
-		/** @private @type {WeakMap<Module, ChunkGraphModule>} */
+		/**
+		 * @private
+		 * @type {WeakMap<Module, ChunkGraphModule>}
+		 */
 		this._modules = new WeakMap();
-		/** @private @type {WeakMap<Chunk, ChunkGraphChunk>} */
+		/**
+		 * @private
+		 * @type {WeakMap<Chunk, ChunkGraphChunk>}
+		 */
 		this._chunks = new WeakMap();
-		/** @private @type {WeakMap<AsyncDependenciesBlock, ChunkGroup>} */
+		/**
+		 * @private
+		 * @type {WeakMap<AsyncDependenciesBlock, ChunkGroup>}
+		 */
 		this._blockChunkGroups = new WeakMap();
-		/** @private @type {Map<string, string | number>} */
+		/**
+		 * @private
+		 * @type {Map<string, string | number>}
+		 */
 		this._runtimeIds = new Map();
 		/** @type {ModuleGraph} */
 		this.moduleGraph = moduleGraph;
@@ -1309,7 +1322,7 @@ class ChunkGraph {
 
 	/**
 	 * @param {Module} module the module
-	 * @returns {string | number} the id of the module
+	 * @returns {ModuleId} the id of the module
 	 */
 	getModuleId(module) {
 		const cgm = this._getChunkGraphModule(module);
@@ -1318,7 +1331,7 @@ class ChunkGraph {
 
 	/**
 	 * @param {Module} module the module
-	 * @param {string | number} id the id of the module
+	 * @param {ModuleId} id the id of the module
 	 * @returns {void}
 	 */
 	setModuleId(module, id) {

package/lib/ChunkGroup.js

@@ -25,7 +25,7 @@ const {
 /** @typedef {{module: Module, loc: DependencyLocation, request: string}} OriginRecord */
 
 /**
- * @typedef {Object} RawChunkGroupOptions
+ * @typedef {object} RawChunkGroupOptions
  * @property {number=} preloadOrder
  * @property {number=} prefetchOrder
  * @property {("low" | "high" | "auto")=} fetchPriority
@@ -93,10 +93,16 @@ class ChunkGroup {
 		/** @type {OriginRecord[]} */
 		this.origins = [];
 		/** Indices in top-down order */
-		/** @private @type {Map<Module, number>} */
+		/**
+		 * @private
+		 * @type {Map<Module, number>}
+		 */
 		this._modulePreOrderIndices = new Map();
 		/** Indices in bottom-up order */
-		/** @private @type {Map<Module, number>} */
+		/**
+		 * @private
+		 * @type {Map<Module, number>}
+		 */
 		this._modulePostOrderIndices = new Map();
 		/** @type {number | undefined} */
 		this.index = undefined;

package/lib/CleanPlugin.js

@@ -24,7 +24,7 @@ const processAsyncTree = require("./util/processAsyncTree");
 /** @typedef {function(IgnoreItem): void} AddToIgnoreCallback */
 
 /**
- * @typedef {Object} CleanPluginCompilationHooks
+ * @typedef {object} CleanPluginCompilationHooks
  * @property {SyncBailHook<[string], boolean>} keep when returning true the file/directory will be kept during cleaning, returning false will clean it and ignore the following plugins and config
  */
 

package/lib/Compilation.js

@@ -168,20 +168,20 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {Record<string, Source>} CompilationAssets */
 
 /**
- * @typedef {Object} AvailableModulesChunkGroupMapping
+ * @typedef {object} AvailableModulesChunkGroupMapping
  * @property {ChunkGroup} chunkGroup
  * @property {Set<Module>} availableModules
  * @property {boolean} needCopy
  */
 
 /**
- * @typedef {Object} DependenciesBlockLike
+ * @typedef {object} DependenciesBlockLike
  * @property {Dependency[]} dependencies
  * @property {AsyncDependenciesBlock[]} blocks
  */
 
 /**
- * @typedef {Object} ChunkPathData
+ * @typedef {object} ChunkPathData
  * @property {string|number} id
  * @property {string=} name
  * @property {string} hash
@@ -191,7 +191,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
- * @typedef {Object} ChunkHashContext
+ * @typedef {object} ChunkHashContext
  * @property {CodeGenerationResults} codeGenerationResults results of code generation
  * @property {RuntimeTemplate} runtimeTemplate the runtime template
  * @property {ModuleGraph} moduleGraph the module graph
@@ -199,18 +199,18 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
- * @typedef {Object} RuntimeRequirementsContext
+ * @typedef {object} RuntimeRequirementsContext
  * @property {ChunkGraph} chunkGraph the chunk graph
  * @property {CodeGenerationResults} codeGenerationResults the code generation results
  */
 
 /**
- * @typedef {Object} ExecuteModuleOptions
+ * @typedef {object} ExecuteModuleOptions
  * @property {EntryOptions=} entryOptions
  */
 
 /**
- * @typedef {Object} ExecuteModuleResult
+ * @typedef {object} ExecuteModuleResult
  * @property {any} exports
  * @property {boolean} cacheable
  * @property {Map<string, { source: Source, info: AssetInfo }>} assets
@@ -221,7 +221,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
- * @typedef {Object} ExecuteModuleArgument
+ * @typedef {object} ExecuteModuleArgument
  * @property {Module} module
  * @property {{ id: string, exports: any, loaded: boolean }=} moduleObject
  * @property {any} preparedInfo
@@ -229,7 +229,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
- * @typedef {Object} ExecuteModuleContext
+ * @typedef {object} ExecuteModuleContext
  * @property {Map<string, { source: Source, info: AssetInfo }>} assets
  * @property {Chunk} chunk
  * @property {ChunkGraph} chunkGraph
@@ -237,14 +237,14 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
- * @typedef {Object} EntryData
+ * @typedef {object} EntryData
  * @property {Dependency[]} dependencies dependencies of the entrypoint that should be evaluated at startup
  * @property {Dependency[]} includeDependencies dependencies of the entrypoint that should be included but not evaluated
  * @property {EntryOptions} options options of the entrypoint
  */
 
 /**
- * @typedef {Object} LogEntry
+ * @typedef {object} LogEntry
  * @property {string} type
  * @property {any[]} args
  * @property {number} time
@@ -252,7 +252,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
- * @typedef {Object} KnownAssetInfo
+ * @typedef {object} KnownAssetInfo
  * @property {boolean=} immutable true, if the asset can be long term cached forever (contains a hash)
  * @property {boolean=} minimized whether the asset is minimized
  * @property {string | string[]=} fullhash the value(s) of the full hash used for this asset
@@ -270,21 +270,21 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {KnownAssetInfo & Record<string, any>} AssetInfo */
 
 /**
- * @typedef {Object} Asset
+ * @typedef {object} Asset
  * @property {string} name the filename of the asset
  * @property {Source} source source of the asset
  * @property {AssetInfo} info info about the asset
  */
 
 /**
- * @typedef {Object} ModulePathData
+ * @typedef {object} ModulePathData
  * @property {string|number} id
  * @property {string} hash
  * @property {function(number): string=} hashWithLength
  */
 
 /**
- * @typedef {Object} PathData
+ * @typedef {object} PathData
  * @property {ChunkGraph=} chunkGraph
  * @property {string=} hash
  * @property {function(number): string=} hashWithLength
@@ -302,7 +302,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
- * @typedef {Object} KnownNormalizedStatsOptions
+ * @typedef {object} KnownNormalizedStatsOptions
  * @property {string} context
  * @property {RequestShortener} requestShortener
  * @property {string} chunksSort
@@ -346,7 +346,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {KnownNormalizedStatsOptions & Omit<StatsOptions, keyof KnownNormalizedStatsOptions> & Record<string, any>} NormalizedStatsOptions */
 
 /**
- * @typedef {Object} KnownCreateStatsOptionsContext
+ * @typedef {object} KnownCreateStatsOptionsContext
  * @property {boolean=} forToString
  */
 
@@ -849,7 +849,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 			/** @type {SyncHook<[Chunk, string]>} */
 			chunkAsset: new SyncHook(["chunk", "filename"]),
 
-			/** @type {SyncWaterfallHook<[string, object, AssetInfo]>} */
+			/** @type {SyncWaterfallHook<[string, object, AssetInfo | undefined]>} */
 			assetPath: new SyncWaterfallHook(["path", "options", "assetInfo"]),
 
 			/** @type {SyncBailHook<[], boolean>} */
@@ -1019,7 +1019,10 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 			arrayToSetDeprecation(this.chunks, "Compilation.chunks");
 			arrayToSetDeprecation(this.modules, "Compilation.modules");
 		}
-		/** @private @type {Map<string, Module>} */
+		/**
+		 * @private
+		 * @type {Map<string, Module>}
+		 */
 		this._modules = new Map();
 		this.records = null;
 		/** @type {string[]} */
@@ -1061,7 +1064,10 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		this.codeGeneratedModules = new WeakSet();
 		/** @type {WeakSet<Module>} */
 		this.buildTimeExecutedModules = new WeakSet();
-		/** @private @type {Map<Module, Callback[]>} */
+		/**
+		 * @private
+		 * @type {Map<Module, Callback[]>}
+		 */
 		this._rebuildingModules = new Map();
 		/** @type {Set<string>} */
 		this.emittedAssets = new Set();
@@ -1787,7 +1793,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
-	 * @typedef {Object} HandleModuleCreationOptions
+	 * @typedef {object} HandleModuleCreationOptions
 	 * @property {ModuleFactory} factory
 	 * @property {Dependency[]} dependencies
 	 * @property {Module | null} originModule
@@ -2122,7 +2128,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 	}
 
 	/**
-	 * @param {Object} options options
+	 * @param {object} options options
 	 * @param {string} options.context context string path
 	 * @param {Dependency} options.dependency dependency used to create Module chain
 	 * @param {Partial<ModuleFactoryCreateDataContextInfo>=} options.contextInfo additional context info for the root module
@@ -2561,7 +2567,7 @@ BREAKING CHANGE: Asset processing hooks in Compilation has been merged into a si
 		};
 		/**
 		 * @param {Module} module module
-		 * @param {Object} references references
+		 * @param {object} references references
 		 * @param {string | number} references.id id
 		 * @param {Map<Module, string | number | undefined>=} references.modules modules
 		 * @param {(string | number | null)[]=} references.blocks blocks
@@ -3466,7 +3472,6 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 						dependencyTemplates,
 						runtimeTemplate,
 						runtime,
-						runtimes,
 						codeGenerationResults: results,
 						compilation: this
 					});
@@ -3510,7 +3515,7 @@ Or do you want to use the entrypoints '${name}' and '${runtime}' independently o
 	}
 
 	/**
-	 * @param {Object} options options
+	 * @param {object} options options
 	 * @param {ChunkGraph=} options.chunkGraph the chunk graph
 	 * @param {Iterable<Module>=} options.modules modules
 	 * @param {Iterable<Chunk>=} options.chunks chunks
@@ -5338,7 +5343,7 @@ This prevents using hashes of each other and should be avoided.`);
 }
 
 /**
- * @typedef {Object} FactorizeModuleOptions
+ * @typedef {object} FactorizeModuleOptions
  * @property {ModuleProfile} currentProfile
  * @property {ModuleFactory} factory
  * @property {Dependency[]} dependencies
@@ -5355,7 +5360,8 @@ This prevents using hashes of each other and should be avoided.`);
  */
 
 // Workaround for typescript as it doesn't support function overloading in jsdoc within a class
-Compilation.prototype.factorizeModule = /** @type {{
+Compilation.prototype.factorizeModule = /**
+	 @type {{
 	(options: FactorizeModuleOptions & { factoryResult?: false }, callback: ModuleCallback): void;
 	(options: FactorizeModuleOptions & { factoryResult: true }, callback: ModuleFactoryResultCallback): void;
 }} */ (

package/lib/Compiler.js

@@ -45,6 +45,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {import("./FileSystemInfo").FileSystemInfoEntry} FileSystemInfoEntry */
 /** @typedef {import("./Module")} Module */
 /** @typedef {import("./Module").BuildInfo} BuildInfo */
+/** @typedef {import("./config/target").PlatformTargetProperties} PlatformTargetProperties */
 /** @typedef {import("./logging/createConsoleLogger").LoggingFunction} LoggingFunction */
 /** @typedef {import("./util/WeakTupleMap")} WeakTupleMap */
 /** @typedef {import("./util/fs").IStats} IStats */
@@ -54,7 +55,7 @@ const { isSourceEqual } = require("./util/source");
 /** @typedef {import("./util/fs").WatchFileSystem} WatchFileSystem */
 
 /**
- * @typedef {Object} CompilationParams
+ * @typedef {object} CompilationParams
  * @property {NormalModuleFactory} normalModuleFactory
  * @property {ContextModuleFactory} contextModuleFactory
  */
@@ -81,7 +82,7 @@ const { isSourceEqual } = require("./util/source");
  */
 
 /**
- * @typedef {Object} AssetEmittedInfo
+ * @typedef {object} AssetEmittedInfo
  * @property {Buffer} content
  * @property {Source} source
  * @property {Compilation} compilation
@@ -104,12 +105,12 @@ const isSorted = array => {
 };
 
 /**
- * @param {Object<string, any>} obj an object
+ * @param {{[key: string]: any}} obj an object
  * @param {string[]} keys the keys of the object
- * @returns {Object<string, any>} the object with properties sorted by property name
+ * @returns {{[key: string]: any}} the object with properties sorted by property name
  */
 const sortObject = (obj, keys) => {
-	/** @type {Object<string, any>} */
+	/** @type {{[key: string]: any}} */
 	const o = {};
 	for (const k of keys.sort()) {
 		o[k] = obj[k];
@@ -265,6 +266,16 @@ class Compiler {
 		/** @type {LoggingFunction | undefined} */
 		this.infrastructureLogger = undefined;
 
+		/** @type {Readonly<PlatformTargetProperties>} */
+		this.platform = {
+			web: null,
+			browser: null,
+			webworker: null,
+			node: null,
+			nwjs: null,
+			electron: null
+		};
+
 		this.options = options;
 
 		this.context = context;
@@ -294,11 +305,20 @@ class Compiler {
 		/** @type {NormalModuleFactory | undefined} */
 		this._lastNormalModuleFactory = undefined;
 
-		/** @private @type {WeakMap<Source, CacheEntry>} */
+		/**
+		 * @private
+		 * @type {WeakMap<Source, CacheEntry>}
+		 */
 		this._assetEmittingSourceCache = new WeakMap();
-		/** @private @type {Map<string, number>} */
+		/**
+		 * @private
+		 * @type {Map<string, number>}
+		 */
 		this._assetEmittingWrittenFiles = new Map();
-		/** @private @type {Set<string>} */
+		/**
+		 * @private
+		 * @type {Set<string>}
+		 */
 		this._assetEmittingPreviousFiles = new Set();
 	}
 

package/lib/ConcatenationScope.js

@@ -14,13 +14,13 @@ const DEFAULT_EXPORT = "__WEBPACK_DEFAULT_EXPORT__";
 const NAMESPACE_OBJECT_EXPORT = "__WEBPACK_NAMESPACE_OBJECT__";
 
 /**
- * @typedef {Object} ExternalModuleInfo
+ * @typedef {object} ExternalModuleInfo
  * @property {number} index
  * @property {Module} module
  */
 
 /**
- * @typedef {Object} ConcatenatedModuleInfo
+ * @typedef {object} ConcatenatedModuleInfo
  * @property {number} index
  * @property {Module} module
  * @property {Map<string, string>} exportMap mapping from export name to symbol
@@ -31,7 +31,7 @@ const NAMESPACE_OBJECT_EXPORT = "__WEBPACK_NAMESPACE_OBJECT__";
 /** @typedef {ConcatenatedModuleInfo | ExternalModuleInfo} ModuleInfo */
 
 /**
- * @typedef {Object} ModuleReferenceOptions
+ * @typedef {object} ModuleReferenceOptions
  * @property {string[]} ids the properties/exports of the module
  * @property {boolean} call true, when this referenced export is called
  * @property {boolean} directImport true, when this referenced export is directly imported (not via property access)