@elliemae/ds-controlled-form 2.0.1 → 2.1.0-rc.10

package/esm/controlled-autocomplete/parts/controls/Controls.js

@@ -0,0 +1,55 @@
+import _jsx from '@babel/runtime/helpers/esm/jsx';
+import { useContext } from 'react';
+import { AutocompleteContext } from '../../AutocompleteCTX.js';
+import { useKeyboardNavigation } from '../../utils/hooks/useKeyboardNavigation.js';
+import { useControlsInput } from './useControlsInput.js';
+import { StyledControlsWrapper, StyledInputWrapper, StyledInput } from './styled.js';
+import { jsx } from 'react/jsx-runtime';
+
+const Controls = () => {
+  const {
+    props: {
+      autoFocus,
+      hasError,
+      placeholder,
+      inputMinWidth
+    },
+    inputRef,
+    showPopover,
+    focusOptionIdx,
+    controlsWrapperRef
+  } = useContext(AutocompleteContext);
+  const {
+    onInputKeyDown
+  } = useKeyboardNavigation();
+  const {
+    handleOnBlur,
+    handleOnInputMouseDown,
+    handleOnChange
+  } = useControlsInput();
+  return /*#__PURE__*/jsx(StyledControlsWrapper, {
+    ref: controlsWrapperRef,
+    cols: ['minmax(20px, auto)'],
+    minWidth: inputMinWidth,
+    hasError: hasError,
+    children: /*#__PURE__*/_jsx(StyledInputWrapper, {}, void 0, /*#__PURE__*/jsx(StyledInput, {
+      autoFocus: autoFocus,
+      "aria-labelledby": "combo-label",
+      "aria-controls": "combo-listbox",
+      "aria-owns": "combo-listbox",
+      "aria-activedescendant": focusOptionIdx,
+      "aria-expanded": showPopover,
+      "aria-haspopup": "listbox",
+      placeholder: placeholder,
+      role: "combobox",
+      ref: inputRef,
+      type: "text",
+      onKeyDown: onInputKeyDown,
+      onChange: handleOnChange,
+      onBlur: handleOnBlur,
+      onClick: handleOnInputMouseDown
+    }))
+  });
+};
+
+export { Controls };

package/esm/controlled-autocomplete/parts/controls/index.js

@@ -0,0 +1 @@
+export { Controls } from './Controls.js';

package/esm/controlled-autocomplete/parts/controls/styled.js

@@ -0,0 +1,32 @@
+import _taggedTemplateLiteral from '@babel/runtime/helpers/esm/taggedTemplateLiteral';
+import styled from 'styled-components';
+import { css } from '@elliemae/ds-system';
+import { Grid } from '@elliemae/ds-grid';
+
+var _templateObject, _templateObject2;
+const normalBorder = css(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n  border: 1px solid ", ";\n"])), props => props.hasError ? props.theme.colors.danger[900] : props.theme.colors.neutral[400]);
+const focusBorder = css(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["\n  border: 2px solid ", ";\n"])), _ref => {
+  let {
+    theme
+  } = _ref;
+  return theme.colors.brand[700];
+});
+const StyledControlsWrapper = /*#__PURE__*/styled(Grid).withConfig({
+  componentId: "sc-xlhlqm-0"
+})(["background:transparent;position:relative;border-radius:2px;min-width:", ";align-items:center;align-content:center;height:28px;padding-left:8px;::after{display:block;content:' ';position:absolute;top:0;left:0;right:0;bottom:0;border-radius:2px;", " pointer-events:none;z-index:7;}:focus-within{::after{", "}}"], _ref2 => {
+  let {
+    minWidth
+  } = _ref2;
+  return "".concat(minWidth, "px");
+}, normalBorder, focusBorder);
+const StyledInput = /*#__PURE__*/styled.input.withConfig({
+  componentId: "sc-xlhlqm-1"
+})(["::placeholder{font-style:italic;color:", ";}font-size:13px;line-height:13px;border:none;padding:0;outline:none;width:100%;color:", ";&:focus{outline:none;}"], props => props.theme.colors.neutral[500], props => props.theme.colors.neutral[700]);
+const StyledInputPlaceHolder = /*#__PURE__*/styled.div.withConfig({
+  componentId: "sc-xlhlqm-2"
+})(["font-style:italic;color:", ";position:absolute;display:flex;align-items:center;width:100%;user-select:none;height:28px;"], props => props.theme.colors.neutral[500]);
+const StyledInputWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "sc-xlhlqm-3"
+})(["position:relative;flex:1;margin-right:5px;display:flex;align-items:center;"]);
+
+export { StyledControlsWrapper, StyledInput, StyledInputPlaceHolder, StyledInputWrapper };

package/esm/controlled-autocomplete/parts/controls/useControlsInput.js

@@ -0,0 +1,40 @@
+import { useContext, useCallback, useMemo } from 'react';
+import { AutocompleteContext } from '../../AutocompleteCTX.js';
+
+const useControlsInput = () => {
+  const {
+    props: {
+      selectedValues,
+      onChange,
+      placeholder,
+      onFilter
+    },
+    setShowPopover,
+    inputRef
+  } = useContext(AutocompleteContext);
+  const handleOnChange = useCallback(e => {
+    const target = e.target;
+    onChange(target.value);
+    setShowPopover(true);
+    onFilter(target.value);
+  }, [onFilter, onChange, setShowPopover]);
+  const handleOnBlur = useCallback(() => {
+    setShowPopover(false);
+  }, [setShowPopover]);
+  const handleOnInputMouseDown = useCallback(e => {
+    e.stopPropagation();
+  }, []);
+  const showPlaceholder = useMemo(() => {
+    var _inputRef$current;
+
+    return !((_inputRef$current = inputRef.current) !== null && _inputRef$current !== void 0 && _inputRef$current.value) && selectedValues === '' ? placeholder : null;
+  }, [placeholder, inputRef, selectedValues]);
+  return useMemo(() => ({
+    handleOnBlur,
+    handleOnChange,
+    handleOnInputMouseDown,
+    showPlaceholder
+  }), [handleOnBlur, handleOnInputMouseDown, handleOnChange, showPlaceholder]);
+};
+
+export { useControlsInput };

package/esm/controlled-autocomplete/parts/menu-list/MenuList.js

@@ -0,0 +1,83 @@
+import _jsx from '@babel/runtime/helpers/esm/jsx';
+import { useContext, useMemo, useCallback } from 'react';
+import { DSCircularProgressIndicator } from '@elliemae/ds-circular-progress-indicator';
+import { Grid } from '@elliemae/ds-grid';
+import { StyledListWrapper, StyledVirtualListWrapper, StyledList } from './styled.js';
+import { AutocompleteDataTestid } from '../../AutocompleteDataTestids.js';
+import { AutocompleteContext } from '../../AutocompleteCTX.js';
+import { useOnElementResize } from '../../utils/hooks/useOnElementResize.js';
+import { useItemRenderer } from './useItemRenderer.js';
+import { useMenuList } from './useMenuList.js';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+const MenuList = () => {
+  var _inputRef$current2;
+
+  const {
+    props: {
+      menuMinWidth,
+      menuMaxHeight,
+      options,
+      isLoading
+    },
+    referenceElement,
+    inputRef,
+    listRef,
+    showPopover,
+    wrapperListRef,
+    controlsWrapperRef,
+    virtualListHelpers: {
+      totalSize
+    }
+  } = useContext(AutocompleteContext);
+  const ItemRenderer = useItemRenderer();
+  useMenuList();
+  const {
+    width
+  } = useOnElementResize(controlsWrapperRef);
+  const listWidth = useMemo(() => menuMinWidth || "".concat(referenceElement === null || referenceElement === void 0 ? void 0 : referenceElement.offsetWidth), // eslint-disable-next-line react-hooks/exhaustive-deps
+  [menuMinWidth, referenceElement, width]);
+  const handleOnFocus = useCallback(() => {
+    var _inputRef$current;
+
+    (_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 ? void 0 : _inputRef$current.focus();
+  }, [inputRef]);
+  return /*#__PURE__*/jsx(StyledListWrapper, {
+    tabIndex: -1,
+    ref: wrapperListRef,
+    onMouseDown: e => e.preventDefault(),
+    minWidth: listWidth,
+    id: "combo-listbox",
+    role: "listbox",
+    children: isLoading && ((_inputRef$current2 = inputRef.current) === null || _inputRef$current2 === void 0 ? void 0 : _inputRef$current2.value) !== '' ? /*#__PURE__*/_jsx(Grid, {
+      justifyContent: "center",
+      alignItems: "center",
+      style: {
+        padding: 20
+      }
+    }, void 0, /*#__PURE__*/_jsx(DSCircularProgressIndicator, {
+      size: "l",
+      loading: isLoading,
+      waiting: false,
+      showTooltip: false
+    })) : /*#__PURE__*/jsx(Fragment, {
+      children: options.length > 0 && /*#__PURE__*/jsx(StyledVirtualListWrapper, {
+        tabIndex: -1,
+        maxHeight: menuMaxHeight,
+        ref: listRef,
+        children: /*#__PURE__*/_jsx(StyledList, {
+          tabIndex: -1,
+          "aria-expanded": showPopover,
+          onFocus: handleOnFocus,
+          "data-testid": AutocompleteDataTestid.LIST,
+          style: {
+            height: totalSize,
+            margin: '8px 0px'
+          }
+        }, void 0, ItemRenderer)
+      })
+    })
+  });
+};
+
+export { MenuList };

package/esm/controlled-autocomplete/parts/menu-list/index.js

@@ -0,0 +1 @@
+export { MenuList } from './MenuList.js';

package/esm/controlled-autocomplete/parts/menu-list/styled.js

@@ -0,0 +1,24 @@
+import styled from 'styled-components';
+
+const StyledListWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "sc-m3oh2u-0"
+})(["min-width:", ";"], props => props.inline ? '100%' : "".concat(props.minWidth, "px"));
+const StyledList = /*#__PURE__*/styled.ul.withConfig({
+  componentId: "sc-m3oh2u-1"
+})(["position:relative;padding:0;"]);
+const StyledVirtualListWrapper = /*#__PURE__*/styled.div.withConfig({
+  componentId: "sc-m3oh2u-2"
+})(["overflow-y:auto;margin-top:", ";max-height:", ";"], _ref => {
+  let {
+    withHeader
+  } = _ref;
+  return withHeader ? '28px' : '';
+}, _ref2 => {
+  let {
+    maxHeight,
+    inline
+  } = _ref2;
+  return inline ? '' : "".concat(!maxHeight ? '400' : maxHeight, "px");
+});
+
+export { StyledList, StyledListWrapper, StyledVirtualListWrapper };

package/esm/controlled-autocomplete/parts/menu-list/useItemRenderer.js

@@ -0,0 +1,81 @@
+import _defineProperty from '@babel/runtime/helpers/esm/defineProperty';
+import 'core-js/modules/esnext.async-iterator.map.js';
+import 'core-js/modules/esnext.iterator.map.js';
+import 'core-js/modules/esnext.async-iterator.filter.js';
+import 'core-js/modules/esnext.iterator.constructor.js';
+import 'core-js/modules/esnext.iterator.filter.js';
+import 'core-js/modules/esnext.async-iterator.for-each.js';
+import 'core-js/modules/esnext.iterator.for-each.js';
+import { useContext, useCallback, useMemo } from 'react';
+import { SingleMenuItem } from '@elliemae/ds-form';
+import { AutocompleteContext } from '../../AutocompleteCTX.js';
+import { isSelected } from '../../utils/listHelper.js';
+import { AutocompleteDataTestid } from '../../AutocompleteDataTestids.js';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+const useItemRenderer = () => {
+  const {
+    props: {
+      options,
+      onChange,
+      selectedValues,
+      onFilter
+    },
+    inputRef,
+    setShowPopover,
+    focusOptionIdx,
+    virtualListHelpers
+  } = useContext(AutocompleteContext);
+  const {
+    virtualItems
+  } = virtualListHelpers;
+  const handleClick = useCallback((option, e) => {
+    var _inputRef$current;
+
+    if (inputRef.current) inputRef.current.value = option.label;
+    onFilter(option.label);
+    onChange(option.label);
+    setShowPopover(false);
+    (_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 ? void 0 : _inputRef$current.focus();
+    e.stopPropagation();
+    e.preventDefault();
+  }, [onFilter, onChange, setShowPopover, inputRef]);
+  const handleOnMouseDown = useCallback(e => {
+    e.preventDefault();
+  }, []);
+  const ItemRenderer = useMemo(() => virtualItems.map(vItem => {
+    const option = options[vItem.index];
+    const generalProps = {
+      wrapperStyles: {
+        position: 'absolute',
+        top: vItem.start,
+        left: 0,
+        width: '100%'
+      },
+      key: "".concat(option.dsId),
+      innerRef: vItem.measureRef
+    };
+
+    if (option.type === 'option') {
+      return /*#__PURE__*/jsx(SingleMenuItem, _objectSpread(_objectSpread({}, generalProps), {}, {
+        value: option.value,
+        label: option.label,
+        dataTestid: AutocompleteDataTestid.OPTION,
+        disabled: option.disabled,
+        onClick: e => handleClick(option, e),
+        onMouseDown: handleOnMouseDown,
+        isActive: option.dsId === focusOptionIdx,
+        isSelected: isSelected(selectedValues, option)
+      }));
+    }
+
+    return /*#__PURE__*/jsx(Fragment, {});
+  }), [options, focusOptionIdx, selectedValues, inputRef, virtualItems]);
+  return ItemRenderer;
+};
+
+export { useItemRenderer };

package/esm/controlled-autocomplete/parts/menu-list/useMenuList.js

@@ -0,0 +1,65 @@
+import { useContext, useEffect } from 'react';
+import { AutocompleteContext } from '../../AutocompleteCTX.js';
+
+const useMenuList = () => {
+  var _inputRef$current3;
+
+  const {
+    props: {
+      selectedValues,
+      onMenuOpen,
+      options
+    },
+    inputRef,
+    setCurrentOption,
+    scrollOptionIntoView,
+    setShowPopover,
+    showPopover
+  } = useContext(AutocompleteContext);
+  useEffect(() => {
+    var _inputRef$current;
+
+    if (options.length === 0 || ((_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 ? void 0 : _inputRef$current.value) === '') {
+      setShowPopover(false);
+    }
+  }, [options, inputRef, setShowPopover]);
+  useEffect(() => {
+    const getFirstOption = () => {
+      for (let i = 0; i < options.length; i += 1) if (!['section', 'separator'].includes(options[i].type)) {
+        setCurrentOption(options[i].dsId);
+        break;
+      }
+    };
+
+    if (showPopover) {
+      var _inputRef$current2;
+
+      onMenuOpen();
+
+      if (((_inputRef$current2 = inputRef.current) === null || _inputRef$current2 === void 0 ? void 0 : _inputRef$current2.value) !== '') {
+        getFirstOption();
+      } else if (Array.isArray(selectedValues)) {
+        const multiSelectedValues = selectedValues;
+
+        if (multiSelectedValues.length > 0) {
+          setCurrentOption(multiSelectedValues[multiSelectedValues.length - 1].dsId);
+          scrollOptionIntoView(multiSelectedValues[multiSelectedValues.length - 1].dsId);
+        } else {
+          getFirstOption();
+        }
+      } else {
+        const singleSelectedValue = selectedValues;
+
+        if (singleSelectedValue) {
+          setCurrentOption(selectedValues.dsId);
+          scrollOptionIntoView(selectedValues.dsId);
+        } else {
+          getFirstOption();
+        }
+      }
+    } // eslint-disable-next-line react-hooks/exhaustive-deps
+
+  }, [showPopover, (_inputRef$current3 = inputRef.current) === null || _inputRef$current3 === void 0 ? void 0 : _inputRef$current3.value]);
+};
+
+export { useMenuList };

package/esm/controlled-autocomplete/propTypes.js

@@ -0,0 +1,21 @@
+import { PropTypes } from 'react-desc';
+
+const propTypes = {
+  placeholder: PropTypes.string.description('input s placeholder value').defaultValue(''),
+  options: PropTypes.oneOfType([PropTypes.array, PropTypes.object]).description('List of options').defaultValue([]),
+  selectedValues: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.object), PropTypes.object, PropTypes.string]).description('Array of option or single option selected'),
+  autoFocus: PropTypes.bool.description('Whether the combo box uses auto focus or not').defaultValue('false'),
+  hasError: PropTypes.bool.description('Whether the combo box has error or not').defaultValue('false'),
+  onChange: PropTypes.func.description('function triggered when an option is selected it will send the options selected').defaultValue(''),
+  onSelectAll: PropTypes.func.description('function triggered when ALL button is selected from the header menu list').defaultValue(''),
+  onFilter: PropTypes.func.description('function triggered when user type in the autocomplete input').defaultValue(''),
+  onCreate: PropTypes.func.description('function triggered when user select "create" a new item whenever is not a match in the all option list').defaultValue(''),
+  onClearAll: PropTypes.func.description('function triggered when user select CLEAR button from the header menu list').defaultValue(''),
+  onMenuOpen: PropTypes.func.description('function triggered when user open the menu list').defaultValue(''),
+  inputMinWidth: PropTypes.any.description('Minimum width for the combo box input controller').defaultValue(undefined),
+  menuMinWidth: PropTypes.any.description('Minimum width for the dropdown menu').defaultValue(undefined),
+  menuMaxHeight: PropTypes.any.description('Maximum height for the dropdown menu').defaultValue(undefined),
+  withToggle: PropTypes.bool.description('POC purpose this prop will not remain').defaultValue('false')
+};
+
+export { propTypes };

package/esm/controlled-autocomplete/utils/hooks/useKeyboardNavigation.js

@@ -0,0 +1,93 @@
+import 'core-js/modules/esnext.async-iterator.find.js';
+import 'core-js/modules/esnext.iterator.constructor.js';
+import 'core-js/modules/esnext.iterator.find.js';
+import { useContext, useCallback } from 'react';
+import { AutocompleteContext } from '../../AutocompleteCTX.js';
+import { findInCircularList } from '../listHelper.js';
+
+const isOptionFocuseable = opt => !['section', 'separator'].includes(opt.type);
+
+const useKeyboardNavigation = () => {
+  const {
+    props: {
+      onKeyDown,
+      onChange,
+      options,
+      onFilter
+    },
+    setShowPopover,
+    showPopover,
+    focusOptionIdx,
+    inputRef,
+    setCurrentOption,
+    scrollOptionIntoView
+  } = useContext(AutocompleteContext);
+  const currentItemIndex = options.findIndex(opt => opt.dsId === focusOptionIdx);
+  const currentItem = options.find(item => item.dsId === focusOptionIdx);
+  const selectOption = useCallback(() => {
+    if (inputRef.current) inputRef.current.value = currentItem.label;
+    onFilter(currentItem.label);
+    onChange(currentItem.label);
+    setShowPopover(false);
+  }, [currentItem, setShowPopover, onFilter, inputRef, onChange]);
+  const onInputKeyDown = useCallback(e => {
+    const targetElement = e.target; // =============================================================================
+    // CUSTOM KEYS
+    // =============================================================================
+
+    onKeyDown(e, currentItem); // =============================================================================
+    // ENTER AND SPACE KEY SELECT OPTIONS AND OPEN CLOSE THE POPOVER
+    // =============================================================================
+
+    if (e.keyCode === 32 && targetElement.value === '' || e.key === 'Enter') {
+      if (showPopover) {
+        e.preventDefault();
+        selectOption();
+      }
+    } // =============================================================================
+    // ARROWS UP AND DOWN
+    // =============================================================================
+
+
+    if (e.key === 'ArrowDown') {
+      e.preventDefault();
+
+      if (showPopover) {
+        const nextItemIndex = findInCircularList(options, currentItemIndex, isOptionFocuseable);
+        setCurrentOption(options[nextItemIndex].dsId);
+        scrollOptionIntoView(options[nextItemIndex].dsId);
+      } else {
+        setShowPopover(true);
+      }
+    }
+
+    if (e.key === 'ArrowUp') {
+      e.preventDefault();
+
+      if (showPopover) {
+        const nextItemIndex = findInCircularList(options, currentItemIndex, isOptionFocuseable, -1);
+        setCurrentOption(options[nextItemIndex].dsId);
+        scrollOptionIntoView(options[nextItemIndex].dsId);
+      } else {
+        setShowPopover(true);
+        setTimeout(() => {
+          const nextItemIndex = findInCircularList(options, 0, isOptionFocuseable, -1);
+          setCurrentOption(options[nextItemIndex].dsId);
+          scrollOptionIntoView(options[nextItemIndex].dsId);
+        });
+      }
+    } // =============================================================================
+    // ESCAPE
+    // =============================================================================
+
+
+    if (e.key === 'Escape') {
+      setShowPopover(false);
+    }
+  }, [scrollOptionIntoView, currentItemIndex, options, currentItem, showPopover, onKeyDown, setCurrentOption, setShowPopover, selectOption]);
+  return {
+    onInputKeyDown
+  };
+};
+
+export { useKeyboardNavigation };

package/esm/controlled-autocomplete/utils/hooks/useOnElementResize.js

@@ -0,0 +1,33 @@
+import 'core-js/modules/web.dom-collections.iterator.js';
+import { useState, useRef, useEffect, useMemo } from 'react';
+
+// Taken and modified from https://stackoverflow.com/a/60218754
+
+const useOnElementResize = targetRef => {
+  var _targetRef$current, _targetRef$current2;
+
+  const [width, setWidth] = useState(targetRef.current ? (_targetRef$current = targetRef.current) === null || _targetRef$current === void 0 ? void 0 : _targetRef$current.offsetWidth : 0);
+  const [height, setHeight] = useState(targetRef.current ? (_targetRef$current2 = targetRef.current) === null || _targetRef$current2 === void 0 ? void 0 : _targetRef$current2.offsetWidth : 0);
+  const observer = useRef(null);
+  useEffect(() => {
+    function outputsize() {
+      if (targetRef.current) {
+        setWidth(targetRef.current.offsetWidth);
+        setHeight(targetRef.current.offsetHeight);
+      }
+    }
+
+    observer.current = new ResizeObserver(outputsize).observe(targetRef.current);
+    return () => {
+      var _observer$current;
+
+      (_observer$current = observer.current) === null || _observer$current === void 0 ? void 0 : _observer$current.disconnect();
+    };
+  }, [targetRef]);
+  return useMemo(() => ({
+    width,
+    height
+  }), [width, height]);
+};
+
+export { useOnElementResize };

package/esm/controlled-autocomplete/utils/listHelper.js

@@ -0,0 +1,34 @@
+import 'core-js/modules/esnext.async-iterator.filter.js';
+import 'core-js/modules/esnext.iterator.constructor.js';
+import 'core-js/modules/esnext.iterator.filter.js';
+import 'core-js/modules/esnext.async-iterator.some.js';
+import 'core-js/modules/esnext.iterator.some.js';
+
+const getSelectableOptions = options => options ? options.filter(option => option.type === 'option' && !option.disabled) : [];
+const getOptions = options => options ? options.filter(option => option.type === 'option') : [];
+const isSelectedValueEmpty = value => Array.isArray(value) ? value.length === 0 : !value;
+const isSelectedValueMultiple = value => Array.isArray(value);
+const isSelected = (value, activeOption) => {
+  if (isSelectedValueMultiple(value)) {
+    const multiValue = value;
+    return multiValue.some(item => (item === null || item === void 0 ? void 0 : item.value) === (activeOption === null || activeOption === void 0 ? void 0 : activeOption.value));
+  }
+
+  if (typeof value === 'string') {
+    return false;
+  }
+
+  const singleValue = value;
+  return (singleValue === null || singleValue === void 0 ? void 0 : singleValue.value) === activeOption.value;
+};
+const findInCircularList = function (list, from, criteria) {
+  let step = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 1;
+
+  for (let i = (from + step + list.length) % list.length; i !== from; i = (i + step + list.length) % list.length) {
+    if (criteria(list[i])) return i;
+  }
+
+  return from; // return same item
+};
+
+export { findInCircularList, getOptions, getSelectableOptions, isSelected, isSelectedValueEmpty, isSelectedValueMultiple };

package/esm/controlled-checkbox/ControlledCheckbox.js

@@ -21,10 +21,13 @@ const DSControlledCheckbox = props => {
     label,
     hasError,
     onChange,
+    onFocus,
+    onBlur,
     value,
     readOnly,
     name,
-    innerRef
+    innerRef,
+    tabIndex
   } = props;
   const handleOnKeyDown = useCallback(e => {
     if (checkboxRef.current && e.key === 'Enter') {
@@ -50,12 +53,15 @@ const DSControlledCheckbox = props => {
     "aria-invalid": hasError,
     "aria-readonly": readOnly,
     "aria-label": ariaLabel || label,
+    onFocus: onFocus,
+    onBlur: onBlur,
     name: name,
     value: value,
     onChange: onChange,
     id: id,
     "data-testid": "ds-checkbox",
-    autoFocus: autoFocus
+    autoFocus: autoFocus,
+    tabIndex: tabIndex || 0
   })), label && /*#__PURE__*/_jsx(StyledLabel, {
     htmlFor: id,
     disabled: disabled,

package/esm/controlled-combobox/ComboBox.js

@@ -0,0 +1,24 @@
+import _jsx from '@babel/runtime/helpers/esm/jsx';
+import 'react';
+import { describe } from 'react-desc';
+import { useMemoMergePropsWithDefault, useValidateTypescriptPropTypes } from '@elliemae/ds-props-helpers';
+import { useComboBox } from './config/useComboBox.js';
+import { Container } from './parts/container/Container.js';
+import { propTypes } from './propTypes.js';
+import { defaultProps, ComboBoxContext } from './ComboBoxCTX.js';
+
+var _Container;
+
+const DSComboBox = props => {
+  const propsWithDefault = useMemoMergePropsWithDefault(props, defaultProps);
+  useValidateTypescriptPropTypes(propsWithDefault, propTypes);
+  const ctx = useComboBox(props);
+  return /*#__PURE__*/_jsx(ComboBoxContext.Provider, {
+    value: ctx
+  }, void 0, _Container || (_Container = /*#__PURE__*/_jsx(Container, {})));
+};
+
+const DSComboBoxWithSchema = describe(DSComboBox);
+DSComboBoxWithSchema.propTypes = propTypes;
+
+export { DSComboBox, DSComboBoxWithSchema };