9.4.0

9.4.0

Bug Fixes

• Align Validation component message icons with the first line of the message text.

Dependencies

• Upgrade USWDS from v3.8.1 to v3.9.0 (see release notes) (!14, !17)

9.3.0

Improvements

• Update styling for Default (previously "Other") Alert component variant, for greater distinction from other variants and consistency with U.S. Web Design System. (#449)
  • It is no longer necessary to assign the usa-alert--other class to use these styles, and it can be safely removed. Existing code assigning usa-alert--other should continue to display the updated default styles as expected.

Bug Fixes

• Improve compatibility of badge icon styling for inner Icon component. (#445)
• Improve text contrast for code syntax highlighting. (!2)

Dependencies

• Upgrade USWDS from v3.8.0 to v3.8.1 (see release notes) (#448)

9.2.0

Improvements

• Update styling for Alert component for increased contrast and consistency with U.S. Web Design System. (#439)
• Update styling for Validation component icons for consistency with U.S. Web Design System. (#441)
• Update markup for badge component to use U.S. Web Design System icons. (#442)
  • Existing usage will not be affected until the next major release (see "Deprecations").

Deprecations

• Badge component markup has been updated and will be required in the next major release. (#442)
• Custom alert icons will be removed in the next major release, use U.S. Web Design System alerts instead.
  • alerts/error.svg
  • alerts/info.svg
  • alerts/success.svg
  • alerts/unphishable.svg
  • alerts/warning.svg

9.1.0

New Features

• Add SVG format option for favicon image. (#424)
• Add "centered" variant for banner component. (#429)

Improvements

• Update styling for Tag component for consistency with U.S. Web Design System. (#426)
• Hide collapsed Accordion component content while JavaScript loads. (#434)

Dependencies

• Upgrade USWDS from v3.7.1 to v3.8.0 (see release notes) (#425)

9.0.0

Breaking Changes

• Prose styling overrides have been removed. Text formatting should now adhere to the defaults from the U.S. Web Design System. (#390)
• Drop support for Internet Explorer. (#387)
  • Support was indirectly dropped in v7.0.0 via the upgrade to USWDS v3.0.0, which similarly ended explicit support for Internet Explorer. This package had continued to include Internet Explorer in its Browserslist configuration, but this has now been removed.
• Remove utility classes for raw color tokens. (#405)
  • These colors were usually incorrect because they were using U.S. Web Design System defaults instead of the Login.gov Design System color set.
  • In most common cases, these should be replaced with stateful equivalents ("success" instead of "green") or theme colors ("base" instead of "gray-50").
  • Applies to the following utilities:
    • Background color (bg-*)
    • Border color (border-*)
    • Text color (text-*)
    • Outline color (outline-*)
    • Text underline color (underline-*)
  • The following colors are removed:
    • red (use error instead)
    • orange
    • gold
    • yellow (use warning instead)
    • green (use success instead)
    • mint
    • cyan
    • blue (use primary instead)
    • indigo
    • violet
    • magenta
    • gray-10 (use base-lighter instead)
    • gray-30 (use base-light instead)
    • gray-50 (use base instead)
    • gray-70 (use base-darker instead)
    • gray-90 (use base-darkest instead)
• Remove images not integral to the design system. (#410)
  • If you use any of these images, consider proposed alternatives below, or copy the image from the previous release into your project:
    • illustrations/fail.svg (legacy alert icon, new alert icons will be introduced in a future release)
    • illustrations/security-key.svg
    • angle-arrow-down-white-hover.svg (use expand_more icon instead)
    • angle-arrow-down-white.svg (use expand_more icon instead)
    • angle-arrow-down.svg (use expand_more icon instead)
    • angle-arrow-up-white-hover.svg (use expand_less icon instead)
    • angle-arrow-up-white.svg (use expand_less icon instead)
    • angle-arrow-up.svg (use expand_less icon instead)
    • close-primary.svg (use close icon instead)
    • close.svg (use close icon instead)
    • hero.png
• Align JavaScript component names with U.S. Web Design System. (#414)
  • header is now named navigation
  • validation is now named validator

Improvements

• Optimize images to reduce their size. (#411)
• Browser-ready JavaScript bundles are now minified. (#421)

New Features

• Add TypeScript types for JavaScript components. (#413)
• Include init.js as both a package entrypoint and precompiled asset within dist/assets/js, which provides the functionality of U.S. Web Design System's uswds-init.js script to reduce the appearance of flashing content during page load. See README Browser-Ready JavaScript Bundles for usage instructions. (#421)

Bug Fixes

• Add missing JavaScript exports for button, inPageNavigation, inputMask, languageSelector, and range. (#407)
• Fix dist/assets/js/main.js compilation to properly consider browser support. (#421)
• Fix strict ES Module import errors due to lack of fully-qualified file path when importing auto entrypoint. (#422)
• Fix background color when hovering an expanded navigation section on large viewport sizes. (#418)

Internal

• Replace code compiler Babel with ESBuild. (#387)
  • This is not expected to have a downstream impact, but there may be subtle differences in the compiled code due to this change.

8.1.2

Bug Fixes

• Fix issue with dual export backwards-compatibility resulting in errors loading in CommonJS projects. (#401)

9.0.0-beta.2

Bug Fixes

• Fix strict ES Module import errors due to lack of fully-qualified file path. (#400)

9.0.0-beta.1

Breaking Changes

• Prose styling overrides have been removed. Text formatting should now adhere to the defaults from the U.S. Web Design System.
• Drop support for Internet Explorer. (#387)
  • Support was indirectly dropped in v7.0.0 via the upgrade to USWDS v3.0.0, which similarly ended explicit support for Internet Explorer. This package had continued to include Internet Explorer in its Browserslist configuration, but this has now been removed.

Internal

• Replace code compiler Babel with ESBuild. (#387)
  • This is not expected to have a downstream impact, but there may be subtle differences in the compiled code due to this change.

8.1.1

Bug Fixes

• Fix strict ES Module import errors due to lack of fully-qualified file path. (#400)

8.1.0

New Features

• Add variant support for danger outline buttons. (#383)

Bug Fixes

• Improve consistency with USWDS disabled buttons styles. (#383)
  • USWDS v3.5.0 removed .usa-button--disabled styling in favor of [aria-disabled="true"]. This wasn't documented as a breaking change, and it's expected the any .usa-button--disabled usage would not be stylized correctly since those changes. You should replace any usage of usa-button--disabled with either the [disabled] or [aria-disabled="true"] attributes.

Dependencies

• Update USWDS from v3.6.1 to v3.7.1. (#381, #384)
  • See release notes:
    • https://github.com/uswds/uswds/releases/tag/v3.7.0
    • https://github.com/uswds/uswds/releases/tag/v3.7.1