Skip to content

v0.7.2

Pre-release
Pre-release

Choose a tag to compare

View all tags
@abbybowman abbybowman released this 20 May 21:12
v0.7.2
af25288
This commit was signed with the committer’s verified signature.
abbybowman
SSH Key Fingerprint: dumTWgu9fPgNaOSQmXLUIDshUh9sm0JNYm2Uz6oFVOI
Verified
Learn about vigilant mode.

Breaking Changes

CSS bundle architecture has changed. Review the updated load contract in README before upgrading.

  • hds.css is now self-contained. It includes all USWDS components, themed and unthemed. The two-file mandatory load requirement is removed.
  • hds-uswds.css is now utilities-only. Load it only if your site uses USWDS utility classes (padding-*, margin-*, etc.). If you don't use utility classes, you no longer need this file.
  • CSS cascade layers are now enforced. Layer order: uswds / uswds-utilities / hds-base / hds-components / hds-dataviz. Custom overrides should target the appropriate layer.
  • Unminified CSS files are no longer included in dist/. Reference .min.css files only.

Mandatory load is now 43 KB gzipped, down from 101 KB across two required files.

Bug Fixes

P0 -- Public Sans was silently falling back to system fonts sitewide. public-sans was incorrectly listed in $theme-typeface-tokens, which caused USWDS to treat it as a custom font and never generate @font-face rules for it. All Public Sans text was rendering in the system default font. (#59)

Inter and DM Mono were loading incomplete font sets. Source files were a partial mix of woff, ttf, and woff2 formats, causing weight-specific fallbacks to Arial and system monospace. Replaced with canonical woff2-only sets trimmed to confirmed-used weights. (#59)

Visually-hidden mixin used deprecated clip property. Replaced with clip-path. (#56)

Stylelint was flagging compiled CSS in dist/. Added .stylelintignore to exclude dist/ from both CLI and VS Code extension linting. (af25288)

Improvements

Font duplication eliminated. @font-face declarations dropped from 144 to 6 by fixing a meta.load-css() compilation issue that was emitting fonts once per package. (#60)

Font files trimmed to woff2-only. dist/assets/fonts/ drops 36 redundant woff/ttf files. All browsers in .browserslistrc support woff2. (#59, #60)

New --hds-font-family-* custom properties added to the public API surface. (#59)

Build pipeline simplified -- one PostCSS pass per bundle, down from two. Intermediate unminified files are cleaned up automatically. (#60)

Cascade layers for USWDS integration -- HDS styles now wrap USWDS in @layer uswds, eliminating load-order specificity conflicts. (#52)

Developer / Tooling

Four linters now configured and passing clean: Prettier (#54), Stylelint (#55), ESLint (#57), remark-lint (#58).

Windows / Git Bash local dev compatibility fixes. (#53)

Artifacts

  • hds-core-v0.7.2-dist.zip -- compiled CSS and font assets

Known Deferred Items

  • Inter Display variable weights -- pending introduction of display-size tokens
  • Variable font loading -- blocked on USWDS skeleton team alignment, deferred post-v1.0
  • hds-uswds.css is larger than expected at 47.9 KB gzipped for a utilities-only bundle. Investigation ongoing; does not affect mandatory load.
Assets 3
Loading