@department-of-veterans-affairs/component-library 44.0.0 → 46.0.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 (121) hide show
  1. package/dist/1185.app.bundle.js +1 -1
  2. package/dist/1279.app.bundle.js +1 -1
  3. package/dist/1652.app.bundle.js +1 -1
  4. package/dist/2108.app.bundle.js +1 -1
  5. package/dist/2305.app.bundle.js +1 -1
  6. package/dist/265.app.bundle.js +1 -0
  7. package/dist/2843.app.bundle.js +1 -1
  8. package/dist/{7705.app.bundle.js → 3270.app.bundle.js} +2 -2
  9. package/dist/3389.app.bundle.js +1 -1
  10. package/dist/3476.app.bundle.js +1 -1
  11. package/dist/3499.app.bundle.js +1 -1
  12. package/dist/360.app.bundle.js +1 -1
  13. package/dist/3661.app.bundle.js +1 -1
  14. package/dist/383.app.bundle.js +1 -1
  15. package/dist/4104.app.bundle.js +1 -1
  16. package/dist/4181.app.bundle.js +1 -1
  17. package/dist/4317.app.bundle.js +1 -1
  18. package/dist/4437.app.bundle.js +1 -1
  19. package/dist/4818.app.bundle.js +1 -1
  20. package/dist/4846.app.bundle.js +1 -1
  21. package/dist/4859.app.bundle.js +1 -1
  22. package/dist/5154.app.bundle.js +1 -1
  23. package/dist/5232.app.bundle.js +1 -1
  24. package/dist/529.app.bundle.js +1 -1
  25. package/dist/5434.app.bundle.js +1 -1
  26. package/dist/5669.app.bundle.js +1 -1
  27. package/dist/569.app.bundle.js +1 -1
  28. package/dist/6166.app.bundle.js +1 -1
  29. package/dist/6171.app.bundle.js +1 -1
  30. package/dist/6205.app.bundle.js +1 -1
  31. package/dist/6391.app.bundle.js +1 -1
  32. package/dist/6569.app.bundle.js +1 -1
  33. package/dist/6596.app.bundle.js +1 -1
  34. package/dist/6734.app.bundle.js +1 -1
  35. package/dist/6874.app.bundle.js +1 -1
  36. package/dist/6998.app.bundle.js +1 -1
  37. package/dist/7375.app.bundle.js +1 -1
  38. package/dist/7454.app.bundle.js +1 -1
  39. package/dist/753.app.bundle.js +1 -1
  40. package/dist/783.app.bundle.js +1 -1
  41. package/dist/8214.app.bundle.js +1 -1
  42. package/dist/8509.app.bundle.js +1 -1
  43. package/dist/8716.app.bundle.js +1 -1
  44. package/dist/876.app.bundle.js +1 -1
  45. package/dist/9262.app.bundle.js +1 -1
  46. package/dist/934.app.bundle.js +1 -1
  47. package/dist/9370.app.bundle.js +1 -1
  48. package/dist/9398.app.bundle.js +1 -1
  49. package/dist/9452.app.bundle.js +1 -0
  50. package/dist/9727.app.bundle.js +1 -1
  51. package/dist/9893.app.bundle.js +1 -1
  52. package/dist/{5112.app.bundle.js → 9970.app.bundle.js} +2 -2
  53. package/dist/app.bundle.js +1 -1
  54. package/dist/components/contacts.js +1 -0
  55. package/dist/components/i18n-setup.js +1 -0
  56. package/dist/components/index.d.ts +9 -55
  57. package/dist/components/index.js +1 -1
  58. package/dist/components/types/components.d.ts +1260 -412
  59. package/dist/components/types/index.d.ts +1 -0
  60. package/dist/components/types/stencil-public-runtime.d.ts +74 -15
  61. package/dist/components/utils.js +1 -1
  62. package/dist/components/va-accordion.js +1 -1
  63. package/dist/components/va-additional-info.js +1 -1
  64. package/dist/components/va-alert2.js +1 -1
  65. package/dist/components/va-back-to-top.js +1 -1
  66. package/dist/components/va-banner.js +1 -1
  67. package/dist/components/va-breadcrumbs.js +1 -1
  68. package/dist/components/va-button-pair.js +1 -1
  69. package/dist/components/va-button2.js +1 -1
  70. package/dist/components/va-checkbox-group.js +1 -1
  71. package/dist/components/va-checkbox2.js +1 -1
  72. package/dist/components/va-crisis-line-modal2.js +1 -1
  73. package/dist/components/va-date.js +1 -1
  74. package/dist/components/va-file-input-multiple.js +1 -1
  75. package/dist/components/va-file-input2.js +1 -1
  76. package/dist/components/va-link2.js +1 -1
  77. package/dist/components/va-memorable-date.js +1 -1
  78. package/dist/components/va-modal2.js +1 -1
  79. package/dist/components/va-official-gov-banner2.js +1 -1
  80. package/dist/components/va-omb-info.js +1 -1
  81. package/dist/components/va-on-this-page.js +1 -1
  82. package/dist/components/va-pagination.js +1 -1
  83. package/dist/components/va-privacy-agreement.js +1 -1
  84. package/dist/components/va-process-list.js +1 -1
  85. package/dist/components/va-radio-option.js +1 -1
  86. package/dist/components/va-radio.js +1 -1
  87. package/dist/components/va-search-input.js +1 -1
  88. package/dist/components/va-segmented-progress-bar.js +1 -1
  89. package/dist/components/va-select2.js +1 -1
  90. package/dist/components/va-statement-of-truth.js +1 -1
  91. package/dist/components/va-summary-box.js +1 -1
  92. package/dist/components/va-table-inner2.js +1 -1
  93. package/dist/components/va-table.js +1 -1
  94. package/dist/components/va-telephone2.js +1 -1
  95. package/dist/components/va-text-input2.js +1 -1
  96. package/dist/components/va-textarea.js +1 -1
  97. package/dist/img/sprite.svg +3 -1
  98. package/dist/main.css +1 -1
  99. package/dist/react-bindings/index.d.ts +0 -2
  100. package/dist/react-bindings/index.js +1 -1
  101. package/dist/react-bindings/index.js.map +1 -1
  102. package/dist/react-bindings/index.ts +0 -1
  103. package/dist/react-bindings/react-component-lib/createComponent.js +1 -1
  104. package/dist/react-bindings/react-component-lib/createComponent.js.map +1 -1
  105. package/dist/react-bindings/react-component-lib/createOverlayComponent.js +1 -1
  106. package/dist/react-bindings/react-component-lib/createOverlayComponent.js.map +1 -1
  107. package/dist/react-bindings/react-component-lib/utils/attachProps.d.ts +1 -1
  108. package/dist/react-bindings/react-component-lib/utils/attachProps.js.map +1 -1
  109. package/dist/react-bindings/react-component-lib/utils/dev.js.map +1 -1
  110. package/dist/react-bindings/react-component-lib/utils/index.d.ts +2 -2
  111. package/dist/react-bindings/react-component-lib/utils/index.js +1 -1
  112. package/dist/react-bindings/react-component-lib/utils/index.js.map +1 -1
  113. package/package.json +2 -2
  114. package/dist/4726.app.bundle.js +0 -2
  115. package/dist/4726.app.bundle.js.LICENSE.txt +0 -5
  116. package/dist/8223.app.bundle.js +0 -1
  117. package/dist/916.app.bundle.js +0 -1
  118. package/dist/components/va-number-input.d.ts +0 -11
  119. package/dist/components/va-number-input.js +0 -1
  120. /package/dist/{7705.app.bundle.js.LICENSE.txt → 3270.app.bundle.js.LICENSE.txt} +0 -0
  121. /package/dist/{5112.app.bundle.js.LICENSE.txt → 9970.app.bundle.js.LICENSE.txt} +0 -0
@@ -6,7 +6,17 @@
6
6
  */
7
7
  import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
8
8
  import { Breadcrumb } from "./components/va-breadcrumbs/va-breadcrumbs";
9
+ export { Breadcrumb } from "./components/va-breadcrumbs/va-breadcrumbs";
9
10
  export namespace Components {
11
+ /**
12
+ * @componentName Accordion
13
+ * @accordionItemToggled This event is fired when an accordion item is opened or closed
14
+ * @maturityCategory use
15
+ * @maturityLevel best_practice
16
+ * @translations English
17
+ * @translations Spanish
18
+ * @translations Tagalog
19
+ */
10
20
  interface VaAccordion {
11
21
  /**
12
22
  * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -43,6 +53,11 @@ export namespace Components {
43
53
  */
44
54
  "subheader"?: string;
45
55
  }
56
+ /**
57
+ * @componentName Additional info
58
+ * @maturityCategory use
59
+ * @maturityLevel deployed
60
+ */
46
61
  interface VaAdditionalInfo {
47
62
  /**
48
63
  * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -56,16 +71,13 @@ export namespace Components {
56
71
  * The text to trigger the expansion
57
72
  */
58
73
  "trigger": string;
59
- /**
60
- * Whether or not the component will use USWDS v3 styling.
61
- */
62
- "uswds"?: boolean;
63
74
  }
75
+ /**
76
+ * @componentName Alert
77
+ * @maturityCategory use
78
+ * @maturityLevel best_practice
79
+ */
64
80
  interface VaAlert {
65
- /**
66
- * If `true`, renders the alert with only a background color corresponding to the status - no left border. (v1 only)
67
- */
68
- "backgroundOnly"?: boolean;
69
81
  /**
70
82
  * Aria-label text for the close button.
71
83
  */
@@ -83,7 +95,7 @@ export namespace Components {
83
95
  */
84
96
  "fullWidth"?: boolean;
85
97
  /**
86
- * Displays the slim variation. Available when USWDS is true.
98
+ * Displays the slim variation.
87
99
  */
88
100
  "slim"?: boolean;
89
101
  /**
@@ -94,15 +106,16 @@ export namespace Components {
94
106
  | 'error'
95
107
  | 'success'
96
108
  | 'continue';
97
- /**
98
- * Whether or not the component will use USWDS v3 styling.
99
- */
100
- "uswds"?: boolean;
101
109
  /**
102
110
  * If `true`, the alert will be visible.
103
111
  */
104
112
  "visible"?: boolean;
105
113
  }
114
+ /**
115
+ * @componentName Alert - expandable
116
+ * @maturityCategory caution
117
+ * @maturityLevel candidate
118
+ */
106
119
  interface VaAlertExpandable {
107
120
  /**
108
121
  * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -121,8 +134,18 @@ export namespace Components {
121
134
  */
122
135
  "trigger": string;
123
136
  }
137
+ /**
138
+ * @componentName Back to top
139
+ * @maturityCategory use
140
+ * @maturityLevel deployed
141
+ */
124
142
  interface VaBackToTop {
125
143
  }
144
+ /**
145
+ * @componentName Banner
146
+ * @maturityCategory use
147
+ * @maturityLevel deployed
148
+ */
126
149
  interface VaBanner {
127
150
  /**
128
151
  * Aria Label for the "region" of the nested va-alert.
@@ -141,7 +164,7 @@ export namespace Components {
141
164
  */
142
165
  "showClose"?: boolean;
143
166
  /**
144
- * The type of the banner. This affects both the icon of the AlertBox and the top border color.
167
+ * The type of the banner. This affects both the icon of the AlertBox and border color / background.
145
168
  */
146
169
  "type"?: 'info' | 'warning' | 'error' | 'success' | 'continue';
147
170
  /**
@@ -153,9 +176,14 @@ export namespace Components {
153
176
  */
154
177
  "windowSession"?: boolean;
155
178
  }
179
+ /**
180
+ * @componentName Breadcrumbs
181
+ * @maturityCategory use
182
+ * @maturityLevel deployed
183
+ */
156
184
  interface VaBreadcrumbs {
157
185
  /**
158
- * Represents a list of breadcrumbs. Use a JSON array of objects with label and href properties, then wrap in a string if using non-React-binding version. See Storybook examples for React-binding version. For pure web components, here's an example link: ``[{"href": "/link1", "label": "Link 1"}]`. This prop is available when `uswds` is set to `true`.
186
+ * Represents a list of breadcrumbs. Use a JSON array of objects with label and href properties, then wrap in a string if using non-React-binding version. See Storybook examples for React-binding version. For pure web components, here's an example link: ``[{"href": "/link1", "label": "Link 1"}]`.
159
187
  */
160
188
  "breadcrumbList"?: Breadcrumb[] | string;
161
189
  /**
@@ -171,14 +199,16 @@ export namespace Components {
171
199
  */
172
200
  "label"?: string;
173
201
  /**
174
- * Whether or not the component will use USWDS v3 styling.
175
- */
176
- "uswds"?: boolean;
177
- /**
178
- * Whether or not the component will wrap the breadcrumbs. This prop is available when `uswds` is set to `true`.
202
+ * Whether or not the component will wrap the breadcrumbs.
179
203
  */
180
204
  "wrapping"?: boolean;
181
205
  }
206
+ /**
207
+ * @componentName Button
208
+ * @nativeHandler onClick
209
+ * @maturityCategory caution
210
+ * @maturityLevel candidate
211
+ */
182
212
  interface VaButton {
183
213
  /**
184
214
  * If `true`, the button will use `Back` as its text and an icon to represent going back in form flows.
@@ -224,11 +254,13 @@ export namespace Components {
224
254
  * The text displayed on the button. If `continue` or `back` is true, the value of text is ignored.
225
255
  */
226
256
  "text"?: string;
227
- /**
228
- * Whether or not the component will use USWDS v3 styling.
229
- */
230
- "uswds"?: boolean;
231
257
  }
258
+ /**
259
+ * @componentName Button - Icon
260
+ * @nativeHandler onClick
261
+ * @maturityCategory caution
262
+ * @maturityLevel candidate
263
+ */
232
264
  interface VaButtonIcon {
233
265
  "buttonType": keyof typeof this.buttonTypeMap;
234
266
  /**
@@ -240,6 +272,12 @@ export namespace Components {
240
272
  */
241
273
  "label"?: string;
242
274
  }
275
+ /**
276
+ * @componentName Button pair
277
+ * @maturityCategory caution
278
+ * @maturityLevel candidate
279
+ * @guidanceHref button/button-pair
280
+ */
243
281
  interface VaButtonPair {
244
282
  /**
245
283
  * If `true`, button pair will use Continue and Back for button text.
@@ -249,10 +287,18 @@ export namespace Components {
249
287
  * If `true`, the component-library-analytics event is disabled.
250
288
  */
251
289
  "disableAnalytics"?: boolean;
290
+ /**
291
+ * Custom text that will be applied to the left va-button inside the component. If set will override text controlled by the 'update' prop.
292
+ */
293
+ "leftButtonText"?: string;
252
294
  /**
253
295
  * Applies to the primary button aria-label.
254
296
  */
255
297
  "primaryLabel"?: string;
298
+ /**
299
+ * Custom text that will be applied to the right va-button inside the component. If set will override text controlled by the 'update' prop,
300
+ */
301
+ "rightButtonText"?: string;
256
302
  /**
257
303
  * Applies to the secondary button aria-label.
258
304
  */
@@ -265,11 +311,12 @@ export namespace Components {
265
311
  * If `true`, button pair will use Update and Cancel for button text.
266
312
  */
267
313
  "update"?: boolean;
268
- /**
269
- * Whether or not the component will use USWDS v3 styling.
270
- */
271
- "uswds"?: boolean;
272
314
  }
315
+ /**
316
+ * @componentName Card
317
+ * @maturityCategory caution
318
+ * @maturityLevel candidate
319
+ */
273
320
  interface VaCard {
274
321
  /**
275
322
  * If `true`, the card will have a gray background.
@@ -280,9 +327,19 @@ export namespace Components {
280
327
  */
281
328
  "showShadow"?: boolean;
282
329
  }
330
+ /**
331
+ * @nativeHandler onBlur
332
+ * @componentName Checkbox
333
+ * @maturityCategory use
334
+ * @maturityLevel deployed
335
+ * @guidanceHref form/checkbox
336
+ * @translations English
337
+ * @translations Spanish
338
+ * @translations Tagalog
339
+ */
283
340
  interface VaCheckbox {
284
341
  /**
285
- * Description of the option displayed below the checkbox label. Available when uswds is true.
342
+ * Description of the option displayed below the checkbox label.
286
343
  */
287
344
  "checkboxDescription"?: string;
288
345
  /**
@@ -294,7 +351,7 @@ export namespace Components {
294
351
  */
295
352
  "description"?: string;
296
353
  /**
297
- * Whether or not the checkbox option is disabled. Available when uswds is true.
354
+ * Whether or not the checkbox option is disabled.
298
355
  */
299
356
  "disabled"?: boolean;
300
357
  /**
@@ -326,14 +383,20 @@ export namespace Components {
326
383
  */
327
384
  "required"?: boolean;
328
385
  /**
329
- * Whether or not the component will display as a tile. Available when uswds is true.
386
+ * Whether or not the component will display as a tile.
330
387
  */
331
388
  "tile"?: boolean;
332
- /**
333
- * Whether or not the component will use USWDS v3 styling.
334
- */
335
- "uswds"?: boolean;
336
389
  }
390
+ /**
391
+ * @vaChange The event emitted when the input value changes.
392
+ * @componentName Checkbox group
393
+ * @maturityCategory use
394
+ * @maturityLevel deployed
395
+ * @guidanceHref form/checkbox
396
+ * @translations English
397
+ * @translations Spanish
398
+ * @translations Tagalog
399
+ */
337
400
  interface VaCheckboxGroup {
338
401
  /**
339
402
  * Whether or not an analytics event will be fired.
@@ -344,11 +407,11 @@ export namespace Components {
344
407
  */
345
408
  "error"?: string;
346
409
  /**
347
- * The content of the heading if `useFormsPattern` and `uswds` are true.
410
+ * The content of the heading if `useFormsPattern` is true.
348
411
  */
349
412
  "formHeading"?: string;
350
413
  /**
351
- * The heading level for the heading if `useFormsPattern` and `uswds` are true.
414
+ * The heading level for the heading if `useFormsPattern` is true.
352
415
  */
353
416
  "formHeadingLevel"?: number;
354
417
  /**
@@ -368,16 +431,23 @@ export namespace Components {
368
431
  */
369
432
  "required"?: boolean;
370
433
  /**
371
- * 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. `uswds` should be true.
434
+ * 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.
372
435
  */
373
436
  "useFormsPattern"?: string;
374
- /**
375
- * Whether or not the component will use USWDS v3 styling.
376
- */
377
- "uswds"?: boolean;
378
437
  }
438
+ /**
439
+ * @componentName Crisis Line Modal
440
+ * @maturityCategory caution
441
+ * @maturityLevel candidate
442
+ */
379
443
  interface VaCrisisLineModal {
380
444
  }
445
+ /**
446
+ * @componentName Date input
447
+ * @maturityCategory use
448
+ * @maturityLevel deployed
449
+ * @guidanceHref form/date-input
450
+ */
381
451
  interface VaDate {
382
452
  /**
383
453
  * Whether or not an analytics event will be fired.
@@ -415,6 +485,12 @@ export namespace Components {
415
485
  */
416
486
  "value"?: string;
417
487
  }
488
+ /**
489
+ * @componentName File input
490
+ * @maturityCategory caution
491
+ * @maturityLevel available
492
+ * @guidanceHref form/file-input
493
+ */
418
494
  interface VaFileInput {
419
495
  /**
420
496
  * A comma-separated list of unique file type specifiers.
@@ -456,11 +532,15 @@ export namespace Components {
456
532
  * Sets the input to required and renders the (*Required) text.
457
533
  */
458
534
  "required"?: boolean;
459
- /**
460
- * Whether or not the component will use USWDS v3 styling.
461
- */
462
- "uswds"?: boolean;
463
535
  }
536
+ /**
537
+ * A component that manages multiple file inputs, allowing users to upload several files.
538
+ * It supports adding, changing, and removing files with dynamic error handling.
539
+ * @componentName File input multiple
540
+ * @maturityCategory caution
541
+ * @maturityLevel available
542
+ * @guidanceHref form/file-input-multiple
543
+ */
464
544
  interface VaFileInputMultiple {
465
545
  /**
466
546
  * Defines acceptable file types the user can select; uses file type or extensions.
@@ -495,6 +575,12 @@ export namespace Components {
495
575
  */
496
576
  "required"?: boolean;
497
577
  }
578
+ /**
579
+ * @componentName Header - Minimal
580
+ * @maturityCategory caution
581
+ * @maturityLevel candidate
582
+ * @guidanceHref header/header-minimal
583
+ */
498
584
  interface VaHeaderMinimal {
499
585
  /**
500
586
  * Disables use of heading tags in the minimal header in favor of `<div>` tags. This is for when a heading level 1 needs to be used elsewhere, as there should only be one heading level 1 per page.
@@ -503,6 +589,11 @@ export namespace Components {
503
589
  "header"?: string;
504
590
  "subheader"?: string;
505
591
  }
592
+ /**
593
+ * @componentName Icon
594
+ * @maturityCategory caution
595
+ * @maturityLevel candidate
596
+ */
506
597
  interface VaIcon {
507
598
  /**
508
599
  * The name of the icon to use
@@ -517,6 +608,11 @@ export namespace Components {
517
608
  */
518
609
  "srtext"?: string;
519
610
  }
611
+ /**
612
+ * @componentName Link
613
+ * @maturityCategory caution
614
+ * @maturityLevel candidate
615
+ */
520
616
  interface VaLink {
521
617
  /**
522
618
  * The title used in the abbr element. If filetype is PDF, the abbr title will be Portable Document Format.
@@ -526,6 +622,10 @@ export namespace Components {
526
622
  * If `true`, the anchor text will be bolded and include a right arrow icon.
527
623
  */
528
624
  "active"?: boolean;
625
+ /**
626
+ * If 'true', renders a "back arrow" in front of the link text
627
+ */
628
+ "back"?: boolean;
529
629
  /**
530
630
  * If `true`, a calendar icon will be displayed before the anchor text.
531
631
  */
@@ -542,6 +642,10 @@ export namespace Components {
542
642
  * If `true`, the link will be treated as a download, and a download icon will be displayed before the anchor text.
543
643
  */
544
644
  "download"?: boolean;
645
+ /**
646
+ * 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
647
+ */
648
+ "external"?: boolean;
545
649
  /**
546
650
  * The suggested filename. Only valid if download or calendar is `true`.
547
651
  */
@@ -583,6 +687,11 @@ export namespace Components {
583
687
  */
584
688
  "video"?: boolean;
585
689
  }
690
+ /**
691
+ * @componentName Link - Action
692
+ * @maturityCategory caution
693
+ * @maturityLevel candidate
694
+ */
586
695
  interface VaLinkAction {
587
696
  /**
588
697
  * If `true`, the component-library-analytics event is disabled.
@@ -605,6 +714,11 @@ export namespace Components {
605
714
  */
606
715
  "type": "primary" | "secondary" | "reverse";
607
716
  }
717
+ /**
718
+ * @componentName Loading indicator
719
+ * @maturityCategory use
720
+ * @maturityLevel best_practice
721
+ */
608
722
  interface VaLoadingIndicator {
609
723
  /**
610
724
  * Analytics tracking function(s) will be called. Form components are disabled by default due to PII/PHI concerns.
@@ -623,6 +737,11 @@ export namespace Components {
623
737
  */
624
738
  "setFocus"?: boolean;
625
739
  }
740
+ /**
741
+ * @componentName Banner - Maintenance
742
+ * @maturityCategory caution
743
+ * @maturityLevel available
744
+ */
626
745
  interface VaMaintenanceBanner {
627
746
  /**
628
747
  * A unique ID that will be used for conditionally rendering the banner based on if the user has dismissed it already.
@@ -657,6 +776,14 @@ export namespace Components {
657
776
  */
658
777
  "upcomingWarnTitle": string;
659
778
  }
779
+ /**
780
+ * @componentName Memorable date
781
+ * @maturityCategory caution
782
+ * @maturityLevel available
783
+ * @guidanceHref form/memorable-date
784
+ * @translations English
785
+ * @translations Spanish
786
+ */
660
787
  interface VaMemorableDate {
661
788
  /**
662
789
  * A custom error message to display if the day is invalid
@@ -718,8 +845,20 @@ export namespace Components {
718
845
  */
719
846
  "value"?: string;
720
847
  }
848
+ /**
849
+ * @componentName Minimal Footer
850
+ * @maturityCategory caution
851
+ * @maturityLevel candidate
852
+ */
721
853
  interface VaMinimalFooter {
722
854
  }
855
+ /**
856
+ * @click Used to detect clicks outside of modal contents to close modal.
857
+ * @keydown Used to detect Escape key to close modal.
858
+ * @componentName Modal
859
+ * @maturityCategory use
860
+ * @maturityLevel deployed
861
+ */
723
862
  interface VaModal {
724
863
  /**
725
864
  * Additional DOM-nodes that should not be hidden from screen readers. Useful when an open modal shouldn't hide all content behind the overlay.
@@ -767,8 +906,19 @@ export namespace Components {
767
906
  */
768
907
  "visible"?: boolean;
769
908
  }
909
+ /**
910
+ * @componentName Need help?
911
+ * @maturityCategory caution
912
+ * @maturityLevel candidate
913
+ * @guidanceHref form/need-help
914
+ */
770
915
  interface VaNeedHelp {
771
916
  }
917
+ /**
918
+ * @componentName Notification
919
+ * @maturityCategory dont_use
920
+ * @maturityLevel deprecated
921
+ */
772
922
  interface VaNotification {
773
923
  /**
774
924
  * Aria-label text for the close button.
@@ -819,76 +969,11 @@ export namespace Components {
819
969
  */
820
970
  "visible"?: boolean;
821
971
  }
822
- interface VaNumberInput {
823
- /**
824
- * Whether this component will be used to accept a currency value.
825
- */
826
- "currency"?: boolean;
827
- /**
828
- * Emit component-library-analytics events on the blur event.
829
- */
830
- "enableAnalytics"?: boolean;
831
- /**
832
- * The error message to render.
833
- */
834
- "error"?: string;
835
- /**
836
- * The content of the heading if `useFormsPattern` and `uswds` are true.
837
- */
838
- "formHeading"?: string;
839
- /**
840
- * The heading level for the heading if `useFormsPattern` and `uswds` are true.
841
- */
842
- "formHeadingLevel"?: number;
843
- /**
844
- * Optional hint text.
845
- */
846
- "hint"?: string;
847
- /**
848
- * The inputmode attribute.
849
- */
850
- "inputmode"?: 'decimal' | 'numeric';
851
- /**
852
- * The label for the text input.
853
- */
854
- "label"?: string;
855
- /**
856
- * Maximum number value The max attribute specifies the maximum value for an input element.
857
- */
858
- "max": number | string;
859
- /**
860
- * An optional message that will be read by screen readers when the input is focused.
861
- */
862
- "messageAriaDescribedby"?: string;
863
- /**
864
- * Minimum number value The min attribute specifies the minimum value for an input element.
865
- */
866
- "min": number | string;
867
- /**
868
- * The name to pass to the input element.
869
- */
870
- "name"?: string;
871
- /**
872
- * Set the input to required and render the (Required) text.
873
- */
874
- "required"?: boolean;
875
- /**
876
- * 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. `uswds` should be true.
877
- */
878
- "useFormsPattern"?: string;
879
- /**
880
- * Whether or not the component will use USWDS v3 styling.
881
- */
882
- "uswds"?: boolean;
883
- /**
884
- * The value for the input.
885
- */
886
- "value"?: string;
887
- /**
888
- * Displays the input at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex).
889
- */
890
- "width"?: string;
891
- }
972
+ /**
973
+ * @componentName Banner - Official Gov
974
+ * @maturityCategory caution
975
+ * @maturityLevel candidate
976
+ */
892
977
  interface VaOfficialGovBanner {
893
978
  /**
894
979
  * If `true`, the component-library-analytics event is disabled.
@@ -899,6 +984,11 @@ export namespace Components {
899
984
  */
900
985
  "tld": string;
901
986
  }
987
+ /**
988
+ * @componentName OMB info
989
+ * @maturityCategory use
990
+ * @maturityLevel best_practice
991
+ */
902
992
  interface VaOmbInfo {
903
993
  /**
904
994
  * The name of the benefit displayed in the Respondent Burden section of the Privacy Act Statement.
@@ -917,12 +1007,25 @@ export namespace Components {
917
1007
  */
918
1008
  "resBurden"?: number;
919
1009
  }
1010
+ /**
1011
+ * @componentName On this page
1012
+ * @maturityCategory use
1013
+ * @maturityLevel best_practice
1014
+ * @translations English
1015
+ * @translations Spanish
1016
+ * @translations Tagalog
1017
+ */
920
1018
  interface VaOnThisPage {
921
1019
  /**
922
1020
  * If true, analytics event will not be fired
923
1021
  */
924
1022
  "disableAnalytics"?: boolean;
925
1023
  }
1024
+ /**
1025
+ * @componentName Pagination
1026
+ * @maturityCategory use
1027
+ * @maturityLevel deployed
1028
+ */
926
1029
  interface VaPagination {
927
1030
  /**
928
1031
  * Aria-label suffix text for buttons
@@ -949,14 +1052,15 @@ export namespace Components {
949
1052
  */
950
1053
  "showLastPage"?: boolean;
951
1054
  /**
952
- * Don't show last page when the page count exceeds `maxPageListLength` (but do show the ellipsis). Only relevant if uswds is true.
1055
+ * Don't show last page when the page count exceeds `maxPageListLength` (but do show the ellipsis).
953
1056
  */
954
1057
  "unbounded"?: boolean;
955
- /**
956
- * Whether or not the component will use USWDS v3 styling.
957
- */
958
- "uswds"?: boolean;
959
1058
  }
1059
+ /**
1060
+ * @componentName Privacy agreement
1061
+ * @maturityCategory caution
1062
+ * @maturityLevel available
1063
+ */
960
1064
  interface VaPrivacyAgreement {
961
1065
  /**
962
1066
  * Whether the checkbox is checked or not.
@@ -970,16 +1074,13 @@ export namespace Components {
970
1074
  * Whether to display the error message or not.
971
1075
  */
972
1076
  "showError"?: boolean;
973
- /**
974
- * Whether or not the component will use USWDS v3 styling.
975
- */
976
- "uswds"?: boolean;
977
1077
  }
1078
+ /**
1079
+ * @componentName Process list
1080
+ * @maturityCategory use
1081
+ * @maturityLevel deployed
1082
+ */
978
1083
  interface VaProcessList {
979
- /**
980
- * Whether or not the component will use USWDS v3 styling.
981
- */
982
- "uswds"?: boolean;
983
1084
  }
984
1085
  interface VaProcessListItem {
985
1086
  /**
@@ -1003,6 +1104,11 @@ export namespace Components {
1003
1104
  */
1004
1105
  "pending"?: boolean;
1005
1106
  }
1107
+ /**
1108
+ * @componentName Progress bar - activity
1109
+ * @maturityCategory use
1110
+ * @maturityLevel deployed
1111
+ */
1006
1112
  interface VaProgressBar {
1007
1113
  /**
1008
1114
  * Whether or not an analytics event will be fired.
@@ -1017,6 +1123,12 @@ export namespace Components {
1017
1123
  */
1018
1124
  "percent": number;
1019
1125
  }
1126
+ /**
1127
+ * @componentName Banner - Promo
1128
+ * @maturityCategory use
1129
+ * @maturityLevel deployed
1130
+ * @guidanceHref banner/promo
1131
+ */
1020
1132
  interface VaPromoBanner {
1021
1133
  /**
1022
1134
  * Analytics tracking function(s) will not be called
@@ -1031,6 +1143,17 @@ export namespace Components {
1031
1143
  */
1032
1144
  "type": 'announcement' | 'news' | 'email-signup';
1033
1145
  }
1146
+ /**
1147
+ * @keydown The event emitted when a key is pressed.
1148
+ * @radioOptionSelected The event emitted when the selected option value changes.
1149
+ * @componentName Radio button
1150
+ * @maturityCategory use
1151
+ * @maturityLevel deployed
1152
+ * @guidanceHref form/radio-button
1153
+ * @translations English
1154
+ * @translations Spanish
1155
+ * @translations Tagalog
1156
+ */
1034
1157
  interface VaRadio {
1035
1158
  /**
1036
1159
  * Whether or not an analytics event will be fired.
@@ -1041,11 +1164,11 @@ export namespace Components {
1041
1164
  */
1042
1165
  "error"?: string;
1043
1166
  /**
1044
- * The content of the heading if `useFormsPattern` and `uswds` are true.
1167
+ * The content of the heading if `useFormsPattern` is true.
1045
1168
  */
1046
1169
  "formHeading"?: string;
1047
1170
  /**
1048
- * The heading level for the heading if `useFormsPattern` and `uswds` are true.
1171
+ * The heading level for the heading if `useFormsPattern` is true.
1049
1172
  */
1050
1173
  "formHeadingLevel"?: number;
1051
1174
  /**
@@ -1069,13 +1192,9 @@ export namespace Components {
1069
1192
  */
1070
1193
  "required"?: boolean;
1071
1194
  /**
1072
- * 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. `uswds` should be true.
1195
+ * 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
1073
1196
  */
1074
1197
  "useFormsPattern"?: string;
1075
- /**
1076
- * Whether or not the component will use USWDS v3 styling.
1077
- */
1078
- "uswds"?: boolean;
1079
1198
  }
1080
1199
  interface VaRadioOption {
1081
1200
  /**
@@ -1087,11 +1206,11 @@ export namespace Components {
1087
1206
  */
1088
1207
  "checked"?: boolean;
1089
1208
  /**
1090
- * Description of the option displayed below the option label. Available when uswds is true.
1209
+ * Description of the option displayed below the option label.
1091
1210
  */
1092
1211
  "description"?: string;
1093
1212
  /**
1094
- * Whether or not the radio option is disabled. Can be used if the USWDS option is active.
1213
+ * Whether or not the radio option is disabled.
1095
1214
  */
1096
1215
  "disabled"?: boolean;
1097
1216
  /**
@@ -1103,55 +1222,62 @@ export namespace Components {
1103
1222
  */
1104
1223
  "name": string;
1105
1224
  /**
1106
- * Whether or not the component will display as a tile. Available when uswds is true.
1225
+ * Whether or not the component will display as a tile.
1107
1226
  */
1108
1227
  "tile"?: boolean;
1109
- /**
1110
- * Whether or not the component will use USWDS v3. styling.
1111
- */
1112
- "uswds"?: boolean;
1113
1228
  /**
1114
1229
  * The value attribute for the input element.
1115
1230
  */
1116
1231
  "value": string;
1117
1232
  }
1233
+ /**
1234
+ * @componentName Search input
1235
+ * @maturityCategory use
1236
+ * @maturityLevel deployed
1237
+ */
1118
1238
  interface VaSearchInput {
1119
1239
  /**
1120
- * If `true`, the component will use the big variant. Only available when `uswds` is `true`.
1240
+ * If `true`, the component will use the big variant.
1121
1241
  */
1122
1242
  "big"?: boolean;
1123
1243
  /**
1124
1244
  * Text displayed inside the search button
1125
1245
  */
1126
1246
  "buttonText"?: string;
1247
+ /**
1248
+ * If `true`, the component-library-analytics event is disabled.
1249
+ */
1250
+ "disableAnalytics"?: boolean;
1127
1251
  /**
1128
1252
  * The aria-label for search input and button. Default is 'Search'.
1129
1253
  */
1130
1254
  "label"?: string;
1131
1255
  /**
1132
- * If `true`, the component will use the small variant. Only available when `uswds` is `true`.
1256
+ * If `true`, the component will use the small variant.
1133
1257
  */
1134
1258
  "small"?: boolean;
1135
1259
  /**
1136
1260
  * An array of strings containing suggestions to be displayed in listbox. This component displays up to 5 suggestions.
1137
1261
  */
1138
1262
  "suggestions"?: any;
1139
- /**
1140
- * Whether or not the component will use USWDS v3 styling.
1141
- */
1142
- "uswds"?: boolean;
1143
1263
  /**
1144
1264
  * The value of the input field
1145
1265
  */
1146
1266
  "value"?: string;
1147
1267
  }
1268
+ /**
1269
+ * @componentName Progress bar - segmented
1270
+ * @maturityCategory use
1271
+ * @maturityLevel deployed
1272
+ * @guidanceHref form/progress-bar-segmented
1273
+ */
1148
1274
  interface VaSegmentedProgressBar {
1149
1275
  /**
1150
- * Whether or not to center the step labels (v3 only)
1276
+ * Whether or not to center the step labels
1151
1277
  */
1152
1278
  "centeredLabels"?: boolean;
1153
1279
  /**
1154
- * Show number counters for each step (v3 only)
1280
+ * Show number counters for each step
1155
1281
  */
1156
1282
  "counters"?: "default" | "small";
1157
1283
  /**
@@ -1163,11 +1289,11 @@ export namespace Components {
1163
1289
  */
1164
1290
  "enableAnalytics"?: boolean;
1165
1291
  /**
1166
- * Header level for button wrapper. Must be between 1 and 6 (v3 only)
1292
+ * Header level for button wrapper. Must be between 1 and 6
1167
1293
  */
1168
1294
  "headerLevel"?: number;
1169
1295
  /**
1170
- * Text of current step (v3 only)
1296
+ * Text of current step
1171
1297
  */
1172
1298
  "headingText"?: string;
1173
1299
  /**
@@ -1175,7 +1301,7 @@ export namespace Components {
1175
1301
  */
1176
1302
  "label"?: string;
1177
1303
  /**
1178
- * String containing a list of step labels delimited by a semi-colon (v3 only) Example: `"Step 1;Step 2;Step 3"`
1304
+ * String containing a list of step labels delimited by a semi-colon. Example: `"Step 1;Step 2;Step 3"`
1179
1305
  */
1180
1306
  "labels"?: string;
1181
1307
  /**
@@ -1187,14 +1313,19 @@ export namespace Components {
1187
1313
  */
1188
1314
  "total": number;
1189
1315
  /**
1190
- * When true, this makes the segmented-progress-bar use a div instead of a heading (v3 only)
1316
+ * When true, this makes the segmented-progress-bar use a div instead of a heading
1191
1317
  */
1192
1318
  "useDiv"?: boolean;
1193
- /**
1194
- * Whether or not the component will use USWDS v3 styling.
1195
- */
1196
- "uswds"?: boolean;
1197
1319
  }
1320
+ /**
1321
+ * @nativeHandler onKeyDown
1322
+ * @componentName Select
1323
+ * @maturityCategory use
1324
+ * @maturityLevel deployed
1325
+ * @guidanceHref form/select
1326
+ * @translations English
1327
+ * @translations Spanish
1328
+ */
1198
1329
  interface VaSelect {
1199
1330
  /**
1200
1331
  * Whether or not to fire the analytics events
@@ -1232,15 +1363,16 @@ export namespace Components {
1232
1363
  * Whether or not this is a required field.
1233
1364
  */
1234
1365
  "required"?: boolean;
1235
- /**
1236
- * Whether or not the component will use USWDS v3 styling.
1237
- */
1238
- "uswds"?: boolean;
1239
1366
  /**
1240
1367
  * Selected value (will get updated on select).
1241
1368
  */
1242
1369
  "value"?: string;
1243
1370
  }
1371
+ /**
1372
+ * @componentName Statement of truth
1373
+ * @maturityCategory caution
1374
+ * @maturityLevel candidate
1375
+ */
1244
1376
  interface VaStatementOfTruth {
1245
1377
  /**
1246
1378
  * The error to be applied to the va-check-box element
@@ -1275,21 +1407,14 @@ export namespace Components {
1275
1407
  */
1276
1408
  "inputValue": string;
1277
1409
  }
1410
+ /**
1411
+ * @componentName Summary box
1412
+ * @maturityCategory use
1413
+ * @maturityLevel deployed
1414
+ */
1278
1415
  interface VaSummaryBox {
1279
- /**
1280
- * Whether or not the component will use USWDS v3 styling.
1281
- */
1282
- "uswds"?: boolean;
1283
1416
  }
1284
1417
  interface VaTable {
1285
- /**
1286
- * Whether the initial sort state will be descending or not.
1287
- */
1288
- "descending"?: boolean;
1289
- /**
1290
- * The zero-based index of the column to sort by (Doesn't work in IE11). Optional.
1291
- */
1292
- "sortColumn"?: number;
1293
1418
  /**
1294
1419
  * Convert to a stacked table when screen size is small True by default, must specify if false if this is unwanted
1295
1420
  */
@@ -1302,25 +1427,18 @@ export namespace Components {
1302
1427
  * If uswds is true, the type of table
1303
1428
  */
1304
1429
  "tableType"?: 'borderless';
1305
- /**
1306
- * Whether or not the component will use USWDS v3 styling.
1307
- */
1308
- "uswds"?: boolean;
1309
1430
  }
1431
+ /**
1432
+ * @componentName Table
1433
+ * @maturityCategory use
1434
+ * @maturityLevel best_practice
1435
+ */
1310
1436
  interface VaTableInner {
1311
1437
  /**
1312
- * If uswds is true, the number of columns in the table
1438
+ * The number of columns in the table
1313
1439
  */
1314
1440
  "cols"?: number;
1315
- /**
1316
- * Whether the initial sort state will be descending or not.
1317
- */
1318
- "descending"?: boolean;
1319
1441
  "rows"?: number;
1320
- /**
1321
- * The zero-based index of the column to sort by (Doesn't work in IE11). Optional.
1322
- */
1323
- "sortColumn"?: number;
1324
1442
  /**
1325
1443
  * If true convert to a stacked table when screen size is small
1326
1444
  */
@@ -1330,20 +1448,17 @@ export namespace Components {
1330
1448
  */
1331
1449
  "tableTitle": string;
1332
1450
  /**
1333
- * If uswds is true, the type of table to be used
1451
+ * The type of table to be used
1334
1452
  */
1335
1453
  "tableType"?: 'borderless';
1336
- /**
1337
- * Whether or not the component will use USWDS v3 styling.
1338
- */
1339
- "uswds"?: boolean;
1340
- /**
1341
- * A live reference to the va-table-rows in the table which are hard to access from this component
1342
- */
1343
- "vaTableRowRefs"?: any;
1344
1454
  }
1345
1455
  interface VaTableRow {
1346
1456
  }
1457
+ /**
1458
+ * @componentName Telephone
1459
+ * @maturityCategory use
1460
+ * @maturityLevel best_practice
1461
+ */
1347
1462
  interface VaTelephone {
1348
1463
  /**
1349
1464
  * Numeric string representing the contact number. Typical length is 3 or 10 digits - SMS short codes will be 5 or 6 digits.
@@ -1378,6 +1493,17 @@ export namespace Components {
1378
1493
  */
1379
1494
  "vanity"?: string;
1380
1495
  }
1496
+ /**
1497
+ * @nativeHandler onInput
1498
+ * @nativeHandler onBlur
1499
+ * @componentName Text input
1500
+ * @maturityCategory use
1501
+ * @maturityLevel deployed
1502
+ * @guidanceHref form/text-input
1503
+ * @translations English
1504
+ * @translations Spanish
1505
+ * @translations Tagalog
1506
+ */
1381
1507
  interface VaTextInput {
1382
1508
  /**
1383
1509
  * Allows the browser to automatically complete the input.
@@ -1415,6 +1541,10 @@ export namespace Components {
1415
1541
  * This property displays a prefix that accepts a string which represents icon name.
1416
1542
  */
1417
1543
  "inputIconPrefix"?: string;
1544
+ /**
1545
+ * A string that represents the name of an icon passed to va-icon, which will be applied as a suffix to the input.
1546
+ */
1547
+ "inputIconSuffix"?: string;
1418
1548
  /**
1419
1549
  * Displays a fixed prefix string at the start of the input field.
1420
1550
  */
@@ -1473,6 +1603,14 @@ export namespace Components {
1473
1603
  * Set the input to required and render the (Required) text.
1474
1604
  */
1475
1605
  "required"?: boolean;
1606
+ /**
1607
+ * When `false`, hides the error message from view, but not from the screen reader. Should only be used if error is being displayed elsewhere. Must use kebab-case on this attribute for it to work properly.
1608
+ */
1609
+ "showInputError"?: boolean;
1610
+ /**
1611
+ * The step attribute is a number, or the string 'any', that specifies the granularity of the value. For example: `<va-text-input type="number" step=".1"/>` enables float/decimal values to be valid and increment by one-tenth. <br/> Defaults to 1 for every field type except for time and datetime-local which default to 60 (seconds). View more documentation on [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)
1612
+ */
1613
+ "step"?: string;
1476
1614
  /**
1477
1615
  * Adds styling based on status value
1478
1616
  */
@@ -1494,6 +1632,16 @@ export namespace Components {
1494
1632
  */
1495
1633
  "width"?: string;
1496
1634
  }
1635
+ /**
1636
+ * @nativeHandler onInput
1637
+ * @nativeHandler onBlur
1638
+ * @componentName Textarea
1639
+ * @maturityCategory use
1640
+ * @maturityLevel deployed
1641
+ * @guidanceHref form/textarea
1642
+ * @translations English
1643
+ * @translations Spanish
1644
+ */
1497
1645
  interface VaTextarea {
1498
1646
  /**
1499
1647
  * Whether the component should show a character count message. Has no effect without maxlength being set.
@@ -1649,10 +1797,6 @@ export interface VaNotificationCustomEvent<T> extends CustomEvent<T> {
1649
1797
  detail: T;
1650
1798
  target: HTMLVaNotificationElement;
1651
1799
  }
1652
- export interface VaNumberInputCustomEvent<T> extends CustomEvent<T> {
1653
- detail: T;
1654
- target: HTMLVaNumberInputElement;
1655
- }
1656
1800
  export interface VaOfficialGovBannerCustomEvent<T> extends CustomEvent<T> {
1657
1801
  detail: T;
1658
1802
  target: HTMLVaOfficialGovBannerElement;
@@ -1714,6 +1858,15 @@ export interface VaTextareaCustomEvent<T> extends CustomEvent<T> {
1714
1858
  target: HTMLVaTextareaElement;
1715
1859
  }
1716
1860
  declare global {
1861
+ /**
1862
+ * @componentName Accordion
1863
+ * @accordionItemToggled This event is fired when an accordion item is opened or closed
1864
+ * @maturityCategory use
1865
+ * @maturityLevel best_practice
1866
+ * @translations English
1867
+ * @translations Spanish
1868
+ * @translations Tagalog
1869
+ */
1717
1870
  interface HTMLVaAccordionElement extends Components.VaAccordion, HTMLStencilElement {
1718
1871
  }
1719
1872
  var HTMLVaAccordionElement: {
@@ -1726,204 +1879,391 @@ declare global {
1726
1879
  prototype: HTMLVaAccordionItemElement;
1727
1880
  new (): HTMLVaAccordionItemElement;
1728
1881
  };
1882
+ /**
1883
+ * @componentName Additional info
1884
+ * @maturityCategory use
1885
+ * @maturityLevel deployed
1886
+ */
1729
1887
  interface HTMLVaAdditionalInfoElement extends Components.VaAdditionalInfo, HTMLStencilElement {
1730
1888
  }
1731
1889
  var HTMLVaAdditionalInfoElement: {
1732
1890
  prototype: HTMLVaAdditionalInfoElement;
1733
1891
  new (): HTMLVaAdditionalInfoElement;
1734
1892
  };
1893
+ /**
1894
+ * @componentName Alert
1895
+ * @maturityCategory use
1896
+ * @maturityLevel best_practice
1897
+ */
1735
1898
  interface HTMLVaAlertElement extends Components.VaAlert, HTMLStencilElement {
1736
1899
  }
1737
1900
  var HTMLVaAlertElement: {
1738
1901
  prototype: HTMLVaAlertElement;
1739
1902
  new (): HTMLVaAlertElement;
1740
1903
  };
1904
+ /**
1905
+ * @componentName Alert - expandable
1906
+ * @maturityCategory caution
1907
+ * @maturityLevel candidate
1908
+ */
1741
1909
  interface HTMLVaAlertExpandableElement extends Components.VaAlertExpandable, HTMLStencilElement {
1742
1910
  }
1743
1911
  var HTMLVaAlertExpandableElement: {
1744
1912
  prototype: HTMLVaAlertExpandableElement;
1745
1913
  new (): HTMLVaAlertExpandableElement;
1746
1914
  };
1915
+ /**
1916
+ * @componentName Back to top
1917
+ * @maturityCategory use
1918
+ * @maturityLevel deployed
1919
+ */
1747
1920
  interface HTMLVaBackToTopElement extends Components.VaBackToTop, HTMLStencilElement {
1748
1921
  }
1749
1922
  var HTMLVaBackToTopElement: {
1750
1923
  prototype: HTMLVaBackToTopElement;
1751
1924
  new (): HTMLVaBackToTopElement;
1752
1925
  };
1926
+ /**
1927
+ * @componentName Banner
1928
+ * @maturityCategory use
1929
+ * @maturityLevel deployed
1930
+ */
1753
1931
  interface HTMLVaBannerElement extends Components.VaBanner, HTMLStencilElement {
1754
1932
  }
1755
1933
  var HTMLVaBannerElement: {
1756
1934
  prototype: HTMLVaBannerElement;
1757
1935
  new (): HTMLVaBannerElement;
1758
1936
  };
1937
+ /**
1938
+ * @componentName Breadcrumbs
1939
+ * @maturityCategory use
1940
+ * @maturityLevel deployed
1941
+ */
1759
1942
  interface HTMLVaBreadcrumbsElement extends Components.VaBreadcrumbs, HTMLStencilElement {
1760
1943
  }
1761
1944
  var HTMLVaBreadcrumbsElement: {
1762
1945
  prototype: HTMLVaBreadcrumbsElement;
1763
1946
  new (): HTMLVaBreadcrumbsElement;
1764
1947
  };
1948
+ /**
1949
+ * @componentName Button
1950
+ * @nativeHandler onClick
1951
+ * @maturityCategory caution
1952
+ * @maturityLevel candidate
1953
+ */
1765
1954
  interface HTMLVaButtonElement extends Components.VaButton, HTMLStencilElement {
1766
1955
  }
1767
1956
  var HTMLVaButtonElement: {
1768
1957
  prototype: HTMLVaButtonElement;
1769
1958
  new (): HTMLVaButtonElement;
1770
1959
  };
1960
+ /**
1961
+ * @componentName Button - Icon
1962
+ * @nativeHandler onClick
1963
+ * @maturityCategory caution
1964
+ * @maturityLevel candidate
1965
+ */
1771
1966
  interface HTMLVaButtonIconElement extends Components.VaButtonIcon, HTMLStencilElement {
1772
1967
  }
1773
1968
  var HTMLVaButtonIconElement: {
1774
1969
  prototype: HTMLVaButtonIconElement;
1775
1970
  new (): HTMLVaButtonIconElement;
1776
1971
  };
1972
+ /**
1973
+ * @componentName Button pair
1974
+ * @maturityCategory caution
1975
+ * @maturityLevel candidate
1976
+ * @guidanceHref button/button-pair
1977
+ */
1777
1978
  interface HTMLVaButtonPairElement extends Components.VaButtonPair, HTMLStencilElement {
1778
1979
  }
1779
1980
  var HTMLVaButtonPairElement: {
1780
1981
  prototype: HTMLVaButtonPairElement;
1781
1982
  new (): HTMLVaButtonPairElement;
1782
1983
  };
1984
+ /**
1985
+ * @componentName Card
1986
+ * @maturityCategory caution
1987
+ * @maturityLevel candidate
1988
+ */
1783
1989
  interface HTMLVaCardElement extends Components.VaCard, HTMLStencilElement {
1784
1990
  }
1785
1991
  var HTMLVaCardElement: {
1786
1992
  prototype: HTMLVaCardElement;
1787
1993
  new (): HTMLVaCardElement;
1788
1994
  };
1995
+ /**
1996
+ * @nativeHandler onBlur
1997
+ * @componentName Checkbox
1998
+ * @maturityCategory use
1999
+ * @maturityLevel deployed
2000
+ * @guidanceHref form/checkbox
2001
+ * @translations English
2002
+ * @translations Spanish
2003
+ * @translations Tagalog
2004
+ */
1789
2005
  interface HTMLVaCheckboxElement extends Components.VaCheckbox, HTMLStencilElement {
1790
2006
  }
1791
2007
  var HTMLVaCheckboxElement: {
1792
2008
  prototype: HTMLVaCheckboxElement;
1793
2009
  new (): HTMLVaCheckboxElement;
1794
2010
  };
2011
+ /**
2012
+ * @vaChange The event emitted when the input value changes.
2013
+ * @componentName Checkbox group
2014
+ * @maturityCategory use
2015
+ * @maturityLevel deployed
2016
+ * @guidanceHref form/checkbox
2017
+ * @translations English
2018
+ * @translations Spanish
2019
+ * @translations Tagalog
2020
+ */
1795
2021
  interface HTMLVaCheckboxGroupElement extends Components.VaCheckboxGroup, HTMLStencilElement {
1796
2022
  }
1797
2023
  var HTMLVaCheckboxGroupElement: {
1798
2024
  prototype: HTMLVaCheckboxGroupElement;
1799
2025
  new (): HTMLVaCheckboxGroupElement;
1800
2026
  };
2027
+ /**
2028
+ * @componentName Crisis Line Modal
2029
+ * @maturityCategory caution
2030
+ * @maturityLevel candidate
2031
+ */
1801
2032
  interface HTMLVaCrisisLineModalElement extends Components.VaCrisisLineModal, HTMLStencilElement {
1802
2033
  }
1803
2034
  var HTMLVaCrisisLineModalElement: {
1804
2035
  prototype: HTMLVaCrisisLineModalElement;
1805
2036
  new (): HTMLVaCrisisLineModalElement;
1806
2037
  };
2038
+ /**
2039
+ * @componentName Date input
2040
+ * @maturityCategory use
2041
+ * @maturityLevel deployed
2042
+ * @guidanceHref form/date-input
2043
+ */
1807
2044
  interface HTMLVaDateElement extends Components.VaDate, HTMLStencilElement {
1808
2045
  }
1809
2046
  var HTMLVaDateElement: {
1810
2047
  prototype: HTMLVaDateElement;
1811
2048
  new (): HTMLVaDateElement;
1812
2049
  };
2050
+ /**
2051
+ * @componentName File input
2052
+ * @maturityCategory caution
2053
+ * @maturityLevel available
2054
+ * @guidanceHref form/file-input
2055
+ */
1813
2056
  interface HTMLVaFileInputElement extends Components.VaFileInput, HTMLStencilElement {
1814
2057
  }
1815
2058
  var HTMLVaFileInputElement: {
1816
2059
  prototype: HTMLVaFileInputElement;
1817
2060
  new (): HTMLVaFileInputElement;
1818
2061
  };
2062
+ /**
2063
+ * A component that manages multiple file inputs, allowing users to upload several files.
2064
+ * It supports adding, changing, and removing files with dynamic error handling.
2065
+ * @componentName File input multiple
2066
+ * @maturityCategory caution
2067
+ * @maturityLevel available
2068
+ * @guidanceHref form/file-input-multiple
2069
+ */
1819
2070
  interface HTMLVaFileInputMultipleElement extends Components.VaFileInputMultiple, HTMLStencilElement {
1820
2071
  }
1821
2072
  var HTMLVaFileInputMultipleElement: {
1822
2073
  prototype: HTMLVaFileInputMultipleElement;
1823
2074
  new (): HTMLVaFileInputMultipleElement;
1824
2075
  };
2076
+ /**
2077
+ * @componentName Header - Minimal
2078
+ * @maturityCategory caution
2079
+ * @maturityLevel candidate
2080
+ * @guidanceHref header/header-minimal
2081
+ */
1825
2082
  interface HTMLVaHeaderMinimalElement extends Components.VaHeaderMinimal, HTMLStencilElement {
1826
2083
  }
1827
2084
  var HTMLVaHeaderMinimalElement: {
1828
2085
  prototype: HTMLVaHeaderMinimalElement;
1829
2086
  new (): HTMLVaHeaderMinimalElement;
1830
2087
  };
2088
+ /**
2089
+ * @componentName Icon
2090
+ * @maturityCategory caution
2091
+ * @maturityLevel candidate
2092
+ */
1831
2093
  interface HTMLVaIconElement extends Components.VaIcon, HTMLStencilElement {
1832
2094
  }
1833
2095
  var HTMLVaIconElement: {
1834
2096
  prototype: HTMLVaIconElement;
1835
2097
  new (): HTMLVaIconElement;
1836
2098
  };
2099
+ /**
2100
+ * @componentName Link
2101
+ * @maturityCategory caution
2102
+ * @maturityLevel candidate
2103
+ */
1837
2104
  interface HTMLVaLinkElement extends Components.VaLink, HTMLStencilElement {
1838
2105
  }
1839
2106
  var HTMLVaLinkElement: {
1840
2107
  prototype: HTMLVaLinkElement;
1841
2108
  new (): HTMLVaLinkElement;
1842
2109
  };
2110
+ /**
2111
+ * @componentName Link - Action
2112
+ * @maturityCategory caution
2113
+ * @maturityLevel candidate
2114
+ */
1843
2115
  interface HTMLVaLinkActionElement extends Components.VaLinkAction, HTMLStencilElement {
1844
2116
  }
1845
2117
  var HTMLVaLinkActionElement: {
1846
2118
  prototype: HTMLVaLinkActionElement;
1847
2119
  new (): HTMLVaLinkActionElement;
1848
2120
  };
2121
+ /**
2122
+ * @componentName Loading indicator
2123
+ * @maturityCategory use
2124
+ * @maturityLevel best_practice
2125
+ */
1849
2126
  interface HTMLVaLoadingIndicatorElement extends Components.VaLoadingIndicator, HTMLStencilElement {
1850
2127
  }
1851
2128
  var HTMLVaLoadingIndicatorElement: {
1852
2129
  prototype: HTMLVaLoadingIndicatorElement;
1853
2130
  new (): HTMLVaLoadingIndicatorElement;
1854
2131
  };
2132
+ /**
2133
+ * @componentName Banner - Maintenance
2134
+ * @maturityCategory caution
2135
+ * @maturityLevel available
2136
+ */
1855
2137
  interface HTMLVaMaintenanceBannerElement extends Components.VaMaintenanceBanner, HTMLStencilElement {
1856
2138
  }
1857
2139
  var HTMLVaMaintenanceBannerElement: {
1858
2140
  prototype: HTMLVaMaintenanceBannerElement;
1859
2141
  new (): HTMLVaMaintenanceBannerElement;
1860
2142
  };
2143
+ /**
2144
+ * @componentName Memorable date
2145
+ * @maturityCategory caution
2146
+ * @maturityLevel available
2147
+ * @guidanceHref form/memorable-date
2148
+ * @translations English
2149
+ * @translations Spanish
2150
+ */
1861
2151
  interface HTMLVaMemorableDateElement extends Components.VaMemorableDate, HTMLStencilElement {
1862
2152
  }
1863
2153
  var HTMLVaMemorableDateElement: {
1864
2154
  prototype: HTMLVaMemorableDateElement;
1865
2155
  new (): HTMLVaMemorableDateElement;
1866
2156
  };
2157
+ /**
2158
+ * @componentName Minimal Footer
2159
+ * @maturityCategory caution
2160
+ * @maturityLevel candidate
2161
+ */
1867
2162
  interface HTMLVaMinimalFooterElement extends Components.VaMinimalFooter, HTMLStencilElement {
1868
2163
  }
1869
2164
  var HTMLVaMinimalFooterElement: {
1870
2165
  prototype: HTMLVaMinimalFooterElement;
1871
2166
  new (): HTMLVaMinimalFooterElement;
1872
2167
  };
2168
+ /**
2169
+ * @click Used to detect clicks outside of modal contents to close modal.
2170
+ * @keydown Used to detect Escape key to close modal.
2171
+ * @componentName Modal
2172
+ * @maturityCategory use
2173
+ * @maturityLevel deployed
2174
+ */
1873
2175
  interface HTMLVaModalElement extends Components.VaModal, HTMLStencilElement {
1874
2176
  }
1875
2177
  var HTMLVaModalElement: {
1876
2178
  prototype: HTMLVaModalElement;
1877
2179
  new (): HTMLVaModalElement;
1878
2180
  };
2181
+ /**
2182
+ * @componentName Need help?
2183
+ * @maturityCategory caution
2184
+ * @maturityLevel candidate
2185
+ * @guidanceHref form/need-help
2186
+ */
1879
2187
  interface HTMLVaNeedHelpElement extends Components.VaNeedHelp, HTMLStencilElement {
1880
2188
  }
1881
2189
  var HTMLVaNeedHelpElement: {
1882
2190
  prototype: HTMLVaNeedHelpElement;
1883
2191
  new (): HTMLVaNeedHelpElement;
1884
2192
  };
2193
+ /**
2194
+ * @componentName Notification
2195
+ * @maturityCategory dont_use
2196
+ * @maturityLevel deprecated
2197
+ */
1885
2198
  interface HTMLVaNotificationElement extends Components.VaNotification, HTMLStencilElement {
1886
2199
  }
1887
2200
  var HTMLVaNotificationElement: {
1888
2201
  prototype: HTMLVaNotificationElement;
1889
2202
  new (): HTMLVaNotificationElement;
1890
2203
  };
1891
- interface HTMLVaNumberInputElement extends Components.VaNumberInput, HTMLStencilElement {
1892
- }
1893
- var HTMLVaNumberInputElement: {
1894
- prototype: HTMLVaNumberInputElement;
1895
- new (): HTMLVaNumberInputElement;
1896
- };
2204
+ /**
2205
+ * @componentName Banner - Official Gov
2206
+ * @maturityCategory caution
2207
+ * @maturityLevel candidate
2208
+ */
1897
2209
  interface HTMLVaOfficialGovBannerElement extends Components.VaOfficialGovBanner, HTMLStencilElement {
1898
2210
  }
1899
2211
  var HTMLVaOfficialGovBannerElement: {
1900
2212
  prototype: HTMLVaOfficialGovBannerElement;
1901
2213
  new (): HTMLVaOfficialGovBannerElement;
1902
2214
  };
2215
+ /**
2216
+ * @componentName OMB info
2217
+ * @maturityCategory use
2218
+ * @maturityLevel best_practice
2219
+ */
1903
2220
  interface HTMLVaOmbInfoElement extends Components.VaOmbInfo, HTMLStencilElement {
1904
2221
  }
1905
2222
  var HTMLVaOmbInfoElement: {
1906
2223
  prototype: HTMLVaOmbInfoElement;
1907
2224
  new (): HTMLVaOmbInfoElement;
1908
2225
  };
2226
+ /**
2227
+ * @componentName On this page
2228
+ * @maturityCategory use
2229
+ * @maturityLevel best_practice
2230
+ * @translations English
2231
+ * @translations Spanish
2232
+ * @translations Tagalog
2233
+ */
1909
2234
  interface HTMLVaOnThisPageElement extends Components.VaOnThisPage, HTMLStencilElement {
1910
2235
  }
1911
2236
  var HTMLVaOnThisPageElement: {
1912
2237
  prototype: HTMLVaOnThisPageElement;
1913
2238
  new (): HTMLVaOnThisPageElement;
1914
2239
  };
2240
+ /**
2241
+ * @componentName Pagination
2242
+ * @maturityCategory use
2243
+ * @maturityLevel deployed
2244
+ */
1915
2245
  interface HTMLVaPaginationElement extends Components.VaPagination, HTMLStencilElement {
1916
2246
  }
1917
2247
  var HTMLVaPaginationElement: {
1918
2248
  prototype: HTMLVaPaginationElement;
1919
2249
  new (): HTMLVaPaginationElement;
1920
2250
  };
2251
+ /**
2252
+ * @componentName Privacy agreement
2253
+ * @maturityCategory caution
2254
+ * @maturityLevel available
2255
+ */
1921
2256
  interface HTMLVaPrivacyAgreementElement extends Components.VaPrivacyAgreement, HTMLStencilElement {
1922
2257
  }
1923
2258
  var HTMLVaPrivacyAgreementElement: {
1924
2259
  prototype: HTMLVaPrivacyAgreementElement;
1925
2260
  new (): HTMLVaPrivacyAgreementElement;
1926
2261
  };
2262
+ /**
2263
+ * @componentName Process list
2264
+ * @maturityCategory use
2265
+ * @maturityLevel deployed
2266
+ */
1927
2267
  interface HTMLVaProcessListElement extends Components.VaProcessList, HTMLStencilElement {
1928
2268
  }
1929
2269
  var HTMLVaProcessListElement: {
@@ -1936,18 +2276,40 @@ declare global {
1936
2276
  prototype: HTMLVaProcessListItemElement;
1937
2277
  new (): HTMLVaProcessListItemElement;
1938
2278
  };
2279
+ /**
2280
+ * @componentName Progress bar - activity
2281
+ * @maturityCategory use
2282
+ * @maturityLevel deployed
2283
+ */
1939
2284
  interface HTMLVaProgressBarElement extends Components.VaProgressBar, HTMLStencilElement {
1940
2285
  }
1941
2286
  var HTMLVaProgressBarElement: {
1942
2287
  prototype: HTMLVaProgressBarElement;
1943
2288
  new (): HTMLVaProgressBarElement;
1944
2289
  };
2290
+ /**
2291
+ * @componentName Banner - Promo
2292
+ * @maturityCategory use
2293
+ * @maturityLevel deployed
2294
+ * @guidanceHref banner/promo
2295
+ */
1945
2296
  interface HTMLVaPromoBannerElement extends Components.VaPromoBanner, HTMLStencilElement {
1946
2297
  }
1947
2298
  var HTMLVaPromoBannerElement: {
1948
2299
  prototype: HTMLVaPromoBannerElement;
1949
2300
  new (): HTMLVaPromoBannerElement;
1950
2301
  };
2302
+ /**
2303
+ * @keydown The event emitted when a key is pressed.
2304
+ * @radioOptionSelected The event emitted when the selected option value changes.
2305
+ * @componentName Radio button
2306
+ * @maturityCategory use
2307
+ * @maturityLevel deployed
2308
+ * @guidanceHref form/radio-button
2309
+ * @translations English
2310
+ * @translations Spanish
2311
+ * @translations Tagalog
2312
+ */
1951
2313
  interface HTMLVaRadioElement extends Components.VaRadio, HTMLStencilElement {
1952
2314
  }
1953
2315
  var HTMLVaRadioElement: {
@@ -1960,30 +2322,60 @@ declare global {
1960
2322
  prototype: HTMLVaRadioOptionElement;
1961
2323
  new (): HTMLVaRadioOptionElement;
1962
2324
  };
2325
+ /**
2326
+ * @componentName Search input
2327
+ * @maturityCategory use
2328
+ * @maturityLevel deployed
2329
+ */
1963
2330
  interface HTMLVaSearchInputElement extends Components.VaSearchInput, HTMLStencilElement {
1964
2331
  }
1965
2332
  var HTMLVaSearchInputElement: {
1966
2333
  prototype: HTMLVaSearchInputElement;
1967
2334
  new (): HTMLVaSearchInputElement;
1968
2335
  };
2336
+ /**
2337
+ * @componentName Progress bar - segmented
2338
+ * @maturityCategory use
2339
+ * @maturityLevel deployed
2340
+ * @guidanceHref form/progress-bar-segmented
2341
+ */
1969
2342
  interface HTMLVaSegmentedProgressBarElement extends Components.VaSegmentedProgressBar, HTMLStencilElement {
1970
2343
  }
1971
2344
  var HTMLVaSegmentedProgressBarElement: {
1972
2345
  prototype: HTMLVaSegmentedProgressBarElement;
1973
2346
  new (): HTMLVaSegmentedProgressBarElement;
1974
2347
  };
2348
+ /**
2349
+ * @nativeHandler onKeyDown
2350
+ * @componentName Select
2351
+ * @maturityCategory use
2352
+ * @maturityLevel deployed
2353
+ * @guidanceHref form/select
2354
+ * @translations English
2355
+ * @translations Spanish
2356
+ */
1975
2357
  interface HTMLVaSelectElement extends Components.VaSelect, HTMLStencilElement {
1976
2358
  }
1977
2359
  var HTMLVaSelectElement: {
1978
2360
  prototype: HTMLVaSelectElement;
1979
2361
  new (): HTMLVaSelectElement;
1980
2362
  };
2363
+ /**
2364
+ * @componentName Statement of truth
2365
+ * @maturityCategory caution
2366
+ * @maturityLevel candidate
2367
+ */
1981
2368
  interface HTMLVaStatementOfTruthElement extends Components.VaStatementOfTruth, HTMLStencilElement {
1982
2369
  }
1983
2370
  var HTMLVaStatementOfTruthElement: {
1984
2371
  prototype: HTMLVaStatementOfTruthElement;
1985
2372
  new (): HTMLVaStatementOfTruthElement;
1986
2373
  };
2374
+ /**
2375
+ * @componentName Summary box
2376
+ * @maturityCategory use
2377
+ * @maturityLevel deployed
2378
+ */
1987
2379
  interface HTMLVaSummaryBoxElement extends Components.VaSummaryBox, HTMLStencilElement {
1988
2380
  }
1989
2381
  var HTMLVaSummaryBoxElement: {
@@ -1996,6 +2388,11 @@ declare global {
1996
2388
  prototype: HTMLVaTableElement;
1997
2389
  new (): HTMLVaTableElement;
1998
2390
  };
2391
+ /**
2392
+ * @componentName Table
2393
+ * @maturityCategory use
2394
+ * @maturityLevel best_practice
2395
+ */
1999
2396
  interface HTMLVaTableInnerElement extends Components.VaTableInner, HTMLStencilElement {
2000
2397
  }
2001
2398
  var HTMLVaTableInnerElement: {
@@ -2008,18 +2405,44 @@ declare global {
2008
2405
  prototype: HTMLVaTableRowElement;
2009
2406
  new (): HTMLVaTableRowElement;
2010
2407
  };
2408
+ /**
2409
+ * @componentName Telephone
2410
+ * @maturityCategory use
2411
+ * @maturityLevel best_practice
2412
+ */
2011
2413
  interface HTMLVaTelephoneElement extends Components.VaTelephone, HTMLStencilElement {
2012
2414
  }
2013
2415
  var HTMLVaTelephoneElement: {
2014
2416
  prototype: HTMLVaTelephoneElement;
2015
2417
  new (): HTMLVaTelephoneElement;
2016
2418
  };
2419
+ /**
2420
+ * @nativeHandler onInput
2421
+ * @nativeHandler onBlur
2422
+ * @componentName Text input
2423
+ * @maturityCategory use
2424
+ * @maturityLevel deployed
2425
+ * @guidanceHref form/text-input
2426
+ * @translations English
2427
+ * @translations Spanish
2428
+ * @translations Tagalog
2429
+ */
2017
2430
  interface HTMLVaTextInputElement extends Components.VaTextInput, HTMLStencilElement {
2018
2431
  }
2019
2432
  var HTMLVaTextInputElement: {
2020
2433
  prototype: HTMLVaTextInputElement;
2021
2434
  new (): HTMLVaTextInputElement;
2022
2435
  };
2436
+ /**
2437
+ * @nativeHandler onInput
2438
+ * @nativeHandler onBlur
2439
+ * @componentName Textarea
2440
+ * @maturityCategory use
2441
+ * @maturityLevel deployed
2442
+ * @guidanceHref form/textarea
2443
+ * @translations English
2444
+ * @translations Spanish
2445
+ */
2023
2446
  interface HTMLVaTextareaElement extends Components.VaTextarea, HTMLStencilElement {
2024
2447
  }
2025
2448
  var HTMLVaTextareaElement: {
@@ -2056,7 +2479,6 @@ declare global {
2056
2479
  "va-modal": HTMLVaModalElement;
2057
2480
  "va-need-help": HTMLVaNeedHelpElement;
2058
2481
  "va-notification": HTMLVaNotificationElement;
2059
- "va-number-input": HTMLVaNumberInputElement;
2060
2482
  "va-official-gov-banner": HTMLVaOfficialGovBannerElement;
2061
2483
  "va-omb-info": HTMLVaOmbInfoElement;
2062
2484
  "va-on-this-page": HTMLVaOnThisPageElement;
@@ -2082,6 +2504,15 @@ declare global {
2082
2504
  }
2083
2505
  }
2084
2506
  declare namespace LocalJSX {
2507
+ /**
2508
+ * @componentName Accordion
2509
+ * @accordionItemToggled This event is fired when an accordion item is opened or closed
2510
+ * @maturityCategory use
2511
+ * @maturityLevel best_practice
2512
+ * @translations English
2513
+ * @translations Spanish
2514
+ * @translations Tagalog
2515
+ */
2085
2516
  interface VaAccordion {
2086
2517
  /**
2087
2518
  * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -2126,6 +2557,11 @@ declare namespace LocalJSX {
2126
2557
  */
2127
2558
  "subheader"?: string;
2128
2559
  }
2560
+ /**
2561
+ * @componentName Additional info
2562
+ * @maturityCategory use
2563
+ * @maturityLevel deployed
2564
+ */
2129
2565
  interface VaAdditionalInfo {
2130
2566
  /**
2131
2567
  * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -2143,16 +2579,13 @@ declare namespace LocalJSX {
2143
2579
  * The text to trigger the expansion
2144
2580
  */
2145
2581
  "trigger": string;
2146
- /**
2147
- * Whether or not the component will use USWDS v3 styling.
2148
- */
2149
- "uswds"?: boolean;
2150
2582
  }
2583
+ /**
2584
+ * @componentName Alert
2585
+ * @maturityCategory use
2586
+ * @maturityLevel best_practice
2587
+ */
2151
2588
  interface VaAlert {
2152
- /**
2153
- * If `true`, renders the alert with only a background color corresponding to the status - no left border. (v1 only)
2154
- */
2155
- "backgroundOnly"?: boolean;
2156
2589
  /**
2157
2590
  * Aria-label text for the close button.
2158
2591
  */
@@ -2182,7 +2615,7 @@ declare namespace LocalJSX {
2182
2615
  */
2183
2616
  "onVa-component-did-load"?: (event: VaAlertCustomEvent<any>) => void;
2184
2617
  /**
2185
- * Displays the slim variation. Available when USWDS is true.
2618
+ * Displays the slim variation.
2186
2619
  */
2187
2620
  "slim"?: boolean;
2188
2621
  /**
@@ -2193,15 +2626,16 @@ declare namespace LocalJSX {
2193
2626
  | 'error'
2194
2627
  | 'success'
2195
2628
  | 'continue';
2196
- /**
2197
- * Whether or not the component will use USWDS v3 styling.
2198
- */
2199
- "uswds"?: boolean;
2200
2629
  /**
2201
2630
  * If `true`, the alert will be visible.
2202
2631
  */
2203
2632
  "visible"?: boolean;
2204
2633
  }
2634
+ /**
2635
+ * @componentName Alert - expandable
2636
+ * @maturityCategory caution
2637
+ * @maturityLevel candidate
2638
+ */
2205
2639
  interface VaAlertExpandable {
2206
2640
  /**
2207
2641
  * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -2224,8 +2658,18 @@ declare namespace LocalJSX {
2224
2658
  */
2225
2659
  "trigger": string;
2226
2660
  }
2661
+ /**
2662
+ * @componentName Back to top
2663
+ * @maturityCategory use
2664
+ * @maturityLevel deployed
2665
+ */
2227
2666
  interface VaBackToTop {
2228
2667
  }
2668
+ /**
2669
+ * @componentName Banner
2670
+ * @maturityCategory use
2671
+ * @maturityLevel deployed
2672
+ */
2229
2673
  interface VaBanner {
2230
2674
  /**
2231
2675
  * Aria Label for the "region" of the nested va-alert.
@@ -2248,7 +2692,7 @@ declare namespace LocalJSX {
2248
2692
  */
2249
2693
  "showClose"?: boolean;
2250
2694
  /**
2251
- * The type of the banner. This affects both the icon of the AlertBox and the top border color.
2695
+ * The type of the banner. This affects both the icon of the AlertBox and border color / background.
2252
2696
  */
2253
2697
  "type"?: 'info' | 'warning' | 'error' | 'success' | 'continue';
2254
2698
  /**
@@ -2260,9 +2704,14 @@ declare namespace LocalJSX {
2260
2704
  */
2261
2705
  "windowSession"?: boolean;
2262
2706
  }
2707
+ /**
2708
+ * @componentName Breadcrumbs
2709
+ * @maturityCategory use
2710
+ * @maturityLevel deployed
2711
+ */
2263
2712
  interface VaBreadcrumbs {
2264
2713
  /**
2265
- * Represents a list of breadcrumbs. Use a JSON array of objects with label and href properties, then wrap in a string if using non-React-binding version. See Storybook examples for React-binding version. For pure web components, here's an example link: ``[{"href": "/link1", "label": "Link 1"}]`. This prop is available when `uswds` is set to `true`.
2714
+ * Represents a list of breadcrumbs. Use a JSON array of objects with label and href properties, then wrap in a string if using non-React-binding version. See Storybook examples for React-binding version. For pure web components, here's an example link: ``[{"href": "/link1", "label": "Link 1"}]`.
2266
2715
  */
2267
2716
  "breadcrumbList"?: Breadcrumb[] | string;
2268
2717
  /**
@@ -2282,18 +2731,20 @@ declare namespace LocalJSX {
2282
2731
  */
2283
2732
  "onComponent-library-analytics"?: (event: VaBreadcrumbsCustomEvent<any>) => void;
2284
2733
  /**
2285
- * Fires when user clicks on breadcrumb anchor tag. Has no effect unless uswds is true and the href of anchor tag is part of breadcrumb object that also has isRouterLink: true
2734
+ * Fires when user clicks on breadcrumb anchor tag. Has no effect unless the href of anchor tag is part of breadcrumb object that also has isRouterLink: true
2286
2735
  */
2287
2736
  "onRouteChange"?: (event: VaBreadcrumbsCustomEvent<{ href: string }>) => void;
2288
2737
  /**
2289
- * Whether or not the component will use USWDS v3 styling.
2290
- */
2291
- "uswds"?: boolean;
2292
- /**
2293
- * Whether or not the component will wrap the breadcrumbs. This prop is available when `uswds` is set to `true`.
2738
+ * Whether or not the component will wrap the breadcrumbs.
2294
2739
  */
2295
2740
  "wrapping"?: boolean;
2296
2741
  }
2742
+ /**
2743
+ * @componentName Button
2744
+ * @nativeHandler onClick
2745
+ * @maturityCategory caution
2746
+ * @maturityLevel candidate
2747
+ */
2297
2748
  interface VaButton {
2298
2749
  /**
2299
2750
  * If `true`, the button will use `Back` as its text and an icon to represent going back in form flows.
@@ -2343,11 +2794,13 @@ declare namespace LocalJSX {
2343
2794
  * The text displayed on the button. If `continue` or `back` is true, the value of text is ignored.
2344
2795
  */
2345
2796
  "text"?: string;
2346
- /**
2347
- * Whether or not the component will use USWDS v3 styling.
2348
- */
2349
- "uswds"?: boolean;
2350
2797
  }
2798
+ /**
2799
+ * @componentName Button - Icon
2800
+ * @nativeHandler onClick
2801
+ * @maturityCategory caution
2802
+ * @maturityLevel candidate
2803
+ */
2351
2804
  interface VaButtonIcon {
2352
2805
  "buttonType"?: keyof typeof this.buttonTypeMap;
2353
2806
  /**
@@ -2363,6 +2816,12 @@ declare namespace LocalJSX {
2363
2816
  */
2364
2817
  "onComponent-library-analytics"?: (event: VaButtonIconCustomEvent<any>) => void;
2365
2818
  }
2819
+ /**
2820
+ * @componentName Button pair
2821
+ * @maturityCategory caution
2822
+ * @maturityLevel candidate
2823
+ * @guidanceHref button/button-pair
2824
+ */
2366
2825
  interface VaButtonPair {
2367
2826
  /**
2368
2827
  * If `true`, button pair will use Continue and Back for button text.
@@ -2372,6 +2831,10 @@ declare namespace LocalJSX {
2372
2831
  * If `true`, the component-library-analytics event is disabled.
2373
2832
  */
2374
2833
  "disableAnalytics"?: boolean;
2834
+ /**
2835
+ * Custom text that will be applied to the left va-button inside the component. If set will override text controlled by the 'update' prop.
2836
+ */
2837
+ "leftButtonText"?: string;
2375
2838
  /**
2376
2839
  * The event used to track usage of the component.
2377
2840
  */
@@ -2388,6 +2851,10 @@ declare namespace LocalJSX {
2388
2851
  * Applies to the primary button aria-label.
2389
2852
  */
2390
2853
  "primaryLabel"?: string;
2854
+ /**
2855
+ * Custom text that will be applied to the right va-button inside the component. If set will override text controlled by the 'update' prop,
2856
+ */
2857
+ "rightButtonText"?: string;
2391
2858
  /**
2392
2859
  * Applies to the secondary button aria-label.
2393
2860
  */
@@ -2400,11 +2867,12 @@ declare namespace LocalJSX {
2400
2867
  * If `true`, button pair will use Update and Cancel for button text.
2401
2868
  */
2402
2869
  "update"?: boolean;
2403
- /**
2404
- * Whether or not the component will use USWDS v3 styling.
2405
- */
2406
- "uswds"?: boolean;
2407
2870
  }
2871
+ /**
2872
+ * @componentName Card
2873
+ * @maturityCategory caution
2874
+ * @maturityLevel candidate
2875
+ */
2408
2876
  interface VaCard {
2409
2877
  /**
2410
2878
  * If `true`, the card will have a gray background.
@@ -2415,9 +2883,19 @@ declare namespace LocalJSX {
2415
2883
  */
2416
2884
  "showShadow"?: boolean;
2417
2885
  }
2886
+ /**
2887
+ * @nativeHandler onBlur
2888
+ * @componentName Checkbox
2889
+ * @maturityCategory use
2890
+ * @maturityLevel deployed
2891
+ * @guidanceHref form/checkbox
2892
+ * @translations English
2893
+ * @translations Spanish
2894
+ * @translations Tagalog
2895
+ */
2418
2896
  interface VaCheckbox {
2419
2897
  /**
2420
- * Description of the option displayed below the checkbox label. Available when uswds is true.
2898
+ * Description of the option displayed below the checkbox label.
2421
2899
  */
2422
2900
  "checkboxDescription"?: string;
2423
2901
  /**
@@ -2429,7 +2907,7 @@ declare namespace LocalJSX {
2429
2907
  */
2430
2908
  "description"?: string;
2431
2909
  /**
2432
- * Whether or not the checkbox option is disabled. Available when uswds is true.
2910
+ * Whether or not the checkbox option is disabled.
2433
2911
  */
2434
2912
  "disabled"?: boolean;
2435
2913
  /**
@@ -2469,14 +2947,20 @@ declare namespace LocalJSX {
2469
2947
  */
2470
2948
  "required"?: boolean;
2471
2949
  /**
2472
- * Whether or not the component will display as a tile. Available when uswds is true.
2950
+ * Whether or not the component will display as a tile.
2473
2951
  */
2474
2952
  "tile"?: boolean;
2475
- /**
2476
- * Whether or not the component will use USWDS v3 styling.
2477
- */
2478
- "uswds"?: boolean;
2479
2953
  }
2954
+ /**
2955
+ * @vaChange The event emitted when the input value changes.
2956
+ * @componentName Checkbox group
2957
+ * @maturityCategory use
2958
+ * @maturityLevel deployed
2959
+ * @guidanceHref form/checkbox
2960
+ * @translations English
2961
+ * @translations Spanish
2962
+ * @translations Tagalog
2963
+ */
2480
2964
  interface VaCheckboxGroup {
2481
2965
  /**
2482
2966
  * Whether or not an analytics event will be fired.
@@ -2487,11 +2971,11 @@ declare namespace LocalJSX {
2487
2971
  */
2488
2972
  "error"?: string;
2489
2973
  /**
2490
- * The content of the heading if `useFormsPattern` and `uswds` are true.
2974
+ * The content of the heading if `useFormsPattern` is true.
2491
2975
  */
2492
2976
  "formHeading"?: string;
2493
2977
  /**
2494
- * The heading level for the heading if `useFormsPattern` and `uswds` are true.
2978
+ * The heading level for the heading if `useFormsPattern` is true.
2495
2979
  */
2496
2980
  "formHeadingLevel"?: number;
2497
2981
  /**
@@ -2515,16 +2999,23 @@ declare namespace LocalJSX {
2515
2999
  */
2516
3000
  "required"?: boolean;
2517
3001
  /**
2518
- * 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. `uswds` should be true.
3002
+ * 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.
2519
3003
  */
2520
3004
  "useFormsPattern"?: string;
2521
- /**
2522
- * Whether or not the component will use USWDS v3 styling.
2523
- */
2524
- "uswds"?: boolean;
2525
3005
  }
3006
+ /**
3007
+ * @componentName Crisis Line Modal
3008
+ * @maturityCategory caution
3009
+ * @maturityLevel candidate
3010
+ */
2526
3011
  interface VaCrisisLineModal {
2527
3012
  }
3013
+ /**
3014
+ * @componentName Date input
3015
+ * @maturityCategory use
3016
+ * @maturityLevel deployed
3017
+ * @guidanceHref form/date-input
3018
+ */
2528
3019
  interface VaDate {
2529
3020
  /**
2530
3021
  * Whether or not an analytics event will be fired.
@@ -2574,6 +3065,12 @@ declare namespace LocalJSX {
2574
3065
  */
2575
3066
  "value"?: string;
2576
3067
  }
3068
+ /**
3069
+ * @componentName File input
3070
+ * @maturityCategory caution
3071
+ * @maturityLevel available
3072
+ * @guidanceHref form/file-input
3073
+ */
2577
3074
  interface VaFileInput {
2578
3075
  /**
2579
3076
  * A comma-separated list of unique file type specifiers.
@@ -2623,11 +3120,15 @@ declare namespace LocalJSX {
2623
3120
  * Sets the input to required and renders the (*Required) text.
2624
3121
  */
2625
3122
  "required"?: boolean;
2626
- /**
2627
- * Whether or not the component will use USWDS v3 styling.
2628
- */
2629
- "uswds"?: boolean;
2630
3123
  }
3124
+ /**
3125
+ * A component that manages multiple file inputs, allowing users to upload several files.
3126
+ * It supports adding, changing, and removing files with dynamic error handling.
3127
+ * @componentName File input multiple
3128
+ * @maturityCategory caution
3129
+ * @maturityLevel available
3130
+ * @guidanceHref form/file-input-multiple
3131
+ */
2631
3132
  interface VaFileInputMultiple {
2632
3133
  /**
2633
3134
  * Defines acceptable file types the user can select; uses file type or extensions.
@@ -2666,6 +3167,12 @@ declare namespace LocalJSX {
2666
3167
  */
2667
3168
  "required"?: boolean;
2668
3169
  }
3170
+ /**
3171
+ * @componentName Header - Minimal
3172
+ * @maturityCategory caution
3173
+ * @maturityLevel candidate
3174
+ * @guidanceHref header/header-minimal
3175
+ */
2669
3176
  interface VaHeaderMinimal {
2670
3177
  /**
2671
3178
  * Disables use of heading tags in the minimal header in favor of `<div>` tags. This is for when a heading level 1 needs to be used elsewhere, as there should only be one heading level 1 per page.
@@ -2674,6 +3181,11 @@ declare namespace LocalJSX {
2674
3181
  "header"?: string;
2675
3182
  "subheader"?: string;
2676
3183
  }
3184
+ /**
3185
+ * @componentName Icon
3186
+ * @maturityCategory caution
3187
+ * @maturityLevel candidate
3188
+ */
2677
3189
  interface VaIcon {
2678
3190
  /**
2679
3191
  * The name of the icon to use
@@ -2688,6 +3200,11 @@ declare namespace LocalJSX {
2688
3200
  */
2689
3201
  "srtext"?: string;
2690
3202
  }
3203
+ /**
3204
+ * @componentName Link
3205
+ * @maturityCategory caution
3206
+ * @maturityLevel candidate
3207
+ */
2691
3208
  interface VaLink {
2692
3209
  /**
2693
3210
  * The title used in the abbr element. If filetype is PDF, the abbr title will be Portable Document Format.
@@ -2697,6 +3214,10 @@ declare namespace LocalJSX {
2697
3214
  * If `true`, the anchor text will be bolded and include a right arrow icon.
2698
3215
  */
2699
3216
  "active"?: boolean;
3217
+ /**
3218
+ * If 'true', renders a "back arrow" in front of the link text
3219
+ */
3220
+ "back"?: boolean;
2700
3221
  /**
2701
3222
  * If `true`, a calendar icon will be displayed before the anchor text.
2702
3223
  */
@@ -2713,6 +3234,10 @@ declare namespace LocalJSX {
2713
3234
  * If `true`, the link will be treated as a download, and a download icon will be displayed before the anchor text.
2714
3235
  */
2715
3236
  "download"?: boolean;
3237
+ /**
3238
+ * 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
3239
+ */
3240
+ "external"?: boolean;
2716
3241
  /**
2717
3242
  * The suggested filename. Only valid if download or calendar is `true`.
2718
3243
  */
@@ -2758,6 +3283,11 @@ declare namespace LocalJSX {
2758
3283
  */
2759
3284
  "video"?: boolean;
2760
3285
  }
3286
+ /**
3287
+ * @componentName Link - Action
3288
+ * @maturityCategory caution
3289
+ * @maturityLevel candidate
3290
+ */
2761
3291
  interface VaLinkAction {
2762
3292
  /**
2763
3293
  * If `true`, the component-library-analytics event is disabled.
@@ -2784,6 +3314,11 @@ declare namespace LocalJSX {
2784
3314
  */
2785
3315
  "type"?: "primary" | "secondary" | "reverse";
2786
3316
  }
3317
+ /**
3318
+ * @componentName Loading indicator
3319
+ * @maturityCategory use
3320
+ * @maturityLevel best_practice
3321
+ */
2787
3322
  interface VaLoadingIndicator {
2788
3323
  /**
2789
3324
  * Analytics tracking function(s) will be called. Form components are disabled by default due to PII/PHI concerns.
@@ -2806,6 +3341,11 @@ declare namespace LocalJSX {
2806
3341
  */
2807
3342
  "setFocus"?: boolean;
2808
3343
  }
3344
+ /**
3345
+ * @componentName Banner - Maintenance
3346
+ * @maturityCategory caution
3347
+ * @maturityLevel available
3348
+ */
2809
3349
  interface VaMaintenanceBanner {
2810
3350
  /**
2811
3351
  * A unique ID that will be used for conditionally rendering the banner based on if the user has dismissed it already.
@@ -2848,6 +3388,14 @@ declare namespace LocalJSX {
2848
3388
  */
2849
3389
  "upcomingWarnTitle"?: string;
2850
3390
  }
3391
+ /**
3392
+ * @componentName Memorable date
3393
+ * @maturityCategory caution
3394
+ * @maturityLevel available
3395
+ * @guidanceHref form/memorable-date
3396
+ * @translations English
3397
+ * @translations Spanish
3398
+ */
2851
3399
  interface VaMemorableDate {
2852
3400
  /**
2853
3401
  * A custom error message to display if the day is invalid
@@ -2921,8 +3469,20 @@ declare namespace LocalJSX {
2921
3469
  */
2922
3470
  "value"?: string;
2923
3471
  }
3472
+ /**
3473
+ * @componentName Minimal Footer
3474
+ * @maturityCategory caution
3475
+ * @maturityLevel candidate
3476
+ */
2924
3477
  interface VaMinimalFooter {
2925
3478
  }
3479
+ /**
3480
+ * @click Used to detect clicks outside of modal contents to close modal.
3481
+ * @keydown Used to detect Escape key to close modal.
3482
+ * @componentName Modal
3483
+ * @maturityCategory use
3484
+ * @maturityLevel deployed
3485
+ */
2926
3486
  interface VaModal {
2927
3487
  /**
2928
3488
  * Additional DOM-nodes that should not be hidden from screen readers. Useful when an open modal shouldn't hide all content behind the overlay.
@@ -2986,8 +3546,19 @@ declare namespace LocalJSX {
2986
3546
  */
2987
3547
  "visible"?: boolean;
2988
3548
  }
3549
+ /**
3550
+ * @componentName Need help?
3551
+ * @maturityCategory caution
3552
+ * @maturityLevel candidate
3553
+ * @guidanceHref form/need-help
3554
+ */
2989
3555
  interface VaNeedHelp {
2990
3556
  }
3557
+ /**
3558
+ * @componentName Notification
3559
+ * @maturityCategory dont_use
3560
+ * @maturityLevel deprecated
3561
+ */
2991
3562
  interface VaNotification {
2992
3563
  /**
2993
3564
  * Aria-label text for the close button.
@@ -3046,80 +3617,11 @@ declare namespace LocalJSX {
3046
3617
  */
3047
3618
  "visible"?: boolean;
3048
3619
  }
3049
- interface VaNumberInput {
3050
- /**
3051
- * Whether this component will be used to accept a currency value.
3052
- */
3053
- "currency"?: boolean;
3054
- /**
3055
- * Emit component-library-analytics events on the blur event.
3056
- */
3057
- "enableAnalytics"?: boolean;
3058
- /**
3059
- * The error message to render.
3060
- */
3061
- "error"?: string;
3062
- /**
3063
- * The content of the heading if `useFormsPattern` and `uswds` are true.
3064
- */
3065
- "formHeading"?: string;
3066
- /**
3067
- * The heading level for the heading if `useFormsPattern` and `uswds` are true.
3068
- */
3069
- "formHeadingLevel"?: number;
3070
- /**
3071
- * Optional hint text.
3072
- */
3073
- "hint"?: string;
3074
- /**
3075
- * The inputmode attribute.
3076
- */
3077
- "inputmode"?: 'decimal' | 'numeric';
3078
- /**
3079
- * The label for the text input.
3080
- */
3081
- "label"?: string;
3082
- /**
3083
- * Maximum number value The max attribute specifies the maximum value for an input element.
3084
- */
3085
- "max"?: number | string;
3086
- /**
3087
- * An optional message that will be read by screen readers when the input is focused.
3088
- */
3089
- "messageAriaDescribedby"?: string;
3090
- /**
3091
- * Minimum number value The min attribute specifies the minimum value for an input element.
3092
- */
3093
- "min"?: number | string;
3094
- /**
3095
- * The name to pass to the input element.
3096
- */
3097
- "name"?: string;
3098
- /**
3099
- * The event used to track usage of the component. This is emitted when the input is blurred and enableAnalytics is true.
3100
- */
3101
- "onComponent-library-analytics"?: (event: VaNumberInputCustomEvent<any>) => void;
3102
- /**
3103
- * Set the input to required and render the (Required) text.
3104
- */
3105
- "required"?: boolean;
3106
- /**
3107
- * 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. `uswds` should be true.
3108
- */
3109
- "useFormsPattern"?: string;
3110
- /**
3111
- * Whether or not the component will use USWDS v3 styling.
3112
- */
3113
- "uswds"?: boolean;
3114
- /**
3115
- * The value for the input.
3116
- */
3117
- "value"?: string;
3118
- /**
3119
- * Displays the input at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex).
3120
- */
3121
- "width"?: string;
3122
- }
3620
+ /**
3621
+ * @componentName Banner - Official Gov
3622
+ * @maturityCategory caution
3623
+ * @maturityLevel candidate
3624
+ */
3123
3625
  interface VaOfficialGovBanner {
3124
3626
  /**
3125
3627
  * If `true`, the component-library-analytics event is disabled.
@@ -3134,6 +3636,11 @@ declare namespace LocalJSX {
3134
3636
  */
3135
3637
  "tld"?: string;
3136
3638
  }
3639
+ /**
3640
+ * @componentName OMB info
3641
+ * @maturityCategory use
3642
+ * @maturityLevel best_practice
3643
+ */
3137
3644
  interface VaOmbInfo {
3138
3645
  /**
3139
3646
  * The name of the benefit displayed in the Respondent Burden section of the Privacy Act Statement.
@@ -3152,6 +3659,14 @@ declare namespace LocalJSX {
3152
3659
  */
3153
3660
  "resBurden"?: number;
3154
3661
  }
3662
+ /**
3663
+ * @componentName On this page
3664
+ * @maturityCategory use
3665
+ * @maturityLevel best_practice
3666
+ * @translations English
3667
+ * @translations Spanish
3668
+ * @translations Tagalog
3669
+ */
3155
3670
  interface VaOnThisPage {
3156
3671
  /**
3157
3672
  * If true, analytics event will not be fired
@@ -3162,6 +3677,11 @@ declare namespace LocalJSX {
3162
3677
  */
3163
3678
  "onComponent-library-analytics"?: (event: VaOnThisPageCustomEvent<any>) => void;
3164
3679
  }
3680
+ /**
3681
+ * @componentName Pagination
3682
+ * @maturityCategory use
3683
+ * @maturityLevel deployed
3684
+ */
3165
3685
  interface VaPagination {
3166
3686
  /**
3167
3687
  * Aria-label suffix text for buttons
@@ -3196,14 +3716,15 @@ declare namespace LocalJSX {
3196
3716
  */
3197
3717
  "showLastPage"?: boolean;
3198
3718
  /**
3199
- * Don't show last page when the page count exceeds `maxPageListLength` (but do show the ellipsis). Only relevant if uswds is true.
3719
+ * Don't show last page when the page count exceeds `maxPageListLength` (but do show the ellipsis).
3200
3720
  */
3201
3721
  "unbounded"?: boolean;
3202
- /**
3203
- * Whether or not the component will use USWDS v3 styling.
3204
- */
3205
- "uswds"?: boolean;
3206
3722
  }
3723
+ /**
3724
+ * @componentName Privacy agreement
3725
+ * @maturityCategory caution
3726
+ * @maturityLevel available
3727
+ */
3207
3728
  interface VaPrivacyAgreement {
3208
3729
  /**
3209
3730
  * Whether the checkbox is checked or not.
@@ -3225,16 +3746,13 @@ declare namespace LocalJSX {
3225
3746
  * Whether to display the error message or not.
3226
3747
  */
3227
3748
  "showError"?: boolean;
3228
- /**
3229
- * Whether or not the component will use USWDS v3 styling.
3230
- */
3231
- "uswds"?: boolean;
3232
3749
  }
3750
+ /**
3751
+ * @componentName Process list
3752
+ * @maturityCategory use
3753
+ * @maturityLevel deployed
3754
+ */
3233
3755
  interface VaProcessList {
3234
- /**
3235
- * Whether or not the component will use USWDS v3 styling.
3236
- */
3237
- "uswds"?: boolean;
3238
3756
  }
3239
3757
  interface VaProcessListItem {
3240
3758
  /**
@@ -3258,6 +3776,11 @@ declare namespace LocalJSX {
3258
3776
  */
3259
3777
  "pending"?: boolean;
3260
3778
  }
3779
+ /**
3780
+ * @componentName Progress bar - activity
3781
+ * @maturityCategory use
3782
+ * @maturityLevel deployed
3783
+ */
3261
3784
  interface VaProgressBar {
3262
3785
  /**
3263
3786
  * Whether or not an analytics event will be fired.
@@ -3276,6 +3799,12 @@ declare namespace LocalJSX {
3276
3799
  */
3277
3800
  "percent": number;
3278
3801
  }
3802
+ /**
3803
+ * @componentName Banner - Promo
3804
+ * @maturityCategory use
3805
+ * @maturityLevel deployed
3806
+ * @guidanceHref banner/promo
3807
+ */
3279
3808
  interface VaPromoBanner {
3280
3809
  /**
3281
3810
  * Analytics tracking function(s) will not be called
@@ -3298,6 +3827,17 @@ declare namespace LocalJSX {
3298
3827
  */
3299
3828
  "type"?: 'announcement' | 'news' | 'email-signup';
3300
3829
  }
3830
+ /**
3831
+ * @keydown The event emitted when a key is pressed.
3832
+ * @radioOptionSelected The event emitted when the selected option value changes.
3833
+ * @componentName Radio button
3834
+ * @maturityCategory use
3835
+ * @maturityLevel deployed
3836
+ * @guidanceHref form/radio-button
3837
+ * @translations English
3838
+ * @translations Spanish
3839
+ * @translations Tagalog
3840
+ */
3301
3841
  interface VaRadio {
3302
3842
  /**
3303
3843
  * Whether or not an analytics event will be fired.
@@ -3308,11 +3848,11 @@ declare namespace LocalJSX {
3308
3848
  */
3309
3849
  "error"?: string;
3310
3850
  /**
3311
- * The content of the heading if `useFormsPattern` and `uswds` are true.
3851
+ * The content of the heading if `useFormsPattern` is true.
3312
3852
  */
3313
3853
  "formHeading"?: string;
3314
3854
  /**
3315
- * The heading level for the heading if `useFormsPattern` and `uswds` are true.
3855
+ * The heading level for the heading if `useFormsPattern` is true.
3316
3856
  */
3317
3857
  "formHeadingLevel"?: number;
3318
3858
  /**
@@ -3344,13 +3884,9 @@ declare namespace LocalJSX {
3344
3884
  */
3345
3885
  "required"?: boolean;
3346
3886
  /**
3347
- * 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. `uswds` should be true.
3887
+ * 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
3348
3888
  */
3349
3889
  "useFormsPattern"?: string;
3350
- /**
3351
- * Whether or not the component will use USWDS v3 styling.
3352
- */
3353
- "uswds"?: boolean;
3354
3890
  }
3355
3891
  interface VaRadioOption {
3356
3892
  /**
@@ -3362,11 +3898,11 @@ declare namespace LocalJSX {
3362
3898
  */
3363
3899
  "checked"?: boolean;
3364
3900
  /**
3365
- * Description of the option displayed below the option label. Available when uswds is true.
3901
+ * Description of the option displayed below the option label.
3366
3902
  */
3367
3903
  "description"?: string;
3368
3904
  /**
3369
- * Whether or not the radio option is disabled. Can be used if the USWDS option is active.
3905
+ * Whether or not the radio option is disabled.
3370
3906
  */
3371
3907
  "disabled"?: boolean;
3372
3908
  /**
@@ -3382,27 +3918,32 @@ declare namespace LocalJSX {
3382
3918
  */
3383
3919
  "onRadioOptionSelected"?: (event: VaRadioOptionCustomEvent<any>) => void;
3384
3920
  /**
3385
- * Whether or not the component will display as a tile. Available when uswds is true.
3921
+ * Whether or not the component will display as a tile.
3386
3922
  */
3387
3923
  "tile"?: boolean;
3388
- /**
3389
- * Whether or not the component will use USWDS v3. styling.
3390
- */
3391
- "uswds"?: boolean;
3392
3924
  /**
3393
3925
  * The value attribute for the input element.
3394
3926
  */
3395
3927
  "value": string;
3396
3928
  }
3929
+ /**
3930
+ * @componentName Search input
3931
+ * @maturityCategory use
3932
+ * @maturityLevel deployed
3933
+ */
3397
3934
  interface VaSearchInput {
3398
3935
  /**
3399
- * If `true`, the component will use the big variant. Only available when `uswds` is `true`.
3936
+ * If `true`, the component will use the big variant.
3400
3937
  */
3401
3938
  "big"?: boolean;
3402
3939
  /**
3403
3940
  * Text displayed inside the search button
3404
3941
  */
3405
3942
  "buttonText"?: string;
3943
+ /**
3944
+ * If `true`, the component-library-analytics event is disabled.
3945
+ */
3946
+ "disableAnalytics"?: boolean;
3406
3947
  /**
3407
3948
  * The aria-label for search input and button. Default is 'Search'.
3408
3949
  */
@@ -3412,29 +3953,31 @@ declare namespace LocalJSX {
3412
3953
  */
3413
3954
  "onComponent-library-analytics"?: (event: VaSearchInputCustomEvent<any>) => void;
3414
3955
  /**
3415
- * If `true`, the component will use the small variant. Only available when `uswds` is `true`.
3956
+ * If `true`, the component will use the small variant.
3416
3957
  */
3417
3958
  "small"?: boolean;
3418
3959
  /**
3419
3960
  * An array of strings containing suggestions to be displayed in listbox. This component displays up to 5 suggestions.
3420
3961
  */
3421
3962
  "suggestions"?: any;
3422
- /**
3423
- * Whether or not the component will use USWDS v3 styling.
3424
- */
3425
- "uswds"?: boolean;
3426
3963
  /**
3427
3964
  * The value of the input field
3428
3965
  */
3429
3966
  "value"?: string;
3430
3967
  }
3968
+ /**
3969
+ * @componentName Progress bar - segmented
3970
+ * @maturityCategory use
3971
+ * @maturityLevel deployed
3972
+ * @guidanceHref form/progress-bar-segmented
3973
+ */
3431
3974
  interface VaSegmentedProgressBar {
3432
3975
  /**
3433
- * Whether or not to center the step labels (v3 only)
3976
+ * Whether or not to center the step labels
3434
3977
  */
3435
3978
  "centeredLabels"?: boolean;
3436
3979
  /**
3437
- * Show number counters for each step (v3 only)
3980
+ * Show number counters for each step
3438
3981
  */
3439
3982
  "counters"?: "default" | "small";
3440
3983
  /**
@@ -3446,11 +3989,11 @@ declare namespace LocalJSX {
3446
3989
  */
3447
3990
  "enableAnalytics"?: boolean;
3448
3991
  /**
3449
- * Header level for button wrapper. Must be between 1 and 6 (v3 only)
3992
+ * Header level for button wrapper. Must be between 1 and 6
3450
3993
  */
3451
3994
  "headerLevel"?: number;
3452
3995
  /**
3453
- * Text of current step (v3 only)
3996
+ * Text of current step
3454
3997
  */
3455
3998
  "headingText"?: string;
3456
3999
  /**
@@ -3458,7 +4001,7 @@ declare namespace LocalJSX {
3458
4001
  */
3459
4002
  "label"?: string;
3460
4003
  /**
3461
- * String containing a list of step labels delimited by a semi-colon (v3 only) Example: `"Step 1;Step 2;Step 3"`
4004
+ * String containing a list of step labels delimited by a semi-colon. Example: `"Step 1;Step 2;Step 3"`
3462
4005
  */
3463
4006
  "labels"?: string;
3464
4007
  /**
@@ -3474,14 +4017,19 @@ declare namespace LocalJSX {
3474
4017
  */
3475
4018
  "total": number;
3476
4019
  /**
3477
- * When true, this makes the segmented-progress-bar use a div instead of a heading (v3 only)
4020
+ * When true, this makes the segmented-progress-bar use a div instead of a heading
3478
4021
  */
3479
4022
  "useDiv"?: boolean;
3480
- /**
3481
- * Whether or not the component will use USWDS v3 styling.
3482
- */
3483
- "uswds"?: boolean;
3484
4023
  }
4024
+ /**
4025
+ * @nativeHandler onKeyDown
4026
+ * @componentName Select
4027
+ * @maturityCategory use
4028
+ * @maturityLevel deployed
4029
+ * @guidanceHref form/select
4030
+ * @translations English
4031
+ * @translations Spanish
4032
+ */
3485
4033
  interface VaSelect {
3486
4034
  /**
3487
4035
  * Whether or not to fire the analytics events
@@ -3531,15 +4079,16 @@ declare namespace LocalJSX {
3531
4079
  * Whether or not this is a required field.
3532
4080
  */
3533
4081
  "required"?: boolean;
3534
- /**
3535
- * Whether or not the component will use USWDS v3 styling.
3536
- */
3537
- "uswds"?: boolean;
3538
4082
  /**
3539
4083
  * Selected value (will get updated on select).
3540
4084
  */
3541
4085
  "value"?: string;
3542
4086
  }
4087
+ /**
4088
+ * @componentName Statement of truth
4089
+ * @maturityCategory caution
4090
+ * @maturityLevel candidate
4091
+ */
3543
4092
  interface VaStatementOfTruth {
3544
4093
  /**
3545
4094
  * The error to be applied to the va-check-box element
@@ -3586,21 +4135,14 @@ declare namespace LocalJSX {
3586
4135
  */
3587
4136
  "onVaInputChange"?: (event: VaStatementOfTruthCustomEvent<any>) => void;
3588
4137
  }
4138
+ /**
4139
+ * @componentName Summary box
4140
+ * @maturityCategory use
4141
+ * @maturityLevel deployed
4142
+ */
3589
4143
  interface VaSummaryBox {
3590
- /**
3591
- * Whether or not the component will use USWDS v3 styling.
3592
- */
3593
- "uswds"?: boolean;
3594
4144
  }
3595
4145
  interface VaTable {
3596
- /**
3597
- * Whether the initial sort state will be descending or not.
3598
- */
3599
- "descending"?: boolean;
3600
- /**
3601
- * The zero-based index of the column to sort by (Doesn't work in IE11). Optional.
3602
- */
3603
- "sortColumn"?: number;
3604
4146
  /**
3605
4147
  * Convert to a stacked table when screen size is small True by default, must specify if false if this is unwanted
3606
4148
  */
@@ -3613,25 +4155,18 @@ declare namespace LocalJSX {
3613
4155
  * If uswds is true, the type of table
3614
4156
  */
3615
4157
  "tableType"?: 'borderless';
3616
- /**
3617
- * Whether or not the component will use USWDS v3 styling.
3618
- */
3619
- "uswds"?: boolean;
3620
4158
  }
4159
+ /**
4160
+ * @componentName Table
4161
+ * @maturityCategory use
4162
+ * @maturityLevel best_practice
4163
+ */
3621
4164
  interface VaTableInner {
3622
4165
  /**
3623
- * If uswds is true, the number of columns in the table
4166
+ * The number of columns in the table
3624
4167
  */
3625
4168
  "cols"?: number;
3626
- /**
3627
- * Whether the initial sort state will be descending or not.
3628
- */
3629
- "descending"?: boolean;
3630
4169
  "rows"?: number;
3631
- /**
3632
- * The zero-based index of the column to sort by (Doesn't work in IE11). Optional.
3633
- */
3634
- "sortColumn"?: number;
3635
4170
  /**
3636
4171
  * If true convert to a stacked table when screen size is small
3637
4172
  */
@@ -3641,20 +4176,17 @@ declare namespace LocalJSX {
3641
4176
  */
3642
4177
  "tableTitle"?: string;
3643
4178
  /**
3644
- * If uswds is true, the type of table to be used
4179
+ * The type of table to be used
3645
4180
  */
3646
4181
  "tableType"?: 'borderless';
3647
- /**
3648
- * Whether or not the component will use USWDS v3 styling.
3649
- */
3650
- "uswds"?: boolean;
3651
- /**
3652
- * A live reference to the va-table-rows in the table which are hard to access from this component
3653
- */
3654
- "vaTableRowRefs"?: any;
3655
4182
  }
3656
4183
  interface VaTableRow {
3657
4184
  }
4185
+ /**
4186
+ * @componentName Telephone
4187
+ * @maturityCategory use
4188
+ * @maturityLevel best_practice
4189
+ */
3658
4190
  interface VaTelephone {
3659
4191
  /**
3660
4192
  * Numeric string representing the contact number. Typical length is 3 or 10 digits - SMS short codes will be 5 or 6 digits.
@@ -3693,6 +4225,17 @@ declare namespace LocalJSX {
3693
4225
  */
3694
4226
  "vanity"?: string;
3695
4227
  }
4228
+ /**
4229
+ * @nativeHandler onInput
4230
+ * @nativeHandler onBlur
4231
+ * @componentName Text input
4232
+ * @maturityCategory use
4233
+ * @maturityLevel deployed
4234
+ * @guidanceHref form/text-input
4235
+ * @translations English
4236
+ * @translations Spanish
4237
+ * @translations Tagalog
4238
+ */
3696
4239
  interface VaTextInput {
3697
4240
  /**
3698
4241
  * Allows the browser to automatically complete the input.
@@ -3730,6 +4273,10 @@ declare namespace LocalJSX {
3730
4273
  * This property displays a prefix that accepts a string which represents icon name.
3731
4274
  */
3732
4275
  "inputIconPrefix"?: string;
4276
+ /**
4277
+ * A string that represents the name of an icon passed to va-icon, which will be applied as a suffix to the input.
4278
+ */
4279
+ "inputIconSuffix"?: string;
3733
4280
  /**
3734
4281
  * Displays a fixed prefix string at the start of the input field.
3735
4282
  */
@@ -3792,6 +4339,14 @@ declare namespace LocalJSX {
3792
4339
  * Set the input to required and render the (Required) text.
3793
4340
  */
3794
4341
  "required"?: boolean;
4342
+ /**
4343
+ * When `false`, hides the error message from view, but not from the screen reader. Should only be used if error is being displayed elsewhere. Must use kebab-case on this attribute for it to work properly.
4344
+ */
4345
+ "showInputError"?: boolean;
4346
+ /**
4347
+ * The step attribute is a number, or the string 'any', that specifies the granularity of the value. For example: `<va-text-input type="number" step=".1"/>` enables float/decimal values to be valid and increment by one-tenth. <br/> Defaults to 1 for every field type except for time and datetime-local which default to 60 (seconds). View more documentation on [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)
4348
+ */
4349
+ "step"?: string;
3795
4350
  /**
3796
4351
  * Adds styling based on status value
3797
4352
  */
@@ -3813,6 +4368,16 @@ declare namespace LocalJSX {
3813
4368
  */
3814
4369
  "width"?: string;
3815
4370
  }
4371
+ /**
4372
+ * @nativeHandler onInput
4373
+ * @nativeHandler onBlur
4374
+ * @componentName Textarea
4375
+ * @maturityCategory use
4376
+ * @maturityLevel deployed
4377
+ * @guidanceHref form/textarea
4378
+ * @translations English
4379
+ * @translations Spanish
4380
+ */
3816
4381
  interface VaTextarea {
3817
4382
  /**
3818
4383
  * Whether the component should show a character count message. Has no effect without maxlength being set.
@@ -3913,7 +4478,6 @@ declare namespace LocalJSX {
3913
4478
  "va-modal": VaModal;
3914
4479
  "va-need-help": VaNeedHelp;
3915
4480
  "va-notification": VaNotification;
3916
- "va-number-input": VaNumberInput;
3917
4481
  "va-official-gov-banner": VaOfficialGovBanner;
3918
4482
  "va-omb-info": VaOmbInfo;
3919
4483
  "va-on-this-page": VaOnThisPage;
@@ -3942,57 +4506,341 @@ export { LocalJSX as JSX };
3942
4506
  declare module "@stencil/core" {
3943
4507
  export namespace JSX {
3944
4508
  interface IntrinsicElements {
4509
+ /**
4510
+ * @componentName Accordion
4511
+ * @accordionItemToggled This event is fired when an accordion item is opened or closed
4512
+ * @maturityCategory use
4513
+ * @maturityLevel best_practice
4514
+ * @translations English
4515
+ * @translations Spanish
4516
+ * @translations Tagalog
4517
+ */
3945
4518
  "va-accordion": LocalJSX.VaAccordion & JSXBase.HTMLAttributes<HTMLVaAccordionElement>;
3946
4519
  "va-accordion-item": LocalJSX.VaAccordionItem & JSXBase.HTMLAttributes<HTMLVaAccordionItemElement>;
4520
+ /**
4521
+ * @componentName Additional info
4522
+ * @maturityCategory use
4523
+ * @maturityLevel deployed
4524
+ */
3947
4525
  "va-additional-info": LocalJSX.VaAdditionalInfo & JSXBase.HTMLAttributes<HTMLVaAdditionalInfoElement>;
4526
+ /**
4527
+ * @componentName Alert
4528
+ * @maturityCategory use
4529
+ * @maturityLevel best_practice
4530
+ */
3948
4531
  "va-alert": LocalJSX.VaAlert & JSXBase.HTMLAttributes<HTMLVaAlertElement>;
4532
+ /**
4533
+ * @componentName Alert - expandable
4534
+ * @maturityCategory caution
4535
+ * @maturityLevel candidate
4536
+ */
3949
4537
  "va-alert-expandable": LocalJSX.VaAlertExpandable & JSXBase.HTMLAttributes<HTMLVaAlertExpandableElement>;
4538
+ /**
4539
+ * @componentName Back to top
4540
+ * @maturityCategory use
4541
+ * @maturityLevel deployed
4542
+ */
3950
4543
  "va-back-to-top": LocalJSX.VaBackToTop & JSXBase.HTMLAttributes<HTMLVaBackToTopElement>;
4544
+ /**
4545
+ * @componentName Banner
4546
+ * @maturityCategory use
4547
+ * @maturityLevel deployed
4548
+ */
3951
4549
  "va-banner": LocalJSX.VaBanner & JSXBase.HTMLAttributes<HTMLVaBannerElement>;
4550
+ /**
4551
+ * @componentName Breadcrumbs
4552
+ * @maturityCategory use
4553
+ * @maturityLevel deployed
4554
+ */
3952
4555
  "va-breadcrumbs": LocalJSX.VaBreadcrumbs & JSXBase.HTMLAttributes<HTMLVaBreadcrumbsElement>;
4556
+ /**
4557
+ * @componentName Button
4558
+ * @nativeHandler onClick
4559
+ * @maturityCategory caution
4560
+ * @maturityLevel candidate
4561
+ */
3953
4562
  "va-button": LocalJSX.VaButton & JSXBase.HTMLAttributes<HTMLVaButtonElement>;
4563
+ /**
4564
+ * @componentName Button - Icon
4565
+ * @nativeHandler onClick
4566
+ * @maturityCategory caution
4567
+ * @maturityLevel candidate
4568
+ */
3954
4569
  "va-button-icon": LocalJSX.VaButtonIcon & JSXBase.HTMLAttributes<HTMLVaButtonIconElement>;
4570
+ /**
4571
+ * @componentName Button pair
4572
+ * @maturityCategory caution
4573
+ * @maturityLevel candidate
4574
+ * @guidanceHref button/button-pair
4575
+ */
3955
4576
  "va-button-pair": LocalJSX.VaButtonPair & JSXBase.HTMLAttributes<HTMLVaButtonPairElement>;
4577
+ /**
4578
+ * @componentName Card
4579
+ * @maturityCategory caution
4580
+ * @maturityLevel candidate
4581
+ */
3956
4582
  "va-card": LocalJSX.VaCard & JSXBase.HTMLAttributes<HTMLVaCardElement>;
4583
+ /**
4584
+ * @nativeHandler onBlur
4585
+ * @componentName Checkbox
4586
+ * @maturityCategory use
4587
+ * @maturityLevel deployed
4588
+ * @guidanceHref form/checkbox
4589
+ * @translations English
4590
+ * @translations Spanish
4591
+ * @translations Tagalog
4592
+ */
3957
4593
  "va-checkbox": LocalJSX.VaCheckbox & JSXBase.HTMLAttributes<HTMLVaCheckboxElement>;
4594
+ /**
4595
+ * @vaChange The event emitted when the input value changes.
4596
+ * @componentName Checkbox group
4597
+ * @maturityCategory use
4598
+ * @maturityLevel deployed
4599
+ * @guidanceHref form/checkbox
4600
+ * @translations English
4601
+ * @translations Spanish
4602
+ * @translations Tagalog
4603
+ */
3958
4604
  "va-checkbox-group": LocalJSX.VaCheckboxGroup & JSXBase.HTMLAttributes<HTMLVaCheckboxGroupElement>;
4605
+ /**
4606
+ * @componentName Crisis Line Modal
4607
+ * @maturityCategory caution
4608
+ * @maturityLevel candidate
4609
+ */
3959
4610
  "va-crisis-line-modal": LocalJSX.VaCrisisLineModal & JSXBase.HTMLAttributes<HTMLVaCrisisLineModalElement>;
4611
+ /**
4612
+ * @componentName Date input
4613
+ * @maturityCategory use
4614
+ * @maturityLevel deployed
4615
+ * @guidanceHref form/date-input
4616
+ */
3960
4617
  "va-date": LocalJSX.VaDate & JSXBase.HTMLAttributes<HTMLVaDateElement>;
4618
+ /**
4619
+ * @componentName File input
4620
+ * @maturityCategory caution
4621
+ * @maturityLevel available
4622
+ * @guidanceHref form/file-input
4623
+ */
3961
4624
  "va-file-input": LocalJSX.VaFileInput & JSXBase.HTMLAttributes<HTMLVaFileInputElement>;
4625
+ /**
4626
+ * A component that manages multiple file inputs, allowing users to upload several files.
4627
+ * It supports adding, changing, and removing files with dynamic error handling.
4628
+ * @componentName File input multiple
4629
+ * @maturityCategory caution
4630
+ * @maturityLevel available
4631
+ * @guidanceHref form/file-input-multiple
4632
+ */
3962
4633
  "va-file-input-multiple": LocalJSX.VaFileInputMultiple & JSXBase.HTMLAttributes<HTMLVaFileInputMultipleElement>;
4634
+ /**
4635
+ * @componentName Header - Minimal
4636
+ * @maturityCategory caution
4637
+ * @maturityLevel candidate
4638
+ * @guidanceHref header/header-minimal
4639
+ */
3963
4640
  "va-header-minimal": LocalJSX.VaHeaderMinimal & JSXBase.HTMLAttributes<HTMLVaHeaderMinimalElement>;
4641
+ /**
4642
+ * @componentName Icon
4643
+ * @maturityCategory caution
4644
+ * @maturityLevel candidate
4645
+ */
3964
4646
  "va-icon": LocalJSX.VaIcon & JSXBase.HTMLAttributes<HTMLVaIconElement>;
4647
+ /**
4648
+ * @componentName Link
4649
+ * @maturityCategory caution
4650
+ * @maturityLevel candidate
4651
+ */
3965
4652
  "va-link": LocalJSX.VaLink & JSXBase.HTMLAttributes<HTMLVaLinkElement>;
4653
+ /**
4654
+ * @componentName Link - Action
4655
+ * @maturityCategory caution
4656
+ * @maturityLevel candidate
4657
+ */
3966
4658
  "va-link-action": LocalJSX.VaLinkAction & JSXBase.HTMLAttributes<HTMLVaLinkActionElement>;
4659
+ /**
4660
+ * @componentName Loading indicator
4661
+ * @maturityCategory use
4662
+ * @maturityLevel best_practice
4663
+ */
3967
4664
  "va-loading-indicator": LocalJSX.VaLoadingIndicator & JSXBase.HTMLAttributes<HTMLVaLoadingIndicatorElement>;
4665
+ /**
4666
+ * @componentName Banner - Maintenance
4667
+ * @maturityCategory caution
4668
+ * @maturityLevel available
4669
+ */
3968
4670
  "va-maintenance-banner": LocalJSX.VaMaintenanceBanner & JSXBase.HTMLAttributes<HTMLVaMaintenanceBannerElement>;
4671
+ /**
4672
+ * @componentName Memorable date
4673
+ * @maturityCategory caution
4674
+ * @maturityLevel available
4675
+ * @guidanceHref form/memorable-date
4676
+ * @translations English
4677
+ * @translations Spanish
4678
+ */
3969
4679
  "va-memorable-date": LocalJSX.VaMemorableDate & JSXBase.HTMLAttributes<HTMLVaMemorableDateElement>;
4680
+ /**
4681
+ * @componentName Minimal Footer
4682
+ * @maturityCategory caution
4683
+ * @maturityLevel candidate
4684
+ */
3970
4685
  "va-minimal-footer": LocalJSX.VaMinimalFooter & JSXBase.HTMLAttributes<HTMLVaMinimalFooterElement>;
4686
+ /**
4687
+ * @click Used to detect clicks outside of modal contents to close modal.
4688
+ * @keydown Used to detect Escape key to close modal.
4689
+ * @componentName Modal
4690
+ * @maturityCategory use
4691
+ * @maturityLevel deployed
4692
+ */
3971
4693
  "va-modal": LocalJSX.VaModal & JSXBase.HTMLAttributes<HTMLVaModalElement>;
4694
+ /**
4695
+ * @componentName Need help?
4696
+ * @maturityCategory caution
4697
+ * @maturityLevel candidate
4698
+ * @guidanceHref form/need-help
4699
+ */
3972
4700
  "va-need-help": LocalJSX.VaNeedHelp & JSXBase.HTMLAttributes<HTMLVaNeedHelpElement>;
4701
+ /**
4702
+ * @componentName Notification
4703
+ * @maturityCategory dont_use
4704
+ * @maturityLevel deprecated
4705
+ */
3973
4706
  "va-notification": LocalJSX.VaNotification & JSXBase.HTMLAttributes<HTMLVaNotificationElement>;
3974
- "va-number-input": LocalJSX.VaNumberInput & JSXBase.HTMLAttributes<HTMLVaNumberInputElement>;
4707
+ /**
4708
+ * @componentName Banner - Official Gov
4709
+ * @maturityCategory caution
4710
+ * @maturityLevel candidate
4711
+ */
3975
4712
  "va-official-gov-banner": LocalJSX.VaOfficialGovBanner & JSXBase.HTMLAttributes<HTMLVaOfficialGovBannerElement>;
4713
+ /**
4714
+ * @componentName OMB info
4715
+ * @maturityCategory use
4716
+ * @maturityLevel best_practice
4717
+ */
3976
4718
  "va-omb-info": LocalJSX.VaOmbInfo & JSXBase.HTMLAttributes<HTMLVaOmbInfoElement>;
4719
+ /**
4720
+ * @componentName On this page
4721
+ * @maturityCategory use
4722
+ * @maturityLevel best_practice
4723
+ * @translations English
4724
+ * @translations Spanish
4725
+ * @translations Tagalog
4726
+ */
3977
4727
  "va-on-this-page": LocalJSX.VaOnThisPage & JSXBase.HTMLAttributes<HTMLVaOnThisPageElement>;
4728
+ /**
4729
+ * @componentName Pagination
4730
+ * @maturityCategory use
4731
+ * @maturityLevel deployed
4732
+ */
3978
4733
  "va-pagination": LocalJSX.VaPagination & JSXBase.HTMLAttributes<HTMLVaPaginationElement>;
4734
+ /**
4735
+ * @componentName Privacy agreement
4736
+ * @maturityCategory caution
4737
+ * @maturityLevel available
4738
+ */
3979
4739
  "va-privacy-agreement": LocalJSX.VaPrivacyAgreement & JSXBase.HTMLAttributes<HTMLVaPrivacyAgreementElement>;
4740
+ /**
4741
+ * @componentName Process list
4742
+ * @maturityCategory use
4743
+ * @maturityLevel deployed
4744
+ */
3980
4745
  "va-process-list": LocalJSX.VaProcessList & JSXBase.HTMLAttributes<HTMLVaProcessListElement>;
3981
4746
  "va-process-list-item": LocalJSX.VaProcessListItem & JSXBase.HTMLAttributes<HTMLVaProcessListItemElement>;
4747
+ /**
4748
+ * @componentName Progress bar - activity
4749
+ * @maturityCategory use
4750
+ * @maturityLevel deployed
4751
+ */
3982
4752
  "va-progress-bar": LocalJSX.VaProgressBar & JSXBase.HTMLAttributes<HTMLVaProgressBarElement>;
4753
+ /**
4754
+ * @componentName Banner - Promo
4755
+ * @maturityCategory use
4756
+ * @maturityLevel deployed
4757
+ * @guidanceHref banner/promo
4758
+ */
3983
4759
  "va-promo-banner": LocalJSX.VaPromoBanner & JSXBase.HTMLAttributes<HTMLVaPromoBannerElement>;
4760
+ /**
4761
+ * @keydown The event emitted when a key is pressed.
4762
+ * @radioOptionSelected The event emitted when the selected option value changes.
4763
+ * @componentName Radio button
4764
+ * @maturityCategory use
4765
+ * @maturityLevel deployed
4766
+ * @guidanceHref form/radio-button
4767
+ * @translations English
4768
+ * @translations Spanish
4769
+ * @translations Tagalog
4770
+ */
3984
4771
  "va-radio": LocalJSX.VaRadio & JSXBase.HTMLAttributes<HTMLVaRadioElement>;
3985
4772
  "va-radio-option": LocalJSX.VaRadioOption & JSXBase.HTMLAttributes<HTMLVaRadioOptionElement>;
4773
+ /**
4774
+ * @componentName Search input
4775
+ * @maturityCategory use
4776
+ * @maturityLevel deployed
4777
+ */
3986
4778
  "va-search-input": LocalJSX.VaSearchInput & JSXBase.HTMLAttributes<HTMLVaSearchInputElement>;
4779
+ /**
4780
+ * @componentName Progress bar - segmented
4781
+ * @maturityCategory use
4782
+ * @maturityLevel deployed
4783
+ * @guidanceHref form/progress-bar-segmented
4784
+ */
3987
4785
  "va-segmented-progress-bar": LocalJSX.VaSegmentedProgressBar & JSXBase.HTMLAttributes<HTMLVaSegmentedProgressBarElement>;
4786
+ /**
4787
+ * @nativeHandler onKeyDown
4788
+ * @componentName Select
4789
+ * @maturityCategory use
4790
+ * @maturityLevel deployed
4791
+ * @guidanceHref form/select
4792
+ * @translations English
4793
+ * @translations Spanish
4794
+ */
3988
4795
  "va-select": LocalJSX.VaSelect & JSXBase.HTMLAttributes<HTMLVaSelectElement>;
4796
+ /**
4797
+ * @componentName Statement of truth
4798
+ * @maturityCategory caution
4799
+ * @maturityLevel candidate
4800
+ */
3989
4801
  "va-statement-of-truth": LocalJSX.VaStatementOfTruth & JSXBase.HTMLAttributes<HTMLVaStatementOfTruthElement>;
4802
+ /**
4803
+ * @componentName Summary box
4804
+ * @maturityCategory use
4805
+ * @maturityLevel deployed
4806
+ */
3990
4807
  "va-summary-box": LocalJSX.VaSummaryBox & JSXBase.HTMLAttributes<HTMLVaSummaryBoxElement>;
3991
4808
  "va-table": LocalJSX.VaTable & JSXBase.HTMLAttributes<HTMLVaTableElement>;
4809
+ /**
4810
+ * @componentName Table
4811
+ * @maturityCategory use
4812
+ * @maturityLevel best_practice
4813
+ */
3992
4814
  "va-table-inner": LocalJSX.VaTableInner & JSXBase.HTMLAttributes<HTMLVaTableInnerElement>;
3993
4815
  "va-table-row": LocalJSX.VaTableRow & JSXBase.HTMLAttributes<HTMLVaTableRowElement>;
4816
+ /**
4817
+ * @componentName Telephone
4818
+ * @maturityCategory use
4819
+ * @maturityLevel best_practice
4820
+ */
3994
4821
  "va-telephone": LocalJSX.VaTelephone & JSXBase.HTMLAttributes<HTMLVaTelephoneElement>;
4822
+ /**
4823
+ * @nativeHandler onInput
4824
+ * @nativeHandler onBlur
4825
+ * @componentName Text input
4826
+ * @maturityCategory use
4827
+ * @maturityLevel deployed
4828
+ * @guidanceHref form/text-input
4829
+ * @translations English
4830
+ * @translations Spanish
4831
+ * @translations Tagalog
4832
+ */
3995
4833
  "va-text-input": LocalJSX.VaTextInput & JSXBase.HTMLAttributes<HTMLVaTextInputElement>;
4834
+ /**
4835
+ * @nativeHandler onInput
4836
+ * @nativeHandler onBlur
4837
+ * @componentName Textarea
4838
+ * @maturityCategory use
4839
+ * @maturityLevel deployed
4840
+ * @guidanceHref form/textarea
4841
+ * @translations English
4842
+ * @translations Spanish
4843
+ */
3996
4844
  "va-textarea": LocalJSX.VaTextarea & JSXBase.HTMLAttributes<HTMLVaTextareaElement>;
3997
4845
  }
3998
4846
  }