@carbon/react 1.42.1 → 1.44.0-rc.0

package/es/components/Breadcrumb/BreadcrumbItem.js

@@ -69,8 +69,7 @@ const BreadcrumbItem = /*#__PURE__*/React__default.forwardRef(function Breadcrum
 });
 BreadcrumbItem.displayName = 'BreadcrumbItem';
 BreadcrumbItem.propTypes = {
-  // @ts-expect-error - v12 TODO: BREAKING: This should match AriaAttributes['aria-current']
-  'aria-current': PropTypes.oneOfType([PropTypes.string, PropTypes.bool]),
+  'aria-current': PropTypes.oneOfType([PropTypes.bool, PropTypes.oneOf(['false', 'true', 'page', 'step', 'location', 'date', 'time'])]),
   /**
    * Pass in content that will be inside of the BreadcrumbItem
    */

package/es/components/ComboBox/ComboBox.d.ts

@@ -5,6 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import Downshift from 'downshift';
+import { ReactNodeLike } from 'prop-types';
 import { type ComponentProps, type ReactNode, type ComponentType, type ReactElement, type RefAttributes, type PropsWithChildren, type PropsWithoutRef, type InputHTMLAttributes, type MouseEvent } from 'react';
 import { ListBoxSize } from '../ListBox';
 type ExcludedAttributes = 'id' | 'onChange' | 'onClick' | 'type' | 'size';
@@ -135,6 +136,10 @@ export interface ComboBoxProps<ItemType> extends Omit<InputHTMLAttributes<HTMLIn
      * Specify the size of the ListBox. Currently supports either `sm`, `md` or `lg` as an option.
      */
     size?: ListBoxSize;
+    /**
+     * Provide a `Slug` component to be rendered inside the `ComboBox` component
+     */
+    slug?: ReactNodeLike;
     /**
      * Provide text to be used in a `<label>` element that is tied to the
      * combobox via ARIA attributes.

package/es/components/ComboBox/ComboBox.js

@@ -112,6 +112,7 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     warn,
     warnText,
     allowCustomValue = false,
+    slug,
     ...rest
   } = props;
   const prefix = usePrefix();
@@ -243,7 +244,8 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
   });
   const wrapperClasses = cx(`${prefix}--list-box__wrapper`, [containerClassName, {
     [`${prefix}--list-box__wrapper--fluid--invalid`]: isFluid && invalid,
-    [`${prefix}--list-box__wrapper--fluid--focus`]: isFluid && isFocused
+    [`${prefix}--list-box__wrapper--fluid--focus`]: isFluid && isFocused,
+    [`${prefix}--list-box__wrapper--slug`]: slug
   }]);
   const inputClasses = cx(`${prefix}--text-input`, {
     [`${prefix}--text-input--empty`]: !inputValue,
@@ -252,6 +254,14 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
 
   // needs to be Capitalized for react to render it correctly
   const ItemToElement = itemToElement;
+
+  // Slug is always size `mini`
+  let normalizedSlug;
+  if (slug) {
+    normalizedSlug = /*#__PURE__*/React__default.cloneElement(slug, {
+      size: 'mini'
+    });
+  }
   return /*#__PURE__*/React__default.createElement(Downshift, _extends({}, downshiftProps, {
     onChange: handleOnChange,
     onInputValueChange: handleOnInputValueChange,
@@ -341,6 +351,18 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
         if (match(event, End) && event.code !== 'Numpad1') {
           event.target.setSelectionRange(event.target.value.length, event.target.value.length);
         }
+        if (event.altKey && event.key == 'ArrowDown') {
+          event.preventDownshiftDefault = true;
+          if (!isOpen) {
+            toggleMenu();
+          }
+        }
+        if (event.altKey && event.key == 'ArrowUp') {
+          event.preventDownshiftDefault = true;
+          if (isOpen) {
+            toggleMenu();
+          }
+        }
       }
     });
     const handleFocus = evt => {
@@ -402,7 +424,7 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     }), /*#__PURE__*/React__default.createElement(ListBoxTrigger, _extends({}, buttonProps, {
       isOpen: isOpen,
       translateWithId: translateWithId
-    }))), /*#__PURE__*/React__default.createElement(ListBox.Menu, getMenuProps({
+    }))), normalizedSlug, /*#__PURE__*/React__default.createElement(ListBox.Menu, getMenuProps({
       'aria-label': deprecatedAriaLabel || ariaLabel
     }), isOpen ? filterItems(items, itemToString, inputValue).map((item, index) => {
       const isObject = item !== null && typeof item === 'object';
@@ -552,6 +574,10 @@ ComboBox.propTypes = {
    * Specify the size of the ListBox. Currently supports either `sm`, `md` or `lg` as an option.
    */
   size: ListBoxSize,
+  /**
+   * Provide a `Slug` component to be rendered inside the `ComboBox` component
+   */
+  slug: PropTypes.node,
   /**
    * Provide text to be used in a `<label>` element that is tied to the
    * combobox via ARIA attributes.

package/es/components/ComboButton/index.js

@@ -68,7 +68,7 @@ const ComboButton = /*#__PURE__*/React__default.forwardRef(function ComboButton(
     }
   }
   function handleOpen() {
-    menuRef.current.style.width = `${width}px`;
+    menuRef.current.style.inlineSize = `${width}px`;
   }
   const containerClasses = cx(`${prefix}--combo-button__container`, `${prefix}--combo-button__container--${size}`, {
     [`${prefix}--combo-button__container--open`]: open
@@ -100,6 +100,7 @@ const ComboButton = /*#__PURE__*/React__default.forwardRef(function ComboButton(
     ref: menuRef,
     id: id,
     label: t('carbon.combo-button.additional-actions'),
+    mode: "basic",
     size: size,
     open: open,
     onClose: handleClose,

package/es/components/ComposedModal/ComposedModal.d.ts

@@ -4,7 +4,7 @@ export interface ModalBodyProps extends HTMLAttributes<HTMLDivElement> {
     children?: ReactNode;
     /**
      * Provide whether the modal content has a form element.
-     * If `true` is used here, non-form child content should have `bx--modal-content__regular-content` class.
+     * If `true` is used here, non-form child content should have `cds--modal-content__regular-content` class.
      */
     hasForm?: boolean;
     /**
@@ -15,11 +15,11 @@ export interface ModalBodyProps extends HTMLAttributes<HTMLDivElement> {
 export declare const ModalBody: React.ForwardRefExoticComponent<ModalBodyProps & React.RefAttributes<HTMLDivElement>>;
 export interface ComposedModalProps extends HTMLAttributes<HTMLDivElement> {
     /**
-     * Specify the aria-label for bx--modal-container
+     * Specify the aria-label for cds--modal-container
      */
     'aria-label'?: string;
     /**
-     * Specify the aria-labelledby for bx--modal-container
+     * Specify the aria-labelledby for cds--modal-container
      */
     'aria-labelledby'?: string;
     /**

package/es/components/ComposedModal/ComposedModal.js

@@ -56,7 +56,7 @@ ModalBody.propTypes = {
   className: PropTypes.string,
   /**
    * Provide whether the modal content has a form element.
-   * If `true` is used here, non-form child content should have `bx--modal-content__regular-content` class.
+   * If `true` is used here, non-form child content should have `cds--modal-content__regular-content` class.
    */
   hasForm: PropTypes.bool,
   /**
@@ -231,11 +231,11 @@ const ComposedModal = /*#__PURE__*/React__default.forwardRef(function ComposedMo
 });
 ComposedModal.propTypes = {
   /**
-   * Specify the aria-label for bx--modal-container
+   * Specify the aria-label for cds--modal-container
    */
   ['aria-label']: PropTypes.string,
   /**
-   * Specify the aria-labelledby for bx--modal-container
+   * Specify the aria-labelledby for cds--modal-container
    */
   ['aria-labelledby']: PropTypes.string,
   /**

package/es/components/ComposedModal/ModalFooter.d.ts

@@ -5,6 +5,7 @@ interface SecondaryButtonProps {
 }
 export interface SecondaryButtonSetProps {
     closeModal(evt: MouseEvent): void;
+    disabled?: boolean;
     onRequestClose(evt: MouseEvent): void;
     secondaryButtonText?: string;
     secondaryButtons?: [SecondaryButtonProps, SecondaryButtonProps];
@@ -66,6 +67,23 @@ export interface ModalFooterProps {
      * Specify a custom className to be applied to the secondary button
      */
     secondaryClassName?: string;
+    /**
+     * loading status
+     */
+    loadingStatus?: string;
+    /**
+     * Specify the description for the loading text
+     */
+    loadingDescription?: string;
+    /**
+     * Specify the description for the loading text
+     */
+    loadingIconDescription?: string;
+    /**
+     * Provide an optional handler to be invoked when loading is
+     * successful
+     */
+    onLoadingSuccess?(): void;
 }
 export declare const ModalFooter: React.ForwardRefExoticComponent<ModalFooterProps & React.RefAttributes<HTMLElement>>;
 export {};

package/es/components/ComposedModal/ModalFooter.js

@@ -14,6 +14,7 @@ import ButtonSet from '../ButtonSet/ButtonSet.js';
 import cx from 'classnames';
 import { usePrefix } from '../../internal/usePrefix.js';
 import { noopFn } from '../../internal/noopFn.js';
+import InlineLoading from '../InlineLoading/InlineLoading.js';
 
 function SecondaryButtonSet(_ref) {
   let {
@@ -21,7 +22,8 @@ function SecondaryButtonSet(_ref) {
     secondaryButtonText,
     secondaryClassName,
     closeModal,
-    onRequestClose
+    onRequestClose,
+    disabled
   } = _ref;
   function handleRequestClose(evt) {
     closeModal(evt);
@@ -43,6 +45,7 @@ function SecondaryButtonSet(_ref) {
   }
   if (secondaryButtonText) {
     return /*#__PURE__*/React__default.createElement(Button, {
+      disabled: disabled,
       className: secondaryClassName,
       onClick: handleRequestClose,
       kind: "secondary"
@@ -52,6 +55,7 @@ function SecondaryButtonSet(_ref) {
 }
 SecondaryButtonSet.propTypes = {
   closeModal: PropTypes.func,
+  disabled: PropTypes.bool,
   onRequestClose: PropTypes.func,
   secondaryButtonText: PropTypes.string,
   secondaryButtons: (props, propName, componentName) => {
@@ -86,32 +90,43 @@ const ModalFooter = /*#__PURE__*/React__default.forwardRef(function ModalFooter(
     secondaryButtonText,
     secondaryButtons,
     secondaryClassName,
+    loadingStatus = 'inactive',
+    loadingDescription,
+    loadingIconDescription,
+    onLoadingSuccess = noopFn,
     ...rest
   } = _ref3;
   const prefix = usePrefix();
   const footerClass = cx(`${prefix}--modal-footer`, customClassName, Array.isArray(secondaryButtons) && secondaryButtons.length === 2 ? `${prefix}--modal-footer--three-button` : null);
+  const primaryButtonClass = cx(primaryClassName, loadingStatus !== 'inactive' ? `${prefix}--btn--loading` : null);
+  const loadingActive = loadingStatus !== 'inactive';
   const secondaryButtonProps = {
     closeModal,
     secondaryButtons,
     secondaryButtonText,
     secondaryClassName,
-    onRequestClose
+    onRequestClose,
+    disabled: loadingActive
   };
-  return (
-    /*#__PURE__*/
+  return /*#__PURE__*/React__default.createElement(ButtonSet, _extends({
+    className: footerClass
+  }, rest, {
     // @ts-expect-error: Invalid derived types, will be fine once explicit types are added
-    React__default.createElement(ButtonSet, _extends({
-      className: footerClass
-    }, rest, {
-      ref: ref
-    }), /*#__PURE__*/React__default.createElement(SecondaryButtonSet, secondaryButtonProps), primaryButtonText && /*#__PURE__*/React__default.createElement(Button, {
-      onClick: onRequestSubmit,
-      className: primaryClassName,
-      disabled: primaryButtonDisabled,
-      kind: danger ? 'danger' : 'primary',
-      ref: inputref
-    }, primaryButtonText), children)
-  );
+    ref: ref,
+    "aria-busy": loadingActive
+  }), /*#__PURE__*/React__default.createElement(SecondaryButtonSet, secondaryButtonProps), primaryButtonText && /*#__PURE__*/React__default.createElement(Button, {
+    onClick: onRequestSubmit,
+    className: primaryButtonClass,
+    disabled: loadingActive || primaryButtonDisabled,
+    kind: danger ? 'danger' : 'primary',
+    ref: inputref
+  }, loadingStatus === 'inactive' ? primaryButtonText : /*#__PURE__*/React__default.createElement(InlineLoading, {
+    status: loadingStatus,
+    description: loadingDescription,
+    iconDescription: loadingIconDescription,
+    className: `${prefix}--inline-loading--btn`,
+    onSuccess: onLoadingSuccess
+  })), children);
 });
 ModalFooter.propTypes = {
   /**
@@ -138,6 +153,23 @@ ModalFooter.propTypes = {
   inputref: PropTypes.oneOfType([PropTypes.func, PropTypes.shape({
     current: PropTypes.any
   })]),
+  /**
+   * Specify the description for the loading text
+   */
+  loadingDescription: PropTypes.string,
+  /**
+   * Specify the description for the loading text
+   */
+  loadingIconDescription: PropTypes.string,
+  /**
+   * loading status
+   */
+  loadingStatus: PropTypes.oneOf(['inactive', 'active', 'finished', 'error']),
+  /**
+   * Provide an optional handler to be invoked when loading is
+   * successful
+   */
+  onLoadingSuccess: PropTypes.func,
   /**
    * Specify an optional function for when the modal is requesting to be
    * closed

package/es/components/ContextMenu/useContextMenu.js

@@ -40,7 +40,8 @@ function useContextMenu() {
     open,
     x: position[0],
     y: position[1],
-    onClose
+    onClose,
+    mode: 'full'
   };
 }
 

package/es/components/DataTableSkeleton/DataTableSkeleton.js

@@ -63,7 +63,7 @@ const DataTableSkeleton = _ref => {
   }, rest), /*#__PURE__*/React__default.createElement("thead", null, /*#__PURE__*/React__default.createElement("tr", null, columnsArray.map(i => /*#__PURE__*/React__default.createElement("th", {
     key: i
   }, headers ? /*#__PURE__*/React__default.createElement("div", {
-    className: "bx--table-header-label"
+    className: "cds--table-header-label"
   }, headers[i]?.header) : _span2 || (_span2 = /*#__PURE__*/React__default.createElement("span", null)))))), /*#__PURE__*/React__default.createElement("tbody", null, rows)));
 };
 DataTableSkeleton.propTypes = {

package/es/components/DatePickerInput/DatePickerInput.d.ts

@@ -76,6 +76,10 @@ interface DatePickerInputProps extends Omit<ReactAttr<HTMLInputElement>, Exclude
      * Specify the size of the Date Picker Input. Currently supports either `sm`, `md`, or `lg` as an option.
      */
     size?: 'sm' | 'md' | 'lg';
+    /**
+     * Provide a `Slug` component to be rendered inside the `DatePickerInput` component
+     */
+    slug?: ReactNodeLike;
     /**
      * Specify the type of the `<input>`
      */

package/es/components/DatePickerInput/DatePickerInput.js

@@ -32,6 +32,7 @@ const DatePickerInput = /*#__PURE__*/React__default.forwardRef(function DatePick
     pattern = '\\d{1,2}\\/\\d{1,2}\\/\\d{4}',
     placeholder,
     size = 'md',
+    slug,
     type = 'text',
     warn,
     warnText,
@@ -60,7 +61,8 @@ const DatePickerInput = /*#__PURE__*/React__default.forwardRef(function DatePick
   };
   const wrapperClasses = cx(`${prefix}--date-picker-input__wrapper`, {
     [`${prefix}--date-picker-input__wrapper--invalid`]: invalid,
-    [`${prefix}--date-picker-input__wrapper--warn`]: warn
+    [`${prefix}--date-picker-input__wrapper--warn`]: warn,
+    [`${prefix}--date-picker-input__wrapper--slug`]: slug
   });
   const labelClasses = cx(`${prefix}--label`, {
     [`${prefix}--visually-hidden`]: hideLabel,
@@ -93,6 +95,14 @@ const DatePickerInput = /*#__PURE__*/React__default.forwardRef(function DatePick
     inputProps['data-invalid'] = true;
   }
   const input = /*#__PURE__*/React__default.createElement("input", inputProps);
+
+  // Slug is always size `mini`
+  let normalizedSlug;
+  if (slug) {
+    normalizedSlug = /*#__PURE__*/React__default.cloneElement(slug, {
+      size: 'mini'
+    });
+  }
   return /*#__PURE__*/React__default.createElement("div", {
     className: containerClasses
   }, labelText && /*#__PURE__*/React__default.createElement(Text, {
@@ -101,7 +111,7 @@ const DatePickerInput = /*#__PURE__*/React__default.forwardRef(function DatePick
     className: labelClasses
   }, labelText), /*#__PURE__*/React__default.createElement("div", {
     className: wrapperClasses
-  }, /*#__PURE__*/React__default.createElement("span", null, input, isFluid && /*#__PURE__*/React__default.createElement(DatePickerIcon, {
+  }, /*#__PURE__*/React__default.createElement("span", null, input, normalizedSlug, isFluid && /*#__PURE__*/React__default.createElement(DatePickerIcon, {
     datePickerType: datePickerType
   }), /*#__PURE__*/React__default.createElement(DatePickerIcon, {
     datePickerType: datePickerType,
@@ -195,6 +205,10 @@ DatePickerInput.propTypes = {
    * Specify the size of the Date Picker Input. Currently supports either `sm`, `md`, or `lg` as an option.
    */
   size: PropTypes.oneOf(['sm', 'md', 'lg']),
+  /**
+   * Provide a `Slug` component to be rendered inside the `DatePickerInput` component
+   */
+  slug: PropTypes.node,
   /**
    * Specify the type of the `<input>`
    */

package/es/components/Dropdown/Dropdown.d.ts

@@ -6,6 +6,7 @@
  */
 import React, { ReactNode } from 'react';
 import { UseSelectProps } from 'downshift';
+import { ReactNodeLike } from 'prop-types';
 import { ListBoxSize, ListBoxType } from '../ListBox';
 import { ReactAttr } from '../../types/common';
 type ExcludedAttributes = 'id' | 'onChange';
@@ -110,6 +111,10 @@ export interface DropdownProps<ItemType> extends Omit<ReactAttr<HTMLDivElement>,
      * Specify the size of the ListBox. Currently supports either `sm`, `md` or `lg` as an option.
      */
     size?: ListBoxSize;
+    /**
+     * Provide a `Slug` component to be rendered inside the `Dropdown` component
+     */
+    slug?: ReactNodeLike;
     /**
      * Provide the title text that will be read by a screen reader when
      * visiting this control

package/es/components/Dropdown/Dropdown.js

@@ -69,6 +69,7 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
     selectedItem: controlledSelectedItem,
     downshiftProps,
     readOnly,
+    slug,
     ...other
   } = _ref;
   const prefix = usePrefix();
@@ -159,7 +160,8 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
     [`${prefix}--dropdown__wrapper--inline--invalid`]: inline && invalid,
     [`${prefix}--list-box__wrapper--inline--invalid`]: inline && invalid,
     [`${prefix}--list-box__wrapper--fluid--invalid`]: isFluid && invalid,
-    [`${prefix}--list-box__wrapper--fluid--focus`]: isFluid && isFocused && !isOpen
+    [`${prefix}--list-box__wrapper--fluid--focus`]: isFluid && isFocused && !isOpen,
+    [`${prefix}--list-box__wrapper--slug`]: slug
   });
   const helperId = !helperText ? undefined : `dropdown-helper-text-${dropdownInstanceId}`;
 
@@ -223,6 +225,14 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
     }
   };
   const menuProps = getMenuProps();
+
+  // Slug is always size `mini`
+  let normalizedSlug;
+  if (slug) {
+    normalizedSlug = /*#__PURE__*/React__default.cloneElement(slug, {
+      size: 'mini'
+    });
+  }
   return /*#__PURE__*/React__default.createElement("div", _extends({
     className: wrapperClasses
   }, other), titleText && /*#__PURE__*/React__default.createElement("label", _extends({
@@ -261,12 +271,15 @@ const Dropdown = /*#__PURE__*/React__default.forwardRef((_ref, ref) => {
   }, selectedItem ? renderSelectedItem ? renderSelectedItem(selectedItem) : itemToString(selectedItem) : label), /*#__PURE__*/React__default.createElement(ListBox.MenuIcon, {
     isOpen: isOpen,
     translateWithId: translateWithId
-  })), /*#__PURE__*/React__default.createElement(ListBox.Menu, menuProps, isOpen && items.map((item, index) => {
+  })), normalizedSlug, /*#__PURE__*/React__default.createElement(ListBox.Menu, menuProps, isOpen && items.map((item, index) => {
     const isObject = item !== null && typeof item === 'object';
     const itemProps = getItemProps({
       item,
       index
     });
+    if (item !== null && typeof item === 'object' && Object.prototype.hasOwnProperty.call(item, 'id')) {
+      itemProps.id = item['id'];
+    }
     const title = isObject && 'text' in item && itemToElement ? item.text : itemToString(item);
     return /*#__PURE__*/React__default.createElement(ListBox.MenuItem, _extends({
       key: itemProps.id,
@@ -294,7 +307,7 @@ Dropdown.propTypes = {
    */
   ariaLabel: deprecate(PropTypes.string, 'This prop syntax has been deprecated. Please use the new `aria-label`.'),
   /**
-   * Provide a custom className to be applied on the bx--dropdown node
+   * Provide a custom className to be applied on the cds--dropdown node
    */
   className: PropTypes.string,
   /**
@@ -382,6 +395,10 @@ Dropdown.propTypes = {
    * Specify the size of the ListBox. Currently supports either `sm`, `md` or `lg` as an option.
    */
   size: ListBoxSize,
+  /**
+   * Provide a `Slug` component to be rendered inside the `Dropdown` component
+   */
+  slug: PropTypes.node,
   /**
    * Provide the title text that will be read by a screen reader when
    * visiting this control

package/es/components/InlineLoading/index.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import InlineLoading from './InlineLoading.js';
+export { default as InlineLoading, default } from './InlineLoading.js';

package/es/components/Link/Link.d.ts

@@ -6,6 +6,11 @@
  */
 import React, { AnchorHTMLAttributes, AriaAttributes, ComponentType, HTMLAttributeAnchorTarget } from 'react';
 export interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    /**
+     * Provide a custom element or component to render the top-level node for the
+     * component.
+     */
+    as?: string | undefined;
     /**
      * @description Indicates the element that represents the
      *   current item within a container or set of related

package/es/components/Link/Link.js

@@ -13,6 +13,7 @@ import { usePrefix } from '../../internal/usePrefix.js';
 
 const Link = /*#__PURE__*/React__default.forwardRef(function Link(_ref, ref) {
   let {
+    as: BaseComponent,
     children,
     className: customClassName,
     href,
@@ -33,7 +34,7 @@ const Link = /*#__PURE__*/React__default.forwardRef(function Link(_ref, ref) {
   });
   const rel = target === '_blank' ? 'noopener' : undefined;
   const linkProps = {
-    className,
+    className: BaseComponent ? undefined : className,
     rel,
     target
   };
@@ -46,7 +47,8 @@ const Link = /*#__PURE__*/React__default.forwardRef(function Link(_ref, ref) {
     linkProps.role = 'link';
     linkProps['aria-disabled'] = true;
   }
-  return /*#__PURE__*/React__default.createElement("a", _extends({
+  const BaseComponentAsAny = BaseComponent ?? 'a';
+  return /*#__PURE__*/React__default.createElement(BaseComponentAsAny, _extends({
     ref: ref
   }, linkProps, rest), children, !inline && Icon && /*#__PURE__*/React__default.createElement("div", {
     className: `${prefix}--link__icon`
@@ -54,6 +56,11 @@ const Link = /*#__PURE__*/React__default.forwardRef(function Link(_ref, ref) {
 });
 Link.displayName = 'Link';
 Link.propTypes = {
+  /**
+   * Provide a custom element or component to render the top-level node for the
+   * component.
+   */
+  as: PropTypes.string,
   /**
    * Provide the content for the Link
    */

package/es/components/Menu/Menu.js

@@ -12,6 +12,7 @@ import React__default, { useRef, useContext, useReducer, useMemo, useState, useE
 import { createPortal } from 'react-dom';
 import { useMergedRefs } from '../../internal/useMergedRefs.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import { warning } from '../../internal/warning.js';
 import { MenuContext, menuReducer } from './MenuContext.js';
 import { useLayoutDirection } from '../LayoutDirection/useLayoutDirection.js';
 import { match } from '../../internal/keyboard/match.js';
@@ -24,6 +25,7 @@ const Menu = /*#__PURE__*/React__default.forwardRef(function Menu(_ref, forwardR
     children,
     className,
     label,
+    mode = 'full',
     onClose,
     onOpen,
     open,
@@ -37,10 +39,14 @@ const Menu = /*#__PURE__*/React__default.forwardRef(function Menu(_ref, forwardR
   const focusReturn = useRef(null);
   const context = useContext(MenuContext);
   const isRoot = context.state.isRoot;
+  if (context.state.mode === 'basic' && !isRoot) {
+    process.env.NODE_ENV !== "production" ? warning(false, 'Nested menus are not supported when the menu is in "basic" mode.') : void 0;
+  }
   const menuSize = isRoot ? size : context.state.size;
   const [childState, childDispatch] = useReducer(menuReducer, {
     ...context.state,
     isRoot: false,
+    mode,
     size,
     requestCloseRoot: isRoot ? handleClose : context.state.requestCloseRoot
   });
@@ -245,6 +251,14 @@ Menu.propTypes = {
    * A label describing the Menu.
    */
   label: PropTypes.string,
+  /**
+   * 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: PropTypes.oneOf(['full', 'basic']),
   /**
    * Provide an optional function to be called when the Menu should be closed.
    */

package/es/components/Menu/MenuContext.js

@@ -9,6 +9,7 @@ import React__default from 'react';
 
 const menuDefaultState = {
   isRoot: true,
+  mode: 'full',
   hasIcons: false,
   size: null,
   items: [],