@transferwise/components 46.136.0 → 46.137.0

package/src/main.less

@@ -67,6 +67,9 @@
 @import "./prompt/PrimitivePrompt/PrimitivePrompt.less";
 @import "./prompt/InlinePrompt/InlinePrompt.less";
 @import "./prompt/InfoPrompt/InfoPrompt.less";
+@import "./prompt/ActionPrompt/ActionPrompt.less";
+@import "./prompt/CriticalBanner/CriticalBanner.less";
+@import "./prompt/common/Expander/Expander.less";
 @import "./radioGroup/RadioGroup.less";
 @import "./section/Section.less";
 @import "./slidingPanel/SlidingPanel.less";
@@ -91,7 +94,6 @@
 @import "./progress/Progress.less";
 @import "./progressBar/ProgressBar.less";
 @import "./legacylistItem/LegacyListItem.less";
-@import "./prompt/ActionPrompt/ActionPrompt.less";
 
 // List all less files in src in alphabetical order: find -s src -type f -name '*.less' ! -name 'main.less'
 // Make sure you are not referencing main.less itself in this file!

package/src/prompt/ActionPrompt/ActionPrompt.tsx

@@ -1,31 +1,19 @@
 import { AriaAttributes, ReactNode, useId } from 'react';
 import { clsx } from 'clsx';
 
-import StatusIcon from '../../statusIcon';
 import Body from '../../body';
 import Button from '../../button';
 import { Breakpoint, Typography } from '../../common';
-import AvatarView, { AvatarViewProps } from '../../avatarView';
-import Image from '../../image';
 import { ButtonProps } from '../../button/Button.types';
 import { PrimitivePrompt, PrimitivePromptProps } from '../PrimitivePrompt';
-import { BadgeAssetsProps } from '../../badge';
-import { GiftBox } from '@transferwise/icons';
 import { useScreenSize } from '../../common/hooks/useScreenSize';
+import { renderPromptMedia, PromptMedia } from '../helpers/promptMedia';
 
 export type ActionPromptProps = {
   title: ReactNode;
   description?: ReactNode;
   /** @default {} */
-  media?: {
-    imgSrc?: string;
-    avatar?: Pick<AvatarViewProps, 'imgSrc' | 'profileName' | 'profileType'> & {
-      asset?: AvatarViewProps['children'];
-      badge?: Pick<BadgeAssetsProps, 'flagCode'>;
-    };
-    'aria-label'?: string;
-    'aria-hidden'?: boolean;
-  };
+  media?: PromptMedia;
   action: Pick<ButtonProps, 'onClick' | 'href' | 'target'> & {
     label: ButtonProps['children'];
   };
@@ -74,54 +62,13 @@ export const ActionPrompt = ({
     .filter(Boolean)
     .join(' ');
 
-  const renderMedia = () => {
-    if (media?.imgSrc) {
-      return (
-        <Image
-          id={mediaId}
-          src={media.imgSrc}
-          className="wds-action-prompt--media-image"
-          alt={media['aria-label'] ?? ''}
-        />
-      );
-    }
-    if (media?.avatar) {
-      const badge = media.avatar.badge
-        ? media.avatar.badge
-        : sentiment === 'proposition'
-          ? {}
-          : { status: sentiment };
-      return (
-        <AvatarView
-          {...media.avatar}
-          badge={badge}
-          aria-label={media['aria-label']}
-          aria-hidden={media['aria-hidden']}
-          id={mediaId}
-          size={48}
-        >
-          {media.avatar.asset}
-        </AvatarView>
-      );
-    }
-    return sentiment === 'proposition' ? (
-      <AvatarView
-        id={mediaId}
-        size={48}
-        aria-label={media['aria-label']}
-        aria-hidden={media['aria-hidden']}
-      >
-        <GiftBox />
-      </AvatarView>
-    ) : (
-      <StatusIcon
-        id={mediaId}
-        size={48}
-        sentiment={sentiment}
-        iconLabel={media['aria-hidden'] ? null : media['aria-label']}
-      />
-    );
-  };
+  const renderMedia = () =>
+    renderPromptMedia({
+      media,
+      sentiment,
+      mediaId,
+      imgClassName: 'wds-action-prompt--media-image',
+    });
 
   return (
     <PrimitivePrompt

package/src/prompt/CriticalBanner/CriticalBanner.accessibility.docs.mdx

@@ -0,0 +1,113 @@
+import { Meta, Source, Canvas } from '@storybook/addon-docs/blocks';
+import * as CriticalBannerStories from './CriticalBanner.story';
+
+<Meta title="Prompts/CriticalBanner/Accessibility" tags={['new']} />
+
+# Accessibility
+
+Under the hood, `CriticalBanner` is marked as `role="region"` for a section of content that users might want to navigate to directly.
+
+By default, it's labelled by the `title` and described by the `description`.
+
+## Announcement Behavior
+
+`CriticalBanner` is designed for critical messages that require immediate attention. It always uses **`aria-live="assertive"`** to immediately interrupt and announce changes to screen readers.
+
+Unlike `InfoPrompt` which offers configurable politeness levels, `CriticalBanner` is always assertive because it communicates critical, time-sensitive information that users must be aware of immediately.
+
+### What Gets Announced
+
+The component intelligently announces only **visible content**, respecting the collapsed/expanded state:
+
+- **Collapsed with title**: Announces title only (description is hidden)
+- **Collapsed without title**: Announces description only (visible up to 2 lines)
+- **Expanded**: Announces title, description, and action button labels (all visible)
+
+<Source
+  dark
+  code={`
+// Collapsed with title - announces: "Your account requires verification"
+<CriticalBanner
+  title="Your account requires verification"
+  description="Please verify your identity to continue"
+  action={{ label: "Verify now", onClick: handleVerify }}
+  expanded={false}
+  onToggle={handleToggle}
+/>
+
+// Expanded - announces: "Your account requires verification | Please verify your identity to continue | Verify now | Learn more"
+
+<CriticalBanner
+  title="Your account requires verification"
+  description="Please verify your identity to continue"
+  action={{ label: 'Verify now', onClick: handleVerify }}
+  actionSecondary={{ label: 'Learn more', onClick: handleLearnMore }}
+  expanded={true}
+  onToggle={handleToggle}
+/>
+
+// Collapsed without title - announces: "Your verification is pending..."
+
+<CriticalBanner
+  description="Your verification is pending. We'll notify you once complete."
+  expanded={false}
+  onToggle={handleToggle}
+/>
+`}
+/>
+
+### When Announcements Trigger
+
+Screen readers announce the banner content whenever:
+
+- The banner first appears in the DOM
+- The user toggles between collapsed and expanded states
+- The content (title, description, or action labels) changes
+
+## Media
+
+Custom media icons should include their own accessibility attributes. Use the `title` prop on icons to provide accessible names for screen readers:
+
+<Source
+  dark
+  code={`
+import { Bank, AlertCircle } from '@transferwise/icons';
+
+<CriticalBanner
+  title="Bank connection required"
+  description="Connect your bank account to continue"
+  media={{ avatar: { asset: <Bank title="Bank account" /> } }}
+  action={{ label: 'Connect now', onClick: handleConnect }}
+  expanded={false}
+  onToggle={handleToggle}
+/>
+
+<CriticalBanner
+  title="Verification required"
+  description="We need to verify your identity"
+  media={{ avatar: { asset: <AlertCircle title="Alert" /> } }}
+  action={{ label: "Start verification", onClick: handleVerify }}
+  expanded={false}
+  onToggle={handleToggle}
+/>
+`}
+/>
+
+Alternatively, you can use `media['aria-label']` to provide a label for custom images:
+
+<Source
+  dark
+  code={`
+<CriticalBanner
+  title="Card blocked"
+  description="Your card has been blocked for security reasons"
+  media={{
+    imgSrc: '/wise-card.svg',
+    'aria-label': 'Wise debit card'
+  }}
+  action={{ label: "Unblock card", onClick: handleUnblock }}
+  expanded={false}
+  onToggle={handleToggle}
+/>
+`}
+/>

package/src/prompt/CriticalBanner/CriticalBanner.css

@@ -0,0 +1,134 @@
+.wds-critical-banner {
+  --Prompt-padding: var(--size-16);
+  --Prompt-actions-gap: var(--size-8);
+  --Prompt-gap: var(--size-10) var(--size-16);
+  --Prompt-border-radius: 0;
+  container-type: inline-size;
+  --critical-banner-easing: cubic-bezier(0.9, 0, 0.7, 1);
+  --critical-banner-duration: 150ms;
+  /* Override PrimitivePrompt's --screen-sm-max actions behaviour:
+     actions only go full-width below mobile-max token (container query) */
+}
+.wds-critical-banner--media-image {
+  width: 48px;
+  width: var(--size-48);
+  height: 48px;
+  height: var(--size-48);
+  -o-object-fit: contain;
+     object-fit: contain;
+}
+.wds-critical-banner__title {
+  display: -webkit-box;
+  -webkit-line-clamp: 8;
+  line-clamp: 8;
+  -webkit-box-orient: vertical;
+  max-height: 192px;
+  overflow: hidden;
+  transition: max-height var(--critical-banner-duration) var(--critical-banner-easing);
+}
+.wds-critical-banner--collapsed .wds-critical-banner__title {
+  -webkit-line-clamp: 2;
+  line-clamp: 2;
+  max-height: 48px;
+}
+.wds-critical-banner__description {
+  max-height: 30vh;
+  opacity: 1;
+  overflow: hidden;
+  transition: max-height var(--critical-banner-duration) var(--critical-banner-easing), opacity var(--critical-banner-duration) var(--critical-banner-easing);
+}
+.wds-critical-banner--collapsed .wds-critical-banner__description--with-title {
+  max-height: 0;
+  opacity: 0;
+}
+.wds-critical-banner--collapsed .wds-critical-banner__description:not(.wds-critical-banner__description--with-title) {
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+.wds-critical-banner .wds-prompt__content-wrapper {
+  grid-template-columns: auto 1fr auto;
+  align-items: flex-start;
+  transition: row-gap var(--critical-banner-duration) var(--critical-banner-easing);
+}
+.wds-critical-banner--collapsed .wds-prompt__content-wrapper {
+  row-gap: 0;
+}
+.wds-critical-banner__text-wrapper {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: flex-start;
+  text-align: start;
+  min-width: 0;
+  max-width: 480px;
+  height: 100%;
+  padding-top: 3px;
+}
+@media (max-width: 320px) {
+  .wds-critical-banner__text-wrapper {
+    padding-top: 0;
+  }
+}
+@container (max-width: 320px) {
+  .wds-critical-banner__text-wrapper {
+    padding-top: 0;
+  }
+}
+.wds-critical-banner--collapsed .wds-critical-banner__title,
+.wds-critical-banner--collapsed .wds-critical-banner__description {
+  transform: translateY(0);
+}
+.wds-critical-banner__toggle {
+  flex-shrink: 0;
+  transition: transform var(--critical-banner-duration) var(--critical-banner-easing);
+}
+.wds-critical-banner__toggle--collapsed {
+  transform: rotate(180deg);
+}
+@container (min-width: 768px) {
+  .wds-critical-banner__toggle {
+    display: none;
+  }
+}
+.wds-critical-banner .wds-prompt__actions-wrapper {
+  grid-column-start: 2;
+  grid-column-end: 3;
+  max-height: 200px;
+  opacity: 1;
+  overflow: visible;
+}
+@container (max-width: 600px) {
+  .wds-critical-banner .wds-prompt__actions-wrapper {
+    grid-column: span 3;
+    width: 100%;
+  }
+  .wds-critical-banner .wds-prompt__actions-wrapper .wds-Button {
+    flex: 1 1 100%;
+    width: 100%;
+  }
+}
+.wds-critical-banner--collapsed .wds-prompt__actions-wrapper {
+  max-height: 0;
+  opacity: 0;
+  overflow: hidden;
+  pointer-events: none;
+}
+@container (max-width: 600px) {
+  .wds-critical-banner--with-two-actions .wds-prompt__actions-wrapper .wds-Button {
+    flex: 1 1 calc(50% - (var(--Prompt-actions-gap) / 2));
+    min-width: -moz-fit-content;
+    min-width: fit-content;
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .wds-critical-banner__description,
+  .wds-critical-banner__title,
+  .wds-critical-banner .wds-prompt__content-wrapper,
+  .wds-critical-banner__toggle {
+    transition: none !important;
+  }
+}

package/src/prompt/CriticalBanner/CriticalBanner.less

@@ -0,0 +1,155 @@
+@import (reference) "./CriticalBanner.vars.less";
+
+.wds-critical-banner {
+  --Prompt-padding: var(--size-16);
+  --Prompt-actions-gap: var(--size-8);
+  --Prompt-gap: var(--size-10) var(--size-16);
+  --Prompt-border-radius: 0;
+  container-type: inline-size;
+
+  // Animation variables
+  --critical-banner-easing: cubic-bezier(0.9, 0, 0.7, 1);
+  --critical-banner-duration: 150ms;
+
+  &--media-image {
+    width: var(--size-48);
+    height: var(--size-48);
+    object-fit: contain;
+  }
+
+  &__title {
+    display: -webkit-box;
+    -webkit-line-clamp: 8;
+    line-clamp: 8;
+    -webkit-box-orient: vertical;
+    max-height: 192px; // ~8 lines (24px line-height × 8) - balanced for common cases
+    overflow: hidden;
+    transition: max-height var(--critical-banner-duration) var(--critical-banner-easing);
+  }
+
+  &--collapsed &__title {
+    -webkit-line-clamp: 2;
+    line-clamp: 2;
+    max-height: 48px; // ~2 lines (24px line-height × 2)
+  }
+
+  &__description {
+    max-height: 30vh;
+    opacity: 1;
+    overflow: hidden;
+    transition:
+      max-height var(--critical-banner-duration) var(--critical-banner-easing),
+      opacity var(--critical-banner-duration) var(--critical-banner-easing);
+  }
+
+  &--collapsed &__description--with-title {
+    max-height: 0;
+    opacity: 0;
+  }
+
+  // When collapsed WITHOUT a title: show 2 lines
+  &--collapsed &__description:not(&__description--with-title) {
+    display: -webkit-box;
+    -webkit-line-clamp: 2;
+    line-clamp: 2;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+  }
+
+  .wds-prompt__content-wrapper {
+    grid-template-columns: auto 1fr auto;
+    align-items: flex-start;
+    transition: row-gap var(--critical-banner-duration) var(--critical-banner-easing);
+  }
+
+  &--collapsed .wds-prompt__content-wrapper {
+    row-gap: 0;
+  }
+
+  &__text-wrapper {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    align-items: flex-start;
+    text-align: start;
+    min-width: 0;
+    max-width: 480px;
+    height: 100%;
+
+    // Padding prevents text shifting when collapsing/expanding layout shift
+    padding-top: 3px;
+
+    @media (--screen-400-zoom) {
+      padding-top: 0;
+    }
+
+    @container (max-width: 320px) {
+      padding-top: 0;
+    }
+  }
+
+  &--collapsed &__title,
+  &--collapsed &__description {
+    transform: translateY(0);
+  }
+
+  &__toggle {
+    flex-shrink: 0;
+    transition: transform var(--critical-banner-duration) var(--critical-banner-easing);
+
+    &--collapsed {
+      transform: rotate(180deg);
+    }
+
+    @container (min-width: @wds-critical-banner-collapsible-max) {
+      display: none;
+    }
+  }
+
+  /* Override PrimitivePrompt's --screen-sm-max actions behaviour:
+     actions only go full-width below mobile-max token (container query) */
+  .wds-prompt__actions-wrapper {
+    grid-column-start: 2;
+    grid-column-end: 3;
+    max-height: 200px;
+    opacity: 1;
+    overflow: visible;
+
+    @container (max-width: @wds-critical-banner-action-wrapper-max) {
+      grid-column: span 3;
+      width: 100%;
+
+      .wds-Button {
+        flex: 1 1 100%;
+        width: 100%;
+      }
+    }
+  }
+
+  &--collapsed .wds-prompt__actions-wrapper {
+    max-height: 0;
+    opacity: 0;
+    overflow: hidden;
+    pointer-events: none;
+  }
+
+  &--with-two-actions .wds-prompt__actions-wrapper {
+    @container (max-width: @wds-critical-banner-action-wrapper-max) {
+      .wds-Button {
+        flex: 1 1 calc(50% - (var(--Prompt-actions-gap) / 2));
+        min-width: fit-content;
+      }
+    }
+  }
+}
+
+// Reduced motion support
+@media (prefers-reduced-motion: reduce) {
+  .wds-critical-banner__description,
+  .wds-critical-banner__title,
+  .wds-critical-banner .wds-prompt__content-wrapper,
+  .wds-critical-banner__toggle {
+    transition: none !important;
+  }
+}