v56.3.0

What's Changed

Component	Summary	API Change	Rendered markup change
va-file-input, va-file-input-multiple	Updates va-file-input and va-file-input-multiple to support the existing behavior for encrypted file passwords (event emission on change of nested va-text-input for password) and the new pattern that includes a submit button for the inputted password. By @RyanMunsch #2027	Yes	Yes
Dependency update	Bumps flatted from 3.3.3 to 3.4.1 in the npm_and_yarn group. By @dependabot #2033	No	No
Component guidance tags	Backfills guidanceHref on top-level web components and adds lint enforcement to prevent future omissions. By @humancompanion-usds #2036	No	No
va-file-input-multiple Storybook	Removes stringified passwordSubmissionSuccessList state value in the EncryptedTemplate from rendered output. I was using this value to debug template validation logic. By @RyanMunsch #2042	No	Yes
va-telephone-input	Updates the va-telephone-input component to be compatible with the form-system such that errors are properly set on the component. By @it-harrison #2028	No	Yes
CSS-Library: mega-menu	Changes mega-menu overflow from scroll to auto to remove unnecessary scrollbar behavior. By @powellkerry #2048	No	Yes
va-date, va-file-input-multiple, va-file-input, va-memorable-date, va-telephone-input, va-text-input	Makes changes to various interactive input components to normalize label bold styles based on the components' error states. Labels should be bold when there is an error present. By @RyanMunsch #2041	No	Yes
Revert - Stencil/puppeteer upgrade	Reverts stencil and puppeteer upgrade due to runtime/modal issues, with follow-up tracked separately. By @powellkerry #2049	No	No
va-on-this-page	Update va-on-this-page to add a prop to exclude h2s that match heading selectors. Update utils to add a function to normalize string arrays so that the react binding is not necessary to use the prop. By @powellkerry #2043	Yes	Yes

Full Changelog: v56.2.1...v56.3.0

v56.2.1

What's Changed

Component	Summary	API Change	Rendered markup change
dashboard	App columns are now sorted alphabetically so the CSV schema is identical every run, regardless of filesystem traversal order. Added a dedicated pattern for single-letter-suffix forms. By @humancompanion-usds #2035	No	No
es-lint	ESLint 9 config converted. For compatibility with ESLint 9, the config files were converted to ES module flat config format. By @jamigibbs #2039	No	No
va-modal	Patch for allowing string versions of "false" for the visible prop. By @powellkerry #2037	No	No

Full Changelog: v56.2.0...v56.2.1

v56.2.0

What's Changed

New Features & Components 🎉

Component	Summary	API Change	Rendered markup change
va-details	Add new component. By @RyanMunsch #2015	Yes	Yes
Architecture Upgrade	Upgrades puppeteer@24.37.2 and stencil/core@4.43.2 By @powellkerry #2008	No	No
Dependabot Upgrades	Security upgrades. By @amyleadem & @powellkerry #2026, #2032	No	No
va-file-upload	The original content select was a va-select with an inert attribute. Updated to a dl. A screen reader should be able to read the content now. By @ediiotero #2020	No	No
va-button	Fixed the va-button when using it to submit a form. The onClick will now fire first before the onSubmit. By @ediiotero #2023	No	No
CSS-Library - Mega Menu	Updated mega-menu css-library styles to allow large font size users to be able to see all links and content in the va.gov navigation menus. By @powellkerry #2022	No	No
va-on-this-page	Filters out sr-only content and invisible elements from the generated link text. By @powellkerry #2022	No	No

Full Changelog: v56.1.0...v56.2.0

v56.1.0

What's Changed

⚠️ Potential impact to downstream applications and tests

This release includes an update to identify when a file upload has been canceled before upload progress has completed. Previously there was not a way to identify it. This can now be determined by the vaChange event sending no files in its event detail payload: !event.detail.files.length. Integrations should update the percent-uploaded property to null when a file upload is canceled.

Fixes

Component	Summary	API Change	Rendered markup change
va-file-input, va-file-input-multipule	This PR reverts the changes to va-file-input and va-file-input-multiple and related files that add the encrypted file password submit button pattern. By @RyanMunsch #2024	Yes	Yes
va-file-input, va-file-input-multipule	Reset file when upload progress is cancelled. Previously, canceling an upload before progress completed left the file visible in the UI, but now it is fully removed and a new upload form is displayed. By @jamigibbs #2006	No	No
va-modal	Update spacing and button layout. Updated component styles for spacing in order to improve text wrapping. By @danbrady #2017	No	No

Full Changelog: v56.0.0...v56.1.0

v56.0.0

What's Changed

⚠️ Potential impact to downstream applications and tests

This release includes updates to rendered component markup that may affect existing applications or test suites. Review the notes below for guidance on resolving test failures for affected components.

News Features

Component	Summary	API Change	Rendered markup change
va-file-input-multiple	Add vaMultipleError event to component. Added a new event to emit information for errors with uploaded files in order to resolve bug in component story for encrypted files. By @RyanMunsch #2000	Yes	No
va-file-input / va-file-input-multiple	Add password submit button. Updated component and logic to include a button to a submit password for encrypted files. Adds new props to both components and replaces vaPasswordChange event with vaPasswordSubmit. By @RyanMunsch / @jamigibbs #1997	Yes	Yes

Fixes

Component	Summary	API Change	Rendered markup change
va-telephone-input	Removed the telephone input wrapper from the tab index. This fixes an accessibility bug related to WCAG 2.4.3 (Focus Order) by improving keyboard navigation. By @amyleadem #2001	N/A	Yes
va-additional-info	Fix focus border. Updated style to prevent focus border from being cut off on final element in drawer if that element is focusable. By @powellkerry #2004	No	No
va-modal	Update spacing and button layout. Updated component styles for spacing in order to improve text wrapping. By @danbrady #1984	No	Yes
va-maintenance-banner	Prevent unnecessary slots from rendering in light DOM. Updated component logic so slots are not rendered if outside of date times for warning/maintenance windows props. By @RyanMunsch #1988	No	Yes

Full Changelog: v55.0.0...v56.0.0

v55.0.0

What's Changed

Breaking Changes

Summary	API change	Rendered markup change
Updated css-library and web-components to use Sass modules. This update replaces the deprecated @import statements  with @use, and uses Sass' built in modules for math and functions.	No	No

Full Changelog: v54.7.0...v55.0.0

v54.7.0

What's Changed

⚠️ Potential impact to downstream applications and tests

This release includes updates to rendered component markup that may affect existing applications or test suites. Review the notes below for guidance on resolving test failures for affected components.

New Features & Components 🎉

Component	Summary	API change	Rendered markup change
va-accordion	Changed the expand/collapse toggles to use va-button-icon. Replaced native button elements with the va-button-icon web component for the expand/collapse actions. If your code or tests rely on this element, update your selectors or assertions to match the updated component structure. By @powellkerry #1975	No	Yes
va-sidenav	Added props for customizing header and aria-label. Additional props added for experimenting with the va-sidenav web component as a stepper component. By @Dr-Pongo #1955	Yes	No
va-card-status	Made header props required. The web component requires the headerText, linkHref, and linkText before it will display. By @RyanMunsch #1990	Yes	No
va-sort	Added new web component. A new web component is available for triggering search result sorting. By @jamigibbs #1963	N/A	N/A

Fixes

Component	Summary	API change	Rendered markup change
va-language-toggle	Updated aria-current to a valid value. Previously the aria-current value was using an invalid value of "language" but it will now use "true" instead. By @jamigibbs #1968	No	No
va-language-toggle	Added language context to aria-label. The aria-label will now provide the name of the language that was selected. By @jamigibbs #1967	No	No
va-radio-option	Override global styles affecting display. The web component was receiving unwanted global styles from the CSS-Library because the shadow DOM of this component is open. By @jamigibbs #1987	No	No

CSS-Library

Summary
Updated non-breaking space unicode value to full 4-digits. This update hopes to remediate a seemingly random issue where Sass compiles content: \a0 to actual UTF-8 bytes 0xC2 0xA0 in the CSS output. By @jamigibbs #1989

Dependency updates

Affected package	Dependency name	Before	After
core	webpack	5.94.0	5.104.1

By @powellkerry #1979

Full Changelog: v54.6.2...v54.7.0

v54.6.2

What's Changed

Fixes

Component	Summary	API change	Rendered markup change
va-file-input-multiple, va-modal	Fixed a bug in iOS VoiceOver that prevented some modal implementations from being accessible via touch gestures. Now, the component traverses both the light and shadow DOM to appropriately apply aria-hidden. By @amyleadem #1977	No	No

Full Changelog: v54.6.1...v54.6.2

v54.6.1

What's Changed

Bug fixes

Component	Summary	API change	Rendered markup change
va-button	Reverted the submit action timing change introduced in v54.6.0. Testing revealed that this change introduced possible complications with downstream implementations. By @amyleadem #1972	No	No

Dependency updates

Affected package	Dependency name	Before	After
design-system-dashboard-cli	glob	13.0.0	13.0.1
react-components	glob	13.0.0	13.0.1

By @powellkerry #1969, #1971

Full Changelog: v54.6.0...v54.6.1

v54.6.0

What's Changed

New Features & Components 🎉

Component	Summary
va-card-status	Added the Card Status component. The new va-card-status component is a structured card that uses required fields to keep status messages consistent. By @ediiotero #1862

Bug fixes

Component	Summary	API change	Rendered markup change
va-button	Fixed a timing bug in va-button that prevented some forms from submitting as expected. The button now runs its onClick action before onSubmit. By @ediiotero #1946	No	No
va-pagination	Fixed an issue in ‎va-pagination that prevented icons from rendering when the icon sprite was stored in a custom location. The component now uses ‎va-icon instead of hard-coded SVGs to prevent broken icon paths. By @jamigibbs #1956	No	Yes

Dependency updates

Affected package	Dependency name	Before	After
design-system-dashboard-cli	eslint	7.32.0	9.26.0
	glob	9.3.5	13.0.0
	lodash	4.17.21	4.17.23
react-components	eslint	7.19.0	9.26.0
	glob	9.3.5	13.0.0
web-components	eslint	8.19.0	9.26.0

By @powellkerry #1954, #1959, #1961

Full Changelog: v54.5.2...v54.6.0