@carbon/react 1.32.0 → 1.33.0

package/lib/components/Tag/Tag.js

@@ -51,6 +51,7 @@ const Tag = _ref => {
     disabled,
     onClose,
     size,
+    as: BaseComponent,
     ...other
   } = _ref;
   const prefix = usePrefix.usePrefix();
@@ -71,7 +72,8 @@ const Tag = _ref => {
     }
   };
   if (filter) {
-    return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({
+    const ComponentTag = BaseComponent ?? 'div';
+    return /*#__PURE__*/React__default["default"].createElement(ComponentTag, _rollupPluginBabelHelpers["extends"]({
       className: tagClasses,
       id: tagId
     }, other), /*#__PURE__*/React__default["default"].createElement("span", {
@@ -86,7 +88,7 @@ const Tag = _ref => {
       title: title
     }, _Close || (_Close = /*#__PURE__*/React__default["default"].createElement(iconsReact.Close, null))));
   }
-  const ComponentTag = other.onClick ? 'button' : 'div';
+  const ComponentTag = BaseComponent ?? (other.onClick ? 'button' : 'div');
   return /*#__PURE__*/React__default["default"].createElement(ComponentTag, _rollupPluginBabelHelpers["extends"]({
     disabled: ComponentTag === 'button' ? disabled : null,
     className: tagClasses,
@@ -98,6 +100,11 @@ const Tag = _ref => {
   }, children !== null && children !== undefined ? children : TYPES[type]));
 };
 Tag.propTypes = {
+  /**
+   * Provide an alternative tag or component to use instead of the default
+   * wrapping element
+   */
+  as: PropTypes__default["default"].elementType,
   /**
    * Provide content to be rendered inside of a <Tag>
    */

package/lib/components/TextArea/TextArea.js

@@ -71,7 +71,7 @@ const TextArea = /*#__PURE__*/React__default["default"].forwardRef((props, forwa
       if (!other.disabled && onChange) {
         // delay textCount assignation to give the textarea element value time to catch up if is a controlled input
         setTimeout(() => {
-          setTextCount(evt.target.value?.length);
+          setTextCount(evt.target?.value?.length);
         }, 0);
         onChange(evt);
       }

package/lib/components/Toggle/Toggle.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Copyright IBM Corp. 2021, 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, { KeyboardEventHandler, MouseEventHandler } from 'react';
+import PropTypes from 'prop-types';
+type ExcludedAttributes = 'aria-labelledby' | 'aria-checked' | 'type' | 'role' | 'id' | 'size' | 'onClick';
+export interface ToggleProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, ExcludedAttributes> {
+    /**
+     * Specify another element's id to be used as the label for this toggle
+     */
+    'aria-labelledby'?: string;
+    /**
+     * Provide an id that unique represents the underlying `<button>`
+     */
+    id: string;
+    /**
+     * Specify the label for the "off" position
+     */
+    labelA?: string | undefined;
+    /**
+     * Specify the label for the "on" position
+     */
+    labelB?: string | undefined;
+    /**
+     * Provide the text that will be read by a screen reader when visiting this
+     * 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?: string | undefined;
+    /**
+     * If true, the side labels (props.labelA and props.labelB) will be replaced by
+     * props.labelText (if passed), so that the toggle doesn't render a top label.
+     */
+    hideLabel?: boolean;
+    /**
+     * Provide an event listener that is called when the control is toggled
+     */
+    onClick: MouseEventHandler<HTMLDivElement> | KeyboardEventHandler<HTMLDivElement> | undefined;
+    /**
+     * Provide an event listener that is called when the control is toggled
+     */
+    onToggle?(checked: boolean): void;
+    /**
+     * Specify the size of the Toggle. Currently only supports 'sm' or 'md' (default)
+     */
+    size?: 'sm' | 'md' | undefined;
+    /**
+     * Whether the toggle should be read-only
+     */
+    readOnly?: boolean | undefined;
+    /**
+     * Specify whether the toggle should be on by default
+     */
+    defaultToggled?: boolean | undefined;
+    /**
+     * Specify whether the control is toggled
+     */
+    toggled?: boolean | undefined;
+}
+export declare function Toggle({ 'aria-labelledby': ariaLabelledby, className, defaultToggled, disabled, hideLabel, id, labelA, labelB, labelText, onClick, onToggle, readOnly, size, toggled, ...other }: ToggleProps): JSX.Element;
+export declare namespace Toggle {
+    var propTypes: {
+        /**
+         * Specify another element's id to be used as the label for this toggle
+         */
+        'aria-labelledby': PropTypes.Requireable<string>;
+        /**
+         * Specify a custom className to apply to the form-item node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the toggle should be on by default
+         */
+        defaultToggled: PropTypes.Requireable<boolean>;
+        /**
+         * Whether this control should be disabled
+         */
+        disabled: PropTypes.Requireable<boolean>;
+        /**
+         * If true, the side labels (props.labelA and props.labelB) will be replaced by
+         * props.labelText (if passed), so that the toggle doesn't render a top label.
+         */
+        hideLabel: PropTypes.Requireable<boolean>;
+        /**
+         * Provide an id that unique represents the underlying `<button>`
+         */
+        id: PropTypes.Validator<string>;
+        /**
+         * Specify the label for the "off" position
+         */
+        labelA: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Specify the label for the "on" position
+         */
+        labelB: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        /**
+         * Provide the text that will be read by a screen reader when visiting this
+         * 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: PropTypes.Requireable<string>;
+        /**
+         * Provide an event listener that is called when the control is clicked
+         */
+        onClick: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Provide an event listener that is called when the control is toggled
+         */
+        onToggle: PropTypes.Requireable<(...args: any[]) => any>;
+        /**
+         * Whether the toggle should be read-only
+         */
+        readOnly: PropTypes.Requireable<boolean>;
+        /**
+         * Specify the size of the Toggle. Currently only supports 'sm' or 'md' (default)
+         */
+        size: PropTypes.Requireable<string>;
+        /**
+         * Specify whether the control is toggled
+         */
+        toggled: PropTypes.Requireable<boolean>;
+    };
+}
+export default Toggle;

package/lib/components/Toggle/Toggle.js

@@ -88,7 +88,7 @@ function Toggle(_ref) {
           handleClick(e);
           buttonElement.current.focus();
         }
-      } : null
+      } : undefined
     }, /*#__PURE__*/React__default["default"].createElement("button", _rollupPluginBabelHelpers["extends"]({}, other, {
       ref: buttonElement,
       id: id,
@@ -100,7 +100,7 @@ function Toggle(_ref) {
       disabled: disabled,
       onClick: handleClick
     })), /*#__PURE__*/React__default["default"].createElement(LabelComponent, {
-      htmlFor: ariaLabelledby ? null : id,
+      htmlFor: ariaLabelledby ? undefined : id,
       className: `${prefix}--toggle__label`
     }, labelText && /*#__PURE__*/React__default["default"].createElement("span", {
       className: labelTextClasses

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

@@ -0,0 +1,11 @@
+/**
+ * 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 { default as Toggle, ToggleProps } from './Toggle';
+export * from './Toggle.Skeleton';
+export default Toggle;
+export { Toggle };
+export type { ToggleProps };

package/lib/components/UIShell/HeaderMenu.js

@@ -36,6 +36,9 @@ class HeaderMenu extends React__default["default"].Component {
   constructor(props) {
     super(props);
     _rollupPluginBabelHelpers.defineProperty(this, "_subMenus", /*#__PURE__*/React__default["default"].createRef());
+    /**
+     * Toggle the expanded state of the menu on click.
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "handleOnClick", e => {
       const {
         current: subMenusNode
@@ -47,6 +50,9 @@ class HeaderMenu extends React__default["default"].Component {
         expanded: !prevState.expanded
       }));
     });
+    /**
+     * Keyboard event handler for the entire menu.
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "handleOnKeyDown", event => {
       // Handle enter or space key for toggling the expanded state of the menu.
       if (match.matches(event, [keys.Enter, keys.Space])) {
@@ -58,6 +64,11 @@ class HeaderMenu extends React__default["default"].Component {
         return;
       }
     });
+    /**
+     * Handle our blur event from our underlying menuitems. Will mostly be used
+     * for toggling the expansion status of our menu in response to a user
+     * clicking off of the menu or menubar.
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "handleOnBlur", event => {
       // Rough guess for a blur event that is triggered outside of our menu or
       // menubar context
@@ -70,12 +81,24 @@ class HeaderMenu extends React__default["default"].Component {
         selectedIndex: null
       });
     });
+    /**
+     * ref handler for our menu button. If we are supplied a `focusRef` prop, we also
+     * forward along the node.
+     *
+     * This is useful when this component is a child in a
+     * menu or menubar as it will allow the parent to explicitly focus the menu
+     * button node when that child should receive focus.
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "handleMenuButtonRef", node => {
       if (this.props.focusRef) {
         this.props.focusRef(node);
       }
       this.menuButtonRef = node;
     });
+    /**
+     * Handles individual menuitem refs. We assign them to a class instance
+     * property so that we can properly manage focus of our children.
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "handleItemRef", index => node => {
       this.items[index] = node;
     });
@@ -94,6 +117,12 @@ class HeaderMenu extends React__default["default"].Component {
         return;
       }
     });
+    /**
+     * We capture the `ref` for each child inside of `this.items` to properly
+     * manage focus. In addition to this focus management, all items receive a
+     * `tabIndex: -1` so the user won't hit a large number of items in their tab
+     * sequence when they might not want to go through all the items.
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "_renderMenuItem", (item, index) => {
       if ( /*#__PURE__*/React__default["default"].isValidElement(item)) {
         return /*#__PURE__*/React__default["default"].cloneElement(item, {
@@ -110,35 +139,6 @@ class HeaderMenu extends React__default["default"].Component {
     };
     this.items = [];
   }
-
-  /**
-   * Toggle the expanded state of the menu on click.
-   */
-
-  /**
-   * Keyboard event handler for the entire menu.
-   */
-
-  /**
-   * Handle our blur event from our underlying menuitems. Will mostly be used
-   * for toggling the expansion status of our menu in response to a user
-   * clicking off of the menu or menubar.
-   */
-
-  /**
-   * ref handler for our menu button. If we are supplied a `focusRef` prop, we also
-   * forward along the node.
-   *
-   * This is useful when this component is a child in a
-   * menu or menubar as it will allow the parent to explicitly focus the menu
-   * button node when that child should receive focus.
-   */
-
-  /**
-   * Handles individual menuitem refs. We assign them to a class instance
-   * property so that we can properly manage focus of our children.
-   */
-
   render() {
     const prefix = this.context;
     const {
@@ -201,13 +201,6 @@ class HeaderMenu extends React__default["default"].Component {
       className: `${prefix}--header__menu`
     }), React__default["default"].Children.map(children, this._renderMenuItem)));
   }
-
-  /**
-   * We capture the `ref` for each child inside of `this.items` to properly
-   * manage focus. In addition to this focus management, all items receive a
-   * `tabIndex: -1` so the user won't hit a large number of items in their tab
-   * sequence when they might not want to go through all the items.
-   */
 }
 _rollupPluginBabelHelpers.defineProperty(HeaderMenu, "propTypes", {
   /**

package/lib/components/UIShell/HeaderMenuButton.d.ts

@@ -28,6 +28,10 @@ declare namespace HeaderMenuButton {
          * Specify whether the menu button is "active".
          */
         isActive: PropTypes.Requireable<boolean>;
+        /**
+         * Specify whether the menu button is collapsible.
+         */
+        isCollapsible: PropTypes.Requireable<boolean>;
         /**
          * Optionally provide an onClick handler that is called when the underlying
          * button fires it's onclick event

package/lib/components/UIShell/HeaderMenuButton.js

@@ -74,6 +74,10 @@ HeaderMenuButton.propTypes = {
    * Specify whether the menu button is "active".
    */
   isActive: PropTypes__default["default"].bool,
+  /**
+   * Specify whether the menu button is collapsible.
+   */
+  isCollapsible: PropTypes__default["default"].bool,
   /**
    * Optionally provide an onClick handler that is called when the underlying
    * button fires it's onclick event

package/lib/components/UIShell/HeaderName.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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 { type ElementType } from 'react';
+import PropTypes from 'prop-types';
+import { type LinkProps } from './Link';
+type HeaderNameProps<E extends ElementType> = LinkProps<E> & {
+    prefix?: string | undefined;
+};
+declare function HeaderName<E extends ElementType = 'a'>({ children, className: customClassName, prefix, ...rest }: HeaderNameProps<E>): JSX.Element;
+declare namespace HeaderName {
+    var propTypes: {
+        /**
+         * Pass in children that are either a string or can be read as a string by
+         * screen readers
+         */
+        children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        /**
+         * Optionally provide a custom class to apply to the underlying `<li>` node
+         */
+        className: PropTypes.Requireable<string>;
+        /**
+         * Provide an href for the name to link to
+         */
+        href: PropTypes.Requireable<string>;
+        /**
+         * Optionally specify a prefix to your header name. Useful for companies, for
+         * example: IBM [Product Name] versus solely [Product Name]
+         */
+        prefix: PropTypes.Requireable<string>;
+        as: PropTypes.Requireable<PropTypes.ReactComponentLike>;
+        element: (props: any, propName: any, componentName: any, ...rest: any[]) => any;
+        isSideNavExpanded: PropTypes.Requireable<boolean>;
+    };
+}
+export default HeaderName;

package/lib/components/UIShell/HeaderName.js

@@ -26,15 +26,13 @@ function HeaderName(_ref) {
   let {
     children,
     className: customClassName,
-    prefix,
-    href,
+    prefix = 'IBM',
     ...rest
   } = _ref;
   const selectorPrefix = usePrefix.usePrefix();
   const className = cx__default["default"](`${selectorPrefix}--header__name`, customClassName);
   return /*#__PURE__*/React__default["default"].createElement(Link["default"], _rollupPluginBabelHelpers["extends"]({}, rest, {
-    className: className,
-    href: href
+    className: className
   }), prefix && /*#__PURE__*/React__default["default"].createElement(React__default["default"].Fragment, null, /*#__PURE__*/React__default["default"].createElement("span", {
     className: `${selectorPrefix}--header__name--prefix`
   }, prefix), "\xA0"), children);
@@ -64,8 +62,5 @@ HeaderName.propTypes = {
    */
   prefix: PropTypes__default["default"].string
 };
-HeaderName.defaultProps = {
-  prefix: 'IBM'
-};
 
 exports["default"] = HeaderName;

package/lib/components/UIShell/HeaderPanel.js

@@ -49,7 +49,7 @@ const HeaderPanel = /*#__PURE__*/React__default["default"].forwardRef(function H
   const eventHandlers = {};
   if (addFocusListeners) {
     eventHandlers.onBlur = event => {
-      if (!event.currentTarget.contains(event.relatedTarget) && !lastClickedElement.classList.contains('cds--switcher__item-link')) {
+      if (!event.currentTarget.contains(event.relatedTarget) && !lastClickedElement?.classList?.contains('cds--switcher__item-link')) {
         setExpandedState(false);
         setLastClickedElement(null);
         if (expanded) {
@@ -70,7 +70,7 @@ const HeaderPanel = /*#__PURE__*/React__default["default"].forwardRef(function H
   useEvent.useWindowEvent('click', () => {
     const focusedElement = document.activeElement;
     setLastClickedElement(focusedElement);
-    if (children.type.__docgenInfo.displayName === 'Switcher' && !focusedElement?.closest(`.${prefix}--header-panel--expanded`) && !focusedElement?.closest(`.${prefix}--header__action`) && !headerPanelRef?.current?.classList.contains(`${prefix}--switcher`) && expanded) {
+    if (children.type?.displayName === 'Switcher' && !focusedElement?.closest(`.${prefix}--header-panel--expanded`) && !focusedElement?.closest(`.${prefix}--header__action`) && !headerPanelRef?.current?.classList.contains(`${prefix}--switcher`) && expanded) {
       setExpandedState(false);
       onHeaderPanelFocus();
     }

package/lib/components/UIShell/Link.js

@@ -64,6 +64,7 @@ const LinkPropTypes = {
 };
 Link.displayName = 'Link';
 Link.propTypes = LinkPropTypes;
+var Link$1 = Link;
 
 exports.LinkPropTypes = LinkPropTypes;
-exports["default"] = Link;
+exports["default"] = Link$1;

package/lib/components/UIShell/Switcher.js

@@ -67,12 +67,23 @@ const Switcher = /*#__PURE__*/React__default["default"].forwardRef(function Swit
     const switcherItem = switcherRef.current.children[nextValidIndex].children[0];
     switcherItem?.focus();
   };
-  const childrenWithProps = React__default["default"].Children.toArray(children).map((child, index) => /*#__PURE__*/React__default["default"].cloneElement(child, {
-    handleSwitcherItemFocus,
-    index,
-    key: index,
-    expanded
-  }));
+  const childrenWithProps = React__default["default"].Children.toArray(children).map((child, index) => {
+    // handleSwitcherItemFocus should only be passed down if the child is a SwitcherItem
+    // SwitcherDivider, for example, does not accept a handleSwitcherItemFocus prop
+    if (child.type?.displayName === 'SwitcherItem') {
+      return /*#__PURE__*/React__default["default"].cloneElement(child, {
+        handleSwitcherItemFocus,
+        index,
+        key: index,
+        expanded
+      });
+    }
+    return /*#__PURE__*/React__default["default"].cloneElement(child, {
+      index,
+      key: index,
+      expanded
+    });
+  });
   return /*#__PURE__*/React__default["default"].createElement("ul", _rollupPluginBabelHelpers["extends"]({
     ref: ref,
     className: className

package/lib/index.js

@@ -63,6 +63,7 @@ var TextArea_Skeleton = require('./components/TextArea/TextArea.Skeleton.js');
 require('./components/TextInput/index.js');
 var Tile = require('./components/Tile/Tile.js');
 var index$a = require('./components/TileGroup/index.js');
+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$b = require('./components/Toggletip/index.js');
@@ -114,7 +115,6 @@ var NumberInput_Skeleton = require('./components/NumberInput/NumberInput.Skeleto
 var ProgressIndicator_Skeleton = require('./components/ProgressIndicator/ProgressIndicator.Skeleton.js');
 var TextInput_Skeleton = require('./components/TextInput/TextInput.Skeleton.js');
 var TextInput = require('./components/TextInput/TextInput.js');
-var Toggle = require('./components/Toggle/Toggle.js');
 var TreeNode = require('./components/TreeView/TreeNode.js');
 var TreeView = require('./components/TreeView/TreeView.js');
 var HeaderContainer = require('./components/UIShell/HeaderContainer.js');
@@ -296,6 +296,7 @@ exports.Tile = Tile.Tile;
 exports.TileAboveTheFoldContent = Tile.TileAboveTheFoldContent;
 exports.TileBelowTheFoldContent = Tile.TileBelowTheFoldContent;
 exports.TileGroup = index$a["default"];
+exports.Toggle = Toggle.Toggle;
 exports.ToggleSkeleton = Toggle_Skeleton["default"];
 exports.ToggleSmallSkeleton = ToggleSmall_Skeleton["default"];
 exports.Toggletip = index$b.Toggletip;
@@ -360,7 +361,6 @@ exports.NumberInputSkeleton = NumberInput_Skeleton["default"];
 exports.ProgressIndicatorSkeleton = ProgressIndicator_Skeleton["default"];
 exports.TextInputSkeleton = TextInput_Skeleton["default"];
 exports.TextInput = TextInput["default"];
-exports.Toggle = Toggle.Toggle;
 exports.TreeNode = TreeNode["default"];
 exports.TreeView = TreeView["default"];
 exports.HeaderContainer = HeaderContainer["default"];

package/lib/internal/FloatingMenu.js

@@ -153,6 +153,7 @@ class FloatingMenu extends React__default["default"].Component {
     var _this;
     super(...arguments);
     _this = this;
+    // `true` if the menu body is mounted and calculation of the position is in progress.
     _rollupPluginBabelHelpers.defineProperty(this, "_placeInProgress", false);
     _rollupPluginBabelHelpers.defineProperty(this, "state", {
       /**
@@ -161,10 +162,36 @@ class FloatingMenu extends React__default["default"].Component {
        */
       floatingPosition: undefined
     });
+    /**
+     * The cached reference to the menu container.
+     * Only used if React portal API is not available.
+     * @type {Element}
+     * @private
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "_menuContainer", null);
+    /**
+     * The cached reference to the menu body.
+     * The reference is set via callback ref instead of object ref,
+     * in order to hook the event when the element ref gets available,
+     * which can be at a different timing from `cDM()`, presumably with SSR scenario.
+     * @type {Element}
+     * @private
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "_menuBody", null);
+    /**
+     * Focus sentinel refs for focus trap behavior
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "startSentinel", /*#__PURE__*/React__default["default"].createRef());
     _rollupPluginBabelHelpers.defineProperty(this, "endSentinel", /*#__PURE__*/React__default["default"].createRef());
+    /**
+     * Calculates the position in the viewport of floating menu,
+     * once this component is mounted or updated upon change in the following props:
+     *
+     * * `menuOffset` (The adjustment that should be applied to the calculated floating menu's position)
+     * * `menuDirection` (Where the floating menu menu should be placed relative to the trigger button)
+     *
+     * @private
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "_updateMenuSize", function () {
       let prevProps = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       let isAdjustment = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
@@ -238,6 +265,11 @@ class FloatingMenu extends React__default["default"].Component {
         }
       }
     });
+    /**
+     * Set focus on floating menu content after menu placement.
+     * @param {Element} menuBody The DOM element of the menu body.
+     * @private
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "_focusMenuContent", menuBody => {
       const primaryFocusNode = menuBody.querySelector(this.props.selectorPrimaryFocus || null);
       const tabbableNode = menuBody.querySelector(navigation.selectorTabbable);
@@ -254,6 +286,10 @@ class FloatingMenu extends React__default["default"].Component {
         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;
       }
     });
+    /**
+     * A callback for called when menu body is mounted or unmounted.
+     * @param {Element} menuBody The menu body being mounted. `null` if the menu body is being unmounted.
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "_menuRef", menuBody => {
       const {
         menuRef
@@ -264,6 +300,10 @@ class FloatingMenu extends React__default["default"].Component {
         this._updateMenuSize();
       }
     });
+    /**
+     * @returns The child nodes, with styles containing the floating menu position.
+     * @private
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "_getChildrenWithProps", () => {
       const {
         styles,
@@ -292,6 +332,12 @@ class FloatingMenu extends React__default["default"].Component {
         }
       });
     });
+    /**
+     * Blur handler for when focus wrap behavior is enabled
+     * @param {Event} event
+     * @param {Element} event.target previously focused node
+     * @param {Element} event.relatedTarget current focused node
+     */
     _rollupPluginBabelHelpers.defineProperty(this, "handleBlur", _ref2 => {
       let {
         target: oldActiveNode,
@@ -313,33 +359,7 @@ class FloatingMenu extends React__default["default"].Component {
         });
       }
     });
-  } // `true` if the menu body is mounted and calculation of the position is in progress.
-  /**
-   * The cached reference to the menu container.
-   * Only used if React portal API is not available.
-   * @type {Element}
-   * @private
-   */
-  /**
-   * The cached reference to the menu body.
-   * The reference is set via callback ref instead of object ref,
-   * in order to hook the event when the element ref gets available,
-   * which can be at a different timing from `cDM()`, presumably with SSR scenario.
-   * @type {Element}
-   * @private
-   */
-  /**
-   * Focus sentinel refs for focus trap behavior
-   */
-  /**
-   * Calculates the position in the viewport of floating menu,
-   * once this component is mounted or updated upon change in the following props:
-   *
-   * * `menuOffset` (The adjustment that should be applied to the calculated floating menu's position)
-   * * `menuDirection` (Where the floating menu menu should be placed relative to the trigger button)
-   *
-   * @private
-   */
+  }
   componentWillUnmount() {
     this.hResize.release();
   }
@@ -348,12 +368,6 @@ class FloatingMenu extends React__default["default"].Component {
       this._updateMenuSize();
     });
   }
-  /**
-   * Set focus on floating menu content after menu placement.
-   * @param {Element} menuBody The DOM element of the menu body.
-   * @private
-   */
-
   componentDidUpdate(prevProps) {
     this._updateMenuSize(prevProps);
     const {
@@ -369,24 +383,6 @@ class FloatingMenu extends React__default["default"].Component {
       }
     }
   }
-
-  /**
-   * A callback for called when menu body is mounted or unmounted.
-   * @param {Element} menuBody The menu body being mounted. `null` if the menu body is being unmounted.
-   */
-
-  /**
-   * @returns The child nodes, with styles containing the floating menu position.
-   * @private
-   */
-
-  /**
-   * Blur handler for when focus wrap behavior is enabled
-   * @param {Event} event
-   * @param {Element} event.target previously focused node
-   * @param {Element} event.relatedTarget current focused node
-   */
-
   render() {
     const {
       context: prefix