@cdx-ui/primitives 0.0.1-beta.1 → 0.0.1-beta.11

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/radio/context.tsx

@@ -0,0 +1,21 @@
+import React from 'react';
+import { createContext } from '@cdx-ui/utils';
+import type { RadioGroupState } from '@react-stately/radio';
+import type { IRadioContextValue } from './types';
+
+export const [RadioProvider, useRadioContext] = createContext<IRadioContextValue>('RadioContext');
+
+export interface IRadioGroupState {
+  isReadOnly: boolean;
+  isDisabled: boolean;
+  isInvalid: boolean;
+  isRequired: boolean;
+  isSelected: (value: string) => boolean;
+  selectValue: (value: string) => void;
+}
+
+export const RadioGroupContext = React.createContext<{
+  state: IRadioGroupState;
+  radioGroupState: RadioGroupState;
+  name?: string;
+} | null>(null);

package/src/radio/createRadioGroup.tsx

@@ -0,0 +1,67 @@
+import { forwardRef } from 'react';
+import { useFormControlContext } from '@cdx-ui/utils';
+import { useRadioGroup } from '@react-native-aria/radio';
+import { useRadioGroupState } from '@react-stately/radio';
+import { dataAttributes } from '../utils/dataAttributes';
+import { RadioGroupContext } from './context';
+import type { IRadioGroupProps } from './types';
+
+export const createRadioGroup = <T,>(BaseRadioGroup: React.ComponentType<T>) =>
+  forwardRef(({ children, ...props }: IRadioGroupProps, ref?: React.Ref<T>) => {
+    const formControlContext = useFormControlContext();
+
+    const combinedProps = {
+      ...formControlContext,
+      ...props,
+    };
+
+    const radioGroupState = useRadioGroupState({
+      ...combinedProps,
+      validationState: combinedProps.isInvalid ? 'invalid' : 'valid',
+    });
+
+    const { radioGroupProps } = useRadioGroup(
+      {
+        ...combinedProps,
+        'aria-label': combinedProps['aria-label'],
+      },
+      radioGroupState,
+    );
+
+    const isDisabled = combinedProps.isDisabled ?? false;
+    const isInvalid = combinedProps.isInvalid ?? false;
+    const isRequired = combinedProps.isRequired ?? false;
+    const isReadOnly = combinedProps.isReadOnly ?? false;
+
+    return (
+      <RadioGroupContext.Provider
+        value={{
+          state: {
+            isDisabled,
+            isInvalid,
+            isRequired,
+            isReadOnly,
+            isSelected: (value: string) => radioGroupState.selectedValue === value,
+            selectValue: (value: string) => radioGroupState.setSelectedValue(value),
+          },
+          radioGroupState,
+          name: combinedProps.name,
+        }}
+      >
+        <BaseRadioGroup
+          {...radioGroupProps}
+          {...(combinedProps as unknown as T)}
+          ref={ref}
+          aria-required={isRequired || undefined}
+          aria-readonly={isReadOnly || undefined}
+          {...dataAttributes({
+            slot: 'radio-group',
+            disabled: isDisabled,
+            invalid: isInvalid,
+          })}
+        >
+          {children}
+        </BaseRadioGroup>
+      </RadioGroupContext.Provider>
+    );
+  });

package/src/radio/createRadioIndicator.tsx

@@ -0,0 +1,32 @@
+import { forwardRef } from 'react';
+import { dataAttributes } from '../utils/dataAttributes';
+import { useRadioContext } from './context';
+import type { IRadioIndicatorProps } from './types';
+
+export const createRadioIndicator = <T,>(BaseRadioIndicator: React.ComponentType<T>) =>
+  forwardRef<unknown, IRadioIndicatorProps & { className?: string }>(
+    ({ children, className, ...props }, ref) => {
+      const { isChecked, isDisabled, isHovered, isInvalid, isReadOnly, isPressed, isFocusVisible } =
+        useRadioContext();
+
+      return (
+        <BaseRadioIndicator
+          className={className}
+          {...dataAttributes({
+            slot: 'radio-indicator',
+            hover: isHovered,
+            checked: isChecked,
+            disabled: isDisabled,
+            focusVisible: isFocusVisible,
+            invalid: isInvalid,
+            readonly: isReadOnly,
+            active: isPressed,
+          })}
+          {...(props as T)}
+          ref={ref}
+        >
+          {children}
+        </BaseRadioIndicator>
+      );
+    },
+  );

package/src/radio/createRadioLabel.tsx

@@ -0,0 +1,28 @@
+import { forwardRef } from 'react';
+import { dataAttributes } from '../utils/dataAttributes';
+import { useRadioContext } from './context';
+import type { IRadioLabelProps } from './types';
+
+export const createRadioLabel = <T,>(BaseRadioLabel: React.ComponentType<T>) =>
+  forwardRef<unknown, IRadioLabelProps & { className?: string }>(
+    ({ children, className, ...props }, ref) => {
+      const { isChecked, isDisabled, isHovered, isInvalid, isReadOnly } = useRadioContext();
+
+      return (
+        <BaseRadioLabel
+          className={className}
+          {...dataAttributes({
+            hover: isHovered,
+            checked: isChecked,
+            disabled: isDisabled,
+            invalid: isInvalid,
+            readonly: isReadOnly,
+          })}
+          {...(props as T)}
+          ref={ref}
+        >
+          {children}
+        </BaseRadioLabel>
+      );
+    },
+  );

package/src/radio/createRadioRoot.tsx

@@ -0,0 +1,100 @@
+import { forwardRef } from 'react';
+import { composeEventHandlers } from '@cdx-ui/utils';
+import { useFocus } from '@react-native-aria/focus';
+import { usePress } from '@react-native-aria/interactions';
+import { dataAttributes } from '../utils/dataAttributes';
+import { RadioProvider } from './context';
+import type { IRadioProps } from './types';
+import { useRadioRoot } from './useRadioRoot';
+
+export const createRadioRoot = <T,>(
+  BaseRadio: React.ComponentType<T>,
+  RadioIndicator: React.ComponentType<any>,
+) =>
+  forwardRef(
+    (
+      {
+        onPressIn,
+        onPressOut,
+        onHoverIn,
+        onHoverOut,
+        onFocus,
+        onBlur,
+        children,
+        ...props
+      }: IRadioProps,
+      ref?: React.Ref<T>,
+    ) => {
+      const {
+        isHovered: isHoveredProp,
+        isDisabled: isDisabledProp,
+        isInvalid: isInvalidProp,
+        isReadOnly: isReadOnlyProp,
+        isPressed: isPressedProp,
+        isFocused: isFocusedProp,
+        isFocusVisible,
+      } = props;
+
+      const {
+        combinedProps,
+        isInvalid,
+        isReadOnly,
+        inputProps,
+        isChecked,
+        isDisabled,
+        isHovered,
+        hoverProps,
+        mergedRef,
+      } = useRadioRoot(props, ref);
+
+      const { focusProps, isFocused } = useFocus();
+
+      const { pressProps, isPressed } = usePress({
+        isDisabled: isDisabled || isDisabledProp,
+      });
+
+      return (
+        <BaseRadio
+          disabled={isDisabled || isDisabledProp}
+          {...pressProps}
+          {...(combinedProps as T)}
+          {...inputProps}
+          ref={mergedRef}
+          role="radio"
+          onPressIn={composeEventHandlers(onPressIn, pressProps.onPressIn)}
+          onPressOut={composeEventHandlers(onPressOut, pressProps.onPressOut)}
+          onHoverIn={composeEventHandlers(onHoverIn, hoverProps.onHoverIn)}
+          onHoverOut={composeEventHandlers(onHoverOut, hoverProps.onHoverOut)}
+          onFocus={composeEventHandlers(onFocus, focusProps.onFocus)}
+          onBlur={composeEventHandlers(onBlur, focusProps.onBlur)}
+          {...dataAttributes({
+            slot: 'radio',
+            checked: isChecked,
+            disabled: isDisabled || isDisabledProp,
+            hover: isHovered || isHoveredProp,
+            invalid: isInvalid || isInvalidProp,
+            readonly: isReadOnly || isReadOnlyProp,
+            active: isPressed,
+            focus: isFocused,
+            focusVisible: isFocusVisible,
+          })}
+        >
+          <RadioProvider
+            value={{
+              isChecked,
+              isDisabled: isDisabled || isDisabledProp,
+              isHovered: isHovered || isHoveredProp,
+              isInvalid: isInvalid || isInvalidProp,
+              isReadOnly: isReadOnly || isReadOnlyProp,
+              isPressed: isPressed || isPressedProp,
+              isFocused: isFocused || isFocusedProp,
+              isFocusVisible,
+            }}
+          >
+            <RadioIndicator />
+            {children}
+          </RadioProvider>
+        </BaseRadio>
+      );
+    },
+  );

package/src/radio/createRadioRoot.web.tsx

@@ -0,0 +1,81 @@
+import { forwardRef } from 'react';
+import { VisuallyHidden } from '@react-aria/visually-hidden';
+import { mergeProps } from '@react-aria/utils';
+import { useFocusRing } from '@react-native-aria/focus';
+import { dataAttributes } from '../utils/dataAttributes';
+import { RadioProvider } from './context';
+import type { IRadioProps } from './types';
+import { useRadioRoot } from './useRadioRoot';
+
+// TODO: Keyboard focus is not working as expected
+
+export const createRadioRoot = <T,>(
+  BaseRadio: React.ComponentType<T>,
+  RadioIndicator: React.ComponentType<any>,
+) =>
+  forwardRef(({ children, ...props }: IRadioProps, ref?: React.Ref<T>) => {
+    const {
+      isHovered: isHoveredProp,
+      isFocusVisible: isFocusVisibleProp,
+      isDisabled: isDisabledProp,
+      isInvalid: isInvalidProp,
+      isReadOnly: isReadOnlyProp,
+      isFocused,
+      isPressed,
+    } = props;
+
+    const {
+      combinedProps,
+      isInvalid,
+      isReadOnly,
+      inputProps,
+      labelProps,
+      isChecked,
+      isDisabled,
+      isHovered,
+      mergedRef,
+      inputRef,
+    } = useRadioRoot(props, ref, { useInputRefForAria: true });
+
+    const { focusProps, isFocusVisible } = useFocusRing();
+
+    return (
+      <BaseRadio
+        {...mergeProps(combinedProps as any, labelProps as any, focusProps as any)}
+        ref={mergedRef}
+        role="label"
+        // eslint-disable-next-line react-native-a11y/has-valid-accessibility-role
+        accessibilityRole="label"
+        {...dataAttributes({
+          slot: 'radio',
+          checked: isChecked,
+          disabled: isDisabled || isDisabledProp,
+          hover: isHovered || isHoveredProp,
+          invalid: isInvalid || isInvalidProp,
+          readonly: isReadOnly || isReadOnlyProp,
+          active: isPressed,
+          focus: isFocused,
+          focusVisible: isFocusVisible || isFocusVisibleProp,
+        })}
+      >
+        <RadioProvider
+          value={{
+            isChecked,
+            isDisabled: isDisabled || isDisabledProp,
+            isFocusVisible: isFocusVisible || isFocusVisibleProp,
+            isHovered: isHovered || isHoveredProp,
+            isInvalid: isInvalid || isInvalidProp,
+            isReadOnly: isReadOnly || isReadOnlyProp,
+            isPressed,
+            isFocused,
+          }}
+        >
+          <VisuallyHidden>
+            <input {...inputProps} ref={inputRef} />
+          </VisuallyHidden>
+          <RadioIndicator />
+          {children}
+        </RadioProvider>
+      </BaseRadio>
+    );
+  });

package/src/radio/index.ts

@@ -0,0 +1,37 @@
+import type React from 'react';
+import { createRadioGroup } from './createRadioGroup';
+import { createRadioIndicator } from './createRadioIndicator';
+import { createRadioLabel } from './createRadioLabel';
+import { createRadioRoot } from './createRadioRoot';
+import type { IRadioComponentType } from './types';
+
+export type {
+  IRadioComponentType,
+  IRadioGroupProps,
+  IRadioIndicatorProps,
+  IRadioLabelProps,
+  IRadioProps,
+} from './types';
+
+export function createRadio<Root, Indicator, Label, Group>(BaseComponents: {
+  Root: React.ComponentType<Root>;
+  Indicator: React.ComponentType<Indicator>;
+  Label: React.ComponentType<Label>;
+  Group: React.ComponentType<Group>;
+}) {
+  const Indicator = createRadioIndicator(BaseComponents.Indicator);
+  const Radio = createRadioRoot(BaseComponents.Root, Indicator);
+  const Label = createRadioLabel(BaseComponents.Label);
+  const Group = createRadioGroup(BaseComponents.Group);
+
+  Radio.displayName = 'RadioPrimitive';
+  Indicator.displayName = 'RadioPrimitive.Indicator';
+  Label.displayName = 'RadioPrimitive.Label';
+  Group.displayName = 'RadioPrimitive.Group';
+
+  return Object.assign(Radio, {
+    Indicator,
+    Label,
+    Group,
+  }) as IRadioComponentType<Root, Indicator, Label, Group>;
+}

package/src/radio/types.ts

@@ -0,0 +1,67 @@
+import type { PressableProps } from 'react-native';
+
+export interface IRadioProps extends PressableProps {
+  /** Required — identifies this item's value within a Radio.Group. */
+  value: string;
+  isDisabled?: boolean;
+  isInvalid?: boolean;
+  isReadOnly?: boolean;
+  isHovered?: boolean;
+  isFocused?: boolean;
+  isPressed?: boolean;
+  isFocusVisible?: boolean;
+  children?: React.ReactNode;
+}
+
+export interface IRadioGroupProps {
+  /** Controlled selected value. */
+  value?: string;
+  /** Default selected value for uncontrolled usage. */
+  defaultValue?: string;
+  /** Called when the selected value changes. */
+  onChange?: (value: string) => void;
+  /** Layout direction of the radio items. */
+  direction?: 'column' | 'row';
+  /** Form field name for web form integration. */
+  name?: string;
+  isDisabled?: boolean;
+  isInvalid?: boolean;
+  isRequired?: boolean;
+  isReadOnly?: boolean;
+  'aria-label'?: string;
+  'aria-labelledby'?: string;
+  children?: React.ReactNode;
+}
+
+export interface IRadioIndicatorProps {
+  children?: React.ReactNode;
+}
+
+export interface IRadioLabelProps {
+  children?: React.ReactNode;
+}
+
+export type IRadioComponentType<Root, Indicator, Label, Group> = React.ForwardRefExoticComponent<
+  React.RefAttributes<Root> & React.PropsWithoutRef<Root> & IRadioProps
+> & {
+  Indicator: React.ForwardRefExoticComponent<
+    React.RefAttributes<Indicator> & React.PropsWithoutRef<Indicator> & IRadioIndicatorProps
+  >;
+  Label: React.ForwardRefExoticComponent<
+    React.RefAttributes<Label> & React.PropsWithoutRef<Label> & IRadioLabelProps
+  >;
+  Group: React.ForwardRefExoticComponent<
+    React.RefAttributes<Group> & React.PropsWithoutRef<Group> & IRadioGroupProps
+  >;
+};
+
+export interface IRadioContextValue {
+  isChecked?: boolean;
+  isDisabled?: boolean;
+  isInvalid?: boolean;
+  isReadOnly?: boolean;
+  isFocused?: boolean;
+  isFocusVisible?: boolean;
+  isHovered?: boolean;
+  isPressed?: boolean;
+}

package/src/radio/useRadioRoot.ts

@@ -0,0 +1,69 @@
+import { useContext, useRef } from 'react';
+import { mergeRefs, useFormControlContext } from '@cdx-ui/utils';
+import { useRadio } from '@react-native-aria/radio';
+import { useHover } from '@react-native-aria/interactions';
+import { RadioGroupContext } from './context';
+import type { IRadioProps } from './types';
+
+interface UseRadioRootOptions {
+  useInputRefForAria?: boolean;
+}
+
+export function useRadioRoot(
+  props: IRadioProps,
+  ref?: React.Ref<unknown>,
+  { useInputRefForAria = false }: UseRadioRootOptions = {},
+) {
+  const formControlContext = useFormControlContext();
+
+  const { isInvalid, isReadOnly, ...combinedProps } = {
+    ...formControlContext,
+    ...props,
+  };
+
+  const radioGroupContext = useContext(RadioGroupContext);
+
+  if (!radioGroupContext) {
+    throw new Error(
+      'Radio must be rendered inside a Radio.Group. Standalone Radio is not supported.',
+    );
+  }
+
+  const rootRef = useRef(null);
+  const inputRef = useRef<HTMLInputElement | null>(null);
+  const mergedRootRef = mergeRefs(ref as any, rootRef as any);
+  const ariaLabel = combinedProps['aria-label'] || combinedProps.value || 'Radio';
+
+  const radio = useRadio(
+    {
+      ...combinedProps,
+      'aria-label': ariaLabel,
+      isReadOnly: isReadOnly || radioGroupContext.state.isReadOnly,
+      isDisabled: combinedProps.isDisabled || radioGroupContext.state.isDisabled,
+    } as any,
+    radioGroupContext.radioGroupState,
+    (useInputRefForAria ? inputRef : rootRef) as any,
+  );
+
+  const { inputProps, labelProps } = radio as typeof radio & {
+    labelProps?: Record<string, unknown>;
+  };
+
+  const { checked: isChecked, disabled: isDisabled } = inputProps;
+
+  const { hoverProps, isHovered } = useHover({}, rootRef);
+
+  return {
+    combinedProps,
+    isInvalid: isInvalid || radioGroupContext.state.isInvalid,
+    isReadOnly: isReadOnly || radioGroupContext.state.isReadOnly,
+    inputProps,
+    labelProps: labelProps ?? {},
+    isChecked,
+    isDisabled,
+    isHovered,
+    hoverProps,
+    mergedRef: mergedRootRef,
+    inputRef,
+  };
+}