@cdx-ui/components 0.0.1-beta.4 → 0.0.1-beta.40

package/src/components/ListItem/styles.ts

@@ -0,0 +1,153 @@
+import { Platform } from 'react-native';
+import { cva, type VariantProps } from 'class-variance-authority';
+import { TRANSITION_COLORS } from '../../styles/primitives';
+
+// ── Root (row): density, surface, separator, interactive feedback ──────────
+
+export const listItemRootVariants = cva(
+  [
+    'flex-row self-stretch w-full px-4',
+    'data-[disabled=true]:opacity-50 data-[disabled=true]:pointer-events-none',
+    'data-[active=true]:opacity-70',
+    TRANSITION_COLORS,
+    Platform.select({
+      web: [
+        'outline-none',
+        'web:data-[hover=true]:bg-slate-50',
+        'web:focus-visible:data-[disabled=false]:bg-slate-50',
+        'web:focus-visible:data-[disabled=false]:ring-2 web:focus-visible:data-[disabled=false]:ring-slate-400/40 web:focus-visible:data-[disabled=false]:ring-offset-2',
+      ].join(' '),
+      default: '',
+    }),
+  ],
+  {
+    variants: {
+      size: {
+        default: 'gap-3 py-4',
+        compact: 'gap-2 py-3',
+      },
+      surface: {
+        default: 'bg-white',
+        negative: 'bg-red-50',
+      },
+      showSeparator: {
+        true: 'border-b border-solid border-stroke-secondary',
+        false: 'border-b-0',
+      },
+      crossAlign: {
+        center: 'items-center',
+        start: 'items-start',
+      },
+    },
+    compoundVariants: [
+      {
+        surface: 'negative',
+        className: Platform.select({
+          web: 'web:data-[hover=true]:bg-red-100/90',
+          default: '',
+        }),
+      },
+    ],
+    defaultVariants: {
+      size: 'default',
+      surface: 'default',
+      showSeparator: true,
+      crossAlign: 'center',
+    },
+  },
+);
+
+// ── Leading / trailing slots ─────────────────────────────────────────────────
+
+export const listItemLeadingSlotVariants = cva(['flex shrink-0 items-center justify-center']);
+
+export const listItemTrailingSlotVariants = cva(['flex shrink-0 flex-row justify-end gap-2'], {
+  variants: {
+    crossAlign: {
+      center: 'items-center',
+      start: 'items-start self-start',
+    },
+  },
+  defaultVariants: {
+    crossAlign: 'center',
+  },
+});
+
+// ── Content stack (title / description / meta) ───────────────────────────────
+
+export const listItemContentVariants = cva('flex min-w-0 flex-1 flex-col gap-1', {
+  variants: {
+    crossAlign: {
+      center: 'justify-center',
+      start: 'justify-start',
+    },
+  },
+  defaultVariants: {
+    crossAlign: 'center',
+  },
+});
+
+// ── Typography ───────────────────────────────────────────────────────────────
+
+export const listItemTitleVariants = cva('text-content-primary font-medium', {
+  variants: {
+    size: {
+      default: 'text-base leading-snug',
+      compact: 'text-sm leading-snug',
+    },
+  },
+  defaultVariants: {
+    size: 'default',
+  },
+});
+
+export const listItemDescriptionVariants = cva('text-content-secondary', {
+  variants: {
+    size: {
+      default: 'text-sm leading-normal',
+      compact: 'text-xs leading-normal',
+    },
+  },
+  defaultVariants: {
+    size: 'default',
+  },
+});
+
+export const listItemMetaVariants = cva('text-content-tertiary', {
+  variants: {
+    size: {
+      default: 'text-xs leading-normal',
+      compact: 'text-[11px] leading-normal',
+    },
+  },
+  defaultVariants: {
+    size: 'default',
+  },
+});
+
+// ── Section header (group label row inside lists / cards) ───────────────────
+
+export const listItemSectionHeaderVariants = cva(
+  [
+    'flex-row items-center justify-between gap-2 border-b border-solid px-4 py-3',
+    'border-stroke-secondary',
+  ],
+  {
+    variants: {
+      showDivider: {
+        true: ['border-t-4 border-solid border-t-surface-brand-strong/40', 'border-x-0'],
+        false: 'border-t-0',
+      },
+    },
+    defaultVariants: {
+      showDivider: true,
+    },
+  },
+);
+
+/** Default section-title typography; applied by `ListItem.SectionHeader` for string/number children. Exported for rare custom composition. */
+export const listItemSectionHeaderLabelVariants = cva(
+  'text-xs font-semibold uppercase tracking-wide text-content-secondary',
+);
+
+export type ListItemVariantProps = VariantProps<typeof listItemRootVariants>;

package/src/components/ProgressSegmented/index.tsx

@@ -1,4 +1,4 @@
-import { forwardRef, useMemo } from 'react';
+import { forwardRef, useEffect, useMemo } from 'react';
 import { View, type ViewProps } from 'react-native';
 import { cn } from '@cdx-ui/utils';
 import {
@@ -7,15 +7,32 @@ import {
   type ProgressSegmentedVariants,
 } from './styles';
 
+/* `ProgressSegmentedProps.total` remains in the public API until the next major release. */
+/* eslint-disable @typescript-eslint/no-deprecated */
 export interface ProgressSegmentedProps extends ViewProps, ProgressSegmentedVariants {
   /** Current step (1-based index into the segment count) */
   readonly step: number;
-  /** Total number of segments */
+  /**
+   * Number of segments in the bar. Matches the Figma `segments` variant (2–6 in the design
+   * system file); the prop accepts any positive integer for backward compatibility.
+   */
+  readonly segments?: number;
+  /**
+   * @deprecated Use {@link ProgressSegmentedProps.segments} instead. This alias will be removed
+   * in a future major release.
+   */
   readonly total?: number;
   /** When true, the current step segment is marked as complete rather than in-progress */
   readonly isStepComplete?: boolean;
-  /** Returns the accessibility value text announced by screen readers. Receives the clamped step, total, and whether the step is complete. */
-  readonly getAccessibilityText?: (step: number, total: number, isStepComplete: boolean) => string;
+  /**
+   * Returns the accessibility value text announced by screen readers. Receives the clamped
+   * step, segment count, and whether the step is complete.
+   */
+  readonly getAccessibilityText?: (
+    step: number,
+    segmentCount: number,
+    isStepComplete: boolean,
+  ) => string;
   readonly className?: string;
 }
 
@@ -23,7 +40,8 @@ export const ProgressSegmented = forwardRef<View, ProgressSegmentedProps>(
   (
     {
       step,
-      total = 5,
+      segments,
+      total,
       isStepComplete = false,
       getAccessibilityText,
       className,
@@ -32,10 +50,25 @@ export const ProgressSegmented = forwardRef<View, ProgressSegmentedProps>(
     },
     ref,
   ) => {
-    const clampedStep = Math.max(0, Math.min(step, total));
+    const segmentCount = segments ?? total ?? 5;
 
-    const segments = useMemo(() => {
-      return Array.from({ length: total }, (_, index) => {
+    useEffect(() => {
+      if (
+        typeof process !== 'undefined' &&
+        process.env.NODE_ENV !== 'production' &&
+        total !== undefined &&
+        segments === undefined
+      ) {
+        console.warn(
+          '[ProgressSegmented] The `total` prop is deprecated and will be removed in a future major release. Use `segments` instead.',
+        );
+      }
+    }, [total, segments]);
+
+    const clampedStep = Math.max(0, Math.min(step, segmentCount));
+
+    const segmentStates = useMemo(() => {
+      return Array.from({ length: segmentCount }, (_, index) => {
         const segmentIndex = index + 1;
         let state: 'complete' | 'incomplete' | 'inprogress' = 'incomplete';
 
@@ -47,13 +80,13 @@ export const ProgressSegmented = forwardRef<View, ProgressSegmentedProps>(
 
         return state;
       });
-    }, [total, clampedStep, isStepComplete]);
+    }, [segmentCount, clampedStep, isStepComplete]);
 
-    let accessibilityText = `Step ${String(clampedStep)} of ${String(total)}`;
+    let accessibilityText = `Step ${String(clampedStep)} of ${String(segmentCount)}`;
     if (getAccessibilityText) {
-      accessibilityText = getAccessibilityText(clampedStep, total, isStepComplete);
+      accessibilityText = getAccessibilityText(clampedStep, segmentCount, isStepComplete);
     } else if (isStepComplete) {
-      accessibilityText = `Step ${String(clampedStep)} of ${String(total)}, completed`;
+      accessibilityText = `Step ${String(clampedStep)} of ${String(segmentCount)}, completed`;
     }
 
     return (
@@ -63,14 +96,14 @@ export const ProgressSegmented = forwardRef<View, ProgressSegmentedProps>(
         accessibilityLabel={accessibilityLabel}
         accessibilityValue={{
           min: 0,
-          max: total,
+          max: segmentCount,
           now: clampedStep,
           text: accessibilityText,
         }}
         className={cn(progressSegmentedVariants(), className)}
         {...props}
       >
-        {segments.map((state, index) => (
+        {segmentStates.map((state, index) => (
           <View key={index} className={cn(segmentVariants({ state }))} />
         ))}
       </View>
@@ -79,3 +112,5 @@ export const ProgressSegmented = forwardRef<View, ProgressSegmentedProps>(
 );
 
 ProgressSegmented.displayName = 'ProgressSegmented';
+
+/* eslint-enable @typescript-eslint/no-deprecated */

package/src/components/Radio/index.tsx

@@ -0,0 +1,192 @@
+import { forwardRef, type ReactNode } from 'react';
+import { Pressable, Text, type TextProps, View, type ViewProps } from 'react-native';
+import { createRadio, dataAttributes, type IRadioProps } from '@cdx-ui/primitives';
+import { cn } from '@cdx-ui/utils';
+import {
+  radioGroupVariants,
+  radioIndicatorVariants,
+  radioInnerDotVariants,
+  radioLabelVariants,
+  radioRootVariants,
+} from './styles';
+
+// =============================================================================
+// STYLED INDICATOR BASE
+// =============================================================================
+
+const RadioIndicatorBase = forwardRef<View, ViewProps & { className?: string }>(
+  ({ className, children, style, ...props }, ref) => {
+    // On web, data attributes arrive as `dataSet: { checked: true }`.
+    // On native, they arrive as individual `data-checked: "true"` props.
+    const ds = (props as any).dataSet;
+    const isChecked = ds ? ds.checked === true : (props as any)['data-checked'] === 'true';
+    const isInvalid = ds ? ds.invalid === true : (props as any)['data-invalid'] === 'true';
+    const isHovered = ds ? ds.hover === true : (props as any)['data-hover'] === 'true';
+
+    return (
+      <View ref={ref} className={cn(radioIndicatorVariants(), className)} style={style} {...props}>
+        <View
+          className={cn(radioInnerDotVariants())}
+          {...dataAttributes({ checked: isChecked, invalid: isInvalid, hover: isHovered })}
+        />
+        {children}
+      </View>
+    );
+  },
+);
+
+RadioIndicatorBase.displayName = 'Radio.IndicatorBase';
+
+// =============================================================================
+// PRIMITIVE ASSEMBLY
+// =============================================================================
+
+const RadioPrimitive = createRadio({
+  Root: Pressable,
+  Indicator: RadioIndicatorBase,
+  Label: Text,
+  Group: View,
+});
+
+// =============================================================================
+// RADIO ROOT
+// =============================================================================
+
+export interface RadioProps extends IRadioProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const RadioRoot = forwardRef<View, RadioProps>(({ className, children, style, ...props }, ref) => {
+  const computedClassName = cn(radioRootVariants(), className);
+
+  return (
+    <RadioPrimitive ref={ref as any} className={computedClassName} style={style} {...props}>
+      {children}
+    </RadioPrimitive>
+  );
+});
+
+RadioRoot.displayName = 'Radio';
+
+// =============================================================================
+// RADIO INDICATOR
+// =============================================================================
+
+export interface RadioIndicatorProps extends ViewProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const RadioIndicator = forwardRef<View, RadioIndicatorProps>(
+  ({ className, children, style, ...props }, ref) => {
+    return (
+      <RadioPrimitive.Indicator ref={ref as any} className={className} style={style} {...props}>
+        {children}
+      </RadioPrimitive.Indicator>
+    );
+  },
+);
+
+RadioIndicator.displayName = 'Radio.Indicator';
+
+// =============================================================================
+// RADIO LABEL
+// =============================================================================
+
+export interface RadioLabelProps extends TextProps {
+  className?: string;
+  children?: ReactNode;
+}
+
+const RadioLabel = forwardRef<Text, RadioLabelProps>(
+  ({ className, children, style, ...props }, ref) => {
+    const computedClassName = cn(radioLabelVariants(), className);
+
+    return (
+      <RadioPrimitive.Label ref={ref as any} className={computedClassName} style={style} {...props}>
+        {children}
+      </RadioPrimitive.Label>
+    );
+  },
+);
+
+RadioLabel.displayName = 'Radio.Label';
+
+// =============================================================================
+// RADIO GROUP
+// =============================================================================
+
+export interface RadioGroupProps extends ViewProps {
+  className?: string;
+  children?: ReactNode;
+  value?: string;
+  defaultValue?: string;
+  onChange?: (value: string) => void;
+  isDisabled?: boolean;
+  isInvalid?: boolean;
+  isRequired?: boolean;
+  isReadOnly?: boolean;
+  direction?: 'column' | 'row';
+  name?: string;
+}
+
+const RadioGroup = forwardRef<View, RadioGroupProps>(
+  (
+    {
+      className,
+      children,
+      style,
+      direction = 'column',
+      value,
+      defaultValue,
+      onChange,
+      isDisabled,
+      isInvalid,
+      isRequired,
+      isReadOnly,
+      name,
+      ...viewProps
+    },
+    ref,
+  ) => {
+    const computedClassName = cn(radioGroupVariants({ direction }), className);
+
+    return (
+      <RadioPrimitive.Group
+        ref={ref as any}
+        className={computedClassName}
+        style={style}
+        value={value}
+        defaultValue={defaultValue}
+        onChange={onChange}
+        isDisabled={isDisabled}
+        isInvalid={isInvalid}
+        isRequired={isRequired}
+        isReadOnly={isReadOnly}
+        name={name}
+        {...viewProps}
+      >
+        {children}
+      </RadioPrimitive.Group>
+    );
+  },
+);
+
+RadioGroup.displayName = 'Radio.Group';
+
+// =============================================================================
+// COMPOUND COMPONENT
+// =============================================================================
+
+type RadioCompoundComponent = typeof RadioRoot & {
+  Indicator: typeof RadioIndicator;
+  Label: typeof RadioLabel;
+  Group: typeof RadioGroup;
+};
+
+export const Radio = Object.assign(RadioRoot, {
+  Indicator: RadioIndicator,
+  Label: RadioLabel,
+  Group: RadioGroup,
+}) as RadioCompoundComponent;

package/src/components/Radio/styles.ts

@@ -0,0 +1,59 @@
+import { Platform } from 'react-native';
+import { cva } from 'class-variance-authority';
+import { DISABLED_CURSOR, TRANSITION_COLORS } from '../../styles/primitives';
+
+export const radioRootVariants = cva([
+  'flex-row items-center gap-2',
+  'data-[disabled=true]:opacity-[var(--opacity-disabled)]',
+  DISABLED_CURSOR,
+]);
+
+export const radioIndicatorVariants = cva([
+  'items-center justify-center',
+  'rounded-[var(--border-radius-round)]',
+  'border-2',
+  'h-5 w-5',
+  'bg-surface-primary',
+  'data-[checked=false]:border-content-secondary',
+  'data-[checked=true]:border-stroke-action',
+  'data-[invalid=true]:border-stroke-danger',
+  'data-[checked=true]:data-[invalid=true]:border-stroke-danger',
+  Platform.select({
+    web: [
+      TRANSITION_COLORS,
+      'data-[hover=true]:data-[checked=true]:border-surface-action-strong-hover',
+      'data-[hover=true]:data-[invalid=true]:border-surface-danger-strong-hover',
+      'web:data-[focus-visible=true]:outline-none',
+      'web:data-[focus-visible=true]:ring-2 web:data-[focus-visible=true]:ring-[var(--color-stroke-ring)] web:data-[focus-visible=true]:ring-offset-2',
+    ].join(' '),
+    default: '',
+  }),
+]);
+
+export const radioInnerDotVariants = cva([
+  'rounded-[var(--border-radius-round)]',
+  'h-2.5 w-2.5',
+  'scale-0',
+  'data-[checked=true]:scale-100',
+  'bg-surface-action-strong',
+  'data-[invalid=true]:bg-surface-danger-strong',
+  Platform.select({
+    web: [
+      'data-[hover=true]:bg-surface-action-strong-hover',
+      'data-[hover=true]:data-[invalid=true]:bg-surface-danger-strong-hover',
+    ].join(' '),
+    default: '',
+  }),
+]);
+
+export const radioLabelVariants = cva(['body-md', 'text-content-primary']);
+
+export const radioGroupVariants = cva([], {
+  variants: {
+    direction: {
+      column: 'gap-2',
+      row: 'flex-row gap-4',
+    },
+  },
+  defaultVariants: { direction: 'column' },
+});

package/src/components/Text/styles.ts

@@ -3,9 +3,9 @@ import { cva, type VariantProps } from 'class-variance-authority';
 
 export const textStyle = cva(
   [
-    `text-content-primary font-normal`,
+    'text-content-primary',
     Platform.select({
-      web: 'font-sans my-0 bg-transparent display-inline no-underline',
+      web: 'font-body my-0 bg-transparent no-underline',
       default: '',
     }),
   ],