@pareto-engineering/design-system 4.0.0-alpha.73 → 4.0.0-alpha.74

package/src/ui/f/fields/SelectInput/common/Multiple/Multiple.jsx

@@ -0,0 +1,288 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import {
+  useState, useEffect, useMemo, useRef,
+} from 'react'
+
+import { useField } from 'formik'
+
+import PropTypes from 'prop-types'
+
+import { useCombobox, useMultipleSelection } from 'downshift'
+
+import styleNames from '@pareto-engineering/bem/exports'
+
+import { Button } from 'ui/b'
+
+import { Popover } from 'ui/a'
+
+import { FormDescription, FormLabel } from 'ui/f'
+
+import { Menu } from '../Menu'
+
+// Local Definitions
+
+const baseClassName = styleNames.base
+
+const componentClassName = 'multiple'
+
+/**
+ *  @param {Array[Object]} first - first array to check if it has an item not in the second array.
+ *  @param {Array[Object]} second - second array to check against the first array.
+ *
+ * @returns {Boolean} - true if the first array has an item not in the second array.
+ */
+const testIfArraysAreUnique = (first, second) => first
+  .filter((objInFirstArray) => !second
+    .some((objInSecondArray) => objInFirstArray.value === objInSecondArray.value))
+  .length > 0
+
+/**
+ * This is the component description.
+ */
+const Multiple = ({
+  id,
+  className:userClassName,
+  style,
+  name,
+  label,
+  labelColor,
+  color,
+  options,
+  validate,
+  optional,
+  description,
+  disabled,
+  autoComplete,
+  transformSearch,
+  getTagColor,
+  placeholder,
+  // ...otherProps
+}) => {
+  const [, meta, helpers] = useField({ name, validate })
+
+  const { setValue } = helpers
+
+  const { value } = meta
+
+  const [searchInputValue, setSearchInputValue] = useState('')
+
+  const {
+    getSelectedItemProps,
+    getDropdownProps,
+    addSelectedItem,
+    removeSelectedItem,
+    setSelectedItems,
+    selectedItems,
+  } = useMultipleSelection({
+    initialSelectedItems:value || [],
+  })
+
+  /**
+   * @returns {Boolean} - Unique items from the options array so that the combobox
+   * shows only the options that are not yet selected.
+ */
+
+  const items = useMemo(() => {
+    const lowerCasedInputValue = searchInputValue.toLowerCase()
+
+    return options.filter((option) => {
+      const lowerCasedOption = option.label.toLowerCase()
+
+      return lowerCasedOption.includes(lowerCasedInputValue)
+        && !selectedItems.includes(option)
+    })
+  }, [searchInputValue, selectedItems])
+
+  const {
+    isOpen,
+    getLabelProps,
+    getMenuProps,
+    getInputProps,
+    getComboboxProps,
+    highlightedIndex,
+    getItemProps,
+  } = useCombobox({
+    inputValue             :searchInputValue,
+    defaultHighlightedIndex:0, // after selection, highlight the first item.
+    selectedItem           :null,
+    items,
+    circularNavigation     :true,
+    stateReducer           :(state, actionAndChanges) => {
+      const { changes, type } = actionAndChanges
+      switch (type) {
+        case useCombobox.stateChangeTypes.InputKeyDownEnter:
+        case useCombobox.stateChangeTypes.ItemClick:
+          return {
+            ...changes,
+            isOpen:true, // keep the menu open after selection.
+          }
+        default:
+          break
+      }
+      return changes
+    },
+    onStateChange:({ inputValue:newSearchInputValue, type, selectedItem }) => {
+      switch (type) {
+        case useCombobox.stateChangeTypes.InputChange: {
+          const transformedInput = transformSearch(newSearchInputValue)
+          setSearchInputValue(transformedInput)
+          break
+        }
+        case useCombobox.stateChangeTypes.InputKeyDownEnter:
+        case useCombobox.stateChangeTypes.ItemClick:
+        case useCombobox.stateChangeTypes.InputBlur:
+          if (selectedItem) {
+            setSearchInputValue('')
+            addSelectedItem(selectedItem)
+          }
+          break
+        default:
+          break
+      }
+    },
+  })
+
+  useEffect(() => {
+    if (selectedItems?.length > 0) {
+      setValue(selectedItems)
+    }
+  }, [selectedItems])
+
+  useEffect(() => {
+    if (value?.length > 0 && (
+      testIfArraysAreUnique(value, selectedItems)
+      || testIfArraysAreUnique(selectedItems, value)
+    )) {
+      setSelectedItems(value)
+    }
+  }, [value])
+
+  const parentRef = useRef(null)
+
+  return (
+    <div
+      id={id}
+      className={[
+
+        baseClassName,
+
+        componentClassName,
+        userClassName,
+      ]
+        .filter((e) => e)
+        .join(' ')}
+      style={style}
+      ref={parentRef}
+      {...getComboboxProps()}
+      // {...otherProps}
+    >
+      <FormLabel
+        className={[
+          baseClassName,
+          componentClassName,
+        ]
+          .filter((e) => e)
+          .join(' ')}
+        {...getLabelProps()}
+        name={name}
+        optional={optional}
+        color={labelColor}
+      >
+        {label}
+      </FormLabel>
+
+      {selectedItems?.length > 0 && (
+        <div className="selected-items">
+          {selectedItems.map((selectedItem, index) => (
+            <div
+              key={selectedItem.label}
+              {...getSelectedItemProps({ selectedItem, index })}
+              className="item"
+            >
+              <Button
+                onClick={(e) => {
+                  e.stopPropagation()
+                  removeSelectedItem(selectedItem)
+                }}
+                isCompact
+                color={getTagColor ? getTagColor(selectedItem) : color}
+              >
+                <span>{selectedItem.label}</span>
+                <span className="icon close">Y</span>
+              </Button>
+            </div>
+          ))}
+        </div>
+      )}
+      <div className="input-container">
+        <input
+          {...getInputProps(
+            getDropdownProps({ preventKeyAction: isOpen }),
+          )}
+          className="input"
+          disabled={disabled}
+          placeholder={placeholder}
+          autoComplete={autoComplete}
+        />
+      </div>
+
+      <FormDescription className="s-1" description={description} name={name} />
+      <Popover
+        isOpen={isOpen}
+        parentRef={parentRef}
+      >
+        <Menu
+          className={`y-${color}`}
+          isOpen={isOpen}
+          getItemProps={getItemProps}
+          highlightedIndex={highlightedIndex}
+          items={items}
+          {...getMenuProps()}
+        />
+      </Popover>
+
+    </div>
+  )
+}
+
+Multiple.propTypes = {
+  /**
+   * The HTML id for this element
+   */
+  id:PropTypes.string,
+
+  /**
+   * The HTML class names for this element
+   */
+  className:PropTypes.string,
+
+  /**
+   * The React-written, css properties for this element.
+   */
+  style:PropTypes.objectOf(PropTypes.string),
+
+  /**
+   * A function that transforms the search input value
+   */
+  transformSearch:PropTypes.func,
+
+  /**
+   * The minimum length of the search input value
+   */
+  minLength:PropTypes.number,
+
+  /**
+   * The base color of the component
+   */
+  color:PropTypes.string,
+}
+
+Multiple.defaultProps = {
+  transformSearch:(e) => e,
+  minLength      :2,
+  color          :'interactive',
+}
+
+export default Multiple

package/src/ui/f/fields/SelectInput/common/Multiple/index.js

@@ -0,0 +1,2 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+export { default as Multiple } from './Multiple'

package/src/ui/f/fields/SelectInput/common/Single/Single.jsx

@@ -0,0 +1,125 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import { useField } from 'formik'
+
+import PropTypes from 'prop-types'
+
+import styleNames from '@pareto-engineering/bem/exports'
+
+import { LoadingCircle } from 'ui/a'
+
+import { FormLabel, FormDescription } from '..'
+
+// Local Definitions
+
+const baseClassName = styleNames.base
+
+const componentClassName = 'single'
+
+/**
+ * This is the component description.
+ */
+const Single = ({
+  id,
+  className:userClassName,
+  style,
+  name,
+  label,
+  labelColor,
+  color,
+  options,
+  validate,
+  optional,
+  description,
+  disabled,
+  isLoading,
+  autoComplete,
+  // ...otherProps
+}) => {
+  const [field] = useField({ name, validate })
+
+  return (
+    <div
+      id={id}
+      className={[
+
+        baseClassName,
+
+        componentClassName,
+        userClassName,
+      ]
+        .filter((e) => e)
+        .join(' ')}
+      style={style}
+    >
+      <FormLabel
+        name={name}
+        color={labelColor}
+        optional={optional}
+      >
+        {label}
+      </FormLabel>
+      <div className={`select-wrapper${disabled ? ' disabled' : ''}`}>
+        <select
+          className={`input y-${color}`}
+          {...field}
+          value={field.value || ''}
+          id={name}
+          disabled={disabled}
+          autoComplete={autoComplete}
+        >
+          {
+          options.map((option) => {
+            // i.e if option is a string like "blah", return { value: "blah", label: "blah" }
+            const newOption = typeof option === 'string' ? { value: option, label: option } : option
+
+            return (
+              <option
+                key={newOption.value}
+                value={newOption.value}
+                disabled={newOption?.disabled || false}
+              >
+                {newOption.label}
+              </option>
+            )
+          })
+        }
+        </select>
+        {isLoading && (
+          <LoadingCircle className="x-main" />
+        )}
+      </div>
+      <FormDescription className="s-1" description={description} name={name} />
+    </div>
+  )
+}
+
+Single.propTypes = {
+  /**
+   * The HTML id for this element
+   */
+  id:PropTypes.string,
+
+  /**
+   * The HTML class names for this element
+   */
+  className:PropTypes.string,
+
+  /**
+   * The React-written, css properties for this element.
+   */
+  style:PropTypes.objectOf(PropTypes.string),
+
+  /**
+   * The base color of the component
+   */
+  color:PropTypes.string,
+
+}
+
+Single.defaultProps = {
+  color:'paragraph',
+}
+
+export default Single

package/src/ui/f/fields/SelectInput/common/Single/index.js

@@ -0,0 +1,2 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+export { default as Single } from './Single'

package/src/ui/f/fields/SelectInput/common/index.js

@@ -0,0 +1,3 @@
+export { Multiple } from './Multiple'
+export { Single } from './Single'
+export { Menu } from './Menu'

package/src/ui/f/fields/SelectInput/styles.scss

@@ -14,72 +14,176 @@ $hover-border: var(--theme-hover-input-border);
 $focus-border: var(--theme-focus-input-border);
 $default-background: var(--background-inputs);
 $disabled-background: var(--background-inputs-30);
+$default-gap: var(--gap);
 
-.#{bem.$base}.select-input {
-  display: flex;
-  flex-direction: column;
-
-  > .#{bem.$base}.form-label {
-    margin-bottom: var(--gap);
-  }
 
-  .select-wrapper {
-    background-color: $default-background;
-    border: $default-border;
-    border-radius: $default-input-border-radius;
+.#{bem.$base}.select-input {
+  > .#{bem.$base}.single {
     display: flex;
     flex-direction: column;
-    padding: $default-padding;
-    padding-right: 0;
-    position: relative;
 
-    &:not(.disabled) {
-      &:hover,
-      &:active {
-        border: $hover-border;
+    > .#{bem.$base}.form-label {
+      margin-bottom: var(--gap);
+    }
+
+    .select-wrapper {
+      background-color: $default-background;
+      border: $default-border;
+      border-radius: $default-input-border-radius;
+      display: flex;
+      flex-direction: column;
+      padding: $default-padding;
+      padding-right: 0;
+      position: relative;
+
+      &:not(.disabled) {
+        &:hover,
+        &:active {
+          border: $hover-border;
+        }
+
+        &:focus {
+          border: $focus-border;
+        }
       }
 
-      &:focus {
-        border: $focus-border;
+      &.disabled {
+        background: $disabled-background;
       }
-    }
 
-    &.disabled {
-      background: $disabled-background;
+      &::placeholder {
+        color: var(--metadata);
+      }
+
+      &::after {
+        border-radius: $default-input-border-radius;
+      }
+
+      >.#{bem.$base}.loading-circle {
+        position: absolute;
+        right: $default-spacing-size;
+        top: 50%;
+        transform: translateY(-50%);
+      }
+
+      select {
+        appearance: none;
+        background-color: $default-background;
+        background-image: url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjAiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCAyMCAxMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTE5IDEuNUwxMCAxMC41TDEgMS41IiBzdHJva2U9IiM0QzRENTMiIHN0cm9rZS13aWR0aD0iMiIvPgo8L3N2Zz4=");
+        background-position: calc(100% - $default-spacing-size);
+        background-repeat: no-repeat;
+        background-size: $default-spacing-size;
+        padding-right: $default-spacing-size;
+
+        &.input {
+          border: none;
+          color: var(--y);
+          outline: none;
+          width: 100%;
+
+          /* stylelint-disable-next-line max-nesting-depth -- required */
+          &:disabled {
+            opacity: 0%;
+          }
+        }
+      }
     }
+  }
 
-    &::placeholder {
-      color: var(--metadata);
+  > .#{bem.$base}.multiple {
+    display: flex;
+    flex-direction: column;
+    outline: none;
+    position: relative;
+
+    > .#{bem.$base}.form-label {
+      margin-bottom: var(--gap);
     }
 
-    &::after {
+
+    .#{bem.$base}.popover {
+      border: $default-border;
       border-radius: $default-input-border-radius;
-    }
+      width: 100%;
+
+      >.menu {
+        list-style: none;
+        margin: 0;
+        outline: 0;
+        padding: 0;
+
+        /* stylelint-disable selector-max-compound-selectors -- required */
+        >.item {
+          border-radius: $default-input-border-radius;
+          padding: $default-padding;
+
+          /* stylelint-disable max-nesting-depth -- required */
+          > p {
+            margin: 0;
+          }
 
-    >.#{bem.$base}.loading-circle {
-      position: absolute;
-      right: $default-spacing-size;
-      top: 50%;
-      transform: translateY(-50%);
+          &.#{bem.$modifier-active} {
+            background-color: var(--y);
+
+            > p {
+              color: var(--on-y);
+            }
+          }
+        }
+      }
     }
 
-    select {
-      appearance: none;
-      background-color: $default-background;
-      background-image: url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjAiIGhlaWdodD0iMTIiIHZpZXdCb3g9IjAgMCAyMCAxMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTE5IDEuNUwxMCAxMC41TDEgMS41IiBzdHJva2U9IiM0QzRENTMiIHN0cm9rZS13aWR0aD0iMiIvPgo8L3N2Zz4=");
-      background-position: calc(100% - $default-spacing-size);
-      background-repeat: no-repeat;
-      background-size: $default-spacing-size;
-      padding-right: $default-spacing-size;
-
-      &.input {
-        border: none;
-        color: var(--y);
+
+    > .input-container {
+      position: relative;
+
+      > .input {
+        background: $default-background;
+        border: $default-border;
+        border-radius: calc(var(--theme-default-border-radius) / 2);
+        color: var(--paragraph);
         outline: none;
+        padding: $default-padding;
         width: 100%;
 
+        &::placeholder {
+          color: var(--metadata);
+        }
+
         &:disabled {
-          opacity: 0%;
+          background-color: $disabled-background;
+          color: var(--paragraph);
+        }
+
+        &:not(:disabled) {
+          &:hover,
+          &:active {
+            border: $hover-border;
+          }
+
+          &:focus {
+            border: $focus-border;
+          }
+        }
+      }
+    }
+
+
+    >.selected-items {
+      display: flex;
+      flex-wrap: wrap;
+      gap: calc($default-gap / 2);
+      margin-bottom: calc($default-gap / 2);
+
+      >.item {
+        >.#{bem.$base}.button {
+          align-items: center;
+          display: flex;
+          gap: calc($default-gap / 2);
+        }
+
+        .close {
+          font-size: calc(var(--s-3) * 1em);
         }
       }
     }