spec: archive portable design token delivery

2026-09-08 19:47:00 +03:00
parent e637a07e6b
commit ca709b5ab9
7 changed files with 488 additions and 2 deletions
@@ -12,8 +12,12 @@
 с семантическими ролями, типографику, интервалы, радиусы, тени и применимые
 адаптивные параметры. Общий фундамент MUST быть независим от бизнес-сущностей
 и уровня приложения; подключение провайдеров принадлежит приложению и runtime
-каталога. Параллельные копии значений MUST NOT создаваться там, где существующий
-механизм темы уже владеет шкалой. Выделение фундамента MUST сохранять текущий
+каталога. Объявленные общие токены SHALL иметь единый переносимый машиночитаемый
+источник значений, единиц, семантических ссылок и описаний, доступный без
+приложения или UI-библиотеки. Адаптер приложения SHALL потреблять этот источник
+без ручного дублирования значений. Перенос владения опубликованными шкалами
+из UI-библиотеки в токены MUST сохранять их эффективные значения; не включённые
+в контракт библиотечные defaults MAY оставаться у библиотеки. Выделение фундамента MUST сохранять текущий
 внешний вид, светлую схему и поведение приложения без массовой замены локальных
 значений оформления.

@@ -34,6 +38,27 @@
 - **THEN** исходные эффективные значения и внешний вид остаются прежними,
  включая встроенные шкалы, глобальные стили и локальное оформление

+#### Scenario: Токены использует другая система
+
+- **WHEN** потребитель читает исходный файл обычным парсером данных
+- **THEN** объявленные цвета, роли, типографика, интервалы, радиусы, тени и
+  адаптивные пороги доступны с определёнными единицами и ссылками без React,
+  Mantine, CSS runtime или запуска приложения; интеграция конкретного инструмента
+  не заявляется автоматически
+
+#### Scenario: Изменён исходный токен
+
+- **WHEN** валидное значение или семантическая ссылка изменены в едином источнике
+- **THEN** приложение и каталог получают изменение через один адаптер, без
+  повторного редактирования визуального значения в коде темы
+
+#### Scenario: Исходные токены некорректны
+
+- **WHEN** источник содержит неподдерживаемую единицу, некорректную шкалу или
+  семантическую ссылку на отсутствующий цвет
+- **THEN** ошибка обнаруживается при проверке или загрузке фундамента, без
+  молчаливой подстановки другого визуального значения
+
 ### Requirement: Общие компоненты независимы от предметной области

 Дизайн-система SHALL предоставлять минимальный набор реально используемых