qpp-style 1.0.0-ds.2 → 1.0.0-mf.0

package/.babelrc

@@ -1,10 +1,11 @@
 {
   "presets": [
-    "@babel/preset-react",
-    "@babel/preset-env"
+    [
+      "@babel/preset-react",
+      {
+        "runtime": "automatic"
+      }
+    ]
   ],
-  "plugins": [
-    "transform-es2015-modules-umd",
-    "transform-class-properties"
-  ]
+  "plugins": ["transform-es2015-modules-umd"]
 }

package/.browserlistrc

@@ -0,0 +1,3 @@
+"browserlist": [
+  "defaults"
+]

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/.husky/pre-commit

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

package/.husky/pre-push

@@ -0,0 +1,2 @@
+cd react
+npm run prepush

package/.prettierrc

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

package/README.md

@@ -2,11 +2,10 @@
 
 This directory contains react implementations of the components for QPP.
 
-A storybook with examples is published at [https://cmsgov.github.io/qpp-style](https://cmsgov.github.io/qpp-style)
-
 ## 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
+   > 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:
@@ -17,13 +16,15 @@ 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
+   > 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.
@@ -34,9 +35,26 @@ 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,64 +1,72 @@
-import React, { useState, useRef, useEffect } from 'react';
-import PropTypes from 'prop-types';
-import { Chevron } from '../../lib/Chevron.jsx';
+import { useState, useRef, useEffect } from "react";
+import PropTypes from "prop-types";
+import { Chevron } from "../../lib/Chevron.jsx";
 
-const Accordion = (props) => {
+const Accordion = ({
+  title = "",
+  subTitle,
+  children,
+  centerItem,
+  rightItem,
+  isOpen = false,
+  isSticky = false,
+}) => {
   const content = useRef(null);
-  const [setActive, setActiveState] = useState(props.isOpen ? 'active' : '');
-  const ariaPressed = setActive ? 'true' : 'false';
+  const [setActive, setActiveState] = useState(isOpen ? "active" : "");
+  const ariaPressed = setActive ? "true" : "false";
   const getHeight = (node) => {
     if (node) {
       return `${node.scrollHeight}px`;
     }
-    return 'auto';
+    return "auto";
   };
-  const height = setActive ? getHeight(content.current) : '0px';
-  const rotate = setActive ? 'accordion-icon rotate' : 'accordion-icon';
+  const height = setActive ? getHeight(content.current) : "0px";
+  const rotate = setActive ? "accordion-icon rotate" : "accordion-icon";
 
   function toggleAccordion() {
-    setActiveState(setActive === '' ? 'active' : '');
+    setActiveState(setActive === "" ? "active" : "");
   }
 
   function openAccordion() {
-    setActiveState('active');
+    setActiveState("active");
   }
 
   function closeAccordion() {
-    setActiveState('');
+    setActiveState("");
   }
 
   useEffect(() => {
-    if (props.isOpen) {
+    if (isOpen) {
       openAccordion();
     } else {
       closeAccordion();
     }
-  }, [props.isOpen]);
+  }, [isOpen]);
 
   return (
     <div className="accordion-section" data-testid="accordion">
       <button
-        className={`accordion ${setActive}`}
-        aria-label={props.title}
+        className={`accordion ${setActive} ${
+          setActive && isSticky ? "sticky" : ""
+        }`}
+        aria-label={title}
         aria-pressed={ariaPressed}
         aria-expanded={ariaPressed}
         tabIndex="0"
         onClick={toggleAccordion}
       >
         <div className="accordion-left-title">
-          <p className="accordion-title">{props.title}</p>
-          {props.subTitle && (
-            <p className="accordion-subtitle">{props.subTitle}</p>
-          )}
+          <p className="accordion-title">{title}</p>
+          {subTitle && <p className="accordion-subtitle">{subTitle}</p>}
         </div>
-        {props.centerItem && (
+        {centerItem && (
           <div className="accordion-center">
-            <p>{props.centerItem}</p>
+            <p>{centerItem}</p>
           </div>
         )}
-        {props.rightItem && (
+        {rightItem && (
           <div className="accordion-right">
-            <p>{props.rightItem}</p>
+            <p>{rightItem}</p>
           </div>
         )}
         <div className="chevron-container">
@@ -70,7 +78,7 @@ const Accordion = (props) => {
         style={{ maxHeight: height }}
         className="accordion-content"
       >
-        <div className="accordion-text dashed-border">{props.children}</div>
+        <div className="accordion-text dashed-border">{children}</div>
       </div>
     </div>
   );
@@ -83,11 +91,7 @@ Accordion.propTypes = {
   centerItem: PropTypes.string,
   rightItem: PropTypes.string,
   isOpen: PropTypes.bool,
-};
-
-Accordion.defaultProps = {
-  title: '',
-  isOpen: false,
+  isSticky: PropTypes.bool,
 };
 
 export default Accordion;

package/components/Button/index.js

@@ -1,30 +1,29 @@
-import React from 'react';
-import PropTypes from 'prop-types';
+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,
+  children = null,
   className,
   href,
-  loading,
-  onClick,
-  size,
+  loading = false,
+  onClick = () => {},
+  size = null,
   variant,
-  type,
+  type = "button",
   ...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) {
@@ -32,7 +31,7 @@ const Button = ({
       <a
         href={href}
         data-testid="ds-btn"
-        className={btnClass || ''}
+        className={btnClass || ""}
         onClick={onClick}
       >
         {children}
@@ -42,7 +41,7 @@ const Button = ({
   return (
     <button
       data-testid="ds-btn"
-      className={btnClass || ''}
+      className={btnClass || ""}
       onClick={onClick}
       disabled={loading}
       type={type}
@@ -64,18 +63,7 @@ Button.propTypes = {
   variant: PropTypes.oneOf(VARIANTS),
 };
 
-Button.defaultProps = {
-  children: false,
-  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} />
 );
 
@@ -83,8 +71,4 @@ TextButton.propTypes = {
   className: PropTypes.string,
 };
 
-TextButton.defaultProps = {
-  className: '',
-};
-
 export default Button;

package/components/Dropdown/index.js

@@ -1,36 +1,35 @@
-import React from 'react';
-import PropTypes from 'prop-types';
+import PropTypes from "prop-types";
 
 const Dropdown = ({
-  className,
-  id,
-  ariaLabelledBy,
-  ariaLabel,
-  onChange,
-  dataTestId,
-  name,
-  dataType,
-  disabled,
-  size,
-  options,
+  className = "qpp-u-width--100",
+  id = null,
+  ariaLabelledBy = null,
+  ariaLabel = null,
+  onChange = () => {},
+  dataTestId = null,
+  name = null,
+  dataType = null,
+  disabled = false,
+  size = null,
+  options = [],
   children,
-  parentElement,
+  parentElement = "span",
   ...rest
 }) => {
   const dropdownClass = [
-    'qpp-c-dropdown',
-    size === 'big' && 'qpp-c-dropdown--big',
+    "qpp-c-dropdown",
+    size === "big" && "qpp-c-dropdown--big",
     className,
   ]
     .filter(Boolean)
-    .join(' ');
+    .join(" ");
 
   return (
     <select
       id={id}
       aria-labelledby={ariaLabelledBy}
       aria-label={ariaLabel}
-      className={dropdownClass || ''}
+      className={dropdownClass || ""}
       onChange={onChange}
       data-testid={dataTestId}
       name={name}
@@ -61,25 +60,9 @@ Dropdown.propTypes = {
   name: PropTypes.string,
   dataType: PropTypes.string,
   disabled: PropTypes.bool,
-  size: PropTypes.oneOf(['big']),
+  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/Error/Collapsible.jsx

@@ -1,5 +1,5 @@
-import React, { Component } from 'react';
-import PropTypes from 'prop-types';
+import { Component } from "react";
+import PropTypes from "prop-types";
 
 class Collapsible extends Component {
   constructor(props) {
@@ -32,7 +32,7 @@ class Collapsible extends Component {
         <span className="collapsible-hide-label">{this.props.hideLabel}</span>
       );
     } else {
-      return '';
+      return "";
     }
   }
 

package/components/Error/ErrorUI.jsx

@@ -1,9 +1,8 @@
-import React from 'react';
-import Collapsible from './Collapsible';
-import PropTypes from 'prop-types';
+import Collapsible from "./Collapsible";
+import PropTypes from "prop-types";
 
 const ErrorUI = (props) => {
-  let errorTitle = `${props.type || 'Error'} ${props.code || ''}`;
+  let errorTitle = `${props.type || "Error"} ${props.code || ""}`;
   let errorDetails = props.message;
 
   return (

package/components/Error/error.js

@@ -1,6 +1,5 @@
-import React from 'react';
-import { render } from 'react-dom';
-import ErrorUI from './ErrorUI';
+import { createRoot } from "react-dom/client";
+import ErrorUI from "./ErrorUI";
 
 /**
  * Renders the QPP Error Page content.
@@ -14,13 +13,13 @@ export default class ErrorPage {
    * @param {HTMLElement} options.rootElement - Elem inside which to render
    */
   constructor(options) {
-    render(
+    const root = createRoot(options.rootElement);
+    root.render(
       <ErrorUI
         type={options.type}
         code={options.code}
         message={options.message}
       />,
-      options.rootElement
     );
   }
 }