@cdx-ui/components 0.0.1-beta.3 → 0.0.1-beta.31

package/src/components/ListItem/index.tsx

@@ -0,0 +1,285 @@
+import { forwardRef, type ReactNode } from 'react';
+import { Pressable, Text, View, type TextProps, type ViewProps } from 'react-native';
+import {
+  createListItem,
+  type IListItemLeadingSlotProps,
+  type IListItemProps,
+  type IListItemSectionHeaderProps,
+  type ListItemCrossAlign,
+} from '@cdx-ui/primitives';
+import { cn, useStyleContext, withStyleContext, type WithStyleContextProps } from '@cdx-ui/utils';
+import {
+  listItemContentVariants,
+  listItemDescriptionVariants,
+  listItemLeadingSlotVariants,
+  listItemMetaVariants,
+  listItemRootVariants,
+  listItemSectionHeaderLabelVariants,
+  listItemSectionHeaderVariants,
+  listItemTitleVariants,
+  listItemTrailingSlotVariants,
+  type ListItemVariantProps,
+} from './styles';
+
+const SCOPE = 'LIST_ITEM';
+
+const RootView = withStyleContext(View, SCOPE);
+const RootPressable = withStyleContext(Pressable, SCOPE);
+
+const ListItemPrimitive = createListItem({
+  View: RootView,
+  Pressable: RootPressable,
+  LeadingSlot: View,
+  Content: View,
+  Title: Text,
+  Description: Text,
+  Meta: Text,
+  TrailingSlot: View,
+  SectionHeader: View,
+});
+
+const useListItemStyleContext = (): Pick<ListItemVariantProps, 'size' | 'crossAlign'> => {
+  const ctx = useStyleContext(SCOPE) as ListItemVariantProps | undefined;
+  return { size: ctx?.size ?? 'default', crossAlign: ctx?.crossAlign ?? 'center' };
+};
+
+// =============================================================================
+// ROOT
+// =============================================================================
+
+export interface ListItemProps extends IListItemProps, WithStyleContextProps {
+  className?: string;
+}
+
+const ListItemRoot = forwardRef<View, ListItemProps>(
+  (
+    {
+      size = 'default',
+      surface = 'default',
+      showSeparator = true,
+      crossAlign = 'center',
+      className,
+      style,
+      ...props
+    },
+    ref,
+  ) => {
+    const computedClassName = cn(
+      listItemRootVariants({ size, surface, showSeparator, crossAlign }),
+      className,
+    );
+
+    return (
+      <ListItemPrimitive
+        ref={ref as never}
+        className={computedClassName}
+        context={{ size, surface, showSeparator, crossAlign }}
+        crossAlign={crossAlign}
+        showSeparator={showSeparator}
+        size={size}
+        style={style}
+        surface={surface}
+        {...props}
+      />
+    );
+  },
+);
+
+ListItemRoot.displayName = 'ListItem';
+
+// =============================================================================
+// SLOTS & TEXT
+// =============================================================================
+
+export interface ListItemLeadingSlotProps extends IListItemLeadingSlotProps {
+  className?: string;
+}
+
+const ListItemLeadingSlot = forwardRef<View, ListItemLeadingSlotProps>(
+  ({ className, style, ...props }, ref) => (
+    <ListItemPrimitive.LeadingSlot
+      ref={ref as never}
+      className={cn(listItemLeadingSlotVariants(), className)}
+      style={style}
+      {...props}
+    />
+  ),
+);
+
+ListItemLeadingSlot.displayName = 'ListItem.LeadingSlot';
+
+export interface ListItemContentProps extends ViewProps {
+  className?: string;
+}
+
+const ListItemContent = forwardRef<View, ListItemContentProps>(
+  ({ className, style, ...props }, ref) => {
+    const { crossAlign } = useListItemStyleContext();
+
+    return (
+      <ListItemPrimitive.Content
+        ref={ref as never}
+        className={cn(listItemContentVariants({ crossAlign }), className)}
+        style={style}
+        {...props}
+      />
+    );
+  },
+);
+
+ListItemContent.displayName = 'ListItem.Content';
+
+export interface ListItemTitleProps extends TextProps {
+  className?: string;
+}
+
+const ListItemTitle = forwardRef<Text, ListItemTitleProps>(
+  ({ className, numberOfLines = 1, style, ...props }, ref) => {
+    const { size } = useListItemStyleContext();
+
+    return (
+      <ListItemPrimitive.Title
+        ref={ref as never}
+        className={cn(listItemTitleVariants({ size }), className)}
+        numberOfLines={numberOfLines}
+        style={style}
+        {...props}
+      />
+    );
+  },
+);
+
+ListItemTitle.displayName = 'ListItem.Title';
+
+export interface ListItemDescriptionProps extends TextProps {
+  className?: string;
+}
+
+const ListItemDescription = forwardRef<Text, ListItemDescriptionProps>(
+  ({ className, style, ...props }, ref) => {
+    const { size } = useListItemStyleContext();
+
+    return (
+      <ListItemPrimitive.Description
+        ref={ref as never}
+        className={cn(listItemDescriptionVariants({ size }), className)}
+        style={style}
+        {...props}
+      />
+    );
+  },
+);
+
+ListItemDescription.displayName = 'ListItem.Description';
+
+export interface ListItemMetaProps extends TextProps {
+  className?: string;
+}
+
+const ListItemMeta = forwardRef<Text, ListItemMetaProps>(
+  ({ className, numberOfLines = 1, style, ...props }, ref) => {
+    const { size } = useListItemStyleContext();
+
+    return (
+      <ListItemPrimitive.Meta
+        ref={ref as never}
+        className={cn(listItemMetaVariants({ size }), className)}
+        numberOfLines={numberOfLines}
+        style={style}
+        {...props}
+      />
+    );
+  },
+);
+
+ListItemMeta.displayName = 'ListItem.Meta';
+
+export interface ListItemTrailingSlotProps extends ViewProps {
+  className?: string;
+}
+
+const ListItemTrailingSlot = forwardRef<View, ListItemTrailingSlotProps>(
+  ({ className, style, ...props }, ref) => {
+    const { crossAlign } = useListItemStyleContext();
+
+    return (
+      <ListItemPrimitive.TrailingSlot
+        ref={ref as never}
+        className={cn(listItemTrailingSlotVariants({ crossAlign }), className)}
+        style={style}
+        {...props}
+      />
+    );
+  },
+);
+
+ListItemTrailingSlot.displayName = 'ListItem.TrailingSlot';
+
+const wrapSectionHeaderLabel = (children: ReactNode): ReactNode => {
+  if (typeof children === 'string' || typeof children === 'number') {
+    return <Text className={cn(listItemSectionHeaderLabelVariants())}>{children}</Text>;
+  }
+  return children;
+};
+
+// =============================================================================
+// SECTION HEADER
+// =============================================================================
+
+export interface ListItemSectionHeaderComponentProps extends IListItemSectionHeaderProps {
+  className?: string;
+}
+
+const ListItemSectionHeader = forwardRef<View, ListItemSectionHeaderComponentProps>(
+  ({ children, className, showDivider = true, style, trailing, ...props }, ref) => (
+    <ListItemPrimitive.SectionHeader
+      ref={ref as never}
+      className={cn(listItemSectionHeaderVariants({ showDivider }), className)}
+      showDivider={showDivider}
+      style={style}
+      trailing={trailing}
+      {...props}
+    >
+      {wrapSectionHeaderLabel(children)}
+    </ListItemPrimitive.SectionHeader>
+  ),
+);
+
+ListItemSectionHeader.displayName = 'ListItem.SectionHeader';
+
+// =============================================================================
+// COMPOUND EXPORT
+// =============================================================================
+
+type ListItemCompound = typeof ListItemRoot & {
+  LeadingSlot: typeof ListItemLeadingSlot;
+  Content: typeof ListItemContent;
+  Title: typeof ListItemTitle;
+  Description: typeof ListItemDescription;
+  Meta: typeof ListItemMeta;
+  TrailingSlot: typeof ListItemTrailingSlot;
+  SectionHeader: typeof ListItemSectionHeader;
+};
+
+export const ListItem = Object.assign(ListItemRoot, {
+  LeadingSlot: ListItemLeadingSlot,
+  Content: ListItemContent,
+  Title: ListItemTitle,
+  Description: ListItemDescription,
+  Meta: ListItemMeta,
+  TrailingSlot: ListItemTrailingSlot,
+  SectionHeader: ListItemSectionHeader,
+}) as ListItemCompound;
+
+export type { ListItemCrossAlign, ListItemVariantProps };
+export {
+  listItemContentVariants,
+  listItemDescriptionVariants,
+  listItemLeadingSlotVariants,
+  listItemMetaVariants,
+  listItemRootVariants,
+  listItemSectionHeaderLabelVariants,
+  listItemSectionHeaderVariants,
+  listItemTitleVariants,
+  listItemTrailingSlotVariants,
+} from './styles';

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 */