uswds-extended 3.13.1

package/.browserslistrc

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

package/.storybook/main.js

@@ -0,0 +1,139 @@
+const path = require("path");
+const {
+  createJoinFunction,
+  createJoinImplementation,
+  asGenerator,
+  defaultJoinGenerator,
+} = require("resolve-url-loader");
+
+const imageDirectory = path.resolve("dist/img");
+const fontsDirectory = path.resolve("dist/fonts");
+
+// call default generator then append any additional paths
+const pathGenerator = asGenerator((item, ...rest) => [
+  ...defaultJoinGenerator(item, ...rest),
+  item.isAbsolute
+    ? null
+    : /\.(png|svg|jpg|jpeg|gif)$/.test(item.uri)
+      ? imageDirectory
+      : /\.(woff|woff2|eot|ttf|otf)$/.test(item.uri)
+        ? fontsDirectory
+        : null,
+]);
+
+const joinSassAssets = createJoinFunction(
+  "joinSassAssets",
+  createJoinImplementation(pathGenerator),
+);
+
+module.exports = {
+  core: {
+    builder: "webpack5",
+  },
+  stories: [
+    "../packages/**/*.stories.mdx",
+    "../packages/**/**/*.stories.@(js|jsx|ts|tsx)",
+  ],
+  addons: [
+    "@storybook/addon-links",
+    "@storybook/addon-essentials",
+    "@storybook/addon-a11y",
+  ],
+  staticDirs: ["../dist"],
+  webpackFinal: async (config, { configType }) => {
+    // `configType` has a value of 'DEVELOPMENT' or 'PRODUCTION'
+    // You can change the configuration based on that.
+    // 'PRODUCTION' is used when building the static version of storybook.
+    config.module.rules.push(
+      {
+        test: /\.twig$/,
+        use: "twigjs-loader",
+        resolve: {
+          alias: {
+            "@components": path.resolve(__dirname, "../packages"),
+            "@templates": path.resolve(__dirname, "../packages/templates"),
+          },
+        },
+      },
+      {
+        test: /\.s(c|a)ss$/i,
+        use: [
+          {
+            loader: "style-loader",
+          },
+          {
+            loader: "css-loader",
+            options: {
+              sourceMap: true,
+              esModule: false,
+            },
+          },
+          {
+            loader: "postcss-loader",
+            options: {
+              sourceMap: true,
+              postcssOptions: (loaderContext) => {
+                return {
+                  plugins: [
+                    ["postcss-import", { root: loaderContext.resourcePath }],
+                    ["postcss-discard-comments", { removeAll: true }],
+                    "postcss-preset-env",
+                    [
+                      "postcss-csso",
+                      { forceMediaMerge: false, comments: false },
+                    ],
+                  ],
+                };
+              },
+            },
+          },
+          {
+            loader: "resolve-url-loader",
+            options: {
+              join: joinSassAssets,
+            },
+          },
+          {
+            loader: "sass-loader",
+            options: {
+              sourceMap: true,
+              sassOptions: {
+                loadPaths: ["./packages", "./node_modules/@uswds"],
+                implementation: require("sass-embedded"),
+              },
+            },
+          },
+        ],
+        include: path.resolve(__dirname, "../packages"),
+      },
+      {
+        test: /\.(png|svg|jpg|jpeg|gif)$/i,
+        type: "javascript/auto",
+        use: {
+          loader: "file-loader",
+          options: {
+            name: "[name].[ext]",
+            //outputPath: "../dist/img",
+          },
+        },
+        include: path.resolve(__dirname, "../packages"),
+      },
+      {
+        test: /\.(woff|woff2|eot|ttf|otf)$/i,
+        type: "javascript/auto",
+        use: {
+          loader: "file-loader",
+          options: {
+            name: "[path][name].[ext]",
+          },
+        },
+        include: path.resolve(
+          __dirname,
+          "../packages/uswds-core/src/assets/fonts",
+        ),
+      },
+    );
+
+    return config;
+  },
+};

package/.storybook/preview-head.html

@@ -0,0 +1,27 @@
+<meta name="robots" content="noindex,nofollow" />
+<meta name="viewport" content="width=device-width" />
+
+<!-- Global styles -->
+<style>
+  #root {
+    box-sizing: border-box;
+  }
+
+  #root * {
+    box-sizing: border-box !important;
+  }
+
+  * {
+    box-sizing: border-box !important;
+  }
+
+  #root *:before,
+  #root *:after {
+    box-sizing: inherit;
+  }
+
+  html,
+  body {
+    font-size: 16px;
+  }
+</style>

package/.storybook/preview.js

@@ -0,0 +1,21 @@
+import "../packages/uswds-core/src/js/start";
+
+export const parameters = {
+  actions: { argTypesRegex: "^on[A-Z].*" },
+  controls: {
+    matchers: {
+      color: /(background|color)$/i,
+      date: /Date$/,
+    },
+  },
+  options: {
+    storySort: {
+      order: [
+        "Design Tokens",
+        "Components",
+        "Patterns",
+        "Pages",
+      ],
+    },
+  },
+};

package/CONTRIBUTING.md

@@ -0,0 +1,155 @@
+## Welcome!
+
+We’re glad you’re thinking about contributing to the U.S. Web Design System (USWDS)!
+
+USWDS is for everyone — we’re an open source project that accepts contributions from our community members. USWDS is the result of community contributions, large and small. Your contribution helps make the Design System better for the next team that uses it.
+
+## Code of Conduct
+
+USWDS is committed to building a safe, welcoming, harassment-free culture for everyone. USWDS is a part of the Technology Transformation Services (TTS) within the General Services Administration (GSA) and we expect everyone to follow the [GSA TTS Code of Conduct](https://handbook.tts.gsa.gov/about-us/code-of-conduct/).
+
+We encourage you to read this project’s Contribution Guide (you are here), its [LICENSE](https://github.com/uswds/uswds/blob/develop/LICENSE.md) and its [README](https://github.com/uswds/uswds/blob/develop/README.md). If you want to read more about our open source policy or have questions, check out the [18F Open Source Policy GitHub repository](https://github.com/18f/open-source-policy) or send us an [email](mailto:uswds@gsa.gov).
+
+## How you can contribute
+
+### Getting Started
+
+Anyone can contribute to USWDS. Whether it's submitting a bug or proposing a new component, we welcome your ideas on how to improve the Design System.
+
+First time contributor? We’re here to help guide you through a successful contribution. We review all contributions before merging them into USWDS. If you’re unsure about anything, just [ask](mailto:uswds@gsa.gov) — or submit your issue or pull request anyway to get the conversation started.
+
+Before submitting a contribution, you’ll just need to create a GitHub account or sign in to your existing account. You'll also need to set up [signature verification on your commits](#setting-up-verified-commits).
+
+If you want to see some other contributions before submitting your own, check out [some good first issues](https://github.com/uswds/uswds/issues?q=is%3Aissue+is%3Aopen+label%3A%22Good+First+Issue%22) from other community members. Again, if you have any questions, don’t hesitate to [reach out to us](mailto:uswds@gsa.gov).
+
+### Setting up verified commits
+> [!important]
+> For security reasons, all commits to this repository must have a verified signature. Use one of the following GitHub guides to set up your verification signature:
+> - [GPG commit signature verification](https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification#gpg-commit-signature-verification)
+> - [SSH commit signature verification](https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification#ssh-commit-signature-verification)
+
+### Reporting bugs and issues
+
+If something isn’t working the way it's supposed to, here’s how you can let us know:
+
+#### 1. Check the issues backlog to see if your bug has already been reported
+
+First, check our [current issues backlog](https://github.com/uswds/uswds/issues?q=is%3Aissue+is%3Aopen+label%3A%22Type%3A+Bug%22+) to see if your bug has already been reported.
+
+If your bug has already been reported, leave a comment in the original issue and provide any additional context (if different than the original submission). This helps us better understand the issue and its impact.
+
+#### 2. Document how to reproduce the bug
+
+Before submitting a bug, try to recreate it and document the steps we can take to reproduce it. If you can, take screen shots to capture specific details about the bug. This helps us understand its context. We can only fix bugs that we're able to understand and reproduce.
+
+#### 3. Submit an issue
+
+If your bug or issue is not in the [current issues backlog](https://github.com/uswds/uswds/issues?q=is%3Aissue+is%3Aopen+label%3A%22Type%3A+Bug%22+), submit an issue using the [bug report template](https://github.com/uswds/uswds/issues/new?assignees=&labels=Type%3A+Bug%2CStatus%3A+Triage%2CNeeds%3A+Confirmation&template=bug_report.yaml&title=USWDS+-+Bug%3A+%5BYOUR+TITLE%5D). A USWDS core team member may reach out to you if we need further clarification or context. We may also need your help testing possible solutions. Be sure to check in on your issue to answer any questions we may have about it.
+
+If you have a code fix for the issue, go ahead and submit a pull request. Our team tracks issues, so make sure any pull request you submit has a related issue.
+
+### Proposing feature requests or enhancements
+
+If you’ve got a new idea or a suggestion for how something could work better, we want to hear about it. Here are a few steps to help you submit a feature request or enhancement.
+
+#### 1. Check the backlog of current feature requests
+
+Check our [feature requests backlog](https://github.com/uswds/uswds/issues?q=is%3Aissue+is%3Aopen+label%3A%22Type%3A+Feature+Request%22) for any duplicate or similar feature requests.
+
+If your idea has already been suggested, upvote that feature request with a thumbs up emoji (👍) and comment on the issue to let us know why you need this feature request and any other supporting information. We review the number of upvotes (represented by 👍) to help us prioritize feature requests.
+
+If you want to find other feature requests open for upvoting, check out our [feature request view sorted by status](https://github.com/orgs/uswds/projects/8/views/18?sortedBy%5Bdirection%5D=asc&sortedBy%5BcolumnId%5D=Status).
+
+#### 2. Submit an issue
+
+If your idea is not in the [current issues backlog](https://github.com/uswds/uswds/issues?q=is%3Aissue+is%3Aopen+label%3A%22Type%3A+Feature+Request%22), submit an issue using the [feature request template](https://github.com/uswds/uswds/issues/new?assignees=&labels=Type%3A+Feature+Request%2CStatus%3A+Triage&template=feature_request.yaml&title=USWDS+-+Feature%3A+%5BYOUR+TITLE%5D).  A USWDS core team member may reach out to you if we need further clarification on your submission.
+
+
+### Submitting code contributions
+
+#### Getting started with USWDS code
+
+1. First, fork this repo into your GitHub account. Read more about [forking a repo on GitHub](https://help.github.com/articles/fork-a-repo/).
+1. Open your local copy of the repository then run the following command in terminal to install project dependencies:
+    ```sh
+    npm install
+    ```
+1. Now that all of your dependencies are installed, start your local server by running the following command:
+    ```sh
+    npm start
+    ```
+1. Open `localhost:6006` in your browser to see your local build of the the USWDS component library in Storybook.
+
+Here are a few other utility commands you may find useful:
+
+- `npm run lint`: Runs `eslint` and `sass-lint` against JavaScript and Sass files.
+- `npm run prettier`: Runs `prettier` against HTML, JavaScript, and Sass files.
+- `npm test`: Runs all tests and linters.
+
+#### Submitting a pull request for a bug fix:
+
+1. Check our [open issues backlog](https://github.com/uswds/uswds/issues) for any duplicate or similar issues.
+1. If your bug has already been submitted, feel free to comment and provide additional context (if different than the original submission).
+1. If your proposed fix is not in the open issues backlog, create an [issue](https://github.com/uswds/uswds/issues/new/choose) for the change you’re proposing. This helps us track our work.
+1. Follow the steps in the [Getting started with USWDS code](#getting-started-with-uswds-code) section above to get setup locally.
+1. Create a branch from `develop` and name it in a way that lightly defines what you’re working on (for example, `add-styles`).
+1. Once you’re ready to submit a pull request, fill out the [pull request template](https://github.com/uswds/uswds/compare).
+1. Link your pull request to the issue you created. This important step helps us know which issue this solution fixes. Tip: You can link the pull request in the body of the pull request template using the GitHub comment `closes #issue-no` or `resolves #issue-no`. You can read more about linking pull requests on [GitHub](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue).
+1. Submit your pull request against the `develop` branch.
+
+If the pull request is accepted, we will schedule the issue and merge the pull request for you.
+
+#### Submitting a pull request for a feature request or enhancement:
+
+1. Check our [open issues backlog](https://github.com/uswds/uswds/issues) for any duplicate or similar issues.
+1. If your idea has already been suggested, upvote that feature request with a thumbs up emoji (👍) and comment on the issue to let us know why you need this feature request or enhancement and any other supporting information.
+Tip: If you want to find other feature requests open for upvoting, check out our [feature requests sorted by upvotes](https://github.com/uswds/uswds/issues?q=is%3Aissue+is%3Aopen+label%3A%22Status%3A+Voting+Open+%F0%9F%91%8D%22+sort%3Areactions-%2B1-desc).
+1. If your proposed fix is not in the [open issues backlog](https://github.com/uswds/uswds/issues), [create an issue](https://github.com/uswds/uswds/issues/new?assignees=&labels=Type%3A+Feature+Request%2CStatus%3A+Triage&template=feature_request.yaml&title=USWDS+-+Feature%3A+%5BYOUR+TITLE%5D) describing your proposal. This doesn’t mean we don’t want you to create a pull request. We simply want to start the process with an online conversation first. Plus, other community members might have supporting thoughts to add to your proposal. If you’ve already got a pull request, no worries. Go ahead and attach it to the issue.
+
+### Proposing something else?
+
+If you’d like to contribute something else that doesn’t fall into any of the above, we’d still love to hear about it. Just create an issue or a discussion, and we can talk about it.
+
+## How we prioritize
+
+Once you’ve submitted a contribution, we'll triage it based on the following considerations:
+1. **Size:** Can we accomplish this in a sprint or will this take longer?
+1. **Severity:** What type of functionality is impacted? Is there a workaround?
+1. **Priority:** Does this align with our vision and roadmap goals?
+
+Note: We prioritize issues that affect accessibility.
+
+These considerations help us decide if and when we can work on the issue. If the issue is accepted, we will schedule them for an upcoming sprint (a 2-week work period).
+
+You can stay up to date on the status of your contributions through [GitHub email notifications](https://docs.github.com/en/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications) (external link) and the assigned labels on the issue.
+
+## Common terms
+
+There can be a lot of jargon when discussing how you can contribute to the Design System. We’ve included some common terms we use below.
+
+- **Backlog** - list of deliverables (like a feature request, enhancement, or bug) that should be implemented into upcoming product development.
+- **Bug** - problem resulting in something not working properly or as expected.
+- **Contribution** - when a community member gives back in a way that enhances the Design System by proposing a new idea, enhancement, or fix that’s released through the system for other people to use.
+- **Enhancement** - a proposal to make something existing in the Design System work better.
+- **Feature request** - a proposal for something new to be included to the Design System.
+- **Fork** - a copy of a repository that you manage.
+- **Open source** - something that can be viewed, modified, and shared by anyone in the public with permissions enforced through an open source license.
+- **Pull request** - a way to notify project team members when a contributor/developer wants to merge new code changes into a main project repository. You can read more on [GitHub](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) (external link).
+- **Repository (aka repo)** - In Github, a repository contains all your projects’ files and each of their revisions. You can read more on [GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/about-repositories) (external link).
+- **Roadmap** - a summary that outlines a product’s goals, priorities, and progress over a period of time.
+
+## Licenses and attribution
+
+### A few parts of this project are not in the public domain
+
+For complete attribution and licensing information for parts of the project that are not in the public domain, see the [LICENSE](https://github.com/uswds/uswds/blob/develop/LICENSE.md).
+
+### The rest of this project is in the public domain
+
+The rest of this project is in the worldwide [public domain](https://github.com/uswds/uswds/blob/develop/LICENSE.md#the-rest-of-this-project-is-in-the-worldwide-public-domain).
+
+This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).
+
+### Contributions will be released into the public domain
+
+All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

package/LICENSE.md

@@ -0,0 +1,83 @@
+## A few parts of this project are not in the public domain
+
+### Copyright ownership of Works created by U.S. federal employees
+
+This repository contains both the original design for Google Material Icons (the “Work”, as defined in Section 1 of the Apache 2.0 License) and modifications made by the General Services Administration (GSA). This repository combines the Work and these GSA modifications, which is a “Modified Version” of Material Icons.
+
+This repository also contains both original designs for Source Sans Pro, Merriweather, and Font Awesome (the “Font Software”, as defined in Section 1 of the SIL Open Font License, version 1.1) and modifications made by the General Services Administration (GSA). This repository combines the Work and these GSA modifications, which is a “Modified Version” of Source Sans Pro, Merriweather, Public Sans, and Font Awesome respectively.
+
+As a work of the United States Government, the software modifications made by GSA are not subject to copyright within the United States. Additionally, GSA waives copyright and related rights in its software modifications worldwide through the CC0 1.0 Universal Public Domain Dedication (https://creativecommons.org/publicdomain/zero/1.0/).
+
+The Work (as defined in the Apache 2.0 License) and Font Software (as defined in the SIL Open Font License, Version 1.1) remains subject to copyright under the respective open source license. The section below lists which works are subject to particular open source licenses.
+
+This Modified Version packaged as `dist/img/sprite.svg` contains both design elements under the Apache 2.0 License and design modifications by GSA released as CC0. It is a “joint work” made of the icon set and modifications combined into a single work.
+
+### Files licensed under the SIL Open Font License, Version 1.1
+
+The Source Sans Pro font files in `packages/uswds-core/src/assets/fonts/source-sans-pro` are a [customized subset](https://github.com/miguelsousa/source-sans-pro-subset) of [Source Sans Pro](https://github.com/adobe-fonts/source-sans-pro) owned by Adobe Systems Incorporated, licensed under the [SIL Open Font License, Version 1.1](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL_web), and copyright 2010, 2012, 2014 [Adobe Systems Incorporated], with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe Systems Incorporated in the United States or other countries.
+
+The Merriweather font files in `packages/uswds-core/src/assets/fonts/merriweather` are the version 2.001 files from [GitHub](https://github.com/EbenSorkin/Merriweather/releases/tag/v2.001) subsetted into Latin and with additional formats generated with [Transfonter](https://transfonter.org/), licensed under the [SIL Open Font License, Version 1.1](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL_web), and copyright [Sorkin Type Co](www.sorkintype.com) with Reserved Font Name 'Merriweather'.
+
+The Public Sans font files in `packages/uswds-core/src/assets/fonts/public-sans` are licensed under the [SIL Open Font License, Version 1.1](https://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL_web). Public Sans is a modification of Libre Franklin, copyright [Impallari Type](www.impallari.com).
+
+
+### Files licensed under the Apache 2.0 License
+
+The Roboto Mono font files in `packages/uswds-core/src/assets/fonts/roboto-mono` are licensed under the [Apache License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt).
+
+The Google Material Icons in `packages/usa-icon/src/img/material-icons-deprecated`, and those packaged as `dist/img/material-icons` are licensed under the [Apache License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt).
+
+### Files licensed under the MIT license
+
+The files in `packages/uswds-elements/lib` are modified from:
+
+- [`normalize.css`](https://github.com/necolas/normalize.css), copyright Nicolas Gallagher and Jonathan Neal, under the [MIT license](https://github.com/necolas/normalize.css/blob/master/LICENSE.md).
+- [`modern-normalize`](https://github.com/sindresorhus/modern-normalize/tree/main), copyright Sindre Sorhus, Nicolas Gallagher, and Jonathan Neal, under the [MIT license](https://github.com/sindresorhus/modern-normalize/blob/main/license).
+
+### Files licensed under the CC0 1.0 Universal license
+
+The files in `packages/uswds-elements/lib` are modified from:
+
+- [`@csstools/normalize.css`](https://github.com/csstools/normalize.css), copyright Jonathan Neal, under the [CC0 1.0 Universal license](https://github.com/csstools/normalize.css/blob/main/LICENSE.md).
+
+#### Full license text for the MIT licensed files:
+
+```
+The MIT License (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## The rest of this project is in the worldwide public domain
+
+As a work of the United States government, this project is in the public domain within the United States.
+
+Additionally, we waive copyright and related rights in the work worldwide through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).
+
+### CC0 1.0 Universal Summary
+
+This is a human-readable summary of the [Legal Code (read the full text)](https://creativecommons.org/publicdomain/zero/1.0/legalcode).
+
+#### No copyright
+
+The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law.
+
+You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.
+
+#### Other information
+
+In no way are the patent or trademark rights of any person affected by CC0, nor are the rights that other persons may have in the work or in how the work is used, such as publicity or privacy rights.
+
+Unless expressly stated otherwise, the person who associated a work with this deed makes no warranties about the work, and disclaims liability for all uses of the work, to the fullest extent permitted by applicable law. When using or citing the work, you should not imply endorsement by the author or the affirmer.
+
+### Contributions to this project
+
+As stated in [CONTRIBUTING](CONTRIBUTING.md), all contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.
+
+### Trademark
+
+GSA owns, reserves, and retains all rights, title, and interest in all trademarks owned by GSA. The User does not acquire any right or interest of any kind in any GSA trademark because of their use of the Modified Version or any of the modifications made to the Work by GSA.