@carbon/react 1.70.0-rc.0 → 1.71.0-rc.0

package/es/components/InlineCheckbox/InlineCheckbox.js

@@ -11,7 +11,6 @@ import deprecate from '../../prop-types/deprecate.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { useMergedRefs } from '../../internal/useMergedRefs.js';
 
-/** @type any */
 const InlineCheckbox = /*#__PURE__*/React__default.forwardRef(function InlineCheckbox(props, forwardRef) {
   const {
     ['aria-label']: ariaLabel,
@@ -48,15 +47,14 @@ const InlineCheckbox = /*#__PURE__*/React__default.forwardRef(function InlineChe
   }
   useEffect(() => {
     if (inputRef?.current) {
-      inputRef.current.indeterminate = indeterminate;
+      inputRef.current.indeterminate = indeterminate || false;
     }
   }, [indeterminate]);
   function onClickCheckBoxInput(evt) {
-    // If the previous "indeterminate" is true, change "checked" to false. If it is not undefined, we're working on `TableSelectAll`
     if (indeterminate) {
       evt.target.checked = false;
     }
-    onClick(evt);
+    onClick?.(evt);
   }
   return /*#__PURE__*/React__default.createElement("div", {
     className: `${prefix}--checkbox--inline`
@@ -121,6 +119,5 @@ InlineCheckbox.propTypes = {
    */
   title: PropTypes.string
 };
-var InlineCheckbox$1 = InlineCheckbox;
 
-export { InlineCheckbox$1 as default };
+export { InlineCheckbox as default };

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

@@ -0,0 +1,9 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import InlineCheckbox, { type InlineCheckboxProps } from './InlineCheckbox';
+export default InlineCheckbox;
+export { InlineCheckbox, type InlineCheckboxProps };

package/es/components/LayoutDirection/LayoutDirection.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import PropTypes from 'prop-types';
+import { ElementType, ReactNode } from 'react';
+import { LayoutDirectionContext } from './LayoutDirectionContext';
+type Direction = 'ltr' | 'rtl';
+interface LayoutDirectionProps {
+    /**
+     * Customize the element type used to render the outermost node
+     */
+    as?: ElementType;
+    /**
+     * Provide child elements or components to be rendered inside of this
+     * component
+     */
+    children?: ReactNode;
+    /**
+     * Specify the layout direction of this part of the page
+     */
+    dir: Direction;
+}
+declare function LayoutDirection({ as: BaseComponent, children, dir, ...rest }: LayoutDirectionProps): import("react/jsx-runtime").JSX.Element;
+declare namespace LayoutDirection {
+    var propTypes: {
+        /**
+         * Customize the element type used to render the outermost node
+         */
+        as: PropTypes.Requireable<NonNullable<((...args: any[]) => any) | PropTypes.ReactComponentLike | null | undefined>>;
+        /**
+         * Provide child elements or components to be rendered inside of this
+         * component
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify the layout direction of this part of the page
+         */
+        dir: PropTypes.Validator<string>;
+    };
+}
+export { LayoutDirectionContext, LayoutDirection };

package/es/components/LayoutDirection/LayoutDirectionContext.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';
+export declare const LayoutDirectionContext: React.Context<{
+    direction: string;
+}>;

package/es/components/LayoutDirection/useLayoutDirection.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+/**
+ * Get access to the current layout direction in context
+ */
+export declare function useLayoutDirection(): {
+    direction: string;
+};

package/es/components/Menu/MenuItem.js

@@ -243,9 +243,6 @@ const MenuItemSelectable = /*#__PURE__*/forwardRef(function MenuItemSelectable(_
   });
   function handleClick(e) {
     setChecked(!checked);
-    if (onChange) {
-      onChange(e);
-    }
   }
   useEffect(() => {
     if (!context.state.hasIcons) {

package/es/components/MultiSelect/FilterableMultiSelect.d.ts

@@ -61,7 +61,7 @@ export interface FilterableMultiSelectProps<ItemType> extends MultiSelectSorting
      */
     filterItems(items: readonly ItemType[], extra: {
         inputValue: string | null;
-        itemToString: NonNullable<UseMultipleSelectionProps<ItemType>['itemToString']>;
+        itemToString: NonNullable<UseComboboxProps<ItemType>['itemToString']>;
     }): ItemType[];
     /**
      * Specify whether the title text should be hidden or not

package/es/components/MultiSelect/FilterableMultiSelect.js

@@ -264,7 +264,7 @@ const FilterableMultiSelect = /*#__PURE__*/React__default.forwardRef(function Fi
     inputValue,
     stateReducer,
     isItemDisabled(item, _index) {
-      return item.disabled;
+      return item?.disabled;
     }
   });
   function stateReducer(state, actionAndChanges) {
@@ -381,7 +381,6 @@ const FilterableMultiSelect = /*#__PURE__*/React__default.forwardRef(function Fi
     activeIndex: highlightedIndex,
     initialSelectedItems,
     selectedItems: controlledSelectedItems,
-    itemToString,
     onStateChange(changes) {
       switch (changes.type) {
         case SelectedItemKeyDownBackspace:

package/es/components/MultiSelect/MultiSelect.js

@@ -196,7 +196,7 @@ const MultiSelect = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
     selectedItem: controlledSelectedItems,
     items: filteredItems,
     isItemDisabled(item, _index) {
-      return item.disabled;
+      return item?.disabled;
     },
     ...downshiftProps
   };

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

@@ -516,6 +516,13 @@ export declare namespace ActionableNotification {
  * Callout
  * ==================
  */
+/**
+ * Deprecated callout kind values.
+ * @deprecated Use NewKindProps instead.
+ */
+export type DeprecatedKindProps = 'error' | 'info' | 'info-square' | 'success' | 'warning' | 'warning-alt';
+export type NewKindProps = 'warning' | 'info';
+export type KindProps = DeprecatedKindProps | NewKindProps;
 export interface CalloutProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * Pass in the action button label that will be rendered within the ActionableNotification.
@@ -532,7 +539,7 @@ export interface CalloutProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * Specify what state the notification represents
      */
-    kind?: 'error' | 'info' | 'info-square' | 'success' | 'warning' | 'warning-alt';
+    kind?: KindProps;
     /**
      * Specify whether you are using the low contrast variant of the Callout.
      */
@@ -576,7 +583,7 @@ export declare namespace Callout {
         /**
          * Specify what state the notification represents
          */
-        kind: PropTypes.Requireable<string>;
+        kind: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
         /**
          * Specify whether you are using the low contrast variant of the Callout.
          */

package/es/components/Notification/Notification.js

@@ -22,6 +22,7 @@ import { noopFn } from '../../internal/noopFn.js';
 import wrapFocus, { wrapFocusWithoutSentinels } from '../../internal/wrapFocus.js';
 import { useFeatureFlag } from '../FeatureFlags/index.js';
 import { warning } from '../../internal/warning.js';
+import deprecateValuesWithin from '../../prop-types/deprecateValuesWithin.js';
 import { Text } from '../Text/Text.js';
 import { match, matches } from '../../internal/keyboard/match.js';
 import { Tab, Escape } from '../../internal/keyboard/keys.js';
@@ -693,6 +694,19 @@ ActionableNotification.propTypes = {
  * ==================
  */
 
+/**
+ * Deprecated callout kind values.
+ * @deprecated Use NewKindProps instead.
+ */
+
+const propMappingFunction = deprecatedValue => {
+  const mapping = {
+    error: 'warning',
+    // only redirect error -> warning
+    success: 'info' // only redirect success -> info
+  };
+  return mapping[deprecatedValue];
+};
 function Callout(_ref8) {
   let {
     actionButtonLabel,
@@ -703,7 +717,7 @@ function Callout(_ref8) {
     subtitle,
     statusIconDescription,
     className,
-    kind = 'error',
+    kind = 'info',
     lowContrast,
     ...rest
   } = _ref8;
@@ -759,7 +773,7 @@ Callout.propTypes = {
   /**
    * Specify what state the notification represents
    */
-  kind: PropTypes.oneOf(['error', 'info', 'info-square', 'success', 'warning', 'warning-alt']),
+  kind: deprecateValuesWithin(PropTypes.oneOf(['error', 'info', 'info-square', 'success', 'warning', 'warning-alt']), ['warning', 'info'], propMappingFunction),
   /**
    * Specify whether you are using the low contrast variant of the Callout.
    */

package/es/components/NumberInput/NumberInput.d.ts

@@ -24,6 +24,10 @@ export interface NumberInputProps extends Omit<React.InputHTMLAttributes<HTMLInp
      * Specify an optional className to be applied to the wrapper node
      */
     className?: string;
+    /**
+     * **Experimental**: Provide a `decorator` component to be rendered inside the `TextInput` component
+     */
+    decorator?: ReactNode;
     /**
      * Optional starting value for uncontrolled state
      */
@@ -113,6 +117,7 @@ export interface NumberInputProps extends Omit<React.InputHTMLAttributes<HTMLInp
      */
     size?: 'sm' | 'md' | 'lg';
     /**
+     * @deprecated please use `decorator` instead.
      * **Experimental**: Provide a `Slug` component to be rendered inside the `TextInput` component
      */
     slug?: ReactNode;

package/es/components/NumberInput/NumberInput.js

@@ -37,6 +37,7 @@ const NumberInput = /*#__PURE__*/React__default.forwardRef(function NumberInput(
   const {
     allowEmpty = false,
     className: customClassName,
+    decorator,
     disabled = false,
     disableWheel: disableWheelProp = false,
     defaultValue = 0,
@@ -112,7 +113,8 @@ const NumberInput = /*#__PURE__*/React__default.forwardRef(function NumberInput(
   const [incrementNumLabel, decrementNumLabel] = [t('increment.number'), t('decrement.number')];
   const wrapperClasses = cx(`${prefix}--number__input-wrapper`, {
     [`${prefix}--number__input-wrapper--warning`]: normalizedProps.warn,
-    [`${prefix}--number__input-wrapper--slug`]: slug
+    [`${prefix}--number__input-wrapper--slug`]: slug,
+    [`${prefix}--number__input-wrapper--decorator`]: decorator
   });
   const iconClasses = cx({
     [`${prefix}--number__invalid`]: normalizedProps.invalid || normalizedProps.warn,
@@ -186,18 +188,18 @@ const NumberInput = /*#__PURE__*/React__default.forwardRef(function NumberInput(
     }
   }
 
-  // Slug is always size `mini`
-  let normalizedSlug;
-  if (slug && slug['type']?.displayName === 'AILabel') {
-    normalizedSlug = /*#__PURE__*/React__default.cloneElement(slug, {
+  // AILabel always size `mini`
+  let normalizedDecorator = /*#__PURE__*/React__default.isValidElement(slug ?? decorator) ? slug ?? decorator : null;
+  if (normalizedDecorator && normalizedDecorator['type']?.displayName === 'AILabel') {
+    normalizedDecorator = /*#__PURE__*/React__default.cloneElement(normalizedDecorator, {
       size: 'mini'
     });
   }
 
   // Need to update the internal value when the revert button is clicked
   let isRevertActive;
-  if (slug && slug['type']?.displayName === 'AILabel') {
-    isRevertActive = normalizedSlug.props.revertActive;
+  if (normalizedDecorator && normalizedDecorator['type']?.displayName === 'AILabel') {
+    isRevertActive = normalizedDecorator.props.revertActive;
   }
   useEffect(() => {
     if (!isRevertActive && slug && defaultValue) {
@@ -252,7 +254,9 @@ const NumberInput = /*#__PURE__*/React__default.forwardRef(function NumberInput(
     step: step,
     type: "number",
     value: value
-  })), normalizedSlug, Icon ? /*#__PURE__*/React__default.createElement(Icon, {
+  })), slug ? normalizedDecorator : decorator ? /*#__PURE__*/React__default.createElement("div", {
+    className: `${prefix}--number__input-inner-wrapper--decorator`
+  }, normalizedDecorator) : '', Icon ? /*#__PURE__*/React__default.createElement(Icon, {
     className: iconClasses
   }) : null, !hideSteppers && /*#__PURE__*/React__default.createElement("div", {
     className: `${prefix}--number__controls`
@@ -297,6 +301,10 @@ NumberInput.propTypes = {
    * Specify an optional className to be applied to the wrapper node
    */
   className: PropTypes.string,
+  /**
+   * **Experimental**: Provide a `decorator` component to be rendered inside the `NumberInput` component
+   */
+  decorator: PropTypes.node,
   /**
    * Optional starting value for uncontrolled state
    */
@@ -379,7 +387,7 @@ NumberInput.propTypes = {
   /**
    * **Experimental**: Provide a `Slug` component to be rendered inside the `NumberInput` component
    */
-  slug: PropTypes.node,
+  slug: deprecate(PropTypes.node, 'The `slug` prop for `NumberInput` is no longer needed and has ' + 'been deprecated in v11 in favor of the new `decorator` prop. It will be moved in the next major release.'),
   /**
    * Specify how much the values should increase/decrease upon clicking on up/down button
    */

package/es/components/OverflowMenu/OverflowMenu.js

@@ -206,7 +206,7 @@ class OverflowMenu extends React__default.Component {
         direction
       } = _ref;
       const enabledIndices = React__default.Children.toArray(this.props.children).reduce((acc, curr, i) => {
-        if ( /*#__PURE__*/React__default.isValidElement(curr) && !curr.props.disabled) {
+        if (/*#__PURE__*/React__default.isValidElement(curr) && !curr.props.disabled) {
           acc.push(i);
         }
         return acc;

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

@@ -19,8 +19,22 @@ import mergeRefs from '../../../tools/mergeRefs.js';
 import { useId } from '../../../internal/useId.js';
 import { usePrefix } from '../../../internal/usePrefix.js';
 import { useAttachedMenu } from '../../../internal/useAttachedMenu.js';
+import deprecateValuesWithin from '../../../prop-types/deprecateValuesWithin.js';
 
 const defaultSize = 'md';
+const propMappingFunction = deprecatedValue => {
+  const mapping = {
+    'top-left': 'top-start',
+    'top-right': 'top-end',
+    'bottom-left': 'bottom-start',
+    'bottom-right': 'bottom-end',
+    'left-bottom': 'left-end',
+    'left-top': 'left-start',
+    'right-bottom': 'right-end',
+    'right-top': 'right-start'
+  };
+  return mapping[deprecatedValue];
+};
 const OverflowMenu = /*#__PURE__*/React__default.forwardRef(function OverflowMenu(_ref, forwardRef) {
   let {
     autoAlign = false,
@@ -162,7 +176,32 @@ OverflowMenu.propTypes = {
   /**
    * Specify how the trigger tooltip should be aligned.
    */
-  tooltipAlignment: PropTypes.oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  tooltipAlignment: deprecateValuesWithin(PropTypes.oneOf(['top', 'top-left',
+  // deprecated use top-start instead
+  'top-right',
+  // deprecated use top-end instead
+
+  'bottom', 'bottom-left',
+  // deprecated use bottom-start instead
+  'bottom-right',
+  // deprecated use bottom-end instead
+
+  'left', 'left-bottom',
+  // deprecated use left-end instead
+  'left-top',
+  // deprecated use left-start instead
+
+  'right', 'right-bottom',
+  // deprecated use right-end instead
+  'right-top',
+  // deprecated use right-start instead
+
+  // new values to match floating-ui
+  'top-start', 'top-end', 'bottom-start', 'bottom-end', 'left-end', 'left-start', 'right-end', 'right-start']),
+  //allowed prop values
+  ['top', 'top-start', 'top-end', 'bottom', 'bottom-start', 'bottom-end', 'left', 'left-start', 'left-end', 'right', 'right-start', 'right-end'],
+  //optional mapper function
+  propMappingFunction),
   /**
    * Specify a DOM node where the Menu should be rendered in. Defaults to document.body.
    */

package/es/components/Pagination/Pagination.js

@@ -29,7 +29,7 @@ function renderSelectItems(total) {
   let counter = 1;
   const itemArr = [];
   while (counter <= total) {
-    itemArr.push( /*#__PURE__*/React__default.createElement(SelectItem, {
+    itemArr.push(/*#__PURE__*/React__default.createElement(SelectItem, {
       key: counter,
       value: counter,
       text: String(counter)
@@ -245,7 +245,7 @@ const Pagination = /*#__PURE__*/React__default.forwardRef(function Pagination(_r
     onClick: decrementPage,
     ref: backBtnRef
   }, _CaretLeft || (_CaretLeft = /*#__PURE__*/React__default.createElement(CaretLeft, null))), /*#__PURE__*/React__default.createElement(IconButton, {
-    align: "top-right",
+    align: "top-end",
     disabled: forwardButtonDisabled || isLastPage,
     kind: "ghost",
     className: forwardButtonClasses,

package/es/components/Pagination/experimental/PageSelector.js

@@ -30,7 +30,7 @@ function PageSelector(_ref) {
   const renderPages = total => {
     const pages = [];
     for (let counter = 1; counter <= total; counter += 1) {
-      pages.push( /*#__PURE__*/React__default.createElement(SelectItem, {
+      pages.push(/*#__PURE__*/React__default.createElement(SelectItem, {
         key: counter,
         value: counter,
         text: String(counter)

package/es/components/PaginationNav/PaginationNav.d.ts

@@ -28,7 +28,7 @@ interface PaginationNavProps extends Omit<React.HTMLAttributes<HTMLElement>, 'on
      */
     disableOverflow?: boolean;
     /**
-     * The number of items to be shown.
+     * The number of items to be shown (minimum of 4 unless props.items < 4).
      */
     itemsShown?: number;
     /**

package/es/components/PaginationNav/PaginationNav.js

@@ -12,6 +12,8 @@ import cx from 'classnames';
 import { CaretRight, CaretLeft, OverflowMenuHorizontal } from '@carbon/icons-react';
 import { IconButton } from '../IconButton/index.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import { breakpoints } from '@carbon/layout';
+import { useMatchMedia } from '../../internal/useMatchMedia.js';
 
 var _CaretRight, _CaretLeft, _option;
 const translationIds = {
@@ -179,8 +181,10 @@ const PaginationNav = /*#__PURE__*/React__default.forwardRef(function Pagination
     translateWithId: t = translateWithId,
     ...rest
   } = _ref4;
+  const smMediaQuery = `(max-width: ${breakpoints.sm.width})`;
+  const isSm = useMatchMedia(smMediaQuery);
   const [currentPage, setCurrentPage] = useState(page);
-  const [itemsDisplayedOnPage, setItemsDisplayedOnPage] = useState(itemsShown >= 4 ? itemsShown : 4);
+  const [itemsDisplayedOnPage, setItemsDisplayedOnPage] = useState(itemsShown >= 4 && !isSm ? itemsShown : 4);
   const [cuts, setCuts] = useState(calculateCuts(currentPage, totalItems, itemsDisplayedOnPage));
   const prevPage = usePrevious(currentPage);
   const prefix = usePrefix();
@@ -225,9 +229,10 @@ const PaginationNav = /*#__PURE__*/React__default.forwardRef(function Pagination
 
   // re-calculate cuts if props.totalItems or props.itemsShown change
   useEffect(() => {
-    setItemsDisplayedOnPage(itemsShown >= 4 ? itemsShown : 4);
-    setCuts(calculateCuts(currentPage, totalItems, itemsShown));
-  }, [totalItems, itemsShown]); // eslint-disable-line react-hooks/exhaustive-deps
+    const itemsToBeShown = itemsShown >= 4 && !isSm ? itemsShown : 4;
+    setItemsDisplayedOnPage(Math.max(itemsToBeShown, 4));
+    setCuts(calculateCuts(currentPage, totalItems, Math.max(itemsToBeShown, 4)));
+  }, [totalItems, itemsShown, isSm]); // eslint-disable-line react-hooks/exhaustive-deps
 
   // update cuts if necessary whenever currentPage changes
   useEffect(() => {
@@ -386,7 +391,7 @@ PaginationNav.propTypes = {
   // eslint-disable-line react/prop-types
 
   /**
-   * The number of items to be shown.
+   * The number of items to be shown (minimum of 4 unless props.items < 4).
    */
   itemsShown: PropTypes.number,
   /**

package/es/components/Popover/index.js

@@ -213,7 +213,7 @@ const Popover = /*#__PURE__*/React__default.forwardRef(function PopoverRenderFun
     const isTriggerElement = item?.type === 'button';
     const isTriggerComponent = enableFloatingStyles && displayName && ['ToggletipButton'].includes(displayName);
     const isAllowedTriggerComponent = enableFloatingStyles && !['ToggletipContent', 'PopoverContent'].includes(displayName);
-    if ( /*#__PURE__*/React__default.isValidElement(item) && (isTriggerElement || isTriggerComponent || isAllowedTriggerComponent)) {
+    if (/*#__PURE__*/React__default.isValidElement(item) && (isTriggerElement || isTriggerComponent || isAllowedTriggerComponent)) {
       const className = item?.props?.className;
       const ref = (item?.props).ref;
       const tabTipClasses = cx(`${prefix}--popover--tab-tip__button`, className);
@@ -336,7 +336,7 @@ Popover.propTypes = {
    */
   open: PropTypes.bool.isRequired
 };
-function PopoverContentRenderFunction( // eslint-disable-next-line react/prop-types
+function PopoverContentRenderFunction(// eslint-disable-next-line react/prop-types
 _ref2, forwardRef) {
   let {
     className,

package/es/components/SkeletonText/SkeletonText.js

@@ -56,7 +56,7 @@ const SkeletonText = _ref => {
   }, [lineCountNumber, paragraph, refs, width, widthNum, widthPercent, widthPx]);
   const lines = [];
   for (let i = 0; i < lineCountNumber; i++) {
-    lines.push( /*#__PURE__*/React__default.createElement("p", _extends({
+    lines.push(/*#__PURE__*/React__default.createElement("p", _extends({
       className: skeletonTextClasses,
       key: i,
       ref: el => refs.current = [...refs.current, el]

package/es/components/Tabs/Tabs.js

@@ -346,6 +346,41 @@ function TabList(_ref4) {
       setActiveIndex(selectedIndex);
     }
   }
+
+  /**
+   * Scroll the tab into view if it is not already visible
+   * @param tab - The tab to scroll into view
+   * @returns {void}
+   */
+  function scrollTabIntoView(tab) {
+    if (!isScrollable || !ref.current) {
+      return;
+    }
+    if (tab) {
+      // The width of the "scroll buttons"
+      const {
+        width: tabWidth
+      } = tab.getBoundingClientRect();
+
+      // The start and end position of the selected tab
+      const start = tab.offsetLeft;
+      const end = tab.offsetLeft + tabWidth;
+
+      // The start and end of the visible area for the tabs
+      const visibleStart = ref.current.scrollLeft + buttonWidth;
+      const visibleEnd = ref.current.scrollLeft + ref.current.clientWidth - buttonWidth;
+
+      // The beginning of the tab is clipped and not visible
+      if (start < visibleStart) {
+        setScrollLeft(start - buttonWidth);
+      }
+
+      // The end of the tab is clipped and not visible
+      if (end > visibleEnd) {
+        setScrollLeft(end + buttonWidth - ref.current.clientWidth);
+      }
+    }
+  }
   useEffectOnce(() => {
     const tab = tabs.current[selectedIndex];
     if (scrollIntoView && tab) {
@@ -377,12 +412,12 @@ function TabList(_ref4) {
   });
   useIsomorphicEffect(() => {
     if (ref.current) {
-      //adding 1 in calculation for firefox support
+      // adding 1 in calculation for firefox support
       setIsScrollable(ref.current.scrollWidth > ref.current.clientWidth + 1);
     }
     function handler() {
       if (ref.current) {
-        //adding 1 in calculation for firefox support
+        // adding 1 in calculation for firefox support
         setIsScrollable(ref.current.scrollWidth > ref.current.clientWidth + 1);
       }
     }
@@ -400,36 +435,18 @@ function TabList(_ref4) {
       ref.current.scrollLeft = scrollLeft;
     }
   }, [scrollLeft]);
+
+  // scroll manual tabs when active index changes (focus outline movement)
   useIsomorphicEffect(() => {
-    if (!isScrollable || !ref.current) {
-      return;
-    }
     const tab = activation === 'manual' ? tabs.current[activeIndex] : tabs.current[selectedIndex];
-    if (tab) {
-      // The width of the "scroll buttons"
-
-      // The start and end position of the selected tab
-      const {
-        width: tabWidth
-      } = tab.getBoundingClientRect();
-      const start = tab.offsetLeft;
-      const end = tab.offsetLeft + tabWidth;
-
-      // The start and end of the visible area for the tabs
-      const visibleStart = ref.current.scrollLeft + buttonWidth;
-      const visibleEnd = ref.current.scrollLeft + ref.current.clientWidth - buttonWidth;
-
-      // The beginning of the tab is clipped and not visible
-      if (start < visibleStart) {
-        setScrollLeft(start - buttonWidth);
-      }
+    scrollTabIntoView(tab);
+  }, [activation, activeIndex]);
 
-      // The end of the tab is clipped and not visible
-      if (end > visibleEnd) {
-        setScrollLeft(end + buttonWidth - ref.current.clientWidth);
-      }
-    }
-  }, [activation, activeIndex, selectedIndex, isScrollable, children]);
+  // scroll tabs when selected index changes
+  useIsomorphicEffect(() => {
+    const tab = tabs.current[selectedIndex];
+    scrollTabIntoView(tab);
+  }, [selectedIndex, isScrollable, children]);
   usePressable(previousButton, {
     onPress(_ref6) {
       let {

package/es/components/TextArea/TextArea.d.ts

@@ -15,6 +15,10 @@ export interface TextAreaProps extends React.InputHTMLAttributes<HTMLTextAreaEle
      * Specify the `cols` attribute for the underlying `<textarea>` node
      */
     cols?: number;
+    /**
+     * **Experimental**: Provide a `decorator` component to be rendered inside the `TextArea` component
+     */
+    decorator?: ReactNode;
     /**
      * Optionally provide the default value of the `<textarea>`
      */
@@ -90,6 +94,7 @@ export interface TextAreaProps extends React.InputHTMLAttributes<HTMLTextAreaEle
      */
     rows?: number;
     /**
+     * @deprecated please use `decorator` instead.
      * **Experimental**: Provide a `Slug` component to be rendered inside the `TextArea` component
      */
     slug?: ReactNode;