@pareto-engineering/design-system 2.0.0-alpha.9 → 3.0.0-alpha.22

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

@@ -5,7 +5,7 @@ import { useLayoutEffect, memo } from 'react'
 
 import PropTypes from 'prop-types'
 
-import styleNames from '@pareto-engineering/bem'
+import styleNames from '@pareto-engineering/bem/exports'
 
 import { useField } from 'formik'
 
@@ -27,17 +27,22 @@ const TextInput = ({
   type,
   name,
   label,
+  color,
+  labelColor,
   validate,
   oneInputLabel,
   description,
   disabled,
+  placeholder,
+  optional,
+  autoComplete,
   // ...otherProps
 }) => {
   useLayoutEffect(() => {
     import('./styles.scss')
   }, [])
 
-  const [field, meta] = useField({ name, validate })
+  const [field] = useField({ name, validate })
 
   return (
     <div
@@ -46,6 +51,7 @@ const TextInput = ({
         baseClassName,
         componentClassName,
         userClassName,
+        `y-${color}`,
       ]
         .filter((e) => e)
         .join(' ')}
@@ -53,27 +59,27 @@ const TextInput = ({
       // {...otherProps}
     >
       <FormLabel
-        className={[
-          'input-label', oneInputLabel ? 'md-s2 s0 v1 mb-v' : 'v50 mb-v']
+        className={[oneInputLabel ? 'md-s2 s0 v1 mb-v' : 'v50 mb-v']
           .filter((e) => e)
           .join(' ')}
         name={name}
+        color={labelColor}
+        optional={optional}
       >
         { label }
       </FormLabel>
       <input
         id={name}
-        className={`input ${meta.touched && meta.error ? 'input-border-error' : 'input-border'}`}
+        className="input"
         type={type}
         disabled={disabled}
+        placeholder={placeholder}
+        autoComplete={autoComplete}
         {...field}
       />
-      {(description || (meta.touched && meta.error))
-      && (
-      <FormDescription isError={!!meta.error} className="v50 mt-v s-1">
-        { meta.error || description }
-      </FormDescription>
-      )}
+
+      <FormDescription className="v50 mt-v s-1" description={description} name={name} />
+
     </div>
   )
 }
@@ -104,6 +110,11 @@ TextInput.propTypes = {
    */
   label:PropTypes.string.isRequired,
 
+  /**
+   * The input label color
+   */
+  labelColor:PropTypes.string,
+
   /**
    * The type of the input (html)
    */
@@ -118,6 +129,7 @@ TextInput.propTypes = {
     'month',
     'tel',
     'hidden',
+    'url',
   ]),
 
   /**
@@ -136,10 +148,32 @@ TextInput.propTypes = {
    * Whether the text input should be disabled
    */
   disabled     :PropTypes.bool,
+
+  /**
+   * The placeholder text for the input
+   */
+  placeholder:PropTypes.string,
+
+  /**
+   * The text input color
+   */
+  color:PropTypes.string,
+
+  /**
+ * Whether the input is optional or not
+ */
+  optional:PropTypes.bool,
+
+  /**
+   * The autoComplete value that the browser should watch for the input
+   * `https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete`
+   */
+  autoComplete:PropTypes.string,
 }
 
 TextInput.defaultProps = {
   type    :'text',
+  color   :'background2',
   disabled:false,
 }
 

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

@@ -9,17 +9,26 @@ $default-padding: 0.75em 0.75em 0.55em;
   display: flex;
   flex-direction: column;
 
-  .input-label {
-    color: var(--main1);
-  }
-
   .input {
-    background: var(--light-background1);
-    color: var(--on-background1);
+    border: var(--theme-border-style) var(--hard-y);
+    background: var(--soft-y);
+    color: var(--on-y);
     padding: $default-padding;
 
+    &::placeholder{
+      color: var(--metadata);
+    }
+
+    &:not(:disabled):hover{
+      border: var(--theme-border-style) var(--soft-background4);
+    }
+
+    &:disabled {
+      background-color: var(--hard-y);
+    }
+
     &:focus {
-      background: var(--dark-background1);
+      background: var(--soft-background4);
     }
   }
 }

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

@@ -5,7 +5,7 @@ import { useLayoutEffect, memo } from 'react'
 
 import PropTypes from 'prop-types'
 
-import styleNames from '@pareto-engineering/bem'
+import styleNames from '@pareto-engineering/bem/exports'
 
 import { useField } from 'formik'
 
@@ -30,17 +30,21 @@ const TextareaInput = ({
   labelAsDescription,
   textAreaId,
   rows,
+  optional,
   textAreaColor,
   labelColor,
   description,
   disabled,
+  placeholder,
+  autoComplete,
+  resize,
   // ...otherProps
 }) => {
   useLayoutEffect(() => {
     import('./styles.scss')
   }, [])
 
-  const [field, meta] = useField({ name, validate })
+  const [field] = useField({ name, validate })
 
   return (
     <div
@@ -51,8 +55,7 @@ const TextareaInput = ({
 
         componentClassName,
         userClassName,
-        `x-${textAreaColor}`,
-        `y-${labelColor}`,
+        `y-${textAreaColor}`,
       ]
         .filter((e) => e)
         .join(' ')}
@@ -60,31 +63,29 @@ const TextareaInput = ({
       // {...otherProps}
     >
       <FormLabel
-        className={[
-          'c-y', labelAsDescription ? 'md-s2 s0 v1 mb-v' : 'v50 mb-v']
+        className={[labelAsDescription ? 'md-s2 s0 v1 mb-v' : 'v50 mb-v']
           .filter((e) => e)
           .join(' ')}
         name={name}
+        color={labelColor}
+        optional={optional}
       >
         { label }
       </FormLabel>
       <textarea
         id={textAreaId}
-        className={`textarea v50 pv-v ${meta.touched && meta.error ? 'input-border-error' : 'input-border'}`}
+        className="textarea"
         {...field}
+        style={{ resize }}
+        placeholder={placeholder}
         rows={rows}
         disabled={disabled}
+        autoComplete={autoComplete}
       >
         {/* It was a dark and stormy night... */}
       </textarea>
 
-      {(description || (meta.touched && meta.error))
-      && (
-      <FormDescription isError={!!meta.error} className="v50 mt-v s-1">
-        { meta.error || description }
-      </FormDescription>
-      )}
-      {' '}
+      <FormDescription className="v50 mt-v s-1" description={description} name={name} />
     </div>
   )
 }
@@ -123,37 +124,64 @@ TextareaInput.propTypes = {
    * If the text area depends on it's label's text as the default description
    */
   labelAsDescription:PropTypes.bool,
+
   /**
    * The textarea id
   */
-  textAreaId        :PropTypes.string,
+  textAreaId:PropTypes.string,
+
   /**
    * The number of rows int the text area
    */
-  rows              :PropTypes.number,
+  rows:PropTypes.number,
+
   /**
    * Text area base color
    */
-  textAreaColor     :PropTypes.string,
+  textAreaColor:PropTypes.string,
+
   /**
    * Label base color
    */
-  labelColor        :PropTypes.string,
+  labelColor:PropTypes.string,
+
   /**
    * Text area description
    */
-  description       :PropTypes.string,
+  description:PropTypes.string,
+
   /**
    * Whether the text area should be disabled
    */
-  disabled          :PropTypes.bool,
+  disabled:PropTypes.bool,
+
+  /**
+   * The textarea placeholder text
+   */
+  placeholder:PropTypes.string,
+
+  /**
+   * The autoComplete value that the browser should watch for the input
+   */
+  autoComplete:PropTypes.string,
+
+  /**
+   * Whether to disable or allow only a certain method of resizing the area
+   * Textarea docs - https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea
+   */
+  resize:PropTypes.string,
+
+  /**
+  * Whether the input is optional or not
+  */
+  optional:PropTypes.bool,
 }
 
 TextareaInput.defaultProps = {
   rows         :3,
-  textAreaColor:'background1',
-  labelColor   :'main1',
+  textAreaColor:'background2',
   disabled     :false,
+  resize       :'vertical',
 }
 
 export default memo(TextareaInput)

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

@@ -1,19 +1,32 @@
 /* @pareto-engineering/generator-front 1.0.12 */
 @use "@pareto-engineering/bem";
 
+$default-padding: .5em;
+
 .#{bem.$base}.text-area-input{
   display: flex;
   flex-direction: column;
 
   .textarea {
-    background: var(--light-x);
-    color: var(--on-x);
+    border: var(--theme-border-style) var(--hard-y);
+    background: var(--soft-y);
+    color: var(--on-y);
+    padding: $default-padding;
 
-    &:focus {
-      background: var(--dark-x);
+    &::placeholder{
+      color: var(--metadata);
     }
-  }
-}
 
+    &:not(:disabled):hover{
+      border: var(--theme-border-style) var(--soft-background4);
+    }
 
+     &:disabled {
+      background-color: var(--hard-y);
+    }
 
+    &:focus {
+      background: var(--soft-background4);
+    }
+  }
+}

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

@@ -1,8 +1,9 @@
 export { TextInput } from './TextInput'
 export { SelectInput } from './SelectInput'
-export { RadioInput } from './RadioInput'
-export { CheckboxInput } from './CheckboxInput'
-export { TaskRecommendationInput } from './TaskRecommendationInput'
 export { ChoicesInput } from './ChoicesInput'
 export { TextareaInput } from './TextareaInput'
 export { RatingsInput } from './RatingsInput'
+export { QueryCombobox } from './QueryCombobox'
+export { QuerySelect } from './QuerySelect'
+export { Checkbox } from './Checkbox'
+export { QueryChoices } from './QueryChoices'

package/src/ui/form-reset.scss

@@ -19,7 +19,7 @@ button,
 textarea,
 label,
 select {
-  background-color: inherit;
+  // background-color: inherit;
   border: 0;
   display: inline-block;
   font: inherit;

package/src/ui/form.scss

@@ -1,7 +1,7 @@
 @use "form-reset.scss";
 
-$form-input-border-bottom: 1px solid var(--dark-background1);
-$form-input-on-focus-border-bottom: 1px solid var(--light-main1);
+$form-input-border-bottom: 1px solid var(--hard-background1);
+$form-input-on-focus-border-bottom: 1px solid var(--soft-main1);
 $form-input-on-error-border-bottom: 1px solid var(--error);
 $label-input-heigth-width: 100%;
 

package/src/ui/index.js

@@ -4,3 +4,5 @@ export * from './b'
 export * from './c'
 export * from './d'
 export * from './f'
+export * from './utils'
+export * from './test'

package/src/ui/test/QueryLoader/QueryLoader.jsx

@@ -0,0 +1,41 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import { useEffect, Suspense } from 'react'
+
+import { useQueryLoader } from 'react-relay'
+
+// Local Definitions
+
+import { PreloadedTestData } from './common'
+
+const testQuery = graphql`
+  query QueryLoaderHelloQuery {
+    hello
+  }
+`
+
+/**
+ * This is the component description.
+ */
+const QueryLoader = () => {
+  const [queryReference, loadQuery] = useQueryLoader(testQuery)
+
+  useEffect(() => {
+    loadQuery({})
+  }, [])
+
+  return (
+    <Suspense fallback="loading">
+      {queryReference ? (
+        <PreloadedTestData queryReference={queryReference} query={testQuery} />
+      ) : null}
+    </Suspense>
+  )
+}
+
+QueryLoader.defaultProps = {
+  // someProp:false
+}
+
+export default QueryLoader

package/src/ui/test/QueryLoader/__generated__/QueryLoaderHelloQuery.graphql.js

@@ -0,0 +1,68 @@
+/**
+ * @flow
+ */
+
+/* eslint-disable */
+
+'use strict';
+
+/*::
+import type { ConcreteRequest } from 'relay-runtime';
+export type QueryLoaderHelloQueryVariables = {||};
+export type QueryLoaderHelloQueryResponse = {|
+  +hello: ?string
+|};
+export type QueryLoaderHelloQuery = {|
+  variables: QueryLoaderHelloQueryVariables,
+  response: QueryLoaderHelloQueryResponse,
+|};
+*/
+
+
+/*
+query QueryLoaderHelloQuery {
+  hello
+}
+*/
+
+const node/*: ConcreteRequest*/ = (function(){
+var v0 = [
+  {
+    "alias": null,
+    "args": null,
+    "kind": "ScalarField",
+    "name": "hello",
+    "storageKey": null
+  }
+];
+return {
+  "fragment": {
+    "argumentDefinitions": [],
+    "kind": "Fragment",
+    "metadata": null,
+    "name": "QueryLoaderHelloQuery",
+    "selections": (v0/*: any*/),
+    "type": "Query",
+    "abstractKey": null
+  },
+  "kind": "Request",
+  "operation": {
+    "argumentDefinitions": [],
+    "kind": "Operation",
+    "name": "QueryLoaderHelloQuery",
+    "selections": (v0/*: any*/)
+  },
+  "params": {
+    "cacheID": "463f9ee8a82dd6ec8dedeb28649cce74",
+    "id": null,
+    "metadata": {},
+    "name": "QueryLoaderHelloQuery",
+    "operationKind": "query",
+    "text": "query QueryLoaderHelloQuery {\n  hello\n}\n"
+  }
+};
+})();
+// prettier-ignore
+(node/*: any*/).hash = 'b92d001ab0208bd484a99f77c274d5ef';
+
+module.exports = node;

package/src/ui/test/QueryLoader/common/PreloadedTestData/PreloadedTestData.jsx

@@ -0,0 +1,51 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import PropTypes from 'prop-types'
+
+import { usePreloadedQuery } from 'react-relay'
+
+/**
+ * This is the component description.
+ */
+const PreloadedTestData = ({
+  query,
+  queryReference,
+  // ...otherProps
+}) => {
+  const data = usePreloadedQuery(query, queryReference)
+
+  return (
+    <pre>
+      {JSON.stringify(data, null, 2)}
+    </pre>
+  )
+}
+
+PreloadedTestData.propTypes = {
+  /**
+   * The query to be used to query the test data
+   */
+  query:PropTypes.objectOf(
+    PropTypes.PropTypes.oneOfType([
+      PropTypes.string,
+      PropTypes.object,
+    ]),
+  ),
+
+  /**
+   *  The query reference to be used to access the preloaded data
+   */
+  queryReference:PropTypes.objectOf(
+    PropTypes.PropTypes.oneOfType([
+      PropTypes.string,
+      PropTypes.object,
+    ]),
+  ),
+}
+
+PreloadedTestData.defaultProps = {
+  // someProp:false
+}
+
+export default PreloadedTestData

package/src/ui/test/QueryLoader/common/PreloadedTestData/index.js

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

package/src/ui/test/QueryLoader/common/index.js

@@ -0,0 +1 @@
+export { PreloadedTestData } from './PreloadedTestData'

package/src/ui/test/QueryLoader/index.js

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

package/src/ui/test/index.js

@@ -0,0 +1 @@
+export { QueryLoader } from './QueryLoader'

package/src/ui/utils/hooks/index.js

@@ -0,0 +1,2 @@
+export { default as useWindowSize } from './useWindowSize'
+export { default as useDynamicPosition } from './useDynamicPosition'

package/src/ui/utils/hooks/useDynamicPosition.js

@@ -0,0 +1,104 @@
+import {
+  useState, useEffect, useMemo, useCallback,
+} from 'react'
+import throttle from 'lodash/throttle'
+import useWindowSize from './useWindowSize'
+
+const verticalPositions = ['top', 'bottom']
+const horizontalPositions = ['left', 'right']
+
+const findCompatiblePositions = (primary, secondaryArray) => {
+  if (verticalPositions.includes(primary)) {
+    return secondaryArray.filter((secondary) => horizontalPositions.includes(secondary))
+  } if (horizontalPositions.includes(primary)) {
+    return secondaryArray.filter((secondary) => verticalPositions.includes(secondary))
+  }
+  return []
+}
+
+const useDynamicPosition = ({
+  elementRef,
+  parentRef,
+  preferredPrimaryOrder,
+  preferredSecondaryOrder,
+  // offsetYPx,
+  offsetXPx,
+  throttleMs = 200,
+}) => {
+  const isClient = typeof window === 'object'
+  const {
+    height:currentHeight,
+    width:currentWidth,
+  } = useWindowSize()
+
+  const [primaryPosition, setPrimaryPosition] = useState(preferredPrimaryOrder[0])
+  const compatibleSecondaryPositions = useMemo(
+    () => findCompatiblePositions(
+      primaryPosition,
+      preferredSecondaryOrder,
+    ), [primaryPosition, preferredSecondaryOrder],
+  )
+  const [secondaryPosition, setSecondaryPosition] = useState(compatibleSecondaryPositions[0])
+
+  const handle = useCallback(
+    throttle(() => {
+      const parentNode = parentRef?.current
+      const elementNode = elementRef?.current
+
+      const {
+        top:parentTop,
+        bottom: parentBottom,
+        right: parentRight,
+        left: parentLeft,
+      } = parentNode?.getBoundingClientRect() || {}
+
+      const {
+        width:elementWidth,
+        height:elementHeight,
+      } = elementNode?.getBoundingClientRect() || {}
+
+      const availablePositions = {
+        top   :parentTop >= elementHeight,
+        bottom:currentHeight - parentBottom >= elementHeight,
+        right :parentRight >= elementWidth,
+        left  :currentWidth - parentLeft >= elementWidth,
+      }
+
+      for (let i = 0; i < preferredPrimaryOrder.length; i += 1) {
+        const position = preferredPrimaryOrder[i]
+        if (availablePositions[position]) {
+          setPrimaryPosition(position)
+          break
+        }
+      }
+
+      for (let i = 0; i < compatibleSecondaryPositions.length; i += 1) {
+        const position = compatibleSecondaryPositions[i]
+        if (availablePositions[position]) {
+          setSecondaryPosition(position)
+          break
+        }
+      }
+    }, throttleMs),
+    [elementRef, offsetXPx, throttleMs],
+  )
+
+  useEffect(() => {
+    if (!isClient) {
+      return false
+    }
+
+    handle()
+    window.addEventListener('scroll', handle)
+    window.addEventListener('resize', handle)
+
+    return () => {
+      window.removeEventListener('scroll', handle)
+      window.removeEventListener('resize', handle)
+    }
+  }, [handle])
+
+  return { primaryPosition, secondaryPosition }
+}
+
+export default useDynamicPosition