@pareto-engineering/design-system 2.0.0-alpha.46 → 2.0.0-alpha.47

package/dist/cjs/f/fields/QueryCombobox/QueryCombobox.js

@@ -36,7 +36,7 @@ var QueryCombobox = _ref => {
     style,
     className,
     query,
-    // multiple,
+    multiple,
     name,
     label,
     color,
@@ -46,7 +46,9 @@ var QueryCombobox = _ref => {
     graphQlNode,
     searchVariable,
     extraVariables,
-    optionsKeyMap // ...otherProps
+    optionsKeyMap,
+    minLength,
+    transformSearch // ...otherProps
 
   } = _ref;
   (0, React.useLayoutEffect)(() => {
@@ -115,9 +117,11 @@ var QueryCombobox = _ref => {
     value,
     color,
     isFetching,
-    className
+    className,
+    minLength,
+    transformSearch
   };
-  var Input = _common.Combobox;
+  var Input = multiple ? _common.MultipleCombobox : _common.Combobox;
   return /*#__PURE__*/React.createElement(Input, comboboxProps);
 };
 
@@ -199,7 +203,17 @@ QueryCombobox.propTypes = {
   /**
    * The variable to be used to search the data
    */
-  searchVariable: _propTypes.default.string
+  searchVariable: _propTypes.default.string,
+
+  /**
+   * The minimum length of the search input to start fetching the options
+   */
+  minLength: _propTypes.default.number,
+
+  /**
+   * The function to transform the search input
+   */
+  transformSearch: _propTypes.default.func
 };
 QueryCombobox.defaultProps = {
   optionsKeyMap: {
@@ -208,7 +222,9 @@ QueryCombobox.defaultProps = {
   },
   multiple: false,
   color: 'background2',
-  searchVariable: 'search'
+  searchVariable: 'search',
+  transformSearch: search => search,
+  minLength: 2
 };
 var _default = QueryCombobox;
 exports.default = _default;

package/dist/cjs/f/fields/QueryCombobox/common/Combobox/Combobox.js

@@ -47,8 +47,9 @@ var Combobox = _ref => {
     description,
     value,
     color,
-    loadingCircleColor,
-    isFetching // ...otherProps
+    minLength,
+    isFetching,
+    transformSearch // ...otherProps
 
   } = _ref;
   var {
@@ -69,7 +70,11 @@ var Combobox = _ref => {
       var {
         inputValue
       } = _ref2;
-      getOptions(inputValue);
+      var transformedInput = transformSearch(inputValue);
+
+      if (transformedInput.length > minLength) {
+        getOptions(transformedInput);
+      }
     }
   }); // If the user has selected an item, we'll set the value of the field
   // or if the combobox state has a selected item, we'll set the value to the formik state
@@ -88,7 +93,7 @@ var Combobox = _ref => {
   var parentRef = (0, React.useRef)(null);
   return /*#__PURE__*/React.createElement("div", {
     id: id,
-    className: [baseClassName, componentClassName, userClassName, "y-".concat(color), "x-".concat(loadingCircleColor)].filter(e => e).join(' '),
+    className: [baseClassName, componentClassName, userClassName, "y-".concat(color)].filter(e => e).join(' '),
     style: style,
     ref: parentRef
   }, /*#__PURE__*/React.createElement(_.FormLabel, _extends({}, getLabelProps(), {
@@ -97,7 +102,9 @@ var Combobox = _ref => {
     className: "input-wrapper"
   }), /*#__PURE__*/React.createElement("input", _extends({}, getInputProps(), {
     className: "input"
-  })), isFetching && /*#__PURE__*/React.createElement(_a.LoadingCircle, null)), /*#__PURE__*/React.createElement(_a.Popover, {
+  })), isFetching && /*#__PURE__*/React.createElement(_a.LoadingCircle, {
+    className: "x-main2"
+  })), /*#__PURE__*/React.createElement(_a.Popover, {
     isOpen: isOpen,
     parentRef: parentRef
   }, /*#__PURE__*/React.createElement(_Menu.Menu, _extends({
@@ -183,12 +190,16 @@ Combobox.propTypes = {
   isFetching: _propTypes.default.bool.isRequired,
 
   /**
-   * The loading circle color
+   * The minimum length of the search input to start fetching the options
+   */
+  minLength: _propTypes.default.number,
+
+  /**
+   * The function to transform the search input
    */
-  loadingCircleColor: _propTypes.default.string
+  transformSearch: _propTypes.default.func
 };
-Combobox.defaultProps = {
-  loadingCircleColor: 'main2'
+Combobox.defaultProps = {// someProp: false
 };
 var _default = Combobox;
 exports.default = _default;

package/dist/cjs/f/fields/QueryCombobox/common/MultipleCombobox/MultipleCombobox.js

@@ -65,7 +65,8 @@ var MultipleCombobox = _ref => {
     value,
     color,
     isFetching,
-    loadingCircleColor // ...otherProps
+    minLength,
+    transformSearch // ...otherProps
 
   } = _ref;
   var [searchInputValue, setSearchInputValue] = (0, React.useState)('');
@@ -79,8 +80,12 @@ var MultipleCombobox = _ref => {
   } = (0, _downshift.useMultipleSelection)({
     initialSelectedItems: value || []
   });
+  /**
+   * @returns {Boolean} - Unique items from the options array so that the combobox
+   * shows only the options that are not yet selected.
+  */
 
-  var getFilteredItems = () => items.filter(item => selectedItems.findIndex(e => e.label === item.label) < 0 && item.label.toLowerCase().startsWith(searchInputValue.toLowerCase()));
+  var getFilteredItems = () => items.filter(item => selectedItems.findIndex(e => e.label === item.label) < 0);
 
   var {
     isOpen,
@@ -126,9 +131,16 @@ var MultipleCombobox = _ref => {
 
       switch (type) {
         case _downshift.useCombobox.stateChangeTypes.InputChange:
-          getOptions(newSearchInputValue);
-          setSearchInputValue(newSearchInputValue);
-          break;
+          {
+            var transformedInput = transformSearch(newSearchInputValue);
+
+            if (transformedInput.length > minLength) {
+              getOptions(transformedInput);
+            }
+
+            setSearchInputValue(newSearchInputValue);
+            break;
+          }
 
         case _downshift.useCombobox.stateChangeTypes.InputKeyDownEnter:
         case _downshift.useCombobox.stateChangeTypes.ItemClick:
@@ -158,7 +170,7 @@ var MultipleCombobox = _ref => {
   var parentRef = (0, React.useRef)(null);
   return /*#__PURE__*/React.createElement("div", {
     id: id,
-    className: [baseClassName, componentClassName, userClassName, "y-".concat(color), "x-".concat(loadingCircleColor)].filter(e => e).join(' '),
+    className: [baseClassName, componentClassName, userClassName, "y-".concat(color)].filter(e => e).join(' '),
     style: style
   }, /*#__PURE__*/React.createElement(_.FormLabel, _extends({}, getLabelProps(), {
     name: name
@@ -184,7 +196,9 @@ var MultipleCombobox = _ref => {
     preventKeyAction: isOpen
   })), {
     className: "input"
-  })), isFetching && /*#__PURE__*/React.createElement(_a.LoadingCircle, null)), /*#__PURE__*/React.createElement(_a.Popover, {
+  })), isFetching && /*#__PURE__*/React.createElement(_a.LoadingCircle, {
+    className: "x-main2"
+  })), /*#__PURE__*/React.createElement(_a.Popover, {
     isOpen: isOpen,
     parentRef: parentRef
   }, /*#__PURE__*/React.createElement(_Menu.Menu, _extends({
@@ -270,12 +284,16 @@ MultipleCombobox.propTypes = {
   isFetching: _propTypes.default.bool.isRequired,
 
   /**
-   * The loading circle color
+   * The minimum length of the search input to start fetching the options
+   */
+  minLength: _propTypes.default.number,
+
+  /**
+   * The function to transform the search input
    */
-  loadingCircleColor: _propTypes.default.string
+  transformSearch: _propTypes.default.func
 };
-MultipleCombobox.defaultProps = {
-  loadingCircleColor: 'main2'
+MultipleCombobox.defaultProps = {// someProp: false
 };
 var _default = MultipleCombobox;
 exports.default = _default;

package/dist/cjs/f/fields/QueryCombobox/common/index.js

@@ -15,7 +15,15 @@ Object.defineProperty(exports, "Combobox", {
     return _Combobox.Combobox;
   }
 });
+Object.defineProperty(exports, "MultipleCombobox", {
+  enumerable: true,
+  get: function get() {
+    return _MultipleCombobox.MultipleCombobox;
+  }
+});
 
 var _Menu = require("./Menu");
 
-var _Combobox = require("./Combobox");
+var _Combobox = require("./Combobox");
+
+var _MultipleCombobox = require("./MultipleCombobox");

package/dist/cjs/f/fields/QueryCombobox/styles.scss

@@ -73,12 +73,6 @@ $default-loading-circle-displacement: 1em;
 .#{bem.$base}.multiple-combobox {
     >.selected-items {
         display: flex;
-
-        /* stylelint-disable selector-max-universal -- Allow */
-        >*:not(:first-child) {
-            margin-left: $default-margin;
-        }
-
-        /* stylelint-enable selector-max-universal */
+        gap: var(--default-gap);
     }
 }

package/dist/es/f/fields/QueryCombobox/QueryCombobox.js

@@ -5,7 +5,7 @@ import { useField } from 'formik';
 import { useRelayEnvironment, fetchQuery } from 'react-relay';
 import PropTypes from 'prop-types'; // Local Definitions
 
-import { Combobox } from "./common";
+import { Combobox, MultipleCombobox } from "./common";
 /**
  * This is the component description.
  */
@@ -15,7 +15,7 @@ const QueryCombobox = ({
   style,
   className,
   query,
-  // multiple,
+  multiple,
   name,
   label,
   color,
@@ -25,7 +25,9 @@ const QueryCombobox = ({
   graphQlNode,
   searchVariable,
   extraVariables,
-  optionsKeyMap // ...otherProps
+  optionsKeyMap,
+  minLength,
+  transformSearch // ...otherProps
 
 }) => {
   useLayoutEffect(() => {
@@ -93,9 +95,11 @@ const QueryCombobox = ({
     value,
     color,
     isFetching,
-    className
+    className,
+    minLength,
+    transformSearch
   };
-  const Input = Combobox;
+  const Input = multiple ? MultipleCombobox : Combobox;
   return /*#__PURE__*/React.createElement(Input, comboboxProps);
 };
 
@@ -177,7 +181,17 @@ QueryCombobox.propTypes = {
   /**
    * The variable to be used to search the data
    */
-  searchVariable: PropTypes.string
+  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
 };
 QueryCombobox.defaultProps = {
   optionsKeyMap: {
@@ -186,6 +200,8 @@ QueryCombobox.defaultProps = {
   },
   multiple: false,
   color: 'background2',
-  searchVariable: 'search'
+  searchVariable: 'search',
+  transformSearch: search => search,
+  minLength: 2
 };
 export default QueryCombobox;

package/dist/es/f/fields/QueryCombobox/common/Combobox/Combobox.js

@@ -29,8 +29,9 @@ const Combobox = ({
   description,
   value,
   color,
-  loadingCircleColor,
-  isFetching // ...otherProps
+  minLength,
+  isFetching,
+  transformSearch // ...otherProps
 
 }) => {
   const {
@@ -50,7 +51,11 @@ const Combobox = ({
     onInputValueChange: ({
       inputValue
     }) => {
-      getOptions(inputValue);
+      const transformedInput = transformSearch(inputValue);
+
+      if (transformedInput.length > minLength) {
+        getOptions(transformedInput);
+      }
     }
   }); // If the user has selected an item, we'll set the value of the field
   // or if the combobox state has a selected item, we'll set the value to the formik state
@@ -69,7 +74,7 @@ const Combobox = ({
   const parentRef = useRef(null);
   return /*#__PURE__*/React.createElement("div", {
     id: id,
-    className: [baseClassName, componentClassName, userClassName, `y-${color}`, `x-${loadingCircleColor}`].filter(e => e).join(' '),
+    className: [baseClassName, componentClassName, userClassName, `y-${color}`].filter(e => e).join(' '),
     style: style,
     ref: parentRef
   }, /*#__PURE__*/React.createElement(FormLabel, _extends({}, getLabelProps(), {
@@ -78,7 +83,9 @@ const Combobox = ({
     className: "input-wrapper"
   }), /*#__PURE__*/React.createElement("input", _extends({}, getInputProps(), {
     className: "input"
-  })), isFetching && /*#__PURE__*/React.createElement(LoadingCircle, null)), /*#__PURE__*/React.createElement(Popover, {
+  })), isFetching && /*#__PURE__*/React.createElement(LoadingCircle, {
+    className: "x-main2"
+  })), /*#__PURE__*/React.createElement(Popover, {
     isOpen: isOpen,
     parentRef: parentRef
   }, /*#__PURE__*/React.createElement(Menu, _extends({
@@ -164,11 +171,15 @@ Combobox.propTypes = {
   isFetching: PropTypes.bool.isRequired,
 
   /**
-   * The loading circle color
+   * The minimum length of the search input to start fetching the options
+   */
+  minLength: PropTypes.number,
+
+  /**
+   * The function to transform the search input
    */
-  loadingCircleColor: PropTypes.string
+  transformSearch: PropTypes.func
 };
-Combobox.defaultProps = {
-  loadingCircleColor: 'main2'
+Combobox.defaultProps = {// someProp: false
 };
 export default Combobox;

package/dist/es/f/fields/QueryCombobox/common/MultipleCombobox/MultipleCombobox.js

@@ -40,7 +40,8 @@ const MultipleCombobox = ({
   value,
   color,
   isFetching,
-  loadingCircleColor // ...otherProps
+  minLength,
+  transformSearch // ...otherProps
 
 }) => {
   const [searchInputValue, setSearchInputValue] = useState('');
@@ -54,8 +55,12 @@ const MultipleCombobox = ({
   } = 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 getFilteredItems = () => items.filter(item => selectedItems.findIndex(e => e.label === item.label) < 0 && item.label.toLowerCase().startsWith(searchInputValue.toLowerCase()));
+  const getFilteredItems = () => items.filter(item => selectedItems.findIndex(e => e.label === item.label) < 0);
 
   const {
     isOpen,
@@ -99,9 +104,16 @@ const MultipleCombobox = ({
     }) => {
       switch (type) {
         case useCombobox.stateChangeTypes.InputChange:
-          getOptions(newSearchInputValue);
-          setSearchInputValue(newSearchInputValue);
-          break;
+          {
+            const transformedInput = transformSearch(newSearchInputValue);
+
+            if (transformedInput.length > minLength) {
+              getOptions(transformedInput);
+            }
+
+            setSearchInputValue(newSearchInputValue);
+            break;
+          }
 
         case useCombobox.stateChangeTypes.InputKeyDownEnter:
         case useCombobox.stateChangeTypes.ItemClick:
@@ -131,7 +143,7 @@ const MultipleCombobox = ({
   const parentRef = useRef(null);
   return /*#__PURE__*/React.createElement("div", {
     id: id,
-    className: [baseClassName, componentClassName, userClassName, `y-${color}`, `x-${loadingCircleColor}`].filter(e => e).join(' '),
+    className: [baseClassName, componentClassName, userClassName, `y-${color}`].filter(e => e).join(' '),
     style: style
   }, /*#__PURE__*/React.createElement(FormLabel, _extends({}, getLabelProps(), {
     name: name
@@ -157,7 +169,9 @@ const MultipleCombobox = ({
     preventKeyAction: isOpen
   })), {
     className: "input"
-  })), isFetching && /*#__PURE__*/React.createElement(LoadingCircle, null)), /*#__PURE__*/React.createElement(Popover, {
+  })), isFetching && /*#__PURE__*/React.createElement(LoadingCircle, {
+    className: "x-main2"
+  })), /*#__PURE__*/React.createElement(Popover, {
     isOpen: isOpen,
     parentRef: parentRef
   }, /*#__PURE__*/React.createElement(Menu, _extends({
@@ -243,11 +257,15 @@ MultipleCombobox.propTypes = {
   isFetching: PropTypes.bool.isRequired,
 
   /**
-   * The loading circle color
+   * The minimum length of the search input to start fetching the options
+   */
+  minLength: PropTypes.number,
+
+  /**
+   * The function to transform the search input
    */
-  loadingCircleColor: PropTypes.string
+  transformSearch: PropTypes.func
 };
-MultipleCombobox.defaultProps = {
-  loadingCircleColor: 'main2'
+MultipleCombobox.defaultProps = {// someProp: false
 };
 export default MultipleCombobox;

package/dist/es/f/fields/QueryCombobox/common/index.js

@@ -1,2 +1,3 @@
 export { Menu } from "./Menu";
-export { Combobox } from "./Combobox";
+export { Combobox } from "./Combobox";
+export { MultipleCombobox } from "./MultipleCombobox";

package/dist/es/f/fields/QueryCombobox/styles.scss

@@ -73,12 +73,6 @@ $default-loading-circle-displacement: 1em;
 .#{bem.$base}.multiple-combobox {
     >.selected-items {
         display: flex;
-
-        /* stylelint-disable selector-max-universal -- Allow */
-        >*:not(:first-child) {
-            margin-left: $default-margin;
-        }
-
-        /* stylelint-enable selector-max-universal */
+        gap: var(--default-gap);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pareto-engineering/design-system",
-  "version": "2.0.0-alpha.46",
+  "version": "2.0.0-alpha.47",
   "description": "",
   "main": "dist/cjs/index.js",
   "module": "dist/es/index.js",

package/src/__snapshots__/Storyshots.test.js.snap

@@ -10737,7 +10737,7 @@ exports[`Storyshots f/FormInput With Query Combobox 1`] = `
     </div>
   </div>
   <div
-    className="base combobox form-input y-background2 x-main2"
+    className="base combobox form-input y-background2"
   >
     <label
       className="base label x-main2"
@@ -11353,6 +11353,201 @@ exports[`Storyshots f/fields/ChoicesInput Multiple With Grid 1`] = `
 </form>
 `;
 
+exports[`Storyshots f/fields/QueryCombobox Multiple Select 1`] = `
+<form
+  action="#"
+  onReset={[Function]}
+  onSubmit={[Function]}
+>
+  <div
+    className="base multiple-combobox y-background2"
+  >
+    <label
+      className="base label x-main2"
+      htmlFor="teams"
+      id="downshift-3-label"
+    >
+      Search for a team
+    </label>
+    <div
+      className="selected-items"
+    />
+    <div
+      aria-expanded={false}
+      aria-haspopup="listbox"
+      aria-owns="downshift-3-menu"
+      className="input-wrapper"
+      role="combobox"
+    >
+      <input
+        aria-autocomplete="list"
+        aria-controls="downshift-3-menu"
+        aria-labelledby="downshift-3-label"
+        autoComplete="off"
+        className="input"
+        id="downshift-3-input"
+        onBlur={[Function]}
+        onChange={[Function]}
+        onClick={[Function]}
+        onKeyDown={[Function]}
+        value=""
+      />
+    </div>
+    <div
+      className="base popover x-background1 bottom left"
+    >
+      <ul
+        aria-labelledby="downshift-3-label"
+        className="base menu"
+        id="downshift-3-menu"
+        onMouseLeave={[Function]}
+        role="listbox"
+      />
+    </div>
+  </div>
+  <div
+    style={
+      Object {
+        "alignItems": "flex-end",
+        "display": "flex",
+        "flexDirection": "column",
+      }
+    }
+  >
+    <div
+      className="debugger"
+    >
+      <button
+        className="base button x-main2"
+        onClick={[Function]}
+        type="button"
+      >
+        Open FormDebugger
+      </button>
+    </div>
+    <button
+      className="base button x-main1"
+      onClick={[Function]}
+      type="button"
+    >
+      Add formik values
+    </button>
+  </div>
+</form>
+`;
+
+exports[`Storyshots f/fields/QueryCombobox Multiple Select With Default Formik State 1`] = `
+<form
+  action="#"
+  onReset={[Function]}
+  onSubmit={[Function]}
+>
+  <div
+    className="base multiple-combobox y-background2"
+  >
+    <label
+      className="base label x-main2"
+      htmlFor="teams"
+      id="downshift-4-label"
+    >
+      Search for a team
+    </label>
+    <div
+      className="selected-items"
+    >
+      <div
+        onClick={[Function]}
+        onKeyDown={[Function]}
+        tabIndex={-1}
+      >
+        Apple
+        <button
+          className="base button f-icons x-main2 modifierCompact modifierSimple"
+          onClick={[Function]}
+          type="button"
+        >
+          X
+        </button>
+      </div>
+      <div
+        onClick={[Function]}
+        onKeyDown={[Function]}
+        tabIndex={-1}
+      >
+        Pear
+        <button
+          className="base button f-icons x-main2 modifierCompact modifierSimple"
+          onClick={[Function]}
+          type="button"
+        >
+          X
+        </button>
+      </div>
+    </div>
+    <div
+      aria-expanded={false}
+      aria-haspopup="listbox"
+      aria-owns="downshift-4-menu"
+      className="input-wrapper"
+      role="combobox"
+    >
+      <input
+        aria-autocomplete="list"
+        aria-controls="downshift-4-menu"
+        aria-labelledby="downshift-4-label"
+        autoComplete="off"
+        className="input"
+        id="downshift-4-input"
+        onBlur={[Function]}
+        onChange={[Function]}
+        onClick={[Function]}
+        onKeyDown={[Function]}
+        value=""
+      />
+    </div>
+    <div
+      className="base popover x-background1 bottom left"
+    >
+      <ul
+        aria-labelledby="downshift-4-label"
+        className="base menu"
+        id="downshift-4-menu"
+        onMouseLeave={[Function]}
+        role="listbox"
+      />
+    </div>
+  </div>
+  <div
+    style={
+      Object {
+        "alignItems": "flex-end",
+        "display": "flex",
+        "flexDirection": "column",
+      }
+    }
+  >
+    <div
+      className="debugger"
+    >
+      <button
+        className="base button x-main2"
+        onClick={[Function]}
+        type="button"
+      >
+        Open FormDebugger
+      </button>
+    </div>
+    <button
+      className="base button x-main1"
+      onClick={[Function]}
+      type="button"
+    >
+      Add formik values
+    </button>
+  </div>
+</form>
+`;
+
 exports[`Storyshots f/fields/QueryCombobox Single Select 1`] = `
 <form
   action="#"
@@ -11360,7 +11555,7 @@ exports[`Storyshots f/fields/QueryCombobox Single Select 1`] = `
   onSubmit={[Function]}
 >
   <div
-    className="base combobox y-background2 x-main2"
+    className="base combobox y-background2"
   >
     <label
       className="base label x-main2"
@@ -11426,7 +11621,7 @@ exports[`Storyshots f/fields/QueryCombobox Single Select 1`] = `
       onClick={[Function]}
       type="button"
     >
-      Replace initial value
+      Replace formik value
     </button>
   </div>
 </form>
@@ -11439,7 +11634,7 @@ exports[`Storyshots f/fields/QueryCombobox Single Select With Default Formik Sta
   onSubmit={[Function]}
 >
   <div
-    className="base combobox y-background2 x-main2"
+    className="base combobox y-background2"
   >
     <label
       className="base label x-main2"
@@ -11505,7 +11700,7 @@ exports[`Storyshots f/fields/QueryCombobox Single Select With Default Formik Sta
       onClick={[Function]}
       type="button"
     >
-      Replace initial value
+      Replace formik value
     </button>
   </div>
 </form>

package/src/local.scss

@@ -5,12 +5,12 @@
   --theme-border-style: 1px solid;
   --theme-border-color: var(--paragraph);
   --theme-border: var(--theme-border-style) var(--theme-border-color);
+  --default-gap: 1em;
 }
 
 html {
   font-family: var(--font-default);
   font-size: 18px;
-  font-feature-settings:'liga' on;
+  font-feature-settings: 'liga' on;
   scroll-behavior: smooth;
-}
-
+}

package/src/stories/f/QueryCombobox.stories.jsx

@@ -80,7 +80,7 @@ const FETCH_TEAMS_QUERY = graphql`
 `
 
 // eslint-disable-next-line react/prop-types
-const ResolvedTemplate = ({ multiple, defaultFormikState = {} }) => {
+const ResolvedTemplate = ({ multiple, defaultFormikState }) => {
   mockRelayOperation(allTeamsMockData)
   mockRelayOperation(allTeamsMockData)
   mockRelayOperation(allTeamsMockData)
@@ -88,15 +88,31 @@ const ResolvedTemplate = ({ multiple, defaultFormikState = {} }) => {
   const Content = () => {
     const name = multiple ? 'teams' : 'team'
 
-    const [, , helpers] = useField(name)
+    const [, meta, helpers] = useField(name)
+
+    const { value } = meta
 
     const { setValue } = helpers
 
     const updateFormikState = () => {
-      setValue({
-        value:'VGVhbU5vZGU6MDAxZTIyOGEtYzA5My00MGI0LWE1MTUtYTNkMTM1NTE1MDNk',
-        label:'Kafagoho',
-      })
+      if (multiple) {
+        setValue([
+          ...(value || []),
+          {
+            value:'VGVhbU5vZGU6MDAxZTIyOGEtYzA5My00MGI0LWE1MTUtYTNkMTM1NTE1MDNk',
+            label:'Matomoko',
+          },
+          {
+            value:'VGVhbU5vZGU6MDAxZTIyOGEtYzA5My00MGI0LWE1MTUtYTNkMTM1NTE1MDNp',
+            label:'Chungwa',
+          },
+        ])
+      } else {
+        setValue({
+          value:'VGVhbU5vZGU6MDAxZTIyOGEtYzA5My00MGI0LWE1MTUtYTNkMTM1NTE1MDNk',
+          label:'Kafagoho',
+        })
+      }
     }
 
     return (
@@ -124,16 +140,24 @@ const ResolvedTemplate = ({ multiple, defaultFormikState = {} }) => {
           <Button
             onClick={updateFormikState}
           >
-            {multiple ? 'Add more initial values' : 'Replace initial value'}
+            {multiple ? 'Add formik values' : 'Replace formik value'}
           </Button>
         </div>
       </>
     )
   }
 
+  let initialValues = defaultFormikState
+
+  if (!defaultFormikState && multiple) {
+    initialValues = []
+  } else if (!defaultFormikState && !multiple) {
+    initialValues = {}
+  }
+
   return (
     <Formik
-      initialValues={defaultFormikState}
+      initialValues={initialValues}
     >
       <Form>
         <Content />
@@ -158,6 +182,29 @@ SingleSelectWithDefaultFormikState.args = {
   },
 }
 
+export const MultipleSelect = ResolvedTemplate.bind({})
+MultipleSelect.args = {
+  multiple          :true,
+  defaultFormikState:{ teams: [] },
+}
+
+export const MultipleSelectWithDefaultFormikState = ResolvedTemplate.bind({})
+MultipleSelectWithDefaultFormikState.args = {
+  multiple          :true,
+  defaultFormikState:{
+    teams:[
+      {
+        value:'VGVhbU5vZGU6MDAxZTIyOGEtYzA5My00MGI0LWE1MTUtYTNkMTM1NTE1MDNl',
+        label:'Apple',
+      },
+      {
+        value:'VGVhbU5vZGU6MDA0N2U4MzktODY0Zi00N2U5LTg3ZjgtZGUwMmM2Yzg1YWJm',
+        label:'Pear',
+      },
+    ],
+  },
+}
+
 // eslint-disable-next-line react/prop-types
 // const RejectedTemplate = ({ multiple }) => {
 //   const Content = () => {

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

@@ -11,7 +11,7 @@ import PropTypes from 'prop-types'
 
 // Local Definitions
 
-import { Combobox } from './common'
+import { Combobox, MultipleCombobox } from './common'
 
 /**
  * This is the component description.
@@ -21,7 +21,7 @@ const QueryCombobox = ({
   style,
   className,
   query,
-  // multiple,
+  multiple,
   name,
   label,
   color,
@@ -32,6 +32,8 @@ const QueryCombobox = ({
   searchVariable,
   extraVariables,
   optionsKeyMap,
+  minLength,
+  transformSearch,
   // ...otherProps
 }) => {
   useLayoutEffect(() => {
@@ -103,9 +105,11 @@ const QueryCombobox = ({
     color,
     isFetching,
     className,
+    minLength,
+    transformSearch,
   }
 
-  const Input = Combobox
+  const Input = multiple ? MultipleCombobox : Combobox
 
   return <Input {...comboboxProps} />
 }
@@ -192,6 +196,16 @@ QueryCombobox.propTypes = {
    * 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,
 }
 
 QueryCombobox.defaultProps = {
@@ -199,9 +213,11 @@ QueryCombobox.defaultProps = {
     value:'id',
     label:'name',
   },
-  multiple      :false,
-  color         :'background2',
-  searchVariable:'search',
+  multiple       :false,
+  color          :'background2',
+  searchVariable :'search',
+  transformSearch:(search) => search,
+  minLength      :2,
 }
 
 export default QueryCombobox

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

@@ -37,8 +37,9 @@ const Combobox = ({
   description,
   value,
   color,
-  loadingCircleColor,
+  minLength,
   isFetching,
+  transformSearch,
   // ...otherProps
 }) => {
   const {
@@ -56,7 +57,10 @@ const Combobox = ({
     initialSelectedItem:value,
     itemToString       :(item) => (item ? item.label : ''),
     onInputValueChange :({ inputValue }) => {
-      getOptions(inputValue)
+      const transformedInput = transformSearch(inputValue)
+      if (transformedInput.length > minLength) {
+        getOptions(transformedInput)
+      }
     },
   })
 
@@ -87,7 +91,6 @@ const Combobox = ({
         componentClassName,
         userClassName,
         `y-${color}`,
-        `x-${loadingCircleColor}`,
       ]
         .filter((e) => e)
         .join(' ')}
@@ -101,7 +104,7 @@ const Combobox = ({
       <div {...getComboboxProps()} className="input-wrapper">
         <input {...getInputProps()} className="input" />
         {isFetching && (
-        <LoadingCircle />
+        <LoadingCircle className="x-main2" />
         )}
       </div>
 
@@ -202,13 +205,18 @@ Combobox.propTypes = {
   isFetching:PropTypes.bool.isRequired,
 
   /**
-   * The loading circle color
+   * The minimum length of the search input to start fetching the options
    */
-  loadingCircleColor:PropTypes.string,
+  minLength:PropTypes.number,
+
+  /**
+   * The function to transform the search input
+   */
+  transformSearch:PropTypes.func,
 }
 
 Combobox.defaultProps = {
-  loadingCircleColor:'main2',
+  // someProp: false
 }
 
 export default Combobox

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

@@ -0,0 +1,317 @@
+/* @pareto-engineering/generator-front 1.0.12 */
+import * as React from 'react'
+
+import { useState, useEffect, useRef } from 'react'
+
+import PropTypes from 'prop-types'
+
+import styleNames from '@pareto-engineering/bem'
+
+import { useCombobox, useMultipleSelection } from 'downshift'
+
+import { Button } from 'ui/b'
+
+import { Popover, LoadingCircle } from 'ui/a'
+
+import { FormDescription, FormLabel } from 'ui/f'
+
+// Local Definitions
+
+import { Menu } from '../Menu'
+
+const baseClassName = styleNames.base
+
+const componentClassName = 'multiple-combobox'
+
+/**
+ *  @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 MultipleCombobox = ({
+  id,
+  className:userClassName,
+  style,
+  label,
+  name,
+  options:items,
+  getOptions,
+  setValue,
+  error,
+  description,
+  value,
+  color,
+  isFetching,
+  minLength,
+  transformSearch,
+  // ...otherProps
+}) => {
+  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 getFilteredItems = () => items
+    .filter((item) => selectedItems
+      .findIndex((e) => e.label === item.label) < 0)
+
+  const {
+    isOpen,
+    getLabelProps,
+    getMenuProps,
+    getInputProps,
+    getComboboxProps,
+    highlightedIndex,
+    getItemProps,
+  } = useCombobox({
+    searchInputValue,
+    defaultHighlightedIndex:0, // after selection, highlight the first item.
+    selectedItem           :null,
+    items                  :getFilteredItems(),
+    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)
+          if (transformedInput.length > minLength) {
+            getOptions(transformedInput)
+          }
+          setSearchInputValue(newSearchInputValue)
+          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,
+        `y-${color}`,
+      ]
+        .filter((e) => e)
+        .join(' ')}
+      style={style}
+    >
+
+      <FormLabel {...getLabelProps()} name={name}>
+        {label}
+      </FormLabel>
+
+      <div className="selected-items">
+        {selectedItems && selectedItems.map((selectedItem, index) => (
+          <div
+            key={selectedItem.label}
+            {...getSelectedItemProps({ selectedItem, index })}
+          >
+            {selectedItem.label}
+            <Button
+              className="f-icons"
+              onClick={(e) => {
+                e.stopPropagation()
+                removeSelectedItem(selectedItem)
+              }}
+              isCompact
+              isSimple
+              color="main2"
+            >
+              X
+            </Button>
+          </div>
+        ))}
+      </div>
+
+      <div {...getComboboxProps()} className="input-wrapper">
+        <input
+          {...getInputProps(
+            getDropdownProps({ preventKeyAction: isOpen }),
+          )}
+          className="input"
+        />
+        {isFetching && (
+        <LoadingCircle className="x-main2" />
+        )}
+      </div>
+
+      <Popover
+        isOpen={isOpen}
+        parentRef={parentRef}
+      >
+        <Menu
+          isOpen={isOpen}
+          getItemProps={getItemProps}
+          highlightedIndex={highlightedIndex}
+          items={getFilteredItems()}
+          {...getMenuProps()}
+        />
+      </Popover>
+
+      {(description || error) && (
+      <FormDescription isError={!!error}>
+        { error || description }
+      </FormDescription>
+      )}
+
+    </div>
+  )
+}
+
+MultipleCombobox.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 label of the custom select input
+   */
+  label:PropTypes.string,
+
+  /**
+   * The custom select input options from the backend
+   */
+  options:PropTypes.arrayOf(
+    PropTypes.shape({
+      value:PropTypes.string,
+      label:PropTypes.string,
+    }),
+  ),
+
+  /**
+   * The name of the custom select input
+   */
+  name:PropTypes.string,
+
+  /**
+   * The function to fetch the options from the backend
+   */
+  getOptions:PropTypes.func,
+
+  /**
+   * The function to set the value of the custom select input
+   */
+  setValue:PropTypes.func.isRequired,
+
+  /**
+   * The custom select input description
+   */
+  description:PropTypes.string,
+
+  /**
+   * The error object
+   */
+  error:PropTypes.objectOf(PropTypes.string),
+
+  /**
+   * The value of the custom select input
+   */
+  value:PropTypes.arrayOf(
+    PropTypes.shape({
+      value:PropTypes.string,
+      label:PropTypes.string,
+    }),
+  ),
+
+  /**
+   * The base color of the custom select input
+   */
+  color:PropTypes.string,
+
+  /**
+   * Whether the query getting the combobox options is inFlight
+   */
+  isFetching:PropTypes.bool.isRequired,
+
+  /**
+   * 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,
+
+}
+
+MultipleCombobox.defaultProps = {
+  // someProp: false
+}
+
+export default MultipleCombobox

package/src/ui/f/fields/QueryCombobox/common/MultipleCombobox/index.js

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

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

@@ -1,2 +1,3 @@
 export { Menu } from './Menu'
 export { Combobox } from './Combobox'
+export { MultipleCombobox } from './MultipleCombobox'

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

@@ -73,12 +73,6 @@ $default-loading-circle-displacement: 1em;
 .#{bem.$base}.multiple-combobox {
     >.selected-items {
         display: flex;
-
-        /* stylelint-disable selector-max-universal -- Allow */
-        >*:not(:first-child) {
-            margin-left: $default-margin;
-        }
-
-        /* stylelint-enable selector-max-universal */
+        gap: var(--default-gap);
     }
 }