@transferwise/components 0.0.0-experimental-da6dbbf → 0.0.0-experimental-3118bd2

package/build/index.mjs

@@ -1,9 +1,8 @@
 import * as React from 'react';
-import React__default, { forwardRef, cloneElement, useState, useEffect, useRef, useMemo, Component, createContext, useContext, useCallback, useImperativeHandle, createElement, PureComponent, createRef, isValidElement, Children, Fragment as Fragment$1 } from 'react';
-import { useId } from '@radix-ui/react-id';
+import React__default, { forwardRef, useId, cloneElement, useState, useEffect, useRef, useMemo, Component, useCallback, createContext, useContext, useSyncExternalStore, useImperativeHandle, createElement, PureComponent, createRef, isValidElement, Children, Fragment as Fragment$1 } from 'react';
 import classNames from 'classnames';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { ChevronUp, CrossCircleFill, Cross, NavigateAway, Check, Info as Info$1, Alert as Alert$1, ClockBorderless, Briefcase, Person, ArrowRight, Download, ChevronLeft, ChevronRight, AlertCircleFill, ArrowLeft, AlertCircle, QuestionMarkCircle, Search, CrossCircle, ChevronDown, CheckCircleFill, ClockFill, Upload as Upload$2, Document, Plus, PlusCircle } from '@transferwise/icons';
+import { ChevronUp, CrossCircleFill, Cross, NavigateAway, Check, Info as Info$1, Alert as Alert$1, ClockBorderless, Briefcase, Person, AlertCircleFill, AlertCircle, ArrowLeft, QuestionMarkCircle, Search, CrossCircle, ChevronDown, CheckCircleFill, ArrowRight, Download, ClockFill, Upload as Upload$2, Document, Plus, PlusCircle } from '@transferwise/icons';
 import { defineMessages, useIntl, injectIntl, IntlProvider } from 'react-intl';
 import PropTypes from 'prop-types';
 import commonmark from 'commonmark';
@@ -11,7 +10,6 @@ import { useTheme, ThemeProvider } from '@wise/components-theming';
 import { CSSTransition } from 'react-transition-group';
 import { FocusScope } from '@react-aria/focus';
 import { createPortal } from 'react-dom';
-import { useSyncExternalStore } from 'use-sync-external-store/shim/index.js';
 import { isUndefined, isNumber, isEmpty, isNull } from '@transferwise/neptune-validation';
 import { formatDate, formatMoney, formatAmount } from '@transferwise/formatting';
 import { Transition, Listbox } from '@headlessui/react';
@@ -1238,68 +1236,67 @@ const radius = {
 };
 const ANIMATION_DURATION_IN_MS = 1500;
 class ProcessIndicator extends Component {
+  static defaultProps = {
+    status: 'processing',
+    size: 'sm'
+  };
+  interval = 0;
+  timeout = 0;
   constructor(props) {
     super(props);
     this.state = {
       status: props.status,
       size: props.size
     };
-    this.interval = null;
-    this.timeout = null;
   }
-
   /**
    * Create interval for animation duration (1500ms)
    * Update state only at the end of every interval
    * (end of animation loop) if props changed before end of animation
    */
   componentDidMount() {
-    this.interval = setInterval(() => {
-      const statusFromState = this.state.status;
-      const sizeFromState = this.state.size;
-      const statusFromProps = this.props.status;
-      const sizeFromProps = this.props.size;
-      if (statusFromState !== statusFromProps) {
+    this.interval = window.setInterval(() => {
+      const {
+        status: targetStatus,
+        size: targetSize,
+        onAnimationCompleted
+      } = this.props;
+      const {
+        status: currentStatus,
+        size: currentSize
+      } = this.state;
+      if (currentStatus !== targetStatus) {
         this.setState({
-          status: statusFromProps
-        }, this.runCallBack(statusFromProps));
+          status: targetStatus
+        }, () => {
+          if (onAnimationCompleted) {
+            this.timeout = window.setTimeout(() => {
+              onAnimationCompleted(targetStatus);
+            }, ANIMATION_DURATION_IN_MS);
+          }
+        });
       }
-      if (sizeFromState !== sizeFromProps) {
+      if (currentSize !== targetSize) {
         this.setState({
-          size: sizeFromProps
+          size: targetSize
         });
       }
     }, ANIMATION_DURATION_IN_MS);
   }
-
   /**
    * Only trigger render if comopnent's state got
    * updated from interval callback
-   *
-   * @param nextProps
-   * @param nextState
    */
   shouldComponentUpdate(nextProps, nextState) {
     const isSameStatus = nextProps.status === nextState.status;
     const isSameSize = nextProps.size === nextState.size;
     return isSameStatus && isSameSize;
   }
-
   // Clear interval before destroying component
   componentWillUnmount() {
-    clearInterval(this.interval);
-    clearTimeout(this.timeout);
+    window.clearInterval(this.interval);
+    window.clearTimeout(this.timeout);
   }
-  runCallBack = statusFromProps => {
-    const {
-      onAnimationCompleted
-    } = this.props;
-    if (onAnimationCompleted) {
-      this.timeouts = setTimeout(() => {
-        onAnimationCompleted(statusFromProps);
-      }, ANIMATION_DURATION_IN_MS);
-    }
-  };
   render() {
     const {
       className,
@@ -1330,28 +1327,13 @@ class ProcessIndicator extends Component {
           className: "process-circle",
           cx: "50%",
           cy: "50%",
-          r: radius[this.state.size],
+          r: radius[size],
           fillOpacity: "0.0"
         })
       })]
     });
   }
 }
-ProcessIndicator.propTypes = {
-  status: PropTypes.oneOf(['processing', 'failed', 'succeeded', 'hidden']),
-  size: PropTypes.oneOf(['xxs', 'xs', 'sm', 'xl']),
-  onAnimationCompleted: PropTypes.func,
-  className: PropTypes.string,
-  'data-testid': PropTypes.string
-};
-ProcessIndicator.defaultProps = {
-  status: Status.PROCESSING,
-  size: Size.SMALL,
-  onAnimationCompleted: null,
-  className: undefined,
-  'data-testid': null
-};
-var ProcessIndicator$1 = ProcessIndicator;
 
 var messages$b = defineMessages({
   loadingAriaLabel: {
@@ -1459,738 +1441,28 @@ const Button = /*#__PURE__*/forwardRef(({
     } = rest;
     props = {
       ...restProps,
-      disabled: disabled || loading,
-      type: htmlType
-    };
-  } else {
-    props = {
-      ...rest
-    };
-  }
-  return /*#__PURE__*/jsxs(Element, {
-    ref: reference,
-    className: classes,
-    ...props,
-    "aria-live": loading ? 'polite' : 'off',
-    "aria-label": loading ? intl.formatMessage(messages$b.loadingAriaLabel) : rest['aria-label'],
-    children: [children, loading && /*#__PURE__*/jsx(ProcessIndicator$1, {
-      size: processIndicatorSize(),
-      className: "btn-loader"
-    })]
-  });
-});
-
-const Card$2 = /*#__PURE__*/forwardRef(({
-  className,
-  children = null,
-  id,
-  isDisabled = false,
-  isSmall = false,
-  onDismiss,
-  testId,
-  ...props
-}, ref) => {
-  const closeButtonReference = useRef(null);
-  return /*#__PURE__*/jsxs("div", {
-    ref: ref,
-    className: classNames('np-Card', {
-      'np-Card--small': !!isSmall,
-      'is-disabled': !!isDisabled
-    }, className),
-    id: id,
-    "data-testid": testId,
-    ...props,
-    children: [onDismiss && /*#__PURE__*/jsx(CloseButton, {
-      ref: closeButtonReference,
-      className: "np-Card-closeButton",
-      size: isSmall ? 'sm' : 'md',
-      isDisabled: isDisabled,
-      testId: "close-button",
-      onClick: e => {
-        stopPropagation$1(e);
-        onDismiss();
-      }
-    }), children]
-  });
-});
-Card$2.displayName = 'Card';
-
-function Display({
-  as: Heading = 'h1',
-  type = Typography.DISPLAY_LARGE,
-  children,
-  className,
-  id
-}) {
-  return /*#__PURE__*/jsx(Heading, {
-    id: id,
-    className: classNames(`np-text-${type}`, 'text-primary', className),
-    children: children
-  });
-}
-
-const useConditionalListener = ({
-  attachListener,
-  callback,
-  eventType,
-  parent
-}) => {
-  useEffect(() => {
-    if (attachListener && !isUndefined(parent)) {
-      parent.addEventListener(eventType, callback, true);
-    }
-    return () => {
-      if (!isUndefined(parent)) {
-        parent.removeEventListener(eventType, callback, true);
-      }
-    };
-  }, [attachListener, callback, eventType, parent]);
-};
-
-const DirectionContext = /*#__PURE__*/createContext(Direction.LTR);
-const DirectionProvider = ({
-  direction,
-  children
-}) => {
-  return /*#__PURE__*/jsx(DirectionContext.Provider, {
-    value: direction,
-    children: children
-  });
-};
-
-const useDirection = () => {
-  const direction = useContext(DirectionContext);
-  return {
-    direction,
-    isRTL: direction === 'rtl'
-  };
-};
-
-const ObserverParams = {
-  threshold: 0.1
-};
-
-/**
- * useHasIntersected.
- * Use this custom hook to detect when an element has became visible inside the viewport. This hook checks only if the intersection happend.
- * Once the intersection has happened the hook will not return false even if the element gets out of the viewport.
- *
- * @param elRef.elRef
- * @param {object} [elRef] - node object that contains a react reference to the element that needs to be observed.
- * @param {strimng} [loading = 'eager'] - string that contains the type of loading.
- * @param elRef.loading
- * @usage `const [hasIntersected] = useHasIntersected({imageRef,loading});`
- */
-const useHasIntersected = ({
-  elRef,
-  loading
-}) => {
-  const [hasIntersected, setHasIntersected] = useState(false);
-  const {
-    current
-  } = elRef || {};
-  const isValidReference = () => {
-    return elRef && current;
-  };
-  const handleOnIntersect = (entries, observer) => {
-    entries.forEach(entry => {
-      if (entry.isIntersecting) {
-        setHasIntersected(true);
-        observer.unobserve(current);
-      }
-    });
-  };
-  useEffect(() => {
-    let observer;
-    let didCancel = false;
-
-    // Check if window is define for SSR and Old browsers fallback
-    if (typeof window === 'undefined' || !window.IntersectionObserver || !isValidReference()) {
-      setHasIntersected(true);
-    } else if (!didCancel) {
-      observer = new IntersectionObserver(handleOnIntersect, ObserverParams);
-      observer.observe(current);
-    }
-    return () => {
-      didCancel = true;
-      if (observer) {
-        observer.unobserve(current);
-      }
-    };
-  }, [elRef]);
-  if (loading === 'eager') {
-    return [false];
-  }
-  return [hasIntersected];
-};
-
-// eslint-disable-next-line import/extensions
-function useMedia(query) {
-  return useSyncExternalStore(onStoreChange => {
-    const mediaQueryList = window.matchMedia(query);
-    mediaQueryList.addEventListener('change', onStoreChange);
-    return () => {
-      mediaQueryList.removeEventListener('change', onStoreChange);
-    };
-  }, () => typeof window !== 'undefined' ? window.matchMedia(query).matches : undefined, () => undefined);
-}
-
-function useScreenSize(size) {
-  return useMedia(`(min-width: ${size}px)`);
-}
-
-/**
- * @deprecated Prefer `useScreenSize` instead.
- */
-const useLayout = () => {
-  const screenXs = useScreenSize(Breakpoint.EXTRA_SMALL);
-  const screenSm = useScreenSize(Breakpoint.SMALL);
-  const screenMd = useScreenSize(Breakpoint.MEDIUM);
-  const screenLg = useScreenSize(Breakpoint.LARGE);
-  const screenXl = useScreenSize(Breakpoint.EXTRA_LARGE);
-  return {
-    isMobile: screenSm != null ? !screenSm : undefined,
-    isExtraSmall: screenXs,
-    isSmall: screenSm,
-    isMedium: screenMd,
-    isLarge: screenLg,
-    isExtraLarge: screenXl
-  };
-};
-
-const EmptyTransparentImage = 'data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==';
-const Image = ({
-  id,
-  src,
-  alt,
-  onLoad,
-  onError,
-  className,
-  loading,
-  stretch = true,
-  role,
-  shrink = true
-}) => {
-  const elementReference = useRef(null);
-  const [hasIntersected] = useHasIntersected({
-    elRef: elementReference,
-    loading
-  });
-  let imageSource = src;
-  let imageOnLoad = onLoad;
-  if (loading === 'lazy' && !hasIntersected) {
-    imageSource = EmptyTransparentImage;
-    imageOnLoad = undefined;
-  }
-  return /*#__PURE__*/jsx("img", {
-    ref: elementReference,
-    id: id,
-    alt: alt,
-    src: imageSource,
-    className: classNames(['tw-image', {
-      'tw-image__stretch': stretch,
-      'tw-image__shrink': shrink
-    }, className]),
-    role: role,
-    onLoad: imageOnLoad,
-    onError: onError
-  });
-};
-
-const defaultPromoCardContext = {
-  state: '',
-  isDisabled: false,
-  // eslint-disable-next-line @typescript-eslint/no-empty-function
-  onChange: () => {}
-};
-/**
- * The PromoCard context object.
- */
-const PromoCardContext = /*#__PURE__*/createContext(defaultPromoCardContext);
-/**
- * A custom hook for accessing the PromoCard context object.
- *
- * The `usePromoCardContext` hook is used to access the PromoCard context object
- * from within a child PromoCard component. It throws an error if the context
- * object is not available, which can help with debugging and development.
- *
- * @returns {PromoCardContextType} - The PromoCard context object.
- */
-const usePromoCardContext = () => {
-  return useContext(PromoCardContext);
-};
-
-const PromoCardIndicator = ({
-  className,
-  children,
-  label,
-  icon,
-  isSmall = false,
-  testid,
-  ...rest
-}) => {
-  const isIconString = icon && typeof icon === 'string';
-  const IconComponent = isIconString && {
-    check: Check,
-    arrow: ArrowRight,
-    download: Download
-  }[icon];
-  return /*#__PURE__*/jsxs("div", {
-    className: classNames('np-Card-indicator', className),
-    "data-testid": testid,
-    ...rest,
-    children: [label && /*#__PURE__*/jsx(Body, {
-      as: "span",
-      type: Typography.BODY_LARGE_BOLD,
-      className: "np-Card-indicatorText",
-      children: label
-    }), icon && /*#__PURE__*/jsx(Avatar, {
-      type: AvatarType.ICON,
-      size: isSmall ? 40 : 56,
-      backgroundColor: "var(--Card-indicator-icon-background-color)",
-      className: "np-Card-indicatorIcon",
-      children: IconComponent ? /*#__PURE__*/jsx(IconComponent, {
-        size: 24,
-        "aria-hidden": "true"
-      }) : icon
-    }), children]
-  });
-};
-
-const PromoCard = /*#__PURE__*/forwardRef(({
-  className,
-  description,
-  defaultChecked,
-  download,
-  href,
-  hrefLang,
-  id,
-  headingLevel = 'h3',
-  imageAlt,
-  imageClass,
-  imageSource,
-  indicatorLabel,
-  indicatorIcon,
-  isChecked,
-  isDisabled,
-  onClick,
-  onKeyDown,
-  rel,
-  tabIndex,
-  target,
-  testId,
-  title,
-  type,
-  value,
-  isSmall,
-  useDisplayFont = true,
-  anchorRef,
-  anchorId,
-  ...props
-}, ref) => {
-  // Set the `checked` state to the value of `defaultChecked` if it is truthy,
-  // or the value of `isChecked` if it is truthy, or `false` if neither
-  // is truthy.
-  const {
-    state,
-    onChange,
-    isDisabled: contextIsDisabled
-  } = usePromoCardContext();
-  const [checked, setChecked] = useState(type === 'checkbox' ? defaultChecked ?? isChecked ?? false : false);
-  const handleClick = () => {
-    if (type === 'radio') {
-      onChange(value || ''); // Update the context state for radio
-    } else if (type === 'checkbox') {
-      setChecked(!checked); // Update local state for checkbox
-    }
-  };
-  const fallbackId = useId();
-  const componentId = id || fallbackId;
-  // Set the icon to `'arrow'` if `href` is truthy and `type` is falsy, or
-  // `'download'` if `download` is truthy. If neither condition is true, set
-  // `icon` to `undefined`.
-  // Create a function to get icon type
-  const getIconType = () => {
-    if (indicatorIcon) {
-      return indicatorIcon;
-    }
-    if (download) {
-      return 'download';
-    }
-    if (href && !type) {
-      return 'arrow';
-    }
-    return undefined;
-  };
-  // Define all class names string based on the values of the `href`, `type`,
-  // `checked`, and `className` props.
-  const commonClasses = classNames({
-    'np-Card--promoCard': true,
-    'np-Card--checked': !href && type,
-    'np-Card--link': href && !type,
-    'is-checked': type === 'radio' ? value === state : type === 'checkbox' ? checked : undefined
-  }, className);
-  // Object with common props that will be passed to the `Card` components
-  const commonProps = {
-    className: commonClasses,
-    id: componentId,
-    isDisabled: isDisabled || contextIsDisabled,
-    onClick,
-    onKeyDown,
-    ref,
-    'data-testid': testId,
-    isSmall
-  };
-  // Object with Anchor props that will be passed to the `a` element. These
-  // won't be refurned if set to `isDisabled`
-  const anchorProps = href && !isDisabled ? {
-    download,
-    href: href || undefined,
-    hrefLang,
-    rel,
-    target,
-    ref: anchorRef,
-    id: anchorId
-  } : {};
-  // Object of all Checked props that will be passed to the root `Card` component
-  const checkedProps = (type === 'checkbox' || type === 'radio') && !href ? {
-    ...commonProps,
-    'aria-checked': type === 'radio' ? value === state : type === 'checkbox' ? checked : undefined,
-    'aria-describedby': `${componentId}-title`,
-    'aria-disabled': isDisabled,
-    'data-value': value ?? undefined,
-    role: type === 'checkbox' || type === 'radio' ? type : undefined,
-    onClick: handleClick,
-    onKeyDown: event => {
-      if (event.key === 'Enter' || event.key === ' ') {
-        handleClick();
-      }
-    },
-    ref,
-    tabIndex: 0
-  } : {};
-  const getTitle = () => {
-    const titleContent = href && !type ? /*#__PURE__*/jsx("a", {
-      className: "np-Card-titleLink",
-      ...anchorProps,
-      children: title
-    }) : title;
-    const titleProps = {
-      id: `${componentId}-title`,
-      as: headingLevel,
-      className: 'np-Card-title'
+      disabled: disabled || loading,
+      type: htmlType
     };
-    return useDisplayFont ? /*#__PURE__*/jsx(Display, {
-      type: Typography.DISPLAY_SMALL,
-      ...titleProps,
-      children: titleContent
-    }) : /*#__PURE__*/jsx(Title, {
-      type: Typography.TITLE_SUBSECTION,
-      ...titleProps,
-      children: titleContent
-    });
-  };
-  useEffect(() => {
-    setChecked(defaultChecked ?? isChecked ?? false);
-  }, [defaultChecked, isChecked]);
-  return /*#__PURE__*/jsxs(Card$2, {
-    ...commonProps,
-    ...checkedProps,
+  } else {
+    props = {
+      ...rest
+    };
+  }
+  return /*#__PURE__*/jsxs(Element, {
+    ref: reference,
+    className: classes,
     ...props,
-    children: [(value === state || checked) && /*#__PURE__*/jsx("span", {
-      className: "np-Card-check",
-      children: /*#__PURE__*/jsx(Check, {
-        size: 24,
-        "aria-hidden": "true"
-      })
-    }), getTitle(), /*#__PURE__*/jsx(Body, {
-      className: "np-Card-description",
-      children: description
-    }), imageSource && /*#__PURE__*/jsx("div", {
-      className: classNames('np-Card-image', {
-        imageClass
-      }),
-      children: /*#__PURE__*/jsx(Image, {
-        src: imageSource,
-        alt: imageAlt || '',
-        loading: "lazy"
-      })
-    }), /*#__PURE__*/jsx(PromoCardIndicator, {
-      label: indicatorLabel,
-      icon: getIconType(),
-      isSmall: isSmall
+    "aria-live": loading ? 'polite' : 'off',
+    "aria-label": loading ? intl.formatMessage(messages$b.loadingAriaLabel) : rest['aria-label'],
+    children: [children, loading && /*#__PURE__*/jsx(ProcessIndicator, {
+      size: processIndicatorSize(),
+      className: "btn-loader"
     })]
   });
 });
-var PromoCard$1 = /*#__PURE__*/React__default.memo(PromoCard);
-
-const LEFT_SCROLL_OFFSET = 8;
-const Carousel = ({
-  header,
-  className,
-  cards,
-  onClick
-}) => {
-  const [scrollPosition, setScrollPosition] = useState(0);
-  const [previousScrollPosition, setPreviousScrollPosition] = useState(0);
-  const [scrollIsAtEnd, setScrollIsAtEnd] = useState(false);
-  const [visibleCardOnMobileView, setVisibleCardOnMobileView] = useState('');
-  const carouselElementRef = useRef(null);
-  const carouselCardsRef = useRef([]);
-  const isLeftActionButtonEnabled = scrollPosition > LEFT_SCROLL_OFFSET;
-  const areActionButtonsEnabled = isLeftActionButtonEnabled || !scrollIsAtEnd;
-  const [focusedCard, setFocusedCard] = useState(cards?.[0]?.id);
-  const updateScrollButtonsState = () => {
-    if (carouselElementRef.current) {
-      const {
-        scrollWidth,
-        offsetWidth
-      } = carouselElementRef.current;
-      const scrollAtEnd = scrollWidth - offsetWidth <= scrollPosition + LEFT_SCROLL_OFFSET;
-      setScrollIsAtEnd(scrollAtEnd);
-    }
-    const scrollDirecton = scrollPosition > previousScrollPosition ? 'right' : 'left';
-    const cardsInFullViewIds = [];
-    carouselCardsRef.current.forEach(card => {
-      if (isVisible(carouselElementRef.current, card.cardElement)) {
-        // eslint-disable-next-line functional/immutable-data
-        cardsInFullViewIds.push(card.cardElement.getAttribute('id') ?? '');
-      }
-    });
-    if (cardsInFullViewIds.length >= 1) {
-      const visibleCardIndex = scrollDirecton === 'right' ? cardsInFullViewIds.length - 1 : 0;
-      const visibleCardId = cardsInFullViewIds[visibleCardIndex];
-      setVisibleCardOnMobileView(visibleCardId);
-      setFocusedCard(visibleCardId);
-    }
-    setPreviousScrollPosition(scrollPosition);
-  };
-  const scrollCarousel = (direction = 'right') => {
-    if (carouselElementRef.current) {
-      const {
-        scrollWidth
-      } = carouselElementRef.current;
-      const cardWidth = scrollWidth / carouselCardsRef.current.length;
-      const res = Math.floor(cardWidth - cardWidth * 0.05);
-      carouselElementRef.current.scrollBy({
-        left: direction === 'right' ? res : -res,
-        behavior: 'smooth'
-      });
-    }
-  };
-  const handleOnKeyDown = (event, index) => {
-    if (event.key === 'ArrowRight' || event.key === 'ArrowLeft') {
-      const nextIndex = event.key === 'ArrowRight' ? index + 1 : index - 1;
-      const nextCard = cards[nextIndex];
-      if (nextCard) {
-        const ref = carouselCardsRef.current[nextIndex];
-        if (ref.type === 'promo') {
-          ref.anchorElement?.focus();
-        } else {
-          ref.cardElement?.focus();
-        }
-        scrollCardIntoView(carouselCardsRef.current[nextIndex].cardElement, nextCard);
-        event.preventDefault();
-      }
-    }
-    if (event.key === 'Enter' || event.key === ' ') {
-      event.currentTarget.click();
-    }
-  };
-  const scrollCardIntoView = (element, card) => {
-    element.scrollIntoView({
-      behavior: 'smooth',
-      block: 'nearest',
-      inline: 'center'
-    });
-    setFocusedCard(card.id);
-  };
-  useEffect(() => {
-    updateScrollButtonsState();
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [scrollPosition]);
-  useEffect(() => {
-    window.addEventListener('resize', updateScrollButtonsState);
-    return () => {
-      window.removeEventListener('resize', updateScrollButtonsState);
-    };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-  const addElementToCardsRefArray = (index, ref) => {
-    if (ref) {
-      // eslint-disable-next-line functional/immutable-data
-      carouselCardsRef.current[index] = {
-        type: ref.type ?? carouselCardsRef.current?.[index]?.type,
-        cardElement: ref.cardElement ?? carouselCardsRef.current?.[index]?.cardElement,
-        anchorElement: ref.anchorElement ?? carouselCardsRef.current?.[index]?.anchorElement
-      };
-    }
-  };
-  return /*#__PURE__*/jsxs("div", {
-    className: classNames('carousel-wrapper', className),
-    children: [/*#__PURE__*/jsxs("div", {
-      className: "d-flex justify-content-between carousel__header",
-      children: [typeof header === 'string' ? /*#__PURE__*/jsx(Title, {
-        as: "span",
-        type: "title-body",
-        children: header
-      }) : header, areActionButtonsEnabled ? /*#__PURE__*/jsxs("div", {
-        className: "hidden-xs",
-        children: [/*#__PURE__*/jsx(ActionButton, {
-          className: "carousel__scroll-button",
-          tabIndex: -1,
-          priority: "secondary",
-          disabled: !isLeftActionButtonEnabled,
-          "aria-hidden": "true",
-          "data-testid": "scroll-carousel-left",
-          onClick: () => scrollCarousel('left'),
-          children: /*#__PURE__*/jsx(ChevronLeft, {})
-        }), /*#__PURE__*/jsx(ActionButton, {
-          tabIndex: -1,
-          className: "carousel__scroll-button m-l-1",
-          priority: "secondary",
-          "aria-hidden": "true",
-          "data-testid": "scroll-carousel-right",
-          disabled: scrollIsAtEnd,
-          onClick: () => scrollCarousel(),
-          children: /*#__PURE__*/jsx(ChevronRight, {})
-        })]
-      }) : null]
-    }), /*#__PURE__*/jsx("div", {
-      ref: carouselElementRef,
-      tabIndex: -1,
-      role: "list",
-      className: "carousel",
-      onScroll: event => {
-        const target = event.target;
-        setScrollPosition(target.scrollLeft);
-      },
-      children: cards?.map((card, index) => {
-        const sharedProps = {
-          id: card.id,
-          className: classNames('carousel__card', {
-            'carousel__card--focused': card.id === focusedCard
-          }),
-          onClick: () => {
-            card.onClick?.();
-            onClick?.(card.id);
-          },
-          onFocus: event => {
-            scrollCardIntoView(event.currentTarget, card);
-          }
-        };
-        const cardContent = card.type !== 'promo' ? /*#__PURE__*/jsx("div", {
-          id: `${card.id}-content`,
-          className: classNames('carousel__card-content', {
-            [card.className ?? '']: !!card.className
-          })
-          // eslint-disable-next-line react/forbid-dom-props
-          ,
-          style: card.styles,
-          children: card.content
-        }) : null;
-        if (card.type === 'button') {
-          return /*#__PURE__*/jsx("div", {
-            "aria-labelledby": `${card.id}-content`,
-            role: "listitem",
-            children: /*#__PURE__*/jsx("div", {
-              ...sharedProps,
-              ref: el => {
-                if (el) {
-                  // eslint-disable-next-line functional/immutable-data
-                  carouselCardsRef.current[index] = {
-                    type: 'default',
-                    cardElement: el
-                  };
-                }
-              },
-              role: "button",
-              tabIndex: 0,
-              onKeyDown: event => handleOnKeyDown(event, index),
-              children: cardContent
-            })
-          }, card.id);
-        }
-        if (card.type === 'promo') {
-          return /*#__PURE__*/jsx("div", {
-            id: card.id,
-            role: "listitem",
-            "aria-labelledby": `${card.id}-anchor`,
-            children: /*#__PURE__*/jsx(PromoCard$1, {
-              ...card,
-              type: undefined,
-              ...sharedProps,
-              ref: el => {
-                if (el) {
-                  addElementToCardsRefArray(index, {
-                    type: 'promo',
-                    cardElement: el
-                  });
-                }
-              },
-              anchorRef: el => {
-                if (el) {
-                  addElementToCardsRefArray(index, {
-                    type: 'promo',
-                    anchorElement: el
-                  });
-                }
-              },
-              anchorId: `${card.id}-anchor`,
-              onKeyDown: event => handleOnKeyDown(event, index)
-            })
-          }, card.id);
-        }
-        return /*#__PURE__*/jsx("div", {
-          "aria-labelledby": `${card.id}-content`,
-          role: "listitem",
-          children: /*#__PURE__*/jsx("a", {
-            ...sharedProps,
-            ref: el => {
-              if (el) {
-                // eslint-disable-next-line functional/immutable-data
-                carouselCardsRef.current[index] = {
-                  type: 'default',
-                  cardElement: el
-                };
-              }
-            },
-            href: card.href,
-            rel: "noreferrer",
-            onKeyDown: event => handleOnKeyDown(event, index),
-            children: cardContent
-          })
-        }, card.id);
-      })
-    }), /*#__PURE__*/jsx("div", {
-      className: "visible-xs",
-      children: /*#__PURE__*/jsx("div", {
-        className: "carousel__indicators",
-        children: cards?.map((card, index) => /*#__PURE__*/jsx("button", {
-          "data-testid": `${card.id}-indicator`,
-          tabIndex: -1,
-          "aria-hidden": true,
-          type: "button",
-          className: classNames('carousel__indicator', {
-            'carousel__indicator--selected': card.id === visibleCardOnMobileView
-          }),
-          onClick: () => {
-            scrollCardIntoView(carouselCardsRef.current[index].cardElement, card);
-          }
-        }, `${card.id}-indicator`))
-      })
-    })]
-  });
-};
-const isVisible = (container, el) => {
-  const cWidth = container.offsetWidth;
-  const cScrollOffset = container.scrollLeft;
-  const elemLeft = el.offsetLeft - container.offsetLeft;
-  const elemRight = elemLeft + el.offsetWidth;
-  return elemLeft >= cScrollOffset && elemRight <= cScrollOffset + cWidth;
-};
 
-const Card = /*#__PURE__*/forwardRef((props, reference) => {
+const Card$1 = /*#__PURE__*/forwardRef((props, reference) => {
   const {
     'aria-label': ariaLabel,
     as: Element,
@@ -2241,7 +1513,7 @@ const Card = /*#__PURE__*/forwardRef((props, reference) => {
 const hasChildren = ({
   children
 }) => children;
-Card.propTypes = {
+Card$1.propTypes = {
   'aria-label': PropTypes.string,
   as: PropTypes.string,
   isExpanded: requiredIf(PropTypes.bool, hasChildren),
@@ -2254,7 +1526,7 @@ Card.propTypes = {
   className: PropTypes.string,
   'data-testid': PropTypes.string
 };
-Card.defaultProps = {
+Card$1.defaultProps = {
   'aria-label': undefined,
   as: 'div',
   children: null,
@@ -2262,7 +1534,7 @@ Card.defaultProps = {
   className: null,
   'data-testid': null
 };
-var Card$1 = Card;
+var Card$2 = Card$1;
 
 const CheckboxButton = /*#__PURE__*/forwardRef(({
   checked,
@@ -2748,6 +2020,134 @@ const DimmerContentWrapper = ({
 };
 var Dimmer$1 = withNextPortalWrapper(Dimmer);
 
+const useConditionalListener = ({
+  attachListener,
+  callback,
+  eventType,
+  parent
+}) => {
+  useEffect(() => {
+    if (attachListener && !isUndefined(parent)) {
+      parent.addEventListener(eventType, callback, true);
+    }
+    return () => {
+      if (!isUndefined(parent)) {
+        parent.removeEventListener(eventType, callback, true);
+      }
+    };
+  }, [attachListener, callback, eventType, parent]);
+};
+
+const DirectionContext = /*#__PURE__*/createContext(Direction.LTR);
+const DirectionProvider = ({
+  direction,
+  children
+}) => {
+  return /*#__PURE__*/jsx(DirectionContext.Provider, {
+    value: direction,
+    children: children
+  });
+};
+
+const useDirection = () => {
+  const direction = useContext(DirectionContext);
+  return {
+    direction,
+    isRTL: direction === 'rtl'
+  };
+};
+
+const ObserverParams = {
+  threshold: 0.1
+};
+
+/**
+ * useHasIntersected.
+ * Use this custom hook to detect when an element has became visible inside the viewport. This hook checks only if the intersection happend.
+ * Once the intersection has happened the hook will not return false even if the element gets out of the viewport.
+ *
+ * @param elRef.elRef
+ * @param {object} [elRef] - node object that contains a react reference to the element that needs to be observed.
+ * @param {strimng} [loading = 'eager'] - string that contains the type of loading.
+ * @param elRef.loading
+ * @usage `const [hasIntersected] = useHasIntersected({imageRef,loading});`
+ */
+const useHasIntersected = ({
+  elRef,
+  loading
+}) => {
+  const [hasIntersected, setHasIntersected] = useState(false);
+  const {
+    current
+  } = elRef || {};
+  const isValidReference = () => {
+    return elRef && current;
+  };
+  const handleOnIntersect = (entries, observer) => {
+    entries.forEach(entry => {
+      if (entry.isIntersecting) {
+        setHasIntersected(true);
+        observer.unobserve(current);
+      }
+    });
+  };
+  useEffect(() => {
+    let observer;
+    let didCancel = false;
+
+    // Check if window is define for SSR and Old browsers fallback
+    if (typeof window === 'undefined' || !window.IntersectionObserver || !isValidReference()) {
+      setHasIntersected(true);
+    } else if (!didCancel) {
+      observer = new IntersectionObserver(handleOnIntersect, ObserverParams);
+      observer.observe(current);
+    }
+    return () => {
+      didCancel = true;
+      if (observer) {
+        observer.unobserve(current);
+      }
+    };
+  }, [elRef]);
+  if (loading === 'eager') {
+    return [false];
+  }
+  return [hasIntersected];
+};
+
+function useMedia(query) {
+  return useSyncExternalStore(onStoreChange => {
+    const mediaQueryList = window.matchMedia(query);
+    mediaQueryList.addEventListener('change', onStoreChange);
+    return () => {
+      mediaQueryList.removeEventListener('change', onStoreChange);
+    };
+  }, () => typeof window !== 'undefined' ? window.matchMedia(query).matches : undefined, () => undefined);
+}
+
+function useScreenSize(size) {
+  return useMedia(`(min-width: ${size}px)`);
+}
+
+/**
+ * @deprecated Prefer `useScreenSize` instead.
+ */
+const useLayout = () => {
+  const screenXs = useScreenSize(Breakpoint.EXTRA_SMALL);
+  const screenSm = useScreenSize(Breakpoint.SMALL);
+  const screenMd = useScreenSize(Breakpoint.MEDIUM);
+  const screenLg = useScreenSize(Breakpoint.LARGE);
+  const screenXl = useScreenSize(Breakpoint.EXTRA_LARGE);
+  return {
+    isMobile: screenSm != null ? !screenSm : undefined,
+    isExtraSmall: screenXs,
+    isSmall: screenSm,
+    isMedium: screenMd,
+    isLarge: screenLg,
+    isExtraLarge: screenXl
+  };
+};
+
 const EXIT_ANIMATION = 350;
 const SlidingPanel = /*#__PURE__*/forwardRef(({
   position = 'left',
@@ -2836,12 +2236,12 @@ Drawer.propTypes = {
   footerContent: PropTypes.node,
   /** The content to appear in the drawer header. */
   headerTitle: PropTypes.node,
-  /** The action to perform on close click. */
-  onClose: PropTypes.func,
   /** The status of Drawer either open or not. */
   open: PropTypes.bool,
   /** The placement of Drawer on the screen either left or right. On mobile it will default to bottom. */
-  position: PropTypes.oneOf(['left', 'right', 'bottom'])
+  position: PropTypes.oneOf(['left', 'right', 'bottom']),
+  /** The action to perform on close click. */
+  onClose: PropTypes.func
 };
 Drawer.defaultProps = {
   children: null,
@@ -3027,6 +2427,39 @@ const BottomSheet$1 = props => {
   });
 };
 
+const Card = ({
+  className,
+  children = null,
+  id,
+  isDisabled = false,
+  isSmall = false,
+  onDismiss,
+  testId,
+  ...props
+}) => {
+  const closeButtonReference = useRef(null);
+  return /*#__PURE__*/jsxs("div", {
+    className: classNames('np-Card', {
+      'np-Card--small': !!isSmall,
+      'is-disabled': !!isDisabled
+    }, className),
+    id: id,
+    "data-testid": testId,
+    ...props,
+    children: [onDismiss && /*#__PURE__*/jsx(CloseButton, {
+      ref: closeButtonReference,
+      className: "np-Card-closeButton",
+      size: isSmall ? 'sm' : 'md',
+      isDisabled: isDisabled,
+      testId: "close-button",
+      onClick: e => {
+        stopPropagation$1(e);
+        onDismiss();
+      }
+    }), children]
+  });
+};
+
 function CriticalCommsBanner({
   title,
   subtitle,
@@ -3516,7 +2949,7 @@ const fallbackPlacements = {
   [Position.LEFT]: [Position.RIGHT, Position.TOP, Position.BOTTOM],
   [Position.RIGHT]: [Position.LEFT, Position.TOP, Position.BOTTOM]
 };
-const Panel = /*#__PURE__*/forwardRef(({
+const Panel = /*#__PURE__*/forwardRef(function Panel({
   arrow = false,
   flip = true,
   altAxis = false,
@@ -3527,7 +2960,7 @@ const Panel = /*#__PURE__*/forwardRef(({
   anchorRef,
   anchorWidth = false,
   ...rest
-}, reference) => {
+}, reference) {
   const [arrowElement, setArrowElement] = useState(null);
   const [popperElement, setPopperElement] = useState(null);
   const modifiers = [];
@@ -3605,7 +3038,7 @@ const Panel = /*#__PURE__*/forwardRef(({
       ...attributes.popper,
       className: classNames('np-panel', {
         'np-panel--open': open
-      }, rest['className']),
+      }, rest.className),
       children: /*#__PURE__*/jsxs("div", {
         ref: reference
         /* eslint-disable-next-line react/forbid-dom-props */,
@@ -3624,7 +3057,7 @@ const Panel = /*#__PURE__*/forwardRef(({
 });
 var Panel$1 = Panel;
 
-const ResponsivePanel = /*#__PURE__*/forwardRef(({
+const ResponsivePanel = /*#__PURE__*/forwardRef(function ResponsivePanel({
   anchorRef,
   arrow = false,
   flip = true,
@@ -3633,7 +3066,7 @@ const ResponsivePanel = /*#__PURE__*/forwardRef(({
   onClose,
   open = false,
   position = Position.BOTTOM
-}, reference) => {
+}, reference) {
   const {
     isMobile
   } = useLayout();
@@ -4884,6 +4317,20 @@ DefinitionList.defaultProps = {
 };
 var DefinitionList$1 = DefinitionList;
 
+function Display({
+  as: Heading = 'h1',
+  type = Typography.DISPLAY_LARGE,
+  children,
+  className,
+  id
+}) {
+  return /*#__PURE__*/jsx(Heading, {
+    id: id,
+    className: classNames(`np-text-${type}`, 'text-primary', className),
+    children: children
+  });
+}
+
 const DropFade = ({
   children,
   show
@@ -4972,6 +4419,84 @@ const Emphasis = ({
   }) : null;
 };
 
+function InlineAlert({
+  id,
+  type = 'neutral',
+  className,
+  children
+}) {
+  const danger = type === 'negative' || type === 'error';
+  return /*#__PURE__*/jsxs("div", {
+    role: "alert",
+    id: id,
+    className: classNames('alert alert-detach', `alert-${danger ? 'danger' : type}`, className),
+    children: [danger && /*#__PURE__*/jsx(AlertCircle, {}), /*#__PURE__*/jsx("div", {
+      children: children
+    })]
+  });
+}
+
+const Label = ({
+  id,
+  htmlFor,
+  className,
+  children
+}) => {
+  return /*#__PURE__*/jsx("label", {
+    id: id,
+    htmlFor: htmlFor,
+    className: classNames('control-label d-flex flex-column gap-y-1 m-b-0', className),
+    children: children
+  });
+};
+
+const Field = ({
+  id,
+  label,
+  hint,
+  error,
+  className,
+  children
+}) => {
+  const hasError = Boolean(error);
+  const hasHint = Boolean(hint) && !hasError;
+  const labelId = useId();
+  const fallbackInputId = useId();
+  const inputId = id !== null ? id ?? fallbackInputId : undefined;
+  const descriptionId = useId();
+  return /*#__PURE__*/jsx(FieldLabelIdContextProvider, {
+    value: labelId,
+    children: /*#__PURE__*/jsx(InputIdContextProvider, {
+      value: inputId,
+      children: /*#__PURE__*/jsx(InputDescribedByProvider, {
+        value: hasError || hasHint ? descriptionId : undefined,
+        children: /*#__PURE__*/jsx(InputInvalidProvider, {
+          value: hasError,
+          children: /*#__PURE__*/jsxs("div", {
+            className: classNames('form-group d-block', {
+              'has-error': hasError,
+              'has-info': hasHint
+            }, className),
+            children: [/*#__PURE__*/jsxs(Label, {
+              id: labelId,
+              htmlFor: inputId,
+              children: [label, children]
+            }), hasHint && /*#__PURE__*/jsx(InlineAlert, {
+              type: Sentiment.NEUTRAL,
+              id: descriptionId,
+              children: hint
+            }), hasError && /*#__PURE__*/jsx(InlineAlert, {
+              type: Sentiment.NEGATIVE,
+              id: descriptionId,
+              children: error
+            })]
+          })
+        })
+      })
+    })
+  });
+};
+
 const FlowHeader = /*#__PURE__*/React.forwardRef(({
   bottomContent,
   className,
@@ -5218,42 +4743,40 @@ const Tooltip = ({
       forceUpdate();
     }
   }, [open]);
-  return /*#__PURE__*/jsx(Fragment, {
-    children: /*#__PURE__*/jsxs("span", {
-      ref: anchorReference,
-      className: "tw-tooltip-container",
-      onMouseOver: () => setOpen(true),
-      onFocus: () => setOpen(true),
-      onMouseOut: () => setOpen(false),
-      onBlur: () => setOpen(false),
-      children: [children ? /*#__PURE__*/cloneElement(children, {
-        'aria-describedby': `${tooltipId}-tooltip`
-      }) : null, /*#__PURE__*/jsx("div", {
-        // @ts-expect-error
-        ref: setPopperElement,
-        className: classNames('np-tooltip', 'np-panel', open ? `np-panel--open np-tooltip--open` : null, className)
-        // eslint-disable-next-line react/forbid-dom-props
-        ,
-        style: {
-          ...styles.popper
-        },
-        ...attributes.popper,
-        "aria-hidden": !open,
-        role: "tooltip",
-        id: `${tooltipId}-tooltip`,
-        children: /*#__PURE__*/jsxs("div", {
-          className: "np-panel__content tooltip-inner",
-          children: [label, /*#__PURE__*/jsx("div", {
-            // @ts-expect-error
-            ref: setArrowElement,
-            className: classNames('np-panel__arrow')
-            // eslint-disable-next-line react/forbid-dom-props
-            ,
-            style: styles.arrow
-          })]
-        })
-      })]
-    })
+  return /*#__PURE__*/jsxs("span", {
+    ref: anchorReference,
+    className: "tw-tooltip-container",
+    onMouseOver: () => setOpen(true),
+    onFocus: () => setOpen(true),
+    onMouseOut: () => setOpen(false),
+    onBlur: () => setOpen(false),
+    children: [children ? /*#__PURE__*/cloneElement(children, {
+      'aria-describedby': `${tooltipId}-tooltip`
+    }) : null, /*#__PURE__*/jsx("div", {
+      // @ts-expect-error
+      ref: setPopperElement,
+      className: classNames('np-tooltip', 'np-panel', open ? `np-panel--open np-tooltip--open` : null, className)
+      // eslint-disable-next-line react/forbid-dom-props
+      ,
+      style: {
+        ...styles.popper
+      },
+      ...attributes.popper,
+      "aria-hidden": !open,
+      role: "tooltip",
+      id: `${tooltipId}-tooltip`,
+      children: /*#__PURE__*/jsxs("div", {
+        className: "np-panel__content tooltip-inner",
+        children: [label, /*#__PURE__*/jsx("div", {
+          // @ts-expect-error
+          ref: setArrowElement,
+          className: classNames('np-panel__arrow')
+          // eslint-disable-next-line react/forbid-dom-props
+          ,
+          style: styles.arrow
+        })]
+      })
+    })]
   });
 };
 
@@ -5451,84 +4974,6 @@ const FlowNavigation = ({
   });
 };
 
-function InlineAlert({
-  id,
-  type = 'neutral',
-  className,
-  children
-}) {
-  const danger = type === 'negative' || type === 'error';
-  return /*#__PURE__*/jsxs("div", {
-    role: "alert",
-    id: id,
-    className: classNames('alert alert-detach', `alert-${danger ? 'danger' : type}`, className),
-    children: [danger && /*#__PURE__*/jsx(AlertCircle, {}), /*#__PURE__*/jsx("div", {
-      children: children
-    })]
-  });
-}
-
-const Label = ({
-  id,
-  htmlFor,
-  className,
-  children
-}) => {
-  return /*#__PURE__*/jsx("label", {
-    id: id,
-    htmlFor: htmlFor,
-    className: classNames('control-label d-flex flex-column gap-y-1 m-b-0', className),
-    children: children
-  });
-};
-
-const Field = ({
-  id,
-  label,
-  hint,
-  error,
-  className,
-  children
-}) => {
-  const hasError = Boolean(error);
-  const hasHint = Boolean(hint) && !hasError;
-  const labelId = useId();
-  const fallbackInputId = useId(); // TODO: Use `React.useId()` when react>=18
-  const inputId = id !== null ? id ?? fallbackInputId : undefined;
-  const descriptionId = useId(); // TODO: Use `React.useId()` when react>=18
-  return /*#__PURE__*/jsx(FieldLabelIdContextProvider, {
-    value: labelId,
-    children: /*#__PURE__*/jsx(InputIdContextProvider, {
-      value: inputId,
-      children: /*#__PURE__*/jsx(InputDescribedByProvider, {
-        value: hasError || hasHint ? descriptionId : undefined,
-        children: /*#__PURE__*/jsx(InputInvalidProvider, {
-          value: hasError,
-          children: /*#__PURE__*/jsxs("div", {
-            className: classNames('form-group d-block', {
-              'has-error': hasError,
-              'has-info': hasHint
-            }, className),
-            children: [/*#__PURE__*/jsxs(Label, {
-              id: labelId,
-              htmlFor: inputId,
-              children: [label, children]
-            }), hasHint && /*#__PURE__*/jsx(InlineAlert, {
-              type: Sentiment.NEUTRAL,
-              id: descriptionId,
-              children: hint
-            }), hasError && /*#__PURE__*/jsx(InlineAlert, {
-              type: Sentiment.NEGATIVE,
-              id: descriptionId,
-              children: error
-            })]
-          })
-        })
-      })
-    })
-  });
-};
-
 const HeaderAction = ({
   action
 }) => {
@@ -5583,16 +5028,55 @@ const Header = ({
     // eslint-disable-next-line no-console
     console.warn('Legends should be the first child in a fieldset, and this is not possible when including an action');
   }
-  return /*#__PURE__*/jsxs("div", {
-    className: classNames('np-header', className),
-    children: [/*#__PURE__*/jsx(Title, {
-      as: as,
-      type: Typography.TITLE_GROUP,
-      className: "np-header__title",
-      children: title
-    }), /*#__PURE__*/jsx(HeaderAction, {
-      action: action
-    })]
+  return /*#__PURE__*/jsxs("div", {
+    className: classNames('np-header', className),
+    children: [/*#__PURE__*/jsx(Title, {
+      as: as,
+      type: Typography.TITLE_GROUP,
+      className: "np-header__title",
+      children: title
+    }), /*#__PURE__*/jsx(HeaderAction, {
+      action: action
+    })]
+  });
+};
+
+const EmptyTransparentImage = 'data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==';
+const Image = ({
+  id,
+  src,
+  alt,
+  onLoad,
+  onError,
+  className,
+  loading,
+  stretch = true,
+  role,
+  shrink = true
+}) => {
+  const elementReference = useRef(null);
+  const [hasIntersected] = useHasIntersected({
+    elRef: elementReference,
+    loading
+  });
+  let imageSource = src;
+  let imageOnLoad = onLoad;
+  if (loading === 'lazy' && !hasIntersected) {
+    imageSource = EmptyTransparentImage;
+    imageOnLoad = undefined;
+  }
+  return /*#__PURE__*/jsx("img", {
+    ref: elementReference,
+    id: id,
+    alt: alt,
+    src: imageSource,
+    className: classNames(['tw-image', {
+      'tw-image__stretch': stretch,
+      'tw-image__shrink': shrink
+    }, className]),
+    role: role,
+    onLoad: imageOnLoad,
+    onError: onError
   });
 };
 
@@ -6138,10 +5622,9 @@ class WithDisplayFormat extends Component {
         return 'Backspace';
       }
       return triggerEvent.key;
-    } else {
-      // triggerEvent can be null only in case of "autofilling" (via password manager extension or browser build-in one) events
-      return 'Paste';
     }
+    // triggerEvent can be null only in case of "autofilling" (via password manager extension or browser build-in one) events
+    return 'Paste';
   };
   resetEvent = () => {
     this.setState({
@@ -6294,11 +5777,10 @@ class WithDisplayFormat extends Component {
       selectionEnd,
       pastedLength
     } = this.state;
+    const target = triggerEvent?.currentTarget;
     const cursorPosition = getCursorPositionAfterActionStroke(action, selectionStart, selectionEnd, displayPattern, pastedLength);
     setTimeout(() => {
-      if (triggerEvent) {
-        triggerEvent.target.setSelectionRange(cursorPosition, cursorPosition);
-      }
+      target?.setSelectionRange(cursorPosition, cursorPosition);
       this.setState({
         selectionStart: cursorPosition,
         selectionEnd: cursorPosition
@@ -9465,6 +8947,227 @@ const ProgressBar = ({
   });
 };
 
+const defaultPromoCardContext = {
+  state: '',
+  isDisabled: false,
+  // eslint-disable-next-line @typescript-eslint/no-empty-function
+  onChange: () => {}
+};
+/**
+ * The PromoCard context object.
+ */
+const PromoCardContext = /*#__PURE__*/createContext(defaultPromoCardContext);
+/**
+ * A custom hook for accessing the PromoCard context object.
+ *
+ * The `usePromoCardContext` hook is used to access the PromoCard context object
+ * from within a child PromoCard component. It throws an error if the context
+ * object is not available, which can help with debugging and development.
+ *
+ * @returns {PromoCardContextType} - The PromoCard context object.
+ */
+const usePromoCardContext = () => {
+  return useContext(PromoCardContext);
+};
+
+const PromoCardIndicator = ({
+  className,
+  children,
+  label,
+  icon,
+  isSmall = false,
+  testid,
+  ...rest
+}) => {
+  const isIconString = icon && typeof icon === 'string';
+  const IconComponent = isIconString && {
+    check: Check,
+    arrow: ArrowRight,
+    download: Download
+  }[icon];
+  return /*#__PURE__*/jsxs("div", {
+    className: classNames('np-Card-indicator', className),
+    "data-testid": testid,
+    ...rest,
+    children: [label && /*#__PURE__*/jsx(Body, {
+      as: "span",
+      type: Typography.BODY_LARGE_BOLD,
+      className: "np-Card-indicatorText",
+      children: label
+    }), icon && /*#__PURE__*/jsx(Avatar, {
+      type: AvatarType.ICON,
+      size: isSmall ? 40 : 56,
+      backgroundColor: "var(--Card-indicator-icon-background-color)",
+      className: "np-Card-indicatorIcon",
+      children: IconComponent ? /*#__PURE__*/jsx(IconComponent, {
+        size: 24,
+        "aria-hidden": "true"
+      }) : icon
+    }), children]
+  });
+};
+
+const PromoCard = /*#__PURE__*/forwardRef(({
+  className,
+  description,
+  defaultChecked,
+  download,
+  href,
+  hrefLang,
+  id,
+  headingLevel = 'h3',
+  imageAlt,
+  imageClass,
+  imageSource,
+  indicatorLabel,
+  indicatorIcon,
+  isChecked,
+  isDisabled,
+  onClick,
+  rel,
+  tabIndex,
+  target,
+  testId,
+  title,
+  type,
+  value,
+  isSmall,
+  useDisplayFont = true,
+  ...props
+}, reference) => {
+  // Set the `checked` state to the value of `defaultChecked` if it is truthy,
+  // or the value of `isChecked` if it is truthy, or `false` if neither
+  // is truthy.
+  const {
+    state,
+    onChange,
+    isDisabled: contextIsDisabled
+  } = usePromoCardContext();
+  const [checked, setChecked] = useState(type === 'checkbox' ? defaultChecked ?? isChecked ?? false : false);
+  const handleClick = () => {
+    if (type === 'radio') {
+      onChange(value || ''); // Update the context state for radio
+    } else if (type === 'checkbox') {
+      setChecked(!checked); // Update local state for checkbox
+    }
+  };
+  const fallbackId = useId();
+  const componentId = id || fallbackId;
+  // Set the icon to `'arrow'` if `href` is truthy and `type` is falsy, or
+  // `'download'` if `download` is truthy. If neither condition is true, set
+  // `icon` to `undefined`.
+  // Create a function to get icon type
+  const getIconType = () => {
+    if (indicatorIcon) {
+      return indicatorIcon;
+    }
+    if (download) {
+      return 'download';
+    }
+    if (href && !type) {
+      return 'arrow';
+    }
+    return undefined;
+  };
+  // Define all class names string based on the values of the `href`, `type`,
+  // `checked`, and `className` props.
+  const commonClasses = classNames({
+    'np-Card--promoCard': true,
+    'np-Card--checked': !href && type,
+    'np-Card--link': href && !type,
+    'is-checked': type === 'radio' ? value === state : type === 'checkbox' ? checked : undefined
+  }, className);
+  // Object with common props that will be passed to the `Card` components
+  const commonProps = {
+    className: commonClasses,
+    id: componentId,
+    isDisabled: isDisabled || contextIsDisabled,
+    onClick,
+    ref: reference,
+    'data-testid': testId,
+    isSmall
+  };
+  // Object with Anchor props that will be passed to the `a` element. These
+  // won't be refurned if set to `isDisabled`
+  const anchorProps = href && !isDisabled ? {
+    download,
+    href: href || undefined,
+    hrefLang,
+    rel,
+    target
+  } : {};
+  // Object of all Checked props that will be passed to the root `Card` component
+  const checkedProps = (type === 'checkbox' || type === 'radio') && !href ? {
+    ...commonProps,
+    'aria-checked': type === 'radio' ? value === state : type === 'checkbox' ? checked : undefined,
+    'aria-describedby': `${componentId}-title`,
+    'aria-disabled': isDisabled,
+    'data-value': value ?? undefined,
+    role: type === 'checkbox' || type === 'radio' ? type : undefined,
+    onClick: handleClick,
+    onKeyDown: event => {
+      if (event.key === 'Enter' || event.key === ' ') {
+        handleClick();
+      }
+    },
+    ref: reference,
+    tabIndex: 0
+  } : {};
+  const getTitle = () => {
+    const titleContent = href && !type ? /*#__PURE__*/jsx("a", {
+      className: "np-Card-titleLink",
+      ...anchorProps,
+      children: title
+    }) : title;
+    const titleProps = {
+      id: `${componentId}-title`,
+      as: headingLevel,
+      className: 'np-Card-title'
+    };
+    return useDisplayFont ? /*#__PURE__*/jsx(Display, {
+      type: Typography.DISPLAY_SMALL,
+      ...titleProps,
+      children: titleContent
+    }) : /*#__PURE__*/jsx(Title, {
+      type: Typography.TITLE_SUBSECTION,
+      ...titleProps,
+      children: titleContent
+    });
+  };
+  useEffect(() => {
+    setChecked(defaultChecked ?? isChecked ?? false);
+  }, [defaultChecked, isChecked]);
+  return /*#__PURE__*/jsxs(Card, {
+    ...commonProps,
+    ...checkedProps,
+    ...props,
+    children: [(value === state || checked) && /*#__PURE__*/jsx("span", {
+      className: "np-Card-check",
+      children: /*#__PURE__*/jsx(Check, {
+        size: 24,
+        "aria-hidden": "true"
+      })
+    }), getTitle(), /*#__PURE__*/jsx(Body, {
+      className: "np-Card-description",
+      children: description
+    }), imageSource && /*#__PURE__*/jsx("div", {
+      className: classNames('np-Card-image', {
+        imageClass
+      }),
+      children: /*#__PURE__*/jsx(Image, {
+        src: imageSource,
+        alt: imageAlt || '',
+        loading: "lazy"
+      })
+    }), /*#__PURE__*/jsx(PromoCardIndicator, {
+      label: indicatorLabel,
+      icon: getIconType(),
+      isSmall: isSmall
+    })]
+  });
+});
+var PromoCard$1 = /*#__PURE__*/React__default.memo(PromoCard);
+
 const PromoCardGroup = ({
   children,
   className,
@@ -12572,7 +12275,7 @@ const ProcessingStep = props => {
     "aria-hidden": isComplete,
     children: /*#__PURE__*/jsxs("div", {
       className: "droppable-card-content",
-      children: [/*#__PURE__*/jsx(ProcessIndicator$1, {
+      children: [/*#__PURE__*/jsx(ProcessIndicator, {
         size: Size.Small,
         status: processStatus,
         onAnimationCompleted: status => onAnimationCompleted(status)
@@ -13395,7 +13098,7 @@ const UploadItem = ({
     switch (status) {
       case Status.PROCESSING:
       case Status.PENDING:
-        processIndicator = /*#__PURE__*/jsx(ProcessIndicator$1, {
+        processIndicator = /*#__PURE__*/jsx(ProcessIndicator, {
           size: Size.EXTRA_SMALL,
           status: Status.PROCESSING
         });
@@ -13406,7 +13109,7 @@ const UploadItem = ({
         processIndicator = isModern ? /*#__PURE__*/jsx(StatusIcon, {
           size: Size.SMALL,
           sentiment: Sentiment.POSITIVE
-        }) : /*#__PURE__*/jsx(ProcessIndicator$1, {
+        }) : /*#__PURE__*/jsx(ProcessIndicator, {
           size: Size.EXTRA_SMALL,
           status: Status.SUCCEEDED
         });
@@ -13421,7 +13124,7 @@ const UploadItem = ({
       children: processIndicator
     }); // Scale down ProcessIndicator to be 20px*20px to match `icons`
   };
-  const getErrorMessage = () => typeof error === 'object' && error.message || error || formatMessage(MESSAGES.uploadingFailed);
+  const getErrorMessage = () => typeof error === 'object' ? error.message : error || formatMessage(MESSAGES.uploadingFailed);
   const getDescription = () => {
     if (error || status === Status.FAILED) {
       return /*#__PURE__*/jsx(Body, {
@@ -14758,5 +14461,5 @@ const translations = {
   'zh-HK': zhHK
 };
 
-export { Accordion, ActionButton, ActionOption, Alert, AlertArrowPosition, Avatar, AvatarType, AvatarWrapper, Badge, Card$2 as BaseCard, Body, BottomSheet$1 as BottomSheet, Breakpoint, Button, Card$1 as Card, Carousel, Checkbox, CheckboxButton$1 as CheckboxButton, CheckboxOption, Chevron, Chip, Chips, CircularButton, ControlType, CriticalCommsBanner, DEFAULT_LANG, DEFAULT_LOCALE, DateInput, DateLookup$1 as DateLookup, DateMode, Decision, DecisionPresentation, DecisionType, DefinitionList$1 as DefinitionList, Dimmer$1 as Dimmer, Direction, DirectionProvider, Display, Drawer$1 as Drawer, DropFade, Emphasis, Field, FileType, FlowNavigation, Header, Image, Info, InfoPresentation, InlineAlert, Input, InputGroup, InputWithDisplayFormat, InstructionsList, Label, LanguageProvider, Layout, Link, ListItem$1 as ListItem, Loader, Logo$1 as Logo, LogoType, Markdown, MarkdownNodeType, Modal, Money, MoneyInput$1 as MoneyInput, MonthFormat, NavigationOption, NavigationOptionList as NavigationOptionsList, Nudge, Option$2 as Option, OverlayHeader$1 as OverlayHeader, PhoneNumberInput, Popover$1 as Popover, Position, Priority, ProcessIndicator$1 as ProcessIndicator, ProfileType, Progress, ProgressBar, PromoCard$1 as PromoCard, PromoCardGroup$1 as PromoCardGroup, Provider, RTL_LANGUAGES, Radio, RadioGroup, RadioOption, SUPPORTED_LANGUAGES, Scroll, SearchInput, Section, SegmentedControl, Select, SelectInput, SelectInputOptionContent, SelectInputTriggerButton, Sentiment, Size, SlidingPanel, SnackbarConsumer, SnackbarContext, SnackbarPortal, SnackbarProvider, Status, StatusIcon, Stepper, Sticky, Summary, Switch, SwitchOption, Tabs$1 as Tabs, TextArea, TextareaWithDisplayFormat, Theme, Title, Tooltip, Type, Typeahead, Typography, Upload$1 as Upload, UploadInput, UploadStep, Variant, Width, adjustLocale, getCountryFromLocale, getDirectionFromLocale, getLangFromLocale, isBrowser, isServerSide, translations, useDirection, useLayout, useScreenSize, useSnackbar };
+export { Accordion, ActionButton, ActionOption, Alert, AlertArrowPosition, Avatar, AvatarType, AvatarWrapper, Badge, Card as BaseCard, Body, BottomSheet$1 as BottomSheet, Breakpoint, Button, Card$2 as Card, Checkbox, CheckboxButton$1 as CheckboxButton, CheckboxOption, Chevron, Chip, Chips, CircularButton, ControlType, CriticalCommsBanner, DEFAULT_LANG, DEFAULT_LOCALE, DateInput, DateLookup$1 as DateLookup, DateMode, Decision, DecisionPresentation, DecisionType, DefinitionList$1 as DefinitionList, Dimmer$1 as Dimmer, Direction, DirectionProvider, Display, Drawer$1 as Drawer, DropFade, Emphasis, Field, FileType, FlowNavigation, Header, Image, Info, InfoPresentation, InlineAlert, Input, InputGroup, InputWithDisplayFormat, InstructionsList, Label, LanguageProvider, Layout, Link, ListItem$1 as ListItem, Loader, Logo$1 as Logo, LogoType, Markdown, MarkdownNodeType, Modal, Money, MoneyInput$1 as MoneyInput, MonthFormat, NavigationOption, NavigationOptionList as NavigationOptionsList, Nudge, Option$2 as Option, OverlayHeader$1 as OverlayHeader, PhoneNumberInput, Popover$1 as Popover, Position, Priority, ProcessIndicator, ProfileType, Progress, ProgressBar, PromoCard$1 as PromoCard, PromoCardGroup$1 as PromoCardGroup, Provider, RTL_LANGUAGES, Radio, RadioGroup, RadioOption, SUPPORTED_LANGUAGES, Scroll, SearchInput, Section, SegmentedControl, Select, SelectInput, SelectInputOptionContent, SelectInputTriggerButton, Sentiment, Size, SlidingPanel, SnackbarConsumer, SnackbarContext, SnackbarPortal, SnackbarProvider, Status, StatusIcon, Stepper, Sticky, Summary, Switch, SwitchOption, Tabs$1 as Tabs, TextArea, TextareaWithDisplayFormat, Theme, Title, Tooltip, Type, Typeahead, Typography, Upload$1 as Upload, UploadInput, UploadStep, Variant, Width, adjustLocale, getCountryFromLocale, getDirectionFromLocale, getLangFromLocale, isBrowser, isServerSide, translations, useDirection, useLayout, useScreenSize, useSnackbar };
 //# sourceMappingURL=index.mjs.map