Правила

Источник: ds-docs/reference/guidelines/README.md, ds-docs/component-contracts/rules/

Правила и процессы: как заводить компоненты, как называть, как применять токены, как вести себя переходам, загрузке и уведомлениям. Наверх — README.

Как заводить и называть компоненты

Правила оформления компонентовАтомы ✱, Pascal Case с пробелом, свойства Variant/Boolean/Text/Instance swap, State layer. Версия 2.0
Теги в названии компонентовПрефиксы Dev Example/DP/Page/Template/❌ Deprecated, суффиксы продукта и команды + справочник кодов
Версии компонентаСвойство Version: 🟢 Stable / ❌ Deprecated

Токены на практике

Токены цвета в макетахТри вида токенов, четыре категории, уровни bg-surface → bg-layer-01 → bg-layer-02
Анимация: процессыКак дизайнер передаёт анимацию (Figma Prototype + аннотации, Jitter) и как разработчик её читает

Поведение продукта

Flow MotionПереходы между страницами; Flutter-хост и React-модули
Загрузка веб-модулейСкелетон, Preloader, стадии загрузки микрофронтов
УведомленияNotification Layer, приоритеты, правило 3 секунд
Паттерн поискаSearch Dialog против поиска на странице

Проверка оформления

Правила для плагина-проверкиКак устроен каталог правил и как его встроить в плагин
Проверяемый список41 правило: признак, строгость, где смотреть в выгрузке и в Plugin API

Куда смотреть дальше

  • Значения токенов — foundations.
  • Карточки компонентов — reference/components.
  • «Почему так» и устные договорённости — decisions.