@transferwise/components 46.130.1 → 46.130.3

package/src/inputs/{_Popover.tsx → SelectInput/Popover/SelectInputPopover.tsx}

@@ -18,9 +18,9 @@ import { ThemeProvider, useTheme } from '@wise/components-theming';
 import { clsx } from 'clsx';
 import { useState } from 'react';
 
-import { PreventScroll } from '../common/preventScroll/PreventScroll';
+import { PreventScroll } from '../../../common/preventScroll/PreventScroll';
 
-export interface PopoverProps {
+export interface SelectInputPopoverProps {
   placement?: Placement;
   open: boolean;
   renderTrigger: (args: {
@@ -37,9 +37,9 @@ export interface PopoverProps {
   onCloseEnd?: () => void;
 }
 
-const floatingPadding = 16;
+const FLOATING_PADDING = 16;
 
-export function Popover({
+export function SelectInputPopover({
   placement,
   open,
   renderTrigger,
@@ -49,16 +49,16 @@ export function Popover({
   children,
   onClose,
   onCloseEnd,
-}: PopoverProps) {
+}: SelectInputPopoverProps) {
   const { refs, floatingStyles, context } = useFloating<Element>({
     strategy: 'fixed',
     placement,
     middleware: [
       offset(8),
-      flip({ padding: floatingPadding, crossAxis: false }),
+      flip({ padding: FLOATING_PADDING, crossAxis: false }),
       shift(),
       floatingSize({
-        padding: floatingPadding,
+        padding: FLOATING_PADDING,
         apply: ({ elements, rects, availableHeight }) => {
           elements.floating.style.setProperty('--max-height', `${availableHeight}px`);
           elements.floating.style.setProperty('--width', `${rects.reference.width}px`);

package/src/inputs/SelectInput/Popover/index.ts

@@ -0,0 +1,2 @@
+export { SelectInputPopover } from './SelectInputPopover';
+export type { SelectInputPopoverProps } from './SelectInputPopover';

package/src/inputs/SelectInput/SelectInput.contexts.tsx

@@ -0,0 +1,40 @@
+import React, { createContext } from 'react';
+
+/**
+ * Context for passing props to the SelectInputTriggerButton component.
+ */
+export interface SelectInputTriggerButtonPropsContextValue {
+  ref?: React.ForwardedRef<HTMLButtonElement | null>;
+  id?: string;
+  onClick?: (event: React.MouseEvent) => void;
+  onKeyDown?: (event: React.KeyboardEvent) => void;
+  size?: 'sm' | 'md' | 'lg';
+  [key: string]: unknown;
+}
+
+/**
+ * Context for passing props to the SelectInputTriggerButton component.
+ */
+export const SelectInputTriggerButtonPropsContext =
+  createContext<SelectInputTriggerButtonPropsContextValue>({});
+
+/**
+ * Context for providing the total count of items in a SelectInput.
+ * Used for ARIA accessibility to inform screen readers about the total number of options.
+ */
+export const SelectInputItemsCountContext = createContext<number | undefined>(undefined);
+
+/**
+ * Context for providing the current item position in a SelectInput.
+ * Used for ARIA accessibility to inform screen readers about the position of the option.
+ */
+export const SelectInputItemPositionContext = createContext<number | undefined>(undefined);
+
+/**
+ * Context indicating whether an option's content is rendered within the trigger button.
+ * When true, certain styling adjustments are applied to make the content fit better in the trigger.
+ */
+export const SelectInputOptionContentWithinTriggerContext = createContext(false);
+
+// Re-export types from the original contexts module for backward compatibility
+export type { WithInputAttributesProps } from '../contexts';

package/src/inputs/SelectInput/SelectInput.less

@@ -0,0 +1,22 @@
+@import (reference) "../../../node_modules/@transferwise/neptune-css/src/less/ring.less";
+
+// Import component styles
+@import "./BottomSheet/SelectInputBottomSheet.less";
+@import "./ButtonInput/SelectInputButtonInput.less";
+@import "./Popover/SelectInputPopover.less";
+@import "./Option/SelectInputOption.less";
+@import "./OptionContent/SelectInputOptionContent.less";
+@import "./ItemView/SelectInputItemView.less";
+@import "./Options/SelectInputOptions.less";
+@import "./ClearButton/SelectInputClearButton.less";
+
+// Main SelectInput styles
+.np-select-input-content {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.np-select-input-placeholder {
+  color: var(--color-content-tertiary);
+}

package/src/inputs/{SelectInput.test.tsx → SelectInput/SelectInput.test.tsx}

@@ -2,15 +2,15 @@ import { screen, waitFor, within } from '@testing-library/react';
 import { userEvent } from '@testing-library/user-event';
 import { mockAnimationsApi } from 'jsdom-testing-mocks';
 
-import { render, mockMatchMedia, mockResizeObserver } from '../test-utils';
+import { render, mockMatchMedia, mockResizeObserver } from '../../test-utils';
 
 import {
   SelectInput,
   SelectInputOptionContent,
   type SelectInputOptionItem,
   type SelectInputProps,
-} from './SelectInput';
-import { Field } from '../field/Field';
+} from '.';
+import { Field } from '../../field/Field';
 
 mockMatchMedia();
 mockResizeObserver();
@@ -40,7 +40,7 @@ describe('SelectInput', () => {
         ]}
         renderFooter={({ queryNormalized: normalizedQuery }) =>
           normalizedQuery != null ? (
-            <>Showing results for ‘{normalizedQuery}’</>
+            <>Showing results for &apos;{normalizedQuery}&apos;</>
           ) : (
             <>All items shown</>
           )
@@ -56,16 +56,16 @@ describe('SelectInput', () => {
     expect(footer).toBeInTheDocument();
 
     await userEvent.keyboard('u');
-    expect(footer).toHaveTextContent(/‘u’$/);
+    expect(footer).toHaveTextContent(/'u'$/);
 
     await userEvent.keyboard('r');
-    expect(footer).toHaveTextContent(/‘ur’$/);
+    expect(footer).toHaveTextContent(/'ur'$/);
 
     await userEvent.keyboard('x');
-    expect(footer).toHaveTextContent(/‘urx’$/);
+    expect(footer).toHaveTextContent(/'urx'$/);
 
     await userEvent.keyboard('{Backspace}');
-    expect(footer).toHaveTextContent(/‘ur’$/);
+    expect(footer).toHaveTextContent(/'ur'$/);
   });
 
   it('allows navigating the listbox with cursors', async () => {
@@ -76,9 +76,7 @@ describe('SelectInput', () => {
           { type: 'option', value: 'EUR' },
           { type: 'option', value: 'USD' },
         ]}
-        renderFooter={({ queryNormalized: normalizedQuery }) => (
-          <button type="button">Footer button</button>
-        )}
+        renderFooter={() => <button type="button">Footer button</button>}
         filterable
       />,
     );

package/src/inputs/SelectInput/SelectInput.tsx

@@ -0,0 +1,257 @@
+import mergeProps from 'merge-props';
+import { useEffect, useRef, useState, useDeferredValue } from 'react';
+import { Listbox as ListboxBase } from '@headlessui/react';
+import { useScreenSize } from '../../common/hooks/useScreenSize';
+import { Breakpoint } from '../../common/propsValues/breakpoint';
+import { useEffectEvent } from '../../common/hooks/useEffectEvent';
+import { useInputAttributes } from '../contexts';
+
+import { SelectInputBottomSheet } from './BottomSheet';
+import { SelectInputPopover } from './Popover';
+import { SelectInputOptions } from './Options';
+import { DefaultRenderTrigger } from './DefaultRenderTrigger';
+
+import {
+  SelectInputOptionContentWithinTriggerContext,
+  SelectInputTriggerButtonPropsContext,
+} from './SelectInput.contexts';
+import { searchableString, sortByRelevance } from './SelectInput.utils';
+import { SelectInputProps } from './SelectInput.types';
+
+const noop = () => {};
+
+/**
+ * SelectInput component allows users to select an option from a dropdown list.
+ * Supports filtering, multiple selection, and customization.
+ */
+export function SelectInput<T = string, M extends boolean = false>({
+  id: idProp,
+  parentId,
+  name,
+  multiple,
+  placeholder,
+  autocomplete,
+  items,
+  defaultValue,
+  value: controlledValue,
+  compareValues,
+  renderValue = String,
+  renderFooter,
+  renderTrigger = DefaultRenderTrigger,
+  filterable,
+  filterPlaceholder,
+  sortFilteredOptions,
+  disabled,
+  size = 'md',
+  className,
+  UNSAFE_triggerButtonProps,
+  triggerRef: externalTriggerRef,
+  onFilterChange = noop,
+  onChange,
+  onOpen,
+  onClose,
+  onClear,
+}: SelectInputProps<T, M>) {
+  const inputAttributes = useInputAttributes({ nonLabelable: true });
+  const id = idProp ?? inputAttributes.id;
+
+  const [open, setOpen] = useState(false);
+
+  const initialized = useRef(false);
+  const handleClose = useEffectEvent(onClose ?? (() => {}));
+  const handleOpen = useEffectEvent(onOpen ?? (() => {}));
+  useEffect(() => {
+    if (initialized.current) {
+      if (open) {
+        handleOpen?.();
+      } else {
+        handleClose?.();
+      }
+    } else {
+      initialized.current = true;
+    }
+  }, [handleClose, handleOpen, open]);
+
+  const [filterQuery, _setFilterQuery] = useState('');
+  const deferredFilterQuery = useDeferredValue(filterQuery);
+  const setFilterQuery = useEffectEvent((query: string) => {
+    _setFilterQuery(query);
+    if (query !== filterQuery) {
+      onFilterChange({
+        query,
+        queryNormalized: query ? searchableString(query) : null,
+      });
+    }
+  });
+
+  const internalTriggerRef = useRef<HTMLButtonElement | null>(null);
+
+  const screenSm = useScreenSize(Breakpoint.SMALL);
+  const OptionsOverlay = screenSm ? SelectInputPopover : SelectInputBottomSheet;
+
+  const searchInputRef = useRef<HTMLInputElement>(null);
+  const listboxRef = useRef<HTMLDivElement>(null);
+  const controllerRef = filterable ? searchInputRef : listboxRef;
+
+  /**
+   * Attempts to resolve the `listbox` label
+   * @see https://storybook.wise.design/?path=/docs/forms-selectinput-accessibility--docs#labelling
+   */
+  const getListBoxLabelProps = (): {
+    listBoxLabel?: string;
+    listBoxLabelledBy?: string;
+  } => {
+    if (UNSAFE_triggerButtonProps?.['aria-label']) {
+      return {
+        listBoxLabel: UNSAFE_triggerButtonProps['aria-label'],
+      };
+    }
+
+    if (UNSAFE_triggerButtonProps?.['aria-labelledby']) {
+      return {
+        listBoxLabelledBy: UNSAFE_triggerButtonProps['aria-labelledby'],
+      };
+    }
+
+    if (inputAttributes['aria-labelledby']) {
+      return {
+        listBoxLabelledBy: inputAttributes['aria-labelledby'],
+      };
+    }
+
+    return {};
+  };
+
+  return (
+    <ListboxBase
+      name={name}
+      multiple={multiple}
+      defaultValue={defaultValue as M extends true ? T[] : T}
+      value={controlledValue as M extends true ? T[] : T}
+      by={compareValues}
+      disabled={disabled}
+      onChange={
+        ((value) => {
+          if (!multiple) {
+            setOpen(false);
+          }
+          onChange?.(value);
+        }) satisfies SelectInputProps<T, M>['onChange']
+      }
+    >
+      {({ disabled: uiDisabled, value }) => {
+        const placeholderShown =
+          multiple && Array.isArray(value) ? value.length === 0 : value == null;
+        return (
+          <OptionsOverlay
+            placement="bottom-start"
+            open={open}
+            renderTrigger={({ ref, getInteractionProps }) => (
+              <SelectInputTriggerButtonPropsContext.Provider
+                // eslint-disable-next-line react/jsx-no-constructed-context-values
+                value={{
+                  ref: (node) => {
+                    ref(node);
+                    if (externalTriggerRef) {
+                      // eslint-disable-next-line no-param-reassign
+                      externalTriggerRef.current = node;
+                    } else {
+                      internalTriggerRef.current = node;
+                    }
+                  },
+                  size,
+                  ...inputAttributes,
+                  ...UNSAFE_triggerButtonProps,
+                  id,
+                  ...mergeProps(
+                    {
+                      onClick: () => {
+                        setOpen((prev) => !prev);
+                      },
+                      onKeyDown: (event: React.KeyboardEvent) => {
+                        if (
+                          event.key === ' ' ||
+                          event.key === 'Enter' ||
+                          event.key === 'ArrowDown' ||
+                          event.key === 'ArrowUp'
+                        ) {
+                          setOpen((prev) => !prev);
+                        }
+                      },
+                    },
+                    getInteractionProps(),
+                  ),
+                }}
+              >
+                {renderTrigger({
+                  content: !placeholderShown ? (
+                    <SelectInputOptionContentWithinTriggerContext.Provider value>
+                      {multiple && Array.isArray(value)
+                        ? (value as readonly NonNullable<T>[])
+                            .map((option) => renderValue(option, true))
+                            .filter((node) => node != null)
+                            .join(', ')
+                        : renderValue(value as NonNullable<T>, true)}
+                    </SelectInputOptionContentWithinTriggerContext.Provider>
+                  ) : (
+                    placeholder
+                  ),
+                  placeholderShown,
+                  clear:
+                    onClear != null
+                      ? () => {
+                          onClear();
+                          (externalTriggerRef?.current ?? internalTriggerRef.current)?.focus({
+                            preventScroll: true,
+                          });
+                        }
+                      : undefined,
+                  disabled: uiDisabled,
+                  size,
+                  className,
+                })}
+              </SelectInputTriggerButtonPropsContext.Provider>
+            )}
+            initialFocusRef={controllerRef}
+            size={filterable ? 'lg' : 'md'}
+            padding="none"
+            onClose={() => {
+              setOpen(false);
+            }}
+            onCloseEnd={() => {
+              setFilterQuery('');
+            }}
+          >
+            <SelectInputOptions
+              id={id ? `${id}Search` : undefined}
+              parentId={parentId}
+              items={items}
+              compareValues={compareValues}
+              renderValue={renderValue}
+              renderFooter={renderFooter}
+              filterable={filterable}
+              filterPlaceholder={filterPlaceholder}
+              sortFilteredOptions={sortFilteredOptions}
+              searchInputRef={searchInputRef}
+              listboxRef={listboxRef}
+              filterQuery={deferredFilterQuery}
+              autocomplete={autocomplete}
+              name={name}
+              onFilterChange={setFilterQuery}
+              onAutocompleteSelect={(matchedValue) => {
+                onChange?.(matchedValue as M extends true ? T[] : T);
+                if (!multiple) {
+                  setOpen(false);
+                }
+              }}
+              {...getListBoxLabelProps()}
+            />
+          </OptionsOverlay>
+        );
+      }}
+    </ListboxBase>
+  );
+}
+
+// Attach sortByRelevance to the component for convenience
+SelectInput.sortByRelevance = sortByRelevance;

package/src/inputs/SelectInput/SelectInput.types.ts

@@ -0,0 +1,113 @@
+import React, { ReactNode } from 'react';
+import { ButtonProps } from '../../button/Button.types';
+import { WithInputAttributesProps } from './SelectInput.contexts';
+
+// Item interfaces
+export interface SelectInputOptionItem<T = string> {
+  type: 'option';
+  value: T;
+  filterMatchers?: readonly string[];
+  disabled?: boolean;
+}
+
+export interface SelectInputGroupItem<T = string> {
+  type: 'group';
+  label: ReactNode;
+  options: readonly SelectInputOptionItem<T>[];
+  action?: {
+    label: string;
+    onClick: ButtonProps['onClick'];
+  };
+}
+
+export interface SelectInputSeparatorItem {
+  type: 'separator';
+}
+
+export type SelectInputItem<T = string> =
+  | SelectInputOptionItem<T>
+  | SelectInputGroupItem<T>
+  | SelectInputSeparatorItem;
+
+// Main component props
+export interface SelectInputProps<T = string, M extends boolean = false> {
+  id?: string;
+  /**
+   * Sets the `data-wds-parent` attribute on the listbox container, which is needed for complex components like DateInput to correctly manage event handling.
+   * @internal
+   */
+  parentId?: string;
+  name?: string;
+  multiple?: M;
+  placeholder?: string;
+  items: readonly SelectInputItem<NonNullable<T>>[];
+  /**
+   * Enables browser autocomplete integration through the search input.
+   * Accepts standard HTML autocomplete values (e.g., "country-name", "address-level1").
+   *
+   * Requires `filterable={true}` to enable the search input.
+   *
+   * @example
+   * <SelectInput
+   *   name="country"
+   *   autocomplete="country-name"
+   *   filterable={true}
+   *   items={[{
+   *     type: 'option',
+   *     value: 'GB',
+   *     filterMatchers: ['United Kingdom', 'UK']
+   *   }]}
+   * />
+   */
+  autocomplete?: string;
+  defaultValue?: M extends true ? readonly T[] : T;
+  value?: M extends true ? readonly T[] : T;
+  compareValues?:
+    | (keyof NonNullable<T> & string)
+    | ((a: T | undefined, b: T | undefined) => boolean);
+  renderValue?: (value: NonNullable<T>, withinTrigger: boolean) => React.ReactNode;
+  renderFooter?: (args: {
+    resultsEmpty: boolean;
+    queryNormalized: string | null | undefined;
+  }) => React.ReactNode;
+  renderTrigger?: (args: {
+    content: React.ReactNode;
+    placeholderShown: boolean;
+    clear: (() => void) | undefined;
+    disabled: boolean;
+    size: 'sm' | 'md' | 'lg';
+    className: string | undefined;
+  }) => React.ReactNode;
+  filterable?: boolean;
+  filterPlaceholder?: string;
+  sortFilteredOptions?: (
+    a: SelectInputOptionItem<NonNullable<T>>,
+    b: SelectInputOptionItem<NonNullable<T>>,
+    searchQuery: string,
+  ) => number;
+  disabled?: boolean;
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+  UNSAFE_triggerButtonProps?: WithInputAttributesProps['inputAttributes'] & {
+    'aria-label'?: string;
+  };
+  /** Ref to the select trigger button element. */
+  triggerRef?: React.MutableRefObject<HTMLButtonElement | null>;
+  onFilterChange?: (args: { query: string; queryNormalized: string | null }) => void;
+  onChange?: (value: M extends true ? T[] : T) => void;
+  onOpen?: () => void;
+  onClose?: () => void;
+  onClear?: () => void;
+}
+
+export type {
+  SelectInputTriggerButtonElementType,
+  SelectInputTriggerButtonProps,
+} from './TriggerButton';
+export type { SelectInputClearButtonProps } from './ClearButton';
+export type { SelectInputOptionContentProps } from './OptionContent';
+export type { SelectInputOptionProps } from './Option';
+export type { SelectInputItemViewProps } from './ItemView';
+export type { SelectInputGroupItemViewProps } from './ItemView/GroupItemView';
+export type { SelectInputOptionsProps } from './Options';
+export type { SelectInputOptionsContainerProps } from './Options/OptionsContainer';