USWDS 3.12.0
What's new in USWDS 3.12.0
Features
Package | A11y | Breaking | Markup change | Description |
---|---|---|---|---|
usa-date-picker , usa-date-range-picker |
- | - | - | Enabled native JavaScript translation for date picker calendar labels. The calendar now uses the Date.toLocaleString API to automatically build translated labels based on the document's lang attribute. Thanks @deebloo! (#5679) |
usa-in-page-navigation |
- | - | - | Added the data-minimum-heading-count property to the in-page navigation component. This property hides the component when the content region does not contain the minimum number of headings. By default, this attribute hides the in-page navigation component when there are fewer than two headings in the content region. ✏️ Teams should customize the value of this property based on their content needs. (#6205) |
usa-tooltip |
- | - | - | Enabled tooltip functionality on non-button elements. Thanks @anmazz! (#6035) |
Bug fixes
Package | A11y | Breaking | Markup change | Description |
---|---|---|---|---|
usa-checkbox , usa-radio |
- | - | - | Updated checkbox and radio styles so that the interactive area now matches the width of the content. Previously, the interactive area extended the full width of its container. (#6192) |
usa-in-page-navigation |
- | - | - | Fixed a bug that prevented in-page navigation from scrolling to nested headings. Now, the component can smooth scroll to headings within components like card and summary box. ✏ Teams that use data-scroll-offset should check to make sure this change does not cause regressions in scroll behaviors. Thanks @jhancock532! (#5878) |
uswds-core |
- | - | - | Resolved Sass deprecation warnings related to the color function. This change ensures compatibility with Dart Sass 2.0.0 and eliminates the use of deprecated color functions. (#6270) |
uswds-core |
- | - | - | Replaced resolve-id-refs dependency with custom JavaScript. (#6308) |
Dependencies and security
Dependency updates
Dependency name | Previous version | New version |
---|---|---|
resolve-id-refs | 0.1.0 | -- |
Dev dependency updates
Dependency name | Previous version | New version |
---|---|---|
@babel/core | 7.26.0 | 7.26.8 |
@babel/preset-env | 7.26.0 | 7.26.8 |
gulp-sass | 5.1.0 | 6.0.0 |
postcss | 8.4.49 | 8.5.2 |
sass | 1.83.1 | 1.84.0 |
sass-embedded | 1.83.1 | 1.83.4 |
sass-loader | 13.3.2 | 16.0.4 |
snyk | 1.1295.0 | 1.1295.3 |
stylelint | 16.11.0 | 16.12.0 |
typescript | 5.7.2 | 5.7.3 |
webpack | 5.97.1 | 5.98.0 |
Additional updates
Important

Advertisement
USWDS now requires a verified signature on all commits to this repository. Learn more about how to set up signature verification in our CONTRIBUTING.md file.
Additional contributions
- Thanks to @aduth for making our prettier configuration more explicit. (#6269)
- Thanks to @szepeviktor for fixing typos. (#6251)
- Thanks to @jcklpe for updating broken links in the USWDS README. (#6239)
- Thanks to @aduth for improving the JavaScript examples in our README (#5928)
- Thanks to @aduth for improving our automated unit test scans (#6171)

Advertisement
0
vulnerabilities in regular dependencies (dependencies for USWDS projects installed with npm install @uswds/uswds
)
30
moderate, 26
high vulnerabilities in devDependencies (development dependencies).
Release TGZ SHA-256 hash: 8a562ec0c24d93b7eeaeaa9056f54050054344331dd34ca96d5be161442f09cd