@carbon/react 1.103.0 → 1.104.0

package/lib/internal/usePreviousValue.js

@@ -1,30 +1,37 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-var React = require('react');
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+let react = require("react");
 
+//#region src/internal/usePreviousValue.ts
 /**
- * Stores the previous value of a given input.
- *
- * @param value - The current value.
- * @returns The value before the current render.
- *
- * @example
- * const [count, setCount] = useState(0);
- * const prevCount = usePreviousValue(count);
- */
-const usePreviousValue = value => {
-  const ref = React.useRef(undefined);
-  React.useEffect(() => {
-    ref.current = value;
-  }, [value]);
-  return ref.current;
+* Copyright IBM Corp. 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.
+*/
+/**
+* Stores the previous value of a given input.
+*
+* @param value - The current value.
+* @returns The value before the current render.
+*
+* @example
+* const [count, setCount] = useState(0);
+* const prevCount = usePreviousValue(count);
+*/
+const usePreviousValue = (value) => {
+	const ref = (0, react.useRef)(void 0);
+	(0, react.useEffect)(() => {
+		ref.current = value;
+	}, [value]);
+	return ref.current;
 };
 
-exports.usePreviousValue = usePreviousValue;
+//#endregion
+exports.usePreviousValue = usePreviousValue;

package/lib/internal/useResizeObserver.js

@@ -1,77 +1,67 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_useIsomorphicEffect = require('./useIsomorphicEffect.js');
+let react = require("react");
 
-var React = require('react');
-var useIsomorphicEffect = require('./useIsomorphicEffect.js');
-
-const useResizeObserver = ({
-  ref,
-  onResize
-}) => {
-  const [width, setWidth] = React.useState(-1);
-  const [height, setHeight] = React.useState(-1);
-  const entriesToHandle = React.useRef(null);
-  const cb = React.useRef(onResize);
-  React.useEffect(() => {
-    // ref for onResize removes it as dependency from useIsomorphicEffect
-    // This significantly reduces repeated calls if a function is redefined on every
-    // render
-    cb.current = onResize;
-  }, [onResize]);
-  React.useEffect(() => {
-    const getInitialSize = () => {
-      if (ref.current) {
-        const refComputedStyle = window.getComputedStyle(ref.current);
-        const initialWidth = (ref.current?.offsetWidth ?? 0) - (typeof refComputedStyle?.paddingLeft === 'string' && refComputedStyle?.paddingLeft.length ? parseFloat(refComputedStyle?.paddingLeft) : 0) - (typeof refComputedStyle?.paddingRight === 'string' && refComputedStyle?.paddingRight.length ? parseFloat(refComputedStyle?.paddingRight) : 0);
-        const initialHeight = (ref.current?.offsetHeight ?? 0) - (typeof refComputedStyle?.paddingTop === 'string' && refComputedStyle?.paddingTop.length ? parseFloat(refComputedStyle?.paddingTop) : 0) - (typeof refComputedStyle?.paddingBottom === 'string' && refComputedStyle?.paddingBottom.length ? parseFloat(refComputedStyle?.paddingBottom) : 0);
-        setWidth(initialWidth);
-        setHeight(initialHeight);
-      }
-    };
-    if (!ref?.current || width >= 0 && height >= 0) {
-      return;
-    }
-    getInitialSize();
-    // eslint-disable-next-line  react-hooks/exhaustive-deps -- https://github.com/carbon-design-system/carbon/issues/20452
-  }, [width, height]);
-  useIsomorphicEffect.default(() => {
-    if (!ref?.current) {
-      return;
-    }
-    const doCallbacks = () => {
-      if (!ref?.current || !Array.isArray(entriesToHandle?.current)) {
-        return;
-      }
-      const entry = entriesToHandle.current[0];
-      setWidth(entry.contentRect.width);
-      setHeight(entry.contentRect.height);
-      cb.current?.(entry.contentRect);
-    };
-    const observer = new ResizeObserver(entries => {
-      // always update entriesToHandle
-      entriesToHandle.current = entries;
-      window.requestAnimationFrame(() => {
-        // do callbacks
-        doCallbacks();
-      });
-    });
-
-    // observe all refs passed
-    observer.observe(ref.current);
-    return () => {
-      observer.disconnect();
-    };
-  }, []);
-  return {
-    width,
-    height
-  };
+//#region src/internal/useResizeObserver.ts
+/**
+* Copyright IBM Corp. 2025, 2026
+*
+* This source code is licensed under the Apache-2.0 license found in the
+* LICENSE file in the root directory of this source tree.
+*/
+const useResizeObserver = ({ ref, onResize }) => {
+	const [width, setWidth] = (0, react.useState)(-1);
+	const [height, setHeight] = (0, react.useState)(-1);
+	const entriesToHandle = (0, react.useRef)(null);
+	const cb = (0, react.useRef)(onResize);
+	(0, react.useEffect)(() => {
+		cb.current = onResize;
+	}, [onResize]);
+	(0, react.useEffect)(() => {
+		const getInitialSize = () => {
+			if (ref.current) {
+				const refComputedStyle = window.getComputedStyle(ref.current);
+				const initialWidth = (ref.current?.offsetWidth ?? 0) - (typeof refComputedStyle?.paddingLeft === "string" && refComputedStyle?.paddingLeft.length ? parseFloat(refComputedStyle?.paddingLeft) : 0) - (typeof refComputedStyle?.paddingRight === "string" && refComputedStyle?.paddingRight.length ? parseFloat(refComputedStyle?.paddingRight) : 0);
+				const initialHeight = (ref.current?.offsetHeight ?? 0) - (typeof refComputedStyle?.paddingTop === "string" && refComputedStyle?.paddingTop.length ? parseFloat(refComputedStyle?.paddingTop) : 0) - (typeof refComputedStyle?.paddingBottom === "string" && refComputedStyle?.paddingBottom.length ? parseFloat(refComputedStyle?.paddingBottom) : 0);
+				setWidth(initialWidth);
+				setHeight(initialHeight);
+			}
+		};
+		if (!ref?.current || width >= 0 && height >= 0) return;
+		getInitialSize();
+	}, [width, height]);
+	require_useIsomorphicEffect.default(() => {
+		if (!ref?.current) return;
+		const doCallbacks = () => {
+			if (!ref?.current || !Array.isArray(entriesToHandle?.current)) return;
+			const entry = entriesToHandle.current[0];
+			setWidth(entry.contentRect.width);
+			setHeight(entry.contentRect.height);
+			cb.current?.(entry.contentRect);
+		};
+		const observer = new ResizeObserver((entries) => {
+			entriesToHandle.current = entries;
+			window.requestAnimationFrame(() => {
+				doCallbacks();
+			});
+		});
+		observer.observe(ref.current);
+		return () => {
+			observer.disconnect();
+		};
+	}, []);
+	return {
+		width,
+		height
+	};
 };
 
-exports.useResizeObserver = useResizeObserver;
+//#endregion
+exports.useResizeObserver = useResizeObserver;

package/lib/internal/useSavedCallback.js

@@ -1,29 +1,35 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-var React = require('react');
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+let react = require("react");
 
+//#region src/internal/useSavedCallback.ts
 /**
- * Returns a stable callback reference that always points to the latest version
- * of a callback. This is useful when you want to avoid including the callback
- * in dependency arrays while still ensuring the latest callback implementation
- * is used.
- *
- * @param callback - The callback to track.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
-const useSavedCallback = callback => {
-  const savedCallback = React.useRef(callback);
-  React.useEffect(() => {
-    savedCallback.current = callback;
-  }, [callback]);
-  return React.useCallback((...args) => savedCallback.current ? savedCallback.current(...args) : undefined, []);
+* 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.
+*/
+/**
+* Returns a stable callback reference that always points to the latest version
+* of a callback. This is useful when you want to avoid including the callback
+* in dependency arrays while still ensuring the latest callback implementation
+* is used.
+*
+* @param callback - The callback to track.
+*/
+const useSavedCallback = (callback) => {
+	const savedCallback = (0, react.useRef)(callback);
+	(0, react.useEffect)(() => {
+		savedCallback.current = callback;
+	}, [callback]);
+	return (0, react.useCallback)((...args) => savedCallback.current ? savedCallback.current(...args) : void 0, []);
 };
 
-exports.useSavedCallback = useSavedCallback;
+//#endregion
+exports.useSavedCallback = useSavedCallback;

package/lib/internal/utils.js

@@ -1,20 +1,27 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-var React = require('react');
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+let react = require("react");
 
+//#region src/internal/utils.ts
 /**
- * Checks if an element is a valid React element of a given component type.
- *
- * @param element - The element to test.
- * @param component - The component to match.
- */
-const isComponentElement = (element, component) => /*#__PURE__*/React.isValidElement(element) && element.type === component;
+* Copyright IBM Corp. 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.
+*/
+/**
+* Checks if an element is a valid React element of a given component type.
+*
+* @param element - The element to test.
+* @param component - The component to match.
+*/
+const isComponentElement = (element, component) => (0, react.isValidElement)(element) && element.type === component;
 
-exports.isComponentElement = isComponentElement;
+//#endregion
+exports.isComponentElement = isComponentElement;

package/lib/internal/warning.js

@@ -1,32 +1,33 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-var noopFn = require('./noopFn.js');
+const require_noopFn = require('./noopFn.js');
 
+//#region src/internal/warning.ts
 /**
- * Logs a warning.
- *
- * The warning is only logged if the condition is not met and
- * `process.env.NODE_ENV !== 'production'` is truthy.
- *
- * @param condition - Condition to evaluate.
- * @param message - Warning message.
- * @throws Error if no `message` is provided.
- */
-const warning = process.env.NODE_ENV !== 'production' ? (condition, message) => {
-  if (typeof message === 'undefined') {
-    throw new Error('`warning(condition, message)` requires a warning ' + 'format argument');
-  }
-  if (!condition) {
-    // eslint-disable-next-line no-console -- https://github.com/carbon-design-system/carbon/issues/20452
-    console.warn('Warning: ' + message);
-  }
-} : noopFn.noopFn;
+* 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.
+*/
+/**
+* Logs a warning.
+*
+* The warning is only logged if the condition is not met and
+* `process.env.NODE_ENV !== 'production'` is truthy.
+*
+* @param condition - Condition to evaluate.
+* @param message - Warning message.
+* @throws Error if no `message` is provided.
+*/
+const warning = process.env.NODE_ENV !== "production" ? (condition, message) => {
+	if (typeof message === "undefined") throw new Error("`warning(condition, message)` requires a warning format argument");
+	if (!condition) console.warn("Warning: " + message);
+} : require_noopFn.noopFn;
 
-exports.warning = warning;
+//#endregion
+exports.warning = warning;

package/lib/internal/wrapFocus.js

@@ -1,118 +1,96 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
-
-var tabbable = require('tabbable');
-var navigation = require('./keyboard/navigation.js');
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_navigation = require('./keyboard/navigation.js');
+let tabbable = require("tabbable");
 
+//#region src/internal/wrapFocus.ts
 /**
- * A flag `node.compareDocumentPosition(target)` returns that indicates
- * `target` is located earlier than `node` in the document or `target` contains `node`.
- */
-const DOCUMENT_POSITION_BROAD_PRECEDING = typeof Node !== 'undefined' ? Node.DOCUMENT_POSITION_PRECEDING | Node.DOCUMENT_POSITION_CONTAINS : 0;
-
+* 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.
+*/
 /**
- * A flag `node.compareDocumentPosition(target)` returns that indicates
- * `target` is located later than `node` in the document or `node` contains `target`.
- */
-const DOCUMENT_POSITION_BROAD_FOLLOWING = typeof Node !== 'undefined' ? Node.DOCUMENT_POSITION_FOLLOWING | Node.DOCUMENT_POSITION_CONTAINED_BY : 0;
-
+* A flag `node.compareDocumentPosition(target)` returns that indicates
+* `target` is located earlier than `node` in the document or `target` contains `node`.
+*/
+const DOCUMENT_POSITION_BROAD_PRECEDING = typeof Node !== "undefined" ? Node.DOCUMENT_POSITION_PRECEDING | Node.DOCUMENT_POSITION_CONTAINS : 0;
 /**
- * Checks whether the given node or one of its ancestors matches any of the
- * specified floating menu selectors.
- *
- * @param {Node} node - A DOM node.
- * @param {string[]} selectorsFloatingMenus - Additional CSS selectors that
- * match floating menus.
- * @returns {boolean} Whether the node or one of its ancestors is in a floating
- * menu.
- */
-const elementOrParentIsFloatingMenu = (node, selectorsFloatingMenus = [], prefix = 'cds') => {
-  if (node instanceof Element && typeof node.closest === 'function') {
-    const allSelectorsFloatingMenus = [`.${prefix}--overflow-menu-options`, `.${prefix}--tooltip`, '.flatpickr-calendar', ...selectorsFloatingMenus];
-    return allSelectorsFloatingMenus.some(selector => !!node.closest(selector));
-  }
-  return false;
+* A flag `node.compareDocumentPosition(target)` returns that indicates
+* `target` is located later than `node` in the document or `node` contains `target`.
+*/
+const DOCUMENT_POSITION_BROAD_FOLLOWING = typeof Node !== "undefined" ? Node.DOCUMENT_POSITION_FOLLOWING | Node.DOCUMENT_POSITION_CONTAINED_BY : 0;
+/**
+* Checks whether the given node or one of its ancestors matches any of the
+* specified floating menu selectors.
+*
+* @param {Node} node - A DOM node.
+* @param {string[]} selectorsFloatingMenus - Additional CSS selectors that
+* match floating menus.
+* @returns {boolean} Whether the node or one of its ancestors is in a floating
+* menu.
+*/
+const elementOrParentIsFloatingMenu = (node, selectorsFloatingMenus = [], prefix = "cds") => {
+	if (node instanceof Element && typeof node.closest === "function") return [
+		`.${prefix}--overflow-menu-options`,
+		`.${prefix}--tooltip`,
+		".flatpickr-calendar",
+		...selectorsFloatingMenus
+	].some((selector) => !!node.closest(selector));
+	return false;
 };
-
 /**
- * Ensures the focus is kept within the given container by implementing
- * "focus-wrap" behavior.
- */
-const wrapFocus = ({
-  bodyNode,
-  startTrapNode,
-  endTrapNode,
-  currentActiveNode,
-  oldActiveNode,
-  selectorsFloatingMenus,
-  prefix = 'cds'
-}) => {
-  if (bodyNode && currentActiveNode && oldActiveNode && !bodyNode.contains(currentActiveNode) && !elementOrParentIsFloatingMenu(currentActiveNode, selectorsFloatingMenus, prefix)) {
-    const comparisonResult = oldActiveNode.compareDocumentPosition(currentActiveNode);
-    if (currentActiveNode === startTrapNode || comparisonResult & DOCUMENT_POSITION_BROAD_PRECEDING) {
-      const tabbableElement = Array.from(bodyNode.querySelectorAll(navigation.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(navigation.selectorTabbable)).find(({
-        offsetParent
-      }) => Boolean(offsetParent));
-      if (tabbableElement) {
-        tabbableElement.focus();
-      } else if (bodyNode !== oldActiveNode) {
-        bodyNode.focus();
-      }
-    }
-  }
+* Ensures the focus is kept within the given container by implementing
+* "focus-wrap" behavior.
+*/
+const wrapFocus = ({ bodyNode, startTrapNode, endTrapNode, currentActiveNode, oldActiveNode, selectorsFloatingMenus, prefix = "cds" }) => {
+	if (bodyNode && currentActiveNode && oldActiveNode && !bodyNode.contains(currentActiveNode) && !elementOrParentIsFloatingMenu(currentActiveNode, selectorsFloatingMenus, prefix)) {
+		const comparisonResult = oldActiveNode.compareDocumentPosition(currentActiveNode);
+		if (currentActiveNode === startTrapNode || comparisonResult & DOCUMENT_POSITION_BROAD_PRECEDING) {
+			const tabbableElement = Array.from(bodyNode.querySelectorAll(require_navigation.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(require_navigation.selectorTabbable)).find(({ offsetParent }) => Boolean(offsetParent));
+			if (tabbableElement) tabbableElement.focus();
+			else if (bodyNode !== oldActiveNode) bodyNode.focus();
+		}
+	}
 };
-
 /**
- * Ensures the focus is kept in the given container, implementing "focus-wrap"
- * behavior.
- *
- * Note: This must be called *before* focus moves using `onKeyDown` or similar.
- */
-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.`);
-  }
-
-  // Use `tabbable` to get the focusable elements in tab order.
-  // `selectorTabbable` returns elements in DOM order which is why it's not
-  // used.
-  const tabbables = tabbable.tabbable(containerNode);
-  const firstTabbable = tabbables[0];
-  const lastTabbable = tabbables[tabbables.length - 1];
-
-  // The shift key indicates if focus is moving forwards or backwards.
-  if (currentActiveNode === lastTabbable && !event.shiftKey) {
-    // Cancel the current movement of focus because we're going to place it ourselves
-    event.preventDefault();
-    firstTabbable.focus();
-  }
-  if (currentActiveNode === firstTabbable && event.shiftKey) {
-    // Cancel the current movement of focus because we're going to place it ourselves
-    event.preventDefault();
-    lastTabbable.focus();
-  }
+* Ensures the focus is kept in the given container, implementing "focus-wrap"
+* behavior.
+*
+* Note: This must be called *before* focus moves using `onKeyDown` or similar.
+*/
+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.`);
+	const tabbables = (0, tabbable.tabbable)(containerNode);
+	const firstTabbable = tabbables[0];
+	const lastTabbable = tabbables[tabbables.length - 1];
+	if (currentActiveNode === lastTabbable && !event.shiftKey) {
+		event.preventDefault();
+		firstTabbable.focus();
+	}
+	if (currentActiveNode === firstTabbable && event.shiftKey) {
+		event.preventDefault();
+		lastTabbable.focus();
+	}
 };
 
+//#endregion
 exports.elementOrParentIsFloatingMenu = elementOrParentIsFloatingMenu;
 exports.wrapFocus = wrapFocus;
-exports.wrapFocusWithoutSentinels = wrapFocusWithoutSentinels;
+exports.wrapFocusWithoutSentinels = wrapFocusWithoutSentinels;

package/lib/prop-types/AriaPropTypes.js

@@ -1,18 +1,26 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-'use strict';
+const require_runtime = require('../_virtual/_rolldown/runtime.js');
+const require_isRequiredOneOf = require('./isRequiredOneOf.js');
+let prop_types = require("prop-types");
+prop_types = require_runtime.__toESM(prop_types);
 
-var PropTypes = require('prop-types');
-var isRequiredOneOf = require('./isRequiredOneOf.js');
-
-const AriaLabelPropType = isRequiredOneOf.isRequiredOneOf({
-  'aria-label': PropTypes.string,
-  'aria-labelledby': PropTypes.string
+//#region src/prop-types/AriaPropTypes.ts
+/**
+* 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.
+*/
+const AriaLabelPropType = require_isRequiredOneOf.isRequiredOneOf({
+	"aria-label": prop_types.default.string,
+	"aria-labelledby": prop_types.default.string
 });
 
-exports.AriaLabelPropType = AriaLabelPropType;
+//#endregion
+exports.AriaLabelPropType = AriaLabelPropType;