webpack 5.27.2 → 5.31.0

package/lib/stats/DefaultStatsFactoryPlugin.js

@@ -282,9 +282,9 @@ const { makePathsRelative, parseResource } = require("../util/identifier");
  * @property {string=} loc
  * @property {string|number=} chunkId
  * @property {string|number=} moduleId
- * @property {any=} moduleTrace
+ * @property {StatsModuleTraceItem[]=} moduleTrace
  * @property {any=} details
- * @property {any=} stack
+ * @property {string=} stack
  */
 
 /** @typedef {Asset & { type: string, related: PreprocessedAsset[] }} PreprocessedAsset */

package/lib/util/deterministicGrouping.js

@@ -216,6 +216,7 @@ class Group {
 				lastNode = node;
 			}
 		}
+		if (resultNodes.length === this.nodes.length) return undefined;
 		this.nodes = newNodes;
 		this.similarities = newSimilarities;
 		this.size = sumSize(newNodes);
@@ -296,14 +297,15 @@ module.exports = ({ maxSize, minSize, items, getSize, getKey }) => {
 	if (initialNodes.length > 0) {
 		const initialGroup = new Group(initialNodes, getSimilarities(initialNodes));
 
-		const removeProblematicNodes = group => {
-			const problemTypes = getTooSmallTypes(group.size, minSize);
+		const removeProblematicNodes = (group, consideredSize = group.size) => {
+			const problemTypes = getTooSmallTypes(consideredSize, minSize);
 			if (problemTypes.size > 0) {
 				// We hit an edge case where the working set is already smaller than minSize
 				// We merge problematic nodes with the smallest result node to keep minSize intact
 				const problemNodes = group.popNodes(
 					n => getNumberOfMatchingSizeTypes(n.size, problemTypes) > 0
 				);
+				if (problemNodes === undefined) return false;
 				// Only merge it with result nodes that have the problematic size type
 				const possibleResultGroups = result.filter(
 					n => getNumberOfMatchingSizeTypes(n.size, problemTypes) > 0
@@ -377,7 +379,31 @@ module.exports = ({ maxSize, minSize, items, getSize, getKey }) => {
 					right--;
 				}
 
+				//      left v   v right
+				// [ O O O ] O O O [ O O O ]
+				// ^^^^^^^^^ leftSize
+				//       rightSize ^^^^^^^^^
+				// leftSize > minSize
+				// rightSize > minSize
+
+				// Perfect split: [ O O O ] [ O O O ]
+				//                right === left - 1
+
 				if (left - 1 > right) {
+					// We try to remove some problematic nodes to "fix" that
+					let prevSize;
+					if (right < group.nodes.length - left) {
+						subtractSizeFrom(rightSize, group.nodes[right + 1].size);
+						prevSize = rightSize;
+					} else {
+						subtractSizeFrom(leftSize, group.nodes[left - 1].size);
+						prevSize = leftSize;
+					}
+					if (removeProblematicNodes(group, prevSize)) {
+						// This changed something, so we try this group again
+						queue.push(group);
+						continue;
+					}
 					// can't split group while holding minSize
 					// because minSize is preferred of maxSize we return
 					// the problematic nodes as result here even while it's too big
@@ -395,7 +421,13 @@ module.exports = ({ maxSize, minSize, items, getSize, getKey }) => {
 					let bestSimilarity = Infinity;
 					let pos = left;
 					let rightSize = sumSize(group.nodes.slice(pos));
-					while (pos <= right) {
+
+					//       pos v   v right
+					// [ O O O ] O O O [ O O O ]
+					// ^^^^^^^^^ leftSize
+					// rightSize ^^^^^^^^^^^^^^^
+
+					while (pos <= right + 1) {
 						const similarity = group.similarities[pos - 1];
 						if (
 							similarity < bestSimilarity &&
@@ -410,7 +442,9 @@ module.exports = ({ maxSize, minSize, items, getSize, getKey }) => {
 						pos++;
 					}
 					if (best < 0) {
-						// can't split group while holding minSize
+						// This can't happen
+						// but if that assumption is wrong
+						// fallback to a big group
 						result.push(group);
 						continue;
 					}

package/lib/util/runtime.js

@@ -347,7 +347,7 @@ const subtractRuntime = (a, b) => {
 		return undefined;
 	} else if (typeof a === "string") {
 		if (typeof b === "string") {
-			return undefined;
+			return a;
 		} else if (b.has(a)) {
 			return undefined;
 		} else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webpack",
-  "version": "5.27.2",
+  "version": "5.31.0",
   "author": "Tobias Koppers @sokra",
   "description": "Packs CommonJs/AMD modules for the browser. Allows to split your codebase into multiple bundles, which can be loaded on demand. Support loaders to preprocess files, i.e. json, jsx, es7, css, less, ... and your custom stuff.",
   "license": "MIT",
@@ -53,7 +53,7 @@
     "es5-ext": "^0.10.53",
     "es6-promise-polyfill": "^1.2.0",
     "eslint": "^7.14.0",
-    "eslint-config-prettier": "^7.0.0",
+    "eslint-config-prettier": "^8.1.0",
     "eslint-plugin-jest": "^24.1.3",
     "eslint-plugin-jsdoc": "^32.0.2",
     "eslint-plugin-node": "^11.0.0",

package/schemas/WebpackOptions.json

@@ -107,6 +107,9 @@
         },
         "filename": {
           "$ref": "#/definitions/FilenameTemplate"
+        },
+        "publicPath": {
+          "$ref": "#/definitions/RawPublicPath"
         }
       }
     },
@@ -178,6 +181,9 @@
         },
         "filename": {
           "$ref": "#/definitions/FilenameTemplate"
+        },
+        "publicPath": {
+          "$ref": "#/definitions/RawPublicPath"
         }
       }
     },
@@ -965,6 +971,16 @@
             "minLength": 1
           }
         },
+        "maxAge": {
+          "description": "Time for which unused cache entries stay in the filesystem cache at minimum (in milliseconds).",
+          "type": "number",
+          "minimum": 0
+        },
+        "maxMemoryGenerations": {
+          "description": "Number of generations unused cache entries stay in memory cache at minimum (0 = no memory cache used, 1 = may be removed after unused for a single compilation, ..., Infinity: kept forever). Cache entries will be deserialized from disk when removed from memory cache.",
+          "type": "number",
+          "minimum": 0
+        },
         "name": {
           "description": "Name for the cache. Different names will lead to different coexisting caches.",
           "type": "string"
@@ -1195,6 +1211,18 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
+        "appendOnly": {
+          "description": "Only appends lines to the output. Avoids updating existing output e. g. for status messages. This option is only used when no custom console is provided.",
+          "type": "boolean"
+        },
+        "colors": {
+          "description": "Enables/Disables colorful output. This option is only used when no custom console is provided.",
+          "type": "boolean"
+        },
+        "console": {
+          "description": "Custom console used for logging.",
+          "tsType": "Console"
+        },
         "debug": {
           "description": "Enable debug logging for specific loggers.",
           "anyOf": [
@@ -1210,6 +1238,10 @@
         "level": {
           "description": "Log level.",
           "enum": ["none", "error", "warn", "info", "log", "verbose"]
+        },
+        "stream": {
+          "description": "Stream used for logging output. Defaults to process.stderr. This option is only used when no custom console is provided.",
+          "tsType": "NodeJS.WritableStream"
         }
       }
     },
@@ -1541,6 +1573,11 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
+        "maxGenerations": {
+          "description": "Number of generations unused cache entries stay in memory cache at minimum (1 = may be removed after unused for a single compilation, ..., Infinity: kept forever).",
+          "type": "number",
+          "minimum": 1
+        },
         "type": {
           "description": "In memory caching.",
           "enum": ["memory"]
@@ -2912,11 +2949,19 @@
       "type": "boolean"
     },
     "PublicPath": {
-      "description": "The `publicPath` specifies the public URL address of the output files when referenced in a browser.",
+      "description": "The 'publicPath' specifies the public URL address of the output files when referenced in a browser.",
       "anyOf": [
         {
           "enum": ["auto"]
         },
+        {
+          "$ref": "#/definitions/RawPublicPath"
+        }
+      ]
+    },
+    "RawPublicPath": {
+      "description": "The 'publicPath' specifies the public URL address of the output files when referenced in a browser.",
+      "anyOf": [
         {
           "type": "string"
         },
@@ -4088,6 +4133,10 @@
           "description": "Group modules by their path.",
           "type": "boolean"
         },
+        "groupModulesByType": {
+          "description": "Group modules by their type.",
+          "type": "boolean"
+        },
         "hash": {
           "description": "Add the hash of the compilation.",
           "type": "boolean"

package/types.d.ts

@@ -312,8 +312,20 @@ declare interface AssetResourceGeneratorOptions {
 	 * Specifies the filename template of output files on disk. You must **not** specify an absolute path here, but the path may contain folders separated by '/'! The specified path is joined with the value of the 'output.path' option to determine the location on disk.
 	 */
 	filename?: string | ((pathData: PathData, assetInfo?: AssetInfo) => string);
+
+	/**
+	 * The 'publicPath' specifies the public URL address of the output files when referenced in a browser.
+	 */
+	publicPath?: string | ((pathData: PathData, assetInfo?: AssetInfo) => string);
 }
-declare abstract class AsyncDependenciesBlock extends DependenciesBlock {
+declare class AsyncDependenciesBlock extends DependenciesBlock {
+	constructor(
+		groupOptions: RawChunkGroupOptions & { name?: string } & {
+			entryOptions?: EntryOptions;
+		},
+		loc?: SyntheticDependencyLocation | RealDependencyLocation,
+		request?: string
+	);
 	groupOptions: RawChunkGroupOptions & { name?: string } & {
 		entryOptions?: EntryOptions;
 	};
@@ -2094,6 +2106,22 @@ type ConnectionState =
 	| boolean
 	| typeof TRANSITIVE_ONLY
 	| typeof CIRCULAR_CONNECTION;
+declare class ConstDependency extends NullDependency {
+	constructor(
+		expression: string,
+		range: number | [number, number],
+		runtimeRequirements?: string[]
+	);
+	expression: string;
+	range: number | [number, number];
+	runtimeRequirements: null | Set<string>;
+	static Template: typeof ConstDependencyTemplate;
+	static NO_EXPORTS_REFERENCED: string[][];
+	static EXPORTS_OBJECT_REFERENCED: string[][];
+}
+declare class ConstDependencyTemplate extends NullDependencyTemplate {
+	constructor();
+}
 declare interface Constructor {
 	new (...params: any[]): any;
 }
@@ -2431,14 +2459,15 @@ declare class Dependency {
 	deserialize(__0: { read: any }): void;
 	module: any;
 	readonly disconnect: any;
-	static NO_EXPORTS_REFERENCED: any[];
-	static EXPORTS_OBJECT_REFERENCED: never[][];
+	static NO_EXPORTS_REFERENCED: string[][];
+	static EXPORTS_OBJECT_REFERENCED: string[][];
 }
 declare interface DependencyConstructor {
 	new (...args: any[]): Dependency;
 }
 type DependencyLocation = SyntheticDependencyLocation | RealDependencyLocation;
-declare abstract class DependencyTemplate {
+declare class DependencyTemplate {
+	constructor();
 	apply(
 		dependency: Dependency,
 		source: ReplaceSource,
@@ -3168,9 +3197,10 @@ declare abstract class ExportInfo {
 	setUsed(newValue: UsageStateType, runtime: RuntimeSpec): boolean;
 	unsetTarget(key?: any): boolean;
 	setTarget(
-		key?: any,
-		connection?: ModuleGraphConnection,
-		exportName?: string[]
+		key: any,
+		connection: ModuleGraphConnection,
+		exportName?: string[],
+		priority?: number
 	): boolean;
 	getUsed(runtime: RuntimeSpec): UsageStateType;
 
@@ -3274,6 +3304,11 @@ declare interface ExportSpec {
 	 */
 	export?: null | string[];
 
+	/**
+	 * when reexported: with which priority
+	 */
+	priority?: number;
+
 	/**
 	 * export is not visible, because another export blends over it
 	 */
@@ -3298,7 +3333,8 @@ declare abstract class ExportsInfo {
 		canMangle?: boolean,
 		excludeExports?: Set<string>,
 		targetKey?: any,
-		targetModule?: ModuleGraphConnection
+		targetModule?: ModuleGraphConnection,
+		priority?: number
 	): boolean;
 	setUsedInUnknownWay(runtime: RuntimeSpec): boolean;
 	setUsedWithoutInfo(runtime: RuntimeSpec): boolean;
@@ -3347,6 +3383,11 @@ declare interface ExportsSpec {
 	 */
 	from?: ModuleGraphConnection;
 
+	/**
+	 * when reexported: with which priority
+	 */
+	priority?: number;
+
 	/**
 	 * can the export be renamed (defaults to true)
 	 */
@@ -3664,6 +3705,16 @@ declare interface FileCacheOptions {
 	 */
 	managedPaths?: string[];
 
+	/**
+	 * Time for which unused cache entries stay in the filesystem cache at minimum (in milliseconds).
+	 */
+	maxAge?: number;
+
+	/**
+	 * Number of generations unused cache entries stay in memory cache at minimum (0 = no memory cache used, 1 = may be removed after unused for a single compilation, ..., Infinity: kept forever). Cache entries will be deserialized from disk when removed from memory cache.
+	 */
+	maxMemoryGenerations?: number;
+
 	/**
 	 * Name for the cache. Different names will lead to different coexisting caches.
 	 */
@@ -3755,6 +3806,7 @@ declare abstract class FileSystemInfo {
 	immutablePaths: string[];
 	immutablePathsWithSlash: string[];
 	logStatistics(): void;
+	clear(): void;
 	addFileTimestamps(
 		map: Map<string, null | FileSystemInfoEntry | "ignore">
 	): void;
@@ -3789,7 +3841,7 @@ declare abstract class FileSystemInfo {
 		callback: (arg0?: Error, arg1?: ResolveBuildDependenciesResult) => void
 	): void;
 	checkResolveResultsValid(
-		resolveResults: Map<string, string>,
+		resolveResults: Map<string, string | false>,
 		callback: (arg0?: Error, arg1?: boolean) => void
 	): void;
 	createSnapshot(
@@ -4144,6 +4196,21 @@ type ImportSource = undefined | null | string | SimpleLiteral | RegExpLiteral;
  * Options for infrastructure level logging.
  */
 declare interface InfrastructureLogging {
+	/**
+	 * Only appends lines to the output. Avoids updating existing output e. g. for status messages. This option is only used when no custom console is provided.
+	 */
+	appendOnly?: boolean;
+
+	/**
+	 * Enables/Disables colorful output. This option is only used when no custom console is provided.
+	 */
+	colors?: boolean;
+
+	/**
+	 * Custom console used for logging.
+	 */
+	console?: Console;
+
 	/**
 	 * Enable debug logging for specific loggers.
 	 */
@@ -4158,6 +4225,11 @@ declare interface InfrastructureLogging {
 	 * Log level.
 	 */
 	level?: "none" | "verbose" | "error" | "warn" | "info" | "log";
+
+	/**
+	 * Stream used for logging output. Defaults to process.stderr. This option is only used when no custom console is provided.
+	 */
+	stream?: NodeJS.WritableStream;
 }
 declare abstract class InitFragment {
 	content: string | Source;
@@ -5232,9 +5304,9 @@ declare interface KnownStatsError {
 	loc?: string;
 	chunkId?: string | number;
 	moduleId?: string | number;
-	moduleTrace?: any;
+	moduleTrace?: StatsModuleTraceItem[];
 	details?: any;
-	stack?: any;
+	stack?: string;
 }
 declare interface KnownStatsFactoryContext {
 	type: string;
@@ -5320,6 +5392,18 @@ declare interface KnownStatsModuleReason {
 	moduleId?: string | number;
 	resolvedModuleId?: string | number;
 }
+declare interface KnownStatsModuleTraceDependency {
+	loc?: string;
+}
+declare interface KnownStatsModuleTraceItem {
+	originIdentifier?: string;
+	originName?: string;
+	moduleIdentifier?: string;
+	moduleName?: string;
+	dependencies?: StatsModuleTraceDependency[];
+	originId?: string | number;
+	moduleId?: string | number;
+}
 declare interface KnownStatsPrinterContext {
 	type?: string;
 	compilation?: StatsCompilation;
@@ -5698,6 +5782,11 @@ declare interface MapOptions {
  * Options object for in-memory caching.
  */
 declare interface MemoryCacheOptions {
+	/**
+	 * Number of generations unused cache entries stay in memory cache at minimum (1 = may be removed after unused for a single compilation, ..., Infinity: kept forever).
+	 */
+	maxGenerations?: number;
+
 	/**
 	 * In memory caching.
 	 */
@@ -5880,10 +5969,14 @@ declare class ModuleConcatenationPlugin {
 	 */
 	apply(compiler: Compiler): void;
 }
-declare abstract class ModuleDependency extends Dependency {
+declare class ModuleDependency extends Dependency {
+	constructor(request: string);
 	request: string;
 	userRequest: string;
 	range: any;
+	static Template: typeof DependencyTemplate;
+	static NO_EXPORTS_REFERENCED: string[][];
+	static EXPORTS_OBJECT_REFERENCED: string[][];
 }
 declare abstract class ModuleFactory {
 	create(
@@ -6432,8 +6525,18 @@ declare class NoEmitOnErrorsPlugin {
 	apply(compiler: Compiler): void;
 }
 declare class NodeEnvironmentPlugin {
-	constructor(options?: any);
-	options: any;
+	constructor(options: {
+		/**
+		 * infrastructure logging options
+		 */
+		infrastructureLogging: InfrastructureLogging;
+	});
+	options: {
+		/**
+		 * infrastructure logging options
+		 */
+		infrastructureLogging: InfrastructureLogging;
+	};
 
 	/**
 	 * Apply the plugin
@@ -6774,6 +6877,15 @@ type NormalizedStatsOptions = KnownNormalizedStatsOptions &
 		| "_env"
 	> &
 	Record<string, any>;
+declare class NullDependency extends Dependency {
+	constructor();
+	static Template: typeof NullDependencyTemplate;
+	static NO_EXPORTS_REFERENCED: string[][];
+	static EXPORTS_OBJECT_REFERENCED: string[][];
+}
+declare class NullDependencyTemplate extends DependencyTemplate {
+	constructor();
+}
 declare interface ObjectDeserializerContext {
 	read: () => any;
 }
@@ -7388,7 +7500,7 @@ declare interface Output {
 	pathinfo?: boolean | "verbose";
 
 	/**
-	 * The `publicPath` specifies the public URL address of the output files when referenced in a browser.
+	 * The 'publicPath' specifies the public URL address of the output files when referenced in a browser.
 	 */
 	publicPath?: string | ((pathData: PathData, assetInfo?: AssetInfo) => string);
 
@@ -7650,7 +7762,7 @@ declare interface OutputNormalized {
 	pathinfo?: boolean | "verbose";
 
 	/**
-	 * The `publicPath` specifies the public URL address of the output files when referenced in a browser.
+	 * The 'publicPath' specifies the public URL address of the output files when referenced in a browser.
 	 */
 	publicPath?: string | ((pathData: PathData, assetInfo?: AssetInfo) => string);
 
@@ -8263,7 +8375,7 @@ declare interface ResolveBuildDependenciesResult {
 	/**
 	 * stored resolve results
 	 */
-	resolveResults: Map<string, string>;
+	resolveResults: Map<string, string | false>;
 
 	/**
 	 * dependencies of the resolving
@@ -10136,6 +10248,9 @@ type StatsLoggingEntry = KnownStatsLoggingEntry & Record<string, any>;
 type StatsModule = KnownStatsModule & Record<string, any>;
 type StatsModuleIssuer = KnownStatsModuleIssuer & Record<string, any>;
 type StatsModuleReason = KnownStatsModuleReason & Record<string, any>;
+type StatsModuleTraceDependency = KnownStatsModuleTraceDependency &
+	Record<string, any>;
+type StatsModuleTraceItem = KnownStatsModuleTraceItem & Record<string, any>;
 
 /**
  * Stats options object.
@@ -10400,6 +10515,11 @@ declare interface StatsOptions {
 	 */
 	groupModulesByPath?: boolean;
 
+	/**
+	 * Group modules by their type.
+	 */
+	groupModulesByType?: boolean;
+
 	/**
 	 * Add the hash of the compilation.
 	 */
@@ -11414,6 +11534,9 @@ declare namespace exports {
 			options: WebpackOptionsNormalized
 		) => void;
 	}
+	export namespace dependencies {
+		export { ModuleDependency, ConstDependency, NullDependency };
+	}
 	export namespace ids {
 		export {
 			ChunkModuleIdRangePlugin,
@@ -11605,6 +11728,7 @@ declare namespace exports {
 	) => void;
 	export {
 		AutomaticPrefetchPlugin,
+		AsyncDependenciesBlock,
 		BannerPlugin,
 		Cache,
 		Chunk,
@@ -11676,7 +11800,20 @@ declare namespace exports {
 		MultiStats,
 		ParserState,
 		Watching,
-		StatsCompilation
+		StatsAsset,
+		StatsChunk,
+		StatsChunkGroup,
+		StatsChunkOrigin,
+		StatsCompilation,
+		StatsError,
+		StatsLogging,
+		StatsLoggingEntry,
+		StatsModule,
+		StatsModuleIssuer,
+		StatsModuleReason,
+		StatsModuleTraceDependency,
+		StatsModuleTraceItem,
+		StatsProfile
 	};
 }