Миграция CDS 3 → CDS 4

@central-design-system/components v4 — мажорное обновление дизайн-системы. Этот документ — живой migration guide: записи добавляются по мере появления breaking-изменений в alpha/beta релизах CDS 4.

Версии: CDS 3 — 3.10.1 (стабильная), CDS 4 — 4.0.0-alpha.4 (в разработке).

Как читать этот документ

• Каждая запись имеет severity (см. ниже). Сначала разбирайтесь с BREAKING, затем с RENAMED, затем с DEPRECATED.
• Записи сгруппированы по категориям (Архитектура, Иконки, …). Изменения по конкретным компонентам — в разделе Компоненты.
• Каждая запись содержит блоки Было (CDS 3) и Стало (CDS 4) с примерами кода и поле Действие — конкретный шаг миграции.
• При запуске приложения смотрите на консольные [CDS UPGRADE] warnings — они подсказывают точки миграции в рантайме (реализация: src/utils/dom/warn.ts → deprecate()).

Легенда severity

Маркер	Что значит
⚠️ BREAKING	Ломает существующий код — обязательное действие.
🔁 RENAMED	Переименование (частный случай breaking) — механический поиск/замена.
🟠 DEPRECATED	Работает в 4.x, будет удалено в 5.x. Желательно обновить.
✨ NEW	Новая возможность без ломки. Информативно.

Быстрый чек-лист

• ✅ Прочитать раздел «Архитектура» — публичный API инициализации мог измениться.
• ✅ Если используете @central-design-system/icons — см. раздел «Иконки» (есть legacy-режим).
• ✅ Заменить rgb(var(--cds-…)) на var(--cds-…) — цвета в переменных теперь готовые значения (скилл cds-migrate, см. «Стили и токены»).
• ✅ Проверить индекс изменений по компонентам.
• ✅ Прогнать сборку приложения и проверить консоль: [CDS UPGRADE] warnings указывают на устаревшие пропсы.

---

Разделы

• 1. Архитектура
• 2. Иконки
• 3. Пропсы
• 4. Стили и токены
• 5. Композаблы
• 6. Hooks
• 7. Сборка и экспорты
• 8. Компоненты