v4.0.0-alpha.13

Русский

English

Русский

English

Тема

Миграция 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 указывают на устаревшие пропсы.

Разделы ​