@carbon/react 1.24.0 → 1.25.0

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carbon/react",
   "description": "React components for the Carbon Design System",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "license": "Apache-2.0",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -46,7 +46,7 @@
     "@carbon/feature-flags": "^0.13.0",
     "@carbon/icons-react": "^11.17.0",
     "@carbon/layout": "^11.12.0",
-    "@carbon/styles": "^1.24.0",
+    "@carbon/styles": "^1.25.0",
     "@carbon/telemetry": "0.1.0",
     "classnames": "2.3.2",
     "copy-to-clipboard": "^3.3.1",
@@ -133,5 +133,5 @@
     "**/*.scss",
     "**/*.css"
   ],
-  "gitHead": "07168bf0272678a04c92cd1e700ac60e66355a95"
+  "gitHead": "47966b102beb1310c23bb0fc914a22f639dc08d6"
 }