@carbon/react 1.81.0-rc.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 {
@@ -37,7 +37,9 @@ const {
   ItemMouseMove,
   InputKeyDownArrowUp,
   InputKeyDownArrowDown,
-  MenuMouseLeave
+  MenuMouseLeave,
+  ItemClick,
+  FunctionSelectItem
 } = useCombobox.stateChangeTypes;
 const defaultItemToString = item => {
   if (typeof item === 'string') {
@@ -208,6 +210,8 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
       prevInputLengthRef.current = inputValue.length;
     }
   }, [typeahead, inputValue, items, itemToString, autocompleteCustomFilter]);
+  const isManualClearingRef = useRef(false);
+  const [isClearing, setIsClearing] = useState(false);
   const prefix = usePrefix();
   const {
     isFluid
@@ -217,6 +221,14 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
   const [isFocused, setIsFocused] = useState(false);
   const prevInputValue = useRef(inputValue);
   const prevSelectedItemProp = useRef(selectedItemProp);
+  useEffect(() => {
+    isManualClearingRef.current = isClearing;
+
+    // Reset flag after render cycle
+    if (isClearing) {
+      setIsClearing(false);
+    }
+  }, [isClearing]);
 
   // fully controlled combobox: handle changes to selectedItemProp
   useEffect(() => {
@@ -302,31 +314,38 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
         }
       case InputKeyDownEnter:
         if (!allowCustomValue) {
-          const highlightedIndex = indexToHighlight(inputValue);
-          const matchingItem = items[highlightedIndex];
-          if (matchingItem) {
-            // Prevent matching items that are marked as `disabled` from
-            // being selected.
-            if (matchingItem.disabled) {
-              return state;
+          if (state.highlightedIndex !== -1) {
+            const filteredList = filterItems(items, itemToString, inputValue);
+            const highlightedItem = filteredList[state.highlightedIndex];
+            if (highlightedItem && !highlightedItem.disabled) {
+              return {
+                ...changes,
+                selectedItem: highlightedItem,
+                inputValue: itemToString(highlightedItem)
+              };
+            }
+          } else {
+            const autoIndex = indexToHighlight(inputValue);
+            if (autoIndex !== -1) {
+              const matchingItem = items[autoIndex];
+              if (matchingItem && !matchingItem.disabled) {
+                return {
+                  ...changes,
+                  selectedItem: matchingItem,
+                  inputValue: itemToString(matchingItem)
+                };
+              }
             }
 
-            // Select the matching item.
-            return {
-              ...changes,
-              selectedItem: matchingItem,
-              inputValue: itemToString(matchingItem)
-            };
-          }
-
-          // If no matching item is found and there is an existing
-          // selection, clear the selection.
-          if (state.selectedItem !== null) {
-            return {
-              ...changes,
-              selectedItem: null,
-              inputValue
-            };
+            // If no matching item is found and there is an existing
+            // selection, clear the selection.
+            if (state.selectedItem !== null) {
+              return {
+                ...changes,
+                selectedItem: null,
+                inputValue
+              };
+            }
           }
         }
 
@@ -491,13 +510,10 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
         type,
         selectedItem: newSelectedItem
       });
-      if (type === useCombobox.stateChangeTypes.ItemClick && !isEqual(selectedItemProp, newSelectedItem)) {
-        onChange({
-          selectedItem: newSelectedItem
-        });
+      if (isManualClearingRef.current) {
+        return;
       }
-      if ((type === useCombobox.stateChangeTypes.FunctionSelectItem || type === useCombobox.stateChangeTypes.InputKeyDownEnter) && !isEqual(selectedItemProp, newSelectedItem) // Only fire if there's an actual change
-      ) {
+      if ((type === ItemClick || type === FunctionSelectItem || type === InputKeyDownEnter) && typeof newSelectedItem !== 'undefined' && !isEqual(selectedItemProp, newSelectedItem)) {
         onChange({
           selectedItem: newSelectedItem
         });
@@ -690,7 +706,13 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     className: `${prefix}--list-box__invalid-icon ${prefix}--list-box__invalid-icon--warning`
   }), inputValue && /*#__PURE__*/React__default.createElement(ListBoxSelection, {
     clearSelection: () => {
+      setIsClearing(true); // This updates the state which syncs to the ref
+      setInputValue('');
+      onChange({
+        selectedItem: null
+      });
       selectItem(null);
+      handleSelectionClear();
     },
     translateWithId: translateWithId,
     disabled: disabled || readOnly,
@@ -884,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
    */