@carbon/react 1.84.0 → 1.85.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, { useContext, useRef, useState, useEffect, forwardRef } from 'react';
+import React, { useContext, useRef, useState, useEffect, forwardRef, cloneElement } from 'react';
 import cx from 'classnames';
 import deprecate from '../../prop-types/deprecate.js';
 import { WarningFilled, WarningAltFilled } from '@carbon/icons-react';
@@ -20,6 +20,8 @@ import { useMergedRefs } from '../../internal/useMergedRefs.js';
 import { useId } from '../../internal/useId.js';
 import { noopFn } from '../../internal/noopFn.js';
 import '../Text/index.js';
+import { AILabel } from '../AILabel/index.js';
+import { isComponentElement } from '../../internal/utils.js';
 import { Text } from '../Text/Text.js';
 
 const frFn = forwardRef;
@@ -258,12 +260,11 @@ const TextArea = frFn((props, forwardRef) => {
   }));
 
   // AILabel is always size `mini`
-  let normalizedDecorator = /*#__PURE__*/React.isValidElement(slug ?? decorator) ? slug ?? decorator : null;
-  if (normalizedDecorator && normalizedDecorator['type']?.displayName === 'AILabel') {
-    normalizedDecorator = /*#__PURE__*/React.cloneElement(normalizedDecorator, {
-      size: 'mini'
-    });
-  }
+  const candidate = slug ?? decorator;
+  const candidateIsAILabel = isComponentElement(candidate, AILabel);
+  const normalizedDecorator = candidateIsAILabel ? /*#__PURE__*/cloneElement(candidate, {
+    size: 'mini'
+  }) : null;
   return /*#__PURE__*/React.createElement("div", {
     className: formItemClasses
   }, /*#__PURE__*/React.createElement("div", {

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

@@ -4,7 +4,7 @@
  * 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, { ReactNode } from 'react';
+import React, { type ReactNode } from 'react';
 type ExcludedAttributes = 'defaultValue' | 'id' | 'size' | 'value';
 export interface TextInputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, ExcludedAttributes> {
     /**

package/es/components/TextInput/TextInput.js

@@ -6,16 +6,19 @@
  */
 
 import PropTypes from 'prop-types';
-import React, { useState, useContext, useRef, useEffect } from 'react';
+import React, { useRef, useState, useEffect, useContext, cloneElement } from 'react';
 import cx from 'classnames';
 import { useNormalizedInputProps } from '../../internal/useNormalizedInputProps.js';
 import deprecate from '../../prop-types/deprecate.js';
 import { textInputProps } from './util.js';
 import '../FluidForm/FluidForm.js';
 import { FormContext } from '../FluidForm/FormContext.js';
+import { useMergedRefs } from '../../internal/useMergedRefs.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { getAnnouncement } from '../../internal/getAnnouncement.js';
 import '../Text/index.js';
+import { AILabel } from '../AILabel/index.js';
+import { isComponentElement } from '../../internal/utils.js';
 import { Text } from '../Text/Text.js';
 
 const TextInput = /*#__PURE__*/React.forwardRef(function TextInput({
@@ -48,7 +51,16 @@ const TextInput = /*#__PURE__*/React.forwardRef(function TextInput({
     defaultValue,
     value
   } = rest;
-  const [textCount, setTextCount] = useState(defaultValue?.toString().length || value?.toString().length || 0);
+  const inputRef = useRef(null);
+  const mergedRef = useMergedRefs([ref, inputRef]);
+  function getInitialTextCount() {
+    const targetValue = defaultValue || value || inputRef.current?.value || '';
+    return targetValue.toString().length;
+  }
+  const [textCount, setTextCount] = useState(getInitialTextCount());
+  useEffect(() => {
+    setTextCount(getInitialTextCount());
+  }, [value, defaultValue, enableCounter]);
   const normalizedProps = useNormalizedInputProps({
     id,
     readOnly,
@@ -81,7 +93,7 @@ const TextInput = /*#__PURE__*/React.forwardRef(function TextInput({
     },
     placeholder,
     type,
-    ref,
+    ref: mergedRef,
     className: textInputClasses,
     title: placeholder,
     disabled: normalizedProps.disabled,
@@ -179,12 +191,11 @@ const TextInput = /*#__PURE__*/React.forwardRef(function TextInput({
   const Icon = normalizedProps.icon;
 
   // AILabel is always size `mini`
-  let normalizedDecorator = /*#__PURE__*/React.isValidElement(slug ?? decorator) ? slug ?? decorator : null;
-  if (normalizedDecorator && normalizedDecorator['type']?.displayName === 'AILabel') {
-    normalizedDecorator = /*#__PURE__*/React.cloneElement(normalizedDecorator, {
-      size: 'mini'
-    });
-  }
+  const candidate = slug ?? decorator;
+  const candidateIsAILabel = isComponentElement(candidate, AILabel);
+  const normalizedDecorator = candidateIsAILabel ? /*#__PURE__*/cloneElement(candidate, {
+    size: 'mini'
+  }) : null;
   return /*#__PURE__*/React.createElement("div", {
     className: inputWrapperClasses
   }, !inline ? labelWrapper : /*#__PURE__*/React.createElement("div", {

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

@@ -4,7 +4,7 @@
  * 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, { type ChangeEvent, type HTMLAttributes, type KeyboardEvent, type MouseEvent, type ReactNode } from 'react';
+import React, { type HTMLAttributes, type KeyboardEvent, type MouseEvent, type ReactNode } from 'react';
 export interface TileProps extends HTMLAttributes<HTMLDivElement> {
     children?: ReactNode;
     className?: string;
@@ -105,7 +105,7 @@ export interface SelectableTileProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * The empty handler of the `<input>`.
      */
-    onChange?(event: ChangeEvent<HTMLDivElement>, selected?: boolean, id?: string): void;
+    onChange?(event: MouseEvent<HTMLDivElement> | KeyboardEvent<HTMLDivElement>, selected?: boolean, id?: string): void;
     /**
      * Specify the function to run when the SelectableTile is clicked
      */

package/es/components/Tile/Tile.js

@@ -6,7 +6,7 @@
  */
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import React, { useState, useRef, useEffect } from 'react';
+import React, { useState, useEffect, useCallback, useRef, cloneElement } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { AiLabel, CheckboxCheckedFilled, Checkbox, ChevronDown, ArrowRight, Error } from '@carbon/icons-react';
@@ -22,6 +22,8 @@ import { useMergedRefs } from '../../internal/useMergedRefs.js';
 import { useFeatureFlag } from '../FeatureFlags/index.js';
 import { useId } from '../../internal/useId.js';
 import '../Text/index.js';
+import { AILabel } from '../AILabel/index.js';
+import { isComponentElement } from '../../internal/utils.js';
 import { Text } from '../Text/Text.js';
 
 var _CheckboxCheckedFille, _Checkbox, _ChevronDown, _ChevronDown2;
@@ -224,7 +226,11 @@ const SelectableTile = /*#__PURE__*/React.forwardRef(function SelectableTile({
   const clickHandler = onClick;
   const keyDownHandler = onKeyDown;
   const [isSelected, setIsSelected] = useState(selected);
-  const [prevSelected, setPrevSelected] = useState(selected);
+
+  // Use useEffect to sync with prop changes instead of render-time logic
+  useEffect(() => {
+    setIsSelected(selected);
+  }, [selected]);
   const classes = cx(`${prefix}--tile`, `${prefix}--tile--selectable`, {
     [`${prefix}--tile--is-selected`]: isSelected,
     [`${prefix}--tile--light`]: light,
@@ -234,50 +240,40 @@ const SelectableTile = /*#__PURE__*/React.forwardRef(function SelectableTile({
     [`${prefix}--tile--decorator`]: decorator,
     [`${prefix}--tile--decorator-rounded`]: decorator && hasRoundedCorners
   }, className);
+
+  // Single function to handle selection changes
+  const handleSelectionChange = useCallback((evt, newSelected) => {
+    setIsSelected(newSelected);
+    onChange(evt, newSelected, id);
+  }, [onChange, id]);
   function handleClick(evt) {
     evt.preventDefault();
     evt?.persist?.();
-    if (normalizedDecorator && decoratorRef.current && decoratorRef.current.contains(evt.target)) {
+    if (normalizedDecorator && decoratorRef.current && evt.target instanceof Node && decoratorRef.current.contains(evt.target)) {
       return;
     }
-    setIsSelected(prevSelected => {
-      const newSelected = !prevSelected;
-      onChange(evt, newSelected, id);
-      return newSelected;
-    });
+    const newSelected = !isSelected;
+    handleSelectionChange(evt, newSelected);
     clickHandler(evt);
   }
   function handleKeyDown(evt) {
     evt?.persist?.();
     if (matches(evt, [Enter, Space])) {
       evt.preventDefault();
-      setIsSelected(prevSelected => {
-        const newSelected = !prevSelected;
-        onChange(evt, newSelected, id);
-        return newSelected;
-      });
+      const newSelected = !isSelected;
+      handleSelectionChange(evt, newSelected);
     }
     keyDownHandler(evt);
   }
-  function handleChange(event) {
-    const newSelected = event.target.checked;
-    setIsSelected(newSelected);
-    onChange(event, newSelected, id);
-  }
-  if (selected !== prevSelected) {
-    setIsSelected(selected);
-    setPrevSelected(selected);
-  }
 
   // AILabel is always size `xs`
   const decoratorRef = useRef(null);
-  let normalizedDecorator = /*#__PURE__*/React.isValidElement(slug ?? decorator) ? slug ?? decorator : null;
-  if (normalizedDecorator && normalizedDecorator['type']?.displayName === 'AILabel') {
-    normalizedDecorator = /*#__PURE__*/React.cloneElement(normalizedDecorator, {
-      size: 'xs',
-      ref: decoratorRef
-    });
-  }
+  const candidate = slug ?? decorator;
+  const candidateIsAILabel = isComponentElement(candidate, AILabel);
+  const normalizedDecorator = candidateIsAILabel ? /*#__PURE__*/cloneElement(candidate, {
+    size: 'xs',
+    ref: decoratorRef
+  }) : null;
   return (
     /*#__PURE__*/
     // eslint-disable-next-line jsx-a11y/interactive-supports-focus
@@ -292,7 +288,6 @@ const SelectableTile = /*#__PURE__*/React.forwardRef(function SelectableTile({
       tabIndex: !disabled ? tabIndex : undefined,
       ref: ref,
       id: id,
-      onChange: !disabled ? handleChange : undefined,
       title: title
     }, rest), /*#__PURE__*/React.createElement("span", {
       className: `${prefix}--tile__checkmark ${prefix}--tile__checkmark--persistent`
@@ -505,12 +500,11 @@ const ExpandableTile = /*#__PURE__*/React.forwardRef(function ExpandableTile({
   const belowTheFoldId = useId('expandable-tile-interactive');
 
   // AILabel is always size `xs`
-  let normalizedDecorator = /*#__PURE__*/React.isValidElement(slug ?? decorator) ? slug ?? decorator : null;
-  if (normalizedDecorator && normalizedDecorator['type']?.displayName === 'AILabel') {
-    normalizedDecorator = /*#__PURE__*/React.cloneElement(normalizedDecorator, {
-      size: 'xs'
-    });
-  }
+  const candidate = slug ?? decorator;
+  const candidateIsAILabel = isComponentElement(candidate, AILabel);
+  const normalizedDecorator = candidateIsAILabel ? /*#__PURE__*/cloneElement(candidate, {
+    size: 'xs'
+  }) : null;
   return interactive ? /*#__PURE__*/React.createElement("div", _extends({
     ref: ref,
     className: interactiveClassNames

package/es/components/Toggletip/index.js

@@ -88,6 +88,7 @@ function Toggletip({
     buttonProps: {
       'aria-expanded': open,
       'aria-controls': id,
+      'aria-describedby': open ? id : undefined,
       onClick: actions.toggle
     },
     contentProps: {
@@ -259,8 +260,7 @@ const ToggletipContent = /*#__PURE__*/React.forwardRef(function ToggletipContent
   return /*#__PURE__*/React.createElement(PopoverContent, _extends({
     className: customClassName
   }, toggletip?.contentProps, {
-    ref: ref,
-    "aria-live": "polite"
+    ref: ref
   }), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--toggletip-content`
   }, children));

package/es/components/Tooltip/DefinitionTooltip.js

@@ -57,6 +57,7 @@ const DefinitionTooltip = ({
   }, /*#__PURE__*/React.createElement("button", _extends({}, rest, {
     className: cx(`${prefix}--definition-term`, triggerClassName),
     "aria-controls": tooltipId,
+    "aria-describedby": tooltipId,
     "aria-expanded": isOpen,
     onBlur: () => {
       setOpen(false);

package/es/components/Tooltip/Tooltip.d.ts

@@ -4,7 +4,7 @@
  * 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, { type JSX } from 'react';
 import { Popover, PopoverAlignment } from '../Popover';
 import { PolymorphicComponentPropWithRef } from '../../internal/PolymorphicProps';
 interface TooltipBaseProps {
@@ -15,7 +15,7 @@ interface TooltipBaseProps {
     /**
      * Pass in the child to which the tooltip will be applied
      */
-    children?: React.ReactElement<any>;
+    children?: React.ReactElement<JSX.IntrinsicElements[keyof JSX.IntrinsicElements]>;
     /**
      * Specify an optional className to be applied to the container node
      */

package/es/components/Tooltip/Tooltip.js

@@ -55,7 +55,7 @@ const Tooltip = /*#__PURE__*/React.forwardRef(({
 
   // An `aria-label` takes precedence over `aria-describedby`, but when it's
   // needed and the user doesn't specify one, the fallback `id` is used.
-  const labelledBy = hasAriaLabel ? null : hasLabel ? ariaLabelledBy ?? id : undefined;
+  const labelledBy = hasAriaLabel ? undefined : hasLabel ? ariaLabelledBy ?? id : undefined;
 
   // If `aria-label` is present, use any provided `aria-describedby`.
   // If not, fallback to child's `aria-describedby` or the tooltip `id` if needed.
@@ -175,7 +175,7 @@ const Tooltip = /*#__PURE__*/React.forwardRef(({
     open: open
   }), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--tooltip-trigger__wrapper`
-  }, child !== undefined ? /*#__PURE__*/React.cloneElement(child, {
+  }, typeof child !== 'undefined' ? /*#__PURE__*/React.cloneElement(child, {
     ...triggerProps,
     ...getChildEventHandlers(child.props)
   }) : null), /*#__PURE__*/React.createElement(PopoverContent, {

package/es/components/TreeView/TreeNode.d.ts

@@ -78,6 +78,17 @@ export type TreeNodeProps = {
      * Optional: The URL the TreeNode is linking to
      */
     href?: string;
+    /**
+     *
+     * Specify how the trigger should align with the tooltip when text is truncated
+     */
+    align?: 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'left-end' | 'left-start' | 'right-end' | 'right-start';
+    /**
+     * **Experimental**: Will attempt to automatically align the floating
+     * element to avoid collisions with the viewport and being clipped by
+     * ancestor elements.
+     */
+    autoAlign?: boolean;
 } & Omit<React.LiHTMLAttributes<HTMLElement>, 'onSelect'>;
 declare const TreeNode: React.ForwardRefExoticComponent<{
     /**
@@ -152,5 +163,16 @@ declare const TreeNode: React.ForwardRefExoticComponent<{
      * Optional: The URL the TreeNode is linking to
      */
     href?: string;
+    /**
+     *
+     * Specify how the trigger should align with the tooltip when text is truncated
+     */
+    align?: "top" | "bottom" | "left" | "right" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-end" | "left-start" | "right-end" | "right-start";
+    /**
+     * **Experimental**: Will attempt to automatically align the floating
+     * element to avoid collisions with the viewport and being clipped by
+     * ancestor elements.
+     */
+    autoAlign?: boolean;
 } & Omit<React.LiHTMLAttributes<HTMLElement>, "onSelect"> & React.RefAttributes<HTMLElement>>;
 export default TreeNode;

package/es/components/TreeView/TreeNode.js

@@ -9,14 +9,83 @@ import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js
 import { CaretDown } from '@carbon/icons-react';
 import cx from 'classnames';
 import PropTypes from 'prop-types';
-import React, { useRef, useState, useEffect } from 'react';
+import React, { useRef, useState, useEffect, useCallback } from 'react';
 import { ArrowLeft, ArrowRight, Enter, Space } from '../../internal/keyboard/keys.js';
 import { matches, match } from '../../internal/keyboard/match.js';
 import { useControllableState } from '../../internal/useControllableState.js';
 import { usePrefix } from '../../internal/usePrefix.js';
-import { uniqueId } from '../../tools/uniqueId.js';
+import { useId } from '../../internal/useId.js';
 import { useFeatureFlag } from '../FeatureFlags/index.js';
+import { IconButton } from '../IconButton/index.js';
 
+const extractTextContent = node => {
+  if (node === null || node === undefined) return '';
+  if (typeof node === 'string') return node;
+  if (typeof node === 'number') return String(node);
+  if (typeof node === 'boolean') return String(node);
+  if (Array.isArray(node)) {
+    return node.map(extractTextContent).join('');
+  }
+  if (/*#__PURE__*/React.isValidElement(node)) {
+    const element = node;
+    const children = element.props.children;
+    return extractTextContent(children);
+  }
+  return '';
+};
+const useEllipsisCheck = (label, detailsWrapperRef) => {
+  const [isEllipsisApplied, setIsEllipsisApplied] = useState(false);
+  const labelTextRef = useRef(null);
+  const checkEllipsis = useCallback(() => {
+    const element = labelTextRef.current;
+    if (!element) {
+      setIsEllipsisApplied(false);
+      return;
+    }
+    if (element.offsetWidth === 0) {
+      setIsEllipsisApplied(false);
+      return;
+    }
+    const checkElement = detailsWrapperRef.current || element;
+    if (checkElement && checkElement.offsetWidth > 0) {
+      const isTextTruncated = element.scrollWidth > checkElement.offsetWidth;
+      setIsEllipsisApplied(isTextTruncated);
+    } else {
+      setIsEllipsisApplied(false);
+    }
+  }, [detailsWrapperRef]);
+  useEffect(() => {
+    let animationFrameId;
+    animationFrameId = requestAnimationFrame(checkEllipsis);
+    let resizeObserver;
+    if (typeof window !== 'undefined' && typeof window.ResizeObserver !== 'undefined' && labelTextRef.current) {
+      resizeObserver = new window.ResizeObserver(() => {
+        requestAnimationFrame(checkEllipsis);
+      });
+      resizeObserver.observe(labelTextRef.current);
+      if (detailsWrapperRef.current) {
+        resizeObserver.observe(detailsWrapperRef.current);
+      }
+    }
+    return () => {
+      cancelAnimationFrame(animationFrameId);
+      if (resizeObserver) {
+        if (labelTextRef.current) {
+          resizeObserver.unobserve(labelTextRef.current);
+        }
+        if (detailsWrapperRef.current) {
+          resizeObserver.unobserve(detailsWrapperRef.current);
+        }
+        resizeObserver.disconnect();
+      }
+    };
+  }, [checkEllipsis, detailsWrapperRef]);
+  return {
+    labelTextRef,
+    isEllipsisApplied,
+    tooltipText: extractTextContent(label)
+  };
+};
 const TreeNode = /*#__PURE__*/React.forwardRef(({
   active,
   children,
@@ -35,15 +104,22 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
   selected: propSelected,
   value,
   href,
+  align = 'bottom',
+  autoAlign = false,
   ...rest
 }, forwardedRef) => {
-  // These are provided by the parent TreeView component
   const depth = propDepth;
   const selected = propSelected;
+  const detailsWrapperRef = useRef(null);
+  const {
+    labelTextRef,
+    isEllipsisApplied,
+    tooltipText
+  } = useEllipsisCheck(label, detailsWrapperRef);
   const enableTreeviewControllable = useFeatureFlag('enable-treeview-controllable');
   const {
     current: id
-  } = useRef(nodeId || uniqueId());
+  } = useRef(nodeId || useId());
   const controllableExpandedState = useControllableState({
     value: isExpanded,
     onChange: newValue => {
@@ -61,6 +137,25 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
   const currentNode = useRef(null);
   const currentNodeLabel = useRef(null);
   const prefix = usePrefix();
+  const renderLabelText = () => {
+    if (isEllipsisApplied && tooltipText) {
+      return /*#__PURE__*/React.createElement(IconButton, {
+        label: tooltipText,
+        kind: "ghost",
+        align: align,
+        autoAlign: autoAlign,
+        className: `${prefix}--tree-node__label__text-button`,
+        wrapperClasses: `${prefix}--popover-container`
+      }, /*#__PURE__*/React.createElement("span", {
+        ref: labelTextRef,
+        className: `${prefix}--tree-node__label__text`
+      }, label));
+    }
+    return /*#__PURE__*/React.createElement("span", {
+      ref: labelTextRef,
+      className: `${prefix}--tree-node__label__text`
+    }, label);
+  };
   const setRefs = element => {
     currentNode.current = element;
     if (typeof forwardedRef === 'function') {
@@ -72,7 +167,7 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
   function enhanceTreeNodes(children) {
     return React.Children.map(children, node => {
       if (! /*#__PURE__*/React.isValidElement(node)) return node;
-      const isTreeNode = node.type.displayName === 'TreeNode';
+      const isTreeNode = node.type === TreeNode;
       if (isTreeNode) {
         return /*#__PURE__*/React.cloneElement(node, {
           active,
@@ -300,7 +395,7 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
         ref: currentNodeLabel
       }, Icon && /*#__PURE__*/React.createElement(Icon, {
         className: `${prefix}--tree-node__icon`
-      }), label)));
+      }), renderLabelText())));
     } else {
       return /*#__PURE__*/React.createElement("li", _extends({}, treeNodeProps, {
         ref: setRefs
@@ -309,7 +404,7 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
         ref: currentNodeLabel
       }, Icon && /*#__PURE__*/React.createElement(Icon, {
         className: `${prefix}--tree-node__icon`
-      }), label));
+      }), renderLabelText()));
     }
   }
   if (href) {
@@ -332,10 +427,11 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
     }, /*#__PURE__*/React.createElement(CaretDown, {
       className: toggleClasses
     })), /*#__PURE__*/React.createElement("span", {
-      className: `${prefix}--tree-node__label__details`
+      className: `${prefix}--tree-node__label__details`,
+      ref: detailsWrapperRef
     }, Icon && /*#__PURE__*/React.createElement(Icon, {
       className: `${prefix}--tree-node__icon`
-    }), label))), /*#__PURE__*/React.createElement("ul", {
+    }), renderLabelText()))), /*#__PURE__*/React.createElement("ul", {
       id: `${id}-subtree`,
       role: "group",
       className: cx(`${prefix}--tree-node__children`, {
@@ -358,10 +454,11 @@ const TreeNode = /*#__PURE__*/React.forwardRef(({
     }, /*#__PURE__*/React.createElement(CaretDown, {
       className: toggleClasses
     })), /*#__PURE__*/React.createElement("span", {
-      className: `${prefix}--tree-node__label__details`
+      className: `${prefix}--tree-node__label__details`,
+      ref: detailsWrapperRef
     }, Icon && /*#__PURE__*/React.createElement(Icon, {
       className: `${prefix}--tree-node__icon`
-    }), label)), /*#__PURE__*/React.createElement("ul", {
+    }), renderLabelText())), /*#__PURE__*/React.createElement("ul", {
       id: `${id}-subtree`,
       role: "group",
       className: cx(`${prefix}--tree-node__children`, {
@@ -444,7 +541,17 @@ TreeNode.propTypes = {
   /**
    * Optional: The URL the TreeNode is linking to
    */
-  href: PropTypes.string
+  href: PropTypes.string,
+  /**
+   * Specify how the tooltip should align when text is truncated
+   */
+  align: PropTypes.oneOf(['top', 'bottom', 'left', 'right', 'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
+  /**
+   * **Experimental**: Will attempt to automatically align the floating
+   * element to avoid collisions with the viewport and being clipped by
+   * ancestor elements.
+   */
+  autoAlign: PropTypes.bool
 };
 TreeNode.displayName = 'TreeNode';
 

package/es/components/TreeView/TreeView.js

@@ -13,7 +13,7 @@ import { ArrowUp, ArrowDown, Home, End } from '../../internal/keyboard/keys.js';
 import { matches, match } from '../../internal/keyboard/match.js';
 import { useControllableState } from '../../internal/useControllableState.js';
 import { usePrefix } from '../../internal/usePrefix.js';
-import { uniqueId } from '../../tools/uniqueId.js';
+import { useId } from '../../internal/useId.js';
 import { useFeatureFlag } from '../FeatureFlags/index.js';
 import TreeNode from './TreeNode.js';
 
@@ -33,7 +33,7 @@ const TreeView = ({
   const enableTreeviewControllable = useFeatureFlag('enable-treeview-controllable');
   const {
     current: treeId
-  } = useRef(rest.id || uniqueId());
+  } = useRef(rest.id || useId());
   const prefix = usePrefix();
   const treeClasses = cx(className, `${prefix}--tree`, {
     // @ts-ignore - will always be false according to prop types
@@ -112,7 +112,7 @@ const TreeView = ({
   function enhanceTreeNodes(children) {
     return React.Children.map(children, child => {
       if (! /*#__PURE__*/React.isValidElement(child)) return child;
-      const isTreeNode = child.type.displayName === 'TreeNode';
+      const isTreeNode = child.type === TreeNode;
       if (isTreeNode) {
         const node = child;
         const sharedNodeProps = {

package/es/components/UIShell/Content.d.ts

@@ -75,6 +75,8 @@ declare const Content: {
         inert?: boolean | undefined;
         inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined;
         is?: string | undefined;
+        exportparts?: string | undefined;
+        part?: string | undefined;
         "aria-activedescendant"?: string | undefined;
         "aria-atomic"?: (boolean | "true" | "false") | undefined;
         "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined;
@@ -149,7 +151,7 @@ declare const Content: {
         onBlurCapture?: React.FocusEventHandler<HTMLElement> | undefined;
         onChange?: React.FormEventHandler<HTMLElement> | undefined;
         onChangeCapture?: React.FormEventHandler<HTMLElement> | undefined;
-        onBeforeInput?: React.FormEventHandler<HTMLElement> | undefined;
+        onBeforeInput?: React.InputEventHandler<HTMLElement> | undefined;
         onBeforeInputCapture?: React.FormEventHandler<HTMLElement> | undefined;
         onInput?: React.FormEventHandler<HTMLElement> | undefined;
         onInputCapture?: React.FormEventHandler<HTMLElement> | undefined;
@@ -199,8 +201,6 @@ declare const Content: {
         onProgressCapture?: React.ReactEventHandler<HTMLElement> | undefined;
         onRateChange?: React.ReactEventHandler<HTMLElement> | undefined;
         onRateChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
-        onResize?: React.ReactEventHandler<HTMLElement> | undefined;
-        onResizeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
         onSeeked?: React.ReactEventHandler<HTMLElement> | undefined;
         onSeekedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
         onSeeking?: React.ReactEventHandler<HTMLElement> | undefined;
@@ -281,6 +281,8 @@ declare const Content: {
         onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLElement> | undefined;
         onScroll?: React.UIEventHandler<HTMLElement> | undefined;
         onScrollCapture?: React.UIEventHandler<HTMLElement> | undefined;
+        onScrollEnd?: React.UIEventHandler<HTMLElement> | undefined;
+        onScrollEndCapture?: React.UIEventHandler<HTMLElement> | undefined;
         onWheel?: React.WheelEventHandler<HTMLElement> | undefined;
         onWheelCapture?: React.WheelEventHandler<HTMLElement> | undefined;
         onAnimationStart?: React.AnimationEventHandler<HTMLElement> | undefined;

package/es/components/UIShell/HeaderPanel.d.ts

@@ -1,10 +1,10 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2025
  *
  * 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, { ReactNode } from 'react';
+import React, { type ReactNode } from 'react';
 export interface HeaderPanelProps {
     /**
      * Specify whether focus and blur listeners are added. They are by default.