# UI UI Fabrilis — это редактор и отладочный оверлей внутри приложения, а не отдельный UI-фреймворк и не библиотека для чужих программ. Окно обычное прямоугольное, управление окном и вводом — на `winit` (D24), рисование — на нашем `wgpu`-рендере, готовые UI-библиотеки не берём (D20). ## Модель - **Immediate-mode на старте.** UI каждый кадр строит список команд рисования (прямоугольник, скруглённый прямоугольник, линия, текст, картинка, клип), рендер батчит их. Состояние виджетов живёт в приложении, а не в дереве UI. - **Retained-дерево только по доказанной нужде.** Если профилирование покажет, что пересборка команд дорога, вводим стабильные `NodeId`, dirty-флаги и кеш ресурсов. Reconciliation и анимационный граф заранее не пишем. - **Event-driven redraw.** Нет изменений — нет кадра. Каждый кадр имеет причину (`Input`, `Animation`, `Resize`, `SimulationTick`, `Debug`), счётчик причин виден в оверлее; в простое — 0 кадров/с. - **Кеш ресурсов.** Пайплайны кешируются по `shader + layout + format + blend`; текст — через общий glyph atlas, а не текстуру на надпись. Offscreen-проходы только там, где эффект этого требует. - **Capability-модель.** Вместо `bool` — `Available | Unavailable { reason } | Conditional { reason }`: «нет прозрачности», «fractional scale не поддержан», «эффект недоступен на этом backend'е». Не выполнять молча. ## Что есть в M4 и M10 | Этап | UI | |---|---| | M4 | оверлей отладки: FPS/RTF, число тел, причины кадров, время подсистем; прямоугольники, текст, линии, клип | | M10 | панели и сплиттеры, дерево конструкции, таблица свойств, графики, 3D-вид, диалоги, текстовые поля | Виджеты вводятся по одному и только под конкретную задачу редактора. Зоопарк «на будущее» запрещён (KISS). ## Управление (M4) В окне одна сцена: тележка на террейне. Ввод задаёт только цель моторов на границе кадра и не меняет шаг симуляции. | Ввод | Действие | |---|---| | `W` / `S` | газ вперёд / назад (тележка) | | `A` / `D` | поворот влево / вправо (тележка) | | Стрелки | камера: вперёд/назад, влево/вправо | | `Q` / `E` | камера вниз / вверх | | `Shift` | ускорить камеру | | ЛКМ + мышь | обзор камерой | | `Escape` | выход | Когда клавиши отпущены, цель моторов — ноль: тележка тормозит, а не катится по инерции. ## Текст - Сейчас: `fontdue` только растеризует глифы, раскладку строк и переносы делаем сами. Для латиницы и кириллицы этого достаточно. - Текстовые поля требуют shaping и IME. Решение отложено до M10: кандидаты — `cosmic-text` или `Parley` (+ `glyphon` для wgpu). Берём только когда появляется настоящее поле ввода, с записью в DECISIONS.md. - Курсор, выделение, копирование и IME не эмулируем частично: либо полноценно, либо поле ввода не выпускаем. ## Что взято из ShapeUI blueprint Локальная копия: `ref/shapeui-blueprint_v0.2_revised_ru.md` (в git не входит). Из него берём идеи, не архитектуру: - event-driven redraw и счётчик причины кадра; - render command list и батчинг вместо draw call на виджет; - общий glyph atlas; - раздельные dirty-флаги (стиль, layout, текст, геометрия); - capability-модель вместо обещаний `bool`; - оверлей диагностики: PSS/RSS, draw calls, offscreen passes, кеши, причина кадра; - дисциплину «сначала панели/текст/ввод, потом виджеты». ## Что из ShapeUI не берём - Окна произвольной формы, click-through, `wl_region`, `set_input_region`: у нас обычное окно, этим занимается `winit`. - Свой Wayland-backend и raw `wl_surface`: дублирует `winit`. - CPU-рендерер, Vello, несколько backend'ов, morphing, shader marketplace. - Собственный scene graph с реконсиляцией до доказанной необходимости. - Доступность (AccessKit) с первого дня; вернёмся к ней перед публичным релизом. ## Диагностика Оверлей показывает то, что можно проверить: ``` PSS / RSS 38.4 / 51.1 MiB (estimated) draw calls 6 offscreen 1 pipelines 5 glyph atlas 2.1 MiB frames last 10s 0 last frame Idle ``` Числа не выдаются за «всю VRAM процесса»; приблизительные помечаются `estimated`. ## Открыто - Shaping и IME для текстовых полей: `cosmic-text` или `Parley`, решаем на M10. - Нужен ли retained-слой: решаем по профилировке M10, не заранее. - Графики: своя простая отрисовка линий и областей; библиотеку не берём.