@cdx-ui/primitives 0.0.1-alpha.9 → 0.0.1-beta.10

package/src/list-item/createListItemDescription.tsx

@@ -0,0 +1,19 @@
+import React, { forwardRef } from 'react';
+import { dataAttributes } from '../utils/dataAttributes';
+import type { IListItemDescriptionProps } from './types';
+
+export const createListItemDescription = <T,>(Base: React.ComponentType<T>) =>
+  forwardRef(
+    ({ children, style, ...props }: IListItemDescriptionProps, ref: React.Ref<unknown>) => (
+      <Base
+        {...(props as T)}
+        {...dataAttributes({
+          slot: 'list-item-description',
+        })}
+        ref={ref as React.Ref<T>}
+        style={style}
+      >
+        {children}
+      </Base>
+    ),
+  );

package/src/list-item/createListItemLeadingSlot.tsx

@@ -0,0 +1,30 @@
+import React, { forwardRef } from 'react';
+import { dataAttributes } from '../utils/dataAttributes';
+import type { IListItemLeadingSlotProps } from './types';
+
+const shrinkZero = { flexShrink: 0 as const };
+
+export const createListItemLeadingSlot = <T,>(Base: React.ComponentType<T>) =>
+  forwardRef(
+    (
+      { 'aria-hidden': ariaHidden, style, children, ...props }: IListItemLeadingSlotProps,
+      ref: React.Ref<unknown>,
+    ) => {
+      const accessibilityElementsHidden = ariaHidden !== false;
+
+      return (
+        <Base
+          {...(props as T)}
+          {...dataAttributes({
+            slot: 'list-item-leading',
+          })}
+          accessibilityElementsHidden={accessibilityElementsHidden}
+          aria-hidden={ariaHidden}
+          ref={ref as React.Ref<T>}
+          style={[shrinkZero, style]}
+        >
+          {children}
+        </Base>
+      );
+    },
+  );

package/src/list-item/createListItemMeta.tsx

@@ -0,0 +1,17 @@
+import React, { forwardRef } from 'react';
+import { dataAttributes } from '../utils/dataAttributes';
+import type { IListItemMetaProps } from './types';
+
+export const createListItemMeta = <T,>(Base: React.ComponentType<T>) =>
+  forwardRef(({ children, style, ...props }: IListItemMetaProps, ref: React.Ref<unknown>) => (
+    <Base
+      {...(props as T)}
+      {...dataAttributes({
+        slot: 'list-item-meta',
+      })}
+      ref={ref as React.Ref<T>}
+      style={style}
+    >
+      {children}
+    </Base>
+  ));

package/src/list-item/createListItemRoot.tsx

@@ -0,0 +1,163 @@
+import React, { forwardRef, useMemo } from 'react';
+import type { PressableProps } from 'react-native';
+import { composeEventHandlers, mergeRefs } from '@cdx-ui/utils';
+import { useHover, usePress } from '@react-native-aria/interactions';
+import { dataAttributes } from '../utils/dataAttributes';
+import { ListItemProvider } from './context';
+import type { IListItemProps, IListItemPressablePassthrough } from './types';
+
+function listItemRootDataAttrs(
+  size: IListItemProps['size'],
+  surface: IListItemProps['surface'],
+  showSeparator: boolean | undefined,
+  crossAlign: IListItemProps['crossAlign'],
+) {
+  return dataAttributes({
+    slot: 'list-item',
+    size: size ?? 'default',
+    surface: surface ?? 'default',
+    separator: showSeparator ?? true,
+    crossAlign: crossAlign ?? 'center',
+  });
+}
+
+function rowStyleForCrossAlign(crossAlign: IListItemProps['crossAlign']) {
+  return {
+    flexDirection: 'row' as const,
+    alignSelf: 'stretch' as const,
+    alignItems: crossAlign === 'start' ? ('flex-start' as const) : ('center' as const),
+  };
+}
+
+export const createListItemRoot = <V, P>(
+  BaseView: React.ComponentType<V>,
+  BasePressable: React.ComponentType<P>,
+) =>
+  forwardRef(
+    (
+      {
+        asChild = false,
+        children,
+        onPress,
+        size = 'default',
+        surface = 'default',
+        showSeparator = true,
+        crossAlign = 'center',
+        disabled = false,
+        style,
+        ...restProps
+      }: IListItemProps,
+      ref: React.Ref<unknown>,
+    ) => {
+      const asChildInteractive = asChild && !!onPress && React.isValidElement(children);
+      const isPressableRoot = !!onPress && !asChildInteractive;
+
+      const pressState = usePress({
+        isDisabled: !isPressableRoot || disabled,
+      });
+      const isPressed = pressState.isPressed;
+      const pressProps = pressState.pressProps as Pick<PressableProps, 'onPressIn' | 'onPressOut'>;
+      const { hoverProps, isHovered } = useHover();
+
+      const slotAttrs = listItemRootDataAttrs(size, surface, showSeparator, crossAlign);
+
+      const contextValue = useMemo(
+        () => ({
+          isPressed: isPressableRoot ? isPressed : false,
+          isHovered,
+          isDisabled: disabled,
+          crossAlign: crossAlign ?? 'center',
+        }),
+        [isPressableRoot, isPressed, isHovered, disabled, crossAlign],
+      );
+
+      if (asChildInteractive) {
+        const child = children as React.ReactElement<Record<string, unknown>>;
+
+        const mergedOnPress = composeEventHandlers(
+          child.props.onPress as IListItemProps['onPress'],
+          onPress,
+        );
+
+        const childDisabled = !!(child.props as { disabled?: boolean }).disabled;
+
+        const resolvedDisabled = disabled || childDisabled;
+
+        return (
+          <ListItemProvider
+            value={{
+              isPressed: false,
+              isHovered: false,
+              isDisabled: resolvedDisabled,
+              crossAlign: crossAlign ?? 'center',
+            }}
+          >
+            {React.cloneElement(child, {
+              ...restProps,
+              ...slotAttrs,
+              ...dataAttributes({
+                active: false,
+                hovered: false,
+                disabled: resolvedDisabled,
+              }),
+              ...(resolvedDisabled && { accessibilityState: { disabled: true } }),
+              disabled: resolvedDisabled,
+              onPress: resolvedDisabled ? undefined : mergedOnPress,
+              ref: mergeRefs(ref, child.props.ref as React.Ref<unknown>),
+              style: [rowStyleForCrossAlign(crossAlign), style, child.props.style],
+            })}
+          </ListItemProvider>
+        );
+      }
+
+      if (isPressableRoot) {
+        const interactionAttrs = dataAttributes({
+          active: isPressed,
+          hovered: isHovered,
+          disabled,
+        });
+
+        const {
+          onPressIn: onPressInProp,
+          onPressOut: onPressOutProp,
+          onHoverIn: onHoverInProp,
+          onHoverOut: onHoverOutProp,
+        } = restProps as IListItemPressablePassthrough;
+
+        return (
+          <ListItemProvider value={contextValue}>
+            <BasePressable
+              {...(restProps as P)}
+              {...slotAttrs}
+              {...interactionAttrs}
+              {...(disabled && { accessibilityState: { disabled: true } })}
+              disabled={disabled}
+              ref={ref as React.Ref<P>}
+              style={[rowStyleForCrossAlign(crossAlign), style]}
+              onPress={disabled ? undefined : onPress}
+              onPressIn={composeEventHandlers(onPressInProp, pressProps.onPressIn)}
+              onPressOut={composeEventHandlers(onPressOutProp, pressProps.onPressOut)}
+              onHoverIn={composeEventHandlers(onHoverInProp, hoverProps.onHoverIn)}
+              onHoverOut={composeEventHandlers(onHoverOutProp, hoverProps.onHoverOut)}
+            >
+              {children}
+            </BasePressable>
+          </ListItemProvider>
+        );
+      }
+
+      return (
+        <ListItemProvider value={contextValue}>
+          <BaseView
+            {...(restProps as V)}
+            {...slotAttrs}
+            {...(disabled ? dataAttributes({ disabled: true }) : undefined)}
+            ref={ref as React.Ref<V>}
+            style={[rowStyleForCrossAlign(crossAlign), style]}
+          >
+            {children}
+          </BaseView>
+        </ListItemProvider>
+      );
+    },
+  );

package/src/list-item/createListItemSectionHeader.tsx

@@ -0,0 +1,53 @@
+import React, { forwardRef } from 'react';
+import { View } from 'react-native';
+import { dataAttributes } from '../utils/dataAttributes';
+import type { IListItemSectionHeaderProps } from './types';
+
+const row = {
+  flexDirection: 'row' as const,
+  alignItems: 'center' as const,
+  justifyContent: 'space-between' as const,
+  gap: 8,
+};
+
+const labelCell = {
+  flex: 1,
+  minWidth: 0,
+  /** Keeps the label column from stretching to a taller trailing sibling (e.g. Chip). */
+  alignSelf: 'center' as const,
+};
+
+const trailingCell = {
+  flexShrink: 0,
+  /** Prevents the trailing slot from stretching vertically and “filling” the row. */
+  alignSelf: 'center' as const,
+};
+
+export const createListItemSectionHeader = <T,>(Base: React.ComponentType<T>) =>
+  forwardRef(
+    (
+      {
+        children,
+        trailing,
+        showDivider = true,
+        style,
+        accessibilityRole = 'header',
+        ...props
+      }: IListItemSectionHeaderProps,
+      ref: React.Ref<unknown>,
+    ) => (
+      <Base
+        {...(props as T)}
+        {...dataAttributes({
+          slot: 'list-section-header',
+          divider: showDivider,
+        })}
+        accessibilityRole={accessibilityRole}
+        ref={ref as React.Ref<T>}
+        style={[row, style]}
+      >
+        <View style={labelCell}>{children}</View>
+        {trailing ? <View style={trailingCell}>{trailing}</View> : null}
+      </Base>
+    ),
+  );

package/src/list-item/createListItemTitle.tsx

@@ -0,0 +1,17 @@
+import React, { forwardRef } from 'react';
+import { dataAttributes } from '../utils/dataAttributes';
+import type { IListItemTitleProps } from './types';
+
+export const createListItemTitle = <T,>(Base: React.ComponentType<T>) =>
+  forwardRef(({ children, style, ...props }: IListItemTitleProps, ref: React.Ref<unknown>) => (
+    <Base
+      {...(props as T)}
+      {...dataAttributes({
+        slot: 'list-item-title',
+      })}
+      ref={ref as React.Ref<T>}
+      style={style}
+    >
+      {children}
+    </Base>
+  ));

package/src/list-item/createListItemTrailingSlot.tsx

@@ -0,0 +1,21 @@
+import React, { forwardRef } from 'react';
+import { dataAttributes } from '../utils/dataAttributes';
+import type { IListItemTrailingSlotProps } from './types';
+
+const shrinkZero = { flexShrink: 0 as const };
+
+export const createListItemTrailingSlot = <T,>(Base: React.ComponentType<T>) =>
+  forwardRef(
+    ({ children, style, ...props }: IListItemTrailingSlotProps, ref: React.Ref<unknown>) => (
+      <Base
+        {...(props as T)}
+        {...dataAttributes({
+          slot: 'list-item-trailing',
+        })}
+        ref={ref as React.Ref<T>}
+        style={[shrinkZero, style]}
+      >
+        {children}
+      </Base>
+    ),
+  );

package/src/list-item/index.ts

@@ -0,0 +1,88 @@
+import type React from 'react';
+import { createListItemContent } from './createListItemContent';
+import { createListItemDescription } from './createListItemDescription';
+import { createListItemLeadingSlot } from './createListItemLeadingSlot';
+import { createListItemMeta } from './createListItemMeta';
+import { createListItemRoot } from './createListItemRoot';
+import { createListItemSectionHeader } from './createListItemSectionHeader';
+import { createListItemTitle } from './createListItemTitle';
+import { createListItemTrailingSlot } from './createListItemTrailingSlot';
+import type { IListItemComponentType } from './types';
+
+export type {
+  IListItemComponentType,
+  IListItemContentProps,
+  IListItemContextValue,
+  IListItemDescriptionProps,
+  IListItemLeadingSlotProps,
+  IListItemMetaProps,
+  IListItemPressablePassthrough,
+  IListItemProps,
+  IListItemSectionHeaderProps,
+  IListItemTitleProps,
+  IListItemTrailingSlotProps,
+  ListItemCrossAlign,
+  ListItemSize,
+  ListItemSurface,
+} from './types';
+
+export { ListItemProvider, useListItemContext } from './context';
+
+export function createListItem<
+  ViewComponent,
+  PressableComponent,
+  LeadingSlot,
+  Content,
+  Title,
+  Description,
+  Meta,
+  TrailingSlot,
+  SectionHeader,
+>(BaseComponents: {
+  View: React.ComponentType<ViewComponent>;
+  Pressable: React.ComponentType<PressableComponent>;
+  LeadingSlot: React.ComponentType<LeadingSlot>;
+  Content: React.ComponentType<Content>;
+  Title: React.ComponentType<Title>;
+  Description: React.ComponentType<Description>;
+  Meta: React.ComponentType<Meta>;
+  TrailingSlot: React.ComponentType<TrailingSlot>;
+  SectionHeader: React.ComponentType<SectionHeader>;
+}) {
+  const ListItem = createListItemRoot(BaseComponents.View, BaseComponents.Pressable);
+  const LeadingSlot = createListItemLeadingSlot(BaseComponents.LeadingSlot);
+  const Content = createListItemContent(BaseComponents.Content);
+  const Title = createListItemTitle(BaseComponents.Title);
+  const Description = createListItemDescription(BaseComponents.Description);
+  const Meta = createListItemMeta(BaseComponents.Meta);
+  const TrailingSlot = createListItemTrailingSlot(BaseComponents.TrailingSlot);
+  const SectionHeader = createListItemSectionHeader(BaseComponents.SectionHeader);
+
+  ListItem.displayName = 'ListItemPrimitive';
+  LeadingSlot.displayName = 'ListItemPrimitive.LeadingSlot';
+  Content.displayName = 'ListItemPrimitive.Content';
+  Title.displayName = 'ListItemPrimitive.Title';
+  Description.displayName = 'ListItemPrimitive.Description';
+  Meta.displayName = 'ListItemPrimitive.Meta';
+  TrailingSlot.displayName = 'ListItemPrimitive.TrailingSlot';
+  SectionHeader.displayName = 'ListItemPrimitive.SectionHeader';
+
+  return Object.assign(ListItem, {
+    LeadingSlot,
+    Content,
+    Title,
+    Description,
+    Meta,
+    TrailingSlot,
+    SectionHeader,
+  }) as IListItemComponentType<
+    ViewComponent | PressableComponent,
+    LeadingSlot,
+    Content,
+    Title,
+    Description,
+    Meta,
+    TrailingSlot,
+    SectionHeader
+  >;
+}

package/src/list-item/types.ts

@@ -0,0 +1,122 @@
+import type { ForwardRefExoticComponent, PropsWithoutRef, ReactNode, RefAttributes } from 'react';
+import type { PressableProps, TextProps, ViewProps } from 'react-native';
+
+export type ListItemSize = 'default' | 'compact';
+
+export type ListItemSurface = 'default' | 'negative';
+
+/**
+ * Cross-axis alignment for the row (`flex-direction: row`).
+ * - **center**: Leading, content, and trailing are vertically centered (typical transactions).
+ * - **start**: Top-aligned — use when trailing text should align with the title row (e.g. branch distance “2.04 mi”) or status chips sit above a tall content stack.
+ */
+export type ListItemCrossAlign = 'center' | 'start';
+
+export type IListItemPressablePassthrough = Partial<
+  Pick<PressableProps, 'onPressIn' | 'onPressOut' | 'onHoverIn' | 'onHoverOut'>
+>;
+
+export interface IListItemProps extends ViewProps, IListItemPressablePassthrough {
+  /**
+   * Disables press handling when the root is pressable (maps to Pressable `disabled`).
+   */
+  disabled?: boolean;
+  /**
+   * When set (and `asChild` is not used), root renders as pressable with interaction props.
+   */
+  onPress?: PressableProps['onPress'];
+  /**
+   * Vertical density; mapped at styled layer via `data-size`.
+   * @default 'default'
+   */
+  size?: ListItemSize;
+  /**
+   * Semantic row surface (e.g. canceled transaction); mapped via `data-surface`.
+   * @default 'default'
+   */
+  surface?: ListItemSurface;
+  /**
+   * Whether the row shows a bottom separator; mapped via `data-separator`.
+   * @default true
+   */
+  showSeparator?: boolean;
+  /**
+   * Vertical alignment of leading / content / trailing along the row cross axis.
+   * @default 'center'
+   */
+  crossAlign?: ListItemCrossAlign;
+  /**
+   * Merge interaction props onto a single child instead of rendering the default pressable root.
+   * Intended for use with `onPress`.
+   */
+  asChild?: boolean;
+}
+
+export interface IListItemContextValue {
+  isPressed: boolean;
+  isHovered: boolean;
+  isDisabled: boolean;
+  crossAlign: ListItemCrossAlign;
+}
+
+export interface IListItemLeadingSlotProps extends ViewProps {
+  /**
+   * Decorative leading content defaults to hidden from the accessibility tree.
+   * Set to `false` when the leading region contains meaningful controls.
+   * @default true
+   */
+  'aria-hidden'?: boolean;
+}
+
+export type IListItemContentProps = ViewProps;
+
+export type IListItemTitleProps = TextProps;
+
+export type IListItemDescriptionProps = TextProps;
+
+export type IListItemMetaProps = TextProps;
+
+export type IListItemTrailingSlotProps = ViewProps;
+
+export interface IListItemSectionHeaderProps extends ViewProps {
+  /** Primary section label (e.g. date heading). */
+  children: ReactNode;
+  /** Optional right-aligned adornment (e.g. section Chip). */
+  trailing?: ReactNode;
+  /**
+   * Whether to expose the top divider marker for styling (`data-divider`).
+   * @default true
+   */
+  showDivider?: boolean;
+}
+
+export type IListItemComponentType<
+  RootRef,
+  LeadingSlot,
+  Content,
+  Title,
+  Description,
+  Meta,
+  TrailingSlot,
+  SectionHeader,
+> = ForwardRefExoticComponent<RefAttributes<RootRef> & IListItemProps> & {
+  LeadingSlot: ForwardRefExoticComponent<
+    RefAttributes<LeadingSlot> & PropsWithoutRef<LeadingSlot> & IListItemLeadingSlotProps
+  >;
+  Content: ForwardRefExoticComponent<
+    RefAttributes<Content> & PropsWithoutRef<Content> & IListItemContentProps
+  >;
+  Title: ForwardRefExoticComponent<
+    RefAttributes<Title> & PropsWithoutRef<Title> & IListItemTitleProps
+  >;
+  Description: ForwardRefExoticComponent<
+    RefAttributes<Description> & PropsWithoutRef<Description> & IListItemDescriptionProps
+  >;
+  Meta: ForwardRefExoticComponent<RefAttributes<Meta> & PropsWithoutRef<Meta> & IListItemMetaProps>;
+  TrailingSlot: ForwardRefExoticComponent<
+    RefAttributes<TrailingSlot> & PropsWithoutRef<TrailingSlot> & IListItemTrailingSlotProps
+  >;
+  SectionHeader: ForwardRefExoticComponent<
+    RefAttributes<SectionHeader> & PropsWithoutRef<SectionHeader> & IListItemSectionHeaderProps
+  >;
+};

package/src/otp-input/context.tsx

@@ -0,0 +1,8 @@
+import { createContext } from '@cdx-ui/utils';
+import type { OtpInputCellIndexContextValue, OtpInputContextValue } from './types';
+
+export const [OtpInputProvider, useOtpInputContext] =
+  createContext<OtpInputContextValue>('OtpInputContext');
+
+export const [OtpCellIndexProvider, useOtpCellIndexContext] =
+  createContext<OtpInputCellIndexContextValue>('OtpCellIndexContext');

package/src/otp-input/createOtpInputCell.tsx

@@ -0,0 +1,22 @@
+import type React from 'react';
+import type { PropsWithChildren } from 'react';
+import { forwardRef } from 'react';
+import { useOtpInputContext } from './context';
+import type { IOtpInputCellProps } from './types';
+
+export const createOtpInputCell = <T,>(BaseCell: React.ComponentType<T>) =>
+  forwardRef<unknown, PropsWithChildren<IOtpInputCellProps & T>>(({ children, ...props }, ref) => {
+    const { isDisabled, isInvalid, isReadOnly } = useOtpInputContext();
+
+    return (
+      <BaseCell
+        ref={ref}
+        isDisabled={isDisabled}
+        isInvalid={isInvalid}
+        isReadOnly={isReadOnly}
+        {...(props as T)}
+      >
+        {children}
+      </BaseCell>
+    );
+  });

package/src/otp-input/createOtpInputField.tsx

@@ -0,0 +1,98 @@
+import type React from 'react';
+import { forwardRef, useMemo } from 'react';
+import { Platform, type TextInput, type TextInputKeyPressEvent } from 'react-native';
+import { mergeRefs } from '@cdx-ui/utils';
+import { useOtpCellIndexContext, useOtpInputContext } from './context';
+import type { IOtpInputFieldProps } from './types';
+
+export const createOtpInputField = <T,>(BaseField: React.ComponentType<T>) =>
+  forwardRef<TextInput, IOtpInputFieldProps & Omit<T, keyof IOtpInputFieldProps>>((props, ref) => {
+    const { cellIndex } = useOtpCellIndexContext();
+    const {
+      value,
+      cellCount,
+      isDisabled,
+      isReadOnly,
+      smsOtpAutofill,
+      getCellProps,
+      cellTestIdPrefix,
+      rootAccessibilityLabel,
+      setFieldRef,
+      handleFieldChange,
+      handleFieldKeyPress,
+    } = useOtpInputContext();
+
+    const char = cellIndex < value.length ? (value[cellIndex] ?? '') : '';
+    const extra = getCellProps?.(cellIndex) ?? {};
+
+    const accessibilityLabel = useMemo(() => {
+      const fromExtra = extra.accessibilityLabel;
+      if (typeof fromExtra === 'string' && fromExtra !== '') {
+        return fromExtra;
+      }
+      if (rootAccessibilityLabel) {
+        return `${rootAccessibilityLabel}, ${String(cellIndex + 1)} of ${String(cellCount)}`;
+      }
+      return `OTP digit ${String(cellIndex + 1)} of ${String(cellCount)}`;
+    }, [cellCount, cellIndex, extra.accessibilityLabel, rootAccessibilityLabel]);
+
+    const autofillProps = useMemo(() => {
+      if (!smsOtpAutofill || cellIndex !== 0) {
+        return {};
+      }
+      return Platform.select<Record<string, unknown>>({
+        web: { autoComplete: 'one-time-code' },
+        ios: { textContentType: 'oneTimeCode' },
+        android: { autoComplete: 'sms-otp' },
+        default: {},
+      });
+    }, [cellIndex, smsOtpAutofill]);
+
+    const editable = !(isDisabled || isReadOnly);
+
+    const { style: extraStyle, accessibilityLabel: _omitExtraA11y, ...extraRest } = extra;
+    void _omitExtraA11y;
+    const {
+      style: incomingStyle,
+      value: _omitValue,
+      defaultValue: _omitDefault,
+      onChangeText: _omitOnChange,
+      ...incomingRest
+    } = props as IOtpInputFieldProps;
+    void _omitValue;
+    void _omitDefault;
+    void _omitOnChange;
+
+    // Default digit OTP (`number-pad`). Root `getCellProps` is spread after and may override `keyboardType`.
+    return (
+      <BaseField
+        ref={mergeRefs(ref, (el: TextInput | null) => {
+          setFieldRef(cellIndex, el);
+        })}
+        accessibilityLabel={accessibilityLabel}
+        aria-label={accessibilityLabel}
+        accessible
+        autoFocus={cellIndex === 0 && editable && value.length === 0}
+        editable={editable}
+        keyboardType="number-pad"
+        returnKeyType="done"
+        selectTextOnFocus
+        testID={
+          cellTestIdPrefix
+            ? `${cellTestIdPrefix}:${String(cellIndex)}:textField:changeText`
+            : undefined
+        }
+        value={char}
+        onChangeText={(text: string) => {
+          handleFieldChange(cellIndex, text);
+        }}
+        onKeyPress={(e: TextInputKeyPressEvent) => {
+          handleFieldKeyPress(cellIndex, e.nativeEvent.key);
+        }}
+        {...autofillProps}
+        {...(extraRest as object)}
+        {...(incomingRest as T)}
+        style={[extraStyle, incomingStyle]}
+      />
+    );
+  });