@carbon/react 1.54.0-rc.0 → 1.54.0

package/es/components/Button/Button.d.ts

@@ -14,7 +14,7 @@ export declare const ButtonTooltipAlignments: readonly ["start", "center", "end"
 export type ButtonTooltipAlignment = (typeof ButtonTooltipAlignments)[number];
 export declare const ButtonTooltipPositions: string[];
 export type ButtonTooltipPosition = (typeof ButtonTooltipPositions)[number];
-interface ButtonBaseProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+export interface ButtonBaseProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     /**
      * Specify the message read by screen readers for the danger button variant
      */

package/es/components/Button/Button.js

@@ -8,11 +8,9 @@
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
 import React__default, { useRef } from 'react';
-import cx from 'classnames';
 import { IconButton } from '../IconButton/index.js';
 import { composeEventHandlers } from '../../tools/events.js';
-import { usePrefix } from '../../internal/usePrefix.js';
-import { useId } from '../../internal/useId.js';
+import ButtonBase from './ButtonBase.js';
 
 const ButtonKinds = ['primary', 'secondary', 'danger', 'ghost', 'danger--primary', 'danger--ghost', 'danger--tertiary', 'tertiary'];
 const ButtonSizes = ['sm', 'md', 'lg', 'xl', '2xl'];
@@ -24,18 +22,13 @@ function isIconOnlyButton(hasIconOnly, _kind) {
   }
   return false;
 }
-const Button = /*#__PURE__*/React__default.forwardRef(function Button(_ref, ref) {
-  let {
+const Button = /*#__PURE__*/React__default.forwardRef(function Button(props, ref) {
+  const tooltipRef = useRef(null);
+  const {
     as,
     children,
-    className,
-    dangerDescription = 'danger',
-    disabled = false,
     hasIconOnly = false,
-    href,
     iconDescription,
-    isExpressive = false,
-    isSelected,
     kind = 'primary',
     onBlur,
     onClick,
@@ -44,92 +37,21 @@ const Button = /*#__PURE__*/React__default.forwardRef(function Button(_ref, ref)
     onMouseLeave,
     renderIcon: ButtonImageElement,
     size,
-    tabIndex,
     tooltipAlignment = 'center',
     tooltipPosition = 'top',
-    type = 'button',
     ...rest
-  } = _ref;
-  const tooltipRef = useRef(null);
-  const prefix = usePrefix();
+  } = props;
   const handleClick = evt => {
     // Prevent clicks on the tooltip from triggering the button click event
     if (evt.target === tooltipRef.current) {
       evt.preventDefault();
     }
   };
-  const buttonClasses = cx(className, {
-    [`${prefix}--btn`]: true,
-    [`${prefix}--btn--sm`]: size === 'sm' && !isExpressive,
-    // TODO: V12 - Remove this class
-    [`${prefix}--btn--md`]: size === 'md' && !isExpressive,
-    // TODO: V12 - Remove this class
-    [`${prefix}--btn--xl`]: size === 'xl',
-    // TODO: V12 - Remove this class
-    [`${prefix}--btn--2xl`]: size === '2xl',
-    // TODO: V12 - Remove this class
-    [`${prefix}--layout--size-${size}`]: size,
-    [`${prefix}--btn--${kind}`]: kind,
-    [`${prefix}--btn--disabled`]: disabled,
-    [`${prefix}--btn--expressive`]: isExpressive,
-    [`${prefix}--btn--icon-only`]: hasIconOnly,
-    [`${prefix}--btn--selected`]: hasIconOnly && isSelected && kind === 'ghost'
-  });
-  const commonProps = {
-    tabIndex,
-    className: buttonClasses,
-    ref
-  };
-  const buttonImage = !ButtonImageElement ? null : /*#__PURE__*/React__default.createElement(ButtonImageElement, {
-    "aria-label": iconDescription,
-    className: `${prefix}--btn__icon`,
-    "aria-hidden": "true"
-  });
   const iconOnlyImage = !ButtonImageElement ? null : /*#__PURE__*/React__default.createElement(ButtonImageElement, null);
-  const dangerButtonVariants = ['danger', 'danger--tertiary', 'danger--ghost'];
-  let component = 'button';
-  const assistiveId = useId('danger-description');
-  const {
-    'aria-pressed': ariaPressed,
-    'aria-describedby': ariaDescribedBy
-  } = rest;
-  let otherProps = {
-    disabled,
-    type,
-    'aria-describedby': dangerButtonVariants.includes(kind) ? assistiveId : ariaDescribedBy || undefined,
-    'aria-pressed': ariaPressed ?? (hasIconOnly && kind === 'ghost' ? isSelected : undefined)
-  };
-  const anchorProps = {
-    href
-  };
-  let assistiveText = null;
-  if (dangerButtonVariants.includes(kind)) {
-    assistiveText = /*#__PURE__*/React__default.createElement("span", {
-      id: assistiveId,
-      className: `${prefix}--visually-hidden`
-    }, dangerDescription);
-  }
-  if (as) {
-    component = as;
-    otherProps = {
-      ...otherProps,
-      ...anchorProps
-    };
-  } else if (href && !disabled) {
-    component = 'a';
-    otherProps = anchorProps;
-  }
   if (!isIconOnlyButton(hasIconOnly)) {
-    return /*#__PURE__*/React__default.createElement(component, {
-      onMouseEnter,
-      onMouseLeave,
-      onFocus,
-      onBlur,
-      onClick,
-      ...rest,
-      ...commonProps,
-      ...otherProps
-    }, assistiveText, children, buttonImage);
+    return /*#__PURE__*/React__default.createElement(ButtonBase, _extends({
+      ref: ref
+    }, props));
   } else {
     let align = undefined;
     if (tooltipPosition === 'top' || tooltipPosition === 'bottom') {
@@ -146,7 +68,8 @@ const Button = /*#__PURE__*/React__default.forwardRef(function Button(_ref, ref)
     if (tooltipPosition === 'right' || tooltipPosition === 'left') {
       align = tooltipPosition;
     }
-    return /*#__PURE__*/React__default.createElement(IconButton, _extends({
+    return /*#__PURE__*/React__default.createElement(IconButton, _extends({}, rest, {
+      ref: ref,
       as: as,
       align: align,
       label: iconDescription,
@@ -156,8 +79,9 @@ const Button = /*#__PURE__*/React__default.forwardRef(function Button(_ref, ref)
       onMouseLeave: onMouseLeave,
       onFocus: onFocus,
       onBlur: onBlur,
-      onClick: composeEventHandlers([onClick, handleClick])
-    }, rest, commonProps, otherProps), iconOnlyImage ?? children);
+      onClick: composeEventHandlers([onClick, handleClick]),
+      renderIcon: iconOnlyImage ? null : ButtonImageElement // avoid doubling the icon.
+    }), iconOnlyImage ?? children);
   }
 });
 Button.displayName = 'Button';

package/es/components/Button/ButtonBase.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 React from 'react';
+import { ButtonProps } from './Button';
+declare const ButtonBase: React.ForwardRefExoticComponent<Omit<ButtonProps<React.ElementType<any>>, "ref"> & React.RefAttributes<unknown>>;
+export default ButtonBase;

package/es/components/Button/ButtonBase.js

@@ -0,0 +1,110 @@
+/**
+ * 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 React__default from 'react';
+import cx from 'classnames';
+import { usePrefix } from '../../internal/usePrefix.js';
+import { useId } from '../../internal/useId.js';
+
+const ButtonBase = /*#__PURE__*/React__default.forwardRef(function ButtonBase(_ref, ref) {
+  let {
+    as,
+    children,
+    className,
+    dangerDescription = 'danger',
+    disabled = false,
+    hasIconOnly = false,
+    href,
+    iconDescription,
+    isExpressive = false,
+    isSelected,
+    kind = 'primary',
+    onBlur,
+    onClick,
+    onFocus,
+    onMouseEnter,
+    onMouseLeave,
+    renderIcon: ButtonImageElement,
+    size,
+    tabIndex,
+    type = 'button',
+    ...rest
+  } = _ref;
+  const prefix = usePrefix();
+  const buttonClasses = cx(className, {
+    [`${prefix}--btn`]: true,
+    [`${prefix}--btn--sm`]: size === 'sm' && !isExpressive,
+    // TODO: V12 - Remove this class
+    [`${prefix}--btn--md`]: size === 'md' && !isExpressive,
+    // TODO: V12 - Remove this class
+    [`${prefix}--btn--xl`]: size === 'xl',
+    // TODO: V12 - Remove this class
+    [`${prefix}--btn--2xl`]: size === '2xl',
+    // TODO: V12 - Remove this class
+    [`${prefix}--layout--size-${size}`]: size,
+    [`${prefix}--btn--${kind}`]: kind,
+    [`${prefix}--btn--disabled`]: disabled,
+    [`${prefix}--btn--expressive`]: isExpressive,
+    [`${prefix}--btn--icon-only`]: hasIconOnly && !className?.includes(`${prefix}--btn--icon-only`),
+    [`${prefix}--btn--selected`]: hasIconOnly && isSelected && kind === 'ghost'
+  });
+  const commonProps = {
+    tabIndex,
+    className: buttonClasses,
+    ref
+  };
+  const buttonImage = !ButtonImageElement ? null : /*#__PURE__*/React__default.createElement(ButtonImageElement, {
+    "aria-label": iconDescription,
+    className: `${prefix}--btn__icon`,
+    "aria-hidden": "true"
+  });
+  const dangerButtonVariants = ['danger', 'danger--tertiary', 'danger--ghost'];
+  let component = 'button';
+  const assistiveId = useId('danger-description');
+  const {
+    'aria-pressed': ariaPressed,
+    'aria-describedby': ariaDescribedBy
+  } = rest;
+  let otherProps = {
+    disabled,
+    type,
+    'aria-describedby': dangerButtonVariants.includes(kind) ? assistiveId : ariaDescribedBy || undefined,
+    'aria-pressed': ariaPressed ?? (hasIconOnly && kind === 'ghost' ? isSelected : undefined)
+  };
+  const anchorProps = {
+    href
+  };
+  let assistiveText = null;
+  if (dangerButtonVariants.includes(kind)) {
+    assistiveText = /*#__PURE__*/React__default.createElement("span", {
+      id: assistiveId,
+      className: `${prefix}--visually-hidden`
+    }, dangerDescription);
+  }
+  if (as) {
+    component = as;
+    otherProps = {
+      ...otherProps,
+      ...anchorProps
+    };
+  } else if (href && !disabled) {
+    component = 'a';
+    otherProps = anchorProps;
+  }
+  return /*#__PURE__*/React__default.createElement(component, {
+    onMouseEnter,
+    onMouseLeave,
+    onFocus,
+    onBlur,
+    onClick,
+    ...rest,
+    ...commonProps,
+    ...otherProps
+  }, assistiveText, children, buttonImage);
+});
+
+export { ButtonBase as default };

package/es/components/CodeSnippet/CodeSnippet.js

@@ -155,6 +155,7 @@ function CodeSnippet(_ref) {
       feedback: feedback,
       feedbackTimeout: feedbackTimeout
     }), /*#__PURE__*/React__default.createElement("code", {
+      "aria-live": "assertive",
       id: uid,
       ref: innerCodeRef
     }, children));

package/es/components/IconButton/index.js

@@ -8,12 +8,11 @@
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
 import React__default from 'react';
-import Button from '../Button/Button.js';
-import '../Button/Button.Skeleton.js';
 import cx from 'classnames';
 import '../Tooltip/DefinitionTooltip.js';
 import { Tooltip } from '../Tooltip/Tooltip.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import ButtonBase from '../Button/ButtonBase.js';
 
 const IconButtonKinds = ['primary', 'secondary', 'ghost', 'tertiary'];
 const IconButton = /*#__PURE__*/React__default.forwardRef(function IconButton(_ref, ref) {
@@ -45,7 +44,7 @@ const IconButton = /*#__PURE__*/React__default.forwardRef(function IconButton(_r
     enterDelayMs: enterDelayMs,
     label: label,
     leaveDelayMs: leaveDelayMs
-  }, /*#__PURE__*/React__default.createElement(Button, _extends({}, rest, {
+  }, /*#__PURE__*/React__default.createElement(ButtonBase, _extends({}, rest, {
     disabled: disabled,
     kind: kind,
     ref: ref,

package/es/components/Menu/Menu.js

@@ -32,6 +32,8 @@ const Menu = /*#__PURE__*/forwardRef(function Menu(_ref, forwardRef) {
     onOpen,
     open,
     size = 'sm',
+    // TODO: #16004
+    // eslint-disable-next-line ssr-friendly/no-dom-globals-in-react-fc
     target = document.body,
     x = 0,
     y = 0,

package/es/components/ModalWrapper/ModalWrapper.d.ts

@@ -59,7 +59,7 @@ export default class ModalWrapper extends React.Component<ModalWrapperProps, Mod
         shouldCloseAfterSubmit: PropTypes.Requireable<boolean>;
         status: PropTypes.Requireable<string>;
         triggerButtonIconDescription: PropTypes.Requireable<string>;
-        triggerButtonKind: PropTypes.Requireable<"primary" | "secondary" | "ghost" | "tertiary" | "danger" | "danger--primary" | "danger--ghost" | "danger--tertiary">;
+        triggerButtonKind: PropTypes.Requireable<"primary" | "secondary" | "danger" | "ghost" | "danger--primary" | "danger--ghost" | "danger--tertiary" | "tertiary">;
         withHeader: PropTypes.Requireable<boolean>;
     };
     triggerButton: React.RefObject<HTMLButtonElement>;

package/es/components/Slider/Slider.Skeleton.js

@@ -7,9 +7,10 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default from 'react';
+import React__default, { useState } from 'react';
 import cx from 'classnames';
 import { usePrefix } from '../../internal/usePrefix.js';
+import useIsomorphicEffect from '../../internal/useIsomorphicEffect.js';
 import { LowerHandle, UpperHandle } from './SliderHandles.js';
 
 var _LowerHandle, _UpperHandle, _UpperHandle2, _LowerHandle2;
@@ -21,7 +22,10 @@ const SliderSkeleton = _ref => {
     ...rest
   } = _ref;
   const prefix = usePrefix();
-  const isRtl = document?.dir === 'rtl';
+  const [isRtl, setIsRtl] = useState(false);
+  useIsomorphicEffect(() => {
+    setIsRtl(document ? document.dir === 'rtl' : false);
+  }, []);
   const containerClasses = cx(`${prefix}--slider-container`, `${prefix}--skeleton`, {
     [`${prefix}--slider-container--two-handles`]: twoHandles,
     [`${prefix}--slider-container--rtl`]: isRtl

package/es/components/StructuredList/StructuredList.d.ts

@@ -144,6 +144,10 @@ export interface StructuredListRowProps extends DivAttrs {
      * Provide a handler that is invoked on the key down event for the control
      */
     onKeyDown?(event: KeyboardEvent): void;
+    /**
+     * Mark if this row should be selectable
+     */
+    selection?: boolean;
 }
 export declare function StructuredListRow(props: StructuredListRowProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace StructuredListRow {
@@ -172,6 +176,10 @@ export declare namespace StructuredListRow {
          * Provide a handler that is invoked on the key down event for the control,
          */
         onKeyDown: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Mark if this row should be selectable
+         */
+        selection: PropTypes.Requireable<boolean>;
     };
 }
 export interface StructuredListInputProps extends DivAttrs {

package/es/components/StructuredList/StructuredList.js

@@ -6,15 +6,18 @@
  */
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import React__default, { useState } from 'react';
+import React__default, { useState, useRef } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { useId } from '../../internal/useId.js';
 import deprecate from '../../prop-types/deprecate.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import '../Text/index.js';
+import { RadioButtonChecked, RadioButton } from '@carbon/icons-react';
+import { useOutsideClick } from '../../internal/useOutsideClick.js';
 import { Text } from '../Text/Text.js';
 
+var _StructuredListCell, _RadioButtonChecked, _RadioButton;
 const GridSelectedRowStateContext = /*#__PURE__*/React__default.createContext(null);
 const GridSelectedRowDispatchContext = /*#__PURE__*/React__default.createContext(null);
 function StructuredListWrapper(props) {
@@ -137,6 +140,7 @@ function StructuredListRow(props) {
     className,
     head,
     onClick,
+    selection,
     ...other
   } = props;
   const [hasFocusWithin, setHasFocusWithin] = useState(false);
@@ -149,25 +153,35 @@ function StructuredListRow(props) {
   };
   const classes = cx(`${prefix}--structured-list-row`, {
     [`${prefix}--structured-list-row--header-row`]: head,
-    [`${prefix}--structured-list-row--focused-within`]: hasFocusWithin,
+    [`${prefix}--structured-list-row--focused-within`]: hasFocusWithin && !selection || hasFocusWithin && selection && (selectedRow === id || selectedRow === null),
+    // Ensure focus on the first item when navigating through Tab keys and no row is selected (selectedRow === null)
     [`${prefix}--structured-list-row--selected`]: selectedRow === id
   }, className);
+  const itemRef = useRef(null);
+  const handleClick = () => {
+    setHasFocusWithin(false);
+  };
+  useOutsideClick(itemRef, handleClick);
   return head ? /*#__PURE__*/React__default.createElement("div", _extends({
     role: "row"
   }, other, {
-    className: classes,
-    "aria-busy": "true"
-  }), children) :
+    className: classes
+  }), selection && (_StructuredListCell || (_StructuredListCell = /*#__PURE__*/React__default.createElement(StructuredListCell, {
+    head: true
+  }))), children) :
   /*#__PURE__*/
   // eslint-disable-next-line jsx-a11y/interactive-supports-focus
-  React__default.createElement("div", _extends({
-    "aria-busy": "true"
-  }, other, {
+  React__default.createElement("div", _extends({}, other, {
     role: "row",
     className: classes,
+    ref: itemRef,
     onClick: event => {
       setSelectedRow?.(id);
       onClick && onClick(event);
+      if (selection) {
+        // focus items only when selection is enabled
+        setHasFocusWithin(true);
+      }
     },
     onFocus: () => {
       setHasFocusWithin(true);
@@ -178,7 +192,7 @@ function StructuredListRow(props) {
     onKeyDown: onKeyDown
   }), /*#__PURE__*/React__default.createElement(GridRowContext.Provider, {
     value: value
-  }, children));
+  }, selection && /*#__PURE__*/React__default.createElement(StructuredListCell, null, selectedRow === id ? _RadioButtonChecked || (_RadioButtonChecked = /*#__PURE__*/React__default.createElement(RadioButtonChecked, null)) : _RadioButton || (_RadioButton = /*#__PURE__*/React__default.createElement(RadioButton, null))), children));
 }
 StructuredListRow.propTypes = {
   /**
@@ -204,7 +218,11 @@ StructuredListRow.propTypes = {
   /**
    * Provide a handler that is invoked on the key down event for the control,
    */
-  onKeyDown: PropTypes.func
+  onKeyDown: PropTypes.func,
+  /**
+   * Mark if this row should be selectable
+   */
+  selection: PropTypes.bool
 };
 function StructuredListInput(props) {
   const defaultId = useId('structureListInput');

package/es/feature-flags.js

@@ -12,5 +12,6 @@ FeatureFlags.merge({
   'enable-css-grid': true,
   'enable-v11-release': true,
   'enable-experimental-tile-contrast': false,
-  'enable-v12-tile-radio-icons': false
+  'enable-v12-tile-radio-icons': false,
+  'enable-v12-structured-list-visible-icons': false
 });

package/es/internal/environment.js

@@ -10,6 +10,10 @@
  *
  * @see https://github.com/facebook/fbjs/blob/4d1751311d3f67af2dcce2e40df8512a23c7b9c6/packages/fbjs/src/core/ExecutionEnvironment.js#L12
  */
-const canUseDOM = !!(typeof window !== 'undefined' && window.document && window.document.createElement);
+const canUseDOM = !!(typeof window !== 'undefined' &&
+// eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+window.document &&
+// eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+window.document.createElement);
 
 export { canUseDOM };

package/es/internal/keyboard/navigation.js

@@ -39,7 +39,9 @@ const getNextIndex = (key, index, arrayLength) => {
  */
 const DOCUMENT_POSITION_BROAD_PRECEDING =
 // Checks `typeof Node` for `react-docgen`
-typeof Node !== 'undefined' && Node.DOCUMENT_POSITION_PRECEDING | Node.DOCUMENT_POSITION_CONTAINS;
+typeof Node !== 'undefined' &&
+// eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+Node.DOCUMENT_POSITION_PRECEDING | Node.DOCUMENT_POSITION_CONTAINS;
 
 /**
  * A flag `node.compareDocumentPosition(target)` returns,
@@ -47,7 +49,9 @@ typeof Node !== 'undefined' && Node.DOCUMENT_POSITION_PRECEDING | Node.DOCUMENT_
  */
 const DOCUMENT_POSITION_BROAD_FOLLOWING =
 // Checks `typeof Node` for `react-docgen`
-typeof Node !== 'undefined' && Node.DOCUMENT_POSITION_FOLLOWING | Node.DOCUMENT_POSITION_CONTAINED_BY;
+typeof Node !== 'undefined' &&
+// eslint-disable-next-line ssr-friendly/no-dom-globals-in-module-scope
+Node.DOCUMENT_POSITION_FOLLOWING | Node.DOCUMENT_POSITION_CONTAINED_BY;
 
 /**
  * CSS selector that selects major nodes that are sequential-focusable.

package/es/internal/useOutsideClick.js

@@ -0,0 +1,31 @@
+/**
+ * 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 { useRef, useEffect } from 'react';
+import { useEvent } from './useEvent.js';
+import { canUseDOM } from './environment.js';
+
+function useOutsideClick(ref, callback) {
+  const savedCallback = useRef(callback);
+  useEffect(() => {
+    savedCallback.current = callback;
+  });
+
+  // We conditionally guard the `useEvent` hook for SSR. `canUseDOM` can be
+  // treated as a constant as it will be false when executed in a Node.js
+  // environment and true when executed in the browser
+  if (canUseDOM) {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    useEvent(window, 'click', event => {
+      if (ref.current && !ref.current.contains(event.target)) {
+        savedCallback.current(event);
+      }
+    });
+  }
+}
+
+export { useOutsideClick };

package/lib/components/Button/Button.d.ts

@@ -14,7 +14,7 @@ export declare const ButtonTooltipAlignments: readonly ["start", "center", "end"
 export type ButtonTooltipAlignment = (typeof ButtonTooltipAlignments)[number];
 export declare const ButtonTooltipPositions: string[];
 export type ButtonTooltipPosition = (typeof ButtonTooltipPositions)[number];
-interface ButtonBaseProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+export interface ButtonBaseProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     /**
      * Specify the message read by screen readers for the danger button variant
      */