@carbon/react 1.110.0-rc.0 → 1.111.0-rc.0

package/lib/components/ListBox/ListBoxMenu.js

@@ -37,12 +37,18 @@ const ListBoxMenu = (0, react.forwardRef)(({ children, id, ...rest }, ref) => {
 });
 ListBoxMenu.displayName = "ListBoxMenu";
 ListBoxMenu.propTypes = {
+	/**
+	* Provide the contents of your ListBoxMenu
+	*/
 	children: prop_types.default.oneOfType([
 		prop_types.default.node,
 		prop_types.default.arrayOf(prop_types.default.oneOf([require_ListBoxMenuItem.default])),
 		prop_types.default.shape({ type: prop_types.default.oneOf([require_ListBoxMenuItem.default]) }),
 		prop_types.default.bool
 	]),
+	/**
+	* Specify a custom `id`
+	*/
 	id: prop_types.default.string.isRequired
 };
 //#endregion

package/lib/components/ListBox/ListBoxMenuIcon.js

@@ -51,7 +51,14 @@ const ListBoxMenuIcon = ({ isOpen, translateWithId: t = defaultTranslateWithId }
 	});
 };
 ListBoxMenuIcon.propTypes = {
+	/**
+	* Specify whether the menu is currently open, which will influence the
+	* direction of the menu icon
+	*/
 	isOpen: prop_types.default.bool.isRequired,
+	/**
+	* Translates component strings using your i18n tool.
+	*/
 	translateWithId: prop_types.default.func
 };
 //#endregion

package/lib/components/ListBox/ListBoxMenuItem.js

@@ -73,10 +73,26 @@ const ListBoxMenuItem = (0, react.forwardRef)(({ children, isActive = false, isH
 });
 ListBoxMenuItem.displayName = "ListBoxMenuItem";
 ListBoxMenuItem.propTypes = {
+	/**
+	* Specify any children nodes that should be rendered inside of the ListBox
+	* Menu Item
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify if the item should be disabled
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Specify whether the current menu item is "active".
+	*/
 	isActive: prop_types.default.bool,
+	/**
+	* Specify whether the current menu item is "highlighted".
+	*/
 	isHighlighted: prop_types.default.bool,
+	/**
+	* Provide an optional tooltip for the ListBoxMenuItem
+	*/
 	title: prop_types.default.string
 };
 //#endregion

package/lib/components/ListBox/ListBoxSelection.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/ListBox/ListBoxSelection.js

@@ -17,7 +17,7 @@ let react_jsx_runtime = require("react/jsx-runtime");
 let _carbon_icons_react = require("@carbon/icons-react");
 //#region src/components/ListBox/ListBoxSelection.tsx
 /**
-* Copyright IBM Corp. 2016, 2025
+* Copyright IBM Corp. 2016, 2026
 *
 * This source code is licensed under the Apache-2.0 license found in the
 * LICENSE file in the root directory of this source tree.
@@ -27,7 +27,7 @@ const translationIds = {
 	"clear.selection": "clear.selection"
 };
 const defaultTranslations = {
-	[translationIds["clear.all"]]: "Clear all selected items",
+	[translationIds["clear.all"]]: "Clear selected items",
 	[translationIds["clear.selection"]]: "Clear selected item"
 };
 const defaultTranslateWithId = (messageId) => {
@@ -40,9 +40,11 @@ const defaultTranslateWithId = (messageId) => {
 */
 const ListBoxSelection = ({ clearSelection, selectionCount, translateWithId: t = defaultTranslateWithId, disabled, onClearSelection, readOnly }) => {
 	const prefix = require_usePrefix.usePrefix();
+	const hasSelectionCount = (selectionCount ?? 0) > 0;
+	const hasMultipleSelections = (selectionCount ?? 0) > 1;
 	const className = (0, classnames.default)(`${prefix}--list-box__selection`, {
-		[`${prefix}--tag--filter`]: selectionCount,
-		[`${prefix}--list-box__selection--multi`]: selectionCount
+		[`${prefix}--tag--filter`]: hasSelectionCount,
+		[`${prefix}--list-box__selection--multi`]: hasSelectionCount
 	});
 	const handleOnClick = (event) => {
 		event.stopPropagation();
@@ -50,9 +52,9 @@ const ListBoxSelection = ({ clearSelection, selectionCount, translateWithId: t =
 		clearSelection(event);
 		if (onClearSelection) onClearSelection(event);
 	};
-	const description = selectionCount ? t("clear.all") : t("clear.selection");
+	const description = hasMultipleSelections ? t("clear.all") : t("clear.selection");
 	const tagClasses = (0, classnames.default)(`${prefix}--tag`, `${prefix}--tag--filter`, `${prefix}--tag--high-contrast`, { [`${prefix}--tag--disabled`]: disabled });
-	return selectionCount ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+	return hasSelectionCount ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: tagClasses,
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 			className: `${prefix}--tag__label`,
@@ -63,27 +65,48 @@ const ListBoxSelection = ({ clearSelection, selectionCount, translateWithId: t =
 			tabIndex: -1,
 			className: `${prefix}--tag__close-icon`,
 			onClick: handleOnClick,
-			"aria-label": t("clear.all"),
+			"aria-label": description,
 			title: description,
 			"aria-disabled": readOnly ? true : void 0,
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_carbon_icons_react.Close, {})
 		})]
-	}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+	}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		role: "button",
 		className,
 		tabIndex: -1,
 		onClick: handleOnClick,
 		"aria-label": description,
 		title: description,
-		children: [selectionCount, /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_carbon_icons_react.Close, {})]
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_carbon_icons_react.Close, {})
 	});
 };
 ListBoxSelection.propTypes = {
+	/**
+	* Specify a function to be invoked when a user interacts with the clear
+	* selection element.
+	*/
 	clearSelection: prop_types.default.func.isRequired,
+	/**
+	* Specify whether or not the clear selection element should be disabled
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Specify an optional `onClearSelection` handler that is called when the underlying
+	* element is cleared
+	*/
 	onClearSelection: prop_types.default.func,
+	/**
+	* Whether or not the Dropdown is readonly
+	*/
 	readOnly: prop_types.default.bool,
+	/**
+	* Specify an optional `selectionCount` value that will be used to determine
+	* whether the selection should display a badge or a single clear icon.
+	*/
 	selectionCount: prop_types.default.number,
+	/**
+	* Translates component strings using your i18n tool.
+	*/
 	translateWithId: prop_types.default.func
 };
 //#endregion

package/lib/components/ListBox/next/ListBoxSelection.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2025
+ * Copyright IBM Corp. 2016, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.

package/lib/components/ListBox/next/ListBoxSelection.js

@@ -17,7 +17,7 @@ let react_jsx_runtime = require("react/jsx-runtime");
 let _carbon_icons_react = require("@carbon/icons-react");
 //#region src/components/ListBox/next/ListBoxSelection.tsx
 /**
-* Copyright IBM Corp. 2016, 2025
+* Copyright IBM Corp. 2016, 2026
 *
 * This source code is licensed under the Apache-2.0 license found in the
 * LICENSE file in the root directory of this source tree.
@@ -32,7 +32,7 @@ const translationIds = {
 	"clear.selection": "clear.selection"
 };
 const defaultTranslations = {
-	[translationIds["clear.all"]]: "Clear all selected items",
+	[translationIds["clear.all"]]: "Clear selected items",
 	[translationIds["clear.selection"]]: "Clear selected item"
 };
 const defaultTranslateWithId = (messageId) => {
@@ -40,11 +40,13 @@ const defaultTranslateWithId = (messageId) => {
 };
 function ListBoxSelection({ clearSelection, selectionCount, translateWithId: t = defaultTranslateWithId, disabled, readOnly, onClearSelection, ...rest }) {
 	const prefix = require_usePrefix.usePrefix();
+	const hasSelectionCount = (selectionCount ?? 0) > 0;
+	const hasMultipleSelections = (selectionCount ?? 0) > 1;
 	const className = (0, classnames.default)(`${prefix}--list-box__selection`, {
-		[`${prefix}--tag--filter`]: selectionCount,
-		[`${prefix}--list-box__selection--multi`]: selectionCount
+		[`${prefix}--tag--filter`]: hasSelectionCount,
+		[`${prefix}--list-box__selection--multi`]: hasSelectionCount
 	});
-	const description = selectionCount ? t("clear.all") : t("clear.selection");
+	const description = hasMultipleSelections ? t("clear.all") : t("clear.selection");
 	const tagClasses = (0, classnames.default)(`${prefix}--tag`, `${prefix}--tag--filter`, `${prefix}--tag--high-contrast`, { [`${prefix}--tag--disabled`]: disabled });
 	function onClick(event) {
 		event.stopPropagation();
@@ -52,7 +54,7 @@ function ListBoxSelection({ clearSelection, selectionCount, translateWithId: t =
 		clearSelection(event);
 		if (onClearSelection) onClearSelection(event);
 	}
-	if (selectionCount) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+	if (hasSelectionCount) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: tagClasses,
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 			className: `${prefix}--tag__label`,
@@ -84,14 +86,47 @@ function ListBoxSelection({ clearSelection, selectionCount, translateWithId: t =
 	});
 }
 ListBoxSelection.propTypes = {
+	/**
+	* Specify a function to be invoked when a user interacts with the clear
+	* selection element.
+	*/
 	clearSelection: prop_types.default.func.isRequired,
+	/**
+	* Specify whether or not the clear selection element should be disabled
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Whether or not the listbox is readonly
+	*/
 	readOnly: prop_types.default.bool,
+	/**
+	* Specify an optional `onClearSelection` handler that is called when the underlying
+	* element is cleared
+	*/
 	onClearSelection: prop_types.default.func,
+	/**
+	* Specify an optional `onClick` handler that is called when the underlying
+	* clear selection element is clicked
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* Specify an optional `onClick` handler that is called when the underlying
+	* clear selection element is clicked
+	*/
 	onMouseUp: prop_types.default.func,
+	/**
+	* Specify an optional `onKeyDown` handler that is called when the underlying
+	* clear selection element fires a keydown event
+	*/
 	onKeyDown: prop_types.default.func,
+	/**
+	* Specify an optional `selectionCount` value that will be used to determine
+	* whether the selection should display a badge or a single clear icon.
+	*/
 	selectionCount: prop_types.default.number,
+	/**
+	* Translates component strings using your i18n tool.
+	*/
 	translateWithId: prop_types.default.func
 };
 //#endregion

package/lib/components/ListBox/next/ListBoxTrigger.js

@@ -56,7 +56,14 @@ const ListBoxTrigger = react.default.forwardRef(({ isOpen, translateWithId: t =
 	});
 });
 ListBoxTrigger.propTypes = {
+	/**
+	* Specify whether the menu is currently open, which will influence the
+	* direction of the menu icon
+	*/
 	isOpen: prop_types.default.bool.isRequired,
+	/**
+	* Translates component strings using your i18n tool.
+	*/
 	translateWithId: prop_types.default.func
 };
 //#endregion

package/lib/components/ListItem/ListItem.js

@@ -31,7 +31,13 @@ function ListItem({ className, children, ...other }) {
 	});
 }
 ListItem.propTypes = {
+	/**
+	* Specify the content for the ListItem
+	*/
 	children: prop_types.default.node,
+	/**
+	* Specify an optional className to apply to the underlying `<li>` node
+	*/
 	className: prop_types.default.string
 };
 //#endregion

package/lib/components/Loading/Loading.js

@@ -66,11 +66,29 @@ function Loading({ active = true, className: customClassName, withOverlay = true
 	}) : loading;
 }
 Loading.propTypes = {
+	/**
+	* Specify whether you want the loading indicator to be spinning or not
+	*/
 	active: prop_types.default.bool,
+	/**
+	* Provide an optional className to be applied to the containing node
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify a description that would be used to best describe the loading state
+	*/
 	description: prop_types.default.string,
+	/**
+	* Provide an `id` to uniquely identify the label
+	*/
 	id: require_deprecate.deprecate(prop_types.default.string, `\nThe prop \`id\` is no longer needed.`),
+	/**
+	* Specify whether you would like the small variant of <Loading>
+	*/
 	small: prop_types.default.bool,
+	/**
+	* Specify whether you want the loader to be applied with an overlay
+	*/
 	withOverlay: prop_types.default.bool
 };
 //#endregion

package/lib/components/Menu/Menu.js

@@ -216,25 +216,77 @@ const Menu = (0, react.forwardRef)(function Menu({ backgroundToken = "layer", bo
 	return isRoot ? open && (0, react_dom.createPortal)(rendered, target) || null : rendered;
 });
 Menu.propTypes = {
+	/**
+	* Specify the background token to use. Default is 'layer'.
+	*/
 	backgroundToken: prop_types.default.oneOf(["layer", "background"]),
+	/**
+	* Specify whether a border should be rendered on the menu
+	*/
 	border: prop_types.default.bool,
+	/**
+	* A collection of MenuItems to be rendered within this Menu.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Additional CSS class names.
+	*/
 	className: prop_types.default.string,
+	/**
+	* A label describing the Menu.
+	*/
 	label: prop_types.default.string,
+	/**
+	* Specify how the menu should align with the button element
+	*/
 	menuAlignment: prop_types.default.string,
+	/**
+	* **Deprecated**: Menus now always support both icons as well as selectable items and nesting.
+	* The mode of this menu. Defaults to full.
+	* `full` supports nesting and selectable menu items, but no icons.
+	* `basic` supports icons but no nesting or selectable menu items.
+	*
+	* **This prop is not intended for use and will be set by the respective implementation (like useContextMenu, MenuButton, and ComboButton).**
+	*/
 	mode: require_deprecate.deprecate(prop_types.default.oneOf(["full", "basic"]), "Menus now always support both icons as well as selectable items and nesting."),
+	/**
+	* Provide an optional function to be called when the Menu should be closed,
+	* including if the Menu is blurred, the user presses escape, or the Menu is
+	* a submenu and the user presses ArrowLeft.
+	*/
 	onClose: prop_types.default.func,
+	/**
+	* Provide an optional function to be called when the Menu is opened.
+	*/
 	onOpen: prop_types.default.func,
+	/**
+	* Whether the Menu is open or not.
+	*/
 	open: prop_types.default.bool,
+	/**
+	* Specify the size of the Menu.
+	*/
 	size: prop_types.default.oneOf([
 		"xs",
 		"sm",
 		"md",
 		"lg"
 	]),
+	/**
+	* Specify a DOM node where the Menu should be rendered in. Defaults to document.body.
+	*/
 	target: prop_types.default.object,
+	/**
+	* Specify the x position of the Menu. Either pass a single number or an array with two numbers describing your activator's boundaries ([x1, x2])
+	*/
 	x: prop_types.default.oneOfType([prop_types.default.number, prop_types.default.arrayOf(prop_types.default.number)]),
+	/**
+	* Specify the y position of the Menu. Either pass a single number or an array with two numbers describing your activator's boundaries ([y1, y2])
+	*/
 	y: prop_types.default.oneOfType([prop_types.default.number, prop_types.default.arrayOf(prop_types.default.number)]),
+	/**
+	* @deprecated Internal compatibility flag. Use `false` to enable auto-alignment behavior.
+	*/
 	legacyAutoalign: prop_types.default.bool
 };
 //#endregion

package/lib/components/Menu/MenuContext.d.ts

@@ -5,16 +5,22 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { KeyboardEvent, RefObject } from 'react';
+type RegisterItemPayload = {
+    ref: RefObject<HTMLLIElement | null>;
+    disabled: boolean;
+};
 type ActionType = {
-    type: 'enableIcons' | 'enableSelectableItems' | 'registerItem';
-    payload: any;
+    type: 'enableIcons' | 'enableSelectableItems';
+} | {
+    type: 'registerItem';
+    payload: RegisterItemPayload;
 };
 type StateType = {
     isRoot: boolean;
     hasIcons: boolean;
     hasSelectableItems: boolean;
     size: 'xs' | 'sm' | 'md' | 'lg' | null;
-    items: any[];
+    items: RegisterItemPayload[];
     requestCloseRoot: (e: Pick<KeyboardEvent<HTMLUListElement>, 'type'>) => void;
 };
 declare function menuReducer(state: StateType, action: ActionType): {
@@ -22,19 +28,12 @@ declare function menuReducer(state: StateType, action: ActionType): {
     isRoot: boolean;
     hasSelectableItems: boolean;
     size: "xs" | "sm" | "md" | "lg" | null;
-    items: any[];
+    items: RegisterItemPayload[];
     requestCloseRoot: (e: Pick<KeyboardEvent<HTMLUListElement>, "type">) => void;
 };
-type DispatchFuncProps = {
-    type: ActionType['type'];
-    payload: {
-        ref: RefObject<HTMLLIElement | null>;
-        disabled: boolean;
-    };
-};
 type MenuContextProps = {
     state: StateType;
-    dispatch: (props: DispatchFuncProps) => void;
+    dispatch: (props: ActionType) => void;
 };
 declare const MenuContext: import("react").Context<MenuContextProps>;
 export { MenuContext, menuReducer };

package/lib/components/Menu/MenuContext.js

@@ -5,7 +5,6 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-require("../../_virtual/_rolldown/runtime.js");
 let react = require("react");
 //#region src/components/Menu/MenuContext.ts
 /**

package/lib/components/Menu/MenuItem.js

@@ -202,14 +202,41 @@ const MenuItem = (0, react.forwardRef)(function MenuItem({ children, className,
 	});
 });
 MenuItem.propTypes = {
+	/**
+	* Optionally provide another Menu to create a submenu. props.children can't be used to specify the content of the MenuItem itself. Use props.label instead.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Additional CSS class names.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify the message read by screen readers for the danger menu item variant
+	*/
 	dangerDescription: prop_types.default.string,
+	/**
+	* Specify whether the MenuItem is disabled or not.
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Specify the kind of the MenuItem.
+	*/
 	kind: prop_types.default.oneOf(["default", "danger"]),
+	/**
+	* A required label titling the MenuItem. Will be rendered as its text content.
+	*/
 	label: prop_types.default.string.isRequired,
+	/**
+	* Provide an optional function to be called when the MenuItem is clicked.
+	*/
 	onClick: prop_types.default.func,
+	/**
+	* A component used to render an icon.
+	*/
 	renderIcon: prop_types.default.oneOfType([prop_types.default.func, prop_types.default.object]),
+	/**
+	* Provide a shortcut for the action of this MenuItem. Note that the component will only render it as a hint but not actually register the shortcut.
+	*/
 	shortcut: prop_types.default.string
 };
 const MenuItemSelectable = (0, react.forwardRef)(function MenuItemSelectable({ className, defaultSelected, label, onChange, selected, ...rest }, forwardRef) {
@@ -238,10 +265,25 @@ const MenuItemSelectable = (0, react.forwardRef)(function MenuItemSelectable({ c
 	});
 });
 MenuItemSelectable.propTypes = {
+	/**
+	* Additional CSS class names.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the option should be selected by default.
+	*/
 	defaultSelected: prop_types.default.bool,
+	/**
+	* A required label titling this option.
+	*/
 	label: prop_types.default.string.isRequired,
+	/**
+	* Provide an optional function to be called when the selection state changes.
+	*/
 	onChange: prop_types.default.func,
+	/**
+	* Pass a bool to props.selected to control the state of this option.
+	*/
 	selected: prop_types.default.bool
 };
 const MenuItemGroup = (0, react.forwardRef)(function MenuItemGroup({ children, className, label, ...rest }, forwardRef) {
@@ -258,8 +300,17 @@ const MenuItemGroup = (0, react.forwardRef)(function MenuItemGroup({ children, c
 	});
 });
 MenuItemGroup.propTypes = {
+	/**
+	* A collection of MenuItems to be rendered within this group.
+	*/
 	children: prop_types.default.node,
+	/**
+	* Additional CSS class names.
+	*/
 	className: prop_types.default.string,
+	/**
+	* A required label titling this group.
+	*/
 	label: prop_types.default.string.isRequired
 };
 const MenuItemRadioGroup = (0, react.forwardRef)(function MenuItemRadioGroup({ className, defaultSelectedItem, items, itemToString = require_defaultItemToString.defaultItemToString, label, onChange, selectedItem, ...rest }, forwardRef) {
@@ -296,12 +347,33 @@ const MenuItemRadioGroup = (0, react.forwardRef)(function MenuItemRadioGroup({ c
 	});
 });
 MenuItemRadioGroup.propTypes = {
+	/**
+	* Additional CSS class names.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify the default selected item. Must match the type of props.items.
+	*/
 	defaultSelectedItem: prop_types.default.any,
+	/**
+	* Converts an item into a string for display.
+	*/
 	itemToString: prop_types.default.func,
+	/**
+	* Provide the options for this radio group. Can be of any type, as long as you provide an appropriate props.itemToString function.
+	*/
 	items: prop_types.default.array,
+	/**
+	* A required label titling this radio group.
+	*/
 	label: prop_types.default.string.isRequired,
+	/**
+	* Provide an optional function to be called when the selection changes.
+	*/
 	onChange: prop_types.default.func,
+	/**
+	* Provide props.selectedItem to control the state of this radio group. Must match the type of props.items.
+	*/
 	selectedItem: prop_types.default.any
 };
 const MenuItemDivider = (0, react.forwardRef)(function MenuItemDivider({ className, ...rest }, forwardRef) {
@@ -313,7 +385,11 @@ const MenuItemDivider = (0, react.forwardRef)(function MenuItemDivider({ classNa
 		ref: forwardRef
 	});
 });
-MenuItemDivider.propTypes = { className: prop_types.default.string };
+MenuItemDivider.propTypes = { 
+/**
+* Additional CSS class names.
+*/
+className: prop_types.default.string };
 //#endregion
 exports.MenuItem = MenuItem;
 exports.MenuItemDivider = MenuItemDivider;

package/lib/components/MenuButton/index.js

@@ -119,11 +119,29 @@ const MenuButton = (0, react.forwardRef)(({ children, className, disabled, kind
 	});
 });
 MenuButton.propTypes = {
+	/**
+	* A collection of MenuItems to be rendered as actions for this MenuButton.
+	*/
 	children: prop_types.default.node.isRequired,
+	/**
+	* Additional CSS class names.
+	*/
 	className: prop_types.default.string,
+	/**
+	* Specify whether the MenuButton should be disabled, or not.
+	*/
 	disabled: prop_types.default.bool,
+	/**
+	* Specify the type of button to be used as the base for the trigger button.
+	*/
 	kind: prop_types.default.oneOf(validButtonKinds),
+	/**
+	* Provide the label to be rendered on the trigger button.
+	*/
 	label: prop_types.default.string.isRequired,
+	/**
+	* Experimental property. Specify how the menu should align with the button element
+	*/
 	menuAlignment: prop_types.default.oneOf([
 		"top",
 		"top-start",
@@ -132,15 +150,30 @@ MenuButton.propTypes = {
 		"bottom-start",
 		"bottom-end"
 	]),
+	/**
+	* Specify the size of the button and menu.
+	*/
 	size: prop_types.default.oneOf([
 		"xs",
 		"sm",
 		"md",
 		"lg"
 	]),
+	/**
+	* Specify the tabIndex of the button.
+	*/
 	tabIndex: prop_types.default.number,
+	/**
+	* Specify the background token to use for the menu. Default is 'layer'.
+	*/
 	menuBackgroundToken: prop_types.default.oneOf(["layer", "background"]),
+	/**
+	* Specify whether a border should be rendered on the menu
+	*/
 	menuBorder: prop_types.default.bool,
+	/**
+	* Specify a DOM node where the Menu should be rendered in. Defaults to document.body.
+	*/
 	menuTarget: prop_types.default.instanceOf(typeof Element !== "undefined" ? Element : Object)
 };
 //#endregion