@carbon/react 1.83.0 → 1.84.0

package/es/internal/useOverflowItems.js

@@ -0,0 +1,122 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { useRef, useState, useMemo, useEffect } from 'react';
+import { useResizeObserver } from './useResizeObserver.js';
+import { usePreviousValue } from './usePreviousValue.js';
+
+/**
+ * Manages overflow items in a container by automatically hiding items that don't fit.
+ * @param items - Array of items to manage for overflow, each must have an `id` property.
+ * @param containerRef - React ref to the container element that holds the items.
+ * @param offsetRef - Optional ref to an offset element (like a "more" button) whose width is reserved when calculating available space.
+ * @param maxItems - Optional maximum number of visible items. If undefined, only container space constrains visibility.
+ * @param onChange - Optional callback called when hidden items change. Receives array of currently hidden items.
+ * @returns Object with `visibleItems` (items to display), `hiddenItems` (items that don't fit), and `itemRefHandler` (function to attach refs to items for width measurement).
+ */
+
+const useOverflowItems = (items, containerRef, offsetRef, maxItems, onChange) => {
+  const itemsRef = useRef(null);
+  const [maxWidth, setMaxWidth] = useState(0);
+  if (!items || !Array.isArray(items)) {
+    return {
+      visibleItems: [],
+      hiddenItems: [],
+      itemRefHandler: () => {}
+    };
+  }
+  const handleResize = () => {
+    if (containerRef.current) {
+      const offset = offsetRef?.current?.offsetWidth || 0;
+      const newMax = containerRef.current.offsetWidth - offset;
+      setMaxWidth(newMax);
+    }
+  };
+  useResizeObserver({
+    ref: containerRef,
+    onResize: handleResize
+  });
+  const getMap = () => {
+    if (!itemsRef.current) {
+      itemsRef.current = new Map();
+    }
+    return itemsRef.current;
+  };
+  const itemRefHandler = (id, node) => {
+    const map = getMap();
+    if (node) {
+      const style = getComputedStyle?.(node);
+      const totalWidth = node.offsetWidth + parseInt(style.marginLeft) + parseInt(style.marginRight);
+      map.set(id, totalWidth);
+    }
+    return () => {
+      map.delete(id);
+    };
+  };
+  const getVisibleItems = () => {
+    if (!items || Array.isArray(items) === false) {
+      return [];
+    }
+    if (!containerRef) {
+      return items;
+    }
+    const map = getMap();
+    let maxReached = false;
+    let accumulatedWidth = 0;
+    const visibleItems = items.slice(0, maxItems).reduce((prev, cur) => {
+      if (maxReached) {
+        return prev;
+      }
+      const itemWidth = map.get(cur.id) || 0;
+      const willFit = accumulatedWidth + itemWidth <= maxWidth;
+      if (willFit) {
+        accumulatedWidth += itemWidth;
+        prev.push(cur);
+      } else {
+        maxReached = true;
+      }
+      return prev;
+    }, []);
+    return visibleItems;
+  };
+
+  // Memoize visible items calculation to avoid recalculating on every render
+  const visibleItems = useMemo(() => {
+    if (!Array.isArray(items)) {
+      return [];
+    }
+    return getVisibleItems();
+  }, [items, maxWidth, maxItems]);
+
+  // Memoize hidden items calculation
+  const hiddenItems = useMemo(() => {
+    if (!Array.isArray(items)) {
+      return [];
+    }
+    return items.slice(visibleItems.length);
+  }, [items, visibleItems]);
+
+  // Use previous value to compare and only call onChange when needed
+  const previousHiddenItems = usePreviousValue(hiddenItems);
+
+  // Only call onChange if hidden items actually changed
+  useEffect(() => {
+    if (previousHiddenItems && onChange) {
+      const hasChanged = hiddenItems.length !== previousHiddenItems.length || hiddenItems.some((item, index) => item !== previousHiddenItems[index]);
+      if (hasChanged) {
+        onChange(hiddenItems);
+      }
+    }
+  }, [hiddenItems, previousHiddenItems, onChange]);
+  return {
+    visibleItems,
+    itemRefHandler,
+    hiddenItems
+  };
+};
+
+export { useOverflowItems as default };

package/es/internal/useResizeObserver.js

@@ -7,11 +7,10 @@
 
 import { useState, useRef, useEffect, useLayoutEffect } from 'react';
 
-const useResizeObserver = _ref => {
-  let {
-    ref,
-    onResize
-  } = _ref;
+const useResizeObserver = ({
+  ref,
+  onResize
+}) => {
   const [width, setWidth] = useState(-1);
   const [height, setHeight] = useState(-1);
   const entriesToHandle = useRef(null);

package/es/internal/useSavedCallback.js

@@ -20,9 +20,7 @@ const useSavedCallback = callback => {
   useEffect(() => {
     savedCallback.current = callback;
   }, [callback]);
-  return useCallback(function () {
-    return savedCallback.current ? savedCallback.current(...arguments) : undefined;
-  }, []);
+  return useCallback((...args) => savedCallback.current ? savedCallback.current(...args) : undefined, []);
 };
 
 export { useSavedCallback };

package/es/internal/wrapFocus.js

@@ -30,8 +30,7 @@ const DOCUMENT_POSITION_BROAD_FOLLOWING = typeof Node !== 'undefined' ? Node.DOC
  * @returns {boolean} Whether the node or one of its ancestors is in a floating
  * menu.
  */
-const elementOrParentIsFloatingMenu = function (node) {
-  let selectorsFloatingMenus = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+const elementOrParentIsFloatingMenu = (node, selectorsFloatingMenus = []) => {
   if (node instanceof Element && typeof node.closest === 'function') {
     const allSelectorsFloatingMenus = ['.cds--overflow-menu-options', '.cds--tooltip', '.flatpickr-calendar', ...selectorsFloatingMenus];
     return allSelectorsFloatingMenus.some(selector => !!node.closest(selector));
@@ -43,36 +42,29 @@ const elementOrParentIsFloatingMenu = function (node) {
  * Ensures the focus is kept within the given container by implementing
  * "focus-wrap" behavior.
  */
-const wrapFocus = _ref => {
-  let {
-    bodyNode,
-    startTrapNode,
-    endTrapNode,
-    currentActiveNode,
-    oldActiveNode,
-    selectorsFloatingMenus
-  } = _ref;
+const wrapFocus = ({
+  bodyNode,
+  startTrapNode,
+  endTrapNode,
+  currentActiveNode,
+  oldActiveNode,
+  selectorsFloatingMenus
+}) => {
   if (bodyNode && currentActiveNode && oldActiveNode && !bodyNode.contains(currentActiveNode) && !elementOrParentIsFloatingMenu(currentActiveNode, selectorsFloatingMenus)) {
     const comparisonResult = oldActiveNode.compareDocumentPosition(currentActiveNode);
     if (currentActiveNode === startTrapNode || comparisonResult & DOCUMENT_POSITION_BROAD_PRECEDING) {
-      const tabbableElement = Array.from(bodyNode.querySelectorAll(selectorTabbable)).reverse().find(_ref2 => {
-        let {
-          offsetParent
-        } = _ref2;
-        return Boolean(offsetParent);
-      });
+      const tabbableElement = Array.from(bodyNode.querySelectorAll(selectorTabbable)).reverse().find(({
+        offsetParent
+      }) => Boolean(offsetParent));
       if (tabbableElement) {
         tabbableElement.focus();
       } else if (bodyNode !== oldActiveNode) {
         bodyNode.focus();
       }
     } else if (currentActiveNode === endTrapNode || comparisonResult & DOCUMENT_POSITION_BROAD_FOLLOWING) {
-      const tabbableElement = Array.from(bodyNode.querySelectorAll(selectorTabbable)).find(_ref3 => {
-        let {
-          offsetParent
-        } = _ref3;
-        return Boolean(offsetParent);
-      });
+      const tabbableElement = Array.from(bodyNode.querySelectorAll(selectorTabbable)).find(({
+        offsetParent
+      }) => Boolean(offsetParent));
       if (tabbableElement) {
         tabbableElement.focus();
       } else if (bodyNode !== oldActiveNode) {
@@ -88,12 +80,11 @@ const wrapFocus = _ref => {
  *
  * Note: This must be called *before* focus moves using `onKeyDown` or similar.
  */
-const wrapFocusWithoutSentinels = _ref4 => {
-  let {
-    containerNode,
-    currentActiveNode,
-    event
-  } = _ref4;
+const wrapFocusWithoutSentinels = ({
+  containerNode,
+  currentActiveNode,
+  event
+}) => {
   if (!containerNode) return;
   if (['blur', 'focusout', 'focusin', 'focus'].includes(event.type) && process.env.NODE_ENV !== 'production') {
     throw new Error(`Error: wrapFocusWithoutSentinels(...) called in unsupported ${event.type} event.\n\nCall wrapFocusWithoutSentinels(...) from onKeyDown instead.`);

package/es/prop-types/deprecate.js

@@ -9,7 +9,7 @@ import { warning } from '../internal/warning.js';
 
 const didWarnAboutDeprecation = {};
 function deprecate(propType, message) {
-  function checker(props, propName, componentName) {
+  function checker(props, propName, componentName, ...rest) {
     if (props[propName] === undefined) {
       return;
     }
@@ -20,9 +20,6 @@ function deprecate(propType, message) {
       };
       process.env.NODE_ENV !== "production" ? warning(false, message || `The prop \`${propName}\` has been deprecated for the ` + `${componentName} component. It will be removed in the next major ` + `release`) : void 0;
     }
-    for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
-      rest[_key - 3] = arguments[_key];
-    }
     return propType(props, propName, componentName, ...rest);
   }
   return checker;

package/es/prop-types/deprecateValuesWithin.js

@@ -9,7 +9,7 @@ import { warning } from '../internal/warning.js';
 
 const didWarnAboutDeprecation = {};
 function deprecateValuesWithin(propType, allowedValues, propMappingFunction) {
-  return function checker(props, propName, componentName) {
+  return function checker(props, propName, componentName, ...rest) {
     if (props[propName] === undefined) {
       return;
     }
@@ -25,9 +25,6 @@ function deprecateValuesWithin(propType, allowedValues, propMappingFunction) {
         process.env.NODE_ENV !== "production" ? warning(false, message) : void 0;
       }
     }
-    for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
-      rest[_key - 3] = arguments[_key];
-    }
     return propType(props, propName, componentName, ...rest);
   };
 }

package/es/prop-types/isRequiredOneOf.js

@@ -15,13 +15,10 @@
  */
 const isRequiredOneOf = propTypes => {
   const names = Object.keys(propTypes);
-  const checker = propType => function (props, propName, componentName) {
+  const checker = propType => (props, propName, componentName, ...rest) => {
     if (process.env.NODE_ENV !== 'production' && names.every(name => typeof props[name] === 'undefined')) {
       return new Error(`${componentName} requires one of the following props: ${names.join(', ')}`);
     }
-    for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
-      rest[_key - 3] = arguments[_key];
-    }
     return propType(props, propName, componentName, ...rest);
   };
   return names.reduce((acc, name) => ({

package/es/prop-types/requiredIfGivenPropIsTruthy.js

@@ -13,13 +13,10 @@
  * becomes required if the prop corresponding to the provided prop name exists.
  */
 function requiredIfGivenPropIsTruthy(name, propType) {
-  return function check(props, propName, componentName) {
+  return function check(props, propName, componentName, ...rest) {
     if (process.env.NODE_ENV !== 'production' && props[name] == true && props[propName] == null) {
       return new Error(`You must provide a value for \`${propName}\` in \`${componentName}\` if \`${name}\` exists.`);
     }
-    for (var _len = arguments.length, rest = new Array(_len > 3 ? _len - 3 : 0), _key = 3; _key < _len; _key++) {
-      rest[_key - 3] = arguments[_key];
-    }
     return propType(props, propName, componentName, ...rest);
   };
 }

package/es/tools/events.js

@@ -14,10 +14,7 @@
  * @param handlers - An array of event handler functions.
  * @returns A composite event handler.
  */
-const composeEventHandlers = handlers => function (event) {
-  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
-    args[_key - 1] = arguments[_key];
-  }
+const composeEventHandlers = handlers => (event, ...args) => {
   for (const handler of handlers) {
     if (event.defaultPrevented) {
       break;

package/es/tools/mergeRefs.js

@@ -9,20 +9,15 @@
  * @param {...Ref<Element>} refs List of React refs to merge.
  * @returns {Ref<Element>} Merged React ref.
  */
-const mergeRefs = function () {
-  for (var _len = arguments.length, refs = new Array(_len), _key = 0; _key < _len; _key++) {
-    refs[_key] = arguments[_key];
-  }
-  return el => {
-    refs.forEach(ref => {
-      // https://github.com/facebook/react/issues/13029#issuecomment-410002316
-      if (typeof ref === 'function') {
-        ref(el);
-      } else if (Object(ref) === ref) {
-        ref.current = el;
-      }
-    });
-  };
+const mergeRefs = (...refs) => el => {
+  refs.forEach(ref => {
+    // https://github.com/facebook/react/issues/13029#issuecomment-410002316
+    if (typeof ref === 'function') {
+      ref(el);
+    } else if (Object(ref) === ref) {
+      ref.current = el;
+    }
+  });
 };
 var mergeRefs$1 = mergeRefs;
 

package/es/tools/uniqueId.js

@@ -6,8 +6,7 @@
  */
 
 let lastId = 0;
-const uniqueId = function () {
-  let prefix = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'id';
+const uniqueId = (prefix = 'id') => {
   lastId++;
   return `${prefix}${lastId}`;
 };

package/es/tools/wrapComponent.js

@@ -14,22 +14,20 @@ import { usePrefix } from '../internal/usePrefix.js';
  * @param {{ name: string, type: string, className?: string | (prefix: string) => string }} props
  * @returns
  */
-const wrapComponent = _ref => {
-  let {
-    name,
-    className: getClassName,
-    type
-  } = _ref;
+const wrapComponent = ({
+  name,
+  className: getClassName,
+  type
+}) => {
   /**
    *
    * @param {{ className?: string, [x: string]: any}} param0
    * @returns
    */
-  function Component(_ref2) {
-    let {
-      className: baseClassName,
-      ...other
-    } = _ref2;
+  function Component({
+    className: baseClassName,
+    ...other
+  }) {
     const prefix = usePrefix();
     const componentClass = cx(typeof getClassName === 'function' ? getClassName(prefix) : getClassName, baseClassName);
     return /*#__PURE__*/React.createElement(type, {

package/lib/components/AILabel/index.js

@@ -29,12 +29,11 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
 var _Undo;
-const AILabelContent = /*#__PURE__*/React__default["default"].forwardRef(function AILabelContent(_ref, ref) {
-  let {
-    className,
-    children,
-    ...rest
-  } = _ref;
+const AILabelContent = /*#__PURE__*/React__default["default"].forwardRef(function AILabelContent({
+  className,
+  children,
+  ...rest
+}, ref) {
   const prefix = usePrefix.usePrefix();
   const hasAILabelActions = React__default["default"].Children.toArray(children).some(child => {
     const item = child;
@@ -59,12 +58,11 @@ AILabelContent.propTypes = {
    */
   className: PropTypes__default["default"].string
 };
-const AILabelActions = /*#__PURE__*/React__default["default"].forwardRef(function AILabelActions(_ref2, ref) {
-  let {
-    className,
-    children,
-    ...rest
-  } = _ref2;
+const AILabelActions = /*#__PURE__*/React__default["default"].forwardRef(function AILabelActions({
+  className,
+  children,
+  ...rest
+}, ref) {
   const prefix = usePrefix.usePrefix();
   const aiLabelActionsClasses = cx__default["default"](className, {
     [`${prefix}--ai-label-actions`]: true
@@ -90,24 +88,23 @@ AILabelActions.propTypes = {
  * @deprecated Use NewPopoverAlignment instead.
  */
 
-const AILabel = /*#__PURE__*/React__default["default"].forwardRef(function AILabel(_ref3, ref) {
-  let {
-    aiText = 'AI',
-    aiTextLabel,
-    textLabel,
-    align,
-    autoAlign = true,
-    children,
-    className,
-    kind = 'default',
-    onRevertClick,
-    revertActive,
-    revertLabel = 'Revert to AI input',
-    slugLabel = 'Show information',
-    ['aria-label']: ariaLabel = 'Show information',
-    size = 'xs',
-    ...rest
-  } = _ref3;
+const AILabel = /*#__PURE__*/React__default["default"].forwardRef(function AILabel({
+  aiText = 'AI',
+  aiTextLabel,
+  textLabel,
+  align,
+  autoAlign = true,
+  children,
+  className,
+  kind = 'default',
+  onRevertClick,
+  revertActive,
+  revertLabel = 'Revert to AI input',
+  slugLabel = 'Show information',
+  ['aria-label']: ariaLabel = 'Show information',
+  size = 'xs',
+  ...rest
+}, ref) {
   const prefix = usePrefix.usePrefix();
   const id = useId.useId('AILabel');
   const aiLabelClasses = cx__default["default"](className, {

package/lib/components/AISkeleton/AISkeletonIcon.js

@@ -22,11 +22,10 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
-const AISkeletonIcon = _ref => {
-  let {
-    className,
-    ...rest
-  } = _ref;
+const AISkeletonIcon = ({
+  className,
+  ...rest
+}) => {
   const prefix = usePrefix.usePrefix();
   const AISkeletonIconClasses = cx__default["default"](className, {
     [`${prefix}--skeleton__icon--ai`]: true

package/lib/components/AISkeleton/AISkeletonPlaceholder.js

@@ -22,11 +22,10 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
-const AISkeletonPlaceholder = _ref => {
-  let {
-    className,
-    ...other
-  } = _ref;
+const AISkeletonPlaceholder = ({
+  className,
+  ...other
+}) => {
   const prefix = usePrefix.usePrefix();
   const AISkeletonPlaceholderClasses = cx__default["default"]({
     className,

package/lib/components/AISkeleton/AISkeletonText.js

@@ -22,11 +22,10 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
-const AISkeletonText = _ref => {
-  let {
-    className,
-    ...rest
-  } = _ref;
+const AISkeletonText = ({
+  className,
+  ...rest
+}) => {
   const prefix = usePrefix.usePrefix();
   const aiSkeletonTextClasses = cx__default["default"](className, {
     [`${prefix}--skeleton__text--ai`]: true

package/lib/components/Accordion/Accordion.Skeleton.js

@@ -24,16 +24,15 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
 var _SkeletonText, _SkeletonText2, _SkeletonText3;
-function AccordionSkeleton(_ref) {
-  let {
-    align = 'end',
-    className,
-    count = 4,
-    isFlush,
-    open = true,
-    ordered = false,
-    ...rest
-  } = _ref;
+function AccordionSkeleton({
+  align = 'end',
+  className,
+  count = 4,
+  isFlush,
+  open = true,
+  ordered = false,
+  ...rest
+}) {
   const prefix = usePrefix.usePrefix();
   const classes = cx__default["default"](`${prefix}--accordion`, `${prefix}--skeleton`, className, {
     [`${prefix}--accordion--${align}`]: align,

package/lib/components/Accordion/Accordion.js

@@ -22,17 +22,16 @@ var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
-function Accordion(_ref) {
-  let {
-    align = 'end',
-    children,
-    className: customClassName,
-    disabled = false,
-    isFlush = false,
-    ordered = false,
-    size,
-    ...rest
-  } = _ref;
+function Accordion({
+  align = 'end',
+  children,
+  className: customClassName,
+  disabled = false,
+  isFlush = false,
+  ordered = false,
+  size,
+  ...rest
+}) {
   const prefix = usePrefix.usePrefix();
   const className = cx__default["default"](`${prefix}--accordion`, customClassName, {
     [`${prefix}--accordion--${align}`]: align,

package/lib/components/Accordion/AccordionItem.js

@@ -32,20 +32,19 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 const defaultRenderToggle = props => /*#__PURE__*/React__default["default"].createElement("button", _rollupPluginBabelHelpers["extends"]({
   type: "button"
 }, props));
-function AccordionItem(_ref) {
-  let {
-    children,
-    className: customClassName = '',
-    open = false,
-    onHeadingClick,
-    renderExpando = defaultRenderToggle,
-    // remove renderExpando in next major release
-    renderToggle,
-    title = 'title',
-    disabled: controlledDisabled,
-    handleAnimationEnd,
-    ...rest
-  } = _ref;
+function AccordionItem({
+  children,
+  className: customClassName = '',
+  open = false,
+  onHeadingClick,
+  renderExpando = defaultRenderToggle,
+  // remove renderExpando in next major release
+  renderToggle,
+  title = 'title',
+  disabled: controlledDisabled,
+  handleAnimationEnd,
+  ...rest
+}) {
   const [isOpen, setIsOpen] = React.useState(open);
   const [prevIsOpen, setPrevIsOpen] = React.useState(open);
   const accordionState = React.useContext(AccordionProvider.AccordionContext);

package/lib/components/Accordion/AccordionProvider.js

@@ -18,11 +18,10 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 const AccordionContext = /*#__PURE__*/React.createContext({
   disabled: false
 });
-const AccordionProvider = _ref => {
-  let {
-    disabled,
-    children
-  } = _ref;
+const AccordionProvider = ({
+  disabled,
+  children
+}) => {
   return /*#__PURE__*/React__default["default"].createElement(AccordionContext.Provider, {
     value: {
       disabled

package/lib/components/AspectRatio/AspectRatio.js

@@ -27,14 +27,13 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
  * This is often useful alongside our grid components, or for media assets like
  * images or videos.
  */
-const AspectRatio = _ref => {
-  let {
-    as: BaseComponent = 'div',
-    className: containerClassName,
-    children,
-    ratio = '1x1',
-    ...rest
-  } = _ref;
+const AspectRatio = ({
+  as: BaseComponent = 'div',
+  className: containerClassName,
+  children,
+  ratio = '1x1',
+  ...rest
+}) => {
   const prefix = usePrefix.usePrefix();
   const className = cx__default["default"](containerClassName, `${prefix}--aspect-ratio`, `${prefix}--aspect-ratio--${ratio}`);
   return /*#__PURE__*/React__default["default"].createElement(BaseComponent, _rollupPluginBabelHelpers["extends"]({