webpack-dev-server 4.7.4 → 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.
@@ -26,12 +26,11 @@ declare class Server {
26
26
  /** @typedef {import("express").NextFunction} NextFunction */
27
27
  /** @typedef {import("express").RequestHandler} ExpressRequestHandler */
28
28
  /** @typedef {import("express").ErrorRequestHandler} ExpressErrorRequestHandler */
29
- /** @typedef {import("anymatch").Matcher} AnymatchMatcher */
30
29
  /** @typedef {import("chokidar").WatchOptions} WatchOptions */
31
30
  /** @typedef {import("chokidar").FSWatcher} FSWatcher */
32
31
  /** @typedef {import("connect-history-api-fallback").Options} ConnectHistoryApiFallbackOptions */
33
- /** @typedef {import("bonjour").Bonjour} Bonjour */
34
- /** @typedef {import("bonjour").BonjourOptions} BonjourOptions */
32
+ /** @typedef {import("bonjour-service").Bonjour} Bonjour */
33
+ /** @typedef {import("bonjour-service").Service} BonjourOptions */
35
34
  /** @typedef {import("http-proxy-middleware").RequestHandler} RequestHandler */
36
35
  /** @typedef {import("http-proxy-middleware").Options} HttpProxyMiddlewareOptions */
37
36
  /** @typedef {import("http-proxy-middleware").Filter} HttpProxyMiddlewareOptionsFilter */
@@ -60,7 +59,7 @@ declare class Server {
60
59
  /**
61
60
  * @typedef {Object} WatchFiles
62
61
  * @property {string | string[]} paths
63
- * @property {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [options]
62
+ * @property {WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [options]
64
63
  */
65
64
  /**
66
65
  * @typedef {Object} Static
@@ -68,7 +67,7 @@ declare class Server {
68
67
  * @property {string | string[]} [publicPath]
69
68
  * @property {boolean | ServeIndexOptions} [serveIndex]
70
69
  * @property {ServeStaticOptions} [staticOptions]
71
- * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [watch]
70
+ * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [watch]
72
71
  */
73
72
  /**
74
73
  * @typedef {Object} NormalizedStatic
@@ -164,7 +163,7 @@ declare class Server {
164
163
  * @property {"auto" | "all" | string | string[]} [allowedHosts]
165
164
  * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
166
165
  * @property {boolean} [setupExitSignals]
167
- * @property {boolean | BonjourOptions} [bonjour]
166
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
168
167
  * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
169
168
  * @property {boolean | string | Static | Array<string | Static>} [static]
170
169
  * @property {boolean | ServerOptions} [https]
@@ -210,13 +209,17 @@ declare class Server {
210
209
  client: {
211
210
  configs: {
212
211
  description: string;
212
+ negatedDescription: string;
213
213
  multiple: boolean;
214
- path: string /** @typedef {import("http").IncomingMessage} IncomingMessage */;
214
+ path: string;
215
215
  type: string;
216
216
  values: boolean[];
217
217
  }[];
218
- /** @typedef {import("open").Options} OpenOptions */
219
- /** @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": {
220
223
  /**
221
224
  * @template Request, Response
222
225
  * @typedef {import("webpack-dev-middleware").Options<Request, Response>} DevMiddlewareOptions
@@ -234,7 +237,7 @@ declare class Server {
234
237
  /**
235
238
  * @typedef {Object} WatchFiles
236
239
  * @property {string | string[]} paths
237
- * @property {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [options]
240
+ * @property {WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [options]
238
241
  */
239
242
  /**
240
243
  * @typedef {Object} Static
@@ -242,7 +245,7 @@ declare class Server {
242
245
  * @property {string | string[]} [publicPath]
243
246
  * @property {boolean | ServeIndexOptions} [serveIndex]
244
247
  * @property {ServeStaticOptions} [staticOptions]
245
- * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [watch]
248
+ * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [watch]
246
249
  */
247
250
  /**
248
251
  * @typedef {Object} NormalizedStatic
@@ -338,7 +341,7 @@ declare class Server {
338
341
  * @property {"auto" | "all" | string | string[]} [allowedHosts]
339
342
  * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
340
343
  * @property {boolean} [setupExitSignals]
341
- * @property {boolean | BonjourOptions} [bonjour]
344
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
342
345
  * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
343
346
  * @property {boolean | string | Static | Array<string | Static>} [static]
344
347
  * @property {boolean | ServerOptions} [https]
@@ -355,11 +358,6 @@ declare class Server {
355
358
  * @property {(devServer: Server) => void} [onListening]
356
359
  * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
357
360
  */
358
- description: string;
359
- multiple: boolean;
360
- simpleType: string;
361
- };
362
- "client-logging": {
363
361
  configs: {
364
362
  type: string;
365
363
  values: string[];
@@ -388,6 +386,7 @@ declare class Server {
388
386
  type: string;
389
387
  multiple: boolean;
390
388
  description: string;
389
+ negatedDescription: string;
391
390
  path: string;
392
391
  }[];
393
392
  description: string;
@@ -399,6 +398,7 @@ declare class Server {
399
398
  type: string;
400
399
  multiple: boolean;
401
400
  description: string;
401
+ negatedDescription: string;
402
402
  path: string;
403
403
  }[];
404
404
  description: string;
@@ -418,54 +418,41 @@ declare class Server {
418
418
  multiple: boolean;
419
419
  };
420
420
  "client-reconnect": {
421
- /**
422
- * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
423
- */
424
- /**
425
- * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
426
- */
427
- /**
428
- * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
429
- */
430
- /**
431
- * @typedef {Object} OpenApp
432
- * @property {string} [name]
433
- * @property {string[]} [arguments]
434
- */
435
- /**
436
- * @typedef {Object} Open
437
- * @property {string | string[] | OpenApp} [app]
438
- * @property {string | string[]} [target]
439
- */
440
- /**
441
- * @typedef {Object} NormalizedOpen
442
- * @property {string} target
443
- * @property {import("open").Options} options
444
- */
445
- /**
446
- * @typedef {Object} WebSocketURL
447
- * @property {string} [hostname]
448
- * @property {string} [password]
449
- * @property {string} [pathname]
450
- * @property {number | string} [port]
451
- * @property {string} [protocol]
452
- * @property {string} [username]
453
- */
454
- /**
455
- * @typedef {Object} ClientConfiguration
456
- * @property {"log" | "info" | "warn" | "error" | "none" | "verbose"} [logging]
457
- * @property {boolean | { warnings?: boolean, errors?: boolean }} [overlay]
458
- * @property {boolean} [progress]
459
- * @property {boolean | number} [reconnect]
460
- * @property {"ws" | "sockjs" | string} [webSocketTransport]
461
- * @property {string | WebSocketURL} [webSocketURL]
462
- */
463
- /**
464
- * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
465
- */
466
- /**
467
- * @typedef {{ name?: string, path?: string, middleware: ExpressRequestHandler | ExpressErrorRequestHandler } | ExpressRequestHandler | ExpressErrorRequestHandler} Middleware
468
- */
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
+ )[];
436
+ description: string;
437
+ simpleType: string;
438
+ multiple: boolean;
439
+ };
440
+ "client-web-socket-transport": {
441
+ configs: (
442
+ | {
443
+ type: string;
444
+ values: string[];
445
+ multiple: boolean;
446
+ description: string;
447
+ path: string;
448
+ }
449
+ | {
450
+ type: string;
451
+ multiple: boolean;
452
+ description: string;
453
+ path: string;
454
+ }
455
+ )[];
469
456
  /**
470
457
  * @typedef {Object} Configuration
471
458
  * @property {boolean | string} [ipc]
@@ -479,7 +466,7 @@ declare class Server {
479
466
  * @property {"auto" | "all" | string | string[]} [allowedHosts]
480
467
  * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
481
468
  * @property {boolean} [setupExitSignals]
482
- * @property {boolean | BonjourOptions} [bonjour]
469
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
483
470
  * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
484
471
  * @property {boolean | string | Static | Array<string | Static>} [static]
485
472
  * @property {boolean | ServerOptions} [https]
@@ -496,33 +483,6 @@ declare class Server {
496
483
  * @property {(devServer: Server) => void} [onListening]
497
484
  * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
498
485
  */
499
- configs: {
500
- type: string;
501
- multiple: boolean;
502
- description: string;
503
- negatedDescription: string;
504
- path: string;
505
- }[];
506
- description: string;
507
- simpleType: string;
508
- multiple: boolean;
509
- };
510
- "client-web-socket-transport": {
511
- configs: (
512
- | {
513
- type: string;
514
- values: string[];
515
- multiple: boolean;
516
- description: string;
517
- path: string;
518
- }
519
- | {
520
- type: string;
521
- multiple: boolean;
522
- description: string;
523
- path: string;
524
- }
525
- )[];
526
486
  description: string;
527
487
  simpleType: string;
528
488
  multiple: boolean;
@@ -598,12 +558,20 @@ declare class Server {
598
558
  type: string;
599
559
  }
600
560
  )[];
561
+ /**
562
+ * @private
563
+ * @type {{ name: string | symbol, listener: (...args: any[]) => void}[] }}
564
+ */
601
565
  description: string;
602
566
  multiple: boolean;
603
567
  simpleType: string;
604
568
  };
605
569
  "client-web-socket-url-username": {
606
570
  configs: {
571
+ /**
572
+ * @private
573
+ * @type {RequestHandler[]}
574
+ */
607
575
  type: string;
608
576
  multiple: boolean;
609
577
  description: string;
@@ -630,6 +598,7 @@ declare class Server {
630
598
  type: string;
631
599
  multiple: boolean;
632
600
  description: string;
601
+ negatedDescription: string;
633
602
  path: string;
634
603
  }[];
635
604
  description: string;
@@ -663,6 +632,10 @@ declare class Server {
663
632
  multiple: boolean;
664
633
  description: string;
665
634
  negatedDescription: string;
635
+ /**
636
+ * @param {"v4" | "v6"} family
637
+ * @returns {string | undefined}
638
+ */
666
639
  path: string;
667
640
  }
668
641
  | {
@@ -670,16 +643,11 @@ declare class Server {
670
643
  values: string[];
671
644
  multiple: boolean;
672
645
  description: string;
673
- negatedDescription: string;
674
646
  path: string;
675
647
  }
676
648
  )[];
677
649
  description: string;
678
650
  simpleType: string;
679
- /**
680
- * @param {"v4" | "v6"} family
681
- * @returns {string | undefined}
682
- */
683
651
  multiple: boolean;
684
652
  };
685
653
  http2: {
@@ -694,6 +662,10 @@ declare class Server {
694
662
  simpleType: string;
695
663
  multiple: boolean;
696
664
  };
665
+ /**
666
+ * @param {Port} port
667
+ * @returns {Promise<number | string>}
668
+ */
697
669
  https: {
698
670
  configs: {
699
671
  type: string;
@@ -713,6 +685,9 @@ declare class Server {
713
685
  description: string;
714
686
  path: string;
715
687
  }[];
688
+ /**
689
+ * @type {string | undefined}
690
+ */
716
691
  description: string;
717
692
  simpleType: string;
718
693
  multiple: boolean;
@@ -744,11 +719,11 @@ declare class Server {
744
719
  description: string;
745
720
  multiple: boolean;
746
721
  path: string;
747
- type: string;
722
+ /** @type {WebSocketURL} */ type: string;
748
723
  }[];
749
724
  description: string;
750
725
  multiple: boolean;
751
- simpleType: string /** @type {WebSocketURL} */;
726
+ simpleType: string;
752
727
  };
753
728
  "https-cert": {
754
729
  configs: {
@@ -871,7 +846,7 @@ declare class Server {
871
846
  }
872
847
  | {
873
848
  type: string;
874
- values: boolean[];
849
+ /** @type {Object<string,string>} */ values: boolean[];
875
850
  multiple: boolean;
876
851
  description: string;
877
852
  path: string;
@@ -950,10 +925,6 @@ declare class Server {
950
925
  "open-app-name-reset": {
951
926
  configs: {
952
927
  type: string;
953
- /**
954
- * @param {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} watchOptions
955
- * @returns {WatchOptions}
956
- */
957
928
  multiple: boolean;
958
929
  description: string;
959
930
  path: string;
@@ -991,10 +962,6 @@ declare class Server {
991
962
  description: string;
992
963
  path: string;
993
964
  }[];
994
- /**
995
- * @param {string | Static | undefined} [optionsForStatic]
996
- * @returns {NormalizedStatic}
997
- */
998
965
  description: string;
999
966
  simpleType: string;
1000
967
  multiple: boolean;
@@ -1165,6 +1132,7 @@ declare class Server {
1165
1132
  "server-options-request-cert": {
1166
1133
  configs: {
1167
1134
  description: string;
1135
+ negatedDescription: string;
1168
1136
  multiple: boolean;
1169
1137
  path: string;
1170
1138
  type: string;
@@ -1186,12 +1154,21 @@ declare class Server {
1186
1154
  simpleType: string;
1187
1155
  };
1188
1156
  static: {
1189
- configs: {
1190
- type: string;
1191
- multiple: boolean;
1192
- description: string;
1193
- path: string;
1194
- }[];
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
+ )[];
1195
1172
  description: string;
1196
1173
  simpleType: string;
1197
1174
  multiple: boolean;
@@ -1290,6 +1267,7 @@ declare class Server {
1290
1267
  configs: (
1291
1268
  | {
1292
1269
  description: string;
1270
+ negatedDescription: string;
1293
1271
  multiple: boolean;
1294
1272
  path: string;
1295
1273
  type: string;
@@ -1317,7 +1295,7 @@ declare class Server {
1317
1295
  configs: (
1318
1296
  | {
1319
1297
  description: string;
1320
- /** @type {ServerOptions & { cacert?: ServerOptions["ca"] }} */ multiple: boolean;
1298
+ multiple: boolean;
1321
1299
  path: string;
1322
1300
  type: string;
1323
1301
  values: string[];
@@ -1331,7 +1309,6 @@ declare class Server {
1331
1309
  )[];
1332
1310
  description: string;
1333
1311
  simpleType: string;
1334
- /** @type {ServerOptions & { cacert?: ServerOptions["ca"] }} */
1335
1312
  multiple: boolean;
1336
1313
  };
1337
1314
  };
@@ -1389,6 +1366,9 @@ declare class Server {
1389
1366
  anyOf: (
1390
1367
  | {
1391
1368
  type: string;
1369
+ cli: {
1370
+ negatedDescription: string;
1371
+ } /** @typedef {import("express").Request} Request */;
1392
1372
  description?: undefined;
1393
1373
  link?: undefined;
1394
1374
  }
@@ -1396,13 +1376,11 @@ declare class Server {
1396
1376
  type: string;
1397
1377
  description: string;
1398
1378
  link: string;
1379
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1399
1380
  }
1400
1381
  )[];
1401
1382
  description: string;
1402
1383
  link: string;
1403
- cli: {
1404
- negatedDescription: string;
1405
- };
1406
1384
  };
1407
1385
  Client: {
1408
1386
  description: string;
@@ -1410,6 +1388,9 @@ declare class Server {
1410
1388
  anyOf: (
1411
1389
  | {
1412
1390
  enum: boolean[];
1391
+ cli: {
1392
+ negatedDescription: string;
1393
+ };
1413
1394
  type?: undefined;
1414
1395
  additionalProperties?: undefined;
1415
1396
  properties?: undefined;
@@ -1421,18 +1402,9 @@ declare class Server {
1421
1402
  logging: {
1422
1403
  $ref: string;
1423
1404
  };
1424
- overlay: {
1425
- $ref: string;
1426
- };
1427
- progress: {
1428
- $ref: string;
1429
- };
1430
- reconnect: {
1431
- $ref: string;
1432
- };
1433
- webSocketTransport: {
1434
- $ref: string;
1435
- };
1405
+ /** @typedef {import("serve-static").ServeStaticOptions} ServeStaticOptions */
1406
+ /** @typedef {import("ipaddr.js").IPv4} IPv4 */
1407
+ /** @typedef {import("ipaddr.js").IPv6} IPv6 */
1436
1408
  /** @typedef {import("net").Socket} Socket */
1437
1409
  /** @typedef {import("http").IncomingMessage} IncomingMessage */
1438
1410
  /** @typedef {import("open").Options} OpenOptions */
@@ -1454,7 +1426,7 @@ declare class Server {
1454
1426
  /**
1455
1427
  * @typedef {Object} WatchFiles
1456
1428
  * @property {string | string[]} paths
1457
- * @property {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [options]
1429
+ * @property {WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [options]
1458
1430
  */
1459
1431
  /**
1460
1432
  * @typedef {Object} Static
@@ -1462,7 +1434,7 @@ declare class Server {
1462
1434
  * @property {string | string[]} [publicPath]
1463
1435
  * @property {boolean | ServeIndexOptions} [serveIndex]
1464
1436
  * @property {ServeStaticOptions} [staticOptions]
1465
- * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [watch]
1437
+ * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: WatchOptions["ignored"], poll?: number | boolean }} [watch]
1466
1438
  */
1467
1439
  /**
1468
1440
  * @typedef {Object} NormalizedStatic
@@ -1558,7 +1530,7 @@ declare class Server {
1558
1530
  * @property {"auto" | "all" | string | string[]} [allowedHosts]
1559
1531
  * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
1560
1532
  * @property {boolean} [setupExitSignals]
1561
- * @property {boolean | BonjourOptions} [bonjour]
1533
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
1562
1534
  * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
1563
1535
  * @property {boolean | string | Static | Array<string | Static>} [static]
1564
1536
  * @property {boolean | ServerOptions} [https]
@@ -1575,11 +1547,24 @@ declare class Server {
1575
1547
  * @property {(devServer: Server) => void} [onListening]
1576
1548
  * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
1577
1549
  */
1550
+ overlay: {
1551
+ $ref: string;
1552
+ };
1553
+ progress: {
1554
+ $ref: string;
1555
+ };
1556
+ reconnect: {
1557
+ $ref: string;
1558
+ };
1559
+ webSocketTransport: {
1560
+ $ref: string;
1561
+ };
1578
1562
  webSocketURL: {
1579
1563
  $ref: string;
1580
1564
  };
1581
1565
  };
1582
1566
  enum?: undefined;
1567
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1583
1568
  }
1584
1569
  )[];
1585
1570
  };
@@ -1592,140 +1577,6 @@ declare class Server {
1592
1577
  anyOf: (
1593
1578
  | {
1594
1579
  description: string;
1595
- /**
1596
- * @template Request, Response
1597
- * @typedef {import("webpack-dev-middleware").Context<Request, Response>} DevMiddlewareContext
1598
- */
1599
- /**
1600
- * @typedef {"local-ip" | "local-ipv4" | "local-ipv6" | string} Host
1601
- */
1602
- /**
1603
- * @typedef {number | string | "auto"} Port
1604
- */
1605
- /**
1606
- * @typedef {Object} WatchFiles
1607
- * @property {string | string[]} paths
1608
- * @property {WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [options]
1609
- */
1610
- /**
1611
- * @typedef {Object} Static
1612
- * @property {string} [directory]
1613
- * @property {string | string[]} [publicPath]
1614
- * @property {boolean | ServeIndexOptions} [serveIndex]
1615
- * @property {ServeStaticOptions} [staticOptions]
1616
- * @property {boolean | WatchOptions & { aggregateTimeout?: number, ignored?: AnymatchMatcher | string[], poll?: number | boolean }} [watch]
1617
- */
1618
- /**
1619
- * @typedef {Object} NormalizedStatic
1620
- * @property {string} directory
1621
- * @property {string[]} publicPath
1622
- * @property {false | ServeIndexOptions} serveIndex
1623
- * @property {ServeStaticOptions} staticOptions
1624
- * @property {false | WatchOptions} watch
1625
- */
1626
- /**
1627
- * @typedef {Object} ServerConfiguration
1628
- * @property {"http" | "https" | "spdy" | string} [type]
1629
- * @property {ServerOptions} [options]
1630
- */
1631
- /**
1632
- * @typedef {Object} WebSocketServerConfiguration
1633
- * @property {"sockjs" | "ws" | string | Function} [type]
1634
- * @property {Record<string, any>} [options]
1635
- */
1636
- /**
1637
- * @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
1638
- */
1639
- /**
1640
- * @typedef {import("ws").WebSocketServer | import("sockjs").Server & { close: import("ws").WebSocketServer["close"] }} WebSocketServer
1641
- */
1642
- /**
1643
- * @typedef {{ implementation: WebSocketServer, clients: ClientConnection[] }} WebSocketServerImplementation
1644
- */
1645
- /**
1646
- * @callback ByPass
1647
- * @param {Request} req
1648
- * @param {Response} res
1649
- * @param {ProxyConfigArrayItem} proxyConfig
1650
- */
1651
- /**
1652
- * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
1653
- */
1654
- /**
1655
- * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
1656
- */
1657
- /**
1658
- * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
1659
- */
1660
- /**
1661
- * @typedef {Object} OpenApp
1662
- * @property {string} [name]
1663
- * @property {string[]} [arguments]
1664
- */
1665
- /**
1666
- * @typedef {Object} Open
1667
- * @property {string | string[] | OpenApp} [app]
1668
- * @property {string | string[]} [target]
1669
- */
1670
- /**
1671
- * @typedef {Object} NormalizedOpen
1672
- * @property {string} target
1673
- * @property {import("open").Options} options
1674
- */
1675
- /**
1676
- * @typedef {Object} WebSocketURL
1677
- * @property {string} [hostname]
1678
- * @property {string} [password]
1679
- * @property {string} [pathname]
1680
- * @property {number | string} [port]
1681
- * @property {string} [protocol]
1682
- * @property {string} [username]
1683
- */
1684
- /**
1685
- * @typedef {Object} ClientConfiguration
1686
- * @property {"log" | "info" | "warn" | "error" | "none" | "verbose"} [logging]
1687
- * @property {boolean | { warnings?: boolean, errors?: boolean }} [overlay]
1688
- * @property {boolean} [progress]
1689
- * @property {boolean | number} [reconnect]
1690
- * @property {"ws" | "sockjs" | string} [webSocketTransport]
1691
- * @property {string | WebSocketURL} [webSocketURL]
1692
- */
1693
- /**
1694
- * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
1695
- */
1696
- /**
1697
- * @typedef {{ name?: string, path?: string, middleware: ExpressRequestHandler | ExpressErrorRequestHandler } | ExpressRequestHandler | ExpressErrorRequestHandler} Middleware
1698
- */
1699
- /**
1700
- * @typedef {Object} Configuration
1701
- * @property {boolean | string} [ipc]
1702
- * @property {Host} [host]
1703
- * @property {Port} [port]
1704
- * @property {boolean | "only"} [hot]
1705
- * @property {boolean} [liveReload]
1706
- * @property {DevMiddlewareOptions<Request, Response>} [devMiddleware]
1707
- * @property {boolean} [compress]
1708
- * @property {boolean} [magicHtml]
1709
- * @property {"auto" | "all" | string | string[]} [allowedHosts]
1710
- * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
1711
- * @property {boolean} [setupExitSignals]
1712
- * @property {boolean | BonjourOptions} [bonjour]
1713
- * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
1714
- * @property {boolean | string | Static | Array<string | Static>} [static]
1715
- * @property {boolean | ServerOptions} [https]
1716
- * @property {boolean} [http2]
1717
- * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
1718
- * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
1719
- * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
1720
- * @property {boolean | string | Open | Array<string | Open>} [open]
1721
- * @property {boolean} [setupExitSignals]
1722
- * @property {boolean | ClientConfiguration} [client]
1723
- * @property {Headers | ((req: Request, res: Response, context: DevMiddlewareContext<Request, Response>) => Headers)} [headers]
1724
- * @property {(devServer: Server) => void} [onAfterSetupMiddleware]
1725
- * @property {(devServer: Server) => void} [onBeforeSetupMiddleware]
1726
- * @property {(devServer: Server) => void} [onListening]
1727
- * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
1728
- */
1729
1580
  link: string;
1730
1581
  type: string;
1731
1582
  cli: {
@@ -1741,15 +1592,21 @@ declare class Server {
1741
1592
  errors: {
1742
1593
  description: string;
1743
1594
  type: string;
1595
+ cli: {
1596
+ negatedDescription: string;
1597
+ };
1744
1598
  };
1745
1599
  warnings: {
1746
1600
  description: string;
1747
1601
  type: string;
1602
+ cli: {
1603
+ negatedDescription: string;
1604
+ };
1748
1605
  };
1749
1606
  };
1750
1607
  description?: undefined;
1751
1608
  link?: undefined;
1752
- cli?: undefined;
1609
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1753
1610
  }
1754
1611
  )[];
1755
1612
  };
@@ -1764,19 +1621,104 @@ declare class Server {
1764
1621
  ClientReconnect: {
1765
1622
  description: string;
1766
1623
  link: string;
1624
+ /**
1625
+ * @callback ByPass
1626
+ * @param {Request} req
1627
+ * @param {Response} res
1628
+ * @param {ProxyConfigArrayItem} proxyConfig
1629
+ */
1630
+ /**
1631
+ * @typedef {{ path?: HttpProxyMiddlewareOptionsFilter | undefined, context?: HttpProxyMiddlewareOptionsFilter | undefined } & { bypass?: ByPass } & HttpProxyMiddlewareOptions } ProxyConfigArrayItem
1632
+ */
1633
+ /**
1634
+ * @typedef {(ProxyConfigArrayItem | ((req?: Request | undefined, res?: Response | undefined, next?: NextFunction | undefined) => ProxyConfigArrayItem))[]} ProxyConfigArray
1635
+ */
1636
+ /**
1637
+ * @typedef {{ [url: string]: string | ProxyConfigArrayItem }} ProxyConfigMap
1638
+ */
1639
+ /**
1640
+ * @typedef {Object} OpenApp
1641
+ * @property {string} [name]
1642
+ * @property {string[]} [arguments]
1643
+ */
1644
+ /**
1645
+ * @typedef {Object} Open
1646
+ * @property {string | string[] | OpenApp} [app]
1647
+ * @property {string | string[]} [target]
1648
+ */
1649
+ /**
1650
+ * @typedef {Object} NormalizedOpen
1651
+ * @property {string} target
1652
+ * @property {import("open").Options} options
1653
+ */
1654
+ /**
1655
+ * @typedef {Object} WebSocketURL
1656
+ * @property {string} [hostname]
1657
+ * @property {string} [password]
1658
+ * @property {string} [pathname]
1659
+ * @property {number | string} [port]
1660
+ * @property {string} [protocol]
1661
+ * @property {string} [username]
1662
+ */
1663
+ /**
1664
+ * @typedef {Object} ClientConfiguration
1665
+ * @property {"log" | "info" | "warn" | "error" | "none" | "verbose"} [logging]
1666
+ * @property {boolean | { warnings?: boolean, errors?: boolean }} [overlay]
1667
+ * @property {boolean} [progress]
1668
+ * @property {boolean | number} [reconnect]
1669
+ * @property {"ws" | "sockjs" | string} [webSocketTransport]
1670
+ * @property {string | WebSocketURL} [webSocketURL]
1671
+ */
1672
+ /**
1673
+ * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
1674
+ */
1675
+ /**
1676
+ * @typedef {{ name?: string, path?: string, middleware: ExpressRequestHandler | ExpressErrorRequestHandler } | ExpressRequestHandler | ExpressErrorRequestHandler} Middleware
1677
+ */
1678
+ /**
1679
+ * @typedef {Object} Configuration
1680
+ * @property {boolean | string} [ipc]
1681
+ * @property {Host} [host]
1682
+ * @property {Port} [port]
1683
+ * @property {boolean | "only"} [hot]
1684
+ * @property {boolean} [liveReload]
1685
+ * @property {DevMiddlewareOptions<Request, Response>} [devMiddleware]
1686
+ * @property {boolean} [compress]
1687
+ * @property {boolean} [magicHtml]
1688
+ * @property {"auto" | "all" | string | string[]} [allowedHosts]
1689
+ * @property {boolean | ConnectHistoryApiFallbackOptions} [historyApiFallback]
1690
+ * @property {boolean} [setupExitSignals]
1691
+ * @property {boolean | Record<string, never> | BonjourOptions} [bonjour]
1692
+ * @property {string | string[] | WatchFiles | Array<string | WatchFiles>} [watchFiles]
1693
+ * @property {boolean | string | Static | Array<string | Static>} [static]
1694
+ * @property {boolean | ServerOptions} [https]
1695
+ * @property {boolean} [http2]
1696
+ * @property {"http" | "https" | "spdy" | string | ServerConfiguration} [server]
1697
+ * @property {boolean | "sockjs" | "ws" | string | WebSocketServerConfiguration} [webSocketServer]
1698
+ * @property {ProxyConfigMap | ProxyConfigArrayItem | ProxyConfigArray} [proxy]
1699
+ * @property {boolean | string | Open | Array<string | Open>} [open]
1700
+ * @property {boolean} [setupExitSignals]
1701
+ * @property {boolean | ClientConfiguration} [client]
1702
+ * @property {Headers | ((req: Request, res: Response, context: DevMiddlewareContext<Request, Response>) => Headers)} [headers]
1703
+ * @property {(devServer: Server) => void} [onAfterSetupMiddleware]
1704
+ * @property {(devServer: Server) => void} [onBeforeSetupMiddleware]
1705
+ * @property {(devServer: Server) => void} [onListening]
1706
+ * @property {(middlewares: Middleware[], devServer: Server) => Middleware[]} [setupMiddlewares]
1707
+ */
1767
1708
  anyOf: (
1768
1709
  | {
1769
1710
  type: string;
1711
+ cli: {
1712
+ negatedDescription: string;
1713
+ };
1770
1714
  minimum?: undefined;
1771
1715
  }
1772
1716
  | {
1773
1717
  type: string;
1774
1718
  minimum: number;
1719
+ cli?: undefined /** @typedef {import("express").Request} Request */;
1775
1720
  }
1776
1721
  )[];
1777
- cli: {
1778
- negatedDescription: string;
1779
- };
1780
1722
  };
1781
1723
  ClientWebSocketTransport: {
1782
1724
  anyOf: {
@@ -1815,6 +1757,9 @@ declare class Server {
1815
1757
  description: string;
1816
1758
  type: string;
1817
1759
  };
1760
+ /**
1761
+ * @typedef {Array<{ key: string; value: string }> | Record<string, string | string[]>} Headers
1762
+ */
1818
1763
  password: {
1819
1764
  description: string;
1820
1765
  type: string;
@@ -1928,15 +1873,16 @@ declare class Server {
1928
1873
  }
1929
1874
  | {
1930
1875
  instanceof: string;
1876
+ /**
1877
+ * @private
1878
+ * @type {RequestHandler[]}
1879
+ */
1931
1880
  type?: undefined;
1932
1881
  items?: undefined;
1933
1882
  }
1934
1883
  )[];
1935
1884
  description: string;
1936
1885
  };
1937
- /**
1938
- * @type {FSWatcher[]}
1939
- */
1940
1886
  cacert: {
1941
1887
  anyOf: (
1942
1888
  | {
@@ -2107,13 +2053,10 @@ declare class Server {
2107
2053
  description: string;
2108
2054
  };
2109
2055
  };
2110
- cli?: undefined;
2056
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2111
2057
  }
2112
2058
  )[];
2113
2059
  description: string;
2114
- /**
2115
- * @type {string | undefined}
2116
- */
2117
2060
  link: string;
2118
2061
  };
2119
2062
  HeaderObject: {
@@ -2159,13 +2102,13 @@ declare class Server {
2159
2102
  description: string;
2160
2103
  link: string;
2161
2104
  };
2162
- /**
2163
- * @type {string[]}
2164
- */
2165
2105
  HistoryApiFallback: {
2166
2106
  anyOf: (
2167
2107
  | {
2168
2108
  type: string;
2109
+ cli: {
2110
+ negatedDescription: string;
2111
+ };
2169
2112
  description?: undefined;
2170
2113
  link?: undefined;
2171
2114
  }
@@ -2173,10 +2116,11 @@ declare class Server {
2173
2116
  type: string;
2174
2117
  description: string;
2175
2118
  link: string;
2119
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2176
2120
  }
2177
2121
  )[];
2178
2122
  description: string;
2179
- link: string;
2123
+ /** @type {string} */ link: string;
2180
2124
  };
2181
2125
  Host: {
2182
2126
  description: string;
@@ -2198,24 +2142,25 @@ declare class Server {
2198
2142
  anyOf: (
2199
2143
  | {
2200
2144
  type: string;
2145
+ cli: {
2146
+ negatedDescription: string;
2147
+ };
2201
2148
  enum?: undefined;
2202
2149
  }
2203
2150
  | {
2204
2151
  enum: string[];
2205
2152
  type?: undefined;
2153
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2206
2154
  }
2207
2155
  )[];
2208
2156
  description: string;
2209
2157
  link: string;
2210
- cli: {
2211
- negatedDescription: string;
2212
- };
2213
2158
  };
2214
2159
  IPC: {
2215
2160
  anyOf: (
2216
2161
  | {
2217
2162
  type: string;
2218
- /** @type {ServerConfiguration} */ minLength: number;
2163
+ minLength: number;
2219
2164
  enum?: undefined;
2220
2165
  }
2221
2166
  | {
@@ -2337,7 +2282,7 @@ declare class Server {
2337
2282
  };
2338
2283
  minLength?: undefined;
2339
2284
  description?: undefined;
2340
- cli?: undefined;
2285
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2341
2286
  }
2342
2287
  | {
2343
2288
  type: string;
@@ -2401,7 +2346,7 @@ declare class Server {
2401
2346
  }
2402
2347
  | {
2403
2348
  instanceof: string;
2404
- type?: undefined;
2349
+ /** @type {string} */ type?: undefined;
2405
2350
  }
2406
2351
  )[];
2407
2352
  };
@@ -2412,14 +2357,10 @@ declare class Server {
2412
2357
  };
2413
2358
  Server: {
2414
2359
  anyOf: {
2415
- $ref: string;
2360
+ $ref: string /** @type {MultiCompiler} */;
2416
2361
  }[];
2417
2362
  link: string;
2418
2363
  description: string;
2419
- /**
2420
- * @private
2421
- * @returns {Compiler["options"]}
2422
- */
2423
2364
  };
2424
2365
  ServerType: {
2425
2366
  enum: string[];
@@ -2434,8 +2375,8 @@ declare class Server {
2434
2375
  type: string;
2435
2376
  minLength: number;
2436
2377
  cli: {
2437
- exclude: boolean /** @type {MultiCompiler} */;
2438
- } /** @type {MultiCompiler} */;
2378
+ exclude: boolean;
2379
+ };
2439
2380
  };
2440
2381
  ServerObject: {
2441
2382
  type: string;
@@ -2453,7 +2394,7 @@ declare class Server {
2453
2394
  };
2454
2395
  ServerOptions: {
2455
2396
  type: string;
2456
- /** @type {MultiCompiler} */ additionalProperties: boolean;
2397
+ additionalProperties: boolean;
2457
2398
  properties: {
2458
2399
  passphrase: {
2459
2400
  type: string;
@@ -2462,6 +2403,9 @@ declare class Server {
2462
2403
  requestCert: {
2463
2404
  type: string;
2464
2405
  description: string;
2406
+ cli: {
2407
+ negatedDescription: string;
2408
+ };
2465
2409
  };
2466
2410
  ca: {
2467
2411
  anyOf: (
@@ -2687,10 +2631,14 @@ declare class Server {
2687
2631
  $ref: string;
2688
2632
  }[];
2689
2633
  };
2634
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2690
2635
  $ref?: undefined;
2691
2636
  }
2692
2637
  | {
2693
2638
  type: string;
2639
+ cli: {
2640
+ negatedDescription: string;
2641
+ };
2694
2642
  items?: undefined;
2695
2643
  $ref?: undefined;
2696
2644
  }
@@ -2698,6 +2646,7 @@ declare class Server {
2698
2646
  $ref: string;
2699
2647
  type?: undefined;
2700
2648
  items?: undefined;
2649
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2701
2650
  }
2702
2651
  )[];
2703
2652
  description: string;
@@ -2740,23 +2689,27 @@ declare class Server {
2740
2689
  anyOf: (
2741
2690
  | {
2742
2691
  type: string;
2692
+ cli: {
2693
+ negatedDescription: string;
2694
+ };
2743
2695
  additionalProperties?: undefined;
2744
2696
  }
2745
2697
  | {
2746
2698
  type: string;
2747
2699
  additionalProperties: boolean;
2700
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2748
2701
  }
2749
2702
  )[];
2750
2703
  description: string;
2751
- cli: {
2752
- negatedDescription: string;
2753
- };
2754
2704
  link: string;
2755
2705
  };
2756
2706
  watch: {
2757
2707
  anyOf: (
2758
2708
  | {
2759
2709
  type: string;
2710
+ cli: {
2711
+ negatedDescription: string;
2712
+ };
2760
2713
  description?: undefined;
2761
2714
  link?: undefined;
2762
2715
  }
@@ -2764,12 +2717,10 @@ declare class Server {
2764
2717
  type: string;
2765
2718
  description: string;
2766
2719
  link: string;
2720
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2767
2721
  }
2768
2722
  )[];
2769
2723
  description: string;
2770
- cli: {
2771
- negatedDescription: string;
2772
- };
2773
2724
  link: string;
2774
2725
  };
2775
2726
  };
@@ -2849,14 +2800,17 @@ declare class Server {
2849
2800
  anyOf: (
2850
2801
  | {
2851
2802
  enum: boolean[];
2803
+ cli: {
2804
+ negatedDescription: string;
2805
+ };
2852
2806
  $ref?: undefined;
2853
2807
  }
2854
2808
  | {
2855
2809
  $ref: string;
2856
2810
  enum?: undefined;
2811
+ cli?: undefined /** @typedef {import("express").Request} Request */;
2857
2812
  }
2858
2813
  )[];
2859
- /** @type {ServerOptions} */
2860
2814
  cli: {
2861
2815
  description: string;
2862
2816
  };
@@ -2896,6 +2850,7 @@ declare class Server {
2896
2850
  $ref: string;
2897
2851
  };
2898
2852
  client: {
2853
+ /** @type {any} */
2899
2854
  $ref: string;
2900
2855
  };
2901
2856
  compress: {
@@ -3172,7 +3127,7 @@ declare class Server {
3172
3127
  private runBonjour;
3173
3128
  /**
3174
3129
  * @private
3175
- * @type {import("bonjour").Bonjour | undefined}
3130
+ * @type {Bonjour | undefined}
3176
3131
  */
3177
3132
  private bonjour;
3178
3133
  /**
@@ -3294,7 +3249,6 @@ declare namespace Server {
3294
3249
  NextFunction,
3295
3250
  ExpressRequestHandler,
3296
3251
  ExpressErrorRequestHandler,
3297
- AnymatchMatcher,
3298
3252
  WatchOptions,
3299
3253
  FSWatcher,
3300
3254
  ConnectHistoryApiFallbackOptions,
@@ -3364,7 +3318,11 @@ type Configuration = {
3364
3318
  | import("connect-history-api-fallback").Options
3365
3319
  | undefined;
3366
3320
  setupExitSignals?: boolean | undefined;
3367
- bonjour?: boolean | import("bonjour").BonjourOptions | undefined;
3321
+ bonjour?:
3322
+ | boolean
3323
+ | Record<string, never>
3324
+ | import("bonjour-service").Service
3325
+ | undefined;
3368
3326
  watchFiles?:
3369
3327
  | string
3370
3328
  | string[]
@@ -3429,12 +3387,11 @@ type Response = import("express").Response;
3429
3387
  type NextFunction = import("express").NextFunction;
3430
3388
  type ExpressRequestHandler = import("express").RequestHandler;
3431
3389
  type ExpressErrorRequestHandler = import("express").ErrorRequestHandler;
3432
- type AnymatchMatcher = import("anymatch").Matcher;
3433
3390
  type WatchOptions = import("chokidar").WatchOptions;
3434
3391
  type ConnectHistoryApiFallbackOptions =
3435
3392
  import("connect-history-api-fallback").Options;
3436
- type Bonjour = import("bonjour").Bonjour;
3437
- type BonjourOptions = import("bonjour").BonjourOptions;
3393
+ type Bonjour = import("bonjour-service").Bonjour;
3394
+ type BonjourOptions = import("bonjour-service").Service;
3438
3395
  type RequestHandler = import("http-proxy-middleware").RequestHandler;
3439
3396
  type HttpProxyMiddlewareOptions = import("http-proxy-middleware").Options;
3440
3397
  type HttpProxyMiddlewareOptionsFilter = import("http-proxy-middleware").Filter;
@@ -3454,15 +3411,15 @@ type ServerOptions = import("https").ServerOptions & {
3454
3411
  };
3455
3412
  };
3456
3413
  type DevMiddlewareOptions<Request_1, Response_1> =
3457
- import("webpack-dev-middleware").Options<Request_1, Response_1>;
3414
+ import("webpack-dev-middleware").Options<Request, Response>;
3458
3415
  type DevMiddlewareContext<Request_1, Response_1> =
3459
- import("webpack-dev-middleware").Context<Request_1, Response_1>;
3416
+ import("webpack-dev-middleware").Context<Request, Response>;
3460
3417
  type WatchFiles = {
3461
3418
  paths: string | string[];
3462
3419
  options?:
3463
3420
  | (import("chokidar").WatchOptions & {
3464
3421
  aggregateTimeout?: number | undefined;
3465
- ignored?: string[] | import("anymatch").Matcher | undefined;
3422
+ ignored?: WatchOptions["ignored"];
3466
3423
  poll?: number | boolean | undefined;
3467
3424
  })
3468
3425
  | undefined;
@@ -3478,7 +3435,7 @@ type Static = {
3478
3435
  | boolean
3479
3436
  | (import("chokidar").WatchOptions & {
3480
3437
  aggregateTimeout?: number | undefined;
3481
- ignored?: string[] | import("anymatch").Matcher | undefined;
3438
+ ignored?: WatchOptions["ignored"];
3482
3439
  poll?: number | boolean | undefined;
3483
3440
  })
3484
3441
  | undefined;