@carbon/react 1.24.0 → 1.26.0-rc.0

package/es/components/OverflowMenu/OverflowMenu.js

@@ -20,9 +20,9 @@ import { IconButton } from '../IconButton/index.js';
 import { matches } from '../../internal/keyboard/match.js';
 import { ArrowUp, ArrowRight, ArrowDown, ArrowLeft, Escape } from '../../internal/keyboard/keys.js';
 
-var _excluded = ["id", "ariaLabel", "children", "iconDescription", "direction", "flipped", "focusTrap", "menuOffset", "menuOffsetFlip", "iconClass", "onClick", "onOpen", "selectorPrimaryFocus", "renderIcon", "innerRef", "menuOptionsClass", "light", "size"];
+var _excluded = ["id", "aria-label", "ariaLabel", "children", "iconDescription", "direction", "flipped", "focusTrap", "menuOffset", "menuOffsetFlip", "iconClass", "onClick", "onOpen", "selectorPrimaryFocus", "renderIcon", "innerRef", "menuOptionsClass", "light", "size"];
 
-var _triggerButtonPositio, _triggerButtonPositio2;
+var _triggerButtonPositio, _triggerButtonPositio2, _defineProperty2, _defineProperty3;
 
 var on = function on(element) {
   for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
@@ -288,7 +288,8 @@ var OverflowMenu = /*#__PURE__*/function (_Component) {
 
       var _this$props = this.props,
           id = _this$props.id,
-          ariaLabel = _this$props.ariaLabel,
+          ariaLabel = _this$props['aria-label'],
+          deprecatedAriaLabel = _this$props.ariaLabel,
           children = _this$props.children,
           iconDescription = _this$props.iconDescription,
           direction = _this$props.direction,
@@ -328,7 +329,7 @@ var OverflowMenu = /*#__PURE__*/function (_Component) {
         className: overflowMenuOptionsClasses,
         tabIndex: "-1",
         role: "menu",
-        "aria-label": ariaLabel,
+        "aria-label": ariaLabel || deprecatedAriaLabel,
         onKeyDown: this.handleKeyPress
       }, childrenWithProps);
       var wrappedMenuBody = /*#__PURE__*/React__default.createElement(FloatingMenu, {
@@ -378,144 +379,17 @@ var OverflowMenu = /*#__PURE__*/function (_Component) {
   return OverflowMenu;
 }(Component);
 
-_defineProperty(OverflowMenu, "propTypes", {
-  /**
-   * The ARIA label.
-   */
-  ariaLabel: PropTypes.string.isRequired,
-
-  /**
-   * The child nodes.
-   */
-  children: PropTypes.node,
-
-  /**
-   * The CSS class names.
-   */
-  className: PropTypes.string,
-
-  /**
-   * The menu direction.
-   */
-  direction: PropTypes.oneOf([DIRECTION_TOP, DIRECTION_BOTTOM]),
-
-  /**
-   * `true` if the menu alignment should be flipped.
-   */
-  flipped: PropTypes.bool,
-
-  /**
-   * Enable or disable focus trap behavior
-   */
-  focusTrap: PropTypes.bool,
-
-  /**
-   * The CSS class for the icon.
-   */
-  iconClass: PropTypes.string,
-
-  /**
-   * The icon description.
-   */
-  iconDescription: PropTypes.string.isRequired,
-
-  /**
-   * The element ID.
-   */
-  id: PropTypes.string,
-
-  /**
-   * `true` to use the light version. For use on $ui-01 backgrounds only.
-   * Don't use this to make OverflowMenu background color same as container background color.
-   */
-  light: deprecate(PropTypes.bool, 'The `light` prop for `OverflowMenu` is no longer needed and has been deprecated. It will be removed in the next major release. Use the Layer component instead.'),
-
-  /**
-   * The adjustment in position applied to the floating menu.
-   */
-  menuOffset: PropTypes.oneOfType([PropTypes.shape({
-    top: PropTypes.number,
-    left: PropTypes.number
-  }), PropTypes.func]),
-
-  /**
-   * The adjustment in position applied to the floating menu.
-   */
-  menuOffsetFlip: PropTypes.oneOfType([PropTypes.shape({
-    top: PropTypes.number,
-    left: PropTypes.number
-  }), PropTypes.func]),
-
-  /**
-   * The class to apply to the menu options
-   */
-  menuOptionsClass: PropTypes.string,
-
-  /**
-   * The event handler for the `click` event.
-   */
-  onClick: PropTypes.func,
-
-  /**
-   * Function called when menu is closed
-   */
-  onClose: PropTypes.func,
-
-  /**
-   * The event handler for the `focus` event.
-   */
-  onFocus: PropTypes.func,
-
-  /**
-   * The event handler for the `keydown` event.
-   */
-  onKeyDown: PropTypes.func,
-
-  /**
-   * Function called when menu is opened
-   */
-  onOpen: PropTypes.func,
-
-  /**
-   * `true` if the menu should be open.
-   */
-  open: PropTypes.bool,
-
-  /**
-   * Function called to override icon rendering.
-   */
-  renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object]),
-
-  /**
-   * Specify a CSS selector that matches the DOM element that should
-   * be focused when the OverflowMenu opens
-   */
-  selectorPrimaryFocus: PropTypes.string,
-
-  /**
-   * Specify the size of the OverflowMenu. Currently supports either `sm`, 'md' (default) or 'lg` as an option.
-   */
-  size: PropTypes.oneOf(['sm', 'md', 'lg'])
-});
+_defineProperty(OverflowMenu, "propTypes", (_defineProperty2 = {}, _defineProperty(_defineProperty2, 'aria-label', PropTypes.string), _defineProperty(_defineProperty2, "ariaLabel", deprecate(PropTypes.string, 'This prop syntax has been deprecated. Please use the new `aria-label`.')), _defineProperty(_defineProperty2, "children", PropTypes.node), _defineProperty(_defineProperty2, "className", PropTypes.string), _defineProperty(_defineProperty2, "direction", PropTypes.oneOf([DIRECTION_TOP, DIRECTION_BOTTOM])), _defineProperty(_defineProperty2, "flipped", PropTypes.bool), _defineProperty(_defineProperty2, "focusTrap", PropTypes.bool), _defineProperty(_defineProperty2, "iconClass", PropTypes.string), _defineProperty(_defineProperty2, "iconDescription", PropTypes.string.isRequired), _defineProperty(_defineProperty2, "id", PropTypes.string), _defineProperty(_defineProperty2, "light", deprecate(PropTypes.bool, 'The `light` prop for `OverflowMenu` is no longer needed and has been deprecated. It will be removed in the next major release. Use the Layer component instead.')), _defineProperty(_defineProperty2, "menuOffset", PropTypes.oneOfType([PropTypes.shape({
+  top: PropTypes.number,
+  left: PropTypes.number
+}), PropTypes.func])), _defineProperty(_defineProperty2, "menuOffsetFlip", PropTypes.oneOfType([PropTypes.shape({
+  top: PropTypes.number,
+  left: PropTypes.number
+}), PropTypes.func])), _defineProperty(_defineProperty2, "menuOptionsClass", PropTypes.string), _defineProperty(_defineProperty2, "onClick", PropTypes.func), _defineProperty(_defineProperty2, "onClose", PropTypes.func), _defineProperty(_defineProperty2, "onFocus", PropTypes.func), _defineProperty(_defineProperty2, "onKeyDown", PropTypes.func), _defineProperty(_defineProperty2, "onOpen", PropTypes.func), _defineProperty(_defineProperty2, "open", PropTypes.bool), _defineProperty(_defineProperty2, "renderIcon", PropTypes.oneOfType([PropTypes.func, PropTypes.object])), _defineProperty(_defineProperty2, "selectorPrimaryFocus", PropTypes.string), _defineProperty(_defineProperty2, "size", PropTypes.oneOf(['sm', 'md', 'lg'])), _defineProperty2));
 
 _defineProperty(OverflowMenu, "contextType", PrefixContext);
 
-_defineProperty(OverflowMenu, "defaultProps", {
-  ariaLabel: null,
-  iconDescription: 'Options',
-  open: false,
-  direction: DIRECTION_BOTTOM,
-  flipped: false,
-  focusTrap: true,
-  renderIcon: OverflowMenuVertical,
-  onClick: function onClick() {},
-  onKeyDown: function onKeyDown() {},
-  onClose: function onClose() {},
-  onOpen: function onOpen() {},
-  menuOffset: getMenuOffset,
-  menuOffsetFlip: getMenuOffset,
-  selectorPrimaryFocus: '[data-overflow-menu-primary-focus]'
-});
+_defineProperty(OverflowMenu, "defaultProps", (_defineProperty3 = {}, _defineProperty(_defineProperty3, 'aria-label', null), _defineProperty(_defineProperty3, "iconDescription", 'Options'), _defineProperty(_defineProperty3, "open", false), _defineProperty(_defineProperty3, "direction", DIRECTION_BOTTOM), _defineProperty(_defineProperty3, "flipped", false), _defineProperty(_defineProperty3, "focusTrap", true), _defineProperty(_defineProperty3, "renderIcon", OverflowMenuVertical), _defineProperty(_defineProperty3, "onClick", function onClick() {}), _defineProperty(_defineProperty3, "onKeyDown", function onKeyDown() {}), _defineProperty(_defineProperty3, "onClose", function onClose() {}), _defineProperty(_defineProperty3, "onOpen", function onOpen() {}), _defineProperty(_defineProperty3, "menuOffset", getMenuOffset), _defineProperty(_defineProperty3, "menuOffsetFlip", getMenuOffset), _defineProperty(_defineProperty3, "selectorPrimaryFocus", '[data-overflow-menu-primary-focus]'), _defineProperty3));
 ((function () {
   var forwardRef = function forwardRef(props, ref) {
     return /*#__PURE__*/React__default.createElement(OverflowMenu, _extends({}, props, {

package/es/components/OverflowMenuItem/OverflowMenuItem.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 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 { ForwardRefReturn } from '../../types/common';
+export interface OverflowMenuItemProps extends React.HTMLAttributes<HTMLElement> {
+    /**
+     * The CSS class name to be placed on the button element
+     */
+    className?: string;
+    /**
+     * A callback to tell the parent menu component that the menu should be closed.
+     */
+    closeMenu?: () => void;
+    /**
+     * `true` to make this menu item disabled.
+     */
+    disabled?: boolean;
+    handleOverflowMenuItemFocus?: (options: {
+        currentIndex?: number;
+        direction: number;
+    }) => void;
+    /**
+     * `true` to make this menu item a divider.
+     */
+    hasDivider?: boolean;
+    /**
+     * If given, overflow item will render as a link with the given href
+     */
+    href?: string;
+    index?: number;
+    /**
+     * The text to show for the menu item
+     */
+    itemText?: React.ReactNode;
+    /**
+     * `true` to make this menu item a danger button.
+     */
+    isDelete?: boolean;
+    /**
+     * `true` to require the title attribute.
+     */
+    requireTitle?: boolean;
+    /**
+     * The title attribute.
+     */
+    title?: string;
+    /**
+     * The CSS class name to be placed on the wrapper element
+     */
+    wrapperClassName?: string;
+}
+export type OverflowMenuItemComponent = ForwardRefReturn<HTMLElement, OverflowMenuItemProps>;
+declare const OverflowMenuItem: OverflowMenuItemComponent;
+export default OverflowMenuItem;

package/es/components/OverflowMenuItem/OverflowMenuItem.js

@@ -9,8 +9,8 @@ import { objectWithoutProperties as _objectWithoutProperties, defineProperty as
 import cx from 'classnames';
 import PropTypes from 'prop-types';
 import React__default from 'react';
-import { warning } from '../../internal/warning.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import { warning } from '../../internal/warning.js';
 import { match } from '../../internal/keyboard/match.js';
 import { ArrowDown, ArrowUp } from '../../internal/keyboard/keys.js';
 
@@ -44,14 +44,14 @@ var OverflowMenuItem = /*#__PURE__*/React__default.forwardRef(function OverflowM
 
   function setTabFocus(evt) {
     if (match(evt, ArrowDown)) {
-      handleOverflowMenuItemFocus({
+      handleOverflowMenuItemFocus === null || handleOverflowMenuItemFocus === void 0 ? void 0 : handleOverflowMenuItemFocus({
         currentIndex: index,
         direction: 1
       });
     }
 
     if (match(evt, ArrowUp)) {
-      handleOverflowMenuItemFocus({
+      handleOverflowMenuItemFocus === null || handleOverflowMenuItemFocus === void 0 ? void 0 : handleOverflowMenuItemFocus({
         currentIndex: index,
         direction: -1
       });
@@ -91,17 +91,22 @@ var OverflowMenuItem = /*#__PURE__*/React__default.forwardRef(function OverflowM
     className: overflowMenuBtnClasses,
     disabled: disabled,
     href: href,
-    index: index,
     onClick: handleClick,
     onKeyDown: function onKeyDown(evt) {
       setTabFocus(evt);
 
       _onKeyDown(evt);
     },
-    role: "menuitem",
+    role: "menuitem" // ref as any: the type of `ref` is `ForwardedRef<HTMLButtonElement>` in `Button` component
+    // but `OverflowMenuItem` can be rendered as `a` tag as well, which is `HTMLAnchorElement`
+    // so we have to use `any` here
+    ,
     ref: ref,
-    tabIndex: "-1",
-    title: requireTitle ? title || itemText : null
+    tabIndex: -1 // itemText as any: itemText may be a ReactNode, but `title` only accepts string
+    // to avoid compatibility issue, we use `any` here. Consider to enforce `itemText` to be `string?`
+    // in the next major release
+    ,
+    title: requireTitle ? title || itemText : undefined
   }, rest), OverflowMenuItemContent));
 });
 OverflowMenuItem.propTypes = {

package/es/components/OverflowMenuV2/index.js

@@ -5,14 +5,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import { objectWithoutProperties as _objectWithoutProperties, slicedToArray as _slicedToArray, defineProperty as _defineProperty, extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import React__default, { useState, useRef } from 'react';
+import { objectWithoutProperties as _objectWithoutProperties, defineProperty as _defineProperty, extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import React__default, { useRef } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { OverflowMenuVertical } from '@carbon/icons-react';
-import { useId } from '../../internal/useId.js';
 import { Menu } from '../Menu/Menu.js';
+import { useId } from '../../internal/useId.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import { useAttachedMenu } from '../../internal/useAttachedMenu.js';
 
 var _excluded = ["children", "className", "renderIcon", "size"];
 var defaultSize = 'md';
@@ -29,53 +30,16 @@ function OverflowMenuV2(_ref) {
       rest = _objectWithoutProperties(_ref, _excluded);
 
   var id = useId('overflowmenu');
-
-  var _useState = useState(false),
-      _useState2 = _slicedToArray(_useState, 2),
-      open = _useState2[0],
-      setOpen = _useState2[1];
-
-  var _useState3 = useState([[0, 0], [0, 0]]),
-      _useState4 = _slicedToArray(_useState3, 2),
-      position = _useState4[0],
-      setPosition = _useState4[1];
-
-  var triggerRef = useRef(null);
   var prefix = usePrefix();
+  var triggerRef = useRef(null);
 
-  function openMenu() {
-    if (triggerRef.current) {
-      var _triggerRef$current$g = triggerRef.current.getBoundingClientRect(),
-          left = _triggerRef$current$g.left,
-          top = _triggerRef$current$g.top,
-          right = _triggerRef$current$g.right,
-          bottom = _triggerRef$current$g.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();
-  }
+  var _useAttachedMenu = useAttachedMenu(triggerRef),
+      open = _useAttachedMenu.open,
+      x = _useAttachedMenu.x,
+      y = _useAttachedMenu.y,
+      handleClick = _useAttachedMenu.handleClick,
+      handleMousedown = _useAttachedMenu.handleMousedown,
+      handleClose = _useAttachedMenu.handleClose;
 
   var containerClasses = cx("".concat(prefix, "--overflow-menu__container"));
   var triggerClasses = cx("".concat(prefix, "--overflow-menu"), (_classNames = {}, _defineProperty(_classNames, "".concat(prefix, "--overflow-menu--open"), open), _defineProperty(_classNames, className, className), _classNames), size !== defaultSize && "".concat(prefix, "--overflow-menu--").concat(size));
@@ -96,9 +60,9 @@ function OverflowMenuV2(_ref) {
     id: id,
     size: size,
     open: open,
-    onClose: closeMenu,
-    x: position[0],
-    y: position[1]
+    onClose: handleClose,
+    x: x,
+    y: y
   }, children));
 }
 

package/es/components/Popover/index.d.ts

@@ -13,7 +13,7 @@ interface PopoverBaseProps {
      */
     align?: PopoverAlignment;
     /**
-     * Will auto-align the popover on first render if it is not visible. This prop is currently experimental and is subject to futurue changes.
+     * Will auto-align the popover on first render if it is not visible. This prop is currently experimental and is subject to future changes.
      */
     autoAlign?: boolean;
     /**
@@ -37,6 +37,10 @@ interface PopoverBaseProps {
      * Render the component using the high-contrast variant
      */
     highContrast?: boolean;
+    /**
+     * Render the component using the tab tip variant
+     */
+    isTabTip?: boolean;
     /**
      * Specify whether the component is currently open or closed
      */

package/es/components/Popover/index.js

@@ -13,7 +13,7 @@ import useIsomorphicEffect from '../../internal/useIsomorphicEffect.js';
 import { useMergedRefs } from '../../internal/useMergedRefs.js';
 import { usePrefix } from '../../internal/usePrefix.js';
 
-var _excluded = ["align", "as", "autoAlign", "caret", "className", "children", "dropShadow", "highContrast", "open"],
+var _excluded = ["isTabTip", "align", "as", "autoAlign", "caret", "className", "children", "dropShadow", "highContrast", "open"],
     _excluded2 = ["className", "children"];
 var PopoverContext = /*#__PURE__*/React__default.createContext({
   floating: {
@@ -23,13 +23,14 @@ var PopoverContext = /*#__PURE__*/React__default.createContext({
 var Popover = /*#__PURE__*/React__default.forwardRef(function (_ref, forwardRef) {
   var _cx;
 
-  var _ref$align = _ref.align,
-      align = _ref$align === void 0 ? 'bottom' : _ref$align,
+  var isTabTip = _ref.isTabTip,
+      _ref$align = _ref.align,
+      align = _ref$align === void 0 ? isTabTip ? 'bottom-left' : 'bottom' : _ref$align,
       as = _ref.as,
       _ref$autoAlign = _ref.autoAlign,
       autoAlign = _ref$autoAlign === void 0 ? false : _ref$autoAlign,
       _ref$caret = _ref.caret,
-      caret = _ref$caret === void 0 ? true : _ref$caret,
+      caret = _ref$caret === void 0 ? isTabTip ? false : true : _ref$caret,
       customClassName = _ref.className,
       children = _ref.children,
       _ref$dropShadow = _ref.dropShadow,
@@ -47,6 +48,15 @@ var Popover = /*#__PURE__*/React__default.forwardRef(function (_ref, forwardRef)
       floating: floating
     };
   }, []);
+
+  if (isTabTip) {
+    var tabTipAlignments = ['bottom-left', 'bottom-right'];
+
+    if (!tabTipAlignments.includes(align)) {
+      align = 'bottom-left';
+    }
+  }
+
   var ref = useMergedRefs([forwardRef, popover]);
 
   var _useState = useState(false),
@@ -59,13 +69,13 @@ var Popover = /*#__PURE__*/React__default.forwardRef(function (_ref, forwardRef)
       autoAlignment = _useState4[0],
       setAutoAlignment = _useState4[1];
 
-  var className = cx((_cx = {}, _defineProperty(_cx, "".concat(prefix, "--popover-container"), true), _defineProperty(_cx, "".concat(prefix, "--popover--caret"), caret), _defineProperty(_cx, "".concat(prefix, "--popover--drop-shadow"), dropShadow), _defineProperty(_cx, "".concat(prefix, "--popover--high-contrast"), highContrast), _defineProperty(_cx, "".concat(prefix, "--popover--open"), open), _defineProperty(_cx, "".concat(prefix, "--popover--").concat(autoAlignment), autoAligned), _defineProperty(_cx, "".concat(prefix, "--popover--").concat(align), !autoAligned), _cx), customClassName);
+  var className = cx((_cx = {}, _defineProperty(_cx, "".concat(prefix, "--popover-container"), true), _defineProperty(_cx, "".concat(prefix, "--popover--caret"), caret), _defineProperty(_cx, "".concat(prefix, "--popover--drop-shadow"), dropShadow), _defineProperty(_cx, "".concat(prefix, "--popover--high-contrast"), highContrast), _defineProperty(_cx, "".concat(prefix, "--popover--open"), open), _defineProperty(_cx, "".concat(prefix, "--popover--").concat(autoAlignment), autoAligned && !isTabTip), _defineProperty(_cx, "".concat(prefix, "--popover--").concat(align), !autoAligned), _defineProperty(_cx, "".concat(prefix, "--popover--tab-tip"), isTabTip), _cx), customClassName);
   useIsomorphicEffect(function () {
     if (!open) {
       return;
     }
 
-    if (!autoAlign) {
+    if (!autoAlign || isTabTip) {
       setAutoAligned(false);
       return;
     }
@@ -156,14 +166,27 @@ var Popover = /*#__PURE__*/React__default.forwardRef(function (_ref, forwardRef)
       setAutoAligned(true);
       setAutoAlignment(alignment);
     }
-  }, [autoAligned, align, autoAlign, prefix, open]);
+  }, [autoAligned, align, autoAlign, prefix, open, isTabTip]);
   var BaseComponent = as !== null && as !== void 0 ? as : 'span';
+  var mappedChildren = React__default.Children.map(children, function (child) {
+    var item = child;
+
+    if ((item === null || item === void 0 ? void 0 : item.type) === 'button') {
+      var _className = item.props.className;
+      var tabTipClasses = cx("".concat(prefix, "--popover--tab-tip__button"), _className);
+      return /*#__PURE__*/React__default.cloneElement(item, {
+        className: tabTipClasses
+      });
+    } else {
+      return item;
+    }
+  });
   return /*#__PURE__*/React__default.createElement(PopoverContext.Provider, {
     value: value
   }, /*#__PURE__*/React__default.createElement(BaseComponent, _extends({}, rest, {
     className: className,
     ref: ref
-  }), children));
+  }), isTabTip ? mappedChildren : children));
 }); // Note: this displayName is temporarily set so that Storybook ArgTable
 // correctly displays the name of this component
 
@@ -184,7 +207,7 @@ Popover.propTypes = {
   as: PropTypes.oneOfType([PropTypes.string, PropTypes.elementType]),
 
   /**
-   * Will auto-align the popover on first render if it is not visible. This prop is currently experimental and is subject to futurue changes.
+   * Will auto-align the popover on first render if it is not visible. This prop is currently experimental and is subject to future changes.
    */
   autoAlign: PropTypes.bool,
 
@@ -214,6 +237,11 @@ Popover.propTypes = {
    */
   highContrast: PropTypes.bool,
 
+  /**
+   * Render the component using the tab tip variant
+   */
+  isTabTip: PropTypes.bool,
+
   /**
    * Specify whether the component is currently open or closed
    */

package/es/components/RadioButton/RadioButton.Skeleton.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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';
+export interface RadioButtonSkeletonProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    /**
+     * Specify an optional className to add.
+     */
+    className?: string;
+}
+declare function RadioButtonSkeleton(props: RadioButtonSkeletonProps): JSX.Element;
+declare namespace RadioButtonSkeleton {
+    var propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+    };
+}
+export default RadioButtonSkeleton;
+export { RadioButtonSkeleton };

package/es/components/RadioButton/RadioButton.Skeleton.js

@@ -13,9 +13,9 @@ import { usePrefix } from '../../internal/usePrefix.js';
 
 var _excluded = ["className"];
 
-function RadioButtonSkeleton(_ref) {
-  var className = _ref.className,
-      rest = _objectWithoutProperties(_ref, _excluded);
+function RadioButtonSkeleton(props) {
+  var className = props.className,
+      rest = _objectWithoutProperties(props, _excluded);
 
   var prefix = usePrefix();
   return /*#__PURE__*/React__default.createElement("div", _extends({

package/es/components/RadioButton/RadioButton.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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 { ReactNodeLike } from 'prop-types';
+import React from 'react';
+type ExcludedAttributes = 'onChange';
+export interface RadioButtonProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, ExcludedAttributes> {
+    /**
+     * Specify whether the `<RadioButton>` is currently checked
+     */
+    checked?: boolean;
+    /**
+     * Provide an optional className to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * Specify whether the `<RadioButton>` should be checked by default
+     */
+    defaultChecked?: boolean;
+    /**
+     * Specify whether the control is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Specify whether the label should be hidden, or not
+     */
+    hideLabel?: boolean;
+    /**
+     * Provide a unique id for the underlying `<input>` node
+     */
+    id?: string;
+    /**
+     * Provide where label text should be placed
+     * NOTE: `top`/`bottom` are deprecated
+     */
+    labelPosition?: 'left' | 'right';
+    /**
+     * Provide label text to be read by screen readers when interacting with the
+     * control
+     */
+    labelText: ReactNodeLike;
+    /**
+     * Provide a name for the underlying `<input>` node
+     */
+    name?: string;
+    /**
+     * Provide an optional `onChange` hook that is called each time the value of
+     * the underlying `<input>` changes
+     */
+    onChange?: (value: string | number, name: string | undefined, event: any) => void;
+    /**
+     * Provide a handler that is invoked when a user clicks on the control
+     */
+    onClick?: (evt: React.MouseEvent<HTMLInputElement>) => void;
+    /**
+     * Specify the value of the `<RadioButton>`
+     */
+    value?: string | number;
+}
+declare const RadioButton: React.ForwardRefExoticComponent<RadioButtonProps & React.RefAttributes<unknown>>;
+export default RadioButton;