qpp-style 0.0.9 → 1.0.0-bv.0

package/.editorconfig

@@ -6,7 +6,7 @@ root = true
 
 [*]
 indent_style = space
-indent_size = 4
+indent_size = 2
 end_of_line = lf
 charset = utf-8
 trim_trailing_whitespace = true

package/.eslintrc.js

@@ -1,31 +1,32 @@
 module.exports = {
-    extends: ['eslint:recommended', 'plugin:react/recommended'],
-    parser: 'babel-eslint',
-    parserOptions: {
-        sourceType: 'module',
-        ecmaFeatures: {
-            jsx: true
-        }
+  extends: ["eslint:recommended", "plugin:react/recommended"],
+  parser: "@babel/eslint-parser",
+  parserOptions: {
+    sourceType: "module",
+    ecmaFeatures: {
+      jsx: true,
     },
-    env: {
-        es6: true,
-        node: true,
-        browser: true,
-        jquery: true,
-        mocha: true
-    },
-    rules: {
-        'no-unused-vars': [
-            'error',
-            {
-                args: 'none'
-            }
-        ],
-        'linebreak-style': ['error', 'unix'],
-        'no-console': 0,
-        'no-prototype-builtins': [0]
-    },
-    settings: {
-        react: { version: 'detect' }
-    }
+  },
+  env: {
+    es6: true,
+    node: true,
+    browser: true,
+    jquery: true,
+    mocha: true,
+  },
+  rules: {
+    "no-unused-vars": [
+      "error",
+      {
+        args: "none",
+      },
+    ],
+    "linebreak-style": ["error", "unix"],
+    "no-console": 0,
+    "no-prototype-builtins": [0],
+    "react/no-deprecated": [0],
+  },
+  settings: {
+    react: { version: "detect" },
+  },
 };

package/.husky/pre-commit

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+cd react
+npm run precommit

package/.prettierrc

@@ -0,0 +1 @@
+{}

package/README.md

@@ -0,0 +1,60 @@
+# QPP-Style React
+
+This directory contains react implementations of the components for QPP.
+
+## Github Branch and Pull Request process
+
+1. Create branch off main and create a Pull Request into main for the feature.
+   > Example Branch Name: feature/QPPXX-XXXX_make_icon_better
+2. Once merged into main, create release branch from main.
+3. Name the new branch release/x.xx.x
+4. Run the version bump:
+
+```bash
+cd qpp-style/react
+npm version --no-git-tag-version patch
+```
+
+Example Commit Message:
+
+> x.xx.x release
+
+5. Create a pull request against main with the PR Title: x.xx.x release [Example PR](https://github.com/CMSgov/qpp-style/pull/1065)
+6. Enter the change in the description of the pull request i.e.:
+   > Added new svg for Icon Name
+
+## Generate an NPM token with Publish permissions
+
+1. If you do not already have an access token, sign in to npmjs.com and navigate to access tokens.
+2. Click generate new token.
+3. Select publish under type.
+4. Copy the npm token and set its value as the environment variable: NPM_TOKEN
+
+```bash
+export NPM_TOKEN={npm_token}
+```
+
+## Publish the react qpp-style npm package (used by both react and angular)
+
+```bash
+cd qpp-style/react
+npm i
+npm publish
+```
+
+7. Once published successfully, merge into main.
+
+The Side Nav contains multiple item array types: divider, container, linkBack, linkHome, practiceDetails, individualDetails, linkDrawer, custom, chart, and switchLink.
+
+| Item Array Type   | Description                                                                                                                                                                                                                                                                                    |
+|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| divider           | <hr> element that is located above and below the practice container.                                                                                                                                                                                                                           |
+| container         | gets Dynamic Content of multiple items and contains the linkDrawer item. Level One and Level Two content are located in this container.                                                                                                                                                        |
+| linkBack          | <button> that links the user back to a URL. This uses a chevron Left icon.                                                                                                                                                                                                                     |
+| linkHome          | <a> tag element which sends the user back to the “Account Home” page /user/submissions. This uses the home icon SVG and is located at the top of the side nav.                                                                                                                                 |
+| practiceDetails   | <div> element with the class name practice-container. Inside this container is the <h2> element which includes the Practice Name and the <p> element which is the Practice Tin. The Practice Tin shows either the CPC+ ID, PCF ID, APM Entity ID, VG ID, or Practice Tin.                      |
+| individualDetails | <div> element with the class name “individual-container”. This parent element contains two other elements which are the <h3> Individual Name and the <p> Individual NPI.                                                                                                                       |
+| linkDrawer        | This is the most complex item type. This item displays the Level One and Level Two <button> elements which contain navigation links depending on each page as well as specific SVG icons. Depending on the page there can be multiple links to the user can access quickly using the side nav. |
+| custom            | This option is for sanitized HTML content. This custom HTML will be cleaned of any potentially harmful elements that could compromise the security of the web app.                                                                                                                             |
+| chart             | This option uses the ScoreChart component to display Chart Data on the Side Nav. This data includes categories from Quality Measures, Advancing Care Info, Promoting Interoperability, Improvement Activities, and Cost.                                                                       |
+| switchLink        | This is an implementation of the “Switch Practice” button for the Side Nav. Clicking 'Switch Practice' will take the user back to the TIN list for the part of the application they are viewing.                                                                                               |

package/components/Accordion/index.jsx

@@ -1,57 +1,49 @@
-import React, { useState, useRef } from 'react';
-import PropTypes from 'prop-types';
-
-const Chevron = (props) => {
-  return (
-    <svg
-      className={props.className}
-      height="14"
-      width="14"
-      viewBox="0 0 200 450"
-      xmlns="http://www.w3.org/2000/svg"
-    >
-      <path
-        d="m258.476 235.971-194.344 194.343c-9.373 9.373-24.569 9.373-33.941 0l-22.667-22.667c-9.357-9.357-9.375-24.522-.04-33.901l154.021-154.746-154.021-154.745c-9.335-9.379-9.317-24.544.04-33.901l22.667-22.667c9.373-9.373 24.569-9.373 33.941 0l194.343 194.343c9.373 9.372 9.373 24.568.001 33.941z"
-        fill="#242424"
-      />
-    </svg>
-  );
-};
-
-Chevron.propTypes = {
-  className: PropTypes.string,
-};
-
-Chevron.defaultProps = {
-  className: 'accordion-icon',
-};
+import React, { useState, useRef, useEffect } from "react";
+import PropTypes from "prop-types";
+import { Chevron } from "../../lib/Chevron.jsx";
 
 const Accordion = (props) => {
-  const [setActive, setActiveState] = useState('');
-  const [setAriaPressed, setAriaPressedState] = useState(false);
-  const [setHeight, setHeightState] = useState('0px');
-  const [setRotate, setRotateState] = useState('accordion-icon');
-
   const content = useRef(null);
+  const [setActive, setActiveState] = useState(props.isOpen ? "active" : "");
+  const ariaPressed = setActive ? "true" : "false";
+  const getHeight = (node) => {
+    if (node) {
+      return `${node.scrollHeight}px`;
+    }
+    return "auto";
+  };
+  const height = setActive ? getHeight(content.current) : "0px";
+  const rotate = setActive ? "accordion-icon rotate" : "accordion-icon";
 
   function toggleAccordion() {
-    setActiveState(setActive === '' ? 'active' : '');
-    setAriaPressedState(setActive === '' ? 'true' : 'false');
-    setHeightState(
-      setActive === 'active' ? '0px' : `${content.current.scrollHeight}px`
-    );
-    setRotateState(
-      setActive === 'active' ? 'accordion-icon' : 'accordion-icon rotate'
-    );
+    setActiveState(setActive === "" ? "active" : "");
+  }
+
+  function openAccordion() {
+    setActiveState("active");
   }
 
+  function closeAccordion() {
+    setActiveState("");
+  }
+
+  useEffect(() => {
+    if (props.isOpen) {
+      openAccordion();
+    } else {
+      closeAccordion();
+    }
+  }, [props.isOpen]);
+
   return (
-    <div className="accordion-section">
+    <div className="accordion-section" data-testid="accordion">
       <button
-        className={`accordion ${setActive}`}
+        className={`accordion ${setActive} ${
+          setActive && props.isSticky ? "sticky" : ""
+        }`}
         aria-label={props.title}
-        aria-pressed={setAriaPressed}
-        aria-expanded={setAriaPressed}
+        aria-pressed={ariaPressed}
+        aria-expanded={ariaPressed}
         tabIndex="0"
         onClick={toggleAccordion}
       >
@@ -72,12 +64,12 @@ const Accordion = (props) => {
           </div>
         )}
         <div className="chevron-container">
-          <Chevron className={`${setRotate}`} />
+          <Chevron className={rotate} />
         </div>
       </button>
       <div
         ref={content}
-        style={{ maxHeight: `${setHeight}` }}
+        style={{ maxHeight: height }}
         className="accordion-content"
       >
         <div className="accordion-text dashed-border">{props.children}</div>
@@ -92,10 +84,14 @@ Accordion.propTypes = {
   children: PropTypes.any.isRequired,
   centerItem: PropTypes.string,
   rightItem: PropTypes.string,
+  isOpen: PropTypes.bool,
+  isSticky: PropTypes.bool,
 };
 
 Accordion.defaultProps = {
-  title: '',
+  title: "",
+  isOpen: false,
+  isSticky: false,
 };
 
 export default Accordion;

package/components/Alert/index.js

@@ -0,0 +1,53 @@
+import React from "react";
+import PropTypes from "prop-types";
+
+const Alert = ({
+  title,
+  children,
+  description,
+  variant,
+  className,
+  ...rest
+}) => {
+  const HeadingComponent = title?.headingLevel || "h2";
+  return (
+    <div
+      className={`qpp-c-alert qpp-c-alert--${variant} ${className}`}
+      role="alert"
+      {...rest}
+    >
+      <div className="qpp-c-alert__body">
+        {title && (
+          <HeadingComponent className="h4 qpp-c-alert__heading">
+            {typeof title === "object" ? title.text : title}
+          </HeadingComponent>
+        )}
+        {description && <p className="qpp-c-alert__text">{description}</p>}
+        {children}
+      </div>
+    </div>
+  );
+};
+
+Alert.propTypes = {
+  children: PropTypes.node,
+  className: PropTypes.string,
+  description: PropTypes.string,
+  title: PropTypes.oneOfType([
+    PropTypes.string,
+    PropTypes.shape({
+      text: PropTypes.string,
+      headingLevel: PropTypes.string,
+    }),
+  ]),
+  variant: PropTypes.oneOf(["info", "warning", "success", "error"]),
+};
+Alert.defaultProps = {
+  children: null,
+  className: "",
+  description: null,
+  title: null,
+  variant: "info",
+};
+
+export default Alert;

package/components/Breadcrumb/index.js

@@ -1,5 +1,5 @@
-import React from 'react';
-import PropTypes from 'prop-types';
+import React from "react";
+import PropTypes from "prop-types";
 
 const Breadcrumb = ({
   breadcrumbClass,
@@ -11,7 +11,7 @@ const Breadcrumb = ({
   return (
     <nav
       className={`qpp-c-breadcrumbs ${
-        !dark ? 'qpp-c-breadcrumbs--light' : ''
+        !dark ? "qpp-c-breadcrumbs--light" : ""
       } ${breadcrumbClass}`}
       aria-label="Breadcrumbs"
     >
@@ -50,12 +50,12 @@ const Breadcrumb = ({
             return (
               <li
                 key={crumb}
-                className="qpp-c-breadcrumbs__list-item qpp-c-breadcrumbs__list-item--current"
+                className={`${
+                  i === crumbs.length - 1 ? "sr-only" : ""
+                } qpp-c-breadcrumbs__list-itemqpp-c-breadcrumbs__list-item--current`}
                 aria-current="page"
               >
-                <span className={i === crumbs.length - 1 ? 'sr-only' : ''}>
-                  {crumb}
-                </span>
+                <span>{crumb}</span>
               </li>
             );
           }
@@ -74,7 +74,7 @@ Breadcrumb.propTypes = {
 };
 
 Breadcrumb.defaultProps = {
-  breadcrumbClass: '',
+  breadcrumbClass: "",
   dark: false,
   RouterLink: null,
   routerExcludedLinks: [],

package/components/Button/index.js

@@ -1,8 +1,8 @@
-import React from 'react';
-import PropTypes from 'prop-types';
+import React from "react";
+import PropTypes from "prop-types";
 
-const VARIANTS = ['secondary', 'outline', 'danger', 'white']
-const SIZES = ['big']
+const VARIANTS = ["secondary", "outline", "danger", "white"];
+const SIZES = ["big"];
 
 const Button = ({
   children,
@@ -12,22 +12,29 @@ const Button = ({
   onClick,
   size,
   variant,
+  type,
+  ...rest
 }) => {
-  let btnClass = 'qpp-c-button';
+  let btnClass = "qpp-c-button";
 
   if (VARIANTS.includes(variant)) {
-    btnClass = btnClass.concat(' ', `qpp-c-button--${variant}`);
+    btnClass = btnClass.concat(" ", `qpp-c-button--${variant}`);
   }
   if (SIZES.includes(size)) {
-    btnClass = btnClass.concat(' ', `qpp-c-button--${size}`);
+    btnClass = btnClass.concat(" ", `qpp-c-button--${size}`);
   }
   if (className) {
-    btnClass = btnClass.concat(' ', className);
+    btnClass = btnClass.concat(" ", className);
   }
 
   if (href) {
     return (
-      <a href={href} data-testid="ds-btn" className={btnClass || ''}>
+      <a
+        href={href}
+        data-testid="ds-btn"
+        className={btnClass || ""}
+        onClick={onClick}
+      >
         {children}
       </a>
     );
@@ -35,9 +42,11 @@ const Button = ({
   return (
     <button
       data-testid="ds-btn"
-      className={btnClass || ''}
+      className={btnClass || ""}
       onClick={onClick}
       disabled={loading}
+      type={type}
+      {...rest}
     >
       {children}
     </button>
@@ -51,29 +60,31 @@ Button.propTypes = {
   loading: PropTypes.bool,
   onClick: PropTypes.func,
   size: PropTypes.oneOf(SIZES),
+  type: PropTypes.string,
   variant: PropTypes.oneOf(VARIANTS),
 };
 
 Button.defaultProps = {
   children: false,
-  className: '',
-  href: '',
+  className: "",
+  href: "",
   loading: false,
   onClick: () => null,
   size: null,
+  type: "button",
   variant: null,
 };
 
-export const TextButton = ({ className = '', ...props }) => (
+export const TextButton = ({ className = "", ...props }) => (
   <Button className={`qpp-c-button--text ${className}`} {...props} />
-)
+);
 
 TextButton.propTypes = {
   className: PropTypes.string,
-}
+};
 
 TextButton.defaultProps = {
-  className: '',
-}
+  className: "",
+};
 
 export default Button;

package/components/Details/DetailsIcons.js

@@ -0,0 +1,50 @@
+import React from "react";
+import PropTypes from "prop-types";
+
+export const Add = ({ iconText }) => (
+  <>
+    <svg
+      className="qpp-c-details--icon-closed qpp-icon-mat qpp-icon-inline--md"
+      aria-hidden="true"
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+      role="img"
+      focusable="false"
+    >
+      <path d="M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6v2z" />
+    </svg>{" "}
+    {iconText}
+  </>
+);
+
+Add.propTypes = {
+  iconText: PropTypes.string,
+};
+
+Add.defaultProps = {
+  iconText: null,
+};
+
+export const Remove = ({ iconText }) => (
+  <>
+    <svg
+      className="qpp-c-details--icon-open qpp-icon-mat qpp-icon-inline--md"
+      aria-hidden="true"
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+      role="img"
+      focusable="false"
+    >
+      <path d="M19 13H5v-2h14v2z" />
+    </svg>
+    {iconText}
+  </>
+);
+
+Remove.propTypes = {
+  iconText: PropTypes.string,
+};
+
+Remove.defaultProps = {
+  iconText: null,
+};

package/components/Details/index.js

@@ -0,0 +1,53 @@
+import React from "react";
+import PropTypes from "prop-types";
+import { Add, Remove } from "./DetailsIcons";
+
+const Details = ({ children, title, variant, className, ...rest }) => {
+  if (variant === "header") {
+    return (
+      <details className="qpp-c-details qpp-c-details--header">
+        <summary>
+          {title}
+          <span className="qpp-c-details--icon-closed" aria-hidden="true">
+            <Add iconText="View" />
+          </span>
+          <span className="qpp-c-details--icon-open" aria-hidden="true">
+            <Remove iconText="Hide" />
+          </span>
+        </summary>
+        {children}
+      </details>
+    );
+  }
+
+  return (
+    <details className={`qpp-c-details ${className}`} {...rest}>
+      <summary
+        className={
+          variant === "text-button" ? "qpp-c-button qpp-c-button--text" : ""
+        }
+      >
+        <Add />
+        <Remove />
+        {title}
+      </summary>
+      {children}
+    </details>
+  );
+};
+
+Details.propTypes = {
+  children: PropTypes.node,
+  title: PropTypes.node,
+  variant: PropTypes.oneOf(["header", "text-button"]),
+  className: PropTypes.string,
+};
+
+Details.defaultProps = {
+  children: false,
+  title: null,
+  variant: null,
+  className: "",
+};
+
+export default Details;

package/components/Dropdown/index.js

@@ -0,0 +1,85 @@
+import React from "react";
+import PropTypes from "prop-types";
+
+const Dropdown = ({
+  className,
+  id,
+  ariaLabelledBy,
+  ariaLabel,
+  onChange,
+  dataTestId,
+  name,
+  dataType,
+  disabled,
+  size,
+  options,
+  children,
+  parentElement,
+  ...rest
+}) => {
+  const dropdownClass = [
+    "qpp-c-dropdown",
+    size === "big" && "qpp-c-dropdown--big",
+    className,
+  ]
+    .filter(Boolean)
+    .join(" ");
+
+  return (
+    <select
+      id={id}
+      aria-labelledby={ariaLabelledBy}
+      aria-label={ariaLabel}
+      className={dropdownClass || ""}
+      onChange={onChange}
+      data-testid={dataTestId}
+      name={name}
+      disabled={disabled}
+      data-type={dataType}
+      {...rest}
+    >
+      {children}
+      {options.map(({ disabled, name, value }) => (
+        <option disabled={disabled} key={value} value={value}>
+          {name}
+        </option>
+      ))}
+    </select>
+  );
+};
+
+Dropdown.propTypes = {
+  children: PropTypes.node,
+  className: PropTypes.string,
+  id: PropTypes.string,
+  ariaLabelledBy: PropTypes.string,
+  ariaLabel: PropTypes.string,
+  onChange: PropTypes.func,
+  value: PropTypes.string,
+  defaultValue: PropTypes.string,
+  dataTestId: PropTypes.string,
+  name: PropTypes.string,
+  dataType: PropTypes.string,
+  disabled: PropTypes.bool,
+  size: PropTypes.oneOf(["big"]),
+  options: PropTypes.array,
+  parentElement: PropTypes.string,
+};
+
+Dropdown.defaultProps = {
+  children: false,
+  className: "qpp-u-width--100",
+  id: null,
+  ariaLabelledBy: null,
+  ariaLabel: null,
+  onChange: () => null,
+  dataTestId: null,
+  name: null,
+  dataType: null,
+  disabled: false,
+  size: null,
+  options: [],
+  parentElement: "span",
+};
+
+export default Dropdown;

package/components/DropdownButton/Menu.js

@@ -0,0 +1,25 @@
+import React from "react";
+import PropTypes from "prop-types";
+import { Menu as AriaKitMenu } from "ariakit/menu";
+
+function Menu({ state, className, children, ...props }) {
+  return (
+    <AriaKitMenu as="ul" state={state} className={className} {...props}>
+      {children}
+    </AriaKitMenu>
+  );
+}
+
+Menu.propTypes = {
+  state: PropTypes.object.isRequired,
+  className: PropTypes.string,
+  children: PropTypes.node,
+};
+
+Menu.defaultProps = {
+  className:
+    "qpp-c-dropdown-menu qpp-c-dropdown-menu__box qpp-c-dropdown-menu__list",
+  children: null,
+};
+
+export default Menu;