@carbon/react 1.68.0-rc.0 → 1.69.0-rc.0

package/README.md

@@ -135,9 +135,9 @@ Licensed under the [Apache 2.0 License](/LICENSE).
 
 ## <picture><source height="20" width="20" media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/ibm-telemetry/telemetry-js/main/docs/images/ibm-telemetry-dark.svg"><source height="20" width="20" media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/ibm-telemetry/telemetry-js/main/docs/images/ibm-telemetry-light.svg"><img height="20" width="20" alt="IBM Telemetry" src="https://raw.githubusercontent.com/ibm-telemetry/telemetry-js/main/docs/images/ibm-telemetry-light.svg"></picture> IBM Telemetry
 
-This package uses IBM Telemetry to collect metrics data. By installing this
-package as a dependency you are agreeing to telemetry collection. To opt out,
-see
+This package uses IBM Telemetry to collect de-identified and anonymized metrics
+data. By installing this package as a dependency you are agreeing to telemetry
+collection. To opt out, see
 [Opting out of IBM Telemetry data collection](https://github.com/ibm-telemetry/telemetry-js/tree/main#opting-out-of-ibm-telemetry-data-collection).
 For more information on the data being collected, please see the
 [IBM Telemetry documentation](https://github.com/ibm-telemetry/telemetry-js/tree/main#ibm-telemetry-collection-basics).

package/es/components/Accordion/AccordionItem.js

@@ -108,7 +108,6 @@ function AccordionItem(_ref) {
     className: `${prefix}--accordion__title`
   }, title)), /*#__PURE__*/React__default.createElement("div", {
     ref: content,
-    hidden: !isOpen,
     className: `${prefix}--accordion__wrapper`,
     onTransitionEnd: onAnimationEnd
   }, /*#__PURE__*/React__default.createElement("div", {

package/es/components/Button/Button.js

@@ -26,6 +26,7 @@ const Button = /*#__PURE__*/React__default.forwardRef(function Button(props, ref
   const tooltipRef = useRef(null);
   const {
     as,
+    autoAlign = false,
     children,
     hasIconOnly = false,
     iconDescription,
@@ -84,6 +85,7 @@ const Button = /*#__PURE__*/React__default.forwardRef(function Button(props, ref
       onMouseLeave: onMouseLeave,
       onFocus: onFocus,
       onBlur: onBlur,
+      autoAlign: autoAlign,
       onClick: composeEventHandlers([onClick, handleClick]),
       renderIcon: iconOnlyImage ? null : ButtonImageElement // avoid doubling the icon.
     }), iconOnlyImage ?? children);
@@ -96,6 +98,10 @@ Button.propTypes = {
    * Make sure to apply all props to the root node and render children appropriately
    */
   as: PropTypes.oneOfType([PropTypes.func, PropTypes.string, PropTypes.elementType]),
+  /**
+   * **Experimental**: Will attempt to automatically align the tooltip
+   */
+  autoAlign: PropTypes.bool,
   /**
    * Specify the content of your Button
    */

package/es/components/CheckboxGroup/CheckboxGroup.js

@@ -126,6 +126,5 @@ CheckboxGroup.propTypes = {
    */
   warnText: PropTypes.node
 };
-var CheckboxGroup$1 = CheckboxGroup;
 
-export { CheckboxGroup$1 as default };
+export { CheckboxGroup as default };

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

@@ -0,0 +1,10 @@
+/**
+ * Copyright IBM Corp. 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 CheckboxGroup from './CheckboxGroup';
+import { type CheckboxGroupProps, type CustomType } from './CheckboxGroup';
+export default CheckboxGroup;
+export { CheckboxGroup, type CheckboxGroupProps, type CustomType };

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, useRef, useEffect, useState, useContext, useCallback, useMemo } from 'react';
 import '../Text/index.js';
 import { WarningFilled, WarningAltFilled, Checkmark } from '@carbon/icons-react';
 import ListBox from '../ListBox/index.js';
@@ -23,6 +23,7 @@ import '../FluidForm/FluidForm.js';
 import { FormContext } from '../FluidForm/FormContext.js';
 import { useFloating, flip, autoUpdate } from '@floating-ui/react';
 import { hide } from '../../node_modules/@floating-ui/dom/dist/floating-ui.dom.mjs.js';
+import { useFeatureFlag } from '../FeatureFlags/index.js';
 import { Text } from '../Text/Text.js';
 import { match } from '../../internal/keyboard/match.js';
 import { ListBoxSize } from '../ListBox/ListBoxPropTypes.js';
@@ -36,8 +37,7 @@ const {
   ItemMouseMove,
   InputKeyDownArrowUp,
   InputKeyDownArrowDown,
-  MenuMouseLeave,
-  FunctionSelectItem
+  MenuMouseLeave
 } = useCombobox.stateChangeTypes;
 const defaultItemToString = item => {
   if (typeof item === 'string') {
@@ -52,26 +52,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 +110,8 @@ const findHighlightedIndex = (_ref2, inputValue) => {
  */
 
 const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
+  const prevInputLengthRef = useRef(0);
+  const inputRef = useRef(null);
   const {
     ['aria-label']: ariaLabel = 'Choose an item',
     ariaLabel: deprecatedAriaLabel,
@@ -122,25 +140,27 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     size,
     titleText,
     translateWithId,
+    typeahead = false,
     warn,
     warnText,
     allowCustomValue = false,
     slug,
     ...rest
   } = props;
+  const enableFloatingStyles = useFeatureFlag('enable-v12-dynamic-floating-styles') || autoAlign;
   const {
     refs,
     floatingStyles,
     middlewareData
-  } = useFloating(autoAlign ? {
+  } = useFloating(enableFloatingStyles ? {
     placement: direction,
     strategy: 'fixed',
-    middleware: [flip(), hide()],
+    middleware: autoAlign ? [flip(), hide()] : undefined,
     whileElementsMounted: autoUpdate
   } : {});
   const parentWidth = refs?.reference?.current?.clientWidth;
   useEffect(() => {
-    if (autoAlign) {
+    if (enableFloatingStyles) {
       const updatedFloatingStyles = {
         ...floatingStyles,
         visibility: middlewareData.hide?.referenceHidden ? 'hidden' : 'visible'
@@ -154,34 +174,69 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
         refs.floating.current.style.width = parentWidth + 'px';
       }
     }
-  }, [autoAlign, floatingStyles, refs.floating, parentWidth]);
-  const prefix = usePrefix();
-  const {
-    isFluid
-  } = useContext(FormContext);
-  const textInput = useRef(null);
-  const comboBoxInstanceId = useId();
+  }, [enableFloatingStyles, floatingStyles, refs.floating, parentWidth]);
   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 +259,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 +295,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);
@@ -321,7 +368,7 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     [`${prefix}--list-box--up`]: direction === 'top',
     [`${prefix}--combo-box--warning`]: showWarning,
     [`${prefix}--combo-box--readonly`]: readOnly,
-    [`${prefix}--autoalign`]: autoAlign
+    [`${prefix}--autoalign`]: enableFloatingStyles
   });
   const titleClasses = cx(`${prefix}--label`, {
     [`${prefix}--label--disabled`]: disabled
@@ -377,25 +424,33 @@ 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));
     },
-    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];
@@ -474,9 +529,18 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
 
   // Memoize the value of getMenuProps to avoid an infinite loop
   const menuProps = useMemo(() => getMenuProps({
-    'aria-label': deprecatedAriaLabel || ariaLabel,
-    ref: autoAlign ? refs.setFloating : null
-  }), [autoAlign, deprecatedAriaLabel, ariaLabel, getMenuProps, refs.setFloating]);
+    ref: enableFloatingStyles ? refs.setFloating : null
+  }), [enableFloatingStyles, 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({
@@ -494,7 +558,7 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     light: light,
     size: size,
     warn: warn,
-    ref: autoAlign ? refs.setReference : null,
+    ref: enableFloatingStyles ? refs.setReference : null,
     warnText: warnText,
     warnTextId: warnTextId
   }, /*#__PURE__*/React__default.createElement("div", {
@@ -507,9 +571,16 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     "aria-haspopup": "listbox",
     title: textInput?.current?.value
   }, getInputProps({
+    'aria-label': titleText ? undefined : deprecatedAriaLabel || ariaLabel,
     'aria-controls': isOpen ? undefined : menuProps.id,
     placeholder,
-    ref: mergeRefs(textInput, ref),
+    value: inputValue,
+    onChange: e => {
+      const newValue = e.target.value;
+      setInputValue(newValue);
+      downshiftSetInputValue(newValue);
+    },
+    ref: mergeRefs(textInput, ref, inputRef),
     onKeyDown: event => {
       if (match(event, Space)) {
         event.stopPropagation();
@@ -557,6 +628,15 @@ 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);
+          selectItem(matchingItem);
+        }
+      }
     }
   }), rest, readOnlyEventHandlers, {
     readOnly: readOnly,
@@ -749,6 +829,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,
   /**
@@ -769,6 +850,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/ComboButton/index.js

@@ -20,6 +20,7 @@ import { useId } from '../../internal/useId.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { flip, size, useFloating, autoUpdate } from '@floating-ui/react';
 import { hide } from '../../node_modules/@floating-ui/dom/dist/floating-ui.dom.mjs.js';
+import { useFeatureFlag } from '../FeatureFlags/index.js';
 import mergeRefs from '../../tools/mergeRefs.js';
 
 var _ChevronDown;
@@ -47,12 +48,18 @@ const ComboButton = /*#__PURE__*/React__default.forwardRef(function ComboButton(
     translateWithId: t = defaultTranslateWithId,
     ...rest
   } = _ref;
+  // feature flag utilized to separate out only the dynamic styles from @floating-ui
+  // flag is turned on when collision detection (ie. flip, hide) logic is not desired
+  const enableOnlyFloatingStyles = useFeatureFlag('enable-v12-dynamic-floating-styles');
   const id = useId('combobutton');
   const prefix = usePrefix();
   const containerRef = useRef(null);
-  const middlewares = [flip({
-    crossAxis: false
-  }), hide()];
+  let middlewares = [];
+  if (!enableOnlyFloatingStyles) {
+    middlewares = [flip({
+      crossAxis: false
+    }), hide()];
+  }
   if (menuAlignment === 'bottom' || menuAlignment === 'top') {
     middlewares.push(size({
       apply(_ref2) {

package/es/components/DataTable/TableCell.d.ts

@@ -28,8 +28,5 @@ interface TableCellProps extends ReactAttr<HTMLTableCellElement> {
      */
     headers?: string;
 }
-declare const TableCell: {
-    ({ children, className, hasSlugHeader, colSpan, ...rest }: TableCellProps): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
+declare const TableCell: React.ForwardRefExoticComponent<TableCellProps & React.RefAttributes<HTMLTableCellElement>>;
 export default TableCell;

package/es/components/DataTable/TableCell.js

@@ -10,7 +10,7 @@ import React__default from 'react';
 import cx from 'classnames';
 import { usePrefix } from '../../internal/usePrefix.js';
 
-const TableCell = _ref => {
+const TableCell = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
   let {
     children,
     className,
@@ -24,9 +24,10 @@ const TableCell = _ref => {
   });
   return /*#__PURE__*/React__default.createElement("td", _extends({
     className: tableCellClassNames ? tableCellClassNames : undefined,
+    ref: ref,
     colSpan: colSpan
   }, rest), children);
-};
+});
 TableCell.displayName = 'TableCell';
 
 export { TableCell as default };

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/Disclosure/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+declare function useDisclosure(id: any): {
+    buttonProps: {
+        'aria-controls': any;
+        'aria-expanded': boolean;
+        onClick(): void;
+    };
+    contentProps: {
+        id: any;
+    };
+    open: boolean;
+};
+export { useDisclosure };

package/es/components/Dropdown/Dropdown.js

@@ -20,6 +20,7 @@ import { FormContext } from '../FluidForm/FormContext.js';
 import { useId } from '../../internal/useId.js';
 import { useFloating, size, flip, autoUpdate } from '@floating-ui/react';
 import { hide } from '../../node_modules/@floating-ui/dom/dist/floating-ui.dom.mjs.js';
+import { useFeatureFlag } from '../FeatureFlags/index.js';
 import { ListBoxSize, ListBoxType } from '../ListBox/ListBoxPropTypes.js';
 
 const {
@@ -71,11 +72,12 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
     slug,
     ...other
   } = _ref;
+  const enableFloatingStyles = useFeatureFlag('enable-v12-dynamic-floating-styles');
   const {
     refs,
     floatingStyles,
     middlewareData
-  } = useFloating(autoAlign ? {
+  } = useFloating(enableFloatingStyles || autoAlign ? {
     placement: direction,
     // The floating element is positioned relative to its nearest
     // containing block (usually the viewport). It will in many cases also
@@ -93,12 +95,14 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
           width: `${rects.reference.width}px`
         });
       }
-    }), flip(), hide()],
+    }), autoAlign && flip(), autoAlign && hide()],
     whileElementsMounted: autoUpdate
-  } : {} // When autoAlign is turned off, floating-ui will not be used
+  } : {}
+  // When autoAlign is turned off & the `enable-v12-dynamic-floating-styles` feature flag is not
+  // enabled, floating-ui will not be used
   );
   useEffect(() => {
-    if (autoAlign) {
+    if (enableFloatingStyles || autoAlign) {
       const updatedFloatingStyles = {
         ...floatingStyles,
         visibility: middlewareData.hide?.referenceHidden ? 'hidden' : 'visible'
@@ -237,9 +241,7 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
       // NOTE: does not prevent click
       evt.preventDefault();
       // focus on the element as per readonly input behavior
-      if (mergedRef.current !== undefined) {
-        mergedRef.current.focus();
-      }
+      mergedRef?.current?.focus();
     },
     onKeyDown: evt => {
       const selectAccessKeys = ['ArrowDown', 'ArrowUp', ' ', 'Enter'];
@@ -267,7 +269,7 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
     }
   };
   const menuProps = useMemo(() => getMenuProps({
-    ref: autoAlign ? refs.setFloating : null
+    ref: enableFloatingStyles || autoAlign ? refs.setFloating : null
   }), [autoAlign, getMenuProps, refs.setFloating]);
 
   // Slug is always size `mini`
@@ -292,7 +294,7 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
     warnText: warnText,
     light: light,
     isOpen: isOpen,
-    ref: autoAlign ? refs.setReference : null,
+    ref: enableFloatingStyles || autoAlign ? refs.setReference : null,
     id: id
   }, invalid && /*#__PURE__*/React__default.createElement(WarningFilled, {
     className: `${prefix}--list-box__invalid-icon`