@carbon/react 1.52.0 → 1.53.0

package/es/components/Accordion/AccordionItem.js

@@ -45,7 +45,7 @@ function AccordionItem(_ref) {
   const prefix = usePrefix();
   const className = cx({
     [`${prefix}--accordion__item`]: true,
-    [`${prefix}--accordion__item--active`]: isOpen,
+    [`${prefix}--accordion__item--active`]: isOpen && !disabled,
     [`${prefix}--accordion__item--disabled`]: disabled,
     [customClassName]: !!customClassName
   });

package/es/components/CodeSnippet/CodeSnippet.js

@@ -24,7 +24,7 @@ const rowHeightInPixels = 16;
 const defaultMaxCollapsedNumberOfRows = 15;
 const defaultMaxExpandedNumberOfRows = 0;
 const defaultMinCollapsedNumberOfRows = 3;
-const defaultMinExpandedNumberOfRows = 16;
+const defaultMinExpandedNumberOfRows = 0;
 function CodeSnippet(_ref) {
   let {
     align = 'bottom',
@@ -101,7 +101,7 @@ function CodeSnippet(_ref) {
       if (codeContentRef?.current && type === 'multi') {
         const {
           height
-        } = codeContentRef.current.getBoundingClientRect();
+        } = innerCodeRef.current.getBoundingClientRect();
         if (maxCollapsedNumberOfRows > 0 && (maxExpandedNumberOfRows <= 0 || maxExpandedNumberOfRows > maxCollapsedNumberOfRows) && height > maxCollapsedNumberOfRows * rowHeightInPixels) {
           setShouldShowMoreLessBtn(true);
         } else {

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

@@ -0,0 +1,74 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import PropTypes from 'prop-types';
+import React, { AnimationEventHandler, MouseEventHandler, PropsWithChildren } from 'react';
+interface CopyProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     * Specify how the trigger should align with the tooltip
+     */
+    align?: 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
+    /**
+     * Specify an optional className to be applied to the underlying `<button>`
+     */
+    className?: string;
+    /**
+     * Specify the string that is displayed when the button is clicked and the
+     * content is copied
+     */
+    feedback?: string;
+    /**
+     * Specify the time it takes for the feedback message to timeout
+     */
+    feedbackTimeout?: number;
+    /**
+     * Specify an optional `onAnimationEnd` handler that is called when the underlying
+     * animation ends
+     */
+    onAnimationEnd?: AnimationEventHandler<HTMLButtonElement>;
+    /**
+     * Specify an optional `onClick` handler that is called when the underlying
+     * `<button>` is clicked
+     */
+    onClick?: MouseEventHandler<HTMLButtonElement>;
+}
+declare function Copy({ align, children, className, feedback, feedbackTimeout, onAnimationEnd, onClick, ...other }: PropsWithChildren<CopyProps>): import("react/jsx-runtime").JSX.Element;
+declare namespace Copy {
+    var propTypes: {
+        /**
+         * Specify how the trigger should align with the tooltip
+         */
+        align: PropTypes.Requireable<string>;
+        /**
+         * Pass in content to be rendered in the underlying `<button>`
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify an optional className to be applied to the underlying `<button>`
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify the string that is displayed when the button is clicked and the
+         * content is copied
+         */
+        feedback: PropTypes.Requireable<string>;
+        /**
+         * Specify the time it takes for the feedback message to timeout
+         */
+        feedbackTimeout: PropTypes.Requireable<number>;
+        /**
+         * Specify an optional `onAnimationEnd` handler that is called when the underlying
+         * animation ends
+         */
+        onAnimationEnd: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Specify an optional `onClick` handler that is called when the underlying
+         * `<button>` is clicked
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+}
+export default Copy;

package/es/components/Copy/Copy.js

@@ -57,7 +57,7 @@ function Copy(_ref) {
     onClick: composeEventHandlers([onClick, handleClick]),
     onAnimationEnd: composeEventHandlers([onAnimationEnd, handleAnimationEnd])
   }, other, {
-    "aria-label": !children && (animation ? feedback : other['aria-label']) || null
+    "aria-label": !children && (animation ? feedback : other['aria-label']) || undefined
   }), children);
 }
 Copy.propTypes = {

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

@@ -0,0 +1,9 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * 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 Copy from './Copy';
+export default Copy;
+export { Copy };

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

@@ -0,0 +1,71 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import PropTypes from 'prop-types';
+import { MouseEventHandler } from 'react';
+import { ButtonProps } from '../Button';
+export interface CopyButtonProps extends ButtonProps<'button'> {
+    /**
+     * Specify how the trigger should align with the tooltip
+     */
+    align?: 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
+    /**
+     * Specify an optional className to be applied to the underlying `<button>`
+     */
+    className?: string;
+    /**
+     * Specify the string that is displayed when the button is clicked and the
+     * content is copied
+     */
+    feedback?: string;
+    /**
+     * Specify the time it takes for the feedback message to timeout
+     */
+    feedbackTimeout?: number;
+    /**
+     * Provide a description for the icon representing the copy action that can
+     * be read by screen readers
+     */
+    iconDescription?: string;
+    /**
+     * Specify an optional `onClick` handler that is called when the underlying
+     * `<button>` is clicked
+     */
+    onClick?: MouseEventHandler<HTMLButtonElement>;
+}
+declare function CopyButton({ align, feedback, feedbackTimeout, iconDescription, className, onClick, ...other }: CopyButtonProps): import("react/jsx-runtime").JSX.Element;
+declare namespace CopyButton {
+    var propTypes: {
+        /**
+         * Specify how the trigger should align with the tooltip
+         */
+        align: PropTypes.Requireable<string>;
+        /**
+         * Specify an optional className to be applied to the underlying `<button>`
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify the string that is displayed when the button is clicked and the
+         * content is copied
+         */
+        feedback: PropTypes.Requireable<string>;
+        /**
+         * Specify the time it takes for the feedback message to timeout
+         */
+        feedbackTimeout: PropTypes.Requireable<number>;
+        /**
+         * Provide a description for the icon representing the copy action that can
+         * be read by screen readers
+         */
+        iconDescription: PropTypes.Requireable<string>;
+        /**
+         * Specify an optional `onClick` handler that is called when the underlying
+         * `<button>` is clicked
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+}
+export default CopyButton;

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

@@ -0,0 +1,9 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * 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 CopyButton from './CopyButton';
+export default CopyButton;
+export { CopyButton };

package/es/components/Dropdown/Dropdown.Skeleton.d.ts

@@ -8,6 +8,17 @@ import React from 'react';
 import { ListBoxSize } from '../ListBox';
 import { ReactAttr } from '../../types/common';
 export interface DropdownSkeletonProps extends ReactAttr<HTMLDivElement> {
+    /**
+     * Specify an optional className to add.
+     */
+    className?: string;
+    /**
+     * Specify whether the label should be hidden, or not
+     */
+    hideLabel?: boolean;
+    /**
+     * Specify the size of the ListBox.
+     */
     size?: ListBoxSize;
 }
 declare const DropdownSkeleton: React.FC<DropdownSkeletonProps>;

package/es/components/Dropdown/Dropdown.Skeleton.js

@@ -17,25 +17,30 @@ const DropdownSkeleton = _ref => {
   let {
     className,
     size,
+    hideLabel,
     ...rest
   } = _ref;
   const prefix = usePrefix();
-  const wrapperClasses = cx(className, `${prefix}--skeleton`, `${prefix}--dropdown-v2`, `${prefix}--list-box`, `${prefix}--form-item`, {
+  const wrapperClasses = cx(className, `${prefix}--skeleton`, `${prefix}--form-item`, {
     [`${prefix}--list-box--${size}`]: size
   });
   return /*#__PURE__*/React__default.createElement("div", _extends({
     className: wrapperClasses
-  }, rest), /*#__PURE__*/React__default.createElement("div", {
-    className: `${prefix}--list-box__field`
-  }, /*#__PURE__*/React__default.createElement("span", {
-    className: `${prefix}--list-box__label`
-  })));
+  }, rest), !hideLabel && /*#__PURE__*/React__default.createElement("span", {
+    className: `${prefix}--label ${prefix}--skeleton`
+  }), /*#__PURE__*/React__default.createElement("div", {
+    className: `${prefix}--skeleton ${prefix}--dropdown`
+  }));
 };
 DropdownSkeleton.propTypes = {
   /**
    * Specify an optional className to add.
    */
   className: PropTypes.string,
+  /**
+   * Specify whether the label should be hidden, or not
+   */
+  hideLabel: PropTypes.bool,
   /**
    * Specify the size of the ListBox.
    */

package/es/components/FileUploader/FileUploaderItem.d.ts

@@ -53,7 +53,7 @@ export interface FileUploaderItemProps extends ReactAttr<HTMLSpanElement> {
      */
     uuid?: string;
 }
-declare function FileUploaderItem({ uuid, name, status, iconDescription, onDelete, invalid, errorSubject, errorBody, size, ...other }: FileUploaderItemProps): import("react/jsx-runtime").JSX.Element;
+declare function FileUploaderItem({ uuid, name, status, iconDescription, onDelete, invalid, errorSubject, errorBody, size, className, ...other }: FileUploaderItemProps): import("react/jsx-runtime").JSX.Element;
 declare namespace FileUploaderItem {
     var propTypes: {
         /**

package/es/components/FileUploader/FileUploaderItem.js

@@ -31,6 +31,7 @@ function FileUploaderItem(_ref) {
     errorSubject,
     errorBody,
     size,
+    className,
     ...other
   } = _ref;
   const [isEllipsisApplied, setIsEllipsisApplied] = useState(false);
@@ -38,7 +39,7 @@ function FileUploaderItem(_ref) {
   const {
     current: id
   } = useRef(uuid || uniqueId());
-  const classes = cx(`${prefix}--file__selected-file`, {
+  const classes = cx(`${prefix}--file__selected-file`, className, {
     [`${prefix}--file__selected-file--invalid`]: invalid,
     [`${prefix}--file__selected-file--md`]: size === 'md',
     [`${prefix}--file__selected-file--sm`]: size === 'sm'

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

@@ -549,7 +549,7 @@ export interface StaticNotificationProps extends HTMLAttributes<HTMLDivElement>
     /**
      * Specify the subtitle
      */
-    subtitle?: string;
+    subtitle?: ReactNode;
     /**
      * Specify the title
      */
@@ -593,7 +593,7 @@ export declare namespace StaticNotification {
         /**
          * Specify the subtitle
          */
-        subtitle: PropTypes.Requireable<string>;
+        subtitle: PropTypes.Requireable<PropTypes.ReactNodeLike>;
         /**
          * Specify the title
          */

package/es/components/Notification/Notification.js

@@ -729,6 +729,7 @@ function StaticNotification(_ref8) {
     className: `${prefix}--actionable-notification__button-wrapper`
   }, actionButtonLabel && /*#__PURE__*/React__default.createElement(NotificationActionButton, {
     onClick: onActionButtonClick,
+    "aria-describedby": titleId,
     inline: true
   }, actionButtonLabel)));
 }
@@ -764,7 +765,7 @@ StaticNotification.propTypes = {
   /**
    * Specify the subtitle
    */
-  subtitle: PropTypes.string,
+  subtitle: PropTypes.node,
   /**
    * Specify the title
    */

package/es/components/OverflowMenu/OverflowMenu.js

@@ -118,6 +118,9 @@ class OverflowMenu extends Component {
       const {
         onClick = noopFn
       } = this.props;
+      this.setState({
+        click: true
+      });
       evt.stopPropagation();
       if (!this._menuBody || !this._menuBody.contains(evt.target)) {
         this.setState({
@@ -127,6 +130,15 @@ class OverflowMenu extends Component {
       }
     });
     _defineProperty(this, "closeMenuAndFocus", () => {
+      let wasClicked = this.state.click;
+      let wasOpen = this.state.open;
+      this.closeMenu(() => {
+        if (wasOpen && !wasClicked) {
+          this.focusMenuEl();
+        }
+      });
+    });
+    _defineProperty(this, "closeMenuOnEscape", () => {
       let wasOpen = this.state.open;
       this.closeMenu(() => {
         if (wasOpen) {
@@ -141,7 +153,7 @@ class OverflowMenu extends Component {
 
       // Close the overflow menu on escape
       if (matches(evt, [Escape])) {
-        this.closeMenuAndFocus();
+        this.closeMenuOnEscape();
 
         // Stop the esc keypress from bubbling out and closing something it shouldn't
         evt.stopPropagation();

package/es/components/RadioTile/RadioTile.js

@@ -6,7 +6,7 @@
  */
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { CheckmarkFilled } from '@carbon/icons-react';
+import { RadioButtonChecked, RadioButton, CheckmarkFilled } from '@carbon/icons-react';
 import cx from 'classnames';
 import PropTypes from 'prop-types';
 import React__default from 'react';
@@ -15,11 +15,12 @@ import { usePrefix } from '../../internal/usePrefix.js';
 import deprecate from '../../prop-types/deprecate.js';
 import { noopFn } from '../../internal/noopFn.js';
 import '../Text/index.js';
+import { useFeatureFlag } from '../FeatureFlags/index.js';
 import { Text } from '../Text/Text.js';
 import { matches } from '../../internal/keyboard/match.js';
 import { Enter, Space } from '../../internal/keyboard/keys.js';
 
-var _CheckmarkFilled;
+var _RadioButtonChecked, _RadioButton, _CheckmarkFilled;
 const RadioTile = /*#__PURE__*/React__default.forwardRef(function RadioTile(_ref, ref) {
   let {
     children,
@@ -42,6 +43,18 @@ const RadioTile = /*#__PURE__*/React__default.forwardRef(function RadioTile(_ref
     [`${prefix}--tile--light`]: light,
     [`${prefix}--tile--disabled`]: disabled
   });
+  const v12TileRadioIcons = useFeatureFlag('enable-v12-tile-radio-icons');
+  function icon() {
+    if (v12TileRadioIcons) {
+      if (checked) {
+        return _RadioButtonChecked || (_RadioButtonChecked = /*#__PURE__*/React__default.createElement(RadioButtonChecked, null));
+      } else {
+        return _RadioButton || (_RadioButton = /*#__PURE__*/React__default.createElement(RadioButton, null));
+      }
+    } else {
+      return _CheckmarkFilled || (_CheckmarkFilled = /*#__PURE__*/React__default.createElement(CheckmarkFilled, null));
+    }
+  }
   function handleOnChange(evt) {
     onChange(value, name, evt);
   }
@@ -68,7 +81,7 @@ const RadioTile = /*#__PURE__*/React__default.forwardRef(function RadioTile(_ref
     className: className
   }), /*#__PURE__*/React__default.createElement("span", {
     className: `${prefix}--tile__checkmark`
-  }, _CheckmarkFilled || (_CheckmarkFilled = /*#__PURE__*/React__default.createElement(CheckmarkFilled, null))), /*#__PURE__*/React__default.createElement(Text, {
+  }, icon()), /*#__PURE__*/React__default.createElement(Text, {
     className: `${prefix}--tile-content`
   }, children)));
 });

package/es/components/Tag/DismissibleTag.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import PropTypes, { ReactNodeLike } from 'prop-types';
+import React from 'react';
+import { PolymorphicProps } from '../../types/common';
+import { SIZES, TYPES } from './Tag';
+export interface DismissibleTagBaseProps {
+    /**
+     * Provide content to be rendered inside of a `DismissibleTag`
+     */
+    children?: React.ReactNode;
+    /**
+     * Provide a custom className that is applied to the containing <span>
+     */
+    className?: string;
+    /**
+     * Specify if the `DismissibleTag` is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify the id for the selectabletag.
+     */
+    id?: string;
+    /**
+     * Click handler for filter tag close button.
+     */
+    onClose?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * Optional prop to render a custom icon.
+     * Can be a React component class
+     */
+    renderIcon?: React.ElementType;
+    /**
+     * Specify the size of the Tag. Currently supports either `sm`,
+     * `md` (default) or `lg` sizes.
+     */
+    size?: keyof typeof SIZES;
+    /**
+     * **Experimental:** Provide a `Slug` component to be rendered inside the `DismissibleTag` component
+     */
+    slug?: ReactNodeLike;
+    /**
+     * Text to show on clear filters
+     */
+    title?: string;
+    /**
+     * Specify the type of the `Tag`
+     */
+    type?: keyof typeof TYPES;
+}
+export type DismissibleTagProps<T extends React.ElementType> = PolymorphicProps<T, DismissibleTagBaseProps>;
+declare const DismissibleTag: {
+    <T extends React.ElementType<any>>({ children, className, disabled, id, renderIcon, title, onClose, slug, size, type, ...other }: DismissibleTagProps<T>): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide content to be rendered inside of a `DismissibleTag`
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide a custom className that is applied to the containing <span>
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify if the `DismissibleTag` is disabled
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * Specify the id for the tag.
+         */
+        id: PropTypes.Requireable<string>;
+        /**
+         * Click handler for filter tag close button.
+         */
+        onClose: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Optional prop to render a custom icon.
+         * Can be a React component class
+         */
+        renderIcon: PropTypes.Requireable<object>;
+        /**
+         * Specify the size of the Tag. Currently supports either `sm`,
+         * `md` (default) or `lg` sizes.
+         */
+        size: PropTypes.Requireable<string>;
+        /**
+         * **Experimental:** Provide a `Slug` component to be rendered inside the `DismissibleTag` component
+         */
+        slug: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Text to show on clear filters
+         */
+        title: PropTypes.Requireable<string>;
+        /**
+         * Specify the type of the `Tag`
+         */
+        type: PropTypes.Requireable<string>;
+    };
+};
+export declare const types: string[];
+export default DismissibleTag;

package/es/components/Tag/OperationalTag.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import PropTypes, { ReactNodeLike } from 'prop-types';
+import React, { MouseEventHandler } from 'react';
+import { PolymorphicProps } from '../../types/common';
+import { SIZES } from './Tag';
+declare const TYPES: {
+    red: string;
+    magenta: string;
+    purple: string;
+    blue: string;
+    cyan: string;
+    teal: string;
+    green: string;
+    gray: string;
+    'cool-gray': string;
+    'warm-gray': string;
+};
+export interface OperationalTagBaseProps {
+    /**
+     * Provide content to be rendered inside of a `OperationalTag`
+     */
+    children?: React.ReactNode;
+    /**
+     * Provide a custom className that is applied to the containing <span>
+     */
+    className?: string;
+    /**
+     * Specify if the `OperationalTag` is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify the id for the OperationalTag.
+     */
+    id?: string;
+    /**
+     * Optional prop to render a custom icon.
+     * Can be a React component class
+     */
+    renderIcon?: React.ElementType;
+    onClick?: MouseEventHandler;
+    /**
+     * Specify the size of the Tag. Currently supports either `sm`,
+     * `md` (default) or `lg` sizes.
+     */
+    size?: keyof typeof SIZES;
+    /**
+     * **Experimental:** Provide a `Slug` component to be rendered inside the `OperationalTag` component
+     */
+    slug?: ReactNodeLike;
+    /**
+     * Specify the type of the `Tag`
+     */
+    type?: keyof typeof TYPES;
+}
+export type OperationalTagProps<T extends React.ElementType> = PolymorphicProps<T, OperationalTagBaseProps>;
+declare const OperationalTag: {
+    <T extends React.ElementType<any>>({ children, className, disabled, id, renderIcon, slug, size, type, ...other }: OperationalTagProps<T>): import("react/jsx-runtime").JSX.Element;
+    propTypes: {
+        /**
+         * Provide content to be rendered inside of a `OperationalTag`
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide a custom className that is applied to the containing <span>
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify if the `OperationalTag` is disabled
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * Specify the id for the tag.
+         */
+        id: PropTypes.Requireable<string>;
+        /**
+         * Optional prop to render a custom icon.
+         * Can be a React component class
+         */
+        renderIcon: PropTypes.Requireable<object>;
+        /**
+         * Specify the size of the Tag. Currently supports either `sm`,
+         * `md` (default) or `lg` sizes.
+         */
+        size: PropTypes.Requireable<string>;
+        /**
+         * **Experimental:** Provide a `Slug` component to be rendered inside the `OperationalTag` component
+         */
+        slug: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify the type of the `Tag`
+         */
+        type: PropTypes.Requireable<string>;
+    };
+};
+export declare const types: string[];
+export default OperationalTag;