Unlucky-Launcher/crates/app-iced/src/pages/settings/general.rs

//! 设置页「General」分组：语言选择器 + 主题 / 启动页 / 关闭按钮（M106 接真控件）。
//!
//! **这一组归 language+appearance 线**（M101 的分线口径）。
//!
//! ## 这一组为什么特殊
//!
//! 它**不走** `Group::body`：那个渲染器的签名是 `fn(&Ui, States) -> Option<Element>`，`States` 只有
//! `appearance` + `groups` 两格，装不下「当前语言档位 + 生效语言」。语言行要的两件在
//! `pages::Language` 里，由 `pages::settings::view` 的 `language` 形参一路递进来、`form` 按下标
//! 转交 [`body`]；所以 `GROUP.body` 仍是 `None`，`tests/mod.rs` 那条「只有外观组带真控件」照样成立。
//!
//! ## 语言切换**没有**走 M101 的 `GroupMessage` 投递口（偏离，已登记）
//!
//! `settings/mod.rs` 的文档说本线要加消息就加到 `settings/language_appearance.rs` 的 `Message` 上。
//! M106 走的是 `pages::Message::Language(choice)` 这条独立增量，理由：语言档位不是「某一组的状态」，
//! 它要**落盘**（`ui.language`）+ **重建整棵视图模型**（目录是 `pages::Model` 的一部分），而落点
//! `app/update/settings/language_appearance.rs` 与消息口 `language_appearance.rs` 都不在本 mission 的
//! scope 内。代价：`page_messages.rs` 多一支（那是 M101 想收掉的共享锚点）。**收口方向**：等本线
//! 再动设置页时，把 `Message::Language` 折进 `GroupMessage::LanguageAppearance(SetChoice)`，并把
//! `pages/mod.rs` 的这支删掉——finding 已登记。
//!
//! ## 语言行的三个事实
//!
//! 1. **选中态显示的是档位**（跟随系统 / 简体中文 / 英文），不是「猜出来的语言」——用户点过什么
//!    就得画回什么，否则「我明明选了跟随系统」这件事在界面上无从确认；
//! 2. **旁边回显生效语言**（`界面当前使用：简体中文`）：中文系统 + 跟随系统时，这一行是「界面
//!    真的用了中文」的唯一可见证据（用户报的 bug 正是「识别到了但没用上」）；
//! 3. **文案全部走 catalog**（[`Key`]），三档选项名跟着界面语言走（见 `catalog/general.rs`
//!    的头注释：为什么不写语言自称）。
//!
//! ## 其余三行仍只读
//!
//! 主题 / 启动页 / 关闭按钮还没有后端（`pages::Action` 里是占位动作），所以它们是**只读行**；
//! 但标签与取值已经进 catalog，中文界面下不会再冒出英文。
//!
//! 分组元数据只有一份（这里的 [`GROUP`]）：`settings/mod.rs` 的 `GROUPS` 直接引用它。

use iced::widget::{button, column, container, row};
use iced::{Alignment, Background, Border, Element, Length, Padding, Shadow, Theme as IcedTheme};

use unlucky_design::color::{Role, StateLayer};
use unlucky_design::icons::IconKind;
use unlucky_design::shape::ShapeScale;
use unlucky_design::spacing::Space;
use unlucky_design::typography::TypeRole;
use unlucky_i18n::catalog::Key;
use unlucky_i18n::LangChoice;

use crate::fonts::install::{CjkInstall, FetchClass};
use crate::pages::{frame, Language, Message};
use crate::theme::Ui;

use super::frame::{card, divider};
use super::Group;

/// General 分组（左列名固定英文：左列是**导航**，与导航轨同源，不进 catalog）。
pub(super) const GROUP: Group = Group {
    name: "General",
    icon: IconKind::Settings,
    // 只给 harness（`pages_demo` 走 `appearance: None` 时）用的演示行：产品路径走 [`body`]。
    // 语言那一行**不在**这里——它的值是要跟着语言变的，写死在静态表里就是用户看到的那条假值。
    rows: &[
        ("Theme", "Follow system"),
        ("Startup page", "Instances"),
        ("Close button", "Exit to tray"),
    ],
    body: None,
};

/// 这一组的正文（**产品路径**）。
pub(super) fn body<'a>(ui: &'a Ui, language: Language) -> Element<'a, Message> {
    let catalog = language.effective.catalog();
    let mut stacked = column![].spacing(0.0).width(Length::Fill);
    stacked = stacked.push(language_row(ui, language));
    // M168（D28 后半）：中文字体的下载状态行。紧贴语言行——用户在这里手选中文，反馈就该在这行下面，
    // 而不是等他切到别的页面才发现「刚才那几秒在干嘛」。
    stacked = stacked.push(divider(ui));
    stacked = stacked.push(font_row(ui, language));

    // 主题 / 启动页 / 关闭按钮：还没有后端，只读；文案已经进 catalog。
    for (label, value) in [
        (Key::SettingsTheme, Key::SettingsThemeFollowSystem),
        (Key::SettingsStartupPage, Key::SettingsStartupInstances),
        (Key::SettingsCloseButton, Key::SettingsCloseToTray),
    ] {
        stacked = stacked.push(divider(ui));
        stacked = stacked.push(setting_row(ui, catalog.text(label), catalog.text(value)));
    }

    card(ui, stacked)
}

/// 中文字体状态行的**文案**（纯函数：状态 × 目录 → 一句话 + 可选的一句解释）。
///
/// 为什么单独拎出来：截图只能证明「画出来了」，而这里能被断言证明「四种状态的词都在、占位符都被
/// 替换、两套目录都没有 `⟪missing⟫`」（见 `tests/general_section.rs`）。
///
/// 失败态**不写具体错误串**：那是给我们看的（`[font] cjk-download failed` 那行日志），用户只需要
/// 知道「网络 / 内容 / 磁盘」里哪一类，以及「界面照常可用」。
pub(super) fn font_status(
    catalog: &unlucky_i18n::catalog::Catalog,
    status: &CjkInstall,
) -> (String, Option<String>) {
    match status {
        CjkInstall::Unknown => (catalog.text(Key::FontCjkStatusUnknown).to_owned(), None),
        CjkInstall::Unprobeable => (catalog.text(Key::FontCjkStatusUnprobeable).to_owned(), None),
        CjkInstall::NotNeeded => (catalog.text(Key::FontCjkStatusNotNeeded).to_owned(), None),
        CjkInstall::System { family } => (
            catalog.render(Key::FontCjkStatusSystem, &[("family", family)]),
            None,
        ),
        CjkInstall::Downloading { bytes } => (
            catalog.render(
                Key::FontCjkStatusDownloading,
                &[("size", &format_size(*bytes))],
            ),
            Some(catalog.text(Key::FontCjkStatusHint).to_owned()),
        ),
        CjkInstall::Ready { family, .. } => (
            catalog.render(Key::FontCjkReady, &[("family", family)]),
            Some(catalog.text(Key::FontCjkStatusHint).to_owned()),
        ),
        CjkInstall::Failed { class, .. } => {
            let reason = catalog.text(match class {
                FetchClass::Network => Key::FontCjkReasonNetwork,
                FetchClass::Integrity => Key::FontCjkReasonIntegrity,
                FetchClass::Disk => Key::FontCjkReasonDisk,
            });
            (
                catalog.render(Key::FontCjkStatusFailed, &[("reason", reason)]),
                None,
            )
        }
    }
}

/// 字节数 → 人话体积（17 772 300 B → `16.9 MB`，按 1 MiB = 1048576 B）。只用于「≈」级别的量。
fn format_size(bytes: u64) -> String {
    const MIB: f64 = 1024.0 * 1024.0;
    let mib = bytes as f64 / MIB;
    if mib >= 1.0 {
        format!("{mib:.1} MB")
    } else {
        format!("{:.0} KB", bytes as f64 / 1024.0)
    }
}

/// 中文字体状态行：标签一行、状态一行（失败红、就绪主色）、需要时再补一句解释。
///
/// 为什么**竖排**而不是像主题那几行「标签左、取值右」：失败那句话是整句（「获取失败（网络不通）。
/// 界面照常可用…」），塞进右列会把它压成一行挤掉标签（实测截图就是一整行红字、标签消失）。
/// 语言行也是竖排（标题 + 选项 + 说明），这一行贴着它，观感一致。
fn font_row<'a>(ui: &'a Ui, language: Language) -> Element<'a, Message> {
    let catalog = language.effective.catalog();
    let status = crate::fonts::install::status();
    let (value, hint) = font_status(&catalog, &status);
    let color = match status {
        CjkInstall::Failed { .. } => ui.color(Role::Error),
        CjkInstall::Ready { .. } | CjkInstall::System { .. } => ui.color(Role::Primary),
        _ => ui.color(Role::OnSurfaceVariant),
    };

    let mut stacked = column![
        frame::text_role(
            ui,
            TypeRole::BodyMedium,
            false,
            catalog.text(Key::FontCjkStatusLabel),
            ui.color(Role::OnSurface),
        ),
        container(frame::text_role_owned(
            ui,
            TypeRole::BodySmall,
            false,
            value,
            color
        ))
        .width(Length::Fill),
    ]
    .spacing(ui.space(Space::X1))
    .width(Length::Fill)
    .padding(Padding::from([ui.space(Space::X2), 0.0]));

    if let Some(hint) = hint {
        stacked = stacked.push(container(frame::text_role_owned(
            ui,
            TypeRole::BodySmall,
            false,
            hint,
            ui.color(Role::OnSurfaceVariant),
        )));
    }

    stacked.into()
}

/// 语言行：标题 + 生效语言回显 + 三档互斥按钮 + 一句说明。
fn language_row<'a>(ui: &'a Ui, language: Language) -> Element<'a, Message> {
    let catalog = language.effective.catalog();
    let effective = LangChoice::Fixed(language.effective).label_key();

    let head = row![
        container(frame::text_role(
            ui,
            TypeRole::BodyMedium,
            false,
            catalog.text(Key::SettingsLanguage),
            ui.color(Role::OnSurface),
        ))
        .width(Length::Fill)
        .align_y(Alignment::Center),
        frame::text_role_owned(
            ui,
            TypeRole::LabelLarge,
            true,
            catalog.render(
                Key::SettingsLanguageEffective,
                &[("language", catalog.text(effective))],
            ),
            ui.color(Role::OnPrimaryFixedVariant),
        ),
    ]
    .width(Length::Fill)
    .align_y(Alignment::Center);

    let chips = row(LangChoice::ALL
        .iter()
        .map(|choice| {
            chip(
                ui,
                catalog.text(choice.label_key()),
                *choice == language.choice,
                *choice,
            )
        })
        .collect::<Vec<_>>())
    .spacing(ui.space(Space::X1))
    .align_y(Alignment::Center);

    column![
        head,
        chips,
        frame::text_role(
            ui,
            TypeRole::BodySmall,
            false,
            catalog.text(Key::SettingsLanguageHint),
            ui.color(Role::OnSurfaceVariant),
        ),
    ]
    .spacing(ui.space(Space::X1))
    .width(Length::Fill)
    .padding(Padding::from([ui.space(Space::X2), 0.0]))
    .into()
}

/// 一个只读的「标签 + 取值」行（与 `frame::demo_card` 的一行同高同排版）。
fn setting_row<'a>(ui: &'a Ui, label: &'a str, value: &'a str) -> Element<'a, Message> {
    let height = ui.metrics().control_height + Space::X2.dp();

    row![
        container(frame::text_role(
            ui,
            TypeRole::BodyMedium,
            false,
            label,
            ui.color(Role::OnSurface),
        ))
        .width(Length::Fill)
        .align_y(Alignment::Center),
        frame::text_role(
            ui,
            TypeRole::BodySmall,
            false,
            value,
            ui.color(Role::OnSurfaceVariant),
        ),
    ]
    .height(height)
    .width(Length::Fill)
    .align_y(Alignment::Center)
    .into()
}

/// 一个互斥按钮（选中态 `SecondaryContainer`，未选中透明 + `OnSurfaceVariant`）。
///
/// 与 `pages/appearance/section.rs` 的 `choice` 同款，但文案来自 catalog（那份是英文基线）。
fn chip<'a>(ui: &'a Ui, text: &'a str, selected: bool, choice: LangChoice) -> Element<'a, Message> {
    let height = ui.metrics().control_height;
    let content_color = if selected {
        ui.color(Role::OnSecondaryContainer)
    } else {
        ui.color(Role::OnSurfaceVariant)
    };

    button(
        container(frame::text_role(
            ui,
            TypeRole::LabelLarge,
            selected,
            text,
            content_color,
        ))
        .align_y(Alignment::Center),
    )
    .height(height)
    .padding(Padding::from([0.0, ui.space(Space::X3)]))
    .style(move |_theme: &IcedTheme, status| {
        let background = if selected {
            Some(Background::Color(ui.color(Role::SecondaryContainer)))
        } else if matches!(status, button::Status::Hovered | button::Status::Pressed) {
            Some(Background::Color(ui.state_over(
                StateLayer::Hover,
                Role::OnSurface,
                Role::Surface,
            )))
        } else {
            None
        };

        button::Style {
            background,
            text_color: content_color,
            border: Border {
                radius: ui.radius(ShapeScale::Full, height),
                ..Border::default()
            },
            shadow: Shadow::default(),
            snap: true,
        }
    })
    .on_press(Message::Language(choice))
    .into()
}