Merge branch 'main' into rc-file-input-checklist

.browserslistrc

@@ -1,5 +1,4 @@
 # Supported browsers
 > 2%
 last 2 versions
-IE 11
 not dead

.github/CODEOWNERS

@@ -0,0 +1,67 @@
+*       @uswds/admins
+
+# This is a comment.
+# Each line is a file pattern followed by one or more owners.
+
+# These owners will be the default owners for everything in
+# the repo. Unless a later match takes precedence,
+# @global-owner1 and @global-owner2 will be requested for
+# review when someone opens a pull request.
+# *       @global-owner1 @global-owner2
+
+# Order is important; the last matching pattern takes the most
+# precedence. When someone opens a pull request that only
+# modifies JS files, only @js-owner and not the global
+# owner(s) will be requested for a review.
+# *.js    @js-owner #This is an inline comment.
+
+# You can also use email addresses if you prefer. They'll be
+# used to look up users just like we do for commit author
+# emails.
+# *.go docs@example.com
+
+# Teams can be specified as code owners as well. Teams should
+# be identified in the format @org/team-name. Teams must have
+# explicit write access to the repository. In this example,
+# the octocats team in the octo-org organization owns all .txt files.
+# *.txt @octo-org/octocats
+
+# In this example, @doctocat owns any files in the build/logs
+# directory at the root of the repository and any of its
+# subdirectories.
+# /build/logs/ @doctocat
+
+# The `docs/*` pattern will match files like
+# `docs/getting-started.md` but not further nested files like
+# `docs/build-app/troubleshooting.md`.
+# docs/*  docs@example.com
+
+# In this example, @octocat owns any file in an apps directory
+# anywhere in your repository.
+# apps/ @octocat
+
+# In this example, @doctocat owns any file in the `/docs`
+# directory in the root of your repository and any of its
+# subdirectories.
+# /docs/ @doctocat
+
+# In this example, any change inside the `/scripts` directory
+# will require approval from @doctocat or @octocat.
+# /scripts/ @doctocat @octocat
+
+# In this example, @octocat owns any file in a `/logs` directory such as
+# `/build/logs`, `/scripts/logs`, and `/deeply/nested/logs`. Any changes
+# in a `/logs` directory will require approval from @octocat.
+# **/logs @octocat
+
+# In this example, @octocat owns any file in the `/apps`
+# directory in the root of your repository except for the `/apps/github`
+# subdirectory, as its owners are left empty.
+# /apps/ @octocat
+# /apps/github
+
+# In this example, @octocat owns any file in the `/apps`
+# directory in the root of your repository except for the `/apps/github`
+# subdirectory, as this subdirectory has its own owner @doctocat
+# /apps/ @octocat
+# /apps/github @doctocat

.tool-versions

@@ -1,2 +1,2 @@
 ruby 3.2.5
-nodejs 20.9.0
+nodejs 22.11.0

_components/step-indicator/guidance/accessibility.md

@@ -1,5 +1,4 @@
 - **Use semantic heading levels.** Though our default code uses an `<h4>`, use the correct heading level in your own implementation.
-- **Use aria-label="progress".** Placing this `aria-label` on the element with the class `usa-step-indicator` helps provide important context to screen readers.
 - **Use visually hidden text on labels.** Use visually hidden text make the completion status of each step explicit.
 - **Indicate the current step.** When using labeled segments, use `aria-current="true"` on the list item representing the current step.
-- **Hide unlabeled segments.** There is no content inside the segments when labels aren't used, so it is safe to add `aria-hidden="true"` to the element with the class name `usa-step-indicator__segments`.
+- **Hide unlabeled segments.** There is no content inside the segments when labels aren't used, so it is safe to add `aria-hidden="true"` to the element with the class name `usa-step-indicator__segments`.

_config.yml

@@ -2,7 +2,7 @@
 title: U.S. Web Design System (USWDS)
 description: USWDS makes it easier to build accessible, mobile-friendly government websites.
 google_analytics_ua: UA-48605964-43
-uswds_version: 3.9.0
+uswds_version: 3.10.0
 uswds_email: uswds@gsa.gov
 federalist_base: "https://federalist-3b6ba08e-0df4-44c9-ac73-6fc193b0e19c.sites.pages.cloud.gov/preview/uswds/uswds"
 federalist_component_preview: "iframe.html?id="
@@ -44,7 +44,7 @@ jekyll_get:
     json: "https://api.github.com/repos/uswds/uswds/contents/SECURITY.md"
     decode_content: true
   - data: hash
-    json: "https://api.github.com/repos/uswds/uswds/contents/security/uswds-3.9.0-zip-hash.txt?ref=main"
+    json: "https://api.github.com/repos/uswds/uswds/contents/security/uswds-3.10.0-zip-hash.txt?ref=main"
     decode_content: true
 
 repos:

_data/changelogs/component-checkbox.yml

@@ -2,6 +2,14 @@ title: Checkbox
 type: component
 changelogURL:
 items:
+  - date: 2024-11-13
+    summary: Removed style tags from indeterminate checkbox SVGs.
+    summaryAdditional: |
+      These style tags were unnecessary and caused a conflict with some automated testing tools.
+    affectsAssets: true
+    githubPr: 6162
+    githubRepo: uswds
+    versionUswds: 3.10.0
   - date: 2024-09-18
     summary: Added WCAG compliance tag and accessibility test status section.
     affectsGuidance: true

_data/changelogs/component-combo-box.yml

@@ -2,6 +2,14 @@ title: Combo box
 type: component
 changelogURL:
 items:
+  - date: 2024-11-13
+    summary: Updated the order of combo box search results.
+    summaryAdditional:  The component now displays options that start with the query at the top of the list, followed by options that contain the query. This behavior more closely aligns with user expectations.
+    isBreaking: false
+    affectsJavascript: true
+    githubPr: 6122
+    githubRepo: uswds
+    versionUswds: 3.10.0
   - date: 2024-10-04
     summary: Removed custom screen reader instructions.
     summaryAdditional: Combo box now relies on the default instructions provided by screen readers.

_data/changelogs/component-file-input.yml

@@ -7,6 +7,13 @@ items:
     affectsGuidance: true
     githubPr: 2963
     githubRepo: uswds-site
+  - date: 2024-11-13
+    summary:  Fixed a bug that caused image previews to break when a Content Security Policy is enabled.
+    summaryAdditional: The component now uses event listeners in place of inline JavaScript to handle error states.
+    affectsJavascript: true
+    githubPr: 5997
+    githubRepo: uswds
+    versionUswds: 3.10.0
   - date: 2024-03-13
     summary: Added known issues section.
     summaryAdditional:

_data/changelogs/component-modal.yml

@@ -2,6 +2,14 @@ title: Modal
 type: component
 changelogURL:
 items:
+- date: 2024-11-13
+  summary: Fixed a bug that prevented bundling the modal package with a custom prefix.
+  summaryAdditional: This update removed hard-coded class names from the modal JavaScript.
+  isBreaking: false
+  affectsJavascript: true
+  githubPr: 6026
+  githubRepo: uswds
+  versionUswds: 3.10.0
 - date: 2024-11-6
   summary: Added focus trap guidance.
   summaryAdditional: Updated guidance to ensure users trap focus inside the modal so that it doesn't move to the content behind it.

_data/changelogs/component-step-indicator.yml

@@ -1,10 +1,17 @@
 title: Step indicator
 type: component
-# Provide url for the package CHANGELOG.md. Note: Not all pages will have a related CHANGELOG.md file.
 changelogURL:
 
 items:
-  # 3.4.0 release
+  - date: 2024-11-13
+    summary: Removed the `aria-label` from the wrapper of the step indicator component.
+    summaryAdditional: This resolves an error related to having an invalid attribute on a `div` element.
+    affectsAccessibility: true
+    affectsMarkup: true
+    affectsGuidance: true
+    githubPr: 6146
+    githubRepo: uswds
+    versionUswds: 3.10.0
   - date: 2023-03-09
     summary: Improved contrast on pending items.
     summaryAdditional: Graphical elements related to pending items now meet accessibility standards for contrast ratio.
@@ -14,7 +21,6 @@ items:
     githubPr: 5048
     githubRepo: uswds
     versionUswds: 3.4.0
-  # 3.0 release
   - date: 2022-04-28
     summary: Updated to Sass module syntax and new package structure.
     isBreaking: true

_data/changelogs/component-time-picker.yml

@@ -1,9 +1,16 @@
 title: Time picker
 type: component
-# Provide url for the package CHANGELOG.md. Note: Not all pages will have a related CHANGELOG.md file.
 changelogURL:
 
 items:
+  - date: 2024-11-13
+    summary: Updated the time picker hint text to improve clarity.
+    summaryAdditional: This update allows the component to meet the success criteria in [WCAG 3.3.2](https://www.w3.org/WAI/WCAG21/Understanding/labels-or-instructions.html).
+    affectsAccessibility: true
+    affectsContent: true
+    githubPr: 6147
+    githubRepo: uswds
+    versionUswds: 3.10.0
   - date: 2024-11-07
     summary: Added WCAG compliance tag and accessibility test status section.
     affectsGuidance: true

_includes/step-indicator.html

@@ -1,4 +1,4 @@
-<div class="usa-step-indicator" aria-label="progress">
+<div class="usa-step-indicator">
   <ol class="usa-step-indicator__segments">
     {% for step in page.steps %}
       {% if step.status == "completed" %}

config/gulp/build.js

@@ -67,8 +67,8 @@ function buildUSWDSComponents() {
     /**
      * We need to: install USWDS deps and build components to HTML.
      */
-    return spawnP("npm", ["install", "--legacy-peer-deps"], sharedOpts).then(
-      () => spawnP("npm", ["run", "build:html"], sharedOpts),
+    return spawnP("npm", ["install"], sharedOpts).then(() =>
+      spawnP("npm", ["run", "build:html"], sharedOpts),
     );
   }
 }