webpack 5.2.1 → 5.4.0

package/types.d.ts

@@ -217,22 +217,22 @@ declare interface AssetInfo {
 	/**
 	 * the value(s) of the full hash used for this asset
 	 */
-	fullhash?: LibraryExport;
+	fullhash?: EntryItem;
 
 	/**
 	 * the value(s) of the chunk hash used for this asset
 	 */
-	chunkhash?: LibraryExport;
+	chunkhash?: EntryItem;
 
 	/**
 	 * the value(s) of the module hash used for this asset
 	 */
-	modulehash?: LibraryExport;
+	modulehash?: EntryItem;
 
 	/**
 	 * the value(s) of the content hash used for this asset
 	 */
-	contenthash?: LibraryExport;
+	contenthash?: EntryItem;
 
 	/**
 	 * when asset was created from a source file (potentially transformed), the original filename relative to compilation context
@@ -262,7 +262,7 @@ declare interface AssetInfo {
 	/**
 	 * object of pointers to other assets, keyed by type of relation (only points from parent to child)
 	 */
-	related?: Record<string, LibraryExport>;
+	related?: Record<string, EntryItem>;
 }
 type AssetModuleFilename =
 	| string
@@ -784,6 +784,8 @@ declare class ChunkGraph {
 	disconnectChunkGroup(chunkGroup: ChunkGroup): void;
 	getModuleId(module: Module): string | number;
 	setModuleId(module: Module, id: string | number): void;
+	getRuntimeId(runtime: string): string | number;
+	setRuntimeId(runtime: string, id: string | number): void;
 	hasModuleHashes(
 		module: Module,
 		runtime: string | SortableSet<string>
@@ -1450,6 +1452,7 @@ declare class Compilation {
 	): void;
 	patchChunksAfterReasonRemoval(module: Module, chunk: Chunk): void;
 	removeChunkFromDependencies(block: DependenciesBlock, chunk: Chunk): void;
+	assignRuntimeIds(): void;
 	sortItemsWithChunkIds(): void;
 	summarizeDependencies(): void;
 	createModuleHashes(): void;
@@ -1724,7 +1727,9 @@ declare interface ConcatenationBailoutReasonContext {
 }
 declare class ConcatenationScope {
 	constructor(
-		modulesWithInfo: (ConcatenatedModuleInfo | ExternalModuleInfo)[],
+		modulesMap:
+			| (ConcatenatedModuleInfo | ExternalModuleInfo)[]
+			| Map<Module, ConcatenatedModuleInfo | ExternalModuleInfo>,
 		currentModule: ConcatenatedModuleInfo
 	);
 	isModuleInScope(module: Module): boolean;
@@ -2607,9 +2612,9 @@ declare class EnableLibraryPlugin {
 }
 type Entry =
 	| string
-	| (() => string | EntryObject | [string, ...string[]] | Promise<EntryStatic>)
+	| (() => string | EntryObject | string[] | Promise<EntryStatic>)
 	| EntryObject
-	| [string, ...string[]];
+	| string[];
 declare interface EntryData {
 	/**
 	 * dependencies of the entrypoint that should be evaluated at startup
@@ -2688,7 +2693,7 @@ declare interface EntryDescriptionNormalized {
 	/**
 	 * The entrypoints that the current entrypoint depend on. They must be loaded when this entrypoint is loaded.
 	 */
-	dependOn?: [string, ...string[]];
+	dependOn?: string[];
 
 	/**
 	 * Specifies the name of each output file on disk. You must **not** specify an absolute path here! The `output.path` option determines the location on disk the files are written to, filename is used solely for naming the individual files.
@@ -2698,7 +2703,7 @@ declare interface EntryDescriptionNormalized {
 	/**
 	 * Module(s) that are loaded upon startup. The last one is exported.
 	 */
-	import?: [string, ...string[]];
+	import?: string[];
 
 	/**
 	 * Options for library.
@@ -2715,7 +2720,7 @@ declare interface EntryDescriptionNormalized {
 	 */
 	wasmLoading?: DevTool;
 }
-type EntryItem = string | [string, ...string[]];
+type EntryItem = string | string[];
 type EntryNormalized =
 	| (() => Promise<EntryStaticNormalized>)
 	| EntryStaticNormalized;
@@ -2724,7 +2729,7 @@ type EntryNormalized =
  * Multiple entry bundles are created. The key is the entry name. The value can be a string, an array or an entry description object.
  */
 declare interface EntryObject {
-	[index: string]: string | [string, ...string[]] | EntryDescription;
+	[index: string]: string | string[] | EntryDescription;
 }
 declare class EntryOptionPlugin {
 	constructor();
@@ -2801,7 +2806,7 @@ declare class EntryPlugin {
 			  >)
 	): EntryDependency;
 }
-type EntryStatic = string | EntryObject | [string, ...string[]];
+type EntryStatic = string | EntryObject | string[];
 
 /**
  * Multiple entry bundles are created. The key is the entry name. The value is an entry description object.
@@ -3093,20 +3098,17 @@ declare abstract class ExportsInfo {
 	): boolean | SortableSet<string>;
 	getProvidedExports(): true | string[];
 	getRelevantExports(runtime: string | SortableSet<string>): ExportInfo[];
-	isExportProvided(name: LibraryExport): boolean;
+	isExportProvided(name: EntryItem): boolean;
 	getUsageKey(runtime: string | SortableSet<string>): string;
 	isEquallyUsed(
 		runtimeA: string | SortableSet<string>,
 		runtimeB: string | SortableSet<string>
 	): boolean;
 	getUsed(
-		name: LibraryExport,
+		name: EntryItem,
 		runtime: string | SortableSet<string>
 	): 0 | 1 | 2 | 3 | 4;
-	getUsedName(
-		name: LibraryExport,
-		runtime: string | SortableSet<string>
-	): string | false | string[];
+	getUsedName(name: EntryItem, runtime: string | SortableSet<string>): Target;
 	updateHash(hash: Hash, runtime: string | SortableSet<string>): void;
 	getRestoreProvidedData(): any;
 	restoreProvided(__0: {
@@ -3202,7 +3204,7 @@ type ExternalItem =
 	  ) => void);
 declare class ExternalModule extends Module {
 	constructor(request?: any, type?: any, userRequest?: any);
-	request: string | string[] | Record<string, LibraryExport>;
+	request: string | string[] | Record<string, EntryItem>;
 	externalType: string;
 	userRequest: string;
 	getSourceData(
@@ -4318,6 +4320,7 @@ declare class JavascriptParser extends Parser {
 	): boolean;
 	getComments(range?: any): any;
 	isAsiPosition(pos: number): boolean;
+	unsetAsiPosition(pos: number): void;
 	isStatementLevelExpression(expr?: any): boolean;
 	getTagData(name?: any, tag?: any): any;
 	tagVariable(name?: any, tag?: any, data?: any): void;
@@ -4514,9 +4517,8 @@ declare interface LibraryCustomUmdObject {
 	/**
 	 * Name of the property exposed globally by a UMD library.
 	 */
-	root?: LibraryExport;
+	root?: EntryItem;
 }
-type LibraryExport = string | string[];
 type LibraryName = string | string[] | LibraryCustomUmdObject;
 
 /**
@@ -4531,7 +4533,7 @@ declare interface LibraryOptions {
 	/**
 	 * Specify which export should be exposed as library.
 	 */
-	export?: LibraryExport;
+	export?: EntryItem;
 
 	/**
 	 * The name of the library (some types allow unnamed libraries too).
@@ -4554,14 +4556,14 @@ declare class LibraryTemplatePlugin {
 		target: string,
 		umdNamedDefine: boolean,
 		auxiliaryComment: AuxiliaryComment,
-		exportProperty: LibraryExport
+		exportProperty: EntryItem
 	);
 	library: {
 		type: string;
 		name: LibraryName;
 		umdNamedDefine: boolean;
 		auxiliaryComment: AuxiliaryComment;
-		export: LibraryExport;
+		export: EntryItem;
 	};
 
 	/**
@@ -5049,7 +5051,7 @@ declare class ModuleGraph {
 		module: Module
 	): (string | ((requestShortener: RequestShortener) => string))[];
 	getProvidedExports(module: Module): true | string[];
-	isExportProvided(module: Module, exportName: LibraryExport): boolean;
+	isExportProvided(module: Module, exportName: EntryItem): boolean;
 	getExportsInfo(module: Module): ExportsInfo;
 	getExportInfo(module: Module, exportName: string): ExportInfo;
 	getReadOnlyExportInfo(module: Module, exportName: string): ExportInfo;
@@ -5160,11 +5162,7 @@ declare interface ModuleOptions {
 	/**
 	 * Don't parse files matching. It's matched against the full resolved request.
 	 */
-	noParse?:
-		| string
-		| Function
-		| RegExp
-		| [string | Function | RegExp, ...(string | Function | RegExp)[]];
+	noParse?: string | Function | RegExp | (string | Function | RegExp)[];
 
 	/**
 	 * An array of rules applied for modules.
@@ -5844,9 +5842,9 @@ declare interface Optimization {
 	runtimeChunk?: OptimizationRuntimeChunk;
 
 	/**
-	 * Skip over modules which are flagged to contain no side effects when exports are not used.
+	 * Skip over modules which contain no side effects when exports are not used (false: disabled, 'flag': only use manually placed side effects flag, true: also analyse source code for side effects).
 	 */
-	sideEffects?: boolean;
+	sideEffects?: boolean | "flag";
 
 	/**
 	 * Optimize duplication and caching by splitting chunks by shared modules and cache group.
@@ -6262,7 +6260,7 @@ declare interface Output {
 	/**
 	 * Specify which export should be exposed as library.
 	 */
-	libraryExport?: LibraryExport;
+	libraryExport?: EntryItem;
 
 	/**
 	 * Type of library (types included by default are 'var', 'module', 'assign', 'this', 'window', 'self', 'global', 'commonjs', 'commonjs2', 'commonjs-module', 'amd', 'amd-require', 'umd', 'umd2', 'jsonp', 'system', but others might be added by plugins).
@@ -6782,8 +6780,8 @@ declare interface ProgressPluginOptions {
 	profile?: boolean;
 }
 declare class ProvidePlugin {
-	constructor(definitions: Record<string, LibraryExport>);
-	definitions: Record<string, LibraryExport>;
+	constructor(definitions: Record<string, EntryItem>);
+	definitions: Record<string, EntryItem>;
 
 	/**
 	 * Apply the plugin
@@ -7049,7 +7047,7 @@ type ResolveAlias =
 			/**
 			 * New request.
 			 */
-			alias: string | false | string[];
+			alias: Target;
 			/**
 			 * Request to be redirected.
 			 */
@@ -7059,7 +7057,7 @@ type ResolveAlias =
 			 */
 			onlyModule?: boolean;
 	  }[]
-	| { [index: string]: string | false | string[] };
+	| { [index: string]: Target };
 declare interface ResolveBuildDependenciesResult {
 	/**
 	 * list of files
@@ -7147,7 +7145,7 @@ declare interface ResolveOptionsTypes {
 		/**
 		 * New request.
 		 */
-		alias: string | false | string[];
+		alias: Target;
 		/**
 		 * Request to be redirected.
 		 */
@@ -7161,7 +7159,7 @@ declare interface ResolveOptionsTypes {
 		/**
 		 * New request.
 		 */
-		alias: string | false | string[];
+		alias: Target;
 		/**
 		 * Request to be redirected.
 		 */
@@ -7171,7 +7169,7 @@ declare interface ResolveOptionsTypes {
 		 */
 		onlyModule?: boolean;
 	}[];
-	aliasFields: Set<LibraryExport>;
+	aliasFields: Set<EntryItem>;
 	cachePredicate: (arg0: ResolveRequest) => boolean;
 	cacheWithContext: boolean;
 
@@ -7181,14 +7179,14 @@ declare interface ResolveOptionsTypes {
 	conditionNames: Set<string>;
 	descriptionFiles: string[];
 	enforceExtension: boolean;
-	exportsFields: Set<LibraryExport>;
-	importsFields: Set<LibraryExport>;
+	exportsFields: Set<EntryItem>;
+	importsFields: Set<EntryItem>;
 	extensions: Set<string>;
 	fileSystem: FileSystem;
 	unsafeCache: any;
 	symlinks: boolean;
 	resolver?: Resolver;
-	modules: LibraryExport[];
+	modules: EntryItem[];
 	mainFields: { name: string[]; forceRelative: boolean }[];
 	mainFiles: Set<string>;
 	plugins: (
@@ -7215,7 +7213,7 @@ declare interface ResolveOptionsWebpackOptions {
 	/**
 	 * Fields in the description file (usually package.json) which are used to redirect requests inside the module.
 	 */
-	aliasFields?: LibraryExport[];
+	aliasFields?: EntryItem[];
 
 	/**
 	 * Extra resolve options per dependency category. Typical categories are "commonjs", "amd", "esm".
@@ -7285,7 +7283,7 @@ declare interface ResolveOptionsWebpackOptions {
 	/**
 	 * Field names from the description file (package.json) which are used to find the default entry point.
 	 */
-	mainFields?: LibraryExport[];
+	mainFields?: EntryItem[];
 
 	/**
 	 * Filenames used to find the default entry point if there is no description file or main field.
@@ -7417,7 +7415,7 @@ declare abstract class ResolverFactory {
 						/**
 						 * Fields in the description file (usually package.json) which are used to redirect requests inside the module.
 						 */
-						aliasFields?: LibraryExport[];
+						aliasFields?: EntryItem[];
 						/**
 						 * Extra resolve options per dependency category. Typical categories are "commonjs", "amd", "esm".
 						 */
@@ -7473,7 +7471,7 @@ declare abstract class ResolverFactory {
 						/**
 						 * Field names from the description file (package.json) which are used to find the default entry point.
 						 */
-						mainFields?: LibraryExport[];
+						mainFields?: EntryItem[];
 						/**
 						 * Filenames used to find the default entry point if there is no description file or main field.
 						 */
@@ -7533,7 +7531,7 @@ declare abstract class ResolverFactory {
 						/**
 						 * Fields in the description file (usually package.json) which are used to redirect requests inside the module.
 						 */
-						aliasFields?: LibraryExport[];
+						aliasFields?: EntryItem[];
 						/**
 						 * Extra resolve options per dependency category. Typical categories are "commonjs", "amd", "esm".
 						 */
@@ -7589,7 +7587,7 @@ declare abstract class ResolverFactory {
 						/**
 						 * Field names from the description file (package.json) which are used to find the default entry point.
 						 */
-						mainFields?: LibraryExport[];
+						mainFields?: EntryItem[];
 						/**
 						 * Filenames used to find the default entry point if there is no description file or main field.
 						 */
@@ -7649,7 +7647,7 @@ declare abstract class ResolverFactory {
 			/**
 			 * Fields in the description file (usually package.json) which are used to redirect requests inside the module.
 			 */
-			aliasFields?: LibraryExport[];
+			aliasFields?: EntryItem[];
 			/**
 			 * Extra resolve options per dependency category. Typical categories are "commonjs", "amd", "esm".
 			 */
@@ -7705,7 +7703,7 @@ declare abstract class ResolverFactory {
 			/**
 			 * Field names from the description file (package.json) which are used to find the default entry point.
 			 */
-			mainFields?: LibraryExport[];
+			mainFields?: EntryItem[];
 			/**
 			 * Filenames used to find the default entry point if there is no description file or main field.
 			 */
@@ -8234,6 +8232,24 @@ declare abstract class RuntimeTemplate {
 		 */
 		runtimeRequirements: Set<string>;
 	}): string;
+	runtimeConditionExpression(__0: {
+		/**
+		 * the chunk graph
+		 */
+		chunkGraph: ChunkGraph;
+		/**
+		 * runtime for which this code will be generated
+		 */
+		runtime?: string | SortableSet<string>;
+		/**
+		 * only execute the statement in some runtimes
+		 */
+		runtimeCondition?: string | boolean | SortableSet<string>;
+		/**
+		 * if set, will be filled with runtime requirements
+		 */
+		runtimeRequirements: Set<string>;
+	}): string;
 	importStatement(__0: {
 		/**
 		 * whether a new variable should be created or the existing one updated
@@ -8263,6 +8279,14 @@ declare abstract class RuntimeTemplate {
 		 * true, if this is a weak dependency
 		 */
 		weak?: boolean;
+		/**
+		 * runtime for which this code will be generated
+		 */
+		runtime?: string | SortableSet<string>;
+		/**
+		 * only execute the statement in some runtimes
+		 */
+		runtimeCondition?: string | boolean | SortableSet<string>;
 		/**
 		 * if set, will be filled with runtime requirements
 		 */
@@ -8284,7 +8308,7 @@ declare abstract class RuntimeTemplate {
 		/**
 		 * the export name
 		 */
-		exportName: LibraryExport;
+		exportName: EntryItem;
 		/**
 		 * the origin module
 		 */
@@ -8490,7 +8514,7 @@ declare interface SharedObject {
 	[index: string]: string | SharedConfig;
 }
 declare class SideEffectsFlagPlugin {
-	constructor();
+	constructor(analyseSource?: boolean);
 
 	/**
 	 * Apply the plugin
@@ -9283,7 +9307,7 @@ declare interface TagInfo {
 	data: any;
 	next: TagInfo;
 }
-type Target = string | false | [string, ...string[]];
+type Target = string | false | string[];
 declare class Template {
 	constructor();
 	static getFunctionContent(fn: Function): string;
@@ -9293,9 +9317,9 @@ declare class Template {
 	static toPath(str: string): string;
 	static numberToIdentifier(n: number): string;
 	static numberToIdentifierContinuation(n: number): string;
-	static indent(s: LibraryExport): string;
-	static prefix(s: LibraryExport, prefix: string): string;
-	static asString(str: LibraryExport): string;
+	static indent(s: EntryItem): string;
+	static prefix(s: EntryItem, prefix: string): string;
+	static asString(str: EntryItem): string;
 	static getModulesArrayBounds(modules: WithId[]): false | [number, number];
 	static renderChunkModules(
 		renderContext: RenderContextModuleTemplate,
@@ -9324,6 +9348,7 @@ declare const UNDEFINED_MARKER: unique symbol;
 declare interface UpdateHashContextDependency {
 	chunkGraph: ChunkGraph;
 	runtime: string | SortableSet<string>;
+	runtimeTemplate?: RuntimeTemplate;
 }
 declare interface UpdateHashContextGenerator {
 	/**
@@ -9338,12 +9363,12 @@ declare interface UserResolveOptions {
 	 * A list of module alias configurations or an object which maps key to value
 	 */
 	alias?:
-		| { [index: string]: string | false | string[] }
+		| { [index: string]: Target }
 		| {
 				/**
 				 * New request.
 				 */
-				alias: string | false | string[];
+				alias: Target;
 				/**
 				 * Request to be redirected.
 				 */
@@ -9358,12 +9383,12 @@ declare interface UserResolveOptions {
 	 * A list of module alias configurations or an object which maps key to value, applied only after modules option
 	 */
 	fallback?:
-		| { [index: string]: string | false | string[] }
+		| { [index: string]: Target }
 		| {
 				/**
 				 * New request.
 				 */
-				alias: string | false | string[];
+				alias: Target;
 				/**
 				 * Request to be redirected.
 				 */
@@ -9377,7 +9402,7 @@ declare interface UserResolveOptions {
 	/**
 	 * A list of alias fields in description files
 	 */
-	aliasFields?: LibraryExport[];
+	aliasFields?: EntryItem[];
 
 	/**
 	 * A function which decides whether a request should be cached or not. An object is passed with at least `path` and `request` properties.
@@ -9407,12 +9432,12 @@ declare interface UserResolveOptions {
 	/**
 	 * A list of exports fields in description files
 	 */
-	exportsFields?: LibraryExport[];
+	exportsFields?: EntryItem[];
 
 	/**
 	 * A list of imports fields in description files
 	 */
-	importsFields?: LibraryExport[];
+	importsFields?: EntryItem[];
 
 	/**
 	 * A list of extensions which should be tried for files
@@ -9442,7 +9467,7 @@ declare interface UserResolveOptions {
 	/**
 	 * A list of directories to resolve modules from, can be absolute path or folder name
 	 */
-	modules?: LibraryExport;
+	modules?: EntryItem;
 
 	/**
 	 * A list of main fields in description files
@@ -9450,7 +9475,7 @@ declare interface UserResolveOptions {
 	mainFields?: (
 		| string
 		| string[]
-		| { name: LibraryExport; forceRelative: boolean }
+		| { name: EntryItem; forceRelative: boolean }
 	)[];
 
 	/**
@@ -9525,7 +9550,7 @@ declare interface WatchFileSystem {
 }
 declare class WatchIgnorePlugin {
 	constructor(options: WatchIgnorePluginOptions);
-	paths: [string | RegExp, ...(string | RegExp)[]];
+	paths: (string | RegExp)[];
 
 	/**
 	 * Apply the plugin
@@ -9536,7 +9561,7 @@ declare interface WatchIgnorePluginOptions {
 	/**
 	 * A list of RegExps or absolute paths to directories or files that should be ignored.
 	 */
-	paths: [string | RegExp, ...(string | RegExp)[]];
+	paths: (string | RegExp)[];
 }
 
 /**
@@ -9888,7 +9913,7 @@ declare interface WithOptions {
 			/**
 			 * Fields in the description file (usually package.json) which are used to redirect requests inside the module.
 			 */
-			aliasFields?: LibraryExport[];
+			aliasFields?: EntryItem[];
 			/**
 			 * Extra resolve options per dependency category. Typical categories are "commonjs", "amd", "esm".
 			 */
@@ -9944,7 +9969,7 @@ declare interface WithOptions {
 			/**
 			 * Field names from the description file (package.json) which are used to find the default entry point.
 			 */
-			mainFields?: LibraryExport[];
+			mainFields?: EntryItem[];
 			/**
 			 * Filenames used to find the default entry point if there is no description file or main field.
 			 */
@@ -10112,6 +10137,7 @@ declare namespace exports {
 		export let scriptNonce: string;
 		export let loadScript: string;
 		export let chunkName: string;
+		export let runtimeId: string;
 		export let getChunkScriptFilename: string;
 		export let getChunkUpdateScriptFilename: string;
 		export let startup: string;