@carbon/react 1.49.0 → 1.50.0-rc.0

package/lib/components/ContainedList/ContainedListItem/ContainedListItem.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');
@@ -28,7 +29,8 @@ function ContainedListItem(_ref) {
     className,
     disabled = false,
     onClick,
-    renderIcon: IconElement
+    renderIcon: IconElement,
+    ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
   const isClickable = onClick !== undefined;
@@ -40,9 +42,9 @@ function ContainedListItem(_ref) {
   const content = /*#__PURE__*/React__default["default"].createElement(React__default["default"].Fragment, null, IconElement && /*#__PURE__*/React__default["default"].createElement("div", {
     className: `${prefix}--contained-list-item__icon`
   }, /*#__PURE__*/React__default["default"].createElement(IconElement, null)), /*#__PURE__*/React__default["default"].createElement("div", null, children));
-  return /*#__PURE__*/React__default["default"].createElement("li", {
+  return /*#__PURE__*/React__default["default"].createElement("li", _rollupPluginBabelHelpers["extends"]({
     className: classes
-  }, isClickable ? /*#__PURE__*/React__default["default"].createElement("button", {
+  }, rest), isClickable ? /*#__PURE__*/React__default["default"].createElement("button", {
     className: `${prefix}--contained-list-item__content`,
     type: "button",
     disabled: disabled,

package/lib/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/lib/components/Menu/Menu.js

@@ -34,7 +34,9 @@ const Menu = /*#__PURE__*/React__default["default"].forwardRef(function Menu(_re
   let {
     children,
     className,
+    containerRef,
     label,
+    menuAlignment,
     mode = 'full',
     onClose,
     onOpen,
@@ -71,6 +73,15 @@ const Menu = /*#__PURE__*/React__default["default"].forwardRef(function Menu(_re
   const [position, setPosition] = React.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
@@ -184,6 +195,16 @@ const Menu = /*#__PURE__*/React__default["default"].forwardRef(function Menu(_re
       }
     };
 
+    // 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,
@@ -200,6 +221,14 @@ const Menu = /*#__PURE__*/React__default["default"].forwardRef(function Menu(_re
     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
@@ -254,6 +283,7 @@ const Menu = /*#__PURE__*/React__default["default"].forwardRef(function Menu(_re
     // 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
@@ -284,6 +314,10 @@ Menu.propTypes = {
    * A label describing the Menu.
    */
   label: PropTypes__default["default"].string,
+  /**
+   * Specify how the menu should align with the button element
+   */
+  menuAlignment: PropTypes__default["default"].string,
   /**
    * The mode of this menu. Defaults to full.
    * `full` supports nesting and selectable menu items, but no icons.

package/lib/components/MenuButton/index.js

@@ -40,6 +40,7 @@ const MenuButton = /*#__PURE__*/React__default["default"].forwardRef(function Me
     kind = defaultButtonKind,
     label,
     size = 'lg',
+    menuAlignment = 'bottom',
     tabIndex = 0,
     ...rest
   } = _ref;
@@ -68,11 +69,16 @@ const MenuButton = /*#__PURE__*/React__default["default"].forwardRef(function Me
   }
   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}--menu-button__container`, className);
   const triggerClasses = cx__default["default"](`${prefix}--menu-button__trigger`, {
     [`${prefix}--menu-button__trigger--open`]: open
   });
+  const menuClasses = cx__default["default"](`${prefix}--menu-button__${menuAlignment}`);
   const buttonKind = validButtonKinds.includes(kind) ? kind : defaultButtonKind;
   return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, rest, {
     ref: ref,
@@ -91,6 +97,9 @@ const MenuButton = /*#__PURE__*/React__default["default"].forwardRef(function Me
     onMouseDown: handleMousedown,
     "aria-controls": open ? id : null
   }, label), /*#__PURE__*/React__default["default"].createElement(Menu.Menu, {
+    containerRef: triggerRef,
+    menuAlignment: menuAlignment,
+    className: menuClasses,
     ref: menuRef,
     id: id,
     label: label,
@@ -124,6 +133,10 @@ MenuButton.propTypes = {
    * Provide the label to be renderd on the trigger 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']),
   /**
    * Specify the size of the button and menu.
    */

package/lib/components/MultiSelect/MultiSelect.js

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

package/lib/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/lib/components/Notification/Notification.js

@@ -688,8 +688,91 @@ ActionableNotification.propTypes = {
   title: PropTypes__default["default"].string
 };
 
+/**
+ * StaticNotification
+ * ==================
+ */
+
+function StaticNotification(_ref8) {
+  let {
+    children,
+    title,
+    titleId,
+    subtitle,
+    statusIconDescription,
+    className,
+    kind = 'error',
+    lowContrast,
+    ...rest
+  } = _ref8;
+  const prefix = usePrefix.usePrefix();
+  const containerClassName = cx__default["default"](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 = React.useRef(null);
+  useNoInteractiveChildren.useInteractiveChildrenNeedDescription(ref, `interactive child node(s) should have an \`aria-describedby\` property with a value matching the value of \`titleId\``);
+  return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({
+    ref: ref
+  }, rest, {
+    className: containerClassName
+  }), /*#__PURE__*/React__default["default"].createElement("div", {
+    className: `${prefix}--inline-notification__details`
+  }, /*#__PURE__*/React__default["default"].createElement(NotificationIcon, {
+    notificationType: "inline",
+    kind: kind,
+    iconDescription: statusIconDescription || `${kind} icon`
+  }), /*#__PURE__*/React__default["default"].createElement("div", {
+    className: `${prefix}--inline-notification__text-wrapper`
+  }, title && /*#__PURE__*/React__default["default"].createElement(Text.Text, {
+    as: "div",
+    id: titleId,
+    className: `${prefix}--inline-notification__title`
+  }, title), subtitle && /*#__PURE__*/React__default["default"].createElement(Text.Text, {
+    as: "div",
+    className: `${prefix}--inline-notification__subtitle`
+  }, subtitle), children)));
+}
+StaticNotification.propTypes = {
+  /**
+   * Specify the content
+   */
+  children: PropTypes__default["default"].node,
+  /**
+   * Specify an optional className to be applied to the notification box
+   */
+  className: PropTypes__default["default"].string,
+  /**
+   * Specify what state the notification represents
+   */
+  kind: PropTypes__default["default"].oneOf(['error', 'info', 'info-square', 'success', 'warning', 'warning-alt']),
+  /**
+   * Specify whether you are using the low contrast variant of the StaticNotification.
+   */
+  lowContrast: PropTypes__default["default"].bool,
+  /**
+   * Provide a description for "status" icon that can be read by screen readers
+   */
+  statusIconDescription: PropTypes__default["default"].string,
+  /**
+   * Specify the subtitle
+   */
+  subtitle: PropTypes__default["default"].string,
+  /**
+   * Specify the title
+   */
+  title: PropTypes__default["default"].string,
+  /**
+   * Specify the id for the element containing the title
+   */
+  titleId: PropTypes__default["default"].string
+};
+
 exports.ActionableNotification = ActionableNotification;
 exports.InlineNotification = InlineNotification;
 exports.NotificationActionButton = NotificationActionButton;
 exports.NotificationButton = NotificationButton;
+exports.StaticNotification = StaticNotification;
 exports.ToastNotification = ToastNotification;

package/lib/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/lib/components/OverflowMenu/next/index.js

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

package/lib/index.js

@@ -300,6 +300,7 @@ exports.ActionableNotification = Notification.ActionableNotification;
 exports.InlineNotification = Notification.InlineNotification;
 exports.NotificationActionButton = Notification.NotificationActionButton;
 exports.NotificationButton = Notification.NotificationButton;
+exports.StaticNotification = Notification.StaticNotification;
 exports.ToastNotification = Notification.ToastNotification;
 exports.NumberInputSkeleton = NumberInput_Skeleton["default"];
 exports.NumberInput = NumberInput.NumberInput;

package/lib/internal/useNoInteractiveChildren.js

@@ -23,6 +23,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
+    React.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
@@ -96,4 +108,5 @@ function isFocusable(element) {
 
 exports.getInteractiveContent = getInteractiveContent;
 exports.getRoleContent = getRoleContent;
+exports.useInteractiveChildrenNeedDescription = useInteractiveChildrenNeedDescription;
 exports.useNoInteractiveChildren = useNoInteractiveChildren;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/react",
   "description": "React components for the Carbon Design System",
-  "version": "1.49.0",
+  "version": "1.50.0-rc.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -49,9 +49,9 @@
   "dependencies": {
     "@babel/runtime": "^7.18.3",
     "@carbon/feature-flags": "^0.16.0",
-    "@carbon/icons-react": "^11.35.0",
+    "@carbon/icons-react": "^11.36.0-rc.0",
     "@carbon/layout": "^11.20.0",
-    "@carbon/styles": "^1.49.0",
+    "@carbon/styles": "^1.50.0-rc.0",
     "@ibm/telemetry-js": "^1.2.0",
     "classnames": "2.5.1",
     "copy-to-clipboard": "^3.3.1",
@@ -139,5 +139,5 @@
     "**/*.scss",
     "**/*.css"
   ],
-  "gitHead": "741ec54a40159b2438b2b09bf55c013bbff2c4ad"
+  "gitHead": "fbec0e13b29a1c9b19ed22a1ae9b6f87107ba920"
 }