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

package/lib/typescript/figma/Radio.figma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Radio.figma.d.ts","sourceRoot":"","sources":["../../../src/figma/Radio.figma.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;;;;;;AAsB1B,wBAOE"}

package/lib/typescript/styles/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/styles/primitives.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAG/C,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAGrD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AACjD,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAC/C,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AACvD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAGjD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAGjD,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AACnD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAItD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyClB,CAAC;AAGX,eAAO,MAAM,UAAU,2CAA2C,CAAC;AAGnE,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAG1C,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,SAAS,cAAc,CAAC;AAMrC,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAGb,CAAC;AAGX,eAAO,MAAM,iBAAiB,mCAAmC,CAAC;AAGlE,eAAO,MAAM,gBAAgB,oCAAoC,CAAC;AAClE,eAAO,MAAM,eAAe,qFACwD,CAAC"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/styles/primitives.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAG/C,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AACtD,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AACrD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAGrD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AACjD,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAC/C,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AACvD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAGjD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAGjD,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AACnD,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAItD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyClB,CAAC;AAGX,eAAO,MAAM,UAAU,2CAA2C,CAAC;AAGnE,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAG1C,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,SAAS,cAAc,CAAC;AAMrC,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAGb,CAAC;AAGX,eAAO,MAAM,iBAAiB,mCAAmC,CAAC;AAGlE,eAAO,MAAM,gBAAgB,oCAAoC,CAAC;AAClE,eAAO,MAAM,eAAe,qFACwD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/components",
-  "version": "0.0.1-beta.1",
+  "version": "0.0.1-beta.11",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "react-native": "src/index.ts",
@@ -24,7 +24,8 @@
   },
   "files": [
     "lib",
-    "src"
+    "src",
+    "!src/figma"
   ],
   "react-native-builder-bob": {
     "source": "src",
@@ -66,9 +67,9 @@
     "@gorhom/bottom-sheet": "^5.2.6",
     "class-variance-authority": "^0.7.1",
     "uniwind": "1.6.1",
-    "@cdx-ui/primitives": "0.0.1-beta.1",
-    "@cdx-ui/icons": "0.0.1-beta.1",
-    "@cdx-ui/utils": "0.0.1-beta.1"
+    "@cdx-ui/primitives": "0.0.1-beta.11",
+    "@cdx-ui/utils": "0.0.1-beta.11",
+    "@cdx-ui/icons": "0.0.1-beta.11"
   },
   "devDependencies": {
     "@types/react": "*",

package/src/components/Button/styles.ts

@@ -10,7 +10,7 @@ export const buttonRootVariants = cva(
     'rounded-[var(--border-radius-button)]',
     'web:outline-none web:focus:outline-none web:focus-visible:outline-none',
     TRANSITION_COLORS,
-    'data-[disabled=true]:opacity-[--opacity-disabled]',
+    'data-[disabled=true]:opacity-[var(--opacity-disabled)]',
     DISABLED_CURSOR,
     'web:data-[focus-visible=true]:ring-2 web:data-[focus-visible=true]:ring-[--color-stroke-focus] web:data-[focus-visible=true]:ring-offset-2',
   ],

package/src/components/Card/index.tsx

@@ -1,31 +1,47 @@
 import { forwardRef, type ReactNode } from 'react';
 import { View, type ViewProps } from 'react-native';
-import { cn } from '@cdx-ui/utils';
+import { cn, useStyleContext, withStyleContext } from '@cdx-ui/utils';
 import {
   cardContentVariants,
   cardFooterVariants,
   cardHeaderVariants,
   cardRootVariants,
+  type CardVariantProps,
+  type CardContentVariantProps,
 } from './styles';
 
 // =============================================================================
 // STYLED ROOT COMPONENT
 // =============================================================================
 
-export interface CardProps extends ViewProps {
+const SCOPE = 'CARD';
+
+const Root = withStyleContext(View, SCOPE);
+
+const useCardStyleContext = () => useStyleContext(SCOPE) as CardVariantProps;
+
+export interface CardProps extends ViewProps, CardVariantProps {
   className?: string;
   children?: ReactNode;
 }
 
-const CardRoot = forwardRef<View, CardProps>(({ className, children, style, ...props }, ref) => {
-  const computedClassName = cn(cardRootVariants(), className);
+const CardRoot = forwardRef<View, CardProps>(
+  ({ className, children, style, fullBleed, ...props }, ref) => {
+    const computedClassName = cn(cardRootVariants(), className);
 
-  return (
-    <View ref={ref} className={computedClassName} style={style} {...props}>
-      {children}
-    </View>
-  );
-});
+    return (
+      <Root
+        ref={ref}
+        className={computedClassName}
+        style={style}
+        context={{ fullBleed }}
+        {...props}
+      >
+        {children}
+      </Root>
+    );
+  },
+);
 
 CardRoot.displayName = 'Card';
 
@@ -56,14 +72,18 @@ CardHeader.displayName = 'Card.Header';
 // STYLED CONTENT COMPONENT
 // =============================================================================
 
-export interface CardContentProps extends ViewProps {
+export interface CardContentProps extends ViewProps, CardContentVariantProps {
   className?: string;
   children?: ReactNode;
 }
 
 const CardContent = forwardRef<View, CardContentProps>(
-  ({ className, children, style, ...props }, ref) => {
-    const computedClassName = cn(cardContentVariants(), className);
+  ({ className, children, style, fullBleed, ...props }, ref) => {
+    const { fullBleed: fullBleedFromContext } = useCardStyleContext();
+    const computedClassName = cn(
+      cardContentVariants({ fullBleed: fullBleed ?? fullBleedFromContext }),
+      className,
+    );
 
     return (
       <View ref={ref} className={computedClassName} style={style} {...props}>

package/src/components/Card/styles.ts

@@ -1,27 +1,30 @@
-import { cva } from 'class-variance-authority';
-import {
-  COLOR_BG_PRIMARY,
-  COLOR_BORDER_DEFAULT,
-  COLOR_TEXT_PRIMARY,
-  RADIUS_SM,
-  SHADOW_SM,
-} from '../../styles/primitives';
+import { cva, VariantProps } from 'class-variance-authority';
 
 // ── Root ────────────────────────────────────────────────────
 
-export const cardRootVariants = cva([
-  COLOR_BG_PRIMARY,
-  `border ${COLOR_BORDER_DEFAULT}`,
-  RADIUS_SM,
-  SHADOW_SM,
-  'overflow-hidden',
-]);
+export const cardRootVariants = cva(
+  [
+    'bg-surface-primary',
+    'border border-stroke-secondary',
+    'rounded-[var(--border-radius-default)]',
+    'overflow-hidden',
+  ],
+  {
+    variants: {
+      fullBleed: {
+        true: '',
+        false: '',
+      },
+    },
+  },
+);
 
 // ── Header ──────────────────────────────────────────────────
 
 export const cardHeaderVariants = cva([
-  'flex-row items-center justify-between p-4 border-b border-t-8',
-  COLOR_BORDER_DEFAULT,
+  'flex-row items-center justify-between px-5 py-3',
+  'border-t-8 border-t-surface-brand-strong',
+  'border-b border-b-solid border-b-stroke-secondary',
 ]);
 
 // ── Title ───────────────────────────────────────────────────
@@ -30,12 +33,17 @@ export const cardTitleVariants = cva(['flex-1']);
 
 // ── Content ─────────────────────────────────────────────────
 
-export const cardContentVariants = cva([COLOR_TEXT_PRIMARY, 'p-4']);
+export const cardContentVariants = cva(['text-content-primary', 'p-5'], {
+  variants: {
+    fullBleed: {
+      true: 'p-0',
+    },
+  },
+});
 
 // ── Footer ──────────────────────────────────────────────────
 
-export const cardFooterVariants = cva([
-  'p-4 border-t',
-  COLOR_BORDER_DEFAULT,
-  'flex-row items-center gap-2',
-]);
+export const cardFooterVariants = cva(['p-5 pt-0', 'flex-row items-center gap-2']);
+
+export type CardVariantProps = VariantProps<typeof cardRootVariants>;
+export type CardContentVariantProps = VariantProps<typeof cardContentVariants>;

package/src/components/IconButton/styles.ts

@@ -8,7 +8,7 @@ export const iconButtonRootVariants = cva(
     'rounded-[var(--border-radius-round)]',
     'web:outline-none web:focus:outline-none web:focus-visible:outline-none',
     TRANSITION_COLORS,
-    'data-[disabled=true]:opacity-[--opacity-disabled]',
+    'data-[disabled=true]:opacity-[var(--opacity-disabled)]',
     DISABLED_CURSOR,
     'web:data-[focus-visible=true]:ring-2 web:data-[focus-visible=true]:ring-[--color-stroke-ring] web:data-[focus-visible=true]:ring-offset-2',
   ],

package/src/components/Input/styles.ts

@@ -9,7 +9,7 @@ export const inputRootVariants = cva(
     'rounded-[var(--border-radius-default)]',
     TRANSITION_COLORS,
     'data-[disabled=true]:bg-surface-secondary',
-    'data-[disabled=true]:opacity-[--opacity-disabled]',
+    'data-[disabled=true]:opacity-[var(--opacity-disabled)]',
     DISABLED_CURSOR,
     'data-[readonly=true]:cursor-default',
     'data-[readonly=true]:bg-surface-secondary',

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,160 @@
+import { Platform } from 'react-native';
+import { cva, type VariantProps } from 'class-variance-authority';
+import {
+  COLOR_BORDER_DEFAULT,
+  COLOR_TEXT_MUTED,
+  COLOR_TEXT_PRIMARY,
+  COLOR_TEXT_SECONDARY,
+  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-[hovered=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', COLOR_BORDER_DEFAULT],
+        false: 'border-b-0',
+      },
+      crossAlign: {
+        center: 'items-center',
+        start: 'items-start',
+      },
+    },
+    compoundVariants: [
+      {
+        surface: 'negative',
+        className: Platform.select({
+          web: 'web:data-[hovered=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([COLOR_TEXT_PRIMARY, 'font-medium'], {
+  variants: {
+    size: {
+      default: 'text-base leading-snug',
+      compact: 'text-sm leading-snug',
+    },
+  },
+  defaultVariants: {
+    size: 'default',
+  },
+});
+
+export const listItemDescriptionVariants = cva([COLOR_TEXT_SECONDARY], {
+  variants: {
+    size: {
+      default: 'text-sm leading-normal',
+      compact: 'text-xs leading-normal',
+    },
+  },
+  defaultVariants: {
+    size: 'default',
+  },
+});
+
+export const listItemMetaVariants = cva([COLOR_TEXT_MUTED], {
+  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',
+    COLOR_BORDER_DEFAULT,
+  ],
+  {
+    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',
+  COLOR_TEXT_SECONDARY,
+]);
+
+export type ListItemVariantProps = VariantProps<typeof listItemRootVariants>;