AskaEth
0f26ed3753
r1 复审 p2-1：`TailShare::of` 只判档位，于是 chips 档「刚进页面」（面板只有一行 提示）也被五五分——700×760 下列表 8 个版本只显示 4 个、下半块 ≈160px 空画布， 而修前（main）这一态是 7 整行。修法：判据加**面板形态**，`Hint` 在任何档位都钉死， `Chips` + `Options`/`Install` 才共享。实测回到 7 整行（与 main 同一水位）。 守门：新增 `options_shot/ready.rs`（`ULL_DL_READY_SHOT`，不设 `ULL_DL_DEMO` 出的 700×760 图）：列表区至少读出 6 个版本号。它在 r1 的图上**红**（4 个，原生输出见 mission 报告），在修后图上绿（7 个）。三条旧守门照旧（chips / compact / wide）， chips 与 compact 换修前图仍红。 r1 复审 p2-2：宽度表的实测值改正（同一张 736 图逐项量）： `1.21` 26（余 6）、`1.20` 28（余 4）、`24w` **29**（余 3）、`All versions` 墨迹画到 x=247（裁切边 248，只差 1px）⇒ 桶标签余量是 **3~6px** 而不是 6；「短标签『全部』= 32 零余量」这条论证的对比强度随之写准（比桶标签的 3~6px 更薄）。 `rails/major.rs` 的表格、`options_shot/compact.rs` 的测试文档一并改成实测值； 「墨迹右边界」那条反例也从 216..244 改成实测 216..247。 r1 复审 p3-1：第二级「全部版本」的图标从网格（与第一级同字形同药丸、像素级同形） 换成文档/清单字形 `IconKind::Logs`，理由与「图标集里没有版本/历史字形」写进 `major_shape` 文档。 r1 复审 p3-2：chips 档最多三层滚动（列表 / 面板 / loader 菜单）作为**已知风险** 登记在 `install.rs` 文档里，并写明为什么「把实例名移出滚动区」本轮不做（要拆 `options::section`，动三个文件，而且改完仍无法验证滚轮冒泡——没有通道）。
248 lines
12 KiB
Rust
248 lines
12 KiB
Rust
//! **版本管理页**（原下载页）：三栏版面 —— 版本类型 / 主版本 / 列表 + 安装面板。
|
||
//!
|
||
//! 用户令（信息架构调整）把这一页从「下载」改称「版本管理」：下载页只负责整合包与 Mod/光影，
|
||
//! 而这一页管的是**游戏版本与加载器安装**。本文件是那次改版后的页面装配点。
|
||
//! **标识符不改**（用户令 2026-11-04 的「只改显示层」边界）：`Route::Download` /
|
||
//! `Screen::Download` / 文件名 / 类型名一律保留，全仓重命名另开 finding 后置——所以本文件里
|
||
//! 「下载页」三个字到处都是，那是标识符的叫法，不是界面上出现的词。
|
||
//! **M102 版面订正**：旧版把整页块压到 424 并水平居中（1180 宽下左缘 422、页头标题在 112，
|
||
//! 左右各空 ~300px，视觉复审判为「内容缩在中间一条窄栏」）。现在页面块走 [`frame::body`]
|
||
//! ——左缘与页头标题同一条线（= 页边距 24），宽 = 块宽 `frame::body_width`（1180 下 1044，
|
||
//! 极宽窗封顶 **1440**）。424 只约束**成段散文**（本页没有），三栏的每一栏都吃块宽。
|
||
//!
|
||
//! ## 版面：三栏，宽度由布局系统裁决
|
||
//!
|
||
//! ```text
|
||
//! ┌─────────┬─────────┬──────────────────────────────┐
|
||
//! │ 版本类型 │ 主版本 │ 搜索条 · 命中数 · 计数头 │
|
||
//! │ 140/64 │ 140/64 │ 版本行（单行四项） │
|
||
//! │ │ │ … │
|
||
//! │ │ │ 安装面板（M105 的选项区在这里）│
|
||
//! └─────────┴─────────┴──────────────────────────────┘
|
||
//! ```
|
||
//!
|
||
//! 三个数字**没有一个是在本文件里拍的**：它们来自
|
||
//! [`VersionRails`](super::layout::VersionRails)（宽档裁决 + 数值表在 `pages/layout/rails.rs`）。
|
||
//! 页面只做一件事：把裁决结果交给 [`rails`] 画出来。
|
||
//!
|
||
//! ## 原顶部 4 个 tab 的去处（不是新造分类）
|
||
//!
|
||
//! 四个 chip（全部 / 正式版 / 预览版 / 远古版）**语义一字不改**，只是从顶部横排搬到第一栏竖排；
|
||
//! 窄到三栏不成立时（可用宽 < 600）它们**原样回到顶部**（[`rails::stacked_chips`]）——同一条
|
||
//! [`Category`] 谓词、同一条 `AppCommand::ListVersions`。
|
||
//!
|
||
//! ## 意图 → 消息 → 指令（页面只发意图，不做乐观回显）
|
||
//!
|
||
//! | 用户动作 | 页面消息 | app 层落点 |
|
||
//! |---|---|---|
|
||
//! | 点分类 tab | [`Message::SetCategory`] | `AppCommand::ListVersions(category)`（`All` 不派：画现有快照） |
|
||
//! | 点一行 | [`Message::SelectVersion`] | **只改视图模型**（选中不是业务命令） |
|
||
//! | 点「安装」 | [`Message::InstallVersion`] | `AppCommand::CreateInstance(草稿)`（M105：带加载器与实例名） |
|
||
//! | 点「取消安装」 | [`Message::CancelInstall`] | `AppCommand::CancelInstall` |
|
||
//! | 点「刷新」/「打开日志」 | `Message::Action(RefreshSources)` / `Message::Navigate(Logs)` | `ListVersions` / `AppState::navigate` |
|
||
//!
|
||
//! ## M105：安装选项（加载器维度）
|
||
//!
|
||
//! 选中版本**不再直接开工**。面板下半块变成「安装选项」区：五家加载器（原版 / Forge /
|
||
//! NeoForge / Fabric / Quilt）的 chip、该加载器的官方版本列表、实例名，点「安装」才派
|
||
//! `CreateInstance`。选项的决策与画法在 [`options`]（子模块），本文件只负责把模型交给它。
|
||
//! 加载器版本列表来自 core 的 `LoaderSource::loader_versions`（经
|
||
//! `AppCommand::ListLoaderVersions` 回流到快照）；取不到时页面给具名原因并**禁掉确认**——
|
||
//! 不许「选完才失败」。
|
||
//!
|
||
//! 进度条只读 `model.install`：它由 presenter 的 `InstallProgress` 事件经 `apply` 灌进来。
|
||
//! 于是「点了没变」只有一种解释——后端还没回事件，这正是要的（P3-2 的纪律）。
|
||
//!
|
||
//! ## M107：两级侧栏从哪来（第一级 = 版本类型，第二级 = 主版本桶）
|
||
//!
|
||
//! 第一级 = 版本类型（4 项，固定）；第二级 = 主版本桶（由快照里的版本 id 按 [`group`] 的规则归纳，
|
||
//! 远古版这类「没有主版本概念」的只有「全部版本」一项）。
|
||
//!
|
||
//! ## 搜索（三层口径）
|
||
//!
|
||
//! | 情形 | 画面 |
|
||
//! |---|---|
|
||
//! | 有命中 | 列表照常；侧栏**位置不动**；搜索条右侧给「N 个匹配」（跨类型读数） |
|
||
//! | 一个都不命中 | [`states::no_match`]：没有匹配 + 换短片段 + 清空 |
|
||
//! | 有命中但不在当前类型 | [`states::elsewhere`]：N 个在别的类型 + 「看全部类型」 |
|
||
//! | 搜索中点第二级桶 | **退出搜索 + 按那个桶过滤**（点桶 = 「我就是要看这个桶」，见 `on_download`） |
|
||
//!
|
||
//! 查询词写在 presenter 快照的 `download_query` 里（页面无状态，见 [`model::Download::from_snapshot`]），
|
||
//! 所以「搜索 → 任何事件回来之后仍然在搜」这条不需要页面持有任何字段。
|
||
//!
|
||
//! ## 状态矩阵（加载 / 空 / 有数据 / 安装中 / 失败）
|
||
//!
|
||
//! 与 M94 时一致，唯一的改动是**空态与搜索态都留在三栏骨架里**：侧栏与搜索框照旧在，
|
||
//! 只有列表区换成占位内容——白屏会让人以为列表坏了。
|
||
//!
|
||
//! ## 两个纯视图态的字段（快照里没有，重建会丢）
|
||
//!
|
||
//! `selected_major`（第二级侧栏选中）与 `type_rail_folded`（类型栏手动折叠）**不在 presenter 快照里**
|
||
//! （`AppState` 没有这两个字段，加字段要动 `pages/mod.rs` 的偏离表与 presenter，见 M107 报告）。
|
||
//! 所以它们与既有的 `selected` 同一档处理：`on_download` 直接改视图模型，**不重建**；
|
||
//! 唯一会重建的路径是搜索（`rebuild_after_query`），那里把两个字段在重建前后各搬一次。
|
||
//! 其余事件（安装进度、版本列表刷新）回来时这两个字段会回到默认值——与 `selected` 的既有缺口同源，
|
||
//! 长期要靠 presenter 加字段，已登记在报告里。
|
||
//!
|
||
//! ## 版面判据（M102 口径：页面块 vs 散文列）
|
||
//!
|
||
//! 页面仍是 `PaneKit::Single`（页内自己切三栏）。整页内容走 [`frame::body`]：块左缘 =
|
||
//! 页头标题左缘 = `rail 88 + gutter 24 = 112`，块宽 = [`frame::body_width`]（pane 宽封顶
|
||
//! **1440**）——视觉复审 ①（内容缩在中间一条窄栏、与页头错位）因此收口。
|
||
//! **三栏的列宽从「块宽」算**（[`VersionRails::of_metrics`] 读 `frame::body_width`，不是
|
||
//! `metrics.available`）：否则 1576+ 的超宽窗上三列之和会超出 1440 的块、右侧被裁。
|
||
//! 424（[`super::layout::measure_cap_px`]）在本页只对**成段散文**有效——这一页没有散文。
|
||
|
||
mod demo;
|
||
mod group;
|
||
mod install;
|
||
mod model;
|
||
mod options;
|
||
mod rails;
|
||
mod rows;
|
||
mod states;
|
||
|
||
#[cfg(test)]
|
||
mod tests;
|
||
|
||
pub use demo::demo;
|
||
pub use model::{cancelled_toast, Category, Download};
|
||
pub use options::{InstallDraft, Loader};
|
||
|
||
// M109：内容库页复用**同一块**安装面板（同一个函数、同一套文案与几何），不另写一套。
|
||
//
|
||
// 两个薄包装为什么必须在**这个文件**里：①`install::panel` 是 `pub(super)`（只在 `pages::download`
|
||
// 可见），再导出到 crate 会撞 `E0364`；②面板的入参是 `&Download`，而 `InstallView` 是页面私有
|
||
// 类型（M105 起不再从本模块导出），所以「快照 → 面板形状」的转换也留在这里——内容库只拿到
|
||
// `Option<Download>`，它不需要也不该认识 `InstallView`。
|
||
pub(crate) fn install_panel<'a>(
|
||
ui: &'a Ui,
|
||
catalog: Catalog,
|
||
model: &'a Download,
|
||
) -> Element<'a, Message> {
|
||
install::panel(ui, catalog, model)
|
||
}
|
||
|
||
/// 快照 → 面板要的 `Download` 形状（**只填 `install`**）。
|
||
///
|
||
/// 「装完 / 已取消」这类没有动作可给的终态返回 `None`（与下载页同一个判断
|
||
/// `InstallView::finished`）：留着只会让面板停在一个点不动的状态上。
|
||
pub(crate) fn install_panel_model(
|
||
progress: &unlucky_presenter::dto::InstallProgressView,
|
||
catalog: Catalog,
|
||
) -> Option<Download> {
|
||
let view = model::InstallView::of(progress, catalog);
|
||
if view.finished() {
|
||
return None;
|
||
}
|
||
Some(Download {
|
||
install: Some(view),
|
||
..Download::loading()
|
||
})
|
||
}
|
||
|
||
use iced::widget::column;
|
||
use iced::{Element, Length};
|
||
|
||
use unlucky_design::spacing::Space;
|
||
|
||
use unlucky_i18n::{Catalog, Key, Lang};
|
||
|
||
use crate::app::components::buttons::{self, Button};
|
||
use crate::app::components::divider;
|
||
use crate::theme::Ui;
|
||
|
||
use super::content;
|
||
use super::frame::{self, Header};
|
||
use super::layout::{FrameMetrics, VersionRails};
|
||
use super::{Action, Message};
|
||
|
||
/// 整页（**唯一**的真数据入口：`model` 由 `app/view.rs` 从 presenter 快照建）。
|
||
///
|
||
/// `lang` 是 i18n 的入参，调用点传的是 `pages::Model.lang`（M106 起 = `App` 的生效语言，
|
||
/// 见 `ui::lang::LangState`）；页面自己不读全局、不猜语言。
|
||
pub fn view<'a>(
|
||
ui: &'a Ui,
|
||
metrics: FrameMetrics,
|
||
model: &'a Download,
|
||
lang: Lang,
|
||
) -> Element<'a, Message> {
|
||
let catalog = lang.catalog();
|
||
|
||
let header = Header::new(catalog.text(Key::DownloadTitle))
|
||
.subtitle(catalog.text(Key::DownloadSubtitle))
|
||
// M109：一级切换「版本管理 | 内容库」。两页共用同一条导航轨项（`NavSection::Download`），
|
||
// 所以这个切换是进内容库的唯一产品入口——少了它，内容库只能靠 `ULL_START_ROUTE` 到达。
|
||
.action(content::section_switcher(ui, catalog))
|
||
.action(buttons::text(
|
||
ui,
|
||
Button::new(
|
||
catalog.text(Key::DownloadRefresh),
|
||
Message::Action(Action::RefreshSources),
|
||
),
|
||
));
|
||
|
||
frame::page(ui, metrics, header, body(ui, metrics, catalog, model))
|
||
}
|
||
|
||
/// 正文：加载态仍是居中占位；其余状态都长在三栏骨架上。
|
||
fn body<'a>(
|
||
ui: &'a Ui,
|
||
metrics: FrameMetrics,
|
||
catalog: Catalog,
|
||
model: &'a Download,
|
||
) -> Element<'a, Message> {
|
||
if model.is_loading() {
|
||
// 还没拉到版本列表：三栏没有内容可填，给占位（安装面板照旧带着，见 M94 复审 p3）
|
||
let content: Element<'a, Message> = if model.install.is_some() {
|
||
column![
|
||
states::loading(ui, catalog),
|
||
divider::full(ui),
|
||
install::panel(ui, catalog, model)
|
||
]
|
||
.spacing(ui.space(Space::X3))
|
||
.width(Length::Fill)
|
||
.height(Length::Fill)
|
||
.into()
|
||
} else {
|
||
states::loading(ui, catalog)
|
||
};
|
||
return frame::body(metrics, content);
|
||
}
|
||
|
||
// 宽度裁决：档位来自布局系统，「用户手动折叠了类型栏」这一条覆盖叠在上面。
|
||
let rails = {
|
||
let rails = VersionRails::of_metrics(metrics);
|
||
if model.type_rail_folded {
|
||
rails.with_type_folded()
|
||
} else {
|
||
rails
|
||
}
|
||
};
|
||
|
||
let content: Element<'a, Message> = if rails.tier.is_three_column() {
|
||
rails::three_column(ui, catalog, model, rails)
|
||
} else {
|
||
// 三栏不成立（可用宽 < 600）：类型与主版本原样退回顶部 chips，列表吃掉整条可用宽。
|
||
// 高度分法跟着档位走：chips 档多花两行 chip，面板必须收回自己的一半（M125 缺陷 1）。
|
||
column![
|
||
rails::stacked_chips(ui, catalog, model),
|
||
divider::full(ui),
|
||
rows::content(
|
||
ui,
|
||
catalog,
|
||
model,
|
||
rows::TailShare::of(rails.tier, &install::panel_state(model)),
|
||
),
|
||
]
|
||
.spacing(ui.space(Space::X2))
|
||
.width(Length::Fill)
|
||
.height(Length::Fill)
|
||
.into()
|
||
};
|
||
|
||
// M102：整页块走 `frame::body`（贴左、块宽封顶 1440），与页头标题同一条左缘。
|
||
// 三栏都在这个块里切，所以 `VersionRails` 读的是块宽而不是 `metrics.available`。
|
||
frame::body(metrics, content)
|
||
}
|