cli-flags.js 39 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277
  1. "use strict";
  2. module.exports = {
  3. "allowed-hosts": {
  4. configs: [
  5. {
  6. type: "string",
  7. multiple: true,
  8. description:
  9. "Allows to enumerate the hosts from which access to the dev server are allowed (useful when you are proxying dev server, by default is 'auto').",
  10. path: "allowedHosts[]",
  11. },
  12. {
  13. description:
  14. "Allows to enumerate the hosts from which access to the dev server are allowed (useful when you are proxying dev server, by default is 'auto').",
  15. multiple: false,
  16. path: "allowedHosts",
  17. type: "enum",
  18. values: ["auto", "all"],
  19. },
  20. ],
  21. description:
  22. "Allows to enumerate the hosts from which access to the dev server are allowed (useful when you are proxying dev server, by default is 'auto').",
  23. multiple: true,
  24. simpleType: "string",
  25. },
  26. "allowed-hosts-reset": {
  27. configs: [
  28. {
  29. type: "reset",
  30. multiple: false,
  31. description:
  32. "Clear all items provided in 'allowedHosts' configuration. Allows to enumerate the hosts from which access to the dev server are allowed (useful when you are proxying dev server, by default is 'auto').",
  33. path: "allowedHosts",
  34. },
  35. ],
  36. description:
  37. "Clear all items provided in 'allowedHosts' configuration. Allows to enumerate the hosts from which access to the dev server are allowed (useful when you are proxying dev server, by default is 'auto').",
  38. simpleType: "boolean",
  39. multiple: false,
  40. },
  41. bonjour: {
  42. configs: [
  43. {
  44. type: "boolean",
  45. multiple: false,
  46. description:
  47. "Allows to broadcasts dev server via ZeroConf networking on start.",
  48. negatedDescription:
  49. "Disallows to broadcasts dev server via ZeroConf networking on start.",
  50. path: "bonjour",
  51. },
  52. ],
  53. description:
  54. "Allows to broadcasts dev server via ZeroConf networking on start.",
  55. simpleType: "boolean",
  56. multiple: false,
  57. },
  58. client: {
  59. configs: [
  60. {
  61. description:
  62. "Allows to specify options for client script in the browser or disable client script.",
  63. negatedDescription: "Disables client script.",
  64. multiple: false,
  65. path: "client",
  66. type: "enum",
  67. values: [false],
  68. },
  69. ],
  70. description:
  71. "Allows to specify options for client script in the browser or disable client script.",
  72. multiple: false,
  73. simpleType: "boolean",
  74. },
  75. "client-logging": {
  76. configs: [
  77. {
  78. type: "enum",
  79. values: ["none", "error", "warn", "info", "log", "verbose"],
  80. multiple: false,
  81. description: "Allows to set log level in the browser.",
  82. path: "client.logging",
  83. },
  84. ],
  85. description: "Allows to set log level in the browser.",
  86. simpleType: "string",
  87. multiple: false,
  88. },
  89. "client-overlay": {
  90. configs: [
  91. {
  92. type: "boolean",
  93. multiple: false,
  94. description:
  95. "Enables a full-screen overlay in the browser when there are compiler errors or warnings.",
  96. negatedDescription:
  97. "Disables the full-screen overlay in the browser when there are compiler errors or warnings.",
  98. path: "client.overlay",
  99. },
  100. ],
  101. description:
  102. "Enables a full-screen overlay in the browser when there are compiler errors or warnings.",
  103. simpleType: "boolean",
  104. multiple: false,
  105. },
  106. "client-overlay-errors": {
  107. configs: [
  108. {
  109. type: "boolean",
  110. multiple: false,
  111. description:
  112. "Enables a full-screen overlay in the browser when there are compiler errors.",
  113. negatedDescription:
  114. "Disables the full-screen overlay in the browser when there are compiler errors.",
  115. path: "client.overlay.errors",
  116. },
  117. ],
  118. description:
  119. "Enables a full-screen overlay in the browser when there are compiler errors.",
  120. simpleType: "boolean",
  121. multiple: false,
  122. },
  123. "client-overlay-trusted-types-policy-name": {
  124. configs: [
  125. {
  126. description:
  127. "The name of a Trusted Types policy for the overlay. Defaults to 'webpack-dev-server#overlay'.",
  128. multiple: false,
  129. path: "client.overlay.trustedTypesPolicyName",
  130. type: "string",
  131. },
  132. ],
  133. description:
  134. "The name of a Trusted Types policy for the overlay. Defaults to 'webpack-dev-server#overlay'.",
  135. multiple: false,
  136. simpleType: "string",
  137. },
  138. "client-overlay-warnings": {
  139. configs: [
  140. {
  141. type: "boolean",
  142. multiple: false,
  143. description:
  144. "Enables a full-screen overlay in the browser when there are compiler warnings.",
  145. negatedDescription:
  146. "Disables the full-screen overlay in the browser when there are compiler warnings.",
  147. path: "client.overlay.warnings",
  148. },
  149. ],
  150. description:
  151. "Enables a full-screen overlay in the browser when there are compiler warnings.",
  152. simpleType: "boolean",
  153. multiple: false,
  154. },
  155. "client-progress": {
  156. configs: [
  157. {
  158. type: "boolean",
  159. multiple: false,
  160. description:
  161. "Prints compilation progress in percentage in the browser.",
  162. negatedDescription:
  163. "Does not print compilation progress in percentage in the browser.",
  164. path: "client.progress",
  165. },
  166. ],
  167. description: "Prints compilation progress in percentage in the browser.",
  168. simpleType: "boolean",
  169. multiple: false,
  170. },
  171. "client-reconnect": {
  172. configs: [
  173. {
  174. type: "boolean",
  175. multiple: false,
  176. description:
  177. "Tells dev-server the number of times it should try to reconnect the client.",
  178. negatedDescription:
  179. "Tells dev-server to not to try to reconnect the client.",
  180. path: "client.reconnect",
  181. },
  182. {
  183. type: "number",
  184. multiple: false,
  185. description:
  186. "Tells dev-server the number of times it should try to reconnect the client.",
  187. path: "client.reconnect",
  188. },
  189. ],
  190. description:
  191. "Tells dev-server the number of times it should try to reconnect the client.",
  192. simpleType: "string",
  193. multiple: false,
  194. },
  195. "client-web-socket-transport": {
  196. configs: [
  197. {
  198. type: "enum",
  199. values: ["sockjs", "ws"],
  200. multiple: false,
  201. description:
  202. "Allows to set custom web socket transport to communicate with dev server.",
  203. path: "client.webSocketTransport",
  204. },
  205. {
  206. type: "string",
  207. multiple: false,
  208. description:
  209. "Allows to set custom web socket transport to communicate with dev server.",
  210. path: "client.webSocketTransport",
  211. },
  212. ],
  213. description:
  214. "Allows to set custom web socket transport to communicate with dev server.",
  215. simpleType: "string",
  216. multiple: false,
  217. },
  218. "client-web-socket-url": {
  219. configs: [
  220. {
  221. type: "string",
  222. multiple: false,
  223. description:
  224. "Allows to specify URL to web socket server (useful when you're proxying dev server and client script does not always know where to connect to).",
  225. path: "client.webSocketURL",
  226. },
  227. ],
  228. description:
  229. "Allows to specify URL to web socket server (useful when you're proxying dev server and client script does not always know where to connect to).",
  230. simpleType: "string",
  231. multiple: false,
  232. },
  233. "client-web-socket-url-hostname": {
  234. configs: [
  235. {
  236. type: "string",
  237. multiple: false,
  238. description:
  239. "Tells clients connected to devServer to use the provided hostname.",
  240. path: "client.webSocketURL.hostname",
  241. },
  242. ],
  243. description:
  244. "Tells clients connected to devServer to use the provided hostname.",
  245. simpleType: "string",
  246. multiple: false,
  247. },
  248. "client-web-socket-url-password": {
  249. configs: [
  250. {
  251. type: "string",
  252. multiple: false,
  253. description:
  254. "Tells clients connected to devServer to use the provided password to authenticate.",
  255. path: "client.webSocketURL.password",
  256. },
  257. ],
  258. description:
  259. "Tells clients connected to devServer to use the provided password to authenticate.",
  260. simpleType: "string",
  261. multiple: false,
  262. },
  263. "client-web-socket-url-pathname": {
  264. configs: [
  265. {
  266. type: "string",
  267. multiple: false,
  268. description:
  269. "Tells clients connected to devServer to use the provided path to connect.",
  270. path: "client.webSocketURL.pathname",
  271. },
  272. ],
  273. description:
  274. "Tells clients connected to devServer to use the provided path to connect.",
  275. simpleType: "string",
  276. multiple: false,
  277. },
  278. "client-web-socket-url-port": {
  279. configs: [
  280. {
  281. type: "number",
  282. multiple: false,
  283. description:
  284. "Tells clients connected to devServer to use the provided port.",
  285. path: "client.webSocketURL.port",
  286. },
  287. {
  288. description:
  289. "Tells clients connected to devServer to use the provided port.",
  290. multiple: false,
  291. path: "client.webSocketURL.port",
  292. type: "string",
  293. },
  294. ],
  295. description:
  296. "Tells clients connected to devServer to use the provided port.",
  297. simpleType: "string",
  298. multiple: false,
  299. },
  300. "client-web-socket-url-protocol": {
  301. configs: [
  302. {
  303. description:
  304. "Tells clients connected to devServer to use the provided protocol.",
  305. multiple: false,
  306. path: "client.webSocketURL.protocol",
  307. type: "enum",
  308. values: ["auto"],
  309. },
  310. {
  311. description:
  312. "Tells clients connected to devServer to use the provided protocol.",
  313. multiple: false,
  314. path: "client.webSocketURL.protocol",
  315. type: "string",
  316. },
  317. ],
  318. description:
  319. "Tells clients connected to devServer to use the provided protocol.",
  320. multiple: false,
  321. simpleType: "string",
  322. },
  323. "client-web-socket-url-username": {
  324. configs: [
  325. {
  326. type: "string",
  327. multiple: false,
  328. description:
  329. "Tells clients connected to devServer to use the provided username to authenticate.",
  330. path: "client.webSocketURL.username",
  331. },
  332. ],
  333. description:
  334. "Tells clients connected to devServer to use the provided username to authenticate.",
  335. simpleType: "string",
  336. multiple: false,
  337. },
  338. compress: {
  339. configs: [
  340. {
  341. type: "boolean",
  342. multiple: false,
  343. description: "Enables gzip compression for everything served.",
  344. negatedDescription: "Disables gzip compression for everything served.",
  345. path: "compress",
  346. },
  347. ],
  348. description: "Enables gzip compression for everything served.",
  349. simpleType: "boolean",
  350. multiple: false,
  351. },
  352. "history-api-fallback": {
  353. configs: [
  354. {
  355. type: "boolean",
  356. multiple: false,
  357. description:
  358. "Allows to proxy requests through a specified index page (by default 'index.html'), useful for Single Page Applications that utilise the HTML5 History API.",
  359. negatedDescription:
  360. "Disallows to proxy requests through a specified index page.",
  361. path: "historyApiFallback",
  362. },
  363. ],
  364. description:
  365. "Allows to proxy requests through a specified index page (by default 'index.html'), useful for Single Page Applications that utilise the HTML5 History API.",
  366. simpleType: "boolean",
  367. multiple: false,
  368. },
  369. host: {
  370. configs: [
  371. {
  372. description: "Allows to specify a hostname to use.",
  373. multiple: false,
  374. path: "host",
  375. type: "enum",
  376. values: ["local-ip", "local-ipv4", "local-ipv6"],
  377. },
  378. {
  379. description: "Allows to specify a hostname to use.",
  380. multiple: false,
  381. path: "host",
  382. type: "string",
  383. },
  384. ],
  385. description: "Allows to specify a hostname to use.",
  386. simpleType: "string",
  387. multiple: false,
  388. },
  389. hot: {
  390. configs: [
  391. {
  392. type: "boolean",
  393. multiple: false,
  394. description: "Enables Hot Module Replacement.",
  395. negatedDescription: "Disables Hot Module Replacement.",
  396. path: "hot",
  397. },
  398. {
  399. type: "enum",
  400. values: ["only"],
  401. multiple: false,
  402. description: "Enables Hot Module Replacement.",
  403. path: "hot",
  404. },
  405. ],
  406. description: "Enables Hot Module Replacement.",
  407. simpleType: "string",
  408. multiple: false,
  409. },
  410. http2: {
  411. configs: [
  412. {
  413. type: "boolean",
  414. multiple: false,
  415. description:
  416. "Allows to serve over HTTP/2 using SPDY. Deprecated, use the `server` option.",
  417. negatedDescription: "Does not serve over HTTP/2 using SPDY.",
  418. path: "http2",
  419. },
  420. ],
  421. description:
  422. "Allows to serve over HTTP/2 using SPDY. Deprecated, use the `server` option.",
  423. simpleType: "boolean",
  424. multiple: false,
  425. },
  426. https: {
  427. configs: [
  428. {
  429. type: "boolean",
  430. multiple: false,
  431. description:
  432. "Allows to configure the server's listening socket for TLS (by default, dev server will be served over HTTP). Deprecated, use the `server` option.",
  433. negatedDescription:
  434. "Disallows to configure the server's listening socket for TLS (by default, dev server will be served over HTTP).",
  435. path: "https",
  436. },
  437. ],
  438. description:
  439. "Allows to configure the server's listening socket for TLS (by default, dev server will be served over HTTP). Deprecated, use the `server` option.",
  440. simpleType: "boolean",
  441. multiple: false,
  442. },
  443. "https-ca": {
  444. configs: [
  445. {
  446. type: "string",
  447. multiple: true,
  448. description:
  449. "Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  450. path: "https.ca[]",
  451. },
  452. ],
  453. description:
  454. "Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  455. simpleType: "string",
  456. multiple: true,
  457. },
  458. "https-ca-reset": {
  459. configs: [
  460. {
  461. description:
  462. "Clear all items provided in 'https.ca' configuration. Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  463. multiple: false,
  464. path: "https.ca",
  465. type: "reset",
  466. },
  467. ],
  468. description:
  469. "Clear all items provided in 'https.ca' configuration. Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  470. multiple: false,
  471. simpleType: "boolean",
  472. },
  473. "https-cacert": {
  474. configs: [
  475. {
  476. type: "string",
  477. multiple: true,
  478. description:
  479. "Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  480. path: "https.cacert[]",
  481. },
  482. ],
  483. description:
  484. "Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  485. simpleType: "string",
  486. multiple: true,
  487. },
  488. "https-cacert-reset": {
  489. configs: [
  490. {
  491. description:
  492. "Clear all items provided in 'https.cacert' configuration. Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  493. multiple: false,
  494. path: "https.cacert",
  495. type: "reset",
  496. },
  497. ],
  498. description:
  499. "Clear all items provided in 'https.cacert' configuration. Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  500. multiple: false,
  501. simpleType: "boolean",
  502. },
  503. "https-cert": {
  504. configs: [
  505. {
  506. type: "string",
  507. multiple: true,
  508. description:
  509. "Path to an SSL certificate or content of an SSL certificate. Deprecated, use the `server.options.cert` option.",
  510. path: "https.cert[]",
  511. },
  512. ],
  513. description:
  514. "Path to an SSL certificate or content of an SSL certificate. Deprecated, use the `server.options.cert` option.",
  515. simpleType: "string",
  516. multiple: true,
  517. },
  518. "https-cert-reset": {
  519. configs: [
  520. {
  521. description:
  522. "Clear all items provided in 'https.cert' configuration. Path to an SSL certificate or content of an SSL certificate. Deprecated, use the `server.options.cert` option.",
  523. multiple: false,
  524. path: "https.cert",
  525. type: "reset",
  526. },
  527. ],
  528. description:
  529. "Clear all items provided in 'https.cert' configuration. Path to an SSL certificate or content of an SSL certificate. Deprecated, use the `server.options.cert` option.",
  530. multiple: false,
  531. simpleType: "boolean",
  532. },
  533. "https-crl": {
  534. configs: [
  535. {
  536. description:
  537. "Path to PEM formatted CRLs (Certificate Revocation Lists) or content of PEM formatted CRLs (Certificate Revocation Lists). Deprecated, use the `server.options.crl` option.",
  538. multiple: true,
  539. path: "https.crl[]",
  540. type: "string",
  541. },
  542. ],
  543. description:
  544. "Path to PEM formatted CRLs (Certificate Revocation Lists) or content of PEM formatted CRLs (Certificate Revocation Lists). Deprecated, use the `server.options.crl` option.",
  545. multiple: true,
  546. simpleType: "string",
  547. },
  548. "https-crl-reset": {
  549. configs: [
  550. {
  551. description:
  552. "Clear all items provided in 'https.crl' configuration. Path to PEM formatted CRLs (Certificate Revocation Lists) or content of PEM formatted CRLs (Certificate Revocation Lists). Deprecated, use the `server.options.crl` option.",
  553. multiple: false,
  554. path: "https.crl",
  555. type: "reset",
  556. },
  557. ],
  558. description:
  559. "Clear all items provided in 'https.crl' configuration. Path to PEM formatted CRLs (Certificate Revocation Lists) or content of PEM formatted CRLs (Certificate Revocation Lists). Deprecated, use the `server.options.crl` option.",
  560. multiple: false,
  561. simpleType: "boolean",
  562. },
  563. "https-key": {
  564. configs: [
  565. {
  566. type: "string",
  567. multiple: true,
  568. description:
  569. "Path to an SSL key or content of an SSL key. Deprecated, use the `server.options.key` option.",
  570. path: "https.key[]",
  571. },
  572. ],
  573. description:
  574. "Path to an SSL key or content of an SSL key. Deprecated, use the `server.options.key` option.",
  575. simpleType: "string",
  576. multiple: true,
  577. },
  578. "https-key-reset": {
  579. configs: [
  580. {
  581. description:
  582. "Clear all items provided in 'https.key' configuration. Path to an SSL key or content of an SSL key. Deprecated, use the `server.options.key` option.",
  583. multiple: false,
  584. path: "https.key",
  585. type: "reset",
  586. },
  587. ],
  588. description:
  589. "Clear all items provided in 'https.key' configuration. Path to an SSL key or content of an SSL key. Deprecated, use the `server.options.key` option.",
  590. multiple: false,
  591. simpleType: "boolean",
  592. },
  593. "https-passphrase": {
  594. configs: [
  595. {
  596. type: "string",
  597. multiple: false,
  598. description:
  599. "Passphrase for a pfx file. Deprecated, use the `server.options.passphrase` option.",
  600. path: "https.passphrase",
  601. },
  602. ],
  603. description:
  604. "Passphrase for a pfx file. Deprecated, use the `server.options.passphrase` option.",
  605. simpleType: "string",
  606. multiple: false,
  607. },
  608. "https-pfx": {
  609. configs: [
  610. {
  611. type: "string",
  612. multiple: true,
  613. description:
  614. "Path to an SSL pfx file or content of an SSL pfx file. Deprecated, use the `server.options.pfx` option.",
  615. path: "https.pfx[]",
  616. },
  617. ],
  618. description:
  619. "Path to an SSL pfx file or content of an SSL pfx file. Deprecated, use the `server.options.pfx` option.",
  620. simpleType: "string",
  621. multiple: true,
  622. },
  623. "https-pfx-reset": {
  624. configs: [
  625. {
  626. description:
  627. "Clear all items provided in 'https.pfx' configuration. Path to an SSL pfx file or content of an SSL pfx file. Deprecated, use the `server.options.pfx` option.",
  628. multiple: false,
  629. path: "https.pfx",
  630. type: "reset",
  631. },
  632. ],
  633. description:
  634. "Clear all items provided in 'https.pfx' configuration. Path to an SSL pfx file or content of an SSL pfx file. Deprecated, use the `server.options.pfx` option.",
  635. multiple: false,
  636. simpleType: "boolean",
  637. },
  638. "https-request-cert": {
  639. configs: [
  640. {
  641. type: "boolean",
  642. multiple: false,
  643. description:
  644. "Request for an SSL certificate. Deprecated, use the `server.options.requestCert` option.",
  645. negatedDescription: "Does not request for an SSL certificate.",
  646. path: "https.requestCert",
  647. },
  648. ],
  649. description:
  650. "Request for an SSL certificate. Deprecated, use the `server.options.requestCert` option.",
  651. simpleType: "boolean",
  652. multiple: false,
  653. },
  654. ipc: {
  655. configs: [
  656. {
  657. type: "string",
  658. multiple: false,
  659. description: "Listen to a unix socket.",
  660. path: "ipc",
  661. },
  662. {
  663. type: "enum",
  664. values: [true],
  665. multiple: false,
  666. description: "Listen to a unix socket.",
  667. path: "ipc",
  668. },
  669. ],
  670. description: "Listen to a unix socket.",
  671. simpleType: "string",
  672. multiple: false,
  673. },
  674. "live-reload": {
  675. configs: [
  676. {
  677. type: "boolean",
  678. multiple: false,
  679. description:
  680. "Enables reload/refresh the page(s) when file changes are detected (enabled by default).",
  681. negatedDescription:
  682. "Disables reload/refresh the page(s) when file changes are detected (enabled by default).",
  683. path: "liveReload",
  684. },
  685. ],
  686. description:
  687. "Enables reload/refresh the page(s) when file changes are detected (enabled by default).",
  688. simpleType: "boolean",
  689. multiple: false,
  690. },
  691. "magic-html": {
  692. configs: [
  693. {
  694. type: "boolean",
  695. multiple: false,
  696. description:
  697. "Tells dev-server whether to enable magic HTML routes (routes corresponding to your webpack output, for example '/main' for 'main.js').",
  698. negatedDescription:
  699. "Disables magic HTML routes (routes corresponding to your webpack output, for example '/main' for 'main.js').",
  700. path: "magicHtml",
  701. },
  702. ],
  703. description:
  704. "Tells dev-server whether to enable magic HTML routes (routes corresponding to your webpack output, for example '/main' for 'main.js').",
  705. simpleType: "boolean",
  706. multiple: false,
  707. },
  708. open: {
  709. configs: [
  710. {
  711. type: "string",
  712. multiple: true,
  713. description:
  714. "Allows to configure dev server to open the browser(s) and page(s) after server had been started (set it to true to open your default browser).",
  715. path: "open[]",
  716. },
  717. {
  718. type: "boolean",
  719. multiple: false,
  720. description:
  721. "Allows to configure dev server to open the browser(s) and page(s) after server had been started (set it to true to open your default browser).",
  722. negatedDescription: "Does not open the default browser.",
  723. path: "open",
  724. },
  725. ],
  726. description:
  727. "Allows to configure dev server to open the browser(s) and page(s) after server had been started (set it to true to open your default browser).",
  728. simpleType: "string",
  729. multiple: true,
  730. },
  731. "open-app": {
  732. configs: [
  733. {
  734. type: "string",
  735. multiple: true,
  736. description:
  737. "Open specified browser. Deprecated: please use '--open-app-name'.",
  738. path: "open[].app",
  739. },
  740. ],
  741. description:
  742. "Open specified browser. Deprecated: please use '--open-app-name'.",
  743. simpleType: "string",
  744. multiple: true,
  745. },
  746. "open-app-name": {
  747. configs: [
  748. {
  749. type: "string",
  750. multiple: true,
  751. description: "Open specified browser.",
  752. path: "open[].app.name",
  753. },
  754. {
  755. type: "string",
  756. multiple: true,
  757. description: "Open specified browser.",
  758. path: "open.app.name[]",
  759. },
  760. ],
  761. description: "Open specified browser.",
  762. simpleType: "string",
  763. multiple: true,
  764. },
  765. "open-app-name-reset": {
  766. configs: [
  767. {
  768. type: "reset",
  769. multiple: false,
  770. description:
  771. "Clear all items provided in 'open.app.name' configuration. Open specified browser.",
  772. path: "open.app.name",
  773. },
  774. ],
  775. description:
  776. "Clear all items provided in 'open.app.name' configuration. Open specified browser.",
  777. simpleType: "boolean",
  778. multiple: false,
  779. },
  780. "open-reset": {
  781. configs: [
  782. {
  783. type: "reset",
  784. multiple: false,
  785. description:
  786. "Clear all items provided in 'open' configuration. Allows to configure dev server to open the browser(s) and page(s) after server had been started (set it to true to open your default browser).",
  787. path: "open",
  788. },
  789. ],
  790. description:
  791. "Clear all items provided in 'open' configuration. Allows to configure dev server to open the browser(s) and page(s) after server had been started (set it to true to open your default browser).",
  792. simpleType: "boolean",
  793. multiple: false,
  794. },
  795. "open-target": {
  796. configs: [
  797. {
  798. type: "string",
  799. multiple: true,
  800. description: "Opens specified page in browser.",
  801. path: "open[].target",
  802. },
  803. {
  804. type: "string",
  805. multiple: true,
  806. description: "Opens specified page in browser.",
  807. path: "open.target[]",
  808. },
  809. ],
  810. description: "Opens specified page in browser.",
  811. simpleType: "string",
  812. multiple: true,
  813. },
  814. "open-target-reset": {
  815. configs: [
  816. {
  817. type: "reset",
  818. multiple: false,
  819. description:
  820. "Clear all items provided in 'open.target' configuration. Opens specified page in browser.",
  821. path: "open.target",
  822. },
  823. ],
  824. description:
  825. "Clear all items provided in 'open.target' configuration. Opens specified page in browser.",
  826. simpleType: "boolean",
  827. multiple: false,
  828. },
  829. port: {
  830. configs: [
  831. {
  832. type: "number",
  833. multiple: false,
  834. description: "Allows to specify a port to use.",
  835. path: "port",
  836. },
  837. {
  838. type: "string",
  839. multiple: false,
  840. description: "Allows to specify a port to use.",
  841. path: "port",
  842. },
  843. {
  844. type: "enum",
  845. values: ["auto"],
  846. multiple: false,
  847. description: "Allows to specify a port to use.",
  848. path: "port",
  849. },
  850. ],
  851. description: "Allows to specify a port to use.",
  852. simpleType: "string",
  853. multiple: false,
  854. },
  855. "server-options-ca": {
  856. configs: [
  857. {
  858. description:
  859. "Path to an SSL CA certificate or content of an SSL CA certificate.",
  860. multiple: true,
  861. path: "server.options.ca[]",
  862. type: "string",
  863. },
  864. ],
  865. description:
  866. "Path to an SSL CA certificate or content of an SSL CA certificate.",
  867. multiple: true,
  868. simpleType: "string",
  869. },
  870. "server-options-ca-reset": {
  871. configs: [
  872. {
  873. description:
  874. "Clear all items provided in 'server.options.ca' configuration. Path to an SSL CA certificate or content of an SSL CA certificate.",
  875. multiple: false,
  876. path: "server.options.ca",
  877. type: "reset",
  878. },
  879. ],
  880. description:
  881. "Clear all items provided in 'server.options.ca' configuration. Path to an SSL CA certificate or content of an SSL CA certificate.",
  882. multiple: false,
  883. simpleType: "boolean",
  884. },
  885. "server-options-cacert": {
  886. configs: [
  887. {
  888. description:
  889. "Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  890. multiple: true,
  891. path: "server.options.cacert[]",
  892. type: "string",
  893. },
  894. ],
  895. description:
  896. "Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  897. multiple: true,
  898. simpleType: "string",
  899. },
  900. "server-options-cacert-reset": {
  901. configs: [
  902. {
  903. description:
  904. "Clear all items provided in 'server.options.cacert' configuration. Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  905. multiple: false,
  906. path: "server.options.cacert",
  907. type: "reset",
  908. },
  909. ],
  910. description:
  911. "Clear all items provided in 'server.options.cacert' configuration. Path to an SSL CA certificate or content of an SSL CA certificate. Deprecated, use the `server.options.ca` option.",
  912. multiple: false,
  913. simpleType: "boolean",
  914. },
  915. "server-options-cert": {
  916. configs: [
  917. {
  918. description:
  919. "Path to an SSL certificate or content of an SSL certificate.",
  920. multiple: true,
  921. path: "server.options.cert[]",
  922. type: "string",
  923. },
  924. ],
  925. description: "Path to an SSL certificate or content of an SSL certificate.",
  926. multiple: true,
  927. simpleType: "string",
  928. },
  929. "server-options-cert-reset": {
  930. configs: [
  931. {
  932. description:
  933. "Clear all items provided in 'server.options.cert' configuration. Path to an SSL certificate or content of an SSL certificate.",
  934. multiple: false,
  935. path: "server.options.cert",
  936. type: "reset",
  937. },
  938. ],
  939. description:
  940. "Clear all items provided in 'server.options.cert' configuration. Path to an SSL certificate or content of an SSL certificate.",
  941. multiple: false,
  942. simpleType: "boolean",
  943. },
  944. "server-options-crl": {
  945. configs: [
  946. {
  947. description:
  948. "Path to PEM formatted CRLs (Certificate Revocation Lists) or content of PEM formatted CRLs (Certificate Revocation Lists).",
  949. multiple: true,
  950. path: "server.options.crl[]",
  951. type: "string",
  952. },
  953. ],
  954. description:
  955. "Path to PEM formatted CRLs (Certificate Revocation Lists) or content of PEM formatted CRLs (Certificate Revocation Lists).",
  956. multiple: true,
  957. simpleType: "string",
  958. },
  959. "server-options-crl-reset": {
  960. configs: [
  961. {
  962. description:
  963. "Clear all items provided in 'server.options.crl' configuration. Path to PEM formatted CRLs (Certificate Revocation Lists) or content of PEM formatted CRLs (Certificate Revocation Lists).",
  964. multiple: false,
  965. path: "server.options.crl",
  966. type: "reset",
  967. },
  968. ],
  969. description:
  970. "Clear all items provided in 'server.options.crl' configuration. Path to PEM formatted CRLs (Certificate Revocation Lists) or content of PEM formatted CRLs (Certificate Revocation Lists).",
  971. multiple: false,
  972. simpleType: "boolean",
  973. },
  974. "server-options-key": {
  975. configs: [
  976. {
  977. description: "Path to an SSL key or content of an SSL key.",
  978. multiple: true,
  979. path: "server.options.key[]",
  980. type: "string",
  981. },
  982. ],
  983. description: "Path to an SSL key or content of an SSL key.",
  984. multiple: true,
  985. simpleType: "string",
  986. },
  987. "server-options-key-reset": {
  988. configs: [
  989. {
  990. description:
  991. "Clear all items provided in 'server.options.key' configuration. Path to an SSL key or content of an SSL key.",
  992. multiple: false,
  993. path: "server.options.key",
  994. type: "reset",
  995. },
  996. ],
  997. description:
  998. "Clear all items provided in 'server.options.key' configuration. Path to an SSL key or content of an SSL key.",
  999. multiple: false,
  1000. simpleType: "boolean",
  1001. },
  1002. "server-options-passphrase": {
  1003. configs: [
  1004. {
  1005. description: "Passphrase for a pfx file.",
  1006. multiple: false,
  1007. path: "server.options.passphrase",
  1008. type: "string",
  1009. },
  1010. ],
  1011. description: "Passphrase for a pfx file.",
  1012. multiple: false,
  1013. simpleType: "string",
  1014. },
  1015. "server-options-pfx": {
  1016. configs: [
  1017. {
  1018. description: "Path to an SSL pfx file or content of an SSL pfx file.",
  1019. multiple: true,
  1020. path: "server.options.pfx[]",
  1021. type: "string",
  1022. },
  1023. ],
  1024. description: "Path to an SSL pfx file or content of an SSL pfx file.",
  1025. multiple: true,
  1026. simpleType: "string",
  1027. },
  1028. "server-options-pfx-reset": {
  1029. configs: [
  1030. {
  1031. description:
  1032. "Clear all items provided in 'server.options.pfx' configuration. Path to an SSL pfx file or content of an SSL pfx file.",
  1033. multiple: false,
  1034. path: "server.options.pfx",
  1035. type: "reset",
  1036. },
  1037. ],
  1038. description:
  1039. "Clear all items provided in 'server.options.pfx' configuration. Path to an SSL pfx file or content of an SSL pfx file.",
  1040. multiple: false,
  1041. simpleType: "boolean",
  1042. },
  1043. "server-options-request-cert": {
  1044. configs: [
  1045. {
  1046. description: "Request for an SSL certificate.",
  1047. negatedDescription: "Does not request for an SSL certificate.",
  1048. multiple: false,
  1049. path: "server.options.requestCert",
  1050. type: "boolean",
  1051. },
  1052. ],
  1053. description: "Request for an SSL certificate.",
  1054. multiple: false,
  1055. simpleType: "boolean",
  1056. },
  1057. "server-type": {
  1058. configs: [
  1059. {
  1060. description: "Allows to set server and options (by default 'http').",
  1061. multiple: false,
  1062. path: "server.type",
  1063. type: "enum",
  1064. values: ["http", "https", "spdy"],
  1065. },
  1066. ],
  1067. description: "Allows to set server and options (by default 'http').",
  1068. multiple: false,
  1069. simpleType: "string",
  1070. },
  1071. static: {
  1072. configs: [
  1073. {
  1074. type: "string",
  1075. multiple: true,
  1076. description:
  1077. "Allows to configure options for serving static files from directory (by default 'public' directory).",
  1078. path: "static[]",
  1079. },
  1080. {
  1081. type: "boolean",
  1082. multiple: false,
  1083. description:
  1084. "Allows to configure options for serving static files from directory (by default 'public' directory).",
  1085. negatedDescription:
  1086. "Disallows to configure options for serving static files from directory.",
  1087. path: "static",
  1088. },
  1089. ],
  1090. description:
  1091. "Allows to configure options for serving static files from directory (by default 'public' directory).",
  1092. simpleType: "string",
  1093. multiple: true,
  1094. },
  1095. "static-directory": {
  1096. configs: [
  1097. {
  1098. type: "string",
  1099. multiple: true,
  1100. description: "Directory for static contents.",
  1101. path: "static[].directory",
  1102. },
  1103. ],
  1104. description: "Directory for static contents.",
  1105. simpleType: "string",
  1106. multiple: true,
  1107. },
  1108. "static-public-path": {
  1109. configs: [
  1110. {
  1111. type: "string",
  1112. multiple: true,
  1113. description:
  1114. "The static files will be available in the browser under this public path.",
  1115. path: "static[].publicPath",
  1116. },
  1117. {
  1118. type: "string",
  1119. multiple: true,
  1120. description:
  1121. "The static files will be available in the browser under this public path.",
  1122. path: "static.publicPath[]",
  1123. },
  1124. ],
  1125. description:
  1126. "The static files will be available in the browser under this public path.",
  1127. simpleType: "string",
  1128. multiple: true,
  1129. },
  1130. "static-public-path-reset": {
  1131. configs: [
  1132. {
  1133. type: "reset",
  1134. multiple: false,
  1135. description:
  1136. "Clear all items provided in 'static.publicPath' configuration. The static files will be available in the browser under this public path.",
  1137. path: "static.publicPath",
  1138. },
  1139. ],
  1140. description:
  1141. "Clear all items provided in 'static.publicPath' configuration. The static files will be available in the browser under this public path.",
  1142. simpleType: "boolean",
  1143. multiple: false,
  1144. },
  1145. "static-reset": {
  1146. configs: [
  1147. {
  1148. type: "reset",
  1149. multiple: false,
  1150. description:
  1151. "Clear all items provided in 'static' configuration. Allows to configure options for serving static files from directory (by default 'public' directory).",
  1152. path: "static",
  1153. },
  1154. ],
  1155. description:
  1156. "Clear all items provided in 'static' configuration. Allows to configure options for serving static files from directory (by default 'public' directory).",
  1157. simpleType: "boolean",
  1158. multiple: false,
  1159. },
  1160. "static-serve-index": {
  1161. configs: [
  1162. {
  1163. type: "boolean",
  1164. multiple: true,
  1165. description:
  1166. "Tells dev server to use serveIndex middleware when enabled.",
  1167. negatedDescription:
  1168. "Does not tell dev server to use serveIndex middleware.",
  1169. path: "static[].serveIndex",
  1170. },
  1171. ],
  1172. description: "Tells dev server to use serveIndex middleware when enabled.",
  1173. simpleType: "boolean",
  1174. multiple: true,
  1175. },
  1176. "static-watch": {
  1177. configs: [
  1178. {
  1179. type: "boolean",
  1180. multiple: true,
  1181. description: "Watches for files in static content directory.",
  1182. negatedDescription:
  1183. "Does not watch for files in static content directory.",
  1184. path: "static[].watch",
  1185. },
  1186. ],
  1187. description: "Watches for files in static content directory.",
  1188. simpleType: "boolean",
  1189. multiple: true,
  1190. },
  1191. "watch-files": {
  1192. configs: [
  1193. {
  1194. type: "string",
  1195. multiple: true,
  1196. description:
  1197. "Allows to configure list of globs/directories/files to watch for file changes.",
  1198. path: "watchFiles[]",
  1199. },
  1200. ],
  1201. description:
  1202. "Allows to configure list of globs/directories/files to watch for file changes.",
  1203. simpleType: "string",
  1204. multiple: true,
  1205. },
  1206. "watch-files-reset": {
  1207. configs: [
  1208. {
  1209. type: "reset",
  1210. multiple: false,
  1211. description:
  1212. "Clear all items provided in 'watchFiles' configuration. Allows to configure list of globs/directories/files to watch for file changes.",
  1213. path: "watchFiles",
  1214. },
  1215. ],
  1216. description:
  1217. "Clear all items provided in 'watchFiles' configuration. Allows to configure list of globs/directories/files to watch for file changes.",
  1218. simpleType: "boolean",
  1219. multiple: false,
  1220. },
  1221. "web-socket-server": {
  1222. configs: [
  1223. {
  1224. description:
  1225. "Deprecated: please use '--web-socket-server-type' option.",
  1226. negatedDescription: "Disallows to set web socket server and options.",
  1227. multiple: false,
  1228. path: "webSocketServer",
  1229. type: "enum",
  1230. values: [false],
  1231. },
  1232. {
  1233. description:
  1234. "Deprecated: please use '--web-socket-server-type' option.",
  1235. multiple: false,
  1236. path: "webSocketServer",
  1237. type: "enum",
  1238. values: ["sockjs", "ws"],
  1239. },
  1240. {
  1241. description:
  1242. "Allows to set web socket server and options (by default 'ws').",
  1243. multiple: false,
  1244. path: "webSocketServer",
  1245. type: "string",
  1246. },
  1247. ],
  1248. description:
  1249. "Deprecated: please use '--web-socket-server-type' option. Allows to set web socket server and options (by default 'ws').",
  1250. simpleType: "string",
  1251. multiple: false,
  1252. },
  1253. "web-socket-server-type": {
  1254. configs: [
  1255. {
  1256. description:
  1257. "Allows to set web socket server and options (by default 'ws').",
  1258. multiple: false,
  1259. path: "webSocketServer.type",
  1260. type: "enum",
  1261. values: ["sockjs", "ws"],
  1262. },
  1263. {
  1264. description:
  1265. "Allows to set web socket server and options (by default 'ws').",
  1266. multiple: false,
  1267. path: "webSocketServer.type",
  1268. type: "string",
  1269. },
  1270. ],
  1271. description:
  1272. "Allows to set web socket server and options (by default 'ws').",
  1273. simpleType: "string",
  1274. multiple: false,
  1275. },
  1276. };