@carbon/react 1.49.0 → 1.50.0-rc.0

package/es/components/Button/Button.js

@@ -90,12 +90,13 @@ const Button = /*#__PURE__*/React__default.forwardRef(function Button(_ref, ref)
   let component = 'button';
   const assistiveId = useId('danger-description');
   const {
-    'aria-pressed': ariaPressed
+    'aria-pressed': ariaPressed,
+    'aria-describedby': ariaDescribedBy
   } = rest;
   let otherProps = {
     disabled,
     type,
-    'aria-describedby': dangerButtonVariants.includes(kind) ? assistiveId : undefined,
+    'aria-describedby': dangerButtonVariants.includes(kind) ? assistiveId : ariaDescribedBy || undefined,
     'aria-pressed': ariaPressed ?? (hasIconOnly && kind === 'ghost' ? isSelected : undefined)
   };
   const anchorProps = {

package/es/components/ComboButton/index.js

@@ -36,6 +36,7 @@ const ComboButton = /*#__PURE__*/React__default.forwardRef(function ComboButton(
     label,
     onClick,
     size = 'lg',
+    menuAlignment = 'bottom',
     tooltipAlignment,
     translateWithId: t = defaultTranslateWithId,
     ...rest
@@ -70,10 +71,15 @@ const ComboButton = /*#__PURE__*/React__default.forwardRef(function ComboButton(
   }
   function handleOpen() {
     menuRef.current.style.inlineSize = `${width}px`;
+    menuRef.current.style.minInlineSize = `${width}px`;
+    if (menuAlignment !== 'bottom' && menuAlignment !== 'top') {
+      menuRef.current.style.inlineSize = `fit-content`;
+    }
   }
   const containerClasses = cx(`${prefix}--combo-button__container`, `${prefix}--combo-button__container--${size}`, {
     [`${prefix}--combo-button__container--open`]: open
   }, className);
+  const menuClasses = cx(`${prefix}--combo-button__${menuAlignment}`);
   const primaryActionClasses = cx(`${prefix}--combo-button__primary-action`);
   const triggerClasses = cx(`${prefix}--combo-button__trigger`);
   return /*#__PURE__*/React__default.createElement("div", _extends({}, rest, {
@@ -83,6 +89,7 @@ const ComboButton = /*#__PURE__*/React__default.forwardRef(function ComboButton(
   }), /*#__PURE__*/React__default.createElement("div", {
     className: primaryActionClasses
   }, /*#__PURE__*/React__default.createElement(Button, {
+    title: label,
     size: size,
     disabled: disabled,
     onClick: handlePrimaryActionClick
@@ -98,6 +105,9 @@ const ComboButton = /*#__PURE__*/React__default.forwardRef(function ComboButton(
     onMouseDown: handleTriggerMousedown,
     "aria-controls": open ? id : null
   }, _ChevronDown || (_ChevronDown = /*#__PURE__*/React__default.createElement(ChevronDown, null))), /*#__PURE__*/React__default.createElement(Menu, {
+    containerRef: containerRef,
+    menuAlignment: menuAlignment,
+    className: menuClasses,
     ref: menuRef,
     id: id,
     label: t('carbon.combo-button.additional-actions'),
@@ -127,6 +137,10 @@ ComboButton.propTypes = {
    * Provide the label to be renderd on the primary action button.
    */
   label: PropTypes.string.isRequired,
+  /**
+   * Experimental property. Specify how the menu should align with the button element
+   */
+  menuAlignment: PropTypes.oneOf(['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end']),
   /**
    * Provide an optional function to be called when the primary action element is clicked.
    */

package/es/components/ContainedList/ContainedList.js

@@ -5,6 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import React__default from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
@@ -44,7 +45,8 @@ function ContainedList(_ref) {
     isInset,
     kind = variants[0],
     label,
-    size
+    size,
+    ...rest
   } = _ref;
   const labelId = `${useId('contained-list')}-header`;
   const prefix = usePrefix();
@@ -57,9 +59,9 @@ function ContainedList(_ref) {
   const filteredChildren = filterChildren(children);
   const isActionSearch = ['Search', 'ExpandableSearch'].includes(action?.type?.displayName);
   const renderedChildren = renderChildren(children);
-  return /*#__PURE__*/React__default.createElement("div", {
+  return /*#__PURE__*/React__default.createElement("div", _extends({
     className: classes
-  }, /*#__PURE__*/React__default.createElement("div", {
+  }, rest), /*#__PURE__*/React__default.createElement("div", {
     className: `${prefix}--contained-list__header`
   }, /*#__PURE__*/React__default.createElement("div", {
     id: labelId,

package/es/components/ContainedList/ContainedListItem/ContainedListItem.js

@@ -5,6 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+import { extends as _extends } from '../../../_virtual/_rollupPluginBabelHelpers.js';
 import React__default from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
@@ -18,7 +19,8 @@ function ContainedListItem(_ref) {
     className,
     disabled = false,
     onClick,
-    renderIcon: IconElement
+    renderIcon: IconElement,
+    ...rest
   } = _ref;
   const prefix = usePrefix();
   const isClickable = onClick !== undefined;
@@ -30,9 +32,9 @@ function ContainedListItem(_ref) {
   const content = /*#__PURE__*/React__default.createElement(React__default.Fragment, null, IconElement && /*#__PURE__*/React__default.createElement("div", {
     className: `${prefix}--contained-list-item__icon`
   }, /*#__PURE__*/React__default.createElement(IconElement, null)), /*#__PURE__*/React__default.createElement("div", null, children));
-  return /*#__PURE__*/React__default.createElement("li", {
+  return /*#__PURE__*/React__default.createElement("li", _extends({
     className: classes
-  }, isClickable ? /*#__PURE__*/React__default.createElement("button", {
+  }, rest), isClickable ? /*#__PURE__*/React__default.createElement("button", {
     className: `${prefix}--contained-list-item__content`,
     type: "button",
     disabled: disabled,

package/es/components/Menu/Menu.d.ts

@@ -4,8 +4,12 @@
  * 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 React, { RefObject } from 'react';
 interface MenuProps extends React.HTMLAttributes<HTMLUListElement> {
+    /**
+     * The ref of the containing element, used for positioning and alignment of the menu
+     */
+    containerRef?: RefObject<HTMLDivElement>;
     /**
      * A collection of MenuItems to be rendered within this Menu.
      */
@@ -18,6 +22,10 @@ interface MenuProps extends React.HTMLAttributes<HTMLUListElement> {
      * A label describing the Menu.
      */
     label?: string;
+    /**
+     * Specify how the menu should align with the button element
+     */
+    menuAlignment?: string;
     /**
      * The mode of this menu. Defaults to full.
      * `full` supports nesting and selectable menu items, but no icons.

package/es/components/Menu/Menu.js

@@ -24,7 +24,9 @@ const Menu = /*#__PURE__*/React__default.forwardRef(function Menu(_ref, forwardR
   let {
     children,
     className,
+    containerRef,
     label,
+    menuAlignment,
     mode = 'full',
     onClose,
     onOpen,
@@ -61,6 +63,15 @@ const Menu = /*#__PURE__*/React__default.forwardRef(function Menu(_ref, forwardR
   const [position, setPosition] = useState([-1, -1]);
   const focusableItems = childContext.state.items.filter(item => !item.disabled && item.ref.current);
 
+  // Getting the width from the parent container element - controlled
+  let actionButtonWidth;
+  if (containerRef?.current) {
+    const {
+      width: w
+    } = containerRef.current.getBoundingClientRect();
+    actionButtonWidth = w;
+  }
+
   // Set RTL based on document direction or `LayoutDirection`
   const {
     direction
@@ -174,6 +185,16 @@ const Menu = /*#__PURE__*/React__default.forwardRef(function Menu(_ref, forwardR
       }
     };
 
+    // Avoid that the Menu render incorrectly when the postion is set in the right side of the screen
+    if (actionButtonWidth && actionButtonWidth < axes.x.size && (menuAlignment === 'bottom' || menuAlignment === 'top')) {
+      axes.x.size = actionButtonWidth;
+    }
+
+    // if 'axes.x.anchor' is lower than 87px dynamically switch render side
+    if (actionButtonWidth && (menuAlignment === 'bottom-end' || menuAlignment === 'top-end') && axes.x.anchor >= 87 && actionButtonWidth < axes.x.size) {
+      const diff = axes.x.anchor + axes.x.reversedAnchor;
+      axes.x.anchor = axes.x.anchor + diff;
+    }
     const {
       max,
       size,
@@ -190,6 +211,14 @@ const Menu = /*#__PURE__*/React__default.forwardRef(function Menu(_ref, forwardR
     reversedAnchor - size >= 0 ? reversedAnchor - size + offset : false,
     // align at max (second fallback)
     max - spacing - size];
+    const topAlignment = menuAlignment === 'top' || menuAlignment === 'top-end' || menuAlignment === 'top-start';
+
+    // If the tooltip is not visible in the top, switch to the bototm
+    if (typeof options[0] === 'number' && topAlignment && options[0] >= 0 && !options[1] && axis === 'y') {
+      menu.current.style.transform = 'translate(0)';
+    } else if (topAlignment && !options[0] && axis === 'y') {
+      options[0] = anchor - offset;
+    }
 
     // Previous array `options`, has at least one item that is a number (the last one - second fallback).
     // That guarantees that the return of `find()` will always be a number
@@ -244,6 +273,7 @@ const Menu = /*#__PURE__*/React__default.forwardRef(function Menu(_ref, forwardR
     // visibility is needed for focusing elements.
     // opacity is only set once the position has been set correctly
     // to avoid a flicker effect when opening.
+    [`${prefix}--menu--box-shadow-top`]: menuAlignment && menuAlignment.slice(0, 3) === 'top',
     [`${prefix}--menu--open`]: open,
     [`${prefix}--menu--shown`]: position[0] >= 0 && position[1] >= 0,
     [`${prefix}--menu--with-icons`]: childContext.state.hasIcons
@@ -274,6 +304,10 @@ Menu.propTypes = {
    * A label describing the Menu.
    */
   label: PropTypes.string,
+  /**
+   * Specify how the menu should align with the button element
+   */
+  menuAlignment: PropTypes.string,
   /**
    * The mode of this menu. Defaults to full.
    * `full` supports nesting and selectable menu items, but no icons.

package/es/components/MenuButton/index.js

@@ -30,6 +30,7 @@ const MenuButton = /*#__PURE__*/React__default.forwardRef(function MenuButton(_r
     kind = defaultButtonKind,
     label,
     size = 'lg',
+    menuAlignment = 'bottom',
     tabIndex = 0,
     ...rest
   } = _ref;
@@ -58,11 +59,16 @@ const MenuButton = /*#__PURE__*/React__default.forwardRef(function MenuButton(_r
   }
   function handleOpen() {
     menuRef.current.style.inlineSize = `${width}px`;
+    menuRef.current.style.minInlineSize = `${width}px`;
+    if (menuAlignment !== 'bottom' && menuAlignment !== 'top') {
+      menuRef.current.style.inlineSize = `fit-content`;
+    }
   }
   const containerClasses = cx(`${prefix}--menu-button__container`, className);
   const triggerClasses = cx(`${prefix}--menu-button__trigger`, {
     [`${prefix}--menu-button__trigger--open`]: open
   });
+  const menuClasses = cx(`${prefix}--menu-button__${menuAlignment}`);
   const buttonKind = validButtonKinds.includes(kind) ? kind : defaultButtonKind;
   return /*#__PURE__*/React__default.createElement("div", _extends({}, rest, {
     ref: ref,
@@ -81,6 +87,9 @@ const MenuButton = /*#__PURE__*/React__default.forwardRef(function MenuButton(_r
     onMouseDown: handleMousedown,
     "aria-controls": open ? id : null
   }, label), /*#__PURE__*/React__default.createElement(Menu, {
+    containerRef: triggerRef,
+    menuAlignment: menuAlignment,
+    className: menuClasses,
     ref: menuRef,
     id: id,
     label: label,
@@ -114,6 +123,10 @@ MenuButton.propTypes = {
    * Provide the label to be renderd on the trigger button.
    */
   label: PropTypes.string.isRequired,
+  /**
+   * Experimental property. Specify how the menu should align with the button element
+   */
+  menuAlignment: PropTypes.oneOf(['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end']),
   /**
    * Specify the size of the button and menu.
    */

package/es/components/MultiSelect/MultiSelect.js

@@ -306,13 +306,14 @@ const MultiSelect = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
       size: 'mini'
     });
   }
+  const itemsSelectedText = selectedItems.length > 0 && selectedItems.map(item => item.text);
   return /*#__PURE__*/React__default.createElement("div", {
     className: wrapperClasses
   }, /*#__PURE__*/React__default.createElement("label", _extends({
     className: titleClasses
   }, getLabelProps()), titleText && titleText, selectedItems.length > 0 && /*#__PURE__*/React__default.createElement("span", {
     className: `${prefix}--visually-hidden`
-  }, clearSelectionDescription, " ", selectedItems.length, ",", clearSelectionText)), /*#__PURE__*/React__default.createElement(ListBox, {
+  }, clearSelectionDescription, " ", selectedItems.length, ' ', itemsSelectedText, ",", clearSelectionText)), /*#__PURE__*/React__default.createElement(ListBox, {
     onFocus: isFluid ? handleFocus : undefined,
     onBlur: isFluid ? handleFocus : undefined,
     type: type,

package/es/components/Notification/Notification.d.ts

@@ -513,3 +513,78 @@ export declare namespace ActionableNotification {
         title: PropTypes.Requireable<string>;
     };
 }
+/**
+ * StaticNotification
+ * ==================
+ */
+export interface StaticNotificationProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Specify the content
+     */
+    children?: ReactNode;
+    /**
+     * Specify an optional className to be applied to the notification box
+     */
+    className?: string;
+    /**
+     * Specify what state the notification represents
+     */
+    kind?: 'error' | 'info' | 'info-square' | 'success' | 'warning' | 'warning-alt';
+    /**
+     * Specify whether you are using the low contrast variant of the StaticNotification.
+     */
+    lowContrast?: boolean;
+    /**
+     * Provide a description for "status" icon that can be read by screen readers
+     */
+    statusIconDescription?: string;
+    /**
+     * Specify the subtitle
+     */
+    subtitle?: string;
+    /**
+     * Specify the title
+     */
+    title?: string;
+    /**
+     * Specify the id for the element containing the title
+     */
+    titleId?: string;
+}
+export declare function StaticNotification({ children, title, titleId, subtitle, statusIconDescription, className, kind, lowContrast, ...rest }: StaticNotificationProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace StaticNotification {
+    var propTypes: {
+        /**
+         * Specify the content
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify an optional className to be applied to the notification box
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify what state the notification represents
+         */
+        kind: PropTypes.Requireable<string>;
+        /**
+         * Specify whether you are using the low contrast variant of the StaticNotification.
+         */
+        lowContrast: PropTypes.Requireable<boolean>;
+        /**
+         * Provide a description for "status" icon that can be read by screen readers
+         */
+        statusIconDescription: PropTypes.Requireable<string>;
+        /**
+         * Specify the subtitle
+         */
+        subtitle: PropTypes.Requireable<string>;
+        /**
+         * Specify the title
+         */
+        title: PropTypes.Requireable<string>;
+        /**
+         * Specify the id for the element containing the title
+         */
+        titleId: PropTypes.Requireable<string>;
+    };
+}

package/es/components/Notification/Notification.js

@@ -15,7 +15,7 @@ import '../Text/index.js';
 import Button from '../Button/Button.js';
 import '../Button/Button.Skeleton.js';
 import useIsomorphicEffect from '../../internal/useIsomorphicEffect.js';
-import { useNoInteractiveChildren } from '../../internal/useNoInteractiveChildren.js';
+import { useNoInteractiveChildren, useInteractiveChildrenNeedDescription } from '../../internal/useNoInteractiveChildren.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { useId } from '../../internal/useId.js';
 import { noopFn } from '../../internal/noopFn.js';
@@ -678,4 +678,86 @@ ActionableNotification.propTypes = {
   title: PropTypes.string
 };
 
-export { ActionableNotification, InlineNotification, NotificationActionButton, NotificationButton, ToastNotification };
+/**
+ * StaticNotification
+ * ==================
+ */
+
+function StaticNotification(_ref8) {
+  let {
+    children,
+    title,
+    titleId,
+    subtitle,
+    statusIconDescription,
+    className,
+    kind = 'error',
+    lowContrast,
+    ...rest
+  } = _ref8;
+  const prefix = usePrefix();
+  const containerClassName = cx(className, {
+    [`${prefix}--inline-notification`]: true,
+    [`${prefix}--inline-notification--low-contrast`]: lowContrast,
+    [`${prefix}--inline-notification--${kind}`]: kind,
+    [`${prefix}--inline-notification--hide-close-button`]: true
+  });
+  const ref = useRef(null);
+  useInteractiveChildrenNeedDescription(ref, `interactive child node(s) should have an \`aria-describedby\` property with a value matching the value of \`titleId\``);
+  return /*#__PURE__*/React__default.createElement("div", _extends({
+    ref: ref
+  }, rest, {
+    className: containerClassName
+  }), /*#__PURE__*/React__default.createElement("div", {
+    className: `${prefix}--inline-notification__details`
+  }, /*#__PURE__*/React__default.createElement(NotificationIcon, {
+    notificationType: "inline",
+    kind: kind,
+    iconDescription: statusIconDescription || `${kind} icon`
+  }), /*#__PURE__*/React__default.createElement("div", {
+    className: `${prefix}--inline-notification__text-wrapper`
+  }, title && /*#__PURE__*/React__default.createElement(Text, {
+    as: "div",
+    id: titleId,
+    className: `${prefix}--inline-notification__title`
+  }, title), subtitle && /*#__PURE__*/React__default.createElement(Text, {
+    as: "div",
+    className: `${prefix}--inline-notification__subtitle`
+  }, subtitle), children)));
+}
+StaticNotification.propTypes = {
+  /**
+   * Specify the content
+   */
+  children: PropTypes.node,
+  /**
+   * Specify an optional className to be applied to the notification box
+   */
+  className: PropTypes.string,
+  /**
+   * Specify what state the notification represents
+   */
+  kind: PropTypes.oneOf(['error', 'info', 'info-square', 'success', 'warning', 'warning-alt']),
+  /**
+   * Specify whether you are using the low contrast variant of the StaticNotification.
+   */
+  lowContrast: PropTypes.bool,
+  /**
+   * Provide a description for "status" icon that can be read by screen readers
+   */
+  statusIconDescription: PropTypes.string,
+  /**
+   * Specify the subtitle
+   */
+  subtitle: PropTypes.string,
+  /**
+   * Specify the title
+   */
+  title: PropTypes.string,
+  /**
+   * Specify the id for the element containing the title
+   */
+  titleId: PropTypes.string
+};
+
+export { ActionableNotification, InlineNotification, NotificationActionButton, NotificationButton, StaticNotification, ToastNotification };

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

@@ -4,4 +4,4 @@
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export { NotificationActionButton, type NotificationActionButtonProps, NotificationButton, type NotificationButtonProps, ToastNotification, type ToastNotificationProps, InlineNotification, type InlineNotificationProps, ActionableNotification, type ActionableNotificationProps, } from './Notification';
+export { NotificationActionButton, type NotificationActionButtonProps, NotificationButton, type NotificationButtonProps, ToastNotification, type ToastNotificationProps, InlineNotification, type InlineNotificationProps, ActionableNotification, type ActionableNotificationProps, StaticNotification, type StaticNotificationProps, } from './Notification';

package/es/components/OverflowMenu/next/index.js

@@ -25,6 +25,7 @@ const OverflowMenu = /*#__PURE__*/React__default.forwardRef(function OverflowMen
     label = 'Options',
     renderIcon: IconElement = OverflowMenuVertical,
     size = defaultSize,
+    menuAlignment = 'bottom-start',
     tooltipAlignment,
     ...rest
   } = _ref;
@@ -35,11 +36,17 @@ const OverflowMenu = /*#__PURE__*/React__default.forwardRef(function OverflowMen
     open,
     x,
     y,
-    handleClick,
+    handleClick: hookOnClick,
     handleMousedown,
     handleClose
   } = useAttachedMenu(triggerRef);
+  function handleTriggerClick() {
+    if (triggerRef.current) {
+      hookOnClick();
+    }
+  }
   const containerClasses = cx(className, `${prefix}--overflow-menu__container`);
+  const menuClasses = cx(`${prefix}--overflow-menu__${menuAlignment}`);
   const triggerClasses = cx(`${prefix}--overflow-menu`, {
     [`${prefix}--overflow-menu--open`]: open
   }, size !== defaultSize && `${prefix}--overflow-menu--${size}`);
@@ -52,7 +59,7 @@ const OverflowMenu = /*#__PURE__*/React__default.forwardRef(function OverflowMen
     "aria-haspopup": true,
     "aria-expanded": open,
     className: triggerClasses,
-    onClick: handleClick,
+    onClick: handleTriggerClick,
     onMouseDown: handleMousedown,
     ref: triggerRef,
     label: label,
@@ -60,6 +67,9 @@ const OverflowMenu = /*#__PURE__*/React__default.forwardRef(function OverflowMen
   }, /*#__PURE__*/React__default.createElement(IconElement, {
     className: `${prefix}--overflow-menu__icon`
   })), /*#__PURE__*/React__default.createElement(Menu, {
+    containerRef: triggerRef,
+    menuAlignment: menuAlignment,
+    className: menuClasses,
     id: id,
     size: size,
     open: open,
@@ -82,6 +92,10 @@ OverflowMenu.propTypes = {
    * A label describing the options available. Is used in the trigger tooltip and as the menu's accessible label.
    */
   label: PropTypes.string,
+  /**
+   * Experimental property. Specify how the menu should align with the button element
+   */
+  menuAlignment: PropTypes.oneOf(['top-start', 'top-end', 'bottom-start', 'bottom-end']),
   /**
    * Otionally provide a custom icon to be rendered on the trigger button.
    */

package/es/index.js

@@ -65,7 +65,7 @@ export { MenuItem, MenuItemDivider, MenuItemGroup, MenuItemRadioGroup, MenuItemS
 export { MenuButton } from './components/MenuButton/index.js';
 export { default as Modal } from './components/Modal/Modal.js';
 export { default as ModalWrapper } from './components/ModalWrapper/ModalWrapper.js';
-export { ActionableNotification, InlineNotification, NotificationActionButton, NotificationButton, ToastNotification } from './components/Notification/Notification.js';
+export { ActionableNotification, InlineNotification, NotificationActionButton, NotificationButton, StaticNotification, ToastNotification } from './components/Notification/Notification.js';
 export { default as NumberInputSkeleton } from './components/NumberInput/NumberInput.Skeleton.js';
 export { NumberInput } from './components/NumberInput/NumberInput.js';
 export { default as OrderedList } from './components/OrderedList/OrderedList.js';

package/es/internal/useNoInteractiveChildren.js

@@ -19,6 +19,18 @@ function useNoInteractiveChildren(ref) {
     });
   }
 }
+function useInteractiveChildrenNeedDescription(ref) {
+  let message = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : `interactive child node(s) should have an \`aria-describedby\` property`;
+  if (process.env.NODE_ENV !== "production") {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    useEffect(() => {
+      const node = ref.current ? getInteractiveContent(ref.current) : false;
+      if (node && !node.hasAttribute('aria-describedby')) {
+        throw new Error(`Error: ${message}.\n\nInstead found: ${node.outerHTML}`);
+      }
+    });
+  }
+}
 
 /**
  * Determines if a given DOM node has interactive content, or is itself
@@ -90,4 +102,4 @@ function isFocusable(element) {
   }
 }
 
-export { getInteractiveContent, getRoleContent, useNoInteractiveChildren };
+export { getInteractiveContent, getRoleContent, useInteractiveChildrenNeedDescription, useNoInteractiveChildren };

package/lib/components/Button/Button.js

@@ -100,12 +100,13 @@ const Button = /*#__PURE__*/React__default["default"].forwardRef(function Button
   let component = 'button';
   const assistiveId = useId.useId('danger-description');
   const {
-    'aria-pressed': ariaPressed
+    'aria-pressed': ariaPressed,
+    'aria-describedby': ariaDescribedBy
   } = rest;
   let otherProps = {
     disabled,
     type,
-    'aria-describedby': dangerButtonVariants.includes(kind) ? assistiveId : undefined,
+    'aria-describedby': dangerButtonVariants.includes(kind) ? assistiveId : ariaDescribedBy || undefined,
     'aria-pressed': ariaPressed ?? (hasIconOnly && kind === 'ghost' ? isSelected : undefined)
   };
   const anchorProps = {

package/lib/components/ComboButton/index.js

@@ -46,6 +46,7 @@ const ComboButton = /*#__PURE__*/React__default["default"].forwardRef(function C
     label,
     onClick,
     size = 'lg',
+    menuAlignment = 'bottom',
     tooltipAlignment,
     translateWithId: t = defaultTranslateWithId,
     ...rest
@@ -80,10 +81,15 @@ const ComboButton = /*#__PURE__*/React__default["default"].forwardRef(function C
   }
   function handleOpen() {
     menuRef.current.style.inlineSize = `${width}px`;
+    menuRef.current.style.minInlineSize = `${width}px`;
+    if (menuAlignment !== 'bottom' && menuAlignment !== 'top') {
+      menuRef.current.style.inlineSize = `fit-content`;
+    }
   }
   const containerClasses = cx__default["default"](`${prefix}--combo-button__container`, `${prefix}--combo-button__container--${size}`, {
     [`${prefix}--combo-button__container--open`]: open
   }, className);
+  const menuClasses = cx__default["default"](`${prefix}--combo-button__${menuAlignment}`);
   const primaryActionClasses = cx__default["default"](`${prefix}--combo-button__primary-action`);
   const triggerClasses = cx__default["default"](`${prefix}--combo-button__trigger`);
   return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, rest, {
@@ -93,6 +99,7 @@ const ComboButton = /*#__PURE__*/React__default["default"].forwardRef(function C
   }), /*#__PURE__*/React__default["default"].createElement("div", {
     className: primaryActionClasses
   }, /*#__PURE__*/React__default["default"].createElement(Button["default"], {
+    title: label,
     size: size,
     disabled: disabled,
     onClick: handlePrimaryActionClick
@@ -108,6 +115,9 @@ const ComboButton = /*#__PURE__*/React__default["default"].forwardRef(function C
     onMouseDown: handleTriggerMousedown,
     "aria-controls": open ? id : null
   }, _ChevronDown || (_ChevronDown = /*#__PURE__*/React__default["default"].createElement(iconsReact.ChevronDown, null))), /*#__PURE__*/React__default["default"].createElement(Menu.Menu, {
+    containerRef: containerRef,
+    menuAlignment: menuAlignment,
+    className: menuClasses,
     ref: menuRef,
     id: id,
     label: t('carbon.combo-button.additional-actions'),
@@ -137,6 +147,10 @@ ComboButton.propTypes = {
    * Provide the label to be renderd on the primary action button.
    */
   label: PropTypes__default["default"].string.isRequired,
+  /**
+   * Experimental property. Specify how the menu should align with the button element
+   */
+  menuAlignment: PropTypes__default["default"].oneOf(['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end']),
   /**
    * Provide an optional function to be called when the primary action element is clicked.
    */

package/lib/components/ContainedList/ContainedList.js

@@ -9,6 +9,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
 var React = require('react');
 var PropTypes = require('prop-types');
 var cx = require('classnames');
@@ -54,7 +55,8 @@ function ContainedList(_ref) {
     isInset,
     kind = variants[0],
     label,
-    size
+    size,
+    ...rest
   } = _ref;
   const labelId = `${useId.useId('contained-list')}-header`;
   const prefix = usePrefix.usePrefix();
@@ -67,9 +69,9 @@ function ContainedList(_ref) {
   const filteredChildren = filterChildren(children);
   const isActionSearch = ['Search', 'ExpandableSearch'].includes(action?.type?.displayName);
   const renderedChildren = renderChildren(children);
-  return /*#__PURE__*/React__default["default"].createElement("div", {
+  return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({
     className: classes
-  }, /*#__PURE__*/React__default["default"].createElement("div", {
+  }, rest), /*#__PURE__*/React__default["default"].createElement("div", {
     className: `${prefix}--contained-list__header`
   }, /*#__PURE__*/React__default["default"].createElement("div", {
     id: labelId,