@carbon/react 1.24.0-rc.0 → 1.25.0

package/lib/components/Toggle/Toggle.js

@@ -74,8 +74,8 @@ function Toggle(_ref) {
 
   var isSm = size === 'sm';
   var sideLabel = hideLabel ? labelText : checked ? labelB : labelA;
-  var renderSideLabel = !(hideLabel && ariaLabelledby);
-  var LabelComponent = ariaLabelledby ? 'div' : 'label';
+  var renderSideLabel = !(hideLabel && !labelText);
+  var LabelComponent = labelText ? 'label' : 'div';
   var wrapperClasses = cx__default["default"]("".concat(prefix, "--toggle"), (_classNames = {}, _rollupPluginBabelHelpers.defineProperty(_classNames, "".concat(prefix, "--toggle--disabled"), disabled), _rollupPluginBabelHelpers.defineProperty(_classNames, "".concat(prefix, "--toggle--readonly"), readOnly), _classNames), className);
   var labelTextClasses = cx__default["default"]("".concat(prefix, "--toggle__label-text"), _rollupPluginBabelHelpers.defineProperty({}, "".concat(prefix, "--visually-hidden"), hideLabel));
   var appearanceClasses = cx__default["default"]("".concat(prefix, "--toggle__appearance"), _rollupPluginBabelHelpers.defineProperty({}, "".concat(prefix, "--toggle__appearance--sm"), isSm));
@@ -85,7 +85,7 @@ function Toggle(_ref) {
     // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions
     React__default["default"].createElement("div", {
       className: wrapperClasses,
-      onClick: ariaLabelledby ? function (e) {
+      onClick: !labelText ? function (e) {
         // the underlying <button> can only be activated by keyboard as it is visually hidden;
         // therefore, if this event's target is the <button>, it had to be triggered by
         // the keyboard event which already calls handleClick. if we wouldn't catch this, the
@@ -151,10 +151,7 @@ Toggle.propTypes = {
 
   /**
    * If true, the side labels (props.labelA and props.labelB) will be replaced by
-   * props.labelText, so that the toggle doesn't render a top label. In order to fully
-   * hide any labels, you can use props['aria-labelledby'] to refer to another element
-   * that labels the toggle. props.labelText would no longer be required in that case
-   * and can therefore be omitted.
+   * props.labelText (if passed), so that the toggle doesn't render a top label.
    */
   hideLabel: PropTypes__default["default"].bool,
 
@@ -175,19 +172,11 @@ Toggle.propTypes = {
 
   /**
    * Provide the text that will be read by a screen reader when visiting this
-   * control. This is required unless 'aria-labelledby' is provided instead
+   * control. This should be provided unless 'aria-labelledby' is set instead
+   * or you use an external <label> element with its "for" attribute set to the
+   * toggle's id.
    */
-  labelText: function labelText(props) {
-    if (!props['aria-labelledby'] && !props.labelText) {
-      return new Error('labelText property is required if no aria-labelledby is provided.');
-    }
-
-    for (var _len = arguments.length, rest = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
-      rest[_key - 1] = arguments[_key];
-    }
-
-    return PropTypes__default["default"].node.apply(PropTypes__default["default"], [props].concat(rest));
-  },
+  labelText: PropTypes__default["default"].string,
 
   /**
    * Provide an event listener that is called when the control is clicked

package/lib/components/Tooltip/DefinitionTooltip.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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.
+ */
+import React from 'react';
+import { PopoverAlignment } from '../Popover';
+export interface DefinitionTooltipProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'id' | 'classname' | 'children' | 'type'> {
+    /**
+     * Specify how the trigger should align with the tooltip
+     */
+    align?: PopoverAlignment;
+    /**
+     * The `children` prop will be used as the value that is being defined
+     */
+    children?: React.ReactNode;
+    /**
+     * Specify an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * Specify whether the tooltip should be open when it first renders
+     */
+    defaultOpen?: boolean;
+    /**
+     * The `definition` prop is used as the content inside of the tooltip that
+     * appears when a user interacts with the element rendered by the `children`
+     * prop
+     */
+    definition: React.ReactNode;
+    /**
+     * Provide a value that will be assigned as the id of the tooltip
+     */
+    id?: string;
+    /**
+     * Specifies whether or not the `DefinitionTooltip` should open on hover or not
+     */
+    openOnHover?: boolean;
+    /**
+     * @deprecated [Deprecated in v11] Please use the `definition` prop instead.
+     *
+     * Provide the text that will be displayed in the tooltip when it is rendered.
+     */
+    tooltipText?: React.ReactNode;
+    /**
+     * The CSS class name of the trigger element
+     */
+    triggerClassName?: string;
+}
+declare const DefinitionTooltip: React.FC<DefinitionTooltipProps>;
+export { DefinitionTooltip };

package/lib/components/Tooltip/DefinitionTooltip.js

@@ -28,7 +28,7 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 
 var _excluded = ["align", "className", "children", "definition", "defaultOpen", "id", "openOnHover", "tooltipText", "triggerClassName"];
 
-function DefinitionTooltip(_ref) {
+var DefinitionTooltip = function DefinitionTooltip(_ref) {
   var _ref$align = _ref.align,
       align = _ref$align === void 0 ? 'bottom-left' : _ref$align,
       className = _ref.className,
@@ -85,7 +85,7 @@ function DefinitionTooltip(_ref) {
     className: "".concat(prefix, "--definition-tooltip"),
     id: tooltipId
   }, tooltipText !== null && tooltipText !== void 0 ? tooltipText : definition));
-}
+};
 
 DefinitionTooltip.propTypes = {
   /**

package/lib/components/Tooltip/Tooltip.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 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.
+ */
+import PropTypes from 'prop-types';
+import React from 'react';
+import { PopoverAlignment } from '../Popover';
+import { PolymorphicProps } from '../../types/common';
+interface TooltipBaseProps {
+    /**
+     * Specify how the trigger should align with the tooltip
+     */
+    align?: PopoverAlignment;
+    /**
+     * Pass in the child to which the tooltip will be applied
+     */
+    children?: React.ReactElement;
+    /**
+     * Specify an optional className to be applied to the container node
+     */
+    className?: string;
+    /**
+     * Determines wether the tooltip should close when inner content is activated (click, Enter or Space)
+     */
+    closeOnActivation?: boolean;
+    /**
+     * Specify whether the tooltip should be open when it first renders
+     */
+    defaultOpen?: boolean;
+    /**
+     * Provide the description to be rendered inside of the Tooltip. The
+     * description will use `aria-describedby` and will describe the child node
+     * in addition to the text rendered inside of the child. This means that if you
+     * have text in the child node, that it will be announced alongside the
+     * description to the screen reader.
+     *
+     * Note: if label and description are both provided, label will be used and
+     * description will not be used
+     */
+    description?: React.ReactNode;
+    /**
+     * Specify the duration in milliseconds to delay before displaying the tooltip
+     */
+    enterDelayMs?: number;
+    /**
+     * Provide the label to be rendered inside of the Tooltip. The label will use
+     * `aria-labelledby` and will fully describe the child node that is provided.
+     * This means that if you have text in the child node, that it will not be
+     * announced to the screen reader.
+     *
+     * Note: if label and description are both provided, description will not be
+     * used
+     */
+    label?: React.ReactNode;
+    /**
+     * Specify the duration in milliseconds to delay before hiding the tooltip
+     */
+    leaveDelayMs?: number;
+}
+export type TooltipProps<T extends React.ElementType> = PolymorphicProps<T, TooltipBaseProps>;
+declare function Tooltip<T extends React.ElementType>({ align, className: customClassName, children, label, description, enterDelayMs, leaveDelayMs, defaultOpen, closeOnActivation, ...rest }: TooltipProps<T>): JSX.Element;
+declare namespace Tooltip {
+    var propTypes: {
+        /**
+         * Specify how the trigger should align with the tooltip
+         */
+        align: PropTypes.Requireable<string>;
+        /**
+         * Pass in the child to which the tooltip will be applied
+         */
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify an optional className to be applied to the container node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Determines wether the tooltip should close when inner content is activated (click, Enter or Space)
+         */
+        closeOnActivation: PropTypes.Requireable<boolean>;
+        /**
+         * Specify whether the tooltip should be open when it first renders
+         */
+        defaultOpen: PropTypes.Requireable<boolean>;
+        /**
+         * Provide the description to be rendered inside of the Tooltip. The
+         * description will use `aria-describedby` and will describe the child node
+         * in addition to the text rendered inside of the child. This means that if you
+         * have text in the child node, that it will be announced alongside the
+         * description to the screen reader.
+         *
+         * Note: if label and description are both provided, label will be used and
+         * description will not be used
+         */
+        description: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify the duration in milliseconds to delay before displaying the tooltip
+         */
+        enterDelayMs: PropTypes.Requireable<number>;
+        /**
+         * Provide the label to be rendered inside of the Tooltip. The label will use
+         * `aria-labelledby` and will fully describe the child node that is provided.
+         * This means that if you have text in the child node, that it will not be
+         * announced to the screen reader.
+         *
+         * Note: if label and description are both provided, description will not be
+         * used
+         */
+        label: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify the duration in milliseconds to delay before hiding the tooltip
+         */
+        leaveDelayMs: PropTypes.Requireable<number>;
+    };
+}
+export { Tooltip };

package/lib/components/Tooltip/Tooltip.js

@@ -113,10 +113,12 @@ function Tooltip(_ref) {
 
   useNoInteractiveChildren.useNoInteractiveChildren(tooltipRef, 'The Tooltip component must have no interactive content rendered by the' + '`label` or `description` prop');
   React.useEffect(function () {
-    var interactiveContent = useNoInteractiveChildren.getInteractiveContent(containerRef.current);
+    if (containerRef !== null && containerRef.current) {
+      var interactiveContent = useNoInteractiveChildren.getInteractiveContent(containerRef.current);
 
-    if (!interactiveContent) {
-      setOpen(false);
+      if (!interactiveContent) {
+        setOpen(false);
+      }
     }
   });
   return /*#__PURE__*/React__default["default"].createElement(index.Popover, _rollupPluginBabelHelpers["extends"]({}, rest, {
@@ -128,7 +130,7 @@ function Tooltip(_ref) {
     onMouseLeave: onMouseLeave,
     open: open,
     ref: containerRef
-  }), /*#__PURE__*/React__default["default"].cloneElement(child, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, triggerProps), getChildEventHandlers(child.props))), /*#__PURE__*/React__default["default"].createElement(index.PopoverContent, {
+  }), child !== undefined ? /*#__PURE__*/React__default["default"].cloneElement(child, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, triggerProps), getChildEventHandlers(child.props))) : null, /*#__PURE__*/React__default["default"].createElement(index.PopoverContent, {
     "aria-hidden": "true",
     className: "".concat(prefix, "--tooltip-content"),
     id: id,

package/lib/components/Tooltip/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ */
+import { DefinitionTooltip } from './DefinitionTooltip';
+import { Tooltip } from './Tooltip';
+export { DefinitionTooltip, Tooltip };

package/lib/index.d.ts

@@ -107,6 +107,8 @@ export * from './components/Layer';
 export { LayoutDirection as unstable_LayoutDirection, useLayoutDirection as unstable_useLayoutDirection, } from './components/Layout';
 export { Menu as unstable_Menu, MenuItem as unstable_MenuItem, MenuItemDivider as unstable_MenuItemDivider, MenuItemGroup as unstable_MenuItemGroup, MenuItemRadioGroup as unstable_MenuItemRadioGroup, MenuItemSelectable as unstable_MenuItemSelectable, } from './components/Menu';
 export { OverflowMenuV2 as unstable_OverflowMenuV2 } from './components/OverflowMenuV2';
+export { ComboButton as unstable_ComboButton } from './components/ComboButton';
+export { MenuButton as unstable_MenuButton } from './components/MenuButton';
 export { PageSelector as unstable_PageSelector, Pagination as unstable_Pagination, } from './components/Pagination/experimental';
 export * from './components/Popover';
 export * from './components/ProgressBar';

package/lib/index.js

@@ -12,8 +12,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 require('./feature-flags.js');
 var Checkbox = require('./components/Checkbox/Checkbox.js');
 var Checkbox_Skeleton = require('./components/Checkbox/Checkbox.Skeleton.js');
-var index$2 = require('./components/ClassPrefix/index.js');
-var index$3 = require('./components/ContentSwitcher/index.js');
+var index$4 = require('./components/ClassPrefix/index.js');
+var index$5 = require('./components/ContentSwitcher/index.js');
 var Dropdown = require('./components/Dropdown/Dropdown.js');
 var Dropdown_Skeleton = require('./components/Dropdown/Dropdown.Skeleton.js');
 var FluidForm = require('./components/FluidForm/FluidForm.js');
@@ -23,13 +23,13 @@ var Grid = require('./components/Grid/Grid.js');
 var Row = require('./components/Grid/Row.js');
 var Column = require('./components/Grid/Column.js');
 var ColumnHang = require('./components/Grid/ColumnHang.js');
-var index$4 = require('./components/IdPrefix/index.js');
-var index$5 = require('./components/OverflowMenu/index.js');
-var index$6 = require('./components/Slider/index.js');
-var index$7 = require('./components/Tab/index.js');
-var index$8 = require('./components/TileGroup/index.js');
-var index$9 = require('./components/TimePickerSelect/index.js');
-var index$a = require('./components/Toggletip/index.js');
+var index$6 = require('./components/IdPrefix/index.js');
+var index$7 = require('./components/OverflowMenu/index.js');
+var index$8 = require('./components/Slider/index.js');
+var index$9 = require('./components/Tab/index.js');
+var index$a = require('./components/TileGroup/index.js');
+var index$b = require('./components/TimePickerSelect/index.js');
+var index$c = require('./components/Toggletip/index.js');
 var Pagination_Skeleton = require('./components/Pagination/Pagination.Skeleton.js');
 var RadioButton_Skeleton = require('./components/RadioButton/RadioButton.Skeleton.js');
 var Tag_Skeleton = require('./components/Tag/Tag.Skeleton.js');
@@ -37,15 +37,18 @@ var Toggle_Skeleton = require('./components/Toggle/Toggle.Skeleton.js');
 var ToggleSmall_Skeleton = require('./components/ToggleSmall/ToggleSmall.Skeleton.js');
 var Icon_Skeleton = require('./components/Icon/Icon.Skeleton.js');
 var index = require('./components/FeatureFlags/index.js');
-var index$b = require('./components/Heading/index.js');
-var index$c = require('./components/IconButton/index.js');
-var index$d = require('./components/Layer/index.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$1 = require('./components/OverflowMenuV2/index.js');
-var index$e = require('./components/Popover/index.js');
-var index$f = require('./components/Stack/index.js');
-require('./components/Text/index.js');
+var index$2 = require('./components/ComboButton/index.js');
+var index$3 = require('./components/MenuButton/index.js');
+var index$g = require('./components/Popover/index.js');
+var index$h = require('./components/Stack/index.js');
 var DefinitionTooltip = require('./components/Tooltip/DefinitionTooltip.js');
-var index$g = require('./components/Theme/index.js');
+var Tooltip = require('./components/Tooltip/Tooltip.js');
+require('./components/Text/index.js');
+var index$i = require('./components/Theme/index.js');
 var usePrefix = require('./internal/usePrefix.js');
 var useIdPrefix = require('./internal/useIdPrefix.js');
 var useContextMenu = require('./components/ContextMenu/useContextMenu.js');
@@ -80,7 +83,6 @@ var NumberInput_Skeleton = require('./components/NumberInput/NumberInput.Skeleto
 var ProgressIndicator_Skeleton = require('./components/ProgressIndicator/ProgressIndicator.Skeleton.js');
 var ExpandableSearch = require('./components/ExpandableSearch/ExpandableSearch.js');
 var Tabs_Skeleton = require('./components/Tabs/Tabs.Skeleton.js');
-var RadioTile = require('./components/RadioTile/RadioTile.js');
 var Toggle = require('./components/Toggle/Toggle.js');
 var TreeNode = require('./components/TreeView/TreeNode.js');
 var TreeView = require('./components/TreeView/TreeView.js');
@@ -189,6 +191,7 @@ var TextArea = require('./components/TextArea/TextArea.js');
 var TextInput_Skeleton = require('./components/TextInput/TextInput.Skeleton.js');
 var TextInput = require('./components/TextInput/TextInput.js');
 var Tile = require('./components/Tile/Tile.js');
+var RadioTile = require('./components/RadioTile/RadioTile.js');
 var TimePicker = require('./components/TimePicker/TimePicker.js');
 var UnorderedList = require('./components/UnorderedList/UnorderedList.js');
 var SkeletonText = require('./components/SkeletonText/SkeletonText.js');
@@ -216,14 +219,13 @@ var SideNavMenu = require('./components/UIShell/SideNavMenu.js');
 var SideNavMenuItem = require('./components/UIShell/SideNavMenuItem.js');
 var SideNavSwitcher = require('./components/UIShell/SideNavSwitcher.js');
 var Stack = require('./components/Stack/Stack.js');
-var Tooltip = require('./components/Tooltip/Tooltip.js');
 
 
 
 exports.Checkbox = Checkbox["default"];
 exports.CheckboxSkeleton = Checkbox_Skeleton["default"];
-exports.ClassPrefix = index$2.ClassPrefix;
-exports.ContentSwitcher = index$3["default"];
+exports.ClassPrefix = index$4.ClassPrefix;
+exports.ContentSwitcher = index$5["default"];
 exports.Dropdown = Dropdown["default"];
 exports.DropdownSkeleton = Dropdown_Skeleton["default"];
 exports.FluidForm = FluidForm["default"];
@@ -233,17 +235,17 @@ exports.Grid = Grid.Grid;
 exports.Row = Row["default"];
 exports.Column = Column["default"];
 exports.ColumnHang = ColumnHang.ColumnHang;
-exports.IdPrefix = index$4.IdPrefix;
-exports.OverflowMenu = index$5["default"];
-exports.Slider = index$6["default"];
-exports.Tab = index$7["default"];
-exports.TileGroup = index$8["default"];
-exports.TimePickerSelect = index$9["default"];
-exports.Toggletip = index$a.Toggletip;
-exports.ToggletipActions = index$a.ToggletipActions;
-exports.ToggletipButton = index$a.ToggletipButton;
-exports.ToggletipContent = index$a.ToggletipContent;
-exports.ToggletipLabel = index$a.ToggletipLabel;
+exports.IdPrefix = index$6.IdPrefix;
+exports.OverflowMenu = index$7["default"];
+exports.Slider = index$8["default"];
+exports.Tab = index$9["default"];
+exports.TileGroup = index$a["default"];
+exports.TimePickerSelect = index$b["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.PaginationSkeleton = Pagination_Skeleton["default"];
 exports.RadioButtonSkeleton = RadioButton_Skeleton["default"];
 exports.TagSkeleton = Tag_Skeleton["default"];
@@ -253,21 +255,24 @@ exports.IconSkeleton = Icon_Skeleton["default"];
 exports.unstable_FeatureFlags = index.FeatureFlags;
 exports.unstable_useFeatureFlag = index.useFeatureFlag;
 exports.unstable_useFeatureFlags = index.useFeatureFlags;
-exports.Heading = index$b.Heading;
-exports.Section = index$b.Section;
-exports.IconButton = index$c.IconButton;
-exports.Layer = index$d.Layer;
-exports.useLayer = index$d.useLayer;
+exports.Heading = index$d.Heading;
+exports.Section = index$d.Section;
+exports.IconButton = index$e.IconButton;
+exports.Layer = index$f.Layer;
+exports.useLayer = index$f.useLayer;
 exports.unstable_OverflowMenuV2 = index$1.OverflowMenuV2;
-exports.Popover = index$e.Popover;
-exports.PopoverContent = index$e.PopoverContent;
-exports.HStack = index$f.HStack;
-exports.VStack = index$f.VStack;
+exports.unstable_ComboButton = index$2.ComboButton;
+exports.unstable_MenuButton = index$3.MenuButton;
+exports.Popover = index$g.Popover;
+exports.PopoverContent = index$g.PopoverContent;
+exports.HStack = index$h.HStack;
+exports.VStack = index$h.VStack;
 exports.DefinitionTooltip = DefinitionTooltip.DefinitionTooltip;
-exports.GlobalTheme = index$g.GlobalTheme;
-exports.Theme = index$g.Theme;
-exports.ThemeContext = index$g.ThemeContext;
-exports.useTheme = index$g.useTheme;
+exports.Tooltip = Tooltip.Tooltip;
+exports.GlobalTheme = index$i.GlobalTheme;
+exports.Theme = index$i.Theme;
+exports.ThemeContext = index$i.ThemeContext;
+exports.useTheme = index$i.useTheme;
 exports.PrefixContext = usePrefix.PrefixContext;
 exports.usePrefix = usePrefix.usePrefix;
 exports.useIdPrefix = useIdPrefix.useIdPrefix;
@@ -303,7 +308,6 @@ exports.NumberInputSkeleton = NumberInput_Skeleton["default"];
 exports.ProgressIndicatorSkeleton = ProgressIndicator_Skeleton["default"];
 exports.ExpandableSearch = ExpandableSearch["default"];
 exports.TabsSkeleton = Tabs_Skeleton["default"];
-exports.RadioTile = RadioTile["default"];
 exports.Toggle = Toggle.Toggle;
 exports.TreeNode = TreeNode["default"];
 exports.TreeView = TreeView["default"];
@@ -437,6 +441,7 @@ exports.SelectableTile = Tile.SelectableTile;
 exports.Tile = Tile.Tile;
 exports.TileAboveTheFoldContent = Tile.TileAboveTheFoldContent;
 exports.TileBelowTheFoldContent = Tile.TileBelowTheFoldContent;
+exports.RadioTile = RadioTile["default"];
 exports.TimePicker = TimePicker["default"];
 exports.UnorderedList = UnorderedList["default"];
 exports.SkeletonText = SkeletonText["default"];
@@ -464,4 +469,3 @@ exports.SideNavMenu = SideNavMenu["default"];
 exports.SideNavMenuItem = SideNavMenuItem["default"];
 exports.SideNavSwitcher = SideNavSwitcher["default"];
 exports.Stack = Stack.Stack;
-exports.Tooltip = Tooltip.Tooltip;

package/lib/internal/ClickListener.js

@@ -34,8 +34,7 @@ var ClickListener = /*#__PURE__*/function (_React$Component) {
     _rollupPluginBabelHelpers.classCallCheck(this, ClickListener);
 
     _this = _super.call(this, props); // We manually bind handlers in this Component, versus using class
-    // properties, so that we can properly test the `handleRef` handler with
-    // enzyme.
+    // properties, so that we can properly test the `handleRef` handler.
 
     _this.handleRef = _this.handleRef.bind(_rollupPluginBabelHelpers.assertThisInitialized(_this));
     _this.handleDocumentClick = _this.handleDocumentClick.bind(_rollupPluginBabelHelpers.assertThisInitialized(_this));

package/lib/internal/keyboard/match.js

@@ -57,7 +57,7 @@ function matches(event, keysToMatch) {
  *   }
  * }
  *
- * @param {Event|number|string} eventOrCode
+ * @param {React.KeyboardEvent|Event|number|string} eventOrCode
  * @param {Key} key
  * @returns {boolean}
  */

package/lib/internal/useAttachedMenu.js

@@ -0,0 +1,89 @@
+/**
+ * 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.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+var React = require('react');
+
+/**
+ * @typedef {object} useAttachedMenuReturn
+ * @property {boolean} open Whether the menu is open or not
+ * @property {[number, number]} x The x position of the menu
+ * @property {[number, number]} y The y position of the menu
+ * @property {Function} handleClick A function to be called when the trigger element receives a click event
+ * @property {Function} handleMousedown A function to be called when the trigger element recives a mousedown event
+ * @property {Function} handleClose A function to be called when the menu emits onClose
+ */
+
+/**
+ * This hook contains common code to be used when a menu should be visually attached to an anchor based on a click event.
+ *
+ * @param {Element|object} anchor The element or ref the menu should visually be attached to.
+ * @returns {useAttachedMenuReturn}
+ */
+
+function useAttachedMenu(anchor) {
+  var _useState = React.useState(false),
+      _useState2 = _rollupPluginBabelHelpers.slicedToArray(_useState, 2),
+      open = _useState2[0],
+      setOpen = _useState2[1];
+
+  var _useState3 = React.useState([[-1, -1], [-1, -1]]),
+      _useState4 = _rollupPluginBabelHelpers.slicedToArray(_useState3, 2),
+      position = _useState4[0],
+      setPosition = _useState4[1];
+
+  function openMenu() {
+    var anchorEl = (anchor === null || anchor === void 0 ? void 0 : anchor.current) || anchor;
+
+    if (anchorEl) {
+      var _anchorEl$getBounding = anchorEl.getBoundingClientRect(),
+          left = _anchorEl$getBounding.left,
+          top = _anchorEl$getBounding.top,
+          right = _anchorEl$getBounding.right,
+          bottom = _anchorEl$getBounding.bottom;
+
+      setPosition([[left, right], [top, bottom]]);
+    }
+
+    setOpen(true);
+  }
+
+  function closeMenu() {
+    setOpen(false);
+  }
+
+  function handleClick() {
+    if (open) {
+      closeMenu();
+    } else {
+      openMenu();
+    }
+  }
+
+  function handleMousedown(e) {
+    // prevent default for mousedown on trigger element to avoid
+    // the "blur" event from firing on the menu as this would close
+    // it and immediately re-open since "click" event is fired after
+    // "blur" event.
+    e.preventDefault();
+  }
+
+  return {
+    open: open,
+    x: position[0],
+    y: position[1],
+    handleClick: handleClick,
+    handleMousedown: handleMousedown,
+    handleClose: closeMenu
+  };
+}
+
+exports.useAttachedMenu = useAttachedMenu;

package/lib/internal/useDelayedState.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+import { SetStateAction } from 'react';
+/**
+ * `useDelayedState` mirrors `useState` but also allows you to add a delay to
+ * when your state updates. You can provide a second argument to `setState`,
+ * `delayMs`, which will be the time in milliseconds after which the state is
+ * updated.
+ *
+ * This hook will clean up pending timers in `useEffect` and will cancel any
+ * pending timers when a `setState` is called before the state is updated from
+ * a previous call
+ */
+export type DispatchWithDelay<A> = (value: A, delayMS?: number) => void;
+export declare function useDelayedState<S>(initialState: S): [S, DispatchWithDelay<SetStateAction<S>>];

package/lib/internal/useDelayedState.js

@@ -33,8 +33,10 @@ function useDelayedState(initialState) {
   // always return the same reference for the `setState` updater
 
   var setStateWithDelay = React.useCallback(function (stateToSet) {
+    var _timeoutId$current;
+
     var delayMs = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-    clearTimeout(timeoutId.current);
+    window.clearTimeout((_timeoutId$current = timeoutId.current) !== null && _timeoutId$current !== void 0 ? _timeoutId$current : undefined);
     timeoutId.current = null;
 
     if (delayMs === 0) {
@@ -42,14 +44,16 @@ function useDelayedState(initialState) {
       return;
     }
 
-    timeoutId.current = setTimeout(function () {
+    timeoutId.current = window.setTimeout(function () {
       setState(stateToSet);
       timeoutId.current = null;
     }, delayMs);
   }, []);
   React.useEffect(function () {
     return function () {
-      clearTimeout(timeoutId.current);
+      var _timeoutId$current2;
+
+      window.clearTimeout((_timeoutId$current2 = timeoutId.current) !== null && _timeoutId$current2 !== void 0 ? _timeoutId$current2 : undefined);
     };
   }, []);
   return [state, setStateWithDelay];

package/lib/internal/useId.js

@@ -54,7 +54,7 @@ function useId() {
 }
 /**
  * Generate a unique id if a given `id` is not provided
- * @param {string} id
+ * @param {string|undefined} id
  * @returns {string}
  */
 

package/lib/internal/useMergedRefs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ */
+import { Ref, ForwardedRef } 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.
+ */
+export declare const useMergedRefs: <T>(refs: ForwardedRef<T>[]) => Ref<T>;