@transferwise/components 46.87.2 → 46.88.1

package/src/button/LegacyButton.story.tsx

@@ -0,0 +1,228 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { userEvent, within, fn, expect } from '@storybook/test';
+import { useState } from 'react';
+
+import Button from '.';
+import LegacyButton from './LegacyButton';
+
+// needed for the SB to show correct name in the Source blocks
+LegacyButton.displayName = 'Button';
+
+const withContainer = (Story: any) => (
+  <div
+    style={{
+      display: 'flex',
+      flexDirection: 'initial',
+      justifyContent: 'center',
+      flexFlow: 'column',
+      alignItems: 'center',
+    }}
+  >
+    <Story />
+  </div>
+);
+
+const meta: Meta<typeof LegacyButton> = {
+  component: LegacyButton,
+  title: 'Actions/Button/Legacy Button',
+  args: {
+    size: undefined,
+    priority: undefined,
+    type: undefined,
+    block: false,
+    disabled: false,
+    loading: false,
+    href: undefined,
+    as: undefined,
+    target: undefined,
+    htmlType: undefined,
+    children: 'Button text',
+    onClick: fn(),
+    onBlur: fn(),
+    onFocus: fn(),
+  },
+  argTypes: {
+    href: {
+      control: 'text',
+      description: 'If set together with `as="a"`, the component will render as an HTML anchor.',
+    },
+    as: {
+      control: {
+        name: 'enum',
+        options: ['button', 'a'],
+      },
+      description: 'If set together with `href`, the component will render as an HTML anchor.',
+    },
+    type: {
+      type: {
+        name: 'enum',
+        value: ['accent', 'positive', 'negative'],
+      },
+      description:
+        '**NB**: `primary` | `pay` | `secondary` | `danger` | `link` are deprecated.\n\n',
+    },
+    size: {
+      type: {
+        name: 'enum',
+        value: ['lg', 'md', 'sm', 'xs'],
+      },
+      description: '**NB**: `xs` is deprecated.\n\n',
+    },
+    priority: {
+      type: {
+        name: 'enum',
+        value: ['primary', 'secondary', 'tertiary'],
+      },
+    },
+    block: {
+      table: {
+        defaultValue: { summary: 'false' },
+      },
+    },
+    v2: {
+      table: {
+        disable: true,
+      },
+    },
+  },
+  tags: ['autodocs'],
+  decorators: [withContainer],
+};
+
+export default meta;
+
+type Story = StoryObj<typeof Button>;
+
+export const Basic: Story = {};
+
+export const Secondary: Story = {
+  args: {
+    type: 'accent',
+    priority: 'secondary',
+  },
+};
+
+export const Tertiary: Story = {
+  args: {
+    type: 'accent',
+    priority: 'tertiary',
+  },
+};
+
+export const Negative: Story = {
+  args: {
+    type: 'negative',
+    priority: 'primary',
+  },
+};
+
+export const Loading: Story = {
+  args: {
+    loading: true,
+  },
+};
+
+export const Variants: Story = {
+  render: () => {
+    return (
+      <div className="d-flex flex-column p-b-2 align-items-start">
+        <div className="d-flex flex-row p-b-2" style={{ gap: 'var(--size-16)' }}>
+          <Button type="accent" priority="primary">
+            Primary Accent
+          </Button>
+          <Button type="accent" priority="secondary">
+            Secondary Accent
+          </Button>
+          <Button type="accent" priority="tertiary">
+            Tertiary Accent
+          </Button>
+        </div>
+        <div className="d-flex flex-row p-b-2" style={{ gap: 'var(--size-16)' }}>
+          <Button type="positive" priority="primary">
+            Primary Positive
+          </Button>
+          <Button type="positive" priority="secondary">
+            Secondary Accent
+          </Button>
+        </div>
+        <div className="d-flex flex-row flex- p-b-2" style={{ gap: 'var(--size-16)' }}>
+          <Button type="negative" priority="primary">
+            Primary Negative
+          </Button>
+          <Button type="negative" priority="secondary">
+            Secondary Negative
+          </Button>
+        </div>
+        <div className="d-flex flex-row p-b-1" style={{ gap: 'var(--size-16)' }}>
+          <Button type="accent" priority="primary" disabled>
+            Button Disabled
+          </Button>
+          <Button type="accent" priority="secondary" disabled>
+            Button Disabled
+          </Button>
+          <Button type="accent" priority="tertiary" disabled>
+            Button Disabled
+          </Button>
+        </div>
+      </div>
+    );
+  },
+};
+
+const wait = async (duration = 500) =>
+  new Promise<void>((resolve) => {
+    setTimeout(resolve, duration);
+  });
+
+export const Focused: Story = {
+  play: async ({ canvasElement }: { canvasElement: HTMLElement }) => {
+    const canvas = within(canvasElement);
+    const button = canvas.getByRole('button');
+    await userEvent.tab();
+    await expect(button).toHaveFocus();
+    await expect(button).toHaveTextContent('Focused!');
+  },
+  render: function Render(args: React.ComponentProps<typeof Button>) {
+    const [focused, setFocused] = useState(false);
+
+    return (
+      <Button {...args} onFocus={() => setFocused(true)}>
+        {focused ? 'Focused!' : 'Button text'}
+      </Button>
+    );
+  },
+};
+
+export const SocialMedia: Story = {
+  render: () => {
+    return (
+      <>
+        <div className="m-b-2">
+          <button type="button" className="btn btn-google">
+            Login with Google
+          </button>
+        </div>
+        <div className="m-b-2">
+          <button type="button" className="btn btn-facebook">
+            Login with Facebook
+          </button>
+        </div>
+        <div className="m-b-2">
+          <button type="button" className="btn btn-lg btn-facebook">
+            Large Button
+          </button>
+        </div>
+        <div className="m-b-2">
+          <button type="button" className="btn btn-block btn-facebook">
+            Block Button
+          </button>
+        </div>
+        <div className="m-b-2">
+          <button type="button" className="btn btn-lg btn-block btn-facebook">
+            Large Block Button
+          </button>
+        </div>
+      </>
+    );
+  },
+};

package/src/button/LegacyButton.tsx

@@ -0,0 +1,177 @@
+import { clsx } from 'clsx';
+import { ElementType, forwardRef, MouseEvent } from 'react';
+import { useIntl } from 'react-intl';
+
+import {
+  Size,
+  ControlType,
+  Priority,
+  ControlTypeAccent,
+  ControlTypeNegative,
+  ControlTypePositive,
+  PriorityPrimary,
+  PrioritySecondary,
+  PriorityTertiary,
+  SizeExtraSmall,
+  SizeSmall,
+  SizeMedium,
+  SizeLarge,
+} from '../common';
+import ProcessIndicator from '../processIndicator';
+
+import messages from '../i18n/commonMessages/Button.messages';
+import { typeClassMap, priorityClassMap } from './classMap';
+import { establishNewPriority, establishNewType, logDeprecationNotices } from './legacyUtils';
+import { ButtonReferenceType } from './Button.types';
+
+/** @deprecated */
+type DeprecatedTypes = 'primary' | 'pay' | 'secondary' | 'danger' | 'link';
+
+/** @deprecated */
+type DeprecatedSizes = SizeExtraSmall;
+
+export type CommonProps = {
+  v2?: false;
+
+  /** Makes the button take up the full width of its container */
+  block?: boolean;
+
+  /**
+   * The `target` attribute for HTML anchor.
+   * If set to `_blank`, `rel="noopener noreferrer"` is automatically added to the rendered node.
+   */
+  target?: string;
+  /**
+   * Toggles the disabled state
+   * @default false
+   */
+
+  disabled?: boolean;
+  /**
+   * Toggles the loading state
+   * @default false
+   */
+  loading?: boolean;
+  type?: ControlTypeAccent | ControlTypeNegative | ControlTypePositive | DeprecatedTypes | null;
+  priority?: PriorityPrimary | PrioritySecondary | PriorityTertiary | null;
+  size?: SizeSmall | SizeMedium | SizeLarge | DeprecatedSizes;
+  htmlType?: 'submit' | 'reset' | 'button';
+};
+
+export type ButtonProps = CommonProps &
+  Omit<React.ComponentPropsWithRef<'button'>, 'type'> & {
+    as?: 'button';
+  };
+
+type AnchorProps = CommonProps &
+  Omit<React.ComponentPropsWithRef<'a'>, 'type'> & {
+    as?: 'a';
+    href?: string;
+  };
+
+export type LegacyButtonProps = ButtonProps | AnchorProps;
+
+/**
+ * @deprecated make sure you use new Button component via `<Button v2 .. />` and new props
+ */
+const LegacyButton = forwardRef<ButtonReferenceType, LegacyButtonProps>(
+  (
+    {
+      as: component = 'button',
+      block = false,
+      children,
+      className,
+      disabled,
+      loading = false,
+      priority = Priority.PRIMARY,
+      size = Size.MEDIUM,
+      type = ControlType.ACCENT,
+      onClick,
+      ...rest
+    }: LegacyButtonProps,
+    ref,
+  ) => {
+    const intl = useIntl();
+
+    logDeprecationNotices({ size, type });
+
+    const newType = establishNewType(type);
+    const newPriority = establishNewPriority(priority, type);
+
+    const classes = clsx(
+      `btn btn-${size}`,
+      `np-btn np-btn-${size}`,
+      {
+        'btn-loading': loading,
+        'btn-block np-btn-block': block,
+        disabled,
+      },
+      // @ts-expect-error fix when refactor `typeClassMap` to TypeScript
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+      typeClassMap[newType],
+      // @ts-expect-error fix when refactor `typeClassMap` to TypeScript
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+      priorityClassMap[newPriority],
+      className,
+    );
+
+    function processIndicatorSize() {
+      return ['sm', 'xs'].includes(size) ? 'xxs' : 'xs';
+    }
+
+    const Element = (component as ElementType) ?? 'button';
+    let props;
+
+    if (Element === 'button') {
+      const { htmlType = 'button', ...restProps } = rest as ButtonProps;
+      props = {
+        ...restProps,
+        disabled,
+        'aria-disabled': loading,
+        type: htmlType,
+      };
+    } else {
+      props = {
+        ...rest,
+        'aria-disabled': loading,
+      } as AnchorProps;
+    }
+
+    /**
+     * Ensures that the button cannot be activated in loading or disabled mode,
+     * when `aria-disabled` might be used over the `disabled` HTML attribute
+     */
+    const handleClick =
+      (handler: LegacyButtonProps['onClick']) =>
+      (event: MouseEvent<HTMLButtonElement> & MouseEvent<HTMLAnchorElement>) => {
+        if (disabled || loading) {
+          event.preventDefault();
+        } else if (typeof handler === 'function') {
+          handler(event);
+        }
+      };
+
+    return (
+      <Element
+        ref={ref as React.Ref<ButtonReferenceType>}
+        className={classes}
+        onClick={handleClick(onClick)}
+        {...props}
+        aria-live={loading ? 'polite' : 'off'}
+        aria-busy={loading}
+        aria-label={loading ? intl.formatMessage(messages.loadingAriaLabel) : rest['aria-label']}
+      >
+        {children}
+        {loading && (
+          <ProcessIndicator
+            size={processIndicatorSize()}
+            className="btn-loader"
+            data-testid="ButtonProgressIndicator"
+          />
+        )}
+      </Element>
+    );
+  },
+);
+
+export default LegacyButton;

package/src/button/index.ts

@@ -1,3 +1,7 @@
-export { default } from './Button';
+export { default } from './Button.resolver';
+export type { ButtonProps as NewButtonProps } from './Button.types';
 
-export type { Props as ButtonProps } from './Button';
+// export legacy button props for backwards compatibility with legacy Button interface
+// delete this when migration to new Button is done (or aleast no more deep imports, use following query)
+// https://github.com/search?q=org%3Atransferwise%20%22%40transferwise%2Fcomponents%2Fbuild%2Ftypes%2Fbutton%2Findex%22&type=code
+export type { LegacyButtonProps as ButtonProps } from './LegacyButton';

package/src/card/Card.story.tsx

@@ -7,9 +7,14 @@ import Card from '.';
 
 type Story = StoryObj<typeof Card>;
 
+/**
+ * @deprecated use Navigation pattern (via `NavigationOption` component)
+ *
+ * @see https://transferwise.atlassian.net/wiki/spaces/DS/pages/2387314550/Instructions+for+killing+expanding+cards+on+web+design+pattern
+ */
 export default {
   component: Card,
-  title: 'Layouts/Card',
+  title: 'Layouts/Card (Deprecated)',
   args: {
     title: 'A card',
     details: 'Some details about this card',

package/src/circularButton/CircularButton.tsx

@@ -1,6 +1,7 @@
 import { clsx } from 'clsx';
 
 import Body from '../body/Body';
+import { typeClassMap, priorityClassMap } from '../button/classMap';
 import { Breakpoint, ControlType, Priority, Typography } from '../common';
 import IconButton, { IconButtonProps } from '../iconButton';
 import { useMedia } from '../common/hooks/useMedia';

package/src/field/Field.story.tsx

@@ -12,7 +12,7 @@ import Info from '../info';
 
 export default {
   component: Field,
-  title: 'Field',
+  title: 'Forms/Field',
   tags: ['autodocs'],
   argTypes: {
     messageIconLabel: {

package/src/flowNavigation/__snapshots__/FlowNavigation.spec.js.snap

@@ -9,10 +9,9 @@ exports[`FlowNavigation on mobile renders as expected 1`] = `
       class="np-flow-header d-flex flex-wrap align-items-center justify-content-between flex__item--12 np-flow-navigation__content p-x-3 np-flow-navigation--xs-max"
     >
       <button
-        aria-disabled="false"
         aria-label="back to previous step"
         aria-live="off"
-        class="wds-Button np-circle d-flex align-items-center justify-content-center np-icon-button np-icon-button-tertiary-default"
+        class="np-circle d-flex align-items-center justify-content-center np-icon-button np-icon-button-tertiary-default"
         style="--circle-size: 40px; --circle-icon-size: 20px; --circle-font-size: 18px;"
         type="button"
       >

package/src/index.ts

@@ -11,7 +11,7 @@ export type { AvatarProps } from './avatar';
 export type { AvatarViewProps } from './avatarView';
 export type { AvatarLayoutProps } from './avatarLayout';
 export type { BadgeProps } from './badge';
-export type { ButtonProps } from './button';
+export type { NewButtonProps as ButtonProps } from './button';
 export type { CardProps } from './card';
 export type { CarouselProps } from './carousel';
 export type { CheckboxProps } from './checkbox';

package/src/inputs/SelectInput.story.tsx

@@ -5,7 +5,7 @@ import { Flag } from '@wise/art';
 import { clsx } from 'clsx';
 import { useState } from 'react';
 
-import Button from '../button/Button';
+import Button from '../button';
 import { getMonthNames } from '../common/dateUtils';
 import Drawer from '../drawer';
 import { Field } from '../field/Field';

package/src/label/Label.story.tsx

@@ -3,7 +3,7 @@ import { Label } from './Label';
 
 export default {
   component: Label,
-  title: 'Label',
+  title: 'Forms/Label',
   tags: ['autodocs'],
 };
 

package/src/link/Link.tsx

@@ -1,13 +1,14 @@
 import { NavigateAway as NavigateAwayIcon } from '@transferwise/icons';
 import { clsx } from 'clsx';
-import { AnchorHTMLAttributes } from 'react';
 import { useIntl } from 'react-intl';
+import { PrimitiveAnchor } from '../primitives';
+import type { PrimitiveAnchorProps } from '../primitives';
 
 import { LinkLarge, LinkDefault } from '../common';
 
 import messages from './Link.messages';
 
-export type Props = AnchorHTMLAttributes<HTMLAnchorElement> & { type?: LinkLarge | LinkDefault };
+export type Props = PrimitiveAnchorProps & { type?: LinkLarge | LinkDefault };
 
 /**
  * Standard Link component with navigate away icon
@@ -24,22 +25,30 @@ const Link = ({
   onClick,
   ...props
 }: Props) => {
+  const { formatMessage } = useIntl();
   const isBlank = target === '_blank';
 
-  const { formatMessage } = useIntl();
+  const classNames = clsx(
+    'np-link',
+    'd-inline-flex',
+    {
+      [`np-text-${type}`]: type,
+    },
+    className,
+  );
 
   return (
-    <a
+    <PrimitiveAnchor
       href={href}
       target={target}
-      className={clsx('np-link', type ? `np-text-${type}` : undefined, 'd-inline-flex', className)}
+      className={classNames}
       aria-label={ariaLabel}
       rel={isBlank ? 'noreferrer' : undefined}
       onClick={onClick}
       {...props}
     >
       {children} {isBlank && <NavigateAwayIcon title={formatMessage(messages.opensInNewTab)} />}
-    </a>
+    </PrimitiveAnchor>
   );
 };