@department-of-veterans-affairs/component-library 45.0.0 → 46.0.0

package/dist/components/types/components.d.ts

@@ -6,7 +6,17 @@
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { Breadcrumb } from "./components/va-breadcrumbs/va-breadcrumbs";
+export { Breadcrumb } from "./components/va-breadcrumbs/va-breadcrumbs";
 export namespace Components {
+    /**
+     * @componentName Accordion
+     * @accordionItemToggled This event is fired when an accordion item is opened or closed
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaAccordion {
         /**
           * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -43,6 +53,11 @@ export namespace Components {
          */
         "subheader"?: string;
     }
+    /**
+     * @componentName Additional info
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaAdditionalInfo {
         /**
           * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -57,6 +72,11 @@ export namespace Components {
          */
         "trigger": string;
     }
+    /**
+     * @componentName Alert
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaAlert {
         /**
           * Aria-label text for the close button.
@@ -91,6 +111,11 @@ export namespace Components {
          */
         "visible"?: boolean;
     }
+    /**
+     * @componentName Alert - expandable
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaAlertExpandable {
         /**
           * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -109,8 +134,18 @@ export namespace Components {
          */
         "trigger": string;
     }
+    /**
+     * @componentName Back to top
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaBackToTop {
     }
+    /**
+     * @componentName Banner
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaBanner {
         /**
           * Aria Label for the "region" of the nested va-alert.
@@ -141,6 +176,11 @@ export namespace Components {
          */
         "windowSession"?: boolean;
     }
+    /**
+     * @componentName Breadcrumbs
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaBreadcrumbs {
         /**
           * 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"}]`.
@@ -163,6 +203,12 @@ export namespace Components {
          */
         "wrapping"?: boolean;
     }
+    /**
+     * @componentName Button
+     * @nativeHandler onClick
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaButton {
         /**
           * If `true`, the button will use `Back` as its text and an icon to represent going back in form flows.
@@ -209,6 +255,12 @@ export namespace Components {
          */
         "text"?: string;
     }
+    /**
+     * @componentName Button - Icon
+     * @nativeHandler onClick
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaButtonIcon {
         "buttonType": keyof typeof this.buttonTypeMap;
         /**
@@ -220,6 +272,12 @@ export namespace Components {
          */
         "label"?: string;
     }
+    /**
+     * @componentName Button pair
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref button/button-pair
+     */
     interface VaButtonPair {
         /**
           * If `true`, button pair will use Continue and Back for button text.
@@ -229,10 +287,18 @@ export namespace Components {
           * If `true`, the component-library-analytics event is disabled.
          */
         "disableAnalytics"?: boolean;
+        /**
+          * Custom text that will be applied to the left va-button inside the component. If set will override text controlled by the 'update' prop.
+         */
+        "leftButtonText"?: string;
         /**
           * Applies to the primary button aria-label.
          */
         "primaryLabel"?: string;
+        /**
+          * Custom text that will be applied to the right va-button inside the component. If set will override text controlled by the 'update' prop,
+         */
+        "rightButtonText"?: string;
         /**
           * Applies to the secondary button aria-label.
          */
@@ -246,6 +312,11 @@ export namespace Components {
          */
         "update"?: boolean;
     }
+    /**
+     * @componentName Card
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaCard {
         /**
           * If `true`, the card will have a gray background.
@@ -256,6 +327,16 @@ export namespace Components {
          */
         "showShadow"?: boolean;
     }
+    /**
+     * @nativeHandler onBlur
+     * @componentName Checkbox
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/checkbox
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaCheckbox {
         /**
           * Description of the option displayed below the checkbox label.
@@ -306,6 +387,16 @@ export namespace Components {
          */
         "tile"?: boolean;
     }
+    /**
+     * @vaChange The event emitted when the input value changes.
+     * @componentName Checkbox group
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/checkbox
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaCheckboxGroup {
         /**
           * Whether or not an analytics event will be fired.
@@ -344,8 +435,19 @@ export namespace Components {
          */
         "useFormsPattern"?: string;
     }
+    /**
+     * @componentName Crisis Line Modal
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaCrisisLineModal {
     }
+    /**
+     * @componentName Date input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/date-input
+     */
     interface VaDate {
         /**
           * Whether or not an analytics event will be fired.
@@ -383,6 +485,12 @@ export namespace Components {
          */
         "value"?: string;
     }
+    /**
+     * @componentName File input
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/file-input
+     */
     interface VaFileInput {
         /**
           * A comma-separated list of unique file type specifiers.
@@ -425,6 +533,14 @@ export namespace Components {
          */
         "required"?: boolean;
     }
+    /**
+     * A component that manages multiple file inputs, allowing users to upload several files.
+     * It supports adding, changing, and removing files with dynamic error handling.
+     * @componentName File input multiple
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/file-input-multiple
+     */
     interface VaFileInputMultiple {
         /**
           * Defines acceptable file types the user can select; uses file type or extensions.
@@ -459,6 +575,12 @@ export namespace Components {
          */
         "required"?: boolean;
     }
+    /**
+     * @componentName Header - Minimal
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref header/header-minimal
+     */
     interface VaHeaderMinimal {
         /**
           * 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.
@@ -467,6 +589,11 @@ export namespace Components {
         "header"?: string;
         "subheader"?: string;
     }
+    /**
+     * @componentName Icon
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaIcon {
         /**
           * The name of the icon to use
@@ -481,6 +608,11 @@ export namespace Components {
          */
         "srtext"?: string;
     }
+    /**
+     * @componentName Link
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaLink {
         /**
           * The title used in the abbr element. If filetype is PDF, the abbr title will be Portable Document Format.
@@ -490,6 +622,10 @@ export namespace Components {
           * If `true`, the anchor text will be bolded and include a right arrow icon.
          */
         "active"?: boolean;
+        /**
+          * If 'true', renders a "back arrow" in front of the link text
+         */
+        "back"?: boolean;
         /**
           * If `true`, a calendar icon will be displayed before the anchor text.
          */
@@ -506,6 +642,10 @@ export namespace Components {
           * If `true`, the link will be treated as a download, and a download icon will be displayed before the anchor text.
          */
         "download"?: boolean;
+        /**
+          * 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
+         */
+        "external"?: boolean;
         /**
           * The suggested filename. Only valid if download or calendar is `true`.
          */
@@ -547,6 +687,11 @@ export namespace Components {
          */
         "video"?: boolean;
     }
+    /**
+     * @componentName Link - Action
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaLinkAction {
         /**
           * If `true`, the component-library-analytics event is disabled.
@@ -569,6 +714,11 @@ export namespace Components {
          */
         "type": "primary" | "secondary" | "reverse";
     }
+    /**
+     * @componentName Loading indicator
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaLoadingIndicator {
         /**
           * Analytics tracking function(s) will be called. Form components are disabled by default due to PII/PHI concerns.
@@ -587,6 +737,11 @@ export namespace Components {
          */
         "setFocus"?: boolean;
     }
+    /**
+     * @componentName Banner - Maintenance
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface VaMaintenanceBanner {
         /**
           * A unique ID that will be used for conditionally rendering the banner based on if the user has dismissed it already.
@@ -621,6 +776,14 @@ export namespace Components {
          */
         "upcomingWarnTitle": string;
     }
+    /**
+     * @componentName Memorable date
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/memorable-date
+     * @translations English
+     * @translations Spanish
+     */
     interface VaMemorableDate {
         /**
           * A custom error message to display if the day is invalid
@@ -682,8 +845,20 @@ export namespace Components {
          */
         "value"?: string;
     }
+    /**
+     * @componentName Minimal Footer
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaMinimalFooter {
     }
+    /**
+     * @click Used to detect clicks outside of modal contents to close modal.
+     * @keydown Used to detect Escape key to close modal.
+     * @componentName Modal
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaModal {
         /**
           * Additional DOM-nodes that should not be hidden from screen readers. Useful when an open modal shouldn't hide all content behind the overlay.
@@ -731,8 +906,19 @@ export namespace Components {
          */
         "visible"?: boolean;
     }
+    /**
+     * @componentName Need help?
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref form/need-help
+     */
     interface VaNeedHelp {
     }
+    /**
+     * @componentName Notification
+     * @maturityCategory dont_use
+     * @maturityLevel deprecated
+     */
     interface VaNotification {
         /**
           * Aria-label text for the close button.
@@ -783,76 +969,11 @@ export namespace Components {
          */
         "visible"?: boolean;
     }
-    interface VaNumberInput {
-        /**
-          * Whether this component will be used to accept a currency value.
-         */
-        "currency"?: boolean;
-        /**
-          * Emit component-library-analytics events on the blur event.
-         */
-        "enableAnalytics"?: boolean;
-        /**
-          * The error message to render.
-         */
-        "error"?: string;
-        /**
-          * The content of the heading if `useFormsPattern` and `uswds` are true.
-         */
-        "formHeading"?: string;
-        /**
-          * The heading level for the heading if `useFormsPattern` and `uswds` are true.
-         */
-        "formHeadingLevel"?: number;
-        /**
-          * Optional hint text.
-         */
-        "hint"?: string;
-        /**
-          * The inputmode attribute.
-         */
-        "inputmode"?: 'decimal' | 'numeric';
-        /**
-          * The label for the text input.
-         */
-        "label"?: string;
-        /**
-          * Maximum number value The max attribute specifies the maximum value for an input element.
-         */
-        "max": number | string;
-        /**
-          * An optional message that will be read by screen readers when the input is focused.
-         */
-        "messageAriaDescribedby"?: string;
-        /**
-          * Minimum number value The min attribute specifies the minimum value for an input element.
-         */
-        "min": number | string;
-        /**
-          * The name to pass to the input element.
-         */
-        "name"?: string;
-        /**
-          * Set the input to required and render the (Required) text.
-         */
-        "required"?: boolean;
-        /**
-          * 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.
-         */
-        "useFormsPattern"?: string;
-        /**
-          * Whether or not the component will use USWDS v3 styling.
-         */
-        "uswds"?: boolean;
-        /**
-          * The value for the input.
-         */
-        "value"?: string;
-        /**
-          * 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).
-         */
-        "width"?: string;
-    }
+    /**
+     * @componentName Banner - Official Gov
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaOfficialGovBanner {
         /**
           * If `true`, the component-library-analytics event is disabled.
@@ -863,6 +984,11 @@ export namespace Components {
          */
         "tld": string;
     }
+    /**
+     * @componentName OMB info
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaOmbInfo {
         /**
           * The name of the benefit displayed in the Respondent Burden section of the Privacy Act Statement.
@@ -881,12 +1007,25 @@ export namespace Components {
          */
         "resBurden"?: number;
     }
+    /**
+     * @componentName On this page
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaOnThisPage {
         /**
           * If true, analytics event will not be fired
          */
         "disableAnalytics"?: boolean;
     }
+    /**
+     * @componentName Pagination
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaPagination {
         /**
           * Aria-label suffix text for buttons
@@ -917,6 +1056,11 @@ export namespace Components {
          */
         "unbounded"?: boolean;
     }
+    /**
+     * @componentName Privacy agreement
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface VaPrivacyAgreement {
         /**
           * Whether the checkbox is checked or not.
@@ -931,6 +1075,11 @@ export namespace Components {
          */
         "showError"?: boolean;
     }
+    /**
+     * @componentName Process list
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaProcessList {
     }
     interface VaProcessListItem {
@@ -955,6 +1104,11 @@ export namespace Components {
          */
         "pending"?: boolean;
     }
+    /**
+     * @componentName Progress bar - activity
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaProgressBar {
         /**
           * Whether or not an analytics event will be fired.
@@ -969,6 +1123,12 @@ export namespace Components {
          */
         "percent": number;
     }
+    /**
+     * @componentName Banner - Promo
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref banner/promo
+     */
     interface VaPromoBanner {
         /**
           * Analytics tracking function(s) will not be called
@@ -983,6 +1143,17 @@ export namespace Components {
          */
         "type": 'announcement' | 'news' | 'email-signup';
     }
+    /**
+     * @keydown The event emitted when a key is pressed.
+     * @radioOptionSelected The event emitted when the selected option value changes.
+     * @componentName Radio button
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/radio-button
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaRadio {
         /**
           * Whether or not an analytics event will be fired.
@@ -1059,6 +1230,11 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * @componentName Search input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaSearchInput {
         /**
           * If `true`, the component will use the big variant.
@@ -1089,6 +1265,12 @@ export namespace Components {
          */
         "value"?: string;
     }
+    /**
+     * @componentName Progress bar - segmented
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/progress-bar-segmented
+     */
     interface VaSegmentedProgressBar {
         /**
           * Whether or not to center the step labels
@@ -1135,6 +1317,15 @@ export namespace Components {
          */
         "useDiv"?: boolean;
     }
+    /**
+     * @nativeHandler onKeyDown
+     * @componentName Select
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/select
+     * @translations English
+     * @translations Spanish
+     */
     interface VaSelect {
         /**
           * Whether or not to fire the analytics events
@@ -1177,6 +1368,11 @@ export namespace Components {
          */
         "value"?: string;
     }
+    /**
+     * @componentName Statement of truth
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaStatementOfTruth {
         /**
           * The error to be applied to the va-check-box element
@@ -1211,17 +1407,14 @@ export namespace Components {
          */
         "inputValue": string;
     }
+    /**
+     * @componentName Summary box
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaSummaryBox {
     }
     interface VaTable {
-        /**
-          * Whether the initial sort state will be descending or not.
-         */
-        "descending"?: boolean;
-        /**
-          * The zero-based index of the column to sort by (Doesn't work in IE11). Optional.
-         */
-        "sortColumn"?: number;
         /**
           * Convert to a stacked table when screen size is small True by default, must specify if false if this is unwanted
          */
@@ -1234,25 +1427,18 @@ export namespace Components {
           * If uswds is true, the type of table
          */
         "tableType"?: 'borderless';
-        /**
-          * Whether or not the component will use USWDS v3 styling.
-         */
-        "uswds"?: boolean;
     }
+    /**
+     * @componentName Table
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaTableInner {
         /**
-          * If uswds is true, the number of columns in the table
+          * The number of columns in the table
          */
         "cols"?: number;
-        /**
-          * Whether the initial sort state will be descending or not.
-         */
-        "descending"?: boolean;
         "rows"?: number;
-        /**
-          * The zero-based index of the column to sort by (Doesn't work in IE11). Optional.
-         */
-        "sortColumn"?: number;
         /**
           * If true convert to a stacked table when screen size is small
          */
@@ -1262,20 +1448,17 @@ export namespace Components {
          */
         "tableTitle": string;
         /**
-          * If uswds is true, the type of table to be used
+          * The type of table to be used
          */
         "tableType"?: 'borderless';
-        /**
-          * Whether or not the component will use USWDS v3 styling.
-         */
-        "uswds"?: boolean;
-        /**
-          * A live reference to the va-table-rows in the table which are hard to access from this component
-         */
-        "vaTableRowRefs"?: any;
     }
     interface VaTableRow {
     }
+    /**
+     * @componentName Telephone
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaTelephone {
         /**
           * Numeric string representing the contact number. Typical length is 3 or 10 digits - SMS short codes will be 5 or 6 digits.
@@ -1310,6 +1493,17 @@ export namespace Components {
          */
         "vanity"?: string;
     }
+    /**
+     * @nativeHandler onInput
+     * @nativeHandler onBlur
+     * @componentName Text input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/text-input
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaTextInput {
         /**
           * Allows the browser to automatically complete the input.
@@ -1409,6 +1603,14 @@ export namespace Components {
           * Set the input to required and render the (Required) text.
          */
         "required"?: boolean;
+        /**
+          * 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.
+         */
+        "showInputError"?: boolean;
+        /**
+          * 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)
+         */
+        "step"?: string;
         /**
           * Adds styling based on status value
          */
@@ -1430,6 +1632,16 @@ export namespace Components {
          */
         "width"?: string;
     }
+    /**
+     * @nativeHandler onInput
+     * @nativeHandler onBlur
+     * @componentName Textarea
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/textarea
+     * @translations English
+     * @translations Spanish
+     */
     interface VaTextarea {
         /**
           * Whether the component should show a character count message. Has no effect without maxlength being set.
@@ -1585,10 +1797,6 @@ export interface VaNotificationCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVaNotificationElement;
 }
-export interface VaNumberInputCustomEvent<T> extends CustomEvent<T> {
-    detail: T;
-    target: HTMLVaNumberInputElement;
-}
 export interface VaOfficialGovBannerCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVaOfficialGovBannerElement;
@@ -1650,6 +1858,15 @@ export interface VaTextareaCustomEvent<T> extends CustomEvent<T> {
     target: HTMLVaTextareaElement;
 }
 declare global {
+    /**
+     * @componentName Accordion
+     * @accordionItemToggled This event is fired when an accordion item is opened or closed
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface HTMLVaAccordionElement extends Components.VaAccordion, HTMLStencilElement {
     }
     var HTMLVaAccordionElement: {
@@ -1662,204 +1879,391 @@ declare global {
         prototype: HTMLVaAccordionItemElement;
         new (): HTMLVaAccordionItemElement;
     };
+    /**
+     * @componentName Additional info
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaAdditionalInfoElement extends Components.VaAdditionalInfo, HTMLStencilElement {
     }
     var HTMLVaAdditionalInfoElement: {
         prototype: HTMLVaAdditionalInfoElement;
         new (): HTMLVaAdditionalInfoElement;
     };
+    /**
+     * @componentName Alert
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface HTMLVaAlertElement extends Components.VaAlert, HTMLStencilElement {
     }
     var HTMLVaAlertElement: {
         prototype: HTMLVaAlertElement;
         new (): HTMLVaAlertElement;
     };
+    /**
+     * @componentName Alert - expandable
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaAlertExpandableElement extends Components.VaAlertExpandable, HTMLStencilElement {
     }
     var HTMLVaAlertExpandableElement: {
         prototype: HTMLVaAlertExpandableElement;
         new (): HTMLVaAlertExpandableElement;
     };
+    /**
+     * @componentName Back to top
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaBackToTopElement extends Components.VaBackToTop, HTMLStencilElement {
     }
     var HTMLVaBackToTopElement: {
         prototype: HTMLVaBackToTopElement;
         new (): HTMLVaBackToTopElement;
     };
+    /**
+     * @componentName Banner
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaBannerElement extends Components.VaBanner, HTMLStencilElement {
     }
     var HTMLVaBannerElement: {
         prototype: HTMLVaBannerElement;
         new (): HTMLVaBannerElement;
     };
+    /**
+     * @componentName Breadcrumbs
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaBreadcrumbsElement extends Components.VaBreadcrumbs, HTMLStencilElement {
     }
     var HTMLVaBreadcrumbsElement: {
         prototype: HTMLVaBreadcrumbsElement;
         new (): HTMLVaBreadcrumbsElement;
     };
+    /**
+     * @componentName Button
+     * @nativeHandler onClick
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaButtonElement extends Components.VaButton, HTMLStencilElement {
     }
     var HTMLVaButtonElement: {
         prototype: HTMLVaButtonElement;
         new (): HTMLVaButtonElement;
     };
+    /**
+     * @componentName Button - Icon
+     * @nativeHandler onClick
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaButtonIconElement extends Components.VaButtonIcon, HTMLStencilElement {
     }
     var HTMLVaButtonIconElement: {
         prototype: HTMLVaButtonIconElement;
         new (): HTMLVaButtonIconElement;
     };
+    /**
+     * @componentName Button pair
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref button/button-pair
+     */
     interface HTMLVaButtonPairElement extends Components.VaButtonPair, HTMLStencilElement {
     }
     var HTMLVaButtonPairElement: {
         prototype: HTMLVaButtonPairElement;
         new (): HTMLVaButtonPairElement;
     };
+    /**
+     * @componentName Card
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaCardElement extends Components.VaCard, HTMLStencilElement {
     }
     var HTMLVaCardElement: {
         prototype: HTMLVaCardElement;
         new (): HTMLVaCardElement;
     };
+    /**
+     * @nativeHandler onBlur
+     * @componentName Checkbox
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/checkbox
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface HTMLVaCheckboxElement extends Components.VaCheckbox, HTMLStencilElement {
     }
     var HTMLVaCheckboxElement: {
         prototype: HTMLVaCheckboxElement;
         new (): HTMLVaCheckboxElement;
     };
+    /**
+     * @vaChange The event emitted when the input value changes.
+     * @componentName Checkbox group
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/checkbox
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface HTMLVaCheckboxGroupElement extends Components.VaCheckboxGroup, HTMLStencilElement {
     }
     var HTMLVaCheckboxGroupElement: {
         prototype: HTMLVaCheckboxGroupElement;
         new (): HTMLVaCheckboxGroupElement;
     };
+    /**
+     * @componentName Crisis Line Modal
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaCrisisLineModalElement extends Components.VaCrisisLineModal, HTMLStencilElement {
     }
     var HTMLVaCrisisLineModalElement: {
         prototype: HTMLVaCrisisLineModalElement;
         new (): HTMLVaCrisisLineModalElement;
     };
+    /**
+     * @componentName Date input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/date-input
+     */
     interface HTMLVaDateElement extends Components.VaDate, HTMLStencilElement {
     }
     var HTMLVaDateElement: {
         prototype: HTMLVaDateElement;
         new (): HTMLVaDateElement;
     };
+    /**
+     * @componentName File input
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/file-input
+     */
     interface HTMLVaFileInputElement extends Components.VaFileInput, HTMLStencilElement {
     }
     var HTMLVaFileInputElement: {
         prototype: HTMLVaFileInputElement;
         new (): HTMLVaFileInputElement;
     };
+    /**
+     * A component that manages multiple file inputs, allowing users to upload several files.
+     * It supports adding, changing, and removing files with dynamic error handling.
+     * @componentName File input multiple
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/file-input-multiple
+     */
     interface HTMLVaFileInputMultipleElement extends Components.VaFileInputMultiple, HTMLStencilElement {
     }
     var HTMLVaFileInputMultipleElement: {
         prototype: HTMLVaFileInputMultipleElement;
         new (): HTMLVaFileInputMultipleElement;
     };
+    /**
+     * @componentName Header - Minimal
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref header/header-minimal
+     */
     interface HTMLVaHeaderMinimalElement extends Components.VaHeaderMinimal, HTMLStencilElement {
     }
     var HTMLVaHeaderMinimalElement: {
         prototype: HTMLVaHeaderMinimalElement;
         new (): HTMLVaHeaderMinimalElement;
     };
+    /**
+     * @componentName Icon
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaIconElement extends Components.VaIcon, HTMLStencilElement {
     }
     var HTMLVaIconElement: {
         prototype: HTMLVaIconElement;
         new (): HTMLVaIconElement;
     };
+    /**
+     * @componentName Link
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaLinkElement extends Components.VaLink, HTMLStencilElement {
     }
     var HTMLVaLinkElement: {
         prototype: HTMLVaLinkElement;
         new (): HTMLVaLinkElement;
     };
+    /**
+     * @componentName Link - Action
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaLinkActionElement extends Components.VaLinkAction, HTMLStencilElement {
     }
     var HTMLVaLinkActionElement: {
         prototype: HTMLVaLinkActionElement;
         new (): HTMLVaLinkActionElement;
     };
+    /**
+     * @componentName Loading indicator
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface HTMLVaLoadingIndicatorElement extends Components.VaLoadingIndicator, HTMLStencilElement {
     }
     var HTMLVaLoadingIndicatorElement: {
         prototype: HTMLVaLoadingIndicatorElement;
         new (): HTMLVaLoadingIndicatorElement;
     };
+    /**
+     * @componentName Banner - Maintenance
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface HTMLVaMaintenanceBannerElement extends Components.VaMaintenanceBanner, HTMLStencilElement {
     }
     var HTMLVaMaintenanceBannerElement: {
         prototype: HTMLVaMaintenanceBannerElement;
         new (): HTMLVaMaintenanceBannerElement;
     };
+    /**
+     * @componentName Memorable date
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/memorable-date
+     * @translations English
+     * @translations Spanish
+     */
     interface HTMLVaMemorableDateElement extends Components.VaMemorableDate, HTMLStencilElement {
     }
     var HTMLVaMemorableDateElement: {
         prototype: HTMLVaMemorableDateElement;
         new (): HTMLVaMemorableDateElement;
     };
+    /**
+     * @componentName Minimal Footer
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaMinimalFooterElement extends Components.VaMinimalFooter, HTMLStencilElement {
     }
     var HTMLVaMinimalFooterElement: {
         prototype: HTMLVaMinimalFooterElement;
         new (): HTMLVaMinimalFooterElement;
     };
+    /**
+     * @click Used to detect clicks outside of modal contents to close modal.
+     * @keydown Used to detect Escape key to close modal.
+     * @componentName Modal
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaModalElement extends Components.VaModal, HTMLStencilElement {
     }
     var HTMLVaModalElement: {
         prototype: HTMLVaModalElement;
         new (): HTMLVaModalElement;
     };
+    /**
+     * @componentName Need help?
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref form/need-help
+     */
     interface HTMLVaNeedHelpElement extends Components.VaNeedHelp, HTMLStencilElement {
     }
     var HTMLVaNeedHelpElement: {
         prototype: HTMLVaNeedHelpElement;
         new (): HTMLVaNeedHelpElement;
     };
+    /**
+     * @componentName Notification
+     * @maturityCategory dont_use
+     * @maturityLevel deprecated
+     */
     interface HTMLVaNotificationElement extends Components.VaNotification, HTMLStencilElement {
     }
     var HTMLVaNotificationElement: {
         prototype: HTMLVaNotificationElement;
         new (): HTMLVaNotificationElement;
     };
-    interface HTMLVaNumberInputElement extends Components.VaNumberInput, HTMLStencilElement {
-    }
-    var HTMLVaNumberInputElement: {
-        prototype: HTMLVaNumberInputElement;
-        new (): HTMLVaNumberInputElement;
-    };
+    /**
+     * @componentName Banner - Official Gov
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaOfficialGovBannerElement extends Components.VaOfficialGovBanner, HTMLStencilElement {
     }
     var HTMLVaOfficialGovBannerElement: {
         prototype: HTMLVaOfficialGovBannerElement;
         new (): HTMLVaOfficialGovBannerElement;
     };
+    /**
+     * @componentName OMB info
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface HTMLVaOmbInfoElement extends Components.VaOmbInfo, HTMLStencilElement {
     }
     var HTMLVaOmbInfoElement: {
         prototype: HTMLVaOmbInfoElement;
         new (): HTMLVaOmbInfoElement;
     };
+    /**
+     * @componentName On this page
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface HTMLVaOnThisPageElement extends Components.VaOnThisPage, HTMLStencilElement {
     }
     var HTMLVaOnThisPageElement: {
         prototype: HTMLVaOnThisPageElement;
         new (): HTMLVaOnThisPageElement;
     };
+    /**
+     * @componentName Pagination
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaPaginationElement extends Components.VaPagination, HTMLStencilElement {
     }
     var HTMLVaPaginationElement: {
         prototype: HTMLVaPaginationElement;
         new (): HTMLVaPaginationElement;
     };
+    /**
+     * @componentName Privacy agreement
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface HTMLVaPrivacyAgreementElement extends Components.VaPrivacyAgreement, HTMLStencilElement {
     }
     var HTMLVaPrivacyAgreementElement: {
         prototype: HTMLVaPrivacyAgreementElement;
         new (): HTMLVaPrivacyAgreementElement;
     };
+    /**
+     * @componentName Process list
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaProcessListElement extends Components.VaProcessList, HTMLStencilElement {
     }
     var HTMLVaProcessListElement: {
@@ -1872,18 +2276,40 @@ declare global {
         prototype: HTMLVaProcessListItemElement;
         new (): HTMLVaProcessListItemElement;
     };
+    /**
+     * @componentName Progress bar - activity
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaProgressBarElement extends Components.VaProgressBar, HTMLStencilElement {
     }
     var HTMLVaProgressBarElement: {
         prototype: HTMLVaProgressBarElement;
         new (): HTMLVaProgressBarElement;
     };
+    /**
+     * @componentName Banner - Promo
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref banner/promo
+     */
     interface HTMLVaPromoBannerElement extends Components.VaPromoBanner, HTMLStencilElement {
     }
     var HTMLVaPromoBannerElement: {
         prototype: HTMLVaPromoBannerElement;
         new (): HTMLVaPromoBannerElement;
     };
+    /**
+     * @keydown The event emitted when a key is pressed.
+     * @radioOptionSelected The event emitted when the selected option value changes.
+     * @componentName Radio button
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/radio-button
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface HTMLVaRadioElement extends Components.VaRadio, HTMLStencilElement {
     }
     var HTMLVaRadioElement: {
@@ -1896,30 +2322,60 @@ declare global {
         prototype: HTMLVaRadioOptionElement;
         new (): HTMLVaRadioOptionElement;
     };
+    /**
+     * @componentName Search input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaSearchInputElement extends Components.VaSearchInput, HTMLStencilElement {
     }
     var HTMLVaSearchInputElement: {
         prototype: HTMLVaSearchInputElement;
         new (): HTMLVaSearchInputElement;
     };
+    /**
+     * @componentName Progress bar - segmented
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/progress-bar-segmented
+     */
     interface HTMLVaSegmentedProgressBarElement extends Components.VaSegmentedProgressBar, HTMLStencilElement {
     }
     var HTMLVaSegmentedProgressBarElement: {
         prototype: HTMLVaSegmentedProgressBarElement;
         new (): HTMLVaSegmentedProgressBarElement;
     };
+    /**
+     * @nativeHandler onKeyDown
+     * @componentName Select
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/select
+     * @translations English
+     * @translations Spanish
+     */
     interface HTMLVaSelectElement extends Components.VaSelect, HTMLStencilElement {
     }
     var HTMLVaSelectElement: {
         prototype: HTMLVaSelectElement;
         new (): HTMLVaSelectElement;
     };
+    /**
+     * @componentName Statement of truth
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface HTMLVaStatementOfTruthElement extends Components.VaStatementOfTruth, HTMLStencilElement {
     }
     var HTMLVaStatementOfTruthElement: {
         prototype: HTMLVaStatementOfTruthElement;
         new (): HTMLVaStatementOfTruthElement;
     };
+    /**
+     * @componentName Summary box
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface HTMLVaSummaryBoxElement extends Components.VaSummaryBox, HTMLStencilElement {
     }
     var HTMLVaSummaryBoxElement: {
@@ -1932,6 +2388,11 @@ declare global {
         prototype: HTMLVaTableElement;
         new (): HTMLVaTableElement;
     };
+    /**
+     * @componentName Table
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface HTMLVaTableInnerElement extends Components.VaTableInner, HTMLStencilElement {
     }
     var HTMLVaTableInnerElement: {
@@ -1944,18 +2405,44 @@ declare global {
         prototype: HTMLVaTableRowElement;
         new (): HTMLVaTableRowElement;
     };
+    /**
+     * @componentName Telephone
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface HTMLVaTelephoneElement extends Components.VaTelephone, HTMLStencilElement {
     }
     var HTMLVaTelephoneElement: {
         prototype: HTMLVaTelephoneElement;
         new (): HTMLVaTelephoneElement;
     };
+    /**
+     * @nativeHandler onInput
+     * @nativeHandler onBlur
+     * @componentName Text input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/text-input
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface HTMLVaTextInputElement extends Components.VaTextInput, HTMLStencilElement {
     }
     var HTMLVaTextInputElement: {
         prototype: HTMLVaTextInputElement;
         new (): HTMLVaTextInputElement;
     };
+    /**
+     * @nativeHandler onInput
+     * @nativeHandler onBlur
+     * @componentName Textarea
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/textarea
+     * @translations English
+     * @translations Spanish
+     */
     interface HTMLVaTextareaElement extends Components.VaTextarea, HTMLStencilElement {
     }
     var HTMLVaTextareaElement: {
@@ -1992,7 +2479,6 @@ declare global {
         "va-modal": HTMLVaModalElement;
         "va-need-help": HTMLVaNeedHelpElement;
         "va-notification": HTMLVaNotificationElement;
-        "va-number-input": HTMLVaNumberInputElement;
         "va-official-gov-banner": HTMLVaOfficialGovBannerElement;
         "va-omb-info": HTMLVaOmbInfoElement;
         "va-on-this-page": HTMLVaOnThisPageElement;
@@ -2018,6 +2504,15 @@ declare global {
     }
 }
 declare namespace LocalJSX {
+    /**
+     * @componentName Accordion
+     * @accordionItemToggled This event is fired when an accordion item is opened or closed
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaAccordion {
         /**
           * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -2062,6 +2557,11 @@ declare namespace LocalJSX {
          */
         "subheader"?: string;
     }
+    /**
+     * @componentName Additional info
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaAdditionalInfo {
         /**
           * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -2080,6 +2580,11 @@ declare namespace LocalJSX {
          */
         "trigger": string;
     }
+    /**
+     * @componentName Alert
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaAlert {
         /**
           * Aria-label text for the close button.
@@ -2126,6 +2631,11 @@ declare namespace LocalJSX {
          */
         "visible"?: boolean;
     }
+    /**
+     * @componentName Alert - expandable
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaAlertExpandable {
         /**
           * If `true`, doesn't fire the CustomEvent which can be used for analytics tracking.
@@ -2148,8 +2658,18 @@ declare namespace LocalJSX {
          */
         "trigger": string;
     }
+    /**
+     * @componentName Back to top
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaBackToTop {
     }
+    /**
+     * @componentName Banner
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaBanner {
         /**
           * Aria Label for the "region" of the nested va-alert.
@@ -2184,6 +2704,11 @@ declare namespace LocalJSX {
          */
         "windowSession"?: boolean;
     }
+    /**
+     * @componentName Breadcrumbs
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaBreadcrumbs {
         /**
           * 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"}]`.
@@ -2214,6 +2739,12 @@ declare namespace LocalJSX {
          */
         "wrapping"?: boolean;
     }
+    /**
+     * @componentName Button
+     * @nativeHandler onClick
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaButton {
         /**
           * If `true`, the button will use `Back` as its text and an icon to represent going back in form flows.
@@ -2264,6 +2795,12 @@ declare namespace LocalJSX {
          */
         "text"?: string;
     }
+    /**
+     * @componentName Button - Icon
+     * @nativeHandler onClick
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaButtonIcon {
         "buttonType"?: keyof typeof this.buttonTypeMap;
         /**
@@ -2279,6 +2816,12 @@ declare namespace LocalJSX {
          */
         "onComponent-library-analytics"?: (event: VaButtonIconCustomEvent<any>) => void;
     }
+    /**
+     * @componentName Button pair
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref button/button-pair
+     */
     interface VaButtonPair {
         /**
           * If `true`, button pair will use Continue and Back for button text.
@@ -2288,6 +2831,10 @@ declare namespace LocalJSX {
           * If `true`, the component-library-analytics event is disabled.
          */
         "disableAnalytics"?: boolean;
+        /**
+          * Custom text that will be applied to the left va-button inside the component. If set will override text controlled by the 'update' prop.
+         */
+        "leftButtonText"?: string;
         /**
           * The event used to track usage of the component.
          */
@@ -2304,6 +2851,10 @@ declare namespace LocalJSX {
           * Applies to the primary button aria-label.
          */
         "primaryLabel"?: string;
+        /**
+          * Custom text that will be applied to the right va-button inside the component. If set will override text controlled by the 'update' prop,
+         */
+        "rightButtonText"?: string;
         /**
           * Applies to the secondary button aria-label.
          */
@@ -2317,6 +2868,11 @@ declare namespace LocalJSX {
          */
         "update"?: boolean;
     }
+    /**
+     * @componentName Card
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaCard {
         /**
           * If `true`, the card will have a gray background.
@@ -2327,6 +2883,16 @@ declare namespace LocalJSX {
          */
         "showShadow"?: boolean;
     }
+    /**
+     * @nativeHandler onBlur
+     * @componentName Checkbox
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/checkbox
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaCheckbox {
         /**
           * Description of the option displayed below the checkbox label.
@@ -2385,6 +2951,16 @@ declare namespace LocalJSX {
          */
         "tile"?: boolean;
     }
+    /**
+     * @vaChange The event emitted when the input value changes.
+     * @componentName Checkbox group
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/checkbox
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaCheckboxGroup {
         /**
           * Whether or not an analytics event will be fired.
@@ -2427,8 +3003,19 @@ declare namespace LocalJSX {
          */
         "useFormsPattern"?: string;
     }
+    /**
+     * @componentName Crisis Line Modal
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaCrisisLineModal {
     }
+    /**
+     * @componentName Date input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/date-input
+     */
     interface VaDate {
         /**
           * Whether or not an analytics event will be fired.
@@ -2478,6 +3065,12 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * @componentName File input
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/file-input
+     */
     interface VaFileInput {
         /**
           * A comma-separated list of unique file type specifiers.
@@ -2528,6 +3121,14 @@ declare namespace LocalJSX {
          */
         "required"?: boolean;
     }
+    /**
+     * A component that manages multiple file inputs, allowing users to upload several files.
+     * It supports adding, changing, and removing files with dynamic error handling.
+     * @componentName File input multiple
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/file-input-multiple
+     */
     interface VaFileInputMultiple {
         /**
           * Defines acceptable file types the user can select; uses file type or extensions.
@@ -2566,6 +3167,12 @@ declare namespace LocalJSX {
          */
         "required"?: boolean;
     }
+    /**
+     * @componentName Header - Minimal
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref header/header-minimal
+     */
     interface VaHeaderMinimal {
         /**
           * 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.
@@ -2574,6 +3181,11 @@ declare namespace LocalJSX {
         "header"?: string;
         "subheader"?: string;
     }
+    /**
+     * @componentName Icon
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaIcon {
         /**
           * The name of the icon to use
@@ -2588,6 +3200,11 @@ declare namespace LocalJSX {
          */
         "srtext"?: string;
     }
+    /**
+     * @componentName Link
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaLink {
         /**
           * The title used in the abbr element. If filetype is PDF, the abbr title will be Portable Document Format.
@@ -2597,6 +3214,10 @@ declare namespace LocalJSX {
           * If `true`, the anchor text will be bolded and include a right arrow icon.
          */
         "active"?: boolean;
+        /**
+          * If 'true', renders a "back arrow" in front of the link text
+         */
+        "back"?: boolean;
         /**
           * If `true`, a calendar icon will be displayed before the anchor text.
          */
@@ -2613,6 +3234,10 @@ declare namespace LocalJSX {
           * If `true`, the link will be treated as a download, and a download icon will be displayed before the anchor text.
          */
         "download"?: boolean;
+        /**
+          * 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
+         */
+        "external"?: boolean;
         /**
           * The suggested filename. Only valid if download or calendar is `true`.
          */
@@ -2658,6 +3283,11 @@ declare namespace LocalJSX {
          */
         "video"?: boolean;
     }
+    /**
+     * @componentName Link - Action
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaLinkAction {
         /**
           * If `true`, the component-library-analytics event is disabled.
@@ -2684,6 +3314,11 @@ declare namespace LocalJSX {
          */
         "type"?: "primary" | "secondary" | "reverse";
     }
+    /**
+     * @componentName Loading indicator
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaLoadingIndicator {
         /**
           * Analytics tracking function(s) will be called. Form components are disabled by default due to PII/PHI concerns.
@@ -2706,6 +3341,11 @@ declare namespace LocalJSX {
          */
         "setFocus"?: boolean;
     }
+    /**
+     * @componentName Banner - Maintenance
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface VaMaintenanceBanner {
         /**
           * A unique ID that will be used for conditionally rendering the banner based on if the user has dismissed it already.
@@ -2748,6 +3388,14 @@ declare namespace LocalJSX {
          */
         "upcomingWarnTitle"?: string;
     }
+    /**
+     * @componentName Memorable date
+     * @maturityCategory caution
+     * @maturityLevel available
+     * @guidanceHref form/memorable-date
+     * @translations English
+     * @translations Spanish
+     */
     interface VaMemorableDate {
         /**
           * A custom error message to display if the day is invalid
@@ -2821,8 +3469,20 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * @componentName Minimal Footer
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaMinimalFooter {
     }
+    /**
+     * @click Used to detect clicks outside of modal contents to close modal.
+     * @keydown Used to detect Escape key to close modal.
+     * @componentName Modal
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaModal {
         /**
           * Additional DOM-nodes that should not be hidden from screen readers. Useful when an open modal shouldn't hide all content behind the overlay.
@@ -2886,8 +3546,19 @@ declare namespace LocalJSX {
          */
         "visible"?: boolean;
     }
+    /**
+     * @componentName Need help?
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     * @guidanceHref form/need-help
+     */
     interface VaNeedHelp {
     }
+    /**
+     * @componentName Notification
+     * @maturityCategory dont_use
+     * @maturityLevel deprecated
+     */
     interface VaNotification {
         /**
           * Aria-label text for the close button.
@@ -2946,80 +3617,11 @@ declare namespace LocalJSX {
          */
         "visible"?: boolean;
     }
-    interface VaNumberInput {
-        /**
-          * Whether this component will be used to accept a currency value.
-         */
-        "currency"?: boolean;
-        /**
-          * Emit component-library-analytics events on the blur event.
-         */
-        "enableAnalytics"?: boolean;
-        /**
-          * The error message to render.
-         */
-        "error"?: string;
-        /**
-          * The content of the heading if `useFormsPattern` and `uswds` are true.
-         */
-        "formHeading"?: string;
-        /**
-          * The heading level for the heading if `useFormsPattern` and `uswds` are true.
-         */
-        "formHeadingLevel"?: number;
-        /**
-          * Optional hint text.
-         */
-        "hint"?: string;
-        /**
-          * The inputmode attribute.
-         */
-        "inputmode"?: 'decimal' | 'numeric';
-        /**
-          * The label for the text input.
-         */
-        "label"?: string;
-        /**
-          * Maximum number value The max attribute specifies the maximum value for an input element.
-         */
-        "max"?: number | string;
-        /**
-          * An optional message that will be read by screen readers when the input is focused.
-         */
-        "messageAriaDescribedby"?: string;
-        /**
-          * Minimum number value The min attribute specifies the minimum value for an input element.
-         */
-        "min"?: number | string;
-        /**
-          * The name to pass to the input element.
-         */
-        "name"?: string;
-        /**
-          * The event used to track usage of the component. This is emitted when the input is blurred and enableAnalytics is true.
-         */
-        "onComponent-library-analytics"?: (event: VaNumberInputCustomEvent<any>) => void;
-        /**
-          * Set the input to required and render the (Required) text.
-         */
-        "required"?: boolean;
-        /**
-          * 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.
-         */
-        "useFormsPattern"?: string;
-        /**
-          * Whether or not the component will use USWDS v3 styling.
-         */
-        "uswds"?: boolean;
-        /**
-          * The value for the input.
-         */
-        "value"?: string;
-        /**
-          * 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).
-         */
-        "width"?: string;
-    }
+    /**
+     * @componentName Banner - Official Gov
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaOfficialGovBanner {
         /**
           * If `true`, the component-library-analytics event is disabled.
@@ -3034,6 +3636,11 @@ declare namespace LocalJSX {
          */
         "tld"?: string;
     }
+    /**
+     * @componentName OMB info
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaOmbInfo {
         /**
           * The name of the benefit displayed in the Respondent Burden section of the Privacy Act Statement.
@@ -3052,6 +3659,14 @@ declare namespace LocalJSX {
          */
         "resBurden"?: number;
     }
+    /**
+     * @componentName On this page
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaOnThisPage {
         /**
           * If true, analytics event will not be fired
@@ -3062,6 +3677,11 @@ declare namespace LocalJSX {
          */
         "onComponent-library-analytics"?: (event: VaOnThisPageCustomEvent<any>) => void;
     }
+    /**
+     * @componentName Pagination
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaPagination {
         /**
           * Aria-label suffix text for buttons
@@ -3100,6 +3720,11 @@ declare namespace LocalJSX {
          */
         "unbounded"?: boolean;
     }
+    /**
+     * @componentName Privacy agreement
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface VaPrivacyAgreement {
         /**
           * Whether the checkbox is checked or not.
@@ -3122,6 +3747,11 @@ declare namespace LocalJSX {
          */
         "showError"?: boolean;
     }
+    /**
+     * @componentName Process list
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaProcessList {
     }
     interface VaProcessListItem {
@@ -3146,6 +3776,11 @@ declare namespace LocalJSX {
          */
         "pending"?: boolean;
     }
+    /**
+     * @componentName Progress bar - activity
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaProgressBar {
         /**
           * Whether or not an analytics event will be fired.
@@ -3164,6 +3799,12 @@ declare namespace LocalJSX {
          */
         "percent": number;
     }
+    /**
+     * @componentName Banner - Promo
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref banner/promo
+     */
     interface VaPromoBanner {
         /**
           * Analytics tracking function(s) will not be called
@@ -3186,6 +3827,17 @@ declare namespace LocalJSX {
          */
         "type"?: 'announcement' | 'news' | 'email-signup';
     }
+    /**
+     * @keydown The event emitted when a key is pressed.
+     * @radioOptionSelected The event emitted when the selected option value changes.
+     * @componentName Radio button
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/radio-button
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaRadio {
         /**
           * Whether or not an analytics event will be fired.
@@ -3274,6 +3926,11 @@ declare namespace LocalJSX {
          */
         "value": string;
     }
+    /**
+     * @componentName Search input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaSearchInput {
         /**
           * If `true`, the component will use the big variant.
@@ -3308,6 +3965,12 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * @componentName Progress bar - segmented
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/progress-bar-segmented
+     */
     interface VaSegmentedProgressBar {
         /**
           * Whether or not to center the step labels
@@ -3358,6 +4021,15 @@ declare namespace LocalJSX {
          */
         "useDiv"?: boolean;
     }
+    /**
+     * @nativeHandler onKeyDown
+     * @componentName Select
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/select
+     * @translations English
+     * @translations Spanish
+     */
     interface VaSelect {
         /**
           * Whether or not to fire the analytics events
@@ -3412,6 +4084,11 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * @componentName Statement of truth
+     * @maturityCategory caution
+     * @maturityLevel candidate
+     */
     interface VaStatementOfTruth {
         /**
           * The error to be applied to the va-check-box element
@@ -3458,17 +4135,14 @@ declare namespace LocalJSX {
          */
         "onVaInputChange"?: (event: VaStatementOfTruthCustomEvent<any>) => void;
     }
+    /**
+     * @componentName Summary box
+     * @maturityCategory use
+     * @maturityLevel deployed
+     */
     interface VaSummaryBox {
     }
     interface VaTable {
-        /**
-          * Whether the initial sort state will be descending or not.
-         */
-        "descending"?: boolean;
-        /**
-          * The zero-based index of the column to sort by (Doesn't work in IE11). Optional.
-         */
-        "sortColumn"?: number;
         /**
           * Convert to a stacked table when screen size is small True by default, must specify if false if this is unwanted
          */
@@ -3481,25 +4155,18 @@ declare namespace LocalJSX {
           * If uswds is true, the type of table
          */
         "tableType"?: 'borderless';
-        /**
-          * Whether or not the component will use USWDS v3 styling.
-         */
-        "uswds"?: boolean;
     }
+    /**
+     * @componentName Table
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaTableInner {
         /**
-          * If uswds is true, the number of columns in the table
+          * The number of columns in the table
          */
         "cols"?: number;
-        /**
-          * Whether the initial sort state will be descending or not.
-         */
-        "descending"?: boolean;
         "rows"?: number;
-        /**
-          * The zero-based index of the column to sort by (Doesn't work in IE11). Optional.
-         */
-        "sortColumn"?: number;
         /**
           * If true convert to a stacked table when screen size is small
          */
@@ -3509,20 +4176,17 @@ declare namespace LocalJSX {
          */
         "tableTitle"?: string;
         /**
-          * If uswds is true, the type of table to be used
+          * The type of table to be used
          */
         "tableType"?: 'borderless';
-        /**
-          * Whether or not the component will use USWDS v3 styling.
-         */
-        "uswds"?: boolean;
-        /**
-          * A live reference to the va-table-rows in the table which are hard to access from this component
-         */
-        "vaTableRowRefs"?: any;
     }
     interface VaTableRow {
     }
+    /**
+     * @componentName Telephone
+     * @maturityCategory use
+     * @maturityLevel best_practice
+     */
     interface VaTelephone {
         /**
           * Numeric string representing the contact number. Typical length is 3 or 10 digits - SMS short codes will be 5 or 6 digits.
@@ -3561,6 +4225,17 @@ declare namespace LocalJSX {
          */
         "vanity"?: string;
     }
+    /**
+     * @nativeHandler onInput
+     * @nativeHandler onBlur
+     * @componentName Text input
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/text-input
+     * @translations English
+     * @translations Spanish
+     * @translations Tagalog
+     */
     interface VaTextInput {
         /**
           * Allows the browser to automatically complete the input.
@@ -3664,6 +4339,14 @@ declare namespace LocalJSX {
           * Set the input to required and render the (Required) text.
          */
         "required"?: boolean;
+        /**
+          * 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.
+         */
+        "showInputError"?: boolean;
+        /**
+          * 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)
+         */
+        "step"?: string;
         /**
           * Adds styling based on status value
          */
@@ -3685,6 +4368,16 @@ declare namespace LocalJSX {
          */
         "width"?: string;
     }
+    /**
+     * @nativeHandler onInput
+     * @nativeHandler onBlur
+     * @componentName Textarea
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref form/textarea
+     * @translations English
+     * @translations Spanish
+     */
     interface VaTextarea {
         /**
           * Whether the component should show a character count message. Has no effect without maxlength being set.
@@ -3785,7 +4478,6 @@ declare namespace LocalJSX {
         "va-modal": VaModal;
         "va-need-help": VaNeedHelp;
         "va-notification": VaNotification;
-        "va-number-input": VaNumberInput;
         "va-official-gov-banner": VaOfficialGovBanner;
         "va-omb-info": VaOmbInfo;
         "va-on-this-page": VaOnThisPage;
@@ -3814,57 +4506,341 @@ export { LocalJSX as JSX };
 declare module "@stencil/core" {
     export namespace JSX {
         interface IntrinsicElements {
+            /**
+             * @componentName Accordion
+             * @accordionItemToggled This event is fired when an accordion item is opened or closed
+             * @maturityCategory use
+             * @maturityLevel best_practice
+             * @translations English
+             * @translations Spanish
+             * @translations Tagalog
+             */
             "va-accordion": LocalJSX.VaAccordion & JSXBase.HTMLAttributes<HTMLVaAccordionElement>;
             "va-accordion-item": LocalJSX.VaAccordionItem & JSXBase.HTMLAttributes<HTMLVaAccordionItemElement>;
+            /**
+             * @componentName Additional info
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-additional-info": LocalJSX.VaAdditionalInfo & JSXBase.HTMLAttributes<HTMLVaAdditionalInfoElement>;
+            /**
+             * @componentName Alert
+             * @maturityCategory use
+             * @maturityLevel best_practice
+             */
             "va-alert": LocalJSX.VaAlert & JSXBase.HTMLAttributes<HTMLVaAlertElement>;
+            /**
+             * @componentName Alert - expandable
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-alert-expandable": LocalJSX.VaAlertExpandable & JSXBase.HTMLAttributes<HTMLVaAlertExpandableElement>;
+            /**
+             * @componentName Back to top
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-back-to-top": LocalJSX.VaBackToTop & JSXBase.HTMLAttributes<HTMLVaBackToTopElement>;
+            /**
+             * @componentName Banner
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-banner": LocalJSX.VaBanner & JSXBase.HTMLAttributes<HTMLVaBannerElement>;
+            /**
+             * @componentName Breadcrumbs
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-breadcrumbs": LocalJSX.VaBreadcrumbs & JSXBase.HTMLAttributes<HTMLVaBreadcrumbsElement>;
+            /**
+             * @componentName Button
+             * @nativeHandler onClick
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-button": LocalJSX.VaButton & JSXBase.HTMLAttributes<HTMLVaButtonElement>;
+            /**
+             * @componentName Button - Icon
+             * @nativeHandler onClick
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-button-icon": LocalJSX.VaButtonIcon & JSXBase.HTMLAttributes<HTMLVaButtonIconElement>;
+            /**
+             * @componentName Button pair
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             * @guidanceHref button/button-pair
+             */
             "va-button-pair": LocalJSX.VaButtonPair & JSXBase.HTMLAttributes<HTMLVaButtonPairElement>;
+            /**
+             * @componentName Card
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-card": LocalJSX.VaCard & JSXBase.HTMLAttributes<HTMLVaCardElement>;
+            /**
+             * @nativeHandler onBlur
+             * @componentName Checkbox
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref form/checkbox
+             * @translations English
+             * @translations Spanish
+             * @translations Tagalog
+             */
             "va-checkbox": LocalJSX.VaCheckbox & JSXBase.HTMLAttributes<HTMLVaCheckboxElement>;
+            /**
+             * @vaChange The event emitted when the input value changes.
+             * @componentName Checkbox group
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref form/checkbox
+             * @translations English
+             * @translations Spanish
+             * @translations Tagalog
+             */
             "va-checkbox-group": LocalJSX.VaCheckboxGroup & JSXBase.HTMLAttributes<HTMLVaCheckboxGroupElement>;
+            /**
+             * @componentName Crisis Line Modal
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-crisis-line-modal": LocalJSX.VaCrisisLineModal & JSXBase.HTMLAttributes<HTMLVaCrisisLineModalElement>;
+            /**
+             * @componentName Date input
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref form/date-input
+             */
             "va-date": LocalJSX.VaDate & JSXBase.HTMLAttributes<HTMLVaDateElement>;
+            /**
+             * @componentName File input
+             * @maturityCategory caution
+             * @maturityLevel available
+             * @guidanceHref form/file-input
+             */
             "va-file-input": LocalJSX.VaFileInput & JSXBase.HTMLAttributes<HTMLVaFileInputElement>;
+            /**
+             * A component that manages multiple file inputs, allowing users to upload several files.
+             * It supports adding, changing, and removing files with dynamic error handling.
+             * @componentName File input multiple
+             * @maturityCategory caution
+             * @maturityLevel available
+             * @guidanceHref form/file-input-multiple
+             */
             "va-file-input-multiple": LocalJSX.VaFileInputMultiple & JSXBase.HTMLAttributes<HTMLVaFileInputMultipleElement>;
+            /**
+             * @componentName Header - Minimal
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             * @guidanceHref header/header-minimal
+             */
             "va-header-minimal": LocalJSX.VaHeaderMinimal & JSXBase.HTMLAttributes<HTMLVaHeaderMinimalElement>;
+            /**
+             * @componentName Icon
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-icon": LocalJSX.VaIcon & JSXBase.HTMLAttributes<HTMLVaIconElement>;
+            /**
+             * @componentName Link
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-link": LocalJSX.VaLink & JSXBase.HTMLAttributes<HTMLVaLinkElement>;
+            /**
+             * @componentName Link - Action
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-link-action": LocalJSX.VaLinkAction & JSXBase.HTMLAttributes<HTMLVaLinkActionElement>;
+            /**
+             * @componentName Loading indicator
+             * @maturityCategory use
+             * @maturityLevel best_practice
+             */
             "va-loading-indicator": LocalJSX.VaLoadingIndicator & JSXBase.HTMLAttributes<HTMLVaLoadingIndicatorElement>;
+            /**
+             * @componentName Banner - Maintenance
+             * @maturityCategory caution
+             * @maturityLevel available
+             */
             "va-maintenance-banner": LocalJSX.VaMaintenanceBanner & JSXBase.HTMLAttributes<HTMLVaMaintenanceBannerElement>;
+            /**
+             * @componentName Memorable date
+             * @maturityCategory caution
+             * @maturityLevel available
+             * @guidanceHref form/memorable-date
+             * @translations English
+             * @translations Spanish
+             */
             "va-memorable-date": LocalJSX.VaMemorableDate & JSXBase.HTMLAttributes<HTMLVaMemorableDateElement>;
+            /**
+             * @componentName Minimal Footer
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-minimal-footer": LocalJSX.VaMinimalFooter & JSXBase.HTMLAttributes<HTMLVaMinimalFooterElement>;
+            /**
+             * @click Used to detect clicks outside of modal contents to close modal.
+             * @keydown Used to detect Escape key to close modal.
+             * @componentName Modal
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-modal": LocalJSX.VaModal & JSXBase.HTMLAttributes<HTMLVaModalElement>;
+            /**
+             * @componentName Need help?
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             * @guidanceHref form/need-help
+             */
             "va-need-help": LocalJSX.VaNeedHelp & JSXBase.HTMLAttributes<HTMLVaNeedHelpElement>;
+            /**
+             * @componentName Notification
+             * @maturityCategory dont_use
+             * @maturityLevel deprecated
+             */
             "va-notification": LocalJSX.VaNotification & JSXBase.HTMLAttributes<HTMLVaNotificationElement>;
-            "va-number-input": LocalJSX.VaNumberInput & JSXBase.HTMLAttributes<HTMLVaNumberInputElement>;
+            /**
+             * @componentName Banner - Official Gov
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-official-gov-banner": LocalJSX.VaOfficialGovBanner & JSXBase.HTMLAttributes<HTMLVaOfficialGovBannerElement>;
+            /**
+             * @componentName OMB info
+             * @maturityCategory use
+             * @maturityLevel best_practice
+             */
             "va-omb-info": LocalJSX.VaOmbInfo & JSXBase.HTMLAttributes<HTMLVaOmbInfoElement>;
+            /**
+             * @componentName On this page
+             * @maturityCategory use
+             * @maturityLevel best_practice
+             * @translations English
+             * @translations Spanish
+             * @translations Tagalog
+             */
             "va-on-this-page": LocalJSX.VaOnThisPage & JSXBase.HTMLAttributes<HTMLVaOnThisPageElement>;
+            /**
+             * @componentName Pagination
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-pagination": LocalJSX.VaPagination & JSXBase.HTMLAttributes<HTMLVaPaginationElement>;
+            /**
+             * @componentName Privacy agreement
+             * @maturityCategory caution
+             * @maturityLevel available
+             */
             "va-privacy-agreement": LocalJSX.VaPrivacyAgreement & JSXBase.HTMLAttributes<HTMLVaPrivacyAgreementElement>;
+            /**
+             * @componentName Process list
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-process-list": LocalJSX.VaProcessList & JSXBase.HTMLAttributes<HTMLVaProcessListElement>;
             "va-process-list-item": LocalJSX.VaProcessListItem & JSXBase.HTMLAttributes<HTMLVaProcessListItemElement>;
+            /**
+             * @componentName Progress bar - activity
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-progress-bar": LocalJSX.VaProgressBar & JSXBase.HTMLAttributes<HTMLVaProgressBarElement>;
+            /**
+             * @componentName Banner - Promo
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref banner/promo
+             */
             "va-promo-banner": LocalJSX.VaPromoBanner & JSXBase.HTMLAttributes<HTMLVaPromoBannerElement>;
+            /**
+             * @keydown The event emitted when a key is pressed.
+             * @radioOptionSelected The event emitted when the selected option value changes.
+             * @componentName Radio button
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref form/radio-button
+             * @translations English
+             * @translations Spanish
+             * @translations Tagalog
+             */
             "va-radio": LocalJSX.VaRadio & JSXBase.HTMLAttributes<HTMLVaRadioElement>;
             "va-radio-option": LocalJSX.VaRadioOption & JSXBase.HTMLAttributes<HTMLVaRadioOptionElement>;
+            /**
+             * @componentName Search input
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-search-input": LocalJSX.VaSearchInput & JSXBase.HTMLAttributes<HTMLVaSearchInputElement>;
+            /**
+             * @componentName Progress bar - segmented
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref form/progress-bar-segmented
+             */
             "va-segmented-progress-bar": LocalJSX.VaSegmentedProgressBar & JSXBase.HTMLAttributes<HTMLVaSegmentedProgressBarElement>;
+            /**
+             * @nativeHandler onKeyDown
+             * @componentName Select
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref form/select
+             * @translations English
+             * @translations Spanish
+             */
             "va-select": LocalJSX.VaSelect & JSXBase.HTMLAttributes<HTMLVaSelectElement>;
+            /**
+             * @componentName Statement of truth
+             * @maturityCategory caution
+             * @maturityLevel candidate
+             */
             "va-statement-of-truth": LocalJSX.VaStatementOfTruth & JSXBase.HTMLAttributes<HTMLVaStatementOfTruthElement>;
+            /**
+             * @componentName Summary box
+             * @maturityCategory use
+             * @maturityLevel deployed
+             */
             "va-summary-box": LocalJSX.VaSummaryBox & JSXBase.HTMLAttributes<HTMLVaSummaryBoxElement>;
             "va-table": LocalJSX.VaTable & JSXBase.HTMLAttributes<HTMLVaTableElement>;
+            /**
+             * @componentName Table
+             * @maturityCategory use
+             * @maturityLevel best_practice
+             */
             "va-table-inner": LocalJSX.VaTableInner & JSXBase.HTMLAttributes<HTMLVaTableInnerElement>;
             "va-table-row": LocalJSX.VaTableRow & JSXBase.HTMLAttributes<HTMLVaTableRowElement>;
+            /**
+             * @componentName Telephone
+             * @maturityCategory use
+             * @maturityLevel best_practice
+             */
             "va-telephone": LocalJSX.VaTelephone & JSXBase.HTMLAttributes<HTMLVaTelephoneElement>;
+            /**
+             * @nativeHandler onInput
+             * @nativeHandler onBlur
+             * @componentName Text input
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref form/text-input
+             * @translations English
+             * @translations Spanish
+             * @translations Tagalog
+             */
             "va-text-input": LocalJSX.VaTextInput & JSXBase.HTMLAttributes<HTMLVaTextInputElement>;
+            /**
+             * @nativeHandler onInput
+             * @nativeHandler onBlur
+             * @componentName Textarea
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref form/textarea
+             * @translations English
+             * @translations Spanish
+             */
             "va-textarea": LocalJSX.VaTextarea & JSXBase.HTMLAttributes<HTMLVaTextareaElement>;
         }
     }