webpack-dev-server 4.7.3 → 4.7.4

package/types/lib/Server.d.ts

@@ -26,6 +26,7 @@ declare class Server {
         /** @typedef {import("express").NextFunction} NextFunction */
         /** @typedef {import("express").RequestHandler} ExpressRequestHandler */
         /** @typedef {import("express").ErrorRequestHandler} ExpressErrorRequestHandler */
+        /** @typedef {import("anymatch").Matcher} AnymatchMatcher */
         /** @typedef {import("chokidar").WatchOptions} WatchOptions */
         /** @typedef {import("chokidar").FSWatcher} FSWatcher */
         /** @typedef {import("connect-history-api-fallback").Options} ConnectHistoryApiFallbackOptions */
@@ -59,7 +60,7 @@ declare class Server {
         /**
          * @typedef {Object} WatchFiles
          * @property {string | string[]} paths
-         * @property {WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [options]
+         * @property {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [options]
          */
         /**
          * @typedef {Object} Static
@@ -67,7 +68,7 @@ declare class Server {
          * @property {string | string[]} [publicPath]
          * @property {boolean | ServeIndexOptions} [serveIndex]
          * @property {ServeStaticOptions} [staticOptions]
-         * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [watch]
+         * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [watch]
          */
         /**
          * @typedef {Object} NormalizedStatic
@@ -97,19 +98,19 @@ declare class Server {
          * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
          */
         /**
-         * @typedef {{ [url: string]: string | HttpProxyMiddlewareOptions }} ProxyConfigMap
+         * @callback ByPass
+         * @param {Request} req
+         * @param {Response} res
+         * @param {ProxyConfigArrayItem} proxyConfig
          */
         /**
-         * @typedef {HttpProxyMiddlewareOptions[]} ProxyArray
+         * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
          */
         /**
-         * @callback ByPass
-         * @param {Request} req
-         * @param {Response} res
-         * @param {ProxyConfigArray} proxyConfig
+         * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
          */
         /**
-         * @typedef {{ path?: string | string[] | undefined, context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined } & HttpProxyMiddlewareOptions & ByPass} ProxyConfigArray
+         * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
          */
         /**
          * @typedef {Object} OpenApp
@@ -170,7 +171,7 @@ declare class Server {
          * @property {boolean} [http2]
          * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
          * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
-         * @property {ProxyConfigMap | ProxyConfigArray | ProxyArray} [proxy]
+         * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
          * @property {boolean | string | Open | Array<string | Open>} [open]
          * @property {boolean} [setupExitSignals]
          * @property {boolean | ClientConfiguration} [client]
@@ -199,10 +200,10 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -210,10 +211,11 @@ declare class Server {
         configs: {
           description: string;
           multiple: boolean;
-          path: string;
+          path: string /** @typedef {import("http").IncomingMessage} IncomingMessage */;
           type: string;
           values: boolean[];
         }[];
+        /** @typedef {import("open").Options} OpenOptions */
         /** @typedef {import("https").ServerOptions & { spdy?: { plain?: boolean | undefined, ssl?: boolean | undefined, 'x-forwarded-for'?: string | undefined, protocol?: string | undefined, protocols?: string[] | undefined }}} ServerOptions */
         /**
          * @template Request, Response
@@ -232,7 +234,7 @@ declare class Server {
         /**
          * @typedef {Object} WatchFiles
          * @property {string | string[]} paths
-         * @property {WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [options]
+         * @property {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [options]
          */
         /**
          * @typedef {Object} Static
@@ -240,7 +242,7 @@ declare class Server {
          * @property {string | string[]} [publicPath]
          * @property {boolean | ServeIndexOptions} [serveIndex]
          * @property {ServeStaticOptions} [staticOptions]
-         * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [watch]
+         * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [watch]
          */
         /**
          * @typedef {Object} NormalizedStatic
@@ -270,19 +272,19 @@ declare class Server {
          * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
          */
         /**
-         * @typedef {{ [url: string]: string | HttpProxyMiddlewareOptions }} ProxyConfigMap
+         * @callback ByPass
+         * @param {Request} req
+         * @param {Response} res
+         * @param {ProxyConfigArrayItem} proxyConfig
          */
         /**
-         * @typedef {HttpProxyMiddlewareOptions[]} ProxyArray
+         * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
          */
         /**
-         * @callback ByPass
-         * @param {Request} req
-         * @param {Response} res
-         * @param {ProxyConfigArray} proxyConfig
+         * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
          */
         /**
-         * @typedef {{ path?: string | string[] | undefined, context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined } & HttpProxyMiddlewareOptions & ByPass} ProxyConfigArray
+         * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
          */
         /**
          * @typedef {Object} OpenApp
@@ -343,7 +345,7 @@ declare class Server {
          * @property {boolean} [http2]
          * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
          * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
-         * @property {ProxyConfigMap | ProxyConfigArray | ProxyArray} [proxy]
+         * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
          * @property {boolean | string | Open | Array<string | Open>} [open]
          * @property {boolean} [setupExitSignals]
          * @property {boolean | ClientConfiguration} [client]
@@ -374,10 +376,10 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -408,22 +410,100 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
       "client-reconnect": {
+        /**
+         * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
+         */
+        /**
+         * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
+         */
+        /**
+         * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
+         */
+        /**
+         * @typedef {Object} OpenApp
+         * @property {string} [name]
+         * @property {string[]} [arguments]
+         */
+        /**
+         * @typedef {Object} Open
+         * @property {string | string[] | OpenApp} [app]
+         * @property {string | string[]} [target]
+         */
+        /**
+         * @typedef {Object} NormalizedOpen
+         * @property {string} target
+         * @property {import("open").Options} options
+         */
+        /**
+         * @typedef {Object} WebSocketURL
+         * @property {string} [hostname]
+         * @property {string} [password]
+         * @property {string} [pathname]
+         * @property {number | string} [port]
+         * @property {string} [protocol]
+         * @property {string} [username]
+         */
+        /**
+         * @typedef {Object} ClientConfiguration
+         * @property {"log" | "info" | "warn" | "error" | "none" | "verbose"} [logging]
+         * @property {boolean  | { warnings?: boolean, errors?: boolean }} [overlay]
+         * @property {boolean} [progress]
+         * @property {boolean | number} [reconnect]
+         * @property {"ws" | "sockjs" | string} [webSocketTransport]
+         * @property {string | WebSocketURL} [webSocketURL]
+         */
+        /**
+         * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
+         */
+        /**
+         * @typedef {{ name?: string, path?: string, middleware: ExpressRequestHandler | ExpressErrorRequestHandler } | ExpressRequestHandler | ExpressErrorRequestHandler} Middleware
+         */
+        /**
+         * @typedef {Object} Configuration
+         * @property {boolean | string} [ipc]
+         * @property {Host} [host]
+         * @property {Port} [port]
+         * @property {boolean | "only"} [hot]
+         * @property {boolean} [liveReload]
+         * @property {DevMiddlewareOptions<Request, Response>} [devMiddleware]
+         * @property {boolean} [compress]
+         * @property {boolean} [magicHtml]
+         * @property {"auto" | "all" | string | string[]} [allowedHosts]
+         * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
+         * @property {boolean} [setupExitSignals]
+         * @property {boolean | BonjourOptions} [bonjour]
+         * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
+         * @property {boolean | string | Static | Array<string | Static>} [static]
+         * @property {boolean | ServerOptions} [https]
+         * @property {boolean} [http2]
+         * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
+         * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
+         * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
+         * @property {boolean | string | Open | Array<string | Open>} [open]
+         * @property {boolean} [setupExitSignals]
+         * @property {boolean | ClientConfiguration} [client]
+         * @property {Headers | ((req: Request, res: Response, context: DevMiddlewareContext<Request, Response>) => Headers)} [headers]
+         * @property {(devServer: Server) => void} [onAfterSetupMiddleware]
+         * @property {(devServer: Server) => void} [onBeforeSetupMiddleware]
+         * @property {(devServer: Server) => void} [onListening]
+         * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
+         */
         configs: {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -530,10 +610,6 @@ declare class Server {
           path: string;
         }[];
         description: string;
-        /**
-         * @private
-         * @type {string | undefined}
-         */
         simpleType: string;
         multiple: boolean;
       };
@@ -542,10 +618,10 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -586,6 +662,7 @@ declare class Server {
               type: string;
               multiple: boolean;
               description: string;
+              negatedDescription: string;
               path: string;
             }
           | {
@@ -593,12 +670,16 @@ declare class Server {
               values: string[];
               multiple: boolean;
               description: string;
+              negatedDescription: string;
               path: string;
             }
         )[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
+        /**
+         * @param {"v4" | "v6"} family
+         * @returns {string | undefined}
+         */
         multiple: boolean;
       };
       http2: {
@@ -606,14 +687,10 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
-        /**
-         * @param {Host} hostname
-         * @returns {Promise<string>}
-         */
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -622,10 +699,10 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -659,9 +736,6 @@ declare class Server {
           path: string;
         }[];
         description: string;
-        /**
-         * @type {string[]}
-         */
         simpleType: string;
         multiple: boolean;
       };
@@ -674,12 +748,12 @@ declare class Server {
         }[];
         description: string;
         multiple: boolean;
-        simpleType: string;
+        simpleType: string /** @type {WebSocketURL} */;
       };
       "https-cert": {
         configs: {
           type: string;
-          /** @type {ClientConfiguration} */ multiple: boolean;
+          multiple: boolean;
           description: string;
           path: string;
         }[];
@@ -780,10 +854,10 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -810,36 +884,44 @@ declare class Server {
       "live-reload": {
         configs: {
           type: string;
-          /** @type {Object<string,string>} */ multiple: boolean;
+          multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
-        multiple: boolean /** @type {any} */;
+        multiple: boolean;
       };
       "magic-html": {
         configs: {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
       open: {
-        configs: {
-          type: string;
-          multiple: boolean;
-          description: string;
-          path: string;
-        }[];
+        configs: (
+          | {
+              type: string;
+              multiple: boolean;
+              description: string;
+              path: string;
+            }
+          | {
+              type: string;
+              multiple: boolean;
+              description: string;
+              negatedDescription: string;
+              path: string;
+            }
+        )[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -868,6 +950,10 @@ declare class Server {
       "open-app-name-reset": {
         configs: {
           type: string;
+          /**
+           * @param {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} watchOptions
+           * @returns {WatchOptions}
+           */
           multiple: boolean;
           description: string;
           path: string;
@@ -895,7 +981,6 @@ declare class Server {
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -906,6 +991,10 @@ declare class Server {
           description: string;
           path: string;
         }[];
+        /**
+         * @param {string | Static | undefined} [optionsForStatic]
+         * @returns {NormalizedStatic}
+         */
         description: string;
         simpleType: string;
         multiple: boolean;
@@ -1115,7 +1204,6 @@ declare class Server {
           path: string;
         }[];
         description: string;
-        /** @type {any} */
         simpleType: string;
         multiple: boolean;
       };
@@ -1157,10 +1245,10 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -1169,10 +1257,10 @@ declare class Server {
           type: string;
           multiple: boolean;
           description: string;
+          negatedDescription: string;
           path: string;
         }[];
         description: string;
-        negatedDescription: string;
         simpleType: string;
         multiple: boolean;
       };
@@ -1229,7 +1317,7 @@ declare class Server {
         configs: (
           | {
               description: string;
-              multiple: boolean;
+              /** @type {ServerOptions & { cacert?: ServerOptions["ca"] }} */ multiple: boolean;
               path: string;
               type: string;
               values: string[];
@@ -1243,6 +1331,7 @@ declare class Server {
         )[];
         description: string;
         simpleType: string;
+        /** @type {ServerOptions & { cacert?: ServerOptions["ca"] }} */
         multiple: boolean;
       };
     };
@@ -1311,6 +1400,9 @@ declare class Server {
         )[];
         description: string;
         link: string;
+        cli: {
+          negatedDescription: string;
+        };
       };
       Client: {
         description: string;
@@ -1341,6 +1433,148 @@ declare class Server {
                 webSocketTransport: {
                   $ref: string;
                 };
+                /** @typedef {import("net").Socket} Socket */
+                /** @typedef {import("http").IncomingMessage} IncomingMessage */
+                /** @typedef {import("open").Options} OpenOptions */
+                /** @typedef {import("https").ServerOptions & { spdy?: { plain?: boolean | undefined, ssl?: boolean | undefined, 'x-forwarded-for'?: string | undefined, protocol?: string | undefined, protocols?: string[] | undefined }}} ServerOptions */
+                /**
+                 * @template Request, Response
+                 * @typedef {import("webpack-dev-middleware").Options<Request, Response>} DevMiddlewareOptions
+                 */
+                /**
+                 * @template Request, Response
+                 * @typedef {import("webpack-dev-middleware").Context<Request, Response>} DevMiddlewareContext
+                 */
+                /**
+                 * @typedef {"local-ip" | "local-ipv4" | "local-ipv6" | string} Host
+                 */
+                /**
+                 * @typedef {number | string | "auto"} Port
+                 */
+                /**
+                 * @typedef {Object} WatchFiles
+                 * @property {string | string[]} paths
+                 * @property {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [options]
+                 */
+                /**
+                 * @typedef {Object} Static
+                 * @property {string} [directory]
+                 * @property {string | string[]} [publicPath]
+                 * @property {boolean | ServeIndexOptions} [serveIndex]
+                 * @property {ServeStaticOptions} [staticOptions]
+                 * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [watch]
+                 */
+                /**
+                 * @typedef {Object} NormalizedStatic
+                 * @property {string} directory
+                 * @property {string[]} publicPath
+                 * @property {false | ServeIndexOptions} serveIndex
+                 * @property {ServeStaticOptions} staticOptions
+                 * @property {false | WatchOptions} watch
+                 */
+                /**
+                 * @typedef {Object} ServerConfiguration
+                 * @property {"http" | "https" | "spdy" | string} [type]
+                 * @property {ServerOptions} [options]
+                 */
+                /**
+                 * @typedef {Object} WebSocketServerConfiguration
+                 * @property {"sockjs" | "ws" | string | Function} [type]
+                 * @property {Record<string, any>} [options]
+                 */
+                /**
+                 * @typedef {(import("ws").WebSocket | import("sockjs").Connection & { send: import("ws").WebSocket["send"], terminate: import("ws").WebSocket["terminate"], ping: import("ws").WebSocket["ping"] }) & { isAlive?: boolean }} ClientConnection
+                 */
+                /**
+                 * @typedef {import("ws").WebSocketServer | import("sockjs").Server & { close: import("ws").WebSocketServer["close"] }} WebSocketServer
+                 */
+                /**
+                 * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
+                 */
+                /**
+                 * @callback ByPass
+                 * @param {Request} req
+                 * @param {Response} res
+                 * @param {ProxyConfigArrayItem} proxyConfig
+                 */
+                /**
+                 * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
+                 */
+                /**
+                 * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
+                 */
+                /**
+                 * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
+                 */
+                /**
+                 * @typedef {Object} OpenApp
+                 * @property {string} [name]
+                 * @property {string[]} [arguments]
+                 */
+                /**
+                 * @typedef {Object} Open
+                 * @property {string | string[] | OpenApp} [app]
+                 * @property {string | string[]} [target]
+                 */
+                /**
+                 * @typedef {Object} NormalizedOpen
+                 * @property {string} target
+                 * @property {import("open").Options} options
+                 */
+                /**
+                 * @typedef {Object} WebSocketURL
+                 * @property {string} [hostname]
+                 * @property {string} [password]
+                 * @property {string} [pathname]
+                 * @property {number | string} [port]
+                 * @property {string} [protocol]
+                 * @property {string} [username]
+                 */
+                /**
+                 * @typedef {Object} ClientConfiguration
+                 * @property {"log" | "info" | "warn" | "error" | "none" | "verbose"} [logging]
+                 * @property {boolean  | { warnings?: boolean, errors?: boolean }} [overlay]
+                 * @property {boolean} [progress]
+                 * @property {boolean | number} [reconnect]
+                 * @property {"ws" | "sockjs" | string} [webSocketTransport]
+                 * @property {string | WebSocketURL} [webSocketURL]
+                 */
+                /**
+                 * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
+                 */
+                /**
+                 * @typedef {{ name?: string, path?: string, middleware: ExpressRequestHandler | ExpressErrorRequestHandler } | ExpressRequestHandler | ExpressErrorRequestHandler} Middleware
+                 */
+                /**
+                 * @typedef {Object} Configuration
+                 * @property {boolean | string} [ipc]
+                 * @property {Host} [host]
+                 * @property {Port} [port]
+                 * @property {boolean | "only"} [hot]
+                 * @property {boolean} [liveReload]
+                 * @property {DevMiddlewareOptions<Request, Response>} [devMiddleware]
+                 * @property {boolean} [compress]
+                 * @property {boolean} [magicHtml]
+                 * @property {"auto" | "all" | string | string[]} [allowedHosts]
+                 * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
+                 * @property {boolean} [setupExitSignals]
+                 * @property {boolean | BonjourOptions} [bonjour]
+                 * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
+                 * @property {boolean | string | Static | Array<string | Static>} [static]
+                 * @property {boolean | ServerOptions} [https]
+                 * @property {boolean} [http2]
+                 * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
+                 * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
+                 * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
+                 * @property {boolean | string | Open | Array<string | Open>} [open]
+                 * @property {boolean} [setupExitSignals]
+                 * @property {boolean | ClientConfiguration} [client]
+                 * @property {Headers | ((req: Request, res: Response, context: DevMiddlewareContext<Request, Response>) => Headers)} [headers]
+                 * @property {(devServer: Server) => void} [onAfterSetupMiddleware]
+                 * @property {(devServer: Server) => void} [onBeforeSetupMiddleware]
+                 * @property {(devServer: Server) => void} [onListening]
+                 * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
+                 */
                 webSocketURL: {
                   $ref: string;
                 };
@@ -1351,145 +1585,6 @@ declare class Server {
       };
       ClientLogging: {
         enum: string[];
-        /** @typedef {import("https").ServerOptions & { spdy?: { plain?: boolean | undefined, ssl?: boolean | undefined, 'x-forwarded-for'?: string | undefined, protocol?: string | undefined, protocols?: string[] | undefined }}} ServerOptions */
-        /**
-         * @template Request, Response
-         * @typedef {import("webpack-dev-middleware").Options<Request, Response>} DevMiddlewareOptions
-         */
-        /**
-         * @template Request, Response
-         * @typedef {import("webpack-dev-middleware").Context<Request, Response>} DevMiddlewareContext
-         */
-        /**
-         * @typedef {"local-ip" | "local-ipv4" | "local-ipv6" | string} Host
-         */
-        /**
-         * @typedef {number | string | "auto"} Port
-         */
-        /**
-         * @typedef {Object} WatchFiles
-         * @property {string | string[]} paths
-         * @property {WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [options]
-         */
-        /**
-         * @typedef {Object} Static
-         * @property {string} [directory]
-         * @property {string | string[]} [publicPath]
-         * @property {boolean | ServeIndexOptions} [serveIndex]
-         * @property {ServeStaticOptions} [staticOptions]
-         * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [watch]
-         */
-        /**
-         * @typedef {Object} NormalizedStatic
-         * @property {string} directory
-         * @property {string[]} publicPath
-         * @property {false | ServeIndexOptions} serveIndex
-         * @property {ServeStaticOptions} staticOptions
-         * @property {false | WatchOptions} watch
-         */
-        /**
-         * @typedef {Object} ServerConfiguration
-         * @property {"http" | "https" | "spdy" | string} [type]
-         * @property {ServerOptions} [options]
-         */
-        /**
-         * @typedef {Object} WebSocketServerConfiguration
-         * @property {"sockjs" | "ws" | string | Function} [type]
-         * @property {Record<string, any>} [options]
-         */
-        /**
-         * @typedef {(import("ws").WebSocket | import("sockjs").Connection & { send: import("ws").WebSocket["send"], terminate: import("ws").WebSocket["terminate"], ping: import("ws").WebSocket["ping"] }) & { isAlive?: boolean }} ClientConnection
-         */
-        /**
-         * @typedef {import("ws").WebSocketServer | import("sockjs").Server & { close: import("ws").WebSocketServer["close"] }} WebSocketServer
-         */
-        /**
-         * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
-         */
-        /**
-         * @typedef {{ [url: string]: string | HttpProxyMiddlewareOptions }} ProxyConfigMap
-         */
-        /**
-         * @typedef {HttpProxyMiddlewareOptions[]} ProxyArray
-         */
-        /**
-         * @callback ByPass
-         * @param {Request} req
-         * @param {Response} res
-         * @param {ProxyConfigArray} proxyConfig
-         */
-        /**
-         * @typedef {{ path?: string | string[] | undefined, context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined } & HttpProxyMiddlewareOptions & ByPass} ProxyConfigArray
-         */
-        /**
-         * @typedef {Object} OpenApp
-         * @property {string} [name]
-         * @property {string[]} [arguments]
-         */
-        /**
-         * @typedef {Object} Open
-         * @property {string | string[] | OpenApp} [app]
-         * @property {string | string[]} [target]
-         */
-        /**
-         * @typedef {Object} NormalizedOpen
-         * @property {string} target
-         * @property {import("open").Options} options
-         */
-        /**
-         * @typedef {Object} WebSocketURL
-         * @property {string} [hostname]
-         * @property {string} [password]
-         * @property {string} [pathname]
-         * @property {number | string} [port]
-         * @property {string} [protocol]
-         * @property {string} [username]
-         */
-        /**
-         * @typedef {Object} ClientConfiguration
-         * @property {"log" | "info" | "warn" | "error" | "none" | "verbose"} [logging]
-         * @property {boolean  | { warnings?: boolean, errors?: boolean }} [overlay]
-         * @property {boolean} [progress]
-         * @property {boolean | number} [reconnect]
-         * @property {"ws" | "sockjs" | string} [webSocketTransport]
-         * @property {string | WebSocketURL} [webSocketURL]
-         */
-        /**
-         * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
-         */
-        /**
-         * @typedef {{ name?: string, path?: string, middleware: ExpressRequestHandler | ExpressErrorRequestHandler } | ExpressRequestHandler | ExpressErrorRequestHandler} Middleware
-         */
-        /**
-         * @typedef {Object} Configuration
-         * @property {boolean | string} [ipc]
-         * @property {Host} [host]
-         * @property {Port} [port]
-         * @property {boolean | "only"} [hot]
-         * @property {boolean} [liveReload]
-         * @property {DevMiddlewareOptions<Request, Response>} [devMiddleware]
-         * @property {boolean} [compress]
-         * @property {boolean} [magicHtml]
-         * @property {"auto" | "all" | string | string[]} [allowedHosts]
-         * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
-         * @property {boolean} [setupExitSignals]
-         * @property {boolean | BonjourOptions} [bonjour]
-         * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
-         * @property {boolean | string | Static | Array<string | Static>} [static]
-         * @property {boolean | ServerOptions} [https]
-         * @property {boolean} [http2]
-         * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
-         * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
-         * @property {ProxyConfigMap | ProxyConfigArray | ProxyArray} [proxy]
-         * @property {boolean | string | Open | Array<string | Open>} [open]
-         * @property {boolean} [setupExitSignals]
-         * @property {boolean | ClientConfiguration} [client]
-         * @property {Headers | ((req: Request, res: Response, context: DevMiddlewareContext<Request, Response>) => Headers)} [headers]
-         * @property {(devServer: Server) => void} [onAfterSetupMiddleware]
-         * @property {(devServer: Server) => void} [onBeforeSetupMiddleware]
-         * @property {(devServer: Server) => void} [onListening]
-         * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
-         */
         description: string;
         link: string;
       };
@@ -1497,78 +1592,70 @@ declare class Server {
         anyOf: (
           | {
               description: string;
-              link: string;
-              type: string;
-              additionalProperties?: undefined;
-              properties?: undefined;
-            }
-          | {
-              type: string;
-              additionalProperties: boolean;
-              properties: {
-                errors: {
-                  description: string;
-                  type: string;
-                };
-                warnings: {
-                  description: string;
-                  type: string;
-                };
-              };
-              description?: undefined;
-              link?: undefined;
-            }
-        )[];
-      };
-      ClientProgress: {
-        description: string;
-        link: string;
-        type: string;
-      };
-      ClientReconnect: {
-        description: string;
-        link: string;
-        anyOf: (
-          | {
-              type: string;
-              minimum?: undefined;
-            }
-          | {
-              type: string;
-              minimum: number;
-            }
-        )[];
-      };
-      ClientWebSocketTransport: {
-        anyOf: {
-          $ref: string;
-        }[];
-        description: string;
-        link: string;
-      };
-      ClientWebSocketTransportEnum: {
-        enum: string[];
-      };
-      ClientWebSocketTransportString: {
-        type: string;
-        minLength: number;
-      };
-      ClientWebSocketURL: {
-        description: string;
-        link: string;
-        anyOf: (
-          | {
               /**
-               * @typedef {HttpProxyMiddlewareOptions[]} ProxyArray
+               * @template Request, Response
+               * @typedef {import("webpack-dev-middleware").Context<Request, Response>} DevMiddlewareContext
+               */
+              /**
+               * @typedef {"local-ip" | "local-ipv4" | "local-ipv6" | string} Host
+               */
+              /**
+               * @typedef {number | string | "auto"} Port
+               */
+              /**
+               * @typedef {Object} WatchFiles
+               * @property {string | string[]} paths
+               * @property {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [options]
+               */
+              /**
+               * @typedef {Object} Static
+               * @property {string} [directory]
+               * @property {string | string[]} [publicPath]
+               * @property {boolean | ServeIndexOptions} [serveIndex]
+               * @property {ServeStaticOptions} [staticOptions]
+               * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [watch]
+               */
+              /**
+               * @typedef {Object} NormalizedStatic
+               * @property {string} directory
+               * @property {string[]} publicPath
+               * @property {false | ServeIndexOptions} serveIndex
+               * @property {ServeStaticOptions} staticOptions
+               * @property {false | WatchOptions} watch
+               */
+              /**
+               * @typedef {Object} ServerConfiguration
+               * @property {"http" | "https" | "spdy" | string} [type]
+               * @property {ServerOptions} [options]
+               */
+              /**
+               * @typedef {Object} WebSocketServerConfiguration
+               * @property {"sockjs" | "ws" | string | Function} [type]
+               * @property {Record<string, any>} [options]
+               */
+              /**
+               * @typedef {(import("ws").WebSocket | import("sockjs").Connection & { send: import("ws").WebSocket["send"], terminate: import("ws").WebSocket["terminate"], ping: import("ws").WebSocket["ping"] }) & { isAlive?: boolean }} ClientConnection
+               */
+              /**
+               * @typedef {import("ws").WebSocketServer | import("sockjs").Server & { close: import("ws").WebSocketServer["close"] }} WebSocketServer
+               */
+              /**
+               * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
                */
               /**
                * @callback ByPass
                * @param {Request} req
                * @param {Response} res
-               * @param {ProxyConfigArray} proxyConfig
+               * @param {ProxyConfigArrayItem} proxyConfig
+               */
+              /**
+               * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
                */
               /**
-               * @typedef {{ path?: string | string[] | undefined, context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined } & HttpProxyMiddlewareOptions & ByPass} ProxyConfigArray
+               * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
+               */
+              /**
+               * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
                */
               /**
                * @typedef {Object} OpenApp
@@ -1629,7 +1716,7 @@ declare class Server {
                * @property {boolean} [http2]
                * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
                * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
-               * @property {ProxyConfigMap | ProxyConfigArray | ProxyArray} [proxy]
+               * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
                * @property {boolean | string | Open | Array<string | Open>} [open]
                * @property {boolean} [setupExitSignals]
                * @property {boolean | ClientConfiguration} [client]
@@ -1639,6 +1726,77 @@ declare class Server {
                * @property {(devServer: Server) => void} [onListening]
                * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
                */
+              link: string;
+              type: string;
+              cli: {
+                negatedDescription: string;
+              };
+              additionalProperties?: undefined;
+              properties?: undefined;
+            }
+          | {
+              type: string;
+              additionalProperties: boolean;
+              properties: {
+                errors: {
+                  description: string;
+                  type: string;
+                };
+                warnings: {
+                  description: string;
+                  type: string;
+                };
+              };
+              description?: undefined;
+              link?: undefined;
+              cli?: undefined;
+            }
+        )[];
+      };
+      ClientProgress: {
+        description: string;
+        link: string;
+        type: string;
+        cli: {
+          negatedDescription: string;
+        };
+      };
+      ClientReconnect: {
+        description: string;
+        link: string;
+        anyOf: (
+          | {
+              type: string;
+              minimum?: undefined;
+            }
+          | {
+              type: string;
+              minimum: number;
+            }
+        )[];
+        cli: {
+          negatedDescription: string;
+        };
+      };
+      ClientWebSocketTransport: {
+        anyOf: {
+          $ref: string;
+        }[];
+        description: string;
+        link: string;
+      };
+      ClientWebSocketTransportEnum: {
+        enum: string[];
+      };
+      ClientWebSocketTransportString: {
+        type: string;
+        minLength: number;
+      };
+      ClientWebSocketURL: {
+        description: string;
+        link: string;
+        anyOf: (
+          | {
               type: string;
               minLength: number;
               additionalProperties?: undefined;
@@ -1702,6 +1860,9 @@ declare class Server {
         type: string;
         description: string;
         link: string;
+        cli: {
+          negatedDescription: string;
+        };
       };
       DevMiddleware: {
         description: string;
@@ -1713,11 +1874,17 @@ declare class Server {
         type: string;
         description: string;
         link: string;
+        cli: {
+          negatedDescription: string;
+        };
       };
       HTTPS: {
         anyOf: (
           | {
               type: string;
+              cli: {
+                negatedDescription: string;
+              };
               additionalProperties?: undefined;
               properties?: undefined;
             }
@@ -1732,6 +1899,9 @@ declare class Server {
                 requestCert: {
                   type: string;
                   description: string;
+                  cli: {
+                    negatedDescription: string;
+                  };
                 };
                 ca: {
                   anyOf: (
@@ -1764,6 +1934,9 @@ declare class Server {
                   )[];
                   description: string;
                 };
+                /**
+                 * @type {FSWatcher[]}
+                 */
                 cacert: {
                   anyOf: (
                     | {
@@ -1815,9 +1988,6 @@ declare class Server {
                       }
                     | {
                         type: string;
-                        /**
-                         * @type {Socket[]}
-                         */
                         items?: undefined;
                         instanceof?: undefined;
                       }
@@ -1840,11 +2010,6 @@ declare class Server {
                                 instanceof?: undefined;
                               }
                             | {
-                                /**
-                                 * @private
-                                 * @returns {StatsOptions}
-                                 * @constructor
-                                 */
                                 instanceof: string;
                                 type?: undefined;
                               }
@@ -1883,7 +2048,6 @@ declare class Server {
                               }
                             | {
                                 type: string;
-                                /** @type {NetworkInterfaceInfo[]} */
                                 additionalProperties: boolean;
                                 instanceof?: undefined;
                               }
@@ -1922,10 +2086,6 @@ declare class Server {
                               }
                             | {
                                 type: string;
-                                /**
-                                 * @param {Host} hostname
-                                 * @returns {Promise<string>}
-                                 */
                                 additionalProperties: boolean;
                                 instanceof?: undefined;
                               }
@@ -1947,9 +2107,13 @@ declare class Server {
                   description: string;
                 };
               };
+              cli?: undefined;
             }
         )[];
         description: string;
+        /**
+         * @type {string | undefined}
+         */
         link: string;
       };
       HeaderObject: {
@@ -1995,6 +2159,9 @@ declare class Server {
         description: string;
         link: string;
       };
+      /**
+       * @type {string[]}
+       */
       HistoryApiFallback: {
         anyOf: (
           | {
@@ -2040,12 +2207,15 @@ declare class Server {
         )[];
         description: string;
         link: string;
+        cli: {
+          negatedDescription: string;
+        };
       };
       IPC: {
         anyOf: (
           | {
               type: string;
-              minLength: number;
+              /** @type {ServerConfiguration} */ minLength: number;
               enum?: undefined;
             }
           | {
@@ -2060,12 +2230,17 @@ declare class Server {
       LiveReload: {
         type: string;
         description: string;
-        /** @type {{ type: WebSocketServerConfiguration["type"], options: NonNullable<WebSocketServerConfiguration["options"]> }} */
+        cli: {
+          negatedDescription: string;
+        };
         link: string;
       };
       MagicHTML: {
         type: string;
         description: string;
+        cli: {
+          negatedDescription: string;
+        };
         link: string;
       };
       OnAfterSetupMiddleware: {
@@ -2105,6 +2280,9 @@ declare class Server {
       };
       OpenBoolean: {
         type: string;
+        cli: {
+          negatedDescription: string;
+        };
       };
       OpenObject: {
         type: string;
@@ -2159,11 +2337,15 @@ declare class Server {
                   };
                   minLength?: undefined;
                   description?: undefined;
+                  cli?: undefined;
                 }
               | {
                   type: string;
                   minLength: number;
                   description: string;
+                  cli: {
+                    description: string;
+                  };
                   additionalProperties?: undefined;
                   properties?: undefined;
                 }
@@ -2234,6 +2416,10 @@ declare class Server {
         }[];
         link: string;
         description: string;
+        /**
+         * @private
+         * @returns {Compiler["options"]}
+         */
       };
       ServerType: {
         enum: string[];
@@ -2248,8 +2434,8 @@ declare class Server {
         type: string;
         minLength: number;
         cli: {
-          exclude: boolean;
-        };
+          exclude: boolean /** @type {MultiCompiler} */;
+        } /** @type {MultiCompiler} */;
       };
       ServerObject: {
         type: string;
@@ -2265,10 +2451,9 @@ declare class Server {
         };
         additionalProperties: boolean;
       };
-      /** @type {any} */
       ServerOptions: {
         type: string;
-        additionalProperties: boolean;
+        /** @type {MultiCompiler} */ additionalProperties: boolean;
         properties: {
           passphrase: {
             type: string;
@@ -2294,10 +2479,6 @@ declare class Server {
                         }
                     )[];
                   };
-                  /**
-                   * @private
-                   * @returns {Compiler["options"]}
-                   */
                   instanceof?: undefined;
                 }
               | {
@@ -2567,6 +2748,9 @@ declare class Server {
                 }
             )[];
             description: string;
+            cli: {
+              negatedDescription: string;
+            };
             link: string;
           };
           watch: {
@@ -2583,6 +2767,9 @@ declare class Server {
                 }
             )[];
             description: string;
+            cli: {
+              negatedDescription: string;
+            };
             link: string;
           };
         };
@@ -2669,7 +2856,10 @@ declare class Server {
               enum?: undefined;
             }
         )[];
-        description: string;
+        /** @type {ServerOptions} */
+        cli: {
+          description: string;
+        };
       };
       WebSocketServerFunction: {
         instanceof: string;
@@ -2754,7 +2944,7 @@ declare class Server {
         $ref: string;
       };
       port: {
-        $ref: string /** @type {Array<keyof ServerOptions>} */;
+        $ref: string;
       };
       proxy: {
         $ref: string;
@@ -3104,6 +3294,7 @@ declare namespace Server {
     NextFunction,
     ExpressRequestHandler,
     ExpressErrorRequestHandler,
+    AnymatchMatcher,
     WatchOptions,
     FSWatcher,
     ConnectHistoryApiFallbackOptions,
@@ -3132,10 +3323,10 @@ declare namespace Server {
     ClientConnection,
     WebSocketServer,
     WebSocketServerImplementation,
-    ProxyConfigMap,
-    ProxyArray,
     ByPass,
+    ProxyConfigArrayItem,
     ProxyConfigArray,
+    ProxyConfigMap,
     OpenApp,
     Open,
     NormalizedOpen,
@@ -3185,7 +3376,7 @@ type Configuration = {
   http2?: boolean | undefined;
   server?: string | ServerConfiguration | undefined;
   webSocketServer?: string | boolean | WebSocketServerConfiguration | undefined;
-  proxy?: ProxyConfigMap | ProxyConfigArray | ProxyArray | undefined;
+  proxy?: ProxyConfigArrayItem | ProxyConfigMap | ProxyConfigArray | undefined;
   open?: string | boolean | Open | (string | Open)[] | undefined;
   client?: boolean | ClientConfiguration | undefined;
   headers?:
@@ -3238,6 +3429,7 @@ type Response = import("express").Response;
 type NextFunction = import("express").NextFunction;
 type ExpressRequestHandler = import("express").RequestHandler;
 type ExpressErrorRequestHandler = import("express").ErrorRequestHandler;
+type AnymatchMatcher = import("anymatch").Matcher;
 type WatchOptions = import("chokidar").WatchOptions;
 type ConnectHistoryApiFallbackOptions =
   import("connect-history-api-fallback").Options;
@@ -3270,7 +3462,7 @@ type WatchFiles = {
   options?:
     | (import("chokidar").WatchOptions & {
         aggregateTimeout?: number | undefined;
-        ignored?: string | RegExp | string[] | undefined;
+        ignored?: string[] | import("anymatch").Matcher | undefined;
         poll?: number | boolean | undefined;
       })
     | undefined;
@@ -3286,7 +3478,7 @@ type Static = {
     | boolean
     | (import("chokidar").WatchOptions & {
         aggregateTimeout?: number | undefined;
-        ignored?: string | RegExp | string[] | undefined;
+        ignored?: string[] | import("anymatch").Matcher | undefined;
         poll?: number | boolean | undefined;
       })
     | undefined;
@@ -3311,20 +3503,28 @@ type WebSocketServer =
   | (import("sockjs").Server & {
       close: import("ws").WebSocketServer["close"];
     });
-type ProxyConfigMap = {
-  [url: string]: string | import("http-proxy-middleware").Options;
-};
-type ProxyArray = HttpProxyMiddlewareOptions[];
 type ByPass = (
   req: Request,
   res: Response,
-  proxyConfig: ProxyConfigArray
+  proxyConfig: ProxyConfigArrayItem
 ) => any;
-type ProxyConfigArray = {
-  path?: string | string[] | undefined;
-  context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined;
-} & HttpProxyMiddlewareOptions &
-  ByPass;
+type ProxyConfigArrayItem = {
+  path?: HttpProxyMiddlewareOptionsFilter | undefined;
+  context?: HttpProxyMiddlewareOptionsFilter | undefined;
+} & {
+  bypass?: ByPass;
+} & HttpProxyMiddlewareOptions;
+type ProxyConfigArray = (
+  | ProxyConfigArrayItem
+  | ((
+      req?: Request | undefined,
+      res?: Response | undefined,
+      next?: NextFunction | undefined
+    ) => ProxyConfigArrayItem)
+)[];
+type ProxyConfigMap = {
+  [url: string]: string | ProxyConfigArrayItem;
+};
 type OpenApp = {
   name?: string | undefined;
   arguments?: string[] | undefined;