docs: describe local frontend packages and ownership

OpenSpec change: evolve-frontend-stack
2026-09-22 22:11:04 +03:00
parent 15d1d820f5
commit 55610ea2b4
2 changed files with 44 additions and 2 deletions
@@ -4,6 +4,34 @@
 типографику, интервалы, радиусы, тени и адаптивные размеры.
 Поддерживается светлая схема; тёмная тема не заявлена.

+## Общая основа и каталог
+
+Внутри frontend используются три private npm workspace-пакета:
+
+| Пакет | Ответственность |
+| --- | --- |
+| `@wealthledger/tokens` | JSON со значениями палитры, типографики, интервалов и других визуальных параметров |
+| `@wealthledger/ui` | Mantine-тема, общие стили, StateView, LoadingSkeleton и EntryCard |
+| `@wealthledger/icons` | React-иконки добавления, редактирования и удаления |
+
+EntryCard отвечает за расположение переданных подписей, значения и действий.
+Предметный компонент определяет смысл операции, форматирует данные и выбирает
+цветовую роль. Денежные расчёты и запросы не входят в общий UI-пакет.
+
+Иконки наследуют цвет через `currentColor`. По умолчанию они декоративные:
+доступное имя принадлежит кнопке. Самостоятельная смысловая иконка получает
+явные роль изображения и доступное имя. Предметные рисунки и анимации
+остаются в приложении; поставки raw SVG и мобильного UI нет.
+
+Storybook объединяет примеры приложения и пакетов. Он показывает синтетические
+состояния без API, авторизации и query providers; формы получают локальные
+callbacks. Каталог помогает проверять представление, но не заменяет проверки
+запросов, денежных ограничений и восстановления после ошибок.
+
+Пакеты используются локально и не опубликованы в registry. Независимый выпуск
+не настроен. Потребители импортируют публичные exports пакетов напрямую; прежние
+compatibility re-exports `shared/theme` и `shared/ui` удалены.
+
 ## Семантические роли

 | Роль | Цветовая основа | Применение |
@@ -16,8 +44,8 @@
 | border | gray.3 | Граница поверхности |
 | primary | blue filled | Основное действие и активная навигация |
 | info | blue.6 | Информация |
-| positive | green.6 | Положительный результат с текстом или знаком |
-| negative | red.6 | Ошибка или отрицательный результат с текстом или знаком |
+| positive | green.9 | Положительный результат с текстом или знаком |
+| negative | red.9 | Ошибка или отрицательный результат с текстом или знаком |
 | warning | yellow.6 | Предупреждение; не мелкий текст на белом |

 Цвет не заменяет подпись или знак. Палитра не гарантирует доступный контраст