@transferwise/components 0.0.0-experimental-76bb7cd → 0.0.0-experimental-9f17c52

package/src/avatarGroup/AvatarGroup.tsx

@@ -0,0 +1,117 @@
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+/* eslint-disable react/jsx-key */
+import { clsx } from 'clsx';
+import { CommonProps } from '../common';
+import AvatarView, { AvatarViewProps } from '../avatarView';
+
+type AvatarType = { asset?: AvatarViewProps['children'] } & Omit<
+  AvatarViewProps,
+  'notification' | 'selected' | 'size' | 'badge' | 'action' | 'children'
+>;
+type AvatarGroupOrientation = 'horizontal' | 'diagonal';
+type AvatarGroupDiagonalSize = 24 | 32 | 40 | 48 | 56 | 72;
+type AvatarGroupSize = 16 | AvatarGroupDiagonalSize;
+
+/**
+ * Diagonal avatar groups have custom styles for avatars, icons, and fonts
+ */
+const MAP_DIAGONAL_AVATAR_STYLE = {
+  16: { avatar: 0, icon: 0, font: 0 },
+  24: { avatar: 15, icon: 11.25, font: 8 },
+  32: { avatar: 20, icon: 15, font: 12 },
+  40: { avatar: 24, icon: 18, font: 12 },
+  48: { avatar: 30, icon: 16.88, font: 14 },
+  56: { avatar: 34, icon: 19.13, font: 14 },
+  72: { avatar: 44, icon: 22, font: 22 },
+};
+
+const MAP_DIAGONAL_AVATAR_POSITION = {
+  24: 9,
+  32: 12,
+  40: 16,
+  48: 18,
+  56: 22,
+  72: 28,
+};
+
+/**
+ * AvatarGroup size: Avatar position (px)
+ */
+const MAP_HORIZONTAL_AVATAR_POSITION = {
+  16: 2,
+  24: 2,
+  32: 7,
+  40: 4,
+  48: 4,
+  56: 6,
+  72: 8,
+};
+
+export type Props = {
+  'aria-label'?: string;
+  avatars: AvatarType[];
+  orientation?: AvatarGroupOrientation;
+  size?: AvatarGroupSize;
+  interactive?: boolean;
+} & CommonProps;
+
+export default function AvatarGroup({
+  avatars,
+  orientation = 'horizontal',
+  size: groupSize = 48,
+  'aria-label': ariaLabel,
+  className,
+  interactive,
+}: Props) {
+  const isDiagonal = orientation === 'diagonal';
+  const singleAvatarSize = isDiagonal ? MAP_DIAGONAL_AVATAR_STYLE[groupSize]?.avatar : groupSize;
+  return (
+    <div
+      className={clsx('np-avatar-group', `np-avatar-group-${orientation}`, className)}
+      style={{
+        // @ts-expect-error `--np-avatar-group-size` exsits in styles of AvatarGroup
+        '--np-avatar-group-size': `${groupSize}px`,
+        '--np-avatar-group-single-size': `${singleAvatarSize}px`,
+      }}
+      aria-label={ariaLabel}
+    >
+      {avatars.length < 2 ||
+      ((groupSize === 16 || avatars.length > 2) && orientation === 'diagonal')
+        ? null
+        : avatars.map((avatar, index) => (
+            <div
+              className={clsx(
+                { [`np-avatar-group-${orientation}-child`]: index !== 0 },
+                { [`np-avatar-group-${orientation}-mask`]: index !== avatars.length - 1 },
+              )}
+              style={{
+                // @ts-expect-error CSS custom props allowed
+                '--np-avatar-group-diagonal-child-position': `${MAP_DIAGONAL_AVATAR_POSITION[groupSize]}px`,
+                '--np-avatar-group-horizontal-child-position': `${MAP_HORIZONTAL_AVATAR_POSITION[groupSize]}px`,
+              }}
+            >
+              <AvatarView
+                {...avatar}
+                // @ts-expect-error AvatarGroup has custom sizes for it's avatars
+                size={singleAvatarSize}
+                style={{
+                  ...(interactive && {
+                    '--circle-border-width': 0,
+                    backgroundColor: 'var(--color-background-neutral)',
+                  }),
+                  // diagonal AvatarGroup variant uses custom sizes for it's avatars, icons, and font
+                  ...(isDiagonal && {
+                    '--circle-size': `${singleAvatarSize}px`,
+                    '--circle-icon-size': `${MAP_DIAGONAL_AVATAR_STYLE[groupSize].icon}px`,
+                    '--circle-font-size': `${MAP_DIAGONAL_AVATAR_STYLE[groupSize].font}px`,
+                  }),
+                  ...avatar.style,
+                }}
+              >
+                {avatar.asset}
+              </AvatarView>
+            </div>
+          ))}
+    </div>
+  );
+}

package/src/avatarGroup/index.ts

@@ -0,0 +1,2 @@
+export type { Props as AvatarGroupProps } from './AvatarGroup';
+export { default } from './AvatarGroup';

package/src/avatarView/AvatarView.css

@@ -0,0 +1,42 @@
+.np-notification-dot {
+  --np-notification-dot-size: 14px;
+  position: relative;
+  display: inline-block;
+}
+.np-notification-dot-mask {
+  -webkit-mask-image: radial-gradient(circle at bottom calc(100% - (var(--np-notification-dot-size) / 2)) left calc(100% - (var(--np-notification-dot-size) / 2)), transparent 0, transparent calc(var(--np-notification-dot-size) / 2 + var(--np-notification-dot-offset)), black 0);
+          mask-image: radial-gradient(circle at bottom calc(100% - (var(--np-notification-dot-size) / 2)) left calc(100% - (var(--np-notification-dot-size) / 2)), transparent 0, transparent calc(var(--np-notification-dot-size) / 2 + var(--np-notification-dot-offset)), black 0);
+  -webkit-mask-image: radial-gradient(circle at bottom calc(100% - calc(var(--np-notification-dot-size) / 2)) left calc(100% - calc(var(--np-notification-dot-size) / 2)), transparent 0, transparent calc(var(--np-notification-dot-size) / 2 + var(--np-notification-dot-offset)), black 0);
+          mask-image: radial-gradient(circle at bottom calc(100% - calc(var(--np-notification-dot-size) / 2)) left calc(100% - calc(var(--np-notification-dot-size) / 2)), transparent 0, transparent calc(var(--np-notification-dot-size) / 2 + var(--np-notification-dot-offset)), black 0);
+}
+.np-notification-dot-badge {
+  position: absolute;
+  width: var(--np-notification-dot-size);
+  height: var(--np-notification-dot-size);
+  background-color: var(--color-sentiment-negative);
+  border-radius: 9999px;
+  border-radius: var(--radius-full);
+  right: 0;
+}
+.np-avatar-view .np-avatar-view-content {
+  color: var(--color-interactive-primary);
+}
+.np-avatar-view-interactive {
+  cursor: pointer;
+}
+.np-avatar-view-interactive .np-circle {
+  background-color: rgba(134,167,189,0.10196);
+  background-color: var(--color-background-neutral);
+}
+.np-avatar-view-interactive:hover {
+  background-color: var(--color-background-neutral-hover);
+}
+.np-avatar-view-interactive:active {
+  background-color: var(--color-background-neutral-active);
+}
+.np-avatar-view-non-interactive .np-circle {
+  background-color: transparent;
+}
+.np-avatar-view-non-interactive .np-avatar-view-content .wds-flag {
+  box-shadow: none;
+}

package/src/avatarView/AvatarView.less

@@ -0,0 +1,33 @@
+@import './NotificationDot.less';
+
+.np-avatar-view {
+  .np-avatar-view-content {
+    color: var(--color-interactive-primary);
+  }
+
+  &-interactive {
+    cursor: pointer;
+    .np-circle {
+      background-color: var(--color-background-neutral);
+    }
+    &:hover {
+      background-color: var(--color-background-neutral-hover);
+    }
+    &:active {
+      background-color: var(--color-background-neutral-active);
+    }
+  }
+
+  &-non-interactive {
+    .np-circle {
+      background-color: transparent;
+    }
+    .np-avatar-view-content {
+      // dismiss broken shadow on Flag component (DS-6309)
+      // https://github.com/transferwise/web-art/blob/main/src/flags/Flag.css#L2
+      .wds-flag {
+        box-shadow: none;
+      }
+    }
+  }
+}

package/src/avatarView/AvatarView.story.tsx

@@ -0,0 +1,480 @@
+/* eslint-disable react/jsx-key */
+import { Meta, StoryObj } from '@storybook/react';
+import {
+  Camera,
+  Convert,
+  FastFlag,
+  Freeze,
+  Graph,
+  Money,
+  Leaf,
+  Plane,
+  PlusCircle,
+  QrCode,
+  Rewards,
+  Target,
+  Team,
+  Transport,
+  Wallet,
+  Water,
+} from '@transferwise/icons';
+import AvatarView, { AvatarViewProps } from '.';
+import { Flag } from '@wise/art';
+import { getBrandColorFromSeed, getInitials } from '../common';
+import Display from '../display';
+
+export default {
+  title: 'Content/AvatarView',
+} satisfies Meta<typeof AvatarView>;
+
+type Story = StoryObj<typeof AvatarView>;
+
+const profileName1 = 'Wolter White';
+const profileName2 = 'Tyler Durden';
+const sizes: AvatarViewProps['size'][] = [16, 24, 32, 40, 48, 56, 72];
+
+export const Selected: Story = {
+  tags: ['autodocs'],
+  render: () => {
+    return (
+      <div
+        style={{
+          gap: '1em',
+          display: 'grid',
+          justifyContent: 'space-between',
+          gridTemplate: `auto auto / repeat(${sizes.length}, min-content)`,
+        }}
+      >
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} selected interactive>
+            <Freeze />
+          </AvatarView>
+        ))}
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-square-dude.webp"
+            selected
+            interactive
+          />
+        ))}
+      </div>
+    );
+  },
+};
+
+export const Notification: Story = {
+  tags: ['autodocs'],
+  render: () => (
+    <div
+      style={{
+        gap: '1em',
+        display: 'grid',
+        justifyContent: 'space-between',
+        gridTemplate: `auto auto / repeat(${sizes.length}, min-content)`,
+      }}
+    >
+      {sizes.map((size) => (
+        <AvatarView key={size} size={size} notification>
+          <Freeze />
+        </AvatarView>
+      ))}
+      {sizes.map((size) => (
+        <AvatarView key={size} size={size} notification interactive>
+          <Freeze />
+        </AvatarView>
+      ))}
+      {sizes.map((size) => (
+        <AvatarView
+          key={size}
+          size={size}
+          imgSrc="../avatar-rectangle-fox.webp"
+          notification
+          interactive
+        />
+      ))}
+    </div>
+  ),
+};
+
+export const Test: Story = {
+  // tags: ['autodocs'],
+  render: () => (
+    <div>
+      <AvatarView
+        imgSrc="../avatar-square-dude.webp"
+        size={72}
+        badge={{
+          flagCode: 'EU',
+        }}
+      />
+      <AvatarView
+        imgSrc="../avatar-square-dude.webp"
+        size={72}
+        badge={{
+          asset: (
+            <div
+              className="d-flex align-items-center justify-content-center"
+              style={{
+                backgroundColor: 'var(--color-bright-pink)',
+                color: 'var(--color-interactive-primary)',
+                width: '100%',
+                height: '100%',
+              }}
+            >
+              <Leaf />
+            </div>
+          ),
+        }}
+      />
+    </div>
+  ),
+};
+
+export const Badge: Story = {
+  tags: ['autodocs'],
+  render: () => {
+    const currencies = ['USD', 'EUR', 'GBP', 'AUD', 'CAD', 'JPY', 'CNY'];
+    const icons = [
+      <Plane />,
+      <QrCode />,
+      <Target />,
+      <Transport />,
+      <Wallet />,
+      <Water />,
+      <Team />,
+    ];
+    return (
+      <div
+        style={{
+          gap: '1em',
+          display: 'grid',
+          justifyContent: 'space-between',
+          gridTemplate: 'auto auto / repeat(7, min-content)',
+        }}
+      >
+        {sizes.map((size, index) => (
+          <AvatarView key={size} size={size} badge={{ flagCode: currencies[index] }}>
+            {icons[index]}
+          </AvatarView>
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-rectangle-fox.webp"
+            badge={{ imgSrc: '../tapestry-01.png' }}
+          />
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-square-dude.webp"
+            badge={{ imgSrc: '../tapestry-01.png' }}
+          />
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView key={size} size={size} badge={{ imgSrc: '../tapestry-01.png' }}>
+            {icons[index]}
+          </AvatarView>
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView key={size} size={size} badge={{ status: 'warning' }}>
+            {icons[index]}
+          </AvatarView>
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView key={size} size={size} badge={{ status: 'neutral' }}>
+            {icons[index]}
+          </AvatarView>
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView key={size} size={size} badge={{ status: 'negative' }}>
+            {icons[index]}
+          </AvatarView>
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView key={size} size={size} badge={{ icon: <FastFlag /> }}>
+            {icons[index]}
+          </AvatarView>
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView key={size} size={size} badge={{ type: 'reference' }}>
+            {icons[index]}
+          </AvatarView>
+        ))}
+
+        {sizes.map((size, index) => (
+          <AvatarView key={size} size={size} badge={{ type: 'action' }}>
+            {icons[index]}
+          </AvatarView>
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-square-dude.webp"
+            badge={{ type: 'action', icon: <Camera /> }}
+          />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-square-dude.webp"
+            badge={{ type: 'reference', icon: <Convert /> }}
+          />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-square-dude.webp"
+            badge={{ icon: <Convert /> }}
+          />
+        ))}
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-square-dude.webp"
+            badge={{
+              asset: (
+                <div
+                  className="d-flex align-items-center justify-content-center"
+                  style={{
+                    backgroundColor: 'var(--color-bright-pink)',
+                    color: 'var(--color-interactive-primary)',
+                    width: '100%',
+                    height: '100%',
+                  }}
+                >
+                  <Leaf />
+                </div>
+              ),
+            }}
+          />
+        ))}
+      </div>
+    );
+  },
+};
+
+export const Images: Story = {
+  tags: ['autodocs'],
+  render: () => {
+    return (
+      <div
+        style={{
+          gap: '1em',
+          display: 'grid',
+          justifyContent: 'space-between',
+          gridTemplate: 'auto auto / repeat(7, min-content)',
+        }}
+      >
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            interactive
+            imgSrc="../avatar-square-dude.webp"
+            profileName="Test Name"
+            profileType="business"
+          />
+        ))}
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-square-dude.webp"
+            profileName="Test Name"
+            profileType="business"
+          />
+        ))}
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} interactive>
+            <Flag code="JPY" intrinsicSize={size} />
+          </AvatarView>
+        ))}
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size}>
+            <Flag code="JPY" intrinsicSize={size} />
+          </AvatarView>
+        ))}
+        {sizes.map((size) => (
+          <AvatarView key={size} interactive imgSrc="../avatar-rectangle-fox.webp" size={size} />
+        ))}
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} imgSrc="../avatar-rectangle-fox.webp" />
+        ))}
+      </div>
+    );
+  },
+};
+
+export const Profiles: Story = {
+  tags: ['autodocs'],
+  render: () => {
+    return (
+      <div
+        style={{
+          gap: '1em',
+          display: 'grid',
+          justifyContent: 'space-between',
+          gridTemplate: 'auto auto / repeat(7, min-content)',
+        }}
+      >
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            imgSrc="../avatar-square-dude.webp"
+            profileName="Test Name"
+            profileType="business"
+          />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView
+            key={size}
+            size={size}
+            interactive
+            imgSrc="../avatar-square-dude.webp"
+            profileName="Test Name"
+            profileType="business"
+          />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} profileName="Test Name" />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} interactive profileName="Test Name" />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} profileType="business" />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} interactive profileType="business" />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} />
+        ))}
+
+        {sizes.map((size) => (
+          <AvatarView key={size} size={size} interactive />
+        ))}
+      </div>
+    );
+  },
+};
+
+export const ProfileBrokenImageFallback: Story = {
+  render: () => (
+    <>
+      <AvatarView imgSrc="../img-wrong-url.lol" />
+      <AvatarView imgSrc="../img-wrong-url.lol" profileType="business" />
+      <AvatarView imgSrc="../img-wrong-url.lol" profileType="business" profileName="D D" />
+    </>
+  ),
+};
+
+export const EdgeInstaces: Story = {
+  tags: ['autodocs'],
+  render: () => {
+    const css = `.custom-variant {
+      border: 1px dashed var(--color-border-neutral);
+    }`;
+    return (
+      <div
+        style={{
+          gap: '1em',
+          display: 'grid',
+          justifyContent: 'space-between',
+          gridTemplate: 'auto auto / repeat(2, min-content)',
+        }}
+      >
+        <style>{css}</style>
+        {/* <Body>- Custom colors</Body> */}
+        <AvatarView
+          interactive
+          badge={{ flagCode: 'EU' }}
+          style={{ backgroundColor: 'var(--color-bright-orange)' }}
+        >
+          <Money />
+        </AvatarView>
+        <AvatarView
+          badge={{ flagCode: 'EU' }}
+          style={{ backgroundColor: 'var(--color-bright-orange)', border: 'none' }}
+        >
+          <Money />
+        </AvatarView>
+        {/* <Body>- Add example with dashed avatar as in shared balances</Body> */}
+        <AvatarView interactive className="custom-variant">
+          <PlusCircle />
+        </AvatarView>
+        <AvatarView interactive className="custom-variant">
+          {null}
+        </AvatarView>
+        {/* <Body> - Add example custom backgrounds as in account summary (https://wise.com/account-summary)</Body> */}
+        <AvatarView style={{ color: 'rgb(22, 51, 0)', backgroundColor: 'rgb(203, 217, 195)' }}>
+          <Graph />
+        </AvatarView>
+        <AvatarView
+          interactive
+          style={{ color: 'rgb(22, 51, 0)', backgroundColor: 'rgb(203, 217, 195)' }}
+        >
+          <Graph />
+        </AvatarView>
+        <AvatarView style={{ color: 'rgb(203, 217, 195)', backgroundColor: 'rgb(22, 51, 0)' }}>
+          <Rewards />
+        </AvatarView>
+        <AvatarView
+          interactive
+          style={{ color: 'rgb(203, 217, 195)', backgroundColor: 'rgb(22, 51, 0)' }}
+        >
+          <Rewards />
+        </AvatarView>
+        {/* <Body>- Add example Wise Sand + custom background from hash</Body> */}
+        <AvatarView
+          badge={{ flagCode: 'EU' }}
+          style={{ backgroundColor: getBrandColorFromSeed(profileName1) }}
+        >
+          <Display>{getInitials(profileName1)}</Display>
+        </AvatarView>
+        <AvatarView style={{ backgroundColor: getBrandColorFromSeed(profileName1) }}>
+          <Display>{getInitials(profileName1)}</Display>
+        </AvatarView>
+        <AvatarView interactive style={{ backgroundColor: getBrandColorFromSeed(profileName2) }}>
+          <Display>{getInitials(profileName1)}</Display>
+        </AvatarView>
+        <AvatarView
+          interactive
+          badge={{ flagCode: 'EU' }}
+          style={{ backgroundColor: getBrandColorFromSeed(profileName2) }}
+        >
+          <Display>{getInitials(profileName1)}</Display>
+        </AvatarView>
+        <AvatarView>9+</AvatarView>
+        <AvatarView interactive>5+</AvatarView>
+      </div>
+    );
+  },
+};