12.4.5

Design System [12.4.5]

🛠 Fixed

• Exported NoteBox correctly (#3818)

CMS.gov Design System [12.4.5]

All changes from the core design system.

Healthcare.gov Design System [16.4.5]

All changes from the core design system.

Medicare.gov Design System [14.4.5]

All changes from the core design system.

Documentation

No changes.

13.2.0

Design System [13.2.0]

💅 Changed

• Removed usage of React's legacy Children API from Autocomplete, LabelMask, Mask, Table, TableHead & TableRow (#3817, #3819, #3820, #3829, #3828 #3826)

📦 Internal

• Updated Caniuse lite db (#3841)
• Removed relative imports from Astro React 19 Example Application (#3840)

Medicare.gov Design System [15.2.0]

All changes from the core design system and...

🛠 Fixed

• Fixed broken Storybook link for the Medicare HelpDrawer (#3879)
• Replaced the missing--shadow-box-card definition for the Card component (#3822)

CMS.gov Design System [13.2.0]

All changes from the core design system and...

🛠 Fixed

• Exported NoteBox correctly (#3818)

Healthcare.gov Design System [17.2.0]

All changes from the core design system.

Documentation

💅 Changed

• Updated frontmatter status fields to reflect current accessibility guidance for each component (#3882)
• Updated the "Writing Content" section in Button guidance (#3843)
• Expanded general accessibility guidance for Card & remove outdated Github and Storybook references (#3823)
• Clarified guidance around hyperlinking phone numbers (#3821)

🚀 Added

• Added Tooltip to Angular example application (#3815)
• Added a dedicated page for contribution proposal guidance (#3813)

🛠 Fixed

• Updated Gatsby config to use the correct canonical siteUrl (#3895)
• Added link for the expose within pattern on the checkedChildren prop for the Choice Storybook page (#3825)

13.1.1

Design System [13.1.1]

🛠 Fixed

• Aria-live regions used by InlineError component now read out errors. This is a reversion of a bug introduced in version 12.4.2, please upgrade to this version if you are using 12.4.2. Pull Request (#3867)

Healthcare.gov Design System [17.1.1]

All changes from the core design system.

Medicare.gov Design System [15.1.1]

All changes from the core design system.

CMS.gov Design System [13.1.1]

All changes from the core design system.

12.4.4

Design System [12.4.4]

🛠 Fixed

• Aria-live regions used by InlineError component now read out errors. This is a reversion of a bug introduced in version 12.4.2, please upgrade to this version if you are using 12.4.2. Pull Request (#3867)

Healthcare.gov Design System [16.4.4]

All changes from the core design system.

Medicare.gov Design System [14.4.4]

All changes from the core design system.

CMS.gov Design System [12.4.4]

All changes from the core design system.

13.1.0

Warning

A11y note: v12.4.2 introduced a regression that prevented InlineError ARIA live region announcements from being read reliably by screen readers. This was fixed in v12.4.4 and v13.1.1. Please upgrade to these versions, especially if your team uses the Instant Validation pattern.

Design System [13.1.0]

💅 Changed

• Updated React types to be compatible with React 19 (#3781, #3783, #3784, #3793, #3794)
• Refocuses Autocomplete input after clearing search. (#3707)

🚀 Added

• Converted icons to web components (#3808)
• Offered Card in Core package (#3760, #3801)
• Added SearchIcon (#3754)
• Added ds-third-party-external-link web component (#3745)

🛠 Fixed

• Added nodeRef attribute to tooltip (#3803)
• Removed aria-invalid attribute if ChoiceList is a checkbox group. (#3780)
• Updated two snapshots (#3770)
• Only render "Learn more" link when learnMoreUrl is defined (#3769)
• Excluded hidden inputs from display: block rule. (#3758)

📦 Internal

• Updated release reviewers (#3835)
• Updated failing snapshot for Astro web-components page (#3810)
• Added necessary snapshot updates for astro-react-18 example application. (#3804)
• Removed push tokens to figma npm scripts (#3796)
• Bumped @types/react packages (#3785)
• CI now waits for fonts before snapshots (#3747)

Healthcare.gov Design System [17.1.0]

All changes from the core design system and...

🛠 Fixed

• Fixed missing red border on Healthcare chekboxes (#3727)

Medicare.gov Design System [15.1.0]

All changes from the core design system and...

💅 Changed

• Removed Mgov Card component (#3802)

CMS.gov Design System [13.1.0]

All changes from the core design system and...

💅 Changed

• Migrated JSX.IntrinsicElements to React.JSX.IntrinsicElements and add custom element support (#3782)

Documentation

💅 Changed

• Updated 'for-developers' page to display themed code blocks with latest version numbers (#3807)
• Added a11y guidance for the Calendar Picker component (#3795)
• Updated New Relic browser app (#3767)
• Removed Medicare-specific references from Card Guidance (#3765)
• Added nested components to ds-drawer in Angular example project. (#3725)
• Cleaned up Storybook actions and controls (#3664)
• Updated accordion a11y guidance (#3657)
• Updated footer a11y guidance (#3656)
• Updated header a11y guidance (#3655)

🚀 Added

• Created Storybook story for Icon web components (#3811)
• Added missing code blocks for CMSgov theme on "for-developers" page. (#3762)
• Added test coverage for Autocomplete selection and blur behavior (#3740)

🛠 Fixed

• Replaced requiredLabel with hint on ChoiceList Story (#3763)
• Cleaned up web component Stories (#3686)

📦 Internal

• Added React 19 example Astro project (#3805)
• Added GitHub Issue line to PR template (#3761)

13.0.0

Warning

A11y note: v12.4.2 introduced a regression that prevented InlineError ARIA live region announcements from being read reliably by screen readers. This was fixed in v12.4.4 and v13.1.1. Please upgrade to these versions, especially if your team uses the Instant Validation pattern.

Design System [13.0.0]

🚨 Breaking

• Removed defaultProps from React components and replaced them with inline default values(#3552)

💅 Changed

• Upgraded React to v18.3.1 (#3433)

📦 Internal

• Resolved eslint errors (#3503)
• Updated two @testing-library dependencies (#3458)
• Set required fields as required in Storybook (#3649)
• Fixed broken example projects (#3515)

Documentation

💅 Changed

• Upgraded react-docgen-typescript to v2.4.0 (#3653)
• Removed react-helmet dependency (#3550)

📦 Internal

• Added a "Color Contrast Guidance" component (#3579)
• Added migration script blogpost (#3673)
• Upgraded Gatsby to v5 (#3477)

CMS.gov Design System [13.0.0]

All changes from the core design system.

Healthcare.gov Design System [17.0.0]

All changes from the core design system + the following:

🚨 Breaking

• Renamed components that have theme-specific overrides (#3672). For migration guidance see our 13.0.0 blog post.
  • HelpDrawer → MedicaregovHelpDrawer
  • HelpDrawerToggle → MedicaregovHelpDrawerToggle
  • ThirdPartyExternalLink → MedicaregovThirdPartyExternalLink
• Removed defaultProps from theme specific-components (#3565)

Medicare.gov Design System [15.0.0]

All changes from the core design system + the following:

🚨 Breaking

• Renamed components that have theme-specific overrides (#3672). For migration guidance see our 13.0.0 blog post.
  • AccordionItem → HealthcaregovAccordionItem
  • ThirdPartyExternalLink → HealthcaregovThirdPartyExternalLink
• Removed defaultProps from theme specific-components (#3565)

12.4.3

Warning

A11y note: v12.4.2 introduced a regression that prevented InlineError ARIA live region announcements from being read reliably by screen readers. This was fixed in v12.4.4 and v13.1.1. Please upgrade to these versions, especially if your team uses the Instant Validation pattern.

Design System [12.4.3]

🚀 Added

• Users can override/edit Screen Reader text for the Badge component (#3688)

🛠 Fixed

• All Web Components are available via the single JS file option (all.js) (#3700)

📦 Internal

• Bumped chalk from 4.1.2 to 5.5.0 in /packages/design-system (#3689)(#3704)
• Added ds-autocomplete component in Angular example project (#3687)
• Added headingClassName attribute to AccordionItem and heading-class-name to ds-accordion-item and additional
  examples (#3702)
• Updated "Focus Button" medicare/webkit snapshot (#3717)

Documentation

💅 Changed

• Updated Pagination accessibility guidance (#3705)

🚀 Added

• Added accessibility guidance to VerticalNav documentation page (#3697)
• Added accessibility testing guidance to FilterChip documentation page (#3696)
• Added accessibility guidance to TextField documentation page (#3694)
• Added accessibility guidance to LabelMask documentation page (#3693)
• Added accessibility guidance to Tabs documentation page (#3692)
• Added accessibility guidance for SingleInputDateField documentation page (#3681)
• Added accessibility guidance to MultiInputDateField documentation page (#3684)
• Added accessibility guidance to Medicare.gov Card documentation page (#3683)
• Added accessibility testing guidance to Badge documentation page (#3680)

🛠 Fixed

• Fix links on Introduction page (#3663)

📦 Internal

• Updated pull request template to better match naming schema in Jira (#3706)
• Added severity to bug report (#3701)

CMS.gov Design System [12.4.3]

All changes from the core design system.

Healthcare.gov Design System [16.4.3]

All changes from the core design system.

Medicare.gov Design System [14.4.3]

All changes from the core design system.

12.4.2

Warning

A11y note: v12.4.2 introduced a regression that prevented InlineError ARIA live region announcements from being read reliably by screen readers. This was fixed in v12.4.4 and v13.1.1. Please upgrade to these versions, especially if your team uses the Instant Validation pattern.

Design System [12.4.2]

🛠 Fixed

• Language-translation-related fix: Resolved an issue that occurred when Chrome users enabled Google Translate, which broke InlineError rendering due to unexpected DOM mutations. This component now remounts safely on update. (#3682)

CMS.gov Design System [12.4.2]

All changes from the core design system.

Healthcare.gov Design System [16.4.2]

All changes from the core design system.

Medicare.gov Design System [14.4.2]

All changes from the core design system.

12.4.1

Design System [12.4.1]

No changes.

Documentation

💅 Changed

• Expanded external link handling in ContentRenderer to support additional analytics props for ThirdPartyExternalLink on our Documentation Site. (#3654)
  Note: This change does not affect teams using the Design System.

CMS.gov Design System [12.4.1]

No changes.

Healthcare.gov Design System [16.4.1]

No changes.

Medicare.gov Design System [14.4.1]

No changes.

12.4.0

Design System [12.4.0]

🛠 Fixed

• Fixed a regex pattern in Textfield by escaping special characters to support Chrome’s /v regex modifier. (#3632)
• Updated Astro config to fix a build issue by including necessary dependencies in Vite’s SSR pipeline (#3619, #3617)

Documentation

💅 Changed

• Implemented accessibility guidance for Hint, InlineError , Icon, and Review components. (#3614)
• Added a deprecation notice in the Table component's documentation page. See this Github discussion for more info. (#3624)
• Updated error-validation documentation to specify inline error placement (top or bottom) based on theme. (#3634)
• Added analytics support for Tooltip & Alert (#3633, #3643)

🛠 Fixed

• Fixed a broken link on the Breakpoints page that now correctly directs to the Typography page. (#3631)
• Added a redirect to the TextField page to ensure correct navigation. (#3625)
• Refactored ds-drawer Storybook docs to use a custom template to improve rendering consistency. (#3607)

📦 Internal

• Bumped inquirer from 9.3.7 to 12.6.3 in /packages/design-system (#3623)
• Removed storybook/viewport from the addon list in Storybook config (#3646)

CMS.gov Design System [12.4.0]

All changes from the core design system.

Healthcare.gov Design System [16.4.0]

All changes from the core design system.

Medicare.gov Design System [14.4.0]

All changes from the core design system.