# Card: API

## Пропсы корня

| Проп | Тип | По умолчанию | Обязательный | Описание |
| --- | --- | --- | --- | --- |
| `size` | `CardSize` | `'md'` | Нет | Задаёт размер карточки. Влияет на отступы, размер шрифта и, возможно, поведение раскладки. |
| `appearance` | `CardAppearance` | `'outline'` | Нет | Определяет визуальный стиль поверхности карточки. Управляет видимостью фона и рамки. |
| `ref` | `Ref<HTMLElement>` | — | Нет | Ref, передаваемый на корневой элемент карточки (`<article>` или дочерний элемент при `asChild`). Полезен для измерений DOM, прокрутки или императивной логики. |
| `asChild` | `boolean` | — | Нет | Если true, рендерит триггер как дочерний элемент через `Slot`. Это позволяет собственным обёрткам (например, `<a>`, `<div>`) наследовать поведение. |

Также принимает все HTML-атрибуты.

## Дочерние части

`Card` не предоставляет публичных дочерних частей.

## Типы

- `CardProps`
- `CardSize`
- `CardAppearance`

## Модель состояния

- С точки зрения API компонента `Card` не имеет состояния.
- Большую часть семантического смысла внутри поверхности определяют содержимое и раскладка потребителя.