@carbon/react 1.77.0 → 1.78.0-rc.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$5 = require('./components/ClassPrefix/index.js');
+var index$6 = 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$6 = require('./components/ComboButton/index.js');
+var index$7 = 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$7 = require('./components/ContentSwitcher/index.js');
+var index$8 = 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');
@@ -66,14 +66,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$8 = require('./components/IdPrefix/index.js');
+var index$9 = 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$9 = require('./components/MenuButton/index.js');
+var index$a = 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,7 +81,7 @@ 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$a = require('./components/OverflowMenu/index.js');
+var index$b = require('./components/OverflowMenu/index.js');
 var OverflowMenuItem = require('./components/OverflowMenuItem/OverflowMenuItem.js');
 var Pagination$1 = require('./components/Pagination/Pagination.js');
 var Pagination_Skeleton = require('./components/Pagination/Pagination.Skeleton.js');
@@ -105,7 +105,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$b = require('./components/Slider/index.js');
+var index$c = 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 +131,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$c = require('./components/Toggletip/index.js');
+var index$d = 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');
@@ -186,14 +186,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$d = require('./components/Heading/index.js');
-var index$e = require('./components/IconButton/index.js');
-var index$f = require('./components/Layer/index.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$g = require('./components/Popover/index.js');
+var index$h = 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 ChatButton = require('./components/ChatButton/ChatButton.js');
 var ChatButton_Skeleton = require('./components/ChatButton/ChatButton.Skeleton.js');
 var AISkeletonPlaceholder = require('./components/AISkeleton/AISkeletonPlaceholder.js');
@@ -202,10 +204,9 @@ 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$h = require('./components/Theme/index.js');
+var index$i = require('./components/Theme/index.js');
 var usePrefix = require('./internal/usePrefix.js');
 var useIdPrefix = require('./internal/useIdPrefix.js');
-var index$4 = require('./components/IconIndicator/index.js');
 var PageSelector = require('./components/Pagination/experimental/PageSelector.js');
 var Pagination = require('./components/Pagination/experimental/Pagination.js');
 var ContainedListItem = require('./components/ContainedList/ContainedListItem/ContainedListItem.js');
@@ -262,16 +263,16 @@ exports.ButtonSet = ButtonSet["default"];
 exports.Checkbox = Checkbox["default"];
 exports.CheckboxSkeleton = Checkbox_Skeleton["default"];
 exports.CheckboxGroup = CheckboxGroup["default"];
-exports.ClassPrefix = index$5.ClassPrefix;
+exports.ClassPrefix = index$6.ClassPrefix;
 exports.CodeSnippet = CodeSnippet["default"];
 exports.CodeSnippetSkeleton = CodeSnippet_Skeleton["default"];
 exports.ComboBox = ComboBox["default"];
-exports.ComboButton = index$6.ComboButton;
+exports.ComboButton = index$7.ComboButton;
 exports.ComposedModal = ComposedModal["default"];
 exports.ModalBody = ComposedModal.ModalBody;
 exports.ModalHeader = ModalHeader.ModalHeader;
 exports.ModalFooter = ModalFooter.ModalFooter;
-exports.ContentSwitcher = index$7["default"];
+exports.ContentSwitcher = index$8["default"];
 exports.useContextMenu = useContextMenu["default"];
 exports.Copy = Copy["default"];
 exports.CopyButton = CopyButton["default"];
@@ -304,7 +305,7 @@ exports.Column = Column["default"];
 exports.ColumnHang = ColumnHang.ColumnHang;
 exports.GridSettings = GridContext.GridSettings;
 exports.IconSkeleton = Icon_Skeleton["default"];
-exports.IdPrefix = index$8.IdPrefix;
+exports.IdPrefix = index$9.IdPrefix;
 exports.InlineLoading = InlineLoading["default"];
 exports.Link = Link["default"];
 exports.ListItem = ListItem["default"];
@@ -315,7 +316,7 @@ exports.MenuItemDivider = MenuItem.MenuItemDivider;
 exports.MenuItemGroup = MenuItem.MenuItemGroup;
 exports.MenuItemRadioGroup = MenuItem.MenuItemRadioGroup;
 exports.MenuItemSelectable = MenuItem.MenuItemSelectable;
-exports.MenuButton = index$9.MenuButton;
+exports.MenuButton = index$a.MenuButton;
 exports.Modal = Modal["default"];
 exports.ModalWrapper = ModalWrapper["default"];
 exports.ActionableNotification = Notification.ActionableNotification;
@@ -328,7 +329,7 @@ exports.ToastNotification = Notification.ToastNotification;
 exports.NumberInputSkeleton = NumberInput_Skeleton["default"];
 exports.NumberInput = NumberInput.NumberInput;
 exports.OrderedList = OrderedList["default"];
-exports.OverflowMenu = index$a["default"];
+exports.OverflowMenu = index$b["default"];
 exports.OverflowMenuItem = OverflowMenuItem["default"];
 exports.Pagination = Pagination$1["default"];
 exports.PaginationSkeleton = Pagination_Skeleton["default"];
@@ -353,7 +354,7 @@ exports.SelectItemGroup = SelectItemGroup["default"];
 exports.SkeletonIcon = SkeletonIcon["default"];
 exports.SkeletonPlaceholder = SkeletonPlaceholder["default"];
 exports.SkeletonText = SkeletonText["default"];
-exports.Slider = index$b["default"];
+exports.Slider = index$c["default"];
 exports.HStack = HStack.HStack;
 exports.VStack = VStack.VStack;
 exports.Stack = Stack.Stack;
@@ -395,11 +396,11 @@ exports.TimePickerSelect = TimePickerSelect["default"];
 exports.Toggle = Toggle.Toggle;
 exports.ToggleSkeleton = Toggle_Skeleton["default"];
 exports.ToggleSmallSkeleton = ToggleSmall_Skeleton["default"];
-exports.Toggletip = index$c.Toggletip;
-exports.ToggletipActions = index$c.ToggletipActions;
-exports.ToggletipButton = index$c.ToggletipButton;
-exports.ToggletipContent = index$c.ToggletipContent;
-exports.ToggletipLabel = index$c.ToggletipLabel;
+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.TreeNode = TreeNode["default"];
 exports.TreeView = TreeView["default"];
 exports.Content = Content["default"];
@@ -455,16 +456,16 @@ 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$d.Heading;
-exports.Section = index$d.Section;
-exports.IconButton = index$e.IconButton;
-exports.IconButtonKinds = index$e.IconButtonKinds;
-exports.Layer = index$f.Layer;
-exports.useLayer = index$f.useLayer;
+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$g.Popover;
-exports.PopoverContent = index$g.PopoverContent;
+exports.Popover = index$h.Popover;
+exports.PopoverContent = index$h.PopoverContent;
 exports.ProgressBar = ProgressBar["default"];
 exports.AILabel = index$3.AILabel;
 exports.AILabelActions = index$3.AILabelActions;
@@ -472,6 +473,8 @@ 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.unstable__ChatButton = ChatButton["default"];
 exports.unstable__ChatButtonSkeleton = ChatButton_Skeleton["default"];
 exports.AISkeletonPlaceholder = AISkeletonPlaceholder["default"];
@@ -482,15 +485,14 @@ exports.AISkeletonText = AISkeletonText["default"];
 exports.unstable__AiSkeletonText = AISkeletonText["default"];
 exports.DefinitionTooltip = DefinitionTooltip.DefinitionTooltip;
 exports.Tooltip = Tooltip.Tooltip;
-exports.GlobalTheme = index$h.GlobalTheme;
-exports.Theme = index$h.Theme;
-exports.ThemeContext = index$h.ThemeContext;
-exports.usePrefersDarkScheme = index$h.usePrefersDarkScheme;
-exports.useTheme = index$h.useTheme;
+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.PrefixContext = usePrefix.PrefixContext;
 exports.usePrefix = usePrefix.usePrefix;
 exports.useIdPrefix = useIdPrefix.useIdPrefix;
-exports.unstable__IconIndicator = index$4.IconIndicator;
 exports.unstable_PageSelector = PageSelector["default"];
 exports.unstable_Pagination = Pagination["default"];
 exports.ContainedListItem = ContainedListItem["default"];

package/lib/internal/FloatingMenu.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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 { type CSSProperties, type ReactElement, type RefObject } from 'react';
+export declare const DIRECTION_LEFT = "left";
+export declare const DIRECTION_TOP = "top";
+export declare const DIRECTION_RIGHT = "right";
+export declare const DIRECTION_BOTTOM = "bottom";
+export interface Offset {
+    top?: number;
+    left?: number;
+}
+interface Container {
+    rect: DOMRect;
+    position: string;
+}
+export type MenuDirection = typeof DIRECTION_LEFT | typeof DIRECTION_TOP | typeof DIRECTION_RIGHT | typeof DIRECTION_BOTTOM;
+export type MenuOffset = Offset | ((menuBody: HTMLElement, menuDirection: MenuDirection, triggerEl?: HTMLElement | null, flipped?: boolean) => Offset);
+interface FloatingMenuProps {
+    /**
+     * Contents of the floating menu.
+     */
+    children: ReactElement;
+    /**
+     * Whether the menu alignment should be flipped.
+     */
+    flipped?: boolean;
+    /**
+     * Enable or disable focus trap behavior.
+     */
+    focusTrap?: boolean;
+    /**
+     * Where to put the menu relative to the trigger.
+     */
+    menuDirection?: MenuDirection;
+    /**
+     * The adjustment of the floating menu's position.
+     */
+    menuOffset?: MenuOffset;
+    /**
+     * Callback when the menu body is mounted/unmounted.
+     */
+    menuRef?: (menuBody: HTMLElement | null) => void;
+    /**
+     * Callback when the menu body has been placed.
+     */
+    onPlace?: (menuBody: HTMLElement) => void;
+    /**
+     * CSS selector for the element to focus when the menu opens.
+     */
+    selectorPrimaryFocus?: string;
+    /**
+     * Additional styles to apply to the menu.
+     */
+    styles?: CSSProperties;
+    /**
+     * Function returning the element where the floating menu is rendered.
+     * @default () => document.body
+     */
+    target?: () => Element;
+    /**
+     * The `ref` of the tooltip’s trigger element. It is assumed to be a
+     * `RefObject` pointing to an `HTMLElement`.
+     */
+    triggerRef: RefObject<HTMLElement>;
+    /**
+     * Optional function to adjust orientation
+     */
+    updateOrientation?: (params: {
+        menuSize: DOMRect;
+        refPosition: DOMRect | undefined;
+        direction: string;
+        offset: Offset;
+        scrollX: number;
+        scrollY: number;
+        container: Container;
+    }) => void;
+}
+export declare const FloatingMenu: ({ children, flipped, focusTrap, menuDirection, menuOffset, menuRef: externalMenuRef, onPlace, selectorPrimaryFocus, styles, target, triggerRef, updateOrientation, }: FloatingMenuProps) => any;
+export {};