@carbon/react 1.79.0 → 1.80.0

package/lib/index.js

@@ -23,16 +23,16 @@ var ButtonSet = require('./components/ButtonSet/ButtonSet.js');
 var Checkbox = require('./components/Checkbox/Checkbox.js');
 var Checkbox_Skeleton = require('./components/Checkbox/Checkbox.Skeleton.js');
 var CheckboxGroup = require('./components/CheckboxGroup/CheckboxGroup.js');
-var index$6 = require('./components/ClassPrefix/index.js');
+var index$7 = require('./components/ClassPrefix/index.js');
 var CodeSnippet = require('./components/CodeSnippet/CodeSnippet.js');
 var CodeSnippet_Skeleton = require('./components/CodeSnippet/CodeSnippet.Skeleton.js');
 var ComboBox = require('./components/ComboBox/ComboBox.js');
-var index$7 = require('./components/ComboButton/index.js');
+var index$8 = require('./components/ComboButton/index.js');
 var ComposedModal = require('./components/ComposedModal/ComposedModal.js');
 var ModalHeader = require('./components/ComposedModal/ModalHeader.js');
 var ModalFooter = require('./components/ComposedModal/ModalFooter.js');
 require('./components/ContainedList/index.js');
-var index$8 = require('./components/ContentSwitcher/index.js');
+var index$9 = require('./components/ContentSwitcher/index.js');
 var useContextMenu = require('./components/ContextMenu/useContextMenu.js');
 var Copy = require('./components/Copy/Copy.js');
 var CopyButton = require('./components/CopyButton/CopyButton.js');
@@ -47,6 +47,7 @@ var Dropdown_Skeleton = require('./components/Dropdown/Dropdown.Skeleton.js');
 var ErrorBoundary = require('./components/ErrorBoundary/ErrorBoundary.js');
 var ErrorBoundaryContext = require('./components/ErrorBoundary/ErrorBoundaryContext.js');
 var ExpandableSearch = require('./components/ExpandableSearch/ExpandableSearch.js');
+var index$1 = require('./components/FeatureFlags/index.js');
 var FileUploader = require('./components/FileUploader/FileUploader.js');
 var Filename = require('./components/FileUploader/Filename.js');
 var FileUploader_Skeleton = require('./components/FileUploader/FileUploader.Skeleton.js');
@@ -66,14 +67,14 @@ var Column = require('./components/Grid/Column.js');
 var ColumnHang = require('./components/Grid/ColumnHang.js');
 var GridContext = require('./components/Grid/GridContext.js');
 var Icon_Skeleton = require('./components/Icon/Icon.Skeleton.js');
-var index$9 = require('./components/IdPrefix/index.js');
+var index$a = require('./components/IdPrefix/index.js');
 var InlineLoading = require('./components/InlineLoading/InlineLoading.js');
 var Link = require('./components/Link/Link.js');
 var ListItem = require('./components/ListItem/ListItem.js');
 var Loading = require('./components/Loading/Loading.js');
 var Menu = require('./components/Menu/Menu.js');
 var MenuItem = require('./components/Menu/MenuItem.js');
-var index$a = require('./components/MenuButton/index.js');
+var index$b = require('./components/MenuButton/index.js');
 var Modal = require('./components/Modal/Modal.js');
 var ModalWrapper = require('./components/ModalWrapper/ModalWrapper.js');
 require('./components/MultiSelect/index.js');
@@ -81,8 +82,9 @@ var Notification = require('./components/Notification/Notification.js');
 var NumberInput_Skeleton = require('./components/NumberInput/NumberInput.Skeleton.js');
 var NumberInput = require('./components/NumberInput/NumberInput.js');
 var OrderedList = require('./components/OrderedList/OrderedList.js');
-var index$b = require('./components/OverflowMenu/index.js');
+var index$c = require('./components/OverflowMenu/index.js');
 var OverflowMenuItem = require('./components/OverflowMenuItem/OverflowMenuItem.js');
+var index = require('./components/PageHeader/index.js');
 var Pagination$1 = require('./components/Pagination/Pagination.js');
 var Pagination_Skeleton = require('./components/Pagination/Pagination.Skeleton.js');
 var PaginationNav = require('./components/PaginationNav/PaginationNav.js');
@@ -105,7 +107,7 @@ var SelectItemGroup = require('./components/SelectItemGroup/SelectItemGroup.js')
 var SkeletonIcon = require('./components/SkeletonIcon/SkeletonIcon.js');
 var SkeletonPlaceholder = require('./components/SkeletonPlaceholder/SkeletonPlaceholder.js');
 var SkeletonText = require('./components/SkeletonText/SkeletonText.js');
-var index$c = require('./components/Slider/index.js');
+var index$d = require('./components/Slider/index.js');
 var HStack = require('./components/Stack/HStack.js');
 var VStack = require('./components/Stack/VStack.js');
 var Stack = require('./components/Stack/Stack.js');
@@ -131,7 +133,7 @@ var TimePickerSelect = require('./components/TimePickerSelect/TimePickerSelect.j
 var Toggle = require('./components/Toggle/Toggle.js');
 var Toggle_Skeleton = require('./components/Toggle/Toggle.Skeleton.js');
 var ToggleSmall_Skeleton = require('./components/ToggleSmall/ToggleSmall.Skeleton.js');
-var index$d = require('./components/Toggletip/index.js');
+var index$e = require('./components/Toggletip/index.js');
 var TreeNode = require('./components/TreeView/TreeNode.js');
 var TreeView = require('./components/TreeView/TreeView.js');
 var Content = require('./components/UIShell/Content.js');
@@ -164,7 +166,6 @@ var SideNavMenu = require('./components/UIShell/SideNavMenu.js');
 var SideNavMenuItem = require('./components/UIShell/SideNavMenuItem.js');
 var SideNavSwitcher = require('./components/UIShell/SideNavSwitcher.js');
 var UnorderedList = require('./components/UnorderedList/UnorderedList.js');
-var index = require('./components/FeatureFlags/index.js');
 var FluidComboBox = require('./components/FluidComboBox/FluidComboBox.js');
 var FluidComboBox_Skeleton = require('./components/FluidComboBox/FluidComboBox.Skeleton.js');
 var FluidDatePicker = require('./components/FluidDatePicker/FluidDatePicker.js');
@@ -186,16 +187,16 @@ var FluidTextInput_Skeleton = require('./components/FluidTextInput/FluidTextInpu
 var FluidTimePicker = require('./components/FluidTimePicker/FluidTimePicker.js');
 var FluidTimePicker_Skeleton = require('./components/FluidTimePicker/FluidTimePicker.Skeleton.js');
 var FluidTimePickerSelect = require('./components/FluidTimePickerSelect/FluidTimePickerSelect.js');
-var index$e = require('./components/Heading/index.js');
-var index$f = require('./components/IconButton/index.js');
-var index$g = require('./components/Layer/index.js');
-var index$1 = require('./components/Layout/index.js');
-var index$2 = require('./components/OverflowMenuV2/index.js');
-var index$h = require('./components/Popover/index.js');
+var index$f = require('./components/Heading/index.js');
+var index$g = require('./components/IconButton/index.js');
+var index$h = require('./components/Layer/index.js');
+var index$2 = require('./components/Layout/index.js');
+var index$3 = require('./components/OverflowMenuV2/index.js');
+var index$i = require('./components/Popover/index.js');
 var ProgressBar = require('./components/ProgressBar/ProgressBar.js');
-var index$3 = require('./components/AILabel/index.js');
-var index$4 = require('./components/IconIndicator/index.js');
-var index$5 = require('./components/ShapeIndicator/index.js');
+var index$4 = require('./components/AILabel/index.js');
+var index$5 = require('./components/IconIndicator/index.js');
+var index$6 = require('./components/ShapeIndicator/index.js');
 var ChatButton = require('./components/ChatButton/ChatButton.js');
 var ChatButton_Skeleton = require('./components/ChatButton/ChatButton.Skeleton.js');
 var AISkeletonPlaceholder = require('./components/AISkeleton/AISkeletonPlaceholder.js');
@@ -204,7 +205,7 @@ var AISkeletonText = require('./components/AISkeleton/AISkeletonText.js');
 var DefinitionTooltip = require('./components/Tooltip/DefinitionTooltip.js');
 var Tooltip = require('./components/Tooltip/Tooltip.js');
 require('./components/Text/index.js');
-var index$i = require('./components/Theme/index.js');
+var index$j = require('./components/Theme/index.js');
 var usePrefix = require('./internal/usePrefix.js');
 var useIdPrefix = require('./internal/useIdPrefix.js');
 var PageSelector = require('./components/Pagination/experimental/PageSelector.js');
@@ -263,16 +264,16 @@ exports.ButtonSet = ButtonSet["default"];
 exports.Checkbox = Checkbox["default"];
 exports.CheckboxSkeleton = Checkbox_Skeleton["default"];
 exports.CheckboxGroup = CheckboxGroup["default"];
-exports.ClassPrefix = index$6.ClassPrefix;
+exports.ClassPrefix = index$7.ClassPrefix;
 exports.CodeSnippet = CodeSnippet["default"];
 exports.CodeSnippetSkeleton = CodeSnippet_Skeleton["default"];
 exports.ComboBox = ComboBox["default"];
-exports.ComboButton = index$7.ComboButton;
+exports.ComboButton = index$8.ComboButton;
 exports.ComposedModal = ComposedModal["default"];
 exports.ModalBody = ComposedModal.ModalBody;
 exports.ModalHeader = ModalHeader.ModalHeader;
 exports.ModalFooter = ModalFooter.ModalFooter;
-exports.ContentSwitcher = index$8["default"];
+exports.ContentSwitcher = index$9["default"];
 exports.useContextMenu = useContextMenu["default"];
 exports.Copy = Copy["default"];
 exports.CopyButton = CopyButton["default"];
@@ -286,6 +287,12 @@ exports.DropdownSkeleton = Dropdown_Skeleton["default"];
 exports.ErrorBoundary = ErrorBoundary["default"];
 exports.ErrorBoundaryContext = ErrorBoundaryContext.ErrorBoundaryContext;
 exports.ExpandableSearch = ExpandableSearch["default"];
+exports.FeatureFlags = index$1.FeatureFlags;
+exports.unstable_FeatureFlags = index$1.FeatureFlags;
+exports.unstable_useFeatureFlag = index$1.useFeatureFlag;
+exports.unstable_useFeatureFlags = index$1.useFeatureFlags;
+exports.useFeatureFlag = index$1.useFeatureFlag;
+exports.useFeatureFlags = index$1.useFeatureFlags;
 exports.FileUploader = FileUploader["default"];
 exports.Filename = Filename["default"];
 exports.FileUploaderSkeleton = FileUploader_Skeleton["default"];
@@ -305,7 +312,7 @@ exports.Column = Column["default"];
 exports.ColumnHang = ColumnHang.ColumnHang;
 exports.GridSettings = GridContext.GridSettings;
 exports.IconSkeleton = Icon_Skeleton["default"];
-exports.IdPrefix = index$9.IdPrefix;
+exports.IdPrefix = index$a.IdPrefix;
 exports.InlineLoading = InlineLoading["default"];
 exports.Link = Link["default"];
 exports.ListItem = ListItem["default"];
@@ -316,7 +323,7 @@ exports.MenuItemDivider = MenuItem.MenuItemDivider;
 exports.MenuItemGroup = MenuItem.MenuItemGroup;
 exports.MenuItemRadioGroup = MenuItem.MenuItemRadioGroup;
 exports.MenuItemSelectable = MenuItem.MenuItemSelectable;
-exports.MenuButton = index$a.MenuButton;
+exports.MenuButton = index$b.MenuButton;
 exports.Modal = Modal["default"];
 exports.ModalWrapper = ModalWrapper["default"];
 exports.ActionableNotification = Notification.ActionableNotification;
@@ -329,8 +336,9 @@ exports.ToastNotification = Notification.ToastNotification;
 exports.NumberInputSkeleton = NumberInput_Skeleton["default"];
 exports.NumberInput = NumberInput.NumberInput;
 exports.OrderedList = OrderedList["default"];
-exports.OverflowMenu = index$b["default"];
+exports.OverflowMenu = index$c["default"];
 exports.OverflowMenuItem = OverflowMenuItem["default"];
+exports.unstable__PageHeader = index;
 exports.Pagination = Pagination$1["default"];
 exports.PaginationSkeleton = Pagination_Skeleton["default"];
 exports.PaginationNav = PaginationNav["default"];
@@ -354,7 +362,7 @@ exports.SelectItemGroup = SelectItemGroup["default"];
 exports.SkeletonIcon = SkeletonIcon["default"];
 exports.SkeletonPlaceholder = SkeletonPlaceholder["default"];
 exports.SkeletonText = SkeletonText["default"];
-exports.Slider = index$c["default"];
+exports.Slider = index$d["default"];
 exports.HStack = HStack.HStack;
 exports.VStack = VStack.VStack;
 exports.Stack = Stack.Stack;
@@ -396,11 +404,11 @@ exports.TimePickerSelect = TimePickerSelect["default"];
 exports.Toggle = Toggle.Toggle;
 exports.ToggleSkeleton = Toggle_Skeleton["default"];
 exports.ToggleSmallSkeleton = ToggleSmall_Skeleton["default"];
-exports.Toggletip = index$d.Toggletip;
-exports.ToggletipActions = index$d.ToggletipActions;
-exports.ToggletipButton = index$d.ToggletipButton;
-exports.ToggletipContent = index$d.ToggletipContent;
-exports.ToggletipLabel = index$d.ToggletipLabel;
+exports.Toggletip = index$e.Toggletip;
+exports.ToggletipActions = index$e.ToggletipActions;
+exports.ToggletipButton = index$e.ToggletipButton;
+exports.ToggletipContent = index$e.ToggletipContent;
+exports.ToggletipLabel = index$e.ToggletipLabel;
 exports.TreeNode = TreeNode["default"];
 exports.TreeView = TreeView["default"];
 exports.Content = Content["default"];
@@ -433,9 +441,6 @@ exports.SideNavMenu = SideNavMenu["default"];
 exports.SideNavMenuItem = SideNavMenuItem["default"];
 exports.SideNavSwitcher = SideNavSwitcher["default"];
 exports.UnorderedList = UnorderedList["default"];
-exports.unstable_FeatureFlags = index.FeatureFlags;
-exports.unstable_useFeatureFlag = index.useFeatureFlag;
-exports.unstable_useFeatureFlags = index.useFeatureFlags;
 exports.unstable__FluidComboBox = FluidComboBox["default"];
 exports.unstable__FluidComboBoxSkeleton = FluidComboBox_Skeleton["default"];
 exports.unstable__FluidDatePicker = FluidDatePicker["default"];
@@ -456,25 +461,25 @@ exports.unstable__FluidTextInputSkeleton = FluidTextInput_Skeleton["default"];
 exports.unstable__FluidTimePicker = FluidTimePicker["default"];
 exports.unstable__FluidTimePickerSkeleton = FluidTimePicker_Skeleton["default"];
 exports.unstable__FluidTimePickerSelect = FluidTimePickerSelect["default"];
-exports.Heading = index$e.Heading;
-exports.Section = index$e.Section;
-exports.IconButton = index$f.IconButton;
-exports.IconButtonKinds = index$f.IconButtonKinds;
-exports.Layer = index$g.Layer;
-exports.useLayer = index$g.useLayer;
-exports.unstable_Layout = index$1.Layout;
-exports.unstable_OverflowMenuV2 = index$2.OverflowMenuV2;
-exports.Popover = index$h.Popover;
-exports.PopoverContent = index$h.PopoverContent;
+exports.Heading = index$f.Heading;
+exports.Section = index$f.Section;
+exports.IconButton = index$g.IconButton;
+exports.IconButtonKinds = index$g.IconButtonKinds;
+exports.Layer = index$h.Layer;
+exports.useLayer = index$h.useLayer;
+exports.unstable_Layout = index$2.Layout;
+exports.unstable_OverflowMenuV2 = index$3.OverflowMenuV2;
+exports.Popover = index$i.Popover;
+exports.PopoverContent = index$i.PopoverContent;
 exports.ProgressBar = ProgressBar["default"];
-exports.AILabel = index$3.AILabel;
-exports.AILabelActions = index$3.AILabelActions;
-exports.AILabelContent = index$3.AILabelContent;
-exports.unstable__Slug = index$3.AILabel;
-exports.unstable__SlugActions = index$3.AILabelActions;
-exports.unstable__SlugContent = index$3.AILabelContent;
-exports.unstable__IconIndicator = index$4.IconIndicator;
-exports.unstable__ShapeIndicator = index$5.ShapeIndicator;
+exports.AILabel = index$4.AILabel;
+exports.AILabelActions = index$4.AILabelActions;
+exports.AILabelContent = index$4.AILabelContent;
+exports.unstable__Slug = index$4.AILabel;
+exports.unstable__SlugActions = index$4.AILabelActions;
+exports.unstable__SlugContent = index$4.AILabelContent;
+exports.unstable__IconIndicator = index$5.IconIndicator;
+exports.unstable__ShapeIndicator = index$6.ShapeIndicator;
 exports.unstable__ChatButton = ChatButton["default"];
 exports.unstable__ChatButtonSkeleton = ChatButton_Skeleton["default"];
 exports.AISkeletonPlaceholder = AISkeletonPlaceholder["default"];
@@ -485,11 +490,11 @@ exports.AISkeletonText = AISkeletonText["default"];
 exports.unstable__AiSkeletonText = AISkeletonText["default"];
 exports.DefinitionTooltip = DefinitionTooltip.DefinitionTooltip;
 exports.Tooltip = Tooltip.Tooltip;
-exports.GlobalTheme = index$i.GlobalTheme;
-exports.Theme = index$i.Theme;
-exports.ThemeContext = index$i.ThemeContext;
-exports.usePrefersDarkScheme = index$i.usePrefersDarkScheme;
-exports.useTheme = index$i.useTheme;
+exports.GlobalTheme = index$j.GlobalTheme;
+exports.Theme = index$j.Theme;
+exports.ThemeContext = index$j.ThemeContext;
+exports.usePrefersDarkScheme = index$j.usePrefersDarkScheme;
+exports.useTheme = index$j.useTheme;
 exports.PrefixContext = usePrefix.PrefixContext;
 exports.usePrefix = usePrefix.usePrefix;
 exports.useIdPrefix = useIdPrefix.useIdPrefix;

package/lib/internal/ClickListener.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 React, { type ReactElement } from 'react';
+interface ClickListenerProps {
+    children: ReactElement;
+    onClickOutside: (event: MouseEvent) => void;
+}
+export declare const ClickListener: ({ children, onClickOutside, }: ClickListenerProps) => React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+export {};

package/lib/internal/ClickListener.js

@@ -9,75 +9,43 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
-var PropTypes = require('prop-types');
 var React = require('react');
 
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
-var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
-
-/**
- * Generic component used for reacting to a click event happening outside of a
- * given `children` element.
- */
-class ClickListener extends React__default["default"].Component {
-  static getEventTarget(evt) {
-    // support Shadow DOM
-    if (evt.composed && typeof evt.composedPath === 'function') {
-      return evt.composedPath()[0];
+const ClickListener = _ref => {
+  let {
+    children,
+    onClickOutside
+  } = _ref;
+  const elementRef = React.useRef(null);
+  const getEventTarget = event => {
+    if (event.composed && typeof event.composedPath === 'function') {
+      return event.composedPath()[0];
     }
-    return evt.target;
-  }
-  constructor(props) {
-    super(props);
-    // We manually bind handlers in this Component, versus using class
-    // properties, so that we can properly test the `handleRef` handler.
-    this.handleRef = this.handleRef.bind(this);
-    this.handleDocumentClick = this.handleDocumentClick.bind(this);
-  }
-  componentDidMount() {
-    document.addEventListener('click', this.handleDocumentClick);
-  }
-  componentWillUnmount() {
-    document.removeEventListener('click', this.handleDocumentClick);
-  }
-  handleDocumentClick(evt) {
-    if (this.element) {
-      if (this.element.contains && !this.element.contains(ClickListener.getEventTarget(evt))) {
-        this.props.onClickOutside(evt);
+    return event.target;
+  };
+  const handleDocumentClick = event => {
+    if (elementRef.current?.contains) {
+      const eventTarget = getEventTarget(event);
+      if (eventTarget instanceof Node && !elementRef.current.contains(eventTarget)) {
+        onClickOutside(event);
       }
     }
-  }
-  handleRef(el) {
-    const {
-      children
-    } = this.props;
-    this.element = el;
-
-    /**
-     * One important note, `children.ref` corresponds to a `ref` prop passed in
-     * directly to the child, not necessarily a `ref` defined in the component.
-     * This means that here we target the following `ref` location:
-     *
-     * <ClickListener onClickOutside={() => {}}>
-     *   <Child ref={targetedRefHere} />
-     * </ClickListener>
-     */
-    if (children.ref && typeof children.ref === 'function') {
+  };
+  React.useEffect(() => {
+    document.addEventListener('click', handleDocumentClick);
+    return () => {
+      document.removeEventListener('click', handleDocumentClick);
+    };
+  }, [onClickOutside]);
+  const handleRef = el => {
+    elementRef.current = el;
+    if ('ref' in children && typeof children.ref === 'function') {
       children.ref(el);
     }
-  }
-  render() {
-    return /*#__PURE__*/React__default["default"].cloneElement(this.props.children, {
-      ref: this.handleRef
-    });
-  }
-}
-_rollupPluginBabelHelpers.defineProperty(ClickListener, "propTypes", {
-  children: PropTypes__default["default"].element.isRequired,
-  onClickOutside: PropTypes__default["default"].func.isRequired
-});
+  };
+  return /*#__PURE__*/React.cloneElement(children, {
+    ref: handleRef
+  });
+};
 
-exports["default"] = ClickListener;
+exports.ClickListener = ClickListener;

package/lib/internal/FloatingMenu.js

@@ -133,7 +133,7 @@ const FloatingMenu = _ref2 => {
   const updateMenuPosition = React.useCallback(isAdjustment => {
     const menuBody = menuBodyRef.current;
     if (!menuBody) {
-      process.env.NODE_ENV !== "production" ? warning.warning(menuBody, 'The DOM node for menu body for calculating its position is not available. Skipping...') : void 0;
+      process.env.NODE_ENV !== "production" ? warning.warning(!!menuBody, 'The DOM node for menu body for calculating its position is not available. Skipping...') : void 0;
       return;
     }
     const triggerEl = triggerRef.current;
@@ -203,7 +203,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.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/lib/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/lib/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/lib/internal/deprecateFieldOnObject.js

@@ -11,11 +11,11 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var warning = require('./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.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;
@@ -23,6 +23,6 @@ function deprecateFieldOnObject(object, field, Component, message) {
       return Component;
     }
   });
-}
+};
 
 exports.deprecateFieldOnObject = deprecateFieldOnObject;

package/lib/internal/useControllableState.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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.
+ */
+interface UseControllableStateConfig<T> {
+    /** The name of the component. */
+    name?: string;
+    /**
+     * The default value for the component. This value is used when the component
+     * is uncontrolled (i.e., when `value` is not provided).
+     */
+    defaultValue: T;
+    /**
+     * This callback is called whenever the state changes. It's useful for
+     * communicating state updates to parent components of controlled components.
+     */
+    onChange?: (value: T) => void;
+    /**
+     * Controlled value. If this prop is omitted, the state will be uncontrolled.
+     */
+    value?: T;
+}
+/**
+ * This hook simplifies the behavior of a component that has state which can be
+ * both controlled and uncontrolled. It works like `useState`. You can use the
+ * `onChange` callback to communicate state updates to parent components.
+ *
+ * Note: This hook will warn if the component switches between controlled and
+ * uncontrolled states.
+ */
+export declare const useControllableState: <T>({ defaultValue, name, onChange, value, }: UseControllableStateConfig<T>) => [T, (stateOrUpdater: T | ((prev: T) => T)) => void];
+export {};

package/lib/internal/useControllableState.js

@@ -13,66 +13,51 @@ var React = require('react');
 var warning = require('./warning.js');
 
 /**
- * This custom hook simplifies the behavior of a component if it has state that
- * can be both controlled and uncontrolled. It functions identical to a
- * useState() hook and provides [state, setState] for you to use. You can use
- * the `onChange` argument to allow updates to the `state` to be communicated to
- * owners of controlled components.
+ * This hook simplifies the behavior of a component that has state which can be
+ * both controlled and uncontrolled. It works like `useState`. You can use the
+ * `onChange` callback to communicate state updates to parent components.
  *
- * Note: this hook will warn if a component is switching from controlled to
- * uncontrolled, or vice-versa.
- *
- * @param {object} config
- * @param {string} [config.name] - the name of the custom component
- * @param {any} config.defaultValue - the default value used for the state. This will be
- * the fallback value used if `value` is not defined.
- * @param {Function|undefined} config.onChange - an optional function that is called when
- * the value of the state changes. This is useful for communicating to parents of
- * controlled components that the value is requesting to be changed.
- * @param {any} config.value - a controlled value. Omitting this means that the state is
- * uncontrolled
- * @returns {[any, (v: any) => void]}
+ * Note: This hook will warn if the component switches between controlled and
+ * uncontrolled states.
  */
-function useControllableState(_ref) {
+const useControllableState = _ref => {
   let {
     defaultValue,
     name = 'custom',
     onChange,
     value
   } = _ref;
-  const [state, internalSetState] = React.useState(value ?? defaultValue);
+  const [state, internalSetState] = React.useState(typeof value !== 'undefined' ? value : defaultValue);
   const controlled = React.useRef(null);
   if (controlled.current === null) {
-    controlled.current = value !== undefined;
+    controlled.current = typeof value !== 'undefined';
   }
-  function setState(stateOrUpdater) {
-    const value = typeof stateOrUpdater === 'function' ? stateOrUpdater(state) : stateOrUpdater;
+  const setState = stateOrUpdater => {
+    const newValue = typeof stateOrUpdater === 'function' ? stateOrUpdater(state) : stateOrUpdater;
     if (controlled.current === false) {
-      internalSetState(value);
+      internalSetState(newValue);
     }
     if (onChange) {
-      onChange(value);
+      onChange(newValue);
     }
-  }
+  };
   React.useEffect(() => {
-    const controlledValue = value !== undefined;
+    const controlledValue = typeof value !== 'undefined';
 
     // 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.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.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.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.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) {
     return [value, setState];
   }
   return [state, setState];
-}
+};
 
 exports.useControllableState = useControllableState;

package/lib/internal/useEvent.js

@@ -11,7 +11,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var React = require('react');
 
-/* eslint-disable jsdoc/check-tag-names */
+// @ts-check
 
 /**
  * @template {keyof GlobalEventHandlersEventMap} E

package/lib/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>;