@pareto-engineering/design-system 2.0.0-alpha.7 → 2.0.0-alpha.70

package/src/ui/f/fields/{CheckboxInput/CheckboxInput.jsx → Checkbox/Checkbox.jsx}

@@ -1,41 +1,41 @@
 /* @pareto-engineering/generator-front 1.0.12 */
 import * as React from 'react'
 
-import { useLayoutEffect, memo } from 'react'
-
-import { useField } from 'formik'
+import { useLayoutEffect } from 'react'
 
 import PropTypes from 'prop-types'
 
 import styleNames from '@pareto-engineering/bem'
 
+import { useField } from 'formik'
+
 import { FormLabel, FormDescription } from '../../common'
 
 // Local Definitions
 
 const baseClassName = styleNames.base
 
-const componentClassName = 'checkbox-input'
+const componentClassName = 'checkbox'
 
 /**
  * This is the component description.
  */
-const CheckboxInput = ({
+const Checkbox = ({
   id,
   className:userClassName,
   style,
-  children,
-  value,
   name,
+  label,
+  description,
+  disabled,
+  optional,
   // ...otherProps
 }) => {
   useLayoutEffect(() => {
     import('./styles.scss')
   }, [])
 
-  const [field, meta] = useField(name)
-
-  const isOptionSelected = !!(field.value?.length > 0 && field.value.includes(value))
+  const [field] = useField({ name, type: 'checkbox' })
 
   return (
     <div
@@ -52,23 +52,24 @@ const CheckboxInput = ({
       style={style}
       // {...otherProps}
     >
-      <div
-        className={`${isOptionSelected ? 'selected' : 'not-selected'} input-content uc v1 pv-v`}
-      >
-        <FormLabel name={name}>
-          <input {...field} id={name} value={value} className="input" type="checkbox" />
-          <span>
-            {children}
-          </span>
-        </FormLabel>
-      </div>
-      {meta.error && meta.touched && <FormDescription error>{meta.error}</FormDescription>}
-
+      {label && (
+      <FormLabel name={name} optional={optional}>
+        {label}
+      </FormLabel>
+      )}
+      <input
+        id={name}
+        className="input"
+        type="checkbox"
+        disabled={disabled}
+        {...field}
+      />
+      <FormDescription className="v50 mt-v s-1" description={description} name={name} />
     </div>
   )
 }
 
-CheckboxInput.propTypes = {
+Checkbox.propTypes = {
   /**
    * The HTML id for this element
    */
@@ -79,29 +80,39 @@ CheckboxInput.propTypes = {
    */
   className:PropTypes.string,
 
+  /**
+   * The React-written, css properties for this element.
+   */
+  style:PropTypes.objectOf(PropTypes.string),
+
   /**
    * The input name (html - and Formik state)
    */
   name:PropTypes.string.isRequired,
 
   /**
-   * The input value
+   * The Input description to guide the user if it's not obvious
    */
-  value:PropTypes.string.isRequired,
+  description:PropTypes.string,
 
   /**
-   * The React-written, css properties for this element.
+   * Whether the input should be disabled
    */
-  style:PropTypes.objectOf(PropTypes.string),
+  disabled:PropTypes.bool,
+
+  /**
+   * The input label
+   */
+  label:PropTypes.string,
 
   /**
-   *  The children JSX
+   * Whether the input should have an optional tag
    */
-  children:PropTypes.node,
+  optional:PropTypes.bool,
 }
 
-CheckboxInput.defaultProps = {
-  // someProp:false
+Checkbox.defaultProps = {
+  disabled:false,
 }
 
-export default memo(CheckboxInput)
+export default Checkbox

package/src/ui/f/fields/Checkbox/index.js

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

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

@@ -0,0 +1,14 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+@use "@pareto-engineering/bem";
+
+$default-margin: 1em;
+
+.#{bem.$base}.checkbox {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+
+    .#{bem.$base}.label {
+        margin-bottom: $default-margin
+    }
+}

package/src/ui/f/fields/ChoicesInput/ChoicesInput.jsx

@@ -33,6 +33,7 @@ const ChoicesInput = ({
   color,
   colorChecked,
   label,
+  optional,
   disabled,
   // ...otherProps
 }) => {
@@ -63,7 +64,7 @@ const ChoicesInput = ({
       // {...otherProps}
     >
       {label && (
-      <FormLabel as="p">
+      <FormLabel as="p" optional={optional}>
         {label}
       </FormLabel>
       )}
@@ -72,7 +73,7 @@ const ChoicesInput = ({
           <Choice
             key={choice.value}
             name={name}
-            id={`${id}-${choice.value}`}
+            id={`${name}-${choice.value}`}
             multiple={multiple}
             validate={validate}
             disabled={disabled}
@@ -142,13 +143,18 @@ ChoicesInput.propTypes = {
    * Whether all the Choices inputs should be disabled
    */
   disabled          :PropTypes.bool,
+
+  /**
+  * Whether the input is optional or not
+  */
+  optional:PropTypes.bool,
 }
 
 ChoicesInput.defaultProps = {
   gridColumnsMobile :2,
   gridColumnsDesktop:3,
   color             :'background2',
-  colorChecked      :'main1',
+  colorChecked      :'main2',
   disabled          :false,
 }
 

package/src/ui/f/fields/ChoicesInput/common/Choice/Choice.jsx

@@ -28,7 +28,15 @@ const Choice = ({
   validate,
   disabled,
 }) => {
-  const [field] = useField({ name, validate })
+  const type = multiple ? 'checkbox' : 'radio'
+
+  const [field] = useField({
+    name,
+    validate,
+    type,
+    value,
+  })
+
   return (
     <div
       className={[
@@ -43,7 +51,7 @@ const Choice = ({
       style={style}
     >
       <input
-        type={multiple ? 'checkbox' : 'radio'}
+        type={type}
         id={id}
         name={name}
         {...field}

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

@@ -29,10 +29,21 @@ $default-transition:all .3s;
         z-index: -1;
       }
 
+      input:disabled + label {
+        background-color: var(--dark-x);
+      }
+
+      input:not(:disabled) + label {
+        &:hover {
+          border-color: var(--light-y);
+        }
+      }
+
       label {
-        background: var(--x);
-        border-radius: var(--theme-border-radius);
+        border: var(--theme-border-style) var(--dark-x);
+        background: var(--light-x);
         color: var(--on-x);
+        border-radius: var(--theme-border-radius);
         display: block;
         height: 100%;
         padding: $default-padding;
@@ -44,6 +55,10 @@ $default-transition:all .3s;
       input:checked + label {
         background: var(--y);
         color: var(--on-y);
+
+        &:hover {
+          border-color: var(--y);
+        }
       }
     }
   }

package/src/ui/f/fields/QueryCombobox/QueryCombobox.jsx

@@ -0,0 +1,240 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import { useState, useLayoutEffect } from 'react'
+
+import { useField } from 'formik'
+
+import { useRelayEnvironment, fetchQuery } from 'react-relay'
+
+import PropTypes from 'prop-types'
+
+// Local Definitions
+
+import { Combobox, MultipleCombobox } from './common'
+
+/**
+ * This is the component description.
+ */
+const QueryCombobox = ({
+  id,
+  style,
+  className,
+  query,
+  multiple,
+  name,
+  label,
+  color,
+  optional,
+  description,
+  disabled,
+  debounceMs,
+  searchVariable,
+  extraVariables,
+  optionsKeyMap,
+  minLength,
+  transformSearch,
+  validate,
+  // ...otherProps
+}) => {
+  useLayoutEffect(() => {
+    import('./styles.scss')
+  }, [])
+
+  const [, meta, helpers] = useField({ name, validate })
+
+  const { setValue, setError } = helpers
+
+  const { value } = meta
+
+  const environment = useRelayEnvironment()
+
+  const [isFetching, setIsFetching] = useState(false)
+
+  const [options, setOptions] = useState([])
+
+  const { graphql, accessor } = query
+
+  const getOptions = (inputValue) => {
+    if (isFetching) return
+
+    let variables = { [searchVariable]: inputValue }
+
+    if (extraVariables) {
+      variables = {
+        ...variables,
+        ...extraVariables,
+      }
+    }
+
+    fetchQuery(
+      environment,
+      graphql,
+      variables,
+    )
+      .subscribe({
+        start:() => {
+          setIsFetching(true)
+        },
+        complete:() => {
+          setIsFetching(false)
+        },
+        error:(fetchError) => {
+          setIsFetching(false)
+          if (setError)setError(fetchError.message)
+        },
+        next:(data) => {
+          setOptions(data[accessor].edges.map(({ node }) => ({
+            value:node[optionsKeyMap.value],
+            label:optionsKeyMap.getLabel(node),
+          })))
+        },
+      })
+  }
+
+  const comboboxProps = {
+    id,
+    style,
+    options,
+    getOptions,
+    debounceMs,
+    disabled,
+    name,
+    label,
+    optional,
+    description,
+    setValue,
+    value,
+    color,
+    isFetching,
+    className,
+    minLength,
+    transformSearch,
+  }
+
+  const Input = multiple ? MultipleCombobox : Combobox
+
+  return <Input {...comboboxProps} />
+}
+
+QueryCombobox.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 name of the custom select input
+   */
+  name:PropTypes.string,
+
+  /**
+   * The label of the custom select input
+   */
+  label:PropTypes.string,
+
+  /**
+   * The custom select input description
+   */
+  description:PropTypes.string,
+
+  /**
+   * Whether the input should be disabled
+   */
+  disabled:PropTypes.bool,
+
+  /**
+   * The base color of the custom select input
+   */
+  color:PropTypes.string,
+
+  /**
+   * The debounce time in milliseconds
+   */
+  debounceMs:PropTypes.number,
+
+  /**
+   * The graphql query to fetch the options and the accessor to destructure the results from
+   */
+  query:PropTypes.shape({
+    accessor:PropTypes.string,
+    graphql :PropTypes.oneOfType([
+      PropTypes.string,
+      PropTypes.object,
+    ]).isRequired,
+  }),
+
+  /**
+   *  The extra variables required to be used in the query.
+   */
+  extraVariables:PropTypes.objectOf(PropTypes.string),
+
+  /**
+   *  The select option keys to be used to map the data to the select options.
+   * i.e `{ value: 'id', label: 'name' }`
+   */
+  optionsKeyMap:PropTypes.shape({
+    value   :PropTypes.string.isRequired,
+    getLabel:PropTypes.func.isRequired,
+  }),
+
+  /**
+   * Whether to allow multiple items selection
+   */
+  multiple:PropTypes.bool,
+
+  /**
+   * The graphql node to be used to destructure the fetched data
+   */
+  graphQlNode:PropTypes.string.isRequired,
+
+  /**
+   * The variable to be used to search the data
+   */
+  searchVariable:PropTypes.string,
+
+  /**
+   * The minimum length of the search input to start fetching the options
+   */
+  minLength:PropTypes.number,
+
+  /**
+   * The function to transform the search input
+   */
+  transformSearch:PropTypes.func,
+
+  /**
+   * The query combobox field validator function
+   */
+  validate:PropTypes.func,
+
+  /*
+  * Whether the input is optional or not
+  */
+  optional:PropTypes.bool,
+}
+
+QueryCombobox.defaultProps = {
+  optionsKeyMap:{
+    value   :'id',
+    getLabel:(node) => node.name,
+  },
+  multiple       :false,
+  color          :'background2',
+  searchVariable :'search',
+  transformSearch:(search) => search,
+  minLength      :2,
+  disabled       :false,
+}
+
+export default QueryCombobox