@carbon/react 1.53.1 → 1.54.0

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 {

package/lib/components/Menu/Menu.js

@@ -42,6 +42,8 @@ const Menu = /*#__PURE__*/React.forwardRef(function Menu(_ref, forwardRef) {
     onOpen,
     open,
     size = 'sm',
+    // TODO: #16004
+    // eslint-disable-next-line ssr-friendly/no-dom-globals-in-react-fc
     target = document.body,
     x = 0,
     y = 0,

package/lib/components/Modal/Modal.js

@@ -25,9 +25,10 @@ var debounce = require('lodash.debounce');
 var useIsomorphicEffect = require('../../internal/useIsomorphicEffect.js');
 var setupGetInstanceId = require('../../tools/setupGetInstanceId.js');
 var usePrefix = require('../../internal/usePrefix.js');
-var index = require('../IconButton/index.js');
+var index$1 = require('../IconButton/index.js');
 var noopFn = require('../../internal/noopFn.js');
 require('../Text/index.js');
+var index = require('../FeatureFlags/index.js');
 var Text = require('../Text/Text.js');
 var match = require('../../internal/keyboard/match.js');
 var keys = require('../../internal/keyboard/keys.js');
@@ -93,6 +94,7 @@ const Modal = /*#__PURE__*/React__default["default"].forwardRef(function Modal(_
     [`${prefix}--btn--loading`]: loadingStatus !== 'inactive'
   });
   const loadingActive = loadingStatus !== 'inactive';
+  const focusTrapWithoutSentinels = index.useFeatureFlag('enable-experimental-focus-wrap-without-sentinels');
   function isCloseButton(element) {
     return !onSecondarySubmit && element === secondaryButton.current || element.classList.contains(modalCloseButtonClass);
   }
@@ -105,6 +107,13 @@ const Modal = /*#__PURE__*/React__default["default"].forwardRef(function Modal(_
       if (match.match(evt, keys.Enter) && shouldSubmitOnEnter && !isCloseButton(evt.target)) {
         onRequestSubmit(evt);
       }
+      if (focusTrapWithoutSentinels && match.match(evt, keys.Tab) && innerModal.current) {
+        wrapFocus.wrapFocusWithoutSentinels({
+          containerNode: innerModal.current,
+          currentActiveNode: evt.target,
+          event: evt
+        });
+      }
     }
   }
   function handleMousedown(evt) {
@@ -237,7 +246,7 @@ const Modal = /*#__PURE__*/React__default["default"].forwardRef(function Modal(_
   }
   const modalButton = /*#__PURE__*/React__default["default"].createElement("div", {
     className: `${prefix}--modal-close-button`
-  }, /*#__PURE__*/React__default["default"].createElement(index.IconButton, {
+  }, /*#__PURE__*/React__default["default"].createElement(index$1.IconButton, {
     className: modalCloseButtonClass,
     label: closeButtonLabel,
     onClick: onRequestClose,
@@ -306,16 +315,16 @@ const Modal = /*#__PURE__*/React__default["default"].forwardRef(function Modal(_
   return /*#__PURE__*/React__default["default"].createElement("div", _rollupPluginBabelHelpers["extends"]({}, rest, {
     onKeyDown: handleKeyDown,
     onMouseDown: handleMousedown,
-    onBlur: handleBlur,
+    onBlur: !focusTrapWithoutSentinels ? handleBlur : () => {},
     className: modalClasses,
     role: "presentation",
     ref: ref
-  }), /*#__PURE__*/React__default["default"].createElement("span", {
+  }), !focusTrapWithoutSentinels && /*#__PURE__*/React__default["default"].createElement("span", {
     ref: startTrap,
     tabIndex: 0,
     role: "link",
     className: `${prefix}--visually-hidden`
-  }, "Focus sentinel"), modalBody, /*#__PURE__*/React__default["default"].createElement("span", {
+  }, "Focus sentinel"), modalBody, !focusTrapWithoutSentinels && /*#__PURE__*/React__default["default"].createElement("span", {
     ref: endTrap,
     tabIndex: 0,
     role: "link",

package/lib/components/ModalWrapper/ModalWrapper.d.ts

@@ -59,7 +59,7 @@ export default class ModalWrapper extends React.Component<ModalWrapperProps, Mod
         shouldCloseAfterSubmit: PropTypes.Requireable<boolean>;
         status: PropTypes.Requireable<string>;
         triggerButtonIconDescription: PropTypes.Requireable<string>;
-        triggerButtonKind: PropTypes.Requireable<"primary" | "secondary" | "ghost" | "tertiary" | "danger" | "danger--primary" | "danger--ghost" | "danger--tertiary">;
+        triggerButtonKind: PropTypes.Requireable<"primary" | "secondary" | "danger" | "ghost" | "danger--primary" | "danger--ghost" | "danger--tertiary" | "tertiary">;
         withHeader: PropTypes.Requireable<boolean>;
     };
     triggerButton: React.RefObject<HTMLButtonElement>;

package/lib/components/Notification/Notification.js

@@ -24,6 +24,7 @@ var usePrefix = require('../../internal/usePrefix.js');
 var useId = require('../../internal/useId.js');
 var noopFn = require('../../internal/noopFn.js');
 var wrapFocus = require('../../internal/wrapFocus.js');
+var index = require('../FeatureFlags/index.js');
 var Text = require('../Text/Text.js');
 var match = require('../../internal/keyboard/match.js');
 var keys = require('../../internal/keyboard/keys.js');
@@ -521,6 +522,7 @@ function ActionableNotification(_ref6) {
   const startTrap = React.useRef(null);
   const endTrap = React.useRef(null);
   const ref = React.useRef(null);
+  const focusTrapWithoutSentinels = index.useFeatureFlag('enable-experimental-focus-wrap-without-sentinels');
   useIsomorphicEffect["default"](() => {
     if (hasFocus) {
       const button = document.querySelector('button.cds--actionable-notification__action-button');
@@ -551,6 +553,15 @@ function ActionableNotification(_ref6) {
       });
     }
   }
+  function handleKeyDown(event) {
+    if (isOpen && match.match(event, keys.Tab) && ref.current) {
+      wrapFocus.wrapFocusWithoutSentinels({
+        containerNode: ref.current,
+        currentActiveNode: event.target,
+        event
+      });
+    }
+  }
   const handleClose = evt => {
     if (!onClose || onClose(evt) !== false) {
       setIsOpen(false);
@@ -569,8 +580,9 @@ function ActionableNotification(_ref6) {
     role: role,
     className: containerClassName,
     "aria-labelledby": title ? id : subtitleId,
-    onBlur: handleBlur
-  }), /*#__PURE__*/React__default["default"].createElement("span", {
+    onBlur: !focusTrapWithoutSentinels ? handleBlur : () => {},
+    onKeyDown: focusTrapWithoutSentinels ? handleKeyDown : () => {}
+  }), !focusTrapWithoutSentinels && /*#__PURE__*/React__default["default"].createElement("span", {
     ref: startTrap,
     tabIndex: 0,
     role: "link",
@@ -603,7 +615,7 @@ function ActionableNotification(_ref6) {
     "aria-label": deprecatedAriaLabel || ariaLabel,
     notificationType: "actionable",
     onClick: handleCloseButtonClick
-  })), /*#__PURE__*/React__default["default"].createElement("span", {
+  })), !focusTrapWithoutSentinels && /*#__PURE__*/React__default["default"].createElement("span", {
     ref: endTrap,
     tabIndex: 0,
     role: "link",

package/lib/components/Pagination/Pagination.Skeleton.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import PropTypes from 'prop-types';
+import React from 'react';
+export interface PaginationSkeletonProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Specify an optional className to add.
+     */
+    className?: string;
+}
+declare function PaginationSkeleton({ className, ...rest }: PaginationSkeletonProps): import("react/jsx-runtime").JSX.Element;
+declare namespace PaginationSkeleton {
+    var propTypes: {
+        /**
+         * Specify an optional className to add.
+         */
+        className: PropTypes.Requireable<string>;
+    };
+}
+export default PaginationSkeleton;
+export { PaginationSkeleton };

package/lib/components/Pagination/Pagination.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Copyright IBM Corp. 2016, 2023
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+type ExcludedAttributes = 'id' | 'onChange';
+export interface PaginationPageSize {
+    text: string;
+    value: number;
+}
+export interface PaginationProps extends Omit<React.HTMLAttributes<HTMLDivElement>, ExcludedAttributes> {
+    /**
+     * The description for the backward icon.
+     */
+    backwardText?: string;
+    /**
+     * The CSS class names.
+     */
+    className?: string;
+    /**
+     * `true` if the backward/forward buttons, as well as the page select elements,  should be disabled.
+     */
+    disabled?: boolean;
+    /**
+     * The description for the forward icon.
+     */
+    forwardText?: string;
+    /**
+     * The unique ID of this component instance.
+     */
+    id?: string | number;
+    /**
+     * `true` if the current page should be the last page.
+     */
+    isLastPage?: boolean;
+    /**
+     * The function returning a translatable text showing where the current page is,
+     * in a manner of the range of items.
+     */
+    itemRangeText?: (min: number, max: number, total: number) => string;
+    /**
+     * A variant of `itemRangeText`, used if the total number of items is unknown.
+     */
+    itemText?: (min: number, max: number) => string;
+    /**
+     * The translatable text indicating the number of items per page.
+     */
+    itemsPerPageText?: string;
+    /**
+     * The callback function called when the current page changes.
+     */
+    onChange?: (data: {
+        page: number;
+        pageSize: number;
+        ref?: React.RefObject<any>;
+    }) => void;
+    /**
+     * The current page.
+     */
+    page?: number;
+    /**
+     * `true` if the select box to change the page should be disabled.
+     */
+    pageInputDisabled?: boolean;
+    pageNumberText?: string;
+    /**
+     * A function returning PII showing where the current page is.
+     */
+    pageRangeText?: (current: number, total: number) => string;
+    /**
+     * The number dictating how many items a page contains.
+     */
+    pageSize?: number;
+    /**
+     * `true` if the select box to change the items per page should be disabled.
+     */
+    pageSizeInputDisabled?: boolean;
+    /**
+     * The choices for `pageSize`.
+     */
+    pageSizes: number[] | PaginationPageSize[];
+    /**
+     * The translatable text showing the current page.
+     */
+    pageText?: (page: number, pagesUnknown?: boolean) => string;
+    /**
+     * `true` if the total number of items is unknown.
+     */
+    pagesUnknown?: boolean;
+    /**
+     * Specify the size of the Pagination.
+     */
+    size?: 'sm' | 'md' | 'lg';
+    /**
+     * The total number of items.
+     */
+    totalItems?: number;
+}
+declare const Pagination: React.ForwardRefExoticComponent<PaginationProps & React.RefAttributes<HTMLDivElement>>;
+export default Pagination;

package/lib/components/Pagination/Pagination.js

@@ -37,7 +37,7 @@ function mapPageSizesToObject(sizes) {
 }
 function renderSelectItems(total) {
   let counter = 1;
-  let itemArr = [];
+  const itemArr = [];
   while (counter <= total) {
     itemArr.push( /*#__PURE__*/React__default["default"].createElement(SelectItem["default"], {
       key: counter,
@@ -62,7 +62,7 @@ function getPageSize(pageSizes, pageSize) {
 const Pagination = /*#__PURE__*/React__default["default"].forwardRef(function Pagination(_ref, ref) {
   let {
     backwardText = 'Previous page',
-    className: customClassName,
+    className: customClassName = '',
     disabled = false,
     forwardText = 'Next page',
     id,
@@ -81,11 +81,11 @@ const Pagination = /*#__PURE__*/React__default["default"].forwardRef(function Pa
     pageText = (page, pagesUnknown) => `page ${pagesUnknown ? '' : page}`,
     pagesUnknown = false,
     size = 'md',
-    totalItems,
+    totalItems = 1,
     ...rest
   } = _ref;
   const prefix = usePrefix.usePrefix();
-  const inputId = useId.useFallbackId(id);
+  const inputId = useId.useFallbackId(id?.toString());
   const backBtnRef = React.useRef(null);
   const forwardBtnRef = React.useRef(null);
   const [pageSizes, setPageSizes] = React.useState(() => {
@@ -173,14 +173,14 @@ const Pagination = /*#__PURE__*/React__default["default"].forwardRef(function Pa
     // the icon button becomes disabled and the focus shifts to `main`
     // this presents an a11y problem for keyboard & screen reader users
     // instead, we want the focus to shift to the other pagination btn
-    if (nextPage === totalPages) {
+    if (nextPage === totalPages && backBtnRef?.current) {
       backBtnRef.current.focus();
     }
     if (onChange) {
       onChange({
         page: nextPage,
         pageSize,
-        backBtnRef
+        ref: backBtnRef
       });
     }
   }
@@ -192,14 +192,14 @@ const Pagination = /*#__PURE__*/React__default["default"].forwardRef(function Pa
     // the icon button becomes disabled and the focus shifts to `main`
     // this presents an a11y problem for keyboard & screen reader users
     // instead, we want the focus to shift to the other pagination btn
-    if (nextPage === 1) {
+    if (nextPage === 1 && forwardBtnRef?.current) {
       forwardBtnRef.current.focus();
     }
     if (onChange) {
       onChange({
         page: nextPage,
         pageSize,
-        forwardBtnRef
+        ref: forwardBtnRef
       });
     }
   }
@@ -330,10 +330,10 @@ Pagination.propTypes = {
   /**
    * The choices for `pageSize`.
    */
-  pageSizes: PropTypes__default["default"].oneOfType([PropTypes__default["default"].arrayOf(PropTypes__default["default"].number), PropTypes__default["default"].arrayOf(PropTypes__default["default"].shape({
-    text: PropTypes__default["default"].text,
-    value: PropTypes__default["default"].number
-  }))]).isRequired,
+  pageSizes: PropTypes__default["default"].oneOfType([PropTypes__default["default"].arrayOf(PropTypes__default["default"].number.isRequired), PropTypes__default["default"].arrayOf(PropTypes__default["default"].shape({
+    text: PropTypes__default["default"].string.isRequired,
+    value: PropTypes__default["default"].number.isRequired
+  }).isRequired)]).isRequired,
   /**
    * The translatable text showing the current page.
    */
@@ -351,6 +351,5 @@ Pagination.propTypes = {
    */
   totalItems: PropTypes__default["default"].number
 };
-var Pagination$1 = Pagination;
 
-exports["default"] = Pagination$1;
+exports["default"] = Pagination;

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

@@ -0,0 +1,10 @@
+/**
+ * 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 Pagination from './Pagination';
+export * from './Pagination.Skeleton';
+export default Pagination;
+export { Pagination };

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

@@ -6,7 +6,7 @@
  */
 import React, { type ForwardedRef, type WeakValidationMap, type ElementType } from 'react';
 import { type PolymorphicProps } from '../../types/common';
-export type PopoverAlignment = 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'left-bottom' | 'left-top' | 'right' | 'right-bottom' | 'right-top';
+export type PopoverAlignment = 'top' | 'top-left' | 'top-right' | 'bottom' | 'bottom-left' | 'bottom-right' | 'left' | 'left-bottom' | 'left-top' | 'right' | 'right-bottom' | 'right-top' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end' | 'left-end' | 'left-start' | 'right-end' | 'right-start';
 interface PopoverBaseProps {
     /**
      * Specify how the popover should align with the trigger element