@carbon/react 1.81.0 → 1.82.0-rc.0

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

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2024
+ * 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.

package/es/components/AILabel/index.js

@@ -13,7 +13,7 @@ import React__default from 'react';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { ToggletipContent, ToggletipActions, Toggletip, ToggletipButton } from '../Toggletip/index.js';
 import { IconButton } from '../IconButton/index.js';
-import { mapPopoverAlignProp } from '../../tools/createPropAdapter.js';
+import { mapPopoverAlign } from '../../tools/mapPopoverAlign.js';
 import { Undo } from '@carbon/icons-react';
 import { useId } from '../../internal/useId.js';
 import deprecate from '../../prop-types/deprecate.js';
@@ -80,9 +80,6 @@ AILabelActions.propTypes = {
  * @deprecated Use NewPopoverAlignment instead.
  */
 
-const propMappingFunction = deprecatedValue => {
-  return mapPopoverAlignProp(deprecatedValue);
-};
 const AILabel = /*#__PURE__*/React__default.forwardRef(function AILabel(_ref3, ref) {
   let {
     aiText = 'AI',
@@ -181,11 +178,7 @@ AILabel.propTypes = {
   // deprecated use right-start instead
 
   // new values to match floating-ui
-  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
-  //allowed prop values
-  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
-  //optional mapper function
-  propMappingFunction),
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']), ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'], mapPopoverAlign),
   /**
    * Specify the text that will be provided to the aria-label of the `AILabel` button
    */

package/es/components/Breadcrumb/Breadcrumb.d.ts

@@ -1,11 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * 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 React from 'react';
-import { ForwardRefReturn } from '../../types/common';
 export interface BreadcrumbProps extends React.HTMLAttributes<HTMLElement> {
     /**
      * Specify the label for the breadcrumb container
@@ -25,5 +24,5 @@ export interface BreadcrumbProps extends React.HTMLAttributes<HTMLElement> {
      */
     size?: 'sm' | 'md';
 }
-declare const Breadcrumb: ForwardRefReturn<HTMLElement, BreadcrumbProps>;
+declare const Breadcrumb: React.ForwardRefExoticComponent<BreadcrumbProps & React.RefAttributes<HTMLElement>>;
 export default Breadcrumb;

package/es/components/Breadcrumb/Breadcrumb.js

@@ -7,19 +7,19 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default from 'react';
+import React__default, { forwardRef } from 'react';
 import cx from 'classnames';
 import { usePrefix } from '../../internal/usePrefix.js';
 
-const Breadcrumb = /*#__PURE__*/React__default.forwardRef(function Breadcrumb(_ref, ref) {
-  let {
+const Breadcrumb = /*#__PURE__*/forwardRef((props, ref) => {
+  const {
     'aria-label': ariaLabel,
     children,
     className: customClassNameNav,
     noTrailingSlash,
     size,
     ...rest
-  } = _ref;
+  } = props;
   const prefix = usePrefix();
   const className = cx({
     [`${prefix}--breadcrumb`]: true,

package/es/components/Breadcrumb/BreadcrumbItem.d.ts

@@ -1,11 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * 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 React, { AriaAttributes } from 'react';
-import { ForwardRefReturn } from '../../types/common';
+import React, { type AriaAttributes } from 'react';
 export interface BreadcrumbItemProps extends React.HTMLAttributes<HTMLLIElement> {
     'aria-current'?: AriaAttributes['aria-current'];
     /**
@@ -21,5 +20,5 @@ export interface BreadcrumbItemProps extends React.HTMLAttributes<HTMLLIElement>
      */
     isCurrentPage?: boolean;
 }
-declare const BreadcrumbItem: ForwardRefReturn<HTMLLIElement, BreadcrumbItemProps>;
+declare const BreadcrumbItem: React.ForwardRefExoticComponent<BreadcrumbItemProps & React.RefAttributes<HTMLLIElement>>;
 export default BreadcrumbItem;

package/es/components/Breadcrumb/BreadcrumbItem.js

@@ -7,7 +7,7 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default from 'react';
+import React__default, { forwardRef } from 'react';
 import cx from 'classnames';
 import Link from '../Link/Link.js';
 import { OverflowMenuHorizontal } from '@carbon/icons-react';
@@ -15,15 +15,16 @@ import { usePrefix } from '../../internal/usePrefix.js';
 import '../Text/index.js';
 import { Text } from '../Text/Text.js';
 
-const BreadcrumbItem = /*#__PURE__*/React__default.forwardRef(function BreadcrumbItem(_ref, ref) {
-  let {
+const frFn = forwardRef;
+const BreadcrumbItem = frFn((props, ref) => {
+  const {
     'aria-current': ariaCurrent,
     children,
     className: customClassName = '',
     href,
     isCurrentPage,
     ...rest
-  } = _ref;
+  } = props;
   const prefix = usePrefix();
   const className = cx({
     [`${prefix}--breadcrumb-item`]: true,

package/es/components/Button/Button.js

@@ -7,9 +7,8 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default, { useRef } from 'react';
+import React__default from 'react';
 import { IconButton, IconButtonKinds } from '../IconButton/index.js';
-import { composeEventHandlers } from '../../tools/events.js';
 import ButtonBase from './ButtonBase.js';
 
 const ButtonKinds = ['primary', 'secondary', 'danger', 'ghost', 'danger--primary', 'danger--ghost', 'danger--tertiary', 'tertiary'];
@@ -23,7 +22,6 @@ function isIconOnlyButton(hasIconOnly, _kind) {
   return false;
 }
 const Button = /*#__PURE__*/React__default.forwardRef((props, ref) => {
-  const tooltipRef = useRef(null);
   const {
     as,
     autoAlign = false,
@@ -47,12 +45,6 @@ const Button = /*#__PURE__*/React__default.forwardRef((props, ref) => {
   if (ButtonImageElement && !children && !iconDescription) {
     console.error('Button: renderIcon property specified without also providing an iconDescription property. ' + 'This may impact accessibility for screen reader users.');
   }
-  const handleClick = evt => {
-    // Prevent clicks on the tooltip from triggering the button click event
-    if (evt.target === tooltipRef.current) {
-      evt.preventDefault();
-    }
-  };
   const iconOnlyImage = !ButtonImageElement ? null : /*#__PURE__*/React__default.createElement(ButtonImageElement, null);
   if (!isIconOnlyButton(hasIconOnly)) {
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
@@ -103,7 +95,7 @@ const Button = /*#__PURE__*/React__default.forwardRef((props, ref) => {
         onFocus: onFocus,
         onBlur: onBlur,
         autoAlign: autoAlign,
-        onClick: composeEventHandlers([onClick, handleClick]),
+        onClick: onClick,
         renderIcon: iconOnlyImage ? null : ButtonImageElement // avoid doubling the icon.
       }), iconOnlyImage ?? children)
     );

package/es/components/ButtonSet/ButtonSet.d.ts

@@ -1,11 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * 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 React from 'react';
-import { ForwardRefReturn } from '../../types/common';
 export interface ButtonSetProps extends React.HTMLAttributes<HTMLDivElement> {
     /**
      * Specify the button arrangement of the set (vertically stacked or
@@ -13,5 +12,5 @@ export interface ButtonSetProps extends React.HTMLAttributes<HTMLDivElement> {
      */
     stacked?: boolean;
 }
-declare const ButtonSet: ForwardRefReturn<HTMLDivElement, ButtonSetProps>;
+declare const ButtonSet: React.ForwardRefExoticComponent<ButtonSetProps & React.RefAttributes<HTMLDivElement>>;
 export default ButtonSet;

package/es/components/ButtonSet/ButtonSet.js

@@ -6,18 +6,18 @@
  */
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import React__default from 'react';
+import React__default, { forwardRef } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { usePrefix } from '../../internal/usePrefix.js';
 
-const ButtonSet = /*#__PURE__*/React__default.forwardRef(function ButtonSet(_ref, ref) {
-  let {
+const ButtonSet = /*#__PURE__*/forwardRef((props, ref) => {
+  const {
     children,
     className,
     stacked,
     ...rest
-  } = _ref;
+  } = props;
   const prefix = usePrefix();
   const buttonSetClasses = cx(className, `${prefix}--btn-set`, {
     [`${prefix}--btn-set--stacked`]: stacked

package/es/components/CodeSnippet/CodeSnippet.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * 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.

package/es/components/CodeSnippet/CodeSnippet.js

@@ -15,30 +15,18 @@ import Copy from '../Copy/Copy.js';
 import Button from '../Button/Button.js';
 import '../Button/Button.Skeleton.js';
 import CopyButton from '../CopyButton/CopyButton.js';
-import uniqueId from '../../tools/uniqueId.js';
+import { uniqueId } from '../../tools/uniqueId.js';
 import copy from 'copy-to-clipboard';
 import deprecate from '../../prop-types/deprecate.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
+import { mapPopoverAlign } from '../../tools/mapPopoverAlign.js';
 
 const rowHeightInPixels = 16;
 const defaultMaxCollapsedNumberOfRows = 15;
 const defaultMaxExpandedNumberOfRows = 0;
 const defaultMinCollapsedNumberOfRows = 3;
 const defaultMinExpandedNumberOfRows = 16;
-const propMappingFunction = deprecatedValue => {
-  const mapping = {
-    'top-left': 'top-start',
-    'top-right': 'top-end',
-    'bottom-left': 'bottom-start',
-    'bottom-right': 'bottom-end',
-    'left-bottom': 'left-end',
-    'left-top': 'left-start',
-    'right-bottom': 'right-end',
-    'right-top': 'right-start'
-  };
-  return mapping[deprecatedValue];
-};
 function CodeSnippet(_ref) {
   let {
     align = 'bottom',
@@ -269,11 +257,7 @@ CodeSnippet.propTypes = {
   // deprecated use right-start instead
 
   // new values to match floating-ui
-  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
-  //allowed prop values
-  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
-  //optional mapper function
-  propMappingFunction),
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']), ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'], mapPopoverAlign),
   /**
    * Specify a label to be read by screen readers on the containing textbox
    * node

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

@@ -6,7 +6,7 @@
  */
 import { UseComboboxProps, UseComboboxActions } from 'downshift';
 import React, { type ReactNode, type ComponentType, type ReactElement, type RefAttributes, type PropsWithChildren, type PropsWithRef, type InputHTMLAttributes, type MouseEvent } from 'react';
-import { ListBoxSize } from '../ListBox';
+import { type ListBoxSize } from '../ListBox';
 import { TranslateWithId } from '../../types/common';
 type ExcludedAttributes = 'id' | 'onChange' | 'onClick' | 'type' | 'size';
 export interface OnChangeData<ItemType> {

package/es/components/ComboBox/ComboBox.js

@@ -26,7 +26,7 @@ import '../FluidForm/FluidForm.js';
 import { FormContext } from '../FluidForm/FormContext.js';
 import { useFloating, flip, hide, autoUpdate } from '@floating-ui/react';
 import { useFeatureFlag } from '../FeatureFlags/index.js';
-import { ListBoxSize } from '../ListBox/ListBoxPropTypes.js';
+import { ListBoxSizePropType } from '../ListBox/ListBoxPropTypes.js';
 import { Text } from '../Text/Text.js';
 
 const {
@@ -906,7 +906,7 @@ ComboBox.propTypes = {
   /**
    * Specify the size of the ListBox. Currently supports either `sm`, `md` or `lg` as an option.
    */
-  size: ListBoxSize,
+  size: ListBoxSizePropType,
   slug: deprecate(PropTypes.node, 'The `slug` prop has been deprecated and will be removed in the next major version. Use the decorator prop instead.'),
   /**
    * Provide text to be used in a `<label>` element that is tied to the

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

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2023
+ * Copyright IBM Corp. 2023, 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.

package/es/components/ComboButton/index.js

@@ -22,6 +22,7 @@ import { flip, hide, size, useFloating, autoUpdate } from '@floating-ui/react';
 import { useFeatureFlag } from '../FeatureFlags/index.js';
 import mergeRefs from '../../tools/mergeRefs.js';
 import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
+import { mapPopoverAlign } from '../../tools/mapPopoverAlign.js';
 
 var _ChevronDown;
 const defaultTranslations = {
@@ -32,19 +33,6 @@ const defaultTranslations = {
  * Message ids that will be passed to translateWithId().
  */
 
-const propMappingFunction = deprecatedValue => {
-  const mapping = {
-    'top-left': 'top-start',
-    'top-right': 'top-end',
-    'bottom-left': 'bottom-start',
-    'bottom-right': 'bottom-end',
-    'left-bottom': 'left-end',
-    'left-top': 'left-start',
-    'right-bottom': 'right-end',
-    'right-top': 'right-start'
-  };
-  return mapping[deprecatedValue];
-};
 function defaultTranslateWithId(messageId) {
   return defaultTranslations[messageId];
 }
@@ -224,11 +212,7 @@ ComboButton.propTypes = {
   // deprecated use right-start instead
 
   // new values to match floating-ui
-  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
-  //allowed prop values
-  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
-  //optional mapper function
-  propMappingFunction),
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']), ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'], mapPopoverAlign),
   /**
    * Optional method that takes in a message id and returns an
    * internationalized string.

package/es/components/ComposedModal/ComposedModal.js

@@ -17,7 +17,7 @@ import mergeRefs from '../../tools/mergeRefs.js';
 import cx from 'classnames';
 import { toggleClass } from '../../tools/toggleClass.js';
 import requiredIfGivenPropIsTruthy from '../../prop-types/requiredIfGivenPropIsTruthy.js';
-import wrapFocus, { wrapFocusWithoutSentinels, elementOrParentIsFloatingMenu } from '../../internal/wrapFocus.js';
+import { wrapFocusWithoutSentinels, elementOrParentIsFloatingMenu, wrapFocus } from '../../internal/wrapFocus.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { Escape, Tab } from '../../internal/keyboard/keys.js';
 import { match } from '../../internal/keyboard/match.js';
@@ -165,10 +165,12 @@ const ComposedModal = /*#__PURE__*/React__default.forwardRef(function ComposedMo
     onMouseDownTarget.current = target;
   }
   function handleOnClick(evt) {
-    const target = evt.target;
+    const {
+      target
+    } = evt;
     const mouseDownTarget = onMouseDownTarget.current;
     evt.stopPropagation();
-    if (!preventCloseOnClickOutside && !elementOrParentIsFloatingMenu(target, selectorsFloatingMenus) && innerModal.current && !innerModal.current.contains(target) && !innerModal.current.contains(mouseDownTarget)) {
+    if (!preventCloseOnClickOutside && target instanceof Node && !elementOrParentIsFloatingMenu(target, selectorsFloatingMenus) && innerModal.current && !innerModal.current.contains(target) && !innerModal.current.contains(mouseDownTarget)) {
       closeModal(evt);
     }
   }

package/es/components/Copy/Copy.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * 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.

package/es/components/Copy/Copy.js

@@ -14,21 +14,9 @@ import { usePrefix } from '../../internal/usePrefix.js';
 import { IconButton } from '../IconButton/index.js';
 import { noopFn } from '../../internal/noopFn.js';
 import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
+import { mapPopoverAlign } from '../../tools/mapPopoverAlign.js';
 import { debounce } from '../../node_modules/es-toolkit/dist/compat/function/debounce.mjs.js';
 
-const propMappingFunction = deprecatedValue => {
-  const mapping = {
-    'top-left': 'top-start',
-    'top-right': 'top-end',
-    'bottom-left': 'bottom-start',
-    'bottom-right': 'bottom-end',
-    'left-bottom': 'left-end',
-    'left-top': 'left-start',
-    'right-bottom': 'right-end',
-    'right-top': 'right-start'
-  };
-  return mapping[deprecatedValue];
-};
 function Copy(_ref) {
   let {
     align = 'bottom',
@@ -101,11 +89,7 @@ Copy.propTypes = {
   // deprecated use right-start instead
 
   // new values to match floating-ui
-  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
-  //allowed prop values
-  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
-  //optional mapper function
-  propMappingFunction),
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']), ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'], mapPopoverAlign),
   /**
    * **Experimental**: Will attempt to automatically align the tooltip
    */

package/es/components/CopyButton/CopyButton.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * 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.

package/es/components/CopyButton/CopyButton.js

@@ -15,20 +15,8 @@ import { LayoutConstraint } from '../Layout/index.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { noopFn } from '../../internal/noopFn.js';
 import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
+import { mapPopoverAlign } from '../../tools/mapPopoverAlign.js';
 
-const propMappingFunction = deprecatedValue => {
-  const mapping = {
-    'top-left': 'top-start',
-    'top-right': 'top-end',
-    'bottom-left': 'bottom-start',
-    'bottom-right': 'bottom-end',
-    'left-bottom': 'left-end',
-    'left-top': 'left-start',
-    'right-bottom': 'right-end',
-    'right-top': 'right-start'
-  };
-  return mapping[deprecatedValue];
-};
 function CopyButton(_ref) {
   let {
     align = 'bottom',
@@ -83,11 +71,7 @@ CopyButton.propTypes = {
   // deprecated use right-start instead
 
   // new values to match floating-ui
-  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
-  //allowed prop values
-  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
-  //optional mapper function
-  propMappingFunction),
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']), ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'], mapPopoverAlign),
   /**
    * **Experimental**: Will attempt to automatically align the tooltip
    */

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

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import PropTypes from 'prop-types';
-import React from 'react';
+import React, { type MouseEvent } from 'react';
 import type { DataTableSortState } from './state/sortStates';
 import Table from './Table';
 import TableActionList from './TableActionList';
@@ -125,7 +125,7 @@ export interface DataTableRenderProps<RowType, ColTypes extends any[]> {
         [key: string]: unknown;
     };
     getSelectionProps: (getSelectionPropsArgs?: {
-        onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+        onClick?: (e: MouseEvent<HTMLInputElement, globalThis.MouseEvent>) => void;
         row: DataTableRow<ColTypes>;
         [key: string]: unknown;
     }) => {
@@ -381,7 +381,7 @@ declare class DataTable<RowType, ColTypes extends any[]> extends React.Component
         'aria-label': any;
         'aria-controls': string;
         isExpanded: boolean;
-        onExpand: any;
+        onExpand: (event: React.MouseEvent<HTMLButtonElement, globalThis.MouseEvent>, ...args: any[]) => void;
     };
     /**
      * Decorate consumer's `onClick` event handler with sort parameters
@@ -413,7 +413,7 @@ declare class DataTable<RowType, ColTypes extends any[]> extends React.Component
         [key: string]: unknown;
     }) => {
         key: string;
-        onExpand: any;
+        onExpand: (event: React.MouseEvent<HTMLButtonElement, globalThis.MouseEvent>, ...args: any[]) => void;
         isExpanded: boolean | undefined;
         'aria-label': any;
         'aria-controls': string;
@@ -437,19 +437,14 @@ declare class DataTable<RowType, ColTypes extends any[]> extends React.Component
      * Gets the props associated with selection for a header or a row, where
      * applicable. Most often used to indicate selection status of the table or
      * for a specific row.
-     *
-     * @param {object} [row] an optional row that we want to access the props for
-     * @param {Function} row.onClick
-     * @param {object} row.row
-     * @returns {object}
      */
     getSelectionProps: ({ onClick, row, ...rest }?: {
         [key: string]: unknown;
-        onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+        onClick?: (e: MouseEvent<HTMLInputElement, globalThis.MouseEvent>) => void;
         row: DataTableRow<ColTypes>;
     }) => {
         checked: boolean | undefined;
-        onSelect: any;
+        onSelect: (event: React.MouseEvent<HTMLInputElement, globalThis.MouseEvent>, ...args: any[]) => void;
         id: string;
         name: string;
         'aria-label': any;
@@ -461,7 +456,7 @@ declare class DataTable<RowType, ColTypes extends any[]> extends React.Component
         id: string;
         indeterminate: boolean;
         name: string;
-        onSelect: any;
+        onSelect: (event: React.MouseEvent<HTMLInputElement, globalThis.MouseEvent>, ...args: any[]) => void;
     };
     getToolbarProps: (props?: {}) => {
         size: "sm" | undefined;

package/es/components/DataTable/DataTable.js

@@ -233,11 +233,6 @@ class DataTable extends React__default.Component {
      * Gets the props associated with selection for a header or a row, where
      * applicable. Most often used to indicate selection status of the table or
      * for a specific row.
-     *
-     * @param {object} [row] an optional row that we want to access the props for
-     * @param {Function} row.onClick
-     * @param {object} row.row
-     * @returns {object}
      */
     _defineProperty(this, "getSelectionProps", function () {
       let {

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

@@ -1,11 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * 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 React from 'react';
-import { ForwardRefReturn } from '../../types/common';
 export interface TableToolbarActionProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onClick'> {
     /**
      * Pass in the children that will be rendered inside the TableToolbarAction
@@ -16,6 +15,5 @@ export interface TableToolbarActionProps extends Omit<React.HTMLAttributes<HTMLD
      */
     onClick: (event: React.MouseEvent<HTMLDivElement>) => void;
 }
-export type TableToolbarActionComponent = ForwardRefReturn<HTMLDivElement, TableToolbarActionProps>;
-declare const TableToolbarAction: TableToolbarActionComponent;
+declare const TableToolbarAction: React.ForwardRefExoticComponent<TableToolbarActionProps & React.RefAttributes<HTMLDivElement>>;
 export default TableToolbarAction;

package/es/components/DataTable/TableToolbarAction.js

@@ -7,14 +7,15 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default from 'react';
+import React__default, { forwardRef } from 'react';
 import OverflowMenuItem from '../OverflowMenuItem/OverflowMenuItem.js';
 
-const TableToolbarAction = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
-  let {
+const frFn = forwardRef;
+const TableToolbarAction = frFn((props, ref) => {
+  const {
     children,
     ...rest
-  } = _ref;
+  } = props;
   return /*#__PURE__*/React__default.createElement(OverflowMenuItem, _extends({
     ref: ref,
     itemText: children

package/es/components/DataTable/tools/sorting.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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 { type DataTableSortState } from '../state/sortStates';
+/**
+ * Compare two values to determine their order. If both values have the same
+ * type, the default sort algorithm will be used for those types. Otherwise, the
+ * values will be converted to strings for comparison.
+ */
+export declare const compare: (a: any, b: any, locale?: string) => number;
+interface Cell {
+    id: string;
+    value: any;
+}
+interface SortRowParams {
+    key: string;
+    sortDirection: DataTableSortState;
+    sortStates: Record<DataTableSortState, DataTableSortState>;
+    locale: string;
+    compare: typeof compare;
+    rowIds: string[];
+}
+interface SortRowsConfig {
+    rowIds: string[];
+    cellsById: Record<string, Cell>;
+    key: string;
+    sortDirection: DataTableSortState;
+    locale?: string;
+    sortRow?: (cellA: any, cellB: any, params: SortRowParams) => number;
+}
+/**
+ * Sorts table rows based on the provided column key and direction.
+ */
+export declare const sortRows: ({ rowIds, cellsById, sortDirection, key, locale, sortRow, }: SortRowsConfig) => string[];
+/**
+ * Sorts table rows based on the sort direction.
+ */
+export declare const defaultSortRow: (cellA: any, cellB: any, { sortDirection, sortStates, locale, }: Pick<SortRowParams, "locale" | "sortDirection" | "sortStates">) => number;
+export {};