@carbon/react 1.79.0 → 1.80.0-rc.0

package/lib/components/TextInput/index.js

@@ -15,7 +15,7 @@ var PasswordInput = require('./PasswordInput.js');
 var TextInput = require('./TextInput.js');
 var TextInput_Skeleton = require('./TextInput.Skeleton.js');
 
-if (process.env.NODE_ENV !== "production") {
+if (process.env.NODE_ENV !== 'production') {
   deprecateFieldOnObject.deprecateFieldOnObject(TextInput["default"], 'ControlledPasswordInput', ControlledPasswordInput["default"]);
   deprecateFieldOnObject.deprecateFieldOnObject(TextInput["default"], 'PasswordInput', PasswordInput["default"]);
 }

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

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

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

@@ -60,13 +60,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.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) {

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>;

package/lib/internal/useMergedRefs.js

@@ -11,25 +11,24 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var React = require('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 React.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]);
 };
 
 exports.useMergedRefs = useMergedRefs;

package/lib/internal/useNoInteractiveChildren.js

@@ -13,7 +13,7 @@ var React = require('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
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;
@@ -25,7 +25,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
     React.useEffect(() => {
       const node = ref.current ? getInteractiveContent(ref.current) : false;

package/lib/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/lib/internal/useSavedCallback.js

@@ -12,24 +12,21 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var React = require('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 = React.useRef(callback);
   React.useEffect(() => {
     savedCallback.current = callback;
-  });
+  }, [callback]);
   return React.useCallback(function () {
-    if (savedCallback.current) {
-      return savedCallback.current(...arguments);
-    }
+    return savedCallback.current ? savedCallback.current(...arguments) : undefined;
   }, []);
-}
+};
 
 exports.useSavedCallback = useSavedCallback;

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