import { TypographyProps } from '../ui/typography';
import * as React from 'react';
type ListSize = 'S' | 'M';
type ListProps = React.HTMLAttributes<HTMLDivElement> & {
    size?: ListSize;
};
declare const List: {
    ({ children, size, className, ref, ...props }: ListProps & {
        ref?: React.Ref<HTMLDivElement>;
    }): React.JSX.Element;
    displayName: string;
};
type ListMainTextProps = TypographyProps & {
    size?: ListSize;
};
declare function ListMainText({ size, children, className, ...props }: ListMainTextProps): React.JSX.Element;
type ListSubTextProps = TypographyProps & {
    size?: ListSize;
};
declare function ListSubText({ size, children, className, ...props }: ListSubTextProps): React.JSX.Element;
type ListCaptionProps = TypographyProps & {
    size?: ListSize;
};
declare function ListCaption({ size, children, className, ...props }: ListCaptionProps): React.JSX.Element;
type ListItemBaseProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> & {
    /** 행 사이즈. 내부 타이포그래피 토큰과 세로 패딩을 결정합니다. */
    size?: ListSize;
    /** 왼쪽 leading 영역 (썸네일/아이콘 등). */
    leading?: React.ReactNode;
    /** 왼쪽 텍스트. variant에 따라 메인/서브 스타일로 렌더링됩니다. */
    title: React.ReactNode;
    /** 오른쪽 Right Area. 텍스트/아이콘/태그/미니버튼/컨트롤 또는 그 조합을 둡니다. */
    trailing?: React.ReactNode;
    /**
     * trailing에 id를 받는 폼 컨트롤(Switch/Checkbox 등)을 둘 경우 그 컨트롤의 id를 전달하면,
     * title이 `<label htmlFor>`로 연결되어 텍스트 클릭으로도 컨트롤을 조작할 수 있고 스크린리더가 라벨을 인식합니다.
     */
    controlId?: string;
    ref?: React.Ref<HTMLDivElement>;
};
/**
 * 왼쪽 텍스트는 메인('main')과 서브('sub')가 상호 배타적인 "타입"입니다(둘은 동시에 올 수 없음).
 * 캡션은 메인 타입에만 위/아래로 붙습니다(Figma Left=Caption 구조).
 */
type ListItemProps = ListItemBaseProps & ({
    /** 메인 텍스트 타입(기본). 강조 텍스트 + 선택적 캡션. */
    variant?: 'main';
    /** 캡션 텍스트. 메인 타입에서만 사용합니다. */
    caption?: React.ReactNode;
    /** 캡션 위치. 기본값 'down'. */
    captionPosition?: 'up' | 'down';
} | {
    /** 서브 텍스트 타입. 보조(회색) 단일 텍스트이며 캡션을 가질 수 없습니다. */
    variant: 'sub';
    caption?: never;
    captionPosition?: never;
});
declare function ListItem({ size, variant, leading, title, caption, captionPosition, trailing, controlId, className, ref, ...props }: ListItemProps): React.JSX.Element;
declare namespace ListItem {
    var displayName: string;
}
export type { ListCaptionProps, ListItemProps, ListProps };
export { List, ListCaption, ListItem, ListMainText, ListSubText };
//# sourceMappingURL=index.d.ts.map