@transferwise/components 0.0.0-experimental-6528439 → 0.0.0-experimental-1ffdc56

package/src/alert/Alert.tsx

@@ -32,7 +32,8 @@ type AlertTypeResolved = `${
   | Sentiment.POSITIVE
   | Sentiment.NEUTRAL
   | Sentiment.WARNING
-  | Sentiment.NEGATIVE}`;
+  | Sentiment.NEGATIVE
+  | Sentiment.CRITICAL}`;
 export type AlertType = AlertTypeResolved | AlertTypeDeprecated;
 
 export enum AlertArrowPosition {
@@ -63,6 +64,7 @@ export interface AlertProps {
   onDismiss?: React.MouseEventHandler<HTMLButtonElement>;
   /** The type dictates which icon and colour will be used */
   type?: AlertType;
+  /** @deprecated They both look and behave the same. */
   variant?: `${Variant}`;
   /** @deprecated Use `InlineAlert` instead. */
   arrow?: `${AlertArrowPosition}`;
@@ -152,9 +154,20 @@ export default function Alert({
 
   const closeButtonReference = useRef<HTMLButtonElement>(null);
 
+  const showButtonBelow = () => {
+    if (variant === 'desktop' && resolvedType === 'critical') {
+      return false;
+    }
+    return true;
+  };
+
   return (
     <div
-      role={resolvedType === Sentiment.NEGATIVE ? 'alert' : 'status'}
+      role={
+        resolvedType === Sentiment.NEGATIVE || resolvedType === Sentiment.CRITICAL
+          ? 'alert'
+          : 'status'
+      }
       className="wds-alert__liveRegion"
     >
       <div
@@ -186,15 +199,13 @@ export default function Alert({
         }}
         onTouchMove={() => setShouldFire(false)}
       >
+        <div className="alert__icon">
+          {icon || <StatusIcon size={48} sentiment={resolvedType} iconLabel={statusIconLabel} />}
+        </div>
         <div
           className={clsx('alert__content', 'd-flex', 'flex-grow-1', variant)}
           data-testid={variant}
         >
-          {icon ? (
-            <div className="alert__icon">{icon}</div>
-          ) : (
-            <StatusIcon size={Size.LARGE} sentiment={resolvedType} iconLabel={statusIconLabel} />
-          )}
           <div className="alert__message">
             <div>
               {title && (
@@ -206,9 +217,27 @@ export default function Alert({
                 {children || <InlineMarkdown>{message}</InlineMarkdown>}
               </Body>
             </div>
-            {action && <Action action={action} variant="action-button" className="m-t-1" />}
+            {action && showButtonBelow() && (
+              <Action
+                action={action}
+                variant="action-button"
+                className="m-t-2"
+                sentiment={type === 'critical' ? 'negative' : 'default'}
+                priority={type === 'critical' ? 'secondary' : 'tertiary'}
+              />
+            )}
           </div>
         </div>
+        {action && !showButtonBelow() && (
+          <div className="action__desktop">
+            <Action
+              action={action}
+              variant="action-button"
+              sentiment={type === 'critical' ? 'negative' : 'default'}
+              priority={type === 'critical' ? 'secondary' : 'tertiary'}
+            />
+          </div>
+        )}
         {onDismiss && (
           <CloseButton ref={closeButtonReference} className="m-l-2" onClick={onDismiss} />
         )}

package/src/avatarLayout/AvatarLayout.css

@@ -11,10 +11,18 @@
   -webkit-mask-image: radial-gradient(circle at bottom calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)) right calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)), transparent 0, transparent calc(var(--np-avatar-size) / 2 + 2px), black 0);
           mask-image: radial-gradient(circle at bottom calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)) right calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)), transparent 0, transparent calc(var(--np-avatar-size) / 2 + 2px), black 0);
 }
+[dir="rtl"] .np-avatar-layout-diagonal-mask {
+  -webkit-mask-image: radial-gradient(circle at bottom calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)) left calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)), transparent 0, transparent calc(var(--np-avatar-size) / 2 + 2px), black 0);
+          mask-image: radial-gradient(circle at bottom calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)) left calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)), transparent 0, transparent calc(var(--np-avatar-size) / 2 + 2px), black 0);
+}
 .np-avatar-layout-diagonal-child {
   margin-left: calc(var(--np-avatar-layout-size) - var(--np-avatar-size) * 2);
   margin-top: calc(var(--np-avatar-layout-size) - var(--np-avatar-size));
 }
+[dir="rtl"] .np-avatar-layout-diagonal-child {
+  margin-left: 0;
+  margin-right: calc(var(--np-avatar-layout-size) - var(--np-avatar-size) * 2);
+}
 .np-avatar-layout-horizontal {
   width: calc(var(--np-avatar-size) * var(--np-avatar-avatars-count) - (var(--np-avatar-offset) * (var(--np-avatar-avatars-count) - 1)));
   width: calc(var(--np-avatar-size) * var(--np-avatar-avatars-count) - calc(var(--np-avatar-offset) * calc(var(--np-avatar-avatars-count) - 1)));
@@ -29,3 +37,6 @@
 .np-avatar-layout-horizontal-child {
   margin-left: calc(var(--np-avatar-offset) * -1);
 }
+[dir="rtl"] .np-avatar-layout-horizontal-child {
+  margin-right: calc(var(--np-avatar-offset) * -1);
+}

package/src/avatarLayout/AvatarLayout.less

@@ -13,11 +13,24 @@
           transparent 0,
           transparent calc(var(--np-avatar-size) / 2 + 2px),
           black 0);
+    
+      :dir(rtl) & {
+        mask-image:
+          radial-gradient(circle at bottom calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)) left calc(100% - var(--np-avatar-size) - var(--np-avatar-offset)),
+            transparent 0,
+            transparent calc(var(--np-avatar-size) / 2 + 2px),
+            black 0);
+      }
     }
 
     &-child {
       margin-left: calc(var(--np-avatar-layout-size) - var(--np-avatar-size) * 2);
       margin-top: calc(var(--np-avatar-layout-size) - var(--np-avatar-size));
+
+      :dir(rtl) & {
+        margin-left: 0;
+        margin-right: calc(var(--np-avatar-layout-size) - var(--np-avatar-size) * 2);
+      }
     }
   }
 
@@ -34,6 +47,10 @@
 
     &-child {
       margin-left: calc(var(--np-avatar-offset) * -1);
+
+      :dir(rtl) & {
+        margin-right: calc(var(--np-avatar-offset) * -1);
+      }
     }
   }
-}
+}

package/src/avatarLayout/AvatarLayout.tsx

@@ -1,5 +1,6 @@
 import { clsx } from 'clsx';
 import AvatarView, { AvatarViewProps } from '../avatarView';
+import { useDirection } from '../common/hooks';
 
 type SingleAvatarType = { asset?: AvatarViewProps['children'] } & Omit<
   AvatarViewProps,
@@ -24,6 +25,7 @@ export default function AvatarLayout({
 }: Props) {
   const orientation =
     size === 16 && orientationProp === 'diagonal' ? 'horizontal' : orientationProp;
+  const { isRTL } = useDirection();
   const isDiagonal = orientation === 'diagonal';
   const avatarSize = isDiagonal ? DIAGONAL_LAYOUT_STYLE_CONFIG[size]?.avatarSize : size;
   return avatars.length < 1 ? null : avatars.length === 1 ? (
@@ -47,8 +49,14 @@ export default function AvatarLayout({
           // eslint-disable-next-line react/no-array-index-key
           key={index}
           className={clsx(
-            { [`np-avatar-layout-${orientation}-child`]: index !== 0 },
-            { [`np-avatar-layout-${orientation}-mask`]: index !== avatars.length - 1 },
+            {
+              [`np-avatar-layout-${orientation}-child`]:
+                !isDiagonal && isRTL ? index !== avatars.length - 1 : index !== 0,
+            },
+            {
+              [`np-avatar-layout-${orientation}-mask`]:
+                !isDiagonal && isRTL ? index !== 0 : index !== avatars.length - 1,
+            },
           )}
         >
           <AvatarView

package/src/button/Button.accessibility.docs.mdx

@@ -0,0 +1,103 @@
+import { Meta, Canvas, Source } from '@storybook/blocks';
+import { NavigationOption } from '..';
+import { Bulb } from '@transferwise/icons';
+import * as stories from './Button.story';
+
+<Meta title="Actions/Button/Accessibility" />
+
+# Accessibility
+
+Given the `Button` is a widely used and highly sensitive component, there are some instances where care is required to ensure inclusive and accessible experience.
+
+<NavigationOption
+  media={<Bulb size={24} />}
+  title="Design guidance"
+  content="Before you start, familiarise yourself with the dedicated accessibility documentation."
+  href="https://wise.design/components/button#accessibility"
+/>
+
+<br />
+<br />
+
+## Anchors
+
+While it's technically possible to make the `Button` component render as a link by using `as="a"` on its own, and there are use cases for it, this will not result in a semantic HTML anchor. For that to happen, you should set `href` instead – it will automatically render the component as a semantic anchor.
+
+<Source dark code={`
+// ⚠️ use with care
+<Button v2 as="a">Inaccessible anchor</Button>
+
+// ✅ semantic link
+
+<Button v2 href="https://wise.com">
+  Accessible anchor
+</Button>
+<Button v2 href="https://wise.com" as="a">
+  Accessible anchor
+</Button>
+`}/>
+
+It's also worth noting that HTML links without a valid `href` are not recognised by RTL via `getByRole('link')`.
+
+**Additional resources:**
+
+1. [Deque: Anchors must only be used as links with valid URLs or URL fragments](https://dequeuniversity.com/rules/axe-devtools/4.2/href-no-hash)
+2. [whatwg HTML standard: 4.6.2 Links created by a and area elements](https://html.spec.whatwg.org/multipage/links.html#links-created-by-a-and-area-elements)
+
+<br />
+
+## Disabled anchors
+
+Technically, there's no such thing as disabled HTML anchor and the `disabled` attribute is not recognised on the `<a />`. While the code shown below works in all major screen readers, should be overall considered a last resort and design teams should be encouraged to use it sporadically and consider alternative flows instead.
+
+<Source
+  dark
+  code={`
+// ⚠️ use with care
+<Button v2 href="https://wise.com" disabled>Emulated disabled anchor</Button>
+`}
+/>
+
+We're emulating this behaviour by applying a combination of the following:
+
+1. removing `href` attribute to strip out the link's semantics.
+2. adding `role="link"` to make it recognisable and discoverable by the assistive tech.
+3. setting `aria-disabled="true"` to inform assistive tech of the component state.
+
+**Additional resources:**
+
+1. [Scott O'Hara: Disabling a link](https://www.scottohara.me/blog/2021/05/28/disabled-links.html)
+2. [CSS-Tricks: How to Disable Links](https://css-tricks.com/how-to-disable-links/)
+
+<br />
+
+## Loading state
+
+While it might be tempting to use the native, HTML `disabled` attribute for the `loading` state, it would result in a component that is completely invisible to the assistive tech – not focusable and not parsable – entirely inaccessible experience for users relying on such tools.
+
+Instead, we're relying on ARIA attributes and roles to ensure the `Button` is focusable, correctly announced as "busy" and offering visual cue different to the disabled state.
+
+<Source dark code={`
+// ❌  do not use
+<Button v2 loading disabled>Invisible</Button>
+
+// ✅ semantic loading button
+
+<Button v2 loading>
+  Proper loading state
+</Button>
+`}/>
+
+`Button` instances rendered as HTML anchors, follow the strategy described in the [Disabled anchors](#disabled-anchors) section above.
+
+<br />
+
+## Working with addons (accessories)
+
+One of the core requirements of accessible experience is that all users have equal access to the same content, no matter how they interact with our products.
+
+This becomes troublesome for more complex instances of the `Button` such as those with contentful icons or avatars, e.g. those referring to particular currencies, people or action types.
+
+Exposing separate ARIA labels for such addons would likely become problematic due to syntactic differences between different languages and so instead we recommend using simple `aria-label` attribute to describe given components complete content. Please note, that screen readers will use that text over the visible label
+
+<Canvas of={stories.AccessibilityAddons} />

package/src/button/Button.css

@@ -1,23 +1,228 @@
-.np-btn {
+.wds-Button {
+  --Button-background: var(--color-interactive-accent);
+  --Button-background-hover: var(--color-interactive-accent-hover);
+  --Button-background-active: var(--color-interactive-accent-active);
+  --Button-color: var(--color-interactive-control);
+  --Button-border-radius: var(--radius-full);
+  --Button-label-gap: var(--size-4);
+  --Button-large-padding: var(--size-12) var(--size-16);
+  --Button-medium-padding: var(--size-8) var(--size-12);
+  --Button-small-padding: var(--size-5) var(--size-12);
+  --Button-avatar-border-color: var(--color-border-neutral);
+  --Button-transition-duration: 150ms;
+  --Button-transition-easing: ease-in-out;
+  --Button-secondary-background: var(--color-interactive-neutral);
+  --Button-secondary-background-hover: var(--color-interactive-neutral-hover);
+  --Button-secondary-background-active: var(--color-interactive-neutral-active);
+  --Button-secondary-color: var(--color-interactive-primary);
+  --Button-tertiary-background: var(--color-background-neutral);
+  --Button-tertiary-background-hover: var(--color-background-neutral-hover);
+  --Button-tertiary-background-active: var(--color-background-neutral-active);
+  --Button-tertiary-color: var(--color-content-primary);
+  --Button-minimal-background: transparent;
+  --Button-minimal-background-hover: var(--color-background-screen-hover);
+  --Button-minimal-background-active: var(--color-background-screen-active);
+  --Button-minimal-color: var(--color-interactive-primary);
+  --Button-primary-negative-background: var(--color-sentiment-negative-primary);
+  --Button-primary-negative-background-hover: var(--color-sentiment-negative-primary-hover);
+  --Button-primary-negative-background-active: var(--color-sentiment-negative-primary-active);
+  --Button-primary-negative-color: var(--color-contrast-overlay);
+  --Button-secondary-negative-background: var(--color-sentiment-negative-secondary);
+  --Button-secondary-negative-background-hover: var(--color-sentiment-negative-secondary-hover);
+  --Button-secondary-negative-background-active: var(--color-sentiment-negative-secondary-active);
+  --Button-secondary-negative-color: var(--color-sentiment-negative-primary);
+}
+.np-theme-personal--bright-green .wds-Button {
+  --Button-primary-negative-color: var(--color-white);
+  --Button-secondary-color: var(--color-interactive-control);
+  --Button-secondary-negative-color: var(--color-white);
+}
+.np-theme-personal--forest-green .wds-Button {
+  --Button-secondary-background: var(--color-interactive-neutral);
+  --Button-secondary-negative-background: var(--color-sentiment-negative-primary);
+  --Button-secondary-negative-background-hover: var(--color-sentiment-negative-primary-hover);
+  --Button-secondary-negative-background-active: var(--color-sentiment-negative-primary-active);
+  --Button-secondary-negative-color: var(--color-contrast-overlay);
+}
+/* Button Styles */
+.wds-Button {
+  display: inline-flex;
+  flex: none;
+  width: auto;
+  align-items: center;
+  justify-content: center;
+  vertical-align: middle;
+  text-align: center;
+  white-space: nowrap;
+  word-wrap: break-word;
+  -webkit-appearance: none;
+     -moz-appearance: none;
+          appearance: none;
+  background-color: var(--Button-background);
+  border: none;
+  border-radius: var(--Button-border-radius);
+  color: var(--Button-color);
+  cursor: pointer;
+  transition: color, background-color var(--Button-transition-duration) var(--Button-transition-easing);
+}
+.wds-Button,
+.wds-Button:hover,
+.wds-Button:active,
+.wds-Button:focus {
+  -webkit-text-decoration: none;
+  text-decoration: none;
+}
+.wds-Button:hover {
+  background-color: var(--Button-background-hover);
+}
+.wds-Button:active {
+  background-color: var(--Button-background-active);
+}
+.wds-Button.wds-Button--disabled,
+.wds-Button:disabled {
+  filter: none;
+  mix-blend-mode: luminosity;
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+.wds-Button.wds-Button--disabled,
+.wds-Button:disabled,
+.wds-Button.wds-Button--disabled:hover,
+.wds-Button:disabled:hover,
+.wds-Button.wds-Button--disabled:active,
+.wds-Button:disabled:active {
+  background-color: var(--Button-background);
+}
+.wds-Button--secondary {
+  --Button-background: var(--Button-secondary-background);
+  --Button-background-hover: var(--Button-secondary-background-hover);
+  --Button-background-active: var(--Button-secondary-background-active);
+  --Button-color: var(--Button-secondary-color);
+}
+.wds-Button--tertiary {
+  --Button-background: var(--Button-tertiary-background);
+  --Button-background-hover: var(--Button-tertiary-background-hover);
+  --Button-background-active: var(--Button-tertiary-background-active);
+  --Button-color: var(--Button-tertiary-color);
+}
+.wds-Button--tertiary .wds-Button-icon--end {
+  color: var(--color-interactive-primary);
+}
+.wds-Button--minimal {
+  --Button-background: var(--Button-minimal-background);
+  --Button-background-hover: var(--Button-minimal-background-hover);
+  --Button-background-active: var(--Button-minimal-background-active);
+  --Button-color: var(--Button-minimal-color);
+}
+.wds-Button--minimal,
+.wds-Button--minimal:hover,
+.wds-Button--minimal:active,
+.wds-Button--minimal:focus {
+  -webkit-text-decoration: underline;
+  text-decoration: underline;
+  text-underline-offset: 3px;
+  text-decoration-thickness: 1px;
+}
+.wds-Button--negative.wds-Button--primary {
+  --Button-background: var(--Button-primary-negative-background);
+  --Button-background-hover: var(--Button-primary-negative-background-hover);
+  --Button-background-active: var(--Button-primary-negative-background-active);
+  --Button-color: var(--Button-primary-negative-color);
+}
+.wds-Button--negative.wds-Button--secondary {
+  --Button-background: var(--Button-secondary-negative-background);
+  --Button-background-hover: var(--Button-secondary-negative-background-hover);
+  --Button-background-active: var(--Button-secondary-negative-background-active);
+  --Button-color: var(--Button-secondary-negative-color);
+}
+.wds-Button--large {
+  padding: var(--Button-large-padding);
+}
+.wds-Button--medium {
+  padding: var(--Button-medium-padding);
+}
+.wds-Button--medium:has(.wds-Button-avatars) {
+  padding-inline-start: 8px;
+  padding-inline-start: var(--size-8);
+}
+.wds-Button--medium:has(.wds-Button-icon--end) {
+  padding-inline-end: 8px;
+  padding-inline-end: var(--size-8);
+}
+.wds-Button--medium .wds-Button-icon--start {
+  margin-inline-end: var(--Button-label-gap);
+}
+.wds-Button--small {
+  padding: var(--Button-small-padding);
+}
+.wds-Button--small:has(.wds-Button-icon--start) {
+  padding-inline-start: 8px;
+  padding-inline-start: var(--size-8);
+}
+.wds-Button--small:has(.wds-Button-icon--end) {
+  padding-inline-end: 8px;
+  padding-inline-end: var(--size-8);
+}
+.wds-Button--block {
+  width: 100%;
+}
+.wds-Button-avatars {
+  display: inline-flex;
+}
+.wds-Button-avatars .np-avatar-view .np-avatar-view-content {
+  color: var(--Button-color);
+}
+.wds-Button-icon {
+  display: inline-block;
+}
+.wds-Button-content {
+  position: relative;
+}
+.wds-Button-content--loading .wds-Button-label,
+.wds-Button-content--loading .wds-Button-media,
+.wds-Button-content--loading .wds-Button-icon {
+  visibility: hidden;
+  opacity: 0;
+}
+.wds-Button-label {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  gap: var(--Button-label-gap);
   position: relative;
 }
-.np-btn.np-btn-block > span.btn-loader {
+.wds-Button-loader {
   position: absolute;
-  left: 24px;
-  left: var(--size-24);
+  width: 100%;
+  height: 100%;
+}
+.wds-Button-loader .process-circle {
+  stroke: var(--Button-color);
+}
+/* Avatar border transparency */
+/* dark buttons get 20% transparency, light buttons get 12% */
+.wds-Button-avatars .np-circle {
+  --circle-border-color: color-mix(in srgb, var(--Button-color) 20%, transparent);
+}
+.np-theme-personal:not(.np-theme-personal--dark):not(.np-theme-personal--forest-green):not(.np-theme-personal--bright-green) .wds-Button--secondary.wds-Button--negative .wds-Button-avatars .np-circle,
+.np-theme-personal:not(.np-theme-personal--dark):not(.np-theme-personal--forest-green):not(.np-theme-personal--bright-green) .wds-Button--secondary .wds-Button-avatars .np-circle,
+.np-theme-personal:not(.np-theme-personal--dark):not(.np-theme-personal--forest-green):not(.np-theme-personal--bright-green) .wds-Button--tertiary .wds-Button-avatars .np-circle,
+.np-theme-personal:not(.np-theme-personal--dark):not(.np-theme-personal--forest-green):not(.np-theme-personal--bright-green) .wds-Button--minimal .wds-Button-avatars .np-circle {
+  --circle-border-color: color-mix(in srgb, var(--Button-color) 12%, transparent);
 }
-[dir="rtl"] .np-btn.np-btn-block > span.btn-loader {
-  right: 24px;
-  right: var(--size-24);
-  left: auto;
-  left: initial;
+.np-theme-personal--dark .wds-Button--primary .wds-Button-avatars .np-circle,
+.np-theme-personal--dark .wds-Button--primary.wds-Button--negative .wds-Button-avatars .np-circle,
+.np-theme-personal--forest-green .wds-Button--primary .wds-Button-avatars .np-circle,
+.np-theme-personal--forest-green .wds-Button--primary.wds-Button--negative .wds-Button-avatars .np-circle {
+  --circle-border-color: color-mix(in srgb, var(--Button-color) 12%, transparent);
 }
-.np-btn.np-btn-xs > span.btn-loader {
-  background-size: 16px 16px;
+.np-theme-personal--bright-green .wds-Button--tertiary .wds-Button-avatars .np-circle,
+.np-theme-personal--bright-green .wds-Button--minimal .wds-Button-avatars .np-circle {
+  --circle-border-color: color-mix(in srgb, var(--Button-color) 12%, transparent);
 }
-.np-btn.np-btn-xs.btn-block > span.btn-loader {
-  top: 0;
+.critical-comms .wds-Button {
+  --Button-background: var(--color-contrast-overlay);
 }
-.np-btn.disabled[class] {
-  pointer-events: auto;
+[dir="rtl"] .wds-Button .tw-icon-chevron-right,[dir="rtl"] .wds-Button .tw-icon-arrow-right,[dir="rtl"] .wds-Button .tw-icon-chevron-left,[dir="rtl"] .wds-Button .tw-icon-arrow-left,[dir="rtl"] .wds-Button .tw-icon-arrow-diagonal-down,[dir="rtl"] .wds-Button .tw-icon-arrow-diagonal-up,[dir="rtl"] .wds-Button .tw-icon-list,[dir="rtl"] .wds-Button .tw-icon-activity {
+  scale: -1 1;
 }