webpack-dev-server 4.7.3 → 4.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/README.md +43 -6
  2. package/bin/cli-flags.js +34 -22
  3. package/client/index.js +1 -1
  4. package/client/modules/sockjs-client/index.js +76 -1120
  5. package/client/socket.js +5 -2
  6. package/client/utils/createSocketURL.js +1 -1
  7. package/client/utils/parseURL.js +1 -1
  8. package/client/utils/stripAnsi.js +20 -0
  9. package/lib/Server.js +136 -134
  10. package/lib/options.json +89 -21
  11. package/package.json +34 -33
  12. package/types/bin/cli-flags.d.ts +63 -33
  13. package/types/lib/Server.d.ts +464 -307
  14. package/types/lib/servers/WebsocketServer.d.ts +1 -1
  15. package/client/modules/strip-ansi/index.js +0 -119
package/types/lib/Server.d.ts CHANGED
@@ -29,8 +29,8 @@ declare class Server {
29
29
  /** @typedef {import("chokidar").WatchOptions} WatchOptions */
30
30
  /** @typedef {import("chokidar").FSWatcher} FSWatcher */
31
31
  /** @typedef {import("connect-history-api-fallback").Options} ConnectHistoryApiFallbackOptions */
32
- /** @typedef {import("bonjour").Bonjour} Bonjour */
33
- /** @typedef {import("bonjour").BonjourOptions} BonjourOptions */
32
+ /** @typedef {import("bonjour-service").Bonjour} Bonjour */
33
+ /** @typedef {import("bonjour-service").Service} BonjourOptions */
34
34
  /** @typedef {import("http-proxy-middleware").RequestHandler} RequestHandler */
35
35
  /** @typedef {import("http-proxy-middleware").Options} HttpProxyMiddlewareOptions */
36
36
  /** @typedef {import("http-proxy-middleware").Filter} HttpProxyMiddlewareOptionsFilter */
@@ -59,7 +59,7 @@ declare class Server {
59
59
  /**
60
60
  * @typedef {Object} WatchFiles
61
61
  * @property {string | string[]} paths
62
- * @property {WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [options]
62
+ * @property {WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [options]
63
63
  */
64
64
  /**
65
65
  * @typedef {Object} Static
@@ -67,7 +67,7 @@ declare class Server {
67
67
  * @property {string | string[]} [publicPath]
68
68
  * @property {boolean | ServeIndexOptions} [serveIndex]
69
69
  * @property {ServeStaticOptions} [staticOptions]
70
- * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [watch]
70
+ * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [watch]
71
71
  */
72
72
  /**
73
73
  * @typedef {Object} NormalizedStatic
@@ -97,19 +97,19 @@ declare class Server {
97
97
  * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
98
98
  */
99
99
  /**
100
- * @typedef {{ [url: string]: string | HttpProxyMiddlewareOptions }} ProxyConfigMap
100
+ * @callback ByPass
101
+ * @param {Request} req
102
+ * @param {Response} res
103
+ * @param {ProxyConfigArrayItem} proxyConfig
101
104
  */
102
105
  /**
103
- * @typedef {HttpProxyMiddlewareOptions[]} ProxyArray
106
+ * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
104
107
  */
105
108
  /**
106
- * @callback ByPass
107
- * @param {Request} req
108
- * @param {Response} res
109
- * @param {ProxyConfigArray} proxyConfig
109
+ * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
110
110
  */
111
111
  /**
112
- * @typedef {{ path?: string | string[] | undefined, context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined } & HttpProxyMiddlewareOptions & ByPass} ProxyConfigArray
112
+ * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
113
113
  */
114
114
  /**
115
115
  * @typedef {Object} OpenApp
@@ -163,14 +163,14 @@ declare class Server {
163
163
  * @property {"auto" | "all" | string | string[]} [allowedHosts]
164
164
  * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
165
165
  * @property {boolean} [setupExitSignals]
166
- * @property {boolean | BonjourOptions} [bonjour]
166
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
167
167
  * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
168
168
  * @property {boolean | string | Static | Array<string | Static>} [static]
169
169
  * @property {boolean | ServerOptions} [https]
170
170
  * @property {boolean} [http2]
171
171
  * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
172
172
  * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
173
- * @property {ProxyConfigMap | ProxyConfigArray | ProxyArray} [proxy]
173
+ * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
174
174
  * @property {boolean | string | Open | Array<string | Open>} [open]
175
175
  * @property {boolean} [setupExitSignals]
176
176
  * @property {boolean | ClientConfiguration} [client]
@@ -199,22 +199,27 @@ declare class Server {
199
199
  type: string;
200
200
  multiple: boolean;
201
201
  description: string;
202
+ negatedDescription: string;
202
203
  path: string;
203
204
  }[];
204
205
  description: string;
205
- negatedDescription: string;
206
206
  simpleType: string;
207
207
  multiple: boolean;
208
208
  };
209
209
  client: {
210
210
  configs: {
211
211
  description: string;
212
+ negatedDescription: string;
212
213
  multiple: boolean;
213
214
  path: string;
214
215
  type: string;
215
216
  values: boolean[];
216
217
  }[];
217
- /** @typedef {import("https").ServerOptions & { spdy?: { plain?: boolean | undefined, ssl?: boolean | undefined, 'x-forwarded-for'?: string | undefined, protocol?: string | undefined, protocols?: string[] | undefined }}} ServerOptions */
218
+ description: string;
219
+ multiple: boolean;
220
+ simpleType: string;
221
+ };
222
+ "client-logging": {
218
223
  /**
219
224
  * @template Request, Response
220
225
  * @typedef {import("webpack-dev-middleware").Options<Request, Response>} DevMiddlewareOptions
@@ -232,7 +237,7 @@ declare class Server {
232
237
  /**
233
238
  * @typedef {Object} WatchFiles
234
239
  * @property {string | string[]} paths
235
- * @property {WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [options]
240
+ * @property {WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [options]
236
241
  */
237
242
  /**
238
243
  * @typedef {Object} Static
@@ -240,7 +245,7 @@ declare class Server {
240
245
  * @property {string | string[]} [publicPath]
241
246
  * @property {boolean | ServeIndexOptions} [serveIndex]
242
247
  * @property {ServeStaticOptions} [staticOptions]
243
- * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [watch]
248
+ * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [watch]
244
249
  */
245
250
  /**
246
251
  * @typedef {Object} NormalizedStatic
@@ -270,19 +275,19 @@ declare class Server {
270
275
  * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
271
276
  */
272
277
  /**
273
- * @typedef {{ [url: string]: string | HttpProxyMiddlewareOptions }} ProxyConfigMap
278
+ * @callback ByPass
279
+ * @param {Request} req
280
+ * @param {Response} res
281
+ * @param {ProxyConfigArrayItem} proxyConfig
274
282
  */
275
283
  /**
276
- * @typedef {HttpProxyMiddlewareOptions[]} ProxyArray
284
+ * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
277
285
  */
278
286
  /**
279
- * @callback ByPass
280
- * @param {Request} req
281
- * @param {Response} res
282
- * @param {ProxyConfigArray} proxyConfig
287
+ * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
283
288
  */
284
289
  /**
285
- * @typedef {{ path?: string | string[] | undefined, context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined } & HttpProxyMiddlewareOptions & ByPass} ProxyConfigArray
290
+ * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
286
291
  */
287
292
  /**
288
293
  * @typedef {Object} OpenApp
@@ -336,14 +341,14 @@ declare class Server {
336
341
  * @property {"auto" | "all" | string | string[]} [allowedHosts]
337
342
  * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
338
343
  * @property {boolean} [setupExitSignals]
339
- * @property {boolean | BonjourOptions} [bonjour]
344
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
340
345
  * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
341
346
  * @property {boolean | string | Static | Array<string | Static>} [static]
342
347
  * @property {boolean | ServerOptions} [https]
343
348
  * @property {boolean} [http2]
344
349
  * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
345
350
  * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
346
- * @property {ProxyConfigMap | ProxyConfigArray | ProxyArray} [proxy]
351
+ * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
347
352
  * @property {boolean | string | Open | Array<string | Open>} [open]
348
353
  * @property {boolean} [setupExitSignals]
349
354
  * @property {boolean | ClientConfiguration} [client]
@@ -353,11 +358,6 @@ declare class Server {
353
358
  * @property {(devServer: Server) => void} [onListening]
354
359
  * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
355
360
  */
356
- description: string;
357
- multiple: boolean;
358
- simpleType: string;
359
- };
360
- "client-logging": {
361
361
  configs: {
362
362
  type: string;
363
363
  values: string[];
@@ -374,10 +374,10 @@ declare class Server {
374
374
  type: string;
375
375
  multiple: boolean;
376
376
  description: string;
377
+ negatedDescription: string;
377
378
  path: string;
378
379
  }[];
379
380
  description: string;
380
- negatedDescription: string;
381
381
  simpleType: string;
382
382
  multiple: boolean;
383
383
  };
@@ -386,6 +386,7 @@ declare class Server {
386
386
  type: string;
387
387
  multiple: boolean;
388
388
  description: string;
389
+ negatedDescription: string;
389
390
  path: string;
390
391
  }[];
391
392
  description: string;
@@ -397,6 +398,7 @@ declare class Server {
397
398
  type: string;
398
399
  multiple: boolean;
399
400
  description: string;
401
+ negatedDescription: string;
400
402
  path: string;
401
403
  }[];
402
404
  description: string;
@@ -408,22 +410,30 @@ declare class Server {
408
410
  type: string;
409
411
  multiple: boolean;
410
412
  description: string;
413
+ negatedDescription: string;
411
414
  path: string;
412
415
  }[];
413
416
  description: string;
414
- negatedDescription: string;
415
417
  simpleType: string;
416
418
  multiple: boolean;
417
419
  };
418
420
  "client-reconnect": {
419
- configs: {
420
- type: string;
421
- multiple: boolean;
422
- description: string;
423
- path: string;
424
- }[];
421
+ configs: (
422
+ | {
423
+ type: string;
424
+ multiple: boolean;
425
+ description: string;
426
+ negatedDescription: string;
427
+ path: string;
428
+ }
429
+ | {
430
+ type: string;
431
+ multiple: boolean;
432
+ description: string;
433
+ path: string;
434
+ }
435
+ )[];
425
436
  description: string;
426
- negatedDescription: string;
427
437
  simpleType: string;
428
438
  multiple: boolean;
429
439
  };
@@ -443,6 +453,36 @@ declare class Server {
443
453
  path: string;
444
454
  }
445
455
  )[];
456
+ /**
457
+ * @typedef {Object} Configuration
458
+ * @property {boolean | string} [ipc]
459
+ * @property {Host} [host]
460
+ * @property {Port} [port]
461
+ * @property {boolean | "only"} [hot]
462
+ * @property {boolean} [liveReload]
463
+ * @property {DevMiddlewareOptions<Request, Response>} [devMiddleware]
464
+ * @property {boolean} [compress]
465
+ * @property {boolean} [magicHtml]
466
+ * @property {"auto" | "all" | string | string[]} [allowedHosts]
467
+ * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
468
+ * @property {boolean} [setupExitSignals]
469
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
470
+ * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
471
+ * @property {boolean | string | Static | Array<string | Static>} [static]
472
+ * @property {boolean | ServerOptions} [https]
473
+ * @property {boolean} [http2]
474
+ * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
475
+ * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
476
+ * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
477
+ * @property {boolean | string | Open | Array<string | Open>} [open]
478
+ * @property {boolean} [setupExitSignals]
479
+ * @property {boolean | ClientConfiguration} [client]
480
+ * @property {Headers | ((req: Request, res: Response, context: DevMiddlewareContext<Request, Response>) => Headers)} [headers]
481
+ * @property {(devServer: Server) => void} [onAfterSetupMiddleware]
482
+ * @property {(devServer: Server) => void} [onBeforeSetupMiddleware]
483
+ * @property {(devServer: Server) => void} [onListening]
484
+ * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
485
+ */
446
486
  description: string;
447
487
  simpleType: string;
448
488
  multiple: boolean;
@@ -518,22 +558,26 @@ declare class Server {
518
558
  type: string;
519
559
  }
520
560
  )[];
561
+ /**
562
+ * @private
563
+ * @type {{ name: string | symbol, listener: (...args: any[]) => void}[] }}
564
+ */
521
565
  description: string;
522
566
  multiple: boolean;
523
567
  simpleType: string;
524
568
  };
525
569
  "client-web-socket-url-username": {
526
570
  configs: {
571
+ /**
572
+ * @private
573
+ * @type {RequestHandler[]}
574
+ */
527
575
  type: string;
528
576
  multiple: boolean;
529
577
  description: string;
530
578
  path: string;
531
579
  }[];
532
580
  description: string;
533
- /**
534
- * @private
535
- * @type {string | undefined}
536
- */
537
581
  simpleType: string;
538
582
  multiple: boolean;
539
583
  };
@@ -542,10 +586,10 @@ declare class Server {
542
586
  type: string;
543
587
  multiple: boolean;
544
588
  description: string;
589
+ negatedDescription: string;
545
590
  path: string;
546
591
  }[];
547
592
  description: string;
548
- negatedDescription: string;
549
593
  simpleType: string;
550
594
  multiple: boolean;
551
595
  };
@@ -554,6 +598,7 @@ declare class Server {
554
598
  type: string;
555
599
  multiple: boolean;
556
600
  description: string;
601
+ negatedDescription: string;
557
602
  path: string;
558
603
  }[];
559
604
  description: string;
@@ -586,6 +631,11 @@ declare class Server {
586
631
  type: string;
587
632
  multiple: boolean;
588
633
  description: string;
634
+ negatedDescription: string;
635
+ /**
636
+ * @param {"v4" | "v6"} family
637
+ * @returns {string | undefined}
638
+ */
589
639
  path: string;
590
640
  }
591
641
  | {
@@ -597,7 +647,6 @@ declare class Server {
597
647
  }
598
648
  )[];
599
649
  description: string;
600
- negatedDescription: string;
601
650
  simpleType: string;
602
651
  multiple: boolean;
603
652
  };
@@ -606,26 +655,26 @@ declare class Server {
606
655
  type: string;
607
656
  multiple: boolean;
608
657
  description: string;
658
+ negatedDescription: string;
609
659
  path: string;
610
660
  }[];
611
- /**
612
- * @param {Host} hostname
613
- * @returns {Promise<string>}
614
- */
615
661
  description: string;
616
- negatedDescription: string;
617
662
  simpleType: string;
618
663
  multiple: boolean;
619
664
  };
665
+ /**
666
+ * @param {Port} port
667
+ * @returns {Promise<number | string>}
668
+ */
620
669
  https: {
621
670
  configs: {
622
671
  type: string;
623
672
  multiple: boolean;
624
673
  description: string;
674
+ negatedDescription: string;
625
675
  path: string;
626
676
  }[];
627
677
  description: string;
628
- negatedDescription: string;
629
678
  simpleType: string;
630
679
  multiple: boolean;
631
680
  };
@@ -636,6 +685,9 @@ declare class Server {
636
685
  description: string;
637
686
  path: string;
638
687
  }[];
688
+ /**
689
+ * @type {string | undefined}
690
+ */
639
691
  description: string;
640
692
  simpleType: string;
641
693
  multiple: boolean;
@@ -659,9 +711,6 @@ declare class Server {
659
711
  path: string;
660
712
  }[];
661
713
  description: string;
662
- /**
663
- * @type {string[]}
664
- */
665
714
  simpleType: string;
666
715
  multiple: boolean;
667
716
  };
@@ -670,7 +719,7 @@ declare class Server {
670
719
  description: string;
671
720
  multiple: boolean;
672
721
  path: string;
673
- type: string;
722
+ /** @type {WebSocketURL} */ type: string;
674
723
  }[];
675
724
  description: string;
676
725
  multiple: boolean;
@@ -679,7 +728,7 @@ declare class Server {
679
728
  "https-cert": {
680
729
  configs: {
681
730
  type: string;
682
- /** @type {ClientConfiguration} */ multiple: boolean;
731
+ multiple: boolean;
683
732
  description: string;
684
733
  path: string;
685
734
  }[];
@@ -780,10 +829,10 @@ declare class Server {
780
829
  type: string;
781
830
  multiple: boolean;
782
831
  description: string;
832
+ negatedDescription: string;
783
833
  path: string;
784
834
  }[];
785
835
  description: string;
786
- negatedDescription: string;
787
836
  simpleType: string;
788
837
  multiple: boolean;
789
838
  };
@@ -797,7 +846,7 @@ declare class Server {
797
846
  }
798
847
  | {
799
848
  type: string;
800
- values: boolean[];
849
+ /** @type {Object<string,string>} */ values: boolean[];
801
850
  multiple: boolean;
802
851
  description: string;
803
852
  path: string;
@@ -810,36 +859,44 @@ declare class Server {
810
859
  "live-reload": {
811
860
  configs: {
812
861
  type: string;
813
- /** @type {Object<string,string>} */ multiple: boolean;
862
+ multiple: boolean;
814
863
  description: string;
864
+ negatedDescription: string;
815
865
  path: string;
816
866
  }[];
817
867
  description: string;
818
- negatedDescription: string;
819
868
  simpleType: string;
820
- multiple: boolean /** @type {any} */;
869
+ multiple: boolean;
821
870
  };
822
871
  "magic-html": {
823
872
  configs: {
824
873
  type: string;
825
874
  multiple: boolean;
826
875
  description: string;
876
+ negatedDescription: string;
827
877
  path: string;
828
878
  }[];
829
879
  description: string;
830
- negatedDescription: string;
831
880
  simpleType: string;
832
881
  multiple: boolean;
833
882
  };
834
883
  open: {
835
- configs: {
836
- type: string;
837
- multiple: boolean;
838
- description: string;
839
- path: string;
840
- }[];
884
+ configs: (
885
+ | {
886
+ type: string;
887
+ multiple: boolean;
888
+ description: string;
889
+ path: string;
890
+ }
891
+ | {
892
+ type: string;
893
+ multiple: boolean;
894
+ description: string;
895
+ negatedDescription: string;
896
+ path: string;
897
+ }
898
+ )[];
841
899
  description: string;
842
- negatedDescription: string;
843
900
  simpleType: string;
844
901
  multiple: boolean;
845
902
  };
@@ -895,7 +952,6 @@ declare class Server {
895
952
  path: string;
896
953
  }[];
897
954
  description: string;
898
- negatedDescription: string;
899
955
  simpleType: string;
900
956
  multiple: boolean;
901
957
  };
@@ -1076,6 +1132,7 @@ declare class Server {
1076
1132
  "server-options-request-cert": {
1077
1133
  configs: {
1078
1134
  description: string;
1135
+ negatedDescription: string;
1079
1136
  multiple: boolean;
1080
1137
  path: string;
1081
1138
  type: string;
@@ -1097,12 +1154,21 @@ declare class Server {
1097
1154
  simpleType: string;
1098
1155
  };
1099
1156
  static: {
1100
- configs: {
1101
- type: string;
1102
- multiple: boolean;
1103
- description: string;
1104
- path: string;
1105
- }[];
1157
+ configs: (
1158
+ | {
1159
+ type: string;
1160
+ multiple: boolean;
1161
+ description: string;
1162
+ path: string;
1163
+ }
1164
+ | {
1165
+ type: string;
1166
+ multiple: boolean;
1167
+ description: string;
1168
+ negatedDescription: string;
1169
+ path: string;
1170
+ }
1171
+ )[];
1106
1172
  description: string;
1107
1173
  simpleType: string;
1108
1174
  multiple: boolean;
@@ -1115,7 +1181,6 @@ declare class Server {
1115
1181
  path: string;
1116
1182
  }[];
1117
1183
  description: string;
1118
- /** @type {any} */
1119
1184
  simpleType: string;
1120
1185
  multiple: boolean;
1121
1186
  };
@@ -1157,10 +1222,10 @@ declare class Server {
1157
1222
  type: string;
1158
1223
  multiple: boolean;
1159
1224
  description: string;
1225
+ negatedDescription: string;
1160
1226
  path: string;
1161
1227
  }[];
1162
1228
  description: string;
1163
- negatedDescription: string;
1164
1229
  simpleType: string;
1165
1230
  multiple: boolean;
1166
1231
  };
@@ -1169,10 +1234,10 @@ declare class Server {
1169
1234
  type: string;
1170
1235
  multiple: boolean;
1171
1236
  description: string;
1237
+ negatedDescription: string;
1172
1238
  path: string;
1173
1239
  }[];
1174
1240
  description: string;
1175
- negatedDescription: string;
1176
1241
  simpleType: string;
1177
1242
  multiple: boolean;
1178
1243
  };
@@ -1202,6 +1267,7 @@ declare class Server {
1202
1267
  configs: (
1203
1268
  | {
1204
1269
  description: string;
1270
+ negatedDescription: string;
1205
1271
  multiple: boolean;
1206
1272
  path: string;
1207
1273
  type: string;
@@ -1300,6 +1366,9 @@ declare class Server {
1300
1366
  anyOf: (
1301
1367
  | {
1302
1368
  type: string;
1369
+ cli: {
1370
+ negatedDescription: string;
1371
+ } /** @typedef {import("express").Request} Request */;
1303
1372
  description?: undefined;
1304
1373
  link?: undefined;
1305
1374
  }
@@ -1307,6 +1376,7 @@ declare class Server {
1307
1376
  type: string;
1308
1377
  description: string;
1309
1378
  link: string;
1379
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1310
1380
  }
1311
1381
  )[];
1312
1382
  description: string;
@@ -1318,6 +1388,9 @@ declare class Server {
1318
1388
  anyOf: (
1319
1389
  | {
1320
1390
  enum: boolean[];
1391
+ cli: {
1392
+ negatedDescription: string;
1393
+ };
1321
1394
  type?: undefined;
1322
1395
  additionalProperties?: undefined;
1323
1396
  properties?: undefined;
@@ -1329,6 +1402,151 @@ declare class Server {
1329
1402
  logging: {
1330
1403
  $ref: string;
1331
1404
  };
1405
+ /** @typedef {import("serve-static").ServeStaticOptions} ServeStaticOptions */
1406
+ /** @typedef {import("ipaddr.js").IPv4} IPv4 */
1407
+ /** @typedef {import("ipaddr.js").IPv6} IPv6 */
1408
+ /** @typedef {import("net").Socket} Socket */
1409
+ /** @typedef {import("http").IncomingMessage} IncomingMessage */
1410
+ /** @typedef {import("open").Options} OpenOptions */
1411
+ /** @typedef {import("https").ServerOptions & { spdy?: { plain?: boolean | undefined, ssl?: boolean | undefined, 'x-forwarded-for'?: string | undefined, protocol?: string | undefined, protocols?: string[] | undefined }}} ServerOptions */
1412
+ /**
1413
+ * @template Request, Response
1414
+ * @typedef {import("webpack-dev-middleware").Options<Request, Response>} DevMiddlewareOptions
1415
+ */
1416
+ /**
1417
+ * @template Request, Response
1418
+ * @typedef {import("webpack-dev-middleware").Context<Request, Response>} DevMiddlewareContext
1419
+ */
1420
+ /**
1421
+ * @typedef {"local-ip" | "local-ipv4" | "local-ipv6" | string} Host
1422
+ */
1423
+ /**
1424
+ * @typedef {number | string | "auto"} Port
1425
+ */
1426
+ /**
1427
+ * @typedef {Object} WatchFiles
1428
+ * @property {string | string[]} paths
1429
+ * @property {WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [options]
1430
+ */
1431
+ /**
1432
+ * @typedef {Object} Static
1433
+ * @property {string} [directory]
1434
+ * @property {string | string[]} [publicPath]
1435
+ * @property {boolean | ServeIndexOptions} [serveIndex]
1436
+ * @property {ServeStaticOptions} [staticOptions]
1437
+ * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [watch]
1438
+ */
1439
+ /**
1440
+ * @typedef {Object} NormalizedStatic
1441
+ * @property {string} directory
1442
+ * @property {string[]} publicPath
1443
+ * @property {false | ServeIndexOptions} serveIndex
1444
+ * @property {ServeStaticOptions} staticOptions
1445
+ * @property {false | WatchOptions} watch
1446
+ */
1447
+ /**
1448
+ * @typedef {Object} ServerConfiguration
1449
+ * @property {"http" | "https" | "spdy" | string} [type]
1450
+ * @property {ServerOptions} [options]
1451
+ */
1452
+ /**
1453
+ * @typedef {Object} WebSocketServerConfiguration
1454
+ * @property {"sockjs" | "ws" | string | Function} [type]
1455
+ * @property {Record<string, any>} [options]
1456
+ */
1457
+ /**
1458
+ * @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
1459
+ */
1460
+ /**
1461
+ * @typedef {import("ws").WebSocketServer | import("sockjs").Server & { close: import("ws").WebSocketServer["close"] }} WebSocketServer
1462
+ */
1463
+ /**
1464
+ * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
1465
+ */
1466
+ /**
1467
+ * @callback ByPass
1468
+ * @param {Request} req
1469
+ * @param {Response} res
1470
+ * @param {ProxyConfigArrayItem} proxyConfig
1471
+ */
1472
+ /**
1473
+ * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
1474
+ */
1475
+ /**
1476
+ * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
1477
+ */
1478
+ /**
1479
+ * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
1480
+ */
1481
+ /**
1482
+ * @typedef {Object} OpenApp
1483
+ * @property {string} [name]
1484
+ * @property {string[]} [arguments]
1485
+ */
1486
+ /**
1487
+ * @typedef {Object} Open
1488
+ * @property {string | string[] | OpenApp} [app]
1489
+ * @property {string | string[]} [target]
1490
+ */
1491
+ /**
1492
+ * @typedef {Object} NormalizedOpen
1493
+ * @property {string} target
1494
+ * @property {import("open").Options} options
1495
+ */
1496
+ /**
1497
+ * @typedef {Object} WebSocketURL
1498
+ * @property {string} [hostname]
1499
+ * @property {string} [password]
1500
+ * @property {string} [pathname]
1501
+ * @property {number | string} [port]
1502
+ * @property {string} [protocol]
1503
+ * @property {string} [username]
1504
+ */
1505
+ /**
1506
+ * @typedef {Object} ClientConfiguration
1507
+ * @property {"log" | "info" | "warn" | "error" | "none" | "verbose"} [logging]
1508
+ * @property {boolean | { warnings?: boolean, errors?: boolean }} [overlay]
1509
+ * @property {boolean} [progress]
1510
+ * @property {boolean | number} [reconnect]
1511
+ * @property {"ws" | "sockjs" | string} [webSocketTransport]
1512
+ * @property {string | WebSocketURL} [webSocketURL]
1513
+ */
1514
+ /**
1515
+ * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
1516
+ */
1517
+ /**
1518
+ * @typedef {{ name?: string, path?: string, middleware: ExpressRequestHandler | ExpressErrorRequestHandler } | ExpressRequestHandler | ExpressErrorRequestHandler} Middleware
1519
+ */
1520
+ /**
1521
+ * @typedef {Object} Configuration
1522
+ * @property {boolean | string} [ipc]
1523
+ * @property {Host} [host]
1524
+ * @property {Port} [port]
1525
+ * @property {boolean | "only"} [hot]
1526
+ * @property {boolean} [liveReload]
1527
+ * @property {DevMiddlewareOptions<Request, Response>} [devMiddleware]
1528
+ * @property {boolean} [compress]
1529
+ * @property {boolean} [magicHtml]
1530
+ * @property {"auto" | "all" | string | string[]} [allowedHosts]
1531
+ * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
1532
+ * @property {boolean} [setupExitSignals]
1533
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
1534
+ * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
1535
+ * @property {boolean | string | Static | Array<string | Static>} [static]
1536
+ * @property {boolean | ServerOptions} [https]
1537
+ * @property {boolean} [http2]
1538
+ * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
1539
+ * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
1540
+ * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
1541
+ * @property {boolean | string | Open | Array<string | Open>} [open]
1542
+ * @property {boolean} [setupExitSignals]
1543
+ * @property {boolean | ClientConfiguration} [client]
1544
+ * @property {Headers | ((req: Request, res: Response, context: DevMiddlewareContext<Request, Response>) => Headers)} [headers]
1545
+ * @property {(devServer: Server) => void} [onAfterSetupMiddleware]
1546
+ * @property {(devServer: Server) => void} [onBeforeSetupMiddleware]
1547
+ * @property {(devServer: Server) => void} [onListening]
1548
+ * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
1549
+ */
1332
1550
  overlay: {
1333
1551
  $ref: string;
1334
1552
  };
@@ -1346,80 +1564,77 @@ declare class Server {
1346
1564
  };
1347
1565
  };
1348
1566
  enum?: undefined;
1567
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1349
1568
  }
1350
1569
  )[];
1351
1570
  };
1352
1571
  ClientLogging: {
1353
1572
  enum: string[];
1354
- /** @typedef {import("https").ServerOptions & { spdy?: { plain?: boolean | undefined, ssl?: boolean | undefined, 'x-forwarded-for'?: string | undefined, protocol?: string | undefined, protocols?: string[] | undefined }}} ServerOptions */
1355
- /**
1356
- * @template Request, Response
1357
- * @typedef {import("webpack-dev-middleware").Options<Request, Response>} DevMiddlewareOptions
1358
- */
1359
- /**
1360
- * @template Request, Response
1361
- * @typedef {import("webpack-dev-middleware").Context<Request, Response>} DevMiddlewareContext
1362
- */
1363
- /**
1364
- * @typedef {"local-ip" | "local-ipv4" | "local-ipv6" | string} Host
1365
- */
1366
- /**
1367
- * @typedef {number | string | "auto"} Port
1368
- */
1369
- /**
1370
- * @typedef {Object} WatchFiles
1371
- * @property {string | string[]} paths
1372
- * @property {WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [options]
1373
- */
1374
- /**
1375
- * @typedef {Object} Static
1376
- * @property {string} [directory]
1377
- * @property {string | string[]} [publicPath]
1378
- * @property {boolean | ServeIndexOptions} [serveIndex]
1379
- * @property {ServeStaticOptions} [staticOptions]
1380
- * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: string | RegExp | string[], poll?: number | boolean }} [watch]
1381
- */
1382
- /**
1383
- * @typedef {Object} NormalizedStatic
1384
- * @property {string} directory
1385
- * @property {string[]} publicPath
1386
- * @property {false | ServeIndexOptions} serveIndex
1387
- * @property {ServeStaticOptions} staticOptions
1388
- * @property {false | WatchOptions} watch
1389
- */
1390
- /**
1391
- * @typedef {Object} ServerConfiguration
1392
- * @property {"http" | "https" | "spdy" | string} [type]
1393
- * @property {ServerOptions} [options]
1394
- */
1395
- /**
1396
- * @typedef {Object} WebSocketServerConfiguration
1397
- * @property {"sockjs" | "ws" | string | Function} [type]
1398
- * @property {Record<string, any>} [options]
1399
- */
1400
- /**
1401
- * @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
1402
- */
1403
- /**
1404
- * @typedef {import("ws").WebSocketServer | import("sockjs").Server & { close: import("ws").WebSocketServer["close"] }} WebSocketServer
1405
- */
1406
- /**
1407
- * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
1408
- */
1573
+ description: string;
1574
+ link: string;
1575
+ };
1576
+ ClientOverlay: {
1577
+ anyOf: (
1578
+ | {
1579
+ description: string;
1580
+ link: string;
1581
+ type: string;
1582
+ cli: {
1583
+ negatedDescription: string;
1584
+ };
1585
+ additionalProperties?: undefined;
1586
+ properties?: undefined;
1587
+ }
1588
+ | {
1589
+ type: string;
1590
+ additionalProperties: boolean;
1591
+ properties: {
1592
+ errors: {
1593
+ description: string;
1594
+ type: string;
1595
+ cli: {
1596
+ negatedDescription: string;
1597
+ };
1598
+ };
1599
+ warnings: {
1600
+ description: string;
1601
+ type: string;
1602
+ cli: {
1603
+ negatedDescription: string;
1604
+ };
1605
+ };
1606
+ };
1607
+ description?: undefined;
1608
+ link?: undefined;
1609
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1610
+ }
1611
+ )[];
1612
+ };
1613
+ ClientProgress: {
1614
+ description: string;
1615
+ link: string;
1616
+ type: string;
1617
+ cli: {
1618
+ negatedDescription: string;
1619
+ };
1620
+ };
1621
+ ClientReconnect: {
1622
+ description: string;
1623
+ link: string;
1409
1624
  /**
1410
- * @typedef {{ [url: string]: string | HttpProxyMiddlewareOptions }} ProxyConfigMap
1625
+ * @callback ByPass
1626
+ * @param {Request} req
1627
+ * @param {Response} res
1628
+ * @param {ProxyConfigArrayItem} proxyConfig
1411
1629
  */
1412
1630
  /**
1413
- * @typedef {HttpProxyMiddlewareOptions[]} ProxyArray
1631
+ * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
1414
1632
  */
1415
1633
  /**
1416
- * @callback ByPass
1417
- * @param {Request} req
1418
- * @param {Response} res
1419
- * @param {ProxyConfigArray} proxyConfig
1634
+ * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
1420
1635
  */
1421
1636
  /**
1422
- * @typedef {{ path?: string | string[] | undefined, context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined } & HttpProxyMiddlewareOptions & ByPass} ProxyConfigArray
1637
+ * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
1423
1638
  */
1424
1639
  /**
1425
1640
  * @typedef {Object} OpenApp
@@ -1473,14 +1688,14 @@ declare class Server {
1473
1688
  * @property {"auto" | "all" | string | string[]} [allowedHosts]
1474
1689
  * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
1475
1690
  * @property {boolean} [setupExitSignals]
1476
- * @property {boolean | BonjourOptions} [bonjour]
1691
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
1477
1692
  * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
1478
1693
  * @property {boolean | string | Static | Array<string | Static>} [static]
1479
1694
  * @property {boolean | ServerOptions} [https]
1480
1695
  * @property {boolean} [http2]
1481
1696
  * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
1482
1697
  * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
1483
- * @property {ProxyConfigMap | ProxyConfigArray | ProxyArray} [proxy]
1698
+ * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
1484
1699
  * @property {boolean | string | Open | Array<string | Open>} [open]
1485
1700
  * @property {boolean} [setupExitSignals]
1486
1701
  * @property {boolean | ClientConfiguration} [client]
@@ -1490,52 +1705,18 @@ declare class Server {
1490
1705
  * @property {(devServer: Server) => void} [onListening]
1491
1706
  * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
1492
1707
  */
1493
- description: string;
1494
- link: string;
1495
- };
1496
- ClientOverlay: {
1497
1708
  anyOf: (
1498
1709
  | {
1499
- description: string;
1500
- link: string;
1501
1710
  type: string;
1502
- additionalProperties?: undefined;
1503
- properties?: undefined;
1504
- }
1505
- | {
1506
- type: string;
1507
- additionalProperties: boolean;
1508
- properties: {
1509
- errors: {
1510
- description: string;
1511
- type: string;
1512
- };
1513
- warnings: {
1514
- description: string;
1515
- type: string;
1516
- };
1711
+ cli: {
1712
+ negatedDescription: string;
1517
1713
  };
1518
- description?: undefined;
1519
- link?: undefined;
1520
- }
1521
- )[];
1522
- };
1523
- ClientProgress: {
1524
- description: string;
1525
- link: string;
1526
- type: string;
1527
- };
1528
- ClientReconnect: {
1529
- description: string;
1530
- link: string;
1531
- anyOf: (
1532
- | {
1533
- type: string;
1534
1714
  minimum?: undefined;
1535
1715
  }
1536
1716
  | {
1537
1717
  type: string;
1538
1718
  minimum: number;
1719
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1539
1720
  }
1540
1721
  )[];
1541
1722
  };
@@ -1558,87 +1739,6 @@ declare class Server {
1558
1739
  link: string;
1559
1740
  anyOf: (
1560
1741
  | {
1561
- /**
1562
- * @typedef {HttpProxyMiddlewareOptions[]} ProxyArray
1563
- */
1564
- /**
1565
- * @callback ByPass
1566
- * @param {Request} req
1567
- * @param {Response} res
1568
- * @param {ProxyConfigArray} proxyConfig
1569
- */
1570
- /**
1571
- * @typedef {{ path?: string | string[] | undefined, context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined } & HttpProxyMiddlewareOptions & ByPass} ProxyConfigArray
1572
- */
1573
- /**
1574
- * @typedef {Object} OpenApp
1575
- * @property {string} [name]
1576
- * @property {string[]} [arguments]
1577
- */
1578
- /**
1579
- * @typedef {Object} Open
1580
- * @property {string | string[] | OpenApp} [app]
1581
- * @property {string | string[]} [target]
1582
- */
1583
- /**
1584
- * @typedef {Object} NormalizedOpen
1585
- * @property {string} target
1586
- * @property {import("open").Options} options
1587
- */
1588
- /**
1589
- * @typedef {Object} WebSocketURL
1590
- * @property {string} [hostname]
1591
- * @property {string} [password]
1592
- * @property {string} [pathname]
1593
- * @property {number | string} [port]
1594
- * @property {string} [protocol]
1595
- * @property {string} [username]
1596
- */
1597
- /**
1598
- * @typedef {Object} ClientConfiguration
1599
- * @property {"log" | "info" | "warn" | "error" | "none" | "verbose"} [logging]
1600
- * @property {boolean | { warnings?: boolean, errors?: boolean }} [overlay]
1601
- * @property {boolean} [progress]
1602
- * @property {boolean | number} [reconnect]
1603
- * @property {"ws" | "sockjs" | string} [webSocketTransport]
1604
- * @property {string | WebSocketURL} [webSocketURL]
1605
- */
1606
- /**
1607
- * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
1608
- */
1609
- /**
1610
- * @typedef {{ name?: string, path?: string, middleware: ExpressRequestHandler | ExpressErrorRequestHandler } | ExpressRequestHandler | ExpressErrorRequestHandler} Middleware
1611
- */
1612
- /**
1613
- * @typedef {Object} Configuration
1614
- * @property {boolean | string} [ipc]
1615
- * @property {Host} [host]
1616
- * @property {Port} [port]
1617
- * @property {boolean | "only"} [hot]
1618
- * @property {boolean} [liveReload]
1619
- * @property {DevMiddlewareOptions<Request, Response>} [devMiddleware]
1620
- * @property {boolean} [compress]
1621
- * @property {boolean} [magicHtml]
1622
- * @property {"auto" | "all" | string | string[]} [allowedHosts]
1623
- * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
1624
- * @property {boolean} [setupExitSignals]
1625
- * @property {boolean | BonjourOptions} [bonjour]
1626
- * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
1627
- * @property {boolean | string | Static | Array<string | Static>} [static]
1628
- * @property {boolean | ServerOptions} [https]
1629
- * @property {boolean} [http2]
1630
- * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
1631
- * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
1632
- * @property {ProxyConfigMap | ProxyConfigArray | ProxyArray} [proxy]
1633
- * @property {boolean | string | Open | Array<string | Open>} [open]
1634
- * @property {boolean} [setupExitSignals]
1635
- * @property {boolean | ClientConfiguration} [client]
1636
- * @property {Headers | ((req: Request, res: Response, context: DevMiddlewareContext<Request, Response>) => Headers)} [headers]
1637
- * @property {(devServer: Server) => void} [onAfterSetupMiddleware]
1638
- * @property {(devServer: Server) => void} [onBeforeSetupMiddleware]
1639
- * @property {(devServer: Server) => void} [onListening]
1640
- * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
1641
- */
1642
1742
  type: string;
1643
1743
  minLength: number;
1644
1744
  additionalProperties?: undefined;
@@ -1657,6 +1757,9 @@ declare class Server {
1657
1757
  description: string;
1658
1758
  type: string;
1659
1759
  };
1760
+ /**
1761
+ * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
1762
+ */
1660
1763
  password: {
1661
1764
  description: string;
1662
1765
  type: string;
@@ -1702,6 +1805,9 @@ declare class Server {
1702
1805
  type: string;
1703
1806
  description: string;
1704
1807
  link: string;
1808
+ cli: {
1809
+ negatedDescription: string;
1810
+ };
1705
1811
  };
1706
1812
  DevMiddleware: {
1707
1813
  description: string;
@@ -1713,11 +1819,17 @@ declare class Server {
1713
1819
  type: string;
1714
1820
  description: string;
1715
1821
  link: string;
1822
+ cli: {
1823
+ negatedDescription: string;
1824
+ };
1716
1825
  };
1717
1826
  HTTPS: {
1718
1827
  anyOf: (
1719
1828
  | {
1720
1829
  type: string;
1830
+ cli: {
1831
+ negatedDescription: string;
1832
+ };
1721
1833
  additionalProperties?: undefined;
1722
1834
  properties?: undefined;
1723
1835
  }
@@ -1732,6 +1844,9 @@ declare class Server {
1732
1844
  requestCert: {
1733
1845
  type: string;
1734
1846
  description: string;
1847
+ cli: {
1848
+ negatedDescription: string;
1849
+ };
1735
1850
  };
1736
1851
  ca: {
1737
1852
  anyOf: (
@@ -1758,6 +1873,10 @@ declare class Server {
1758
1873
  }
1759
1874
  | {
1760
1875
  instanceof: string;
1876
+ /**
1877
+ * @private
1878
+ * @type {RequestHandler[]}
1879
+ */
1761
1880
  type?: undefined;
1762
1881
  items?: undefined;
1763
1882
  }
@@ -1815,9 +1934,6 @@ declare class Server {
1815
1934
  }
1816
1935
  | {
1817
1936
  type: string;
1818
- /**
1819
- * @type {Socket[]}
1820
- */
1821
1937
  items?: undefined;
1822
1938
  instanceof?: undefined;
1823
1939
  }
@@ -1840,11 +1956,6 @@ declare class Server {
1840
1956
  instanceof?: undefined;
1841
1957
  }
1842
1958
  | {
1843
- /**
1844
- * @private
1845
- * @returns {StatsOptions}
1846
- * @constructor
1847
- */
1848
1959
  instanceof: string;
1849
1960
  type?: undefined;
1850
1961
  }
@@ -1883,7 +1994,6 @@ declare class Server {
1883
1994
  }
1884
1995
  | {
1885
1996
  type: string;
1886
- /** @type {NetworkInterfaceInfo[]} */
1887
1997
  additionalProperties: boolean;
1888
1998
  instanceof?: undefined;
1889
1999
  }
@@ -1922,10 +2032,6 @@ declare class Server {
1922
2032
  }
1923
2033
  | {
1924
2034
  type: string;
1925
- /**
1926
- * @param {Host} hostname
1927
- * @returns {Promise<string>}
1928
- */
1929
2035
  additionalProperties: boolean;
1930
2036
  instanceof?: undefined;
1931
2037
  }
@@ -1947,6 +2053,7 @@ declare class Server {
1947
2053
  description: string;
1948
2054
  };
1949
2055
  };
2056
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1950
2057
  }
1951
2058
  )[];
1952
2059
  description: string;
@@ -1999,6 +2106,9 @@ declare class Server {
1999
2106
  anyOf: (
2000
2107
  | {
2001
2108
  type: string;
2109
+ cli: {
2110
+ negatedDescription: string;
2111
+ };
2002
2112
  description?: undefined;
2003
2113
  link?: undefined;
2004
2114
  }
@@ -2006,10 +2116,11 @@ declare class Server {
2006
2116
  type: string;
2007
2117
  description: string;
2008
2118
  link: string;
2119
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2009
2120
  }
2010
2121
  )[];
2011
2122
  description: string;
2012
- link: string;
2123
+ /** @type {string} */ link: string;
2013
2124
  };
2014
2125
  Host: {
2015
2126
  description: string;
@@ -2031,11 +2142,15 @@ declare class Server {
2031
2142
  anyOf: (
2032
2143
  | {
2033
2144
  type: string;
2145
+ cli: {
2146
+ negatedDescription: string;
2147
+ };
2034
2148
  enum?: undefined;
2035
2149
  }
2036
2150
  | {
2037
2151
  enum: string[];
2038
2152
  type?: undefined;
2153
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2039
2154
  }
2040
2155
  )[];
2041
2156
  description: string;
@@ -2060,12 +2175,17 @@ declare class Server {
2060
2175
  LiveReload: {
2061
2176
  type: string;
2062
2177
  description: string;
2063
- /** @type {{ type: WebSocketServerConfiguration["type"], options: NonNullable<WebSocketServerConfiguration["options"]> }} */
2178
+ cli: {
2179
+ negatedDescription: string;
2180
+ };
2064
2181
  link: string;
2065
2182
  };
2066
2183
  MagicHTML: {
2067
2184
  type: string;
2068
2185
  description: string;
2186
+ cli: {
2187
+ negatedDescription: string;
2188
+ };
2069
2189
  link: string;
2070
2190
  };
2071
2191
  OnAfterSetupMiddleware: {
@@ -2105,6 +2225,9 @@ declare class Server {
2105
2225
  };
2106
2226
  OpenBoolean: {
2107
2227
  type: string;
2228
+ cli: {
2229
+ negatedDescription: string;
2230
+ };
2108
2231
  };
2109
2232
  OpenObject: {
2110
2233
  type: string;
@@ -2159,11 +2282,15 @@ declare class Server {
2159
2282
  };
2160
2283
  minLength?: undefined;
2161
2284
  description?: undefined;
2285
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2162
2286
  }
2163
2287
  | {
2164
2288
  type: string;
2165
2289
  minLength: number;
2166
2290
  description: string;
2291
+ cli: {
2292
+ description: string;
2293
+ };
2167
2294
  additionalProperties?: undefined;
2168
2295
  properties?: undefined;
2169
2296
  }
@@ -2219,7 +2346,7 @@ declare class Server {
2219
2346
  }
2220
2347
  | {
2221
2348
  instanceof: string;
2222
- type?: undefined;
2349
+ /** @type {string} */ type?: undefined;
2223
2350
  }
2224
2351
  )[];
2225
2352
  };
@@ -2230,7 +2357,7 @@ declare class Server {
2230
2357
  };
2231
2358
  Server: {
2232
2359
  anyOf: {
2233
- $ref: string;
2360
+ $ref: string /** @type {MultiCompiler} */;
2234
2361
  }[];
2235
2362
  link: string;
2236
2363
  description: string;
@@ -2265,7 +2392,6 @@ declare class Server {
2265
2392
  };
2266
2393
  additionalProperties: boolean;
2267
2394
  };
2268
- /** @type {any} */
2269
2395
  ServerOptions: {
2270
2396
  type: string;
2271
2397
  additionalProperties: boolean;
@@ -2277,6 +2403,9 @@ declare class Server {
2277
2403
  requestCert: {
2278
2404
  type: string;
2279
2405
  description: string;
2406
+ cli: {
2407
+ negatedDescription: string;
2408
+ };
2280
2409
  };
2281
2410
  ca: {
2282
2411
  anyOf: (
@@ -2294,10 +2423,6 @@ declare class Server {
2294
2423
  }
2295
2424
  )[];
2296
2425
  };
2297
- /**
2298
- * @private
2299
- * @returns {Compiler["options"]}
2300
- */
2301
2426
  instanceof?: undefined;
2302
2427
  }
2303
2428
  | {
@@ -2506,10 +2631,14 @@ declare class Server {
2506
2631
  $ref: string;
2507
2632
  }[];
2508
2633
  };
2634
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2509
2635
  $ref?: undefined;
2510
2636
  }
2511
2637
  | {
2512
2638
  type: string;
2639
+ cli: {
2640
+ negatedDescription: string;
2641
+ };
2513
2642
  items?: undefined;
2514
2643
  $ref?: undefined;
2515
2644
  }
@@ -2517,6 +2646,7 @@ declare class Server {
2517
2646
  $ref: string;
2518
2647
  type?: undefined;
2519
2648
  items?: undefined;
2649
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2520
2650
  }
2521
2651
  )[];
2522
2652
  description: string;
@@ -2559,11 +2689,15 @@ declare class Server {
2559
2689
  anyOf: (
2560
2690
  | {
2561
2691
  type: string;
2692
+ cli: {
2693
+ negatedDescription: string;
2694
+ };
2562
2695
  additionalProperties?: undefined;
2563
2696
  }
2564
2697
  | {
2565
2698
  type: string;
2566
2699
  additionalProperties: boolean;
2700
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2567
2701
  }
2568
2702
  )[];
2569
2703
  description: string;
@@ -2573,6 +2707,9 @@ declare class Server {
2573
2707
  anyOf: (
2574
2708
  | {
2575
2709
  type: string;
2710
+ cli: {
2711
+ negatedDescription: string;
2712
+ };
2576
2713
  description?: undefined;
2577
2714
  link?: undefined;
2578
2715
  }
@@ -2580,6 +2717,7 @@ declare class Server {
2580
2717
  type: string;
2581
2718
  description: string;
2582
2719
  link: string;
2720
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2583
2721
  }
2584
2722
  )[];
2585
2723
  description: string;
@@ -2662,14 +2800,20 @@ declare class Server {
2662
2800
  anyOf: (
2663
2801
  | {
2664
2802
  enum: boolean[];
2803
+ cli: {
2804
+ negatedDescription: string;
2805
+ };
2665
2806
  $ref?: undefined;
2666
2807
  }
2667
2808
  | {
2668
2809
  $ref: string;
2669
2810
  enum?: undefined;
2811
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2670
2812
  }
2671
2813
  )[];
2672
- description: string;
2814
+ cli: {
2815
+ description: string;
2816
+ };
2673
2817
  };
2674
2818
  WebSocketServerFunction: {
2675
2819
  instanceof: string;
@@ -2706,6 +2850,7 @@ declare class Server {
2706
2850
  $ref: string;
2707
2851
  };
2708
2852
  client: {
2853
+ /** @type {any} */
2709
2854
  $ref: string;
2710
2855
  };
2711
2856
  compress: {
@@ -2754,7 +2899,7 @@ declare class Server {
2754
2899
  $ref: string;
2755
2900
  };
2756
2901
  port: {
2757
- $ref: string /** @type {Array<keyof ServerOptions>} */;
2902
+ $ref: string;
2758
2903
  };
2759
2904
  proxy: {
2760
2905
  $ref: string;
@@ -2982,7 +3127,7 @@ declare class Server {
2982
3127
  private runBonjour;
2983
3128
  /**
2984
3129
  * @private
2985
- * @type {import("bonjour").Bonjour | undefined}
3130
+ * @type {Bonjour | undefined}
2986
3131
  */
2987
3132
  private bonjour;
2988
3133
  /**
@@ -3132,10 +3277,10 @@ declare namespace Server {
3132
3277
  ClientConnection,
3133
3278
  WebSocketServer,
3134
3279
  WebSocketServerImplementation,
3135
- ProxyConfigMap,
3136
- ProxyArray,
3137
3280
  ByPass,
3281
+ ProxyConfigArrayItem,
3138
3282
  ProxyConfigArray,
3283
+ ProxyConfigMap,
3139
3284
  OpenApp,
3140
3285
  Open,
3141
3286
  NormalizedOpen,
@@ -3173,7 +3318,11 @@ type Configuration = {
3173
3318
  | import("connect-history-api-fallback").Options
3174
3319
  | undefined;
3175
3320
  setupExitSignals?: boolean | undefined;
3176
- bonjour?: boolean | import("bonjour").BonjourOptions | undefined;
3321
+ bonjour?:
3322
+ | boolean
3323
+ | Record<string, never>
3324
+ | import("bonjour-service").Service
3325
+ | undefined;
3177
3326
  watchFiles?:
3178
3327
  | string
3179
3328
  | string[]
@@ -3185,7 +3334,7 @@ type Configuration = {
3185
3334
  http2?: boolean | undefined;
3186
3335
  server?: string | ServerConfiguration | undefined;
3187
3336
  webSocketServer?: string | boolean | WebSocketServerConfiguration | undefined;
3188
- proxy?: ProxyConfigMap | ProxyConfigArray | ProxyArray | undefined;
3337
+ proxy?: ProxyConfigArrayItem | ProxyConfigMap | ProxyConfigArray | undefined;
3189
3338
  open?: string | boolean | Open | (string | Open)[] | undefined;
3190
3339
  client?: boolean | ClientConfiguration | undefined;
3191
3340
  headers?:
@@ -3241,8 +3390,8 @@ type ExpressErrorRequestHandler = import("express").ErrorRequestHandler;
3241
3390
  type WatchOptions = import("chokidar").WatchOptions;
3242
3391
  type ConnectHistoryApiFallbackOptions =
3243
3392
  import("connect-history-api-fallback").Options;
3244
- type Bonjour = import("bonjour").Bonjour;
3245
- type BonjourOptions = import("bonjour").BonjourOptions;
3393
+ type Bonjour = import("bonjour-service").Bonjour;
3394
+ type BonjourOptions = import("bonjour-service").Service;
3246
3395
  type RequestHandler = import("http-proxy-middleware").RequestHandler;
3247
3396
  type HttpProxyMiddlewareOptions = import("http-proxy-middleware").Options;
3248
3397
  type HttpProxyMiddlewareOptionsFilter = import("http-proxy-middleware").Filter;
@@ -3262,15 +3411,15 @@ type ServerOptions = import("https").ServerOptions & {
3262
3411
  };
3263
3412
  };
3264
3413
  type DevMiddlewareOptions<Request_1, Response_1> =
3265
- import("webpack-dev-middleware").Options<Request_1, Response_1>;
3414
+ import("webpack-dev-middleware").Options<Request, Response>;
3266
3415
  type DevMiddlewareContext<Request_1, Response_1> =
3267
- import("webpack-dev-middleware").Context<Request_1, Response_1>;
3416
+ import("webpack-dev-middleware").Context<Request, Response>;
3268
3417
  type WatchFiles = {
3269
3418
  paths: string | string[];
3270
3419
  options?:
3271
3420
  | (import("chokidar").WatchOptions & {
3272
3421
  aggregateTimeout?: number | undefined;
3273
- ignored?: string | RegExp | string[] | undefined;
3422
+ ignored?: WatchOptions["ignored"];
3274
3423
  poll?: number | boolean | undefined;
3275
3424
  })
3276
3425
  | undefined;
@@ -3286,7 +3435,7 @@ type Static = {
3286
3435
  | boolean
3287
3436
  | (import("chokidar").WatchOptions & {
3288
3437
  aggregateTimeout?: number | undefined;
3289
- ignored?: string | RegExp | string[] | undefined;
3438
+ ignored?: WatchOptions["ignored"];
3290
3439
  poll?: number | boolean | undefined;
3291
3440
  })
3292
3441
  | undefined;
@@ -3311,20 +3460,28 @@ type WebSocketServer =
3311
3460
  | (import("sockjs").Server & {
3312
3461
  close: import("ws").WebSocketServer["close"];
3313
3462
  });
3314
- type ProxyConfigMap = {
3315
- [url: string]: string | import("http-proxy-middleware").Options;
3316
- };
3317
- type ProxyArray = HttpProxyMiddlewareOptions[];
3318
3463
  type ByPass = (
3319
3464
  req: Request,
3320
3465
  res: Response,
3321
- proxyConfig: ProxyConfigArray
3466
+ proxyConfig: ProxyConfigArrayItem
3322
3467
  ) => any;
3323
- type ProxyConfigArray = {
3324
- path?: string | string[] | undefined;
3325
- context?: string | string[] | HttpProxyMiddlewareOptionsFilter | undefined;
3326
- } & HttpProxyMiddlewareOptions &
3327
- ByPass;
3468
+ type ProxyConfigArrayItem = {
3469
+ path?: HttpProxyMiddlewareOptionsFilter | undefined;
3470
+ context?: HttpProxyMiddlewareOptionsFilter | undefined;
3471
+ } & {
3472
+ bypass?: ByPass;
3473
+ } & HttpProxyMiddlewareOptions;
3474
+ type ProxyConfigArray = (
3475
+ | ProxyConfigArrayItem
3476
+ | ((
3477
+ req?: Request | undefined,
3478
+ res?: Response | undefined,
3479
+ next?: NextFunction | undefined
3480
+ ) => ProxyConfigArrayItem)
3481
+ )[];
3482
+ type ProxyConfigMap = {
3483
+ [url: string]: string | ProxyConfigArrayItem;
3484
+ };
3328
3485
  type OpenApp = {
3329
3486
  name?: string | undefined;
3330
3487
  arguments?: string[] | undefined;