webpack 5.100.2 → 5.101.1

package/schemas/WebpackOptions.json

@@ -1874,6 +1874,10 @@
             }
           ]
         },
+        "deferImport": {
+          "description": "Enable experimental tc39 proposal https://github.com/tc39/proposal-defer-import-eval. This allows to defer execution of a module until it's first use.",
+          "type": "boolean"
+        },
         "dynamicImportFetchPriority": {
           "description": "Specifies global fetchPriority for dynamic import.",
           "enum": ["low", "high", "auto", false]

package/types.d.ts

@@ -160,6 +160,12 @@ declare class AbstractLibraryPlugin<T> {
 		renderContext: StartupRenderContext,
 		libraryContext: LibraryContext<T>
 	): Source;
+	renderModuleContent(
+		source: Source,
+		module: Module,
+		renderContext: ModuleRenderContext,
+		libraryContext: Omit<LibraryContext<T>, "options">
+	): Source;
 	chunkHash(
 		chunk: Chunk,
 		hash: Hash,
@@ -1180,6 +1186,7 @@ declare interface CallbackWebpack<T> {
 	(err: null | Error, stats?: T): void;
 }
 type Cell<T> = undefined | T;
+type ChildrenStatsOptions = undefined | string | boolean | StatsOptions;
 declare class Chunk {
 	constructor(name?: null | string, backCompat?: boolean);
 	id: null | string | number;
@@ -1366,6 +1373,7 @@ declare class ChunkGraph {
 	getNumberOfRuntimeModules(chunk: Chunk): number;
 	getChunkEntryModulesIterable(chunk: Chunk): Iterable<Module>;
 	getChunkEntryDependentChunksIterable(chunk: Chunk): Iterable<Chunk>;
+	getChunkEntryDependOnChunksIterable(chunk: Chunk): Iterable<Chunk>;
 	hasChunkEntryDependentChunks(chunk: Chunk): boolean;
 	getChunkRuntimeModulesIterable(chunk: Chunk): Iterable<RuntimeModule>;
 	getChunkRuntimeModulesInOrder(chunk: Chunk): RuntimeModule[];
@@ -1951,6 +1959,55 @@ type CodeValuePrimitive =
 	| boolean
 	| Function
 	| RegExp;
+declare interface Colors {
+	reset: (value?: any) => string;
+	bold: (value?: any) => string;
+	dim: (value?: any) => string;
+	italic: (value?: any) => string;
+	underline: (value?: any) => string;
+	inverse: (value?: any) => string;
+	hidden: (value?: any) => string;
+	strikethrough: (value?: any) => string;
+	black: (value?: any) => string;
+	red: (value?: any) => string;
+	green: (value?: any) => string;
+	yellow: (value?: any) => string;
+	blue: (value?: any) => string;
+	magenta: (value?: any) => string;
+	cyan: (value?: any) => string;
+	white: (value?: any) => string;
+	gray: (value?: any) => string;
+	bgBlack: (value?: any) => string;
+	bgRed: (value?: any) => string;
+	bgGreen: (value?: any) => string;
+	bgYellow: (value?: any) => string;
+	bgBlue: (value?: any) => string;
+	bgMagenta: (value?: any) => string;
+	bgCyan: (value?: any) => string;
+	bgWhite: (value?: any) => string;
+	blackBright: (value?: any) => string;
+	redBright: (value?: any) => string;
+	greenBright: (value?: any) => string;
+	yellowBright: (value?: any) => string;
+	blueBright: (value?: any) => string;
+	magentaBright: (value?: any) => string;
+	cyanBright: (value?: any) => string;
+	whiteBright: (value?: any) => string;
+	bgBlackBright: (value?: any) => string;
+	bgRedBright: (value?: any) => string;
+	bgGreenBright: (value?: any) => string;
+	bgYellowBright: (value?: any) => string;
+	bgBlueBright: (value?: any) => string;
+	bgMagentaBright: (value?: any) => string;
+	bgCyanBright: (value?: any) => string;
+	bgWhiteBright: (value?: any) => string;
+}
+declare interface ColorsOptions {
+	/**
+	 * force use colors
+	 */
+	useColor?: boolean;
+}
 declare interface Comparator<T> {
 	(a: T, b: T): 0 | 1 | -1;
 }
@@ -2499,15 +2556,11 @@ declare interface CompilationHooksCssModulesPlugin {
 	chunkHash: SyncHook<[Chunk, Hash, ChunkHashContext]>;
 }
 declare interface CompilationHooksJavascriptModulesPlugin {
-	renderModuleContent: SyncWaterfallHook<
-		[Source, Module, ChunkRenderContextJavascriptModulesPlugin]
-	>;
+	renderModuleContent: SyncWaterfallHook<[Source, Module, ModuleRenderContext]>;
 	renderModuleContainer: SyncWaterfallHook<
-		[Source, Module, ChunkRenderContextJavascriptModulesPlugin]
-	>;
-	renderModulePackage: SyncWaterfallHook<
-		[Source, Module, ChunkRenderContextJavascriptModulesPlugin]
+		[Source, Module, ModuleRenderContext]
 	>;
+	renderModulePackage: SyncWaterfallHook<[Source, Module, ModuleRenderContext]>;
 	renderChunk: SyncWaterfallHook<
 		[Source, RenderContextJavascriptModulesPlugin]
 	>;
@@ -2519,7 +2572,7 @@ declare interface CompilationHooksJavascriptModulesPlugin {
 	renderStartup: SyncWaterfallHook<[Source, Module, StartupRenderContext]>;
 	renderRequire: SyncWaterfallHook<[string, RenderBootstrapContext]>;
 	inlineInRuntimeBailout: SyncBailHook<
-		[Module, RenderBootstrapContext],
+		[Module, Partial<RenderBootstrapContext>],
 		string | void
 	>;
 	embedInRuntimeBailout: SyncBailHook<
@@ -2701,6 +2754,7 @@ declare interface ConcatenatedModuleInfo {
 	rawExportMap?: Map<string, string>;
 	namespaceExportSymbol?: string;
 	namespaceObjectName?: string;
+	concatenationScope?: ConcatenationScope;
 
 	/**
 	 * "default-with-named" namespace
@@ -2746,12 +2800,17 @@ declare interface ConcatenationBailoutReasonContext {
 declare class ConcatenationScope {
 	constructor(
 		modulesMap: ModuleInfo[] | Map<Module, ModuleInfo>,
-		currentModule: ConcatenatedModuleInfo
+		currentModule: ConcatenatedModuleInfo,
+		usedNames: Set<string>
 	);
+	usedNames: Set<string>;
 	isModuleInScope(module: Module): boolean;
 	registerExport(exportName: string, symbol: string): void;
 	registerRawExport(exportName: string, expression: string): void;
+	getRawExport(exportName: string): undefined | string;
+	setRawExportMap(exportName: string, expression: string): void;
 	registerNamespaceExport(symbol: string): void;
+	registerUsedName(symbol: string): boolean;
 	createModuleReference(
 		module: Module,
 		__1: Partial<ModuleReferenceOptions>
@@ -5180,6 +5239,7 @@ declare class ExternalModule extends Module {
 		unsafeCacheData: UnsafeCacheData,
 		normalModuleFactory: NormalModuleFactory
 	): void;
+	static ModuleExternalInitFragment: typeof ModuleExternalInitFragment;
 }
 declare interface ExternalModuleInfo {
 	type: "external";
@@ -5606,9 +5666,9 @@ declare abstract class FileSystemInfo {
 	): void;
 	createSnapshot(
 		startTime: undefined | null | number,
-		files: null | Iterable<string>,
-		directories: null | Iterable<string>,
-		missing: null | Iterable<string>,
+		files: undefined | null | Iterable<string>,
+		directories: undefined | null | Iterable<string>,
+		missing: undefined | null | Iterable<string>,
 		options: undefined | null | SnapshotOptionsFileSystemInfo,
 		callback: (err: null | WebpackError, snapshot: null | Snapshot) => void
 	): void;
@@ -5910,10 +5970,12 @@ declare class HarmonyImportDependency extends ModuleDependency {
 	constructor(
 		request: string,
 		sourceOrder: number,
-		attributes?: ImportAttributes
+		attributes?: ImportAttributes,
+		defer?: boolean
 	);
 	sourceOrder: number;
 	getImportVar(moduleGraph: ModuleGraph): string;
+	getModuleExports(__0: DependencyTemplateContext): string;
 	getImportStatement(
 		update: boolean,
 		__1: DependencyTemplateContext
@@ -6226,6 +6288,7 @@ type ImportSource =
 	| SimpleLiteral
 	| RegExpLiteral
 	| BigIntLiteral;
+type Imported = true | [string, string][];
 
 /**
  * Options for infrastructure level logging.
@@ -6288,6 +6351,8 @@ declare class InitFragment<GenerateContext> {
 	serialize(context: ObjectSerializerContext): void;
 	deserialize(context: ObjectDeserializerContext): void;
 	merge: any;
+	getImported: any;
+	setImported: any;
 	static addToSource<Context, T>(
 		source: Source,
 		initFragments: InitFragment<T>[],
@@ -6399,9 +6464,8 @@ declare class JavascriptModulesPlugin {
 	apply(compiler: Compiler): void;
 	renderModule(
 		module: Module,
-		renderContext: ChunkRenderContextJavascriptModulesPlugin,
-		hooks: CompilationHooksJavascriptModulesPlugin,
-		factory: boolean
+		renderContext: ModuleRenderContext,
+		hooks: CompilationHooksJavascriptModulesPlugin
 	): null | Source;
 	renderChunk(
 		renderContext: RenderContextJavascriptModulesPlugin,
@@ -7818,6 +7882,11 @@ declare interface JavascriptParserOptions {
 	 */
 	createRequire?: string | boolean;
 
+	/**
+	 * Enable experimental tc39 proposal https://github.com/tc39/proposal-defer-import-eval. This allows to defer execution of a module until it's first use.
+	 */
+	deferImport?: boolean;
+
 	/**
 	 * Specifies global fetchPriority for dynamic import.
 	 */
@@ -8009,7 +8078,7 @@ declare interface JsonGeneratorOptions {
 	 */
 	JSONParse?: boolean;
 }
-type JsonObjectFs = { [index: string]: JsonValueFs } & {
+declare interface JsonObjectFs {
 	[index: string]:
 		| undefined
 		| null
@@ -8018,8 +8087,8 @@ type JsonObjectFs = { [index: string]: JsonValueFs } & {
 		| boolean
 		| JsonObjectFs
 		| JsonValueFs[];
-};
-type JsonObjectTypes = { [index: string]: JsonValueTypes } & {
+}
+declare interface JsonObjectTypes {
 	[index: string]:
 		| undefined
 		| null
@@ -8028,7 +8097,7 @@ type JsonObjectTypes = { [index: string]: JsonValueTypes } & {
 		| boolean
 		| JsonObjectTypes
 		| JsonValueTypes[];
-};
+}
 
 /**
  * Parser options for JSON modules.
@@ -8288,9 +8357,10 @@ declare interface KnownBuildMeta {
 	strictHarmonyModule?: boolean;
 	async?: boolean;
 	sideEffectFree?: boolean;
-	exportsFinalName?: Record<string, string>;
 	isCSSModule?: boolean;
 	jsIncompatibleExports?: Record<string, string>;
+	exportsFinalName?: Record<string, string>;
+	factoryExportsBinding?: string;
 }
 declare interface KnownCreateStatsOptionsContext {
 	forToString?: boolean;
@@ -8445,7 +8515,7 @@ declare interface KnownStatsChunkOrigin {
 	moduleId?: string | number;
 }
 declare interface KnownStatsCompilation {
-	env?: Record<string, any>;
+	env?: any;
 	name?: string;
 	hash?: string;
 	version?: string;
@@ -9759,7 +9829,30 @@ declare class ModuleDependency extends Dependency {
 	static EXPORTS_OBJECT_REFERENCED: string[][];
 	static TRANSITIVE: typeof TRANSITIVE;
 }
-declare abstract class ModuleFactory {
+declare class ModuleExternalInitFragment extends InitFragment<GenerateContext> {
+	constructor(
+		request: string,
+		imported: Imported,
+		ident?: string,
+		dependencyMeta?: ImportDependencyMeta,
+		hashFunction?: string | typeof Hash
+	);
+	getNamespaceIdentifier(): string;
+	static addToSource<Context, T>(
+		source: Source,
+		initFragments: InitFragment<T>[],
+		context: Context
+	): Source;
+	static STAGE_CONSTANTS: number;
+	static STAGE_ASYNC_BOUNDARY: number;
+	static STAGE_HARMONY_EXPORTS: number;
+	static STAGE_HARMONY_IMPORTS: number;
+	static STAGE_PROVIDES: number;
+	static STAGE_ASYNC_DEPENDENCIES: number;
+	static STAGE_ASYNC_HARMONY_IMPORTS: number;
+}
+declare class ModuleFactory {
+	constructor();
 	create(
 		data: ModuleFactoryCreateData,
 		callback: (err?: null | Error, result?: ModuleFactoryResult) => void
@@ -10266,6 +10359,57 @@ declare interface ModuleReferenceOptions {
 	 */
 	asiSafe?: boolean;
 }
+declare interface ModuleRenderContext {
+	/**
+	 * the chunk
+	 */
+	chunk: Chunk;
+
+	/**
+	 * the dependency templates
+	 */
+	dependencyTemplates: DependencyTemplates;
+
+	/**
+	 * the runtime template
+	 */
+	runtimeTemplate: RuntimeTemplate;
+
+	/**
+	 * the module graph
+	 */
+	moduleGraph: ModuleGraph;
+
+	/**
+	 * the chunk graph
+	 */
+	chunkGraph: ChunkGraph;
+
+	/**
+	 * results of code generation
+	 */
+	codeGenerationResults: CodeGenerationResults;
+
+	/**
+	 * init fragments for the chunk
+	 */
+	chunkInitFragments: InitFragment<ChunkRenderContextJavascriptModulesPlugin>[];
+
+	/**
+	 * rendering in strict context
+	 */
+	strictMode?: boolean;
+
+	/**
+	 * true: renders as factory method, false: pure module content
+	 */
+	factory: boolean;
+
+	/**
+	 * the inlined entry module is wrapped in an IIFE, existing only when `factory` is set to false
+	 */
+	inlinedInIIFE?: boolean;
+}
 declare interface ModuleResult {
 	client: string;
 	data: string;
@@ -10313,7 +10457,7 @@ declare abstract class ModuleTemplate {
 				fn: (
 					source: Source,
 					module: Module,
-					chunkRenderContext: ChunkRenderContextJavascriptModulesPlugin,
+					moduleRenderContext: ModuleRenderContext,
 					dependencyTemplates: DependencyTemplates
 				) => Source
 			) => void;
@@ -10326,7 +10470,7 @@ declare abstract class ModuleTemplate {
 				fn: (
 					source: Source,
 					module: Module,
-					chunkRenderContext: ChunkRenderContextJavascriptModulesPlugin,
+					moduleRenderContext: ModuleRenderContext,
 					dependencyTemplates: DependencyTemplates
 				) => Source
 			) => void;
@@ -10417,14 +10561,18 @@ declare interface MultiCompilerOptions {
 	 */
 	parallelism?: number;
 }
+type MultiConfiguration = ReadonlyArray<Configuration> & MultiCompilerOptions;
 declare abstract class MultiStats {
 	stats: Stats[];
 	get hash(): string;
 	hasErrors(): boolean;
 	hasWarnings(): boolean;
-	toJson(options?: string | boolean | StatsOptions): StatsCompilation;
-	toString(options?: string | boolean | StatsOptions): string;
+	toJson(options?: string | boolean | MultiStatsOptions): StatsCompilation;
+	toString(options?: string | boolean | MultiStatsOptions): string;
 }
+type MultiStatsOptions = Omit<StatsOptions, "children"> & {
+	children?: string | boolean | StatsOptions | ChildrenStatsOptions[];
+};
 declare abstract class MultiWatching {
 	watchings: Watching[];
 	compiler: MultiCompiler;
@@ -10877,43 +11025,43 @@ declare class NormalModuleReplacementPlugin {
 type NormalizedStatsOptions = KnownNormalizedStatsOptions &
 	Omit<
 		StatsOptions,
-		| "context"
-		| "chunkGroups"
-		| "requestShortener"
-		| "chunksSort"
-		| "modulesSort"
-		| "chunkModulesSort"
-		| "nestedModulesSort"
 		| "assetsSort"
-		| "ids"
-		| "cachedAssets"
-		| "groupAssetsByEmitStatus"
-		| "groupAssetsByPath"
-		| "groupAssetsByExtension"
 		| "assetsSpace"
-		| "excludeAssets"
-		| "excludeModules"
-		| "warningsFilter"
+		| "cachedAssets"
 		| "cachedModules"
-		| "orphanModules"
+		| "chunkGroupAuxiliary"
+		| "chunkGroupChildren"
+		| "chunkGroupMaxAssets"
+		| "chunkGroups"
+		| "chunkModulesSpace"
+		| "chunksSort"
+		| "context"
 		| "dependentModules"
-		| "runtimeModules"
+		| "entrypoints"
+		| "excludeAssets"
+		| "excludeModules"
+		| "groupAssetsByEmitStatus"
+		| "groupAssetsByExtension"
+		| "groupAssetsByPath"
+		| "groupModulesByAttributes"
 		| "groupModulesByCacheStatus"
+		| "groupModulesByExtension"
 		| "groupModulesByLayer"
-		| "groupModulesByAttributes"
 		| "groupModulesByPath"
-		| "groupModulesByExtension"
 		| "groupModulesByType"
-		| "entrypoints"
-		| "chunkGroupAuxiliary"
-		| "chunkGroupChildren"
-		| "chunkGroupMaxAssets"
-		| "modulesSpace"
-		| "chunkModulesSpace"
-		| "nestedModulesSpace"
+		| "ids"
 		| "logging"
 		| "loggingDebug"
 		| "loggingTrace"
+		| "modulesSort"
+		| "modulesSpace"
+		| "nestedModulesSpace"
+		| "orphanModules"
+		| "runtimeModules"
+		| "warningsFilter"
+		| "requestShortener"
+		| "chunkModulesSort"
+		| "nestedModulesSort"
 		| "_env"
 	> &
 	Record<string, any>;
@@ -12574,7 +12722,7 @@ declare class ProgressPlugin {
 	showModules?: boolean;
 	showDependencies?: boolean;
 	showActiveModules?: boolean;
-	percentBy?: null | "entries" | "modules" | "dependencies";
+	percentBy?: null | "modules" | "entries" | "dependencies";
 	apply(compiler: Compiler | MultiCompiler): void;
 	static getReporter(
 		compiler: Compiler
@@ -12639,7 +12787,7 @@ declare interface ProgressPluginOptions {
 	/**
 	 * Collect percent algorithm. By default it calculates by a median from modules, entries and dependencies percent.
 	 */
-	percentBy?: null | "entries" | "modules" | "dependencies";
+	percentBy?: null | "modules" | "entries" | "dependencies";
 
 	/**
 	 * Collect profile data for progress steps. Default: false.
@@ -14912,6 +15060,7 @@ declare abstract class RuntimeTemplate {
 	supportsEcmaScriptModuleSyntax(): undefined | boolean;
 	supportTemplateLiteral(): undefined | boolean;
 	supportNodePrefixForCoreModules(): undefined | boolean;
+	renderNodePrefixForCoreModule(mod: string): string;
 	returningFunction(returnValue: string, args?: string): string;
 	basicFunction(args: string, body: string | string[]): string;
 	concatenation(...args: (string | { expr: string })[]): string;
@@ -15882,9 +16031,52 @@ declare abstract class StackedMap<K, V> {
 	get size(): number;
 	createChild(): StackedMap<K, V>;
 }
-type StartupRenderContext = RenderContextJavascriptModulesPlugin & {
+declare interface StartupRenderContext {
+	/**
+	 * the chunk
+	 */
+	chunk: Chunk;
+
+	/**
+	 * the dependency templates
+	 */
+	dependencyTemplates: DependencyTemplates;
+
+	/**
+	 * the runtime template
+	 */
+	runtimeTemplate: RuntimeTemplate;
+
+	/**
+	 * the module graph
+	 */
+	moduleGraph: ModuleGraph;
+
+	/**
+	 * the chunk graph
+	 */
+	chunkGraph: ChunkGraph;
+
+	/**
+	 * results of code generation
+	 */
+	codeGenerationResults: CodeGenerationResults;
+
+	/**
+	 * rendering in strict context
+	 */
+	strictMode?: boolean;
+
+	/**
+	 * inlined
+	 */
 	inlined: boolean;
-};
+
+	/**
+	 * the inlined entry module is wrapped in an IIFE
+	 */
+	inlinedInIIFE?: boolean;
+}
 declare interface StatFs {
 	(
 		path: PathLikeFs,
@@ -17389,21 +17581,24 @@ declare interface WriteStreamOptions {
 declare function exports(
 	options: Configuration,
 	callback?: CallbackWebpack<Stats>
-): Compiler;
+): null | Compiler;
 declare function exports(
-	options: ReadonlyArray<Configuration> & MultiCompilerOptions,
+	options: MultiConfiguration,
 	callback?: CallbackWebpack<MultiStats>
-): MultiCompiler;
+): null | MultiCompiler;
 declare namespace exports {
 	export const webpack: {
-		(options: Configuration, callback?: CallbackWebpack<Stats>): Compiler;
 		(
-			options: ReadonlyArray<Configuration> & MultiCompilerOptions,
+			options: Configuration,
+			callback?: CallbackWebpack<Stats>
+		): null | Compiler;
+		(
+			options: MultiConfiguration,
 			callback?: CallbackWebpack<MultiStats>
-		): MultiCompiler;
+		): null | MultiCompiler;
 	};
 	export const validate: (
-		configuration: Configuration | Configuration[]
+		configuration: Configuration | MultiConfiguration
 	) => void;
 	export const validateSchema: (
 		schema: Parameters<typeof validateFunction>[0],
@@ -17412,6 +17607,7 @@ declare namespace exports {
 	) => void;
 	export const version: string;
 	export namespace cli {
+		export let createColors: (__0?: ColorsOptions) => Colors;
 		export let getArguments: (
 			schema?:
 				| (JSONSchema4 & {
@@ -17448,6 +17644,7 @@ declare namespace exports {
 						};
 				  })
 		) => Flags;
+		export let isColorSupported: () => boolean;
 		export let processArguments: (
 			args: Flags,
 			config: ObjectConfiguration,
@@ -17525,6 +17722,10 @@ declare namespace exports {
 		export let ensureChunkHandlers: "__webpack_require__.f";
 		export let ensureChunkIncludeEntries: "__webpack_require__.f (include entries)";
 		export let entryModuleId: "__webpack_require__.s";
+		export let esmId: "__webpack_esm_id__";
+		export let esmIds: "__webpack_esm_ids__";
+		export let esmModules: "__webpack_esm_modules__";
+		export let esmRuntime: "__webpack_esm_runtime__";
 		export let exports: "__webpack_exports__";
 		export let externalInstallChunk: "__webpack_require__.C";
 		export let getChunkCssFilename: "__webpack_require__.k";
@@ -18044,6 +18245,7 @@ declare namespace exports {
 		LoaderOptionsPlugin,
 		LoaderTargetPlugin,
 		Module,
+		ModuleFactory,
 		ModuleGraph,
 		ModuleGraphConnection,
 		NoEmitOnErrorsPlugin,
@@ -18100,14 +18302,21 @@ declare namespace exports {
 		AssetEmittedInfo,
 		Entrypoint,
 		MultiCompilerOptions,
+		MultiConfiguration,
 		MultiStats,
+		MultiStatsOptions,
 		ResolveData,
 		ParserState,
 		ResolvePluginInstance,
 		Resolver,
+		RenderManifestEntry,
+		RenderManifestOptions,
+		TemplatePath,
 		Watching,
 		Argument,
 		Problem,
+		Colors,
+		ColorsOptions,
 		StatsAsset,
 		StatsChunk,
 		StatsChunkGroup,
@@ -18122,6 +18331,8 @@ declare namespace exports {
 		StatsModuleTraceDependency,
 		StatsModuleTraceItem,
 		StatsProfile,
+		ObjectSerializerContext,
+		ObjectDeserializerContext,
 		InputFileSystem,
 		OutputFileSystem,
 		LoaderModule,