@carbon/react 1.83.0-rc.0 → 1.84.0-rc.0

package/lib/components/DataTable/tools/sorting.js

@@ -17,8 +17,7 @@ var sortStates = require('../state/sortStates.js');
  * type, the default sort algorithm will be used for those types. Otherwise, the
  * values will be converted to strings for comparison.
  */
-const compare = function (a, b) {
-  let locale = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'en';
+const compare = (a, b, locale = 'en') => {
   // prevent multiple null values in one column (sorting breaks)
   if (a === null) a = '';
   if (b === null) b = '';
@@ -41,8 +40,7 @@ const compare = function (a, b) {
  *
  * Note: Uses numeric comparison if strings are numeric.
  */
-const compareStrings = function (a, b) {
-  let locale = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'en';
+const compareStrings = (a, b, locale = 'en') => {
   const isNumeric = !isNaN(parseFloat(a)) && !isNaN(parseFloat(b));
   return a.localeCompare(b, locale, {
     numeric: isNumeric
@@ -51,38 +49,34 @@ const compareStrings = function (a, b) {
 /**
  * Sorts table rows based on the provided column key and direction.
  */
-const sortRows = _ref => {
-  let {
-    rowIds,
-    cellsById,
-    sortDirection,
+const sortRows = ({
+  rowIds,
+  cellsById,
+  sortDirection,
+  key,
+  locale = 'en',
+  sortRow = defaultSortRow
+}) => rowIds.slice().sort((a, b) => {
+  const cellA = cellsById[cells.getCellId(a, key)];
+  const cellB = cellsById[cells.getCellId(b, key)];
+  return sortRow(cellA?.value, cellB?.value, {
     key,
-    locale = 'en',
-    sortRow = defaultSortRow
-  } = _ref;
-  return rowIds.slice().sort((a, b) => {
-    const cellA = cellsById[cells.getCellId(a, key)];
-    const cellB = cellsById[cells.getCellId(b, key)];
-    return sortRow(cellA?.value, cellB?.value, {
-      key,
-      sortDirection,
-      sortStates: sortStates.sortStates,
-      locale,
-      compare,
-      rowIds: [a, b]
-    });
+    sortDirection,
+    sortStates: sortStates.sortStates,
+    locale,
+    compare,
+    rowIds: [a, b]
   });
-};
+});
 
 /**
  * Sorts table rows based on the sort direction.
  */
-const defaultSortRow = (cellA, cellB, _ref2) => {
-  let {
-    sortDirection,
-    sortStates,
-    locale
-  } = _ref2;
+const defaultSortRow = (cellA, cellB, {
+  sortDirection,
+  sortStates,
+  locale
+}) => {
   if (sortDirection === sortStates.ASC) {
     return compare(cellA, cellB, locale);
   }

package/lib/components/DataTableSkeleton/DataTableSkeleton.js

@@ -22,18 +22,17 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
 var _span, _span2;
-const DataTableSkeleton = _ref => {
-  let {
-    headers,
-    rowCount = 5,
-    columnCount = 5,
-    zebra = false,
-    compact = false,
-    className,
-    showHeader = true,
-    showToolbar = true,
-    ...rest
-  } = _ref;
+const DataTableSkeleton = ({
+  headers,
+  rowCount = 5,
+  columnCount = 5,
+  zebra = false,
+  compact = false,
+  className,
+  showHeader = true,
+  showToolbar = true,
+  ...rest
+}) => {
   const prefix = usePrefix.usePrefix();
   const dataTableSkeletonClasses = cx__default["default"](className, {
     [`${prefix}--skeleton`]: true,

package/lib/components/DatePicker/DatePicker.Skeleton.js

@@ -21,14 +21,13 @@ var PropTypes__default = /*#__PURE__*/_interopDefaultLegacy(PropTypes);
 var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var cx__default = /*#__PURE__*/_interopDefaultLegacy(cx);
 
-const DatePickerSkeleton = _ref => {
-  let {
-    range,
-    id,
-    hideLabel,
-    className,
-    ...rest
-  } = _ref;
+const DatePickerSkeleton = ({
+  range,
+  id,
+  hideLabel,
+  className,
+  ...rest
+}) => {
   const prefix = usePrefix.usePrefix();
   const dateInput = /*#__PURE__*/React__default["default"].createElement("div", {
     className: `${prefix}--date-picker-container`

package/lib/components/DatePicker/DatePicker.js

@@ -144,35 +144,34 @@ function updateClassNames(calendar, prefix) {
     });
   }
 }
-const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function DatePicker(_ref, ref) {
-  let {
-    allowInput,
-    appendTo,
-    children,
-    className,
-    closeOnSelect = true,
-    dateFormat = 'm/d/Y',
-    datePickerType,
-    disable,
-    enable,
-    inline,
-    invalid,
-    invalidText,
-    warn,
-    warnText,
-    light = false,
-    locale = 'en',
-    maxDate,
-    minDate,
-    onChange,
-    onClose,
-    onOpen,
-    readOnly = false,
-    short = false,
-    value,
-    parseDate: parseDateProp,
-    ...rest
-  } = _ref;
+const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function DatePicker({
+  allowInput,
+  appendTo,
+  children,
+  className,
+  closeOnSelect = true,
+  dateFormat = 'm/d/Y',
+  datePickerType,
+  disable,
+  enable,
+  inline,
+  invalid,
+  invalidText,
+  warn,
+  warnText,
+  light = false,
+  locale = 'en',
+  maxDate,
+  minDate,
+  onChange,
+  onClose,
+  onOpen,
+  readOnly = false,
+  short = false,
+  value,
+  parseDate: parseDateProp,
+  ...rest
+}, ref) {
   const prefix = usePrefix.usePrefix();
   const {
     isFluid
@@ -220,6 +219,7 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
     }
   }, [calendarCloseEvent, handleCalendarClose]);
   const endInputField = React.useRef(null);
+  const lastFocusedField = React.useRef(null);
   const savedOnChange = useSavedCallback.useSavedCallback(onChange);
   const savedOnOpen = useSavedCallback.useSavedCallback(onOpen);
   const datePickerClasses = cx__default["default"](`${prefix}--date-picker`, {
@@ -368,40 +368,68 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
       noCalendar: readOnly,
       nextArrow: rightArrowHTML,
       prevArrow: leftArrowHTML,
-      onChange: function () {
+      onChange: (...args) => {
         if (!readOnly) {
-          savedOnChange(...arguments);
+          savedOnChange(...args);
         }
       },
       onReady: onHook,
       onMonthChange: onHook,
       onYearChange: onHook,
-      onOpen: function () {
-        onHook(...arguments);
-        savedOnOpen(...arguments);
+      onOpen: (...args) => {
+        onHook(...args);
+        savedOnOpen(...args);
       },
       onValueUpdate: onHook
     };
     const calendar = flatpickr__default["default"](start, flatpickerConfig);
     calendarRef.current = calendar;
-    function handleArrowDown(event) {
+    const handleInputFieldKeyDown = event => {
+      const {
+        calendarContainer,
+        selectedDateElem: fpSelectedDateElem,
+        todayDateElem: fpTodayDateElem
+      } = calendar;
       if (match.match(event, keys.Escape)) {
-        calendar?.calendarContainer?.classList.remove('open');
+        calendarContainer.classList.remove('open');
       }
-      if (match.match(event, keys.ArrowDown)) {
-        if (event.target == endInputField.current) {
-          calendar?.calendarContainer?.classList.add('open');
+      if (match.match(event, keys.Tab)) {
+        if (!event.shiftKey) {
+          event.preventDefault();
+          calendarContainer.classList.add('open');
+          const selectedDateElem = calendarContainer.querySelector('.selected') && fpSelectedDateElem;
+          const todayDateElem = calendarContainer.querySelector('.today') && fpTodayDateElem;
+          (selectedDateElem || todayDateElem || calendarContainer.querySelector('.flatpickr-day[tabindex]') || calendarContainer).focus();
+          if (event.target === startInputField.current) {
+            lastFocusedField.current = startInputField.current;
+          } else if (event.target === endInputField.current) {
+            lastFocusedField.current = endInputField.current;
+          }
+        } else if (calendarRef.current?.isOpen && event.target === startInputField.current) {
+          calendarRef.current.close();
+          onCalendarClose(calendarRef.current.selectedDates, '', calendarRef.current, event);
         }
-        const {
-          calendarContainer,
-          selectedDateElem: fpSelectedDateElem,
-          todayDateElem: fpTodayDateElem
-        } = calendar;
-        const selectedDateElem = calendarContainer.querySelector('.selected') && fpSelectedDateElem;
-        const todayDateElem = calendarContainer.querySelector('.today') && fpTodayDateElem;
-        (selectedDateElem || todayDateElem || calendarContainer.querySelector('.flatpickr-day[tabindex]') || calendarContainer).focus();
       }
-    }
+    };
+    const handleCalendarKeyDown = event => {
+      if (!calendarRef.current || !startInputField.current) return;
+      const lastInputField = datePickerType == 'range' ? endInputField.current : startInputField.current;
+      if (match.match(event, keys.Tab)) {
+        if (!event.shiftKey) {
+          if (lastFocusedField.current === lastInputField) {
+            lastInputField.focus();
+            calendarRef.current.close();
+            onCalendarClose(calendarRef.current.selectedDates, '', calendarRef.current, event);
+          } else {
+            event.preventDefault();
+            lastInputField.focus();
+          }
+        } else {
+          event.preventDefault();
+          (lastFocusedField.current || startInputField.current).focus();
+        }
+      }
+    };
     function handleOnChange(event) {
       const {
         target
@@ -425,7 +453,7 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
       }
     }
     if (start) {
-      start.addEventListener('keydown', handleArrowDown);
+      start.addEventListener('keydown', handleInputFieldKeyDown);
       start.addEventListener('change', handleOnChange);
       start.addEventListener('keypress', handleKeyPress);
       if (calendar && calendar.calendarContainer) {
@@ -438,10 +466,13 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
       }
     }
     if (end) {
-      end.addEventListener('keydown', handleArrowDown);
+      end.addEventListener('keydown', handleInputFieldKeyDown);
       end.addEventListener('change', handleOnChange);
       end.addEventListener('keypress', handleKeyPress);
     }
+    if (calendar.calendarContainer) {
+      calendar.calendarContainer.addEventListener('keydown', handleCalendarKeyDown);
+    }
 
     //component did unmount equivalent
     return () => {
@@ -462,14 +493,17 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
         }
       }
       if (start) {
-        start.removeEventListener('keydown', handleArrowDown);
+        start.removeEventListener('keydown', handleInputFieldKeyDown);
         start.removeEventListener('change', handleOnChange);
         start.removeEventListener('keypress', handleKeyPress);
       }
       if (end) {
-        end.removeEventListener('keydown', handleArrowDown);
+        end.removeEventListener('keydown', handleInputFieldKeyDown);
         end.removeEventListener('change', handleOnChange);
-        end.removeEventListener('change', handleKeyPress);
+        end.removeEventListener('keypress', handleKeyPress);
+      }
+      if (calendar.calendarContainer) {
+        calendar.calendarContainer.removeEventListener('keydown', handleCalendarKeyDown);
       }
     };
     // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -566,17 +600,6 @@ const DatePicker = /*#__PURE__*/React__default["default"].forwardRef(function Da
     }
   }, [value, prefix]); //eslint-disable-line react-hooks/exhaustive-deps
 
-  React.useEffect(() => {
-    if (!calendarRef.current || !startInputField.current) return;
-    const handleKeyDown = event => {
-      if (match.match(event, keys.Tab) && !event.shiftKey && document.activeElement === endInputField.current && calendarRef.current?.isOpen) {
-        calendarRef.current.close();
-        onCalendarClose(calendarRef.current.selectedDates, '', calendarRef.current, event);
-      }
-    };
-    document.addEventListener('keydown', handleKeyDown, true);
-    return () => document.removeEventListener('keydown', handleKeyDown, true);
-  }, [calendarRef, startInputField, endInputField, onCalendarClose]);
   let fluidError;
   if (isFluid) {
     if (invalid) {

package/lib/components/DatePickerInput/DatePickerInput.d.ts

@@ -1,16 +1,15 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2025
  *
  * 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 { ReactElementLike } from 'prop-types';
-import React, { ReactNode } from 'react';
-import { ReactAttr } from '../../types/common';
+import React, { type HTMLAttributes, type ReactNode } from 'react';
 type ExcludedAttributes = 'value' | 'onChange' | 'locale' | 'children';
 export type ReactNodeLike = ReactElementLike | ReadonlyArray<ReactNode> | string | number | boolean | null | undefined;
 export type func = (...args: any[]) => any;
-export interface DatePickerInputProps extends Omit<ReactAttr<HTMLInputElement>, ExcludedAttributes> {
+export interface DatePickerInputProps extends Omit<HTMLAttributes<HTMLInputElement>, ExcludedAttributes> {
     /**
      * The type of the date picker:
      *

package/lib/components/DatePickerInput/DatePickerInput.js

@@ -237,12 +237,11 @@ DatePickerInput.propTypes = {
    */
   warnText: PropTypes__default["default"].node
 };
-function DatePickerIcon(_ref) {
-  let {
-    datePickerType,
-    invalid,
-    warn
-  } = _ref;
+function DatePickerIcon({
+  datePickerType,
+  invalid,
+  warn
+}) {
   const prefix = usePrefix.usePrefix();
   const {
     isFluid

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

@@ -4,9 +4,14 @@
  * 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';
-import { ReactAttr } from '../../types/common';
-export interface DialogProps extends ReactAttr<HTMLDialogElement> {
+import React, { type HTMLAttributes } from 'react';
+import { InlineLoadingStatus } from '../InlineLoading/InlineLoading';
+/**
+ * ----------
+ * Dialog
+ * ----------
+ */
+interface DialogProps extends HTMLAttributes<HTMLDialogElement> {
     /**
      * Provide the contents of the Dialog
      */
@@ -43,26 +48,205 @@ export interface DialogProps extends ReactAttr<HTMLDialogElement> {
      * Specify whether the Dialog is currently open
      */
     open?: boolean;
+    /**
+     * Specify the role of the dialog for accessibility
+     * 'dialog' is the default, but 'alertdialog' can be used for important messages requiring user attention
+     */
+    role?: '' | 'alertdialog';
+    /**
+     * Specify a label for screen readers
+     */
+    ariaLabel?: string;
+    /**
+     * Specify the ID of an element that labels this dialog
+     */
+    ariaLabelledBy?: string;
+    /**
+     * Specify the ID of an element that describes this dialog
+     */
+    ariaDescribedBy?: string;
 }
-export declare const unstable__Dialog: React.ForwardRefExoticComponent<DialogProps & React.RefAttributes<unknown>>;
-export interface DialogHeaderProps extends ReactAttr<HTMLDivElement> {
+declare const unstable__Dialog: React.ForwardRefExoticComponent<DialogProps & React.RefAttributes<unknown>>;
+/**
+ * -------------
+ * DialogHeader
+ * -------------
+ */
+interface DialogHeaderProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * Provide the contents to be rendered inside of this component
      */
     children?: React.ReactNode;
 }
-export declare const DialogHeader: React.ForwardRefExoticComponent<DialogHeaderProps & React.RefAttributes<HTMLDivElement>>;
-export interface DialogControlsProps extends ReactAttr<HTMLDivElement> {
+declare const DialogHeader: React.ForwardRefExoticComponent<DialogHeaderProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * ---------------
+ * DialogControls
+ * ---------------
+ */
+interface DialogControlsProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * Provide the contents to be rendered inside of this component
      */
     children?: React.ReactNode;
 }
-export declare const DialogControls: React.ForwardRefExoticComponent<DialogControlsProps & React.RefAttributes<HTMLDivElement>>;
-export interface DialogCloseButtonProps extends ReactAttr<HTMLDivElement> {
+declare const DialogControls: React.ForwardRefExoticComponent<DialogControlsProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * -------------------
+ * DialogCloseButton
+ * -------------------
+ */
+interface DialogCloseButtonProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * Specify a click handler applied to the IconButton
      */
     onClick?: React.MouseEventHandler;
 }
-export declare const DialogCloseButton: React.ForwardRefExoticComponent<DialogCloseButtonProps & React.RefAttributes<HTMLDivElement>>;
+declare const DialogCloseButton: React.ForwardRefExoticComponent<DialogCloseButtonProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * ------------
+ * DialogTitle
+ * ------------
+ */
+interface DialogTitleProps extends HTMLAttributes<HTMLHeadingElement> {
+    /**
+     * Provide the contents of the DialogTitle
+     */
+    children?: React.ReactNode;
+    /**
+     * Specify an optional className to be applied to the title node
+     */
+    className?: string;
+    /**
+     * Specify an optional id for the title element
+     */
+    id?: string;
+}
+declare const DialogTitle: React.ForwardRefExoticComponent<DialogTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * ---------------
+ * DialogSubtitle
+ * ---------------
+ */
+interface DialogSubtitleProps extends HTMLAttributes<HTMLParagraphElement> {
+    /**
+     * Provide the contents of the DialogSubtitle
+     */
+    children?: React.ReactNode;
+    /**
+     * Specify an optional className to be applied to the subtitle node
+     */
+    className?: string;
+    /**
+     * Specify an optional id for the subtitle element
+     */
+    id?: string;
+}
+declare const DialogSubtitle: React.ForwardRefExoticComponent<DialogSubtitleProps & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * -----------
+ * DialogBody
+ * -----------
+ */
+interface DialogBodyProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Provide the contents of the DialogBody
+     */
+    children?: React.ReactNode;
+    /**
+     * Specify an optional className to be applied to the body node
+     */
+    className?: string;
+    /**
+     * Specify whether the content has overflow that should be scrollable
+     */
+    hasScrollingContent?: boolean;
+}
+declare const DialogBody: React.ForwardRefExoticComponent<DialogBodyProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * -------------
+ * DialogFooter
+ * -------------
+ */
+interface DialogFooterProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Provide the contents of the DialogFooter
+     */
+    children?: React.ReactNode;
+    /**
+     * Specify an optional className to be applied to the footer node
+     */
+    className?: string;
+    /**
+     * Specify a handler for closing dialog (secondary button)
+     */
+    onRequestClose?: React.ReactEventHandler<HTMLElement>;
+    /**
+     * Specify a handler for the secondary button.
+     * Useful if separate handler from `onRequestClose` is desirable
+     */
+    onSecondarySubmit?: React.ReactEventHandler<HTMLElement>;
+    /**
+     * Specify a handler for submitting dialog (primary button)
+     */
+    onRequestSubmit?: React.ReactEventHandler<HTMLElement>;
+    /**
+     * Specify the text for the primary button
+     */
+    primaryButtonText?: React.ReactNode;
+    /**
+     * Specify whether the Button should be disabled, or not
+     */
+    primaryButtonDisabled?: boolean;
+    /**
+     * Specify the text for the secondary button
+     */
+    secondaryButtonText?: React.ReactNode;
+    /**
+     * Specify an array of config objects for secondary buttons
+     */
+    secondaryButtons?: Array<{
+        buttonText: React.ReactNode;
+        onClick: React.MouseEventHandler<HTMLButtonElement>;
+    }>;
+    /**
+     * Specify whether the Dialog is for dangerous actions
+     */
+    danger?: boolean;
+    /**
+     * Specify loading status
+     */
+    loadingStatus?: InlineLoadingStatus;
+    /**
+     * Specify the description for the loading text
+     */
+    loadingDescription?: string;
+    /**
+     * Specify the description for the loading icon
+     */
+    loadingIconDescription?: string;
+    /**
+     * Specify an optional handler to be invoked when loading is
+     * successful
+     */
+    onLoadingSuccess?: () => void;
+}
+declare const DialogFooter: React.ForwardRefExoticComponent<DialogFooterProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * -------
+ * Exports
+ * -------
+ */
+type DialogComponentType = typeof unstable__Dialog & {
+    Root: typeof unstable__Dialog;
+    Header: typeof DialogHeader;
+    Controls: typeof DialogControls;
+    CloseButton: typeof DialogCloseButton;
+    Title: typeof DialogTitle;
+    Subtitle: typeof DialogSubtitle;
+    Body: typeof DialogBody;
+    Footer: typeof DialogFooter;
+};
+declare const Dialog: DialogComponentType;
+export { Dialog, unstable__Dialog, DialogHeader, DialogControls, DialogCloseButton, DialogTitle, DialogSubtitle, DialogBody, DialogFooter, };
+export type { DialogProps, DialogHeaderProps, DialogControlsProps, DialogCloseButtonProps, DialogTitleProps, DialogSubtitleProps, DialogBodyProps, DialogFooterProps, };