13.1.0

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

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

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

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.

12.3.0

Design System [12.3.0]

💅 Changed

• Made stylesheet polling stop after 30 seconds (#3580)

🚀 Added

• Added an alert icon without circle (#3574)

🛠 Fixed

• Fixed ds-autocomplete storybook controls (#3571)
• Hid abbreviated month labels from screen readers in MonthPicker (#3478)

📦 Internal

• Updated @react-stately dependency (#3596)
• Replicated autocomplete keyboard interaction bug (#3594)
• Refactored custom Playwright reporter to isolate test results by config group (#3546)

Documentation

💅 Changed

• Clarified storybook documentation around attributes that accept stringified JSON (#3603)
• Added a11y guidance to all logos on docsite (#3556)
• Updated to pull request template (#3549)

🚀 Added

• Added StatusIndicator component to docs (#3597)
• Added a11y guidance idle timeout (#3589)
• Added A11y guidance for radio and checkbox components (#3572)
• Added more detailed storybook guidance for ds-autocomplete (#3564)
• Added status to frontmatter for .mdx files (#3563)
• Updated text-field guidance (#3542)
• Updated vertical spacing guidance (#3528)
• Added pattern guidance for html tables (#3499)

🛠 Fixed

• Added Doc Site analytics for page views (#3602, #3593, #3591, #3587, #3573, #3559)
• Fixed ds-modal-dialog stories where the modals don't open (#3590)
• Removed form components table (#3566)
• Fixed broken link on dropdown page (#3562)
• Removed two broken links on checkbox page (#3561)
• Fixed broken links on single-input-field page (#3551)

CMS.gov Design System [12.3.0]

All changes from the core design system.

Healthcare.gov Design System [16.3.0]

All changes from the core design system.

Medicare.gov Design System [14.3.0]

All changes from the core design system.

12.2.0

Design System [12.2.0]

🚀 Added

• Added support for aria-describedby to ThirdPartyExternalLink (#3490)
• Exposed informational as part of the AlertVariation type (#3301)

🛠 Fixed

• Fixed aria-invalid property previously assigned to Dropdown button (#3516)
• Scoped prefers-reduced-motion CSS to only target design system components. (#3457)

📦 Internal

• Made labels unique for the GitHub bug report (#3505)
• Fixed release script (#3547)

Documentation

💅 Changed

• Updated typography headings guidance (#3426)
• Updated color guidance (#3395)
• Updated Alert component guidance (#3369)
• Updated Utility Actions content (#3309)
• Updated Drawer component guidance (#3299)

🚀 Added

• Added NoteBox guidance (#3494)
• Added Typography overview guidance (#3423)
• Added missing custom event documentation on Storybook for several web components (#3475)
• Added new guidance and reordered sections for the drawer/help drawer page (#3436)
• Added accessibility guidance for the following pages:
  • Masked Field Text Inputs (#3462)
  • USA Banner (#3461)
  • Third Party External Link (#3455)
  • Step List (#3439)
  • Month Picker (#3435)
  • Tooltip (#3434)
• Added analytics events:
  • NavigationOpened (#3440)
  • 404 page load (#3438)
  • Button engagement (#3431)
  • Theme and versions selection dialogs (#3424)
  • Link tracking (#3401)
  • Documentation searches (#3396)

🛠 Fixed

• Fixed href-template attribute casing in ds-pagination Storybook docs (#3541)
• Added analytics handler to Storybook links (#3495)
• Fixed typo in ds-dropdown Storybook docs (#3474)
• Fixed analytics-related issues around empty search strings search result positioning, and various links (#3471, #3470, #3469, #3468)
• Removed incorrect documentation for Dropdown (#3456)
• Removed a stray Sketch reference on the MaturityChecklist component. (#3437)
• Fixed web component Storybook link for Button (#3425)

Medicare.gov Design System [14.2.0]

All changes from the core design system and...

💅 Changed

• Updated guidance on Button and removed clickable card guidance (#3316, #3325)

CMS.gov Design System [12.2.0]

All changes from the core design system.

Healthcare.gov Design System [16.2.0]

All changes from the core design system.

12.1.1

Design System [12.1.1]

🛠 Fixed

• Fixed onChange not firing for grouped items in Autocomplete and ds-autocomplete (#3543)

Medicare.gov Design System [14.1.1]

All changes from the core design system.

CMS.gov Design System [12.1.1]

All changes from the core design system.

Healthcare.gov Design System [16.1.1]

All changes from the core design system.

12.1.0

Design System [12.1.0]

🚨 Breaking

• Fixed inconsistencies in Review heading styles (#3342)
• Fixed inconsistencies in Alert heading styles (#3334)

💅 Changed

• Updated ds-button, ds-hint and ds-inline-error to use the Shadow DOM (#3391)
• Updated ds-autocomplete to allow pass through props into Textfield (#3331)
• Updated USA Banner to match Figma (#3319)

🚀 Added

• Added NoteBox component (#3419, #3418)
• Updated Alert to dynamically assign role based on variation (#3366)
• Added test coverage for fetching async data with ds-autocomplete & Autocomplete (#3354, #3351)
• Extended Autocomplete & ds-autocomplete to support grouped items under headers and added stories (#3344, #3352)
• Implemented ds-modal-dialog web component (#3302)
• Added analytics support to web components (#3296)
• Implemented ds-review web component (#3285)
• Added backdrop-click-exits attribute to ds-drawer (#3493)

🛠 Fixed

• Pulled in an accessibility fix for react-aria's <HiddenSelect /> (#3452)
• Enabled DateInput to switch between MM/DD and DD/MM formats based on page language (#3451)
• Fixed hintClassName being applied to DOM elements (#3393)
• Standardized inputRef prop types (#3356, #3361)
• Fixed analytics={false} being passed into ds-modal-dialog (#3350)
• Added a fix to prevent double firing of exit event in NativeDialog (#3330)
• Fixed Angular event binding on nested web components (#3327)
• Removed aria-disabled from TabPanel components (#3315)
• Removed ds-tab-panel module (#3304)
• Added the optional hintClassName prop to the useHint interface (#3292)
• Fixed arrow key behavior for disabled Tab components (#3286)
• Added Angular example project and fix Angular web component content issue (#3275)

📦 Internal

• Migrated yarn to npm (#3397)
• Removed outdated humanize-react library (#3380)
• Upgraded Astro from 4.4.8 to 5.1.2 (#3365)
• Increased usage of the isPossibleValue utility and added a spec (#3345)
• Updated Autocomplete tests to skip combinations that trigger a Playwright bug (#3367)
• Upgraded Playwright from 1.31 to 1.49 (#3364)
• Updated snapshots for nightly tests (#3300, #3328, #3293 #3500)
• Updated PR Template to reflect new script that updates all browser tests (#3329)
• Enabled --list for custom Playwright test reporter (#3362)
• Formatted example files when template is applied (#3360)
• Added functionality to calculate unit test code coverage (#3359)
• Changed the failure threshold for VRT screenshots (#3353)
• Added missing version to versions.json (#3341)
• Added custom playwright reporter to provide JSON summary of test metrics (#3335)
• Added error handling for missing alias case in sync:from-figma script (#3428)
• Added new form for bug reports (#3497 #3501)

Medicare.gov Design System [14.1.0]

All changes from the core design system and...

💅 Changed

• Updated Pagination Styling for Medicare (#3312)
• Made Medicare URLs language-aware in SimpleFooter (#3466)

🚀 Added

• Added Medicare footer web-component ds-simple-footer (#3405)

CMS.gov Design System [12.1.0]

All changes from the core design system and...

💅 Changed

• Swapped bold headers with semibold headers on CMSgov theme (#3291)

Healthcare.gov Design System [16.1.0]

All changes from the core design system.

Documentation

💅 Changed

• Updated Angular Example (#3358)

🚀 Added

• Added subcomponents table for web components (#3463)
• Added missing web component sections to several doc site component pages (#3313, #3308)
• Added a web component section to Accordion doc site page (#3307)
• Added ds-drawer to Astro example project (#3399)
• Added analytics handler to Storybook links (3495)
• Added a dedicated backdropClickExits story for Drawer (#3491)

🛠 Fixed

• Added default analytics value for empty string searches (#3471)
• Added search results position to search event (#3470)
• Updated link events to point link URLs at link destination (#3469)
• Made Figma use the external link event (#3468)
• Renamed font size story (#3427)
• Removed empty StepList data snapshots (#3403)
• Fixed dead links to old developer docs (#3402)
• Added a preemptive fix for CORS blocking stylesheet access in web component CDN example (#3394)
• Updated the description of the design system package dist folder (#3379)
• Fixed wrong Storybook iframes loading on doc site (#3357)
• Added markdown rendering to web component Storybook docs (#3303)
• Fixed broken default story for ds-drawer in Storybook (#3492)

📦 Internal

• Cleaned up release script (#3429, #3489)
• Validated compatibility with different React versions through automated testing (#3407)