@carbon/react 1.103.0-rc.0 → 1.104.0-rc.0

package/lib/internal/OptimizedResize.js

@@ -1,58 +1,46 @@
 /**
- * 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';
-
-// Use `globalThis` for universal access to global object (browser, workers, Node).
-const win = globalThis;
 
+//#region src/internal/OptimizedResize.ts
 /**
- * A callback function to be executed on `resize`.
- */
-
+* 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 win = globalThis;
 const OptimizedResize = (() => {
-  const callbacks = [];
-  let running = false;
-  const runCallbacks = () => {
-    callbacks.forEach(callback => {
-      callback();
-    });
-    running = false;
-  };
-  const handleResize = () => {
-    if (!running) {
-      running = true;
-      win.requestAnimationFrame(runCallbacks);
-    }
-  };
-  const addCallback = callback => {
-    const index = callbacks.indexOf(callback);
-    if (index < 0) {
-      callbacks.push(callback);
-    }
-  };
-  return {
-    /** Adds a callback function to be executed on window `resize`. */
-    add: callback => {
-      if (!callbacks.length) {
-        win.addEventListener('resize', handleResize);
-      }
-      addCallback(callback);
-      return {
-        /** Removes the callback. */
-        remove: () => {
-          const index = callbacks.indexOf(callback);
-          if (index >= 0) {
-            callbacks.splice(index, 1);
-          }
-        }
-      };
-    }
-  };
+	const callbacks = [];
+	let running = false;
+	const runCallbacks = () => {
+		callbacks.forEach((callback) => {
+			callback();
+		});
+		running = false;
+	};
+	const handleResize = () => {
+		if (!running) {
+			running = true;
+			win.requestAnimationFrame(runCallbacks);
+		}
+	};
+	const addCallback = (callback) => {
+		if (callbacks.indexOf(callback) < 0) callbacks.push(callback);
+	};
+	return { add: (callback) => {
+		if (!callbacks.length) win.addEventListener("resize", handleResize);
+		addCallback(callback);
+		return { remove: () => {
+			const index = callbacks.indexOf(callback);
+			if (index >= 0) callbacks.splice(index, 1);
+		} };
+	} };
 })();
 
-exports.OptimizedResize = OptimizedResize;
+//#endregion
+exports.OptimizedResize = OptimizedResize;

package/lib/internal/Selection.js

@@ -1,147 +1,115 @@
 /**
- * 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');
+let react = require("react");
+react = require_runtime.__toESM(react);
+let react_jsx_runtime = require("react/jsx-runtime");
+let react_fast_compare = require("react-fast-compare");
+react_fast_compare = require_runtime.__toESM(react_fast_compare);
 
-var React = require('react');
-var isEqual = require('react-fast-compare');
-
-const callOnChangeHandler = ({
-  isControlled,
-  isMounted,
-  onChangeHandlerControlled,
-  onChangeHandlerUncontrolled,
-  selectedItems
-}) => {
-  if (isControlled) {
-    if (isMounted && onChangeHandlerControlled) {
-      // Use setTimeout to defer the controlled onChange call,
-      // avoiding React’s warning: "Cannot update a component while rendering a different component".
-      // This ensures the parent state updates after rendering completes.
-      setTimeout(() => {
-        onChangeHandlerControlled({
-          selectedItems
-        });
-      }, 0);
-    }
-  } else {
-    onChangeHandlerUncontrolled(selectedItems);
-  }
+//#region src/internal/Selection.tsx
+/**
+* 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 callOnChangeHandler = ({ isControlled, isMounted, onChangeHandlerControlled, onChangeHandlerUncontrolled, selectedItems }) => {
+	if (isControlled) {
+		if (isMounted && onChangeHandlerControlled) setTimeout(() => {
+			onChangeHandlerControlled({ selectedItems });
+		}, 0);
+	} else onChangeHandlerUncontrolled(selectedItems);
 };
-const useSelection = ({
-  disabled,
-  onChange,
-  initialSelectedItems = [],
-  selectedItems: controlledItems,
-  selectAll = false,
-  filteredItems = []
-}) => {
-  const isMounted = React.useRef(false);
-  const savedOnChange = React.useRef(onChange);
-  const [uncontrolledItems, setUncontrolledItems] = React.useState(initialSelectedItems);
-  const isControlled = !!controlledItems;
-  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- https://github.com/carbon-design-system/carbon/issues/20452
-  const selectedItems = isControlled ? controlledItems : uncontrolledItems;
-  const onItemChange = React.useCallback(item => {
-    if (disabled) return;
-
-    // Assert special properties (e.g., `disabled`, `isSelectAll`, etc.) are
-    // `any` since those properties aren’t part of the generic type.
-    const allSelectableItems = filteredItems.filter(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
-    item => !item?.disabled && !item?.isSelectAll);
-    const disabledItemCount = filteredItems.filter(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
-    item => item?.disabled).length;
-    let newSelectedItems;
-
-    // deselect all on click to All/indeterminate option
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
-    if (item?.isSelectAll && selectedItems.length > 0) {
-      newSelectedItems = [];
-    }
-    // select all options
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
-    else if (item?.isSelectAll && selectedItems.length === 0) {
-      newSelectedItems = allSelectableItems;
-    } else {
-      const selectedIndex = selectedItems.findLastIndex(selectedItem => isEqual(selectedItem, item));
-      if (selectedIndex === -1) {
-        newSelectedItems = selectedItems.concat(item);
-        // checking if all items are selected then We should select mark the 'select All' option as well
-        if (selectAll && filteredItems.length - 1 === newSelectedItems.length + disabledItemCount) {
-          newSelectedItems = allSelectableItems;
-        }
-      } else {
-        newSelectedItems = removeAtIndex(selectedItems, selectedIndex);
-        newSelectedItems = newSelectedItems.filter(
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- https://github.com/carbon-design-system/carbon/issues/20452
-        item => !item?.isSelectAll);
-      }
-    }
-    callOnChangeHandler({
-      isControlled,
-      isMounted: isMounted.current,
-      onChangeHandlerControlled: savedOnChange.current,
-      onChangeHandlerUncontrolled: setUncontrolledItems,
-      selectedItems: newSelectedItems
-    });
-  }, [disabled, selectedItems, filteredItems, selectAll, isControlled]);
-  const clearSelection = React.useCallback(() => {
-    if (disabled) return;
-    callOnChangeHandler({
-      isControlled,
-      isMounted: isMounted.current,
-      onChangeHandlerControlled: savedOnChange.current,
-      onChangeHandlerUncontrolled: setUncontrolledItems,
-      selectedItems: []
-    });
-  }, [disabled, isControlled]);
-  const toggleAll = React.useCallback(items => {
-    callOnChangeHandler({
-      isControlled,
-      isMounted: isMounted.current,
-      onChangeHandlerControlled: savedOnChange.current,
-      onChangeHandlerUncontrolled: setUncontrolledItems,
-      selectedItems: items
-    });
-  }, [isControlled]);
-  React.useEffect(() => {
-    savedOnChange.current = onChange;
-  }, [onChange]);
-  React.useEffect(() => {
-    if (isMounted.current && savedOnChange.current && !isControlled) {
-      savedOnChange.current({
-        selectedItems
-      });
-    }
-  }, [isControlled, selectedItems]);
-  React.useEffect(() => {
-    isMounted.current = true;
-    return () => {
-      isMounted.current = false;
-    };
-  }, []);
-  return {
-    clearSelection,
-    onItemChange,
-    toggleAll,
-    selectedItems
-  };
+const useSelection = ({ disabled, onChange, initialSelectedItems = [], selectedItems: controlledItems, selectAll = false, filteredItems = [] }) => {
+	const isMounted = (0, react.useRef)(false);
+	const savedOnChange = (0, react.useRef)(onChange);
+	const [uncontrolledItems, setUncontrolledItems] = (0, react.useState)(initialSelectedItems);
+	const isControlled = !!controlledItems;
+	const selectedItems = isControlled ? controlledItems : uncontrolledItems;
+	const onItemChange = (0, react.useCallback)((item) => {
+		if (disabled) return;
+		const allSelectableItems = filteredItems.filter((item) => !item?.disabled && !item?.isSelectAll);
+		const disabledItemCount = filteredItems.filter((item) => item?.disabled).length;
+		let newSelectedItems;
+		if (item?.isSelectAll && selectedItems.length > 0) newSelectedItems = [];
+		else if (item?.isSelectAll && selectedItems.length === 0) newSelectedItems = allSelectableItems;
+		else {
+			const selectedIndex = selectedItems.findLastIndex((selectedItem) => (0, react_fast_compare.default)(selectedItem, item));
+			if (selectedIndex === -1) {
+				newSelectedItems = selectedItems.concat(item);
+				if (selectAll && filteredItems.length - 1 === newSelectedItems.length + disabledItemCount) newSelectedItems = allSelectableItems;
+			} else {
+				newSelectedItems = removeAtIndex(selectedItems, selectedIndex);
+				newSelectedItems = newSelectedItems.filter((item) => !item?.isSelectAll);
+			}
+		}
+		callOnChangeHandler({
+			isControlled,
+			isMounted: isMounted.current,
+			onChangeHandlerControlled: savedOnChange.current,
+			onChangeHandlerUncontrolled: setUncontrolledItems,
+			selectedItems: newSelectedItems
+		});
+	}, [
+		disabled,
+		selectedItems,
+		filteredItems,
+		selectAll,
+		isControlled
+	]);
+	const clearSelection = (0, react.useCallback)(() => {
+		if (disabled) return;
+		callOnChangeHandler({
+			isControlled,
+			isMounted: isMounted.current,
+			onChangeHandlerControlled: savedOnChange.current,
+			onChangeHandlerUncontrolled: setUncontrolledItems,
+			selectedItems: []
+		});
+	}, [disabled, isControlled]);
+	const toggleAll = (0, react.useCallback)((items) => {
+		callOnChangeHandler({
+			isControlled,
+			isMounted: isMounted.current,
+			onChangeHandlerControlled: savedOnChange.current,
+			onChangeHandlerUncontrolled: setUncontrolledItems,
+			selectedItems: items
+		});
+	}, [isControlled]);
+	(0, react.useEffect)(() => {
+		savedOnChange.current = onChange;
+	}, [onChange]);
+	(0, react.useEffect)(() => {
+		if (isMounted.current && savedOnChange.current && !isControlled) savedOnChange.current({ selectedItems });
+	}, [isControlled, selectedItems]);
+	(0, react.useEffect)(() => {
+		isMounted.current = true;
+		return () => {
+			isMounted.current = false;
+		};
+	}, []);
+	return {
+		clearSelection,
+		onItemChange,
+		toggleAll,
+		selectedItems
+	};
 };
-
 /**
- * Generic utility for safely removing an element at a given index from an
- * array.
- */
+* Generic utility for safely removing an element at a given index from an
+* array.
+*/
 const removeAtIndex = (array, index) => {
-  const result = array.slice();
-  result.splice(index, 1);
-  return result;
+	const result = array.slice();
+	result.splice(index, 1);
+	return result;
 };
 
-exports.useSelection = useSelection;
+//#endregion
+exports.useSelection = useSelection;

package/lib/internal/clamp.js

@@ -1,15 +1,22 @@
 /**
- * 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';
 
+//#region src/internal/clamp.ts
 /**
- * Clamps a number between a minimum and maximum value (inclusive).
- */
+* 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.
+*/
+/**
+* Clamps a number between a minimum and maximum value (inclusive).
+*/
 const clamp = (num, min, max) => Math.min(max, Math.max(min, num));
 
-exports.clamp = clamp;
+//#endregion
+exports.clamp = clamp;

package/lib/internal/defaultItemToString.js

@@ -1,19 +1,24 @@
 /**
- * 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 defaultItemToString = item => {
-  if (typeof item === 'string') return item;
-  if (typeof item === 'number') return `${item}`;
-  if (item && typeof item === 'object' && 'label' in item && typeof item.label === 'string') {
-    return item.label;
-  }
-  return '';
+//#region src/internal/defaultItemToString.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 defaultItemToString = (item) => {
+	if (typeof item === "string") return item;
+	if (typeof item === "number") return `${item}`;
+	if (item && typeof item === "object" && "label" in item && typeof item.label === "string") return item.label;
+	return "";
 };
 
-exports.defaultItemToString = defaultItemToString;
+//#endregion
+exports.defaultItemToString = defaultItemToString;

package/lib/internal/deprecateFieldOnObject.js

@@ -1,26 +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 warning = require('./warning.js');
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_warning = require('./warning.js');
 
+//#region src/internal/deprecateFieldOnObject.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 deprecateFieldOnObject = (object, field, Component, message) => {
-  const didWarnAboutDeprecation = {};
-  Object.defineProperty(object, field, {
-    enumerable: true,
-    get: () => {
-      if (!didWarnAboutDeprecation[field]) {
-        process.env.NODE_ENV !== "production" ? warning.warning(false, `The ${field} field has been deprecated on the ${object.displayName} object. ` + `Please import and use ${Component.displayName || Component.name || 'the field'} directly.`) : void 0;
-        didWarnAboutDeprecation[field] = true;
-      }
-      return Component;
-    }
-  });
+	const didWarnAboutDeprecation = {};
+	Object.defineProperty(object, field, {
+		enumerable: true,
+		get: () => {
+			if (!didWarnAboutDeprecation[field]) {
+				require_warning.warning(false, message || `The ${field} field has been deprecated on the ${object.displayName} object. Please import and use ${Component.displayName || Component.name || "the field"} directly.`);
+				didWarnAboutDeprecation[field] = true;
+			}
+			return Component;
+		}
+	});
 };
 
-exports.deprecateFieldOnObject = deprecateFieldOnObject;
+//#endregion
+exports.deprecateFieldOnObject = deprecateFieldOnObject;

package/lib/internal/environment.js

@@ -1,17 +1,24 @@
 /**
- * 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';
 
+//#region src/internal/environment.ts
 /**
- * Indicate whether current execution environment can access the DOM.
- *
- * @see https://github.com/facebook/fbjs/blob/4d1751311d3f67af2dcce2e40df8512a23c7b9c6/packages/fbjs/src/core/ExecutionEnvironment.js#L12
- */
-const canUseDOM = !!(typeof window !== 'undefined' && window.document && window.document.createElement);
+* 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.
+*/
+/**
+* Indicate whether current execution environment can access the DOM.
+*
+* @see https://github.com/facebook/fbjs/blob/4d1751311d3f67af2dcce2e40df8512a23c7b9c6/packages/fbjs/src/core/ExecutionEnvironment.js#L12
+*/
+const canUseDOM = !!(typeof window !== "undefined" && window.document && window.document.createElement);
 
-exports.canUseDOM = canUseDOM;
+//#endregion
+exports.canUseDOM = canUseDOM;

package/lib/internal/getAnnouncement.js

@@ -1,24 +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';
 
+//#region src/internal/getAnnouncement.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.
+*/
 /** Returns an announcement message when the remaining count is low. */
-const getAnnouncement = (count, maxCount, singularEntityName = 'character', pluralEntityName = 'characters') => {
-  if (typeof maxCount === 'undefined') return null;
-  const remaining = maxCount - count;
-  if (remaining <= 10 && remaining > 0) {
-    const entityName = remaining === 1 ? singularEntityName : pluralEntityName;
-    return `${remaining} ${entityName} left.`;
-  }
-  if (remaining <= 0) {
-    return `Maximum ${pluralEntityName} reached.`;
-  }
-  return null;
+const getAnnouncement = (count, maxCount, singularEntityName = "character", pluralEntityName = "characters") => {
+	if (typeof maxCount === "undefined") return null;
+	const remaining = maxCount - count;
+	if (remaining <= 10 && remaining > 0) return `${remaining} ${remaining === 1 ? singularEntityName : pluralEntityName} left.`;
+	if (remaining <= 0) return `Maximum ${pluralEntityName} reached.`;
+	return null;
 };
 
-exports.getAnnouncement = getAnnouncement;
+//#endregion
+exports.getAnnouncement = getAnnouncement;