@carbon/react 1.99.0 → 1.100.0

package/lib/components/ListBox/ListBoxSelection.d.ts

@@ -4,7 +4,7 @@
  * 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';
+import PropTypes from 'prop-types';
 import { KeyboardEvent, MouseEvent } from 'react';
 import type { TranslateWithId } from '../../types/common';
 export interface ListBoxSelectionProps extends TranslateWithId<TranslationKey> {
@@ -32,7 +32,7 @@ export interface ListBoxSelectionProps extends TranslateWithId<TranslationKey> {
      */
     selectionCount?: number;
 }
-export type ListBoxSelectionComponent = React.FC<ListBoxSelectionProps>;
+export type ListBoxSelectionComponent = typeof ListBoxSelection;
 declare const translationIds: {
     readonly 'clear.all': "clear.all";
     readonly 'clear.selection': "clear.selection";
@@ -43,5 +43,36 @@ type TranslationKey = keyof typeof translationIds;
  * addition to conditionally rendering a badge if the control has more than one
  * selection.
  */
-declare const ListBoxSelection: ListBoxSelectionComponent;
+declare const ListBoxSelection: {
+    ({ clearSelection, selectionCount, translateWithId: t, disabled, onClearSelection, readOnly, }: ListBoxSelectionProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify a function to be invoked when a user interacts with the clear
+         * selection element.
+         */
+        clearSelection: PropTypes.Validator<(...args: any[]) => any>;
+        /**
+         * Specify whether or not the clear selection element should be disabled
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * Specify an optional `onClearSelection` handler that is called when the underlying
+         * element is cleared
+         */
+        onClearSelection: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Whether or not the Dropdown is readonly
+         */
+        readOnly: PropTypes.Requireable<boolean>;
+        /**
+         * Specify an optional `selectionCount` value that will be used to determine
+         * whether the selection should display a badge or a single clear icon.
+         */
+        selectionCount: PropTypes.Requireable<number>;
+        /**
+         * Translates component strings using your i18n tool.
+         */
+        translateWithId: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+};
 export default ListBoxSelection;

package/lib/components/Menu/MenuItem.d.ts

@@ -4,7 +4,7 @@
  * 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, { ComponentProps, FC, KeyboardEvent, LiHTMLAttributes, MouseEvent, ReactNode } from 'react';
+import React, { type ComponentProps, type ElementType, type KeyboardEvent, type LiHTMLAttributes, type MouseEvent, type ReactNode } from 'react';
 export interface MenuItemProps extends LiHTMLAttributes<HTMLLIElement> {
     /**
      * Optionally provide another Menu to create a submenu. props.children can't be used to specify the content of the MenuItem itself. Use props.label instead.
@@ -33,7 +33,7 @@ export interface MenuItemProps extends LiHTMLAttributes<HTMLLIElement> {
     /**
      * A component used to render an icon.
      */
-    renderIcon?: FC;
+    renderIcon?: ElementType;
     /**
      * Provide a shortcut for the action of this MenuItem. Note that the component will only render it as a hint but not actually register the shortcut.
      */

package/lib/components/MultiSelect/FilterableMultiSelect.d.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { type UseComboboxProps, type UseMultipleSelectionProps } from 'downshift';
-import React, { type FunctionComponent, type ReactElement, type ReactNode } from 'react';
+import React, { type ReactElement, type ReactNode } from 'react';
 import { type MultiSelectSortingProps } from './MultiSelectPropTypes';
 import { type ListBoxMenuIconTranslationKey, type ListBoxSelectionTranslationKey, type ListBoxSize, type ListBoxType } from '../ListBox';
 import type { TranslateWithId } from '../../types/common';
@@ -93,7 +93,7 @@ export interface FilterableMultiSelectProps<ItemType> extends MultiSelectSorting
      * Function to render items as custom components instead of strings.
      * Defaults to null and is overridden by a getter
      */
-    itemToElement?: FunctionComponent<ItemType>;
+    itemToElement?: (item: ItemType) => ReactNode;
     /**
      * Helper function passed to downshift that allows the library to render
      * a given item to a string label.

package/lib/components/MultiSelect/FilterableMultiSelect.js

@@ -35,6 +35,7 @@ var react = require('@floating-ui/react');
 var index = require('../AILabel/index.js');
 var defaultItemToString = require('../../internal/defaultItemToString.js');
 var utils = require('../../internal/utils.js');
+var useNormalizedInputProps = require('../../internal/useNormalizedInputProps.js');
 var ListBoxPropTypes = require('../ListBox/ListBoxPropTypes.js');
 
 const {
@@ -73,7 +74,7 @@ const FilterableMultiSelect = /*#__PURE__*/React.forwardRef(function FilterableM
   hideLabel,
   id,
   initialSelectedItems = [],
-  invalid,
+  invalid = false,
   invalidText,
   items,
   itemToElement: ItemToElement,
@@ -95,7 +96,7 @@ const FilterableMultiSelect = /*#__PURE__*/React.forwardRef(function FilterableM
   sortItems = sorting.defaultSortItems,
   translateWithId,
   useTitleInItem,
-  warn,
+  warn = false,
   warnText,
   slug,
   inputProps
@@ -239,15 +240,23 @@ const FilterableMultiSelect = /*#__PURE__*/React.forwardRef(function FilterableM
     return sortedReal;
     // eslint-disable-next-line  react-hooks/exhaustive-deps -- https://github.com/carbon-design-system/carbon/issues/20452
   }, [items, inputValue, controlledSelectedItems, topItems, selectionFeedback, itemToString, compareItems, locale, sortItems, nonSelectAllItems]);
+  const normalizedProps = useNormalizedInputProps.useNormalizedInputProps({
+    id,
+    disabled,
+    readOnly,
+    invalid,
+    warn
+  });
   const inline = type === 'inline';
-  const showWarning = !invalid && warn;
+  const showWarning = normalizedProps.warn;
+  const showHelperText = !normalizedProps.warn && !normalizedProps.invalid;
   const wrapperClasses = cx(`${prefix}--multi-select__wrapper`, `${prefix}--multi-select--filterable__wrapper`, `${prefix}--list-box__wrapper`, containerClassName, {
     [`${prefix}--multi-select__wrapper--inline`]: inline,
     [`${prefix}--list-box__wrapper--inline`]: inline,
-    [`${prefix}--multi-select__wrapper--inline--invalid`]: inline && invalid,
-    [`${prefix}--list-box__wrapper--inline--invalid`]: inline && invalid,
+    [`${prefix}--multi-select__wrapper--inline--invalid`]: inline && normalizedProps.invalid,
+    [`${prefix}--list-box__wrapper--inline--invalid`]: inline && normalizedProps.invalid,
     [`${prefix}--list-box--up`]: direction === 'top',
-    [`${prefix}--list-box__wrapper--fluid--invalid`]: isFluid && invalid,
+    [`${prefix}--list-box__wrapper--fluid--invalid`]: isFluid && normalizedProps.invalid,
     [`${prefix}--list-box__wrapper--slug`]: slug,
     [`${prefix}--list-box__wrapper--decorator`]: decorator,
     [`${prefix}--autoalign`]: autoAlign
@@ -521,8 +530,8 @@ const FilterableMultiSelect = /*#__PURE__*/React.forwardRef(function FilterableM
   // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
   item => !item.isSelectAll).length;
   const className = cx(`${prefix}--multi-select`, `${prefix}--combo-box`, `${prefix}--multi-select--filterable`, {
-    [`${prefix}--multi-select--invalid`]: invalid,
-    [`${prefix}--multi-select--invalid--focused`]: invalid && inputFocused,
+    [`${prefix}--multi-select--invalid`]: normalizedProps.invalid,
+    [`${prefix}--multi-select--invalid--focused`]: inputFocused && normalizedProps.invalid,
     [`${prefix}--multi-select--open`]: isOpen,
     [`${prefix}--multi-select--inline`]: inline,
     [`${prefix}--multi-select--selected`]: controlledSelectedItems?.length > 0,
@@ -554,7 +563,7 @@ const FilterableMultiSelect = /*#__PURE__*/React.forwardRef(function FilterableM
   });
   const inputProp = getInputProps(getDropdownProps({
     'aria-controls': isOpen ? menuId : undefined,
-    'aria-describedby': helperText && !invalid && !warn ? helperId : undefined,
+    'aria-describedby': helperText && showHelperText ? helperId : undefined,
     'aria-haspopup': 'listbox',
     // Remove excess aria `aria-labelledby`. HTML <label for>
     // provides this aria information.
@@ -649,9 +658,9 @@ const FilterableMultiSelect = /*#__PURE__*/React.forwardRef(function FilterableM
     light: light,
     ref: ref,
     id: id,
-    invalid: invalid,
+    invalid: normalizedProps.invalid,
     invalidText: invalidText,
-    warn: warn,
+    warn: normalizedProps.warn,
     warnText: warnText,
     isOpen: !readOnly && isOpen,
     size: size
@@ -675,7 +684,7 @@ const FilterableMultiSelect = /*#__PURE__*/React.forwardRef(function FilterableM
     ref: mergedRef
   }, readOnlyEventHandlers, {
     readOnly: readOnly
-  })), invalid && /*#__PURE__*/React.createElement(iconsReact.WarningFilled, {
+  })), normalizedProps.invalid && /*#__PURE__*/React.createElement(iconsReact.WarningFilled, {
     className: `${prefix}--list-box__invalid-icon`
   }), showWarning && /*#__PURE__*/React.createElement(iconsReact.WarningAltFilled, {
     className: `${prefix}--list-box__invalid-icon ${prefix}--list-box__invalid-icon--warning`
@@ -744,7 +753,7 @@ const FilterableMultiSelect = /*#__PURE__*/React.forwardRef(function FilterableM
       disabled: disabled,
       tabIndex: -1
     })));
-  }) : null)), !inline && !invalid && !warn ? helper : null);
+  }) : null)), !inline && showHelperText ? helper : null);
 });
 FilterableMultiSelect.displayName = 'FilterableMultiSelect';
 FilterableMultiSelect.propTypes = {

package/lib/components/MultiSelect/MultiSelect.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -82,10 +82,9 @@ export interface MultiSelectProps<ItemType> extends MultiSelectSortingProps<Item
      */
     invalidText?: ReactNode;
     /**
-     * Function to render items as custom components instead of strings.
-     * Defaults to null and is overridden by a getter
+     * Renders an item as a custom React node instead of a string.
      */
-    itemToElement?: React.JSXElementConstructor<ItemType>;
+    itemToElement?: ((item: ItemType) => NonNullable<ReactNode>) | 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

package/lib/components/MultiSelect/MultiSelect.js

@@ -34,6 +34,7 @@ var index = require('../FeatureFlags/index.js');
 var index$1 = require('../AILabel/index.js');
 var defaultItemToString = require('../../internal/defaultItemToString.js');
 var utils = require('../../internal/utils.js');
+var useNormalizedInputProps = require('../../internal/useNormalizedInputProps.js');
 var ListBoxPropTypes = require('../ListBox/ListBoxPropTypes.js');
 
 const {
@@ -73,9 +74,9 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
   clearAnnouncement = 'all items have been cleared',
   clearSelectionDescription = 'Total items selected: ',
   light,
-  invalid,
+  invalid = false,
   invalidText,
-  warn,
+  warn = false,
   warnText,
   useTitleInItem,
   translateWithId,
@@ -256,14 +257,22 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
     setIsOpenWrapper(open);
     setPrevOpenProp(open);
   }
+  const normalizedProps = useNormalizedInputProps.useNormalizedInputProps({
+    id,
+    disabled,
+    readOnly,
+    invalid,
+    warn
+  });
   const inline = type === 'inline';
-  const showWarning = !invalid && warn;
+  const showWarning = normalizedProps.warn;
+  const showHelperText = !normalizedProps.warn && !normalizedProps.invalid && helperText;
   const wrapperClasses = cx(`${prefix}--multi-select__wrapper`, `${prefix}--list-box__wrapper`, containerClassName, {
     [`${prefix}--multi-select__wrapper--inline`]: inline,
     [`${prefix}--list-box__wrapper--inline`]: inline,
-    [`${prefix}--multi-select__wrapper--inline--invalid`]: inline && invalid,
-    [`${prefix}--list-box__wrapper--inline--invalid`]: inline && invalid,
-    [`${prefix}--list-box__wrapper--fluid--invalid`]: isFluid && invalid,
+    [`${prefix}--multi-select__wrapper--inline--invalid`]: inline && normalizedProps.invalid,
+    [`${prefix}--list-box__wrapper--inline--invalid`]: inline && normalizedProps.invalid,
+    [`${prefix}--list-box__wrapper--fluid--invalid`]: isFluid && normalizedProps.invalid,
     [`${prefix}--list-box__wrapper--slug`]: slug,
     [`${prefix}--list-box__wrapper--decorator`]: decorator
   });
@@ -277,8 +286,8 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
     [`${prefix}--form__helper-text--disabled`]: disabled
   });
   const className = cx(`${prefix}--multi-select`, {
-    [`${prefix}--multi-select--invalid`]: invalid,
-    [`${prefix}--multi-select--invalid--focused`]: invalid && inputFocused,
+    [`${prefix}--multi-select--invalid`]: normalizedProps.invalid,
+    [`${prefix}--multi-select--invalid--focused`]: inputFocused && normalizedProps.invalid,
     [`${prefix}--multi-select--warning`]: showWarning,
     [`${prefix}--multi-select--inline`]: inline,
     [`${prefix}--multi-select--selected`]: selectedItems && selectedItems.length > 0,
@@ -287,10 +296,6 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
     [`${prefix}--autoalign`]: enableFloatingStyles,
     [`${prefix}--multi-select--selectall`]: selectAll
   });
-
-  // needs to be capitalized for react to render it correctly
-  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-  const ItemToElement = itemToElement;
   if (selectionFeedback === 'fixed') {
     sortOptions.selectedItems = [];
   } else if (selectionFeedback === 'top-after-reopen') {
@@ -449,13 +454,13 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
     className: className,
     disabled: disabled,
     light: light,
-    invalid: invalid,
+    invalid: normalizedProps.invalid,
     invalidText: invalidText,
-    warn: warn,
+    warn: normalizedProps.warn,
     warnText: warnText,
     isOpen: isOpen,
     id: id
-  }, invalid && /*#__PURE__*/React.createElement(iconsReact.WarningFilled, {
+  }, normalizedProps.invalid && /*#__PURE__*/React.createElement(iconsReact.WarningFilled, {
     className: `${prefix}--list-box__invalid-icon`
   }), showWarning && /*#__PURE__*/React.createElement(iconsReact.WarningAltFilled, {
     className: `${prefix}--list-box__invalid-icon ${prefix}--list-box__invalid-icon--warning`
@@ -475,7 +480,7 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
     className: `${prefix}--list-box__field`,
     disabled: disabled,
     "aria-disabled": disabled || readOnly,
-    "aria-describedby": !inline && !invalid && !warn && helperText ? helperId : undefined
+    "aria-describedby": !inline && showHelperText ? helperId : undefined
   }, toggleButtonProps, {
     ref: mergedRef
   }, readOnlyEventHandlers), /*#__PURE__*/React.createElement("span", {
@@ -519,9 +524,7 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
       className: `${prefix}--checkbox-wrapper`
     }, /*#__PURE__*/React.createElement(Checkbox.default, {
       id: `${itemProps.id}__checkbox`,
-      labelText: itemToElement ? /*#__PURE__*/React.createElement(ItemToElement, _rollupPluginBabelHelpers.extends({
-        key: itemProps.id
-      }, item)) : itemText,
+      labelText: itemToElement ? itemToElement(item) : itemText,
       checked: isChecked,
       title: useTitleInItem ? itemText : undefined,
       indeterminate: isIndeterminate,
@@ -530,7 +533,7 @@ const MultiSelect = /*#__PURE__*/React.forwardRef(({
   })), itemsCleared && /*#__PURE__*/React.createElement("span", {
     "aria-live": "assertive",
     "aria-label": clearAnnouncement
-  })), !inline && !invalid && !warn && helperText && /*#__PURE__*/React.createElement("div", {
+  })), !inline && showHelperText && /*#__PURE__*/React.createElement("div", {
     id: helperId,
     className: helperClasses
   }, helperText));
@@ -612,8 +615,7 @@ MultiSelect.propTypes = {
    */
   invalidText: PropTypes.node,
   /**
-   * Function to render items as custom components instead of strings.
-   * Defaults to null and is overridden by a getter
+   * Renders an item as a custom React node instead of a string.
    */
   itemToElement: PropTypes.func,
   /**

package/lib/components/Notification/Notification.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -7,6 +7,7 @@
 import PropTypes from 'prop-types';
 import React, { type ReactNode, type MouseEvent, type ButtonHTMLAttributes, type HTMLAttributes, type ComponentProps } from 'react';
 import Button, { type ButtonProps } from '../Button';
+type NotificationCloseHandler = ((event: MouseEvent) => boolean) | ((event: MouseEvent) => void);
 export interface NotificationActionButtonProps extends ButtonProps<'button'> {
     /**
      * Specify the content of the notification action button.
@@ -151,7 +152,7 @@ export interface ToastNotificationProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * Provide a function that is called when menu is closed
      */
-    onClose?(event: MouseEvent): boolean | void;
+    onClose?: NotificationCloseHandler;
     /**
      * Provide a function that is called when the close button is clicked
      */
@@ -277,7 +278,7 @@ export interface InlineNotificationProps extends HTMLAttributes<HTMLDivElement>
     /**
      * Provide a function that is called when menu is closed
      */
-    onClose?(event: MouseEvent): boolean | void;
+    onClose?: NotificationCloseHandler;
     /**
      * Provide a function that is called when the close button is clicked
      */
@@ -409,7 +410,7 @@ export interface ActionableNotificationProps extends HTMLAttributes<HTMLDivEleme
      * Provide a function that is called when menu is closed.
      * Default behavior of hiding the notification is prevented if this function returns false.
      */
-    onClose?(event: MouseEvent): boolean | void;
+    onClose?: NotificationCloseHandler;
     /**
      * Provide a function that is called when the close button is clicked
      */
@@ -617,6 +618,6 @@ export declare namespace Callout {
 /**
  * @deprecated Use `CalloutProps` instead.
  */
-export interface StaticNotificationProps extends CalloutProps {
-}
-export declare const StaticNotification: React.FC<StaticNotificationProps>;
+export type StaticNotificationProps = CalloutProps;
+export declare const StaticNotification: (props: StaticNotificationProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/lib/components/Notification/Notification.js

@@ -574,6 +574,8 @@ function ActionableNotification({
     role: "link",
     className: `${prefix}--visually-hidden`
   }, "Focus sentinel"), /*#__PURE__*/React.createElement("div", {
+    ref: innerModal
+  }, /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--actionable-notification__details`
   }, /*#__PURE__*/React.createElement(NotificationIcon, {
     notificationType: inline ? 'inline' : 'toast',
@@ -595,8 +597,7 @@ function ActionableNotification({
     as: "div",
     className: `${prefix}--actionable-notification__caption`
   }, caption), children))), /*#__PURE__*/React.createElement("div", {
-    className: `${prefix}--actionable-notification__button-wrapper`,
-    ref: innerModal
+    className: `${prefix}--actionable-notification__button-wrapper`
   }, actionButtonLabel && /*#__PURE__*/React.createElement(NotificationActionButton, {
     onClick: onActionButtonClick,
     inline: inline
@@ -604,7 +605,7 @@ function ActionableNotification({
     "aria-label": deprecatedAriaLabel || ariaLabel,
     notificationType: "actionable",
     onClick: handleCloseButtonClick
-  })), !focusTrapWithoutSentinels && /*#__PURE__*/React.createElement("span", {
+  }))), !focusTrapWithoutSentinels && /*#__PURE__*/React.createElement("span", {
     ref: endTrap,
     tabIndex: 0,
     role: "link",
@@ -812,7 +813,6 @@ Callout.propTypes = {
 /**
  * @deprecated Use `CalloutProps` instead.
  */
-// eslint-disable-next-line @typescript-eslint/no-empty-object-type -- https://github.com/carbon-design-system/carbon/issues/20452
 
 let didWarnAboutDeprecation = false;
 const StaticNotification = props => {

package/lib/components/OverflowMenu/OverflowMenu.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/OverflowMenu/OverflowMenu.js

@@ -79,7 +79,6 @@ const getMenuOffset = (menuBody, direction, trigger, flip) => {
     case 'top':
     case 'bottom':
       {
-        // TODO: Ensure `trigger` is there for `<OverflowMenu open>`
         const triggerWidth = !trigger ? 0 : trigger.offsetWidth;
         return {
           left: (!flip ? 1 : -1) * (menuWidth / 2 - triggerWidth / 2),

package/lib/components/OverflowMenu/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/PageHeader/PageHeader.d.ts

@@ -4,7 +4,7 @@
  * 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, { type ComponentType, type FunctionComponent } from 'react';
+import React, { type ElementType } from 'react';
 import PropTypes from 'prop-types';
 import { TYPES } from '../Tag/Tag';
 /**
@@ -32,7 +32,7 @@ interface PageHeaderBreadcrumbBarProps {
     /**
      * Provide an optional icon to render in front of the PageHeaderContent's title.
      */
-    renderIcon?: ComponentType | FunctionComponent;
+    renderIcon?: ElementType;
     /**
      * The PageHeaderBreadcrumbBar's content actions
      */
@@ -68,7 +68,7 @@ interface PageHeaderContentProps {
     /**
      * Provide an optional icon to render in front of the PageHeaderContent's title.
      */
-    renderIcon?: ComponentType | FunctionComponent;
+    renderIcon?: ElementType;
     /**
      * The PageHeaderContent's title
      */

package/lib/components/Popover/index.js

@@ -149,7 +149,9 @@ forwardRef) {
     refs,
     floatingStyles,
     placement,
-    middlewareData
+    middlewareData,
+    elements,
+    update
   } = react.useFloating(enableFloatingStyles ? {
     placement: align,
     // The floating element is positioned relative to its nearest
@@ -169,12 +171,18 @@ forwardRef) {
     }), react.arrow({
       element: caretRef,
       padding: 16
-    }), autoAlign && react.hide()],
-    whileElementsMounted: react.autoUpdate
+    }), autoAlign && react.hide()]
   } : {}
   // When autoAlign is turned off & the `enable-v12-dynamic-floating-styles` feature flag is not
   // enabled, floating-ui will not be used
   );
+  React.useEffect(() => {
+    if (!enableFloatingStyles) return;
+    if (open && elements.reference && elements.floating) {
+      const cleanup = react.autoUpdate(elements.reference, elements.floating, update);
+      return cleanup;
+    }
+  }, [enableFloatingStyles, open, elements, update]);
   const value = React.useMemo(() => {
     return {
       floating,
@@ -399,11 +407,13 @@ Popover.propTypes = {
    */
   open: PropTypes.bool.isRequired
 };
-function PopoverContentRenderFunction({
-  className,
-  children,
-  ...rest
-}, forwardRef) {
+const frFn = React.forwardRef;
+const PopoverContent = frFn((props, forwardRef) => {
+  const {
+    className,
+    children,
+    ...rest
+  } = props;
   const prefix = usePrefix.usePrefix();
   const {
     setFloating,
@@ -429,8 +439,7 @@ function PopoverContentRenderFunction({
     }),
     ref: caretRef
   }));
-}
-const PopoverContent = /*#__PURE__*/React.forwardRef(PopoverContentRenderFunction);
+});
 PopoverContent.displayName = 'PopoverContent';
 PopoverContent.propTypes = {
   /**

package/lib/components/Search/Search.d.ts

@@ -4,7 +4,7 @@
  * 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, { type ChangeEvent, type ComponentType, type FunctionComponent, type HTMLAttributes, type KeyboardEvent, type MouseEvent, type ReactNode } from 'react';
+import React, { type ChangeEvent, type ElementType, type HTMLAttributes, type KeyboardEvent, type MouseEvent, type ReactNode } from 'react';
 type InputPropsBase = Omit<HTMLAttributes<HTMLInputElement>, 'onChange'>;
 export interface SearchProps extends InputPropsBase {
     /**
@@ -61,7 +61,7 @@ export interface SearchProps extends InputPropsBase {
     /**
      * A component used to render an icon.
      */
-    renderIcon?: ComponentType | FunctionComponent;
+    renderIcon?: ElementType;
     /**
      * @deprecated Specify the role for the underlying `<input>`.
      * No longer needed since `<input type="search">` already provides the correct semantics.

package/lib/components/Select/Select.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/SkeletonIcon/SkeletonIcon.d.ts

@@ -1,9 +1,23 @@
-import React from 'react';
+/**
+ * Copyright IBM Corp. 2016, 2025
+ *
+ * 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';
 export interface SkeletonIconProps {
     /**
      * Specify an optional className to add.
      */
     className?: string;
 }
-declare const SkeletonIcon: React.FC<SkeletonIconProps>;
+declare const SkeletonIcon: {
+    ({ className, ...other }: SkeletonIconProps): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+    };
+};
 export default SkeletonIcon;

package/lib/components/SkeletonText/SkeletonText.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Tag/Tag.d.ts

@@ -72,7 +72,7 @@ export interface TagBaseProps {
      */
     slug?: ReactNode;
     /**
-     * @deprecated The `title` prop has been deprecated and will be removed in the next major version. Use DismissibleTag instead.
+     * @deprecated The `title` prop has been deprecated and will be removed in the next major version. Use `children` instead.
      */
     title?: string;
     /**

package/lib/components/Tag/Tag.js

@@ -156,6 +156,8 @@ const TagBase = /*#__PURE__*/React.forwardRef(({
   }, normalizedDecorator) : '');
 });
 const Tag = TagBase;
+
+// @ts-expect-error - `propTypes` isn't typed.
 Tag.propTypes = {
   /**
    * Provide an alternative tag or component to use instead of the default

package/lib/components/Text/Text.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/Text/Text.js

@@ -13,7 +13,7 @@ var React = require('react');
 var TextDirectionContext = require('./TextDirectionContext.js');
 
 // eslint-disable-next-line react/display-name -- https://github.com/carbon-design-system/carbon/issues/20452
-const TextBase = /*#__PURE__*/React.forwardRef(({
+const Text = /*#__PURE__*/React.forwardRef(({
   as,
   children,
   dir = 'auto',
@@ -55,7 +55,8 @@ const TextBase = /*#__PURE__*/React.forwardRef(({
     ref: ref
   }, rest, textProps), children));
 });
-const Text = TextBase;
+
+// @ts-expect-error - `propTypes` isn't typed.
 Text.propTypes = {
   /**
    * Provide a custom element type used to render the outermost node

package/lib/components/Text/TextDirection.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.