Версии компонента: 🟢 Stable / ❌ Deprecated

Источник: ds-docs/reference/guidelines/component-status.md

Правило про состояние жизненного цикла компонента и его вариантов. Связано: ds-internal/AUDIT.md, Теги в названии компонентов, decisions.

Где живёт статус

Статус выражается свойством Version на компоненте/варианте (ось вариантов в Figma), а у устаревших — ещё и приставкой ❌ в имени слоя/символа. Значения:

🟢 StableТекущая, поддерживаемая, рекомендованная версияДа — по умолчанию берём её
❌ DeprecatedУстаревшая версия; оставлена для совместимости/историиНет — не тащить в новые макеты

Правила

  1. В новых макетах используем только 🟢 Stable. ❌ Deprecated существует ради обратной совместимости и плавной миграции, а не для работы.
  2. Deprecated не удаляют сразу — он остаётся видимым, чтобы старые экраны не сломались; уводится из обращения по плану команды ДС.
  3. Помечать явно. Устаревшее — Version=❌ Deprecated и/или префикс ❌ в имени; в идеале с указанием замены: ❌ <Старое> (используйте <Новое>).
  4. При разборе/аудите ❌-варианты не считаются дефектом сами по себе — это легальное состояние; проблема только если deprecated используется в боевых макетах или если неясна замена.

Известные расхождения (чинить — см. ds-internal/AUDIT.md)

  • Конвенция пометки непоследовательна: встречается ❌ Deprecated, ❌ Description (двусмысленно — совпадает с реальным слоем Description) и ❌ <Name> (используйте <Name>). Нужна единая форма (предлагаю: Version=❌ Deprecated + в имени ❌ <Name> → <замена>).
  • ~30 компонентов несут внутри deprecated-варианты — стоит вести единый реестр устаревшего и сроки вывода.

Если у команды есть формальная политика депрекейта (сроки, как уведомляют, когда удаляют) — зафиксировать её здесь и записью в decisions.

Источник

наблюдение по компонентам Astra-DS + договорённость