Unlucky-Launcher/crates/presenter/src/prefs.rs

//! UI 偏好项与持久化键登记（导航折叠、AI 栏折叠、磁贴尺寸、视图、主题三态与外观四件、下载分类）。
//!
//! 偏好不自己写盘：core::setting 的 schema 按 [`keys::ALL`] 登记这些键，
//! app 启动时读一次、变更时写回（跨模块约定见 `DevDocs/SubAgentsTalk/app-DTO通道约定.md`）。
//! 落盘实现是 [`crate::settings_bridge`]（同一份 `config/launcher.json`，与 `ull config set` 同源），
//! 主题三态 + `appearance.*` 高级键已接（M41）；其余 UI 偏好键仍只在内存里（后续 mission 接）。

/// 背景图填充模式（09 §101）。直接复用 core 的枚举：取值与落盘词表只有一处真相。
pub use unlucky_core::setting::appearance::BgFill;

pub use unlucky_core::setting::appearance::PALETTE_SOURCES;
/// 外观下层的三张表/常量（D36·D37·D38）：复用 core 的定义，一处真相。
///
/// [`WINDOW_ALPHA_MIN`] 还要给 `unlucky-app-iced` 的 win32 α 层用（它只依赖本 crate，不直接依赖
/// core）：窗口 α 的硬底必须与设置侧同源，两边各写一个 `0.08` 迟早会漂。
///
/// 同理 [`PANEL_ALPHA_MIN`]（0.4）与 [`BG_DIM_MAX`]（0.95）也在这里重导出：M93 的 UI 侧要按它们
/// 钳位滑块与暗化，而 `app-iced` 不直接依赖 core——不重导出就只能各抄一份字面量。
pub use unlucky_core::setting::appearance::{
    PaletteSource, TitlebarMode, WindowCorner, BG_DIM_MAX, PANEL_ALPHA_MIN, WINDOW_ALPHA_MIN,
    WINDOW_CORNERS,
};

/// 系统版本探测（M116）：Windows 侧「能不能用 DWM 圆角」的判据要 build 号，而
/// `unlucky-app-iced` 不直接依赖 `unlucky-core`（分层：UI → presenter → core），
/// 所以在这里做**唯一一次**重导出，`platform` 只认 [`WindowsVersion`]。
///
/// [`WIN11_MIN_BUILD`] = 22000：Win11 与 Server 2025 共用同一内核判据（M116 实测本机
/// Server 2025 build 26100 落在这条线之上）。
pub use unlucky_core::platform::windows_version::{
    probe as probe_windows_version, WindowsVersion, WIN11_MIN_BUILD,
};

use crate::dto::VersionCategory;

/// 预设强调色板（09 §104）。**必须**与 UI 侧设置页「外观」分组的色板控件同序同值：
/// UI 侧只回传索引，十六进制串由这张表给出（一处真相）。
pub const ACCENT_PRESETS: [&str; 8] = [
    "#0078D4", "#0F6CBD", "#107C10", "#9D5D00", "#C42B1C", "#8764B8", "#C239B3", "#00B7C3",
];

/// 强调色输入的**结构化失败原因**（M250 ACCENTWIRE）。
///
/// 为什么不是 `bool`：接线之后「填坏的串」必须能变成一条看得见的原因，回退成 `false` 只会让
/// 用户再体验一次「保存成功、界面没变」。空串**不在这里**：空 = 出厂品牌板（合法取值）。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum AccentError {
    /// 去掉 `#` 后不足 6 位（`#12`、`#006A5`）。
    Short {
        /// 实际位数（原样报给用户，别把「6 位」写死在句子里）。
        digits: usize,
    },
    /// 去掉 `#` 后超过 6 位（`#006A5C00`、粘了整行的串）。
    Long {
        /// 实际位数。
        digits: usize,
    },
    /// 含非十六进制字符（`zzzzzz`）。
    Digit {
        /// 第一个不合法字符（比「格式不对」有用：用户能一眼看到错在哪个字符）。
        ch: char,
    },
}

/// 一次强调色输入的解析结果：`appearance.accent_color` 的**唯一**解析点（M250）：设置页输入框、
/// 配置读回、出图取证开关都走它。少了 `#` 也接受（`006A5C` = `#006A5C`）——core 的 `normalize_hex`
/// 同样接受，而 `ull config set appearance.accent_color 006A5C` 写出来的值必须能被界面吃下
/// （否则 CLI 设的值会在设置页亮红行、颜色却是生效的）。输出一律规范化为大写 `#RRGGBB`。
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum AccentChoice {
    /// 空串 = 出厂品牌板（`DesignTokens::brand`）。**不是错误**。
    Factory,
    /// 合法的 `#RRGGBB`（大写、带 `#`）。
    Custom(String),
}

impl AccentChoice {
    /// 解析一段用户输入 / 配置值。
    ///
    /// # Errors
    /// 位数不是 6 或含非十六进制字符时返回 [`AccentError`]；空串是 `Ok(Factory)`。
    pub fn parse(text: &str) -> Result<Self, AccentError> {
        let trimmed = text.trim();
        if trimmed.is_empty() {
            return Ok(Self::Factory);
        }
        let body = trimmed.strip_prefix('#').unwrap_or(trimmed);
        if let Some(ch) = body.chars().find(|ch| !ch.is_ascii_hexdigit()) {
            return Err(AccentError::Digit { ch });
        }
        match body.chars().count() {
            digits @ 0..=5 => Err(AccentError::Short { digits }),
            6 => Ok(Self::Custom(format!("#{}", body.to_ascii_uppercase()))),
            digits => Err(AccentError::Long { digits }),
        }
    }

    /// 落盘字符串（`""` = 出厂；`#RRGGBB` = 自定义）。
    #[must_use]
    pub fn as_str(&self) -> &str {
        match self {
            Self::Factory => "",
            Self::Custom(hex) => hex,
        }
    }
}

/// 磁贴尺寸（Q24-3：小 6 列 / 中 4 列 / 大 3 列）。
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum TileSize {
    /// 小：6 列，只留图标/名字/启动键
    Small,
    /// 中：4 列（D16 默认）
    #[default]
    Medium,
    /// 大：3 列，显示完整徽标与最后游玩时间
    Large,
}

impl TileSize {
    /// 该尺寸对应的网格列数。
    pub fn columns(self) -> usize {
        match self {
            Self::Small => 6,
            Self::Medium => 4,
            Self::Large => 3,
        }
    }

    /// 设置页/实例页分段控件的文案。
    pub fn label(self) -> &'static str {
        match self {
            Self::Small => "小",
            Self::Medium => "中",
            Self::Large => "大",
        }
    }
}

/// 实例页视图模式。
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum InstanceView {
    /// 磁贴网格（默认）
    #[default]
    Tiles,
    /// 紧凑列表
    List,
}

/// 主题三态（D17，P0 交付）：`appearance.theme_mode ∈ {light, dark, auto}`，出厂 auto。
///
/// `auto` = 跟随系统（由 UI 侧的令牌层读系统调色板，随 OS 热更；探测口径见
/// [`crate::theme::system_theme_value`]）；`light` / `dark` 钉死**自绘体系**的取值。
/// 三个取值怎么变成框架颜色是 UI 侧的事，本 crate 只给语义。
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum ThemeMode {
    /// 跟随系统（默认）
    #[default]
    Auto,
    /// 强制浅色
    Light,
    /// 强制深色
    Dark,
}

impl ThemeMode {
    /// 落盘取值（`appearance.theme_mode`）：`auto` / `light` / `dark`。
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Auto => "auto",
            Self::Light => "light",
            Self::Dark => "dark",
        }
    }

    /// 从落盘取值解析；未知值按 `auto` 兜底（配置被手改坏也不崩）。
    pub fn from_key_value(value: &str) -> Self {
        match value {
            "light" => Self::Light,
            "dark" => Self::Dark,
            _ => Self::Auto,
        }
    }
}

/// 09 §101-104「外观（高级）」四件的取值快照（出厂全部关闭）。
///
/// 与 `unlucky_core::setting::appearance::Appearance` 一一对应，但字段类型是 UI 侧好用的
/// `f32`/`String`；落盘由 [`crate::settings_bridge`] 转成 schema 键。
#[derive(Debug, Clone, PartialEq, Default)]
pub struct AppearancePrefs {
    /// 背景图总开关
    pub bg_image_enabled: bool,
    /// 背景图路径（PNG；空 = 未设置）
    pub bg_image: String,
    /// 填充模式
    pub bg_fill: BgFill,
    /// 暗化层强度 0.0~0.9
    pub bg_dim: f32,
    /// 面板半透明度 0.4~1.0
    pub panel_alpha: f32,
    /// 玻璃拟态卡片
    pub glass: bool,
    /// 自定义强调色 `#RRGGBB`；空 = 出厂 [#0078D4]
    pub accent_color: String,
}

impl AppearancePrefs {
    /// 出厂态：Metro 纯色，四个高级特性全关。
    pub fn factory() -> Self {
        Self {
            bg_image_enabled: false,
            bg_image: String::new(),
            bg_fill: BgFill::Cover,
            bg_dim: 0.35,
            panel_alpha: 1.0,
            glass: false,
            accent_color: String::new(),
        }
    }

    /// 背景图是否真的生效（开关打开且路径非空）。
    pub fn bg_active(&self) -> bool {
        self.bg_image_enabled && !self.bg_image.trim().is_empty()
    }

    /// 规范化写入强调色：`#RRGGBB` 才接受（空串 = 恢复出厂）；返回 `false` = 输入不合法、
    /// 现状不变。需要**原因**时走 [`AppearancePrefs::set_accent_checked`]（设置页走那条）。
    pub fn set_accent(&mut self, text: &str) -> bool {
        self.set_accent_checked(text).is_ok()
    }

    /// 与 [`AppearancePrefs::set_accent`] 同一条路，但把结构化原因交出去。失败时**不动**
    /// `accent_color`（保持上一次合法值）：非法串既不落盘、也不改生效色，只在 UI 上留一条原因。
    ///
    /// # Errors
    /// 位数不是 6 或含非十六进制字符时返回 [`AccentError`]（见 [`AccentChoice::parse`]）。
    pub fn set_accent_checked(&mut self, text: &str) -> Result<(), AccentError> {
        let choice = AccentChoice::parse(text)?;
        self.accent_color = choice.as_str().to_owned();
        Ok(())
    }

    /// 用预设色板第 `index` 个颜色（越界忽略）。
    pub fn set_accent_preset(&mut self, index: usize) -> bool {
        match ACCENT_PRESETS.get(index) {
            Some(hex) => self.set_accent(hex),
            None => false,
        }
    }
}

/// 外观下层的**只读**快照：整窗 α / 标题栏三态 / 配色来源 / 窗口圆角（D36·D37·D38 · M116）。
///
/// 不并进 [`AppearancePrefs`] 的两个理由：那个结构体由 `settings_bridge` 逐字段字面量
/// 构造（加字段就得改那边），且这**四个**键只读不写——落盘仍走 core 的 `Appearance::write`。
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct AppearanceBase {
    /// 整窗透明度 [`WINDOW_ALPHA_MIN`]~1.0（1.0 = 完全不透明）
    pub window_opacity: f32,
    /// 标题栏三态（`auto` 的具体判定属于 UI 侧，本 crate 只给值）
    pub titlebar_mode: TitlebarMode,
    /// 配色来源档（三级编排在 `unlucky-design`，本 crate 只给值）
    pub palette_source: PaletteSource,
    /// 窗口外框圆角策略（M116：`system` / `square`；能不能圆由平台决定）
    pub window_corner: WindowCorner,
}

impl AppearanceBase {
    /// 出厂态：不透明 / `auto` / 内置色卡 / 跟随系统圆角。
    #[must_use]
    pub fn factory() -> Self {
        Self {
            window_opacity: 1.0,
            titlebar_mode: TitlebarMode::Auto,
            palette_source: PaletteSource::Preset,
            window_corner: WindowCorner::System,
        }
    }

    /// 从配置文档读一份快照：缺键 → 出厂默认、越界 → 钳位、非法枚举 → 回落。
    ///
    /// 三条语义都在 core 里落地（本函数只搬运，不重新判一遍）。
    #[must_use]
    pub fn from_document(doc: &unlucky_core::setting::document::SettingDocument) -> Self {
        let appearance = unlucky_core::setting::appearance::Appearance::read(doc);
        Self {
            window_opacity: appearance.window_opacity as f32,
            titlebar_mode: appearance.titlebar_mode,
            palette_source: appearance.palette_source,
            window_corner: appearance.window_corner,
        }
    }

    /// 整窗 α 是否需要真的落到窗口上（1.0 = 不透明，调 FFI 纯属多余）。
    #[must_use]
    pub fn is_transparent(&self) -> bool {
        self.window_opacity < 1.0
    }
}

/// 需要跨会话记忆的 UI 偏好。
///
/// 注意：`Eq` 不成立（[`AppearancePrefs`] 带 `f32` 滑条值），用到的地方按 `PartialEq` 比。
#[derive(Debug, Clone, PartialEq)]
pub struct UiPrefs {
    /// 左侧导航栏折叠成图标条
    pub nav_collapsed: bool,
    /// 右侧 AI 栏折叠成 icon 轨
    pub ai_collapsed: bool,
    /// 磁贴尺寸
    pub tile_size: TileSize,
    /// 实例页视图
    pub instance_view: InstanceView,
    /// 主题模式
    pub theme: ThemeMode,
    /// 外观（高级）四件（09 §101-104）
    pub appearance: AppearancePrefs,
    /// 下载页选中的分类
    pub download_category: VersionCategory,
}

impl Default for UiPrefs {
    fn default() -> Self {
        Self {
            nav_collapsed: false,
            ai_collapsed: false,
            // D16 默认中磁贴（4 列）
            tile_size: TileSize::Medium,
            instance_view: InstanceView::Tiles,
            theme: ThemeMode::Auto,
            appearance: AppearancePrefs::factory(),
            download_category: VersionCategory::Release,
        }
    }
}

/// 持久化键名登记（core::setting schema 按此注册；改名等于迁移，慎动）。
pub mod keys {
    /// 导航栏折叠
    pub const NAV_COLLAPSED: &str = "ui.nav.collapsed";
    /// AI 栏折叠
    pub const AI_COLLAPSED: &str = "ui.ai.collapsed";
    /// 磁贴尺寸
    pub const TILE_SIZE: &str = "ui.instances.tile_size";
    /// 实例页视图（磁贴/列表）
    pub const INSTANCE_VIEW: &str = "ui.instances.view";
    /// 主题三态（D17；与设置页「外观」分组同名，取值见 [`super::ThemeMode::as_str`]）
    pub const THEME_MODE: &str = "appearance.theme_mode";
    /// 背景图开关（09 §101）
    pub const BG_IMAGE_ENABLED: &str = "appearance.bg_image_enabled";
    /// 背景图路径
    pub const BG_IMAGE: &str = "appearance.bg_image";
    /// 背景图填充模式
    pub const BG_FILL: &str = "appearance.bg_fill";
    /// 暗化层强度
    pub const BG_DIM: &str = "appearance.bg_dim";
    /// 面板半透明度（09 §102）
    pub const PANEL_ALPHA: &str = "appearance.panel_alpha";
    /// 玻璃拟态卡片（09 §103）
    pub const GLASS: &str = "appearance.glass";
    /// 自定义强调色（09 §104）
    pub const ACCENT_COLOR: &str = "appearance.accent_color";
    /// 下载页分类
    pub const DOWNLOAD_CATEGORY: &str = "ui.download.category";
    /// 整窗透明度（D36；下限见 [`super::WINDOW_ALPHA_MIN`]）
    pub const WINDOW_OPACITY: &str = "appearance.window_opacity";
    /// 标题栏三态（D37）
    pub const TITLEBAR_MODE: &str = "appearance.titlebar_mode";
    /// 配色来源档（D38）
    pub const PALETTE_SOURCE: &str = "appearance.palette_source";
    /// 窗口圆角策略（M116；`system` / `square`）
    pub const WINDOW_CORNER: &str = "appearance.window_corner";

    /// 本模块登记的全部键（自检/迁移用）。
    pub const ALL: [&str; 17] = [
        NAV_COLLAPSED,
        AI_COLLAPSED,
        TILE_SIZE,
        INSTANCE_VIEW,
        THEME_MODE,
        BG_IMAGE_ENABLED,
        BG_IMAGE,
        BG_FILL,
        BG_DIM,
        PANEL_ALPHA,
        GLASS,
        ACCENT_COLOR,
        DOWNLOAD_CATEGORY,
        WINDOW_OPACITY,
        TITLEBAR_MODE,
        PALETTE_SOURCE,
        WINDOW_CORNER,
    ];
}

#[cfg(test)]
mod tests;