@carbon/react 1.67.1 → 1.68.0

package/es/components/ComboBox/ComboBox.d.ts

@@ -158,6 +158,7 @@ export interface ComboBoxProps<ItemType> extends Omit<InputHTMLAttributes<HTMLIn
      * Specify your own filtering logic by passing in a `shouldFilterItem`
      * function that takes in the current input and an item and passes back
      * whether or not the item should be filtered.
+     * this prop will be ignored if `typeahead` prop is enabled
      */
     shouldFilterItem?: (input: {
         item: ItemType;
@@ -177,6 +178,10 @@ export interface ComboBoxProps<ItemType> extends Omit<InputHTMLAttributes<HTMLIn
      * combobox via ARIA attributes.
      */
     titleText?: ReactNode;
+    /**
+     * **Experimental**: will enable autcomplete and typeahead for the input field
+     */
+    typeahead?: boolean;
     /**
      * Specify whether the control is currently in warning state
      */

package/es/components/ComboBox/ComboBox.js

@@ -9,7 +9,7 @@ import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js
 import cx from 'classnames';
 import { useCombobox } from 'downshift';
 import PropTypes from 'prop-types';
-import React__default, { forwardRef, useEffect, useContext, useRef, useState, useMemo } from 'react';
+import React__default, { forwardRef, useState, useRef, useEffect, useContext, useCallback, useMemo } from 'react';
 import '../Text/index.js';
 import { WarningFilled, WarningAltFilled, Checkmark } from '@carbon/icons-react';
 import ListBox from '../ListBox/index.js';
@@ -36,8 +36,7 @@ const {
   ItemMouseMove,
   InputKeyDownArrowUp,
   InputKeyDownArrowDown,
-  MenuMouseLeave,
-  FunctionSelectItem
+  MenuMouseLeave
 } = useCombobox.stateChangeTypes;
 const defaultItemToString = item => {
   if (typeof item === 'string') {
@@ -52,26 +51,42 @@ const defaultItemToString = item => {
   return '';
 };
 const defaultShouldFilterItem = () => true;
-const getInputValue = _ref => {
+const autocompleteCustomFilter = _ref => {
+  let {
+    item,
+    inputValue
+  } = _ref;
+  if (inputValue === null || inputValue === '') {
+    return true; // Show all items if there's no input
+  }
+  const lowercaseItem = item.toLowerCase();
+  const lowercaseInput = inputValue.toLowerCase();
+  return lowercaseItem.startsWith(lowercaseInput);
+};
+const getInputValue = _ref2 => {
   let {
     initialSelectedItem,
     inputValue,
     itemToString,
-    selectedItem
-  } = _ref;
+    selectedItem,
+    prevSelectedItem
+  } = _ref2;
   if (selectedItem) {
     return itemToString(selectedItem);
   }
   if (initialSelectedItem) {
     return itemToString(initialSelectedItem);
   }
+  if (!selectedItem && prevSelectedItem) {
+    return '';
+  }
   return inputValue || '';
 };
-const findHighlightedIndex = (_ref2, inputValue) => {
+const findHighlightedIndex = (_ref3, inputValue) => {
   let {
     items,
     itemToString = defaultItemToString
-  } = _ref2;
+  } = _ref3;
   if (!inputValue) {
     return -1;
   }
@@ -94,6 +109,9 @@ const findHighlightedIndex = (_ref2, inputValue) => {
  */
 
 const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
+  const [cursorPosition, setCursorPosition] = useState(0);
+  const prevInputLengthRef = useRef(0);
+  const inputRef = useRef(null);
   const {
     ['aria-label']: ariaLabel = 'Choose an item',
     ariaLabel: deprecatedAriaLabel,
@@ -122,6 +140,7 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     size,
     titleText,
     translateWithId,
+    typeahead = false,
     warn,
     warnText,
     allowCustomValue = false,
@@ -155,33 +174,68 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
       }
     }
   }, [autoAlign, floatingStyles, refs.floating, parentWidth]);
-  const prefix = usePrefix();
-  const {
-    isFluid
-  } = useContext(FormContext);
-  const textInput = useRef(null);
-  const comboBoxInstanceId = useId();
   const [inputValue, setInputValue] = useState(getInputValue({
     initialSelectedItem,
     inputValue: '',
     itemToString,
     selectedItem: selectedItemProp
   }));
+  const [typeaheadText, setTypeaheadText] = useState('');
+  useEffect(() => {
+    if (typeahead) {
+      if (inputValue.length >= prevInputLengthRef.current) {
+        if (inputValue) {
+          const filteredItems = items.filter(item => autocompleteCustomFilter({
+            item: itemToString(item),
+            inputValue: inputValue
+          }));
+          if (filteredItems.length > 0) {
+            const suggestion = itemToString(filteredItems[0]);
+            setTypeaheadText(suggestion.slice(inputValue.length));
+          } else {
+            setTypeaheadText('');
+          }
+        } else {
+          setTypeaheadText('');
+        }
+      } else {
+        setTypeaheadText('');
+      }
+      prevInputLengthRef.current = inputValue.length;
+    }
+  }, [typeahead, inputValue, items, itemToString, autocompleteCustomFilter]);
+  const prefix = usePrefix();
+  const {
+    isFluid
+  } = useContext(FormContext);
+  const textInput = useRef(null);
+  const comboBoxInstanceId = useId();
   const [isFocused, setIsFocused] = useState(false);
-  const [prevSelectedItem, setPrevSelectedItem] = useState();
-  const [doneInitialSelectedItem, setDoneInitialSelectedItem] = useState(false);
   const savedOnInputChange = useRef(onInputChange);
-  if (!doneInitialSelectedItem || prevSelectedItem !== selectedItemProp) {
-    setDoneInitialSelectedItem(true);
-    setPrevSelectedItem(selectedItemProp);
-    setInputValue(getInputValue({
-      initialSelectedItem,
-      inputValue,
-      itemToString,
-      selectedItem: selectedItemProp
-    }));
-  }
-  const filterItems = (items, itemToString, inputValue) => items.filter(item => shouldFilterItem ? shouldFilterItem({
+  const prevSelectedItemProp = useRef(selectedItemProp);
+
+  // fully controlled combobox: handle changes to selectedItemProp
+  useEffect(() => {
+    if (prevSelectedItemProp.current !== selectedItemProp) {
+      const currentInputValue = getInputValue({
+        initialSelectedItem,
+        inputValue,
+        itemToString,
+        selectedItem: selectedItemProp,
+        prevSelectedItem: prevSelectedItemProp.current
+      });
+      setInputValue(currentInputValue);
+      onChange({
+        selectedItem: selectedItemProp,
+        inputValue: currentInputValue
+      });
+      prevSelectedItemProp.current = selectedItemProp;
+    }
+  }, [selectedItemProp]);
+  const filterItems = (items, itemToString, inputValue) => items.filter(item => typeahead ? autocompleteCustomFilter({
+    item: itemToString(item),
+    inputValue
+  }) : shouldFilterItem ? shouldFilterItem({
     item,
     itemToString,
     inputValue
@@ -204,7 +258,7 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     ...props,
     items: filteredItems(inputValue)
   }, inputValue);
-  const stateReducer = React__default.useCallback((state, actionAndChanges) => {
+  const stateReducer = useCallback((state, actionAndChanges) => {
     const {
       type,
       changes
@@ -240,14 +294,6 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
           }
           return changes;
         }
-      case FunctionSelectItem:
-        if (onChange) {
-          onChange({
-            selectedItem: changes.selectedItem,
-            inputValue: changes.inputValue
-          });
-        }
-        return changes;
       case InputKeyDownEnter:
         if (allowCustomValue) {
           setInputValue(inputValue);
@@ -304,6 +350,12 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     if (onToggleClick) {
       onToggleClick(event);
     }
+    if (readOnly) {
+      // Prevent the list from opening if readOnly is true
+      event.preventDownshiftDefault = true;
+      event?.persist?.();
+      return;
+    }
     if (event.target === textInput.current && isOpen) {
       event.preventDownshiftDefault = true;
       event?.persist?.();
@@ -371,25 +423,34 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     itemToString: item => {
       return itemToString(item);
     },
-    onInputValueChange(_ref3) {
+    onInputValueChange(_ref4) {
       let {
         inputValue
-      } = _ref3;
-      setInputValue(inputValue || '');
-      setHighlightedIndex(indexToHighlight(inputValue));
+      } = _ref4;
+      const normalizedInput = inputValue || '';
+      setInputValue(normalizedInput);
+      if (selectedItemProp && !inputValue) {
+        // ensure onChange is called when selectedItem is cleared
+        onChange({
+          selectedItem,
+          inputValue: normalizedInput
+        });
+      }
+      setHighlightedIndex(indexToHighlight(normalizedInput));
+      setCursorPosition(inputValue === null ? 0 : normalizedInput.length);
     },
-    onSelectedItemChange(_ref4) {
+    onSelectedItemChange(_ref5) {
       let {
         selectedItem
-      } = _ref4;
+      } = _ref5;
       onChange({
         selectedItem
       });
     },
-    onHighlightedIndexChange: _ref5 => {
+    onHighlightedIndexChange: _ref6 => {
       let {
         highlightedIndex
-      } = _ref5;
+      } = _ref6;
       if (highlightedIndex > -1 && typeof window !== undefined) {
         const itemArray = document.querySelectorAll(`li.${prefix}--list-box__menu-item[role="option"]`);
         const highlightedItem = itemArray[highlightedIndex];
@@ -425,6 +486,11 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
       };
     }
   }, [closeMenu, openMenu, reset, selectItem, setHighlightedIndex, downshiftSetInputValue, toggleMenu]);
+  useEffect(() => {
+    if (inputRef.current) {
+      inputRef.current.setSelectionRange(cursorPosition, cursorPosition);
+    }
+  }, [inputValue, cursorPosition]);
   const buttonProps = getToggleButtonProps({
     disabled: disabled || readOnly,
     onClick: handleToggleClick(isOpen),
@@ -452,6 +518,12 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
       if (evt.key !== 'Tab') {
         evt.preventDefault();
       }
+    },
+    onClick: evt => {
+      // Prevent the default behavior which would open the list
+      evt.preventDefault();
+      // Focus on the element as per readonly input behavior
+      evt.currentTarget.focus();
     }
   } : {};
 
@@ -465,6 +537,16 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     'aria-label': deprecatedAriaLabel || ariaLabel,
     ref: autoAlign ? refs.setFloating : null
   }), [autoAlign, deprecatedAriaLabel, ariaLabel, getMenuProps, refs.setFloating]);
+  useEffect(() => {
+    if (textInput.current) {
+      if (inputRef.current && typeaheadText) {
+        const selectionStart = inputValue.length;
+        const selectionEnd = selectionStart + typeaheadText.length;
+        inputRef.current.value = inputValue + typeaheadText;
+        inputRef.current.setSelectionRange(selectionStart, selectionEnd);
+      }
+    }
+  }, [inputValue, typeaheadText]);
   return /*#__PURE__*/React__default.createElement("div", {
     className: wrapperClasses
   }, titleText && /*#__PURE__*/React__default.createElement(Text, _extends({
@@ -497,7 +579,12 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
   }, getInputProps({
     'aria-controls': isOpen ? undefined : menuProps.id,
     placeholder,
-    ref: mergeRefs(textInput, ref),
+    value: inputValue,
+    onChange: e => {
+      const newValue = e.target.value;
+      downshiftSetInputValue(newValue);
+    },
+    ref: mergeRefs(textInput, ref, inputRef),
     onKeyDown: event => {
       if (match(event, Space)) {
         event.stopPropagation();
@@ -545,6 +632,16 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
           toggleMenu();
         }
       }
+      if (typeahead && event.key === 'Tab') {
+        //  event.preventDefault();
+        const matchingItem = items.find(item => itemToString(item).toLowerCase().startsWith(inputValue.toLowerCase()));
+        if (matchingItem) {
+          const newValue = itemToString(matchingItem);
+          downshiftSetInputValue(newValue);
+          setCursorPosition(newValue.length);
+          selectItem(matchingItem);
+        }
+      }
     }
   }), rest, readOnlyEventHandlers, {
     readOnly: readOnly,
@@ -737,6 +834,7 @@ ComboBox.propTypes = {
    * Specify your own filtering logic by passing in a `shouldFilterItem`
    * function that takes in the current input and an item and passes back
    * whether or not the item should be filtered.
+   * this prop will be ignored if `typeahead` prop is enabled
    */
   shouldFilterItem: PropTypes.func,
   /**
@@ -757,6 +855,10 @@ ComboBox.propTypes = {
    * and returns the localized string for the message
    */
   translateWithId: PropTypes.func,
+  /**
+   * **Experimental**: will enable autcomplete and typeahead for the input field
+   */
+  typeahead: PropTypes.bool,
   /**
    * Specify whether the control is currently in warning state
    */

package/es/components/ComposedModal/ModalHeader.js

@@ -44,7 +44,7 @@ const ModalHeader = /*#__PURE__*/React__default.forwardRef(function ModalHeader(
     ref: ref
   }), label && /*#__PURE__*/React__default.createElement("h2", {
     className: labelClass
-  }, label), title && /*#__PURE__*/React__default.createElement("h3", {
+  }, label), title && /*#__PURE__*/React__default.createElement("h2", {
     className: titleClass
   }, title), children, /*#__PURE__*/React__default.createElement("div", {
     className: `${prefix}--modal-close-button`

package/es/components/DatePicker/DatePicker.js

@@ -22,7 +22,7 @@ import '../FluidForm/FluidForm.js';
 import { FormContext } from '../FluidForm/FormContext.js';
 import { WarningFilled, WarningAltFilled } from '@carbon/icons-react';
 import { match } from '../../internal/keyboard/match.js';
-import { Escape, ArrowDown, Tab } from '../../internal/keyboard/keys.js';
+import { Escape, ArrowDown, Enter, Tab } from '../../internal/keyboard/keys.js';
 
 // Weekdays shorthand for english locale
 l10n.en.weekdays.shorthand.forEach((_day, index) => {
@@ -391,9 +391,6 @@ const DatePicker = /*#__PURE__*/React__default.forwardRef(function DatePicker(_r
       }
     }
     function handleOnChange(event) {
-      if (datePickerType == 'single' && closeOnSelect) {
-        calendar.calendarContainer.classList.remove('open');
-      }
       const {
         target
       } = event;
@@ -409,12 +406,16 @@ const DatePicker = /*#__PURE__*/React__default.forwardRef(function DatePicker(_r
       if (calendar.selectedDates.length === 0) {
         return;
       }
-      calendar.clear();
-      calendar.input.focus();
+    }
+    function handleKeyPress(event) {
+      if (match(event, Enter) && closeOnSelect && datePickerType == 'single') {
+        calendar.calendarContainer.classList.remove('open');
+      }
     }
     if (start) {
       start.addEventListener('keydown', handleArrowDown);
       start.addEventListener('change', handleOnChange);
+      start.addEventListener('keypress', handleKeyPress);
       if (calendar && calendar.calendarContainer) {
         // Flatpickr's calendar dialog is not rendered in a landmark causing an
         // error with IBM Equal Access Accessibility Checker so we add an aria
@@ -427,6 +428,7 @@ const DatePicker = /*#__PURE__*/React__default.forwardRef(function DatePicker(_r
     if (end) {
       end.addEventListener('keydown', handleArrowDown);
       end.addEventListener('change', handleOnChange);
+      end.addEventListener('keypress', handleKeyPress);
     }
 
     //component did unmount equivalent
@@ -450,10 +452,12 @@ const DatePicker = /*#__PURE__*/React__default.forwardRef(function DatePicker(_r
       if (start) {
         start.removeEventListener('keydown', handleArrowDown);
         start.removeEventListener('change', handleOnChange);
+        start.removeEventListener('keypress', handleKeyPress);
       }
       if (end) {
         end.removeEventListener('keydown', handleArrowDown);
         end.removeEventListener('change', handleOnChange);
+        end.removeEventListener('change', handleKeyPress);
       }
     };
     // eslint-disable-next-line react-hooks/exhaustive-deps

package/es/components/Dropdown/Dropdown.js

@@ -207,7 +207,9 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
 
   // needs to be Capitalized for react to render it correctly
   const ItemToElement = itemToElement;
-  const toggleButtonProps = getToggleButtonProps();
+  const toggleButtonProps = getToggleButtonProps({
+    'aria-label': ariaLabel || deprecatedAriaLabel
+  });
   const helper = helperText && !isFluid ? /*#__PURE__*/React__default.createElement("div", {
     id: helperId,
     className: helperClasses
@@ -282,7 +284,6 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
   }, getLabelProps()), titleText), /*#__PURE__*/React__default.createElement(ListBox, {
     onFocus: handleFocus,
     onBlur: handleFocus,
-    "aria-label": deprecatedAriaLabel || ariaLabel,
     size: size$1,
     className: className,
     invalid: invalid,

package/es/components/FeatureFlags/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright IBM Corp. 2015, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import PropTypes from 'prop-types';
+import React, { ReactNode } from 'react';
+interface FeatureFlagsProps {
+    children?: ReactNode;
+    flags?: Record<string, boolean>;
+    enableV12TileDefaultIcons?: boolean;
+    enableV12TileRadioIcons?: boolean;
+    enableV12Overflowmenu?: boolean;
+    enableTreeviewControllable?: boolean;
+    enableExperimentalFocusWrapWithoutSentinels?: boolean;
+}
+/**
+ * Our FeatureFlagContext is used alongside the FeatureFlags component to enable
+ * or disable feature flags in a given React tree
+ */
+declare const FeatureFlagContext: React.Context<any>;
+/**
+ * Supports an object of feature flag values with the `flags` prop, merging them
+ * along with the current `FeatureFlagContext` to provide consumers to check if
+ * a feature flag is enabled or disabled in a given React tree
+ */
+declare function FeatureFlags({ children, flags, enableV12TileDefaultIcons, enableV12TileRadioIcons, enableV12Overflowmenu, enableTreeviewControllable, enableExperimentalFocusWrapWithoutSentinels, }: FeatureFlagsProps): JSX.Element;
+declare namespace FeatureFlags {
+    var propTypes: {
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide the feature flags to enabled or disabled in the current Rea,ct tree
+         */
+        flags: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
+        enableV12TileDefaultIcons: PropTypes.Requireable<boolean>;
+        enableV12TileRadioIcons: PropTypes.Requireable<boolean>;
+        enableV12Overflowmenu: PropTypes.Requireable<boolean>;
+        enableTreeviewControllable: PropTypes.Requireable<boolean>;
+        enableExperimentalFocusWrapWithoutSentinels: PropTypes.Requireable<boolean>;
+    };
+}
+/**
+ * Access whether a given flag is enabled or disabled in a given
+ * FeatureFlagContext
+ *
+ * @returns {boolean}
+ */
+declare function useFeatureFlag(flag: any): any;
+/**
+ * Access all feature flag information for the given FeatureFlagContext
+ *
+ * @returns {FeatureFlagScope}
+ */
+declare function useFeatureFlags(): any;
+export { FeatureFlags, FeatureFlagContext, useFeatureFlags, useFeatureFlag };

package/es/components/FeatureFlags/index.js

@@ -5,9 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { FeatureFlags as FeatureFlags$1, createScope } from '@carbon/feature-flags';
+import { createScope, FeatureFlags as FeatureFlags$1 } from '@carbon/feature-flags';
 import PropTypes from 'prop-types';
-import React__default, { createContext, useContext, useState, useRef, useEffect } from 'react';
+import React__default, { useContext, useState, useRef, useEffect, createContext } from 'react';
 import deprecate from '../../prop-types/deprecate.js';
 
 /**

package/es/components/FileUploader/FileUploaderDropContainer.js

@@ -143,7 +143,7 @@ function FileUploaderDropContainer(_ref) {
     multiple: multiple,
     onChange: handleChange,
     onClick: evt => {
-      evt.target.value = null;
+      evt.target.value = '';
     }
   }));
 }

package/es/components/FluidComboBox/FluidComboBox.Skeleton.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+export interface FluidComboBoxSkeletonProps {
+    /**
+     * Specify an optional className to add.
+     */
+    className?: string;
+}
+declare const FluidComboBoxSkeleton: React.FC<FluidComboBoxSkeletonProps>;
+export default FluidComboBoxSkeleton;

package/es/components/FluidComboBox/FluidComboBox.Skeleton.js

@@ -34,6 +34,5 @@ FluidComboBoxSkeleton.propTypes = {
    */
   className: PropTypes.string
 };
-var FluidComboBoxSkeleton$1 = FluidComboBoxSkeleton;
 
-export { FluidComboBoxSkeleton$1 as default };
+export { FluidComboBoxSkeleton as default };

package/es/components/FluidComboBox/FluidComboBox.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Copyright IBM Corp. 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React, { ComponentType } from 'react';
+import { ComboBoxProps } from '../ComboBox/ComboBox';
+type ItemToStringHandler<ItemType> = (item: ItemType | null) => string;
+interface OnChangeData<ItemType> {
+    selectedItem: ItemType | null | undefined;
+    inputValue?: string | null;
+}
+export interface FluidComboBoxProps<ItemType> extends ComboBoxProps<ItemType> {
+    /**
+     * Specify an optional className to be applied to the outer FluidForm wrapper
+     */
+    className?: string;
+    /**
+     * Specify the direction of the dropdown. Can be either top or bottom.
+     */
+    direction?: 'top' | 'bottom';
+    /**
+     * Specify whether the `<input>` should be disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify a custom `id` for the `<input>`
+     */
+    id: string;
+    /**
+     * Allow users to pass in an arbitrary item or a string (in case their items are an array of strings)
+     * from their collection that are pre-selected
+     */
+    initialSelectedItem?: ItemType;
+    /**
+     * Specify if the currently selected value is invalid.
+     */
+    invalid?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in an invalid state
+     */
+    invalidText?: React.ReactNode;
+    /**
+     * Specify if the `FluidComboBox` should render its menu items in condensed mode
+     */
+    isCondensed?: boolean;
+    /**
+     * Function to render items as custom components instead of strings.
+     * Defaults to null and is overridden by a getter
+     */
+    itemToElement?: ComponentType<ItemType> | null;
+    /**
+     * Helper function passed to downshift that allows the library to render a
+     * given item to a string label. By default, it extracts the `label` field
+     * from a given item to serve as the item label in the list.
+     */
+    itemToString?: ItemToStringHandler<ItemType>;
+    /**
+     * We try to stay as generic as possible here to allow individuals to pass
+     * in a collection of whatever kind of data structure they prefer
+     */
+    items: ItemType[];
+    /**
+     * Generic `label` that will be used as the textual representation of what
+     * this field is for
+     */
+    label: React.ReactNode;
+    /**
+     * `onChange` is a utility for this controlled component to communicate to a
+     * consuming component what kind of internal state changes are occurring.
+     */
+    onChange: (data: OnChangeData<ItemType>) => void;
+    /**
+     * An optional callback to render the currently selected item as a react element instead of only
+     * as a string.
+     */
+    renderSelectedItem?: (selectedItem: ItemType) => React.ReactNode;
+    /**
+     * In the case you want to control the dropdown selection entirely.
+     * */
+    selectedItem?: ItemType | null;
+    /**
+     * Provide the title text that will be read by a screen reader when
+     * visiting this control
+     */
+    titleText?: React.ReactNode;
+    /**
+     * Callback function for translating ListBoxMenuIcon SVG title
+     */
+    translateWithId?: (id: string) => string;
+    /**
+     * Specify whether the control is currently in warning state
+     */
+    warn?: boolean;
+    /**
+     * Provide the text that is displayed when the control is in warning state
+     */
+    warnText?: React.ReactNode;
+}
+declare const FluidComboBox: React.ForwardRefExoticComponent<FluidComboBoxProps<unknown> & React.RefAttributes<HTMLInputElement>>;
+export default FluidComboBox;

package/es/components/FluidComboBox/FluidComboBox.js

@@ -91,7 +91,7 @@ FluidComboBox.propTypes = {
    * `onChange` is a utility for this controlled component to communicate to a
    * consuming component what kind of internal state changes are occurring.
    */
-  onChange: PropTypes.func,
+  onChange: PropTypes.func.isRequired,
   /**
    * An optional callback to render the currently selected item as a react element instead of only
    * as a string.
@@ -119,6 +119,5 @@ FluidComboBox.propTypes = {
    */
   warnText: PropTypes.node
 };
-var FluidComboBox$1 = FluidComboBox;
 
-export { FluidComboBox$1 as default };
+export { FluidComboBox as default };