import { ComponentPropsWithoutRef } from 'react';
import { LayoutUtilProps, Size } from '../../types';
/** Size option for list typography */
export type ListSize = Extract<Size, "small" | "medium" | "large">;
/**
 * Props for unordered list variant
 * @extends ComponentPropsWithoutRef<"ul">
 * @extends LayoutUtilProps
 */
export type UnorderedListProps = ComponentPropsWithoutRef<"ul"> & LayoutUtilProps & {
    /** Renders as unordered list (ul). Default. */
    variant?: "unordered";
    /** Typography size for list content. @default "medium" */
    size?: ListSize;
};
/**
 * Props for ordered list variant
 * @extends ComponentPropsWithoutRef<"ol">
 * @extends LayoutUtilProps
 */
export type OrderedListProps = ComponentPropsWithoutRef<"ol"> & LayoutUtilProps & {
    /** Renders as ordered list (ol). */
    variant: "ordered";
    /** Typography size for list content. @default "medium" */
    size?: ListSize;
};
/**
 * Props for the List component
 * @extends UnorderedListProps
 * @extends OrderedListProps
 */
export type ListProps = UnorderedListProps | OrderedListProps;
/**
 * List component for displaying ordered or unordered lists with design system styling.
 *
 * Features:
 * - Supports unordered (ul) and ordered (ol) lists via variant prop
 * - Typography size options aligned with design tokens
 * - Semantic HTML and accessible list structure
 * - Supports nested lists
 * - Layout utilities for positioning and spacing
 *
 * @example
 * <List>
 *   <List.Item>First item</List.Item>
 *   <List.Item>Second item</List.Item>
 * </List>
 *
 * @example
 * <List variant="ordered" start={1}>
 *   <List.Item>Step one</List.Item>
 *   <List.Item>Step two</List.Item>
 * </List>
 */
export declare const List: import('react').ForwardRefExoticComponent<ListProps & import('react').RefAttributes<HTMLOListElement | HTMLUListElement>> & {
    /**
     * ListItem component for individual items within a List.
     *
     * Features:
     * - Renders as a semantic list item (li)
     * - Supports layout and styling via standard HTML attributes
     *
     * @example
     * <List.Item>Item content</List.Item>
     */
    Item: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>, "ref"> & import('react').RefAttributes<HTMLLIElement>>;
};
