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

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

@@ -60,7 +60,7 @@ export namespace Components {
     /**
      * @componentName Additional info
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaAdditionalInfo {
         /**
@@ -118,8 +118,8 @@ export namespace Components {
     /**
      * @componentName Alert - expandable
      * @guidanceHref alert/alert-expandable
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaAlertExpandable {
         /**
@@ -243,8 +243,8 @@ export namespace Components {
     /**
      * @componentName Button
      * @nativeHandler onClick
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaButton {
         /**
@@ -267,6 +267,10 @@ export namespace Components {
           * If `true`, the click event will not fire.
          */
         "disabled"?: boolean;
+        /**
+          * If `true`, the button will expand to the full available width of its container.
+         */
+        "fullWidth"?: boolean;
         /**
           * The aria-label of the component.
          */
@@ -300,7 +304,7 @@ export namespace Components {
      * @componentName Button - Icon
      * @nativeHandler onClick
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaButtonIcon {
         "buttonType": keyof typeof this.buttonTypeMap;
@@ -315,8 +319,8 @@ export namespace Components {
     }
     /**
      * @componentName Button pair
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref button/button-pair
      */
     interface VaButtonPair {
@@ -355,8 +359,8 @@ export namespace Components {
     }
     /**
      * @componentName Card
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaCard {
         /**
@@ -533,7 +537,7 @@ export namespace Components {
     /**
      * @componentName Crisis Line Modal
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaCrisisLineModal {
     }
@@ -631,6 +635,10 @@ export namespace Components {
           * The name for the input element.
          */
         "name"?: string;
+        /**
+          * Percent upload completed. For use with va-progress-bar component
+         */
+        "percentUploaded"?: number;
         /**
           * Optionally displays the read-only view
          */
@@ -713,7 +721,7 @@ export namespace Components {
     /**
      * @componentName Header - Minimal
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      * @guidanceHref header/header-minimal
      */
     interface VaHeaderMinimal {
@@ -727,7 +735,7 @@ export namespace Components {
     /**
      * @componentName Icon
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaIcon {
         /**
@@ -746,7 +754,7 @@ export namespace Components {
     /**
      * @componentName Language Toggle
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaLanguageToggle {
         /**
@@ -772,8 +780,8 @@ export namespace Components {
     }
     /**
      * @componentName Link
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaLink {
         /**
@@ -855,8 +863,10 @@ export namespace Components {
     }
     /**
      * @componentName Link - Action
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref link/action
+     * @guidanceName Action link
      */
     interface VaLinkAction {
         /**
@@ -887,7 +897,7 @@ export namespace Components {
     /**
      * @componentName Loading indicator
      * @maturityCategory use
-     * @maturityLevel best_practice
+     * @maturityLevel deployed
      */
     interface VaLoadingIndicator {
         /**
@@ -909,8 +919,8 @@ export namespace Components {
     }
     /**
      * @componentName Banner - Maintenance
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaMaintenanceBanner {
         /**
@@ -948,8 +958,8 @@ export namespace Components {
     }
     /**
      * @componentName Memorable date
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref form/memorable-date
      * @translations English
      * @translations Spanish
@@ -1018,7 +1028,7 @@ export namespace Components {
     /**
      * @componentName Minimal Footer
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaMinimalFooter {
     }
@@ -1027,7 +1037,7 @@ export namespace Components {
      * @keydown Used to detect Escape key to close modal.
      * @componentName Modal
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaModal {
         /**
@@ -1078,8 +1088,8 @@ export namespace Components {
     }
     /**
      * @componentName Need help?
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref form/need-help
      */
     interface VaNeedHelp {
@@ -1141,8 +1151,8 @@ export namespace Components {
     }
     /**
      * @componentName Banner - Official Gov
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel best_practice
      */
     interface VaOfficialGovBanner {
         /**
@@ -1228,8 +1238,8 @@ export namespace Components {
     }
     /**
      * @componentName Privacy agreement
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaPrivacyAgreement {
         /**
@@ -1248,7 +1258,7 @@ export namespace Components {
     /**
      * @componentName Process list
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaProcessList {
     }
@@ -1281,7 +1291,7 @@ export namespace Components {
     /**
      * @componentName Progress bar - activity
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaProgressBar {
         /**
@@ -1322,7 +1332,7 @@ export namespace Components {
      * @radioOptionSelected The event emitted when the selected option value changes.
      * @componentName Radio button
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/radio-button
      * @translations English
      * @translations Spanish
@@ -1411,7 +1421,7 @@ export namespace Components {
     /**
      * @componentName Search input
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaSearchInput {
         /**
@@ -1499,7 +1509,7 @@ export namespace Components {
      * @nativeHandler onKeyDown
      * @componentName Select
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/select
      * @translations English
      * @translations Spanish
@@ -1513,6 +1523,18 @@ export namespace Components {
           * Error message to display. When defined, this indicates an error.
          */
         "error"?: string;
+        /**
+          * The content of the heading if `useFormsPattern` is true.
+         */
+        "formHeading"?: string;
+        /**
+          * The heading level for the heading if `useFormsPattern` is true.
+         */
+        "formHeadingLevel"?: number;
+        /**
+          * If true, sets the select to take the full-width of its container
+         */
+        "fullWidth"?: boolean;
         /**
           * Optional hint text.
          */
@@ -1545,12 +1567,16 @@ export namespace Components {
           * Whether an error message should be shown - set to false when this component is used inside va-date or va-memorable-date in which the error for the va-select will be rendered outside of va-select
          */
         "showError"?: 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
+         */
+        "useFormsPattern"?: string;
         /**
           * Selected value (will get updated on select).
          */
         "value"?: string;
         /**
-          * Displays the select at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex).
+          * Displays the select at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex). Defined in USWDS here: https://github.com/uswds/uswds/blob/develop/packages/uswds-core/src/styles/tokens/units/input-widths.scss
          */
         "width"?: string;
     }
@@ -1595,8 +1621,8 @@ export namespace Components {
     }
     /**
      * @componentName Statement of truth
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaStatementOfTruth {
         /**
@@ -1639,6 +1665,11 @@ export namespace Components {
      */
     interface VaSummaryBox {
     }
+    /**
+     * @componentName Table
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface VaTable {
         /**
           * When active, forces the table to expand to the full-width of its container
@@ -1767,7 +1798,7 @@ export namespace Components {
      * @nativeHandler onBlur
      * @componentName Text input
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/text-input
      * @translations English
      * @translations Spanish
@@ -1906,7 +1937,7 @@ export namespace Components {
      * @nativeHandler onBlur
      * @componentName Textarea
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/textarea
      * @translations English
      * @translations Spanish
@@ -2189,7 +2220,7 @@ declare global {
     /**
      * @componentName Additional info
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface HTMLVaAdditionalInfoElement extends Components.VaAdditionalInfo, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaAdditionalInfoElementEventMap>(type: K, listener: (this: HTMLVaAdditionalInfoElement, ev: VaAdditionalInfoCustomEvent<HTMLVaAdditionalInfoElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2235,8 +2266,8 @@ declare global {
     /**
      * @componentName Alert - expandable
      * @guidanceHref alert/alert-expandable
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface HTMLVaAlertExpandableElement extends Components.VaAlertExpandable, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaAlertExpandableElementEventMap>(type: K, listener: (this: HTMLVaAlertExpandableElement, ev: VaAlertExpandableCustomEvent<HTMLVaAlertExpandableElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2326,8 +2357,8 @@ declare global {
     /**
      * @componentName Button
      * @nativeHandler onClick
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface HTMLVaButtonElement extends Components.VaButton, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaButtonElementEventMap>(type: K, listener: (this: HTMLVaButtonElement, ev: VaButtonCustomEvent<HTMLVaButtonElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2350,7 +2381,7 @@ declare global {
      * @componentName Button - Icon
      * @nativeHandler onClick
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface HTMLVaButtonIconElement extends Components.VaButtonIcon, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaButtonIconElementEventMap>(type: K, listener: (this: HTMLVaButtonIconElement, ev: VaButtonIconCustomEvent<HTMLVaButtonIconElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2373,8 +2404,8 @@ declare global {
     }
     /**
      * @componentName Button pair
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref button/button-pair
      */
     interface HTMLVaButtonPairElement extends Components.VaButtonPair, HTMLStencilElement {
@@ -2393,8 +2424,8 @@ declare global {
     };
     /**
      * @componentName Card
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface HTMLVaCardElement extends Components.VaCard, HTMLStencilElement {
     }
@@ -2485,7 +2516,7 @@ declare global {
     /**
      * @componentName Crisis Line Modal
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface HTMLVaCrisisLineModalElement extends Components.VaCrisisLineModal, HTMLStencilElement {
     }
@@ -2570,7 +2601,7 @@ declare global {
     /**
      * @componentName Header - Minimal
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      * @guidanceHref header/header-minimal
      */
     interface HTMLVaHeaderMinimalElement extends Components.VaHeaderMinimal, HTMLStencilElement {
@@ -2582,7 +2613,7 @@ declare global {
     /**
      * @componentName Icon
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface HTMLVaIconElement extends Components.VaIcon, HTMLStencilElement {
     }
@@ -2597,7 +2628,7 @@ declare global {
     /**
      * @componentName Language Toggle
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface HTMLVaLanguageToggleElement extends Components.VaLanguageToggle, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaLanguageToggleElementEventMap>(type: K, listener: (this: HTMLVaLanguageToggleElement, ev: VaLanguageToggleCustomEvent<HTMLVaLanguageToggleElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2618,8 +2649,8 @@ declare global {
     }
     /**
      * @componentName Link
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface HTMLVaLinkElement extends Components.VaLink, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaLinkElementEventMap>(type: K, listener: (this: HTMLVaLinkElement, ev: VaLinkCustomEvent<HTMLVaLinkElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2640,8 +2671,10 @@ declare global {
     }
     /**
      * @componentName Link - Action
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref link/action
+     * @guidanceName Action link
      */
     interface HTMLVaLinkActionElement extends Components.VaLinkAction, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaLinkActionElementEventMap>(type: K, listener: (this: HTMLVaLinkActionElement, ev: VaLinkActionCustomEvent<HTMLVaLinkActionElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2663,7 +2696,7 @@ declare global {
     /**
      * @componentName Loading indicator
      * @maturityCategory use
-     * @maturityLevel best_practice
+     * @maturityLevel deployed
      */
     interface HTMLVaLoadingIndicatorElement extends Components.VaLoadingIndicator, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaLoadingIndicatorElementEventMap>(type: K, listener: (this: HTMLVaLoadingIndicatorElement, ev: VaLoadingIndicatorCustomEvent<HTMLVaLoadingIndicatorElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2685,8 +2718,8 @@ declare global {
     }
     /**
      * @componentName Banner - Maintenance
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface HTMLVaMaintenanceBannerElement extends Components.VaMaintenanceBanner, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaMaintenanceBannerElementEventMap>(type: K, listener: (this: HTMLVaMaintenanceBannerElement, ev: VaMaintenanceBannerCustomEvent<HTMLVaMaintenanceBannerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2709,8 +2742,8 @@ declare global {
     }
     /**
      * @componentName Memorable date
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref form/memorable-date
      * @translations English
      * @translations Spanish
@@ -2732,7 +2765,7 @@ declare global {
     /**
      * @componentName Minimal Footer
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface HTMLVaMinimalFooterElement extends Components.VaMinimalFooter, HTMLStencilElement {
     }
@@ -2751,7 +2784,7 @@ declare global {
      * @keydown Used to detect Escape key to close modal.
      * @componentName Modal
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface HTMLVaModalElement extends Components.VaModal, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaModalElementEventMap>(type: K, listener: (this: HTMLVaModalElement, ev: VaModalCustomEvent<HTMLVaModalElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2769,8 +2802,8 @@ declare global {
     };
     /**
      * @componentName Need help?
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref form/need-help
      */
     interface HTMLVaNeedHelpElement extends Components.VaNeedHelp, HTMLStencilElement {
@@ -2807,8 +2840,8 @@ declare global {
     }
     /**
      * @componentName Banner - Official Gov
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel best_practice
      */
     interface HTMLVaOfficialGovBannerElement extends Components.VaOfficialGovBanner, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaOfficialGovBannerElementEventMap>(type: K, listener: (this: HTMLVaOfficialGovBannerElement, ev: VaOfficialGovBannerCustomEvent<HTMLVaOfficialGovBannerElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2889,8 +2922,8 @@ declare global {
     }
     /**
      * @componentName Privacy agreement
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface HTMLVaPrivacyAgreementElement extends Components.VaPrivacyAgreement, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaPrivacyAgreementElementEventMap>(type: K, listener: (this: HTMLVaPrivacyAgreementElement, ev: VaPrivacyAgreementCustomEvent<HTMLVaPrivacyAgreementElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2909,7 +2942,7 @@ declare global {
     /**
      * @componentName Process list
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface HTMLVaProcessListElement extends Components.VaProcessList, HTMLStencilElement {
     }
@@ -2929,7 +2962,7 @@ declare global {
     /**
      * @componentName Progress bar - activity
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface HTMLVaProgressBarElement extends Components.VaProgressBar, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaProgressBarElementEventMap>(type: K, listener: (this: HTMLVaProgressBarElement, ev: VaProgressBarCustomEvent<HTMLVaProgressBarElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -2978,7 +3011,7 @@ declare global {
      * @radioOptionSelected The event emitted when the selected option value changes.
      * @componentName Radio button
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/radio-button
      * @translations English
      * @translations Spanish
@@ -3021,7 +3054,7 @@ declare global {
     /**
      * @componentName Search input
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface HTMLVaSearchInputElement extends Components.VaSearchInput, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaSearchInputElementEventMap>(type: K, listener: (this: HTMLVaSearchInputElement, ev: VaSearchInputCustomEvent<HTMLVaSearchInputElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -3070,7 +3103,7 @@ declare global {
      * @nativeHandler onKeyDown
      * @componentName Select
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/select
      * @translations English
      * @translations Spanish
@@ -3107,8 +3140,8 @@ declare global {
     }
     /**
      * @componentName Statement of truth
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface HTMLVaStatementOfTruthElement extends Components.VaStatementOfTruth, HTMLStencilElement {
         addEventListener<K extends keyof HTMLVaStatementOfTruthElementEventMap>(type: K, listener: (this: HTMLVaStatementOfTruthElement, ev: VaStatementOfTruthCustomEvent<HTMLVaStatementOfTruthElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -3135,6 +3168,11 @@ declare global {
         prototype: HTMLVaSummaryBoxElement;
         new (): HTMLVaSummaryBoxElement;
     };
+    /**
+     * @componentName Table
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface HTMLVaTableElement extends Components.VaTable, HTMLStencilElement {
     }
     var HTMLVaTableElement: {
@@ -3199,7 +3237,7 @@ declare global {
      * @nativeHandler onBlur
      * @componentName Text input
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/text-input
      * @translations English
      * @translations Spanish
@@ -3227,7 +3265,7 @@ declare global {
      * @nativeHandler onBlur
      * @componentName Textarea
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/textarea
      * @translations English
      * @translations Spanish
@@ -3365,7 +3403,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Additional info
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaAdditionalInfo {
         /**
@@ -3439,8 +3477,8 @@ declare namespace LocalJSX {
     /**
      * @componentName Alert - expandable
      * @guidanceHref alert/alert-expandable
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaAlertExpandable {
         /**
@@ -3580,8 +3618,8 @@ declare namespace LocalJSX {
     /**
      * @componentName Button
      * @nativeHandler onClick
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaButton {
         /**
@@ -3604,6 +3642,10 @@ declare namespace LocalJSX {
           * If `true`, the click event will not fire.
          */
         "disabled"?: boolean;
+        /**
+          * If `true`, the button will expand to the full available width of its container.
+         */
+        "fullWidth"?: boolean;
         /**
           * The aria-label of the component.
          */
@@ -3641,7 +3683,7 @@ declare namespace LocalJSX {
      * @componentName Button - Icon
      * @nativeHandler onClick
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaButtonIcon {
         "buttonType"?: keyof typeof this.buttonTypeMap;
@@ -3660,8 +3702,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Button pair
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref button/button-pair
      */
     interface VaButtonPair {
@@ -3712,8 +3754,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Card
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaCard {
         /**
@@ -3906,7 +3948,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Crisis Line Modal
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaCrisisLineModal {
     }
@@ -4024,6 +4066,10 @@ declare namespace LocalJSX {
           * The event emitted when the file input value changes.
          */
         "onVaChange"?: (event: VaFileInputCustomEvent<any>) => void;
+        /**
+          * Percent upload completed. For use with va-progress-bar component
+         */
+        "percentUploaded"?: number;
         /**
           * Optionally displays the read-only view
          */
@@ -4110,7 +4156,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Header - Minimal
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      * @guidanceHref header/header-minimal
      */
     interface VaHeaderMinimal {
@@ -4124,7 +4170,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Icon
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaIcon {
         /**
@@ -4143,7 +4189,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Language Toggle
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaLanguageToggle {
         /**
@@ -4177,8 +4223,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Link
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaLink {
         /**
@@ -4261,8 +4307,10 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Link - Action
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
+     * @guidanceHref link/action
+     * @guidanceName Action link
      */
     interface VaLinkAction {
         /**
@@ -4297,7 +4345,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Loading indicator
      * @maturityCategory use
-     * @maturityLevel best_practice
+     * @maturityLevel deployed
      */
     interface VaLoadingIndicator {
         /**
@@ -4323,8 +4371,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Banner - Maintenance
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaMaintenanceBanner {
         /**
@@ -4370,8 +4418,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Memorable date
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref form/memorable-date
      * @translations English
      * @translations Spanish
@@ -4452,7 +4500,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Minimal Footer
      * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityLevel available
      */
     interface VaMinimalFooter {
     }
@@ -4461,7 +4509,7 @@ declare namespace LocalJSX {
      * @keydown Used to detect Escape key to close modal.
      * @componentName Modal
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaModal {
         /**
@@ -4528,8 +4576,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Need help?
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      * @guidanceHref form/need-help
      */
     interface VaNeedHelp {
@@ -4599,8 +4647,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Banner - Official Gov
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel best_practice
      */
     interface VaOfficialGovBanner {
         /**
@@ -4702,8 +4750,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Privacy agreement
-     * @maturityCategory caution
-     * @maturityLevel available
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaPrivacyAgreement {
         /**
@@ -4730,7 +4778,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Process list
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaProcessList {
     }
@@ -4763,7 +4811,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Progress bar - activity
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaProgressBar {
         /**
@@ -4816,7 +4864,7 @@ declare namespace LocalJSX {
      * @radioOptionSelected The event emitted when the selected option value changes.
      * @componentName Radio button
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/radio-button
      * @translations English
      * @translations Spanish
@@ -4917,7 +4965,7 @@ declare namespace LocalJSX {
     /**
      * @componentName Search input
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      */
     interface VaSearchInput {
         /**
@@ -5013,7 +5061,7 @@ declare namespace LocalJSX {
      * @nativeHandler onKeyDown
      * @componentName Select
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/select
      * @translations English
      * @translations Spanish
@@ -5027,6 +5075,18 @@ declare namespace LocalJSX {
           * Error message to display. When defined, this indicates an error.
          */
         "error"?: string;
+        /**
+          * The content of the heading if `useFormsPattern` is true.
+         */
+        "formHeading"?: string;
+        /**
+          * The heading level for the heading if `useFormsPattern` is true.
+         */
+        "formHeadingLevel"?: number;
+        /**
+          * If true, sets the select to take the full-width of its container
+         */
+        "fullWidth"?: boolean;
         /**
           * Optional hint text.
          */
@@ -5075,12 +5135,16 @@ declare namespace LocalJSX {
           * Whether an error message should be shown - set to false when this component is used inside va-date or va-memorable-date in which the error for the va-select will be rendered outside of va-select
          */
         "showError"?: 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
+         */
+        "useFormsPattern"?: string;
         /**
           * Selected value (will get updated on select).
          */
         "value"?: string;
         /**
-          * Displays the select at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex).
+          * Displays the select at a specific width. Accepts 2xs (4ex), xs (7ex), sm or small (10ex), md or medium (20ex), lg (30ex), xl (40ex), and 2xl (50ex). Defined in USWDS here: https://github.com/uswds/uswds/blob/develop/packages/uswds-core/src/styles/tokens/units/input-widths.scss
          */
         "width"?: string;
     }
@@ -5125,8 +5189,8 @@ declare namespace LocalJSX {
     }
     /**
      * @componentName Statement of truth
-     * @maturityCategory caution
-     * @maturityLevel candidate
+     * @maturityCategory use
+     * @maturityLevel deployed
      */
     interface VaStatementOfTruth {
         /**
@@ -5181,6 +5245,11 @@ declare namespace LocalJSX {
      */
     interface VaSummaryBox {
     }
+    /**
+     * @componentName Table
+     * @maturityCategory caution
+     * @maturityLevel available
+     */
     interface VaTable {
         /**
           * When active, forces the table to expand to the full-width of its container
@@ -5317,7 +5386,7 @@ declare namespace LocalJSX {
      * @nativeHandler onBlur
      * @componentName Text input
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/text-input
      * @translations English
      * @translations Spanish
@@ -5460,7 +5529,7 @@ declare namespace LocalJSX {
      * @nativeHandler onBlur
      * @componentName Textarea
      * @maturityCategory use
-     * @maturityLevel deployed
+     * @maturityLevel best_practice
      * @guidanceHref form/textarea
      * @translations English
      * @translations Spanish
@@ -5611,7 +5680,7 @@ declare module "@stencil/core" {
             /**
              * @componentName Additional info
              * @maturityCategory use
-             * @maturityLevel deployed
+             * @maturityLevel best_practice
              */
             "va-additional-info": LocalJSX.VaAdditionalInfo & JSXBase.HTMLAttributes<HTMLVaAdditionalInfoElement>;
             /**
@@ -5623,8 +5692,8 @@ declare module "@stencil/core" {
             /**
              * @componentName Alert - expandable
              * @guidanceHref alert/alert-expandable
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel deployed
              */
             "va-alert-expandable": LocalJSX.VaAlertExpandable & JSXBase.HTMLAttributes<HTMLVaAlertExpandableElement>;
             /**
@@ -5655,28 +5724,28 @@ declare module "@stencil/core" {
             /**
              * @componentName Button
              * @nativeHandler onClick
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel deployed
              */
             "va-button": LocalJSX.VaButton & JSXBase.HTMLAttributes<HTMLVaButtonElement>;
             /**
              * @componentName Button - Icon
              * @nativeHandler onClick
              * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityLevel available
              */
             "va-button-icon": LocalJSX.VaButtonIcon & JSXBase.HTMLAttributes<HTMLVaButtonIconElement>;
             /**
              * @componentName Button pair
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel deployed
              * @guidanceHref button/button-pair
              */
             "va-button-pair": LocalJSX.VaButtonPair & JSXBase.HTMLAttributes<HTMLVaButtonPairElement>;
             /**
              * @componentName Card
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel deployed
              */
             "va-card": LocalJSX.VaCard & JSXBase.HTMLAttributes<HTMLVaCardElement>;
             /**
@@ -5713,7 +5782,7 @@ declare module "@stencil/core" {
             /**
              * @componentName Crisis Line Modal
              * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityLevel available
              */
             "va-crisis-line-modal": LocalJSX.VaCrisisLineModal & JSXBase.HTMLAttributes<HTMLVaCrisisLineModalElement>;
             /**
@@ -5742,50 +5811,52 @@ declare module "@stencil/core" {
             /**
              * @componentName Header - Minimal
              * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityLevel available
              * @guidanceHref header/header-minimal
              */
             "va-header-minimal": LocalJSX.VaHeaderMinimal & JSXBase.HTMLAttributes<HTMLVaHeaderMinimalElement>;
             /**
              * @componentName Icon
              * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityLevel available
              */
             "va-icon": LocalJSX.VaIcon & JSXBase.HTMLAttributes<HTMLVaIconElement>;
             /**
              * @componentName Language Toggle
              * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityLevel available
              */
             "va-language-toggle": LocalJSX.VaLanguageToggle & JSXBase.HTMLAttributes<HTMLVaLanguageToggleElement>;
             /**
              * @componentName Link
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel deployed
              */
             "va-link": LocalJSX.VaLink & JSXBase.HTMLAttributes<HTMLVaLinkElement>;
             /**
              * @componentName Link - Action
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel deployed
+             * @guidanceHref link/action
+             * @guidanceName Action link
              */
             "va-link-action": LocalJSX.VaLinkAction & JSXBase.HTMLAttributes<HTMLVaLinkActionElement>;
             /**
              * @componentName Loading indicator
              * @maturityCategory use
-             * @maturityLevel best_practice
+             * @maturityLevel deployed
              */
             "va-loading-indicator": LocalJSX.VaLoadingIndicator & JSXBase.HTMLAttributes<HTMLVaLoadingIndicatorElement>;
             /**
              * @componentName Banner - Maintenance
-             * @maturityCategory caution
-             * @maturityLevel available
+             * @maturityCategory use
+             * @maturityLevel deployed
              */
             "va-maintenance-banner": LocalJSX.VaMaintenanceBanner & JSXBase.HTMLAttributes<HTMLVaMaintenanceBannerElement>;
             /**
              * @componentName Memorable date
-             * @maturityCategory caution
-             * @maturityLevel available
+             * @maturityCategory use
+             * @maturityLevel deployed
              * @guidanceHref form/memorable-date
              * @translations English
              * @translations Spanish
@@ -5794,7 +5865,7 @@ declare module "@stencil/core" {
             /**
              * @componentName Minimal Footer
              * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityLevel available
              */
             "va-minimal-footer": LocalJSX.VaMinimalFooter & JSXBase.HTMLAttributes<HTMLVaMinimalFooterElement>;
             /**
@@ -5802,13 +5873,13 @@ declare module "@stencil/core" {
              * @keydown Used to detect Escape key to close modal.
              * @componentName Modal
              * @maturityCategory use
-             * @maturityLevel deployed
+             * @maturityLevel best_practice
              */
             "va-modal": LocalJSX.VaModal & JSXBase.HTMLAttributes<HTMLVaModalElement>;
             /**
              * @componentName Need help?
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel deployed
              * @guidanceHref form/need-help
              */
             "va-need-help": LocalJSX.VaNeedHelp & JSXBase.HTMLAttributes<HTMLVaNeedHelpElement>;
@@ -5820,8 +5891,8 @@ declare module "@stencil/core" {
             "va-notification": LocalJSX.VaNotification & JSXBase.HTMLAttributes<HTMLVaNotificationElement>;
             /**
              * @componentName Banner - Official Gov
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel best_practice
              */
             "va-official-gov-banner": LocalJSX.VaOfficialGovBanner & JSXBase.HTMLAttributes<HTMLVaOfficialGovBannerElement>;
             /**
@@ -5847,21 +5918,21 @@ declare module "@stencil/core" {
             "va-pagination": LocalJSX.VaPagination & JSXBase.HTMLAttributes<HTMLVaPaginationElement>;
             /**
              * @componentName Privacy agreement
-             * @maturityCategory caution
-             * @maturityLevel available
+             * @maturityCategory use
+             * @maturityLevel deployed
              */
             "va-privacy-agreement": LocalJSX.VaPrivacyAgreement & JSXBase.HTMLAttributes<HTMLVaPrivacyAgreementElement>;
             /**
              * @componentName Process list
              * @maturityCategory use
-             * @maturityLevel deployed
+             * @maturityLevel best_practice
              */
             "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
+             * @maturityLevel best_practice
              */
             "va-progress-bar": LocalJSX.VaProgressBar & JSXBase.HTMLAttributes<HTMLVaProgressBarElement>;
             /**
@@ -5876,7 +5947,7 @@ declare module "@stencil/core" {
              * @radioOptionSelected The event emitted when the selected option value changes.
              * @componentName Radio button
              * @maturityCategory use
-             * @maturityLevel deployed
+             * @maturityLevel best_practice
              * @guidanceHref form/radio-button
              * @translations English
              * @translations Spanish
@@ -5887,7 +5958,7 @@ declare module "@stencil/core" {
             /**
              * @componentName Search input
              * @maturityCategory use
-             * @maturityLevel deployed
+             * @maturityLevel best_practice
              */
             "va-search-input": LocalJSX.VaSearchInput & JSXBase.HTMLAttributes<HTMLVaSearchInputElement>;
             /**
@@ -5901,7 +5972,7 @@ declare module "@stencil/core" {
              * @nativeHandler onKeyDown
              * @componentName Select
              * @maturityCategory use
-             * @maturityLevel deployed
+             * @maturityLevel best_practice
              * @guidanceHref form/select
              * @translations English
              * @translations Spanish
@@ -5915,8 +5986,8 @@ declare module "@stencil/core" {
             "va-service-list-item": LocalJSX.VaServiceListItem & JSXBase.HTMLAttributes<HTMLVaServiceListItemElement>;
             /**
              * @componentName Statement of truth
-             * @maturityCategory caution
-             * @maturityLevel candidate
+             * @maturityCategory use
+             * @maturityLevel deployed
              */
             "va-statement-of-truth": LocalJSX.VaStatementOfTruth & JSXBase.HTMLAttributes<HTMLVaStatementOfTruthElement>;
             /**
@@ -5925,6 +5996,11 @@ declare module "@stencil/core" {
              * @maturityLevel deployed
              */
             "va-summary-box": LocalJSX.VaSummaryBox & JSXBase.HTMLAttributes<HTMLVaSummaryBoxElement>;
+            /**
+             * @componentName Table
+             * @maturityCategory caution
+             * @maturityLevel available
+             */
             "va-table": LocalJSX.VaTable & JSXBase.HTMLAttributes<HTMLVaTableElement>;
             /**
              * @componentName Table
@@ -5944,7 +6020,7 @@ declare module "@stencil/core" {
              * @nativeHandler onBlur
              * @componentName Text input
              * @maturityCategory use
-             * @maturityLevel deployed
+             * @maturityLevel best_practice
              * @guidanceHref form/text-input
              * @translations English
              * @translations Spanish
@@ -5956,7 +6032,7 @@ declare module "@stencil/core" {
              * @nativeHandler onBlur
              * @componentName Textarea
              * @maturityCategory use
-             * @maturityLevel deployed
+             * @maturityLevel best_practice
              * @guidanceHref form/textarea
              * @translations English
              * @translations Spanish