@carbon/react 1.53.0 → 1.54.0-rc.0

package/es/internal/wrapFocus.js

@@ -6,7 +6,9 @@
  */
 
 import findLast from 'lodash.findlast';
+import { useEffect } from 'react';
 import { DOCUMENT_POSITION_BROAD_PRECEDING, selectorTabbable, DOCUMENT_POSITION_BROAD_FOLLOWING } from './keyboard/navigation.js';
+import { tabbable } from 'tabbable';
 
 /**
  * @param {Node} node A DOM node.
@@ -60,4 +62,52 @@ function wrapFocus(_ref) {
   }
 }
 
-export { wrapFocus as default, elementOrParentIsFloatingMenu };
+/**
+ * Ensures the focus is kept in the given `containerNode`, implementing "focus-wrap" behavior.
+ * Note: This must be called *before* focus moves using onKeyDown or similar.
+ * @param {object} options The options.
+ * @param {Node|null} options.containerNode
+ * @param {EventTarget} options.currentActiveNode The DOM node that has focus.
+ * @param {KeyboardEvent} options.event The DOM event
+ */
+function wrapFocusWithoutSentinels(_ref2) {
+  let {
+    containerNode,
+    currentActiveNode,
+    event
+  } = _ref2;
+  if (['blur', 'focusout', 'focusin', 'focus'].includes(event.type) && process.env.NODE_ENV !== "production") {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    useEffect(() => {
+      throw new Error(`Error: wrapFocusWithoutSentinels(...) called in unsupported ${event.type} event.\n\nCall wrapFocusWithoutSentinels(...) from onKeyDown instead.`);
+    });
+  }
+
+  // The reason we're using tabbable is because it returns the tabbable
+  // items *in tab order*, whereas using our `selectorTabbable` only
+  // returns in DOM order
+  const tabbables = tabbable(containerNode);
+  const firstTabbable = tabbables[0];
+  const lastTabbable = tabbables[tabbables.length - 1];
+
+  // console.log(`---------------------------------`);
+  // console.log(containerNode);
+  // console.log(tabbables);
+  // console.log(firstTabbable);
+  // console.log(lastTabbable);
+  // console.log(currentActiveNode);
+
+  // The shift key is used to determine if focus is moving forwards or backwards
+  if (currentActiveNode === lastTabbable && !event.shiftKey) {
+    // Cancel the current movement of focus because we're going to place it ourselves
+    event.preventDefault();
+    firstTabbable.focus();
+  }
+  if (currentActiveNode === firstTabbable && event.shiftKey) {
+    // Cancel the current movement of focus because we're going to place it ourselves
+    event.preventDefault();
+    lastTabbable.focus();
+  }
+}
+
+export { wrapFocus as default, elementOrParentIsFloatingMenu, wrapFocusWithoutSentinels };

package/es/tools/createPropAdapter.js

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ */
+
+/**
+ * Create an adapter that converts an object of props with potentially deprecated
+ * prop names to the replacement prop names in a newer version. Useful for guarding
+ * against breaking changes when a prop has been renamed
+ *
+ * @param {Array} spec - an array of options which specify a text or regex
+ * matcher alongside a replacement if there is a match
+ * @returns {Function}
+ */
+function mapPopoverAlignProp(align) {
+  switch (align) {
+    case 'top-left':
+      return 'top-start';
+    case 'top-right':
+      return 'top-end';
+    case 'bottom-left':
+      return 'bottom-start';
+    case 'bottom-right':
+      return 'bottom-end';
+    case 'left-bottom':
+      return 'left-end';
+    case 'left-top':
+      return 'left-start';
+    case 'right-bottom':
+      return 'right-end';
+    case 'right-top':
+      return 'right-start';
+    default:
+      return align;
+  }
+}
+
+export { mapPopoverAlignProp };

package/lib/components/AiSkeleton/AiSkeletonIcon.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var PropTypes = require('prop-types');
+var React = require('react');
+var cx = require('classnames');
+var usePrefix = require('../../internal/usePrefix.js');
+var SkeletonIcon = require('../SkeletonIcon/SkeletonIcon.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
+
+const AiSkeletonIcon = _ref => {
+  let {
+    className,
+    ...rest
+  } = _ref;
+  const prefix = usePrefix.usePrefix();
+  const AiSkeletonIconClasses = cx__default["default"](className, {
+    [`${prefix}--skeleton__icon--ai`]: true
+  });
+  return /*#__PURE__*/React__default["default"].createElement(SkeletonIcon["default"], _rollupPluginBabelHelpers["extends"]({
+    className: AiSkeletonIconClasses
+  }, rest));
+};
+AiSkeletonIcon.propTypes = {
+  /**
+   * Specify an optional className to add.
+   */
+  className: PropTypes__default["default"].string,
+  /**
+   * The CSS styles.
+   */
+  style: PropTypes__default["default"].object
+};
+
+exports["default"] = AiSkeletonIcon;

package/lib/components/AiSkeleton/AiSkeletonPlaceholder.js

@@ -0,0 +1,47 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var React = require('react');
+var PropTypes = require('prop-types');
+var cx = require('classnames');
+var usePrefix = require('../../internal/usePrefix.js');
+var SkeletonPlaceholder = require('../SkeletonPlaceholder/SkeletonPlaceholder.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
+var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
+
+const AiSkeletonPlaceholder = _ref => {
+  let {
+    className,
+    ...other
+  } = _ref;
+  const prefix = usePrefix.usePrefix();
+  const AiSkeletonPlaceholderClasses = cx__default["default"]({
+    className,
+    [`${prefix}--skeleton__placeholder--ai`]: true
+  }, className);
+  return /*#__PURE__*/React__default["default"].createElement(SkeletonPlaceholder["default"], _rollupPluginBabelHelpers["extends"]({
+    className: AiSkeletonPlaceholderClasses
+  }, other));
+};
+AiSkeletonPlaceholder.propTypes = {
+  /**
+   * Add a custom class to the component
+   * to set the height and width
+   */
+  className: PropTypes__default["default"].string
+};
+
+exports["default"] = AiSkeletonPlaceholder;

package/lib/components/AiSkeleton/AiSkeletonText.js

@@ -0,0 +1,61 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var PropTypes = require('prop-types');
+var React = require('react');
+var cx = require('classnames');
+var usePrefix = require('../../internal/usePrefix.js');
+var SkeletonText = require('../SkeletonText/SkeletonText.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
+
+const AiSkeletonText = _ref => {
+  let {
+    className,
+    ...rest
+  } = _ref;
+  const prefix = usePrefix.usePrefix();
+  const aiSkeletonTextClasses = cx__default["default"](className, {
+    [`${prefix}--skeleton__text--ai`]: true
+  });
+  return /*#__PURE__*/React__default["default"].createElement(SkeletonText["default"], _rollupPluginBabelHelpers["extends"]({
+    className: aiSkeletonTextClasses
+  }, rest));
+};
+AiSkeletonText.propTypes = {
+  /**
+   * Specify an optional className to be applied to the container node
+   */
+  className: PropTypes__default["default"].string,
+  /**
+   * generates skeleton text at a larger size
+   */
+  heading: PropTypes__default["default"].bool,
+  /**
+   * the number of lines shown if paragraph is true
+   */
+  lineCount: PropTypes__default["default"].number,
+  /**
+   * will generate multiple lines of text
+   */
+  paragraph: PropTypes__default["default"].bool,
+  /**
+   * width (in px or %) of single line of text or max-width of paragraph lines
+   */
+  width: PropTypes__default["default"].string
+};
+
+exports["default"] = AiSkeletonText;

package/lib/components/ComboBox/ComboBox.js

@@ -249,7 +249,9 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
   const titleClasses = cx__default["default"](`${prefix}--label`, {
     [`${prefix}--label--disabled`]: disabled
   });
-  const comboBoxHelperId = !helperText ? undefined : `combobox-helper-text-${comboBoxInstanceId}`;
+  const helperTextId = `combobox-helper-text-${comboBoxInstanceId}`;
+  const warnTextId = `combobox-warn-text-${comboBoxInstanceId}`;
+  const invalidTextId = `combobox-invalid-text-${comboBoxInstanceId}`;
   const helperClasses = cx__default["default"](`${prefix}--form__helper-text`, {
     [`${prefix}--form__helper-text--disabled`]: disabled
   });
@@ -387,6 +389,11 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
         }
       }
     } : {};
+
+    // The input should be described by the appropriate message text id
+    // when both the message is supplied *and* when the component is in
+    // the matching state (invalid, warn, etc).
+    const ariaDescribedBy = invalid && invalidText && invalidTextId || warn && warnText && warnTextId || helperText && !isFluid && helperTextId || undefined;
     return /*#__PURE__*/React__default["default"].createElement("div", {
       className: wrapperClasses
     }, titleText && /*#__PURE__*/React__default["default"].createElement(Text.Text, _rollupPluginBabelHelpers["extends"]({
@@ -399,11 +406,13 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
       disabled: disabled,
       invalid: invalid,
       invalidText: invalidText,
+      invalidTextId: invalidTextId,
       isOpen: isOpen,
       light: light,
       size: size,
       warn: warn,
-      warnText: warnText
+      warnText: warnText,
+      warnTextId: warnTextId
     }, /*#__PURE__*/React__default["default"].createElement("div", {
       className: `${prefix}--list-box__field`
     }, /*#__PURE__*/React__default["default"].createElement("input", _rollupPluginBabelHelpers["extends"]({
@@ -421,7 +430,7 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
     }, inputProps, rest, readOnlyEventHandlers, {
       readOnly: readOnly,
       ref: mergeRefs["default"](textInput, ref),
-      "aria-describedby": helperText && !invalid && !warn && !isFluid ? comboBoxHelperId : undefined
+      "aria-describedby": ariaDescribedBy
     })), invalid && /*#__PURE__*/React__default["default"].createElement(iconsReact.WarningFilled, {
       className: `${prefix}--list-box__invalid-icon`
     }), showWarning && /*#__PURE__*/React__default["default"].createElement(iconsReact.WarningAltFilled, {
@@ -460,7 +469,7 @@ const ComboBox = /*#__PURE__*/React.forwardRef((props, ref) => {
       }));
     }) : null)), helperText && !invalid && !warn && !isFluid && (_Text || (_Text = /*#__PURE__*/React__default["default"].createElement(Text.Text, {
       as: "div",
-      id: comboBoxHelperId,
+      id: helperTextId,
       className: helperClasses
     }, helperText))));
   });

package/lib/components/ComboButton/index.js

@@ -162,7 +162,7 @@ ComboButton.propTypes = {
   /**
    * Specify how the trigger tooltip should be aligned.
    */
-  tooltipAlignment: PropTypes__default["default"].oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  tooltipAlignment: PropTypes__default["default"].oneOf(['top', 'top-left', 'top-start', 'top-right', 'top-end', 'bottom', 'bottom-left', 'bottom-start', 'bottom-right', 'bottom-end', 'left', 'right']),
   /**
    * Optional method that takes in a message id and returns an
    * internationalized string.

package/lib/components/ComposedModal/ComposedModal.js

@@ -23,6 +23,7 @@ var toggleClass = require('../../tools/toggleClass.js');
 var requiredIfGivenPropIsTruthy = require('../../prop-types/requiredIfGivenPropIsTruthy.js');
 var wrapFocus = require('../../internal/wrapFocus.js');
 var usePrefix = require('../../internal/usePrefix.js');
+var index = require('../FeatureFlags/index.js');
 var match = require('../../internal/keyboard/match.js');
 var keys = require('../../internal/keyboard/keys.js');
 
@@ -125,6 +126,7 @@ const ComposedModal = /*#__PURE__*/React__default["default"].forwardRef(function
   const button = React.useRef(null);
   const startSentinel = React.useRef(null);
   const endSentinel = React.useRef(null);
+  const focusTrapWithoutSentinels = index.useFeatureFlag('enable-experimental-focus-wrap-without-sentinels');
 
   // Keep track of modal open/close state
   // and propagate it to the document.body
@@ -142,12 +144,19 @@ const ComposedModal = /*#__PURE__*/React__default["default"].forwardRef(function
     };
   }, []); // eslint-disable-line react-hooks/exhaustive-deps
 
-  function handleKeyDown(evt) {
-    evt.stopPropagation();
-    if (match.match(evt, keys.Escape)) {
-      closeModal(evt);
+  function handleKeyDown(event) {
+    event.stopPropagation();
+    if (match.match(event, keys.Escape)) {
+      closeModal(event);
+    }
+    if (focusTrapWithoutSentinels && open && match.match(event, keys.Tab) && innerModal.current) {
+      wrapFocus.wrapFocusWithoutSentinels({
+        containerNode: innerModal.current,
+        currentActiveNode: event.target,
+        event: event
+      });
     }
-    onKeyDown?.(evt);
+    onKeyDown?.(event);
   }
   function handleMousedown(evt) {
     evt.stopPropagation();
@@ -255,7 +264,7 @@ const ComposedModal = /*#__PURE__*/React__default["default"].forwardRef(function
     role: "presentation",
     ref: ref,
     "aria-hidden": !open,
-    onBlur: handleBlur,
+    onBlur: !focusTrapWithoutSentinels ? handleBlur : () => {},
     onMouseDown: handleMousedown,
     onKeyDown: handleKeyDown,
     className: modalClass
@@ -265,14 +274,14 @@ const ComposedModal = /*#__PURE__*/React__default["default"].forwardRef(function
     "aria-modal": "true",
     "aria-label": ariaLabel ? ariaLabel : generatedAriaLabel,
     "aria-labelledby": ariaLabelledBy
-  }, /*#__PURE__*/React__default["default"].createElement("button", {
+  }, !focusTrapWithoutSentinels && /*#__PURE__*/React__default["default"].createElement("button", {
     type: "button",
     ref: startSentinel,
     className: `${prefix}--visually-hidden`
   }, "Focus sentinel"), /*#__PURE__*/React__default["default"].createElement("div", {
     ref: innerModal,
     className: `${prefix}--modal-container-body`
-  }, normalizedSlug, childrenWithProps), /*#__PURE__*/React__default["default"].createElement("button", {
+  }, normalizedSlug, childrenWithProps), !focusTrapWithoutSentinels && /*#__PURE__*/React__default["default"].createElement("button", {
     type: "button",
     ref: endSentinel,
     className: `${prefix}--visually-hidden`

package/lib/components/DataTable/DataTable.js

@@ -324,7 +324,7 @@ class DataTable extends React__default["default"].Component {
         isSortable,
         useStaticWidth,
         stickyHeader,
-        overflowMenuOnHover = true,
+        overflowMenuOnHover = false,
         experimentalAutoAlign
       } = this.props;
       return {

package/lib/components/DataTable/TableBatchAction.d.ts

@@ -24,7 +24,7 @@ export interface TableBatchActionProps extends React.ButtonHTMLAttributes<HTMLBu
 declare const TableBatchAction: {
     ({ renderIcon, iconDescription, ...props }: {
         [x: string]: any;
-        renderIcon?: import("@carbon/icons-react/lib/CarbonIcon").CarbonIconType | undefined;
+        renderIcon?: import("@carbon/icons-react").CarbonIconType | undefined;
         iconDescription?: string | undefined;
     }): import("react/jsx-runtime").JSX.Element;
     propTypes: {

package/lib/components/DataTable/TableToolbarMenu.d.ts

@@ -8,13 +8,17 @@ import React from 'react';
 export interface TableToolbarMenuProps extends React.HTMLAttributes<HTMLDivElement> {
     children: React.ReactNode;
     /**
-     * Provide an optional class name for the toolbar menu
+     * Provide an optional class name for the toolbar menu trigger button
      */
     className?: string;
     /**
      * The description of the menu icon.
      */
     iconDescription?: string;
+    /**
+     * Provide an optional class name for the toolbar menu
+     */
+    menuOptionsClass?: string;
     /**
      * Optional prop to allow overriding the default menu icon
      */

package/lib/components/DataTable/TableToolbarMenu.js

@@ -30,16 +30,19 @@ const TableToolbarMenu = _ref => {
     renderIcon = iconsReact.Settings,
     iconDescription = defaultIconDescription,
     children,
+    menuOptionsClass,
     ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
   const toolbarActionClasses = cx__default["default"](className, `${prefix}--toolbar-action ${prefix}--overflow-menu`);
+  const menuOptionsClasses = cx__default["default"](menuOptionsClass, `${prefix}--toolbar-action__menu`);
   return /*#__PURE__*/React__default["default"].createElement(index["default"], _rollupPluginBabelHelpers["extends"]({
     "aria-label": iconDescription,
     renderIcon: renderIcon,
     className: toolbarActionClasses,
     title: iconDescription,
     iconDescription: iconDescription,
+    menuOptionsClass: menuOptionsClasses,
     flipped: true
   }, rest), children);
 };
@@ -53,6 +56,10 @@ TableToolbarMenu.propTypes = {
    * The description of the menu icon.
    */
   iconDescription: PropTypes__default["default"].string,
+  /**
+   * Provide an optional class name for the toolbar menu
+   */
+  menuOptionsClass: PropTypes__default["default"].string,
   /**
    * Optional prop to allow overriding the default menu icon
    */

package/lib/components/DatePicker/DatePicker.d.ts

@@ -102,6 +102,10 @@ interface DatePickerProps {
      * The `open` event handler.
      */
     onOpen?: flatpickr.Options.Hook;
+    /**
+     * flatpickr prop passthrough. Controls how dates are parsed.
+     */
+    parseDate?: (date: string) => Date | false;
     /**
      * whether the DatePicker is to be readOnly
      * if boolean applies to all inputs

package/lib/components/DatePicker/DatePicker.js

@@ -170,6 +170,7 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
     readOnly = false,
     short = false,
     value,
+    parseDate: parseDateProp,
     ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
@@ -279,6 +280,37 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
     } else {
       localeData = l10n__default["default"][locale];
     }
+
+    /**
+     * parseDate is called before the date is actually set.
+     * It attempts to parse the input value and return a valid date string.
+     * Flatpickr's default parser results in odd dates when given invalid
+     * values, so instead here we normalize the month/day to `1` if given
+     * a value outside the acceptable range.
+     */
+    let parseDate;
+    if (!parseDateProp && dateFormat === 'm/d/Y') {
+      // This function only supports the default dateFormat.
+      parseDate = date => {
+        // Month must be 1-12. If outside these bounds, `1` should be used.
+        const month = date.split('/')[0] <= 12 && date.split('/')[0] > 0 ? parseInt(date.split('/')[0]) : 1;
+        const year = parseInt(date.split('/')[2]);
+        if (month && year) {
+          // The month and year must be provided to be able to determine
+          // the number of days in the month.
+          const daysInMonth = new Date(year, month, 0).getDate();
+          // If the day does not fall within the days in the month, `1` should be used.
+          const day = date.split('/')[1] <= daysInMonth && date.split('/')[1] > 0 ? parseInt(date.split('/')[1]) : 1;
+          return new Date(`${year}/${month}/${day}`);
+        } else {
+          // With no month and year, we cannot calculate anything.
+          // Returning false gives flatpickr an invalid date, which will clear the input
+          return false;
+        }
+      };
+    } else if (parseDateProp) {
+      parseDate = parseDateProp;
+    }
     const {
       current: start
     } = startInputField;
@@ -297,6 +329,7 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
       [enableOrDisable]: enableOrDisableArr,
       minDate: minDate,
       maxDate: maxDate,
+      parseDate: parseDate,
       plugins: [datePickerType === 'range' ? rangePlugin["default"]({
         input: endInputField.current
       }) : () => {}, appendTo ? appendToPlugin["default"]({
@@ -708,6 +741,10 @@ DatePicker.propTypes = {
    * `(dates: Date[], dStr: string, fp: Instance, data?: any):void;`
    */
   onOpen: PropTypes__default["default"].func,
+  /**
+   * flatpickr prop passthrough. Controls how dates are parsed.
+   */
+  parseDate: PropTypes__default["default"].func,
   /**
    * whether the DatePicker is to be readOnly
    * if boolean applies to all inputs

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

@@ -13,7 +13,7 @@ interface IconButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>
     /**
      * Specify how the trigger should align with the tooltip
      */
-    align?: 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
+    align?: 'top' | 'top-left' | 'top-start' | 'top-right' | 'top-end' | 'bottom' | 'bottom-left' | 'bottom-start' | 'bottom-right' | 'bottom-end' | 'left' | 'right';
     /**
      * Provide an icon or asset to be rendered inside of the IconButton
      */

package/lib/components/IconButton/index.js

@@ -69,7 +69,7 @@ IconButton.propTypes = {
   /**
    * Specify how the trigger should align with the tooltip
    */
-  align: PropTypes__default["default"].oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  align: PropTypes__default["default"].oneOf(['top', 'top-left', 'top-start', 'top-right', 'top-end', 'bottom', 'bottom-left', 'bottom-start', 'bottom-right', 'bottom-end', 'left', 'right']),
   /**
    * Provide an icon or asset to be rendered inside of the IconButton
    */

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

@@ -21,6 +21,10 @@ export interface ListBoxProps extends Omit<ReactAttr<HTMLDivElement>, ExcludedAt
      * Specify the text to be displayed when the control is invalid
      */
     invalidText?: React.ReactNode;
+    /**
+     * Specify the id to be applied to the element containing the invalid text
+     */
+    invalidTextId?: string;
     /**
      * Specify if the control should render open
      */
@@ -50,6 +54,10 @@ export interface ListBoxProps extends Omit<ReactAttr<HTMLDivElement>, ExcludedAt
      * Provide the text that is displayed when the control is in warning state
      */
     warnText?: React.ReactNode;
+    /**
+     * Specify the id to be applied to the element containing the warn text
+     */
+    warnTextId?: string;
 }
 export type ListBoxComponent = ForwardRefReturn<HTMLDivElement, ListBoxProps>;
 /**

package/lib/components/ListBox/ListBox.js

@@ -47,8 +47,10 @@ const ListBox = /*#__PURE__*/React__default["default"].forwardRef(function ListB
     size,
     invalid,
     invalidText,
+    invalidTextId,
     warn,
     warnText,
+    warnTextId,
     light,
     isOpen,
     ...rest
@@ -80,9 +82,11 @@ const ListBox = /*#__PURE__*/React__default["default"].forwardRef(function ListB
   }), children), isFluid && /*#__PURE__*/React__default["default"].createElement("hr", {
     className: `${prefix}--list-box__divider`
   }), invalid ? /*#__PURE__*/React__default["default"].createElement("div", {
-    className: `${prefix}--form-requirement`
+    className: `${prefix}--form-requirement`,
+    id: invalidTextId
   }, invalidText) : null, showWarning ? /*#__PURE__*/React__default["default"].createElement("div", {
-    className: `${prefix}--form-requirement`
+    className: `${prefix}--form-requirement`,
+    id: warnTextId
   }, warnText) : null);
 });
 ListBox.displayName = 'ListBox';
@@ -107,6 +111,10 @@ ListBox.propTypes = {
    * Specify the text to be displayed when the control is invalid
    */
   invalidText: PropTypes__default["default"].node,
+  /**
+   * Specify the id to be applied to the element containing the invalid text
+   */
+  invalidTextId: PropTypes__default["default"].string,
   /**
    * Specify if the control should render open
    */
@@ -132,7 +140,11 @@ ListBox.propTypes = {
   /**
    * Provide the text that is displayed when the control is in warning state
    */
-  warnText: PropTypes__default["default"].node
+  warnText: PropTypes__default["default"].string,
+  /**
+   * Specify the id to be applied to the element containing the warn text
+   */
+  warnTextId: PropTypes__default["default"].string
 };
 
 exports["default"] = ListBox;

package/lib/components/Loading/Loading.d.ts

@@ -30,7 +30,7 @@ export interface LoadingProps extends ReactAttr<HTMLDivElement> {
     /**
      * Specify whether you want the loader to be applied with an overlay
      */
-    withOverlay: boolean;
+    withOverlay?: boolean;
 }
 declare function Loading({ active, className: customClassName, withOverlay, small, description, ...rest }: LoadingProps): import("react/jsx-runtime").JSX.Element;
 declare namespace Loading {