@carbon/react 1.44.0-rc.0 → 1.45.0-rc.0

package/es/components/TextArea/TextArea.js

@@ -7,7 +7,7 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default, { useContext, useState, useRef, useEffect } from 'react';
+import React__default, { useContext, useRef, useState, useEffect } from 'react';
 import cx from 'classnames';
 import deprecate from '../../prop-types/deprecate.js';
 import { WarningFilled, WarningAltFilled } from '@carbon/icons-react';
@@ -39,6 +39,7 @@ const TextArea = /*#__PURE__*/React__default.forwardRef((props, forwardRef) => {
     placeholder = '',
     enableCounter = false,
     maxCount = undefined,
+    counterMode = 'character',
     warn = false,
     warnText = '',
     rows = 4,
@@ -53,15 +54,25 @@ const TextArea = /*#__PURE__*/React__default.forwardRef((props, forwardRef) => {
     defaultValue,
     value
   } = other;
-  const [textCount, setTextCount] = useState(defaultValue?.toString()?.length || value?.toString()?.length || 0);
   const {
     current: textAreaInstanceId
   } = useRef(getInstanceId());
   const textareaRef = useRef(null);
   const ref = useMergedRefs([forwardRef, textareaRef]);
+  function getInitialTextCount() {
+    const targetValue = defaultValue || value || textareaRef.current?.value || '';
+    const strValue = targetValue.toString();
+    if (counterMode === 'character') {
+      return strValue.length;
+    } else {
+      return strValue.match(/\w+/g)?.length || 0;
+    }
+  }
+  const [textCount, setTextCount] = useState(getInitialTextCount());
   useEffect(() => {
-    setTextCount(defaultValue?.toString()?.length || value?.toString()?.length || 0);
-  }, [value, defaultValue]);
+    setTextCount(getInitialTextCount());
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [value, defaultValue, counterMode]);
   useIsomorphicEffect(() => {
     if (other.cols && textareaRef.current) {
       textareaRef.current.style.width = '';
@@ -72,14 +83,63 @@ const TextArea = /*#__PURE__*/React__default.forwardRef((props, forwardRef) => {
   }, [other.cols]);
   const textareaProps = {
     id,
+    onKeyDown: evt => {
+      if (!disabled && enableCounter && counterMode === 'word') {
+        const key = evt.which;
+        if (maxCount && textCount >= maxCount && key === 32) {
+          evt.preventDefault();
+        }
+      }
+    },
+    onPaste: evt => {
+      if (!disabled) {
+        if (counterMode === 'word' && enableCounter && typeof maxCount !== 'undefined' && textareaRef.current !== null) {
+          const existingWords = textareaRef.current.value.match(/\w+/g) || [];
+          const pastedWords = evt.clipboardData.getData('Text').match(/\w+/g) || [];
+          const totalWords = existingWords.length + pastedWords.length;
+          if (totalWords > maxCount) {
+            evt.preventDefault();
+            const allowedWords = existingWords.concat(pastedWords).slice(0, maxCount);
+            setTimeout(() => {
+              setTextCount(maxCount);
+            }, 0);
+            textareaRef.current.value = allowedWords.join(' ');
+          }
+        }
+      }
+    },
     onChange: evt => {
-      if (!disabled && onChange) {
-        evt?.persist?.();
-        // delay textCount assignation to give the textarea element value time to catch up if is a controlled input
-        setTimeout(() => {
-          setTextCount(evt.target?.value?.length);
-        }, 0);
-        onChange(evt);
+      if (!disabled) {
+        if (counterMode == 'character') {
+          evt?.persist?.();
+          // delay textCount assignation to give the textarea element value time to catch up if is a controlled input
+          setTimeout(() => {
+            setTextCount(evt.target?.value?.length);
+          }, 0);
+        } else if (counterMode == 'word') {
+          if (!evt.target.value) {
+            setTimeout(() => {
+              setTextCount(0);
+            }, 0);
+            return;
+          }
+          if (enableCounter && typeof maxCount !== 'undefined' && textareaRef.current !== null) {
+            const matchedWords = evt.target?.value?.match(/\w+/g);
+            if (matchedWords && matchedWords.length <= maxCount) {
+              textareaRef.current.removeAttribute('maxLength');
+              setTimeout(() => {
+                setTextCount(matchedWords.length);
+              }, 0);
+            } else if (matchedWords && matchedWords.length > maxCount) {
+              setTimeout(() => {
+                setTextCount(matchedWords.length);
+              }, 0);
+            }
+          }
+        }
+        if (onChange) {
+          onChange(evt);
+        }
       }
     },
     onClick: evt => {
@@ -114,7 +174,7 @@ const TextArea = /*#__PURE__*/React__default.forwardRef((props, forwardRef) => {
     htmlFor: id,
     className: labelClasses
   }, labelText) : null;
-  const counter = enableCounter && maxCount ? /*#__PURE__*/React__default.createElement(Text, {
+  const counter = enableCounter && maxCount && (counterMode === 'character' || counterMode === 'word') ? /*#__PURE__*/React__default.createElement(Text, {
     as: "div",
     className: counterClasses
   }, `${textCount}/${maxCount}`) : null;
@@ -147,9 +207,12 @@ const TextArea = /*#__PURE__*/React__default.forwardRef((props, forwardRef) => {
     ariaDescribedBy = helperId;
   }
   if (enableCounter) {
-    textareaProps.maxLength = maxCount;
+    // handle different counter mode
+    if (counterMode == 'character') {
+      textareaProps.maxLength = maxCount;
+    }
   }
-  const ariaAnnouncement = useAnnouncer(textCount, maxCount);
+  const ariaAnnouncement = useAnnouncer(textCount, maxCount, counterMode === 'word' ? 'words' : undefined);
   const input = /*#__PURE__*/React__default.createElement("textarea", _extends({}, other, textareaProps, {
     placeholder: placeholder,
     className: textareaClasses,
@@ -197,6 +260,10 @@ TextArea.propTypes = {
    * Specify the `cols` attribute for the underlying `<textarea>` node
    */
   cols: PropTypes.number,
+  /**
+   * Specify the method used for calculating the counter number
+   */
+  counterMode: PropTypes.oneOf(['character', 'word']),
   /**
    * Optionally provide the default value of the `<textarea>`
    */
@@ -206,7 +273,7 @@ TextArea.propTypes = {
    */
   disabled: PropTypes.bool,
   /**
-   * Specify whether to display the character counter
+   * Specify whether to display the counter
    */
   enableCounter: PropTypes.bool,
   /**
@@ -240,7 +307,7 @@ TextArea.propTypes = {
    */
   light: deprecate(PropTypes.bool, 'The `light` prop for `TextArea` has ' + 'been deprecated in favor of the new `Layer` component. It will be removed in the next major release.'),
   /**
-   * Max character count allowed for the textarea. This is needed in order for enableCounter to display
+   * Max entity count allowed for the textarea. This is needed in order for enableCounter to display
    */
   maxCount: PropTypes.number,
   /**
@@ -266,7 +333,7 @@ TextArea.propTypes = {
    */
   rows: PropTypes.number,
   /**
-   * Provide a `Slug` component to be rendered inside the `TextArea` component
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `TextArea` component
    */
   slug: PropTypes.node,
   /**

package/es/components/TextInput/TextInput.d.ts

@@ -87,7 +87,7 @@ export interface TextInputProps extends Omit<React.InputHTMLAttributes<HTMLInput
      */
     size?: 'sm' | 'md' | 'lg' | 'xl';
     /**
-     * Provide a `Slug` component to be rendered inside the `TextInput` component
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `TextInput` component
      */
     slug?: ReactNodeLike;
     /**

package/es/components/TextInput/TextInput.js

@@ -261,7 +261,7 @@ TextInput.propTypes = {
    */
   size: PropTypes.oneOf(['sm', 'md', 'lg']),
   /**
-   * Provide a `Slug` component to be rendered inside the `TextInput` component
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `TextInput` component
    */
   slug: PropTypes.node,
   /**

package/es/components/Tile/Tile.d.ts

@@ -1,9 +1,19 @@
 import React, { type ReactNode, type MouseEvent, type KeyboardEvent, type HTMLAttributes, type ChangeEvent, type ComponentType } from 'react';
+import { ReactNodeLike } from 'prop-types';
 export interface TileProps extends HTMLAttributes<HTMLDivElement> {
     children?: ReactNode;
     className?: string;
     /** @deprecated */
     light?: boolean;
+    /**
+     * **Experimental**: Specify if the `Tile` component should be rendered with rounded corners. Only valid
+     * when `slug` prop is present
+     */
+    hasRoundedCorners?: boolean;
+    /**
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `SelectableTile` component
+     */
+    slug?: ReactNodeLike;
 }
 export declare const Tile: React.ForwardRefExoticComponent<TileProps & React.RefAttributes<HTMLDivElement>>;
 export interface ClickableTileProps extends HTMLAttributes<HTMLAnchorElement> {
@@ -19,6 +29,11 @@ export interface ClickableTileProps extends HTMLAttributes<HTMLAnchorElement> {
      * Specify whether the ClickableTile should be disabled
      */
     disabled?: boolean;
+    /**
+     * **Experimental**: Specify if the `ClickableTile` component should be rendered with rounded corners.
+     * Only valid when `slug` prop is present
+     */
+    hasRoundedCorners?: boolean;
     /**
      * The href for the link.
      */
@@ -41,6 +56,10 @@ export interface ClickableTileProps extends HTMLAttributes<HTMLAnchorElement> {
      * The rel property for the link.
      */
     rel?: string;
+    /**
+     * **Experimental**: Specify if a `Slug` icon should be rendered inside the `ClickableTile`
+     */
+    slug?: boolean;
 }
 export declare const ClickableTile: React.ForwardRefExoticComponent<ClickableTileProps & React.RefAttributes<HTMLAnchorElement>>;
 export interface SelectableTileProps extends HTMLAttributes<HTMLDivElement> {
@@ -52,6 +71,11 @@ export interface SelectableTileProps extends HTMLAttributes<HTMLDivElement> {
      * Specify whether the SelectableTile should be disabled
      */
     disabled?: boolean;
+    /**
+     * **Experimental**: Specify if the `SelectableTile` component should be rendered with rounded corners.
+     * Only valid when `slug` prop is present
+     */
+    hasRoundedCorners?: boolean;
     /**
      * The ID of the `<input>`.
      */
@@ -77,6 +101,10 @@ export interface SelectableTileProps extends HTMLAttributes<HTMLDivElement> {
      * `true` to select this tile.
      */
     selected?: boolean;
+    /**
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `SelectableTile` component
+     */
+    slug?: ReactNodeLike;
     /**
      * Specify the tab index of the wrapper element
      */
@@ -101,6 +129,11 @@ export interface ExpandableTileProps extends HTMLAttributes<HTMLDivElement> {
      * `true` if the tile is expanded.
      */
     expanded?: boolean;
+    /**
+     * **Experimental**: Specify if the `ExpandableTile` component should be rendered with rounded corners.
+     * Only valid when `slug` prop is present
+     */
+    hasRoundedCorners?: boolean;
     /**
      * An ID that can be provided to aria-labelledby
      */
@@ -113,6 +146,10 @@ export interface ExpandableTileProps extends HTMLAttributes<HTMLDivElement> {
      * optional handler to trigger a function when a key is pressed
      */
     onKeyUp?(event: KeyboardEvent): void;
+    /**
+     * **Experimental**: Provide a `Slug` component to be rendered inside the `ExpandableTile` component
+     */
+    slug?: ReactNodeLike;
     /**
      * The `tabindex` attribute.
      */

package/es/components/Tile/Tile.js

@@ -24,20 +24,26 @@ import { Text } from '../Text/Text.js';
 import { matches } from '../../internal/keyboard/match.js';
 import { Enter, Space } from '../../internal/keyboard/keys.js';
 
-var _CheckboxCheckedFille, _Checkbox, _ChevronDown, _ChevronDown2;
+var _rect, _path, _CheckboxCheckedFille, _Checkbox, _ChevronDown, _ChevronDown2;
 const Tile = /*#__PURE__*/React__default.forwardRef(function Tile(_ref, ref) {
   let {
     children,
     className,
     light = false,
+    slug,
+    hasRoundedCorners = false,
     ...rest
   } = _ref;
   const prefix = usePrefix();
-  const tileClasses = cx(`${prefix}--tile`, light && `${prefix}--tile--light`, className);
+  const tileClasses = cx(`${prefix}--tile`, {
+    [`${prefix}--tile--light`]: light,
+    [`${prefix}--tile--slug`]: slug,
+    [`${prefix}--tile--slug-rounded`]: slug && hasRoundedCorners
+  }, className);
   return /*#__PURE__*/React__default.createElement("div", _extends({
     className: tileClasses,
     ref: ref
-  }, rest), children);
+  }, rest), children, slug);
 });
 Tile.displayName = 'Tile';
 Tile.propTypes = {
@@ -49,13 +55,22 @@ Tile.propTypes = {
    * The CSS class names.
    */
   className: PropTypes.string,
+  /**
+   * **Experimental**: Specify if the `Tile` component should be rendered with rounded corners. Only valid
+   * when `slug` prop is present
+   */
+  hasRoundedCorners: PropTypes.bool,
   /**
    * `true` to use the light version. For use on $ui-01 backgrounds only.
    * Don't use this to make tile background color same as container background color.
    *
    * @deprecated
    */
-  light: deprecate(PropTypes.bool, 'The `light` prop for `Tile` is no longer needed and has been deprecated. It will be removed in the next major release. Use the Layer component instead.')
+  light: deprecate(PropTypes.bool, 'The `light` prop for `Tile` is no longer needed and has been deprecated. It will be removed in the next major release. Use the Layer component instead.'),
+  /**
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `Tile` component
+   */
+  slug: PropTypes.node
 };
 const ClickableTile = /*#__PURE__*/React__default.forwardRef(function ClickableTile(_ref2, ref) {
   let {
@@ -68,10 +83,17 @@ const ClickableTile = /*#__PURE__*/React__default.forwardRef(function ClickableT
     onClick = () => {},
     onKeyDown = () => {},
     renderIcon: Icon,
+    hasRoundedCorners,
+    slug,
     ...rest
   } = _ref2;
   const prefix = usePrefix();
-  const classes = cx(`${prefix}--tile`, `${prefix}--tile--clickable`, clicked && `${prefix}--tile--is-clicked`, light && `${prefix}--tile--light`, className);
+  const classes = cx(`${prefix}--tile`, `${prefix}--tile--clickable`, {
+    [`${prefix}--tile--is-clicked`]: clicked,
+    [`${prefix}--tile--light`]: light,
+    [`${prefix}--tile--slug`]: slug,
+    [`${prefix}--tile--slug-rounded`]: slug && hasRoundedCorners
+  }, className);
   const [isSelected, setIsSelected] = useState(clicked);
   function handleOnClick(evt) {
     evt?.persist?.();
@@ -85,6 +107,25 @@ const ClickableTile = /*#__PURE__*/React__default.forwardRef(function ClickableT
     }
     onKeyDown(evt);
   }
+
+  // To Do: Replace with an an icon from `@carbon/react`
+  // since the hollow slug in `ClickableTile` is not interactive
+  const hollowSlugIcon = /*#__PURE__*/React__default.createElement("svg", {
+    className: `${prefix}--tile--slug-icon`,
+    width: "24",
+    height: "24",
+    viewBox: "0 0 24 24",
+    fill: "none",
+    xmlns: "http://www.w3.org/2000/svg"
+  }, _rect || (_rect = /*#__PURE__*/React__default.createElement("rect", {
+    x: "0.5",
+    y: "0.5",
+    width: "23",
+    height: "23"
+  })), _path || (_path = /*#__PURE__*/React__default.createElement("path", {
+    d: "M13.2436 16H11.5996L10.9276 13.864H7.95164L7.29164 16H5.68364L8.49164 7.624H10.4596L13.2436 16ZM10.5436 12.508L9.46364 9.064H9.40364L8.33564 12.508H10.5436ZM17.9341 16H14.1301V14.728H15.2341V8.896H14.1301V7.624H17.9341V8.896H16.8181V14.728H17.9341V16Z",
+    fill: "#161616"
+  })));
   const v12DefaultIcons = useFeatureFlag('enable-v12-tile-default-icons');
   if (v12DefaultIcons) {
     if (!Icon) {
@@ -106,7 +147,9 @@ const ClickableTile = /*#__PURE__*/React__default.forwardRef(function ClickableT
     onKeyDown: handleOnKeyDown,
     ref: ref,
     disabled: disabled
-  }, rest), children, Icon && /*#__PURE__*/React__default.createElement(Icon, {
+  }, rest), slug ? /*#__PURE__*/React__default.createElement("div", {
+    className: `${prefix}--tile-content`
+  }, children) : children, slug && hollowSlugIcon, Icon && /*#__PURE__*/React__default.createElement(Icon, {
     className: iconClasses,
     "aria-hidden": "true"
   }));
@@ -129,6 +172,11 @@ ClickableTile.propTypes = {
    * Specify whether the ClickableTile should be disabled
    */
   disabled: PropTypes.bool,
+  /**
+   * **Experimental**: Specify if the `ClickableTile` component should be rendered with rounded corners.
+   * Only valid when `slug` prop is present
+   */
+  hasRoundedCorners: PropTypes.bool,
   /**
    * The href for the link.
    */
@@ -170,6 +218,8 @@ const SelectableTile = /*#__PURE__*/React__default.forwardRef(function Selectabl
     selected = false,
     tabIndex = 0,
     title = 'title',
+    slug,
+    hasRoundedCorners,
     ...rest
   } = _ref3;
   const prefix = usePrefix();
@@ -177,12 +227,21 @@ const SelectableTile = /*#__PURE__*/React__default.forwardRef(function Selectabl
   const keyDownHandler = onKeyDown;
   const [isSelected, setIsSelected] = useState(selected);
   const [prevSelected, setPrevSelected] = useState(selected);
-  const classes = cx(`${prefix}--tile`, `${prefix}--tile--selectable`, isSelected && `${prefix}--tile--is-selected`, light && `${prefix}--tile--light`, disabled && `${prefix}--tile--disabled`, className);
+  const classes = cx(`${prefix}--tile`, `${prefix}--tile--selectable`, {
+    [`${prefix}--tile--is-selected`]: isSelected,
+    [`${prefix}--tile--light`]: light,
+    [`${prefix}--tile--disabled`]: disabled,
+    [`${prefix}--tile--slug`]: slug,
+    [`${prefix}--tile--slug-rounded`]: slug && hasRoundedCorners
+  }, className);
 
   // TODO: rename to handleClick when handleClick prop is deprecated
   function handleOnClick(evt) {
     evt.preventDefault();
     evt?.persist?.();
+    if (slug && slugRef.current && slugRef.current.contains(evt.target)) {
+      return;
+    }
     setIsSelected(!isSelected);
     clickHandler(evt);
     onChange(evt);
@@ -206,6 +265,16 @@ const SelectableTile = /*#__PURE__*/React__default.forwardRef(function Selectabl
     setIsSelected(selected);
     setPrevSelected(selected);
   }
+
+  // Slug is always size `xs`
+  const slugRef = useRef(null);
+  let normalizedSlug;
+  if (slug) {
+    normalizedSlug = /*#__PURE__*/React__default.cloneElement(slug, {
+      size: 'xs',
+      ref: slugRef
+    });
+  }
   return (
     /*#__PURE__*/
     // eslint-disable-next-line jsx-a11y/interactive-supports-focus
@@ -228,10 +297,9 @@ const SelectableTile = /*#__PURE__*/React__default.forwardRef(function Selectabl
       as: "label",
       htmlFor: id,
       className: `${prefix}--tile-content`
-    }, children))
+    }, children), normalizedSlug)
   );
 });
-SelectableTile.displayName = 'SelectableTile';
 SelectableTile.propTypes = {
   children: PropTypes.node,
   className: PropTypes.string,
@@ -239,6 +307,11 @@ SelectableTile.propTypes = {
    * Specify whether the SelectableTile should be disabled
    */
   disabled: PropTypes.bool,
+  /**
+   * **Experimental**: Specify if the `SelectableTile` component should be rendered with rounded corners.
+   * Only valid when `slug` prop is present
+   */
+  hasRoundedCorners: PropTypes.bool,
   /**
    * The ID of the `<input>`.
    */
@@ -269,6 +342,10 @@ SelectableTile.propTypes = {
    * `true` to select this tile.
    */
   selected: PropTypes.bool,
+  /**
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `SelectableTile` component
+   */
+  slug: PropTypes.node,
   /**
    * Specify the tab index of the wrapper element
    */
@@ -300,6 +377,8 @@ const ExpandableTile = /*#__PURE__*/React__default.forwardRef(function Expandabl
     tileCollapsedLabel,
     tileExpandedLabel,
     light,
+    slug,
+    hasRoundedCorners,
     ...rest
   } = _ref4;
   const [isTileMaxHeight, setIsTileMaxHeight] = useState(tileMaxHeight);
@@ -355,7 +434,12 @@ const ExpandableTile = /*#__PURE__*/React__default.forwardRef(function Expandabl
     [`${prefix}--tile--is-expanded`]: isExpanded,
     [`${prefix}--tile--light`]: light
   }, className);
-  const interactiveClassNames = cx(`${prefix}--tile`, `${prefix}--tile--expandable`, `${prefix}--tile--expandable--interactive`, isExpanded && `${prefix}--tile--is-expanded`, light && `${prefix}--tile--light`, className);
+  const interactiveClassNames = cx(`${prefix}--tile`, `${prefix}--tile--expandable`, `${prefix}--tile--expandable--interactive`, {
+    [`${prefix}--tile--is-expanded`]: isExpanded,
+    [`${prefix}--tile--light`]: light,
+    [`${prefix}--tile--slug`]: slug,
+    [`${prefix}--tile--slug-rounded`]: slug && hasRoundedCorners
+  }, className);
   const chevronInteractiveClassNames = cx(`${prefix}--tile__chevron`, `${prefix}--tile__chevron--interactive`);
   const childrenAsArray = getChildren();
   useIsomorphicEffect(() => {
@@ -381,10 +465,10 @@ const ExpandableTile = /*#__PURE__*/React__default.forwardRef(function Expandabl
 
     // Interactive elements or elements that are given a role should be treated
     // the same because elements with a role can not be rendered inside a `button`
-    if (!getInteractiveContent(belowTheFold.current) && !getRoleContent(belowTheFold.current) && !getInteractiveContent(aboveTheFold.current) && !getRoleContent(aboveTheFold.current)) {
+    if (!getInteractiveContent(belowTheFold.current) && !getRoleContent(belowTheFold.current) && !getInteractiveContent(aboveTheFold.current) && !getRoleContent(aboveTheFold.current) && !slug) {
       setInteractive(false);
     }
-  }, []);
+  }, [slug]);
   useIsomorphicEffect(() => {
     if (!tile.current) {
       return;
@@ -407,13 +491,21 @@ const ExpandableTile = /*#__PURE__*/React__default.forwardRef(function Expandabl
     return () => resizeObserver.disconnect();
   }, []);
   const belowTheFoldId = useId('expandable-tile-interactive');
+
+  // Slug is always size `xs`
+  let normalizedSlug;
+  if (slug) {
+    normalizedSlug = /*#__PURE__*/React__default.cloneElement(slug, {
+      size: 'xs'
+    });
+  }
   return interactive ? /*#__PURE__*/React__default.createElement("div", _extends({
     // @ts-expect-error: Needlesly strict & deep typing for the element type
     ref: ref,
     className: interactiveClassNames
   }, rest), /*#__PURE__*/React__default.createElement("div", {
     ref: tileContent
-  }, /*#__PURE__*/React__default.createElement("div", {
+  }, normalizedSlug, /*#__PURE__*/React__default.createElement("div", {
     ref: aboveTheFold,
     className: `${prefix}--tile-content`
   }, childrenAsArray[0]), /*#__PURE__*/React__default.createElement("button", {
@@ -459,6 +551,11 @@ ExpandableTile.propTypes = {
    * `true` if the tile is expanded.
    */
   expanded: PropTypes.bool,
+  /**
+   * Specify if the `ExpandableTile` component should be rendered with rounded corners.
+   * Only valid when `slug` prop is present
+   */
+  hasRoundedCorners: PropTypes.bool,
   /**
    * An ID that can be provided to aria-labelledby
    */
@@ -476,6 +573,10 @@ ExpandableTile.propTypes = {
    * optional handler to trigger a function when a key is pressed
    */
   onKeyUp: PropTypes.func,
+  /**
+   * **Experimental**: Provide a `Slug` component to be rendered inside the `ExpandableTile` component
+   */
+  slug: PropTypes.node,
   /**
    * The `tabindex` attribute.
    */

package/es/components/Tooltip/Tooltip.js

@@ -8,7 +8,7 @@
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import cx from 'classnames';
 import PropTypes from 'prop-types';
-import React__default, { useRef, useEffect } from 'react';
+import React__default, { useRef, useState, useCallback, useEffect } from 'react';
 import { Popover, PopoverContent } from '../Popover/index.js';
 import { useDelayedState } from '../../internal/useDelayedState.js';
 import { useId } from '../../internal/useId.js';
@@ -17,6 +17,10 @@ import { usePrefix } from '../../internal/usePrefix.js';
 import { match } from '../../internal/keyboard/match.js';
 import { Escape, Enter, Space } from '../../internal/keyboard/keys.js';
 
+/**
+ * Event types that trigger a "drag" to stop.
+ */
+const DRAG_STOP_EVENT_TYPES = new Set(['mouseup', 'touchend', 'touchcancel']);
 function Tooltip(_ref) {
   let {
     align = 'top',
@@ -33,6 +37,8 @@ function Tooltip(_ref) {
   const containerRef = useRef(null);
   const tooltipRef = useRef(null);
   const [open, setOpen] = useDelayedState(defaultOpen);
+  const [isDragging, setIsDragging] = useState(false);
+  const [isPointerIntersecting, setIsPointerIntersecting] = useState(false);
   const id = useId('tooltip');
   const prefix = usePrefix();
   const child = React__default.Children.only(children);
@@ -41,7 +47,11 @@ function Tooltip(_ref) {
     onBlur: () => setOpen(false),
     onClick: () => closeOnActivation && setOpen(false),
     // This should be placed on the trigger in case the element is disabled
-    onMouseEnter
+    onMouseEnter,
+    onMouseLeave,
+    onMouseDown: onDragStart,
+    onMouseMove: onMouseMove,
+    onTouchStart: onDragStart
   };
   function getChildEventHandlers(childProps) {
     const eventHandlerFunctions = ['onFocus', 'onBlur', 'onClick', 'onMouseEnter'];
@@ -71,11 +81,34 @@ function Tooltip(_ref) {
     }
   }
   function onMouseEnter() {
+    setIsPointerIntersecting(true);
     setOpen(true, enterDelayMs);
   }
   function onMouseLeave() {
+    setIsPointerIntersecting(false);
+    if (isDragging) {
+      return;
+    }
     setOpen(false, leaveDelayMs);
   }
+  function onMouseMove(evt) {
+    if (evt.buttons === 1) {
+      setIsDragging(true);
+    } else {
+      setIsDragging(false);
+    }
+  }
+  function onDragStart() {
+    setIsDragging(true);
+  }
+  const onDragStop = useCallback(() => {
+    setIsDragging(false);
+    // Close the tooltip, unless the mouse pointer is within the bounds of the
+    // trigger.
+    if (!isPointerIntersecting) {
+      setOpen(false, leaveDelayMs);
+    }
+  }, [isPointerIntersecting, leaveDelayMs, setOpen]);
   useNoInteractiveChildren(tooltipRef, 'The Tooltip component must have no interactive content rendered by the' + '`label` or `description` prop');
   useEffect(() => {
     if (containerRef !== null && containerRef.current) {
@@ -85,6 +118,19 @@ function Tooltip(_ref) {
       }
     }
   });
+  useEffect(() => {
+    if (isDragging) {
+      // Register drag stop handlers.
+      DRAG_STOP_EVENT_TYPES.forEach(eventType => {
+        document.addEventListener(eventType, onDragStop);
+      });
+    }
+    return () => {
+      DRAG_STOP_EVENT_TYPES.forEach(eventType => {
+        document.removeEventListener(eventType, onDragStop);
+      });
+    };
+  }, [isDragging, onDragStop]);
   return /*#__PURE__*/React__default.createElement(Popover, _extends({}, rest, {
     align: align,
     className: cx(`${prefix}--tooltip`, customClassName),