altum 0.0.2 → 0.0.3

package/docs/COMPONENTS.md

@@ -2,7 +2,7 @@
 
 Краткий справочник публичного API. Установка и точки входа — [README](../README.md). Токены — [THEMING.md](./THEMING.md). Раскладка — [LAYOUT.md](./LAYOUT.md). Иконки — [ICONS.md](./ICONS.md).
 
-**Button / Link `asChild`:** единственный потомок получает стили и обработчики через Slot.
+**Link:** единственный элемент-потомок получает стили через Slot (роутерный `Link`). Смена HTML-тега у кнопок — `as` (`button` | `a`). **`Dropdown`** / **`Popover`**: якорь — `renderTrigger(props, ref)`; **`Tooltip`**: элемент-child или render-prop. Без пропа `asChild`.
 
 Оверлеи: кнопки — в `Modal.Footer` / `Modal.FormFooter` / `Sheet.Footer`, sibling к `Body`, не внутри скролла.
 
@@ -14,12 +14,11 @@
 |-----------|----------|
 | **Button** | Кнопка: `variant` (`primary` / `tinted` / `secondary` / `ghost` / `link`) × `status` (`default` / `danger`), иконки, `loading`, `fullWidth`, `shortcut`. |
 | **ButtonIcon** | Иконка-кнопка; `circle` / `square`; по умолчанию `variant="ghost"`. |
-| **ButtonGroup** | Составная группа (`ButtonGroup` + `ButtonGroup.Item`): высота = `--altum-control-height-*`; `width` `auto` \| `full` (full — колонка формы); `variant` / `status` / `size` / `borderless` на Root; переключение через `active` на Item; циклический клавиатурный фокус. |
-| **SegmentedControl** | Переключатель сегментов (на **SelectionGroup**): `itemFit` `equal` \| `content`; варианты `primary` / `tinted` / `secondary` (по умолчанию) / `ghost` / `plain`. |
-| **SelectionGroup** | Составной (`Root` / `List` / `Item` / `Panel`): взаимоисключающий выбор + циклический клавиатурный фокус; `value` / `onChange`. База для SegmentedControl и Tabs. |
-| **Overflow** | Лишние пункты за ⋯ в `Dropdown`. Дети `Overflow.Item` — панель действий (`visibleCount`, `display`); произвольные дети — измерение ширины (`fit`, `maxVisible`, `gap`). |
-| **ActionList** | Список действий: `items` / `groups` (`groupId`), `filterable` (**`TextField`** + `IconSearch`), `onAction`; клавиатура на **Listbox**. |
-| **ActionSheetTrigger** | Долгое нажатие → Overflow; `showOverflowTrigger` (по умолчанию `false`) — на touch+mobile ⋯ скрыт; пульс при срабатывании. |
+| **ButtonGroup** | Составная группа (`ButtonGroup` + `ButtonGroup.Item`): `mode` `button` (независимые, выбранность через `active` на Item) / `toggle` (один выбранный, слайдер) / `multi_toggle` (несколько); `itemFit` `equal` \| `content`; `width` `auto` \| `full`; `variant` / `status` / `size` / `borderless` на Root. |
+| **SegmentedControl** | Обёртка над `ButtonGroup` (`mode="toggle"`, `width="full"`): `options` + `value` / `onChange`; `itemFit` `equal` \| `content`; варианты `primary` / `tinted` / `secondary` (по умолчанию) / `ghost` / `plain`. |
+| **Overflow** | Лишние пункты за ⋯ в `Dropdown`. `Overflow.Item` — панель действий; прочие дети — измерение ширины. `longPress` открывает меню долгим нажатием (хост — **`ActionSheetTrigger`**). |
+| **ActionList** | Список действий: `items` / `groups` (`groupId`), `filterable`, `onAction`. |
+| **ActionSheetTrigger** | Хост long-press → `Overflow` на тач-экранах; опциональная кнопка ⋯ на десктопе (`showOverflowTrigger`). |
 
 ---
 
@@ -27,8 +26,7 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **FieldBase** | Составная оболочка полей: `Root` / `Label` / `Prefix` / `Control` / `Postfix` / `Button` / `Icon` / `Clear` / `Helper` / `Error`. `Clear` рендерится внутри `Postfix`. `width` `md` (до 320px, по умолчанию) \| `full`. |
-| **TextField** | Однострочное поле на **FieldBase**. `keepPlaceholder` — не скрывать placeholder при фокусе пустого поля. |
+| **TextField** | Однострочное поле. `keepPlaceholder` — не скрывать placeholder при фокусе пустого поля. |
 | **PasswordField** | Пароль на базе TextField: показать/скрыть, опциональный индикатор сложности. |
 | **SearchField** | Обёртка над `TextField` с `labelPlacement="none"` по умолчанию и иконкой поиска (`onClear` от TextField). |
 | **TextareaField** | Многострочное поле на **FieldBase**; авто-рост высоты. |
@@ -36,25 +34,23 @@
 | **MaskedField** | Поле с маской ввода (телефон, дата и т.п.) на базе `TextField`; опционально `maskAsPlaceholder`. Не переопределяйте `padding` / `font-size` на inner `input`. |
 | **PinInput** | PIN / OTP (2FA, код из SMS). |
 | **Rating** | Оценка звёздами. |
-| **FormMessage** / **FieldError** | Подсказка / ошибка / успех под полем; `variant`; `FieldError` = `variant="error"`. |
-| **Listbox** | Список опций с клавиатурой и группами; база для Select / CustomSelect / SuggestField / ActionList. |
-| **CustomSelect** | Составной примитив select/combobox (`Root` / `Filter` / `List` / `Shell`): Dropdown + Listbox; `Filter` — **`TextField`** + `IconSearch`; `groups` + `groupId`; `selectionMode`: `single` \| `multiple` \| `path`; `value` / `onChange`. |
-| **Select** | Один компонент на CustomSelect + FieldBase: `options`, `value` / `onChange`, `label`, `filterable`; `selectionMode="multiple"` рисует chips. Кастомный триггер — **CustomSelect**. |
+| **FormMessage** | Подсказка / ошибка / успех под полем; `variant` `hint` / `error` / `success`. |
+| **Select** | Поле выбора: `options`, `value` / `onChange`, `label`, `filterable`; `selectionMode="multiple"` рисует chips. |
 | **SuggestField** | Автодополнение на TextField; chrome от **`FieldBaseProps`** (`label`, `onClear`, `prefix`, …). |
-| **Checkbox** | `size`, `labelSide`, `indeterminate`, `mode` (`default` \| `task`), `align` (`start` \| `center`; для task по умолчанию `start`), `labelVisibility` (`visible` \| `hidden` + обязательный `aria-label` / `aria-labelledby`). |
-| **Switch** | `size`, `labelSide`. |
+| **Checkbox** | `size`, `labelSide`, `indeterminate`, `mode` (`default` \| `task`), `align`, `labelVisibility`, `onCheckedChange(checked)` (native `onChange` сохраняется). |
+| **Switch** | `size`, `labelSide`; `onChange(checked)` и алиас `onCheckedChange`. |
 | **CheckboxGroup** | Группа чекбоксов с управляемым `value: string[]`. |
-| **Radio** / **RadioGroup** | Радиокнопка и группа взаимоисключающих опций. |
+| **Radio** / **RadioGroup** | Радиокнопка и группа; `labelSide`, `onCheckedChange` на `Radio`. |
+| **SelectionGroup** | Без собственного chrome: составной `Root` / `List` / `Item` / `Panel` (roving focus). На нём собраны **Tabs** и **ColorSwatchGroup**. Внешний вид — через `className`. |
 | **Slider** | Ползунок: `value: number` или диапазон `value: [from, to]` (два thumb). |
-| **DatePicker** | Выбор даты: MaskedField + календарь; по умолчанию prefix — `FieldBase.Icon` + календарь; chrome от **`FieldBaseProps`**. |
-| **DateRangePicker** | Диапазон дат (`value`/`onChange` как `{ start?, end? }` / `DateRangeValue`); `layout` `single` / `split`. |
-| **TimePicker** / **TimePickerField** | Панель времени + поле с маской `HH:MM`; по умолчанию prefix — `FieldBase.Icon` + часы. |
-| **Calendar** | Составной: `Provider` / `Root` / `Header` / `Title` / `Nav` / `Body`. `selectionMode` `single` \| `range` на Provider. Контекст: `view` / `setView` (`CalendarViewMode`). |
-| **DayStripCalendar** | Горизонтальная полоса дней (недельный chrome): `daysCount`, предыдущий/следующий, `value` / `onChange`, `renderDay`. |
+| **DatePicker** | Выбор даты: MaskedField + календарь; по умолчанию prefix — `FieldBaseIcon` + календарь; chrome от **`FieldBaseProps`**. |
+| **DateRangePicker** | Диапазон дат (`value`/`onChange` как `{ start?, end? }`); chrome от **`FieldBaseProps`**; `layout` `single` / `split`. |
+| **TimePicker** | Поле времени с маской `HH:MM` и выпадающей панелью; по умолчанию prefix — иконка часов. |
+| **Calendar** | Составной: `Provider` / `Root` / `Header` / `Title` / `Nav` / `Body`. `selectionMode` `single` \| `range` на Provider. `value` — `Date` или `DateRangeValue`. |
+| **DayStripCalendar** | Горизонтальная полоса дней: `daysCount`, prev/next выбирают соседний день, `value` / `onChange`, `renderDay`. |
 | **ColorSwatchGroup** | Выбор цвета из набора цветных точек. |
 | **UploadZone** | Зона перетаскивания файлов для загрузки. |
-| **Fieldset** | Составной: `Inner` / `Legend` / `Description` / `Hint` / `Content` / `Footer`; варианты `default` / `card` / `plain`. |
-| **FieldLabel** | Лейбл + контент: `layout` vertical / horizontal; `align` start / center / baseline; `justify` start / between. |
+| **Fieldset** | Группа полей: `legend` / `description` / `hint` / `footer` / `gap`; содержимое — `children`. Варианты `default` / `card` / `plain`. |
 
 ---
 
@@ -62,17 +58,15 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **Overlay** | Примитив позиционирования без chrome: `variant` `modal` / `floating` / `sheet` / `popover` / `dropdown`. Видимость: `open` / `onOpenChange` / `onClose`. Портал + появление/скрытие; z-index / offset — `purpose` (см. [THEMING.md](./THEMING.md)). |
-| **Backdrop** | Затемнение под оверлеем: `variant` `default` / `strong`, `blur`, клик закрывает слой. |
-| **Modal** | Составной на **`Overlay`** (`variant="modal"`): `Header` / `Title` / `Close` / `Body` / `Footer` / **`FormFooter`**. |
-| **ConfirmDialog** | Готовый диалог на **`Modal`**: отмена + подтверждение, `confirmLabel`, `secondaryAction`, `status="danger"`, `onClose`. |
-| **Sheet** | Панель на **`Overlay`** (`variant="sheet"`): `Header` / `Title` / `Close` / `Body` / `Footer`; `mode` / `direction` / `backdrop` / `showHandle`. `padding` — на **Body**; подпись закрытия — `aria-label` на **Close**. |
-| **ImageLightbox** | Полноэкранный просмотр на **`Overlay`** (`variant="modal"`, `purpose="lightbox"`); фото с тенью на Backdrop, без рамки. |
-| **Dropdown** | Выпадающая панель на **`Overlay`** (`variant="dropdown"`). Составной: `Dropdown` + `Dropdown.Trigger` + `Dropdown.Content`. Trigger без лишней DOM-обёртки (`asChild` / render-prop). `widthMode` / `align` / `mobileTitle` — на **Content**. На мобильных — нижний Sheet. |
+| **Modal** | Составной диалог: `Header` / `Title` / `Close` / `Body` / `Footer` / **`FormFooter`**. `open` / `onOpenChange`. |
+| **ConfirmDialog** | Готовый диалог на **`Modal`**: отмена + подтверждение, `confirmLabel`, `secondaryAction`, `status="danger"`, `onOpenChange`. |
+| **Sheet** | Панель: `Header` / `Title` / `Close` / `Body` / `Footer`; `mode` / `direction` / `backdrop` / `showHandle`. `open` / `onOpenChange`. |
+| **ImageLightbox** | Полноэкранный просмотр; `open` / `onOpenChange`. |
+| **Dropdown** | Выпадающая панель. Якорь — `renderTrigger(props, ref)`; содержимое — `children`. `align` `start` \| `center` \| `end` \| `auto` (`left`/`right` — алиасы). `triggerMode` `toggle` \| `combobox`. `open` / `onOpenChange`. На мобильных — нижний Sheet. |
 | **Menu** | Меню действий: клик по `trigger` (Dropdown + ActionList) или `trigger="context"` (ПКМ / Shift+F10 у курсора). |
-| **Tooltip** | Подсказка на **`Overlay`** (`variant="popover"`, `triggerMode="hover"`); триггер через `renderChildren` (`asChild` / render-prop); `openDelay` / `closeDelay`, wrap, arrow. Мьютекс наведения: не больше одной подсказки одновременно при быстром переходе между триггерами. |
-| **Popover** | Плавающий слой на **`Overlay`** (`variant="popover"`). Составной: `Trigger` (`asChild` / render-prop) + `Content` (`panel`/`tooltip`/`plain`, `arrow`; `side` / `align` / delays / `closeOn*`). `trigger` click/hover/manual. |
-| **CommandPalette** | Палитра Cmd+K: `items` / `groups`, поиск в шапке через **`TextField`** + `IconSearch` (без автосбора команд). |
+| **Tooltip** | Подсказка при наведении / фокусе; триггер — элемент-child или render-prop; `side` (алиас `position`), `openDelay` / `closeDelay`, wrap, arrow. |
+| **Popover** | Плавающий слой. Якорь — `renderTrigger`; содержимое — `children`. `trigger` click/hover/manual; `variant` panel/plain, `side` / `align` / delays, стрелка `arrow`. Подсказки — **Tooltip**. |
+| **CommandPalette** | Палитра Cmd+K: `items` / `groups`, фильтр — **`ActionList`** с `filterable`. |
 
 ---
 
@@ -80,10 +74,10 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **Pagination** | Составной: `Summary` («N–M из K»), `Controls`, `PageSize` (**`Select`** `sm`); многоточие при многих страницах. |
+| **Pagination** | Постраничная навигация. Без `children` — `Controls`; опционально `totalItems` / `pageSize` / `onPageSizeChange`. Составной: `Summary`, `Controls`, `PageSize`. |
 | **Sidebar** | Составной: `Root`, `Header`, `Title`, `Collapse`, `Content`, `Group`, `GroupLabel`, `Item`, `Footer`, `MobileTrigger`; `value` / `onChange`; десктопный rail + мобильный Sheet. |
 | **Steps** | Мастер: горизонтальный/вертикальный, статус шага, `onStepClick`. |
-| **Tabs** | Составные вкладки: `Tabs.List` / `Tabs.Trigger` / `Tabs.Panel`; `value` / `defaultValue` / `onChange`; `line` / `pill`, горизонтальные/вертикальные и бейдж на Trigger. |
+| **Tabs** | Составные вкладки: `Tabs.List` / `Tabs.Trigger` / `Tabs.Panel`; `value` / `defaultValue` / `onChange` (без `defaultValue` вкладка не выбирается сама); `line` / `pill`, горизонтальные/вертикальные и бейдж на Trigger. |
 
 ---
 
@@ -91,13 +85,13 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **Table** | Составной: `Root` / `Toolbar` / `Content` / `Loading` / `Empty` / `Footer` / `RowActions`. `Content` содержит сортировку (клиент/сервер), выбор строк, раскрытие, липкие колонки, `density`, resize и `rowActions` (`ActionListItem[]`); loading, empty и пагинация собираются sibling-слотами. |
-| **Timeline** | Вертикальный/горизонтальный, сворачиваемые подробности, `currentId`. |
-| **Card** | `variant` outlined/elevated/ghost; `header` / `media` / `actions` (ReactNode), `children` — body; `loading`. |
-| **Accordion** | Составной: `Item` / `Trigger` / `Content`; `flush` (по умолчанию) / `bordered` (chrome в CSS от `data-variant`); `multiple`, отключённый пункт. |
-| **Badge** | `size` sm/md, `position` overlay/standalone, `variant` включая `error`; overlay — `--altum-badge-overhang`. Числовой `label` / `BadgeCounter` ограничивается через `max`; `children` — якорь overlay. |
+| **Table** | Один компонент: `columns` / `data` / `rowKey`, плюс `toolbar`, `loading`, `empty` (`title` / `description` / `action`) и `footer` (пагинация). Сортировка (клиент/сервер), выбор строк, раскрытие, липкие колонки, `density`, resize и `rowActions` (`ActionListItem[]`). |
+| **Timeline** | Вертикальный/горизонтальный, сворачиваемые подробности (`<details>`), `currentId`. |
+| **Card** | `variant` outlined/elevated/ghost; радиус по умолчанию `lg`; `header` / `media` / `actions` (ReactNode), `children` — body; `loading`. |
+| **Accordion** | `Accordion.Item` с `title` и содержимым в `children`; `flush` (по умолчанию) / `bordered`; `multiple`, отключённый пункт. |
+| **Badge** | `size` sm/md, `position` overlay/standalone, `variant` включая `error`; overlay — `--altum-badge-overhang`. Числовой `label` ограничивается через `max`; `children` — якорь overlay. |
 | **Avatar** / **AvatarGroup** | Размеры `xs`…`xl`, кольцо статуса, запасная иконка; группа с наложением. |
-| **Chip** | Тег / фильтр: `mode` `chip` \| `tag`, `size`, `active`, `onRemove` / `onClick`. **`ChipGroup`**: `layout` `wrap` \| `scrollX`. |
+| **Chip** | Тег / фильтр: `mode` `chip` \| `tag` \| `toggle` (`as` — deprecated-алиас), `size`, `onRemove` / `onClick`. **`ChipGroup`**: `mode` `chip` \| `tag`, `layout` `wrap` \| `scrollX`. |
 | **StatBadge** | Компактный блок статистики: число + подпись; `variant` `default` / `success` / `warning` / `error`; `size` `md` / `sm`. |
 | **EmptyState** | Пустое состояние: иконка (`--altum-color-empty-icon`), заголовок, описание, действие; `size` для вложенных панелей. |
 | **DescriptionList** | Список «ключ — значение» (`stacked` / `inline`, колонки). |
@@ -112,9 +106,9 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **Title** | Заголовки уровней `h1`–`h4`; цвет `--altum-color-type` (адаптация в `Box`). |
+| **Title** | Заголовки уровней `h1`–`h4`; цвет `--altum-color-type`. |
 | **Text** | Текстовый примитив (`--altum-type-*`). Дефолт `as="span"` (inline); для блочного copy — `as="p"` / `as="div"`, иначе соседние `Text` склеятся в одну строку. |
-| **Link** | Ссылка: `variant` `primary`\|`secondary`\|`muted`, `status` `danger`, `size` `xs`–`xl` (или inherit), `--altum-color-link-*`. |
+| **Link** | Ссылка: `variant` `primary`\|`secondary`\|`muted`, `status` `danger`, `size` `xs`–`xl` (или inherit), `--altum-color-link-*`. Единственный элемент-child — Slot (роутерный Link). |
 | **Kbd** / **KbdGroup** | Отображение клавиш и сочетаний клавиатуры. |
 
 ---
@@ -123,17 +117,17 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **Layout** | Панель: скролл на корне; `Header` / `Footer` sticky; алиасы `Stack` / `Inline` / `Split` / `ControlRow` / `Item` / `Grid`. |
+| **Layout** | Панель: скролл на корне; `Header` / `Footer` sticky; алиасы `Inline` / `Split` / `ControlRow` / `Item`. |
 | **Stack** / **Inline** / **Split** / **ControlRow** / **LayoutItem** | Flex-примитивы (вертикаль / чипы / края / ряд контролов / `grow`). |
 | **Grid** / **GridItem** | CSS Grid; `GRID_BREAKPOINTS`. |
 | **Container** / **Page** | Колонка с max-width (`sm`…`xl` / `full`) и оболочка страницы. |
-| **Box** | Поверхность (`outlined` / `elevated` / `floating` / `tinted` / `secondary` / `muted` / `glass` / `overlay` / `ghost` / `plain`). |
-| **Collapse** | Плавное сворачивание по высоте. |
-| **Separator** (`Spacer`) | Разделитель: `orientation` horizontal \| vertical, текст (`children`), отступы `start` / `end`. |
-| **Item** | Составная строка: `Media` / `Content` / `Title` / `Description` / `Actions`; поверхность — `Box`. |
+| **Box** | Поверхность (`outlined` / `elevated` / `floating` / `tinted` / `secondary` / `muted` / `glass` / `overlay` / `ghost` / `plain`). Красит только себя; потомки остаются на глобальных токенах. |
+| **Collapse** | Плавное сворачивание по высоте (CSS `grid-template-rows`). |
+| **Separator** | Разделитель: `orientation` horizontal \| vertical, текст (`children`), отступы `start` / `end`. |
+| **Item** | Строка: `media` / `mediaVariant`, `title`, `description`, `actions`; поверхность — `Box`. |
 | **AspectRatio** | Обёртка с `aspect-ratio` (16:9 / 1:1). |
-| **Media** | img/video-превью на базе **AspectRatio**. |
-| **ScrollArea** | Стилизованный скролл (`orientation` y/x/both). |
+| **Media** | img/video-превью с `aspect-ratio`. |
+| **ScrollArea** | Стилизованный скролл (`orientation` y/x/both); `maxHeight` / `maxWidth` без дефолта. |
 
 ---
 
@@ -141,10 +135,10 @@
 
 | Компонент | Описание |
 |-----------|----------|
-| **ImageGallery** | Составная галерея: `Root` + `Viewport` / `Image` / `Prev` / `Next` / `Thumbnails` / `Thumb` / `Counter` / `Empty`. |
+| **ImageGallery** | Галерея: `images`, chrome `default` \| `none`, `showNav` / `showThumbnails` / `showCounter`. |
 | **ImageCrop** | Обрезка изображения. |
-| **FileList** | Список загрузок на **`Attachment`**: progress / retry / remove через `FileList.Item`. |
-| **Attachment** | Карточка файла/изображения (compound `Media` / `Content` / `Title` / `Description` / `Actions`). |
+| **FileList** | Список загрузок на **`Item`**: progress / retry / remove через `FileList.Item`. |
+| **Attachment** | Карточка файла: `Item` + статус загрузки (`idle` / `uploading` / `error` / `done`). Действия в слоте — **`ButtonIcon`**. |
 
 ---
 
@@ -173,7 +167,6 @@
 |-----------|----------|
 | **SafeArea** | Отступы под notch / home-indicator (`env(safe-area-inset-*)`). |
 | **PullToRefresh** | Жест «потянуть, чтобы обновить» для контейнера с прокруткой. |
-| **GrabHandle** | Ручка захвата в стиле iOS. |
 | **SwipeToAction** | Сенсорная обёртка: свайп раскрывает действия (iOS). |
 
 ---
@@ -186,7 +179,7 @@
 | **Skeleton** | Плейсхолдер; `variant` `block` / `text` / `avatar` / `card` / `table`. |
 | **Progress** / **ProgressCircle** | `size`, `variant` (auto → success при 100%), `showValueText`, indeterminate, labels; у круга `diameter` перекрывает токен размера. |
 | **Alert** | `title`, `icon` (`null` скрывает), `actions`, `onClose`; `children` — текст; `variant`, `size`, `layout` block/inline. |
-| **Notification** | Составной тост: `Provider`, `Viewport`, `Root`, `Title`, `Description`, `Actions`, `Close`. `variant` `info` / `success` / `warning` / `error`. Императивно: `NotificationProvider` + `notify()`. |
+| **Notification** | Карточка: `title`, `description`, `actions`. Императивно: `NotificationProvider` + `notify()`. Декларативно: `Notification.Viewport`. |
 
 ---
 
@@ -199,6 +192,5 @@
 | **useLocale** / **useT** | Хук `{ locale, messages, t }` / только `t`. |
 | **ru** / **en** | Встроенные словари. |
 | **useTheme** | Хук `{ theme, setTheme, toggleTheme }` внутри `ThemeProvider`. |
-| **FocusTrap** | Ловушка фокуса для доступности в модальных окнах. |
 | **VisuallyHidden** | Контент только для скринридеров (скрыт визуально). |
 | **SkipLink** | «Перейти к содержимому» (виден при фокусе). |

package/docs/ICONS.md

@@ -9,7 +9,7 @@ import {IconSearch} from 'altum/icons';
 <ButtonIcon aria-label="Поиск" icon={<IconSearch />} />
 ```
 
-Набор **не** входит в главный barrel — только `altum/icons`. Просмотр: Storybook → **Icons**.
+Набор **не** входит в главный barrel — только `altum/icons`. Просмотр: Storybook → **Icons**. Каталог собран через `createIcon` (`IconProps` тот же: `size`, `color`).
 
 ### Контракт для кастомных SVG
 

package/docs/LAYOUT.md

@@ -33,7 +33,7 @@ import {
 | Слева заголовок, справа действия | **Split** |
 | Поля + Chip + Button в одной строке фильтров | **ControlRow** |
 | Одному ребёнку — `flex: 1` или «не сжимать» | **LayoutItem** (`ControlRow.Item` / `Layout.Item`) |
-| Колонки сетки | **Grid** / `Layout.Grid` |
+| Колонки сетки | **Grid** |
 | Оболочка input (label / prefix / clear) | **FieldBase** |
 
 ---
@@ -102,7 +102,7 @@ import {
 
 ### Namespace
 
-На `Layout` также висят алиасы: `Layout.Stack`, `.Inline`, `.Split`, `.ControlRow`, `.Item`, `.Grid`, `.GridItem`.
+На `Layout` также висят алиасы: `Layout.Inline`, `.Split`, `.ControlRow`, `.Item`.
 
 В приложении предпочтительны **именованные импорты**; `Layout.*` удобен, когда вы уже внутри панели.
 
@@ -262,7 +262,7 @@ Flex-ячейка внутри Stack / Inline / Split / ControlRow.
       <SearchField label="Поиск" width="full" />
     </ControlRow.Item>
     <Inline gap="sm">
-      <Chip active>Все</Chip>
+      <Chip mode="toggle">Все</Chip>
       <Chip>Активные</Chip>
     </Inline>
   </ControlRow>

package/docs/THEMING.md

@@ -91,8 +91,6 @@ return (
 | `--altum-g-font-size-3xl` | 24px | Display (`Title` h2) |
 | `--altum-g-font-size-4xl` | 32px | Display (`Title` h1) |
 | `--altum-g-font-weight-normal` … `--altum-g-font-weight-bold` | 400–700 | Начертания |
-| `--altum-g-line-height-snug` / `--altum-g-line-height-relaxed` | → xs / base | Алиасы |
-
 В компонентах: `font-size: var(--altum-g-font-size-sm); line-height: var(--altum-g-line-height-sm);`.
 
 ### Диалог / список / опция
@@ -124,13 +122,13 @@ return (
 | `--altum-toggle-task-check-height` | 7px | Высота галочки в режиме task |
 | `--altum-toggle-radio-dot*` | sm/md/lg | Размер внутренней точки Radio |
 | `--altum-toggle-align-nudge` | `0.15em` | Оптическое выравнивание бокса тоггла относительно лейбла |
-| `--altum-rating-size-sm` / `md` / `lg` | 16 / 22 / 28 | Размер SVG-звезды Rating |
+| `--altum-rating-size-sm` / `md` / `lg` | 16 / 22 / 28 | Размер звезды Rating |
 | `--altum-command-palette-max-width` / `height` | 560 / 520 | Ограничение панели CommandPalette |
 | `--altum-button-group-item-min-sm` / `md` / `lg` | space-6 / 7 / 8 | Мин. ширина ButtonGroup.Item |
 | `--altum-focus-ring-width` | 2px | Толщина outline-фокуса (навигация / тогглы / выбор) |
 | `--altum-focus-ring-offset` | light 1px / dark 2px | Смещение outline-фокуса (согласовано с зазором кольца кнопки) |
 | `--altum-focus-ring-color` | light → `--altum-color-input-border-focus`; dark `rgba(248,250,252,0.55)` | Общий цвет outline-фокуса (в dark — светлая hairline, не заливка CTA) |
-| `--altum-button-focus-inner` / `--altum-button-focus-outer` | light 1px / 3px; dark 2px / 4px | Ширины двойного кольца кнопки (алиасы `--altum-color-button-focus-*`) |
+| `--altum-button-focus-inner` / `--altum-button-focus-outer` | light 1px / 3px; dark 2px / 4px | Ширины двойного кольца кнопки |
 | `--altum-opacity-disabled` | 0.5 | Отключённые контролы; **Button** — та же заливка × opacity |
 | `--altum-field-disabled-opacity` | 0.8 | Chrome отключённого поля (текст остаётся читаемым) |
 | `--altum-field-label-gap` / `--altum-field-message-gap` | `--altum-g-space-1` | Зазор внешнего лейбла / helper+ошибка |
@@ -177,7 +175,7 @@ return (
 | Переменная | По умолчанию | Кто использует |
 |------------|--------------|----------------|
 | `--altum-g-z-below` | `-1` | Линия-коннектор Steps |
-| `--altum-g-z-raised` | `1` | Слайдер SegmentedControl |
+| `--altum-g-z-raised` | `1` | Слайдер ButtonGroup / SegmentedControl |
 | `--altum-g-z-raised-above` | `2` | Контент кнопки, контролы NumberField |
 | `--altum-g-z-control` | `5` | Бегунок Slider |
 | `--altum-g-z-local` | `10` | Badge, липкий заголовок таблицы, маска TextField |
@@ -195,7 +193,7 @@ return (
 |---------|---------|------------|
 | `tooltip` | `--altum-g-z-tooltip` | `--altum-overlay-offset-tooltip` (8px) |
 | `popover` | `--altum-g-z-dropdown` | `--altum-overlay-offset-popover` (8px) |
-| `dropdown` | `--altum-g-z-dropdown` | `--altum-overlay-offset-dropdown` (4px) |
+| `dropdown` | `--altum-g-z-dropdown` | `--altum-overlay-offset-dropdown` (8px) |
 | `modal` | `--altum-g-z-modal` | — |
 | `sheet` | `--altum-g-z-overlay` | — |
 | `lightbox` | `--altum-g-z-lightbox` | — |
@@ -216,7 +214,7 @@ return (
 
 ### Тонированный (`--altum-color-brand-tint-*`)
 
-Приглушённый акцентный вариант (Apple-style Tinted / Light): заливка ~16% от акцента, текст остаётся ярким и контрастным. Используется в `Button` / `Chip` / `SegmentedControl` с `variant="tinted"`.
+Приглушённый акцентный вариант (Apple-style Tinted / Light): заливка ~16% от акцента, текст остаётся ярким и контрастным. Pressed заметно плотнее hover. Используется в `Button` / `Chip` / `SegmentedControl` с `variant="tinted"`.
 
 | Переменная | Назначение |
 |------------|------------|
@@ -227,7 +225,7 @@ return (
 | `--altum-color-brand-tint-border` | Рамка |
 | `--altum-color-button-border-tinted` | Рамка кнопки |
 
-Светлая заливка деструктивной кнопки использует `--altum-color-danger-bg-solid: #b91c1c` (WCAG AA с белым текстом).
+Светлая заливка деструктивной кнопки — mix red-700 со slate (`--altum-color-danger-bg-solid`), тот же регистр пыли, что статусы; AA на белом тексте.
 
 ### Вторичный (`--altum-color-surface`, `--altum-color-border`)
 
@@ -236,7 +234,7 @@ return (
 | Переменная | Назначение |
 |------------|------------|
 | `--altum-color-surface` | Фон поверхности (карточка) |
-| `--altum-color-surface-elevated` | На ступень выше surface (`Box` `elevated`; dark: `#1a1e27`) |
+| `--altum-color-surface-elevated` | На ступень выше surface (`Box` `elevated`; dark: `#262628`) |
 | `--altum-color-border` | Рамки |
 | `--altum-color-text-secondary` | Приглушённый текст |
 
@@ -256,32 +254,32 @@ TextField, Checkbox (`mode="task"`), Switch, Radio. Примитивы — ис
 
 | Переменная | Назначение |
 |------------|------------|
-| `--altum-color-input-bg` | Фон поля (dark: overlay `#242c3f`, не surface) |
+| `--altum-color-input-bg` | Фон поля (dark: overlay `#2b2b2e`, не surface) |
 | `--altum-color-input-text` | Текст поля |
 | `--altum-color-input-border` | Рамка по умолчанию |
 | `--altum-color-input-border-focus` | Рамка в фокусе |
-| `--altum-color-muted` | Плавающий лейбл (light: `#64748b`, dark: `#a3b0c2`) |
+| `--altum-color-muted` | Плавающий лейбл (light: `#64748b`, dark: `#A8A8B3`) |
 | `--altum-color-control-bg` | Фон checkbox/radio |
 | `--altum-color-control-bg-checked` | Состояние checked |
 | `--altum-color-control-text-color` | Текст лейбла контрола |
 
 ### Chrome элементов (`--altum-field-*`, `--altum-color-button-*`, `--altum-color-chip-*`, `--altum-color-segmented-*`, `--altum-color-panel-*`, `--altum-type-*`, `--altum-color-link-*`)
 
-Компоненты читают токены **элементов**. Значения по умолчанию — алиасы примитивов выше. Адаптивные варианты `Box` (`outlined` / `elevated` / `tinted` / `secondary` / `muted` / `glass` / `overlay`) переопределяют кнопки, чипы и панели для потомков через CSS-каскад. Поля и тогглы в dark оставляют глобальный overlay-fill (lift над карточкой); `overlay` по-прежнему даёт frosted chrome.
+Компоненты читают токены **элементов**. Значения по умолчанию — алиасы примитивов выше. `Box` красит только себя: вложенные кнопки, чипы, поля и текст остаются на этой глобальной палитре на любой заливке.
 
 | Группа | Примеры |
 |--------|---------|
 | Поле | `--altum-color-field-bg`, `--altum-color-field-border`, `--altum-color-border-hover`, `--altum-color-field-text`, `--altum-field-label` |
 | Кнопка (secondary / tinted / ghost) | `--altum-color-button-secondary-bg`, `--altum-color-button-tinted-border`, `--altum-color-button-ghost-text` (muted, не secondary), `--altum-color-button-ghost-hover-bg` |
 | Chip | `--altum-color-chip-secondary-bg`, `--altum-color-chip-tinted-text` |
-| Segmented | `--altum-color-segmented-*` (алиасы на `--altum-color-button-*`); primary active: `--altum-color-segmented-primary-slider-bg` (в dark контрастнее трека) |
+| Segmented | `--altum-color-segmented-*`: колодец (`*-track-bg`) + приглушённый thumb (`*-slider-bg`, `--altum-color-segmented-slider-shadow`). Один thumb на secondary / tinted / ghost |
 | Панель | `--altum-color-panel-bg`, `--altum-color-panel-border`, `--altum-color-panel-bg-hover` |
-| Типографика | `--altum-color-type`, `--altum-color-type-secondary`, `--altum-color-type-muted` (`Title` / `Text`) |
+| Типографика | `--altum-color-type`, `--altum-color-type-secondary`, `--altum-color-type-tertiary`, `--altum-color-type-muted` (`Title` / `Text`) |
 | Ссылка | `--altum-color-link-color`, `--altum-color-link-secondary`, `--altum-color-link-muted`, `--altum-color-link-danger`, `--altum-color-link-focus-ring` |
 | Tooltip | `--altum-color-tooltip-bg` / `--altum-color-tooltip-fg` (инверсия ink, не brand-кнопка) |
 | Индикатор Tabs / Pagination | `--altum-color-tabs-indicator` |
 
-Primary- и danger-кнопки остаются на `--altum-color-brand-*` / `--altum-color-danger-*` (Box их не перемапливает). Ремап типографики/ссылок сильнее всего на `tinted` и `overlay`.
+Primary- и danger-кнопки остаются на `--altum-color-brand-*` / `--altum-color-danger-*`.
 
 ### Поверхности
 
@@ -292,7 +290,7 @@ Primary- и danger-кнопки остаются на `--altum-color-brand-*` /
 | `--altum-color-dropdown-bg` | Modal / Sheet / выпадающие панели (dark: elevated, не overlay полей) |
 | `--altum-color-option-hover` | Фоны при наведении |
 | `--altum-color-selection-fill` / `--altum-color-selection-fill-fg` / `--altum-color-selection-fill-emphasis` | Акцентный выбранный chrome (Segmented primary, Chip primary/tinted active) |
-| `--altum-color-selection-neutral-fill` / `--altum-color-selection-neutral-border` / `--altum-color-selection-neutral-slider` | Мягкий выбранный chrome (Segmented secondary, Chip secondary active) |
+| `--altum-color-selection-neutral-fill` / `--altum-color-selection-neutral-border` / `--altum-color-selection-neutral-slider` | Мягкий выбранный chrome: Chip secondary active; slider — приподнятый thumb Segmented / ButtonGroup |
 | `--altum-color-empty-icon` | Чернила иллюстрации EmptyState (`--altum-color-text-secondary`) |
 
 ## Тёмная тема
@@ -315,4 +313,4 @@ const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
 <ThemeProvider initialTheme={prefersDark ? 'dark' : 'light'} />
 ```
 
-Тёмная primary — плотный steel (`--altum-color-brand: #4e6480`, hover `#5d7694`, текст `--altum-g-color-slate-50`), без инверсии светлой заливки и без мытого `#6b7f98` на CTA. Ссылки в dark — `--altum-color-link-color` `#cbd5e1` (ярче Ghost/muted `#a3b0c2`); `Button` `link` / `Link` — idle underline 1px при ~45% currentColor, полная на hover. Ghost — muted, метрика кнопки, hover-смывка. Лестница поверхностей: canvas `--altum-color-bg` `#11151c` (navy) → surface `#151920` → elevated / диалоги `#1a1e27` (приглушённый холодный серо-navy) → overlay/поля `#242c3f`; hover опции `#2f374d`; pressed `--altum-color-surface-active` `#11151a`. Скрам оверлея — navy `rgba(11, 15, 24, 0.72)`, не чистый чёрный. Инпут — заливка overlay `#242c3f` (не surface; поле ≠ карточка), idle-рамка `color-mix(#ffffff 26%)`; фокус поля — `--altum-color-input-border-focus` (`#6b7f98`). Кольцо Tab — `--altum-focus-ring-color` `rgba(248,250,252,0.55)` 2px / offset 2px, не steel-заливка. Tinted — смывка `#94a3b8` ~22%, текст `#cbd5e1`. Статусы в dark — чуть чище пыль (success `#53b689`, info `#6594be`, warning `#d1a54e`, error `#cf7379`); Alert / Chip — mix 14% на surface + hairline 26%, fg = пигмент; hover чипа — `--altum-color-status-*-bg-hover` на surface. Danger secondary / tinted в dark — едва тёплый подтон на surface (~9–16%), не twin обычного secondary и не неон. Выбранная строка / день — `--altum-color-selection-fill` (brand 42% на overlay), светлые чернила. Tooltip — `--altum-color-tooltip-bg` `#293244`, не brand-кнопка. Рамки Checkbox / Radio — `--altum-color-control-border` → `--altum-color-input-border`; галочка на заливке — `#f1f5f9`. Overlay close — ghost без диска.
+Тёмная primary — плотный steel (`--altum-color-brand: #4e6480`, hover `#5d7694`, текст `--altum-g-color-slate-50`), без инверсии светлой заливки и без мытого `#6b7f98` на CTA. Ссылки в dark — `--altum-color-link-color` `#9aafc4` (steel, не почти-белый; Ghost/лейбл muted `#A8A8B3`, secondary `#C5C9D1`); `Button` `link` / `Link` — idle underline 1px при ~72% currentColor, полная на hover. Ghost — muted, без линии, метрика кнопки, hover-смывка. Лестница поверхностей: canvas `--altum-color-bg` `#141416` (нейтральный charcoal в климате steel) → surface `#1f1f22` → elevated / диалоги `#262628` → overlay/поля `#2b2b2e`; hover опции `#2d2d30`; pressed `--altum-color-surface-active` `#1a1a1c`. Скрам оверлея — `rgba(10, 10, 12, 0.72)`, не чистый чёрный. Контролы на оверлее — `--altum-overlay-control-bg` → input-bg, рамка → input-border, hover → option-hover. Инпут — заливка overlay `#2b2b2e` (не surface; поле ≠ карточка), idle-рамка `color-mix(#ffffff 17%)`; фокус поля — `--altum-color-input-border-focus` (`#6b7f98`). Кольцо Tab — `--altum-focus-ring-color` `rgba(248,250,252,0.72)` 2px / offset 2px, не steel-заливка. Tinted — mix brand на surface (~26 / 34 / 54% idle / hover / pressed), текст `#c8d3e4`. Статусы в dark — пыль без неона (success `#53b689`, info `#5b8cba`, warning `#c4a05e`, error `#cf7379`); Alert / Chip — mix 14% на surface + hairline 26%, fg = пигмент; hover чипа — `--altum-color-status-*-bg-hover` на surface. Danger fill в dark — пыльная роза `#8f4e53` (тот же hue, что error). Danger secondary / tinted в dark — едва тёплый подтон на surface (~9–16%), не twin обычного secondary и не неон. Выбранная строка / день — `--altum-color-selection-fill` (brand 42% на overlay), светлые чернила. Tooltip — `--altum-color-tooltip-bg` `#303033`, не brand-кнопка. Рамки Checkbox / Radio — `--altum-color-control-border` → `--altum-color-input-border`; галочка на заливке — `#f1f5f9`. Overlay close — ghost без диска. Вторичный текст `#C5C9D1`; лейблы / Ghost / muted `#A8A8B3`; `Text` tertiary / muted `#8C8C99`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "altum",
-	"version": "0.0.2",
+	"version": "0.0.3",
 	"description": "Библиотека React + TypeScript UI-компонентов: CSS Modules, токены ThemeProvider, адаптация overlay/sheet.",
 	"license": "MIT",
 	"author": "Alexander <azeeson@gmail.com>",