9.0.0-beta.1

Beta release details

Design System [9.0.0-beta.1]

🚨 Breaking

• Removed misnamed --typography-heading-base__font-size CSS variable from theme files (#2784)
• Typography .ds-text-* and .ds-text-body-* classes are no longer controlled by setting the --typography-heading-* CSS variables (which are for headings). They now get their sizes directly from the --font-size-* variables. (#2784)
• Removed the deprecated textClassName prop from labels (#2780)
• Reorganized the font tokens (#2776)
  • The following CSS variables were renamed:
    • --form-label__color--inverse renamed to --label__color--inverse
  • The following CSS variables were removed:
    • --font-family-open-sans
    • --font-family-rubik
    • --font-family-montserrat
    • --font-family-bitter
• Removed the unused "success" text field (ds-c-field--success class) (#2725)
• Labels, hints, and inline-error messages are now independent elements. (#2685)
  • They used to all be contained within a single <label> element rendered by a FormLabel component. The new React components are Label, Hint, and InlineError (not new), but FormLabel still exists in this version for backward compatibility.
• Replaced useFormLabel with smaller, more focused hooks (#2814). This was an internal hook that was exported by the package. We're no longer exporting it, thus why it is being marked as a breaking change.

🚀 Added

• Added ds-dropdown web component (#2772)
• Added custom event handling to web components (#2738)
• Added web-component support to our Storybook (#2715)
• Reorganized the font tokens, adding the following CSS variables (#2776):
  • --font-size-* variables targeting specific screen sizes
  • --typography-heading-* variables for font-size
  • --label* variables about text styling
• Added fallback fonts to theme tokens (#2721)

🛠 Fixed

• Fixed inconsistencies between fallback fonts for StepList bullet points between different browsers (#2734)
• Fixed alert body content flowing out of bounds (#2824)
• Updated prop type definitions for the following components to support passthrough attributes (#2798):
  • Badge
  • SingleInputDateField
  • Tooltip
  • All the icon components

📦 Internal

• Fixed interaction tests run with Preact (#2768)
• Added a "patch" script for automatically cherry-picking commits (#2762)
• Packages to now consume tokens directly from tokens directory instead of copying (#2808)

Documentation

💅 Changed

• Storybook to use Preact by default again (#2769)

🚀 Added

• Documented pass-through props in Storybook dev docs (#2799)
• Added an attributes table to storybook docs for web components (#2753)
• Added more functionality to ds-alert story (#2728)
• Added a ds-usa-banner story (#2727)

🛠 Fixed

• Fixed radio example showing on checkbox doc page (#2767)
• Fixed dead links in docs (#2766)

8.0.5

Design System [8.0.5]

🚀 Added

• Added a name property to the DropdownChangeObject sent in the Dropdown component's onChange handler (#2805)

🛠 Fixed

• Worked around React/Google-Translate issue in dropdown options (#2819)
• Removed redundant table role to fix axe-core error (#2818)
• Restored ability to disable autocompletes (#2797)

8.0.4

Design System [8.0.4]

🛠 Fixed

• Fixed the Dropdown not scrolling to the selected item when using pointer (#2785)
• Fixed id/aria-describedby syncing issue in Tooltip (#2775)

Healthcare.gov Design System [12.0.4]

All changes from the core design system and...

🛠 Fixed

• Worked around React/Google-Translate incompatibility in healthcareHeader (#2781)

Documentation

🚀 Added

• Added reference links to design artboards in Sketch cloud (#2782)

8.0.3

Design System [8.0.3]

🛠 Fixed

• Gave the SingleInputDateField calendar button more context for screen readers (#2749)
• Fixed incompatibilities with React 18 types for FilterChip, Table, and TableCell (#2747)
• Fixed tap-through bug in Dropdown and Autocomplete (#2743)
• Fixed rendering issue for UsaBanner experienced by the Learn team (#2730)

Documentation

💅 Changed

• Updated CDN examples to use latest DS version (#2751)

🛠 Fixed

• Fixed css-variable tables overlapping guidance text in Alert docs in Medicare theme (#2752)
• Fixed inability to set an error message on the inverse ChoiceList story (#2748)

CMS.gov Design System [8.0.3]

All changes from the core design system

Healthcare.gov Design System [12.0.3]

All changes from the core design system

Medicare.gov Design System [10.0.3]

All changes from the core design system

8.0.2

Design System [8.0.2]

🛠 Fixed

• Fixed desktop VoiceOver announcing selected tribe names as being misspelled in Dropdown (#2707)
• Fixed Autocomplete stripping props from TextField unintentionally (#2706)
• Fixed Autocomplete results failing to close after selection is made (#2705)

CMS.gov Design System [8.0.2]

All changes from the core design system

Healthcare.gov Design System [12.0.2]

All changes from the core design system

Medicare.gov Design System [10.0.2]

All changes from the core design system

8.0.1

Design System [8.0.1]

🛠 Fixed

• Fixed delayed receipt of items failing to open Autocomplete results list (#2694)
• Fixed event handlers for Autocomplete child TextField (#2692)
• Fixed Autocomplete results list not showing after restoring focus (#2689)

CMS.gov Design System [8.0.1]

All changes from the core design system

Healthcare.gov Design System [12.0.1]

All changes from the core design system

Medicare.gov Design System [10.0.1]

All changes from the core design system

Documentation

🚀 Added

• Documented how the Autocomplete React component should work. This documentation lives in Storybook (#2691)

8.0.0

For a high-level overview, please read our Release 8.0 blog post.

Design System [8.0.0]

🚨 Breaking

• Swapped Downshift library for react-aria (#2663, #2667)
  • This fixes unreliable VoiceOver behavior of Autocomplete and Dropdown
  • Autocomplete onChange and onInputValueChange functions now only pass one parameter. The second parameter of each was previously meta-data that was specific to the underlying library we used.
  • The following Autocomplete props have been deprecated and are no longer used:
    • getA11yStatusMessage
    • itemToString
  • The following Dropdown props have been deprecated and are no longer used:
    • getA11yStatusMessage
    • getA11ySelectionMessage
• Updated UsaBanner, which also changed the following CSS variables: (#2578)
  • Renamed tokens:
    • --usa-banner-action__color to --usa-banner-link__color
    • --usa-banner-lock-icon__color to --usa-banner-security-icon__color
    • --usa-banner-close-button__background-color to --usa-banner-close-button__background-color--mobile
  • Updated token values:
    • --usa-banner__color
    • --usa-banner-heading__font-size
  • Added new tokens:
    • --usa-banner__max-width
    • --usa-banner-gutter-width
    • --usa-banner-heading__font-family
    • --usa-banner-heading__line-height
    • --usa-banner-panel__font-family
    • --usa-banner-panel__line-height
    • --usa-banner-panel__font-size
    • --usa-banner-panel__font-family
    • --usa-banner-domain-icon__color
    • --usa-banner-heading__font-family
    • --usa-banner-close-button__color--mobile

💅 Changed

• All of a component's element ids are now derived from a single root id that can be supplied by the user (#2633)
  • The purpose of this is to ensure determinism even in multi-threaded static-site-generator projects
  • All components that generate ids now accept an id prop if they didn't previously
  • Some components allow additional ids to be specified through props; they are still there, but they will now fall back to an id derived from the root id.
  • Derived ids now follow a standard format
• Expanded the following props from accepting only string to any ReactNode:
  • tab prop on TabPanel (#2612)
  • heading prop on Alert (#2642)
  • heading and footerTitle props on Drawer and HelpDrawer (#2642)
  • heading prop on IdleTimeout (#2642)

🛠 Fixed

• Fixed Autocomplete/Dropdown menus getting cut off at dialog window boundaries (#2669)

📦 Internal

• Converted the FormLabel component to a functional component (#2585)

Healthcare.gov Design System [12.0.0]

All changes from the core design system and...

🚨 Breaking

• Added the USA banner component to HealthCare.gov global header behind a default-ON feature flag prop (#2603, #2616)

🛠 Fixed

• Added list role to HealthCare.gov header lists (#2630)

Medicare.gov Design System [10.0.0]

All changes from the core design system and...

🚨 Breaking

• Removed glossary link from the Medicare.gov footer (#2615)

🛠 Fixed

• Fixed layout styles for the Medicare footer and simplified the CSS (#2646)
• Updated the URL for the "Linking Policy" link in the Medicare footer (#2683)

Documentation

💅 Changed

• Improved the SkipNav story
• Restricted the theme for healthcare's one-col-page-layout story (#2614)
• Moved developer/React documentation into Storybook
  • Migrated all prop tables from doc site into Storybook (#2563, #2575)
  • Made the Storybook doc pages more informative (#2562)
  • Updated component story names to match component names (#2574)
• Checked the "forced colors mode" item of Autocomplete's maturity checklist (#2668)

🚀 Added

• Used a new filter-dialog prototype for doc site theme and version switching (#2599)

Design Sketch UI Kits

All UI Kits

💅 Tested and updated to Sketch version 98.2

🎨 CORE

Core 5.0.0 Sketch UI Kit and Theme

• Autocomplete component: Updated styles to match dropdown
• Hint text: Replaced the text-box with a symbol.
• Help Drawer: Layout and styles updated
• Form label: Varients updated to improve content layout

🎨 Healthcare

HealthCare 5.0.0 Sketch UI Kit and Theme

• Autocomplete component: Updated styles to match dropdown
• Hint text: Replaced the text-box with a symbol.
• Header: Updated HealthCare header to include the USA Banner component

🎨 Medicare

Medicare 5.0.0 Sketch UI Kit and Theme

• Autocomplete component: Updated styles to match dropdown
• Hint text: Replaced the text-box with a symbol.
• Header: Updated Medicare header to include the USA Banner component
• Footer: Removed "glossary" link

8.0.0-beta.3

Beta release details

Design System [8.0.0-beta.3]

🛠 Fixed

• Fixed dropdown onBlur errors (#2675)
• Inlined some Dropdown and Autocomplete dependencies (#2675)

CMS.gov Design System [8.0.0-beta.3]

All changes from the core design system

Healthcare.gov Design System [12.0.0-beta.3]

All changes from the core design system

Medicare.gov Design System [10.0.0-beta.3]

All changes from the core design system

8.0.0-beta.2

Beta release details

Design System [8.0.0-beta.2]

🚨 Breaking

• Swapped Downshift library for react-aria (#2663, #2667)
  • This fixes unreliable VoiceOver behavior of Autocomplete and Dropdown
  • Autocomplete onChange and onInputValueChange functions now only pass one parameter. The second parameter of each was previously meta-data that was specific to the underlying library we used.
  • The following Autocomplete props have been deprecated and are no longer used:
    • getA11yStatusMessage
    • itemToString
  • The following Dropdown props have been deprecated and are no longer used:
    • getA11yStatusMessage
    • getA11ySelectionMessage

💅 Changed

• All of a component's element ids are now derived from a single root id that can be supplied by the user (#2633)
  • The purpose of this is to ensure determinism even in multi-threaded static-site-generator projects
  • All components that generate ids now accept an id prop if they didn't previously
  • Some components allow additional ids to be specified through props; they are still there, but they will now fall back to an id derived from the root id.
  • Derived ids now follow a standard format

🛠 Fixed

• Fixed dropdown menus getting cut off at dialog window boundaries (#2669)

Healthcare.gov Design System [12.0.0-beta.2]

All changes from the core design system

Medicare.gov Design System [10.0.0-beta.2]

All changes from the core design system and...

🛠 Fixed

• Fixed layout styles for the Medicare footer and simplified the CSS (#2646)

Documentation

💅 Changed

• Checked the "forced colors mode" item of Autocomplete's maturity checklist (#2668)

7.0.7

Design System [7.0.7]

🛠 Fixed

• Fixed high specificity of list normalization rules and fixed bare list styles (#2649)

CMS.gov Design System [7.0.7]

All changes from the core design system

Healthcare.gov Design System [11.0.7]

All changes from the core design system

Medicare.gov Design System [9.0.7]

All changes from the core design system