#pragma once #include #include #include #include #include #include #include #include namespace evo::client { enum class UiError : std::uint8_t { invalid, stale_time, busy, exhausted }; enum class NoticeLevel : std::uint8_t { info, warning, error }; struct Notice { std::uint64_t id{}, expires_at_ms{}; NoticeLevel level{}; std::string text; }; struct Dialog { std::uint64_t id{}; std::string title, body; }; // Main-thread, bounded presentation state. Never store credentials or authority here. class UiState { public: static constexpr std::size_t max_notices = 8, max_text = 240, max_title = 96; [[nodiscard]] std::expected advance(std::uint64_t now_ms); [[nodiscard]] std::expected notify(std::string_view text, NoticeLevel level, std::uint64_t lifetime_ms = 5000); [[nodiscard]] bool dismiss(std::uint64_t id); [[nodiscard]] std::expected open_dialog(std::string_view title, std::string_view body); [[nodiscard]] bool close_dialog(std::uint64_t id); [[nodiscard]] std::span notices() const noexcept { return notices_; } [[nodiscard]] const std::optional& dialog() const noexcept { return dialog_; } [[nodiscard]] std::uint64_t evicted_notices() const noexcept { return evicted_; } private: std::uint64_t now_{}, next_id_{1}, evicted_{}; std::vector notices_; std::optional dialog_; }; // Engineering UI scale. The UI grows with the window: logical height over a 720-point // reference, clamped to [1, 2.5] (display DPI is already in the logical size), times the // user's nudge, clamped to [0.5, 2]. A non-finite or non-positive input counts as 1. inline constexpr float ui_reference_height = 720.0F; inline constexpr float ui_window_min = 1.0F, ui_window_max = 2.5F; inline constexpr float ui_user_min = 0.5F, ui_user_max = 2.0F, ui_user_step = 0.1F; [[nodiscard]] float ui_scale(int logical_height, float user) noexcept; // One nudge up (+1) or down (-1), kept on the 0.1 grid and within the user range. [[nodiscard]] float ui_user_nudge(float user, int direction) noexcept; } // namespace evo::client