webpack 5.59.0 → 5.62.0

package/schemas/WebpackOptions.json

@@ -681,14 +681,14 @@
       "implements": ["#/definitions/ExperimentsCommon"],
       "additionalProperties": false,
       "properties": {
-        "asset": {
-          "description": "Allow module type 'asset' to generate assets.",
-          "type": "boolean"
-        },
         "asyncWebAssembly": {
           "description": "Support WebAssembly as asynchronous EcmaScript Module.",
           "type": "boolean"
         },
+        "backCompat": {
+          "description": "Enable backward-compat layer with deprecation warnings for many webpack 4 APIs.",
+          "type": "boolean"
+        },
         "buildHttp": {
           "description": "Build http(s): urls using a lockfile and resource content cache.",
           "anyOf": [
@@ -709,7 +709,7 @@
           "type": "boolean"
         },
         "layers": {
-          "description": "Enable module and chunk layers.",
+          "description": "Enable module layers.",
           "type": "boolean"
         },
         "lazyCompilation": {
@@ -742,14 +742,14 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
-        "asset": {
-          "description": "Allow module type 'asset' to generate assets.",
-          "type": "boolean"
-        },
         "asyncWebAssembly": {
           "description": "Support WebAssembly as asynchronous EcmaScript Module.",
           "type": "boolean"
         },
+        "backCompat": {
+          "description": "Enable backward-compat layer with deprecation warnings for many webpack 4 APIs.",
+          "type": "boolean"
+        },
         "cacheUnaffected": {
           "description": "Enable additional in memory caching of modules that are unchanged and reference only unchanged modules.",
           "type": "boolean"
@@ -759,7 +759,7 @@
           "type": "boolean"
         },
         "layers": {
-          "description": "Enable module and chunk layers.",
+          "description": "Enable module layers.",
           "type": "boolean"
         },
         "outputModule": {
@@ -782,14 +782,14 @@
       "implements": ["#/definitions/ExperimentsCommon"],
       "additionalProperties": false,
       "properties": {
-        "asset": {
-          "description": "Allow module type 'asset' to generate assets.",
-          "type": "boolean"
-        },
         "asyncWebAssembly": {
           "description": "Support WebAssembly as asynchronous EcmaScript Module.",
           "type": "boolean"
         },
+        "backCompat": {
+          "description": "Enable backward-compat layer with deprecation warnings for many webpack 4 APIs.",
+          "type": "boolean"
+        },
         "buildHttp": {
           "description": "Build http(s): urls using a lockfile and resource content cache.",
           "oneOf": [
@@ -807,7 +807,7 @@
           "type": "boolean"
         },
         "layers": {
-          "description": "Enable module and chunk layers.",
+          "description": "Enable module layers.",
           "type": "boolean"
         },
         "lazyCompilation": {
@@ -1068,12 +1068,12 @@
             "description": "List of paths that are managed by a package manager and contain a version or hash in its path so all files are immutable.",
             "anyOf": [
               {
-                "description": "A RegExp matching a immutable directory (usually a package manager cache directory, including the tailing slash)",
+                "description": "A RegExp matching an immutable directory (usually a package manager cache directory, including the tailing slash)",
                 "instanceof": "RegExp",
                 "tsType": "RegExp"
               },
               {
-                "description": "A path to a immutable directory (usually a package manager cache directory).",
+                "description": "A path to an immutable directory (usually a package manager cache directory).",
                 "type": "string",
                 "absolutePath": true,
                 "minLength": 1
@@ -1474,6 +1474,10 @@
           "description": "Enable/disable parsing of magic comments in CommonJs syntax.",
           "type": "boolean"
         },
+        "exportsPresence": {
+          "description": "Specifies the behavior of invalid export names in \"import ... from ...\" and \"export ... from ...\".",
+          "enum": ["error", "warn", "auto", false]
+        },
         "exprContextCritical": {
           "description": "Enable warnings for full dynamic dependencies.",
           "type": "boolean"
@@ -1506,9 +1510,17 @@
           "description": "Enable/disable parsing of import() syntax.",
           "type": "boolean"
         },
+        "importExportsPresence": {
+          "description": "Specifies the behavior of invalid export names in \"import ... from ...\".",
+          "enum": ["error", "warn", "auto", false]
+        },
         "node": {
           "$ref": "#/definitions/Node"
         },
+        "reexportExportsPresence": {
+          "description": "Specifies the behavior of invalid export names in \"export ... from ...\". This might be useful to disable during the migration from \"export ... from ...\" to \"export type ... from ...\" when reexporting types in TypeScript.",
+          "enum": ["error", "warn", "auto", false]
+        },
         "requireContext": {
           "description": "Enable/disable parsing of require.context syntax.",
           "type": "boolean"
@@ -1526,7 +1538,7 @@
           "type": "boolean"
         },
         "strictExportPresence": {
-          "description": "Emit errors instead of warnings when imported names don't exist in imported module.",
+          "description": "Deprecated in favor of \"exportsPresence\". Emit errors instead of warnings when imported names don't exist in imported module.",
           "type": "boolean"
         },
         "strictThisContextOnImports": {
@@ -1615,20 +1627,86 @@
         }
       ]
     },
-    "LazyCompilationOptions": {
-      "description": "Options for compiling entrypoints and import()s only when they are accessed.",
+    "LazyCompilationDefaultBackendOptions": {
+      "description": "Options for the default backend.",
       "type": "object",
       "additionalProperties": false,
       "properties": {
-        "backend": {
-          "description": "A custom backend.",
-          "instanceof": "Function",
-          "tsType": "(((compiler: import('../lib/Compiler'), client: string, callback: (err?: Error, api?: any) => void) => void) | ((compiler: import('../lib/Compiler'), client: string) => Promise<any>))"
-        },
         "client": {
           "description": "A custom client.",
           "type": "string"
         },
+        "listen": {
+          "description": "Specifies where to listen to from the server.",
+          "anyOf": [
+            {
+              "description": "A port.",
+              "type": "number"
+            },
+            {
+              "description": "Listen options.",
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "host": {
+                  "description": "A host.",
+                  "type": "string"
+                },
+                "port": {
+                  "description": "A port.",
+                  "type": "number"
+                }
+              },
+              "tsType": "import(\"net\").ListenOptions"
+            },
+            {
+              "description": "A custom listen function.",
+              "instanceof": "Function",
+              "tsType": "((server: import(\"net\").Server) => void)"
+            }
+          ]
+        },
+        "protocol": {
+          "description": "Specifies the protocol the client should use to connect to the server.",
+          "enum": ["http", "https"]
+        },
+        "server": {
+          "description": "Specifies how to create the server handling the EventSource requests.",
+          "anyOf": [
+            {
+              "description": "ServerOptions for the http or https createServer call.",
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {},
+              "tsType": "(import(\"https\").ServerOptions | import(\"http\").ServerOptions)"
+            },
+            {
+              "description": "A custom create server function.",
+              "instanceof": "Function",
+              "tsType": "(() => import(\"net\").Server)"
+            }
+          ]
+        }
+      }
+    },
+    "LazyCompilationOptions": {
+      "description": "Options for compiling entrypoints and import()s only when they are accessed.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "backend": {
+          "description": "Specifies the backend that should be used for handling client keep alive.",
+          "anyOf": [
+            {
+              "description": "A custom backend.",
+              "instanceof": "Function",
+              "tsType": "(((compiler: import('../lib/Compiler'), callback: (err?: Error, api?: import(\"../lib/hmr/LazyCompilationPlugin\").BackendApi) => void) => void) | ((compiler: import('../lib/Compiler')) => Promise<import(\"../lib/hmr/LazyCompilationPlugin\").BackendApi>))"
+            },
+            {
+              "$ref": "#/definitions/LazyCompilationDefaultBackendOptions"
+            }
+          ]
+        },
         "entries": {
           "description": "Enable/disable lazy compilation for entries.",
           "type": "boolean"
@@ -2631,6 +2709,18 @@
               "type": "string",
               "minLength": 1
             },
+            "chunks": {
+              "description": "Select chunks for determining shared modules (defaults to \"async\", \"initial\" and \"all\" requires adding these chunks to the HTML).",
+              "anyOf": [
+                {
+                  "enum": ["initial", "async", "all"]
+                },
+                {
+                  "instanceof": "Function",
+                  "tsType": "((chunk: import('../lib/Chunk')) => boolean)"
+                }
+              ]
+            },
             "maxAsyncSize": {
               "description": "Maximal size hint for the on-demand chunks.",
               "oneOf": [
@@ -4138,12 +4228,12 @@
             "description": "List of paths that are managed by a package manager and contain a version or hash in its path so all files are immutable.",
             "anyOf": [
               {
-                "description": "A RegExp matching a immutable directory (usually a package manager cache directory, including the tailing slash)",
+                "description": "A RegExp matching an immutable directory (usually a package manager cache directory, including the tailing slash)",
                 "instanceof": "RegExp",
                 "tsType": "RegExp"
               },
               {
-                "description": "A path to a immutable directory (usually a package manager cache directory).",
+                "description": "A path to an immutable directory (usually a package manager cache directory).",
                 "type": "string",
                 "absolutePath": true,
                 "minLength": 1

package/types.d.ts

@@ -80,6 +80,8 @@ import {
 	WithStatement,
 	YieldExpression
 } from "estree";
+import { ServerOptions as ServerOptionsImport } from "http";
+import { ListenOptions, Server } from "net";
 import { validate as validateFunction } from "schema-utils";
 import { default as ValidationError } from "schema-utils/declarations/ValidationError";
 import { ValidationErrorConfiguration } from "schema-utils/declarations/validate";
@@ -95,6 +97,7 @@ import {
 	SyncHook,
 	SyncWaterfallHook
 } from "tapable";
+import { SecureContextOptions, TlsOptions } from "tls";
 
 declare class AbstractLibraryPlugin<T> {
 	constructor(__0: {
@@ -383,6 +386,10 @@ declare class AutomaticPrefetchPlugin {
 	apply(compiler: Compiler): void;
 }
 type AuxiliaryComment = string | LibraryCustomUmdCommentObject;
+declare interface BackendApi {
+	dispose: (arg0?: Error) => void;
+	module: (arg0: Module) => { client: string; data: string; active: boolean };
+}
 declare class BannerPlugin {
 	constructor(options: BannerPluginArgument);
 	options: BannerPluginOptions;
@@ -684,7 +691,7 @@ declare interface CallbackWebpack<T> {
 }
 type Cell<T> = undefined | T;
 declare class Chunk {
-	constructor(name?: string);
+	constructor(name?: string, backCompat?: boolean);
 	id: null | string | number;
 	ids: null | (string | number)[];
 	debugId: number;
@@ -1386,22 +1393,22 @@ declare class Compilation {
 		additionalChunkAssets: FakeHook<
 			Pick<
 				AsyncSeriesHook<[Set<Chunk>]>,
-				"tap" | "tapAsync" | "tapPromise" | "name"
+				"name" | "tap" | "tapAsync" | "tapPromise"
 			>
 		>;
 		additionalAssets: FakeHook<
-			Pick<AsyncSeriesHook<[]>, "tap" | "tapAsync" | "tapPromise" | "name">
+			Pick<AsyncSeriesHook<[]>, "name" | "tap" | "tapAsync" | "tapPromise">
 		>;
 		optimizeChunkAssets: FakeHook<
 			Pick<
 				AsyncSeriesHook<[Set<Chunk>]>,
-				"tap" | "tapAsync" | "tapPromise" | "name"
+				"name" | "tap" | "tapAsync" | "tapPromise"
 			>
 		>;
 		afterOptimizeChunkAssets: FakeHook<
 			Pick<
 				AsyncSeriesHook<[Set<Chunk>]>,
-				"tap" | "tapAsync" | "tapPromise" | "name"
+				"name" | "tap" | "tapAsync" | "tapPromise"
 			>
 		>;
 		optimizeAssets: AsyncSeriesHook<
@@ -1850,7 +1857,7 @@ declare interface CompilationParams {
 	contextModuleFactory: ContextModuleFactory;
 }
 declare class Compiler {
-	constructor(context: string);
+	constructor(context: string, options?: WebpackOptionsNormalized);
 	hooks: Readonly<{
 		initialize: SyncHook<[]>;
 		shouldEmit: SyncBailHook<[Compilation], boolean>;
@@ -2448,7 +2455,7 @@ declare abstract class ContextModuleFactory extends ModuleFactory {
 		alternatives: FakeHook<
 			Pick<
 				AsyncSeriesWaterfallHook<[any[]]>,
-				"tap" | "tapAsync" | "tapPromise" | "name"
+				"name" | "tap" | "tapAsync" | "tapPromise"
 			>
 		>;
 		alternativeRequests: AsyncSeriesWaterfallHook<
@@ -3297,14 +3304,14 @@ type Experiments = ExperimentsCommon & ExperimentsExtra;
  */
 declare interface ExperimentsCommon {
 	/**
-	 * Allow module type 'asset' to generate assets.
+	 * Support WebAssembly as asynchronous EcmaScript Module.
 	 */
-	asset?: boolean;
+	asyncWebAssembly?: boolean;
 
 	/**
-	 * Support WebAssembly as asynchronous EcmaScript Module.
+	 * Enable backward-compat layer with deprecation warnings for many webpack 4 APIs.
 	 */
-	asyncWebAssembly?: boolean;
+	backCompat?: boolean;
 
 	/**
 	 * Enable additional in memory caching of modules that are unchanged and reference only unchanged modules.
@@ -3317,7 +3324,7 @@ declare interface ExperimentsCommon {
 	futureDefaults?: boolean;
 
 	/**
-	 * Enable module and chunk layers.
+	 * Enable module layers.
 	 */
 	layers?: boolean;
 
@@ -3852,6 +3859,7 @@ declare interface FactorizeModuleOptions {
 type FakeHook<T> = T & FakeHookMarker;
 declare interface FakeHookMarker {}
 declare interface FallbackCacheGroup {
+	chunksFilter: (chunk: Chunk) => boolean;
 	minSize: SplitChunksSizes;
 	maxAsyncSize: SplitChunksSizes;
 	maxInitialSize: SplitChunksSizes;
@@ -5282,6 +5290,11 @@ declare interface JavascriptParserOptions {
 	 */
 	commonjsMagicComments?: boolean;
 
+	/**
+	 * Specifies the behavior of invalid export names in "import ... from ..." and "export ... from ...".
+	 */
+	exportsPresence?: false | "error" | "warn" | "auto";
+
 	/**
 	 * Enable warnings for full dynamic dependencies.
 	 */
@@ -5312,11 +5325,21 @@ declare interface JavascriptParserOptions {
 	 */
 	import?: boolean;
 
+	/**
+	 * Specifies the behavior of invalid export names in "import ... from ...".
+	 */
+	importExportsPresence?: false | "error" | "warn" | "auto";
+
 	/**
 	 * Include polyfills or mocks for various node stuff.
 	 */
 	node?: false | NodeOptions;
 
+	/**
+	 * Specifies the behavior of invalid export names in "export ... from ...". This might be useful to disable during the migration from "export ... from ..." to "export type ... from ..." when reexporting types in TypeScript.
+	 */
+	reexportExportsPresence?: false | "error" | "warn" | "auto";
+
 	/**
 	 * Enable/disable parsing of require.context syntax.
 	 */
@@ -5338,7 +5361,7 @@ declare interface JavascriptParserOptions {
 	requireJs?: boolean;
 
 	/**
-	 * Emit errors instead of warnings when imported names don't exist in imported module.
+	 * Deprecated in favor of "exportsPresence". Emit errors instead of warnings when imported names don't exist in imported module.
 	 */
 	strictExportPresence?: boolean;
 
@@ -5794,25 +5817,45 @@ declare interface KnownStatsProfile {
 	dependencies: number;
 }
 
+/**
+ * Options for the default backend.
+ */
+declare interface LazyCompilationDefaultBackendOptions {
+	/**
+	 * A custom client.
+	 */
+	client?: string;
+
+	/**
+	 * Specifies where to listen to from the server.
+	 */
+	listen?: number | ListenOptions | ((server: typeof Server) => void);
+
+	/**
+	 * Specifies the protocol the client should use to connect to the server.
+	 */
+	protocol?: "http" | "https";
+
+	/**
+	 * Specifies how to create the server handling the EventSource requests.
+	 */
+	server?: ServerOptionsImport | ServerOptionsHttps | (() => typeof Server);
+}
+
 /**
  * Options for compiling entrypoints and import()s only when they are accessed.
  */
 declare interface LazyCompilationOptions {
 	/**
-	 * A custom backend.
+	 * Specifies the backend that should be used for handling client keep alive.
 	 */
 	backend?:
 		| ((
 				compiler: Compiler,
-				client: string,
-				callback: (err?: Error, api?: any) => void
+				callback: (err?: Error, api?: BackendApi) => void
 		  ) => void)
-		| ((compiler: Compiler, client: string) => Promise<any>);
-
-	/**
-	 * A custom client.
-	 */
-	client?: string;
+		| ((compiler: Compiler) => Promise<BackendApi>)
+		| LazyCompilationDefaultBackendOptions;
 
 	/**
 	 * Enable/disable lazy compilation for entries.
@@ -7485,6 +7528,7 @@ declare interface NormalModuleLoaderContext<OptionsType> {
 	utils: {
 		absolutify: (context: string, request: string) => string;
 		contextify: (context: string, request: string) => string;
+		createHash: (algorithm?: string) => Hash;
 	};
 	rootContext: string;
 	fs: InputFileSystem;
@@ -7903,6 +7947,10 @@ declare interface OptimizationSplitChunksOptions {
 		 * Sets the name delimiter for created chunks.
 		 */
 		automaticNameDelimiter?: string;
+		/**
+		 * Select chunks for determining shared modules (defaults to "async", "initial" and "all" requires adding these chunks to the HTML).
+		 */
+		chunks?: "all" | "initial" | "async" | ((chunk: Chunk) => boolean);
 		/**
 		 * Maximal size hint for the on-demand chunks.
 		 */
@@ -10369,6 +10417,9 @@ declare abstract class Serializer {
 	serialize(obj?: any, context?: any): any;
 	deserialize(value?: any, context?: any): any;
 }
+type ServerOptionsHttps = SecureContextOptions &
+	TlsOptions &
+	ServerOptionsImport;
 declare class SharePlugin {
 	constructor(options: SharePluginOptions);