@elliemae/ds-controlled-form 2.1.0-rc.6 → 2.1.0

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 };

package/esm/controlled-combobox/ComboBoxCTX.js

@@ -0,0 +1,49 @@
+import { createContext, createRef } from 'react';
+import { noop } from 'lodash';
+
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+const defaultProps = {
+  placeholder: '',
+  options: [],
+  selectedValues: null,
+  hasError: false,
+  inline: false,
+  autoFocus: false,
+  startPlacementPreference: 'bottom-start',
+  placementOrderPreference: ['bottom-start', 'bottom-end'],
+  onClearAll: noop,
+  onSelectAll: noop,
+  onCreate: noop,
+  withToggle: false,
+  onChange: noop,
+  onKeyDown: noop,
+  onFilter: noop,
+  onMenuOpen: noop
+};
+const defaultContext = {
+  props: defaultProps,
+  showPopover: false,
+  setShowPopover: noop,
+  scrollOptionIntoView: noop,
+  referenceElement: null,
+  hasFocus: false,
+  setHasFocus: noop,
+  pillGroupRef: /*#__PURE__*/createRef(),
+  setReferenceElement: noop,
+  inputRef: /*#__PURE__*/createRef(),
+  listRef: /*#__PURE__*/createRef(),
+  wrapperListRef: /*#__PURE__*/createRef(),
+  controlsWrapperRef: /*#__PURE__*/createRef(),
+  selectedOptionsRef: /*#__PURE__*/createRef(),
+  showSelectedValue: false,
+  setShowSelectedValue: noop,
+  focusOptionIdx: '',
+  setCurrentOption: noop,
+  showSelectedOptions: false,
+  setShowSelectedOptions: noop
+};
+/** Context for cross component communication */
+
+const ComboBoxContext = /*#__PURE__*/createContext(defaultContext);
+
+export { ComboBoxContext, ComboBoxContext as default, defaultProps };

package/esm/controlled-combobox/ComboboxDataTestids.js

@@ -0,0 +1,13 @@
+const ComboboxDataTestid = {
+  INPUT: 'combobox-input',
+  LIST: 'combobox-menu-list',
+  SELECTED_VALUES: 'combobox-selected-values',
+  SELECT_ALL_BUTTON: 'combobox-all-btn',
+  CLEAR_ALL_BUTTON: 'combobox-clear-btn',
+  DROPDOWN: 'combobox-dropdown-btn',
+  OPTION: 'combobox-option',
+  SELECT_ALL_CHECKBOX: 'combobox-select-all-checkbox',
+  SHOW_SELECTED_OPTIONS_TOGGLE: 'combobox-selected-options-toggle'
+};
+
+export { ComboboxDataTestid };

package/esm/controlled-combobox/config/constants.js

@@ -0,0 +1,10 @@
+const DATA_TESTID = {
+  COMBOBOX_MENU_LIST: 'combobox-menu-list',
+  COMBOBOX_CLEAR_BTN: 'combobox-clear-btn',
+  COMBOBOX_ALL_BTN: 'combobox-all-btn',
+  COMBOBOX_DROPDOWN_BTN: 'combobox-dropdown-btn',
+  COMBOBOX_OPTION: 'combobox-option',
+  COMBOBOX: 'combobox'
+};
+
+export { DATA_TESTID };

package/esm/controlled-combobox/config/useComboBox.js

@@ -0,0 +1,135 @@
+import _defineProperty from '@babel/runtime/helpers/esm/defineProperty';
+import 'core-js/modules/web.dom-collections.iterator.js';
+import 'core-js/modules/esnext.async-iterator.for-each.js';
+import 'core-js/modules/esnext.iterator.constructor.js';
+import 'core-js/modules/esnext.iterator.for-each.js';
+import 'core-js/modules/esnext.async-iterator.find.js';
+import 'core-js/modules/esnext.iterator.find.js';
+import 'core-js/modules/esnext.async-iterator.filter.js';
+import 'core-js/modules/esnext.iterator.filter.js';
+import { useState, useRef, useCallback, useMemo } from 'react';
+import { noop } from 'lodash';
+import { v4 } from 'uuid';
+import { useVirtual } from 'react-virtual';
+import { useGetComboBoxWithDefaultsProps } from './useGetPropsWithDefault.js';
+
+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 useComboBox = props => {
+  const [showPopover, setShowPopover] = useState(false);
+  const [referenceElement, setReferenceElement] = useState(null);
+  const [showSelectedValue, setShowSelectedValue] = useState(false);
+  const [showSelectedOptions, setShowSelectedOptions] = useState(false);
+  const [hasFocus, setHasFocus] = useState(false);
+  const [focusOptionIdx, setCurrentOption] = useState('');
+  const inputRef = useRef(null);
+  const listRef = useRef(null);
+  const wrapperListRef = useRef(null);
+  const selectedOptionsRef = useRef(null);
+  const controlsWrapperRef = useRef(null);
+  const pillGroupRef = useRef(null);
+  const propsWithDefaults = useGetComboBoxWithDefaultsProps(props);
+  const {
+    options,
+    selectedValues,
+    onCreate
+  } = propsWithDefaults; // ---------------------------------------------------------------------------
+  // Menu Options with/out selected filter
+  // ---------------------------------------------------------------------------
+
+  const selectedValuesWithSections = useCallback(() => {
+    var _items2;
+
+    const multiSelectedValue = selectedValues;
+    const items = [];
+    options.forEach(option => {
+      const isSelectedValue = multiSelectedValue.find(item => item.dsId === option.dsId);
+
+      if (isSelectedValue) {
+        items.push(option);
+      }
+
+      if (option.type === 'section') {
+        var _items;
+
+        if (((_items = items[items.length - 1]) === null || _items === void 0 ? void 0 : _items.type) === 'section') {
+          items[items.length - 1] = option;
+        } else {
+          items.push(option);
+        }
+      }
+    });
+
+    if (((_items2 = items[items.length - 1]) === null || _items2 === void 0 ? void 0 : _items2.type) === 'section') {
+      items.pop();
+    }
+
+    return items;
+  }, [options, selectedValues]);
+  const correctOptions = useMemo(() => {
+    if (showSelectedOptions && Array.isArray(selectedValues) && selectedValues.length > 0) {
+      return selectedValuesWithSections();
+    }
+
+    if (onCreate !== noop && inputRef.current && inputRef.current.value !== '') {
+      var _inputRef$current;
+
+      const creatableUuid = v4();
+      const creatableItem = {
+        dsId: "creatable-".concat(creatableUuid),
+        label: (_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 ? void 0 : _inputRef$current.value,
+        type: 'creatable'
+      };
+      return [creatableItem, ...options];
+    }
+
+    return options;
+  }, [options, onCreate, selectedValuesWithSections, selectedValues, showSelectedOptions]); // ===========================================================================
+  // Virtualization setup
+  // ===========================================================================
+
+  const virtualListHelpers = useVirtual({
+    size: correctOptions.length,
+    parentRef: listRef,
+    overscan: 15,
+    paddingStart: 0
+  }); // ===========================================================================
+  // Scroll into view function
+  // ===========================================================================
+
+  const scrollOptionIntoView = useCallback(function (dsId) {
+    let opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+      align: 'center'
+    };
+    virtualListHelpers.scrollToIndex(correctOptions.findIndex(opt => opt.dsId === dsId), opts);
+  }, [correctOptions, virtualListHelpers]);
+  const ctx = useMemo(() => ({
+    props: _objectSpread(_objectSpread({}, propsWithDefaults), {}, {
+      options: correctOptions
+    }),
+    virtualListHelpers,
+    showPopover,
+    referenceElement,
+    inputRef,
+    showSelectedValue,
+    listRef,
+    focusOptionIdx,
+    selectedOptionsRef,
+    controlsWrapperRef,
+    hasFocus,
+    pillGroupRef,
+    showSelectedOptions,
+    wrapperListRef,
+    setShowSelectedOptions,
+    setHasFocus,
+    setCurrentOption,
+    scrollOptionIntoView,
+    setShowSelectedValue,
+    setReferenceElement,
+    setShowPopover
+  }), [scrollOptionIntoView, correctOptions, propsWithDefaults, virtualListHelpers, focusOptionIdx, showSelectedValue, wrapperListRef, showSelectedOptions, showPopover, pillGroupRef, referenceElement, inputRef, selectedOptionsRef, controlsWrapperRef, hasFocus, listRef]);
+  return ctx;
+};
+
+export { useComboBox };

package/esm/controlled-combobox/config/useGetPropsWithDefault.js

@@ -0,0 +1,7 @@
+import { useMemoMergePropsWithDefault } from '@elliemae/ds-props-helpers';
+import { defaultProps } from '../ComboBoxCTX.js';
+
+// we have to merge the "default" nested default values with what the user gives us...
+const useGetComboBoxWithDefaultsProps = props => useMemoMergePropsWithDefault(props, defaultProps);
+
+export { useGetComboBoxWithDefaultsProps };

package/esm/controlled-combobox/index.d.js

@@ -0,0 +1 @@
+

package/esm/controlled-combobox/index.js

@@ -0,0 +1 @@
+export { DSComboBox, DSComboBoxWithSchema } from './ComboBox.js';

package/esm/controlled-combobox/parts/a11y-messages/MultiAllyMessages.js

@@ -0,0 +1,25 @@
+import _jsx from '@babel/runtime/helpers/esm/jsx';
+import 'core-js/modules/esnext.async-iterator.map.js';
+import 'core-js/modules/esnext.iterator.map.js';
+import { useContext } from 'react';
+import { ComboBoxContext } from '../../ComboBoxCTX.js';
+import { getSelectableOptions } from '../../utils/listHelper.js';
+import { StyledA11ySelectedValues } from './styled.js';
+
+const MultiAllyMessages = () => {
+  const {
+    props: {
+      options,
+      selectedValues
+    }
+  } = useContext(ComboBoxContext);
+  const selectableOptions = getSelectableOptions(options);
+  const multipleSelectedValues = selectedValues;
+  return /*#__PURE__*/_jsx(StyledA11ySelectedValues, {
+    "aria-live": "polite",
+    "aria-atomic": "false",
+    "aria-relevant": "additions text"
+  }, void 0, "Options selected: ".concat(multipleSelectedValues.map(item => item.label).join(', '), ". ").concat(multipleSelectedValues.length, " of ").concat(selectableOptions.length));
+};
+
+export { MultiAllyMessages };

package/esm/controlled-combobox/parts/a11y-messages/SingleAllyMessages.js

@@ -0,0 +1,20 @@
+import _jsx from '@babel/runtime/helpers/esm/jsx';
+import { useContext } from 'react';
+import { ComboBoxContext } from '../../ComboBoxCTX.js';
+import { StyledA11ySelectedValues } from './styled.js';
+
+const SingleAllyMessages = () => {
+  const {
+    props: {
+      selectedValues
+    }
+  } = useContext(ComboBoxContext);
+  const singleSelectedValue = selectedValues;
+  return /*#__PURE__*/_jsx(StyledA11ySelectedValues, {
+    "aria-live": "polite",
+    "aria-atomic": "false",
+    "aria-relevant": "additions text"
+  }, void 0, "Option selected: ".concat(singleSelectedValue.label, "."));
+};
+
+export { SingleAllyMessages };

package/esm/controlled-combobox/parts/a11y-messages/index.js

@@ -0,0 +1,2 @@
+export { MultiAllyMessages } from './MultiAllyMessages.js';
+export { SingleAllyMessages } from './SingleAllyMessages.js';