@transferwise/components 46.159.2 → 46.160.1

package/src/ProgressBar/_stories/ProgressBar.test.story.tsx

@@ -1,6 +1,6 @@
 import type { Meta, StoryObj } from '@storybook/react-webpack5';
 
-import { withRTLDiff } from '../../../.storybook/decorators/RtlDiffDecorator';
+import { useRtlDiffI18n, withRTLDiff } from '../../../.storybook/decorators/RtlDiffDecorator';
 import ProgressBar from '..';
 
 export default {
@@ -12,22 +12,36 @@ export default {
 type Story = StoryObj<typeof ProgressBar>;
 
 export const RTLDiff: Story = {
-  render: () => (
-    <>
-      <ProgressBar
-        id="progress-bar-with-description"
-        title="Send 5,550 GBP"
-        description="You have 3 days to reach your goal."
-        progress={{ value: 50, max: 100 }}
-        textEnd="200 GBP to go"
-      />
-      <ProgressBar
-        id="progress-bar-without-description"
-        title="Total limit"
-        progress={{ value: 800, max: 1000 }}
-        textEnd="200 GBP remaining"
-      />
-    </>
-  ),
-  ...withRTLDiff(),
+  render: () => {
+    const i18n = useRtlDiffI18n();
+    return (
+      <>
+        <ProgressBar
+          id="progress-bar-with-description"
+          title={i18n.title1}
+          description={i18n.description}
+          progress={{ value: 50, max: 100 }}
+          textEnd={i18n.textEnd1}
+        />
+        <ProgressBar
+          id="progress-bar-without-description"
+          title={i18n.title2}
+          progress={{ value: 800, max: 1000 }}
+          textEnd={i18n.textEnd2}
+        />
+      </>
+    );
+  },
+  ...withRTLDiff({
+    i18n: {
+      title1: { ltr: 'Send 5,550 GBP', rtl: 'أرسل ٥٬٥٥٠ جنيه إسترليني' },
+      description: {
+        ltr: 'You have 3 days to reach your goal.',
+        rtl: 'لديك ٣ أيام للوصول إلى هدفك.',
+      },
+      textEnd1: { ltr: '200 GBP to go', rtl: '٢٠٠ جنيه إسترليني متبقي' },
+      title2: { ltr: 'Total limit', rtl: 'الحد الإجمالي' },
+      textEnd2: { ltr: '200 GBP remaining', rtl: '٢٠٠ جنيه إسترليني متبقي' },
+    },
+  }),
 };

package/src/PromoCard/PromoCard.css

@@ -17,43 +17,34 @@
 .np-Card-image {
   transform: scale(var(--Card-image-scale)) translateY(var(--Card-image-translate));
   transition: transform 0.5s ease-in-out;
-  margin: 0 auto;
-  width: 100%;
-  height: auto;
-  width: calc(100% + 48px);
-  width: calc(100% + var(--size-48));
-  left: calc(24px * -1);
-  left: calc(var(--size-24) * -1);
+  margin-block: 0;
+  margin-inline: auto;
+  inline-size: 100%;
+  block-size: auto;
+  inline-size: calc(100% + 48px);
+  inline-size: calc(100% + var(--size-48));
+  inset-inline-start: calc(24px * -1);
+  inset-inline-start: calc(var(--size-24) * -1);
   position: relative;
 }
-[dir="rtl"] .np-Card-image {
-  left: auto;
-  right: calc(24px * -1);
-  right: calc(var(--size-24) * -1);
-}
 .np-Card-description {
   color: #5d7079;
   color: var(--color-content-secondary);
 }
 .np-Card-indicator {
   position: absolute;
-  right: 8px;
-  right: var(--size-8);
-  bottom: 8px;
-  bottom: var(--size-8);
+  inset-inline-end: 8px;
+  inset-inline-end: var(--size-8);
+  inset-block-end: 8px;
+  inset-block-end: var(--size-8);
   display: flex;
   gap: 4px;
   gap: var(--size-4);
 }
-[dir="rtl"] .np-Card-indicator {
-  right: auto;
-  left: 8px;
-  left: var(--size-8);
-}
 .np-Card-indicatorText {
   display: inline-block;
   vertical-align: middle;
-  text-align: left;
+  text-align: start;
   background: var(--Card-indicator-text-background-color);
   padding: 16px;
   padding: var(--size-16);
@@ -130,12 +121,12 @@
   outline: none;
 }
 .np-Card--link .np-Card-titleLink::after {
-  content: '';
+  content: "";
   display: block;
-  width: 100%;
-  height: 100%;
-  left: 0;
-  top: 0;
+  inline-size: 100%;
+  block-size: 100%;
+  inset-inline-start: 0;
+  inset-block-start: 0;
   position: absolute;
   z-index: 10;
 }
@@ -149,23 +140,18 @@
   border-radius: 9999px;
   border-radius: var(--radius-full);
   display: flex;
-  height: 40px;
-  height: var(--size-40);
+  block-size: 40px;
+  block-size: var(--size-40);
   position: absolute;
-  right: 8px;
-  right: var(--size-8);
-  top: 8px;
-  top: var(--size-8);
-  width: 40px;
-  width: var(--size-40);
+  inset-inline-end: 8px;
+  inset-inline-end: var(--size-8);
+  inset-block-start: 8px;
+  inset-block-start: var(--size-8);
+  inline-size: 40px;
+  inline-size: var(--size-40);
   justify-content: center;
   align-items: center;
 }
-[dir="rtl"] .np-Card--checked.is-checked .np-Card-check {
-  right: auto;
-  left: 8px;
-  left: var(--size-8);
-}
 .np-Card--checked.is-checked:focus-visible:not(.is-disabled):not(:disabled) {
   box-shadow: none;
 }
@@ -174,7 +160,7 @@
   flex-direction: column;
   gap: 24px;
   gap: var(--size-24);
-  width: 100%;
+  inline-size: 100%;
 }
 @media (min-width: 840px) {
   .np-CardGroup {
@@ -182,5 +168,5 @@
   }
 }
 .np-CardGroup .np-Card.np-Card--promoCard {
-  max-width: 100%;
+  max-inline-size: 100%;
 }

package/src/PromoCard/PromoCard.less

@@ -12,31 +12,26 @@
     --Card-max-width: 358px;
 
     &.is-disabled {
-      opacity: .45;
+      opacity: 0.45;
       filter: grayscale(1);
     }
   }
 
   &-image {
     transform: scale(var(--Card-image-scale)) translateY(var(--Card-image-translate));
-    transition: transform .5s ease-in-out;
+    transition: transform 0.5s ease-in-out;
     margin: 0 auto;
     width: 100%;
     height: auto;
     width: calc(100% + var(--size-48)); // Ensures we have 100% width to parent
     left: calc(var(--size-24) * -1);
     position: relative;
-
-    [dir="rtl"] & {
-      left: auto;
-      right: calc(var(--size-24) * -1);
-    }
   }
 
   &-description {
     color: var(--color-content-secondary);
   }
-  
+
   &-indicator {
     position: absolute;
     right: var(--size-8);
@@ -44,11 +39,6 @@
     display: flex;
     gap: var(--size-4);
 
-    [dir="rtl"] & {
-      right: auto;
-      left: var(--size-8);
-    }
-    
     &Text {
       display: inline-block;
       vertical-align: middle;
@@ -57,7 +47,7 @@
       padding: var(--size-16);
       border-radius: 100px;
     }
-    
+
     &Icon .tw-icon {
       color: var(--Card-indicator-icon-color);
 
@@ -67,19 +57,26 @@
       }
     }
   }
-  
+
   &--checked,
   &--link {
     color: currentColor;
     cursor: pointer;
     box-shadow: none;
     transform: scale(1);
-    transition: box-shadow .2s ease-in-out, transform .5s ease-in-out;
+    transition:
+      box-shadow 0.2s ease-in-out,
+      transform 0.5s ease-in-out;
 
-    // Defines a box shadow for the Card component that is only applied 
-    // when it is a child of an element with the class np-theme-personal 
+    // Defines a box shadow for the Card component that is only applied
+    // when it is a child of an element with the class np-theme-personal
     // and does not have the class `'np-theme-personal--(dark|bright-green|forest-green)'`.
-    .np-theme-personal:not(.np-theme-personal--dark, .np-theme-personal--bright-green, .np-theme-personal--forest-green) & {
+    .np-theme-personal:not(
+        .np-theme-personal--dark,
+        .np-theme-personal--bright-green,
+        .np-theme-personal--forest-green
+      )
+      & {
       --Card-box-shadow: 0px 20px var(--size-40) 0px var(--color-background-neutral);
       --Card-check-color: var(--color-interactive-accent);
     }
@@ -87,25 +84,25 @@
     &.is-disabled {
       cursor: not-allowed;
     }
-    
+
     // Removes all animations for users who prefer reduced motion
     @media (prefers-reduced-motion: reduce) {
       transition: none;
     }
-    
+
     &:hover:not(.is-disabled, :disabled, .is-checked, :focus-within) {
       --Card-image-scale: 1.1;
       box-shadow: var(--Card-box-shadow);
     }
-  
-    &:active:not(.is-disabled, :disabled, .is-checked) { 
+
+    &:active:not(.is-disabled, :disabled, .is-checked) {
       --Card-background-color: var(--color-background-neutral-active);
       --Card-image-scale: 1.1;
       --Card-image-translate: var(--size-8);
       transform: scale(98%);
       box-shadow: var(--Card-box-shadow);
 
-      // Required as --color-background-elevated isn't present within the 
+      // Required as --color-background-elevated isn't present within the
       // bright-green theme
       .np-theme-personal--bright-green & {
         --Card-background-color: var(--color-background-neutral);
@@ -135,7 +132,7 @@
       }
 
       &::after {
-        content: '';
+        content: "";
         display: block;
         width: 100%;
         height: 100%;
@@ -150,7 +147,7 @@
   &--checked {
     &.is-checked {
       box-shadow: 0 0 0 var(--size-4) var(--color-interactive-primary);
-      
+
       .np-Card-check {
         color: var(--Card-check-color);
         background: var(--Card-check-background-color);
@@ -163,13 +160,8 @@
         width: var(--size-40);
         justify-content: center;
         align-items: center;
-
-        [dir="rtl"] & {
-          right: auto;
-          left: var(--size-8);
-        }
       }
-      
+
       &:focus-visible:not(.is-disabled, :disabled) {
         box-shadow: none;
       }

package/src/Prompt/ActionPrompt/ActionPrompt.css

@@ -6,26 +6,26 @@
   --Prompt-border-radius: var(--radius-large);
 }
 .wds-action-prompt--media-image {
-  width: 48px;
-  width: var(--size-48);
-  height: 48px;
-  height: var(--size-48);
+  inline-size: 48px;
+  inline-size: var(--size-48);
+  block-size: 48px;
+  block-size: var(--size-48);
   -o-object-fit: contain;
      object-fit: contain;
 }
 @media (max-width: 599.98px) {
   .wds-action-prompt .wds-action-prompt__action {
-    width: 100%;
+    inline-size: 100%;
   }
 }
 @media (max-width: 599.98px) {
   .wds-action-prompt--with-two-actions .wds-action-prompt__action {
     flex: 1 1 calc(50% - (var(--Prompt-actions-gap) / 2));
-    min-width: -moz-fit-content;
-    min-width: fit-content;
+    min-inline-size: -moz-fit-content;
+    min-inline-size: fit-content;
   }
 }
 .wds-action-prompt__content {
-  max-width: calc(48px * 10);
-  max-width: calc(var(--size-48) * 10);
+  max-inline-size: calc(48px * 10);
+  max-inline-size: calc(var(--size-48) * 10);
 }

package/src/Prompt/CriticalBanner/CriticalBanner.css

@@ -19,10 +19,10 @@
   background: var(--critical-banner-background);
 }
 .wds-critical-banner--media-image {
-  width: 48px;
-  width: var(--size-48);
-  height: 48px;
-  height: var(--size-48);
+  inline-size: 48px;
+  inline-size: var(--size-48);
+  block-size: 48px;
+  block-size: var(--size-48);
   -o-object-fit: contain;
      object-fit: contain;
 }
@@ -31,23 +31,23 @@
   -webkit-line-clamp: 8;
   line-clamp: 8;
   -webkit-box-orient: vertical;
-  max-height: 192px;
+  max-block-size: 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;
+  max-block-size: 48px;
 }
 .wds-critical-banner__description {
-  max-height: 30vh;
+  max-block-size: 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;
+  max-block-size: 0;
   opacity: 0;
 }
 .wds-critical-banner--collapsed .wds-critical-banner__description:not(.wds-critical-banner__description--with-title) {
@@ -72,9 +72,9 @@
   justify-content: center;
   align-items: flex-start;
   text-align: start;
-  min-width: 0;
-  max-width: 480px;
-  height: 100%;
+  min-inline-size: 0;
+  max-inline-size: 480px;
+  block-size: 100%;
 }
 .wds-critical-banner--collapsed .wds-critical-banner__title,
 .wds-critical-banner--collapsed .wds-critical-banner__description {
@@ -95,22 +95,22 @@
 .wds-critical-banner .wds-prompt__actions-wrapper {
   grid-column-start: 2;
   grid-column-end: 3;
-  max-height: 200px;
+  max-block-size: 200px;
   opacity: 1;
   overflow: visible;
 }
 @container (max-width: 600px) {
   .wds-critical-banner .wds-prompt__actions-wrapper {
     grid-column: span 3;
-    width: 100%;
+    inline-size: 100%;
   }
   .wds-critical-banner .wds-prompt__actions-wrapper .wds-Button {
     flex: 1 1 100%;
-    width: 100%;
+    inline-size: 100%;
   }
 }
 .wds-critical-banner--collapsed .wds-prompt__actions-wrapper {
-  max-height: 0;
+  max-block-size: 0;
   opacity: 0;
   overflow: hidden;
   pointer-events: none;
@@ -118,8 +118,8 @@
 @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;
+    min-inline-size: -moz-fit-content;
+    min-inline-size: fit-content;
   }
 }
 .wds-critical-banner-overhang-query {
@@ -139,22 +139,51 @@
           )
           100% 0 / var(--critical-banner-mobile-overhang-size)
           var(--critical-banner-mobile-overhang-size) no-repeat;
-    margin-bottom: 32px;
-    margin-bottom: var(--critical-banner-mobile-overhang-size);
+    margin-block-end: 32px;
+    margin-block-end: var(--critical-banner-mobile-overhang-size);
   }
   .wds-critical-banner-overhang-query .wds-critical-banner-overhang::after {
     content: "";
     position: absolute;
-    right: 0;
-    bottom: calc(-1 * var(--critical-banner-mobile-overhang-size));
-    left: 0;
-    height: var(--critical-banner-mobile-overhang-size);
+    inset-inline-end: 0;
+    inset-block-end: calc(-1 * var(--critical-banner-mobile-overhang-size));
+    inset-inline-start: 0;
+    block-size: var(--critical-banner-mobile-overhang-size);
     pointer-events: none;
     background: var(--critical-banner-background);
     -webkit-mask: var(--critical-banner-overhang-mask);
     mask: var(--critical-banner-overhang-mask);
   }
 }
+.wds-critical-banner__entry-mask {
+  display: grid;
+  grid-template-rows: 1fr;
+  overflow: visible;
+}
+.wds-critical-banner__entry-mask--animated {
+  grid-template-rows: 0fr;
+  overflow: hidden;
+  animation: wds-critical-banner-reveal-height 400ms cubic-bezier(0.3, 0, 0.1, 1) 500ms both, wds-critical-banner-release-overflow 1ms linear 899ms both;
+}
+.wds-critical-banner__entry-track {
+  min-block-size: 0;
+}
+@keyframes wds-critical-banner-reveal-height {
+  from {
+    grid-template-rows: 0fr;
+  }
+  to {
+    grid-template-rows: 1fr;
+  }
+}
+@keyframes wds-critical-banner-release-overflow {
+  from {
+    overflow: hidden;
+  }
+  to {
+    overflow: visible;
+  }
+}
 @media (prefers-reduced-motion: reduce) {
   .wds-critical-banner__description,
   .wds-critical-banner__title,
@@ -162,4 +191,9 @@
   .wds-critical-banner__toggle {
     transition: none !important;
   }
+  .wds-critical-banner__entry-mask--animated {
+    animation: none;
+    grid-template-rows: 1fr;
+    overflow: visible;
+  }
 }

package/src/Prompt/CriticalBanner/CriticalBanner.less

@@ -193,6 +193,45 @@
   }
 }
 
+.wds-critical-banner__entry-mask {
+  display: grid;
+  grid-template-rows: 1fr;
+  overflow: visible;
+
+  // Clip only during the reveal, then release overflow so actions remain visible.
+  &--animated {
+    grid-template-rows: 0fr;
+    overflow: hidden;
+    animation:
+      wds-critical-banner-reveal-height 400ms cubic-bezier(0.3, 0, 0.1, 1) 500ms both,
+      wds-critical-banner-release-overflow 1ms linear 899ms both;
+  }
+}
+
+.wds-critical-banner__entry-track {
+  min-height: 0;
+}
+
+@keyframes wds-critical-banner-reveal-height {
+  from {
+    grid-template-rows: 0fr;
+  }
+
+  to {
+    grid-template-rows: 1fr;
+  }
+}
+
+@keyframes wds-critical-banner-release-overflow {
+  from {
+    overflow: hidden;
+  }
+
+  to {
+    overflow: visible;
+  }
+}
+
 // Reduced motion support
 @media (prefers-reduced-motion: reduce) {
   .wds-critical-banner__description,
@@ -201,4 +240,10 @@
   .wds-critical-banner__toggle {
     transition: none !important;
   }
+
+  .wds-critical-banner__entry-mask--animated {
+    animation: none;
+    grid-template-rows: 1fr;
+    overflow: visible;
+  }
 }

package/src/Prompt/CriticalBanner/CriticalBanner.test.tsx

@@ -15,7 +15,7 @@ describe('CriticalBanner', () => {
     resetLiveRegionAnnouncementQueue();
   });
 
-  it('renders mobile overhang markup without entry animation markup', () => {
+  it('applies mobile overhang classes by default', () => {
     const { container } = render(
       <CriticalBanner {...defaultProps} data-testid="critical-banner" />,
     );
@@ -23,7 +23,30 @@ describe('CriticalBanner', () => {
     expect(screen.getByTestId('critical-banner')).toBeInTheDocument();
     expect(container.querySelector('.wds-critical-banner-overhang')).toBeInTheDocument();
     expect(container.querySelector('.wds-critical-banner-overhang-query')).toBeInTheDocument();
-    expect(container.querySelector('.wds-critical-banner__entry-mask')).not.toBeInTheDocument();
-    expect(container.querySelector('.wds-critical-banner__entry-track')).not.toBeInTheDocument();
+  });
+
+  it('applies the entry animation by default', () => {
+    const { container } = render(
+      <CriticalBanner {...defaultProps} data-testid="critical-banner" />,
+    );
+
+    expect(screen.getByTestId('critical-banner')).toBeInTheDocument();
+    expect(
+      container.querySelector('.wds-critical-banner__entry-mask--animated'),
+    ).toBeInTheDocument();
+    expect(container.querySelector('.wds-critical-banner__entry-track')).toBeInTheDocument();
+  });
+
+  it('can render without the entry animation', () => {
+    const { container } = render(
+      <CriticalBanner {...defaultProps} animateEntry={false} data-testid="critical-banner" />,
+    );
+
+    expect(screen.getByTestId('critical-banner')).toBeInTheDocument();
+    expect(container.querySelector('.wds-critical-banner__entry-mask')).toBeInTheDocument();
+    expect(
+      container.querySelector('.wds-critical-banner__entry-mask--animated'),
+    ).not.toBeInTheDocument();
+    expect(container.querySelector('.wds-critical-banner__entry-track')).toBeInTheDocument();
   });
 });

package/src/Prompt/CriticalBanner/CriticalBanner.tsx

@@ -24,6 +24,11 @@ export type CriticalBannerProps = {
     label: ButtonProps['children'];
   };
   sentiment?: Exclude<PrimitivePromptProps['sentiment'], 'proposition'>;
+  /**
+   * Controls whether the banner plays its entry animation 500ms after mounting.
+   * Expand and collapse animations are unaffected.
+   */
+  animateEntry?: boolean;
   /**
    * Controls whether the description and actions are visible, as a controlled component.
    * When collapsed with a title, only the title is shown.
@@ -53,6 +58,7 @@ export const CriticalBanner = ({
   media = {},
   action,
   actionSecondary,
+  animateEntry = true,
   expanded: expandedProp,
   onToggle,
   id,
@@ -179,7 +185,15 @@ export const CriticalBanner = ({
         actionSecondaryLabel: actionSecondary?.label,
       })}
     >
-      <div className="wds-critical-banner-overhang-query">{bannerSurface}</div>
+      <div className="wds-critical-banner-overhang-query">
+        <div
+          className={clsx('wds-critical-banner__entry-mask', {
+            'wds-critical-banner__entry-mask--animated': animateEntry,
+          })}
+        >
+          <div className="wds-critical-banner__entry-track">{bannerSurface}</div>
+        </div>
+      </div>
     </LiveRegion>
   );
 };

package/src/Prompt/CriticalBanner/_stories/CriticalBanner.accessibility.docs.mdx

@@ -66,7 +66,10 @@ Screen readers announce the banner content whenever:
 
 ## Reduced Motion
 
-`CriticalBanner` respects the user's reduced motion preference. When reduced motion is on, the component does not show the collapse and expand animation used when the user toggles the banner content.
+`CriticalBanner` respects the user's reduced motion preference. When reduced motion is on, the component does not show:
+
+- the entry animation that reveals the banner from above when it first appears
+- the collapse and expand animation used when the user toggles the banner content
 
 The same content is still rendered and announced. Reduced motion only removes the visual movement.