@carbon/react 1.79.0 → 1.80.0-rc.0

package/es/components/TextArea/TextArea.js

@@ -7,7 +7,7 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default, { useContext, useRef, useState, useEffect } from 'react';
+import React__default, { forwardRef, useContext, useRef, useState, useEffect } from 'react';
 import cx from 'classnames';
 import deprecate from '../../prop-types/deprecate.js';
 import { WarningFilled, WarningAltFilled } from '@carbon/icons-react';
@@ -22,7 +22,10 @@ import { noopFn } from '../../internal/noopFn.js';
 import '../Text/index.js';
 import { Text } from '../Text/Text.js';
 
-const TextArea = /*#__PURE__*/React__default.forwardRef((props, forwardRef) => {
+// TODO: This type was added to prevent the formatter from changing the
+// indentation of this entire function. Delete it in a future pull request.
+
+const TextArea = /*#__PURE__*/forwardRef((props, forwardRef) => {
   const {
     className,
     decorator,

package/es/components/TextInput/ControlledPasswordInput.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Copyright IBM Corp. 2023, 2024
+ *
+ * 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';
 import { ReactAttr } from '../../types/common';
 export interface ControlledPasswordInputProps extends ReactAttr<HTMLInputElement> {

package/es/components/TextInput/ControlledPasswordInput.js

@@ -45,7 +45,7 @@ const ControlledPasswordInput = /*#__PURE__*/React__default.forwardRef(function
   } = _ref;
   const prefix = usePrefix();
   const controlledPasswordInstanceId = useId();
-  if (process.env.NODE_ENV !== "production") {
+  if (process.env.NODE_ENV !== 'production') {
     process.env.NODE_ENV !== "production" ? warning(didWarnAboutDeprecation, '`<TextInput.ControlledPasswordInput>` has been deprecated in favor of `<TextInput.PasswordInput />` and will be removed in the next major release of `carbon-components-react`') : void 0;
     didWarnAboutDeprecation = true;
   }

package/es/components/TextInput/PasswordInput.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Copyright IBM Corp. 2023, 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, { InputHTMLAttributes, ReactNode } from 'react';
 type ExcludedAttributes = 'size';
 export interface PasswordInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, ExcludedAttributes> {

package/es/components/TextInput/index.js

@@ -12,7 +12,7 @@ import TextInput from './TextInput.js';
 export { default as TextInput, default } from './TextInput.js';
 export { default as TextInputSkeleton } from './TextInput.Skeleton.js';
 
-if (process.env.NODE_ENV !== "production") {
+if (process.env.NODE_ENV !== 'production') {
   deprecateFieldOnObject(TextInput, 'ControlledPasswordInput', ControlledPasswordInput);
   deprecateFieldOnObject(TextInput, 'PasswordInput', PasswordInput);
 }

package/es/components/Tile/Tile.d.ts

@@ -4,7 +4,7 @@
  * 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 ReactNode, type MouseEvent, type KeyboardEvent, type HTMLAttributes, type ChangeEvent } from 'react';
+import React, { type ChangeEvent, type HTMLAttributes, type KeyboardEvent, type MouseEvent, type ReactNode } from 'react';
 export interface TileProps extends HTMLAttributes<HTMLDivElement> {
     children?: ReactNode;
     className?: string;

package/es/components/Tile/Tile.js

@@ -517,7 +517,6 @@ const ExpandableTile = /*#__PURE__*/React__default.forwardRef(function Expandabl
     });
   }
   return interactive ? /*#__PURE__*/React__default.createElement("div", _extends({
-    // @ts-expect-error: Needlesly strict & deep typing for the element type
     ref: ref,
     className: interactiveClassNames
   }, rest), /*#__PURE__*/React__default.createElement("div", {
@@ -541,9 +540,7 @@ const ExpandableTile = /*#__PURE__*/React__default.forwardRef(function Expandabl
     className: `${prefix}--tile-content`,
     id: belowTheFoldId
   }, childrenAsArray[1]))) : /*#__PURE__*/React__default.createElement("button", _extends({
-    type: "button"
-    // @ts-expect-error: Needlesly strict & deep typing for the element type
-    ,
+    type: "button",
     ref: ref,
     className: classNames,
     "aria-expanded": isExpanded,

package/es/components/UIShell/Switcher.d.ts

@@ -1,11 +1,5 @@
 /**
- * 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.
- */
-/**
- * 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.

package/es/components/UIShell/SwitcherDivider.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Copyright IBM Corp. 2023, 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 from 'react';
 export interface SwitcherDividerProps {
     /**

package/es/components/UIShell/SwitcherItem.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Copyright IBM Corp. 2023, 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, { HTMLAttributeAnchorTarget, KeyboardEvent } from 'react';
 export interface BaseSwitcherItemProps {
     /**

package/es/index.d.ts

@@ -31,6 +31,9 @@ export * from './components/DatePickerInput';
 export * from './components/Dropdown';
 export * from './components/ErrorBoundary';
 export * from './components/ExpandableSearch';
+export { FeatureFlags, useFeatureFlag, useFeatureFlags, FeatureFlags as unstable_FeatureFlags, // this export can be removed in v12
+useFeatureFlag as unstable_useFeatureFlag, // this export can be removed in v12
+useFeatureFlags as unstable_useFeatureFlags, } from './components/FeatureFlags';
 export * from './components/FileUploader';
 export * from './components/FilterableMultiSelect';
 export * from './components/FluidForm';
@@ -55,6 +58,7 @@ export * from './components/NumberInput';
 export * from './components/OrderedList';
 export * from './components/OverflowMenu';
 export * from './components/OverflowMenuItem';
+export * as unstable__PageHeader from './components/PageHeader';
 export * from './components/Pagination';
 export * from './components/Pagination/Pagination.Skeleton';
 export * from './components/PaginationNav';
@@ -95,7 +99,6 @@ export * from './components/Toggletip';
 export * from './components/TreeView';
 export * from './components/UIShell';
 export * from './components/UnorderedList';
-export { FeatureFlags as unstable_FeatureFlags, useFeatureFlag as unstable_useFeatureFlag, useFeatureFlags as unstable_useFeatureFlags, } from './components/FeatureFlags';
 export { FluidComboBox as unstable__FluidComboBox, FluidComboBoxSkeleton as unstable__FluidComboBoxSkeleton, } from './components/FluidComboBox';
 export { FluidDatePicker as unstable__FluidDatePicker, FluidDatePickerSkeleton as unstable__FluidDatePickerSkeleton, } from './components/FluidDatePicker';
 export { FluidDatePickerInput as unstable__FluidDatePickerInput } from './components/FluidDatePickerInput';
@@ -263,6 +266,7 @@ export type { NumberInputSkeletonProps } from './components/NumberInput/NumberIn
 export type { OrderedListProps } from './components/OrderedList/OrderedList';
 export type { OverflowMenuProps } from './components/OverflowMenu/OverflowMenu';
 export type { OverflowMenuItemProps } from './components/OverflowMenuItem/OverflowMenuItem';
+export type { PageHeaderProps, PageHeaderBreadcrumbBarProps, PageHeaderContentProps, PageHeaderHeroImageProps, PageHeaderTabBarProps, } from './components/PageHeader';
 export type { PaginationProps } from './components/Pagination/Pagination';
 export type { PaginationSkeletonProps } from './components/Pagination/Pagination.Skeleton';
 export type { DirectionButtonProps } from './components/PaginationNav/PaginationNav';

package/es/index.js

@@ -43,6 +43,7 @@ export { default as DropdownSkeleton } from './components/Dropdown/Dropdown.Skel
 export { default as ErrorBoundary } from './components/ErrorBoundary/ErrorBoundary.js';
 export { ErrorBoundaryContext } from './components/ErrorBoundary/ErrorBoundaryContext.js';
 export { default as ExpandableSearch } from './components/ExpandableSearch/ExpandableSearch.js';
+export { FeatureFlags, FeatureFlags as unstable_FeatureFlags, useFeatureFlag as unstable_useFeatureFlag, useFeatureFlags as unstable_useFeatureFlags, useFeatureFlag, useFeatureFlags } from './components/FeatureFlags/index.js';
 export { default as FileUploader } from './components/FileUploader/FileUploader.js';
 export { default as Filename } from './components/FileUploader/Filename.js';
 export { default as FileUploaderSkeleton } from './components/FileUploader/FileUploader.Skeleton.js';
@@ -79,6 +80,8 @@ export { NumberInput } from './components/NumberInput/NumberInput.js';
 export { default as OrderedList } from './components/OrderedList/OrderedList.js';
 export { default as OverflowMenu } from './components/OverflowMenu/index.js';
 export { default as OverflowMenuItem } from './components/OverflowMenuItem/OverflowMenuItem.js';
+import * as index from './components/PageHeader/index.js';
+export { index as unstable__PageHeader };
 export { default as Pagination } from './components/Pagination/Pagination.js';
 export { default as PaginationSkeleton } from './components/Pagination/Pagination.Skeleton.js';
 export { default as PaginationNav } from './components/PaginationNav/PaginationNav.js';
@@ -160,7 +163,6 @@ export { default as SideNavMenu } from './components/UIShell/SideNavMenu.js';
 export { default as SideNavMenuItem } from './components/UIShell/SideNavMenuItem.js';
 export { default as SideNavSwitcher } from './components/UIShell/SideNavSwitcher.js';
 export { default as UnorderedList } from './components/UnorderedList/UnorderedList.js';
-export { FeatureFlags as unstable_FeatureFlags, useFeatureFlag as unstable_useFeatureFlag, useFeatureFlags as unstable_useFeatureFlags } from './components/FeatureFlags/index.js';
 export { default as unstable__FluidComboBox } from './components/FluidComboBox/FluidComboBox.js';
 export { default as unstable__FluidComboBoxSkeleton } from './components/FluidComboBox/FluidComboBox.Skeleton.js';
 export { default as unstable__FluidDatePicker } from './components/FluidDatePicker/FluidDatePicker.js';

package/es/internal/FloatingMenu.js

@@ -104,7 +104,7 @@ const FloatingMenu = _ref2 => {
   const updateMenuPosition = useCallback(isAdjustment => {
     const menuBody = menuBodyRef.current;
     if (!menuBody) {
-      process.env.NODE_ENV !== "production" ? warning(menuBody, 'The DOM node for menu body for calculating its position is not available. Skipping...') : void 0;
+      process.env.NODE_ENV !== "production" ? warning(!!menuBody, 'The DOM node for menu body for calculating its position is not available. Skipping...') : void 0;
       return;
     }
     const triggerEl = triggerRef.current;
@@ -174,7 +174,7 @@ const FloatingMenu = _ref2 => {
     // First programmatic focusable node
     menuBody;
     focusTarget.focus();
-    if (focusTarget === menuBody && process.env.NODE_ENV !== "production") {
+    if (focusTarget === menuBody) {
       process.env.NODE_ENV !== "production" ? warning(focusableNode === null, 'Floating Menus must have at least a programmatically focusable child. This can be accomplished by adding tabIndex="-1" to the content element.') : void 0;
     }
   };

package/es/internal/PolymorphicProps.d.ts

@@ -1,3 +1,9 @@
+/**
+ * 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.
+ */
 type AsProp<C extends React.ElementType> = {
     as?: C;
 };

package/es/internal/deprecateFieldOnObject.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+export declare const deprecateFieldOnObject: <T extends {
+    displayName?: string;
+}>(object: T, field: string, Component: {
+    displayName?: string;
+    name?: string;
+}, message?: string) => void;

package/es/internal/deprecateFieldOnObject.js

@@ -7,11 +7,11 @@
 
 import { warning } from './warning.js';
 
-const didWarnAboutDeprecation = {};
-function deprecateFieldOnObject(object, field, Component, message) {
+const deprecateFieldOnObject = (object, field, Component, message) => {
+  const didWarnAboutDeprecation = {};
   Object.defineProperty(object, field, {
     enumerable: true,
-    get() {
+    get: () => {
       if (!didWarnAboutDeprecation[field]) {
         process.env.NODE_ENV !== "production" ? 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.`) : void 0;
         didWarnAboutDeprecation[field] = true;
@@ -19,6 +19,6 @@ function deprecateFieldOnObject(object, field, Component, message) {
       return Component;
     }
   });
-}
+};
 
 export { deprecateFieldOnObject };

package/es/internal/useControllableState.js

@@ -56,13 +56,13 @@ function useControllableState(_ref) {
     // Uncontrolled -> Controlled
     // If the component prop is uncontrolled, the prop value should be undefined
     if (controlled.current === false && controlledValue) {
-      process.env.NODE_ENV !== "production" ? warning(false, 'A component is changing an uncontrolled %s component to be controlled. ' + 'This is likely caused by the value changing to a defined value ' + 'from undefined. Decide between using a controlled or uncontrolled ' + 'value for the lifetime of the component. ' + 'More info: https://reactjs.org/link/controlled-components', name) : void 0;
+      process.env.NODE_ENV !== "production" ? warning(false, `A component is changing an uncontrolled ${name} component to be controlled. ` + 'This is likely caused by the value changing to a defined value ' + 'from undefined. Decide between using a controlled or uncontrolled ' + 'value for the lifetime of the component. ' + 'More info: https://reactjs.org/link/controlled-components') : void 0;
     }
 
     // Controlled -> Uncontrolled
     // If the component prop is controlled, the prop value should be defined
     if (controlled.current === true && !controlledValue) {
-      process.env.NODE_ENV !== "production" ? warning(false, 'A component is changing a controlled %s component to be uncontrolled. ' + 'This is likely caused by the value changing to an undefined value ' + 'from a defined one. Decide between using a controlled or ' + 'uncontrolled value for the lifetime of the component. ' + 'More info: https://reactjs.org/link/controlled-components', name) : void 0;
+      process.env.NODE_ENV !== "production" ? warning(false, `A component is changing a controlled ${name} component to be uncontrolled. ` + 'This is likely caused by the value changing to an undefined value ' + 'from a defined one. Decide between using a controlled or ' + 'uncontrolled value for the lifetime of the component. ' + 'More info: https://reactjs.org/link/controlled-components') : void 0;
     }
   }, [name, value]);
   if (controlled.current === true) {

package/es/internal/useEvent.js

@@ -7,7 +7,7 @@
 
 import { useRef, useEffect } from 'react';
 
-/* eslint-disable jsdoc/check-tag-names */
+// @ts-check
 
 /**
  * @template {keyof GlobalEventHandlersEventMap} E

package/es/internal/useMergedRefs.d.ts

@@ -1,13 +1,16 @@
 /**
- * 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 { Ref, ForwardedRef } from 'react';
+import { type ForwardedRef, type Ref } from 'react';
 /**
- * Combine multiple refs into a single ref. This use useful when you have two
- * refs from both `React.forwardRef` and `useRef` that you would like to add to
- * the same node.
+ * Merges multiple refs into a single callback ref.
+ *
+ * This hook is useful when you need to attach multiple refs (for example, a ref
+ * passed from `forwardRef` and a local ref from `useRef`) to the same node. It
+ * accepts an array of refs and returns a callback ref that, when attached to a
+ * node, assigns that node to every ref in the array.
  */
-export declare const useMergedRefs: <T extends unknown>(refs: ForwardedRef<T>[]) => Ref<T>;
+export declare const useMergedRefs: <T>(refs: ForwardedRef<T>[]) => Ref<T>;

package/es/internal/useMergedRefs.js

@@ -7,25 +7,24 @@
 
 import { useCallback } from 'react';
 
-// TODO: Investigate updating this hook based on the following code from
-// https://github.com/carbon-design-system/carbon/pull/18611:
-// https://github.com/adamalston/carbon/blob/dd403b6b10de3d8a6ccd8d2e21174c908c1e890a/packages/react/src/components/ListBox/ListBoxMenuItem.tsx#L23-L46
 /**
- * Combine multiple refs into a single ref. This use useful when you have two
- * refs from both `React.forwardRef` and `useRef` that you would like to add to
- * the same node.
+ * Merges multiple refs into a single callback ref.
+ *
+ * This hook is useful when you need to attach multiple refs (for example, a ref
+ * passed from `forwardRef` and a local ref from `useRef`) to the same node. It
+ * accepts an array of refs and returns a callback ref that, when attached to a
+ * node, assigns that node to every ref in the array.
  */
 const useMergedRefs = refs => {
   return useCallback(node => {
     refs.forEach(ref => {
       if (typeof ref === 'function') {
         ref(node);
-      } else if (ref !== null && ref !== undefined) {
+      } else if (ref) {
         ref.current = node;
       }
     });
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, refs);
+  }, [refs]);
 };
 
 export { useMergedRefs };

package/es/internal/useNoInteractiveChildren.js

@@ -9,7 +9,7 @@ import { useEffect } from 'react';
 
 function useNoInteractiveChildren(ref) {
   let message = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'component should have no interactive child nodes';
-  if (process.env.NODE_ENV !== "production") {
+  if (process.env.NODE_ENV !== 'production') {
     // eslint-disable-next-line react-hooks/rules-of-hooks
     useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
@@ -21,7 +21,7 @@ function useNoInteractiveChildren(ref) {
 }
 function useInteractiveChildrenNeedDescription(ref) {
   let message = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : `interactive child node(s) should have an \`aria-describedby\` property`;
-  if (process.env.NODE_ENV !== "production") {
+  if (process.env.NODE_ENV !== 'production') {
     // eslint-disable-next-line react-hooks/rules-of-hooks
     useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;

package/es/internal/useSavedCallback.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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.
+ */
+export declare const useSavedCallback: <T extends (...args: any[]) => any>(callback: T | undefined) => (...args: Parameters<T>) => ReturnType<T> | undefined;

package/es/internal/useSavedCallback.js

@@ -8,24 +8,21 @@
 import { useRef, useEffect, useCallback } from 'react';
 
 /**
- * Provide a stable reference for a callback that is passed as a prop to a
- * component. This is helpful when you want access to the latest version of a
- * callback prop but don't want it to be added to the dependency array of an
- * effect.
+ * 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 {Function | undefined} callback
- * @returns {Function}
+ * @param callback - The callback to track.
  */
-function useSavedCallback(callback) {
+const useSavedCallback = callback => {
   const savedCallback = useRef(callback);
   useEffect(() => {
     savedCallback.current = callback;
-  });
+  }, [callback]);
   return useCallback(function () {
-    if (savedCallback.current) {
-      return savedCallback.current(...arguments);
-    }
+    return savedCallback.current ? savedCallback.current(...arguments) : undefined;
   }, []);
-}
+};
 
 export { useSavedCallback };

package/es/internal/warning.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ */
+export declare const warning: (condition: boolean, message: string) => void;

package/es/internal/warning.js

@@ -5,21 +5,25 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-const emptyFunction = function () {};
-const warning = process.env.NODE_ENV !== "production" ? function warning(condition, format) {
-  for (var _len = arguments.length, args = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {
-    args[_key - 2] = arguments[_key];
-  }
-  if (format === undefined) {
-    throw new Error('`warning(condition, format, ...args)` requires a warning ' + 'format argument');
+import { noopFn } from './noopFn.js';
+
+/**
+ * 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) {
-    let index = 0;
-    const message = format.replace(/%s/g, () => {
-      return args[index++];
-    });
     console.warn('Warning: ' + message);
   }
-} : emptyFunction;
+} : noopFn;
 
 export { warning };

package/es/internal/wrapFocus.js

@@ -75,7 +75,7 @@ function wrapFocusWithoutSentinels(_ref2) {
     currentActiveNode,
     event
   } = _ref2;
-  if (['blur', 'focusout', 'focusin', 'focus'].includes(event.type) && process.env.NODE_ENV !== "production") {
+  if (['blur', 'focusout', 'focusin', 'focus'].includes(event.type) && process.env.NODE_ENV !== 'production') {
     // eslint-disable-next-line react-hooks/rules-of-hooks
     useEffect(() => {
       throw new Error(`Error: wrapFocusWithoutSentinels(...) called in unsupported ${event.type} event.\n\nCall wrapFocusWithoutSentinels(...) from onKeyDown instead.`);

package/es/prop-types/isRequiredOneOf.js

@@ -14,7 +14,7 @@
 function isRequiredOneOf(propTypes) {
   const names = Object.keys(propTypes);
   const checker = propType => function (props, propName, componentName) {
-    if (process.env.NODE_ENV !== "production" && names.every(name => typeof props[name] === 'undefined')) {
+    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++) {

package/es/prop-types/requiredIfGivenPropIsTruthy.js

@@ -14,7 +14,7 @@
  */
 function requiredIfGivenPropIsTruthy(name, propType) {
   return function check(props, propName, componentName) {
-    if (process.env.NODE_ENV !== "production" && props[name] == true && props[propName] == null) {
+    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++) {

package/es/tools/events.js

@@ -5,12 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-/**
- * 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.
- */
+// @ts-check
 
 /**
  * Generic utility to compose event handlers so that consumers can supply their

package/es/tools/toggleClass.js

@@ -5,6 +5,12 @@
  * LICENSE file in the root directory of this source tree.
  */
 
+/**
+ * Adds or removes a CSS class to an element.
+ * @param {Element} element An element.
+ * @param {string} name A CSS class name.
+ * @param {boolean} add `true` to add the given CSS class to given the element. Otherwise to remove.
+ */
 function toggleClass(element, name, add) {
   if (element.classList.contains(name) === !add) {
     element.classList[add ? 'add' : 'remove'](name);

package/es/types/common.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Copyright IBM Corp. 2023, 2024
+ *
+ * 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 * as React from 'react';
 export type ReactAttr<T = HTMLElement> = React.HTMLAttributes<T>;
 export type ForwardRefProps<T, P = unknown> = React.PropsWithoutRef<React.PropsWithChildren<P>> & React.RefAttributes<T>;

package/lib/components/CodeSnippet/CodeSnippet.js

@@ -13,7 +13,7 @@ var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelper
 var PropTypes = require('prop-types');
 var React = require('react');
 var cx = require('classnames');
-var useResizeObserver = require('use-resize-observer/polyfilled');
+var useResizeObserver = require('use-resize-observer');
 var iconsReact = require('@carbon/icons-react');
 var Copy = require('../Copy/Copy.js');
 var Button = require('../Button/Button.js');

package/lib/components/ComposedModal/ComposedModal.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Copyright IBM Corp. 2023, 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 MouseEvent, type KeyboardEvent, type HTMLAttributes, type ReactNode, type RefObject } from 'react';
 export interface ModalBodyProps extends HTMLAttributes<HTMLDivElement> {
     /** Specify the content to be placed in the ModalBody. */

package/lib/components/ComposedModal/ModalFooter.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Copyright IBM Corp. 2023, 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 ReactNode, type MouseEvent, type Ref } from 'react';
 import { InlineLoadingStatus } from '../InlineLoading/InlineLoading';
 export interface SecondaryButtonProps {

package/lib/components/ContainedList/index.js

@@ -14,7 +14,7 @@ var ContainedList = require('./ContainedList.js');
 var ContainedListItem = require('./ContainedListItem/ContainedListItem.js');
 
 ContainedList["default"].ContainedListItem = ContainedListItem["default"];
-if (process.env.NODE_ENV !== "production") {
+if (process.env.NODE_ENV !== 'production') {
   deprecateFieldOnObject.deprecateFieldOnObject(ContainedList["default"], 'ContainedListItem', ContainedListItem["default"]);
 }
 

package/lib/components/DataTable/DataTable.d.ts

@@ -201,10 +201,12 @@ export interface DataTableProps<RowType, ColTypes extends any[]> extends Transla
     render?: (renderProps: DataTableRenderProps<RowType, ColTypes>) => React.ReactElement;
     rows: Array<Omit<DataTableRow<ColTypes>, 'cells'>>;
     size?: DataTableSize;
-    sortRow?: (cellA: DataTableCell<any>, cellB: DataTableCell<any>, sortRowOptions: {
+    sortRow?: (cellA: any, cellB: any, sortRowOptions: {
         sortDirection: DataTableSortState;
         sortStates: Record<DataTableSortState, DataTableSortState>;
         locale: string;
+        key: string;
+        compare: (a: number | string, b: number | string, locale?: string) => number;
     }) => number;
     stickyHeader?: boolean;
     useStaticWidth?: boolean;

package/lib/components/DatePicker/DatePicker.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.

package/lib/components/DatePicker/DatePicker.js

@@ -369,7 +369,7 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
       nextArrow: rightArrowHTML,
       prevArrow: leftArrowHTML,
       onChange: function () {
-        if (savedOnChange && !readOnly) {
+        if (!readOnly) {
           savedOnChange(...arguments);
         }
       },