@carbon/react 1.78.2 → 1.79.0-rc.0

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

@@ -1,13 +1,13 @@
 /**
- * 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 { type OverflowMenuProps } from './OverflowMenu';
-declare function OverflowMenu(props: any): import("react/jsx-runtime").JSX.Element;
-declare namespace OverflowMenu {
-    var displayName: string;
-}
+declare const OverflowMenu: {
+    (props: OverflowMenuProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
 export default OverflowMenu;
 export { OverflowMenu, type OverflowMenuProps };

package/es/components/OverflowMenu/index.js

@@ -12,10 +12,10 @@ import { OverflowMenu as OverflowMenu$1 } from './OverflowMenu.js';
 import { createClassWrapper } from '../../internal/createClassWrapper.js';
 
 const OverflowMenuV11 = createClassWrapper(OverflowMenu$1);
-function OverflowMenu(props) {
+const OverflowMenu = props => {
   const enableV12OverflowMenu = useFeatureFlag('enable-v12-overflowmenu');
   return enableV12OverflowMenu ? /*#__PURE__*/React__default.createElement(OverflowMenu$2, props) : /*#__PURE__*/React__default.createElement(OverflowMenuV11, props);
-}
+};
 OverflowMenu.displayName = 'OverflowMenu';
 
 export { OverflowMenu, OverflowMenu as default };

package/es/components/OverflowMenu/next/index.d.ts

@@ -1,10 +1,10 @@
 /**
- * Copyright IBM Corp. 2020, 2023
+ * Copyright IBM Corp. 2020, 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, { type ComponentType, type FunctionComponent } from 'react';
+import React, { type ElementType } from 'react';
 interface OverflowMenuProps {
     /**
      * **Experimental**: Will attempt to automatically align the floating element to avoid collisions with the viewport and being clipped by ancestor elements.
@@ -27,9 +27,9 @@ interface OverflowMenuProps {
      */
     menuAlignment?: 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
     /**
-     * Optionally provide a custom icon to be rendered on the trigger button.
+     * A component used to render an icon.
      */
-    renderIcon?: ComponentType | FunctionComponent;
+    renderIcon?: ElementType;
     /**
      * Specify the size of the menu, from a list of available sizes.
      */

package/es/components/OverflowMenu/next/index.js

@@ -165,7 +165,7 @@ OverflowMenu.propTypes = {
    */
   menuAlignment: PropTypes.oneOf(['top-start', 'top-end', 'bottom-start', 'bottom-end']),
   /**
-   * Optionally provide a custom icon to be rendered on the trigger button.
+   * A component used to render an icon.
    */
   // @ts-expect-error: PropTypes are not expressive enough to cover this case
   renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),

package/es/components/OverflowMenuItem/OverflowMenuItem.js

@@ -9,12 +9,12 @@ import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js
 import cx from 'classnames';
 import PropTypes from 'prop-types';
 import React__default from 'react';
+import { ArrowDown, ArrowUp } from '../../internal/keyboard/keys.js';
+import { match } from '../../internal/keyboard/match.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { warning } from '../../internal/warning.js';
 import '../Text/index.js';
-import { match } from '../../internal/keyboard/match.js';
 import { Text } from '../Text/Text.js';
-import { ArrowDown, ArrowUp } from '../../internal/keyboard/keys.js';
 
 const OverflowMenuItem = /*#__PURE__*/React__default.forwardRef(function OverflowMenuItem(_ref, ref) {
   let {

package/es/components/ProgressIndicator/ProgressIndicator.js

@@ -9,12 +9,12 @@ import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js
 import cx from 'classnames';
 import PropTypes from 'prop-types';
 import React__default, { useState } from 'react';
+import { Enter, Space } from '../../internal/keyboard/keys.js';
+import { matches } from '../../internal/keyboard/match.js';
 import { Warning, Incomplete, CheckmarkOutline, CircleDash } from '@carbon/icons-react';
 import { usePrefix } from '../../internal/usePrefix.js';
 import '../Text/index.js';
-import { matches } from '../../internal/keyboard/match.js';
 import { Text } from '../Text/Text.js';
-import { Enter, Space } from '../../internal/keyboard/keys.js';
 
 const defaultTranslations = {
   'carbon.progress-step.complete': 'Complete',

package/es/components/RadioTile/RadioTile.js

@@ -10,15 +10,15 @@ import { RadioButtonChecked, RadioButton, CheckmarkFilled } from '@carbon/icons-
 import cx from 'classnames';
 import PropTypes from 'prop-types';
 import React__default from 'react';
+import { Enter, Space } from '../../internal/keyboard/keys.js';
+import { matches } from '../../internal/keyboard/match.js';
 import { useFallbackId } from '../../internal/useId.js';
 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 { matches } from '../../internal/keyboard/match.js';
 import { Text } from '../Text/Text.js';
-import { Enter, Space } from '../../internal/keyboard/keys.js';
 
 var _RadioButtonChecked, _RadioButton, _CheckmarkFilled;
 const RadioTile = /*#__PURE__*/React__default.forwardRef(function RadioTile(_ref, ref) {

package/es/components/Search/Search.d.ts

@@ -1,5 +1,5 @@
 /**
- * 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.
@@ -62,8 +62,7 @@ export interface SearchProps extends InputPropsBase {
      */
     placeholder?: string;
     /**
-     * Rendered icon for the Search.
-     * Can be a React component class
+     * A component used to render an icon.
      */
     renderIcon?: ComponentType | FunctionComponent;
     /**

package/es/components/Search/Search.js

@@ -10,7 +10,8 @@ import { Close, Search as Search$1 } from '@carbon/icons-react';
 import cx from 'classnames';
 import PropTypes from 'prop-types';
 import React__default, { useContext, useRef, useState } from 'react';
-import { focus } from '../../internal/focus/index.js';
+import { Escape, Enter, Space } from '../../internal/keyboard/keys.js';
+import { match } from '../../internal/keyboard/match.js';
 import { useId } from '../../internal/useId.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { composeEventHandlers } from '../../tools/events.js';
@@ -18,8 +19,6 @@ import { useMergedRefs } from '../../internal/useMergedRefs.js';
 import deprecate from '../../prop-types/deprecate.js';
 import '../FluidForm/FluidForm.js';
 import { FormContext } from '../FluidForm/FormContext.js';
-import { match } from '../../internal/keyboard/match.js';
-import { Escape, Enter, Space } from '../../internal/keyboard/keys.js';
 
 var _Close;
 const Search = /*#__PURE__*/React__default.forwardRef(function Search(_ref, forwardRef) {
@@ -90,7 +89,7 @@ const Search = /*#__PURE__*/React__default.forwardRef(function Search(_ref, forw
     onChange(clearedEvt);
     onClear();
     setHasContent(false);
-    focus(inputRef);
+    inputRef.current?.focus();
   }
   function handleChange(event) {
     setHasContent(event.target.value !== '');
@@ -221,8 +220,7 @@ Search.propTypes = {
    */
   placeholder: PropTypes.string,
   /**
-   * Rendered icon for the Search.
-   * Can be a React component class
+   * A component used to render an icon.
    */
   // @ts-expect-error: PropTypes are not expressive enough to cover this case
   renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),

package/es/components/Slider/Slider.d.ts

@@ -1,5 +1,5 @@
 /**
- * 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.
@@ -164,11 +164,6 @@ export interface SliderProps extends Omit<React.InputHTMLAttributes<HTMLInputEle
      */
     warnText?: React.ReactNode;
 }
-interface CalcValueProps {
-    clientX?: number;
-    value?: number;
-    useRawValue?: boolean;
-}
 interface CalcLeftPercentProps {
     clientX?: number;
     value?: number;
@@ -355,11 +350,13 @@ declare class Slider extends PureComponent<SliderProps> {
      */
     clamp(val: any, min: any, max: any): number;
     /**
-     * Takes a value and ensures it fits to the steps of the range
-     * @param value
-     * @returns value of the nearest step
+     * Rounds a given value to the nearest step defined by the slider's `step`
+     * prop.
+     *
+     * @param value - The value to adjust to the nearest step. Defaults to `0`.
+     * @returns The value rounded to the precision determined by the step.
      */
-    nearestStepValue(value: any): number;
+    nearestStepValue(value?: number): number;
     /**
      * Sets up "drag" event handlers and calls `this.onDrag` in case dragging
      * started on somewhere other than the thumb without a corresponding "move"
@@ -413,46 +410,44 @@ declare class Slider extends PureComponent<SliderProps> {
     onInputKeyDown: (evt: any) => void;
     processNewInputValue: (input: HTMLInputElement) => void;
     calcLeftPercent: ({ clientX, value, range }: CalcLeftPercentProps) => number;
-    calcSteppedValuePercent: ({ leftPercent, range }: {
-        leftPercent: any;
-        range: any;
-    }) => number[];
-    /**
-     * Calculates a new Slider `value` and `left` (thumb offset) given a `clientX`,
-     * `value`, or neither of those.
-     * - If `clientX` is specified, it will be used in
-     *   conjunction with the Slider's bounding rectangle to calculate the new
-     *   values.
-     * - If `clientX` is not specified and `value` is, it will be used to
-     *   calculate new values as though it were the current value of the Slider.
-     * - If neither `clientX` nor `value` are specified, `this.props.value` will
-     *   be used to calculate the new values as though it were the current value
-     *   of the Slider.
-     *
-     * @param {object} params
-     * @param {number} [params.clientX] Optional clientX value expected to be from
-     *   an event fired by one of the Slider's `DRAG_EVENT_TYPES` events.
-     * @param {number} [params.value] Optional value use during calculations if
-     *   clientX is not provided.
-     * @param {boolean} [params.useRawValue=false] `true` to use the given value as-is.
-     */
-    calcValue: ({ clientX, value, useRawValue }: CalcValueProps) => {
+    /**
+     * Calculates the discrete value (snapped to the nearest step) along
+     * with the corresponding handle position percentage.
+     */
+    calcDiscreteValueAndPercent: ({ leftPercent, }: {
+        /** The percentage representing the position on the track. */
+        leftPercent: number;
+    }) => {
+        discreteValue: number;
+        discretePercent: number;
+    };
+    /**
+     * Calculates the slider's value and handle position based on either a
+     * mouse/touch event or an explicit value.
+     */
+    calcValue: ({ clientX, value, useRawValue, }: {
+        /** The x-coordinate from a mouse/touch event. */
+        clientX?: number;
+        /** Value to base the calculations on (if no `clientX`). */
+        value?: number;
+        /** Whether to bypass the stepping logic and use the raw value. */
+        useRawValue?: boolean;
+    }) => {
         value: number | undefined;
         left: number;
     };
     calcDistanceToHandle: (handle: HandlePosition, clientX: any) => number;
     /**
-     * Given the current value, delta and step, calculate the new value.
+     * Calculates a new slider value based on the current value, a change delta,
+     * and a step.
      *
-     * @param {number} currentValue
-     *   Current value user is moving from.
-     * @param {number} delta
-     *   Movement from the current value. Can be positive or negative.
-     * @param {number} step
-     *   A value determining how much the value should increase/decrease by moving
-     *   the thumb by mouse.
-     */
-    calcValueForDelta: (currentValue: any, delta: any, step?: number) => any;
+     * @param currentValue - The starting value from which the slider is moving.
+     * @param delta - The amount to adjust the current value by.
+     * @param step - The step. Defaults to `1`.
+     * @returns The new slider value, rounded to the same number of decimal places
+     *          as the step.
+     */
+    calcValueForDelta: (currentValue: number, delta: number, step?: number) => number;
     /**
      * Sets state relevant to the given handle position.
      *

package/es/components/Slider/Slider.js

@@ -10,6 +10,7 @@ import React__default, { PureComponent } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { ArrowDown, ArrowLeft, ArrowUp, ArrowRight, Enter } from '../../internal/keyboard/keys.js';
+import { matches } from '../../internal/keyboard/match.js';
 import { PrefixContext } from '../../internal/usePrefix.js';
 import deprecate from '../../prop-types/deprecate.js';
 import { FeatureFlagContext } from '../FeatureFlags/index.js';
@@ -19,7 +20,6 @@ import '../Tooltip/DefinitionTooltip.js';
 import { Tooltip } from '../Tooltip/Tooltip.js';
 import { LowerHandle, LowerHandleFocus, UpperHandle, UpperHandleFocus } from './SliderHandles.js';
 import { throttle } from '../../node_modules/es-toolkit/dist/compat/function/throttle.mjs.js';
-import { matches } from '../../internal/keyboard/match.js';
 import { Text } from '../Text/Text.js';
 
 const ThumbWrapper = _ref => {
@@ -316,7 +316,7 @@ class Slider extends PureComponent {
           value,
           left
         } = this.calcValue({
-          value: this.calcValueForDelta(currentValue, delta, this.props.step)
+          value: this.calcValueForDelta(currentValue ?? this.props.min, delta, this.props.step)
         });
         this.setValueLeftForHandle(this.state.activeHandle, {
           value: this.nearestStepValue(value),
@@ -523,67 +523,65 @@ class Slider extends PureComponent {
       // re-assure Typescript, return 0.
       return 0;
     });
-    _defineProperty(this, "calcSteppedValuePercent", _ref3 => {
+    /**
+     * Calculates the discrete value (snapped to the nearest step) along
+     * with the corresponding handle position percentage.
+     */
+    _defineProperty(this, "calcDiscreteValueAndPercent", _ref3 => {
       let {
-        leftPercent,
-        range
+        leftPercent
       } = _ref3;
       const {
-        step = 1
+        step = 1,
+        min,
+        max
       } = this.props;
-      const totalSteps = range / step;
-      let steppedValue = Math.round(leftPercent * totalSteps) * step;
-      const steppedPercent = this.clamp(steppedValue / range, 0, 1);
-      steppedValue = this.clamp(steppedValue + this.props.min, this.props.min, this.props.max);
-      return [steppedValue, steppedPercent];
+      const numSteps = Math.floor((max - min) / step) + ((max - min) % step === 0 ? 1 : 2);
+      /** Index of the step that corresponds to `leftPercent`. */
+      const stepIndex = Math.round(leftPercent * (numSteps - 1));
+      const discreteValue = stepIndex === numSteps - 1 ? max : min + step * stepIndex;
+      /** Percentage corresponding to the step index. */
+      const discretePercent = stepIndex / (numSteps - 1);
+      return {
+        discreteValue,
+        discretePercent
+      };
     });
     /**
-     * Calculates a new Slider `value` and `left` (thumb offset) given a `clientX`,
-     * `value`, or neither of those.
-     * - If `clientX` is specified, it will be used in
-     *   conjunction with the Slider's bounding rectangle to calculate the new
-     *   values.
-     * - If `clientX` is not specified and `value` is, it will be used to
-     *   calculate new values as though it were the current value of the Slider.
-     * - If neither `clientX` nor `value` are specified, `this.props.value` will
-     *   be used to calculate the new values as though it were the current value
-     *   of the Slider.
-     *
-     * @param {object} params
-     * @param {number} [params.clientX] Optional clientX value expected to be from
-     *   an event fired by one of the Slider's `DRAG_EVENT_TYPES` events.
-     * @param {number} [params.value] Optional value use during calculations if
-     *   clientX is not provided.
-     * @param {boolean} [params.useRawValue=false] `true` to use the given value as-is.
+     * Calculates the slider's value and handle position based on either a
+     * mouse/touch event or an explicit value.
      */
     _defineProperty(this, "calcValue", _ref4 => {
       let {
         clientX,
         value,
-        useRawValue = false
+        useRawValue
       } = _ref4;
       const range = this.props.max - this.props.min;
-
-      // @todo solve for rtl.
-      const leftPercent = this.calcLeftPercent({
+      const leftPercentRaw = this.calcLeftPercent({
         clientX,
         value,
         range
       });
+      /** `leftPercentRaw` clamped between 0 and 1. */
+      const leftPercent = Math.min(1, Math.max(0, leftPercentRaw));
       if (useRawValue) {
-        // Adjusts only for min/max of thumb position
         return {
           value,
-          left: Math.min(1, Math.max(0, leftPercent)) * 100
+          left: leftPercent * 100
         };
       }
-      const [steppedValue, steppedPercent] = this.calcSteppedValuePercent({
-        leftPercent,
-        range
+
+      // Use the discrete value and percentage for snapping.
+      const {
+        discreteValue,
+        discretePercent
+      } = this.calcDiscreteValueAndPercent({
+        leftPercent
       });
       return {
-        value: steppedValue,
-        left: steppedPercent * 100
+        value: discreteValue,
+        left: discretePercent * 100
       };
     });
     _defineProperty(this, "calcDistanceToHandle", (handle, clientX) => {
@@ -593,19 +591,21 @@ class Slider extends PureComponent {
       return Math.abs(handleX - clientX);
     });
     /**
-     * Given the current value, delta and step, calculate the new value.
+     * Calculates a new slider value based on the current value, a change delta,
+     * and a step.
      *
-     * @param {number} currentValue
-     *   Current value user is moving from.
-     * @param {number} delta
-     *   Movement from the current value. Can be positive or negative.
-     * @param {number} step
-     *   A value determining how much the value should increase/decrease by moving
-     *   the thumb by mouse.
+     * @param currentValue - The starting value from which the slider is moving.
+     * @param delta - The amount to adjust the current value by.
+     * @param step - The step. Defaults to `1`.
+     * @returns The new slider value, rounded to the same number of decimal places
+     *          as the step.
      */
     _defineProperty(this, "calcValueForDelta", function (currentValue, delta) {
       let step = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
-      return (delta > 0 ? Math.floor(currentValue / step) * step : currentValue) + delta;
+      const base = delta > 0 ? Math.floor(currentValue / step) * step : currentValue;
+      const newValue = base + delta;
+      const decimals = (step.toString().split('.')[1] || '').length;
+      return Number(newValue.toFixed(decimals));
     });
     /**
      * Sets state relevant to the given handle position.
@@ -869,18 +869,16 @@ class Slider extends PureComponent {
   }
 
   /**
-   * Takes a value and ensures it fits to the steps of the range
-   * @param value
-   * @returns value of the nearest step
+   * Rounds a given value to the nearest step defined by the slider's `step`
+   * prop.
+   *
+   * @param value - The value to adjust to the nearest step. Defaults to `0`.
+   * @returns The value rounded to the precision determined by the step.
    */
-  nearestStepValue(value) {
-    const tempInput = document.createElement('input');
-    tempInput.type = 'range';
-    tempInput.min = `${this.props.min}`;
-    tempInput.max = `${this.props.max}`;
-    tempInput.step = `${this.props.step}`;
-    tempInput.value = `${value}`;
-    return parseFloat(tempInput.value);
+  nearestStepValue() {
+    let value = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
+    const decimals = (this.props.step?.toString().split('.')[1] || '').length;
+    return Number(value.toFixed(decimals));
   }
   getClientXFromEvent(event) {
     let clientX;

package/es/components/Tabs/Tabs.d.ts

@@ -1,5 +1,5 @@
 /**
- * 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.
@@ -340,12 +340,9 @@ export interface TabProps extends HTMLAttributes<HTMLElement> {
      */
     renderButton?(): ReactNode;
     /**
-     * Optional prop to render an icon next to the label.
-     * Can be a React component class
+     * A component used to render an icon.
      */
-    renderIcon?: ComponentType<{
-        size: number;
-    }>;
+    renderIcon?: React.ElementType;
     /**
      * An optional label to render under the primary tab label.
      * Only useful for contained tabs.

package/es/components/Tabs/Tabs.js

@@ -21,12 +21,13 @@ import { isElement } from 'react-is';
 import '../Tooltip/DefinitionTooltip.js';
 import { Tooltip } from '../Tooltip/Tooltip.js';
 import { useControllableState } from '../../internal/useControllableState.js';
-import { useEffectOnce } from '../../internal/useEffectOnce.js';
 import { useId } from '../../internal/useId.js';
 import useIsomorphicEffect from '../../internal/useIsomorphicEffect.js';
 import { useMergedRefs } from '../../internal/useMergedRefs.js';
 import { getInteractiveContent } from '../../internal/useNoInteractiveChildren.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import { ArrowRight, ArrowLeft, Home, End, ArrowDown, ArrowUp, Delete } from '../../internal/keyboard/keys.js';
+import { matches, match } from '../../internal/keyboard/match.js';
 import { usePressable } from './usePressable.js';
 import deprecate from '../../prop-types/deprecate.js';
 import { useEvent } from '../../internal/useEvent.js';
@@ -34,9 +35,7 @@ import { useMatchMedia } from '../../internal/useMatchMedia.js';
 import '../Text/index.js';
 import { BadgeIndicator } from '../BadgeIndicator/index.js';
 import { debounce } from '../../node_modules/es-toolkit/dist/compat/function/debounce.mjs.js';
-import { matches, match } from '../../internal/keyboard/match.js';
 import { Text } from '../Text/Text.js';
-import { ArrowRight, ArrowLeft, Home, End, ArrowDown, ArrowUp, Delete } from '../../internal/keyboard/keys.js';
 
 var _ChevronLeft, _ChevronRight, _BadgeIndicator;
 const verticalTabHeight = 64;
@@ -382,7 +381,7 @@ function TabList(_ref4) {
       }
     }
   }
-  useEffectOnce(() => {
+  useEffect(() => {
     const tab = tabs.current[selectedIndex];
     if (scrollIntoView && tab) {
       tab.scrollIntoView({
@@ -390,7 +389,7 @@ function TabList(_ref4) {
         inline: 'nearest'
       });
     }
-  });
+  }, []);
   useEffect(() => {
     //adding 1 in calculation for firefox support
     setIsNextButtonVisible(ref.current ? scrollLeft + buttonWidth + ref.current.clientWidth + 1 < ref.current.scrollWidth : false);
@@ -400,7 +399,7 @@ function TabList(_ref4) {
       }
     }
   }, [scrollLeft, children, dismissable, isScrollable]);
-  useEffectOnce(() => {
+  useEffect(() => {
     if (tabs.current[selectedIndex]?.disabled) {
       const activeTabs = tabs.current.filter(tab => {
         return !tab.disabled;
@@ -410,7 +409,7 @@ function TabList(_ref4) {
         setSelectedIndex(tabs.current.indexOf(tab));
       }
     }
-  });
+  }, []);
   useIsomorphicEffect(() => {
     if (ref.current) {
       // adding 1 in calculation for firefox support
@@ -624,7 +623,7 @@ function TabListVertical(_ref8) {
       setActiveIndex(selectedIndex);
     }
   }
-  useEffectOnce(() => {
+  useEffect(() => {
     if (tabs.current[selectedIndex]?.disabled) {
       const activeTabs = tabs.current.filter(tab => {
         return !tab.disabled;
@@ -634,7 +633,7 @@ function TabListVertical(_ref8) {
         setSelectedIndex(tabs.current.indexOf(tab));
       }
     }
-  });
+  }, []);
   useEffect(() => {
     function handler() {
       const containerHeight = ref.current?.offsetHeight;
@@ -1007,22 +1006,21 @@ Tab.propTypes = {
    * Provide a handler that is invoked on the key down event for the control
    */
   onKeyDown: PropTypes.func,
-  /*
+  /**
    * An optional parameter to allow overriding the anchor rendering.
    * Useful for using Tab along with react-router or other client
    * side router libraries.
-   **/
+   */
   renderButton: PropTypes.func,
   /**
-   * Optional prop to render an icon next to the label.
-   * Can be a React component class
+   * A component used to render an icon.
    */
   // @ts-expect-error: Invalid prop type derivation
   renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
-  /*
+  /**
    * An optional label to render under the primary tab label.
-  /* This prop is only useful for contained tabs
-   **/
+   * Only useful for contained tabs.
+   */
   secondaryLabel: PropTypes.string
 };
 
@@ -1124,7 +1122,7 @@ const TabPanel = /*#__PURE__*/React__default.forwardRef(function TabPanel(_ref12
   const className = cx(`${prefix}--tab-content`, customClassName, {
     [`${prefix}--tab-content--interactive`]: interactiveContent
   });
-  useEffectOnce(() => {
+  useEffect(() => {
     if (!panel.current) {
       return;
     }
@@ -1133,7 +1131,7 @@ const TabPanel = /*#__PURE__*/React__default.forwardRef(function TabPanel(_ref12
       setInteractiveContent(true);
       setTabIndex(-1);
     }
-  });
+  }, []);
 
   // tabindex should only be 0 if no interactive content in children
   useEffect(() => {

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

@@ -1,5 +1,5 @@
 /**
- * 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.
@@ -30,8 +30,7 @@ export interface DismissibleTagBaseProps {
      */
     onClose?: (event: React.MouseEvent<HTMLButtonElement>) => void;
     /**
-     * Optional prop to render a custom icon.
-     * Can be a React component class
+     * A component used to render an icon.
      */
     renderIcon?: React.ElementType;
     /**
@@ -86,8 +85,7 @@ declare const DismissibleTag: {
          */
         onClose: PropTypes.Requireable<(...args: any[]) => any>;
         /**
-         * Optional prop to render a custom icon.
-         * Can be a React component class
+         * A component used to render an icon.
          */
         renderIcon: PropTypes.Requireable<object>;
         /**