75 KiB
MASTER PROMPT — Adaptive Material 3 Linux Shell
Полная адаптивная оболочка Hyprland + Quickshell для Desktop, Tablet и Phone
Ты — senior Linux systems engineer, Wayland compositor developer, Qt 6/QML architect, Rust developer и специалист по мобильным Linux-окружениям.
Твоя задача — превратить мою существующую конфигурацию Hyprland в полноценное конвергентное Linux-окружение на базе Quickshell и Google Material Design 3, одинаково пригодное для компьютеров, планшетов и телефонов.
Требуется не прототип, не набор демонстрационных QML-экранов, а работоспособная, оптимизированная, интегрированная оболочка.
Главное требование: не создавай новую конфигурацию Hyprland вместо существующей. Изучи мои текущие настройки и аккуратно модифицируй их, сохранив всю функциональность, которую я уже использую.
Продолжай реализацию по этапам, проверяй результат, исправляй ошибки и документируй технические ограничения.
1. Исходная система
Документ — задание на будущую реализацию, а не описание готовой Quickshell-оболочки. Срез рабочего дерева репозитория обновлён 17 ноября 2026 года. Перед реализацией повторно сверь его с файлами: локальные изменения могут отличаться от последнего коммита.
Заявленные целевые платформы:
- Arch Linux на desktop, архитектура x86_64.
- Arch Linux ARM на телефоне, архитектура aarch64.
- Сенсорный ввод на телефоне, внешние мониторы и отпечаток пальца на поддерживаемом оборудовании.
- Ручной запуск desktop-сессии из TTY без обязательного Display Manager.
Наличие телефона, датчиков, сканера, конкретного аудиосервера и установленные версии компонентов нельзя установить по одним dotfiles. Подтверди их отдельным аудитом целевой машины.
1.1. Фактическая структура репозитория
Основная конфигурация композитора — hypr/hyprland.lua, использующая API hl.*. Не создавай вместо неё новый hyprland.conf и не переноси настройки обратно в conf-синтаксис без обоснованной необходимости.
| Файлы | Текущее назначение |
|---|---|
hypr/hyprland.lua |
Подключает keybinds, windowrules, startup, monitors, environment, keyboard, gestures, decoration, animation; задаёт общие параметры композитора |
hypr/keybinds.lua, hypr/programs.lua |
Привязки клавиш и команды приложений; programs подключается из keybinds |
hypr/startup.lua |
Автозапуск через обработчик hl.on("hyprland.start", ...) |
hypr/monitors.lua |
В текущем рабочем дереве: DP-1, 3440x1440@165.00Hz, позиция 0x0, scale 1; это профиль desktop, а не универсальная настройка |
hypr/keyboard.lua, hypr/gestures.lua |
Раскладки, устройства ввода и трёхпальцевые жесты тачпада |
hypr/decoration.lua, hypr/animation.lua, hypr/windowrules.lua |
Оформление, анимации, правила окон и слоёв |
hypr/hypridle.conf, hypr/hyprlock.conf, hypr/hyprpaper.conf |
Отдельные конфигурации соответствующих демонов; выясни реальные пути загрузки в сессии |
hypr/hypridle.lua, hypr/hyprlock.lua, hypr/hyprpaper.lua |
Результаты hyprconf2lua с предупреждениями/TODO; основной hyprland.lua их не подключает. Не считай их рабочей заменой .conf |
hypr/monitors.conf, hypr/workspaces.conf |
В текущем рабочем дереве пустые; основной Lua entrypoint их не подключает |
waybar/config.jsonc, waybar/style.css, waybar/scripts/ |
Текущая панель и вспомогательные скрипты |
swaync/config.json, swaync/style.css |
Центр уведомлений |
rofi/launcher/, rofi/powermenu/, rofi/emoji/, rofi/clipboard/ |
Лаунчер, питание, emoji и отдельный clipboard-сценарий |
hypr/bin/ |
Скрипты обоев, блокировки, экранной клавиатуры, обновления и перезапуска компонентов |
shell/source.sh |
PATH, Flatpak XDG data paths, alias H='start-hyprland' |
Каталога quickshell/, реализации Material 3 Settings и общего HardwareCapabilityService пока нет. Их нужно создать в рамках будущей реализации. Конфигурации niri/ и mako/ также присутствуют, но текущий Hyprland startup запускает SwayNC; наличие каталога не доказывает запуск сервиса.
1.2. Автозапуск и интеграции, которые нужно сохранить
hypr/startup.lua запускает:
hyprpaper, затем с задержкойhypr/bin/background.sh.waybar,swaync,hypridle,swayosd-server.lxpolkit,nm-applet --indicator,uxplay,unclutter,clipse -listen.- Настройку GTK-темы
MacTahoe-Dark, icon themeMacTahoe-dark, курсораBibata-Modern-Iceразмера 24 и тёмной цветовой схемы. - Импорт
WAYLAND_DISPLAYиXDG_CURRENT_DESKTOPчерезdbus-update-activation-environment --systemdиsystemctl --user import-environment.
Сохраняй polkit agent, clipboard manager и пользовательские приложения. SwayOSD, сетевой апплет и прежние визуальные компоненты отключай только после проверки соответствующей замены. Проверь отсутствие дублирования OSD и конкуренции за D-Bus notifications name. Не запускай Quickshell одновременно из Lua startup и нового systemd unit; выбери один способ с корректным завершением вместе с сессией.
1.3. Существующие сценарии управления
- Основной модификатор — Alt, не Super. Сохрани привязки и их привычные действия.
Alt+Return— Kitty,Alt+T— Thunar,Alt+DиXF86LaunchB— Rofi launcher.Alt+Space— отдельный лаунчерsherlock; не удаляй его при замене Rofi без согласованной замены сценария.Alt+B—hypr/bin/hyprlock-background.sh;Alt+Shift+P— Rofi power menu.Alt+Z— открыть SwayNC,Alt+Shift+R— перечитать его конфигурацию. При миграции перенаправь эти действия на эквиваленты оболочки.Alt+C—kitty clipse;Alt+E— Rofimoji. Скриптrofi/clipboard/clipboard.shиспользует Greenclip, но это отдельный сценарий, не текущий clipboard bind.Alt+Shift+O— переключениеwvkbd-mobintlчерезhypr/bin/toggle_keyboard.sh.- Громкость, mute, микрофон, яркость и media keys используют
swayosd-client; клавиатурная подсветка —brightnessctlс устройствомsmc::kbd_backlight. Не переноси это имя на все устройства. - Сохрани скриншоты через Grim/Slurp/wl-copy, запуск обновлений, навигацию и перемещение окон, workspaces 1–10, special workspace
magicи resize submap. - Ввод:
us,ru, переключениеgrp:win_space_toggle, repeat rate 50, delay 500; touchpad natural scroll и scroll factor 0.2. - Текущие жесты: три пальца horizontal → workspace, up → fullscreen, pinchout → float. Это не реализация глобальных touchscreen-жестов.
- Исходное desktop-оформление: dwindle, gaps 5/5, border 1, rounding 20, blur и shadow выключены. При возврате из мобильного режима восстанавливай пользовательские значения.
1.4. Что перенести из панели и уведомлений
Waybar сейчас показывает launcher, CPU/RAM/temperature/disk, заголовок окна, workspaces, звук/микрофон, MPRIS, подсветку, состояния клавиатуры, язык, батареи, часы, tray и питание. Часы настроены на Asia/Tomsk: сохрани настройку как пользовательское предпочтение.
Сохрани возможность просмотра обновлений и запуска hypr/bin/startupdate.sh (Kitty + sudo pacman -Syu). Не запускай обновления из UI без пользовательского действия и не выдавай успех при ошибке команды.
Различай объявления модулей и их включение в modules-left/center/right: network, bluetooth, privacy, custom/onscreenkeyboard, cava и custom/spotify описаны, но в текущие списки не включены. custom/weather включён в список, но его определения закомментированы. Не считай эти функции подтверждённо работающими. Две записи батарей, включая BAT2, не доказывают наличие двух аккумуляторов.
В SwayNC включены title/clear all, DND, MPRIS, volume, backlight и notifications; тайм-ауты 6 секунд для обычных, 3 для low, 0 для critical. Есть настройки inline replies и 2FA actions. buttons-grid описан, но не включён в widgets; старый путь /home/alien/... не является зависимостью новой оболочки.
1.5. Известные места для проверки при реализации
Это наблюдения по исходникам, а не результаты проверки работающей сессии:
hypr/hypridle.conf: lock commandpidof hyprlock || hyprlock, перед сномloginctl lock-session, после сна DPMS on. Тайм-ауты: 150 — приглушение подсветки, 6000 — lock, 7200 — DPMS off, 8000 — suspend (секунды). В командах подсветки написаноbrightnesctl; проверь и исправь опечатку при реализации, сохранив осознанно выбранные интервалы.- Ручной lock bind использует wrapper со случайными обоями, idle lock запускает Hyprlock напрямую. Объедини поведение через проверенную точку входа, сохранив защиту от повторного запуска и блокировку перед сном.
hypr/bin/hyprlock-background.shменяетhypr/hyprlock.confчерез широкийsedпо строкамPictures. Для новой реализации не используй изменение отслеживаемого конфига как хранилище runtime-состояния.hypr/bin/background.shвыбирает случайные обои из~/Pictures/wallpaperдля мониторов и вызывает Hyprpaper IPC. Учти пустой каталог, пути с пробелами, hotplug и независимые обои выходов.hypr/bin/toggle_keyboard.shхранит флаг в~/.keyboard_started; он может расходиться с состоянием процесса. Сохрани возможность ручного вызова клавиатуры, добавь проверку реального состояния и совместимости с полями ввода/lock screen.- В Waybar MPRIS есть ссылка на
~/dotfiles/ags/media/toggle_media, но каталогаags/в репозитории нет. Не делай отсутствующий AGS обязательной зависимостью. README.mdиINSTALL.mdсодержат старые пути.conf, упоминания Mako/Greenclip/PulseAudio, отсутствующегоinstall_scripts/install.shи инструкции Display Manager. При расхождении опирайся на текущий код и аудит сессии; обнови инструкции в ходе миграции.- Реальный
install_scripts/install-arch.shустанавливает ОС с разметкой/форматированием диска; это не установщик оболочки. Для миграции создай отдельный безопасный механизм установки dotfiles и зависимостей.
Цель — единая оболочка для всех устройств с сохранением этих сценариев, а не три независимых окружения.
Обязательный предварительный аудит
Сначала изучи исходники в корне этого репозитория, затем сопоставь их с реально загруженными файлами и симлинками в пользовательской сессии. Проверь также git status: сохраняй существующие локальные изменения, включая неотслеживаемые файлы; не выполняй автоматический reset/checkout и не включай посторонние правки в свои коммиты.
Перед изменениями изучи:
~/.config/hypr/~/.config/waybar/~/.config/swaync/~/.config/rofi/~/.config/quickshell/~/.config/hypr/hypridle.conf~/.config/hypr/hyprlock.conf- пользовательские скрипты
- systemd user services
- PAM-конфигурацию, относящуюся к блокировке
- текущие способы запуска Hyprland
- установленные версии Hyprland, Quickshell и Qt
- существующие правила окон, рабочих пространств и мониторов
Не предполагай, что конфигурационные файлы находятся только в стандартных местах. Проверь реальные пути и подключаемые конфигурации.
Сделай резервные копии изменяемых файлов.
Если проект находится под Git, используй существующую структуру и сохраняй понятную историю изменений.
Не удаляй существующие пакеты и конфигурации до успешного завершения миграции.
2. Целевая архитектура
Создай одну оболочку Quickshell с общей системой сервисов и адаптивными представлениями.
Архитектура:
Hyprland
│
├── Quickshell
│ ├── Adaptive Shell
│ │ ├── Desktop UI
│ │ ├── Tablet UI
│ │ └── Phone UI
│ │
│ ├── Material 3 Design System
│ │ ├── Colors
│ │ ├── Typography
│ │ ├── Shapes
│ │ ├── Motion
│ │ └── Components
│ │
│ ├── System Bar
│ ├── Quick Settings
│ ├── Notification Center
│ ├── Application Launcher
│ ├── Home Screen
│ ├── Recent Apps
│ ├── Navigation Gestures
│ ├── Wallpaper Engine
│ ├── Secure Lock Screen
│ ├── Power Menu
│ └── Settings Application
│
├── Hypridle
├── NetworkManager
├── BlueZ
├── PipeWire / WirePlumber
├── UPower
├── systemd-logind
├── fprintd / libfprint
└── Linux kernel device interfaces
Quickshell должен быть основным процессом визуальной оболочки.
Не создавай отдельные постоянно работающие приложения там, где функциональность может быть реализована внутри Quickshell.
Допускается небольшой вспомогательный сервис на Rust, если он действительно необходим для безопасного доступа к системным API, обработки жестов или интеграции с аппаратным обеспечением.
Не дублируй сервисы между режимами.
3. Полный Google Material Design 3
Весь интерфейс должен быть выполнен в стиле Google Material Design 3 / Material You.
Официальные ориентиры:
https://m3.material.io/styles/color/system/overview
https://m3.material.io/foundations/layout/understanding-layout/overview
https://fonts.google.com/icons
Требования:
- Полноценная система Material 3 design tokens.
- Dynamic Color на основе обоев.
- Светлая тема.
- Тёмная тема.
- Системная тема.
- AMOLED-тема с настоящим чёрным фоном.
- Ручной выбор accent color.
- Material Symbols.
- Material 3 typography.
- Material 3 switches, sliders, buttons, menus и dialogs.
- Material 3 cards, navigation rail, navigation drawer и bottom navigation.
- Корректные состояния hover, pressed, focused, disabled.
- Плавные, но оптимизированные анимации.
- Поддержка reduced motion.
- Доступность и клавиатурная навигация.
- Корректное масштабирование интерфейса.
Используй единый набор компонентов.
Не создавай три разные темы для телефона, планшета и компьютера. Меняться должны layout, размеры, плотность и способы взаимодействия, а дизайн-система должна оставаться общей.
4. Адаптивная система режимов
Реализуй:
autophonetabletdesktop
Режим должен определяться по сочетанию:
- размера доступной рабочей области
- масштаба дисплея
- наличия сенсорного ввода
- типа устройства
- пользовательских предпочтений
Не определяй режим исключительно по CPU architecture или физическому разрешению экрана.
Поддержи разные режимы на разных мониторах одновременно.
Например:
- Экран телефона: phone mode.
- Внешний монитор: desktop mode.
При подключении и отключении мониторов оболочка должна перестраиваться без перезапуска пользовательских приложений.
Добавь ручное переключение режима в Settings.
5. Замена Waybar
Полностью реализуй верхнюю системную панель в Quickshell.
Desktop:
- Верхняя панель.
- Часы и календарь.
- Рабочие пространства.
- Индикаторы приложений.
- Системный трей.
- Wi-Fi и Ethernet.
- Bluetooth.
- Громкость.
- Микрофон.
- Батарея.
- Яркость.
- Медиаплеер.
- Уведомления.
- Режим «Не беспокоить».
- Меню питания.
- Кнопка запуска приложений.
Tablet:
- Адаптивная системная панель.
- Сенсорные элементы.
- Упрощённые индикаторы.
- Быстрый доступ к многозадачности.
Phone:
- Компактная status bar.
- Время.
- Сигнал сети, если доступен соответствующий backend.
- Wi-Fi.
- Bluetooth при необходимости.
- Батарея.
- Индикаторы состояния.
- Поддержка вырезов и безопасных областей экрана, если информация о них доступна.
Не используй фиктивные значения сигналов, батареи или сети.
6. Замена SwayNC
Реализуй собственный сервер уведомлений через Freedesktop Notifications D-Bus API.
Обязательно:
- Получение уведомлений.
- Уведомления с иконками и изображениями.
- Action buttons.
- Замена уведомлений по ID.
- Группировка по приложениям.
- История уведомлений.
- Удаление свайпом.
- Очистка всех уведомлений.
- Приоритеты.
- Тайм-ауты.
- Do Not Disturb.
- Уведомления на экране блокировки с настройками приватности.
- Ограничение размера истории.
- Сохранение состояния.
- Корректная обработка закрытия и сигналов D-Bus.
В desktop mode используй компактный Notification Center.
В phone mode уведомления должны находиться в единой шторке с быстрыми настройками.
При переходе на новый сервер уведомлений не допускай одновременного запуска SwayNC.
7. Material 3 Quick Settings
Создай полноценный центр управления.
Функции:
- Wi-Fi.
- Ethernet.
- Bluetooth.
- Громкость.
- Выбор аудиоустройств.
- Яркость.
- Батарея.
- Энергосбережение.
- Do Not Disturb.
- Фонарик при наличии.
- Автоповорот при наличии датчиков.
- Медиаплеер через MPRIS.
- Настройки экрана.
- Быстрый переход в Settings.
Используй реальные системные интерфейсы:
- NetworkManager D-Bus.
- BlueZ D-Bus.
- PipeWire / WirePlumber.
- UPower.
- MPRIS.
- power-profiles-daemon или совместимый backend.
- iio-sensor-proxy при наличии.
Не создавай отдельные shell-скрипты для каждого переключателя, если доступен нормальный API.
Все переключатели должны показывать реальное состояние системы.
8. Замена Rofi
Реализуй собственный Application Launcher.
Desktop:
- Material 3 search popup.
- Поиск приложений.
- Клавиатурная навигация.
- Избранное.
- История запуска.
- Поиск файлов через доступный backend.
- Настраиваемые действия.
Tablet:
- Адаптивная сетка приложений.
- Поиск.
- Сенсорное управление.
Phone:
- Полноэкранный App Drawer.
- Сетка иконок.
- Поиск.
- Категории.
- Избранное.
- Поддержка экранной клавиатуры.
Используй XDG Desktop Entries.
Поддерживай Flatpak.
Корректно обрабатывай Desktop Entry Exec, TryExec, NoDisplay, OnlyShowIn, NotShowIn и Desktop Actions.
Не выполняй непроверенные строки поиска как shell-команды.
9. Домашний экран телефона
Реализуй настоящий Home Screen.
Функциональность:
- Сетка приложений.
- Перемещение иконок.
- Папки.
- Dock.
- Несколько страниц.
- Настраиваемые обои.
- Поиск.
- Виджеты при наличии backend.
- Контекстные меню.
- Сохранение состояния.
- Адаптация к повороту экрана.
Домашний экран должен оставаться доступным независимо от того, какие приложения открыты.
Не реализуй его обычным окном, которое случайно может оказаться поверх активных приложений или нарушить фокус.
Используй корректную интеграцию с композитором и слоями Wayland.
10. Recent Apps и многозадачность
Создай мобильный переключатель запущенных приложений.
Функции:
- Карточки открытых окон.
- Иконки приложений.
- Названия.
- Переключение на выбранное окно.
- Закрытие окна свайпом вверх.
- Закрытие нескольких окон.
- Поддержка полноэкранных приложений.
- Корректное восстановление фокуса.
- Поддержка нескольких окон одного приложения.
Для desktop реализуй обзор окон, если это возможно через поддерживаемые API Hyprland.
Для миниатюр используй реальный compositor-compatible механизм.
Не показывай поддельные скриншоты приложений.
Если миниатюры недоступны, используй карточки с иконками и названиями.
11. Мобильная жестовая навигация
Это критически важная функциональность.
Реализуй системные жесты, работающие поверх обычных и полноэкранных приложений.
| Жест | Действие |
|---|---|
| Свайп снизу вверх | Сразу домашний экран |
| Свайп снизу вверх с удержанием | Recent Apps |
| Свайп от левого края вправо | Назад |
| Свайп от правого края влево | Назад |
| Свайп сверху вниз | Шторка уведомлений и быстрых настроек |
| Свайп по нижней полоске влево/вправо | Переключение приложений |
| Свайп карточки вверх в Recent Apps | Закрытие окна |
| Свайп вверх по открытой шторке | Закрытие шторки |
Особые требования
Выход домой — простым свайпом снизу вверх, без удержания.
Для открытия Recent Apps нужно сделать свайп снизу вверх и удержать палец.
Оба боковых края должны поддерживать жест «Назад».
Реализуй:
- Пороги распознавания.
- Настраиваемую чувствительность.
- Визуальную обратную связь.
- Отмену жеста.
- Защиту от ложных срабатываний.
- Поддержку landscape.
- Учёт DPI и масштабирования.
- Приоритет жестов на границах экрана.
- Поддержку настоящего touchscreen input.
Учитывай, что Linux-приложения не имеют универсального действия «Назад».
Создай маршрутизацию действия с учётом активного приложения, поддерживаемых API и настраиваемых fallback-клавиш.
Не отправляй произвольные сочетания клавиш в приложения, где это может привести к потере данных.
Не считай обычный QML MouseArea достаточной реализацией глобальных жестов.
Проверь возможности Hyprland и при необходимости реализуй отдельную compositor-level интеграцию.
12. Динамическая конфигурация Hyprland
Реализуй автоматическое переключение параметров композитора.
Phone:
- Нулевые отступы.
- Нулевые рамки.
- Без скруглений.
- Без размытия.
- Минимальные анимации.
- Одно основное приложение на экране.
Tablet:
- Небольшие отступы.
- Адаптивная многозадачность.
- Сенсорное управление.
Desktop:
- Настраиваемые gaps.
- Настраиваемые borders.
- Скругления.
- Анимации.
- Tiling и floating.
Не перезаписывай исходные пользовательские значения.
Сохраняй их как базовый профиль.
Применяй изменения через поддерживаемые API текущей версии Hyprland.
Учитывай, что глобальные параметры Hyprland могут влиять сразу на несколько мониторов. Для независимых режимов используй доступные правила рабочих пространств и окон, а ограничения документируй.
13. Замена Hyprpaper
Перенеси управление обоями в Quickshell.
Реализуй Wallpaper Engine.
Поддерживаемые форматы:
- JPG.
- JPEG.
- PNG.
- WebP.
- SVG.
- GIF.
- Видеообои через поддерживаемый мультимедийный backend.
Функциональность:
- Отдельные обои для разных мониторов.
- Отдельные обои Home Screen.
- Отдельные обои Lock Screen.
- Crop / Fit / Fill.
- Слайд-шоу.
- Автоматическая смена.
- Динамическая цветовая палитра Material You.
- Предпросмотр.
- Выбор из файлов.
- Настройка через Settings.
Для видеообоев реализуй приостановку декодирования, когда поверхность не видна или устройство переходит в энергосберегающий режим.
Не запускай тяжёлые видеообои на слабом ARM без возможности отключения.
Отключай Hyprpaper только после проверки корректного отображения новых обоев.
14. Замена Hyprlock
Создай собственный Material 3 Lock Screen в Quickshell.
Используй настоящий Wayland Session Lock Protocol ext-session-lock-v1.
Не используй обычное полноэкранное окно как механизм безопасности.
Lock Screen должен поддерживать:
- Часы.
- Дату.
- Обои.
- Батарею.
- Статус зарядки.
- Уведомления с настройками приватности.
- Поле пароля.
- PIN при наличии безопасного механизма проверки.
- Отпечаток пальца.
- Анимации разблокировки.
- Разные layout для desktop, tablet и phone.
- Корректную работу после suspend/resume.
Используй PAM для проверки учётных данных.
Не сохраняй пароль или PIN в конфигурации Quickshell.
Не реализуй собственную криптографию хранения паролей.
Обеспечь защиту от обхода блокировки при:
- Перезапуске Quickshell.
- Отключении монитора.
- Подключении нового монитора.
- Изменении разрешения.
- Сбое UI.
- Переключении TTY и возвращении в сессию.
- Suspend/resume.
Если безопасная реализация не готова, продолжай использовать Hyprlock.
Не отключай рабочий блокировщик до успешных проверок нового.
15. Touch ID / Fingerprint Unlock
Реализуй разблокировку по отпечатку пальца на телефоне и desktop.
Используй:
- fprintd.
- libfprint.
- PAM.
- Поддерживаемые аппаратные драйверы.
Требования:
- Разблокировка одним прикосновением.
- Без необходимости предварительно вводить пароль.
- Без необходимости нажимать Enter.
- Визуальный индикатор сканирования.
- Отображение ошибок.
- Повторная попытка.
- Возможность переключиться на пароль.
- Ограничение попыток согласно политике аутентификации.
- Безопасная обработка отсутствия устройства.
Создай раздел Fingerprint в Settings.
Функции:
- Проверка доступности сканера.
- Регистрация отпечатка через доверенный системный backend.
- Просмотр зарегистрированных отпечатков, если backend поддерживает.
- Удаление отпечатков после надлежащей авторизации.
- Включение/отключение разблокировки отпечатком.
- Диагностика устройства.
Не создавай собственную базу биометрических шаблонов.
Не считай успешное получение события от датчика подтверждением личности.
Разблокировка разрешена только после успешной проверки доверенным backend.
Если сканер телефона не поддерживается libfprint/fprintd, не имитируй поддержку. Документируй необходимые драйверы и возможные способы интеграции.
16. Сохранение Hypridle
Я уже использую Hypridle.
Не заменяй его без необходимости.
Изучи текущую конфигурацию и интегрируй с новым экраном блокировки.
Обеспечь:
- Блокировку по тайм-ауту.
- Блокировку перед suspend.
- Корректную работу после resume.
- Выключение дисплея.
- Настраиваемые интервалы.
- Отдельные профили desktop и phone.
- Настройки через Material 3 Settings.
Используй loginctl, systemd-logind и поддерживаемые интерфейсы там, где это необходимо.
Не допускай ситуации, когда устройство засыпает до установки безопасной блокировки.
Сохрани рабочую интеграцию Hypridle + Hyprlock до проверки нового Lock Screen.
17. Запуск из TTY без Display Manager
На desktop я не использую Display Manager.
Я вручную вхожу в TTY и запускаю Hyprland. В shell/source.sh для этого есть alias H='start-hyprland'; сохрани его и проверь фактический механизм запуска на целевой машине.
Сохрани этот способ запуска.
Не устанавливай SDDM, GDM, LightDM или другой Display Manager.
После запуска Hyprland должен автоматически запускаться Quickshell.
Проверь:
- Правильную пользовательскую сессию.
- D-Bus user session.
- XDG_RUNTIME_DIR.
- systemd user services.
- Переменные Wayland.
- Корректное завершение оболочки при выходе из Hyprland.
На телефоне разрешается отдельный механизм автозапуска, но он не должен ослаблять безопасность входа.
Не настраивай автоматический вход без явного подтверждения пользователя.
18. Полноценное приложение Settings
Создай отдельное, реально работающее приложение настроек, тесно интегрированное с Quickshell и Hyprland.
Название приложения: Settings.
Дизайн: Google Material Design 3.
Settings должно быть доступно:
- Через лаунчер.
- Через Quick Settings.
- Через Home Screen.
- Через меню приложений.
- Через отдельный
.desktopфайл.
Допускается реализация отдельным QML-приложением или выделенным окном Quickshell, если выбранная архитектура обеспечивает правильную работу, независимое открытие, фокус и безопасность.
Адаптивный дизайн Settings
Phone
Используй стиль Android Material 3 Settings:
- Вертикальный список разделов.
- Крупные сенсорные элементы.
- Поиск настроек.
- Вложенные страницы.
- Кнопка «Назад».
- Поддержка боковых жестов.
- Корректная работа экранной клавиатуры.
Tablet
- Navigation Rail.
- Двухпанельный интерфейс.
- Список разделов слева.
- Содержимое справа.
Desktop
- Боковая навигация.
- Поиск.
- Настройки в основной области.
- Поддержка мыши и клавиатуры.
- Изменение размера окна.
- Многомониторность.
Разделы Settings
18.1. Главная страница
Показывай:
- Название устройства.
- Версию Linux.
- Версию ядра.
- Архитектуру CPU.
- Версию Hyprland.
- Версию Quickshell.
- Состояние сети.
- Состояние батареи, если доступна.
18.2. Wi-Fi и сеть
- Wi-Fi on/off.
- Список доступных сетей.
- Подключение к сети.
- Сохранённые подключения.
- Ethernet.
- IP-адреса.
- DNS.
- Настройки прокси, если реализован соответствующий backend.
- VPN через NetworkManager, если поддерживается.
18.3. Bluetooth
- Включение.
- Поиск устройств.
- Сопряжение.
- Подключение.
- Отключение.
- Удаление сопряжения.
- Информация об устройстве.
18.4. Звук
- Громкость.
- Микрофон.
- Устройства вывода.
- Устройства ввода.
- Баланс при поддержке backend.
- Звуки уведомлений.
- Звук блокировки.
- Звуки интерфейса.
18.5. Дисплей
- Разрешение.
- Частота обновления.
- Масштабирование.
- Яркость.
- Поворот.
- Расположение мониторов.
- Основной монитор.
- Включение/отключение дисплеев.
- Автоматический поворот при наличии датчиков.
Не применяй неподдерживаемые режимы мониторов.
Предусмотри подтверждение опасных изменений с автоматическим откатом.
18.6. Обои и стиль
- Выбор обоев.
- Отдельные обои для Home Screen и Lock Screen.
- Видеообои.
- Слайд-шоу.
- Dynamic Color.
- Accent Color.
- Светлая/тёмная/системная тема.
- AMOLED.
- Размеры элементов.
- Шрифты.
- Анимации.
- Reduced Motion.
18.7. Home Screen
- Сетка приложений.
- Размер иконок.
- Dock.
- Количество страниц.
- Папки.
- Виджеты.
- Скрытие приложений из домашней сетки.
- Настройки App Drawer.
18.8. Жесты и навигация
- Включение жестовой навигации.
- Чувствительность.
- Зоны распознавания.
- Свайп домой.
- Recent Apps.
- Назад с левого края.
- Назад с правого края.
- Переключение приложений.
- Анимации.
- Тактильная отдача при наличии.
- Режим трёх навигационных кнопок как опциональная альтернатива, если реализован.
18.9. Уведомления
- Разрешения по приложениям.
- История.
- Группировка.
- Do Not Disturb.
- Звуки.
- Отображение на Lock Screen.
- Скрытие чувствительного содержимого.
- Всплывающие уведомления.
18.10. Панель и Quick Settings
- Положение панели.
- Высота.
- Автоскрытие.
- Состав индикаторов.
- Порядок Quick Settings.
- Размер переключателей.
- Состав быстрых действий.
- Поведение шторки.
18.11. Многозадачность
- Настройки Recent Apps.
- Анимации.
- Поведение окон.
- Tiling/Floating.
- Gaps.
- Borders.
- Скругления.
- Рабочие пространства.
- Правила отдельных приложений.
18.12. Блокировка и безопасность
- Способ блокировки.
- Время автоматической блокировки.
- Блокировка при suspend.
- Настройки Hypridle.
- Отпечатки пальцев.
- Приватность уведомлений.
- Настройки экрана блокировки.
Не позволяй отключать обязательную проверку личности без соответствующей авторизации.
18.13. Питание и батарея
- Процент заряда.
- Состояние зарядки.
- Профиль энергопотребления.
- Тайм-аут дисплея.
- Тайм-аут блокировки.
- Suspend.
- Настройки энергосбережения.
- Статистика батареи, если данные доступны.
18.14. Клавиатура и ввод
- Раскладки клавиатуры.
- Переключение языка.
- Повтор клавиш.
- Настройки мыши.
- Настройки тачпада.
- Сенсорный ввод.
- Экранная клавиатура.
- Скорость указателя.
- Жесты тачпада, если поддерживаются.
18.15. Приложения
- Список установленных приложений.
- Информация о приложениях.
- Настройки отображения в лаунчере.
- Приложения по умолчанию через XDG.
- Автозапуск пользовательских приложений.
- Разрешения Flatpak через подходящие системные инструменты, если доступны.
Не обещай универсальное управление разрешениями для обычных несандбоксированных Linux-приложений.
18.16. Система
- Информация об устройстве.
- CPU.
- RAM.
- GPU.
- Версия ядра.
- Версия Hyprland.
- Версия Quickshell.
- Информация о дисплеях.
- Диагностика оболочки.
- Экспорт конфигурации.
- Импорт конфигурации.
- Сброс настроек оболочки с подтверждением.
18.17. Developer Options
- Принудительный phone/tablet/desktop mode.
- Отображение FPS, если доступно.
- Отображение нагрузки CPU.
- Отображение RAM.
- Отладка жестов.
- Логи Quickshell.
- Логи интеграции Hyprland.
- Диагностика D-Bus.
- Проверка системных сервисов.
- Перезапуск пользовательской оболочки.
- Безопасный возврат к предыдущей конфигурации.
19. Настройки должны реально работать
Не создавай декоративное приложение Settings.
Каждый переключатель должен:
- Читать реальное состояние.
- Показывать его пользователю.
- Изменять соответствующую настройку через поддерживаемый API.
- Обрабатывать ошибки.
- Сохранять пользовательские предпочтения там, где это необходимо.
- Обновлять UI после изменения состояния извне.
Если функция не поддерживается устройством, скрывай её или показывай понятное состояние «Не поддерживается».
Не используй фиктивные данные.
Для операций, требующих привилегий, используй стандартные механизмы авторизации Linux, включая polkit, если это применимо.
Не запускай весь Settings от root.
20. Единое хранилище настроек
Создай общую систему конфигурации для Quickshell и Settings.
Требования:
- Сохранение настроек.
- Валидация значений.
- Версионирование схемы.
- Миграции.
- Атомарная запись.
- Защита от повреждения файла.
- Синхронизация между открытыми окнами Settings и оболочкой.
- Отдельные настройки дисплеев.
- Общие настройки темы.
- Профили phone/tablet/desktop.
- Экспорт и импорт.
- Сброс настроек.
Используй XDG Base Directory Specification.
Не храни секреты Wi-Fi, VPN, пароли или биометрические данные в обычном JSON-файле оболочки.
Для секретов используй соответствующие системные хранилища и сервисы.
21. Производительность
Целевые устройства включают слабые ARM64-телефоны с 4 ГБ RAM и GPU Mali-G52 MC2 под Mesa/Panfrost.
Оптимизируй:
- Потребление RAM.
- CPU в простое.
- Количество QML-объектов.
- Перерисовку.
- Загрузку иконок.
- Обработку изображений.
- Анимации.
- Видеообои.
- Работу с D-Bus.
- Обработку событий Hyprland.
Не создавай постоянный polling там, где доступны события.
Используй ленивую загрузку.
Не допускай, чтобы закрытый Settings продолжал выполнять тяжёлые операции.
Добавь режим снижения визуальных эффектов для слабых устройств.
Сравни фактические показатели с исходной конфигурацией Waybar + SwayNC + Rofi + Hyprpaper.
Не придумывай результаты бенчмарков.
22. Тестирование на компьютере
Обязательно реализуй возможность тестирования phone и tablet mode на desktop.
Создай скрипты:
scripts/test-desktop.sh
scripts/test-tablet.sh
scripts/test-phone.sh
scripts/test-settings.sh
Используй вложенную тестовую сессию Hyprland, если она поддерживается установленной системой.
Примерные размеры:
- Phone: 390×844.
- Tablet: 768×1024.
- Desktop: 1920×1080.
Тестовая сессия не должна менять основную конфигурацию Hyprland.
Поддержи эмуляцию сенсорных жестов мышью для UI-тестов.
Отдельно документируй, какие проверки требуют настоящего сенсорного экрана.
23. Тестирование на телефоне
Проверь:
- Arch Linux ARM aarch64.
- Запуск Hyprland.
- Запуск Quickshell.
- Status Bar.
- Home Screen.
- App Drawer.
- Recent Apps.
- Свайп домой.
- Свайп назад с обоих краёв.
- Уведомления.
- Quick Settings.
- Settings.
- Экранную клавиатуру.
- Блокировку.
- Fingerprint Unlock, если драйвер поддерживается.
- Suspend/resume.
- Поворот экрана.
- Управление яркостью.
- Управление громкостью.
- Батарею.
- Производительность.
Не заявляй об успешном аппаратном тестировании без реального запуска на устройстве.
24. Безопасная миграция
Переход должен происходить постепенно.
Порядок:
- Сохрани резервную копию.
- Проверь зависимости.
- Реализуй Quickshell.
- Запусти его в тестовом режиме.
- Проверь панель.
- Проверь уведомления.
- Проверь лаунчер.
- Проверь Settings.
- Проверь обои.
- Проверь мобильную навигацию.
- Проверь новый Lock Screen.
- Проверь fingerprint authentication.
- Проверь Hypridle.
- Проверь suspend/resume.
- Только после успешных проверок отключи старые компоненты.
Сохрани возможность отката к:
- Waybar.
- SwayNC.
- Rofi.
- Hyprpaper.
- Hyprlock.
Особенно важно: не отключай Hyprlock, пока новый блокировщик не прошёл проверки безопасности и восстановления после сбоев.
25. Документация
Создай:
README.md
AGENTS.md
ARCHITECTURE.md
IMPLEMENTATION_STATUS.md
TESTING.md
MIGRATION.md
ROLLBACK.md
README должен содержать:
- Установку на Arch Linux.
- Установку на Arch Linux ARM.
- Зависимости.
- Запуск из TTY.
- Автозапуск Quickshell.
- Запуск Settings.
- Переключение режимов.
- Настройку жестов.
- Настройку отпечатка пальца.
- Проверку блокировки.
- Тестирование мобильного интерфейса на ПК.
- Диагностику проблем.
- Возврат к исходной конфигурации.
В IMPLEMENTATION_STATUS.md отмечай для каждого компонента:
- Реализовано.
- Протестировано на desktop.
- Протестировано на ARM64.
- Требует проверки на устройстве.
- Имеет технические ограничения.
Не называй непроверенную функцию полностью готовой.
26. Порядок разработки
Работай последовательно:
- Аудит существующей конфигурации.
- Резервное копирование.
- Архитектура Quickshell.
- Material 3 Design System.
- Общие системные сервисы.
- Desktop Panel.
- Notification Center.
- Quick Settings.
- Application Launcher.
- Home Screen.
- Recent Apps.
- Gesture Navigation.
- Tablet Layout.
- Phone Layout.
- Wallpaper Engine.
- Settings Application.
- Secure Lock Screen.
- Fingerprint Authentication.
- Hypridle Integration.
- Multi-monitor Convergence.
- ARM64 Optimization.
- End-to-end Testing.
- Исправление ошибок.
- Документация и миграция.
После каждого этапа выполняй доступные тесты.
Не переходи к опасной замене механизма блокировки, пока не готовы проверки и откат.
27. Критерии завершения
Проект считается завершённым, когда:
- Существующая конфигурация Hyprland сохранена и адаптирована.
- Quickshell заменяет Waybar.
- Quickshell заменяет SwayNC.
- Quickshell заменяет Rofi в согласованных сценариях.
- Quickshell заменяет Hyprpaper.
- Hypridle продолжает работать.
- Экран блокировки безопасен.
- Отпечаток пальца работает на поддерживаемом оборудовании.
- Домашний экран работает.
- App Drawer работает.
- Recent Apps работает.
- Жесты работают на настоящем сенсорном экране.
- Назад работает с обоих боковых краёв там, где приложение поддерживает соответствующее действие.
- Свайп снизу вверх возвращает домой без удержания.
- Свайп сверху вниз открывает шторку.
- Настройки доступны через полноценное Material 3 Settings.
- Настройки действительно изменяют систему.
- Поддерживаются desktop, tablet и phone.
- Есть тесты для мобильного режима на ПК.
- Есть инструкции для ARM64.
- Нет необходимости устанавливать Display Manager.
- Нет ненужных постоянно работающих процессов.
- Есть безопасный механизм отката.
28. Финальные инструкции агенту
Начни с повторной сверки раздела 1 с рабочим деревом: hypr/hyprland.lua, его Lua-модули, конфигурации отдельных демонов и скрипты. Затем проверь реально загруженную конфигурацию и установленные версии компонентов. Отделяй проверенное по коду, проверенное в сессии и ещё не проверенное на оборудовании.
Не переписывай всё с нуля.
Не ограничивайся генерацией примеров кода.
Изменяй реальные файлы.
Если в существующей конфигурации уже есть нужная функциональность, сохрани её и интегрируй с новой оболочкой.
Не делай предположений о поддержке конкретного API без проверки.
Не придумывай команды Hyprland, Quickshell или системных сервисов.
Не создавай фиктивные UI-элементы.
Не отключай действующие средства безопасности без полноценной проверенной замены.
Продолжай разработку и исправление ошибок до максимально полного рабочего результата.
Если некоторые возможности требуют реального телефона, аппаратного драйвера или дополнительной интеграции с композитором, реализуй всё, что возможно в доступной среде, и документируй оставшиеся проверки.
Начинай с аудита. Затем переходи к реализации, тестированию и интеграции. Главная цель — единая, быстрая, безопасная и адаптивная Material 3 оболочка для Hyprland на desktop, tablet и phone, полностью управляемая через собственное приложение Settings.
Дополнение: Dynamic Hardware Capability Detection & Adaptive UI
1. Основная задача
Реализуй динамическую систему обнаружения аппаратных и программных возможностей устройства для всей оболочки Hyprland + Quickshell и приложения Material 3 Settings.
Главное правило: отображай только те элементы управления, для которых существует реальное поддерживаемое оборудование или доступная системная функция.
Не показывай несуществующие переключатели и не создавай фиктивные устройства.
Это правило должно действовать во всех интерфейсах:
- Desktop Panel.
- Phone Status Bar.
- Tablet Status Bar.
- Quick Settings.
- Notification Shade.
- Settings Application.
- Lock Screen.
- Power Management.
- Device Management.
2. Обнаружение оборудования
Создай единый HardwareCapabilityService, который отслеживает доступные возможности через системные API.
Используй:
- NetworkManager D-Bus — сетевые интерфейсы и подключения.
- ModemManager D-Bus — мобильные модемы, SIM, мобильная передача данных.
- BlueZ D-Bus — Bluetooth-контроллеры.
- PipeWire/WirePlumber — аудиоустройства.
- UPower — аккумуляторы и питание.
- sysfs и udev — аппаратные устройства.
- iio-sensor-proxy — датчики ориентации.
- Hyprland IPC — мониторы и устройства ввода.
- fprintd — поддерживаемые сканеры отпечатков.
- Поддерживаемые интерфейсы управления подсветкой.
- Доступные интерфейсы управления фонариком.
Не выполняй непрерывный polling, если можно подписаться на события D-Bus, udev или композитора.
3. Динамические сетевые элементы
Wi-Fi
Если Wi-Fi-адаптер отсутствует:
- Не показывай Wi-Fi в Quick Settings.
- Не показывай индикатор Wi-Fi в системной панели.
- Не показывай переключатель Wi-Fi в Settings.
- Не отображай пустой список беспроводных сетей.
Если адаптер подключён, соответствующие элементы должны появиться автоматически.
Если адаптер существует, но Wi-Fi выключен, показывай переключатель в состоянии Off, а не скрывай его.
Ethernet
Если существует один или несколько проводных интерфейсов:
- Показывай Ethernet в Quick Settings.
- Показывай соответствующий сетевой статус в системной панели.
- Показывай раздел проводных сетей в Settings.
- Поддерживай несколько физических и виртуальных интерфейсов.
- Отображай реальное состояние каждого интерфейса.
- Показывай IP, скорость соединения и другие параметры, если они доступны.
- Поддерживай DHCP и статическую конфигурацию через NetworkManager.
- Не объединяй разные Ethernet-интерфейсы в одно фиктивное устройство.
Если Ethernet-интерфейсов несколько, показывай компактную сводку и раскрываемый список интерфейсов.
Mobile Data / SIM
Если в системе отсутствует поддерживаемый мобильный модем:
- Не показывай Mobile Data.
- Не показывай SIM Settings.
- Не показывай индикатор сотового сигнала.
- Не показывай настройки APN.
- Не показывай переключатель мобильной передачи данных.
Если модем обнаружен, но SIM отсутствует, показывай состояние «Нет SIM» в соответствующем разделе, а не скрывай модем полностью.
Если есть несколько SIM или eSIM-профилей, поддерживай их в пределах возможностей ModemManager и оборудования.
Не путай отсутствие модема с отключённой мобильной передачей данных.
4. Пример поведения
| Оборудование | Видимые сетевые элементы |
|---|---|
| Desktop с одним Ethernet | Ethernet |
| Desktop с двумя Ethernet | Ethernet 1, Ethernet 2 |
| Desktop с Ethernet + Wi-Fi | Ethernet, Wi-Fi |
| Ноутбук с Wi-Fi | Wi-Fi |
| Телефон с Wi-Fi + LTE | Wi-Fi, Mobile Data, SIM |
| Телефон без доступного модема | Wi-Fi, если адаптер обнаружен |
| ПК без сетевых устройств | Общий статус сети без несуществующих переключателей |
Общий раздел «Сеть» в Settings можно сохранять для диагностики и настройки будущих подключений, даже если сейчас нет доступных адаптеров.
5. Обнаружение других компонентов
Применяй ту же логику ко всем аппаратным функциям.
| Возможность | Когда показывать |
|---|---|
| Bluetooth | Есть поддерживаемый контроллер |
| Батарея | Есть доступный аккумулятор |
| Яркость | Есть управляемая подсветка дисплея |
| Микрофон | Есть доступный источник аудиоввода |
| Динамики / аудиовыход | Есть доступный аудиовыход |
| Отпечаток пальца | Есть поддерживаемый сканер |
| Фонарик | Есть доступный и управляемый LED |
| Автоповорот | Есть поддерживаемые датчики ориентации |
| Камера | Есть доступное устройство камеры |
| Внешние мониторы | Hyprland обнаруживает соответствующие выходы |
| Power Profiles | Есть поддерживаемый backend |
| NFC | Есть поддерживаемый NFC-контроллер |
Не считай наличие устройства доказательством того, что все его функции поддерживаются. Проверяй конкретные операции.
6. Различай состояния оборудования
Для каждой возможности реализуй состояния:
unavailable— оборудование отсутствует.available— оборудование обнаружено.disabled— оборудование есть, но функция отключена.blocked— аппаратная или программная блокировка.unsupported— устройство обнаружено, но необходимый backend не поддерживает функцию.error— ошибка доступа или инициализации.
Не скрывай устройство только потому, что оно временно отключено, не подключено к сети или заблокировано через rfkill.
Если устройство поддерживается, но действие требует дополнительных разрешений, показывай его и корректно запрашивай авторизацию.
7. Горячее подключение оборудования
Поддерживай изменения без перезапуска Quickshell:
- Подключение USB Wi-Fi.
- Отключение Wi-Fi.
- Подключение Ethernet.
- Подключение USB Ethernet.
- Подключение Bluetooth-адаптера.
- Подключение внешнего аудиоустройства.
- Подключение внешнего монитора.
- Подключение или отключение зарядки.
- Появление и исчезновение модема.
Используй событийную модель.
Обновляй состояние и доступные элементы интерфейса автоматически.
8. Адаптивная компоновка
При исчезновении недоступного элемента остальные элементы должны занимать освободившееся место.
Не оставляй пустые плитки, разделители или пробелы.
Desktop:
- Компактная системная панель.
- Только реальные индикаторы.
- Quick Settings без несуществующих устройств.
Tablet:
- Адаптивная сетка переключателей.
- Перестройка при изменении доступных функций.
Phone:
- Только доступные плитки.
- Компактная status bar.
- Корректная компоновка при повороте дисплея.
Сохраняй пользовательский порядок плиток даже при временном исчезновении оборудования.
9. Settings Application
Все разделы Settings должны использовать общий HardwareCapabilityService.
Не создавай отдельную несовместимую логику определения устройств для каждого экрана.
Например:
- Если Wi-Fi отсутствует, скрывай Wi-Fi-настройки из обычного пользовательского интерфейса.
- Если обнаружен только Ethernet, показывай настройки Ethernet.
- Если есть несколько Ethernet, показывай каждый интерфейс отдельно.
- Если нет Bluetooth-контроллера, скрывай обычные Bluetooth-переключатели.
- Если нет аккумулятора, не показывай фиктивный процент заряда.
- Если нет сканера отпечатка, не предлагай регистрацию отпечатка.
Добавь в Developer Options отдельный раздел Hardware Capabilities, где можно увидеть все обнаруженные и отсутствующие возможности, причины недоступности и ошибки backend.
10. Тестирование
Реализуй автоматические тесты со смоделированными состояниями оборудования:
- Только Ethernet.
- Несколько Ethernet-интерфейсов.
- Только Wi-Fi.
- Ethernet + Wi-Fi.
- Wi-Fi + LTE.
- Модем без SIM.
- Отсутствие Bluetooth.
- Отсутствие батареи.
- Отсутствие датчика яркости или управляемой подсветки.
- Отсутствие сканера отпечатка.
- Подключение USB-адаптера во время работы.
- Отключение устройства во время открытых Settings.
Проверь, что пользовательский интерфейс обновляется корректно, не падает и не отображает фиктивные элементы.
Для тестов используй mock-backend, но никогда не подменяй реальные данные mock-значениями в обычном режиме.
11. Критерии готовности
- Система определяет реальные аппаратные возможности.
- Не показывает несуществующие переключатели.
- Сохраняет элементы для существующих, но отключённых устройств.
- Поддерживает несколько Ethernet-интерфейсов.
- Поддерживает появление и исчезновение устройств.
- Корректно перестраивает Material 3 интерфейс.
- Использует единый backend для Shell и Settings.
- Работает на x86_64 и aarch64.
- Не требует перезапуска Quickshell при hotplug.
- Не создаёт дополнительную постоянную нагрузку на CPU.
Интегрируй эту систему в существующую архитектуру Quickshell + Hyprland + Material 3 Settings. Не реализуй её как отдельное приложение. Все компоненты оболочки должны использовать единый источник информации об аппаратных возможностях.