374 строк · 32 КиБ
docs/UI-DESIGN-SPEC.md
| 1 | # Спецификация интерфейса Chimera-Launcher, 2026-09-24 |
| 2 | |
| 3 | Задача: интерфейс должен быть качественным, красивым и настраиваемым. |
| 4 | Это касается шрифтов, линий, кнопок, фонов и раскладки. Документ собран |
| 5 | из трёх частей: |
| 6 | - аудита текущего интерфейса: 15 страниц и страница игры на ширинах 1100 |
| 7 | и 1600, сборка 0.1.51; |
| 8 | - чтения `chl-gui/src/theme.rs`; |
| 9 | - обзора лучших практик: GNOME HIG, исходники стилей libadwaita, Steam |
| 10 | Library Assets, Microsoft «Designing for Xbox and TV», Playnite, WCAG 2.2. |
| 11 | |
| 12 | Источники перечислены в конце. |
| 13 | |
| 14 | Внедряет сессия, которая ведёт `chl-gui`. Каждую правку нужно проверить |
| 15 | снимком «после» на тех же двух ширинах. |
| 16 | |
| 17 | ## 0. Рамки |
| 18 | |
| 19 | - **Тёмная тема остаётся принудительной** (`ForceDark`). HIG допускает её |
| 20 | для приложений, где много картинок: обложки, hero, видео. Светлую тему |
| 21 | делать отдельным решением владельца. |
| 22 | - **«Стекло» над живым фоном остаётся**, но с правилами контраста |
| 23 | (раздел 3.4). |
| 24 | - **Версии.** В комплекте GTK 4.22.5 и libadwaita 1.9.4: в |
| 25 | `packaging/out/payload/lib` есть `adw_sidebar_new` и |
| 26 | `adw_style_manager_get_accent_color`. Rust-обёртка сейчас |
| 27 | `libadwaita = 0.9.2` с `features = ["v1_7"]`. |
| 28 | - Если для `AdwSidebar` (1.9) или `AdwToggleGroup` (1.7) не хватает |
| 29 | фичи обёртки, её поднимают. Если нужной версии обёртки нет, остаётся |
| 30 | текущий виджет. |
| 31 | - GTK 4.22 уже умеет `backdrop-filter` и `@media (prefers-reduced-motion)`. |
| 32 | Libadwaita 1.9 тоже учитывает reduced motion. |
| 33 | |
| 34 | Снимки «до» не коммитятся: они весят около 8 МБ. Повторить их одной командой: |
| 35 | |
| 36 | ```bash |
| 37 | G=~/.cache/chimera-launcher-dev/target/debug/chimera-launcher |
| 38 | for p in library stats media downloads accounts settings wine appearance gamepad launcher backups doctor updates about; do |
| 39 | CHL_SCREENSHOT_DELAY=3500 CHL_WINDOW_WIDTH=1100 CHL_WINDOW_HEIGHT=720 $G --page $p --screenshot /tmp/ui/$p-1100.png |
| 40 | done |
| 41 | CHL_SCREENSHOT_DELAY=3500 CHL_WINDOW_WIDTH=1100 CHL_WINDOW_HEIGHT=720 $G --page library --game "Gothic 1 Remake" --screenshot /tmp/ui/game-1100.png |
| 42 | ``` |
| 43 | |
| 44 | ## 1. Что найдено при аудите |
| 45 | |
| 46 | | # | Где | Что | Почему плохо | |
| 47 | |---|---|---|---| |
| 48 | | A1 | `theme.rs` | 14 разных `font-size` (от .7em до 3.4em) и 5 весов (300/500/600/700/800) | Нет шкалы: соседние тексты отличаются на 2–4%, и глаз видит неаккуратность, а не иерархию. HIG просит минимум размеров | |
| 49 | | A2 | `theme.rs` | 8 радиусов: 6, 7, 10, 12, 13, 14, 16, 999 | Карточки, строки и кнопки скруглены «почти одинаково» и выглядят как ошибка вёрстки | |
| 50 | | A3 | `theme.rs` | Цвета статусов прямо в hex (`#f08a8a`, `#e8c07a`, `#6bd6a8`, `#7fd0ff`, `#c0392b`) | Не меняются с палитрой и не работают в высоком контрасте. В libadwaita для этого есть `--success/warning/error-color` | |
| 51 | | A4 | Сайдбар | 15 пунктов по ~66px, при высоте 720 прокручивается | В строке сайдбара по HIG хватает ~40–44px. Нижние разделы («Бэкапы», «Диагностика») не видны без прокрутки | |
| 52 | | A5 | Переключатели | Три вида одного и того же: пилюли со значком (магазины, вкладки настроек, «Сборки Wine»), сцепленные кнопки (фильтр статуса, «Статистика»), вкладки игры | Одно действие — три внешних вида | |
| 53 | | A6 | Библиотека | Над сеткой 4 ряда: магазины, «Продолжить», поиск/добавить/сортировка, фильтр статуса. Около 270 из 720px | Контент (обложки) начинается ниже трети окна | |
| 54 | | A7 | Плитки | Название игры белым поверх постера, где логотип уже есть на самом арте | Steam прямо требует: на постере только арт и логотип. Двойная подпись и обрезанные «Adobe Photoshop 20…» | |
| 55 | | A8 | Плитки без обложки | Плоская заливка и огромная буква «W» | Похоже на незагруженное изображение, а не на осознанную заглушку | |
| 56 | | A9 | Страница игры | Вкладки над hero; «Запустить» справа сверху, отдельно от названия; «Об игре» показывает «Источник: вручную» и пути | Главное (время в игре, последний запуск, совместимость, античит) на странице не видно. Пути — служебное и уместно во вкладках «Запуск»/«Префикс» | |
| 57 | | A10 | Настройки игры | В каждой строке постоянно развёрнуты описание и «Когда менять» по 2–4 строки | Стена текста: на 720px видно 3 настройки | |
| 58 | | A11 | Внешний вид | Палитры — список радиокнопок. Яркость и прозрачность — `0,50 −/+` | Цвет выбирают глазом: нужны образцы. Непрерывную величину удобнее менять ползунком | |
| 59 | | A12 | Статистика | Итоги («Наиграно 1445 ч») — строками списка. «Средняя сессия отсюда 12 с» | Главные числа не выделены. 12 секунд — среднее с учётом мгновенных выходов, то есть число неверное по смыслу | |
| 60 | | A13 | Настраиваемость | Есть палитра, фон, прозрачность, плитки, сортировка, свёрнутый сайдбар. Нет: размера шрифта, плотности, скруглений, акцента отдельно от палитры, сброса | Настройка шрифта — первое, что ищут на 4K и на Steam Deck | |
| 61 | |
| 62 | ## 2. Токены |
| 63 | |
| 64 | Вся тема — переменные на `:root`, которые задаются из `appearance.rs`. В |
| 65 | правилах CSS чисел нет, только переменные и классы libadwaita. Каждая |
| 66 | настройка меняет одну переменную и имеет ограниченный набор шагов. |
| 67 | |
| 68 | ### 2.1 Типографика: классы libadwaita вместо своих `font-size` |
| 69 | |
| 70 | | Роль | Класс | Размер (1.8/1.9) | Где | |
| 71 | |---|---|---|---| |
| 72 | | Название на hero | `.title-1` | 181%, 800 | страница игры | |
| 73 | | Заголовок страницы или большой счётчик | `.title-2` | 136%, 800 | статистика, пустые состояния | |
| 74 | | Подзаголовок раздела | `.title-4` | 118%, 700 | группы внутри вкладок | |
| 75 | | Название плитки, пункт «Продолжить» | `.heading` | 100%, 700 | сетка | |
| 76 | | Основной текст | базовый | 100% | строки | |
| 77 | | Подписи, метаданные | `.caption` | 82%, межстрочный 140% | время, размеры, источник | |
| 78 | | Бейджи | `.caption-heading` | 82%, 700 | Steam, «файла нет», ProtonDB | |
| 79 | |
| 80 | - Все 14 размеров из `theme.rs` сводятся к этим семи. Своё значение |
| 81 | остаётся одно — `--chl-hero-title-scale` для названия на hero, если |
| 82 | `.title-1` мал на 1600+. По умолчанию 1, диапазон 1–1.6. |
| 83 | - Цифры (время, размеры, проценты, FPS, прогресс) получают `.numeric`, |
| 84 | то есть табличные цифры. |
| 85 | - `.dim-label` заменить на `.dimmed`: первый устарел с libadwaita 1.7. |
| 86 | - Капс («ПРОДОЛЖИТЬ») убрать. HIG капс не рекомендует: заголовок блока — |
| 87 | `.caption-heading` обычным регистром. |
| 88 | - Шрифт — системный. Cantarell/DejaVu в комплекте только запасные. На KDE |
| 89 | это Noto Sans, и он крупнее; масштаб решается настройкой из 2.5, а не |
| 90 | своим `font-size`. |
| 91 | |
| 92 | ### 2.2 Отступы: шаг 6 |
| 93 | |
| 94 | `--chl-space-1: 6px; --chl-space-2: 12px; --chl-space-3: 18px; --chl-space-4: 24px; --chl-space-6: 36px` |
| 95 | |
| 96 | - Страница: поля 24px сверху и снизу, 12px по бокам, между группами 24px. |
| 97 | Это отступы `AdwPreferencesPage` в libadwaita. |
| 98 | - Сетка библиотеки: промежуток между плитками — `--chl-grid-gap`, равный |
| 99 | 12px при обычной плотности (2.5). |
| 100 | - Строка списка: не ниже 50px (как у `AdwActionRow`), внутренние поля 6/12px. |
| 101 | |
| 102 | ### 2.3 Скругления: пропорция 9/12/15 |
| 103 | |
| 104 | `--chl-radius-scale` (0.5 / 1 / 1.35), пресеты «Строгие / Обычные / Мягкие»: |
| 105 | - кнопка, бейдж — `calc(9px * var(--chl-radius-scale))`; |
| 106 | - карточка, плитка, boxed list, строка «Продолжить» — `12px × scale`; |
| 107 | - диалог, поповер, панели «стекла» — `15px × scale`; |
| 108 | - пилюли (Play, фильтры) — `999px`, не масштабируются. |
| 109 | |
| 110 | Все восемь нынешних радиусов сводятся к этим трём уровням. |
| 111 | |
| 112 | ### 2.4 Цвета |
| 113 | |
| 114 | - **Палитра задаёт фон и акцент.** Шесть палитр (`Teal … Graphite`) |
| 115 | переопределяют `--accent-bg-color`/`--accent-fg-color` на `:root`, как |
| 116 | описано в «Styles & Appearance». Отдельно появляется вариант |
| 117 | «Системный акцент» (`AdwStyleManager:accent-color`, libadwaita 1.6+), |
| 118 | чтобы акцент можно было выбрать независимо от палитры фона. |
| 119 | - **Статусы — через переменные libadwaita.** Работает → |
| 120 | `--success-color`, требует настройки → `--warning-color`, не работает / |
| 121 | ошибка → `--error-color`, информация → `--accent-color`. Hex из A3 убрать. |
| 122 | - **Акцент не заливает большие поверхности.** Выделение пункта сайдбара — |
| 123 | фон `--chl-panel-hover` и тонкая полоса или точка акцента, а не |
| 124 | акцентная рамка на всю строку, как сейчас. |
| 125 | - **Бейдж понятен без цвета.** ProtonDB — словом («Gold»), античит — словом |
| 126 | и значком. Только цвет не годится (HIG, WCAG 1.4.1). |
| 127 | |
| 128 | ### 2.5 Настраиваемость — новые и изменённые переменные |
| 129 | |
| 130 | | Настройка | Переменная | Шаги | По умолчанию | |
| 131 | |---|---|---|---| |
| 132 | | Размер шрифта | корневой `font-size` окна | 90 / 100 / 115 / 130 / 150% | 100% | |
| 133 | | Плотность | `--chl-density`: высота строки −0/−4/−8px, промежуток сетки 12/9/6px | Обычная / Плотная / Компактная | Обычная | |
| 134 | | Скругления | `--chl-radius-scale` | Строгие / Обычные / Мягкие | Обычные | |
| 135 | | Акцент | `--accent-bg-color` | «Из палитры» / «Системный» / 9 цветов libadwaita | Из палитры | |
| 136 | | Прозрачность панелей | `--chl-panel-alpha` | 0.55–0.95, ползунок | 0.70 | |
| 137 | | Фон | уже есть: палитра, яркость, видео/картинка | + «Размытие фона» 0/8/16px и «Затемнение фона» 0–60% | 8px, 30% | |
| 138 | | Плитки | уже есть `tile_scale` 0.6–1.5 → шаги S/M/L/XL | L = 300×450 | M | |
| 139 | | Подписи под обложками | «Всегда / Только без обложки / Никогда» | — | Только без обложки | |
| 140 | | Неустановленные игры | «Как есть / Приглушить» | — | Приглушить | |
| 141 | | Анимации | «Живой фон» + следование `prefers-reduced-motion` | — | Вкл, но выкл при reduced motion | |
| 142 | |
| 143 | Правила: |
| 144 | - Применяется сразу, без «Сохранить». |
| 145 | - У каждой группы на странице «Внешний вид» кнопка «Сбросить», внизу — |
| 146 | «Сбросить всё». |
| 147 | - Сброс не спрашивает подтверждения: после него toast «Сброшено» с |
| 148 | кнопкой «Вернуть». |
| 149 | - Нижняя граница прозрачности 0.55 не случайна, см. 3.4. |
| 150 | |
| 151 | ## 3. Правила компонентов |
| 152 | |
| 153 | ### 3.1 Кнопки |
| 154 | |
| 155 | - На одном виде одна кнопка `suggested-action`. В библиотеке это |
| 156 | «Добавить игру», на странице игры — «Запустить» (плюс `.pill`). |
| 157 | «Поставить новее» на странице сборок — обычная, иначе акцентов пять. |
| 158 | - Опасное действие — `destructive-action` только внутри диалога |
| 159 | подтверждения. В строках удаление — плоская кнопка со значком корзины и |
| 160 | всплывающей подсказкой. |
| 161 | - Вне заголовка кнопка — либо значок, либо текст, не оба. Исключение — |
| 162 | «Запустить» и «Добавить игру». |
| 163 | - Кнопки управления окном — штатные (`GtkWindowControls`). Свои квадратные |
| 164 | с рамкой выбиваются из системы. |
| 165 | |
| 166 | ### 3.2 Переключатели (A5): два вида на всё приложение |
| 167 | |
| 168 | - **Смена вида/раздела** («Об игре / Запуск / Настройки…», «Сборки / |
| 169 | Снимки», вкладки настроек) — `AdwInlineViewSwitcher`, как уже в |
| 170 | шапке 0.1.50. Значок и подпись. |
| 171 | - **Фильтр** (магазин, статус установки, фильтр статистики) — |
| 172 | `AdwToggleGroup` (libadwaita 1.7). Только подписи, без значков. Фильтры |
| 173 | магазина и статуса стоят в одной строке рядом (A6). |
| 174 | |
| 175 | ### 3.3 Списки и страницы настроек (A10) |
| 176 | |
| 177 | - Длинные страницы — `AdwPreferencesPage` → `AdwPreferencesGroup` |
| 178 | с заголовком и одной строкой описания. |
| 179 | - Строка настройки: название и подзаголовок **одной строкой**, то есть |
| 180 | `doc` из реестра. «Когда менять» (`impact`) убирается из строки в |
| 181 | поповер по круглой плоской кнопке `dialog-information-symbolic` или |
| 182 | в `AdwExpanderRow`. |
| 183 | - В строке не больше двух элементов управления: значение и «сбросить». |
| 184 | Сейчас их три (значение, сброс, стрелка). |
| 185 | - Строка-переход (открывает подстраницу) заканчивается `go-next-symbolic`. |
| 186 | - Непрерывные величины (яркость, прозрачность, размытие) — `GtkScale` с |
| 187 | метками и значением `.numeric` справа. Дискретные — `AdwSpinRow` или |
| 188 | выпадающий список (A11). |
| 189 | |
| 190 | ### 3.4 «Стекло» и контраст |
| 191 | |
| 192 | Расчёт для белого текста над самым светлым пикселем фона: |
| 193 | |
| 194 | | Непрозрачность подложки | Белый текст | `.dimmed` (55%) | |
| 195 | |---|---|---| |
| 196 | | 0.55 | 4.8:1 — AA | 2.6:1 | |
| 197 | | 0.70 | 8.5:1 | 3.9:1 | |
| 198 | | 0.80 | 12.6:1 | 5.0:1 — AA | |
| 199 | |
| 200 | Правила: |
| 201 | - Под любым текстом подложка не прозрачнее 0.55. Отсюда нижняя граница |
| 202 | ползунка из 2.5. |
| 203 | - Приглушённый текст (подзаголовки строк, метаданные) — либо на подложке |
| 204 | от 0.8, либо фон под панелью затемнён и размыт. |
| 205 | - **Размывать и затемнять один слой фона**, а не каждую панель: |
| 206 | `backdrop-filter` на панелях поверх анимации пересчитывается каждый |
| 207 | кадр. Размытый и затемнённый фон рисуется один раз за кадр фона, поверх |
| 208 | лежат тонированные подложки с `--border-color` в 1px. |
| 209 | - На hero под названием и кнопкой — градиентное затемнение снизу вверх, |
| 210 | прозрачность от 0.75 до 0. |
| 211 | - Проверка: пипеткой на трёх самых светлых кадрах анимации в каждой |
| 212 | палитре. Текст ≥ 4.5:1, элементы управления и границы полей ≥ 3:1. |
| 213 | |
| 214 | ### 3.5 Движение |
| 215 | |
| 216 | - Живой фон стоит, если окно `suspended`, неактивно или идёт игра. Частота |
| 217 | до 30 кадров в секунду. Это уже сделано в 0.1.50, проверить, что |
| 218 | осталось в силе. |
| 219 | - `@media (prefers-reduced-motion: reduce)` и |
| 220 | `gtk-interface-reduced-motion`: фон статичен, переходы короче. WCAG 2.2.2 |
| 221 | требует возможность остановить движение дольше 5 секунд. |
| 222 | - Переходы — штатные `AdwNavigationView`/`AdwViewStack`, свои анимации не |
| 223 | нужны. |
| 224 | |
| 225 | ### 3.6 Пустые состояния и обратная связь |
| 226 | |
| 227 | - Пустая библиотека (первый запуск) — `AdwStatusPage`: значок приложения, |
| 228 | «Здесь будут ваши игры», кнопки «Добавить игру» и «Подключить Steam». |
| 229 | - Пустой результат поиска или фильтра — `AdwStatusPage.compact` с |
| 230 | символьным значком и «Сбросить фильтры». |
| 231 | - Действие с возвратом (удалить из библиотеки, сбросить внешний вид) — |
| 232 | toast с «Вернуть». |
| 233 | - Необратимое (удалить сборку, префикс) — `AdwAlertDialog`: «Отмена» |
| 234 | первой, вторая кнопка — глагол («Удалить»), не «OK». |
| 235 | - Ошибка сети или устаревший каталог — `AdwBanner` над страницей. |
| 236 | |
| 237 | ### 3.7 Клавиатура |
| 238 | |
| 239 | `Ctrl+F` — поиск, `Ctrl+,` — настройки лаунчера, `Ctrl+?` — |
| 240 | `AdwShortcutsDialog`, `Alt+←` — назад, `F11` — Big Picture (оставить). |
| 241 | Стрелки двигают фокус по сетке. Кольцо фокуса штатное: 2px, акцент 50%. |
| 242 | |
| 243 | ## 4. Правки по страницам |
| 244 | |
| 245 | Приоритет: **P1** — видно на первом экране или ломает правила выше; |
| 246 | **P2** — заметно при работе; **P3** — улучшение. |
| 247 | |
| 248 | ### Каркас окна |
| 249 | 1. **P1.** Сайдбар: строка 40–44px, между группами 12px, заголовки групп — |
| 250 | `.caption-heading .dimmed`. Все 15 пунктов влезают в 720px без |
| 251 | прокрутки (A4). Выделение — по 2.4. |
| 252 | 2. **P1.** Штатные кнопки окна (3.1). |
| 253 | 3. **P2.** Заголовок в шапке повторяет выбранный пункт сайдбара. Оставить, |
| 254 | но `.heading` вместо своего размера. На странице игры в шапке — имя игры. |
| 255 | |
| 256 | ### Библиотека |
| 257 | 4. **P1.** Над сеткой два ряда вместо четырёх (A6): |
| 258 | - первый: поиск, «Добавить игру» (suggested), сортировка, вид сетки; |
| 259 | - второй: `AdwToggleGroup` магазина и `AdwToggleGroup` статуса в одну |
| 260 | строку. |
| 261 | 5. **P1.** «Продолжить» — горизонтальная полка карточек по пропорции |
| 262 | header-арта Steam 920×430 (≈ 2.14:1), высота 88–110px: арт, название |
| 263 | `.heading`, «сегодня, 16:50 · 42 с» `.caption .numeric`, круглая кнопка |
| 264 | Play. Без капс-заголовка. |
| 265 | 6. **P1.** Подпись под обложкой — по настройке из 2.5, по умолчанию только |
| 266 | для игр без арта (A7). Название целиком видно во всплывающей подсказке и |
| 267 | под плиткой в режиме «Всегда», в две строки с многоточием. |
| 268 | 7. **P1.** Заглушка без обложки (A8): градиент из двух цветов палитры, |
| 269 | сдвинутый по хэшу имени, чтобы заглушки различались. В центре значок |
| 270 | `applications-games-symbolic` 48px и название `.heading` в 2–3 строки. |
| 271 | Огромной буквы нет. |
| 272 | 8. **P2.** Бейджи в одном месте и одного вида: левый верхний угол, |
| 273 | `.caption-heading`, радиус 9×scale, подложка 0.7. Магазин — |
| 274 | нейтральный, «файла нет» — `--error-color`, ProtonDB/античит — текстом |
| 275 | (2.4). |
| 276 | 9. **P2.** Неустановленные игры приглушены до 60% (Playnite так делает), |
| 277 | по настройке. |
| 278 | |
| 279 | ### Страница игры (A9) |
| 280 | 10. **P1.** Порядок сверху вниз: |
| 281 | - hero на всю ширину: обрезка по центральной зоне 860×380 из 1920×620; |
| 282 | - поверх hero — градиент (3.4), слева снизу логотип игры (Steam logo |
| 283 | asset) или `.title-1`; |
| 284 | - рядом с названием — «Запустить» `suggested-action pill`, а в режиме |
| 285 | Big Picture фокус сразу на ней; |
| 286 | - под названием строка фактов `.caption .numeric`: «124 ч · последний |
| 287 | запуск вчера · GE-Proton11-6 · ProtonDB: Gold · Античит: работает»; |
| 288 | - **под** hero — вкладки. |
| 289 | «Назад» — плоская кнопка со стрелкой в шапке, а не квадрат с рамкой. |
| 290 | 11. **P1.** «Об игре» начинается с того, ради чего её открывают: |
| 291 | - время в игре и последние сессии; |
| 292 | - совместимость (ProtonDB, protonfixes, античит из `chl hints --json`), |
| 293 | предупреждение про античит `AdwBanner` над вкладками; |
| 294 | - описание из базы знаний. |
| 295 | Пути и «Источник: вручную» — в «Запуск» / «Префикс». |
| 296 | 12. **P2.** Карточка «Не хватает в префиксе» (0.1.50) — на «Об игре», если |
| 297 | есть что докачать, иначе только на «Запуск». |
| 298 | |
| 299 | ### Настройки игры и лаунчера (A10) |
| 300 | 13. **P1.** Строки по 3.3. `impact` в поповер. На 720px должно быть видно |
| 301 | не меньше 6 настроек. |
| 302 | 14. **P2.** Каждая вкладка — группы с заголовком и описанием одной |
| 303 | строкой. «Сбросить группу» — в заголовке группы, плоская кнопка. |
| 304 | 15. **P2.** Настройка, отличная от общих умолчаний, помечена точкой акцента |
| 305 | слева от названия. Сейчас это видно только по кнопке сброса. |
| 306 | |
| 307 | ### Внешний вид (A11, A13) |
| 308 | 16. **P1.** Палитры — сетка образцов (`GtkFlowBox`): карточки 120×72 с |
| 309 | градиентом палитры, подпись под ними, выбранная обведена кольцом |
| 310 | акцента. Плюс карточка «Системный акцент». |
| 311 | 17. **P1.** Ползунки вместо «−/+» (3.3). Новые настройки из 2.5: размер |
| 312 | шрифта, плотность, скругления, акцент, размытие и затемнение фона, |
| 313 | подписи под обложками, неустановленные игры. Всё применяется сразу. |
| 314 | 18. **P2.** Справа или сверху — живое превью: мини-плитка, строка списка и |
| 315 | кнопка Play в текущих настройках. Внизу «Сбросить всё». |
| 316 | |
| 317 | ### Статистика (A12) |
| 318 | 19. **P2.** Сверху — ряд из 3–4 плиток-итогов: «Наиграно» `.title-2 |
| 319 | .numeric`, «Запусков», «Игр с историей», «Любимая игра». Ниже — |
| 320 | нынешние списки. |
| 321 | 20. **P2.** «Средняя сессия» считать по сессиям длиннее минуты, иначе |
| 322 | мгновенные выходы (отладка, падения) дают «12 с». Счёт живёт в |
| 323 | `chl-gui/src/stats_page.rs`. |
| 324 | |
| 325 | ### Сборки Wine |
| 326 | 21. **P2.** Переключатель режима обновлений `wine_auto_update` |
| 327 | (Не проверять / Сообщать / Ставить сам) в группе «Каталог сборок». |
| 328 | Сделано 2026-09-24 (7073988). |
| 329 | 22. **P3.** «Поставить новее» — обычная кнопка (3.1). Итог установки — |
| 330 | toast. Сделано 2026-09-24 (9046eca); заодно обычной стала «Поставить» |
| 331 | в каталоге (a96b132). |
| 332 | |
| 333 | ### Big Picture (F11) |
| 334 | 23. **P2.** Отдельная раскладка, а не только крупные плитки: |
| 335 | - макет под 960×540 эффективных пикселей при масштабе 2×; |
| 336 | - текст от 15 epx (второстепенный — от 12); |
| 337 | - цели от 32 epx; |
| 338 | - безопасная зона 48/27 epx; |
| 339 | - фокус — рамка 3px акцента и лёгкое увеличение плитки, контраст ≥ 3:1; |
| 340 | - A — выбрать, B — назад (кнопку «Назад» на экране не рисовать), |
| 341 | Y — поиск, LB/RB — наборы фильтров, Menu — действия; |
| 342 | - подсказки кнопок внизу по активному устройству ввода, без tooltips. |
| 343 | |
| 344 | ### Проверка в конце |
| 345 | 24. **P1.** Матрица снимков «после»: каждая страница на 1100 и 1600, |
| 346 | системный шрифт 100% и 150%, `prefers-contrast: more`, три палитры |
| 347 | (Бирюза, Янтарь, Графит). Контраст — пипеткой по 3.4. |
| 348 | Сделано 2026-09-24: `tools/ui-matrix/run.sh`, контраст по рамкам слов |
| 349 | tesseract и формуле WCAG вместо пипетки; `prefers-contrast: more` — |
| 350 | через `ADW_DEBUG_HIGH_CONTRAST=1`. Находки и исправления — DEVLOG за |
| 351 | 2026-09-24 (поздний вечер). |
| 352 | |
| 353 | ## 5. Порядок внедрения |
| 354 | |
| 355 | 1. Токены (раздел 2) в `theme.rs` без изменения внешнего вида: замена |
| 356 | чисел на переменные с текущими значениями. Проверка — снимки |
| 357 | совпадают «до» и «после». |
| 358 | 2. Сведение к шкале: 2.1, 2.3, цвета статусов 2.4. Затем каркас: пункты |
| 359 | 1–3. |
| 360 | 3. Библиотека, пункты 4–9, и страница игры, 10–12. |
| 361 | 4. Настройки, 13–15, и «Внешний вид» с новыми настройками, 16–18. |
| 362 | 5. Статистика, сборки, Big Picture: 19–23. |
| 363 | 6. Матрица проверки, пункт 24. Затем выпуск и публичная выкладка по |
| 364 | решению владельца. |
| 365 | |
| 366 | ## Источники |
| 367 | |
| 368 | - libadwaita: [style classes](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/style-classes.html), [CSS variables](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/css-variables.html), [Styles & Appearance](https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/styles-and-appearance.html), [adaptive layouts](https://gitlab.gnome.org/GNOME/libadwaita/-/raw/libadwaita-1-8/doc/adaptive-layouts.md), [SCSS 1.8](https://gitlab.gnome.org/GNOME/libadwaita/-/tree/libadwaita-1-8/src/stylesheet) |
| 369 | - GNOME HIG: [typography](https://developer.gnome.org/hig/guidelines/typography.html), [buttons](https://developer.gnome.org/hig/patterns/controls/buttons.html), [boxed lists](https://developer.gnome.org/hig/patterns/containers/boxed-lists.html), [adaptive](https://developer.gnome.org/hig/guidelines/adaptive.html), [toasts](https://developer.gnome.org/hig/patterns/feedback/toasts.html), [dialogs](https://developer.gnome.org/hig/patterns/feedback/dialogs.html), [placeholders](https://developer.gnome.org/hig/patterns/feedback/placeholders.html), [keyboard](https://developer.gnome.org/hig/reference/keyboard.html) |
| 370 | - Игры: [Steam Library Assets](https://partner.steamgames.com/doc/store/assets/libraryassets), [Steam Deck compatibility](https://partner.steamgames.com/doc/steamdeck/compat), [Designing for Xbox and TV](https://learn.microsoft.com/en-us/windows/apps/design/devices/designing-for-tv), [Gamepad interactions](https://learn.microsoft.com/en-us/windows/apps/design/input/gamepad-and-remote-interactions), [Playnite Fullscreen](https://api.playnite.link/docs/manual/gettingStarted/playniteFullscreenMode.html) |
| 371 | - Доступность: [WCAG 1.4.3](https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html), [1.4.11](https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html), [2.2.2](https://www.w3.org/WAI/WCAG22/Understanding/pause-stop-hide.html), [2.5.8](https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html), [NN/g Glassmorphism](https://www.nngroup.com/articles/glassmorphism/) |
| 372 | - GTK: [NEWS 4.22](https://gitlab.gnome.org/GNOME/gtk/-/raw/gtk-4-22/NEWS), [GtkWindow:suspended](https://docs.gtk.org/gtk4/property.Window.suspended.html), [gtk-interface-reduced-motion](https://docs.gtk.org/gtk4/property.Settings.gtk-interface-reduced-motion.html) |
| 373 | - Шрифты: [Adwaita Fonts](https://blogs.gnome.org/monster/introducing-adwaita-fonts/), [Inter](https://rsms.me/inter/) |
| 374 |