@department-of-veterans-affairs/component-library 49.2.0 → 49.4.0

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 (97) hide show
  1. package/dist/1214.app.bundle.js +1 -1
  2. package/dist/1450.app.bundle.js +1 -1
  3. package/dist/157.app.bundle.js +1 -0
  4. package/dist/2222.app.bundle.js +1 -1
  5. package/dist/2387.app.bundle.js +1 -1
  6. package/dist/2654.app.bundle.js +1 -1
  7. package/dist/2664.app.bundle.js +1 -1
  8. package/dist/2801.app.bundle.js +1 -1
  9. package/dist/286.app.bundle.js +1 -1
  10. package/dist/3071.app.bundle.js +1 -1
  11. package/dist/3156.app.bundle.js +1 -1
  12. package/dist/4064.app.bundle.js +1 -1
  13. package/dist/4117.app.bundle.js +1 -1
  14. package/dist/4140.app.bundle.js +1 -1
  15. package/dist/4493.app.bundle.js +1 -1
  16. package/dist/4715.app.bundle.js +1 -1
  17. package/dist/5155.app.bundle.js +1 -1
  18. package/dist/5306.app.bundle.js +1 -1
  19. package/dist/5610.app.bundle.js +1 -1
  20. package/dist/5699.app.bundle.js +1 -1
  21. package/dist/5830.app.bundle.js +1 -1
  22. package/dist/6034.app.bundle.js +1 -1
  23. package/dist/6246.app.bundle.js +1 -1
  24. package/dist/6247.app.bundle.js +1 -1
  25. package/dist/641.app.bundle.js +1 -0
  26. package/dist/6527.app.bundle.js +1 -1
  27. package/dist/6655.app.bundle.js +2 -0
  28. package/dist/712.app.bundle.js +1 -1
  29. package/dist/7367.app.bundle.js +1 -1
  30. package/dist/7531.app.bundle.js +1 -1
  31. package/dist/7663.app.bundle.js +1 -1
  32. package/dist/7821.app.bundle.js +1 -1
  33. package/dist/8175.app.bundle.js +1 -1
  34. package/dist/82.app.bundle.js +1 -1
  35. package/dist/8762.app.bundle.js +1 -1
  36. package/dist/890.app.bundle.js +1 -1
  37. package/dist/9157.app.bundle.js +1 -1
  38. package/dist/9288.app.bundle.js +1 -1
  39. package/dist/9670.app.bundle.js +1 -1
  40. package/dist/9724.app.bundle.js +1 -1
  41. package/dist/9800.app.bundle.js +1 -1
  42. package/dist/app.bundle.js +1 -1
  43. package/dist/components/index.d.ts +2 -0
  44. package/dist/components/index.js +1 -1
  45. package/dist/components/types/components.d.ts +354 -163
  46. package/dist/components/utils.js +1 -1
  47. package/dist/components/va-accordion.js +1 -1
  48. package/dist/components/va-additional-info.js +1 -1
  49. package/dist/components/va-alert-expandable.js +1 -1
  50. package/dist/components/va-alert-sign-in.js +1 -1
  51. package/dist/components/va-back-to-top.js +1 -1
  52. package/dist/components/va-button-icon2.js +1 -1
  53. package/dist/components/va-button2.js +1 -1
  54. package/dist/components/va-card2.js +1 -1
  55. package/dist/components/va-checkbox-group.js +1 -1
  56. package/dist/components/va-checkbox2.js +1 -1
  57. package/dist/components/va-combo-box.js +2 -2
  58. package/dist/components/va-crisis-line-modal2.js +1 -1
  59. package/dist/components/va-file-input-multiple.js +1 -1
  60. package/dist/components/va-file-input2.js +1 -1
  61. package/dist/components/va-header-minimal.js +1 -1
  62. package/dist/components/va-icon2.js +1 -1
  63. package/dist/components/va-language-toggle.js +1 -1
  64. package/dist/components/va-link-action.js +1 -1
  65. package/dist/components/va-loading-indicator.js +1 -1
  66. package/dist/components/va-minimal-footer.js +1 -1
  67. package/dist/components/va-need-help.js +1 -1
  68. package/dist/components/va-official-gov-banner2.js +1 -1
  69. package/dist/components/va-omb-info.js +1 -1
  70. package/dist/components/va-privacy-agreement.js +1 -1
  71. package/dist/components/va-process-list-item.js +1 -1
  72. package/dist/components/va-process-list.js +1 -1
  73. package/dist/components/va-progress-bar.js +1 -1
  74. package/dist/components/va-progress-bar2.js +1 -0
  75. package/dist/components/va-radio-option.js +1 -1
  76. package/dist/components/va-radio.js +1 -1
  77. package/dist/components/va-search-input.js +1 -1
  78. package/dist/components/va-select2.js +1 -1
  79. package/dist/components/va-service-list-item.d.ts +11 -0
  80. package/dist/components/va-service-list-item.js +1 -0
  81. package/dist/components/va-statement-of-truth.js +1 -1
  82. package/dist/components/va-summary-box.js +1 -1
  83. package/dist/components/va-table-inner2.js +1 -1
  84. package/dist/components/va-table-row.js +1 -1
  85. package/dist/components/va-table.js +1 -1
  86. package/dist/components/va-telephone2.js +1 -1
  87. package/dist/components/va-textarea.js +1 -1
  88. package/dist/main.css +1 -1
  89. package/dist/react-bindings/index.d.ts +1 -0
  90. package/dist/react-bindings/index.js +1 -1
  91. package/dist/react-bindings/index.js.map +1 -1
  92. package/dist/react-bindings/index.ts +1 -0
  93. package/package.json +2 -2
  94. package/dist/196.app.bundle.js +0 -2
  95. package/dist/326.app.bundle.js +0 -1
  96. package/dist/5628.app.bundle.js +0 -1
  97. /package/dist/{196.app.bundle.js.LICENSE.txt → 6655.app.bundle.js.LICENSE.txt} +0 -0
@@ -7,8 +7,10 @@
7
7
  import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
8
8
  import { Breadcrumb } from "./components/va-breadcrumbs/va-breadcrumbs";
9
9
  import { UploadedFile } from "./components/va-file-input/uploadedFile";
10
+ import { OptionalLink, ServiceAction, ServiceDetails } from "./components/va-service-list-item/va-service-list-item";
10
11
  export { Breadcrumb } from "./components/va-breadcrumbs/va-breadcrumbs";
11
12
  export { UploadedFile } from "./components/va-file-input/uploadedFile";
13
+ export { OptionalLink, ServiceAction, ServiceDetails } from "./components/va-service-list-item/va-service-list-item";
12
14
  export namespace Components {
13
15
  /**
14
16
  * @componentName Accordion
@@ -58,7 +60,7 @@ export namespace Components {
58
60
  /**
59
61
  * @componentName Additional info
60
62
  * @maturityCategory use
61
- * @maturityLevel deployed
63
+ * @maturityLevel best_practice
62
64
  */
63
65
  interface VaAdditionalInfo {
64
66
  /**
@@ -116,8 +118,8 @@ export namespace Components {
116
118
  /**
117
119
  * @componentName Alert - expandable
118
120
  * @guidanceHref alert/alert-expandable
119
- * @maturityCategory caution
120
- * @maturityLevel candidate
121
+ * @maturityCategory use
122
+ * @maturityLevel deployed
121
123
  */
122
124
  interface VaAlertExpandable {
123
125
  /**
@@ -157,7 +159,7 @@ export namespace Components {
157
159
  */
158
160
  "timeLimit"?: string;
159
161
  /**
160
- * **Required.** Determines the text content and border/background color. Must be one of "signInRequired", "signInOptional", "signInEither", "verifyIdMe", or "verifyLoginGov".
162
+ * **Required.** Determines the text content and border/background color. Must be one of "signInRequired", "signInOptional", "signInOptionalNoPrefill", "signInEither", "verifyIdMe", or "verifyLoginGov".
161
163
  */
162
164
  "variant": string;
163
165
  /**
@@ -241,8 +243,8 @@ export namespace Components {
241
243
  /**
242
244
  * @componentName Button
243
245
  * @nativeHandler onClick
244
- * @maturityCategory caution
245
- * @maturityLevel candidate
246
+ * @maturityCategory use
247
+ * @maturityLevel deployed
246
248
  */
247
249
  interface VaButton {
248
250
  /**
@@ -265,6 +267,10 @@ export namespace Components {
265
267
  * If `true`, the click event will not fire.
266
268
  */
267
269
  "disabled"?: boolean;
270
+ /**
271
+ * If `true`, the button will expand to the full available width of its container.
272
+ */
273
+ "fullWidth"?: boolean;
268
274
  /**
269
275
  * The aria-label of the component.
270
276
  */
@@ -298,7 +304,7 @@ export namespace Components {
298
304
  * @componentName Button - Icon
299
305
  * @nativeHandler onClick
300
306
  * @maturityCategory caution
301
- * @maturityLevel candidate
307
+ * @maturityLevel available
302
308
  */
303
309
  interface VaButtonIcon {
304
310
  "buttonType": keyof typeof this.buttonTypeMap;
@@ -313,8 +319,8 @@ export namespace Components {
313
319
  }
314
320
  /**
315
321
  * @componentName Button pair
316
- * @maturityCategory caution
317
- * @maturityLevel candidate
322
+ * @maturityCategory use
323
+ * @maturityLevel deployed
318
324
  * @guidanceHref button/button-pair
319
325
  */
320
326
  interface VaButtonPair {
@@ -353,8 +359,8 @@ export namespace Components {
353
359
  }
354
360
  /**
355
361
  * @componentName Card
356
- * @maturityCategory caution
357
- * @maturityLevel candidate
362
+ * @maturityCategory use
363
+ * @maturityLevel deployed
358
364
  */
359
365
  interface VaCard {
360
366
  /**
@@ -531,7 +537,7 @@ export namespace Components {
531
537
  /**
532
538
  * @componentName Crisis Line Modal
533
539
  * @maturityCategory caution
534
- * @maturityLevel candidate
540
+ * @maturityLevel available
535
541
  */
536
542
  interface VaCrisisLineModal {
537
543
  }
@@ -629,6 +635,10 @@ export namespace Components {
629
635
  * The name for the input element.
630
636
  */
631
637
  "name"?: string;
638
+ /**
639
+ * Percent upload completed. For use with va-progress-bar component
640
+ */
641
+ "percentUploaded"?: number;
632
642
  /**
633
643
  * Optionally displays the read-only view
634
644
  */
@@ -711,7 +721,7 @@ export namespace Components {
711
721
  /**
712
722
  * @componentName Header - Minimal
713
723
  * @maturityCategory caution
714
- * @maturityLevel candidate
724
+ * @maturityLevel available
715
725
  * @guidanceHref header/header-minimal
716
726
  */
717
727
  interface VaHeaderMinimal {
@@ -725,7 +735,7 @@ export namespace Components {
725
735
  /**
726
736
  * @componentName Icon
727
737
  * @maturityCategory caution
728
- * @maturityLevel candidate
738
+ * @maturityLevel available
729
739
  */
730
740
  interface VaIcon {
731
741
  /**
@@ -744,7 +754,7 @@ export namespace Components {
744
754
  /**
745
755
  * @componentName Language Toggle
746
756
  * @maturityCategory caution
747
- * @maturityLevel candidate
757
+ * @maturityLevel available
748
758
  */
749
759
  interface VaLanguageToggle {
750
760
  /**
@@ -770,8 +780,8 @@ export namespace Components {
770
780
  }
771
781
  /**
772
782
  * @componentName Link
773
- * @maturityCategory caution
774
- * @maturityLevel candidate
783
+ * @maturityCategory use
784
+ * @maturityLevel deployed
775
785
  */
776
786
  interface VaLink {
777
787
  /**
@@ -803,7 +813,7 @@ export namespace Components {
803
813
  */
804
814
  "download"?: boolean;
805
815
  /**
806
- * If 'true', will open in a new tab and have icon denoting that. Will also have the text "opens in a new tab" appended to the link text in screen reader only span
816
+ * If 'true', will open in a new tab and will have the text "opens in a new tab" appended to the link text in screen reader only span
807
817
  */
808
818
  "external"?: boolean;
809
819
  /**
@@ -853,8 +863,10 @@ export namespace Components {
853
863
  }
854
864
  /**
855
865
  * @componentName Link - Action
856
- * @maturityCategory caution
857
- * @maturityLevel candidate
866
+ * @maturityCategory use
867
+ * @maturityLevel deployed
868
+ * @guidanceHref link/action
869
+ * @guidanceName Action link
858
870
  */
859
871
  interface VaLinkAction {
860
872
  /**
@@ -885,7 +897,7 @@ export namespace Components {
885
897
  /**
886
898
  * @componentName Loading indicator
887
899
  * @maturityCategory use
888
- * @maturityLevel best_practice
900
+ * @maturityLevel deployed
889
901
  */
890
902
  interface VaLoadingIndicator {
891
903
  /**
@@ -907,8 +919,8 @@ export namespace Components {
907
919
  }
908
920
  /**
909
921
  * @componentName Banner - Maintenance
910
- * @maturityCategory caution
911
- * @maturityLevel available
922
+ * @maturityCategory use
923
+ * @maturityLevel deployed
912
924
  */
913
925
  interface VaMaintenanceBanner {
914
926
  /**
@@ -946,8 +958,8 @@ export namespace Components {
946
958
  }
947
959
  /**
948
960
  * @componentName Memorable date
949
- * @maturityCategory caution
950
- * @maturityLevel available
961
+ * @maturityCategory use
962
+ * @maturityLevel deployed
951
963
  * @guidanceHref form/memorable-date
952
964
  * @translations English
953
965
  * @translations Spanish
@@ -1016,7 +1028,7 @@ export namespace Components {
1016
1028
  /**
1017
1029
  * @componentName Minimal Footer
1018
1030
  * @maturityCategory caution
1019
- * @maturityLevel candidate
1031
+ * @maturityLevel available
1020
1032
  */
1021
1033
  interface VaMinimalFooter {
1022
1034
  }
@@ -1025,7 +1037,7 @@ export namespace Components {
1025
1037
  * @keydown Used to detect Escape key to close modal.
1026
1038
  * @componentName Modal
1027
1039
  * @maturityCategory use
1028
- * @maturityLevel deployed
1040
+ * @maturityLevel best_practice
1029
1041
  */
1030
1042
  interface VaModal {
1031
1043
  /**
@@ -1076,8 +1088,8 @@ export namespace Components {
1076
1088
  }
1077
1089
  /**
1078
1090
  * @componentName Need help?
1079
- * @maturityCategory caution
1080
- * @maturityLevel candidate
1091
+ * @maturityCategory use
1092
+ * @maturityLevel deployed
1081
1093
  * @guidanceHref form/need-help
1082
1094
  */
1083
1095
  interface VaNeedHelp {
@@ -1139,8 +1151,8 @@ export namespace Components {
1139
1151
  }
1140
1152
  /**
1141
1153
  * @componentName Banner - Official Gov
1142
- * @maturityCategory caution
1143
- * @maturityLevel candidate
1154
+ * @maturityCategory use
1155
+ * @maturityLevel best_practice
1144
1156
  */
1145
1157
  interface VaOfficialGovBanner {
1146
1158
  /**
@@ -1226,8 +1238,8 @@ export namespace Components {
1226
1238
  }
1227
1239
  /**
1228
1240
  * @componentName Privacy agreement
1229
- * @maturityCategory caution
1230
- * @maturityLevel available
1241
+ * @maturityCategory use
1242
+ * @maturityLevel deployed
1231
1243
  */
1232
1244
  interface VaPrivacyAgreement {
1233
1245
  /**
@@ -1246,7 +1258,7 @@ export namespace Components {
1246
1258
  /**
1247
1259
  * @componentName Process list
1248
1260
  * @maturityCategory use
1249
- * @maturityLevel deployed
1261
+ * @maturityLevel best_practice
1250
1262
  */
1251
1263
  interface VaProcessList {
1252
1264
  }
@@ -1279,7 +1291,7 @@ export namespace Components {
1279
1291
  /**
1280
1292
  * @componentName Progress bar - activity
1281
1293
  * @maturityCategory use
1282
- * @maturityLevel deployed
1294
+ * @maturityLevel best_practice
1283
1295
  */
1284
1296
  interface VaProgressBar {
1285
1297
  /**
@@ -1320,7 +1332,7 @@ export namespace Components {
1320
1332
  * @radioOptionSelected The event emitted when the selected option value changes.
1321
1333
  * @componentName Radio button
1322
1334
  * @maturityCategory use
1323
- * @maturityLevel deployed
1335
+ * @maturityLevel best_practice
1324
1336
  * @guidanceHref form/radio-button
1325
1337
  * @translations English
1326
1338
  * @translations Spanish
@@ -1409,7 +1421,7 @@ export namespace Components {
1409
1421
  /**
1410
1422
  * @componentName Search input
1411
1423
  * @maturityCategory use
1412
- * @maturityLevel deployed
1424
+ * @maturityLevel best_practice
1413
1425
  */
1414
1426
  interface VaSearchInput {
1415
1427
  /**
@@ -1497,7 +1509,7 @@ export namespace Components {
1497
1509
  * @nativeHandler onKeyDown
1498
1510
  * @componentName Select
1499
1511
  * @maturityCategory use
1500
- * @maturityLevel deployed
1512
+ * @maturityLevel best_practice
1501
1513
  * @guidanceHref form/select
1502
1514
  * @translations English
1503
1515
  * @translations Spanish
@@ -1511,6 +1523,18 @@ export namespace Components {
1511
1523
  * Error message to display. When defined, this indicates an error.
1512
1524
  */
1513
1525
  "error"?: string;
1526
+ /**
1527
+ * The content of the heading if `useFormsPattern` is true.
1528
+ */
1529
+ "formHeading"?: string;
1530
+ /**
1531
+ * The heading level for the heading if `useFormsPattern` is true.
1532
+ */
1533
+ "formHeadingLevel"?: number;
1534
+ /**
1535
+ * If true, sets the select to take the full-width of its container
1536
+ */
1537
+ "fullWidth"?: boolean;
1514
1538
  /**
1515
1539
  * Optional hint text.
1516
1540
  */
@@ -1543,20 +1567,63 @@ export namespace Components {
1543
1567
  * Whether an error message should be shown - set to false when this component is used inside va-date or va-memorable-date in which the error for the va-select will be rendered outside of va-select
1544
1568
  */
1545
1569
  "showError"?: boolean;
1570
+ /**
1571
+ * Enabling this will add a heading and description for integrating into the forms pattern. Accepts `single` or `multiple` to indicate if the form is a single input or will have multiple inputs
1572
+ */
1573
+ "useFormsPattern"?: string;
1546
1574
  /**
1547
1575
  * Selected value (will get updated on select).
1548
1576
  */
1549
1577
  "value"?: string;
1550
1578
  /**
1551
- * Displays the select at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex).
1579
+ * Displays the select at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex). Defined in USWDS here: https://github.com/uswds/uswds/blob/develop/packages/uswds-core/src/styles/tokens/units/input-widths.scss
1552
1580
  */
1553
1581
  "width"?: string;
1554
1582
  }
1555
1583
  /**
1556
- * @componentName Statement of truth
1584
+ * @componentName Service list item
1557
1585
  * @maturityCategory caution
1558
1586
  * @maturityLevel candidate
1559
1587
  */
1588
+ interface VaServiceListItem {
1589
+ /**
1590
+ * Action associated with the service
1591
+ */
1592
+ "action"?: ServiceAction | string;
1593
+ /**
1594
+ * The icon associated with the service
1595
+ */
1596
+ "icon"?: string;
1597
+ /**
1598
+ * An optional link related to the service
1599
+ */
1600
+ "optionalLink"?: OptionalLink | string;
1601
+ /**
1602
+ * Details about the service
1603
+ */
1604
+ "serviceDetails": ServiceDetails | string;
1605
+ /**
1606
+ * The link to the service page
1607
+ */
1608
+ "serviceLink": string;
1609
+ /**
1610
+ * The name of the service
1611
+ */
1612
+ "serviceName": string;
1613
+ /**
1614
+ * The heading level for the service name (defaults to h3)
1615
+ */
1616
+ "serviceNameHeadingLevel": number;
1617
+ /**
1618
+ * The status of the service
1619
+ */
1620
+ "serviceStatus": string;
1621
+ }
1622
+ /**
1623
+ * @componentName Statement of truth
1624
+ * @maturityCategory use
1625
+ * @maturityLevel deployed
1626
+ */
1560
1627
  interface VaStatementOfTruth {
1561
1628
  /**
1562
1629
  * The error to be applied to the va-check-box element
@@ -1598,11 +1665,20 @@ export namespace Components {
1598
1665
  */
1599
1666
  interface VaSummaryBox {
1600
1667
  }
1668
+ /**
1669
+ * @componentName Table
1670
+ * @maturityCategory caution
1671
+ * @maturityLevel available
1672
+ */
1601
1673
  interface VaTable {
1602
1674
  /**
1603
1675
  * When active, forces the table to expand to the full-width of its container
1604
1676
  */
1605
1677
  "fullWidth"?: boolean;
1678
+ /**
1679
+ * A comma-separated, zero-indexed string of which columns, if any, should be right-aligned
1680
+ */
1681
+ "rightAlignCols"?: string;
1606
1682
  /**
1607
1683
  * When active, the table can be horizontally scrolled and is focusable
1608
1684
  */
@@ -1642,6 +1718,10 @@ export namespace Components {
1642
1718
  * When active, the table will expand to the full width of its container
1643
1719
  */
1644
1720
  "fullWidth": boolean;
1721
+ /**
1722
+ * A comma-separated, zero-indexed string of which columns, if any, should be right-aligned
1723
+ */
1724
+ "rightAlignCols"?: string;
1645
1725
  "rows"?: number;
1646
1726
  /**
1647
1727
  * When active, the table can be horizontally scrolled and is focusable
@@ -1718,7 +1798,7 @@ export namespace Components {
1718
1798
  * @nativeHandler onBlur
1719
1799
  * @componentName Text input
1720
1800
  * @maturityCategory use
1721
- * @maturityLevel deployed
1801
+ * @maturityLevel best_practice
1722
1802
  * @guidanceHref form/text-input
1723
1803
  * @translations English
1724
1804
  * @translations Spanish
@@ -1857,7 +1937,7 @@ export namespace Components {
1857
1937
  * @nativeHandler onBlur
1858
1938
  * @componentName Textarea
1859
1939
  * @maturityCategory use
1860
- * @maturityLevel deployed
1940
+ * @maturityLevel best_practice
1861
1941
  * @guidanceHref form/textarea
1862
1942
  * @translations English
1863
1943
  * @translations Spanish
@@ -2140,7 +2220,7 @@ declare global {
2140
2220
  /**
2141
2221
  * @componentName Additional info
2142
2222
  * @maturityCategory use
2143
- * @maturityLevel deployed
2223
+ * @maturityLevel best_practice
2144
2224
  */
2145
2225
  interface HTMLVaAdditionalInfoElement extends Components.VaAdditionalInfo, HTMLStencilElement {
2146
2226
  addEventListener<K extends keyof HTMLVaAdditionalInfoElementEventMap>(type: K, listener: (this: HTMLVaAdditionalInfoElement, ev: VaAdditionalInfoCustomEvent<HTMLVaAdditionalInfoElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2186,8 +2266,8 @@ declare global {
2186
2266
  /**
2187
2267
  * @componentName Alert - expandable
2188
2268
  * @guidanceHref alert/alert-expandable
2189
- * @maturityCategory caution
2190
- * @maturityLevel candidate
2269
+ * @maturityCategory use
2270
+ * @maturityLevel deployed
2191
2271
  */
2192
2272
  interface HTMLVaAlertExpandableElement extends Components.VaAlertExpandable, HTMLStencilElement {
2193
2273
  addEventListener<K extends keyof HTMLVaAlertExpandableElementEventMap>(type: K, listener: (this: HTMLVaAlertExpandableElement, ev: VaAlertExpandableCustomEvent<HTMLVaAlertExpandableElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2277,8 +2357,8 @@ declare global {
2277
2357
  /**
2278
2358
  * @componentName Button
2279
2359
  * @nativeHandler onClick
2280
- * @maturityCategory caution
2281
- * @maturityLevel candidate
2360
+ * @maturityCategory use
2361
+ * @maturityLevel deployed
2282
2362
  */
2283
2363
  interface HTMLVaButtonElement extends Components.VaButton, HTMLStencilElement {
2284
2364
  addEventListener<K extends keyof HTMLVaButtonElementEventMap>(type: K, listener: (this: HTMLVaButtonElement, ev: VaButtonCustomEvent<HTMLVaButtonElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2301,7 +2381,7 @@ declare global {
2301
2381
  * @componentName Button - Icon
2302
2382
  * @nativeHandler onClick
2303
2383
  * @maturityCategory caution
2304
- * @maturityLevel candidate
2384
+ * @maturityLevel available
2305
2385
  */
2306
2386
  interface HTMLVaButtonIconElement extends Components.VaButtonIcon, HTMLStencilElement {
2307
2387
  addEventListener<K extends keyof HTMLVaButtonIconElementEventMap>(type: K, listener: (this: HTMLVaButtonIconElement, ev: VaButtonIconCustomEvent<HTMLVaButtonIconElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2324,8 +2404,8 @@ declare global {
2324
2404
  }
2325
2405
  /**
2326
2406
  * @componentName Button pair
2327
- * @maturityCategory caution
2328
- * @maturityLevel candidate
2407
+ * @maturityCategory use
2408
+ * @maturityLevel deployed
2329
2409
  * @guidanceHref button/button-pair
2330
2410
  */
2331
2411
  interface HTMLVaButtonPairElement extends Components.VaButtonPair, HTMLStencilElement {
@@ -2344,8 +2424,8 @@ declare global {
2344
2424
  };
2345
2425
  /**
2346
2426
  * @componentName Card
2347
- * @maturityCategory caution
2348
- * @maturityLevel candidate
2427
+ * @maturityCategory use
2428
+ * @maturityLevel deployed
2349
2429
  */
2350
2430
  interface HTMLVaCardElement extends Components.VaCard, HTMLStencilElement {
2351
2431
  }
@@ -2436,7 +2516,7 @@ declare global {
2436
2516
  /**
2437
2517
  * @componentName Crisis Line Modal
2438
2518
  * @maturityCategory caution
2439
- * @maturityLevel candidate
2519
+ * @maturityLevel available
2440
2520
  */
2441
2521
  interface HTMLVaCrisisLineModalElement extends Components.VaCrisisLineModal, HTMLStencilElement {
2442
2522
  }
@@ -2521,7 +2601,7 @@ declare global {
2521
2601
  /**
2522
2602
  * @componentName Header - Minimal
2523
2603
  * @maturityCategory caution
2524
- * @maturityLevel candidate
2604
+ * @maturityLevel available
2525
2605
  * @guidanceHref header/header-minimal
2526
2606
  */
2527
2607
  interface HTMLVaHeaderMinimalElement extends Components.VaHeaderMinimal, HTMLStencilElement {
@@ -2533,7 +2613,7 @@ declare global {
2533
2613
  /**
2534
2614
  * @componentName Icon
2535
2615
  * @maturityCategory caution
2536
- * @maturityLevel candidate
2616
+ * @maturityLevel available
2537
2617
  */
2538
2618
  interface HTMLVaIconElement extends Components.VaIcon, HTMLStencilElement {
2539
2619
  }
@@ -2548,7 +2628,7 @@ declare global {
2548
2628
  /**
2549
2629
  * @componentName Language Toggle
2550
2630
  * @maturityCategory caution
2551
- * @maturityLevel candidate
2631
+ * @maturityLevel available
2552
2632
  */
2553
2633
  interface HTMLVaLanguageToggleElement extends Components.VaLanguageToggle, HTMLStencilElement {
2554
2634
  addEventListener<K extends keyof HTMLVaLanguageToggleElementEventMap>(type: K, listener: (this: HTMLVaLanguageToggleElement, ev: VaLanguageToggleCustomEvent<HTMLVaLanguageToggleElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2569,8 +2649,8 @@ declare global {
2569
2649
  }
2570
2650
  /**
2571
2651
  * @componentName Link
2572
- * @maturityCategory caution
2573
- * @maturityLevel candidate
2652
+ * @maturityCategory use
2653
+ * @maturityLevel deployed
2574
2654
  */
2575
2655
  interface HTMLVaLinkElement extends Components.VaLink, HTMLStencilElement {
2576
2656
  addEventListener<K extends keyof HTMLVaLinkElementEventMap>(type: K, listener: (this: HTMLVaLinkElement, ev: VaLinkCustomEvent<HTMLVaLinkElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2591,8 +2671,10 @@ declare global {
2591
2671
  }
2592
2672
  /**
2593
2673
  * @componentName Link - Action
2594
- * @maturityCategory caution
2595
- * @maturityLevel candidate
2674
+ * @maturityCategory use
2675
+ * @maturityLevel deployed
2676
+ * @guidanceHref link/action
2677
+ * @guidanceName Action link
2596
2678
  */
2597
2679
  interface HTMLVaLinkActionElement extends Components.VaLinkAction, HTMLStencilElement {
2598
2680
  addEventListener<K extends keyof HTMLVaLinkActionElementEventMap>(type: K, listener: (this: HTMLVaLinkActionElement, ev: VaLinkActionCustomEvent<HTMLVaLinkActionElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2614,7 +2696,7 @@ declare global {
2614
2696
  /**
2615
2697
  * @componentName Loading indicator
2616
2698
  * @maturityCategory use
2617
- * @maturityLevel best_practice
2699
+ * @maturityLevel deployed
2618
2700
  */
2619
2701
  interface HTMLVaLoadingIndicatorElement extends Components.VaLoadingIndicator, HTMLStencilElement {
2620
2702
  addEventListener<K extends keyof HTMLVaLoadingIndicatorElementEventMap>(type: K, listener: (this: HTMLVaLoadingIndicatorElement, ev: VaLoadingIndicatorCustomEvent<HTMLVaLoadingIndicatorElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2636,8 +2718,8 @@ declare global {
2636
2718
  }
2637
2719
  /**
2638
2720
  * @componentName Banner - Maintenance
2639
- * @maturityCategory caution
2640
- * @maturityLevel available
2721
+ * @maturityCategory use
2722
+ * @maturityLevel deployed
2641
2723
  */
2642
2724
  interface HTMLVaMaintenanceBannerElement extends Components.VaMaintenanceBanner, HTMLStencilElement {
2643
2725
  addEventListener<K extends keyof HTMLVaMaintenanceBannerElementEventMap>(type: K, listener: (this: HTMLVaMaintenanceBannerElement, ev: VaMaintenanceBannerCustomEvent<HTMLVaMaintenanceBannerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2660,8 +2742,8 @@ declare global {
2660
2742
  }
2661
2743
  /**
2662
2744
  * @componentName Memorable date
2663
- * @maturityCategory caution
2664
- * @maturityLevel available
2745
+ * @maturityCategory use
2746
+ * @maturityLevel deployed
2665
2747
  * @guidanceHref form/memorable-date
2666
2748
  * @translations English
2667
2749
  * @translations Spanish
@@ -2683,7 +2765,7 @@ declare global {
2683
2765
  /**
2684
2766
  * @componentName Minimal Footer
2685
2767
  * @maturityCategory caution
2686
- * @maturityLevel candidate
2768
+ * @maturityLevel available
2687
2769
  */
2688
2770
  interface HTMLVaMinimalFooterElement extends Components.VaMinimalFooter, HTMLStencilElement {
2689
2771
  }
@@ -2702,7 +2784,7 @@ declare global {
2702
2784
  * @keydown Used to detect Escape key to close modal.
2703
2785
  * @componentName Modal
2704
2786
  * @maturityCategory use
2705
- * @maturityLevel deployed
2787
+ * @maturityLevel best_practice
2706
2788
  */
2707
2789
  interface HTMLVaModalElement extends Components.VaModal, HTMLStencilElement {
2708
2790
  addEventListener<K extends keyof HTMLVaModalElementEventMap>(type: K, listener: (this: HTMLVaModalElement, ev: VaModalCustomEvent<HTMLVaModalElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2720,8 +2802,8 @@ declare global {
2720
2802
  };
2721
2803
  /**
2722
2804
  * @componentName Need help?
2723
- * @maturityCategory caution
2724
- * @maturityLevel candidate
2805
+ * @maturityCategory use
2806
+ * @maturityLevel deployed
2725
2807
  * @guidanceHref form/need-help
2726
2808
  */
2727
2809
  interface HTMLVaNeedHelpElement extends Components.VaNeedHelp, HTMLStencilElement {
@@ -2758,8 +2840,8 @@ declare global {
2758
2840
  }
2759
2841
  /**
2760
2842
  * @componentName Banner - Official Gov
2761
- * @maturityCategory caution
2762
- * @maturityLevel candidate
2843
+ * @maturityCategory use
2844
+ * @maturityLevel best_practice
2763
2845
  */
2764
2846
  interface HTMLVaOfficialGovBannerElement extends Components.VaOfficialGovBanner, HTMLStencilElement {
2765
2847
  addEventListener<K extends keyof HTMLVaOfficialGovBannerElementEventMap>(type: K, listener: (this: HTMLVaOfficialGovBannerElement, ev: VaOfficialGovBannerCustomEvent<HTMLVaOfficialGovBannerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2840,8 +2922,8 @@ declare global {
2840
2922
  }
2841
2923
  /**
2842
2924
  * @componentName Privacy agreement
2843
- * @maturityCategory caution
2844
- * @maturityLevel available
2925
+ * @maturityCategory use
2926
+ * @maturityLevel deployed
2845
2927
  */
2846
2928
  interface HTMLVaPrivacyAgreementElement extends Components.VaPrivacyAgreement, HTMLStencilElement {
2847
2929
  addEventListener<K extends keyof HTMLVaPrivacyAgreementElementEventMap>(type: K, listener: (this: HTMLVaPrivacyAgreementElement, ev: VaPrivacyAgreementCustomEvent<HTMLVaPrivacyAgreementElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2860,7 +2942,7 @@ declare global {
2860
2942
  /**
2861
2943
  * @componentName Process list
2862
2944
  * @maturityCategory use
2863
- * @maturityLevel deployed
2945
+ * @maturityLevel best_practice
2864
2946
  */
2865
2947
  interface HTMLVaProcessListElement extends Components.VaProcessList, HTMLStencilElement {
2866
2948
  }
@@ -2880,7 +2962,7 @@ declare global {
2880
2962
  /**
2881
2963
  * @componentName Progress bar - activity
2882
2964
  * @maturityCategory use
2883
- * @maturityLevel deployed
2965
+ * @maturityLevel best_practice
2884
2966
  */
2885
2967
  interface HTMLVaProgressBarElement extends Components.VaProgressBar, HTMLStencilElement {
2886
2968
  addEventListener<K extends keyof HTMLVaProgressBarElementEventMap>(type: K, listener: (this: HTMLVaProgressBarElement, ev: VaProgressBarCustomEvent<HTMLVaProgressBarElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2929,7 +3011,7 @@ declare global {
2929
3011
  * @radioOptionSelected The event emitted when the selected option value changes.
2930
3012
  * @componentName Radio button
2931
3013
  * @maturityCategory use
2932
- * @maturityLevel deployed
3014
+ * @maturityLevel best_practice
2933
3015
  * @guidanceHref form/radio-button
2934
3016
  * @translations English
2935
3017
  * @translations Spanish
@@ -2972,7 +3054,7 @@ declare global {
2972
3054
  /**
2973
3055
  * @componentName Search input
2974
3056
  * @maturityCategory use
2975
- * @maturityLevel deployed
3057
+ * @maturityLevel best_practice
2976
3058
  */
2977
3059
  interface HTMLVaSearchInputElement extends Components.VaSearchInput, HTMLStencilElement {
2978
3060
  addEventListener<K extends keyof HTMLVaSearchInputElementEventMap>(type: K, listener: (this: HTMLVaSearchInputElement, ev: VaSearchInputCustomEvent<HTMLVaSearchInputElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -3021,7 +3103,7 @@ declare global {
3021
3103
  * @nativeHandler onKeyDown
3022
3104
  * @componentName Select
3023
3105
  * @maturityCategory use
3024
- * @maturityLevel deployed
3106
+ * @maturityLevel best_practice
3025
3107
  * @guidanceHref form/select
3026
3108
  * @translations English
3027
3109
  * @translations Spanish
@@ -3040,6 +3122,17 @@ declare global {
3040
3122
  prototype: HTMLVaSelectElement;
3041
3123
  new (): HTMLVaSelectElement;
3042
3124
  };
3125
+ /**
3126
+ * @componentName Service list item
3127
+ * @maturityCategory caution
3128
+ * @maturityLevel candidate
3129
+ */
3130
+ interface HTMLVaServiceListItemElement extends Components.VaServiceListItem, HTMLStencilElement {
3131
+ }
3132
+ var HTMLVaServiceListItemElement: {
3133
+ prototype: HTMLVaServiceListItemElement;
3134
+ new (): HTMLVaServiceListItemElement;
3135
+ };
3043
3136
  interface HTMLVaStatementOfTruthElementEventMap {
3044
3137
  "vaInputChange": any;
3045
3138
  "vaInputBlur": any;
@@ -3047,8 +3140,8 @@ declare global {
3047
3140
  }
3048
3141
  /**
3049
3142
  * @componentName Statement of truth
3050
- * @maturityCategory caution
3051
- * @maturityLevel candidate
3143
+ * @maturityCategory use
3144
+ * @maturityLevel deployed
3052
3145
  */
3053
3146
  interface HTMLVaStatementOfTruthElement extends Components.VaStatementOfTruth, HTMLStencilElement {
3054
3147
  addEventListener<K extends keyof HTMLVaStatementOfTruthElementEventMap>(type: K, listener: (this: HTMLVaStatementOfTruthElement, ev: VaStatementOfTruthCustomEvent<HTMLVaStatementOfTruthElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -3075,6 +3168,11 @@ declare global {
3075
3168
  prototype: HTMLVaSummaryBoxElement;
3076
3169
  new (): HTMLVaSummaryBoxElement;
3077
3170
  };
3171
+ /**
3172
+ * @componentName Table
3173
+ * @maturityCategory caution
3174
+ * @maturityLevel available
3175
+ */
3078
3176
  interface HTMLVaTableElement extends Components.VaTable, HTMLStencilElement {
3079
3177
  }
3080
3178
  var HTMLVaTableElement: {
@@ -3139,7 +3237,7 @@ declare global {
3139
3237
  * @nativeHandler onBlur
3140
3238
  * @componentName Text input
3141
3239
  * @maturityCategory use
3142
- * @maturityLevel deployed
3240
+ * @maturityLevel best_practice
3143
3241
  * @guidanceHref form/text-input
3144
3242
  * @translations English
3145
3243
  * @translations Spanish
@@ -3167,7 +3265,7 @@ declare global {
3167
3265
  * @nativeHandler onBlur
3168
3266
  * @componentName Textarea
3169
3267
  * @maturityCategory use
3170
- * @maturityLevel deployed
3268
+ * @maturityLevel best_practice
3171
3269
  * @guidanceHref form/textarea
3172
3270
  * @translations English
3173
3271
  * @translations Spanish
@@ -3233,6 +3331,7 @@ declare global {
3233
3331
  "va-search-input": HTMLVaSearchInputElement;
3234
3332
  "va-segmented-progress-bar": HTMLVaSegmentedProgressBarElement;
3235
3333
  "va-select": HTMLVaSelectElement;
3334
+ "va-service-list-item": HTMLVaServiceListItemElement;
3236
3335
  "va-statement-of-truth": HTMLVaStatementOfTruthElement;
3237
3336
  "va-summary-box": HTMLVaSummaryBoxElement;
3238
3337
  "va-table": HTMLVaTableElement;
@@ -3304,7 +3403,7 @@ declare namespace LocalJSX {
3304
3403
  /**
3305
3404
  * @componentName Additional info
3306
3405
  * @maturityCategory use
3307
- * @maturityLevel deployed
3406
+ * @maturityLevel best_practice
3308
3407
  */
3309
3408
  interface VaAdditionalInfo {
3310
3409
  /**
@@ -3378,8 +3477,8 @@ declare namespace LocalJSX {
3378
3477
  /**
3379
3478
  * @componentName Alert - expandable
3380
3479
  * @guidanceHref alert/alert-expandable
3381
- * @maturityCategory caution
3382
- * @maturityLevel candidate
3480
+ * @maturityCategory use
3481
+ * @maturityLevel deployed
3383
3482
  */
3384
3483
  interface VaAlertExpandable {
3385
3484
  /**
@@ -3423,7 +3522,7 @@ declare namespace LocalJSX {
3423
3522
  */
3424
3523
  "timeLimit"?: string;
3425
3524
  /**
3426
- * **Required.** Determines the text content and border/background color. Must be one of "signInRequired", "signInOptional", "signInEither", "verifyIdMe", or "verifyLoginGov".
3525
+ * **Required.** Determines the text content and border/background color. Must be one of "signInRequired", "signInOptional", "signInOptionalNoPrefill", "signInEither", "verifyIdMe", or "verifyLoginGov".
3427
3526
  */
3428
3527
  "variant"?: string;
3429
3528
  /**
@@ -3519,8 +3618,8 @@ declare namespace LocalJSX {
3519
3618
  /**
3520
3619
  * @componentName Button
3521
3620
  * @nativeHandler onClick
3522
- * @maturityCategory caution
3523
- * @maturityLevel candidate
3621
+ * @maturityCategory use
3622
+ * @maturityLevel deployed
3524
3623
  */
3525
3624
  interface VaButton {
3526
3625
  /**
@@ -3543,6 +3642,10 @@ declare namespace LocalJSX {
3543
3642
  * If `true`, the click event will not fire.
3544
3643
  */
3545
3644
  "disabled"?: boolean;
3645
+ /**
3646
+ * If `true`, the button will expand to the full available width of its container.
3647
+ */
3648
+ "fullWidth"?: boolean;
3546
3649
  /**
3547
3650
  * The aria-label of the component.
3548
3651
  */
@@ -3580,7 +3683,7 @@ declare namespace LocalJSX {
3580
3683
  * @componentName Button - Icon
3581
3684
  * @nativeHandler onClick
3582
3685
  * @maturityCategory caution
3583
- * @maturityLevel candidate
3686
+ * @maturityLevel available
3584
3687
  */
3585
3688
  interface VaButtonIcon {
3586
3689
  "buttonType"?: keyof typeof this.buttonTypeMap;
@@ -3599,8 +3702,8 @@ declare namespace LocalJSX {
3599
3702
  }
3600
3703
  /**
3601
3704
  * @componentName Button pair
3602
- * @maturityCategory caution
3603
- * @maturityLevel candidate
3705
+ * @maturityCategory use
3706
+ * @maturityLevel deployed
3604
3707
  * @guidanceHref button/button-pair
3605
3708
  */
3606
3709
  interface VaButtonPair {
@@ -3651,8 +3754,8 @@ declare namespace LocalJSX {
3651
3754
  }
3652
3755
  /**
3653
3756
  * @componentName Card
3654
- * @maturityCategory caution
3655
- * @maturityLevel candidate
3757
+ * @maturityCategory use
3758
+ * @maturityLevel deployed
3656
3759
  */
3657
3760
  interface VaCard {
3658
3761
  /**
@@ -3845,7 +3948,7 @@ declare namespace LocalJSX {
3845
3948
  /**
3846
3949
  * @componentName Crisis Line Modal
3847
3950
  * @maturityCategory caution
3848
- * @maturityLevel candidate
3951
+ * @maturityLevel available
3849
3952
  */
3850
3953
  interface VaCrisisLineModal {
3851
3954
  }
@@ -3963,6 +4066,10 @@ declare namespace LocalJSX {
3963
4066
  * The event emitted when the file input value changes.
3964
4067
  */
3965
4068
  "onVaChange"?: (event: VaFileInputCustomEvent<any>) => void;
4069
+ /**
4070
+ * Percent upload completed. For use with va-progress-bar component
4071
+ */
4072
+ "percentUploaded"?: number;
3966
4073
  /**
3967
4074
  * Optionally displays the read-only view
3968
4075
  */
@@ -4049,7 +4156,7 @@ declare namespace LocalJSX {
4049
4156
  /**
4050
4157
  * @componentName Header - Minimal
4051
4158
  * @maturityCategory caution
4052
- * @maturityLevel candidate
4159
+ * @maturityLevel available
4053
4160
  * @guidanceHref header/header-minimal
4054
4161
  */
4055
4162
  interface VaHeaderMinimal {
@@ -4063,7 +4170,7 @@ declare namespace LocalJSX {
4063
4170
  /**
4064
4171
  * @componentName Icon
4065
4172
  * @maturityCategory caution
4066
- * @maturityLevel candidate
4173
+ * @maturityLevel available
4067
4174
  */
4068
4175
  interface VaIcon {
4069
4176
  /**
@@ -4082,7 +4189,7 @@ declare namespace LocalJSX {
4082
4189
  /**
4083
4190
  * @componentName Language Toggle
4084
4191
  * @maturityCategory caution
4085
- * @maturityLevel candidate
4192
+ * @maturityLevel available
4086
4193
  */
4087
4194
  interface VaLanguageToggle {
4088
4195
  /**
@@ -4116,8 +4223,8 @@ declare namespace LocalJSX {
4116
4223
  }
4117
4224
  /**
4118
4225
  * @componentName Link
4119
- * @maturityCategory caution
4120
- * @maturityLevel candidate
4226
+ * @maturityCategory use
4227
+ * @maturityLevel deployed
4121
4228
  */
4122
4229
  interface VaLink {
4123
4230
  /**
@@ -4149,7 +4256,7 @@ declare namespace LocalJSX {
4149
4256
  */
4150
4257
  "download"?: boolean;
4151
4258
  /**
4152
- * If 'true', will open in a new tab and have icon denoting that. Will also have the text "opens in a new tab" appended to the link text in screen reader only span
4259
+ * If 'true', will open in a new tab and will have the text "opens in a new tab" appended to the link text in screen reader only span
4153
4260
  */
4154
4261
  "external"?: boolean;
4155
4262
  /**
@@ -4200,8 +4307,10 @@ declare namespace LocalJSX {
4200
4307
  }
4201
4308
  /**
4202
4309
  * @componentName Link - Action
4203
- * @maturityCategory caution
4204
- * @maturityLevel candidate
4310
+ * @maturityCategory use
4311
+ * @maturityLevel deployed
4312
+ * @guidanceHref link/action
4313
+ * @guidanceName Action link
4205
4314
  */
4206
4315
  interface VaLinkAction {
4207
4316
  /**
@@ -4236,7 +4345,7 @@ declare namespace LocalJSX {
4236
4345
  /**
4237
4346
  * @componentName Loading indicator
4238
4347
  * @maturityCategory use
4239
- * @maturityLevel best_practice
4348
+ * @maturityLevel deployed
4240
4349
  */
4241
4350
  interface VaLoadingIndicator {
4242
4351
  /**
@@ -4262,8 +4371,8 @@ declare namespace LocalJSX {
4262
4371
  }
4263
4372
  /**
4264
4373
  * @componentName Banner - Maintenance
4265
- * @maturityCategory caution
4266
- * @maturityLevel available
4374
+ * @maturityCategory use
4375
+ * @maturityLevel deployed
4267
4376
  */
4268
4377
  interface VaMaintenanceBanner {
4269
4378
  /**
@@ -4309,8 +4418,8 @@ declare namespace LocalJSX {
4309
4418
  }
4310
4419
  /**
4311
4420
  * @componentName Memorable date
4312
- * @maturityCategory caution
4313
- * @maturityLevel available
4421
+ * @maturityCategory use
4422
+ * @maturityLevel deployed
4314
4423
  * @guidanceHref form/memorable-date
4315
4424
  * @translations English
4316
4425
  * @translations Spanish
@@ -4391,7 +4500,7 @@ declare namespace LocalJSX {
4391
4500
  /**
4392
4501
  * @componentName Minimal Footer
4393
4502
  * @maturityCategory caution
4394
- * @maturityLevel candidate
4503
+ * @maturityLevel available
4395
4504
  */
4396
4505
  interface VaMinimalFooter {
4397
4506
  }
@@ -4400,7 +4509,7 @@ declare namespace LocalJSX {
4400
4509
  * @keydown Used to detect Escape key to close modal.
4401
4510
  * @componentName Modal
4402
4511
  * @maturityCategory use
4403
- * @maturityLevel deployed
4512
+ * @maturityLevel best_practice
4404
4513
  */
4405
4514
  interface VaModal {
4406
4515
  /**
@@ -4467,8 +4576,8 @@ declare namespace LocalJSX {
4467
4576
  }
4468
4577
  /**
4469
4578
  * @componentName Need help?
4470
- * @maturityCategory caution
4471
- * @maturityLevel candidate
4579
+ * @maturityCategory use
4580
+ * @maturityLevel deployed
4472
4581
  * @guidanceHref form/need-help
4473
4582
  */
4474
4583
  interface VaNeedHelp {
@@ -4538,8 +4647,8 @@ declare namespace LocalJSX {
4538
4647
  }
4539
4648
  /**
4540
4649
  * @componentName Banner - Official Gov
4541
- * @maturityCategory caution
4542
- * @maturityLevel candidate
4650
+ * @maturityCategory use
4651
+ * @maturityLevel best_practice
4543
4652
  */
4544
4653
  interface VaOfficialGovBanner {
4545
4654
  /**
@@ -4641,8 +4750,8 @@ declare namespace LocalJSX {
4641
4750
  }
4642
4751
  /**
4643
4752
  * @componentName Privacy agreement
4644
- * @maturityCategory caution
4645
- * @maturityLevel available
4753
+ * @maturityCategory use
4754
+ * @maturityLevel deployed
4646
4755
  */
4647
4756
  interface VaPrivacyAgreement {
4648
4757
  /**
@@ -4669,7 +4778,7 @@ declare namespace LocalJSX {
4669
4778
  /**
4670
4779
  * @componentName Process list
4671
4780
  * @maturityCategory use
4672
- * @maturityLevel deployed
4781
+ * @maturityLevel best_practice
4673
4782
  */
4674
4783
  interface VaProcessList {
4675
4784
  }
@@ -4702,7 +4811,7 @@ declare namespace LocalJSX {
4702
4811
  /**
4703
4812
  * @componentName Progress bar - activity
4704
4813
  * @maturityCategory use
4705
- * @maturityLevel deployed
4814
+ * @maturityLevel best_practice
4706
4815
  */
4707
4816
  interface VaProgressBar {
4708
4817
  /**
@@ -4755,7 +4864,7 @@ declare namespace LocalJSX {
4755
4864
  * @radioOptionSelected The event emitted when the selected option value changes.
4756
4865
  * @componentName Radio button
4757
4866
  * @maturityCategory use
4758
- * @maturityLevel deployed
4867
+ * @maturityLevel best_practice
4759
4868
  * @guidanceHref form/radio-button
4760
4869
  * @translations English
4761
4870
  * @translations Spanish
@@ -4856,7 +4965,7 @@ declare namespace LocalJSX {
4856
4965
  /**
4857
4966
  * @componentName Search input
4858
4967
  * @maturityCategory use
4859
- * @maturityLevel deployed
4968
+ * @maturityLevel best_practice
4860
4969
  */
4861
4970
  interface VaSearchInput {
4862
4971
  /**
@@ -4952,7 +5061,7 @@ declare namespace LocalJSX {
4952
5061
  * @nativeHandler onKeyDown
4953
5062
  * @componentName Select
4954
5063
  * @maturityCategory use
4955
- * @maturityLevel deployed
5064
+ * @maturityLevel best_practice
4956
5065
  * @guidanceHref form/select
4957
5066
  * @translations English
4958
5067
  * @translations Spanish
@@ -4966,6 +5075,18 @@ declare namespace LocalJSX {
4966
5075
  * Error message to display. When defined, this indicates an error.
4967
5076
  */
4968
5077
  "error"?: string;
5078
+ /**
5079
+ * The content of the heading if `useFormsPattern` is true.
5080
+ */
5081
+ "formHeading"?: string;
5082
+ /**
5083
+ * The heading level for the heading if `useFormsPattern` is true.
5084
+ */
5085
+ "formHeadingLevel"?: number;
5086
+ /**
5087
+ * If true, sets the select to take the full-width of its container
5088
+ */
5089
+ "fullWidth"?: boolean;
4969
5090
  /**
4970
5091
  * Optional hint text.
4971
5092
  */
@@ -5014,20 +5135,63 @@ declare namespace LocalJSX {
5014
5135
  * Whether an error message should be shown - set to false when this component is used inside va-date or va-memorable-date in which the error for the va-select will be rendered outside of va-select
5015
5136
  */
5016
5137
  "showError"?: boolean;
5138
+ /**
5139
+ * Enabling this will add a heading and description for integrating into the forms pattern. Accepts `single` or `multiple` to indicate if the form is a single input or will have multiple inputs
5140
+ */
5141
+ "useFormsPattern"?: string;
5017
5142
  /**
5018
5143
  * Selected value (will get updated on select).
5019
5144
  */
5020
5145
  "value"?: string;
5021
5146
  /**
5022
- * Displays the select at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex).
5147
+ * Displays the select at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex). Defined in USWDS here: https://github.com/uswds/uswds/blob/develop/packages/uswds-core/src/styles/tokens/units/input-widths.scss
5023
5148
  */
5024
5149
  "width"?: string;
5025
5150
  }
5026
5151
  /**
5027
- * @componentName Statement of truth
5152
+ * @componentName Service list item
5028
5153
  * @maturityCategory caution
5029
5154
  * @maturityLevel candidate
5030
5155
  */
5156
+ interface VaServiceListItem {
5157
+ /**
5158
+ * Action associated with the service
5159
+ */
5160
+ "action"?: ServiceAction | string;
5161
+ /**
5162
+ * The icon associated with the service
5163
+ */
5164
+ "icon"?: string;
5165
+ /**
5166
+ * An optional link related to the service
5167
+ */
5168
+ "optionalLink"?: OptionalLink | string;
5169
+ /**
5170
+ * Details about the service
5171
+ */
5172
+ "serviceDetails"?: ServiceDetails | string;
5173
+ /**
5174
+ * The link to the service page
5175
+ */
5176
+ "serviceLink"?: string;
5177
+ /**
5178
+ * The name of the service
5179
+ */
5180
+ "serviceName"?: string;
5181
+ /**
5182
+ * The heading level for the service name (defaults to h3)
5183
+ */
5184
+ "serviceNameHeadingLevel"?: number;
5185
+ /**
5186
+ * The status of the service
5187
+ */
5188
+ "serviceStatus"?: string;
5189
+ }
5190
+ /**
5191
+ * @componentName Statement of truth
5192
+ * @maturityCategory use
5193
+ * @maturityLevel deployed
5194
+ */
5031
5195
  interface VaStatementOfTruth {
5032
5196
  /**
5033
5197
  * The error to be applied to the va-check-box element
@@ -5081,11 +5245,20 @@ declare namespace LocalJSX {
5081
5245
  */
5082
5246
  interface VaSummaryBox {
5083
5247
  }
5248
+ /**
5249
+ * @componentName Table
5250
+ * @maturityCategory caution
5251
+ * @maturityLevel available
5252
+ */
5084
5253
  interface VaTable {
5085
5254
  /**
5086
5255
  * When active, forces the table to expand to the full-width of its container
5087
5256
  */
5088
5257
  "fullWidth"?: boolean;
5258
+ /**
5259
+ * A comma-separated, zero-indexed string of which columns, if any, should be right-aligned
5260
+ */
5261
+ "rightAlignCols"?: string;
5089
5262
  /**
5090
5263
  * When active, the table can be horizontally scrolled and is focusable
5091
5264
  */
@@ -5129,6 +5302,10 @@ declare namespace LocalJSX {
5129
5302
  * Fires when the component is closed by clicking on the close icon. This fires only when closeable is true.
5130
5303
  */
5131
5304
  "onSortTable"?: (event: VaTableInnerCustomEvent<any>) => void;
5305
+ /**
5306
+ * A comma-separated, zero-indexed string of which columns, if any, should be right-aligned
5307
+ */
5308
+ "rightAlignCols"?: string;
5132
5309
  "rows"?: number;
5133
5310
  /**
5134
5311
  * When active, the table can be horizontally scrolled and is focusable
@@ -5209,7 +5386,7 @@ declare namespace LocalJSX {
5209
5386
  * @nativeHandler onBlur
5210
5387
  * @componentName Text input
5211
5388
  * @maturityCategory use
5212
- * @maturityLevel deployed
5389
+ * @maturityLevel best_practice
5213
5390
  * @guidanceHref form/text-input
5214
5391
  * @translations English
5215
5392
  * @translations Spanish
@@ -5352,7 +5529,7 @@ declare namespace LocalJSX {
5352
5529
  * @nativeHandler onBlur
5353
5530
  * @componentName Textarea
5354
5531
  * @maturityCategory use
5355
- * @maturityLevel deployed
5532
+ * @maturityLevel best_practice
5356
5533
  * @guidanceHref form/textarea
5357
5534
  * @translations English
5358
5535
  * @translations Spanish
@@ -5474,6 +5651,7 @@ declare namespace LocalJSX {
5474
5651
  "va-search-input": VaSearchInput;
5475
5652
  "va-segmented-progress-bar": VaSegmentedProgressBar;
5476
5653
  "va-select": VaSelect;
5654
+ "va-service-list-item": VaServiceListItem;
5477
5655
  "va-statement-of-truth": VaStatementOfTruth;
5478
5656
  "va-summary-box": VaSummaryBox;
5479
5657
  "va-table": VaTable;
@@ -5502,7 +5680,7 @@ declare module "@stencil/core" {
5502
5680
  /**
5503
5681
  * @componentName Additional info
5504
5682
  * @maturityCategory use
5505
- * @maturityLevel deployed
5683
+ * @maturityLevel best_practice
5506
5684
  */
5507
5685
  "va-additional-info": LocalJSX.VaAdditionalInfo & JSXBase.HTMLAttributes<HTMLVaAdditionalInfoElement>;
5508
5686
  /**
@@ -5514,8 +5692,8 @@ declare module "@stencil/core" {
5514
5692
  /**
5515
5693
  * @componentName Alert - expandable
5516
5694
  * @guidanceHref alert/alert-expandable
5517
- * @maturityCategory caution
5518
- * @maturityLevel candidate
5695
+ * @maturityCategory use
5696
+ * @maturityLevel deployed
5519
5697
  */
5520
5698
  "va-alert-expandable": LocalJSX.VaAlertExpandable & JSXBase.HTMLAttributes<HTMLVaAlertExpandableElement>;
5521
5699
  /**
@@ -5546,28 +5724,28 @@ declare module "@stencil/core" {
5546
5724
  /**
5547
5725
  * @componentName Button
5548
5726
  * @nativeHandler onClick
5549
- * @maturityCategory caution
5550
- * @maturityLevel candidate
5727
+ * @maturityCategory use
5728
+ * @maturityLevel deployed
5551
5729
  */
5552
5730
  "va-button": LocalJSX.VaButton & JSXBase.HTMLAttributes<HTMLVaButtonElement>;
5553
5731
  /**
5554
5732
  * @componentName Button - Icon
5555
5733
  * @nativeHandler onClick
5556
5734
  * @maturityCategory caution
5557
- * @maturityLevel candidate
5735
+ * @maturityLevel available
5558
5736
  */
5559
5737
  "va-button-icon": LocalJSX.VaButtonIcon & JSXBase.HTMLAttributes<HTMLVaButtonIconElement>;
5560
5738
  /**
5561
5739
  * @componentName Button pair
5562
- * @maturityCategory caution
5563
- * @maturityLevel candidate
5740
+ * @maturityCategory use
5741
+ * @maturityLevel deployed
5564
5742
  * @guidanceHref button/button-pair
5565
5743
  */
5566
5744
  "va-button-pair": LocalJSX.VaButtonPair & JSXBase.HTMLAttributes<HTMLVaButtonPairElement>;
5567
5745
  /**
5568
5746
  * @componentName Card
5569
- * @maturityCategory caution
5570
- * @maturityLevel candidate
5747
+ * @maturityCategory use
5748
+ * @maturityLevel deployed
5571
5749
  */
5572
5750
  "va-card": LocalJSX.VaCard & JSXBase.HTMLAttributes<HTMLVaCardElement>;
5573
5751
  /**
@@ -5604,7 +5782,7 @@ declare module "@stencil/core" {
5604
5782
  /**
5605
5783
  * @componentName Crisis Line Modal
5606
5784
  * @maturityCategory caution
5607
- * @maturityLevel candidate
5785
+ * @maturityLevel available
5608
5786
  */
5609
5787
  "va-crisis-line-modal": LocalJSX.VaCrisisLineModal & JSXBase.HTMLAttributes<HTMLVaCrisisLineModalElement>;
5610
5788
  /**
@@ -5633,50 +5811,52 @@ declare module "@stencil/core" {
5633
5811
  /**
5634
5812
  * @componentName Header - Minimal
5635
5813
  * @maturityCategory caution
5636
- * @maturityLevel candidate
5814
+ * @maturityLevel available
5637
5815
  * @guidanceHref header/header-minimal
5638
5816
  */
5639
5817
  "va-header-minimal": LocalJSX.VaHeaderMinimal & JSXBase.HTMLAttributes<HTMLVaHeaderMinimalElement>;
5640
5818
  /**
5641
5819
  * @componentName Icon
5642
5820
  * @maturityCategory caution
5643
- * @maturityLevel candidate
5821
+ * @maturityLevel available
5644
5822
  */
5645
5823
  "va-icon": LocalJSX.VaIcon & JSXBase.HTMLAttributes<HTMLVaIconElement>;
5646
5824
  /**
5647
5825
  * @componentName Language Toggle
5648
5826
  * @maturityCategory caution
5649
- * @maturityLevel candidate
5827
+ * @maturityLevel available
5650
5828
  */
5651
5829
  "va-language-toggle": LocalJSX.VaLanguageToggle & JSXBase.HTMLAttributes<HTMLVaLanguageToggleElement>;
5652
5830
  /**
5653
5831
  * @componentName Link
5654
- * @maturityCategory caution
5655
- * @maturityLevel candidate
5832
+ * @maturityCategory use
5833
+ * @maturityLevel deployed
5656
5834
  */
5657
5835
  "va-link": LocalJSX.VaLink & JSXBase.HTMLAttributes<HTMLVaLinkElement>;
5658
5836
  /**
5659
5837
  * @componentName Link - Action
5660
- * @maturityCategory caution
5661
- * @maturityLevel candidate
5838
+ * @maturityCategory use
5839
+ * @maturityLevel deployed
5840
+ * @guidanceHref link/action
5841
+ * @guidanceName Action link
5662
5842
  */
5663
5843
  "va-link-action": LocalJSX.VaLinkAction & JSXBase.HTMLAttributes<HTMLVaLinkActionElement>;
5664
5844
  /**
5665
5845
  * @componentName Loading indicator
5666
5846
  * @maturityCategory use
5667
- * @maturityLevel best_practice
5847
+ * @maturityLevel deployed
5668
5848
  */
5669
5849
  "va-loading-indicator": LocalJSX.VaLoadingIndicator & JSXBase.HTMLAttributes<HTMLVaLoadingIndicatorElement>;
5670
5850
  /**
5671
5851
  * @componentName Banner - Maintenance
5672
- * @maturityCategory caution
5673
- * @maturityLevel available
5852
+ * @maturityCategory use
5853
+ * @maturityLevel deployed
5674
5854
  */
5675
5855
  "va-maintenance-banner": LocalJSX.VaMaintenanceBanner & JSXBase.HTMLAttributes<HTMLVaMaintenanceBannerElement>;
5676
5856
  /**
5677
5857
  * @componentName Memorable date
5678
- * @maturityCategory caution
5679
- * @maturityLevel available
5858
+ * @maturityCategory use
5859
+ * @maturityLevel deployed
5680
5860
  * @guidanceHref form/memorable-date
5681
5861
  * @translations English
5682
5862
  * @translations Spanish
@@ -5685,7 +5865,7 @@ declare module "@stencil/core" {
5685
5865
  /**
5686
5866
  * @componentName Minimal Footer
5687
5867
  * @maturityCategory caution
5688
- * @maturityLevel candidate
5868
+ * @maturityLevel available
5689
5869
  */
5690
5870
  "va-minimal-footer": LocalJSX.VaMinimalFooter & JSXBase.HTMLAttributes<HTMLVaMinimalFooterElement>;
5691
5871
  /**
@@ -5693,13 +5873,13 @@ declare module "@stencil/core" {
5693
5873
  * @keydown Used to detect Escape key to close modal.
5694
5874
  * @componentName Modal
5695
5875
  * @maturityCategory use
5696
- * @maturityLevel deployed
5876
+ * @maturityLevel best_practice
5697
5877
  */
5698
5878
  "va-modal": LocalJSX.VaModal & JSXBase.HTMLAttributes<HTMLVaModalElement>;
5699
5879
  /**
5700
5880
  * @componentName Need help?
5701
- * @maturityCategory caution
5702
- * @maturityLevel candidate
5881
+ * @maturityCategory use
5882
+ * @maturityLevel deployed
5703
5883
  * @guidanceHref form/need-help
5704
5884
  */
5705
5885
  "va-need-help": LocalJSX.VaNeedHelp & JSXBase.HTMLAttributes<HTMLVaNeedHelpElement>;
@@ -5711,8 +5891,8 @@ declare module "@stencil/core" {
5711
5891
  "va-notification": LocalJSX.VaNotification & JSXBase.HTMLAttributes<HTMLVaNotificationElement>;
5712
5892
  /**
5713
5893
  * @componentName Banner - Official Gov
5714
- * @maturityCategory caution
5715
- * @maturityLevel candidate
5894
+ * @maturityCategory use
5895
+ * @maturityLevel best_practice
5716
5896
  */
5717
5897
  "va-official-gov-banner": LocalJSX.VaOfficialGovBanner & JSXBase.HTMLAttributes<HTMLVaOfficialGovBannerElement>;
5718
5898
  /**
@@ -5738,21 +5918,21 @@ declare module "@stencil/core" {
5738
5918
  "va-pagination": LocalJSX.VaPagination & JSXBase.HTMLAttributes<HTMLVaPaginationElement>;
5739
5919
  /**
5740
5920
  * @componentName Privacy agreement
5741
- * @maturityCategory caution
5742
- * @maturityLevel available
5921
+ * @maturityCategory use
5922
+ * @maturityLevel deployed
5743
5923
  */
5744
5924
  "va-privacy-agreement": LocalJSX.VaPrivacyAgreement & JSXBase.HTMLAttributes<HTMLVaPrivacyAgreementElement>;
5745
5925
  /**
5746
5926
  * @componentName Process list
5747
5927
  * @maturityCategory use
5748
- * @maturityLevel deployed
5928
+ * @maturityLevel best_practice
5749
5929
  */
5750
5930
  "va-process-list": LocalJSX.VaProcessList & JSXBase.HTMLAttributes<HTMLVaProcessListElement>;
5751
5931
  "va-process-list-item": LocalJSX.VaProcessListItem & JSXBase.HTMLAttributes<HTMLVaProcessListItemElement>;
5752
5932
  /**
5753
5933
  * @componentName Progress bar - activity
5754
5934
  * @maturityCategory use
5755
- * @maturityLevel deployed
5935
+ * @maturityLevel best_practice
5756
5936
  */
5757
5937
  "va-progress-bar": LocalJSX.VaProgressBar & JSXBase.HTMLAttributes<HTMLVaProgressBarElement>;
5758
5938
  /**
@@ -5767,7 +5947,7 @@ declare module "@stencil/core" {
5767
5947
  * @radioOptionSelected The event emitted when the selected option value changes.
5768
5948
  * @componentName Radio button
5769
5949
  * @maturityCategory use
5770
- * @maturityLevel deployed
5950
+ * @maturityLevel best_practice
5771
5951
  * @guidanceHref form/radio-button
5772
5952
  * @translations English
5773
5953
  * @translations Spanish
@@ -5778,7 +5958,7 @@ declare module "@stencil/core" {
5778
5958
  /**
5779
5959
  * @componentName Search input
5780
5960
  * @maturityCategory use
5781
- * @maturityLevel deployed
5961
+ * @maturityLevel best_practice
5782
5962
  */
5783
5963
  "va-search-input": LocalJSX.VaSearchInput & JSXBase.HTMLAttributes<HTMLVaSearchInputElement>;
5784
5964
  /**
@@ -5792,17 +5972,23 @@ declare module "@stencil/core" {
5792
5972
  * @nativeHandler onKeyDown
5793
5973
  * @componentName Select
5794
5974
  * @maturityCategory use
5795
- * @maturityLevel deployed
5975
+ * @maturityLevel best_practice
5796
5976
  * @guidanceHref form/select
5797
5977
  * @translations English
5798
5978
  * @translations Spanish
5799
5979
  */
5800
5980
  "va-select": LocalJSX.VaSelect & JSXBase.HTMLAttributes<HTMLVaSelectElement>;
5801
5981
  /**
5802
- * @componentName Statement of truth
5982
+ * @componentName Service list item
5803
5983
  * @maturityCategory caution
5804
5984
  * @maturityLevel candidate
5805
5985
  */
5986
+ "va-service-list-item": LocalJSX.VaServiceListItem & JSXBase.HTMLAttributes<HTMLVaServiceListItemElement>;
5987
+ /**
5988
+ * @componentName Statement of truth
5989
+ * @maturityCategory use
5990
+ * @maturityLevel deployed
5991
+ */
5806
5992
  "va-statement-of-truth": LocalJSX.VaStatementOfTruth & JSXBase.HTMLAttributes<HTMLVaStatementOfTruthElement>;
5807
5993
  /**
5808
5994
  * @componentName Summary box
@@ -5810,6 +5996,11 @@ declare module "@stencil/core" {
5810
5996
  * @maturityLevel deployed
5811
5997
  */
5812
5998
  "va-summary-box": LocalJSX.VaSummaryBox & JSXBase.HTMLAttributes<HTMLVaSummaryBoxElement>;
5999
+ /**
6000
+ * @componentName Table
6001
+ * @maturityCategory caution
6002
+ * @maturityLevel available
6003
+ */
5813
6004
  "va-table": LocalJSX.VaTable & JSXBase.HTMLAttributes<HTMLVaTableElement>;
5814
6005
  /**
5815
6006
  * @componentName Table
@@ -5829,7 +6020,7 @@ declare module "@stencil/core" {
5829
6020
  * @nativeHandler onBlur
5830
6021
  * @componentName Text input
5831
6022
  * @maturityCategory use
5832
- * @maturityLevel deployed
6023
+ * @maturityLevel best_practice
5833
6024
  * @guidanceHref form/text-input
5834
6025
  * @translations English
5835
6026
  * @translations Spanish
@@ -5841,7 +6032,7 @@ declare module "@stencil/core" {
5841
6032
  * @nativeHandler onBlur
5842
6033
  * @componentName Textarea
5843
6034
  * @maturityCategory use
5844
- * @maturityLevel deployed
6035
+ * @maturityLevel best_practice
5845
6036
  * @guidanceHref form/textarea
5846
6037
  * @translations English
5847
6038
  * @translations Spanish