webpack 5.111.0 → 5.111.1

package/types.d.ts

@@ -233,8 +233,11 @@ declare interface AbstractLibraryPluginOptions {
 	 */
 	type: string;
 }
-declare interface AdditionalData {
-	[index: string]: any;
+type AdditionalData = AdditionalDataKnown & Record<string, any>;
+declare interface AdditionalDataKnown {
+	/**
+	 * the AST webpack should parse instead of the source
+	 */
 	webpackAST: object;
 }
 type AfterContextResolveData = ContextResolveData &
@@ -334,6 +337,21 @@ declare interface AllCodeGenerationSchemas {
 	 */
 	externalReexport: string;
 
+	/**
+	 * export definitions left out of a javascript module's source on demand (see `KnownMeta.onDemandExports`), to be placed before its body where it is wrapped
+	 */
+	exportsSource: string;
+
+	/**
+	 * export definitions left out on demand that read the module's own declarations, to be placed after its body where it is wrapped
+	 */
+	exportsBindingSource: string;
+
+	/**
+	 * final name of each used export of a concatenated module whose definitions were left out on demand
+	 */
+	exportsFinalName: Record<string, string>;
+
 	/**
 	 * url for asset modules
 	 */
@@ -362,7 +380,8 @@ declare interface AllCodeGenerationSchemas {
 type AnalyzableForm =
 	"import" | "url" | "url-runtime" | "url-inline" | "wasm" | "wasm-relative";
 type AnyLoaderContext = NormalModuleLoaderContext<any> &
-	LoaderRunnerLoaderContext<any> &
+	LoaderRunnerMutableContext<any> &
+	LoaderRunnerReadonlyContext<any> &
 	LoaderPluginLoaderContext &
 	HotModuleReplacementPluginLoaderContext;
 
@@ -3106,6 +3125,9 @@ type CodeGenValue<K extends string> = K extends
 	| "freeNames"
 	| "chunkInitFragments"
 	| "externalReexport"
+	| "exportsSource"
+	| "exportsBindingSource"
+	| "exportsFinalName"
 	| "url"
 	| "fullContentHash"
 	? AllCodeGenerationSchemas[K]
@@ -6881,6 +6903,11 @@ declare interface DependencyTemplateContext {
 	 * chunkInitFragments
 	 */
 	chunkInitFragments: InitFragment<GenerateContext>[];
+
+	/**
+	 * get access to the code generation data
+	 */
+	getData?: () => CodeGenerationResultData;
 }
 declare abstract class DependencyTemplates {
 	/**
@@ -7335,6 +7362,19 @@ declare interface DotenvPluginOptions {
 	 */
 	template?: string[];
 }
+
+declare interface DualModeResolve {
+	(
+		context: string,
+		request: string,
+		callback: (
+			err: null | ErrorWithDetail,
+			res?: string | false,
+			req?: ResolveRequest
+		) => void
+	): void;
+	(context: string, request: string): Promise<string>;
+}
 declare class DynamicEntryPlugin {
 	/**
 	 * Creates an instance of DynamicEntryPlugin.
@@ -8474,7 +8514,9 @@ declare abstract class ExportInfo {
 	isReexport(): undefined | boolean;
 
 	/**
-	 * Returns the target, undefined when there is no target, false when no target is valid.
+	 * Walks the reexport chain and returns the first target whose module passes
+	 * `validTargetModuleFilter`. Returns undefined when there is no target, false
+	 * when the chain ends without a valid module.
 	 */
 	findTarget(
 		moduleGraph: ModuleGraph,
@@ -8482,7 +8524,9 @@ declare abstract class ExportInfo {
 	): undefined | null | false | TargetItemWithoutConnection;
 
 	/**
-	 * Returns the target.
+	 * Resolves the reexport chain as far as `resolveTargetFilter` allows and
+	 * returns where it ends. Returns undefined when there is no target, the
+	 * targets disagree, or the chain is circular.
 	 */
 	getTarget(
 		moduleGraph: ModuleGraph,
@@ -9893,12 +9937,23 @@ declare class Generator {
 		[index: string]: undefined | Generator;
 	}): ByTypeGenerator;
 
+	/**
+	 * Returns what a module that failed to build says about it in the output.
+	 * The stack it carries is written relative to the context, keeping a
+	 * position only where a second build names the same one.
+	 */
+	static buildErrorMessage(
+		error: Error,
+		requestShortener?: RequestShortener
+	): string;
+
 	/**
 	 * Returns the statement a module that failed to build throws when executed.
 	 */
 	static throwBuildErrorCode(
 		error: Error,
-		parseErrorConstructor?: string
+		parseErrorConstructor?: string,
+		requestShortener?: RequestShortener
 	): string;
 }
 declare interface GeneratorOptions {
@@ -10049,6 +10104,11 @@ declare class GetChunkFilenameRuntimeModule extends RuntimeModule {
 	static getSourceBasicTypes(module: Module): ReadonlySet<string>;
 }
 
+declare interface GetOptionsMethod<OptionsType> {
+	(): OptionsType;
+	(schema: Parameters<typeof validateFunction>[0]): OptionsType;
+}
+
 /**
  * Creates a callback wrapper that waits for a fixed number of completions and
  * forwards the first error immediately.
@@ -10457,10 +10517,6 @@ declare class HotModuleReplacementPlugin {
 	 */
 	static getParserHooks(parser: JavascriptParser): HMRJavascriptParserHooks;
 }
-
-/**
- * These properties are added by the HotModuleReplacementPlugin
- */
 declare interface HotModuleReplacementPluginLoaderContext {
 	hot?: boolean;
 }
@@ -10861,7 +10917,7 @@ declare interface HtmlProcessOptions {
 	sortTokenLists?: boolean;
 
 	/**
-	 * drop an attribute whose value is the element's own default; `true` is `"smart"`, and `"all"` also drops the spec defaults a selector can match (default false)
+	 * drop an attribute whose value is the element's own default; `true` is `"smart"`, and `"all"` also drops the spec defaults a selector can match, and with them a value naming no keyword where that says the same (default false)
 	 */
 	removeRedundantAttributes?: boolean | "all" | "smart";
 
@@ -11662,6 +11718,15 @@ declare interface ImportMetaParserOptionsKnown {
 declare interface ImportMetaParserOptionsUnknown {
 	[index: string]: boolean;
 }
+
+declare interface ImportModuleMethod {
+	(
+		request: string,
+		options: undefined | ImportModuleOptions,
+		callback: (err?: null | Error, exports?: any) => void
+	): void;
+	(request: string, options?: ImportModuleOptions): Promise<any>;
+}
 declare interface ImportModuleOptions {
 	/**
 	 * the target layer
@@ -12103,15 +12168,6 @@ declare class JavascriptModulesPlugin {
 				[Module, Partial<RenderBootstrapContext>],
 				string | void
 			>;
-			/**
-			 * Offers a module's rendered export-definition call to a consumer that can place
-			 * it better — a library whose entry exports the same bindings natively takes it
-			 * over and emits it only where the module is wrapped. Return true to take it.
-			 */
-			onDemandExportsGeneration: SyncBailHook<
-				[Module, RuntimeSpec, string, boolean],
-				boolean | void
-			>;
 			/**
 			 * @since 5.22.0
 			 */
@@ -12192,15 +12248,6 @@ declare class JavascriptModulesPlugin {
 				[Module, Partial<RenderBootstrapContext>],
 				string | void
 			>;
-			/**
-			 * Offers a module's rendered export-definition call to a consumer that can place
-			 * it better — a library whose entry exports the same bindings natively takes it
-			 * over and emits it only where the module is wrapped. Return true to take it.
-			 */
-			onDemandExportsGeneration: SyncBailHook<
-				[Module, RuntimeSpec, string, boolean],
-				boolean | void
-			>;
 			/**
 			 * @since 5.22.0
 			 */
@@ -12281,15 +12328,6 @@ declare class JavascriptModulesPlugin {
 				[Module, Partial<RenderBootstrapContext>],
 				string | void
 			>;
-			/**
-			 * Offers a module's rendered export-definition call to a consumer that can place
-			 * it better — a library whose entry exports the same bindings natively takes it
-			 * over and emits it only where the module is wrapped. Return true to take it.
-			 */
-			onDemandExportsGeneration: SyncBailHook<
-				[Module, RuntimeSpec, string, boolean],
-				boolean | void
-			>;
 			/**
 			 * @since 5.22.0
 			 */
@@ -12372,15 +12410,6 @@ declare class JavascriptModulesPlugin {
 				[Module, Partial<RenderBootstrapContext>],
 				string | void
 			>;
-			/**
-			 * Offers a module's rendered export-definition call to a consumer that can place
-			 * it better — a library whose entry exports the same bindings natively takes it
-			 * over and emits it only where the module is wrapped. Return true to take it.
-			 */
-			onDemandExportsGeneration: SyncBailHook<
-				[Module, RuntimeSpec, string, boolean],
-				boolean | void
-			>;
 			/**
 			 * @since 5.22.0
 			 */
@@ -12461,15 +12490,6 @@ declare class JavascriptModulesPlugin {
 				[Module, Partial<RenderBootstrapContext>],
 				string | void
 			>;
-			/**
-			 * Offers a module's rendered export-definition call to a consumer that can place
-			 * it better — a library whose entry exports the same bindings natively takes it
-			 * over and emits it only where the module is wrapped. Return true to take it.
-			 */
-			onDemandExportsGeneration: SyncBailHook<
-				[Module, RuntimeSpec, string, boolean],
-				boolean | void
-			>;
 			/**
 			 * @since 5.22.0
 			 */
@@ -12550,15 +12570,6 @@ declare class JavascriptModulesPlugin {
 				[Module, Partial<RenderBootstrapContext>],
 				string | void
 			>;
-			/**
-			 * Offers a module's rendered export-definition call to a consumer that can place
-			 * it better — a library whose entry exports the same bindings natively takes it
-			 * over and emits it only where the module is wrapped. Return true to take it.
-			 */
-			onDemandExportsGeneration: SyncBailHook<
-				[Module, RuntimeSpec, string, boolean],
-				boolean | void
-			>;
 			/**
 			 * @since 5.22.0
 			 */
@@ -12638,15 +12649,6 @@ declare class JavascriptModulesPlugin {
 			[Module, Partial<RenderBootstrapContext>],
 			string | void
 		>;
-		/**
-		 * Offers a module's rendered export-definition call to a consumer that can place
-		 * it better — a library whose entry exports the same bindings natively takes it
-		 * over and emits it only where the module is wrapped. Return true to take it.
-		 */
-		onDemandExportsGeneration: SyncBailHook<
-			[Module, RuntimeSpec, string, boolean],
-			boolean | void
-		>;
 		/**
 		 * @since 5.22.0
 		 */
@@ -12808,6 +12810,11 @@ declare class JavascriptParser extends ParserClass {
 				boolean | void
 			>
 		>;
+		/**
+		 * Every statement the hoisting pass reads, which a tap on this turns
+		 * back into a walk of them all. Tap `preStatementByType` instead.
+		 * @deprecated TODO webpack 6: remove, with the statement walk it turns on
+		 */
 		preStatement: SyncBailHook<
 			[
 				| ImportDeclaration
@@ -12842,6 +12849,9 @@ declare class JavascriptParser extends ParserClass {
 			boolean | void
 		>;
 		/**
+		 * Each declaration the parser records: a variable, function or class
+		 * one. Any other type turns the pass back into a walk of every
+		 * statement, and goes away with that walk in webpack 6.
 		 * @since 5.109.0
 		 */
 		preStatementByType: HookMap<
@@ -12879,6 +12889,11 @@ declare class JavascriptParser extends ParserClass {
 				boolean | void
 			>
 		>;
+		/**
+		 * Every statement the block pass reads, which a tap on this turns back
+		 * into a walk of them all. Tap `blockPreStatementByType` instead.
+		 * @deprecated TODO webpack 6: remove, with the statement walk it turns on
+		 */
 		blockPreStatement: SyncBailHook<
 			[
 				| ImportDeclaration
@@ -12913,6 +12928,9 @@ declare class JavascriptParser extends ParserClass {
 			boolean | void
 		>;
 		/**
+		 * Each statement the parser records for the block pass: a variable, class
+		 * or export declaration. Any other type turns the pass back into a walk
+		 * of every statement, and goes away with that walk in webpack 6.
 		 * @since 5.109.0
 		 */
 		blockPreStatementByType: HookMap<
@@ -13125,6 +13143,10 @@ declare class JavascriptParser extends ParserClass {
 		canRename: HookMap<SyncBailHook<[ExpressionEstreeIndex], boolean | void>>;
 		rename: HookMap<SyncBailHook<[ExpressionEstreeIndex], boolean | void>>;
 		assign: HookMap<SyncBailHook<[AssignmentExpression], boolean | void>>;
+		write: HookMap<SyncBailHook<[WriteStatement], boolean | void>>;
+		writeMemberChain: HookMap<
+			SyncBailHook<[WriteStatement, string[]], boolean | void>
+		>;
 		assignMemberChain: HookMap<
 			SyncBailHook<[AssignmentExpression, string[]], boolean | void>
 		>;
@@ -13376,9 +13398,11 @@ declare class JavascriptParser extends ParserClass {
 	): void;
 
 	/**
-	 * Module pre walking iterates the scope for import entries
+	 * Walk every statement of a scope to declare what hoists to it. Only a tap
+	 * on the deprecated `preStatement` hook asks for this.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
 	 */
-	modulePreWalkStatements(
+	preWalkStatements(
 		statements: (
 			| ImportDeclaration
 			| ExportNamedDeclaration
@@ -13410,9 +13434,89 @@ declare class JavascriptParser extends ParserClass {
 	): void;
 
 	/**
-	 * Pre walking iterates the scope for variable declarations
+	 * Pre walk block statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
 	 */
-	preWalkStatements(
+	preWalkBlockStatement(statement: BlockStatement): void;
+
+	/**
+	 * Pre walk if statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkIfStatement(statement: IfStatement): void;
+
+	/**
+	 * Pre walk labeled statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkLabeledStatement(statement: LabeledStatement): void;
+
+	/**
+	 * Pre walk with statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkWithStatement(statement: WithStatement): void;
+
+	/**
+	 * Pre walk switch statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkSwitchStatement(statement: SwitchStatement): void;
+
+	/**
+	 * Pre walk switch cases.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkSwitchCases(switchCases: SwitchCase[]): void;
+
+	/**
+	 * Pre walk try statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkTryStatement(statement: TryStatement): void;
+
+	/**
+	 * Pre walk catch clause.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkCatchClause(catchClause: CatchClause): void;
+
+	/**
+	 * Pre walk while statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkWhileStatement(statement: WhileStatement): void;
+
+	/**
+	 * Pre walk do while statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkDoWhileStatement(statement: DoWhileStatement): void;
+
+	/**
+	 * Pre walk for statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkForStatement(statement: ForStatement): void;
+
+	/**
+	 * Pre walk for in statement.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkForInStatement(statement: ForInStatement): void;
+
+	/**
+	 * Pre walk for of statement. `for await` is reported by the walk, not here.
+	 * @deprecated TODO webpack 6: remove, with the `preStatement` hook
+	 */
+	preWalkForOfStatement(statement: ForOfStatement): void;
+
+	/**
+	 * Scan every top-level statement for the program's module declarations.
+	 * The parser records them now, so nothing inside webpack scans for them.
+	 * @deprecated TODO webpack 6: remove
+	 */
+	modulePreWalkStatements(
 		statements: (
 			| ImportDeclaration
 			| ExportNamedDeclaration
@@ -13444,7 +13548,9 @@ declare class JavascriptParser extends ParserClass {
 	): void;
 
 	/**
-	 * Block pre walking iterates the scope for block variable declarations
+	 * Walk every statement of a list to declare what it binds. Only a tap on the
+	 * deprecated `blockPreStatement` hook asks for this.
+	 * @deprecated TODO webpack 6: remove, with the `blockPreStatement` hook
 	 */
 	blockPreWalkStatements(
 		statements: (
@@ -13623,11 +13729,6 @@ declare class JavascriptParser extends ParserClass {
 	 */
 	walkNestedStatement(statement: Statement): void;
 
-	/**
-	 * Pre walk block statement.
-	 */
-	preWalkBlockStatement(statement: BlockStatement): void;
-
 	/**
 	 * Walk block statement.
 	 */
@@ -13638,11 +13739,6 @@ declare class JavascriptParser extends ParserClass {
 	 */
 	walkExpressionStatement(statement: ExpressionStatement): void;
 
-	/**
-	 * Pre walk if statement.
-	 */
-	preWalkIfStatement(statement: IfStatement): void;
-
 	/**
 	 * Walks a conditional branch with its guard frame (if any) pushed onto the
 	 * parser-state guard stack for the duration of the branch body.
@@ -13654,31 +13750,16 @@ declare class JavascriptParser extends ParserClass {
 	 */
 	walkIfStatement(statement: IfStatement): void;
 
-	/**
-	 * Pre walk labeled statement.
-	 */
-	preWalkLabeledStatement(statement: LabeledStatement): void;
-
 	/**
 	 * Walk labeled statement.
 	 */
 	walkLabeledStatement(statement: LabeledStatement): void;
 
-	/**
-	 * Pre walk with statement.
-	 */
-	preWalkWithStatement(statement: WithStatement): void;
-
 	/**
 	 * Walk with statement.
 	 */
 	walkWithStatement(statement: WithStatement): void;
 
-	/**
-	 * Pre walk switch statement.
-	 */
-	preWalkSwitchStatement(statement: SwitchStatement): void;
-
 	/**
 	 * Walk switch statement.
 	 */
@@ -13699,61 +13780,31 @@ declare class JavascriptParser extends ParserClass {
 	 */
 	walkThrowStatement(statement: ThrowStatement): void;
 
-	/**
-	 * Pre walk try statement.
-	 */
-	preWalkTryStatement(statement: TryStatement): void;
-
 	/**
 	 * Walk try statement.
 	 */
 	walkTryStatement(statement: TryStatement): void;
 
-	/**
-	 * Pre walk while statement.
-	 */
-	preWalkWhileStatement(statement: WhileStatement): void;
-
 	/**
 	 * Walk while statement.
 	 */
 	walkWhileStatement(statement: WhileStatement): void;
 
-	/**
-	 * Pre walk do while statement.
-	 */
-	preWalkDoWhileStatement(statement: DoWhileStatement): void;
-
 	/**
 	 * Walk do while statement.
 	 */
 	walkDoWhileStatement(statement: DoWhileStatement): void;
 
-	/**
-	 * Pre walk for statement.
-	 */
-	preWalkForStatement(statement: ForStatement): void;
-
 	/**
 	 * Walk for statement.
 	 */
 	walkForStatement(statement: ForStatement): void;
 
-	/**
-	 * Pre walk for in statement.
-	 */
-	preWalkForInStatement(statement: ForInStatement): void;
-
 	/**
 	 * Walk for in statement.
 	 */
 	walkForInStatement(statement: ForInStatement): void;
 
-	/**
-	 * Pre walk for of statement.
-	 */
-	preWalkForOfStatement(statement: ForOfStatement): void;
-
 	/**
 	 * Walk for of statement.
 	 */
@@ -13898,21 +13949,11 @@ declare class JavascriptParser extends ParserClass {
 		statement: ClassDeclaration | MaybeNamedClassDeclaration
 	): void;
 
-	/**
-	 * Pre walk switch cases.
-	 */
-	preWalkSwitchCases(switchCases: SwitchCase[]): void;
-
 	/**
 	 * Processes the provided switch case.
 	 */
 	walkSwitchCases(switchCases: SwitchCase[]): void;
 
-	/**
-	 * Pre walk catch clause.
-	 */
-	preWalkCatchClause(catchClause: CatchClause): void;
-
 	/**
 	 * Processes the provided catch clause.
 	 */
@@ -14555,6 +14596,12 @@ declare class JavascriptParser extends ParserClass {
 	 */
 	getComments(range: [number, number]): CommentJavascriptParser[];
 
+	/**
+	 * Where the comments written for `statement` begin: the run of comments
+	 * before it that whitespace alone separates from it and from each other.
+	 */
+	getAttachedCommentsStart(statement: StatementPathItem): number;
+
 	/**
 	 * Reports whether `identifier` may occur as a word in the source text of
 	 * `range`. A conservative pre-filter for expensive AST scans: `false` means
@@ -15445,21 +15492,6 @@ declare interface KnownBuildMeta {
 	defaultObject?: false | "redirect" | "redirect-warn";
 	async?: boolean;
 	sideEffectFree?: boolean;
-
-	/**
-	 * using in ModuleLibraryPlugin
-	 */
-	exportsFinalNameByRuntime?: Map<string, Record<string, string>>;
-
-	/**
-	 * using in ModuleLibraryPlugin
-	 */
-	exportsSourceByRuntime?: Map<string, string>;
-
-	/**
-	 * export definitions `ModuleLibraryPlugin` took over, re-emitted only where the module is wrapped
-	 */
-	exportsBindingSourceByRuntime?: Map<string, string>;
 }
 declare interface KnownConcatenatedModuleBuildInfo {
 	fileDependencies?: LazySet<string>;
@@ -15601,6 +15633,11 @@ declare interface KnownJsonModuleBuildInfo {
 declare interface KnownMeta {
 	importVarMap?: Map<Module, string>;
 	deferredImportVarMap?: Map<Module, string>;
+
+	/**
+	 * generate export definitions on demand
+	 */
+	onDemandExports?: boolean;
 }
 declare interface KnownNormalModuleBuildInfo {
 	parsed?: boolean;
@@ -16500,10 +16537,33 @@ declare class LoadScriptRuntimeModule extends HelperRuntimeModule {
 declare interface Loader {
 	[index: string]: any;
 }
-type LoaderContext<OptionsType> = NormalModuleLoaderContext<OptionsType> &
-	LoaderRunnerLoaderContext<OptionsType> &
+type LoaderContextLibIndex<OptionsType> =
+	NormalModuleLoaderContext<OptionsType> &
+		LoaderRunnerMutableContext<OptionsType> &
+		LoaderRunnerReadonlyContext<OptionsType> &
+		LoaderPluginLoaderContext &
+		HotModuleReplacementPluginLoaderContext;
+type LoaderContextNormalModule<T> = NormalModuleLoaderContext<T> &
+	LoaderRunnerMutableContext<T> &
+	LoaderRunnerReadonlyContext<T> &
 	LoaderPluginLoaderContext &
 	HotModuleReplacementPluginLoaderContext;
+declare interface LoaderContextUtils {
+	/**
+	 * returns a new request string using absolute paths when possible
+	 */
+	absolutify: (context: string, request: string) => string;
+
+	/**
+	 * returns a new request string avoiding absolute paths when possible
+	 */
+	contextify: (context: string, request: string) => string;
+
+	/**
+	 * creates a hash with the compilation's function
+	 */
+	createHash: (algorithm?: string | typeof Hash) => Hash;
+}
 type LoaderDefinition<
 	OptionsType = {},
 	ContextAdditions = {}
@@ -16517,7 +16577,8 @@ declare interface LoaderDefinitionFunction<
 > {
 	(
 		this: NormalModuleLoaderContext<OptionsType> &
-			LoaderRunnerLoaderContext<OptionsType> &
+			LoaderRunnerMutableContext<OptionsType> &
+			LoaderRunnerReadonlyContext<OptionsType> &
 			LoaderPluginLoaderContext &
 			HotModuleReplacementPluginLoaderContext &
 			ContextAdditions,
@@ -16526,6 +16587,21 @@ declare interface LoaderDefinitionFunction<
 		additionalData?: AdditionalData
 	): string | void | Buffer | Promise<string | Buffer>;
 }
+declare interface LoaderEntry {
+	request: string;
+	path: string;
+	query: string;
+	fragment: string;
+	options?: string | object;
+	ident: string;
+	normal?: Function;
+	pitch?: Function;
+	raw?: boolean;
+	data?: object;
+	pitchExecuted: boolean;
+	normalExecuted: boolean;
+	type?: "module" | "commonjs";
+}
 declare interface LoaderItem {
 	loader: string;
 	options?: null | string | Record<string, any>;
@@ -16575,10 +16651,6 @@ declare interface LoaderOptionsPluginOptions {
 		context?: string;
 	};
 }
-
-/**
- * These properties are added by the LoaderPlugin
- */
 declare interface LoaderPluginLoaderContext {
 	/**
 	 * Resolves the given request to a module, applies all configured loaders and calls
@@ -16586,7 +16658,7 @@ declare interface LoaderPluginLoaderContext {
 	 * instance of NormalModule). Use this function if you need to know the source code
 	 * of another module to generate the result.
 	 */
-	loadModule(
+	loadModule: (
 		request: string,
 		callback: (
 			err: null | Error,
@@ -16594,36 +16666,27 @@ declare interface LoaderPluginLoaderContext {
 			sourceMap?: null | object,
 			module?: Module
 		) => void
-	): void;
-	importModule(
-		request: string,
-		options: undefined | ImportModuleOptions,
-		callback: (err?: null | Error, exports?: any) => void
-	): void;
-	importModule(request: string, options?: ImportModuleOptions): Promise<any>;
+	) => void;
+	importModule: ImportModuleMethod;
 }
-
-/**
- * The properties are added by https://github.com/webpack/loader-runner
- */
-declare interface LoaderRunnerLoaderContext<OptionsType> {
+declare interface LoaderRunnerMutableContext<OptionsType> {
 	/**
 	 * Add a directory as dependency of the loader result.
 	 */
-	addContextDependency(context: string): void;
+	addContextDependency: (context: string) => void;
 
 	/**
 	 * Adds a file as dependency of the loader result in order to make them watchable.
 	 * For example, html-loader uses this technique as it finds src and src-set attributes.
 	 * Then, it sets the url's for those attributes as dependencies of the html file that is parsed.
 	 */
-	addDependency(file: string): void;
-	addMissingDependency(context: string): void;
+	addDependency: (file: string) => void;
+	addMissingDependency: (context: string) => void;
 
 	/**
 	 * Make this loader async.
 	 */
-	async(): (
+	async: () => (
 		err?: null | Error,
 		content?: string | Buffer,
 		sourceMap?: null | string | RawSourceMap,
@@ -16636,7 +16699,7 @@ declare interface LoaderRunnerLoaderContext<OptionsType> {
 	 * This means the loader shouldn't have other dependencies than specified with this.addDependency.
 	 * Most loaders are deterministic and cacheable.
 	 */
-	cacheable(flag?: boolean): void;
+	cacheable: (flag?: boolean) => void;
 	callback: (
 		err?: null | Error,
 		content?: string | Buffer,
@@ -16647,15 +16710,13 @@ declare interface LoaderRunnerLoaderContext<OptionsType> {
 	/**
 	 * Remove all dependencies of the loader result. Even initial dependencies and these of other loaders.
 	 */
-	clearDependencies(): void;
+	clearDependencies: () => void;
 
 	/**
 	 * The directory of the module. Can be used as context for resolving other stuff.
 	 * eg '/workspaces/ts-loader/examples/vanilla/src'
 	 */
 	context: string;
-	readonly currentRequest: string;
-	readonly data: any;
 
 	/**
 	 * alias of addDependency
@@ -16663,53 +16724,22 @@ declare interface LoaderRunnerLoaderContext<OptionsType> {
 	 * For example, html-loader uses this technique as it finds src and src-set attributes.
 	 * Then, it sets the url's for those attributes as dependencies of the html file that is parsed.
 	 */
-	dependency(file: string): void;
-	getContextDependencies(): string[];
-	getDependencies(): string[];
-	getMissingDependencies(): string[];
+	dependency: (file: string) => void;
+	getContextDependencies: () => string[];
+	getDependencies: () => string[];
+	getMissingDependencies: () => string[];
 
 	/**
 	 * The index in the loaders array of the current loader.
 	 * In the example: in loader1: 0, in loader2: 1
 	 */
 	loaderIndex: number;
-	readonly previousRequest: string;
-	readonly query: string | OptionsType;
-	readonly remainingRequest: string;
-	readonly request: string;
 
 	/**
 	 * An array of all the loaders. It is writeable in the pitch phase.
 	 * loaders = [{request: string, path: string, query: string, module: function}]
-	 * In the example:
-	 * [
-	 *   { request: "/abc/loader1.js?xyz",
-	 *     path: "/abc/loader1.js",
-	 *     query: "?xyz",
-	 *     module: [Function]
-	 *   },
-	 *   { request: "/abc/node_modules/loader2/index.js",
-	 *     path: "/abc/node_modules/loader2/index.js",
-	 *     query: "",
-	 *     module: [Function]
-	 *   }
-	 * ]
-	 */
-	loaders: {
-		request: string;
-		path: string;
-		query: string;
-		fragment: string;
-		options?: string | object;
-		ident: string;
-		normal?: Function;
-		pitch?: Function;
-		raw?: boolean;
-		data?: object;
-		pitchExecuted: boolean;
-		normalExecuted: boolean;
-		type?: "module" | "commonjs";
-	}[];
+	 */
+	loaders: LoaderEntry[];
 
 	/**
 	 * The resource path.
@@ -16747,6 +16777,14 @@ declare interface LoaderRunnerLoaderContext<OptionsType> {
 	 */
 	environment: Environment;
 }
+declare interface LoaderRunnerReadonlyContext<OptionsType> {
+	readonly currentRequest: string;
+	readonly data: any;
+	readonly previousRequest: string;
+	readonly query: string | OptionsType;
+	readonly remainingRequest: string;
+	readonly request: string;
+}
 declare class LoaderTargetPlugin {
 	/**
 	 * Creates an instance of LoaderTargetPlugin.
@@ -19387,7 +19425,12 @@ declare class NormalModule extends Module {
 		sourceMap?: null | string | RawSourceMap,
 		associatedObjectForCache?: object
 	): Source;
-	markModuleAsErrored(error: Error): void;
+
+	/**
+	 * Marks the module as failed, so what it generates says so. A tap or a
+	 * loader may fail with anything, and what reads the failure expects an error.
+	 */
+	markModuleAsErrored(error?: any): void;
 	applyNoParseRule(
 		rule: string | RegExp | ((content: string) => boolean),
 		content: string
@@ -20010,62 +20053,38 @@ declare abstract class NormalModuleFactory extends ModuleFactory {
 		resolveOptions?: ResolveOptionsWithDependencyType
 	): ResolverWithOptions;
 }
-
-/**
- * These properties are added by the NormalModule
- */
 declare interface NormalModuleLoaderContext<OptionsType> {
 	version: number;
 
 	/**
 	 * Extracts and parses the options of the current loader.
 	 * Parses string options as JSON or a query string.
-	 * Extracts and parses the options of the current loader.
-	 * Parses string options as JSON or a query string, and optionally validates them against a provided schema.
-	 */
-
-	/**
-	 * Extracts and parses the options of the current loader.
-	 * Parses string options as JSON or a query string.
-	 */
-	getOptions(): OptionsType;
-
-	/**
-	 * Extracts and parses the options of the current loader.
-	 * Parses string options as JSON or a query string.
-	 * Extracts and parses the options of the current loader.
-	 * Parses string options as JSON or a query string, and optionally validates them against a provided schema.
 	 */
-
-	/**
-	 * Extracts and parses the options of the current loader.
-	 * Parses string options as JSON or a query string, and optionally validates them against a provided schema.
-	 */
-	getOptions(schema: Parameters<typeof validateFunction>[0]): OptionsType;
+	getOptions: GetOptionsMethod<OptionsType>;
 
 	/**
 	 * Emits a warning for this module.
 	 * The warning will be displayed to the user during compilation.
 	 */
-	emitWarning(warning: string | Error): void;
+	emitWarning: (warning: string | Error) => void;
 
 	/**
 	 * Emits an error for this module.
 	 * The error will be displayed to the user and typically causes the compilation to fail.
 	 */
-	emitError(error: string | Error): void;
+	emitError: (error: string | Error) => void;
 
 	/**
 	 * Gets a logger instance scoped to this loader and module.
 	 * Useful for emitting debug or compilation information in a structured way.
 	 */
-	getLogger(name?: string): WebpackLogger;
+	getLogger: (name?: string) => WebpackLogger;
 
 	/**
 	 * Resolves a module request (e.g., a relative path or module name) to an absolute file path.
 	 * It uses Webpack's internal resolver, taking into account configured aliases and extensions.
 	 */
-	resolve(
+	resolve: (
 		context: string,
 		request: string,
 		callback: (
@@ -20073,41 +20092,26 @@ declare interface NormalModuleLoaderContext<OptionsType> {
 			res?: string | false,
 			req?: ResolveRequest
 		) => void
-	): void;
+	) => void;
 
 	/**
 	 * Creates a resolve function with specific options.
 	 * The returned function can be used as a Promise-based resolver or a callback-based resolver.
 	 */
-	getResolve(options?: ResolveOptionsWithDependencyType): {
-		(
-			context: string,
-			request: string,
-			callback: (
-				err: null | ErrorWithDetail,
-				res?: string | false,
-				req?: ResolveRequest
-			) => void
-		): void;
-		(context: string, request: string): Promise<string>;
-	};
+	getResolve: (options?: ResolveOptionsWithDependencyType) => DualModeResolve;
 
 	/**
 	 * Emits a new file (asset) to the compilation output directory.
 	 * This allows loaders to generate additional files alongside the main module output.
 	 */
-	emitFile(
+	emitFile: (
 		name: string,
 		content: string | Buffer,
 		sourceMap?: string,
 		assetInfo?: AssetInfo
-	): void;
-	addBuildDependency(dep: string): void;
-	utils: {
-		absolutify: (context: string, request: string) => string;
-		contextify: (context: string, request: string) => string;
-		createHash: (algorithm?: string | typeof Hash) => Hash;
-	};
+	) => void;
+	addBuildDependency: (dep: string) => void;
+	utils: LoaderContextUtils;
 	rootContext: string;
 	fs: InputFileSystem;
 	sourceMap?: boolean;
@@ -23068,7 +23072,8 @@ declare interface PitchLoaderDefinitionFunction<
 > {
 	(
 		this: NormalModuleLoaderContext<OptionsType> &
-			LoaderRunnerLoaderContext<OptionsType> &
+			LoaderRunnerMutableContext<OptionsType> &
+			LoaderRunnerReadonlyContext<OptionsType> &
 			LoaderPluginLoaderContext &
 			HotModuleReplacementPluginLoaderContext &
 			ContextAdditions,
@@ -23737,7 +23742,8 @@ declare interface RawLoaderDefinitionFunction<
 > {
 	(
 		this: NormalModuleLoaderContext<OptionsType> &
-			LoaderRunnerLoaderContext<OptionsType> &
+			LoaderRunnerMutableContext<OptionsType> &
+			LoaderRunnerReadonlyContext<OptionsType> &
 			LoaderPluginLoaderContext &
 			HotModuleReplacementPluginLoaderContext &
 			ContextAdditions,
@@ -27283,6 +27289,7 @@ declare abstract class ScopeParser {
 	lexical?: Set<string>;
 	functions?: Set<string>;
 	firstLexical?: string;
+	hoisted?: (number | NodeLike)[];
 }
 
 /**
@@ -29733,6 +29740,16 @@ declare class TokenStream {
 	 */
 	skipWhitespace(): void;
 
+	/**
+	 * Step over the run of selector-prelude leaves a skip-mode parse drops (CSS
+	 * Syntax §5.4.3's "append to prelude", which skip mode does not do), without
+	 * lexing one token each. Only valid where every leaf up to the next
+	 * `BC_PRELUDE_STOP` code point is dropped whatever it is — which in
+	 * `consumeAQualifiedRule` is once the two tokens the `--foo: {`
+	 * disambiguation reads have both been seen. No-op while a token is cached.
+	 */
+	skipPreludeLeaves(): void;
+
 	/**
 	 * Mark (CSS Syntax §3 "mark") — push the current cursor position.
 	 */
@@ -30040,7 +30057,7 @@ declare interface VirtualModule {
 	 * The source function that provides the virtual content.
 	 */
 	source: (
-		loaderContext: LoaderContext<any>
+		loaderContext: LoaderContextNormalModule<any>
 	) => string | Buffer | Promise<string | Buffer>;
 
 	/**
@@ -30056,7 +30073,7 @@ declare interface VirtualModule {
 type VirtualModuleContent =
 	| string
 	| ((
-			loaderContext: LoaderContext<any>
+			loaderContext: LoaderContextNormalModule<any>
 	  ) => string | Buffer | Promise<string | Buffer>)
 	| VirtualModule;
 declare interface VirtualModules {
@@ -30962,6 +30979,8 @@ type WriteFileOptions =
 declare interface WriteOnlySet<T> {
 	add: (item: T) => void;
 }
+type WriteStatement =
+	AssignmentExpression | UpdateExpression | ForInStatement | ForOfStatement;
 type WriteStreamOptions = StreamOptions & {
 	fs?: null | CreateWriteStreamFSImplementation;
 	flush?: boolean;
@@ -32498,7 +32517,7 @@ declare namespace exports {
 		LoaderDefinitionFunction,
 		PitchLoaderDefinitionFunction,
 		RawLoaderDefinitionFunction,
-		LoaderContext
+		LoaderContextLibIndex as LoaderContext
 	};
 }
 declare const topLevelSymbolTag: unique symbol;