webpack 5.107.1 → 5.107.2

package/types.d.ts

@@ -2886,6 +2886,22 @@ declare interface CleanPluginCompilationHooks {
 	 */
 	keep: SyncBailHook<[string], boolean | void>;
 }
+declare interface ClearCacheOptions {
+	/**
+	 * drop cached source maps (default `true`)
+	 */
+	maps?: boolean;
+
+	/**
+	 * drop cached source/buffer copies (default `true`)
+	 */
+	source?: boolean;
+
+	/**
+	 * drop the parsed object form of cached source maps on `SourceMapSource` instances (default `false` — re-parsing JSON is significantly more expensive than `toString`). Only takes effect when a serialized form (buffer or string) is also retained, so the data remains recoverable.
+	 */
+	parsedMap?: boolean;
+}
 declare interface CodeGenMapOverloads {
 	get: <K extends string>(key: K) => undefined | CodeGenValue<K>;
 	set: <K extends string>(
@@ -4038,6 +4054,27 @@ declare interface CompiledAliasOption {
 	 */
 	arrayAlias: boolean;
 }
+declare interface CompiledAliasOptions {
+	/**
+	 * declaration-ordered list
+	 */
+	all: CompiledAliasOption[];
+
+	/**
+	 * bucketed by first char code
+	 */
+	byFirstChar: Map<number, CompiledAliasOption[]>;
+
+	/**
+	 * true when an empty-prefix wildcard is present
+	 */
+	hasAnyFirstChar: boolean;
+
+	/**
+	 * true when the bucket fast-path should be used at resolve time
+	 */
+	useBuckets: boolean;
+}
 declare class Compiler {
 	/**
 	 * Creates an instance of Compiler.
@@ -9658,7 +9695,10 @@ declare interface InputFileSystem {
 		) => void
 	) => void;
 	readJsonSync?: (pathOrFileDescriptor: PathOrFileDescriptorFs) => JsonObjectFs;
-	purge?: (value?: string | string[] | Set<string>) => void;
+	purge?: (
+		value?: string | string[] | Set<string>,
+		options?: { exact?: boolean }
+	) => void;
 	join?: (path1: string, path2: string) => string;
 	relative?: (from: string, to: string) => string;
 	dirname?: (dirname: string) => string;
@@ -16656,11 +16696,55 @@ declare abstract class NormalModuleFactory extends ModuleFactory {
  */
 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;
-	emitWarning(warning: Error): void;
-	emitError(error: Error): void;
+
+	/**
+	 * Emits a warning for this module.
+	 * The warning will be displayed to the user during compilation.
+	 */
+	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;
+
+	/**
+	 * 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;
+
+	/**
+	 * 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(
 		context: string,
 		request: string,
@@ -16670,6 +16754,11 @@ declare interface NormalModuleLoaderContext<OptionsType> {
 			req?: ResolveRequest
 		) => 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,
@@ -16682,6 +16771,11 @@ declare interface NormalModuleLoaderContext<OptionsType> {
 		): void;
 		(context: string, request: string): Promise<string>;
 	};
+
+	/**
+	 * Emits a new file (asset) to the compilation output directory.
+	 * This allows loaders to generate additional files alongside the main module output.
+	 */
 	emitFile(
 		name: string,
 		content: string | Buffer,
@@ -18757,7 +18851,7 @@ declare class ProgressPlugin {
 	static createDefaultHandler: (
 		profile: undefined | null | boolean,
 		logger: WebpackLogger,
-		progressBar:
+		progressBar?:
 			| false
 			| Required<{
 					/**
@@ -22470,6 +22564,19 @@ declare class Source {
 	map(options?: MapOptions): null | RawSourceMap;
 	sourceAndMap(options?: MapOptions): SourceAndMap;
 	updateHash(hash: HashLike): void;
+
+	/**
+	 * Release cached data held by this source. clearCache is a memory
+	 * hint: it never affects correctness or output, only how expensive
+	 * the next read is. Subclasses override; the base is a no-op so
+	 * every Source supports the call. Composite sources always recurse
+	 * into wrapped sources. When the same child is reachable via several
+	 * parents (e.g. modules shared across webpack chunks), pass a shared
+	 * `visited` WeakSet so each subtree is walked at most once.
+	 * Not safe to call concurrently with source/map/sourceAndMap/
+	 * streamChunks/updateHash on the same instance.
+	 */
+	clearCache(options?: ClearCacheOptions, visited?: WeakSet<Source>): void;
 }
 declare interface SourceAndMap {
 	/**
@@ -22517,6 +22624,11 @@ declare interface SourceLike {
 	 * hash updater
 	 */
 	updateHash?: (hash: HashLike) => void;
+
+	/**
+	 * clear cache
+	 */
+	clearCache?: (options?: ClearCacheOptions, visited?: WeakSet<Source>) => void;
 }
 declare class SourceMapDevToolPlugin {
 	/**
@@ -23935,7 +24047,7 @@ declare interface TsconfigPathsData {
 	/**
 	 * tsconfig file data
 	 */
-	alias: CompiledAliasOption[];
+	alias: CompiledAliasOptions;
 
 	/**
 	 * tsconfig file data