aboutsummaryrefslogtreecommitdiff
path: root/docs/specs/ui.md
diff options
context:
space:
mode:
authorValentin Popov <valentin@popov.link>2026-02-19 10:07:04 +0300
committerValentin Popov <valentin@popov.link>2026-02-19 10:07:04 +0300
commit0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d (patch)
tree6398ba4a13d22656af75395db6de2e4f84d6c875 /docs/specs/ui.md
parenta281ffa32ea615670d369503692f057b2dc60e6f (diff)
downloadfparkan-0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d.tar.xz
fparkan-0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d.zip
Документирование и обновление спецификаций
- Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`. - Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности. - Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы. - Уточнены форматы данных и правила взаимодействия между компонентами системы.
Diffstat (limited to 'docs/specs/ui.md')
-rw-r--r--docs/specs/ui.md32
1 files changed, 30 insertions, 2 deletions
diff --git a/docs/specs/ui.md b/docs/specs/ui.md
index 9d71dfd..bb915cb 100644
--- a/docs/specs/ui.md
+++ b/docs/specs/ui.md
@@ -1,5 +1,33 @@
# UI system
-Документ описывает интерфейсную подсистему: ресурсы UI, шрифты, minimap, layout и обработку пользовательского ввода в интерфейсе.
+`UI` — подсистема интерфейса:
-> Статус: в работе. Спецификация будет дополняться по мере реверс-инжиниринга UI-компонентов движка.
+- экранные панели и HUD;
+- меню;
+- шрифты;
+- minimap и служебные оверлеи.
+
+## 1. Архитектурная роль
+
+1. Работает поверх render-пайплайна как отдельный этап кадра.
+2. Использует UI-ресурсы из архивных библиотек.
+3. Перехватывает пользовательский ввод по правилам фокуса.
+
+## 2. Минимальный runtime-контракт
+
+1. Детерминированный порядок draw-проходов UI.
+2. Консистентный фокус и приоритет ввода (UI vs world).
+3. Стабильная загрузка font/minimap/ui-ресурсов по именам.
+
+## 3. Статус покрытия и что осталось до 100%
+
+Закрыто:
+
+- позиция UI-слоя в общем кадре и его связи с render/input.
+
+Осталось:
+
+1. Полная спецификация форматов UI layout и контролов.
+2. Полный контракт ресурсов шрифтов и text-rendering поведения.
+3. Формат minimap-данных и правила трансформации координат.
+4. UI parity-тесты (скриншотные и событийные).