Release v16.0.0

[booc0mtaco]

16.0.0 (2025-05-12)

⚠ BREAKING CHANGES

Note

For each item below, expand the section to learn more about mitigation notes, tips, and tricks on how to migrate to v16

Avatar: remove 1.x component export

• This component has been removed from export, and will be re-introduced in a future version of EDS
• If you need to use this component, consider building from scratch or copying the implementation a previous EDS

typography: introduce 2.0 tokens and component updates (#2167)

Text and Heading Presets Remapped

In order to resolve some inconsistencies and gaps in the typography ramp, we remodel all the presets to be more expressive, customizable, and themable. As a result, some previous presets have changed to map to new values. If you are using one of the previous presets, use the table below to find the corresponding mapped value

Presets in EDS < 15	Equivalent Preset in EDS >= 16
headline-lg-bold	headline-lg
headline-lg-bold-mobile	headline-lg
headline-lg-mobile	headline-lg
headline-md-bold	headline-md
headline-md-bold-mobile	headline-md
headline-md-mobile	headline-md
headline-sm-bold	headline-sm
headline-sm-bold-mobile	headline-sm
headline-secondary-lg	headline-decorative-inline-lg
headline-secondary-lg-bold	headline-decorative-inline-lg
headline-secondary-lg-bold-mobile	headline-decorative-inline-lg
headline-secondary-lg-mobile	headline-decorative-inline-lg
headline-secondary-md	headline-decorative-inline-md
headline-secondary-md-bold	headline-decorative-inline-md
headline-secondary-md-bold-mobile	headline-decorative-inline-md
headline-secondary-md-mobile	headline-decorative-inline-md
headline-secondary-sm	headline-decorative-inline-sm
headline-secondary-sm-bold	headline-decorative-inline-sm
headline-secondary-sm-bold-mobile	headline-decorative-inline-sm
headline-secondary-sm-mobile	headline-decorative-inline-sm
title-lg-bold	title-lg
title-md-bold	title-md
title-sm-bold	title-sm
title-xs-bold	title-xs
label-lg-subtle	label-lg
label-md-subtle	label-md
caption-lg	caption-md
caption-lg-bold	caption-md
caption-md-bold	caption-md
caption-sm-bold	caption-sm
overline	overline-md
button-lg	label-lg
button-md	label-lg
button-sm	label-sm
form-label	label-md
form-input	input
tag	label-sm
breadcrumb	body-sm

If code was previously using the combined preset variables (e.g., --eds-theme-typography-preset-*), these are no longer supported. Instead, each of the above presets are defined in {Heading|Text}.module.css file(s). To apply to components where you cannot use Heading or `Text, please reach out for support.

apply changes from next-major comments in code (#2164)

• Components using the Align property type no longer support left and right values. Instead use leading and trailing respectively.
• The Hint utility type was removed as it was no longer in use
• Exports to PageNotificationV2Props and AppNotificationV2Props were leftover in error, so the exports were removed from this release.
• Table has been marked as deprecated. Please use DataTable instead
• Updates of remaining component interfaces to use type definitions instead of interface definitions to be internally consistent
  • If previously relying on interface conventions, convert code to use type instead:

// From EDS ...
-interface XYZ { ... }
+type XYZ = { ... }

// In your local code ... 
-interface ABC Extends XYZ { ... }
+type ABC = XYZ & { ... } 

remove items marked as deprecated [EDS-1543] (#2156)

Spacing Tokens and Utility Classes

In order to better align between design and code, we updated the naming of the spacing tokens to have format --eds-spacing-size-X. Before, the naming lacked the extra -spacing.

For uses via tailwind, update each instance of the utility to include the renamed value to better match up with what shows in Figma (-size- => -spacing-size-)

Deprecated color tokens now removed

In this release is a large cleanup of a number of tokens used by the old theme. This release removes the vast majority of those tokens, preserving the remaining few used in legacy components and layouts. These will be removed after the last set of components have been migrated to the new theme/API.

deps: update dependency ts-morph to v25 (#2158)

ts-morph is used internally to help write migration scripts. This major version includes more TypeScript functionality and does not affect component exports.

update HeadlessUI to 2.x (#2148)

In this version of EDS, we move to HeadlessUI v2.0. With this move comes some library updates and API changes, which affect several EDS components:

• Modal
• Popover
• Menu
• Select

HeadlessUI migration notes are here: https://github.com/tailwindlabs/headlessui/releases/tag/%40headlessui%2Freact%40v2.0.0

In summary:

• cases where a render prop used active now use focus
• internally, some components switch over to the piecemeal component imports, but the external interface of sub components is preserved by EDS

remove horizontalstepper component [EDS-1539] (#2153)

• If you need to use this component, consider building from scratch or copying the implementation from EDS

remove progressbar component [EDS-1538] (#2152)

• If you need to use this component, consider building from scratch or copying the implementation from EDS

remove searchbar component [EDS-1537] (#2151)

• If you need to use this component, consider building from scratch or copying the implementation from EDS

remove Badge component [EDS-1536] (#2150)

• If you need to use this component, consider building from scratch or copying the implementation from EDS

remove Slider component [EDS-1534] (#2149)

• If you need to use this component, consider building from scratch or copying the implementation from EDS

Features

• apply changes from next-major comments in code (#2164) (55b8351)
• Avatar: remove 1.x component export (9e9919e)
• remove Badge component EDS-1536 (#2150) (13eb4e2)
• remove horizontalstepper component EDS-1539 (#2153) (75ba3f0)
• remove items marked as deprecated EDS-1543 (#2156) (cd03452)
• remove progressbar component EDS-1538 (#2152) (0af4e55)
• remove searchbar component EDS-1537 (#2151) (af943be)
• remove Slider component EDS-1534 (#2149) (c4e7617)
• Typography: add in full set of Graphik fonts and weights (#2181) (c83e3ff)
• typography: introduce 2.0 tokens and component updates (#2167) (71f05e6)
• update HeadlessUI to 2.x (#2148) (f01a838)

Bug Fixes

• deps: update dependency ts-morph to v25 (#2158) (c4aac68)
• InputChip: add padding to inside left edge to match design (#2182) (f29c5dc)
• set background token for text selection in reset file (b722237)
• storybook: set default foreground/background colors for story pages (#2163) (bdf1c48)
• TabGroup: use proper tier 2+ tokens with component (#2180) (a35515d)

[codecov]

Codecov Report

Attention: Patch coverage is 97.43590% with 2 lines in your changes missing coverage. Please review.

Project coverage is 96.29%. Comparing base (3ed42d5) to head (0052ea0).

Files with missing lines	Patch %	Lines
src/components/Popover/Popover.tsx	84.61%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2184      +/-   ##
==========================================
- Coverage   96.74%   96.29%   -0.45%     
==========================================
  Files         114      101      -13     
  Lines        2948     2403     -545     
  Branches      805      723      -82     
==========================================
- Hits         2852     2314     -538     
+ Misses         92       85       -7     
  Partials        4        4              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

size-limit report 📦

Path	Size
components	87.51 KB (-9.4% 🔽)
styles	24.83 KB (-18.1% 🔽)

[ajmoreno]

🚢