[PROD] Next Release

package.json

@@ -6,7 +6,7 @@
     "dev-https": "cross-env APPMODE=development webpack-dev-server --https --port 8502 --host 0.0.0.0",
     "build": "webpack --mode=${APPMODE:-production} --env.config=${APPENV:-prod}",
     "analyze": "webpack --mode=production --env.analyze=true",
-    "lint": "eslint src --ext js --ext jsx",
+    "lint": "eslint ./src --ext .js,.jsx",
     "format": "prettier --write \"./**\"",
     "test": "cross-env BABEL_ENV=test jest",
     "watch-tests": "cross-env BABEL_ENV=test jest --watch",

src/components/ActionsMenu/index.jsx

@@ -0,0 +1,244 @@
+import React, { useCallback, useMemo, useState } from "react";
+import PT from "prop-types";
+import cn from "classnames";
+import { usePopper } from "react-popper";
+import Button from "components/Button";
+import Tooltip from "components/Tooltip";
+import IconArrowDown from "../../assets/images/icon-arrow-down-narrow.svg";
+import { useClickOutside } from "utils/hooks";
+import { negate, stopPropagation } from "utils/misc";
+import compStyles from "./styles.module.scss";
+
+/**
+ * Displays a clickable button with a menu.
+ *
+ * @param {Object} props component properties
+ * @param {'primary'|'error'|'warning'} [props.handleColor] menu handle color
+ * @param {'small'|'medium'} [props.handleSize] menu handle size
+ * @param {string} [props.handleText] text to show inside menu handle
+ * @param {Array} props.items menu items
+ * @param {'absolute'|'fixed'} [props.popupStrategy] popup positioning strategy
+ * @param {boolean} [props.stopClickPropagation] whether to stop click event propagation
+ * @returns {JSX.Element}
+ */
+const ActionsMenu = ({
+  handleColor = "primary",
+  handleSize = "small",
+  handleText,
+  items = [],
+  popupStrategy = "absolute",
+  stopClickPropagation = false,
+}) => {
+  const [isOpen, setIsOpen] = useState(false);
+  const [referenceElement, setReferenceElement] = useState(null);
+
+  const closeMenu = useCallback(() => {
+    setIsOpen(false);
+  }, []);
+
+  const toggleMenu = useCallback(() => {
+    setIsOpen(negate);
+  }, []);
+
+  return (
+    <div
+      className={compStyles.container}
+      onClick={stopClickPropagation ? stopPropagation : null}
+      role="button"
+      tabIndex={0}
+    >
+      <Button
+        color={handleColor}
+        size={handleSize}
+        style={handleText ? "rounded" : "circle"}
+        variant="contained"
+        onClick={isOpen ? null : toggleMenu}
+        className={cn(compStyles.handle, {
+          [compStyles.handleMenuOpen]: isOpen,
+        })}
+        innerRef={setReferenceElement}
+      >
+        {handleText ? <span>{handleText}&nbsp;</span> : null}
+        <IconArrowDown className={compStyles.iconArrowDown} />
+      </Button>
+      {isOpen && (
+        <Menu
+          close={closeMenu}
+          items={items}
+          referenceElement={referenceElement}
+          strategy={popupStrategy}
+        />
+      )}
+    </div>
+  );
+};
+
+ActionsMenu.propTypes = {
+  handleColor: PT.oneOf(["primary", "error", "warning"]),
+  handleSize: PT.oneOf(["small", "medium"]),
+  handleText: PT.string,
+  items: PT.arrayOf(
+    PT.shape({
+      label: PT.string,
+      action: PT.func,
+      separator: PT.bool,
+      disabled: PT.bool,
+      hidden: PT.bool,
+    })
+  ),
+  popupStrategy: PT.oneOf(["absolute", "fixed"]),
+  stopClickPropagation: PT.bool,
+};
+
+export default ActionsMenu;
+
+/**
+ * Displays a list of provided action items.
+ *
+ * @param {Object} props component properties
+ * @returns {JSX.Element}
+ */
+const Menu = ({ close, items, referenceElement, strategy }) => {
+  const [popperElement, setPopperElement] = useState(null);
+  const [arrowElement, setArrowElement] = useState(null);
+  const { styles, attributes } = usePopper(referenceElement, popperElement, {
+    placement: "bottom",
+    strategy,
+    modifiers: [
+      {
+        name: "flip",
+        options: {
+          fallbackPlacements: ["bottom"],
+        },
+      },
+      {
+        name: "offset",
+        options: {
+          // use offset to move the dropdown slightly down
+          offset: [0, 5],
+        },
+      },
+      {
+        name: "arrow",
+        // padding should be equal to border-radius of the dropdown
+        options: { element: arrowElement, padding: 8 },
+      },
+      {
+        name: "preventOverflow",
+        options: {
+          // padding from browser edges
+          padding: 16,
+        },
+      },
+      {
+        name: "computeStyles",
+        options: {
+          // to fix bug in IE 11 https://github.com/popperjs/popper-core/issues/636
+          gpuAcceleration: false,
+        },
+      },
+    ],
+  });
+
+  const onClickItem = useCallback(
+    (event) => {
+      let targetData = event.target.dataset;
+      let index = +targetData.actionIndex;
+      let item = items[index];
+      if (!item || targetData.disabled || item.separator) {
+        return;
+      }
+      close();
+      item.action?.();
+    },
+    [close, items]
+  );
+
+  useClickOutside(popperElement, close, []);
+
+  const menuItems = useMemo(() => {
+    return items.map((item, index) => {
+      if (item.hidden) {
+        return null;
+      } else if (item.separator) {
+        return <div key={index} className={compStyles.separator} />;
+      } else {
+        let disabled = !!item.disabled;
+        let reasonsDisabled = Array.isArray(item.disabled)
+          ? item.disabled
+          : null;
+        let attrs = {
+          key: index,
+          "data-action-index": index,
+          onClick: onClickItem,
+          role: "button",
+          tabIndex: 0,
+          className: cn(
+            compStyles.item,
+            { [compStyles.itemDisabled]: disabled },
+            item.className
+          ),
+        };
+        if (disabled) {
+          attrs["data-disabled"] = true;
+        }
+        return (
+          <div {...attrs}>
+            {reasonsDisabled ? (
+              <Tooltip
+                content={
+                  reasonsDisabled.length === 1 ? (
+                    reasonsDisabled[0]
+                  ) : (
+                    <ul>
+                      {reasonsDisabled.map((text, index) => (
+                        <li key={index}>{text}</li>
+                      ))}
+                    </ul>
+                  )
+                }
+                strategy="fixed"
+              >
+                {item.label}
+              </Tooltip>
+            ) : (
+              item.label
+            )}
+          </div>
+        );
+      }
+    });
+  }, [items, onClickItem]);
+
+  return (
+    <div
+      className={compStyles.popover}
+      ref={setPopperElement}
+      style={styles.popper}
+      {...attributes.popper}
+    >
+      <div className={compStyles.items}>{menuItems}</div>
+      <div
+        ref={setArrowElement}
+        style={styles.arrow}
+        className={compStyles.popoverArrow}
+      />
+    </div>
+  );
+};
+
+Menu.propTypes = {
+  close: PT.func.isRequired,
+  items: PT.arrayOf(
+    PT.shape({
+      label: PT.string,
+      action: PT.func,
+      checkDisabled: PT.func,
+      disabled: PT.bool,
+      separator: PT.bool,
+      hidden: PT.bool,
+    })
+  ),
+  referenceElement: PT.object,
+  strategy: PT.oneOf(["absolute", "fixed"]),
+};

src/components/ActionsMenu/styles.module.scss

@@ -0,0 +1,80 @@
+@import "styles/variables";
+
+.container {
+  position: relative;
+  display: inline-block;
+}
+
+.handle {
+  display: inline-flex;
+  align-items: center;
+
+  > span {
+    + .iconArrowDown {
+      margin-left: 8px;
+    }
+  }
+}
+
+.iconArrowDown {
+  display: inline-block;
+  width: 12px;
+  height: 8px;
+}
+
+.handleMenuOpen {
+  .iconArrowDown {
+    transform: rotate(180deg);
+  }
+}
+
+.popover {
+  z-index: 100;
+  border-radius: 8px;
+  // min-width: 175px;
+  background-color: #fff;
+  box-shadow: 0px 5px 25px #c6c6c6;
+}
+
+.popoverArrow {
+  top: -9px;
+  border: 10px solid transparent;
+  border-top: none;
+  border-bottom-color: #fff;
+  width: 0;
+  height: 0;
+}
+
+.items {
+  padding: 16px;
+}
+
+.separator {
+  border-top: 1px solid #e7e7e7;
+  margin: 5px 0;
+}
+
+.item {
+  padding: 5px 0;
+  font-size: 12px;
+  font-weight: bold;
+  letter-spacing: 0.8px;
+  text-align: left;
+  text-transform: uppercase;
+  white-space: nowrap;
+  color: $primary-text-color;
+  cursor: pointer;
+}
+
+.danger {
+  color: #ef476f;
+}
+
+.itemDisabled {
+  color: #bbb;
+  cursor: default;
+}
+
+.hidden {
+  display: none;
+}

src/components/Button/index.jsx

@@ -11,6 +11,8 @@ import styles from "./styles.module.scss";
  * @param {string} [props.className] class name added to root element
  * @param {'primary'|'primary-dark'|'primary-light'|'error'|'warning'} [props.color]
  * button color
+ * @param {Object|function} [props.innerRef] Ref object or function to accept the
+ * ref for <button> element
  * @param {boolean} [props.isDisabled] if button is disabled
  * @param {boolean} [props.isSelected] if button is selected
  * @param {string} [props.name] button name
@@ -26,6 +28,7 @@ const Button = ({
   children,
   className,
   color = "primary",
+  innerRef,
   isDisabled = false,
   isSelected = false,
   name,
@@ -40,6 +43,7 @@ const Button = ({
     data-value={value}
     disabled={isDisabled}
     name={name || ""}
+    ref={innerRef}
     type={type}
     className={cn(
       styles.button,
@@ -66,6 +70,7 @@ Button.propTypes = {
     "error",
     "warning",
   ]),
+  innerRef: PT.oneOfType([PT.object, PT.func]),
   isDisabled: PT.bool,
   isSelected: PT.bool,
   name: PT.string,