Unlucky-Launcher/crates/app-iced/src/pages/logs/lines.rs

//! 日志行列表：**等宽 + 折行 + 独立滚动**。
//!
//! ## 为什么折行而不是横向滚动（tower 要求二选一，这里选折行）
//!
//! 一行崩溃堆栈动辄 200+ 字符（样例里最长的一行 214 字符）。M102 起卡片吃满页宽
//! （1180 窗宽 → 卡内约 1004px），但 214 字符 × 等宽 12px ≈ 1412px 仍要折一次。两条路：
//!
//! | 方案 | 代价 |
//! |---|---|
//! | 横向滚动 | 一条日志要横甩两屏；外壳已经是竖向滚动，横竖两向嵌套后滚轮归属会打架 |
//! | **折行（本页选）** | 一条日志可能占 2~3 行，行号/等级栏必须能标明「这是同一条」 |
//!
//! 选折行的决定性理由：**折行让等宽族只承担「视觉密度」，不承担「列对齐」**。等宽栈在
//! Windows 上是 `Cascadia Mono` / `Consolas`，它们没有 CJK 字形——中文日志要靠 cosmic-text
//! 逐字回退到系统 CJK 族（本机实测回退到 `Microsoft YaHei UI`），回退字形的 advance 不是 1ch。
//! 横向滚动方案里「第 40 列对齐」是有意义的（堆栈缩进、`at a.b.C(File.java:12)` 的括号列），
//! 一旦 CJK 回退把列宽带偏，对齐就废了；折行版面不承诺任何列对齐，回退只影响同一行内的观感。
//! ## 悬挂缩进（M95 r2 落地，视觉复审 P2-1）
//!
//! r1 的 `entry()` 只有 `row![等级条, 单个 Text]`：折行的续行回到文本自己的左边距，
//! 于是 `at com.mojang…(GLX.java:64)` 被拆成「`at` 独占一行 + 帧名一行」，和「下一条日志」
//! 视觉上无法区分（一屏白花 ~5 行）。**现在的落地方式**是把一行拆成**前缀 + 正文两个文本控件**：
//!
//! ```text
//! │ [19:40:14] [Render thread/ERROR] 显卡驱动不支持 OpenGL 3.2，初始化窗口失败
//! │        ↑ 前缀（第一个空格及其之前，含空格）   ↑ 正文从它右边开始，带着 Fill 宽度自己折行
//! │ java.lang.IllegalStateException: GLFW error before init: [0x10008] Failed to create window…
//! │ ↑ 无前缀（第一个「词」超过 20 字符）⇒ 整行一个文本块
//! ```
//!
//! 为什么不是「NBSP 绑定前缀 + 单个 Text」：NBSP 只阻止断行，**改不了续行的起点**——续行依旧
//! 回到文本左边距，`at` 还是独占一行（除非整行按字形硬断，那会把时间戳也断掉）。两段布局是
//! iced 里唯一能同时做到「`at` 与帧名同行」+「续行比行首缩进」的写法。
//!
//! 代价与边界：续行缩进量 = **该行前缀宽度**（时间戳行 ≈ 10 字符、栈帧 `at` 行 ≈ 3 字符），
//! 所以不同行的续行缩进不一样——这是悬挂缩进的正常形态（按行首标签缩进），不是 bug。
//!
//! ## 软断点（M102，视觉复审 ③）
//!
//! 没有空格的长串（`graphics.gl_operation_failure:medium(70)`）在原版里只能按字形硬断，
//! 图里出现 `gl_o` / `peration_failure`。现在正文先过
//! [`super::super::layout::wrap::breakable`]：在 `.` `_` `:` `/` `\` 后插零宽空格，折行落回
//! 词边界；悬挂缩进不受影响（前缀仍是独立文本控件），`Line::text` 仍是原文。
//!
//! ## 贴底（M95 r2，视觉复审 P2-4）
//!
//! 崩溃排查看的是**最后几行**，所以行列表用 `panel::scroll_tail`（`Anchor::End`）：偏移按
//! 「距底多远」记，内容增长时视图保持距底同一位置 ⇒ 天然跟随尾部。用户上滚后的行为与
//! 「是否冻结」的边界写在 [`panel::scroll_tail`] 的文档里（结论：**没有**冻结，需要 app 层
//! 回灌滚动状态才做得到）。
//!
//! ## 等宽族的实际落点
//!
//! `ui.families().mono` 是启动时用系统字体库核对过的族名（[`crate::fonts`] 求值，启动日志里
//! 有一行 `mono=…`），本页只通过 [`mono_style`] 用它，不写死族名。字号/行高走
//! `TypeRole::BodySmall`（12/16），与报告里的数值表对得上（见 `logs/tests.rs`）。

use iced::widget::text::LineHeight;
use iced::widget::{column, container, row, space};
use iced::{Alignment, Background, Border, Color, Element, Length, Padding, Pixels};

use unlucky_design::color::Role;
use unlucky_design::shape::ShapeScale;
use unlucky_design::spacing::Space;
use unlucky_design::typography::{FontFamily, TypeRole, TypeStyle};
use unlucky_i18n::catalog::{Catalog, Key};
use unlucky_i18n::Lang;

use crate::theme::Ui;

use super::super::frame;
use super::super::layout::wrap;
use super::super::Message;
use super::model::{Level, Line, Logs};
use super::panel;

/// 前缀上限（字符）：超过就不拆（见 [`split_prefix`]）。
const PREFIX_MAX_CHARS: usize = 20;

/// 等级条宽度（2px：够看见，又不抢日志正文的起始列）。
const BAR_WIDTH: f32 = 2.0;

/// 日志卡片：标题行（`OUTPUT` + 行数）+ 独立滚动的行列表。高度由调用方定（见 [`panel`]）。
pub fn card<'a>(ui: &'a Ui, logs: &'a Logs, lang: Lang, height: Length) -> Element<'a, Message> {
    let catalog = Catalog::of(lang);

    let head = row![
        container(frame::text_role(
            ui,
            TypeRole::LabelMedium,
            false,
            catalog.text(Key::LogsOutputTitle),
            ui.color(Role::OnSurfaceVariant),
        ))
        .width(Length::Fill)
        .align_y(Alignment::Center),
        frame::text_role_owned(
            ui,
            TypeRole::LabelMedium,
            false,
            logs.lines.len().to_string(),
            ui.color(Role::OnSurfaceVariant),
        ),
    ]
    .width(Length::Fill)
    .align_y(Alignment::Center)
    .padding(Padding::default().bottom(ui.space(Space::X2)));

    let rows = column(
        logs.lines
            .iter()
            .map(|line| entry(ui, line))
            .collect::<Vec<_>>(),
    )
    .spacing(ui.space(Space::X1))
    .width(Length::Fill);

    panel::card(ui, height, column![head, panel::scroll_tail(ui, rows)])
}

/// 一行：等级条（跨行）+ **前缀 / 正文两段**（正文折行后落在前缀右边 = 悬挂缩进）。
fn entry<'a>(ui: &'a Ui, line: &'a Line) -> Element<'a, Message> {
    let color = color_of(ui, line.level);
    let (prefix, body) = split_prefix(&line.text);

    let bar = container(space::horizontal())
        .width(BAR_WIDTH)
        .height(Length::Fill)
        .style(move |_theme| container::Style {
            background: Some(Background::Color(color)),
            border: Border {
                radius: ui.radius(ShapeScale::Full, BAR_WIDTH),
                ..Border::default()
            },
            ..container::Style::default()
        });

    // 「前缀 + 正文」拆两个文本控件是悬挂缩进的**唯一**落地方式（iced 的单个 `Text` 折行后
    // 续行一定回到自己的左边距，没有 `text-indent` 之类的排版钩子）：
    // 前缀占第一行开头，正文从它右边开始、带着 `Fill` 宽度自己折行 ⇒ 续行自然落在
    // `前缀宽度` 之后，与下一条日志的起点（x = 等级条右边）分开。
    //
    // M102：正文先过 `wrap::breakable`——`graphics.gl_operation_failure:medium(70)` 这种没有空格的
    // 长串在原版里只能按字形硬断（`gl_o` / `peration`），补上软断点后才断在 `.` `_` `:` 后面。
    let text = row![
        mono(ui, prefix, color),
        mono_owned(ui, wrap::breakable(body), color)
            .width(Length::Fill)
            .wrapping(iced::widget::text::Wrapping::WordOrGlyph),
    ]
    .spacing(0.0)
    .width(Length::Fill)
    .align_y(Alignment::Start);

    row![bar, text]
        .spacing(ui.space(Space::X2))
        .width(Length::Fill)
        .align_y(Alignment::Start)
        .into()
}

/// 拆「前缀」与「正文」：前缀 = 第一个空格及其之前的部分（**含**那个空格，所以接缝处不用再加
/// 间距），正文 = 其余。
///
/// 拆的条件：空格在 1..=[`PREFIX_MAX_CHARS`] 个字符之内。超长（一整行没有空格、或第一个
/// 「词」本身就比 20 字符长，例如以 URL 开头的行）就**不拆**，整行当一个文本块折行——否则
/// 前缀会把正文挤成一条 1 字符宽的缝。
pub(super) fn split_prefix(text: &str) -> (&str, &str) {
    match text.find(' ') {
        Some(index) if index > 0 && index < PREFIX_MAX_CHARS => text.split_at(index + 1),
        _ => ("", text),
    }
}

/// 等级 → 颜色（错误用 `Error`，警告用 `Tertiary`：与主题的 warning 槽位同源）。
fn color_of(ui: &Ui, level: Level) -> Color {
    match level {
        Level::Error => ui.color(Role::Error),
        Level::Warn => ui.color(Role::Tertiary),
        Level::Info => ui.color(Role::OnSurface),
        Level::Debug => ui.color(Role::OnSurfaceVariant),
    }
}

/// 等宽排版档：**同一个 `BodySmall` 档，只把字体族换成 mono 栈**。
///
/// 不新造字号（12/16 与辅助说明同档），所以「等宽」这件事只改字体族这一个维度，
/// 行高仍是令牌值——CJK 回退只换字形，行高不会跳（这也是折行方案的前提之一）。
#[must_use]
pub fn mono_style(ui: &Ui) -> TypeStyle {
    TypeStyle {
        family: FontFamily::Mono,
        ..ui.style(TypeRole::BodySmall)
    }
}

/// 等宽文本（字号 / 行高 / 字重 / 族全来自 [`mono_style`]）。
#[must_use]
pub fn mono<'a>(ui: &Ui, content: &'a str, color: Color) -> iced::widget::Text<'a> {
    mono_styled(ui, content, color)
}

/// 同 [`mono`]，但文案是**拥有的**字符串（摘要行这类运行时拼出来的短串）。
#[must_use]
pub fn mono_owned<'a>(ui: &Ui, content: String, color: Color) -> iced::widget::Text<'a> {
    mono_styled(ui, content, color)
}

fn mono_styled<'a>(
    ui: &Ui,
    content: impl iced::widget::text::IntoFragment<'a>,
    color: Color,
) -> iced::widget::Text<'a> {
    let style = mono_style(ui);

    iced::widget::text(content)
        .size(style.size_px)
        .line_height(LineHeight::Absolute(Pixels(style.line_height_px)))
        .font(ui.font_of(style))
        .color(color)
}