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

package/es/components/Notification/Notification.js

@@ -7,7 +7,7 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default, { useState, useRef, useEffect } from 'react';
+import React, { useState, useRef, useEffect } from 'react';
 import deprecate from '../../prop-types/deprecate.js';
 import cx from 'classnames';
 import { Close, ErrorFilled, CheckmarkFilled, WarningFilled, WarningAltFilled, InformationFilled, InformationSquareFilled } from '@carbon/icons-react';
@@ -33,8 +33,7 @@ import { Text } from '../Text/Text.js';
  * @param {func} callback - function to be called
  * @param {bool} override - escape hatch to conditionally call the callback
  */
-function useEscapeToClose(ref, callback) {
-  let override = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+function useEscapeToClose(ref, callback, override = true) {
   const handleKeyDown = event => {
     // The callback should only be called when focus is on or within the container
     const elementContainsFocus = ref.current && document.activeElement === ref.current || ref.current?.contains(document.activeElement);
@@ -49,19 +48,18 @@ function useEscapeToClose(ref, callback) {
     return () => document.removeEventListener('keydown', handleKeyDown, false);
   });
 }
-function NotificationActionButton(_ref) {
-  let {
-    children,
-    className: customClassName,
-    onClick,
-    inline,
-    ...rest
-  } = _ref;
+function NotificationActionButton({
+  children,
+  className: customClassName,
+  onClick,
+  inline,
+  ...rest
+}) {
   const prefix = usePrefix();
   const className = cx(customClassName, {
     [`${prefix}--actionable-notification__action-button`]: true
   });
-  return /*#__PURE__*/React__default.createElement(Button, _extends({
+  return /*#__PURE__*/React.createElement(Button, _extends({
     className: className,
     kind: inline ? 'ghost' : 'tertiary',
     onClick: onClick,
@@ -92,17 +90,16 @@ NotificationActionButton.propTypes = {
  * ==================
  */
 
-function NotificationButton(_ref2) {
-  let {
-    'aria-label': ariaLabel = 'close notification',
-    ariaLabel: deprecatedAriaLabel,
-    className,
-    type = 'button',
-    renderIcon: IconTag = Close,
-    name,
-    notificationType = 'toast',
-    ...rest
-  } = _ref2;
+function NotificationButton({
+  'aria-label': ariaLabel = 'close notification',
+  ariaLabel: deprecatedAriaLabel,
+  className,
+  type = 'button',
+  renderIcon: IconTag = Close,
+  name,
+  notificationType = 'toast',
+  ...rest
+}) {
   const prefix = usePrefix();
   const buttonClassName = cx(className, {
     [`${prefix}--${notificationType}-notification__close-button`]: notificationType
@@ -110,13 +107,13 @@ function NotificationButton(_ref2) {
   const iconClassName = cx({
     [`${prefix}--${notificationType}-notification__close-icon`]: notificationType
   });
-  return /*#__PURE__*/React__default.createElement("button", _extends({}, rest, {
+  return /*#__PURE__*/React.createElement("button", _extends({}, rest, {
     // eslint-disable-next-line react/button-has-type
     type: type,
     "aria-label": deprecatedAriaLabel || ariaLabel,
     title: deprecatedAriaLabel || ariaLabel,
     className: buttonClassName
-  }), IconTag && /*#__PURE__*/React__default.createElement(IconTag, {
+  }), IconTag && /*#__PURE__*/React.createElement(IconTag, {
     className: iconClassName,
     name: name
   }));
@@ -167,21 +164,20 @@ const iconTypes = {
   info: InformationFilled,
   ['info-square']: InformationSquareFilled
 };
-function NotificationIcon(_ref3) {
-  let {
-    iconDescription,
-    kind,
-    notificationType
-  } = _ref3;
+function NotificationIcon({
+  iconDescription,
+  kind,
+  notificationType
+}) {
   const prefix = usePrefix();
   const IconForKind = iconTypes[kind];
   if (!IconForKind) {
     return null;
   }
-  return /*#__PURE__*/React__default.createElement(IconForKind, {
+  return /*#__PURE__*/React.createElement(IconForKind, {
     className: `${prefix}--${notificationType}-notification__icon`,
     size: 20
-  }, /*#__PURE__*/React__default.createElement("title", null, iconDescription));
+  }, /*#__PURE__*/React.createElement("title", null, iconDescription));
 }
 NotificationIcon.propTypes = {
   iconDescription: PropTypes.string.isRequired,
@@ -194,26 +190,25 @@ NotificationIcon.propTypes = {
  * =================
  */
 
-function ToastNotification(_ref4) {
-  let {
-    ['aria-label']: ariaLabel,
-    // @ts-expect-error: deprecated prop
-    ariaLabel: deprecatedAriaLabel,
-    role = 'status',
-    onClose,
-    onCloseButtonClick = noopFn,
-    statusIconDescription,
-    className,
-    children,
-    kind = 'error',
-    lowContrast,
-    hideCloseButton = false,
-    timeout = 0,
-    title,
-    caption,
-    subtitle,
-    ...rest
-  } = _ref4;
+function ToastNotification({
+  ['aria-label']: ariaLabel,
+  // @ts-expect-error: deprecated prop
+  ariaLabel: deprecatedAriaLabel,
+  role = 'status',
+  onClose,
+  onCloseButtonClick = noopFn,
+  statusIconDescription,
+  className,
+  children,
+  kind = 'error',
+  lowContrast,
+  hideCloseButton = false,
+  timeout = 0,
+  title,
+  caption,
+  subtitle,
+  ...rest
+}) {
   const [isOpen, setIsOpen] = useState(true);
   const prefix = usePrefix();
   const containerClassName = cx(className, {
@@ -254,28 +249,28 @@ function ToastNotification(_ref4) {
   if (!isOpen) {
     return null;
   }
-  return /*#__PURE__*/React__default.createElement("div", _extends({
+  return /*#__PURE__*/React.createElement("div", _extends({
     ref: ref
   }, rest, {
     role: role,
     className: containerClassName
-  }), /*#__PURE__*/React__default.createElement(NotificationIcon, {
+  }), /*#__PURE__*/React.createElement(NotificationIcon, {
     notificationType: "toast",
     kind: kind,
     iconDescription: statusIconDescription || `${kind} icon`
-  }), /*#__PURE__*/React__default.createElement("div", {
+  }), /*#__PURE__*/React.createElement("div", {
     ref: contentRef,
     className: `${prefix}--toast-notification__details`
-  }, title && /*#__PURE__*/React__default.createElement(Text, {
+  }, title && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     className: `${prefix}--toast-notification__title`
-  }, title), subtitle && /*#__PURE__*/React__default.createElement(Text, {
+  }, title), subtitle && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     className: `${prefix}--toast-notification__subtitle`
-  }, subtitle), caption && /*#__PURE__*/React__default.createElement(Text, {
+  }, subtitle), caption && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     className: `${prefix}--toast-notification__caption`
-  }, caption), children), !hideCloseButton && /*#__PURE__*/React__default.createElement(NotificationButton, {
+  }, caption), children), !hideCloseButton && /*#__PURE__*/React.createElement(NotificationButton, {
     notificationType: "toast",
     onClick: handleCloseButtonClick,
     "aria-label": deprecatedAriaLabel || ariaLabel
@@ -351,22 +346,21 @@ ToastNotification.propTypes = {
  * ==================
  */
 
-function InlineNotification(_ref5) {
-  let {
-    ['aria-label']: ariaLabel,
-    children,
-    title,
-    subtitle,
-    role = 'status',
-    onClose,
-    onCloseButtonClick = noopFn,
-    statusIconDescription,
-    className,
-    kind = 'error',
-    lowContrast,
-    hideCloseButton = false,
-    ...rest
-  } = _ref5;
+function InlineNotification({
+  ['aria-label']: ariaLabel,
+  children,
+  title,
+  subtitle,
+  role = 'status',
+  onClose,
+  onCloseButtonClick = noopFn,
+  statusIconDescription,
+  className,
+  kind = 'error',
+  lowContrast,
+  hideCloseButton = false,
+  ...rest
+}) {
   const [isOpen, setIsOpen] = useState(true);
   const prefix = usePrefix();
   const containerClassName = cx(className, {
@@ -390,27 +384,27 @@ function InlineNotification(_ref5) {
   if (!isOpen) {
     return null;
   }
-  return /*#__PURE__*/React__default.createElement("div", _extends({
+  return /*#__PURE__*/React.createElement("div", _extends({
     ref: ref
   }, rest, {
     role: role,
     className: containerClassName
-  }), /*#__PURE__*/React__default.createElement("div", {
+  }), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--inline-notification__details`
-  }, /*#__PURE__*/React__default.createElement(NotificationIcon, {
+  }, /*#__PURE__*/React.createElement(NotificationIcon, {
     notificationType: "inline",
     kind: kind,
     iconDescription: statusIconDescription || `${kind} icon`
-  }), /*#__PURE__*/React__default.createElement("div", {
+  }), /*#__PURE__*/React.createElement("div", {
     ref: contentRef,
     className: `${prefix}--inline-notification__text-wrapper`
-  }, title && /*#__PURE__*/React__default.createElement(Text, {
+  }, title && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     className: `${prefix}--inline-notification__title`
-  }, title), subtitle && /*#__PURE__*/React__default.createElement(Text, {
+  }, title), subtitle && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     className: `${prefix}--inline-notification__subtitle`
-  }, subtitle), children)), !hideCloseButton && /*#__PURE__*/React__default.createElement(NotificationButton, {
+  }, subtitle), children)), !hideCloseButton && /*#__PURE__*/React.createElement(NotificationButton, {
     notificationType: "inline",
     onClick: handleCloseButtonClick,
     "aria-label": ariaLabel
@@ -473,29 +467,28 @@ InlineNotification.propTypes = {
  * ======================
  */
 
-function ActionableNotification(_ref6) {
-  let {
-    actionButtonLabel,
-    ['aria-label']: ariaLabel,
-    // @ts-expect-error: deprecated prop
-    ariaLabel: deprecatedAriaLabel,
-    children,
-    role = 'alertdialog',
-    onActionButtonClick,
-    onClose,
-    onCloseButtonClick = noopFn,
-    statusIconDescription,
-    className,
-    inline = false,
-    kind = 'error',
-    lowContrast,
-    hideCloseButton = false,
-    hasFocus = true,
-    closeOnEscape = true,
-    title,
-    subtitle,
-    ...rest
-  } = _ref6;
+function ActionableNotification({
+  actionButtonLabel,
+  ['aria-label']: ariaLabel,
+  // @ts-expect-error: deprecated prop
+  ariaLabel: deprecatedAriaLabel,
+  children,
+  role = 'alertdialog',
+  onActionButtonClick,
+  onClose,
+  onCloseButtonClick = noopFn,
+  statusIconDescription,
+  className,
+  inline = false,
+  kind = 'error',
+  lowContrast,
+  hideCloseButton = false,
+  hasFocus = true,
+  closeOnEscape = true,
+  title,
+  subtitle,
+  ...rest
+}) {
   const [isOpen, setIsOpen] = useState(true);
   const prefix = usePrefix();
   const id = useId('actionable-notification');
@@ -518,11 +511,10 @@ function ActionableNotification(_ref6) {
       button?.focus();
     }
   });
-  function handleBlur(_ref7) {
-    let {
-      target: oldActiveNode,
-      relatedTarget: currentActiveNode
-    } = _ref7;
+  function handleBlur({
+    target: oldActiveNode,
+    relatedTarget: currentActiveNode
+  }) {
     if (isOpen && currentActiveNode && oldActiveNode && role === 'alertdialog') {
       const {
         current: bodyNode
@@ -564,47 +556,47 @@ function ActionableNotification(_ref6) {
   if (!isOpen) {
     return null;
   }
-  return /*#__PURE__*/React__default.createElement("div", _extends({}, rest, {
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
     ref: ref,
     role: role,
     className: containerClassName,
     "aria-labelledby": title ? id : subtitleId,
     onBlur: !focusTrapWithoutSentinels ? handleBlur : () => {},
     onKeyDown: focusTrapWithoutSentinels ? handleKeyDown : () => {}
-  }), !focusTrapWithoutSentinels && /*#__PURE__*/React__default.createElement("span", {
+  }), !focusTrapWithoutSentinels && /*#__PURE__*/React.createElement("span", {
     ref: startTrap,
     tabIndex: 0,
     role: "link",
     className: `${prefix}--visually-hidden`
-  }, "Focus sentinel"), /*#__PURE__*/React__default.createElement("div", {
+  }, "Focus sentinel"), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--actionable-notification__details`
-  }, /*#__PURE__*/React__default.createElement(NotificationIcon, {
+  }, /*#__PURE__*/React.createElement(NotificationIcon, {
     notificationType: inline ? 'inline' : 'toast',
     kind: kind,
     iconDescription: statusIconDescription || `${kind} icon`
-  }), /*#__PURE__*/React__default.createElement("div", {
+  }), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--actionable-notification__text-wrapper`
-  }, /*#__PURE__*/React__default.createElement("div", {
+  }, /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--actionable-notification__content`
-  }, title && /*#__PURE__*/React__default.createElement(Text, {
+  }, title && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     className: `${prefix}--actionable-notification__title`,
     id: id
-  }, title), subtitle && /*#__PURE__*/React__default.createElement(Text, {
+  }, title), subtitle && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     className: `${prefix}--actionable-notification__subtitle`,
     id: subtitleId
-  }, subtitle), children))), /*#__PURE__*/React__default.createElement("div", {
+  }, subtitle), children))), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--actionable-notification__button-wrapper`,
     ref: innerModal
-  }, actionButtonLabel && /*#__PURE__*/React__default.createElement(NotificationActionButton, {
+  }, actionButtonLabel && /*#__PURE__*/React.createElement(NotificationActionButton, {
     onClick: onActionButtonClick,
     inline: inline
-  }, actionButtonLabel), !hideCloseButton && /*#__PURE__*/React__default.createElement(NotificationButton, {
+  }, actionButtonLabel), !hideCloseButton && /*#__PURE__*/React.createElement(NotificationButton, {
     "aria-label": deprecatedAriaLabel || ariaLabel,
     notificationType: "actionable",
     onClick: handleCloseButtonClick
-  })), !focusTrapWithoutSentinels && /*#__PURE__*/React__default.createElement("span", {
+  })), !focusTrapWithoutSentinels && /*#__PURE__*/React.createElement("span", {
     ref: endTrap,
     tabIndex: 0,
     role: "link",
@@ -708,20 +700,19 @@ const propMappingFunction = deprecatedValue => {
   };
   return mapping[deprecatedValue];
 };
-function Callout(_ref8) {
-  let {
-    actionButtonLabel,
-    children,
-    onActionButtonClick,
-    title,
-    titleId,
-    subtitle,
-    statusIconDescription,
-    className,
-    kind = 'info',
-    lowContrast,
-    ...rest
-  } = _ref8;
+function Callout({
+  actionButtonLabel,
+  children,
+  onActionButtonClick,
+  title,
+  titleId,
+  subtitle,
+  statusIconDescription,
+  className,
+  kind = 'info',
+  lowContrast,
+  ...rest
+}) {
   const prefix = usePrefix();
   const containerClassName = cx(className, {
     [`${prefix}--actionable-notification`]: true,
@@ -731,27 +722,27 @@ function Callout(_ref8) {
   });
   const childrenContainer = useRef(null);
   useInteractiveChildrenNeedDescription(childrenContainer, `interactive child node(s) should have an \`aria-describedby\` property with a value matching the value of \`titleId\``);
-  return /*#__PURE__*/React__default.createElement("div", _extends({}, rest, {
+  return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
     className: containerClassName
-  }), /*#__PURE__*/React__default.createElement("div", {
+  }), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--actionable-notification__details`
-  }, /*#__PURE__*/React__default.createElement(NotificationIcon, {
+  }, /*#__PURE__*/React.createElement(NotificationIcon, {
     notificationType: "inline",
     kind: kind,
     iconDescription: statusIconDescription || `${kind} icon`
-  }), /*#__PURE__*/React__default.createElement("div", {
+  }), /*#__PURE__*/React.createElement("div", {
     ref: childrenContainer,
     className: `${prefix}--actionable-notification__text-wrapper`
-  }, title && /*#__PURE__*/React__default.createElement(Text, {
+  }, title && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     id: titleId,
     className: `${prefix}--actionable-notification__title`
-  }, title), subtitle && /*#__PURE__*/React__default.createElement(Text, {
+  }, title), subtitle && /*#__PURE__*/React.createElement(Text, {
     as: "div",
     className: `${prefix}--actionable-notification__subtitle`
-  }, subtitle), children)), /*#__PURE__*/React__default.createElement("div", {
+  }, subtitle), children)), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--actionable-notification__button-wrapper`
-  }, actionButtonLabel && /*#__PURE__*/React__default.createElement(NotificationActionButton, {
+  }, actionButtonLabel && /*#__PURE__*/React.createElement(NotificationActionButton, {
     onClick: onActionButtonClick,
     "aria-describedby": titleId,
     inline: true
@@ -816,7 +807,7 @@ const StaticNotification = props => {
     process.env.NODE_ENV !== "production" ? warning(didWarnAboutDeprecation, '`StaticNotification` has been renamed to `Callout`.' + 'Run the following codemod to automatically update usages in your' + 'project: `npx @carbon/upgrade migrate refactor-to-callout --write`') : void 0;
     didWarnAboutDeprecation = true;
   }
-  return /*#__PURE__*/React__default.createElement(Callout, props);
+  return /*#__PURE__*/React.createElement(Callout, props);
 };
 
 export { ActionableNotification, Callout, InlineNotification, NotificationActionButton, NotificationButton, StaticNotification, ToastNotification };

package/es/components/NumberInput/NumberFormatPropTypes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright IBM Corp. 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 PropTypes from 'prop-types';
+export declare const NumberFormatOptionsPropType: PropTypes.Requireable<PropTypes.InferProps<{
+    localeMatcher: PropTypes.Requireable<string>;
+    style: PropTypes.Requireable<string>;
+    currency: PropTypes.Requireable<string>;
+    currencyDisplay: PropTypes.Requireable<string>;
+    currencySign: PropTypes.Requireable<string>;
+    unit: PropTypes.Requireable<string>;
+    unitDisplay: PropTypes.Requireable<string>;
+    notation: PropTypes.Requireable<string>;
+    compactDisplay: PropTypes.Requireable<string>;
+    signDisplay: PropTypes.Requireable<string>;
+    minimumIntegerDigits: PropTypes.Requireable<number>;
+    minimumFractionDigits: PropTypes.Requireable<number>;
+    maximumFractionDigits: PropTypes.Requireable<number>;
+    minimumSignificantDigits: PropTypes.Requireable<number>;
+    maximumSignificantDigits: PropTypes.Requireable<number>;
+    useGrouping: PropTypes.Requireable<NonNullable<string | boolean | null | undefined>>;
+    numberingSystem: PropTypes.Requireable<string>;
+    roundingIncrement: PropTypes.Requireable<number>;
+    roundingMode: PropTypes.Requireable<string>;
+    trailingZeroDisplay: PropTypes.Requireable<string>;
+}>>;

package/es/components/NumberInput/NumberFormatPropTypes.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.
+ */
+
+import PropTypes from 'prop-types';
+
+const NumberFormatOptionsPropType = PropTypes.shape({
+  // Locale Options
+  localeMatcher: PropTypes.oneOf(['best fit', 'lookup']),
+  // Style Options
+  style: PropTypes.oneOf(['decimal', 'currency', 'percent', 'unit']),
+  currency: PropTypes.string,
+  // e.g., 'USD'
+  currencyDisplay: PropTypes.oneOf(['symbol', 'narrowSymbol', 'code', 'name']),
+  currencySign: PropTypes.oneOf(['standard', 'accounting']),
+  unit: PropTypes.string,
+  // e.g., 'liter', 'mile-per-hour'
+  unitDisplay: PropTypes.oneOf(['short', 'narrow', 'long']),
+  notation: PropTypes.oneOf(['standard', 'scientific', 'engineering', 'compact']),
+  compactDisplay: PropTypes.oneOf(['short', 'long']),
+  signDisplay: PropTypes.oneOf(['auto', 'never', 'always', 'exceptZero']),
+  // Digit Options
+  minimumIntegerDigits: PropTypes.number,
+  minimumFractionDigits: PropTypes.number,
+  maximumFractionDigits: PropTypes.number,
+  minimumSignificantDigits: PropTypes.number,
+  maximumSignificantDigits: PropTypes.number,
+  useGrouping: PropTypes.oneOfType([PropTypes.bool, PropTypes.oneOf(['always', 'auto', 'min2'])]),
+  // Misc/Other Options
+  numberingSystem: PropTypes.string,
+  // e.g., 'latn', 'arab'
+  roundingIncrement: PropTypes.number,
+  roundingMode: PropTypes.oneOf(['ceil', 'floor', 'expand', 'trunc', 'halfCeil', 'halfFloor', 'halfExpand', 'halfTrunc', 'halfEven']),
+  trailingZeroDisplay: PropTypes.oneOf(['auto', 'stripIfInteger'])
+});
+
+export { NumberFormatOptionsPropType };

package/es/components/NumberInput/NumberInput.Skeleton.js

@@ -7,23 +7,22 @@
 
 import { extends as _extends } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import PropTypes from 'prop-types';
-import React__default from 'react';
+import React from 'react';
 import cx from 'classnames';
 import { usePrefix } from '../../internal/usePrefix.js';
 
-function NumberInputSkeleton(_ref) {
-  let {
-    hideLabel,
-    className,
-    size = 'md',
-    ...rest
-  } = _ref;
+function NumberInputSkeleton({
+  hideLabel,
+  className,
+  size = 'md',
+  ...rest
+}) {
   const prefix = usePrefix();
-  return /*#__PURE__*/React__default.createElement("div", _extends({
+  return /*#__PURE__*/React.createElement("div", _extends({
     className: cx(`${prefix}--form-item`, className)
-  }, rest), !hideLabel && /*#__PURE__*/React__default.createElement("span", {
+  }, rest), !hideLabel && /*#__PURE__*/React.createElement("span", {
     className: `${prefix}--label ${prefix}--skeleton`
-  }), /*#__PURE__*/React__default.createElement("div", {
+  }), /*#__PURE__*/React.createElement("div", {
     className: `${prefix}--number ${prefix}--skeleton ${prefix}--number--${size}`
   }));
 }