@carbon/react 1.53.1 → 1.54.0-rc.0

package/es/components/ComboBox/ComboBox.js

@@ -238,7 +238,9 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
   const titleClasses = cx(`${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(`${prefix}--form__helper-text`, {
     [`${prefix}--form__helper-text--disabled`]: disabled
   });
@@ -376,6 +378,11 @@ const ComboBox = /*#__PURE__*/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.createElement("div", {
       className: wrapperClasses
     }, titleText && /*#__PURE__*/React__default.createElement(Text, _extends({
@@ -388,11 +395,13 @@ const ComboBox = /*#__PURE__*/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.createElement("div", {
       className: `${prefix}--list-box__field`
     }, /*#__PURE__*/React__default.createElement("input", _extends({
@@ -410,7 +419,7 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
     }, inputProps, rest, readOnlyEventHandlers, {
       readOnly: readOnly,
       ref: mergeRefs(textInput, ref),
-      "aria-describedby": helperText && !invalid && !warn && !isFluid ? comboBoxHelperId : undefined
+      "aria-describedby": ariaDescribedBy
     })), invalid && /*#__PURE__*/React__default.createElement(WarningFilled, {
       className: `${prefix}--list-box__invalid-icon`
     }), showWarning && /*#__PURE__*/React__default.createElement(WarningAltFilled, {
@@ -449,7 +458,7 @@ const ComboBox = /*#__PURE__*/forwardRef((props, ref) => {
       }));
     }) : null)), helperText && !invalid && !warn && !isFluid && (_Text || (_Text = /*#__PURE__*/React__default.createElement(Text, {
       as: "div",
-      id: comboBoxHelperId,
+      id: helperTextId,
       className: helperClasses
     }, helperText))));
   });

package/es/components/ComboButton/index.js

@@ -152,7 +152,7 @@ ComboButton.propTypes = {
   /**
    * Specify how the trigger tooltip should be aligned.
    */
-  tooltipAlignment: PropTypes.oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  tooltipAlignment: PropTypes.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/es/components/ComposedModal/ComposedModal.js

@@ -17,10 +17,11 @@ import mergeRefs from '../../tools/mergeRefs.js';
 import cx from 'classnames';
 import toggleClass from '../../tools/toggleClass.js';
 import requiredIfGivenPropIsTruthy from '../../prop-types/requiredIfGivenPropIsTruthy.js';
-import wrapFocus from '../../internal/wrapFocus.js';
+import wrapFocus, { wrapFocusWithoutSentinels } from '../../internal/wrapFocus.js';
 import { usePrefix } from '../../internal/usePrefix.js';
+import { useFeatureFlag } from '../FeatureFlags/index.js';
 import { match } from '../../internal/keyboard/match.js';
-import { Escape } from '../../internal/keyboard/keys.js';
+import { Escape, Tab } from '../../internal/keyboard/keys.js';
 
 const ModalBody = /*#__PURE__*/React__default.forwardRef(function ModalBody(_ref, ref) {
   let {
@@ -114,6 +115,7 @@ const ComposedModal = /*#__PURE__*/React__default.forwardRef(function ComposedMo
   const button = useRef(null);
   const startSentinel = useRef(null);
   const endSentinel = useRef(null);
+  const focusTrapWithoutSentinels = useFeatureFlag('enable-experimental-focus-wrap-without-sentinels');
 
   // Keep track of modal open/close state
   // and propagate it to the document.body
@@ -131,12 +133,19 @@ const ComposedModal = /*#__PURE__*/React__default.forwardRef(function ComposedMo
     };
   }, []); // eslint-disable-line react-hooks/exhaustive-deps
 
-  function handleKeyDown(evt) {
-    evt.stopPropagation();
-    if (match(evt, Escape)) {
-      closeModal(evt);
+  function handleKeyDown(event) {
+    event.stopPropagation();
+    if (match(event, Escape)) {
+      closeModal(event);
+    }
+    if (focusTrapWithoutSentinels && open && match(event, Tab) && innerModal.current) {
+      wrapFocusWithoutSentinels({
+        containerNode: innerModal.current,
+        currentActiveNode: event.target,
+        event: event
+      });
     }
-    onKeyDown?.(evt);
+    onKeyDown?.(event);
   }
   function handleMousedown(evt) {
     evt.stopPropagation();
@@ -244,7 +253,7 @@ const ComposedModal = /*#__PURE__*/React__default.forwardRef(function ComposedMo
     role: "presentation",
     ref: ref,
     "aria-hidden": !open,
-    onBlur: handleBlur,
+    onBlur: !focusTrapWithoutSentinels ? handleBlur : () => {},
     onMouseDown: handleMousedown,
     onKeyDown: handleKeyDown,
     className: modalClass
@@ -254,14 +263,14 @@ const ComposedModal = /*#__PURE__*/React__default.forwardRef(function ComposedMo
     "aria-modal": "true",
     "aria-label": ariaLabel ? ariaLabel : generatedAriaLabel,
     "aria-labelledby": ariaLabelledBy
-  }, /*#__PURE__*/React__default.createElement("button", {
+  }, !focusTrapWithoutSentinels && /*#__PURE__*/React__default.createElement("button", {
     type: "button",
     ref: startSentinel,
     className: `${prefix}--visually-hidden`
   }, "Focus sentinel"), /*#__PURE__*/React__default.createElement("div", {
     ref: innerModal,
     className: `${prefix}--modal-container-body`
-  }, normalizedSlug, childrenWithProps), /*#__PURE__*/React__default.createElement("button", {
+  }, normalizedSlug, childrenWithProps), !focusTrapWithoutSentinels && /*#__PURE__*/React__default.createElement("button", {
     type: "button",
     ref: endSentinel,
     className: `${prefix}--visually-hidden`

package/es/components/DataTable/DataTable.js

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

package/es/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/es/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/es/components/DataTable/TableToolbarMenu.js

@@ -20,16 +20,19 @@ const TableToolbarMenu = _ref => {
     renderIcon = Settings,
     iconDescription = defaultIconDescription,
     children,
+    menuOptionsClass,
     ...rest
   } = _ref;
   const prefix = usePrefix();
   const toolbarActionClasses = cx(className, `${prefix}--toolbar-action ${prefix}--overflow-menu`);
+  const menuOptionsClasses = cx(menuOptionsClass, `${prefix}--toolbar-action__menu`);
   return /*#__PURE__*/React__default.createElement(OverflowMenu, _extends({
     "aria-label": iconDescription,
     renderIcon: renderIcon,
     className: toolbarActionClasses,
     title: iconDescription,
     iconDescription: iconDescription,
+    menuOptionsClass: menuOptionsClasses,
     flipped: true
   }, rest), children);
 };
@@ -43,6 +46,10 @@ TableToolbarMenu.propTypes = {
    * The description of the menu icon.
    */
   iconDescription: PropTypes.string,
+  /**
+   * Provide an optional class name for the toolbar menu
+   */
+  menuOptionsClass: PropTypes.string,
   /**
    * Optional prop to allow overriding the default menu icon
    */

package/es/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/es/components/DatePicker/DatePicker.js

@@ -158,6 +158,7 @@ const DatePicker = /*#__PURE__*/React__default.forwardRef(function DatePicker(_r
     readOnly = false,
     short = false,
     value,
+    parseDate: parseDateProp,
     ...rest
   } = _ref;
   const prefix = usePrefix();
@@ -267,6 +268,37 @@ const DatePicker = /*#__PURE__*/React__default.forwardRef(function DatePicker(_r
     } else {
       localeData = l10n[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;
@@ -285,6 +317,7 @@ const DatePicker = /*#__PURE__*/React__default.forwardRef(function DatePicker(_r
       [enableOrDisable]: enableOrDisableArr,
       minDate: minDate,
       maxDate: maxDate,
+      parseDate: parseDate,
       plugins: [datePickerType === 'range' ? carbonFlatpickrRangePlugin({
         input: endInputField.current
       }) : () => {}, appendTo ? carbonFlatpickrAppendToPlugin({
@@ -696,6 +729,10 @@ DatePicker.propTypes = {
    * `(dates: Date[], dStr: string, fp: Instance, data?: any):void;`
    */
   onOpen: PropTypes.func,
+  /**
+   * flatpickr prop passthrough. Controls how dates are parsed.
+   */
+  parseDate: PropTypes.func,
   /**
    * whether the DatePicker is to be readOnly
    * if boolean applies to all inputs

package/es/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/es/components/IconButton/index.js

@@ -59,7 +59,7 @@ IconButton.propTypes = {
   /**
    * Specify how the trigger should align with the tooltip
    */
-  align: PropTypes.oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  align: PropTypes.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/es/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/es/components/ListBox/ListBox.js

@@ -37,8 +37,10 @@ const ListBox = /*#__PURE__*/React__default.forwardRef(function ListBox(_ref, re
     size,
     invalid,
     invalidText,
+    invalidTextId,
     warn,
     warnText,
+    warnTextId,
     light,
     isOpen,
     ...rest
@@ -70,9 +72,11 @@ const ListBox = /*#__PURE__*/React__default.forwardRef(function ListBox(_ref, re
   }), children), isFluid && /*#__PURE__*/React__default.createElement("hr", {
     className: `${prefix}--list-box__divider`
   }), invalid ? /*#__PURE__*/React__default.createElement("div", {
-    className: `${prefix}--form-requirement`
+    className: `${prefix}--form-requirement`,
+    id: invalidTextId
   }, invalidText) : null, showWarning ? /*#__PURE__*/React__default.createElement("div", {
-    className: `${prefix}--form-requirement`
+    className: `${prefix}--form-requirement`,
+    id: warnTextId
   }, warnText) : null);
 });
 ListBox.displayName = 'ListBox';
@@ -97,6 +101,10 @@ ListBox.propTypes = {
    * Specify the text to be displayed when the control is invalid
    */
   invalidText: PropTypes.node,
+  /**
+   * Specify the id to be applied to the element containing the invalid text
+   */
+  invalidTextId: PropTypes.string,
   /**
    * Specify if the control should render open
    */
@@ -122,7 +130,11 @@ ListBox.propTypes = {
   /**
    * Provide the text that is displayed when the control is in warning state
    */
-  warnText: PropTypes.node
+  warnText: PropTypes.string,
+  /**
+   * Specify the id to be applied to the element containing the warn text
+   */
+  warnTextId: PropTypes.string
 };
 
 export { ListBox as default };

package/es/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/es/components/Modal/Modal.js

@@ -16,7 +16,7 @@ import '../Button/Button.Skeleton.js';
 import ButtonSet from '../ButtonSet/ButtonSet.js';
 import InlineLoading from '../InlineLoading/InlineLoading.js';
 import requiredIfGivenPropIsTruthy from '../../prop-types/requiredIfGivenPropIsTruthy.js';
-import wrapFocus, { elementOrParentIsFloatingMenu } from '../../internal/wrapFocus.js';
+import wrapFocus, { wrapFocusWithoutSentinels, elementOrParentIsFloatingMenu } from '../../internal/wrapFocus.js';
 import debounce from 'lodash.debounce';
 import useIsomorphicEffect from '../../internal/useIsomorphicEffect.js';
 import setupGetInstanceId from '../../tools/setupGetInstanceId.js';
@@ -24,9 +24,10 @@ import { usePrefix } from '../../internal/usePrefix.js';
 import { IconButton } from '../IconButton/index.js';
 import { noopFn } from '../../internal/noopFn.js';
 import '../Text/index.js';
+import { useFeatureFlag } from '../FeatureFlags/index.js';
 import { Text } from '../Text/Text.js';
 import { match } from '../../internal/keyboard/match.js';
-import { Escape, Enter } from '../../internal/keyboard/keys.js';
+import { Escape, Enter, Tab } from '../../internal/keyboard/keys.js';
 
 const getInstanceId = setupGetInstanceId();
 const ModalSizes = ['xs', 'sm', 'md', 'lg'];
@@ -82,6 +83,7 @@ const Modal = /*#__PURE__*/React__default.forwardRef(function Modal(_ref, ref) {
     [`${prefix}--btn--loading`]: loadingStatus !== 'inactive'
   });
   const loadingActive = loadingStatus !== 'inactive';
+  const focusTrapWithoutSentinels = useFeatureFlag('enable-experimental-focus-wrap-without-sentinels');
   function isCloseButton(element) {
     return !onSecondarySubmit && element === secondaryButton.current || element.classList.contains(modalCloseButtonClass);
   }
@@ -94,6 +96,13 @@ const Modal = /*#__PURE__*/React__default.forwardRef(function Modal(_ref, ref) {
       if (match(evt, Enter) && shouldSubmitOnEnter && !isCloseButton(evt.target)) {
         onRequestSubmit(evt);
       }
+      if (focusTrapWithoutSentinels && match(evt, Tab) && innerModal.current) {
+        wrapFocusWithoutSentinels({
+          containerNode: innerModal.current,
+          currentActiveNode: evt.target,
+          event: evt
+        });
+      }
     }
   }
   function handleMousedown(evt) {
@@ -295,16 +304,16 @@ const Modal = /*#__PURE__*/React__default.forwardRef(function Modal(_ref, ref) {
   return /*#__PURE__*/React__default.createElement("div", _extends({}, rest, {
     onKeyDown: handleKeyDown,
     onMouseDown: handleMousedown,
-    onBlur: handleBlur,
+    onBlur: !focusTrapWithoutSentinels ? handleBlur : () => {},
     className: modalClasses,
     role: "presentation",
     ref: ref
-  }), /*#__PURE__*/React__default.createElement("span", {
+  }), !focusTrapWithoutSentinels && /*#__PURE__*/React__default.createElement("span", {
     ref: startTrap,
     tabIndex: 0,
     role: "link",
     className: `${prefix}--visually-hidden`
-  }, "Focus sentinel"), modalBody, /*#__PURE__*/React__default.createElement("span", {
+  }, "Focus sentinel"), modalBody, !focusTrapWithoutSentinels && /*#__PURE__*/React__default.createElement("span", {
     ref: endTrap,
     tabIndex: 0,
     role: "link",

package/es/components/Notification/Notification.js

@@ -19,10 +19,11 @@ import { useNoInteractiveChildren, useInteractiveChildrenNeedDescription } from
 import { usePrefix } from '../../internal/usePrefix.js';
 import { useId } from '../../internal/useId.js';
 import { noopFn } from '../../internal/noopFn.js';
-import wrapFocus from '../../internal/wrapFocus.js';
+import wrapFocus, { wrapFocusWithoutSentinels } from '../../internal/wrapFocus.js';
+import { useFeatureFlag } from '../FeatureFlags/index.js';
 import { Text } from '../Text/Text.js';
-import { matches } from '../../internal/keyboard/match.js';
-import { Escape } from '../../internal/keyboard/keys.js';
+import { match, matches } from '../../internal/keyboard/match.js';
+import { Tab, Escape } from '../../internal/keyboard/keys.js';
 
 /**
  * Conditionally call a callback when the escape key is pressed
@@ -511,6 +512,7 @@ function ActionableNotification(_ref6) {
   const startTrap = useRef(null);
   const endTrap = useRef(null);
   const ref = useRef(null);
+  const focusTrapWithoutSentinels = useFeatureFlag('enable-experimental-focus-wrap-without-sentinels');
   useIsomorphicEffect(() => {
     if (hasFocus) {
       const button = document.querySelector('button.cds--actionable-notification__action-button');
@@ -541,6 +543,15 @@ function ActionableNotification(_ref6) {
       });
     }
   }
+  function handleKeyDown(event) {
+    if (isOpen && match(event, Tab) && ref.current) {
+      wrapFocusWithoutSentinels({
+        containerNode: ref.current,
+        currentActiveNode: event.target,
+        event
+      });
+    }
+  }
   const handleClose = evt => {
     if (!onClose || onClose(evt) !== false) {
       setIsOpen(false);
@@ -559,8 +570,9 @@ function ActionableNotification(_ref6) {
     role: role,
     className: containerClassName,
     "aria-labelledby": title ? id : subtitleId,
-    onBlur: handleBlur
-  }), /*#__PURE__*/React__default.createElement("span", {
+    onBlur: !focusTrapWithoutSentinels ? handleBlur : () => {},
+    onKeyDown: focusTrapWithoutSentinels ? handleKeyDown : () => {}
+  }), !focusTrapWithoutSentinels && /*#__PURE__*/React__default.createElement("span", {
     ref: startTrap,
     tabIndex: 0,
     role: "link",
@@ -593,7 +605,7 @@ function ActionableNotification(_ref6) {
     "aria-label": deprecatedAriaLabel || ariaLabel,
     notificationType: "actionable",
     onClick: handleCloseButtonClick
-  })), /*#__PURE__*/React__default.createElement("span", {
+  })), !focusTrapWithoutSentinels && /*#__PURE__*/React__default.createElement("span", {
     ref: endTrap,
     tabIndex: 0,
     role: "link",

package/es/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/es/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;