Unlucky Launcher v0.2.1
Single-commit source snapshot of the v0.2.1 release.
This commit is contained in:
AskaEth committed
commit
d517f28140
1092 files changed
+211068
No files matched your search
@@ -0,0 +1,92 @@
|
||||
[package]
|
||||
name = "unlucky-app-iced"
|
||||
description = "Unlucky-Launcher 桌面壳（iced 0.14 重写版）：M3 Expressive 骨架 / 令牌适配 / 截图通道"
|
||||
version.workspace = true
|
||||
edition.workspace = true
|
||||
license.workspace = true
|
||||
authors.workspace = true
|
||||
repository.workspace = true
|
||||
rust-version.workspace = true
|
||||
publish.workspace = true
|
||||
|
||||
# 并存期（D26）：Slint 版仍是 `crates/app` 的 `unlucky-launcher`，本 crate 出
|
||||
# `unlucky-launcher-iced`。两个 package 在同一 target 目录产出同名 bin 会冲突，
|
||||
# 所以**翻牌前不许改回 `unlucky-launcher`**（步骤见 SubAgentsTalk/app-iced-骨架与翻牌.md）。
|
||||
[[bin]]
|
||||
name = "unlucky-launcher-iced"
|
||||
path = "src/main.rs"
|
||||
|
||||
[lib]
|
||||
name = "unlucky_app_iced"
|
||||
path = "src/lib.rs"
|
||||
|
||||
[dependencies]
|
||||
# 令牌唯一真源（M61）：颜色/排版/形状/间距/图标几何全部只从这里取。
|
||||
unlucky-design = { path = "../design", version = "0.2.1" }
|
||||
|
||||
# M85：UI 框架无关的宿主层（DTO / 状态 reducer / host）。**只登记依赖，本 mission 不接线**——
|
||||
# 页面用它的时机由后续 iced 页面 mission 决定（接线流程见 crates/presenter/src/lib.rs 的 crate 文档）。
|
||||
# 与 Slint 版共用同一套 host 与状态语义，这是 D26「重写只换渲染」的落点。
|
||||
unlucky-presenter = { path = "../presenter", version = "0.2.1" }
|
||||
|
||||
# UI 框架（D26 锁定 iced 0.14）。**不得依赖 slint**。
|
||||
# 关掉默认 features 后必须显式给执行器（M60 踩坑 Q2：否则 `No futures executor has been enabled`），
|
||||
# 这里给 `thread-pool`（iced 自己的默认执行器，不额外引 tokio 运行时）。
|
||||
# `wgpu` 由本 crate 的 `gpu` feature 打开，于是「仅 CPU」体积基线用 `--no-default-features` 就能量到。
|
||||
iced = { version = "=0.14.0", default-features = false, features = [
|
||||
"tiny-skia",
|
||||
"crisp",
|
||||
"advanced",
|
||||
# M93：背景图要真图直出 ⇒ 需要渲染器的 image 支持。用 `image-without-codecs` 而不是
|
||||
# `image` 是刻意的：后者会打开 `image/default` 的全套编解码器；前者的编解码能力由本 crate
|
||||
# 依赖表里那条 `image` 的 features 决定（png / jpeg / bmp），不必把 webp/tiff/exr/gif 拖进来。
|
||||
"image-without-codecs",
|
||||
"svg",
|
||||
"thread-pool",
|
||||
] }
|
||||
|
||||
# 截图落 PNG + 背景图解码（M93）：png 是截图通道，jpeg/bmp 是用户真会挑的背景图/壁纸格式
|
||||
# （M73 的壁纸探测不筛扩展名）。仍不开 default-features——那会拖进 avif/ravif/webp/tiff 一整套。
|
||||
image = { version = "0.25", default-features = false, features = [
|
||||
"png",
|
||||
"jpeg",
|
||||
"bmp",
|
||||
] }
|
||||
|
||||
# M82：同一个二进制也带 CLI 子命令（`unlucky-launcher-iced instances list` …），
|
||||
# 进 UI 之前分发，命中就把控制权交给 `unlucky_cli::run`。依赖方向 app-iced → cli →
|
||||
# core/agent 不违反 core 零 UI 铁律（core 的依赖树里没有 cli）。零 UI 依赖的 `ull`
|
||||
# 仍在 `crates/cli`，给没有图形库的机器用——两者不是重复品。
|
||||
unlucky-cli = { path = "../cli", version = "0.2.1" }
|
||||
|
||||
# M92（D28）：国际化地基（语言探测 / 消息目录 / 中文字体策略）。零依赖 crate——它拿不到 iced，
|
||||
# 所以系统字体扫描留在这里（`src/fonts/cjk.rs`），本 crate 只把族名喂给它的纯函数。
|
||||
unlucky-i18n = { path = "../i18n", version = "0.2.1" }
|
||||
|
||||
# M97：判据表第 8 行的取证通道。`iced_wgpu` 在真创建设备时会 `log::info!("Selected: {adapter:#?}")`，
|
||||
# 但进程里从来没人装 logger，于是「看不见」被当成了「没发生」。这里装一个只放行 `iced_wgpu*` /
|
||||
# `wgpu*` 的 logger（见 `src/renderer/log_bridge.rs`），把这行捞出来。
|
||||
# 已是 iced 传递依赖树里的版本（0.4.34），不新增任何传递依赖；MIT OR Apache-2.0，许可白名单内。
|
||||
log = { version = "0.4", features = ["std"] }
|
||||
|
||||
# X11 / Wayland 后端与 Linux 主题检测只在 Linux 上启用：macOS 没有 X11/Wayland（走 Metal +
|
||||
# 系统外观），Windows 走 DX12，这三个 feature 在那边没有意义。同一个包在两处写 features 是
|
||||
# **取并集**（Cargo 的 feature 解析是加法），所以 Linux 上拿到的仍是上面 5 个 + 这 3 个，
|
||||
# Windows / macOS 只拿上面那 5 个（`cargo tree --target` 可复核）。
|
||||
# 诚实边界：这**不**解决「iced 版至今没在 macOS 上编过」这件事——`iced_winit` 已把 `mundy`
|
||||
# 放在 `cfg(target_os = "linux")` 段里，这三个 feature 在非 Linux 上本来就不拉依赖，这里只是
|
||||
# 让本仓库的依赖图按平台自述清楚，不再把 Linux 专属能力写成全平台事实。
|
||||
[target.'cfg(target_os = "linux")'.dependencies]
|
||||
iced = { version = "=0.14.0", default-features = false, features = [
|
||||
"x11",
|
||||
"wayland",
|
||||
"linux-theme-detection",
|
||||
] }
|
||||
|
||||
[features]
|
||||
default = ["gpu"]
|
||||
# 硬件渲染后端（wgpu→Vulkan/DX12）。关闭后只剩 tiny-skia（CPU），用于体积基线与无 GPU 机器。
|
||||
gpu = ["iced/wgpu"]
|
||||
|
||||
[lints]
|
||||
workspace = true
|
||||
@@ -0,0 +1,37 @@
|
||||
//! 页面骨架截图入口（M84 `PAGEFRAME` 的验收通道）。
|
||||
//!
|
||||
//! ```text
|
||||
//! cargo run -p unlucky-app-iced --example pages_demo -- \
|
||||
//! --screen=instances --width=1180 --height=760 \
|
||||
//! --screenshot=out.png --screenshot-theme=light --software-renderer
|
||||
//! ```
|
||||
//!
|
||||
//! 参数解析与 iced 接线都在 `unlucky_app_iced::pages::harness` 里：**本 example 只是入口**，
|
||||
//! 它也刻意不接 `cli.rs`（那边归 M75）。详细口径见 `pages::harness` 的模块文档。
|
||||
|
||||
use std::process::ExitCode;
|
||||
|
||||
use unlucky_app_iced::pages::harness::{self, Request};
|
||||
|
||||
fn main() -> ExitCode {
|
||||
let request = match Request::parse(std::env::args().skip(1)) {
|
||||
Ok(request) => request,
|
||||
Err(message) => {
|
||||
eprintln!("[cli] {message}");
|
||||
eprintln!(
|
||||
"用法：pages_demo [--screen=instances|download|settings|logs] [--width <px>] \
|
||||
[--height <px>] [--theme=light|dark] [--screenshot-theme=light|dark] \
|
||||
[--screenshot <png>] [--renderer=auto|gpu|cpu] [--software-renderer]"
|
||||
);
|
||||
return ExitCode::from(2);
|
||||
}
|
||||
};
|
||||
|
||||
match harness::run(request) {
|
||||
Ok(()) => ExitCode::SUCCESS,
|
||||
Err(message) => {
|
||||
eprintln!("[run] {message}");
|
||||
ExitCode::FAILURE
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,130 @@
|
||||
//! App 侧的外观动作：**下发整窗 α / 写回配置 / 打取证日志**。
|
||||
//!
|
||||
//! 三件事各自只有一条路，且都从这里出去（`update` 只负责把它们按消息串起来）：
|
||||
//!
|
||||
//! | 动作 | 唯一落点 | 为什么 |
|
||||
//! |---|---|---|
|
||||
//! | 下发整窗 α | [`App::apply_window_alpha`] → `app::window_alpha::dispatch` | 判据在 `platform`、FFI 在 `platform/win32`，这里只做「取 α → 交给执行侧 → 记日志」 |
|
||||
//! | 写回配置 | [`App::persist_appearance`]（8 个 UI 字段）+ `AppCommand::SetSetting`（另外**三个**只读键） | 每个键**只有一个写者**：`AppearancePrefs` 里没有 `window_opacity` / `palette_source` / `window_corner`，它们只能走 schema 指令 |
|
||||
//! | 取证日志 | [`App::log_appearance`] | 一行里同时有请求值、生效值、下发字节与 FFI 结局 |
|
||||
//!
|
||||
//! ## 为什么「写回」要分两条路
|
||||
//!
|
||||
//! `SettingsBridge::persist` 收的是 `AppearancePrefs`（背景图四件 + 面板 α + 玻璃 + 强调色），
|
||||
//! 它的实现是「先读文件当前值，再覆盖我们改的那几个字段」——所以用它写**它覆盖的键**最省事，
|
||||
//! 也不会把用户的自定义强调色冲掉。而 `appearance.window_opacity` / `appearance.palette_source` /
|
||||
//! `appearance.window_corner` 不在那个结构里（它们是「只读下层键」，见
|
||||
//! `presenter::prefs::AppearanceBase` 的**四个**字段：整窗 α / 标题栏三态 / 配色来源 / 窗口圆角），
|
||||
//! 写它们只能走 schema 白名单指令 `AppCommand::SetSetting`（真 host 用 `SettingStore::set` 落盘）。
|
||||
//! 其中「标题栏三态」目前**没有 UI 写者**（D37 的接线未落地），所以走 `SetSetting` 的是**三个**键。
|
||||
|
||||
use unlucky_presenter::dto::AppCommand;
|
||||
|
||||
use crate::pages::appearance::Change;
|
||||
|
||||
use super::state::App;
|
||||
use super::window_alpha::{self, Dispatch};
|
||||
|
||||
impl App {
|
||||
/// 把当前整窗 α 交给执行侧（补 `WS_EX_LAYERED` + `SetLayeredWindowAttributes`）并记一行日志。
|
||||
///
|
||||
/// 没有句柄时**也打日志**（`hwnd=none`）：不能让「α 没生效」这件事只体现为「屏幕上没变化」。
|
||||
pub(super) fn apply_window_alpha(&self, context: &str) {
|
||||
let Some(hwnd) = self.hwnd else {
|
||||
self.log_appearance(context, None);
|
||||
return;
|
||||
};
|
||||
let alpha = crate::platform::effective_window_alpha(
|
||||
self.appearance.backend,
|
||||
f64::from(self.appearance.window_opacity),
|
||||
);
|
||||
let dispatch = window_alpha::dispatch(hwnd, alpha);
|
||||
self.log_appearance(context, Some(&dispatch));
|
||||
}
|
||||
|
||||
/// 取证日志：`[appearance] <状态行> layered=… outcome=…`。
|
||||
///
|
||||
/// 数值来自 [`crate::pages::appearance::State::log_line`]（请求值 / 生效值 / 下发字节），
|
||||
/// 尾巴来自执行侧。**这一行就是「透明度到底设成了多少」的证据**——RDP 上的观感不可信。
|
||||
pub(super) fn log_appearance(&self, context: &str, dispatch: Option<&Dispatch>) {
|
||||
let mut line = self.appearance.log_line(context);
|
||||
if let Some(dispatch) = dispatch {
|
||||
line.push(' ');
|
||||
line.push_str(&dispatch.describe());
|
||||
} else {
|
||||
line.push_str(" layered=skipped outcome=no-window");
|
||||
}
|
||||
eprintln!("{line}");
|
||||
}
|
||||
|
||||
/// 设置页改了一项外观。
|
||||
pub(super) fn on_appearance(&mut self, change: Change) {
|
||||
let needs_window = self.appearance.apply(change.clone());
|
||||
|
||||
// 配色来源 / 背景图可能变了 ⇒ `Ui` 可能要改用解析出的方案。
|
||||
self.rebuild_ui();
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
|
||||
match change.key() {
|
||||
// 三个只读下层键（整窗 α / 配色来源 / 窗口圆角）：走 schema 指令
|
||||
// （`SettingsBridge` 的结构里没有它们；标题栏三态还没有 UI 写者，不在此列）。
|
||||
Some(_)
|
||||
if matches!(
|
||||
change,
|
||||
Change::WindowOpacity(_) | Change::PaletteSource(_) | Change::Corner(_)
|
||||
) =>
|
||||
{
|
||||
if let (Some(key), Some(value)) = (change.key(), change.value()) {
|
||||
self.dispatch(AppCommand::SetSetting {
|
||||
key: key.to_owned(),
|
||||
value,
|
||||
});
|
||||
}
|
||||
}
|
||||
// 其余键：走 bridge（它知道怎么保留强调色这类本 mission 不管的字段）。
|
||||
Some(_) => self.persist_appearance(),
|
||||
None => {}
|
||||
}
|
||||
|
||||
if needs_window {
|
||||
self.apply_window_alpha("change");
|
||||
} else {
|
||||
self.log_appearance("change", None);
|
||||
}
|
||||
// M116：圆角档位变了要**重新判定 + 重新下发**（与整窗 α 是两条独立的管线）。
|
||||
self.apply_window_corner("change");
|
||||
}
|
||||
|
||||
/// 重读配置后同步外观（热切：外部 CLI / AI 改完 1 秒内生效）。
|
||||
pub(super) fn reload_appearance(&mut self) {
|
||||
let (prefs, _theme) = self.bridge.load();
|
||||
let base = self.bridge.load_base();
|
||||
self.appearance.reload(&prefs, &base);
|
||||
self.appearance_prefs = prefs;
|
||||
self.rebuild_ui();
|
||||
self.view_dirty = true;
|
||||
self.apply_window_alpha("reload");
|
||||
// M116：外部（CLI / AI）改了 `appearance.window_corner` 也要热生效。
|
||||
self.apply_window_corner("reload");
|
||||
}
|
||||
|
||||
/// 把外观写回 `launcher.json`（只改本 mission 管的字段，强调色/玻璃原样保留）。
|
||||
fn persist_appearance(&mut self) {
|
||||
let mut prefs = self.appearance_prefs.clone();
|
||||
prefs.bg_image_enabled = self.appearance.bg_enabled;
|
||||
prefs.bg_image = self.appearance.bg_path.clone();
|
||||
prefs.bg_fill = self.appearance.bg_fill;
|
||||
prefs.bg_dim = self.appearance.bg_dim;
|
||||
prefs.panel_alpha = self.appearance.panel_alpha;
|
||||
prefs.glass = self.appearance.glass;
|
||||
|
||||
self.bridge.persist(&prefs, self.theme_mode);
|
||||
self.appearance_prefs = prefs;
|
||||
|
||||
match self.bridge.path() {
|
||||
Some(path) => eprintln!("[settings] 外观已写回 {}", path.display()),
|
||||
None => eprintln!("[settings] 外观未落盘（数据根解析不出来，内存态运行）"),
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,177 @@
|
||||
//! 本进程**实际**用的是哪个渲染后端（D36 的「CPU 档」判据）。
|
||||
//!
|
||||
//! ## 为什么不能直接看 `--renderer` 的请求值
|
||||
//!
|
||||
//! `Options::backend` 是**请求**（默认 `Auto`）。真正落到哪个渲染器由 `probe::apply` 决定，
|
||||
//! 它把结论写进进程环境变量 `ICED_BACKEND`（iced 只认这个）。于是默认参数 + 没有独显的机器上：
|
||||
//! 请求是 `Auto`，实际是 tiny-skia（CPU）——如果面板 α / 玻璃的降级判据只看请求值，
|
||||
//! D36 明写的「CPU 档面板 α 强制 1.0」**恰好在它最该生效的场景失效**（复审 r1 P2-2）。
|
||||
//!
|
||||
//! 所以判据统一走 [`effective_backend`]：它把 `ICED_BACKEND` 翻译回 [`Backend`]。
|
||||
//! 这里是**唯一**的翻译点，别在别处再读一遍环境变量。
|
||||
//!
|
||||
//! ## M97 之后这条链是准的（以前不是）
|
||||
//!
|
||||
//! 以前 `ICED_BACKEND` 可能是**候选列表**（`wgpu,tiny-skia`），运行期 wgpu 静默回退到
|
||||
//! tiny-skia 时这个变量还停在 wgpu ⇒ 本模块按 **GPU 档**判 ⇒ **半透明在 CPU 渲染器上照开**。
|
||||
//! 也就是说「静默降级」不只让日志说谎，还让 D36 的降级判据一起说谎。
|
||||
//!
|
||||
//! 现在 `ICED_BACKEND` **永远是单项**（[`crate::renderer::Kind`]），而且 `app::boot` 的重试
|
||||
//! 在降级重开前会把它改成 `tiny-skia`，于是：**真降级到 CPU 的那一次，面板 α 会正确地强制 1.0**。
|
||||
//!
|
||||
//! ## 已知边界（诚实登记）
|
||||
//!
|
||||
//! `iced` 0.14 没有公开的「当前后端」查询，所以本模块读的仍是**我们请求的那一项**。
|
||||
//! 单项 + 重试（[`crate::renderer`] 判据表第 8 行）把「请求 ≠ 实际」的窗口压到只剩一种：
|
||||
//! 重试那次自己也失败——那时候进程会带着具名错误退出，不会带着错的档位继续画。
|
||||
|
||||
use crate::renderer::Kind;
|
||||
use crate::Backend;
|
||||
|
||||
/// `ICED_BACKEND` 的取值 → 后端（纯函数，好测）。
|
||||
///
|
||||
/// 逗号列表按**首项**解释：兼容 M97 之前写下的值（以及外部手设的实验值），
|
||||
/// 但本 crate 不再产出那种值（守门测试见 `probe::tests::apply_writes_exactly_one_backend`）。
|
||||
#[must_use]
|
||||
pub(super) fn parse_kind(env: &str) -> Option<Kind> {
|
||||
match env.trim().split(',').next()?.trim() {
|
||||
"tiny-skia" => Some(Kind::TinySkia),
|
||||
"wgpu" => Some(Kind::Wgpu),
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
|
||||
/// `ICED_BACKEND` → 实际档位（纯函数，好测）。
|
||||
///
|
||||
/// | `ICED_BACKEND` | 含义（`probe::apply` 的产物） | 结论 |
|
||||
/// |---|---|---|
|
||||
/// | `tiny-skia` | 只有 CPU（`--renderer=cpu` / 未编 wgpu / 探测无硬件 / wgpu 失败后重开） | [`Backend::Cpu`] |
|
||||
/// | `wgpu` | 判据表第 3、6 行：起步就是 GPU（起不来会打印具名错误并重开成 `tiny-skia`） | [`Backend::Gpu`] |
|
||||
/// | 未设 / 别的值 | 不是本 crate 写的（外部手设 / M97 之前的旧进程） | 请求值（不猜） |
|
||||
#[must_use]
|
||||
pub(super) fn backend_from_env(request: Backend, env: Option<&str>) -> Backend {
|
||||
env.and_then(parse_kind).map_or(request, Kind::tier)
|
||||
}
|
||||
|
||||
/// 本进程实际生效的后端（判据 = `probe::apply` 写下的 `ICED_BACKEND`）。
|
||||
#[must_use]
|
||||
pub(super) fn effective_backend(request: Backend) -> Backend {
|
||||
backend_from_env(request, std::env::var("ICED_BACKEND").ok().as_deref())
|
||||
}
|
||||
|
||||
/// 本进程实际生效的**后端名**（`None` = 变量没写 / 不认识）。
|
||||
///
|
||||
/// 与 [`effective_backend`] 的区别：那个给「档位」，这个给「名字」，用于**取证日志**
|
||||
/// （`[shot] … renderer=wgpu`）。两张图分辨不出 GPU/CPU 的时候，靠的就是这一行。
|
||||
#[must_use]
|
||||
pub(super) fn effective_kind() -> Option<Kind> {
|
||||
std::env::var("ICED_BACKEND")
|
||||
.ok()
|
||||
.as_deref()
|
||||
.and_then(parse_kind)
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::backend_from_env;
|
||||
use crate::Backend;
|
||||
use unlucky_presenter::prefs::{PANEL_ALPHA_MIN, WINDOW_ALPHA_MIN};
|
||||
|
||||
/// 抓得住：`probe::apply` 现在产出的**每一种单项值**都被翻译成正确的档位，
|
||||
/// 且 M97 之前写下的逗号列表仍按首项解释（向后兼容）。
|
||||
/// 抓不住：运行期重试降级那一刻的时序（那由 `app::boot` 的重试保证，见 `renderer` 判据表第 8 行）。
|
||||
#[test]
|
||||
fn every_iced_backend_value_maps_to_a_tier() {
|
||||
// 本 crate 现在只产单项（`probe::tests::apply_writes_exactly_one_backend` 守这一条）。
|
||||
assert_eq!(
|
||||
backend_from_env(Backend::Auto, Some("tiny-skia")),
|
||||
Backend::Cpu,
|
||||
"M97 判据表第 5 行：探测无硬件 ⇒ CPU 档"
|
||||
);
|
||||
assert_eq!(
|
||||
backend_from_env(Backend::Auto, Some("wgpu")),
|
||||
Backend::Gpu,
|
||||
"M97 判据表第 6 行：有硬件 ⇒ GPU 档"
|
||||
);
|
||||
assert_eq!(
|
||||
backend_from_env(Backend::Cpu, Some("tiny-skia")),
|
||||
Backend::Cpu,
|
||||
"强制 CPU 也是 CPU 档"
|
||||
);
|
||||
// 兼容 M97 之前的逗号列表（外部手设 / 旧进程留下）：按首项解释。
|
||||
assert_eq!(
|
||||
backend_from_env(Backend::Auto, Some("tiny-skia,wgpu")),
|
||||
Backend::Cpu
|
||||
);
|
||||
assert_eq!(
|
||||
backend_from_env(Backend::Auto, Some("wgpu,tiny-skia")),
|
||||
Backend::Gpu
|
||||
);
|
||||
assert_eq!(
|
||||
backend_from_env(Backend::Gpu, Some("wgpu,tiny-skia")),
|
||||
Backend::Gpu
|
||||
);
|
||||
// 未设 / 空白：保持请求值（不是本 crate 写的，不猜）。
|
||||
assert_eq!(backend_from_env(Backend::Auto, None), Backend::Auto);
|
||||
assert_eq!(backend_from_env(Backend::Auto, Some(" ")), Backend::Auto);
|
||||
// 不认识的取值不猜：保留请求值。
|
||||
assert_eq!(
|
||||
backend_from_env(Backend::Auto, Some("metal")),
|
||||
Backend::Auto
|
||||
);
|
||||
}
|
||||
|
||||
/// **复审 r1 P2-2 的守门**：默认档（`Auto`）在无独显机器上必须落进 CPU 档，
|
||||
/// 从而让「面板 α / 玻璃强制 1.0」在默认路径上真的生效。
|
||||
///
|
||||
/// 抓得住：判据走 `effective_backend()` 这条链（谁把 `State::new` 改回只吃请求值，这条会红）。
|
||||
/// 抓不住：整窗 α 在 CPU 档仍要生效（那是另一条判据，见 `alpha` 模块真值表）。
|
||||
#[test]
|
||||
fn auto_with_a_software_renderer_forces_the_panel_opaque() {
|
||||
use crate::pages::appearance::alpha::{effective_glass, effective_panel_alpha};
|
||||
|
||||
let backend = backend_from_env(Backend::Auto, Some("tiny-skia"));
|
||||
assert_eq!(backend, Backend::Cpu);
|
||||
assert_eq!(
|
||||
effective_panel_alpha(backend, 0.55),
|
||||
1.0,
|
||||
"D36：CPU 档面板 1.0"
|
||||
);
|
||||
assert!(!effective_glass(backend, true), "D36：CPU 档玻璃强制关");
|
||||
// 但整窗 α 不受限（D36 对 D27 的修订）。
|
||||
assert!(crate::platform::effective_window_alpha(backend, 0.8).is_some());
|
||||
|
||||
// 反方向：GPU 档不做这个降级（否则「强制」就没意义了）。
|
||||
let gpu = backend_from_env(Backend::Auto, Some("wgpu"));
|
||||
assert_eq!(effective_panel_alpha(gpu, 0.55), 0.55);
|
||||
assert!((PANEL_ALPHA_MIN - 0.4).abs() < 1e-9 && (WINDOW_ALPHA_MIN - 0.08).abs() < 1e-9);
|
||||
}
|
||||
|
||||
/// **M97 的新守门**：wgpu 失败重开成 `tiny-skia` 之后，档位必须跟着变成 CPU 档。
|
||||
///
|
||||
/// 这是修之前做不到的一条：那时变量停在 `wgpu,tiny-skia`，静默回退到 tiny-skia 之后
|
||||
/// 判据仍然读 `Gpu` ⇒ 半透明在 CPU 渲染器上照开。现在 `app::boot` 重开前会改写这个值，
|
||||
/// 这条测试钉的是「改写成 tiny-skia 之后判据确实翻转」。
|
||||
/// **两个后端取值各自对应哪个档位、面板 α 各是多少。**
|
||||
///
|
||||
/// ⚠️ 这条**不**守「降级后档位翻转」——它只是把两个字面量喂给纯函数，`respawn` 一行都没执行。
|
||||
/// 复审 M97 r1 p2-1 就是靠这一点把 `respawn` 里的 `.env("ICED_BACKEND", …)` 删掉而测试全绿的。
|
||||
/// 真正的翻转由 `app::boot::tests::fallback_env_carries_the_backend_and_the_gate`
|
||||
/// （respawn 到底传了什么）钉住——那条红了才是「翻转坏了」。
|
||||
#[test]
|
||||
fn each_backend_value_maps_to_its_tier_and_alpha() {
|
||||
use crate::pages::appearance::alpha::effective_panel_alpha;
|
||||
|
||||
let gpu = backend_from_env(Backend::Auto, Some("wgpu"));
|
||||
assert_eq!(gpu, Backend::Gpu);
|
||||
assert_eq!(effective_panel_alpha(gpu, 0.55), 0.55);
|
||||
|
||||
let cpu = backend_from_env(Backend::Auto, Some("tiny-skia"));
|
||||
assert_eq!(cpu, Backend::Cpu);
|
||||
assert_eq!(
|
||||
effective_panel_alpha(cpu, 0.55),
|
||||
1.0,
|
||||
"D36：CPU 档面板 α 强制 1.0"
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,248 @@
|
||||
//! 启动编排：**探测 → 字体 → 打印诊断 → 起 iced**（四步，别把它撑回一坨）。
|
||||
//!
|
||||
//! ## 三条纪律（每条都对应一次返工）
|
||||
//!
|
||||
//! 1. **后端起不来时的两条路策略不同**（判据表第 8/9 行）：交互启动换进程重开、取证启动
|
||||
//! （`--screenshot`）拒绝出图 —— 实现与测试都在 [`fallback`]。
|
||||
//! 2. **窗口设置只有一个产地**（[`diagnostics::window_settings`]），`[window]` / `[caps]` 两行日志
|
||||
//! 从**同一个** `&window::Settings` 取字段。M98 r1 p2-1 的教训：把 `decorations=false` 写进
|
||||
//! 格式化串，等于让日志与真实行为可以各走各的（踩坑记录 U1）。
|
||||
//! 3. **没测过的就写 `skipped`**，不许拿 `0ms` 冒充实测（[`diagnostics::report_font`] 的 `probe`）。
|
||||
//!
|
||||
//! 为什么重开必须是**换进程**：Windows 实测本进程里再 `run()` 一次直接 panic
|
||||
//! （`iced_winit-0.14.1/src/lib.rs:81` → `Create event loop: RecreationAttempt`）。
|
||||
|
||||
use std::time::{Duration, Instant};
|
||||
|
||||
use iced::Task;
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
|
||||
use crate::cli::Options;
|
||||
use crate::fonts;
|
||||
use crate::probe;
|
||||
use crate::renderer::{self, acceptance, Decision};
|
||||
use crate::theme::Families;
|
||||
|
||||
use super::message::Message;
|
||||
use super::state::{App, STARTED};
|
||||
use super::{MIN_SIZE, WINDOW_SIZE};
|
||||
|
||||
mod diagnostics;
|
||||
mod fallback;
|
||||
|
||||
use fallback::{on_failure, respawn, OnFailure};
|
||||
|
||||
/// 启动 iced（阻塞到退出）。`--diff` 不走这里，见 `main.rs`。
|
||||
pub(crate) fn run(options: Options) -> iced::Result {
|
||||
let _ = STARTED.set(Instant::now());
|
||||
let boot_started = Instant::now();
|
||||
|
||||
// ① 探测（判据取在哪、日志在 `report_boot` 里统一打）
|
||||
let boot = boot_probe(&options);
|
||||
let decision = boot.decision;
|
||||
diagnostics::report_boot(&options, &boot.probe, &decision);
|
||||
|
||||
// ② 字体（`fonts` 自己打两行既有日志；新加的那行在 `report_font` 里）
|
||||
let font_started = Instant::now();
|
||||
let resolved = fonts::resolve();
|
||||
let font_ms = font_started.elapsed();
|
||||
eprintln!("[font] 求值耗时 {:.0} ms", font_ms.as_secs_f64() * 1000.0);
|
||||
eprintln!("{}", resolved.describe());
|
||||
if resolved.has_synthetic() {
|
||||
eprintln!(
|
||||
"[font] 警告：有字重落在「合成加粗」档（观感降级），D28 后半（CDN 字体/按档换字族）要处理"
|
||||
);
|
||||
}
|
||||
let families = resolved.families();
|
||||
|
||||
// ③ 打印（主题来源 + 字体回退链 + 启动耗时）
|
||||
// 截图模式：`--screenshot-theme` > `--theme` > **Light**（唯一取值口 `Options::capture_flavor`）。
|
||||
// **不再有**「等系统主题到达」的闸门——CI 的 xvfb 没有主题会话，等它就是挂死（见 cli 文档）。
|
||||
if options.screenshot.is_some() && options.shot_flavor().is_none() {
|
||||
eprintln!("[shot] 未指定主题，按 Light 出图（D30 可复现；CI 冒烟依赖这条默认值）");
|
||||
}
|
||||
let flavor = options.capture_flavor().unwrap_or(SchemeFlavor::Light);
|
||||
diagnostics::report_theme(&options, flavor);
|
||||
diagnostics::report_font(
|
||||
resolved.platform,
|
||||
boot.probe_ms,
|
||||
font_ms,
|
||||
boot_started.elapsed(),
|
||||
);
|
||||
|
||||
// ④ 起 iced（失败按判据表第 8/9 行分流；具名原因在分流之前就打到同一个 stderr 上了）
|
||||
let launch_started = Instant::now();
|
||||
let result = match launch(&options, families, flavor, decision.primary) {
|
||||
Err(iced::Error::GraphicsCreationFailed(error)) => {
|
||||
renderer::report_failure(decision.primary, &error);
|
||||
match on_failure(decision, options.screenshot.as_ref()) {
|
||||
Some(OnFailure::Respawn(fallback)) => {
|
||||
respawn(decision.primary, fallback, &error.to_string())
|
||||
}
|
||||
Some(OnFailure::Refuse) => {
|
||||
// 取证启动：**拒绝降级出图**（换了后端出的图会让报告撒谎）。
|
||||
eprintln!(
|
||||
"[gpu] 拒绝降级出图：本次是取证启动（--screenshot {}），换后端出的图会撒谎。",
|
||||
options
|
||||
.screenshot
|
||||
.as_ref()
|
||||
.map_or_else(String::new, |path| path.display().to_string())
|
||||
);
|
||||
eprintln!(
|
||||
"[gpu] 想用 CPU 出图请显式加 --renderer=cpu / --software-renderer（CI 就是这么跑的）。"
|
||||
);
|
||||
Err(iced::Error::GraphicsCreationFailed(error))
|
||||
}
|
||||
None => Err(iced::Error::GraphicsCreationFailed(error)),
|
||||
}
|
||||
}
|
||||
other => other,
|
||||
};
|
||||
let launch_elapsed = launch_started.elapsed();
|
||||
|
||||
diagnostics::report_outcome(
|
||||
&decision,
|
||||
result.as_ref().err().map(|error| {
|
||||
renderer::named_graphics_error(error).unwrap_or_else(|| error.to_string())
|
||||
}),
|
||||
acceptance::failure_via(decision.fallback.is_some(), options.screenshot.is_some()),
|
||||
if options.screenshot.is_some() {
|
||||
"screenshot"
|
||||
} else {
|
||||
"interactive"
|
||||
},
|
||||
launch_elapsed,
|
||||
);
|
||||
|
||||
result
|
||||
}
|
||||
|
||||
/// 按一次后端启动 iced。`backend` 决定这次写进 `ICED_BACKEND` 的唯一一项。
|
||||
fn launch(
|
||||
options: &Options,
|
||||
families: Families,
|
||||
flavor: SchemeFlavor,
|
||||
backend: renderer::Kind,
|
||||
) -> iced::Result {
|
||||
std::env::set_var("ICED_BACKEND", backend.env_value());
|
||||
|
||||
let boot_options = options.clone();
|
||||
|
||||
// M98：`ULL_WINDOW_SIZE=1520x900` 覆盖尺寸（矩阵的「最小 / 宽屏」两档靠它，且必须走**真外壳**
|
||||
// ——`pages_demo` example 的标题栏是留白带，出不了「三键位置」那张图）。
|
||||
let (size, size_source) = acceptance::window_size(
|
||||
(WINDOW_SIZE.width, WINDOW_SIZE.height),
|
||||
(MIN_SIZE.width, MIN_SIZE.height),
|
||||
);
|
||||
let settings = diagnostics::window_settings(size);
|
||||
// 两行日志与开窗用的是**同一个** settings（见模块文档纪律 2）
|
||||
diagnostics::report_window(&settings, options.scale_factor, size_source);
|
||||
|
||||
let application = iced::application(
|
||||
move || {
|
||||
(
|
||||
App::new(boot_options.clone(), families, flavor),
|
||||
Task::done(Message::Boot),
|
||||
)
|
||||
},
|
||||
App::update,
|
||||
App::view,
|
||||
)
|
||||
.title(App::title)
|
||||
.theme(App::theme)
|
||||
.subscription(App::subscription)
|
||||
.default_font(default_font(families))
|
||||
.window(settings);
|
||||
|
||||
match options.scale_factor {
|
||||
Some(scale) => application.scale_factor(move |_| scale).run(),
|
||||
None => application.run(),
|
||||
}
|
||||
}
|
||||
|
||||
/// [`boot_probe`] 的产物：判据 + 探测到的适配器 + **探测耗时（没测就是 `None`）**。
|
||||
///
|
||||
/// 为什么把 `Probe` 带出来：`[env]` 的 `gpu=` / `hardware=` 必须是**这一次真枚举到的**结果
|
||||
/// （再枚举一遍多花 0.65~1.2 s，还可能给出不同状态）。判据与诊断看同一份数据。
|
||||
struct Boot {
|
||||
decision: Decision,
|
||||
probe: probe::Probe,
|
||||
probe_ms: Option<Duration>,
|
||||
}
|
||||
|
||||
/// 渲染后端探测 + 写 `ICED_BACKEND`，返回判据产物（供 `run` 决定要不要换进程重开）。
|
||||
fn boot_probe(options: &Options) -> Boot {
|
||||
// 「上一步失败后重开」的那一次：别再探（会得到同一个结论，然后无限重开）。兜底必须是 None
|
||||
// ——由 `decision::fallback_round` 单点保证。
|
||||
if let Some(kind) = renderer::forced_fallback() {
|
||||
let decision = renderer::fallback_round(kind);
|
||||
std::env::set_var("ICED_BACKEND", kind.env_value());
|
||||
eprintln!(
|
||||
"[probe] 本次是降级重开（{}={}）：跳过探测 -> ICED_BACKEND={}",
|
||||
renderer::FALLBACK_ENV,
|
||||
kind.env_value(),
|
||||
kind.env_value()
|
||||
);
|
||||
eprintln!("[probe] {}", decision.describe());
|
||||
// 验收要 `[env]` 里的真实适配器：这一轮**也枚举一次，并如实计时**（没计时就 `None`
|
||||
// ⇒ 日志写 `probe=skipped`，不写 0ms）。
|
||||
let (probe, probe_ms) = if acceptance::enabled() {
|
||||
let started = Instant::now();
|
||||
let probe = probe::Probe::run();
|
||||
(probe, Some(started.elapsed()))
|
||||
} else {
|
||||
(probe::Probe::default(), None)
|
||||
};
|
||||
return Boot {
|
||||
decision,
|
||||
probe,
|
||||
probe_ms,
|
||||
};
|
||||
}
|
||||
|
||||
// 只有 `auto` 需要探测（`cpu`/`gpu` 的决策与硬件无关，枚举 13 个适配器本机要 0.65~1.2 s）。
|
||||
// 验收模式例外：`[env]` 那行要 GPU 名，不管请求是哪个后端。
|
||||
let needs_probe = options.backend == crate::Backend::Auto || acceptance::enabled();
|
||||
let probe_started = Instant::now();
|
||||
let probe = if needs_probe {
|
||||
probe::Probe::run()
|
||||
} else {
|
||||
probe::Probe::default()
|
||||
};
|
||||
let probe_ms = needs_probe.then(|| probe_started.elapsed());
|
||||
|
||||
// `ULL_PREFLIGHT=1` 时先自己验一遍 wgpu（判据表第 7 行）；默认不跑，见 preflight 模块文档。
|
||||
let preflight = renderer::preflight::run_if_requested();
|
||||
let decision = probe::apply_with_preflight(options.backend, &probe, preflight.as_ref());
|
||||
|
||||
if cfg!(feature = "gpu") {
|
||||
match probe_ms {
|
||||
Some(elapsed) => eprintln!(
|
||||
"[probe] 探测耗时 {:.0} ms（wgpu 实例 + 全后端适配器枚举）",
|
||||
elapsed.as_secs_f64() * 1000.0
|
||||
),
|
||||
None => eprintln!(
|
||||
"[probe] 探测耗时 跳过（--renderer={} 与硬件无关，未枚举）",
|
||||
options.backend.name()
|
||||
),
|
||||
}
|
||||
}
|
||||
Boot {
|
||||
decision,
|
||||
probe,
|
||||
probe_ms,
|
||||
}
|
||||
}
|
||||
|
||||
/// 默认字体（正文档解析出来的族）。
|
||||
fn default_font(families: Families) -> iced::Font {
|
||||
iced::Font {
|
||||
family: iced::font::Family::Name(families.text),
|
||||
..iced::Font::DEFAULT
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
#[path = "boot/tests.rs"]
|
||||
mod tests;
|
||||
@@ -0,0 +1,110 @@
|
||||
//! 启动阶段的**验收诊断编排**：把 `app/boot.rs` 的 `run()` 收成「探测 → 字体 → 打印 → 起 iced」。
|
||||
//!
|
||||
//! ## 为什么单独一个文件（M98 r1 p2-1 的根因）
|
||||
//!
|
||||
//! 第一版把 `[window] requested … resizable=true decorations=false transparent=false` 直接写在
|
||||
//! 格式化串里，而 `boot.rs` 给窗口的 `settings` 是另一处常量 —— 两者**没有任何绑定**。定向变异
|
||||
//! 把 `settings.decorations` 改成 `true`，371 个测试全绿，而验收包里 `[caps] decorations=true` 与
|
||||
//! `[window] decorations=false` 会互相矛盾（踩坑记录 U1：常量冒充观测结果）。
|
||||
//!
|
||||
//! 现在：窗口设置由 [`window_settings`] **一处**产生，日志由 [`report_window`] 从**同一个
|
||||
//! `&window::Settings`** 取字段。钉死它的守门测试在 `boot/tests.rs`（`window_settings_*`）。
|
||||
//!
|
||||
//! 另一件事：所有「跑没跑」都要能如实说。降级重开那一轮没计时就写 `probe=skipped`，
|
||||
//! 不许拿 `0ms` 冒充一次实测（M98 r1 p3-1）。
|
||||
|
||||
use std::time::Duration;
|
||||
|
||||
use iced::window;
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform as FontPlatform;
|
||||
|
||||
use crate::cli::Options;
|
||||
use crate::probe::Probe;
|
||||
use crate::renderer::{acceptance, Decision};
|
||||
|
||||
use super::MIN_SIZE;
|
||||
use crate::app::APP_TITLE;
|
||||
|
||||
/// 产品窗口设置（**唯一产地**：`launch()` 用它开窗，`[window]` / `[caps]` 从它取字段）。
|
||||
///
|
||||
/// `ULL_WINDOW_SIZE` 的覆盖在 `boot.rs` 解析成 `size` 后从这里进来 —— 日志与真窗口永远同源。
|
||||
pub(super) fn window_settings(size: (f32, f32)) -> window::Settings {
|
||||
window::Settings {
|
||||
size: iced::Size::new(size.0, size.1),
|
||||
min_size: Some(MIN_SIZE),
|
||||
// 自绘三键（M93）：窗口**不许**带系统装饰，否则 macOS 上会出现原生标题栏 + 自绘三键两套。
|
||||
decorations: false,
|
||||
resizable: true,
|
||||
// M93 / D36：整窗 α 需要 `WS_EX_LAYERED`，但这里给不了——`window::Settings` 没有扩展样式
|
||||
// 字段，写它只有 `Get/SetWindowLongPtrW`（`unsafe`，全仓只允许出现在
|
||||
// `platform/win32/transparency.rs`）。所以 α 下发在拿到句柄之后（`Message::WindowHandle`）。
|
||||
transparent: false,
|
||||
..window::Settings::default()
|
||||
}
|
||||
}
|
||||
|
||||
/// `[window] requested` + `[caps]` 两行，**都从同一个 `settings` 取**（不给手抄字面量的机会）。
|
||||
pub(super) fn report_window(settings: &window::Settings, scale: Option<f32>, size_source: &str) {
|
||||
let facts = acceptance::WindowFacts::from_settings(settings);
|
||||
acceptance::report_window(&facts, scale, size_source, Some(APP_TITLE));
|
||||
acceptance::report_caps(
|
||||
std::env::current_exe().ok().as_deref(),
|
||||
facts.transparent,
|
||||
facts.resizable,
|
||||
facts.decorations,
|
||||
);
|
||||
}
|
||||
|
||||
/// 第一段：`[acceptance] on` + `[backend] plan` +（验收模式）`[env]` / `[i18n]`。
|
||||
pub(super) fn report_boot(options: &Options, probe: &Probe, decision: &Decision) {
|
||||
if acceptance::enabled() {
|
||||
acceptance::announce();
|
||||
}
|
||||
acceptance::report_backend_plan(decision, options.backend);
|
||||
if acceptance::enabled() {
|
||||
acceptance::report_startup(probe, options.scale_factor, options.screenshot.is_some());
|
||||
}
|
||||
}
|
||||
|
||||
/// 第二段：`[font] chain` + `[perf] boot`（都要 `ULL_ACCEPTANCE=1`）。
|
||||
///
|
||||
/// `probe = None` = 这一轮**没有探测**（既不是 `auto` 也没开验收）⇒ 打 `probe=skipped`。
|
||||
pub(super) fn report_font(
|
||||
platform: FontPlatform,
|
||||
probe: Option<Duration>,
|
||||
font: Duration,
|
||||
to_run: Duration,
|
||||
) {
|
||||
if acceptance::enabled() {
|
||||
acceptance::report_font_chain(platform);
|
||||
acceptance::report_perf_boot(probe, font, to_run);
|
||||
}
|
||||
}
|
||||
|
||||
/// 第三段：`[theme]`（恒开：它解释的是「这次主题凭什么是这个」）。
|
||||
pub(super) fn report_theme(options: &Options, flavor: SchemeFlavor) {
|
||||
let (source, follows) = acceptance::theme_source(
|
||||
options.screenshot_theme.is_some(),
|
||||
options.theme.is_some(),
|
||||
options.screenshot.is_some(),
|
||||
);
|
||||
let explicit = (!follows).then_some(if flavor.is_dark() { "dark" } else { "light" });
|
||||
acceptance::report_theme(source, explicit, follows);
|
||||
}
|
||||
|
||||
/// 第四段：`[backend] final`（恒开）+ `[perf] session`（验收模式）。
|
||||
///
|
||||
/// `error` = 具名失败原因（`None` = 起来了）；`via` 见 `renderer::acceptance::failure_via`。
|
||||
/// `refuse` / `none` 两条路**什么都没跑起来** ⇒ `final=none`；只有 `respawn` 才有「换到哪个
|
||||
/// 后端」可言（那一格是兜底名，子进程自己还会再打一遍自己的 plan/final）。
|
||||
pub(super) fn report_outcome(
|
||||
decision: &Decision,
|
||||
error: Option<String>,
|
||||
via: &str,
|
||||
mode: &str,
|
||||
elapsed: Duration,
|
||||
) {
|
||||
acceptance::report_outcome(decision, error.as_deref(), via, mode, elapsed);
|
||||
}
|
||||
@@ -0,0 +1,117 @@
|
||||
//! 起步后端失败后的**兜底/重开**一簇：判据、进程环境交接、`respawn`、退出码透传。
|
||||
//!
|
||||
//! 从 `app/boot.rs` 拆出来的理由：这一簇**与启动编排零耦合**，但已有 5 条测试，而且它是
|
||||
//! M97 判据表第 8/9 行的落点。`boot.rs` 那边只负责「什么时候调它」。
|
||||
//!
|
||||
//! ## 为什么必须换进程（别改回进程内重试）
|
||||
//!
|
||||
//! Windows 实测本进程里再 `run()` 一次直接 panic
|
||||
//! （`iced_winit-0.14.1/src/lib.rs:81` → `Create event loop: RecreationAttempt`），winit 一个进程
|
||||
//! 只能建一次事件循环。
|
||||
|
||||
use crate::renderer::Decision;
|
||||
use crate::renderer::{self, acceptance, Kind};
|
||||
|
||||
/// 起步后端失败后的去向（判据表第 8 行 vs 第 9 行——**两条路策略不同，别合成一条**）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub(super) enum OnFailure {
|
||||
/// 交互启动：安全网优先，换进程用这个后端重开。
|
||||
Respawn(Kind),
|
||||
/// 取证启动：红着退出，**不出图**。
|
||||
Refuse,
|
||||
}
|
||||
|
||||
/// 纯判据：起步后端失败时走哪条路。
|
||||
///
|
||||
/// `evidence` 非空 = 本次是取证启动（带 `--screenshot`）；返回 `None` = 没有兜底可用
|
||||
/// （`--renderer=cpu` / 未编 wgpu），原样把错误交回去。抽成纯函数只为一个理由：这条分支以前
|
||||
/// **没有任何测试**，`respawn` / `Refuse` 两条路可以被静默改反（M97 r1 p2-1 就是这么测出来的）。
|
||||
pub(super) fn on_failure(
|
||||
decision: Decision,
|
||||
evidence: Option<&std::path::PathBuf>,
|
||||
) -> Option<OnFailure> {
|
||||
let fallback = decision.fallback?;
|
||||
Some(match evidence {
|
||||
Some(_) => OnFailure::Refuse,
|
||||
None => OnFailure::Respawn(fallback),
|
||||
})
|
||||
}
|
||||
|
||||
/// 降级重开要传给子进程的环境变量（**两条缺一不可**）。
|
||||
///
|
||||
/// ① `ICED_BACKEND`：让子进程直接用 `fallback` 跑。
|
||||
/// ② [`renderer::FALLBACK_ENV`]：**防无限重开的闸门**——子进程见它就必须跳过探测
|
||||
/// （`boot_probe` 的第一个分支），否则会算出同一个结论、再失败、再 respawn。
|
||||
///
|
||||
/// 抽成纯函数是为了让「漏传其中之一」变成**测试能抓到**的错误：两条都是静默失效型
|
||||
/// （漏 ① 重开又跑一遍 wgpu、漏 ② 无限重开），线上极难看出来。
|
||||
pub(super) fn fallback_env(fallback: Kind) -> [(&'static str, &'static str); 2] {
|
||||
[
|
||||
("ICED_BACKEND", fallback.env_value()),
|
||||
(renderer::FALLBACK_ENV, fallback.env_value()),
|
||||
]
|
||||
}
|
||||
|
||||
/// 安全网：起一个**新进程**用 `fallback` 后端重开，然后带着它的退出码退出。
|
||||
///
|
||||
/// 只在**交互启动**时走到这里（取证启动宁可红着退出也不换后端出图）；子进程看到
|
||||
/// [`renderer::FALLBACK_ENV`] 必须跳过探测，否则无限递归重开（闸门在 `boot_probe` 入口）。
|
||||
pub(super) fn respawn(failed: Kind, fallback: Kind, error: &str) -> ! {
|
||||
let exe = std::env::current_exe().unwrap_or_else(|err| {
|
||||
eprintln!("[gpu] 降级重开失败：拿不到自身路径（{err}）");
|
||||
std::process::exit(exit_code(None));
|
||||
});
|
||||
eprintln!(
|
||||
"[gpu] 降级 → {}（{} 已失败，原因见上两行；换一个进程重开：winit 不允许同进程建两次事件循环）。\
|
||||
下一次的日志从 `[probe] 本次是降级重开` 开始。",
|
||||
fallback.name(),
|
||||
failed.name()
|
||||
);
|
||||
// `[backend] final` 一行把「哪个后端失败了、去了哪、为什么」收在一起（可 grep 的单一结论行）。
|
||||
// 这里 `final=` 装的是**兜底**（进程即将带着它重开）；`via=respawn` 说明它是换进程去的。
|
||||
acceptance::report_backend_failed(failed, Some(fallback), Some(fallback), "respawn", error);
|
||||
|
||||
let status = fallback_command(&exe, std::env::args_os().skip(1), fallback).status();
|
||||
|
||||
// 退出码**透传**子进程的：上层脚本/CI 靠它判断成败。写错的失效方式是「安静地给出一个错
|
||||
// 结论」——不崩、不静默降级、不无限重开，只是让 CI 把失败当成功。
|
||||
let code = match status {
|
||||
Ok(status) => exit_code(status.code()),
|
||||
Err(err) => {
|
||||
eprintln!("[gpu] 降级重开失败：{err}");
|
||||
exit_code(None)
|
||||
}
|
||||
};
|
||||
std::process::exit(code)
|
||||
}
|
||||
|
||||
/// 子进程退出码 → 本进程退出码。
|
||||
///
|
||||
/// `None` = 子进程被信号杀死（只有 Unix）：走兜底码而**不是** panic、也不是 0——上层判据是
|
||||
/// 「非零 = 失败」，「拿不到退出码」和「退出码是某个非零值」对脚本是一回事。
|
||||
pub(super) fn exit_code(code: Option<i32>) -> i32 {
|
||||
/// 重开失败 / 拿不到退出码时的兜底码（与 `main` 的「参数或运行错误」一致）。
|
||||
const RESPAWN_FAILED: i32 = 2;
|
||||
code.unwrap_or(RESPAWN_FAILED)
|
||||
}
|
||||
|
||||
/// 构造降级重开的子进程命令（**可测**：program / argv / env 都能在测试里断言）。
|
||||
///
|
||||
/// `program` / `args` 是参数而不是在函数里读 `std::env`，唯一目的是让测试能喂假命令
|
||||
/// （`cmd /c exit 7` / `sh -c "exit 7"`）来验退出码透传——真用 `current_exe()` 就没法测。
|
||||
///
|
||||
/// 三路 stdio **显式**继承：子进程日志必须和父进程同一路输出，否则验收只抓到父进程那两行具名
|
||||
/// 错误。`Command` 没有 stdio 的 getter（stable 没有），所以这条只能靠真跑一次证明。
|
||||
pub(super) fn fallback_command(
|
||||
program: &std::path::Path,
|
||||
args: impl IntoIterator<Item = std::ffi::OsString>,
|
||||
fallback: Kind,
|
||||
) -> std::process::Command {
|
||||
let mut command = std::process::Command::new(program);
|
||||
command.args(args).envs(fallback_env(fallback));
|
||||
command
|
||||
.stdin(std::process::Stdio::inherit())
|
||||
.stdout(std::process::Stdio::inherit())
|
||||
.stderr(std::process::Stdio::inherit());
|
||||
command
|
||||
}
|
||||
@@ -0,0 +1,271 @@
|
||||
//! `app/boot.rs` 的单元测试 + **变异验证说明**（M97 r1）。
|
||||
//!
|
||||
//! 放独立文件（同 `pages/harness/tests.rs`）是为了让 `boot.rs` 留在 400 行内。
|
||||
|
||||
//! ## 变异验证怎么做（M97 r1 的教训，改测试前先读这段）
|
||||
//!
|
||||
//! 这批测试的价值不是「跑绿了」，而是「把实现改坏会红」。做变异时**只在目标函数体内替换**，
|
||||
//! 并且把测试里的同一字面量排除在外：
|
||||
//!
|
||||
//! ```text
|
||||
//! # // 示意（真实脚本是一次性的，没入库）
|
||||
//! def in_body(path, marker, changes):
|
||||
//! """按函数体范围替换。**不能**全局 sed：那会连测试期望里的同一字面量一起改掉，
|
||||
//! 于是实现和断言被换成同一个错值 ⇒ 测试照样绿 ⇒ 验证的是变异脚本自己。"""
|
||||
//! ```
|
||||
//!
|
||||
//! M97 r1 第一次跑变异时，M1/M2/M3 三个变异「照样绿」——不是测试弱，是脚本用全局 `sed`
|
||||
//! 把断言一起改了。这类假绿最阴：变异验证本来是我们判断「测试够不够」的终极手段，
|
||||
//! 手段本身假绿时，它还会附赠「已验证」的强信心。
|
||||
|
||||
use super::fallback::*;
|
||||
use super::*;
|
||||
|
||||
use crate::renderer::acceptance::WindowFacts;
|
||||
use crate::renderer::decision;
|
||||
use crate::renderer::Kind;
|
||||
use std::ffi::{OsStr, OsString};
|
||||
use std::path::Path;
|
||||
|
||||
fn probe(device_type: &'static str) -> crate::Probe {
|
||||
crate::Probe {
|
||||
adapters: vec![crate::probe::AdapterSummary {
|
||||
name: "adapter".to_owned(),
|
||||
device_type,
|
||||
}],
|
||||
hardware: !matches!(device_type, "Cpu" | "Other"),
|
||||
}
|
||||
}
|
||||
|
||||
/// **降级重开到底传了什么**（M97 r1 p2-1 的守门）。
|
||||
///
|
||||
/// 抓得住：`fallback_env` 少写/写错任一条——两条都是静默失效型：
|
||||
/// 漏 `ICED_BACKEND` ⇒ 子进程又去试 wgpu（白开一次窗）；漏 `ULL_GPU_FALLBACK` ⇒ **无限重开**。
|
||||
/// 抓不住：`Command` 本身没被建起来（那要真起进程，见 §「Windows 实测」）。
|
||||
#[test]
|
||||
fn fallback_env_carries_the_backend_and_the_gate() {
|
||||
for fallback in [Kind::TinySkia, Kind::Wgpu] {
|
||||
let env = fallback_env(fallback);
|
||||
assert_eq!(
|
||||
env.len(),
|
||||
2,
|
||||
"就这两条，多一条少一条都要在这里改文档：{env:?}"
|
||||
);
|
||||
assert!(
|
||||
env.contains(&("ICED_BACKEND", fallback.env_value())),
|
||||
"子进程必须直接用 {fallback:?} 跑，实际 {env:?}"
|
||||
);
|
||||
assert!(
|
||||
env.contains(&(renderer::FALLBACK_ENV, fallback.env_value())),
|
||||
"缺防无限重开的闸门 {FALLBACK_ENV:?}，实际 {env:?}",
|
||||
FALLBACK_ENV = renderer::FALLBACK_ENV
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 闸门的另一半：子进程那一轮的决策**不能再有兜底**，否则失败后继续 respawn ⇒ 无限递归。
|
||||
///
|
||||
/// 抓得住：`fallback_round` 的 `fallback` 被写成 `Some(..)`（自杀式循环）。
|
||||
/// 抓不住：`forced_fallback()` 没被 `boot_probe` 调用（那是环境变量的读，见下一条的说明）。
|
||||
#[test]
|
||||
fn fallback_round_never_degrades_again() {
|
||||
for kind in [Kind::TinySkia, Kind::Wgpu] {
|
||||
let decision = decision::fallback_round(kind);
|
||||
assert_eq!(decision.primary, kind);
|
||||
assert_eq!(
|
||||
decision.fallback, None,
|
||||
"降级重开那一次不许再有兜底，否则会无限递归重开"
|
||||
);
|
||||
assert_eq!(decision.reason, "fallback-after-failure");
|
||||
}
|
||||
}
|
||||
|
||||
/// 判据表第 8 行 vs 第 9 行：**交互降级 / 取证拒绝**，两条路的策略不同。
|
||||
///
|
||||
/// 抓得住：`--screenshot` 分支被改回「也降级」（那正是 M97 要杀的「取证工具自己换后端」）。
|
||||
/// 抓不住：`screenshot` 传进来的时机（那是 `run()` 的接线，见 Windows 实测记录）。
|
||||
#[test]
|
||||
fn evidence_start_refuses_instead_of_degrading() {
|
||||
let auto = decision::decide(crate::Backend::Auto, &probe("IntegratedGpu"), true);
|
||||
let evidence = std::path::PathBuf::from("out.png");
|
||||
|
||||
assert_eq!(
|
||||
on_failure(auto, Some(&evidence)),
|
||||
Some(OnFailure::Refuse),
|
||||
"取证启动 + wgpu 起不来 ⇒ 拒绝出图"
|
||||
);
|
||||
assert_eq!(
|
||||
on_failure(auto, None),
|
||||
Some(OnFailure::Respawn(Kind::TinySkia)),
|
||||
"交互启动 + wgpu 起不来 ⇒ 换进程降级"
|
||||
);
|
||||
}
|
||||
|
||||
/// **构造侧**：argv 原样透传、两组 env 都在、program 就是传进来的那个。
|
||||
///
|
||||
/// 抓得住：重开时丢掉用户参数（`--screenshot` / `--screen` / `--data-dir` 全没了，
|
||||
/// 子进程会按默认参数跑，那是最难查的一种「重开后行为变了」）、env 少传（M97 r1 的 p2-1）。
|
||||
/// 抓不住：stdio 继承（`Command` 没有 stdio getter，只能真跑一次，见 `fallback_command` 的注释）。
|
||||
#[test]
|
||||
fn fallback_command_passes_program_argv_and_envs() {
|
||||
let args = ["--renderer=auto", "--screenshot", "out.png"];
|
||||
let command = fallback_command(
|
||||
Path::new("unlucky-launcher-iced"),
|
||||
args.iter().map(OsString::from),
|
||||
Kind::TinySkia,
|
||||
);
|
||||
|
||||
assert_eq!(
|
||||
command.get_program(),
|
||||
OsStr::new("unlucky-launcher-iced"),
|
||||
"program 必须是传进来的那个（生产里是 current_exe）"
|
||||
);
|
||||
assert_eq!(
|
||||
command.get_args().collect::<Vec<_>>(),
|
||||
args.iter().map(OsStr::new).collect::<Vec<_>>(),
|
||||
"argv 必须原样透传，一条不漏、顺序不变"
|
||||
);
|
||||
let envs: Vec<_> = command.get_envs().collect();
|
||||
for (key, value) in fallback_env(Kind::TinySkia) {
|
||||
assert!(
|
||||
envs.contains(&(OsStr::new(key), Some(OsStr::new(value)))),
|
||||
"重开命令缺 {key}={value}，实际 {envs:?}"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// **执行侧**：子进程退出 7 → 父进程拿到 7（不是 0、不是自己造的值）。
|
||||
///
|
||||
/// 抓得住：`exit_code` 被改成恒 0 / 恒 1 / 写成 `status.success().into()`。
|
||||
/// 抓不住：生产里 `current_exe()` 那个 program（测试用假命令，见 `fallback_command` 注释）。
|
||||
#[test]
|
||||
fn fallback_command_really_passes_the_child_exit_code() {
|
||||
#[cfg(windows)]
|
||||
let (program, args) = ("cmd", vec!["/c", "exit", "7"]);
|
||||
#[cfg(unix)]
|
||||
let (program, args) = ("sh", vec!["-c", "exit 7"]);
|
||||
|
||||
let status = fallback_command(
|
||||
Path::new(program),
|
||||
args.iter().map(OsString::from),
|
||||
Kind::TinySkia,
|
||||
)
|
||||
.status()
|
||||
.expect("假子进程必须能起来");
|
||||
assert_eq!(
|
||||
exit_code(status.code()),
|
||||
7,
|
||||
"子进程退出 7，父进程必须透传 7；{status:?}"
|
||||
);
|
||||
}
|
||||
|
||||
/// 子进程**被信号杀死**（`code()` 为 `None`）：走兜底码，不 panic、不当成功。
|
||||
///
|
||||
/// 这是纯函数测试，所以在 Windows 上也能跑（真造一个信号死亡的 `ExitStatus`
|
||||
/// 需要 `ExitStatusExt`，只有 Unix 有；而这里测的正是「拿不到码」那一刻的行为）。
|
||||
#[test]
|
||||
fn signal_death_falls_back_to_a_nonzero_code() {
|
||||
assert_eq!(exit_code(Some(0)), 0, "成功必须透传 0");
|
||||
assert_eq!(exit_code(Some(7)), 7);
|
||||
let fallback = exit_code(None);
|
||||
assert_ne!(fallback, 0, "拿不到退出码绝不能当成功");
|
||||
assert_eq!(fallback, 2, "兜底码与 main 的「参数或运行错误」一致");
|
||||
}
|
||||
|
||||
/// 没有兜底可用的两行（强制 CPU / 未编 wgpu）：失败就原样把错误交回去，不许 respawn。
|
||||
#[test]
|
||||
fn no_fallback_means_no_respawn() {
|
||||
let cpu = decision::decide(crate::Backend::Cpu, &probe("IntegratedGpu"), true);
|
||||
let evidence = std::path::PathBuf::from("out.png");
|
||||
assert_eq!(cpu.fallback, None);
|
||||
assert_eq!(on_failure(cpu, None), None);
|
||||
assert_eq!(
|
||||
on_failure(cpu, Some(&evidence)),
|
||||
None,
|
||||
"强制 CPU 也不该走到「拒绝降级」那条提示上（它压根没想上 GPU）"
|
||||
);
|
||||
|
||||
let not_compiled = decision::decide(crate::Backend::Auto, &probe("IntegratedGpu"), false);
|
||||
assert_eq!(on_failure(not_compiled, None), None);
|
||||
}
|
||||
|
||||
/// **窗口设置就是验收日志里那三个字段的来源**（M98 r1 p2-1 的守门）。
|
||||
///
|
||||
/// 抓得住：把 `decorations` 改回 `true`（自绘三键退回系统装饰）、把 `resizable` / `transparent`
|
||||
/// 打开 —— 这三种改动都会让 `[window]` 与 `[caps]` 两行与代码自相矛盾，而在此之前**371 个测试
|
||||
/// 全绿**（复审 M6 变异实证）。现在它们必须红在这里。
|
||||
/// 抓不住：winit 是否真按这些设置建窗（那要真机看窗口，见判据表「谁能验证」列）。
|
||||
#[test]
|
||||
fn window_settings_match_what_the_acceptance_logs_claim() {
|
||||
let settings = diagnostics::window_settings((1180.0, 760.0));
|
||||
|
||||
assert!(
|
||||
!settings.decorations,
|
||||
"M93 自绘三键：窗口不能带系统装饰（否则 macOS 上会出现两套标题栏）"
|
||||
);
|
||||
assert!(
|
||||
settings.resizable,
|
||||
"验收要验「能否缩放」，窗口必须声明可缩放"
|
||||
);
|
||||
assert!(
|
||||
!settings.transparent,
|
||||
"整窗透明只在 win32 拿到句柄后下发（D36），窗口创建侧不许打开它"
|
||||
);
|
||||
assert_eq!(
|
||||
settings.min_size,
|
||||
Some(MIN_SIZE),
|
||||
"最小尺寸档（880×560）是矩阵的一格，不能被改动"
|
||||
);
|
||||
|
||||
// 日志确实从上面这个 settings 取值（而不是另抄一份字面量）
|
||||
let facts = WindowFacts::from_settings(&settings);
|
||||
let line = crate::renderer::acceptance::window_text(
|
||||
&facts,
|
||||
None,
|
||||
"default",
|
||||
Some(super::super::APP_TITLE),
|
||||
);
|
||||
assert!(line.contains("resizable=true"), "{line}");
|
||||
assert!(line.contains("decorations=false"), "{line}");
|
||||
assert!(line.contains("transparent=false"), "{line}");
|
||||
assert!(line.contains("size=1180x760"), "{line}");
|
||||
assert!(line.contains("min=880x560"), "{line}");
|
||||
|
||||
// 抽字段这一步必须**忠实**：拿一份处处相反的 settings 进来，facts 必须跟着反
|
||||
// （抓的是「from_settings 里又写死一份常量」这条回退路 —— M98 r1 M7 变异实证它当年漏抓）
|
||||
let odd = iced::window::Settings {
|
||||
size: iced::Size::new(640.0, 480.0),
|
||||
min_size: None,
|
||||
decorations: true,
|
||||
resizable: false,
|
||||
transparent: true,
|
||||
..iced::window::Settings::default()
|
||||
};
|
||||
assert_eq!(
|
||||
WindowFacts::from_settings(&odd),
|
||||
WindowFacts {
|
||||
size: (640.0, 480.0),
|
||||
min: None,
|
||||
resizable: false,
|
||||
decorations: true,
|
||||
transparent: true,
|
||||
},
|
||||
"from_settings 必须逐字段搬运，不能在内部再写死一份常量"
|
||||
);
|
||||
|
||||
// 反向：把事实翻个身，日志必须跟着变（证明没有第二份真值）
|
||||
let flipped = WindowFacts {
|
||||
decorations: true,
|
||||
..facts
|
||||
};
|
||||
let line = crate::renderer::acceptance::window_text(
|
||||
&flipped,
|
||||
None,
|
||||
"default",
|
||||
Some(super::super::APP_TITLE),
|
||||
);
|
||||
assert!(
|
||||
line.contains("decorations=true"),
|
||||
"日志必须跟着 settings 走：{line}"
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,101 @@
|
||||
//! 应用消息：单一大枚举。
|
||||
//!
|
||||
//! 纪律：本枚举是**唯一**的消息类型，`view` 产出的所有回调都必须落到这里；组件库与页面层
|
||||
//! 各自用自己的 `Message`（组件契约 §2 的泛型纪律），由 `view` 做一次 `.map` 接上。
|
||||
//!
|
||||
//! ## 三类输入（M90）
|
||||
//!
|
||||
//! | 来源 | 变体 | 落点 |
|
||||
//! |---|---|---|
|
||||
//! | 窗口/框架 | `Boot` / `WindowReady` / `Window` / `Frame` / `Captured` / 三个 caption | [`super::update`] 直接处理 |
|
||||
//! | **时间** | `Frame`（忙碌，33 ms 闸门）+ `Heartbeat`（空闲，1 Hz） | presenter 的 TICK 节拍：`backend.tick` + `drain_events` + `apply` |
|
||||
//! | **页面** | `Page(pages::Message)` | 导航 → `AppState::navigate`；启动/停止 → `AppCommand` |
|
||||
|
||||
use iced::{window, window::Direction};
|
||||
|
||||
use unlucky_presenter::router::Route;
|
||||
|
||||
use crate::pages;
|
||||
use crate::shell::NavItem;
|
||||
|
||||
use super::components;
|
||||
|
||||
/// 消息（单一大枚举）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub enum Message {
|
||||
/// 启动即发一次（`iced::application` 的 boot 闭包）。
|
||||
Boot,
|
||||
/// `window::latest()` 的结果。
|
||||
WindowReady(Option<window::Id>),
|
||||
/// 系统主题探测结果（只可能在**交互模式**出现，截图模式必有主题）。
|
||||
SystemTheme(iced::theme::Mode),
|
||||
/// 一帧画完。**只在需要 33 ms 节拍时订阅**：截图通道 / 有 Busy-Running 实例 / 有未过期
|
||||
/// toast / 派发后的 3 s 观察窗（见 `subscription::needs_frames`）。
|
||||
Frame,
|
||||
/// **空闲态**的 1 Hz 心跳：`Task::perform(sleep(1s))` 的自续链，用来替代空闲时的帧循环
|
||||
/// （M90 r3 / P2-2）。它保证 `theme::config_poll_due` 仍按「30 × 33 ms ≈ 1 秒」的
|
||||
/// presenter 语义跑，外部 CLI/AI 改配置后主题 1 秒内生效。
|
||||
Heartbeat,
|
||||
/// 窗口事件（M90：`Resized` 决定布局档位，600 / 840 两条断点靠它生效）。
|
||||
Window(window::Event),
|
||||
/// 窗口句柄（M93：`window::run` 探测出的 raw handle；`None` = 拿不到，整窗 α 无法下发）。
|
||||
WindowHandle(Option<isize>),
|
||||
/// 页面消息（导航 / 启动 / 停止 / 占位动作）。
|
||||
Page(pages::Message),
|
||||
/// **AI 助手栏 / 独立页**的消息（M104：三档状态、输入框、拖拽、键盘）。
|
||||
///
|
||||
/// 为什么不走 `pages::Message`：助手栏是**外壳级视图**（它挂在任何页面右边），不是某一页的
|
||||
/// 消息；塞进页面枚举还要动 `app/update/page_messages.rs` 的穷尽 match（那个文件正被未合的
|
||||
/// M101 改），绕开它就少一处 rebase 面。落点是 `app/update/agent.rs`。
|
||||
Agent(crate::shell::agent::Message),
|
||||
/// 外壳导航轨点选（`src/shell/nav.rs` 的回调仍然发这一条；收到就翻成同一个路由跳转）。
|
||||
///
|
||||
/// M90 起产品界面用 `pages` 里的真 `NavigationRail`，这条变体是给**外壳回退路径**
|
||||
/// （`Route::Agent`）留的——`shell` 不在本 mission 的 scope 里，不能删它的消息。
|
||||
Select(NavItem),
|
||||
/// 按下标题栏 → 拖窗。
|
||||
DragWindow,
|
||||
/// 边缘热区：开始缩放（方向由坐标决定）。
|
||||
ResizeStart(Direction),
|
||||
/// 最小化。
|
||||
Minimize,
|
||||
/// 最大化/还原。
|
||||
ToggleMaximize,
|
||||
/// 关窗退出。
|
||||
Close,
|
||||
/// 截图回来了。
|
||||
Captured(window::Screenshot),
|
||||
/// gallery（组件库 harness）里的演示交互。
|
||||
Demo(components::gallery::DemoMessage),
|
||||
}
|
||||
|
||||
/// 外壳导航项 → 路由（导航项只在一级页之间有对应；AI 项对应 [`Route::Agent`]）。
|
||||
///
|
||||
/// 这是 `NavItem → Route` 的**唯一**转换点：外壳（`src/shell/nav.rs`）与页面导航轨
|
||||
/// （`pages::NAV`）最终都落到同一个 `Route`，所以两条入口不会各走一套页面语义。
|
||||
pub(super) fn route_of(nav: NavItem) -> Route {
|
||||
match nav {
|
||||
NavItem::Instances => Route::Instances,
|
||||
NavItem::Download => Route::Download,
|
||||
NavItem::Logs => Route::Logs,
|
||||
NavItem::Settings => Route::Settings,
|
||||
NavItem::Ai => Route::Agent,
|
||||
// 轨底头像位（M114）：账户是一级页，但**不在主序列**里
|
||||
NavItem::Account => Route::Accounts,
|
||||
}
|
||||
}
|
||||
|
||||
/// 路由 → 外壳导航项（[`route_of`] 的逆；外壳 rail 与 caption 键都按它高亮）。
|
||||
///
|
||||
/// `Route::Detail(_)` 高亮「实例」（与 `Route::nav()` 同源）。
|
||||
pub(super) fn nav_item_of(route: &Route) -> NavItem {
|
||||
match route {
|
||||
Route::Instances | Route::Detail(_) => NavItem::Instances,
|
||||
// M109：内容库与版本管理共用「下载」那一个导航项（B1 裁定）
|
||||
Route::Download | Route::Content => NavItem::Download,
|
||||
Route::Logs => NavItem::Logs,
|
||||
Route::Settings => NavItem::Settings,
|
||||
Route::Agent => NavItem::Ai,
|
||||
Route::Accounts => NavItem::Account,
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
//! Elm 三件套：`State` / `Message` / `update` + `view` 接线，以及启动序列。
|
||||
//!
|
||||
//! 启动序列：①探测渲染后端并写 `ICED_BACKEND`（必须在 `run()` 之前，M60 Q1）→ ②求值字体栈
|
||||
//! （D28 前半）→ ③`iced::application(..).run()`（1180×760、无边框自绘标题栏）→ ④首个 `view()`
|
||||
//! 打耗时；截图模式第 3 帧落盘后退出（无边框窗首帧可能是旧尺寸，M60 坑 #5）。
|
||||
//!
|
||||
//! ## 为什么拆成目录（M90）
|
||||
//!
|
||||
//! 本文件原来是**单个 400 行的 `app.rs`**：正好卡在「单文件 ≤400 行、动它前必须先拆」的硬门槛上
|
||||
//! （AGENTS 的文件上限 + 本 mission 的第一条任务）。拆法与职责：
|
||||
//!
|
||||
//! | 文件 | 职责（**只做这一件事**） |
|
||||
//! |---|---|
|
||||
//! | [`state`] | [`App`] 字段 + 构造（presenter 三件在此持有）+ 主题切换 |
|
||||
//! | [`message`] | [`Message`] 枚举与「导航项 → 路由」的翻译 |
|
||||
//! | [`update`] | 全部 `Message` 分支 + 「用户动作 → `AppCommand`」的派发与事件回流 |
|
||||
//! | [`subscription`] | 帧事件（截图）与 presenter 的 TICK 节拍 |
|
||||
//! | [`view`] | `view` / `theme` / `title` |
|
||||
//! | [`boot`] | [`run`]：后端探测 → 字体 → `iced::application(..)` |
|
||||
//!
|
||||
//! 拆分的每一步都保持**可观察行为不变**（截图四件套 `--screenshot` / `--screenshot-theme` /
|
||||
//! `--screen=gallery` / `--diff` 出图逐字节相同），presenter 接线是在拆分**之后**另一步做的。
|
||||
//!
|
||||
//! ## 组件库为什么还在本模块下声明
|
||||
//!
|
||||
//! `src/lib.rs` 是五条组件线共用的文件，改它必然冲突；`#[path]` 保证物理路径仍是
|
||||
//! `src/components/`（组件目录自己的归属规则不变），逻辑路径仍是 `crate::app::components`
|
||||
//! （组件源码里的文档与测试都按这个路径写）。
|
||||
|
||||
mod appearance;
|
||||
mod backend;
|
||||
mod boot;
|
||||
mod message;
|
||||
mod state;
|
||||
mod subscription;
|
||||
mod update;
|
||||
mod view;
|
||||
mod window_alpha;
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
|
||||
pub(crate) use boot::run;
|
||||
pub use message::Message;
|
||||
|
||||
// 组件库（D39）在本文件声明：`src/lib.rs` 是五条组件线共用的文件，改它必然冲突；
|
||||
// `#[path]` 保证物理路径仍是 `src/components/`（组件目录自己的归属规则不变）。
|
||||
//
|
||||
// M90：可见性从 `mod` 放到 `pub(crate) mod` —— 页面层（`src/pages/**`）要**用**真组件
|
||||
// （`components::buttons` / `navigation` / `divider`），而 `app` 不是它的父模块。
|
||||
// 只放开 crate 内可见，组件目录的归属规则一字不改。
|
||||
#[path = "../components/mod.rs"]
|
||||
pub(crate) mod components;
|
||||
|
||||
/// 验收窗口尺寸（1180×760 @100% DPI —— D30 的硬要求）。
|
||||
pub const WINDOW_SIZE: iced::Size = iced::Size {
|
||||
width: 1180.0,
|
||||
height: 760.0,
|
||||
};
|
||||
|
||||
/// 产品名（自绘标题栏的标题；`'static` 好让 view 借用）。
|
||||
pub const APP_TITLE: &str = "Unlucky Launcher";
|
||||
|
||||
/// 窗口最小尺寸（再小骨架会挤坏：88 导航 + 页面留白 + 卡片）。
|
||||
const MIN_SIZE: iced::Size = iced::Size {
|
||||
width: 880.0,
|
||||
height: 560.0,
|
||||
};
|
||||
|
||||
/// 截图落盘的帧号（见模块文档）。
|
||||
const CAPTURE_AT_FRAME: u32 = 3;
|
||||
@@ -0,0 +1,188 @@
|
||||
//! 应用状态：**只放字段与构造**，不放消息分支（那是 [`super::update`] 的事）。
|
||||
//!
|
||||
//! ## presenter 三件（`crates/presenter/src/lib.rs` crate 文档 §4）
|
||||
//!
|
||||
//! | 字段 | 谁给 | 干什么 |
|
||||
//! |---|---|---|
|
||||
//! | `backend: Box<dyn Backend>` | [`build_backend`](unlucky_presenter::backend::build_backend) | 派发 [`AppCommand`](unlucky_presenter::dto::AppCommand)、收 [`AppEvent`](unlucky_presenter::dto::AppEvent) |
|
||||
//! | `bridge: SettingsBridge` | [`SettingsBridge::open`](unlucky_presenter::settings_bridge::SettingsBridge::open) | 读一次外观/主题，之后每 N 拍问「文件变了吗」 |
|
||||
//! | `state: AppState` | [`AppState::new`](unlucky_presenter::state::AppState::new) | **唯一**的状态写入口（`apply` / `navigate`） |
|
||||
//!
|
||||
//! `view: pages::Model` 是**展示转换的缓存**：presenter 快照 → 页面要画的东西。
|
||||
//! 它在**状态真的变了**时重建（[`App::view_dirty`] 门控，M90 r2/P2-1 起），不是每拍重建——
|
||||
//! 重建要把 N 个实例的名字/版本串克隆一遍，30 Hz 空转没有意义。缓存成字段是为了让
|
||||
//! `view(&self)` 能只借 `&self`：iced 的 `view` 签名不允许返回一棵借用局部变量的树。
|
||||
//!
|
||||
//! ## 本文件只管「有哪些字段」
|
||||
//!
|
||||
//! M119 起按功能拆出去（`state.rs` 当时正好 400 行、零余量）：
|
||||
//!
|
||||
//! | 子文件 | 内容 |
|
||||
//! |---|---|
|
||||
//! | [`construct`] | 两个构造器 + 字段初始化表 |
|
||||
//! | [`refresh`] | [`App::refresh_view`]（快照 → 视图模型的唯一转换点） |
|
||||
//! | [`theme`] | `Ui` 重算 / 主题档 / [`App::has_screenshot`] |
|
||||
//! | [`boot_probe`] | 启动探针（`ULL_*` 取证开关与首帧日志） |
|
||||
|
||||
use std::time::Instant;
|
||||
|
||||
use iced::window;
|
||||
|
||||
use unlucky_presenter::dto::Backend;
|
||||
use unlucky_presenter::prefs::ThemeMode;
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
use unlucky_presenter::state::AppState;
|
||||
|
||||
use crate::cli::Options;
|
||||
use crate::pages;
|
||||
use crate::theme::{Families, Ui};
|
||||
use crate::ui::lang::LangState;
|
||||
|
||||
/// presenter 的 TICK 节拍（33 ms ≈ 30 fps）——**忙碌态**的节拍。
|
||||
///
|
||||
/// 与 Slint 版的 `TICK_MS` 同值：`backend.tick(..)` 的时间推进、toast 过期、
|
||||
/// `theme::config_poll_due` 的计数都按这个节拍走，两个 UI 版的时间语义因此一致。
|
||||
pub(super) const TICK_MS: u64 = 33;
|
||||
|
||||
/// [`TICK_MS`] 的 `Duration` 形态。
|
||||
pub(super) const TICK: std::time::Duration = std::time::Duration::from_millis(TICK_MS);
|
||||
|
||||
/// **空闲态**的低频心跳（1 Hz，M90 r3 / P2-2）。
|
||||
///
|
||||
/// 空闲时不能订阅 `window::frames()`：那条订阅会自持重绘循环（实测软件渲染约 500 帧/秒），
|
||||
/// 而空闲时唯一需要的时钟是「偶发一次」——外部 CLI / AI 工具改 `launcher.json` 后的热切
|
||||
/// （presenter 的 `theme::config_poll_due` 语义是 30 × 33 ms ≈ 1 秒一拍）。
|
||||
///
|
||||
/// 实现用的是 `Task::perform(async { sleep(1s) })` 的自续链：[`App::heartbeat`]。它每秒只唤醒
|
||||
/// 一次、只触发**一帧**重绘，而 `frames()` 是每秒几百帧。为什么不用 `iced::time::every`：
|
||||
/// 它挂在 tokio/smol 后端下，本 crate 的执行器是 thread-pool（Cargo.toml 不在 scope）。
|
||||
pub(super) const IDLE_TICK: std::time::Duration = std::time::Duration::from_secs(1);
|
||||
|
||||
/// 派发指令后保持帧订阅的观察窗（见 [`App::watch_until`]）。
|
||||
///
|
||||
/// 3 秒够真 host 把「命令已受理」的第一条事件交回来；之后由「有 Busy/Running 实例」这个条件续订。
|
||||
pub(super) const WATCH_WINDOW: std::time::Duration = std::time::Duration::from_secs(3);
|
||||
|
||||
mod boot_probe;
|
||||
mod construct;
|
||||
mod refresh;
|
||||
mod theme;
|
||||
|
||||
/// iced 侧的 presenter 接线层（M119）：物理目录 `src/presenter/`，逻辑名字在 `crate::app::state` 下。
|
||||
///
|
||||
/// 为什么用 `#[path]` 而不是在 `lib.rs` 加一行 `mod presenter;`：本 mission 的 scope 不含
|
||||
/// `lib.rs` / `app/mod.rs`，而 `shell::agent` 挂 `pages/agent/` 是同一个先例。没有第二份实现。
|
||||
#[path = "../presenter/mod.rs"]
|
||||
pub(super) mod presenter;
|
||||
|
||||
pub(crate) use boot_probe::{log_first_frame, STARTED};
|
||||
|
||||
/// 应用状态：UI 状态 + presenter 三件 + 展示转换缓存。
|
||||
pub struct App {
|
||||
/// 启动参数（截图/主题/画面开关）。
|
||||
pub(super) options: Options,
|
||||
/// 字体族（切主题时重建 [`Ui`] 要用）。
|
||||
pub(super) families: Families,
|
||||
/// 令牌求值器（浅/深两套）。
|
||||
pub(super) ui: Ui,
|
||||
/// 后端通道（真 host 或 mock）。
|
||||
pub(super) backend: Box<dyn Backend>,
|
||||
/// 设置持久化桥。
|
||||
pub(super) bridge: SettingsBridge,
|
||||
/// presenter 的全局状态（唯一写入口是 `apply`）。
|
||||
pub(super) state: AppState,
|
||||
/// 已推进的拍数（`theme::config_poll_due` 的输入）。单位是 **33 ms 一拍**，不是调用次数。
|
||||
pub(super) ticks: u64,
|
||||
/// 下一次「比对配置文件 mtime」的 tick 号（见 `update::advance` 的注释）。
|
||||
pub(super) config_due_at: u64,
|
||||
/// 设置文件里的主题模式（`auto` / `light` / `dark`）。
|
||||
///
|
||||
/// 用来定优先级：`--theme` > 配置文件 > 系统主题。没有它，`Message::SystemTheme` 会无条件
|
||||
/// 盖掉配置文件的显式主题（M90 r3 修）。
|
||||
pub(super) theme_mode: ThemeMode,
|
||||
/// 界面语言（M106）：用户档位 + 探测结论 + 目录选择。见 [`crate::ui::lang`]。
|
||||
///
|
||||
/// 为什么不在 `Ui` 里：`theme.rs` 是令牌求值器（颜色/字号），而语言是**运行期状态**——
|
||||
/// 随设置变、要落盘、要重建视图模型（切主题只重建 Style）。
|
||||
pub(super) lang: LangState,
|
||||
/// 上一次推进节拍的时刻（节拍由帧事件驱动，按真实流逝时间累加）。
|
||||
pub(super) last_tick: Instant,
|
||||
/// 窗口宽度（布局档位的判据；交互模式跟着 resize 事件走）。
|
||||
pub(super) width: f32,
|
||||
/// 展示转换缓存（presenter 快照 → 页面视图模型）。
|
||||
pub(super) view: pages::Model,
|
||||
/// 视图模型是否过期（P2-1）：只有 `apply` / `navigate` / resize / 主题这类**真的改了状态**
|
||||
/// 的事情才置位，`advance()` 每拍只在置位时重建模型（否则 30 Hz × N 实例的白克隆）。
|
||||
pub(super) view_dirty: bool,
|
||||
/// 「刚派发过指令，等后端回事件」的观察窗（P2-1）。
|
||||
///
|
||||
/// 空闲态**不订阅帧事件**（只有 1 Hz 的 `heartbeat`），所以派发之后必须有这段短窗口让
|
||||
/// 33 ms 节拍跑起来，否则真 host 的异步事件永远抽不出来。
|
||||
///
|
||||
/// 空闲态不订阅帧事件（不点亮窗口重绘），但派发之后必须有一段短窗口保持节拍，
|
||||
/// 否则真 host 的异步事件永远抽不出来（`LaunchInstance` 之后状态还是 Idle ⇒ 帧订阅永不开启）。
|
||||
pub(super) watch_until: Option<Instant>,
|
||||
/// 窗口句柄（`window::latest()` 之后才有）。
|
||||
pub(super) window: Option<window::Id>,
|
||||
/// 已画的帧数（截图闸门用）。
|
||||
pub(super) frames: u32,
|
||||
/// 视图模型重建次数（P2-1 的可观测计数：空闲态 100 拍里必须是 0 增长）。
|
||||
pub(super) refreshes: u64,
|
||||
/// 首屏快照到位后是否已经自动选中过第一行（list-detail 的桌面惯例，见 `update::auto_select`）。
|
||||
pub(super) auto_selected: bool,
|
||||
/// 窗口高度（背景图平铺网格的视口判据；宽度在 `width`）。
|
||||
pub(super) height: f32,
|
||||
/// 外观运行期状态（M93）：面板 α / 背景图 / 配色来源 / 诊断。
|
||||
pub(super) appearance: pages::appearance::State,
|
||||
/// 设置文件里那 8 个「UI 写入」外观字段的最近快照（写回时只改我们真改了的字段，
|
||||
/// 强调色这类本 mission 不管的字段原样保留）。
|
||||
pub(super) appearance_prefs: unlucky_presenter::prefs::AppearancePrefs,
|
||||
/// 窗口句柄（`Message::WindowHandle` 之后才有；非 Windows 平台恒 `None`）。
|
||||
pub(super) hwnd: Option<isize>,
|
||||
/// 设置页各组自己的运行期状态（M101 r2 的**状态漏斗**）。
|
||||
///
|
||||
/// 所有者在 `pages/settings/state.rs` 的 `Groups`：加/改某一组的字段只改那一组自己的文件，
|
||||
/// 本字段与 `app/view.rs` 都不用动（`settings::States` 只看 `&Groups`，不看任何一组的字段）。
|
||||
/// 放在字段列表**末尾**：后续 mission 若也要往这里加字段，冲突面最小。
|
||||
pub(super) settings: pages::settings::Groups,
|
||||
/// AI 助手栏的 UI 状态（M104）：右栗三档 + 展开宽度 + 草稿/焦点。
|
||||
///
|
||||
/// 挂在 `App` 上而不是全局：这棵树在 `view(&self)` 里只读、在 `update(&mut self)` 里改，
|
||||
/// 状态跟着 App 走才能 per-app、可测（tower 明确否掉了 `OnceLock<Mutex<..>>`）。
|
||||
///
|
||||
/// **只留 UI 态**：会话内容 / 未读 / busy 在 `agent_host` 的 rail 上（M119 起）。
|
||||
pub(super) agent: crate::shell::agent::AgentUi,
|
||||
/// AI 助手的 presenter 句柄（M119）：四个契约 + 事件队列 + 具名错误。
|
||||
///
|
||||
/// 为什么单独一份 `AppState` 而不是把 `state` 交给它：`Presenter` 的可写状态后门
|
||||
/// （`state_mut`）只在 presenter crate 的 `#[cfg(test)]` 里存在，而 `app/subscription.rs`
|
||||
/// 等处仍要直读 `App.state`。所以口径是——**`App.state` 管除 rail 外的一切，这个句柄管 rail**；
|
||||
/// `AppEvent::Agent` 只喂这里（`App.state.ai` 从此不再被读，也不再被写）。
|
||||
pub(super) agent_host: presenter::AgentHost,
|
||||
/// 下载页的安装草稿（M105：选中版本 + 加载器 + 加载器版本 + 实例名）。
|
||||
///
|
||||
/// 为什么住在 `App` 而不是页面模型：`refresh_view` 每次事件都把 `self.view` 整棵重建，
|
||||
/// 页面自己存不住「用户正在填但还没确认」的东西；这与分类筛选（`view.download.category`）
|
||||
/// 是同一个理由、同一个做法。
|
||||
pub(super) download_draft: pages::InstallDraft,
|
||||
/// 已经提示过的取消次数（M105）：`AppState::install_cancelled` 是「发生过几次取消」，
|
||||
/// 这里是「其中几次已经弹过提示」。两者不等 ⇒ 弹一次 i18n 提示。
|
||||
pub(super) install_cancelled_seen: u64,
|
||||
/// 内容库页的页面内选择（M109）：内容类型 / 选中项目 / 目标实例 / 关键词草稿。
|
||||
///
|
||||
/// 为什么在 `App` 而不是 presenter：这四样是「用户在这一屏上点了什么」，重建快照不该冲掉；
|
||||
/// 而检索条件与结果（会跨页存活、要被事件写）在 `AppState::content`。放进 `view` 模型也
|
||||
/// 不行——`refresh_view` 每次都用快照重建模型，选择会被冲回默认值。
|
||||
pub(super) content: pages::content::PageState,
|
||||
/// 账户页的**表单状态**（三条轨道的输入串；密码只活在这一次请求里）。
|
||||
pub(super) account_form: pages::account::Form,
|
||||
/// 账户页视图模型（与 `view` 同一条「状态变了才重建」的门控）。
|
||||
pub(super) account: pages::account::Page,
|
||||
/// 皮肤/头像解码缓存（M114：同一张皮肤只解一次）。
|
||||
pub(super) avatars: pages::account::avatar::Cache,
|
||||
/// 上一次**真下发过**的圆角判定指纹（M116 r1 复审 P2-4：判定没变就不重下、不重记日志）。
|
||||
///
|
||||
/// `None` = 还没下发过（首屏 `boot` 那一次）。指纹类型见
|
||||
/// [`crate::platform::win32::corner::CornerApplied`]。
|
||||
pub(super) corner_applied: Option<crate::platform::win32::corner::CornerApplied>,
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
//! 启动期取证：后端选项的换算 + 首帧耗时那一行日志。
|
||||
//!
|
||||
//! 从 `app/state.rs` 拆出（rebase 到 5adac23 之后 `state.rs` 顶到 401 行）。这两件事都属于
|
||||
//! 「进程启动那一刻记了什么」，与 `App` 的状态机无关；`state.rs` 只留 `pub(super) use` 再导出，
|
||||
//! 于是 `app/boot.rs`（`use super::state::STARTED`）与 `app/view.rs`（`log_first_frame`）的既有路径一字未变。
|
||||
|
||||
use std::sync::atomic::{AtomicBool, Ordering};
|
||||
use std::sync::OnceLock;
|
||||
use std::time::Instant;
|
||||
|
||||
use crate::cli::Options;
|
||||
use unlucky_presenter::backend::AppOptions;
|
||||
|
||||
/// 进程内「run() 开始」的时刻（首帧耗时基线）。
|
||||
pub(crate) static STARTED: OnceLock<Instant> = OnceLock::new();
|
||||
/// 首帧日志只打一次。
|
||||
static FIRST_FRAME_LOGGED: AtomicBool = AtomicBool::new(false);
|
||||
|
||||
/// 启动参数 → presenter 的后端选项。
|
||||
pub(super) fn app_options(options: &Options) -> AppOptions {
|
||||
AppOptions {
|
||||
// `--data-dir`：M90 起**真的消费**它（此前是「接受并忽略」的翻牌兼容参数）。
|
||||
// 截图通道强制 mock，所以 CI 冒烟那条 `--data-dir <tmp>` 不会往那个目录写东西。
|
||||
data_root: options.data_dir.clone(),
|
||||
mock: options.screenshot.is_some(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 首帧耗时日志（只在第一次 `view()` 打一行）。
|
||||
pub(crate) fn log_first_frame() {
|
||||
if FIRST_FRAME_LOGGED.swap(true, Ordering::Relaxed) {
|
||||
return;
|
||||
}
|
||||
if let Some(started) = STARTED.get() {
|
||||
eprintln!(
|
||||
"[boot] first frame in {:.0} ms（run() 开始 → 首次 view，含后端探测与字体扫描）",
|
||||
started.elapsed().as_secs_f64() * 1000.0
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,148 @@
|
||||
//! `App` 的两个构造器（从 `state.rs` 搬出来守 400 行硬线；M119 拆，纯搬不改）。
|
||||
//!
|
||||
//! | 构造器 | 谁用 | 碰不碰磁盘 |
|
||||
//! |---|---|---|
|
||||
//! | [`App::new`](super::App::new) | 生产（`main` → `boot`） | 按启动参数选后端 + 打开设置桥 |
|
||||
//! | [`App::with_presenter`](super::App::with_presenter) | 单测（后端与桥都由调用方给） | **不碰** |
|
||||
//!
|
||||
//! 两个都走 `with_presenter`：生产路径只是先造好后端与桥。**字段初始化表**也在这一个文件里
|
||||
//! （构造 = 字段表 + 三件外部依赖），加字段时只改这一处。
|
||||
|
||||
use iced::window;
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_presenter::backend::{build_backend, config_path};
|
||||
use unlucky_presenter::dto::Backend;
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
use unlucky_presenter::state::AppState;
|
||||
|
||||
use crate::cli::Options;
|
||||
use crate::pages;
|
||||
use crate::theme::{Families, Ui};
|
||||
use crate::ui::lang::LangState;
|
||||
|
||||
use super::super::WINDOW_SIZE;
|
||||
use super::boot_probe::app_options;
|
||||
use super::App;
|
||||
|
||||
impl App {
|
||||
/// 生产构造：按启动参数选后端、打开设置桥。
|
||||
///
|
||||
/// **截图通道强制 mock**：出图要可复现（D30），真 host 会按本机盘上的实例清单画面，
|
||||
/// 同一份代码在两台机器上出不了同一张图。交互模式走真 host（数据根解析不出来时
|
||||
/// [`build_backend`] 自己退回 mock）。
|
||||
pub(in crate::app) fn new(options: Options, families: Families, flavor: SchemeFlavor) -> Self {
|
||||
let backend = build_backend(&app_options(&options));
|
||||
// P2-2：设置桥必须与后端指向**同一个数据根**。早先这里无条件 `SettingsBridge::open()`
|
||||
// （按便携配置解析），于是 `--data-dir X` 会出现「实例来自 X、主题/设置读写默认根」的一进程
|
||||
// 两个数据根。Slint 版是同一条口径：`app/src/ui_bind.rs` 的
|
||||
// `Some(root) => SettingsBridge::with_path(config_path(root))`。
|
||||
let bridge = match &options.data_dir {
|
||||
Some(root) => SettingsBridge::with_path(config_path(root)),
|
||||
None => SettingsBridge::open(),
|
||||
};
|
||||
Self::with_presenter(options, families, flavor, backend, bridge)
|
||||
}
|
||||
|
||||
/// 注入式构造（单测用：后端与桥都由调用方给，**不碰磁盘**）。
|
||||
pub(in crate::app) fn with_presenter(
|
||||
options: Options,
|
||||
families: Families,
|
||||
flavor: SchemeFlavor,
|
||||
backend: Box<dyn Backend>,
|
||||
bridge: SettingsBridge,
|
||||
) -> Self {
|
||||
let width = WINDOW_SIZE.width;
|
||||
let height = WINDOW_SIZE.height;
|
||||
let theme_mode = bridge.load().1;
|
||||
// 外观两半分开读：`load()` 给 8 个 UI 写入字段，`load_base()` 给 4 个只读下层键
|
||||
// （整窗 α / 标题栏三态 / 配色来源 / 窗口圆角）。M93 之前这些键在 app 侧**根本读不到**。
|
||||
//
|
||||
// 截图通道**不读用户配置**（D30：同一份代码在两台机器上要出同一张图）：外观一律取出厂值，
|
||||
// 矩阵需要的值由 `ULL_APPEARANCE_*` 显式灌进来。
|
||||
let (appearance_prefs, appearance_base) = if options.screenshot.is_some() {
|
||||
(
|
||||
unlucky_presenter::prefs::AppearancePrefs::factory(),
|
||||
unlucky_presenter::prefs::AppearanceBase::factory(),
|
||||
)
|
||||
} else {
|
||||
(bridge.load().0, bridge.load_base())
|
||||
};
|
||||
// 面板 α / 玻璃的降级判据要的是**实际**后端，不是 `--renderer` 的请求值（复审 r1 P2-2）：
|
||||
// 默认 `Auto` + 无独显时请求是 Auto、实际是 tiny-skia，只看请求值就会漏掉 D36 的强制项。
|
||||
let backend_tier = super::super::backend::effective_backend(options.backend);
|
||||
let mut appearance = pages::appearance::State::new(
|
||||
&appearance_prefs,
|
||||
&appearance_base,
|
||||
backend_tier,
|
||||
flavor,
|
||||
);
|
||||
// 取证开关（D30）：`ULL_SETTINGS_GROUP=<下标>` 直达设置页的某一组（出图要看见语言行）。
|
||||
if let Some(index) =
|
||||
crate::ui::lang::screenshot_settings_group(options.screenshot.is_some())
|
||||
{
|
||||
appearance.selected_group = index;
|
||||
}
|
||||
// 界面语言（M106）：**M92 已经探测对了，问题是一直没人用**——`pages::Model.lang` 此前在
|
||||
// `view::model` 里被写死成 `Lang::En`，于是中文系统上开出来的是全英文界面。
|
||||
let lang = LangState::boot(&bridge, options.screenshot.is_some());
|
||||
let mut view = pages::Model::new(
|
||||
pages::Screen::Instances,
|
||||
width,
|
||||
Some(pages::Screen::Instances.nav()),
|
||||
);
|
||||
view.lang = lang.lang();
|
||||
|
||||
let mut app = Self {
|
||||
ui: Ui::new(flavor, families),
|
||||
families,
|
||||
options,
|
||||
backend,
|
||||
bridge,
|
||||
state: AppState::new(),
|
||||
ticks: 0,
|
||||
config_due_at: unlucky_presenter::theme::CONFIG_POLL_TICKS,
|
||||
theme_mode,
|
||||
lang,
|
||||
last_tick: std::time::Instant::now(),
|
||||
width,
|
||||
view,
|
||||
view_dirty: false,
|
||||
watch_until: None,
|
||||
window: None::<window::Id>,
|
||||
frames: 0,
|
||||
refreshes: 0,
|
||||
auto_selected: false,
|
||||
height,
|
||||
appearance,
|
||||
appearance_prefs,
|
||||
hwnd: None,
|
||||
settings: pages::settings::Groups::default(),
|
||||
// 出厂是**空会话**（M119 删了 M104 的样本会话）；取证开关 `ULL_AGENT_*` 的档位
|
||||
// 与夹具在 `boot_agent` 里落地（它要先让 presenter 知道栏可见性，见那里）。
|
||||
agent: crate::shell::agent::AgentUi::new(),
|
||||
agent_host: super::presenter::AgentHost::from_env(),
|
||||
// 下载页安装草稿（M105）：出厂态 = 没选中、原版、两个空串
|
||||
download_draft: pages::InstallDraft::default(),
|
||||
install_cancelled_seen: 0,
|
||||
content: pages::content::PageState::default(),
|
||||
account_form: pages::account::Form::new(),
|
||||
account: pages::account::Page::build(
|
||||
&AppState::new(),
|
||||
&pages::account::Form::new(),
|
||||
&mut pages::account::avatar::Cache::default(),
|
||||
unlucky_i18n::Lang::En,
|
||||
width,
|
||||
),
|
||||
avatars: pages::account::avatar::Cache::default(),
|
||||
corner_applied: None,
|
||||
};
|
||||
// 配色来源档可能已经指向一张背景图：那时 `Ui` 必须由解析出的方案构造，而不是 baseline。
|
||||
app.rebuild_ui();
|
||||
// 两行日志：①档位 + 探测结论 + 生效语言 ②中文策略（D28 缺字体不许静默）。
|
||||
// 下一个人据此分得清「探测错了」还是「探测对了但没用上」。
|
||||
app.lang.log();
|
||||
app.lang.log_cjk();
|
||||
app
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,61 @@
|
||||
//! 快照 → 视图模型的重建口径（从 `state.rs` 搬出来守 400 行硬线；M119 拆，纯搬不改）。
|
||||
//!
|
||||
//! 全仓只有 [`App::refresh_view`] 这一个「presenter 快照 → 页面要画的东西」的转换点，
|
||||
//! 由 [`App::view_dirty`](super::App) 门控（M90 r2/P2-1 起）：只有真的改了状态的事情才置位，
|
||||
//! 30 Hz 空转不重建（重建要把 N 个实例的名字/版本串克隆一遍）。
|
||||
|
||||
use unlucky_presenter::toast::ToastKind;
|
||||
|
||||
use crate::pages;
|
||||
|
||||
use super::App;
|
||||
|
||||
impl App {
|
||||
/// 把 presenter 的快照转换成页面视图模型（**展示转换在 UI 侧做**）。
|
||||
///
|
||||
/// 代价是「克隆 N 个实例的名字/版本串」，所以只在 [`App::view_dirty`] 置位时调用（P2-1）。
|
||||
pub(in crate::app) fn refresh_view(&mut self) {
|
||||
// **不变式先对齐再算宽度**（M104 / 复审 r1 P2-1）：`Route::Agent` ⟺ `RailState::Detached`。
|
||||
// 每一次路由变化都会走到这里，所以它是「档位 ↔ 路由」的唯一点；放在算宽度之前，
|
||||
// 是为了让模型拿到的 `content_width` 与页面头部读到的档位来自同一份状态。
|
||||
self.sync_agent_route();
|
||||
// M119：把「栏可见吗」写回 presenter（未读口径的输入，两个窄入口：`navigate` + `prefs_mut`）。
|
||||
// 必须在 `sync_agent_route` 之后：档位刚被它对齐过，这里读到的才是这一帧的真值。
|
||||
self.sync_agent_presenter();
|
||||
|
||||
// M105：取消安装的提示语在**这里**弹（`refresh_view` 是事件 apply 之后必经的那一处）。
|
||||
// 文案由页面层求（`pages::cancelled_toast`），presenter 只发信号 ——
|
||||
// 否则会出现「选项区英文、取消弹窗中文」的同屏两语（复审 P2-2）。
|
||||
if self.state.install_cancelled != self.install_cancelled_seen {
|
||||
self.install_cancelled_seen = self.state.install_cancelled;
|
||||
// M106：提示语跟着**生效语言**走（M105 留的 `view::ui_lang()` 占位已删——它恒英文，
|
||||
// 中文界面会弹出英文提示，那正是 M105 r1 复审 P2-2 要堵的同屏两语）。
|
||||
let text = pages::cancelled_toast(self.lang());
|
||||
self.state.toasts.push(ToastKind::Info, text);
|
||||
}
|
||||
|
||||
// 分类是**页面自己持有的过滤条件**（真 host 丢弃 `ListVersions` 的分类参数）：
|
||||
// 重建视图模型时带回去，否则每次事件都会把 chip 打回「全部」（复审 P2-1）。
|
||||
let category = self.view.download.category;
|
||||
// 草稿同理（M105）：它也是页面自己持有的输入，重建模型时带回去，
|
||||
// 否则每来一条事件（连安装进度都算）用户填的加载器就被抹回「原版」。
|
||||
let draft = self.download_draft.clone();
|
||||
// 右栏占掉的宽度先扣掉：面板展开时页面按更窄的宽度排版（「收缩而不是溢出」，M104）
|
||||
let width = self.agent.content_width(self.width);
|
||||
// M106：语言形参跟着 `LangState` 走（`draft` 那一位是 M105 的安装草稿）。
|
||||
self.view = super::super::view::model(
|
||||
&self.state,
|
||||
width,
|
||||
self.options.force_state,
|
||||
category,
|
||||
&draft,
|
||||
self.lang(),
|
||||
&self.content,
|
||||
);
|
||||
// 账户页（M114）：与 `view` 同一次门控重建（实现见 `view/account_page.rs`，
|
||||
// 皮肤解码走缓存，所以重复重建不重解图）。
|
||||
self.rebuild_account_page(width);
|
||||
self.view_dirty = false;
|
||||
self.refreshes += 1;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,86 @@
|
||||
//! 主题与 `Ui` 的重算口径（从 `state.rs` 搬出来守 400 行硬线；M119 拆，纯搬不改）。
|
||||
//!
|
||||
//! 三件事在这里：①`Ui` 什么时候重建（[`App::rebuild_ui`]）②主题档怎么定
|
||||
//! （[`App::set_flavor`] / [`App::apply_config_theme`]）③读当前求值器（[`App::ui`]）。
|
||||
//!
|
||||
//! 截图通道的判据 [`App::has_screenshot`] 也放在这儿：上面三条里两条都要「截图不读用户配置」。
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_presenter::prefs::ThemeMode;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::App;
|
||||
|
||||
impl App {
|
||||
/// 本次进程是否走截图通道。
|
||||
pub(in crate::app) fn has_screenshot(&self) -> bool {
|
||||
self.options.screenshot.is_some()
|
||||
}
|
||||
|
||||
/// 切主题：重建 [`Ui`]（= 重建 Style），**不动任何 UI 状态**。
|
||||
///
|
||||
/// M93 起 `Ui` 有两个来源：配色来源取到了图（①②级）就用解析出的方案，否则用令牌 baseline。
|
||||
/// 所以这里改叫「重算 `Ui`」：先让外观状态记住新深浅（配色解析要它），再重建。
|
||||
pub(in crate::app) fn set_flavor(&mut self, flavor: SchemeFlavor) {
|
||||
if self.ui.flavor() == flavor && self.appearance.flavor() == flavor {
|
||||
return;
|
||||
}
|
||||
|
||||
self.appearance.set_flavor(flavor);
|
||||
let previous = self.ui.name();
|
||||
self.rebuild_ui();
|
||||
eprintln!(
|
||||
"[theme] {} -> {} (Theme::name 变化触发缓存重算)",
|
||||
previous,
|
||||
self.ui.name()
|
||||
);
|
||||
}
|
||||
|
||||
/// 按「配色来源是否取色成功」重建 [`Ui`]。
|
||||
///
|
||||
/// 色卡档（③）刻意继续走 `Scheme::baseline`：`resolve_source` 的色卡档返回的是
|
||||
/// `DEFAULT_CARD`（天蓝卡）方案，与令牌 baseline 逐色不同，应用它会把**全部既有验收图的
|
||||
/// 像素**改掉。这条偏离登记在 `pages::appearance` 的偏离表 #4。
|
||||
pub(in crate::app) fn rebuild_ui(&mut self) {
|
||||
// 面板 α（D36）在这里注入 `Ui`：全仓所有表面色都从 `Ui::layer` 出去，所以这是**唯一**
|
||||
// 生效点（外壳 / 三页卡片 / 外观分组卡片 / 空态图标块自动同源，调用点没有机会各处自乘）。
|
||||
let panel_alpha = self.appearance.effective_panel_alpha();
|
||||
self.ui = match self.appearance.derived_scheme() {
|
||||
Some(scheme) => {
|
||||
eprintln!(
|
||||
"[appearance] palette={} → Ui::from_scheme（取色方案接管 49 个角色）",
|
||||
self.appearance.palette_level()
|
||||
);
|
||||
Ui::from_scheme(*scheme, self.families)
|
||||
}
|
||||
None => Ui::new(self.appearance.flavor(), self.families),
|
||||
}
|
||||
.with_panel_alpha(panel_alpha);
|
||||
}
|
||||
|
||||
/// 按设置文件里的主题模式切一次外观；`--theme` 显式给了就不动。
|
||||
///
|
||||
/// **截图通道直接跳过**：`--screenshot` 的主题唯一取值口是 `Options::capture_flavor`
|
||||
/// （D30 可复现），读本机 `launcher.json` 会让同一份代码在两台机器上出不同的图。
|
||||
///
|
||||
/// `ThemeMode::Auto` 不在这里处理：那要看系统主题（`iced::system::theme()` 的结果在
|
||||
/// `Message::SystemTheme` 里落地）。
|
||||
pub(in crate::app) fn apply_config_theme(&mut self) {
|
||||
if self.has_screenshot() || self.options.theme.is_some() {
|
||||
return;
|
||||
}
|
||||
let mode = self.bridge.load().1;
|
||||
self.theme_mode = mode;
|
||||
match mode {
|
||||
ThemeMode::Light => self.set_flavor(SchemeFlavor::Light),
|
||||
ThemeMode::Dark => self.set_flavor(SchemeFlavor::Dark),
|
||||
ThemeMode::Auto => {}
|
||||
}
|
||||
}
|
||||
|
||||
/// 当前令牌求值器（测试与截图日志用）。
|
||||
pub(in crate::app) fn ui(&self) -> &Ui {
|
||||
&self.ui
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,94 @@
|
||||
//! 订阅：**按需**帧节拍（presenter 的 TICK）+ 窗口尺寸事件。
|
||||
//!
|
||||
//! ## 为什么要「按需」
|
||||
//!
|
||||
//! iced_winit 在处理完任何一条消息后都会 `request_redraw()`，而 `window::frames()` 监听的是
|
||||
//! `RedrawRequested` —— 于是「订阅帧 → 收 Frame → update → 再触发重绘」是一条**自持循环**：
|
||||
//! 只要订阅着，窗口就永远在重绘（M90 r1 就是这样，CPU 空转）。
|
||||
//!
|
||||
//! 现在只在**真的需要 33 ms 节拍**的时候订阅（[`App::needs_frames`]）：
|
||||
//!
|
||||
//! | 条件 | 为什么需要 33 ms 节拍 |
|
||||
//! |---|---|
|
||||
//! | 截图通道 | 第 3 帧要落盘 |
|
||||
//! | 有 `Busy` / `Running` 实例 | 启动进度、日志尾随都靠 `backend.tick` 推进 |
|
||||
//! | 有未过期的 toast | toast 按毫秒倒计时 |
|
||||
//! | 刚派发过指令（3 s 观察窗） | 真 host 的异步事件要靠节拍抽出来 |
|
||||
//!
|
||||
//! 空闲态**一条帧消息都不来** ⇒ 窗口不重绘、`refresh_view` 不跑（配合 `view_dirty`）。
|
||||
//!
|
||||
//! ## 空闲态的时钟从哪来（M90 r3 / P2-2）
|
||||
//!
|
||||
//! r2 把空闲的帧订阅掐掉之后，`config_poll_due` 就再也没被调用过 —— 外部 CLI / AI 工具改
|
||||
//! `launcher.json` 后主题**永不生效**（不是「等下次交互」，是「等下一次 dispatch」）。这与
|
||||
//! D4「AI 能读改 ULL 配置」直接冲突。
|
||||
//!
|
||||
//! 所以空闲态换成一个 **1 Hz 的自续心跳**（[`crate::app::message::Message::Heartbeat`]，
|
||||
//! 由 `Task::perform(sleep(1s))` 驱动，见 `update::heartbeat`）：每秒醒一次、推进一拍
|
||||
//! presenter（内部按 33 ms 折算 30 拍，于是 `config_poll_due` 仍是「约 1 秒比对一次 mtime」）。
|
||||
//!
|
||||
//! 为什么不用 `window::frames()` + 1 s 闸门来实现这个低频时钟：帧订阅**本身就是**自持重绘循环
|
||||
//! （iced_winit 处理完任何消息都 `request_redraw()`），闸门只能省掉 `advance()` 里的活，省不掉
|
||||
//! 整窗重绘——实测软件渲染约 **500 帧/秒**。心跳是「每秒一帧」，差三个数量级。
|
||||
//!
|
||||
//! ## 已知代价（都登记，不藏）
|
||||
//!
|
||||
//! 1. **忙碌态仍是自持帧循环**：`Running`/`Busy` 一天不结束，就一天按帧刷（软件渲染实测约
|
||||
//! 970 帧/秒，refreshes 不增长 = 纯像素空转）。功能上需要 tick 来发现游戏退出，但「整段
|
||||
//! 运行期近千帧/秒重绘」是真实开销；要收口得让 `Running` 走更慢的时钟（follow-up）。
|
||||
//! 2. 心跳用 `thread::sleep` 占线程池一个线程 1 秒；1 Hz 下可接受，但不是优雅解法（正解仍是
|
||||
//! `iced::time::every` + tokio/smol，Cargo.toml 在 scope 外，已报 finding）。
|
||||
|
||||
use std::time::Instant;
|
||||
|
||||
use iced::{window, Subscription};
|
||||
|
||||
use super::message::Message;
|
||||
use super::state::App;
|
||||
|
||||
impl App {
|
||||
/// 本次进程的订阅表。
|
||||
pub(super) fn subscription(&self) -> Subscription<Message> {
|
||||
let frames = if self.needs_frames() {
|
||||
window::frames().map(|_| Message::Frame)
|
||||
} else {
|
||||
Subscription::none()
|
||||
};
|
||||
|
||||
// 断点 600 / 840 要跟着真窗口宽度走；截图模式的窗口尺寸由参数钉死，不吃 resize。
|
||||
let events = if self.has_screenshot() {
|
||||
Subscription::none()
|
||||
} else {
|
||||
window::events().map(|(_, event)| Message::Window(event))
|
||||
};
|
||||
|
||||
// 键盘（M104）：`Esc` 收栗 / `Tab` 走焦点环 / `Enter` 激活焦点键。
|
||||
//
|
||||
// 为什么订阅整条键盘流而不是自己挑键：`iced::keyboard::listen()` 是唯一的全窗键盘入口，
|
||||
// 挑键与「什么状态下该做什么」的解释权放在 `app/update/agent.rs`（一眼看完），
|
||||
// 订阅表只负责搬运。截图通道不开它——D30 要可复现，键盘事件一个都不该进图。
|
||||
let keys = if self.has_screenshot() {
|
||||
Subscription::none()
|
||||
} else {
|
||||
iced::keyboard::listen()
|
||||
.map(|event| Message::Agent(crate::shell::agent::Message::Key(event)))
|
||||
};
|
||||
|
||||
Subscription::batch([frames, events, keys])
|
||||
}
|
||||
|
||||
/// 是否订阅帧事件（= 截图模式要帧数闸门）。
|
||||
pub(super) fn wants_frames(&self) -> bool {
|
||||
self.has_screenshot()
|
||||
}
|
||||
|
||||
/// 现在要不要**时钟**（见模块文档的表）。
|
||||
pub(super) fn needs_frames(&self) -> bool {
|
||||
self.has_screenshot()
|
||||
|| !self.state.toasts.is_empty()
|
||||
|| !self.state.running().is_empty()
|
||||
|| self
|
||||
.watch_until
|
||||
.is_some_and(|deadline| Instant::now() < deadline)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,382 @@
|
||||
//! `app` 的单测：主题切换、窗口尺寸、截图闸门、gallery 能构图，以及**presenter 接线的闭环**。
|
||||
//!
|
||||
//! 闭环测试用的是 `MockBackend`（presenter 自带的假后端）：它走的是与真 host 完全相同的
|
||||
//! `dispatch → drain_events → AppState::apply → 视图模型` 通道，所以「点 Play → 状态真的变」
|
||||
//! 这件事在这里就能判死，不必等图形环境。
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_presenter::mock::MockBackend;
|
||||
use unlucky_presenter::router::Route;
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
|
||||
#[cfg(test)]
|
||||
mod appearance;
|
||||
#[cfg(test)]
|
||||
mod presenter;
|
||||
|
||||
use super::message::Message;
|
||||
use super::state::App;
|
||||
use super::{APP_TITLE, WINDOW_SIZE};
|
||||
use crate::cli::{Options, Screen};
|
||||
use crate::pages;
|
||||
use crate::shell::agent::RailState;
|
||||
use crate::shell::NavItem;
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
/// 不碰磁盘的 App（mock 后端 + 内存设置桥）。
|
||||
fn headless(options: Options, flavor: SchemeFlavor) -> App {
|
||||
App::with_presenter(
|
||||
options,
|
||||
FAMILIES,
|
||||
flavor,
|
||||
Box::new(MockBackend::new()),
|
||||
SettingsBridge::memory_only(),
|
||||
)
|
||||
}
|
||||
|
||||
fn screenshot_options() -> Options {
|
||||
Options {
|
||||
screenshot: Some(std::path::PathBuf::from("x.png")),
|
||||
..Options::default()
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn switching_flavor_rebuilds_styles_but_keeps_ui_state() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
app.state.navigate(Route::Logs);
|
||||
app.refresh_view();
|
||||
assert_eq!(app.ui().name(), "ull-m3-light");
|
||||
|
||||
app.set_flavor(SchemeFlavor::Dark);
|
||||
|
||||
assert_eq!(app.ui().name(), "ull-m3-dark", "切主题要换主题名");
|
||||
assert_eq!(app.state.route(), &Route::Logs, "切主题不许重置 UI 状态");
|
||||
assert_eq!(app.view.screen, pages::Screen::Logs, "视图模型跟着路由");
|
||||
assert!(app.options.screenshot.is_none(), "切主题不许改启动参数");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn window_size_is_the_acceptance_size() {
|
||||
assert_eq!((WINDOW_SIZE.width, WINDOW_SIZE.height), (1180.0, 760.0));
|
||||
assert_eq!(APP_TITLE, "Unlucky Launcher");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn screenshot_mode_never_waits_for_the_system_theme() {
|
||||
// 门禁依赖：CI 的 runtime-smoke 不带主题，xvfb 里也没有主题会话。
|
||||
let options = screenshot_options();
|
||||
assert!(!options.wants_system_theme(), "截图模式不许等系统主题");
|
||||
assert_eq!(options.capture_flavor(), Some(SchemeFlavor::Light));
|
||||
|
||||
let app = headless(options, SchemeFlavor::Light);
|
||||
assert!(app.has_screenshot() && app.ui().name() == "ull-m3-light");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn gallery_screen_builds_a_tree() {
|
||||
assert_eq!(Options::default().screen, Screen::Shell, "默认仍是产品骨架");
|
||||
let options = Options {
|
||||
screen: Screen::Gallery,
|
||||
..Options::default()
|
||||
};
|
||||
let app = headless(options, SchemeFlavor::Light);
|
||||
// 真实像素由 `--screen=gallery --screenshot` 出图 + `gallery::probe` 量
|
||||
let _ = app.view();
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn frames_are_only_requested_in_screenshot_mode() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
assert!(!app.wants_frames(), "普通运行不订阅帧，避免每帧重绘");
|
||||
|
||||
app.options.screenshot = Some(std::path::PathBuf::from("x.png"));
|
||||
assert!(
|
||||
app.wants_frames(),
|
||||
"截图模式必须订阅帧事件才能在第 3 帧出图"
|
||||
);
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------- P2-1 按需节拍
|
||||
|
||||
/// 空闲态**不要每帧节拍**（但要有 1 Hz 心跳）。
|
||||
///
|
||||
/// 意图与 r2 那条 `an_idle_app_asks_for_no_clock` 一致：空闲时不许按帧循环跑（那会以每秒几百帧
|
||||
/// 的速度重绘整窗），改成「低频心跳」。断言拆成两半：
|
||||
///
|
||||
/// 1. `needs_frames()` 为假 ⇒ **不订阅** `window::frames()`；
|
||||
/// 2. 空闲时钟的周期 = [`IDLE_TICK`] = 1 s，且心跳每拍推进的 tick 预算 = 30（= 1 s / 33 ms），
|
||||
/// 这样 `theme::config_poll_due`（30 拍）仍是「约 1 秒比对一次 mtime」。
|
||||
///
|
||||
/// 抓得住：有人把「无条件订阅帧」改回来（第 1 半红）；有人把心跳周期改快/改慢（第 2 半红）。
|
||||
/// 抓不住：真实窗口的重绘次数（那要 `ULL_TICK_TRACE=1` 跑一次交互模式看日志，见报告）。
|
||||
#[test]
|
||||
fn an_idle_app_uses_a_slow_heartbeat_instead_of_frames() {
|
||||
let app = headless(screenshot_options(), SchemeFlavor::Light);
|
||||
assert!(app.needs_frames(), "截图通道永远要帧（第 3 帧落盘）");
|
||||
|
||||
let mut idle = headless(Options::default(), SchemeFlavor::Light);
|
||||
let _ = idle.update(Message::Boot);
|
||||
assert!(
|
||||
idle.needs_frames(),
|
||||
"Boot 刚派发过 RefreshAll：3 秒观察窗内要节拍（等真 host 的首批事件）"
|
||||
);
|
||||
|
||||
// 观察窗过期、也没有忙碌实例 ⇒ 空闲态不订阅帧事件（改走 1 Hz 心跳）
|
||||
idle.watch_until = None;
|
||||
assert!(!idle.needs_frames(), "空闲交互态：不订阅帧事件（只有心跳）");
|
||||
|
||||
// 派发之后观察窗重新打开
|
||||
let _ = idle.update(Message::Page(pages::Message::Navigate(Route::Detail(
|
||||
"survival".to_string(),
|
||||
))));
|
||||
let _ = idle.update(Message::Page(pages::Message::Launch(
|
||||
"survival".to_string(),
|
||||
)));
|
||||
assert!(idle.needs_frames(), "派发后观察窗内要有节拍");
|
||||
|
||||
// 进入 Busy 之后由「忙碌实例」这个条件自己续订（不靠观察窗）
|
||||
idle.watch_until = None;
|
||||
assert!(
|
||||
idle.needs_frames(),
|
||||
"有 Busy 实例时即便观察窗过期也要继续 tick"
|
||||
);
|
||||
}
|
||||
|
||||
/// 心跳的**节奏**：1 Hz，且每拍折算 30 个 33 ms 单位 ⇒ `config_poll_due` ≈ 每秒一次。
|
||||
///
|
||||
/// 抓得住：心跳周期常量、以及 `advance()` 里「按流逝时间折算 ticks」这条记账（改回
|
||||
/// `ticks += 1` 会让空闲态的配置轮询变成 30 秒一次，这条就红）。
|
||||
/// 抓不住：`Task::perform` 那条自续链真的每秒触发一次（那是运行期 trace 的事，见报告）。
|
||||
#[test]
|
||||
fn the_idle_heartbeat_budgets_one_config_poll_per_second() {
|
||||
use unlucky_presenter::theme::config_poll_due;
|
||||
|
||||
assert_eq!(
|
||||
super::state::IDLE_TICK,
|
||||
std::time::Duration::from_secs(1),
|
||||
"空闲心跳周期必须是 1 s"
|
||||
);
|
||||
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
app.watch_until = None;
|
||||
|
||||
// 一次空闲心跳（1 s）之后：ticks 增加 30，且正好落在 config 轮询点上
|
||||
let before = app.ticks;
|
||||
app.advance(super::state::IDLE_TICK);
|
||||
assert_eq!(app.ticks - before, 30, "1 s 应折算 30 个 33 ms 拍");
|
||||
assert!(
|
||||
config_poll_due(app.ticks),
|
||||
"空闲心跳每拍都要落在 config 轮询点上（ticks={}）",
|
||||
app.ticks
|
||||
);
|
||||
}
|
||||
|
||||
/// 空闲态每拍**不再重建视图模型**（P2-1 的另一半：`refresh_view` 的 30 Hz × N 实例白克隆）。
|
||||
///
|
||||
/// 抓得住：把 `advance()` 里的 `if self.view_dirty` 去掉（改回无条件 `refresh_view()`）时，
|
||||
/// 这条断言里的 `refreshes` 会从「不增长」变成「每拍 +1」。
|
||||
/// 抓不住：「重建一次花了多少微秒」（没有基准测试；量级判断见报告）。
|
||||
#[test]
|
||||
fn idle_ticks_do_not_rebuild_the_view_model() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
|
||||
let before = app.refreshes;
|
||||
for _ in 0..100 {
|
||||
app.advance(super::state::TICK);
|
||||
}
|
||||
assert_eq!(
|
||||
app.refreshes,
|
||||
before,
|
||||
"空闲 100 拍：视图模型一次都不该重建（实际 +{}）",
|
||||
app.refreshes - before
|
||||
);
|
||||
|
||||
// 有事件进来时仍然要重建（否则页面不刷新）
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Logs)));
|
||||
assert!(app.refreshes > before, "导航之后必须重建一次");
|
||||
}
|
||||
/// 视图模型跟着窗口宽度走（交互模式下 600 / 840 两条断点靠 resize 事件生效）。
|
||||
///
|
||||
/// M104 起 `view.window_width` 装的是**中栗可用宽度**（窗口 − 右栗 − 拖拽缝），所以这里按三档
|
||||
/// 各钉一个**字面量**：48 的折叠条与 320 的面板各自的减法都得对。
|
||||
/// （断言里不调 `agent.content_width(..)`——那是同义反复，实现错一处它照样绿。）
|
||||
#[test]
|
||||
fn resizing_the_window_rebuilds_the_view_model() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
|
||||
// 出厂是 Collapsed(48) 档：中栗 = 窗口 − 48
|
||||
let _ = app.update(Message::Window(iced::window::Event::Resized(
|
||||
iced::Size::new(1180.0, 760.0),
|
||||
)));
|
||||
assert!(
|
||||
(app.view.window_width - 1132.0).abs() < f32::EPSILON,
|
||||
"1180 − 48（折叠条）= 1132，实际 {}",
|
||||
app.view.window_width
|
||||
);
|
||||
|
||||
let _ = app.update(Message::Window(iced::window::Event::Resized(
|
||||
iced::Size::new(700.0, 600.0),
|
||||
)));
|
||||
assert!(
|
||||
(app.view.window_width - 652.0).abs() < f32::EPSILON,
|
||||
"700 − 48（折叠条）= 652，实际 {}",
|
||||
app.view.window_width
|
||||
);
|
||||
|
||||
// Expanded(320) 档：中栗 = 窗口 − 320（面板）− 8（拖拽缝）= 852
|
||||
app.agent.expand();
|
||||
app.view_dirty = true;
|
||||
app.refresh_view();
|
||||
assert!(
|
||||
(app.view.window_width - 652.0).abs() < f32::EPSILON,
|
||||
"700 上展开档不成立（上限 700 − 88 − 472 − 8 = 132 < 280）⇒ 实际按折叠条 48 算： 700 − 48 = 652，实际 {}",
|
||||
app.view.window_width
|
||||
);
|
||||
let _ = app.update(Message::Window(iced::window::Event::Resized(
|
||||
iced::Size::new(1180.0, 760.0),
|
||||
)));
|
||||
assert!(
|
||||
(app.view.window_width - 852.0).abs() < f32::EPSILON,
|
||||
"1180 − 320 − 8 = 852，实际 {}",
|
||||
app.view.window_width
|
||||
);
|
||||
|
||||
// Detached 档：右栗不占宽，中栗 = 窗口 = 1180。
|
||||
// **必须走路由**（`Select(Ai)`）：r1 之后「档位 = Detached」与「路由 = Agent」是一条不变式，
|
||||
// 直接 `agent.detach()` 再手工 refresh 会被 `sync_agent_route` 立刻收回右栗（那正是要的语义）。
|
||||
let _ = app.update(Message::Select(NavItem::Ai));
|
||||
app.view_dirty = true;
|
||||
app.refresh_view();
|
||||
assert!(
|
||||
(app.view.window_width - 1180.0).abs() < f32::EPSILON,
|
||||
"拆出后右栗不占宽：1180 − 0 = 1180，实际 {}",
|
||||
app.view.window_width
|
||||
);
|
||||
// 页面照旧能构图（窄窗退化到单列，不 panic）
|
||||
let _ = app.view();
|
||||
}
|
||||
|
||||
/// **不变式（复审 r1 的 P2-1）**：`Route::Agent` ⟺ `RailState::Detached`。
|
||||
///
|
||||
/// 走的是**真实路由入口**（外壳导航第五项 `Assistant` → `Message::Select(NavItem::Ai)`），不是
|
||||
/// 直接调 `agent.detach()`：r1 复现的 bug 正是「导航进页面时档位没变」，只测 `detach()` 抓不到它。
|
||||
///
|
||||
/// 抓得住：①进独立页后档位 = Detached（页头才会是 `Dock back` 而不是 `Open assistant`/`Pop out`）；
|
||||
/// ②未读在进页时清零；③`Esc` 在独立页真的离开（不是只把档位改成折叠）；④从页上点别的导航，
|
||||
/// 会话收回右栗（档位不再停在 Detached）。
|
||||
/// 抓不住：按钮在像素上长什么样（那要出图，见 `13/14` 两张）。
|
||||
#[test]
|
||||
fn entering_the_agent_route_detaches_the_rail() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
assert_eq!(app.agent.rail, RailState::Collapsed, "出厂是折叠档");
|
||||
// M119：出厂没有样本会话，未读由 presenter 按真事件累加 ⇒ 出厂就是 0
|
||||
assert_eq!(app.agent_host.rail().unread, 0, "出厂 0 条未读");
|
||||
|
||||
// ① 外壳导航第五项（真实入口）
|
||||
let _ = app.update(Message::Select(NavItem::Ai));
|
||||
assert_eq!(app.state.route(), &Route::Agent);
|
||||
assert_eq!(
|
||||
app.agent.rail,
|
||||
RailState::Detached,
|
||||
"进了独立页，档位必须是 Detached——否则页头会画右栗才有的动作"
|
||||
);
|
||||
assert_eq!(app.agent_host.rail().unread, 0, "进独立页即读");
|
||||
|
||||
// ③ Esc 真的离开这一页
|
||||
let _ = app.update(Message::Agent(crate::shell::agent::Message::Escape));
|
||||
assert_ne!(app.state.route(), &Route::Agent, "独立页上 Esc 必须离开");
|
||||
assert_eq!(app.agent.rail, RailState::Expanded, "收回到右栗展开档");
|
||||
|
||||
// ④ 从独立页点别的导航：会话收回右栗（档位不能停在 Detached）
|
||||
let _ = app.update(Message::Select(NavItem::Ai));
|
||||
assert_eq!(app.agent.rail, RailState::Detached);
|
||||
let _ = app.update(Message::Select(NavItem::Instances));
|
||||
assert_eq!(app.state.route(), &Route::Instances);
|
||||
assert_eq!(
|
||||
app.agent.rail,
|
||||
RailState::Expanded,
|
||||
"离开独立页 ⇒ 会话收回右栗（否则页走了、栏还是 0 宽）"
|
||||
);
|
||||
}
|
||||
|
||||
/// 同一条不变式的另一个入口：页面层的 `Navigate(Route::Agent)`（右栗里的 `pages::Message` 路径）。
|
||||
#[test]
|
||||
fn the_page_navigation_entry_also_detaches() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
// 走真消息（不是直接改字段）：这样「展开即读」的 `agent_mark_read` 也会真的发生
|
||||
let _ = app.update(Message::Agent(crate::shell::agent::Message::Expand));
|
||||
assert_eq!(app.agent.rail, RailState::Expanded);
|
||||
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Agent)));
|
||||
assert_eq!(app.state.route(), &Route::Agent);
|
||||
assert_eq!(app.agent.rail, RailState::Detached);
|
||||
assert_eq!(app.agent_host.rail().unread, 0);
|
||||
|
||||
// 页面层回退（不是 Dock 消息）也要把档位收回来
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Instances)));
|
||||
assert_eq!(app.agent.rail, RailState::Expanded);
|
||||
}
|
||||
|
||||
/// 截图模式不读设置文件里的主题（D30 可复现：两台机器出同一张图）。
|
||||
#[test]
|
||||
fn screenshot_mode_ignores_the_settings_file_theme() {
|
||||
let mut app = headless(screenshot_options(), SchemeFlavor::Light);
|
||||
app.apply_config_theme();
|
||||
assert_eq!(app.ui().name(), "ull-m3-light", "截图模式的主题只认命令行");
|
||||
}
|
||||
|
||||
/// 主题优先级：`--theme` > 配置文件 `appearance.theme_mode` > 系统主题。
|
||||
///
|
||||
/// r2 之前 `Message::SystemTheme` 无条件 `set_flavor`，于是「配置文件写 dark、系统是浅色」会
|
||||
/// 出现 `light -> dark -> light` 的一次抖动、配置永远不生效（r3 做 P2-2 的配置热切实测时暴露
|
||||
/// 出来，一并修）。
|
||||
///
|
||||
/// 抓得住：系统主题不许盖掉显式配置/命令行给出的主题（三条分支各一条断言）。
|
||||
/// 抓不住：真实桌面切换系统主题时的事件时序（只有消息级验证）。
|
||||
#[test]
|
||||
fn the_system_theme_never_overrides_an_explicit_one() {
|
||||
use unlucky_presenter::prefs::ThemeMode;
|
||||
|
||||
// ① auto（内存桥默认）：系统主题说了算
|
||||
let mut auto = headless(Options::default(), SchemeFlavor::Light);
|
||||
assert_eq!(auto.theme_mode, ThemeMode::Auto);
|
||||
let _ = auto.update(Message::SystemTheme(iced::theme::Mode::Dark));
|
||||
assert_eq!(auto.ui().name(), "ull-m3-dark", "auto 模式要跟随系统");
|
||||
|
||||
// ② 配置文件显式 dark：系统给浅色也不许改
|
||||
let mut pinned = headless(Options::default(), SchemeFlavor::Dark);
|
||||
pinned.theme_mode = ThemeMode::Dark;
|
||||
let _ = pinned.update(Message::SystemTheme(iced::theme::Mode::Light));
|
||||
assert_eq!(
|
||||
pinned.ui().name(),
|
||||
"ull-m3-dark",
|
||||
"配置文件说 dark，系统说 light：不许改"
|
||||
);
|
||||
|
||||
// ③ 命令行 `--theme` 优先级最高
|
||||
let mut explicit = headless(
|
||||
Options {
|
||||
theme: Some(SchemeFlavor::Dark),
|
||||
..Options::default()
|
||||
},
|
||||
SchemeFlavor::Dark,
|
||||
);
|
||||
let _ = explicit.update(Message::SystemTheme(iced::theme::Mode::Light));
|
||||
assert_eq!(
|
||||
explicit.ui().name(),
|
||||
"ull-m3-dark",
|
||||
"--theme 优先级最高，系统主题不许盖"
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,331 @@
|
||||
//! 外观接线的单测：**配置 → 状态 → 下发字节 / 像素 / 落盘**。
|
||||
//!
|
||||
//! 每条都按本 mission 的验收纪律写「抓得住 / 抓不住」。真机才有的东西（`WS_EX_LAYERED` 是否补上、
|
||||
//! `LWA_ALPHA` 的观感）不在这里假装——那是 `[appearance]` 日志与报告里「没验的部分」的事。
|
||||
|
||||
use std::path::PathBuf;
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_presenter::mock::MockBackend;
|
||||
use unlucky_presenter::prefs::{BgFill, PaletteSource};
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
|
||||
use crate::cli::{Backend, Options};
|
||||
use crate::pages::appearance::{self, Change, State};
|
||||
use crate::pages::{self, Screen};
|
||||
|
||||
use super::{headless, FAMILIES};
|
||||
|
||||
use super::super::state::App;
|
||||
|
||||
/// 一个把配置写在临时文件里的 App（测「读回 / 写回」必须真的过文件）。
|
||||
fn with_config(json: &str, backend: Backend, label: &str) -> (App, PathBuf) {
|
||||
let dir = std::env::temp_dir().join(format!(
|
||||
"ull-appear-{label}-{}-{}",
|
||||
std::process::id(),
|
||||
line!()
|
||||
));
|
||||
std::fs::create_dir_all(dir.join("config")).expect("临时目录");
|
||||
let path = dir.join("config/launcher.json");
|
||||
std::fs::write(&path, json).expect("写配置文件");
|
||||
|
||||
let app = App::with_presenter(
|
||||
Options {
|
||||
backend,
|
||||
..Options::default()
|
||||
},
|
||||
FAMILIES,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(MockBackend::new()),
|
||||
SettingsBridge::with_path(&path),
|
||||
);
|
||||
(app, dir)
|
||||
}
|
||||
|
||||
fn cleanup(dir: &PathBuf) {
|
||||
std::fs::remove_dir_all(dir).ok();
|
||||
}
|
||||
|
||||
/// 抓得住：配置里写 `window_opacity=0.8` → 启动读回 0.8 → 下发字节 205（钳位链的入口那一段）。
|
||||
/// 抓不住：Win32 是否真的收下 204（`transparency` 的单测与本机日志各自举证）。
|
||||
#[test]
|
||||
fn the_configured_window_alpha_is_read_back_and_turned_into_a_byte() {
|
||||
let (app, dir) = with_config(
|
||||
r#"{"appearance":{"window_opacity":0.8,"palette_source":"preset"}}"#,
|
||||
Backend::Cpu,
|
||||
"read",
|
||||
);
|
||||
|
||||
assert_eq!(app.appearance.window_opacity, 0.8);
|
||||
assert_eq!(
|
||||
app.appearance.window_alpha_byte(),
|
||||
Some(205),
|
||||
"f32 0.8 → f64 略大于 0.8 → ceil 205（不向下取整）"
|
||||
);
|
||||
// CPU 档：窗口 α 允许，面板 α 强制 1.0。
|
||||
assert_eq!(app.appearance.effective_panel_alpha(), 1.0);
|
||||
assert!(app.appearance.panel_is_forced());
|
||||
cleanup(&dir);
|
||||
}
|
||||
|
||||
/// 抓得住：①面板 α 滑到 0.8 → 状态是 0.8、生效值 GPU 档也是 0.8；
|
||||
/// ②CPU 档下滑到 0.5 → 生效值仍是 1.0，而**请求值**仍是 0.5（界面上的「requested → forced」靠这条）。
|
||||
/// 抓不住：这层半透明在屏幕上到底多透（RDP 上不可信，见报告）。
|
||||
#[test]
|
||||
fn panel_alpha_is_independent_of_the_window_alpha_and_forced_on_cpu() {
|
||||
let mut gpu = headless(Options::default(), SchemeFlavor::Light);
|
||||
gpu.appearance.apply(Change::PanelAlpha(0.8));
|
||||
assert_eq!(gpu.appearance.panel_alpha, 0.8);
|
||||
assert_eq!(gpu.appearance.effective_panel_alpha(), 0.8);
|
||||
assert_eq!(gpu.appearance.window_opacity, 1.0, "面板 α 不许带动整窗 α");
|
||||
|
||||
let mut cpu = headless(
|
||||
Options {
|
||||
backend: Backend::Cpu,
|
||||
..Options::default()
|
||||
},
|
||||
SchemeFlavor::Light,
|
||||
);
|
||||
assert!(
|
||||
!cpu.appearance.apply(Change::PanelAlpha(0.5)),
|
||||
"只有整窗 α 需要立刻下发（面板 α 只重绘）"
|
||||
);
|
||||
assert_eq!(cpu.appearance.panel_alpha, 0.5, "请求值保留");
|
||||
assert_eq!(
|
||||
cpu.appearance.effective_panel_alpha(),
|
||||
1.0,
|
||||
"CPU 档强制 1.0"
|
||||
);
|
||||
assert_eq!(cpu.appearance.window_alpha_byte(), None, "整窗 α 仍是 1.0");
|
||||
}
|
||||
|
||||
/// 抓得住：一次滑块改动 → 落盘 → **新开一个 bridge** 能读回（= 重启后还在）。
|
||||
/// 抓不住：真 host 是否也写了同一份文件（`AppCommand::SetSetting` 走的是同一份 schema）。
|
||||
#[test]
|
||||
fn a_panel_alpha_change_is_written_back_to_the_config_file() {
|
||||
let (mut app, dir) = with_config("{}", Backend::Gpu, "write");
|
||||
app.on_appearance(Change::PanelAlpha(0.8));
|
||||
app.on_appearance(Change::BgFill(BgFill::Tile));
|
||||
app.on_appearance(Change::BgDim(0.5));
|
||||
|
||||
let path = dir.join("config/launcher.json");
|
||||
let reopened = SettingsBridge::with_path(&path).load().0;
|
||||
assert_eq!(reopened.panel_alpha, 0.8);
|
||||
assert_eq!(reopened.bg_fill, BgFill::Tile);
|
||||
assert!((reopened.bg_dim - 0.5).abs() < 1e-6);
|
||||
assert_eq!(
|
||||
app.appearance_prefs.panel_alpha, 0.8,
|
||||
"内存里的「已落盘快照」也要跟上，否则下一次写回会拿旧基底覆盖"
|
||||
);
|
||||
cleanup(&dir);
|
||||
}
|
||||
|
||||
/// 抓得住：路径读不出来时 ①不 panic ②`background_active()` 为假（静默回落）
|
||||
/// ③诊断里有一句人话（不是空串）④配色回落到色卡档（不换 scheme）。
|
||||
/// 抓不住：这张图在别的机器上路径存在时会怎样（那是成功路径，另一条测试管）。
|
||||
#[test]
|
||||
fn a_broken_background_path_falls_back_silently_but_says_why() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
app.appearance
|
||||
.apply(Change::BgImage("D:/definitely/not/here.png".to_owned()));
|
||||
|
||||
assert!(!app.appearance.background_active());
|
||||
assert!(app.appearance.image().is_none(), "解码失败 ⇒ 没有可用图");
|
||||
assert_eq!(app.appearance.diagnostics().len(), 1, "恰好一条诊断");
|
||||
assert!(
|
||||
app.appearance.diagnostics()[0].contains("could not be read"),
|
||||
"诊断要是人话：{:?}",
|
||||
app.appearance.diagnostics()
|
||||
);
|
||||
assert_eq!(app.appearance.palette_level(), "preset", "回落色卡");
|
||||
assert!(
|
||||
app.appearance.derived_scheme().is_none(),
|
||||
"色卡档不换 scheme"
|
||||
);
|
||||
}
|
||||
|
||||
/// 抓得住：真 PNG → 背景真的生效（解出原图尺寸、路径留给渲染器、配色走「背景图取色」这一级）。
|
||||
/// 抓不住：渲染出来的像素（由截图举证），以及三种填充的覆盖范围（由 `background::tiles` 的
|
||||
/// 「覆盖 ≥ 视口」断言守）。
|
||||
#[test]
|
||||
fn a_decodable_png_makes_the_background_and_the_palette_active() {
|
||||
let dir = std::env::temp_dir().join(format!("ull-appear-png-{}", std::process::id()));
|
||||
std::fs::create_dir_all(&dir).expect("临时目录");
|
||||
let path = dir.join("bg.png");
|
||||
let image = image::RgbImage::from_fn(64, 32, |x, _y| {
|
||||
if x < 32 {
|
||||
image::Rgb([200, 30, 30])
|
||||
} else {
|
||||
image::Rgb([20, 60, 200])
|
||||
}
|
||||
});
|
||||
image.save(&path).expect("写 png");
|
||||
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
app.appearance
|
||||
.apply(Change::PaletteSource(PaletteSource::BackgroundImage));
|
||||
app.appearance
|
||||
.apply(Change::BgImage(path.to_string_lossy().to_string()));
|
||||
app.rebuild_ui();
|
||||
|
||||
assert!(app.appearance.background_active());
|
||||
assert!(app.appearance.image().is_some(), "解码成功 ⇒ 有可用图");
|
||||
assert!(
|
||||
!app.appearance.bg_path.trim().is_empty(),
|
||||
"渲染器按路径解码（见 picture::image_handle）"
|
||||
);
|
||||
assert_eq!(app.appearance.diagnostics().len(), 0, "成功时没有诊断");
|
||||
assert_eq!(app.appearance.palette_level(), "background-image");
|
||||
assert!(
|
||||
app.appearance.derived_scheme().is_some(),
|
||||
"取色成功后 Ui 要换成解析出的方案"
|
||||
);
|
||||
// 换 scheme 之后主题名仍是同一个（深浅没变），但 primary 必须与 baseline 不同。
|
||||
assert_eq!(app.ui().name(), "ull-m3-light");
|
||||
let baseline = crate::theme::Ui::new(SchemeFlavor::Light, FAMILIES);
|
||||
assert_ne!(
|
||||
app.ui().color(unlucky_design::color::Role::Primary),
|
||||
baseline.color(unlucky_design::color::Role::Primary)
|
||||
);
|
||||
std::fs::remove_dir_all(&dir).ok();
|
||||
}
|
||||
|
||||
/// 抓得住：设置页在有外观状态时能真的构图（真控件树，含文本框/滑块/互斥按钮），并且
|
||||
/// 「外观」分组的下标与 `appearance::APPEARANCE_GROUP` 一致（点左列能切过去）。
|
||||
/// 抓不住：这些控件点下去之后的交互（`Message` 的落点由 `on_appearance` 的其它测试管）。
|
||||
#[test]
|
||||
fn the_settings_page_renders_the_real_appearance_group() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
app.state
|
||||
.navigate(unlucky_presenter::router::Route::Settings);
|
||||
app.refresh_view();
|
||||
assert_eq!(app.view.screen, Screen::Settings);
|
||||
assert_eq!(app.appearance.selected_group, appearance::APPEARANCE_GROUP);
|
||||
|
||||
let _tree = pages::page_with_appearance(&app.ui, &app.view, &app.appearance);
|
||||
drop(_tree);
|
||||
|
||||
// 切分组：只改视图状态，不落盘（`Change::SelectGroup` 的 key() == None）。
|
||||
app.appearance.apply(Change::SelectGroup(0));
|
||||
assert_eq!(app.appearance.selected_group, 0);
|
||||
let _tree = pages::page_with_appearance(&app.ui, &app.view, &app.appearance);
|
||||
}
|
||||
|
||||
/// **P2-2 的守门（复审 r1）**：面板 α 只作用到允许半透明的层。
|
||||
///
|
||||
/// 抓得住：`Ui::layer(Canvas)` 在 α=0.55 时仍是不透明（标题栏/导航轨/页头带都取 Canvas，
|
||||
/// 它们一旦透底，三个窗口键与导航文字就压在背景照片上）；`Card` / `Overlay` 必须真的吃到 α。
|
||||
/// 抓不住：真实合成后的观感（那由截图看）。
|
||||
#[test]
|
||||
fn the_canvas_layer_stays_opaque_while_panels_take_the_alpha() {
|
||||
use unlucky_design::elevation::MaterialLayer;
|
||||
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
app.appearance.apply(Change::PanelAlpha(0.55));
|
||||
app.rebuild_ui();
|
||||
|
||||
let ui = app.ui();
|
||||
assert_eq!(ui.panel_alpha(), 0.55, "生效值进了 Ui");
|
||||
assert_eq!(
|
||||
ui.layer(MaterialLayer::Canvas).a,
|
||||
1.0,
|
||||
"窗口底（标题栏/导航轨/页头带）永远不透明——令牌的不变量"
|
||||
);
|
||||
for layer in [MaterialLayer::Card, MaterialLayer::Overlay] {
|
||||
assert!(
|
||||
(ui.layer(layer).a - 0.55).abs() < 1e-6,
|
||||
"{layer:?} 必须吃面板 α（实际 {}）",
|
||||
ui.layer(layer).a
|
||||
);
|
||||
}
|
||||
|
||||
// CPU 档：α 被强制 1.0 ⇒ 连卡片也不透明。
|
||||
let mut cpu = headless(
|
||||
Options {
|
||||
backend: Backend::Cpu,
|
||||
..Options::default()
|
||||
},
|
||||
SchemeFlavor::Light,
|
||||
);
|
||||
cpu.appearance.apply(Change::PanelAlpha(0.55));
|
||||
cpu.rebuild_ui();
|
||||
assert_eq!(cpu.ui().layer(MaterialLayer::Card).a, 1.0, "CPU 档强制 1.0");
|
||||
}
|
||||
|
||||
/// 抓得住：**把滑块从头拖到尾**（0.00 → 1.00 的 11 个档）时，状态里的整窗 α 与下发字节逐档单调
|
||||
/// 上升、且最低一档就是下限字节 21（= 0.0824 ≥ 0.08）、最后一档不透明（不给字节）。
|
||||
/// 这就是「拖动 → 实际 α」的链条在数值上的等价物；真机拖动的那一次由二进制日志举证。
|
||||
/// 抓不住：拖动的手感与真实观感（RDP 上不可信）。
|
||||
#[test]
|
||||
fn a_slider_sweep_moves_the_alpha_and_the_byte_monotonically() {
|
||||
let mut app = headless(Options::default(), SchemeFlavor::Light);
|
||||
let mut bytes = Vec::new();
|
||||
for step in 0..=10 {
|
||||
let fraction = step as f32 / 10.0;
|
||||
let alpha = crate::pages::appearance::alpha::window_alpha_from_fraction(fraction);
|
||||
app.appearance.apply(Change::WindowOpacity(alpha));
|
||||
let byte = app.appearance.window_alpha_byte();
|
||||
bytes.push(byte);
|
||||
// 每一档都要能打出一行（数值而不是观感）。
|
||||
assert!(app.appearance.log_line("sweep").contains("window_alpha="));
|
||||
}
|
||||
|
||||
assert_eq!(bytes[0], Some(21), "0% 一档 = 下限 0.08 → 21");
|
||||
assert_eq!(bytes[10], None, "100% 一档 = 不透明 → 不下发");
|
||||
let sent: Vec<u8> = bytes.iter().flatten().copied().collect();
|
||||
assert!(
|
||||
sent.windows(2).all(|pair| pair[0] <= pair[1]),
|
||||
"字节必须单调不减：{sent:?}"
|
||||
);
|
||||
assert_eq!(sent.len(), 10, "除最后一档（不透明）之外每档都有字节");
|
||||
assert!(
|
||||
sent.iter().all(|byte| *byte >= 21),
|
||||
"任何一档都不许低于下限字节：{sent:?}"
|
||||
);
|
||||
}
|
||||
|
||||
/// 抓得住：日志行里有请求值、生效值与下发字节（RDP 上唯一可信的证据形态）。
|
||||
/// 抓不住：这行日志是否真的被写进了 stderr（本测试只钉格式，真机日志由跑起来的二进制举证）。
|
||||
#[test]
|
||||
fn the_log_line_carries_requests_effective_values_and_the_byte() {
|
||||
let mut cpu = headless(
|
||||
Options {
|
||||
backend: Backend::Cpu,
|
||||
..Options::default()
|
||||
},
|
||||
SchemeFlavor::Light,
|
||||
);
|
||||
cpu.appearance.apply(Change::WindowOpacity(0.5));
|
||||
cpu.appearance.apply(Change::PanelAlpha(0.4));
|
||||
|
||||
let line = cpu.appearance.log_line("change");
|
||||
assert!(line.starts_with("[appearance] change "), "{line}");
|
||||
assert!(line.contains("window_alpha=0.500"), "{line}");
|
||||
assert!(line.contains("panel_alpha=1.000"), "CPU 档生效值：{line}");
|
||||
assert!(line.contains("(requested 0.400)"), "请求值也要在：{line}");
|
||||
assert!(
|
||||
line.contains("byte=128"),
|
||||
"0.5×255=127.5 → 向上取整 128：{line}"
|
||||
);
|
||||
|
||||
// 不透明时不给字节（而不是给 255）。
|
||||
let opaque = headless(Options::default(), SchemeFlavor::Light);
|
||||
assert!(opaque.appearance.log_line("boot").contains("byte=none"));
|
||||
}
|
||||
|
||||
/// 抓得住：`State::new` 与 `apply_env` 之外，`State` 的构造不会偷偷读环境（测试之间不串味）。
|
||||
/// 抓不住：`ULL_APPEARANCE_*` 在真机上的解析（`apply_env` 由截图矩阵覆盖，见报告）。
|
||||
#[test]
|
||||
fn a_fresh_state_is_the_factory_appearance() {
|
||||
let state = State::new(
|
||||
&unlucky_presenter::prefs::AppearancePrefs::factory(),
|
||||
&unlucky_presenter::prefs::AppearanceBase::factory(),
|
||||
Backend::Gpu,
|
||||
SchemeFlavor::Light,
|
||||
);
|
||||
assert_eq!(state.window_opacity, 1.0);
|
||||
assert_eq!(state.effective_panel_alpha(), 1.0);
|
||||
assert!(!state.background_active());
|
||||
assert!(state.diagnostics().is_empty());
|
||||
assert!(state.image().is_none());
|
||||
}
|
||||
@@ -0,0 +1,246 @@
|
||||
//! presenter 闭环与节拍的断言（M90 r2 从 `app/tests.rs` 外置：那边 416 行会被 file-size 判红）。
|
||||
//!
|
||||
//! 这里的每条都依赖一个可注入的 `Backend`：
|
||||
//! - `MockBackend`（presenter 自带）验「命令 → 事件 → 状态」的闭环；
|
||||
//! - `RecorderBackend`（本文件，只记账不回事件）验「UI 侧不做乐观回显」——用 MockBackend 验这条
|
||||
//! 会得到**假绿**，因为它是同步发事件的，本地回显与事件回流终态相同（P3-2 的教训）。
|
||||
|
||||
use std::cell::RefCell;
|
||||
use std::rc::Rc;
|
||||
|
||||
use unlucky_i18n::Key;
|
||||
use unlucky_presenter::dto::{AppCommand, AppEvent, Backend, CoreEvent};
|
||||
use unlucky_presenter::mock_data::mock_instances;
|
||||
|
||||
use super::*;
|
||||
|
||||
// --------------------------------------------------------------- presenter 闭环
|
||||
|
||||
/// **首屏快照在 Boot 就到位**（截图在第 3 帧落盘，等 30 fps 的 tick 会拍进空页面）。
|
||||
#[test]
|
||||
fn boot_drains_the_first_snapshot_before_the_first_frame() {
|
||||
let mut app = headless(screenshot_options(), SchemeFlavor::Light);
|
||||
assert!(app.view.instances.rows.is_empty(), "还没 Boot");
|
||||
|
||||
let _ = app.update(Message::Boot);
|
||||
|
||||
assert_eq!(
|
||||
app.view.instances.rows.len(),
|
||||
4,
|
||||
"mock 的四个实例已进视图模型"
|
||||
);
|
||||
assert_eq!(app.view.screen, pages::Screen::Instances);
|
||||
}
|
||||
|
||||
/// 首屏自动选中第一行（右栏不该开局空白），且**只做一次**：返回列表后再刷新不弹回详情。
|
||||
#[test]
|
||||
fn the_first_snapshot_selects_the_first_instance_once() {
|
||||
let mut app = headless(screenshot_options(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
assert_eq!(
|
||||
app.state.route(),
|
||||
&Route::Detail("survival".to_string()),
|
||||
"首屏快照到位后自动选中第一行"
|
||||
);
|
||||
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Instances)));
|
||||
assert_eq!(app.state.route(), &Route::Instances);
|
||||
|
||||
// 再推进一拍（会 drain_events + auto_select）：不该把他弹回详情页
|
||||
app.advance(super::super::state::TICK);
|
||||
assert_eq!(app.state.route(), &Route::Instances, "自动选中只做一次");
|
||||
}
|
||||
|
||||
/// 只记账、**不回任何事件**的后端（P3-2）。
|
||||
///
|
||||
/// 为什么需要它：`MockBackend::dispatch` 是**同步**发事件的，于是「UI 本地回显」与「事件回流」
|
||||
/// 在 dispatch 之后终态相同——拿 MockBackend 测「不乐观回显」是假绿（r1 就是栽在这条上）。
|
||||
/// 这个后端把两件事分开：命令只进 `dispatched`，`drain_events` 永远空 ⇒ 状态**不可能**变；
|
||||
/// 一旦有人在 `update` 里偷偷改本地状态，下面那条断言立刻红（实测见报告「P3-2 取证」）。
|
||||
#[derive(Debug, Default)]
|
||||
struct RecorderBackend {
|
||||
dispatched: Rc<RefCell<Vec<AppCommand>>>,
|
||||
seeded: Vec<AppEvent>,
|
||||
}
|
||||
|
||||
impl Backend for RecorderBackend {
|
||||
fn drain_events(&mut self) -> Vec<AppEvent> {
|
||||
std::mem::take(&mut self.seeded)
|
||||
}
|
||||
|
||||
fn dispatch(&mut self, command: AppCommand) {
|
||||
self.dispatched.borrow_mut().push(command);
|
||||
}
|
||||
}
|
||||
|
||||
/// 用 recorder 后端造一个 App（首屏快照靠 `seeded` 一次性喂进去）。
|
||||
fn recording(options: Options, flavor: SchemeFlavor) -> (App, Rc<RefCell<Vec<AppCommand>>>) {
|
||||
let recorded = Rc::new(RefCell::new(Vec::new()));
|
||||
// 注意：`InstancesChanged` 是**整体替换**，所以四条必须合成一条事件；
|
||||
// 分开发的话最后只会剩一个实例（r1 在这条上踩过）。
|
||||
let backend = RecorderBackend {
|
||||
dispatched: Rc::clone(&recorded),
|
||||
seeded: vec![AppEvent::Core(
|
||||
CoreEvent::InstancesChanged(mock_instances()),
|
||||
)],
|
||||
};
|
||||
let app = App::with_presenter(
|
||||
options,
|
||||
FAMILIES,
|
||||
flavor,
|
||||
Box::new(backend),
|
||||
SettingsBridge::memory_only(),
|
||||
);
|
||||
(app, recorded)
|
||||
}
|
||||
|
||||
/// **P3-2：不做乐观回显**——命令必须真的出 UI 层，而状态在后端回事件之前**一个字节都不许变**。
|
||||
///
|
||||
/// 抓得住：`update` 里出现「本地先改状态」的写法（recorder 永远不回事件，本地一改这里就红）。
|
||||
/// 抓不住：「命令有没有真的到达 host」——那由 `MockBackend` 的闭环测试与真机验证负责。
|
||||
#[test]
|
||||
fn launching_only_dispatches_and_never_echoes_locally() {
|
||||
let mut options = screenshot_options();
|
||||
options.screenshot = None; // recorder 不依赖截图通道
|
||||
let (mut app, recorded) = recording(options, SchemeFlavor::Light);
|
||||
|
||||
let _ = app.update(Message::Boot);
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Detail(
|
||||
"survival".to_string(),
|
||||
))));
|
||||
|
||||
// Boot 自己发过一条 RefreshAll，先把账本清掉，下面只看「点 Play」这一个动作
|
||||
recorded.borrow_mut().clear();
|
||||
|
||||
let before = app.view.instances.detail.clone().expect("有选中项");
|
||||
assert!(before.can_launch && !before.can_stop && before.status.is_none());
|
||||
|
||||
let _ = app.update(Message::Page(pages::Message::Launch(
|
||||
"survival".to_string(),
|
||||
)));
|
||||
|
||||
// ① 命令真的出 UI 层了
|
||||
assert_eq!(
|
||||
*recorded.borrow(),
|
||||
vec![AppCommand::LaunchInstance("survival".to_string())],
|
||||
"Launch 必须翻成一条 AppCommand::LaunchInstance 并交给 Backend::dispatch"
|
||||
);
|
||||
|
||||
// ② 后端一条事件都没回 ⇒ 视图模型必须**原样不动**（任何本地回显都会让这条红）
|
||||
let after = app.view.instances.detail.clone().expect("有选中项");
|
||||
assert_eq!(
|
||||
after, before,
|
||||
"没有事件回流时页面不许自己变（乐观回显）；现在的差异是 {after:?}"
|
||||
);
|
||||
assert!(!after.can_stop, "不许因为点了 Play 就本地切成「可停止」");
|
||||
assert!(after.status.is_none(), "不许本地造一条进度文案");
|
||||
}
|
||||
|
||||
/// **点 Play → 命令真的派发出去 → 事件回流 → 页面真的变**（真后端的闭环）。
|
||||
#[test]
|
||||
fn launching_goes_through_the_backend_and_comes_back_as_events() {
|
||||
let mut app = headless(screenshot_options(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Detail(
|
||||
"survival".to_string(),
|
||||
))));
|
||||
|
||||
let detail = app.view.instances.detail.as_ref().expect("有选中项");
|
||||
assert!(
|
||||
detail.can_launch && !detail.can_stop,
|
||||
"空闲：可启动不可停止"
|
||||
);
|
||||
|
||||
let _ = app.update(Message::Page(pages::Message::Launch(
|
||||
"survival".to_string(),
|
||||
)));
|
||||
|
||||
let detail = app.view.instances.detail.as_ref().expect("有选中项");
|
||||
assert!(
|
||||
!detail.can_launch && detail.can_stop,
|
||||
"派发 LaunchInstance 后后端发回了 Busy 事件：按钮组合必须已经翻转"
|
||||
);
|
||||
// 阶段名跟界面语言走（M120）：断言对着**当前生效语言**的目录算，别在中文机器上钉死英文
|
||||
let stage = app.lang().catalog().text(Key::InstancesStageDownload);
|
||||
assert_eq!(
|
||||
detail.status.as_deref(),
|
||||
Some(format!("{stage} · 0%").as_str()),
|
||||
"状态行来自事件里的进度，不是本地假造"
|
||||
);
|
||||
}
|
||||
|
||||
/// 时间推进真的把状态往前推（后端的脚本按 tick 的累计时长走）。
|
||||
#[test]
|
||||
fn ticks_advance_the_backend_script() {
|
||||
let mut app = headless(screenshot_options(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Detail(
|
||||
"survival".to_string(),
|
||||
))));
|
||||
let _ = app.update(Message::Page(pages::Message::Launch(
|
||||
"survival".to_string(),
|
||||
)));
|
||||
|
||||
// 33 ms × 50 ≈ 1.65 s：mock 的脚本在 1.5 s 从 Download 切到 Verify
|
||||
for _ in 0..50 {
|
||||
app.advance(super::super::state::TICK);
|
||||
}
|
||||
|
||||
let detail = app.view.instances.detail.as_ref().expect("有选中项");
|
||||
let status = detail.status.as_deref().unwrap_or_default();
|
||||
let catalog = app.lang().catalog();
|
||||
let (verify, launch) = (
|
||||
catalog.text(Key::InstancesStageVerify),
|
||||
catalog.text(Key::InstancesStageLaunch),
|
||||
);
|
||||
assert!(
|
||||
status.starts_with(verify) || status.starts_with(launch),
|
||||
"50 拍之后应已过下载阶段，实际 {status:?}"
|
||||
);
|
||||
}
|
||||
|
||||
/// 停止也是真命令：`StopInstance` 让 mock 直接回一条 Idle 事件。
|
||||
#[test]
|
||||
fn stopping_returns_to_idle_through_an_event() {
|
||||
let mut app = headless(screenshot_options(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Detail(
|
||||
"survival".to_string(),
|
||||
))));
|
||||
let _ = app.update(Message::Page(pages::Message::Launch(
|
||||
"survival".to_string(),
|
||||
)));
|
||||
let _ = app.update(Message::Page(pages::Message::Stop("survival".to_string())));
|
||||
|
||||
let detail = app.view.instances.detail.as_ref().expect("有选中项");
|
||||
assert!(detail.can_launch && !detail.can_stop, "停下来回到空闲");
|
||||
assert!(detail.status.is_none(), "空闲没有状态行");
|
||||
}
|
||||
|
||||
/// 导航：一级页替换、详情压栈、返回出栈——页面换的是 `Route`，不是页面自己的选中项。
|
||||
#[test]
|
||||
fn navigation_follows_the_presenter_router() {
|
||||
let mut app = headless(screenshot_options(), SchemeFlavor::Light);
|
||||
let _ = app.update(Message::Boot);
|
||||
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Detail(
|
||||
"survival".to_string(),
|
||||
))));
|
||||
assert_eq!(app.view.screen, pages::Screen::Instances, "详情仍是实例页");
|
||||
assert!(app.state.router.can_go_back());
|
||||
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Settings)));
|
||||
assert_eq!(app.view.screen, pages::Screen::Settings);
|
||||
assert_eq!(
|
||||
app.view.active,
|
||||
Some(pages::Screen::Settings.nav()),
|
||||
"导航轨高亮跟着路由走"
|
||||
);
|
||||
assert!(
|
||||
!app.state.router.can_go_back(),
|
||||
"一级页互相替换，不进栈（presenter::router 的语义）"
|
||||
);
|
||||
|
||||
let _ = app.update(Message::Page(pages::Message::Navigate(Route::Instances)));
|
||||
assert_eq!(app.view.screen, pages::Screen::Instances);
|
||||
}
|
||||
@@ -0,0 +1,288 @@
|
||||
//! `update`：消息分支的**唯一**落点（含「用户动作 → 后端指令」的派发与事件回流）。
|
||||
//!
|
||||
//! ## 数据流的三个入口（presenter crate 文档 §2）
|
||||
//!
|
||||
//! ```text
|
||||
//! 用户动作 ──dispatch(AppCommand)──► backend ──► drain_events() ──► AppState::apply ──► 视图模型
|
||||
//! ▲ ▲
|
||||
//! └── pages::Message（导航/启动/停止）──────────────────┘ 忙碌 33 ms / 空闲 1 Hz
|
||||
//! ```
|
||||
//!
|
||||
//! 三条纪律：
|
||||
//!
|
||||
//! 1. **不做乐观回显**：点了「Play」不改本地状态，等 `InstanceRuntimeChanged` 事件回来才变
|
||||
//! （否则事件与本地状态打架时，磁贴与进度条会各说一套）；
|
||||
//! 2. **状态只有一个写入口**：`AppState::apply`（事件）与 `AppState::navigate`（路由）；
|
||||
//! 3. **只在状态变了才重建视图模型**：`refresh_view()` 是快照 → 页面的唯一转换点，
|
||||
//! 由 `view_dirty` 门控（M90 r2/P2-1 起；此前是每拍无条件重建）。
|
||||
//!
|
||||
//! ## 两个时钟（M90 r3 / P2-2）
|
||||
//!
|
||||
//! | 场景 | 时钟 | 周期 | 谁触发 |
|
||||
//! |---|---|---|---|
|
||||
//! | 截图 / 有 Busy-Running 实例 / 有 toast / 派发后 3 s 观察窗 | `window::frames()` + 闸门 | 33 ms | [`App::needs_frames`] |
|
||||
//! | 其余（空闲） | `Heartbeat` 自续链 | 1 s | [`App::heartbeat`] |
|
||||
//!
|
||||
//! 两条时钟不会同时干活：心跳在 `needs_frames()` 为真时**只续排、不推进**，忙碌结束自动接回。
|
||||
|
||||
use std::time::Instant;
|
||||
|
||||
use iced::{window, Task};
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_presenter::dto::AppCommand;
|
||||
use unlucky_presenter::prefs::ThemeMode;
|
||||
use unlucky_presenter::router::Route;
|
||||
|
||||
use crate::pages;
|
||||
use crate::renderer::Kind;
|
||||
|
||||
use super::message::{route_of, Message};
|
||||
use super::state::{App, IDLE_TICK, TICK, WATCH_WINDOW};
|
||||
use super::CAPTURE_AT_FRAME;
|
||||
|
||||
mod account;
|
||||
mod agent;
|
||||
mod appearance;
|
||||
mod boot_env;
|
||||
mod clock;
|
||||
mod content;
|
||||
mod download;
|
||||
mod page_messages;
|
||||
mod settings;
|
||||
|
||||
impl App {
|
||||
/// 一条消息进来，改状态并返回后续任务。
|
||||
pub(super) fn update(&mut self, message: Message) -> Task<Message> {
|
||||
match message {
|
||||
Message::Boot => self.on_boot(),
|
||||
Message::WindowReady(id) => {
|
||||
self.window = id;
|
||||
// M93：整窗 α 要 Win32 句柄，而 iced 只给 `window::Id`。`window::run` 是唯一能把
|
||||
// `&dyn Window`（实现了 `HasWindowHandle`）拿出来的入口。
|
||||
match id {
|
||||
Some(id) => {
|
||||
window::run(id, super::window_alpha::probe_hwnd).map(Message::WindowHandle)
|
||||
}
|
||||
None => Task::none(),
|
||||
}
|
||||
}
|
||||
Message::WindowHandle(hwnd) => {
|
||||
self.hwnd = hwnd;
|
||||
match hwnd {
|
||||
Some(_) => self.apply_window_alpha("boot"),
|
||||
None => {
|
||||
eprintln!("[appearance] hwnd=none（拿不到窗口句柄：整窗 α 无法下发）");
|
||||
self.log_appearance("boot", None);
|
||||
}
|
||||
}
|
||||
// M116：圆角放在 α **之后**——α < 1 时那一步才补上 `WS_EX_LAYERED`，
|
||||
// 先打圆角日志会把 `layered=` 记成 `off`（那正是我们要分辨的那一位）。
|
||||
self.apply_window_corner("boot");
|
||||
Task::none()
|
||||
}
|
||||
Message::SystemTheme(mode) => {
|
||||
let flavor = match mode {
|
||||
iced::theme::Mode::Dark => SchemeFlavor::Dark,
|
||||
iced::theme::Mode::None | iced::theme::Mode::Light => SchemeFlavor::Light,
|
||||
};
|
||||
eprintln!("[theme] 系统主题 = {mode:?}");
|
||||
// 优先级：`--theme` > 配置文件里的 `appearance.theme_mode` > 系统。
|
||||
// 早先这里无条件盖掉，于是「配置文件写 dark、系统是浅色」会出现
|
||||
// `light -> dark -> light` 的一次抖动，配置永远不生效（M90 r3 顺手修）。
|
||||
if self.options.theme.is_none() && self.theme_mode == ThemeMode::Auto {
|
||||
self.set_flavor(flavor);
|
||||
}
|
||||
Task::none()
|
||||
}
|
||||
Message::Frame => self.on_frame(),
|
||||
Message::Heartbeat => self.on_heartbeat(),
|
||||
Message::Window(event) => {
|
||||
match event {
|
||||
window::Event::Resized(size) => {
|
||||
self.width = size.width;
|
||||
// 高度是背景平铺网格的视口判据之一（宽度早就有），以前只记宽是因为没有背景层。
|
||||
self.height = size.height;
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
}
|
||||
// M113: import/export —— 拖入整合包（本版唯一的选文件通道；窗口级事件，
|
||||
// 所以入口收起时也照样接得住。细节在 `on_pack_dropped` / `on_pack_hover`）
|
||||
window::Event::FileDropped(path) => return self.on_pack_dropped(path),
|
||||
window::Event::FileHovered(_) => return self.on_pack_hover(true),
|
||||
window::Event::FilesHoveredLeft => return self.on_pack_hover(false),
|
||||
_ => {}
|
||||
}
|
||||
Task::none()
|
||||
}
|
||||
Message::Page(message) => self.on_page(message),
|
||||
Message::Agent(message) => self.on_agent(message),
|
||||
// 外壳导航轨（`src/shell/nav.rs`）发来的点选：翻成同一次路由跳转
|
||||
Message::Select(nav) => {
|
||||
self.state.navigate(route_of(nav));
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
Task::none()
|
||||
}
|
||||
Message::DragWindow => match self.window {
|
||||
Some(id) => window::drag(id),
|
||||
None => Task::none(),
|
||||
},
|
||||
Message::ResizeStart(direction) => match self.window {
|
||||
Some(id) => window::drag_resize(id, direction),
|
||||
None => Task::none(),
|
||||
},
|
||||
Message::Minimize => match self.window {
|
||||
Some(id) => window::minimize(id, true),
|
||||
None => Task::none(),
|
||||
},
|
||||
Message::ToggleMaximize => match self.window {
|
||||
Some(id) => window::toggle_maximize(id),
|
||||
None => Task::none(),
|
||||
},
|
||||
Message::Close => iced::exit(),
|
||||
Message::Captured(screenshot) => self.on_captured(&screenshot),
|
||||
Message::Demo(message) => {
|
||||
// gallery 只是 harness：按下只打日志，不接业务（组件库要能脱离业务验收）
|
||||
eprintln!("[gallery] {} pressed", message.id());
|
||||
Task::none()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 启动：问窗口句柄 → 让后端发布首屏快照 → 决定主题。
|
||||
///
|
||||
/// **首屏快照在 `Boot` 就抽干**（不是等第一拍）：截图通道在第 3 帧落盘，33 ms 的节拍
|
||||
/// 未必来得及到达，等节拍会把空页面拍进图里。
|
||||
fn on_boot(&mut self) -> Task<Message> {
|
||||
let mut tasks = vec![window::latest().map(Message::WindowReady)];
|
||||
|
||||
// M117：启动日志一行 —— `[auth] msa client_id=configured|missing source=env|build|none`。
|
||||
// 判据（配没配 + 从哪来）在 `core::auth::microsoft::client_id_status()`，零网络；
|
||||
// 本 crate 不直接依赖 core，所以经 `unlucky_cli`（已是本 crate 的依赖）出面，
|
||||
// 免得 UI 侧把判据重算一遍、两份口径漂。日后看日志能一眼分辨
|
||||
// 「没配置」与「配了但登录失败」。
|
||||
eprintln!("{}", unlucky_cli::commands::msa_client_id_log_line());
|
||||
|
||||
// 主题优先级：显式 `--theme` / `--screenshot-theme` > 设置文件 > 系统。
|
||||
// 截图通道**不读设置文件**（D30 可复现：同一份代码在两台机器上要出同一张图）。
|
||||
self.apply_config_theme();
|
||||
|
||||
// M93 外观取证开关（`ULL_APPEARANCE_*`）+ 启动那一行数值日志。
|
||||
// 必须在 `refresh_view` 之前：设置页要画的就是这份状态。
|
||||
self.appearance.apply_env();
|
||||
self.rebuild_ui();
|
||||
self.log_appearance("boot", None);
|
||||
|
||||
// 交互模式且没显式指定主题 → 探系统；截图模式永不等（见 cli 模块文档）
|
||||
if self.options.wants_system_theme() {
|
||||
tasks.push(iced::system::theme().map(Message::SystemTheme));
|
||||
}
|
||||
|
||||
// M104：助手栏的启动尾巴（窗口尺寸 adopt + 「拆出档直接落到独立页」）在 update/agent.rs。
|
||||
// **必须在 RefreshAll 之前**：那次 dispatch 会 `pump → auto_select`，把路由拉到实例详情，
|
||||
// 而 `sync_agent_route` 看到「不在 Agent 页却还是 Detached」就会把档位收回来——顺序反了
|
||||
// 就会出现「`ULL_AGENT_RAIL=detached` 启动后停在实例页」（r2 实测踩到）。
|
||||
self.boot_agent();
|
||||
|
||||
// 「重新扫描实例目录 + 全部页面快照」：真 host 在这里发首批事件，mock 在构造时已预置
|
||||
self.dispatch(AppCommand::RefreshAll);
|
||||
|
||||
// 取证开关 `ULL_START_ROUTE`：截图/冒烟直接落到某一页（`cli.rs` 不在本 mission 的 scope，
|
||||
// 而「外观」分组只在设置页上，出矩阵必须能直达）。未知值忽略。
|
||||
if let Some(route) = boot_env::env_start_route() {
|
||||
eprintln!("[boot] ULL_START_ROUTE → {route:?}");
|
||||
self.state.navigate(route);
|
||||
// 直达某一页时不要再被「自动选中第一条实例」拉回详情页。
|
||||
self.auto_selected = true;
|
||||
// M109：直达内容库时补一次检索（与页面内切换同一个入口）
|
||||
self.ensure_content_loaded();
|
||||
}
|
||||
account::force_account_state(self);
|
||||
|
||||
self.auto_select();
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
|
||||
// 空闲心跳从这里开始自续（它是唯一能在「没有帧事件」时戳醒 app 的时钟）
|
||||
tasks.push(heartbeat());
|
||||
|
||||
Task::batch(tasks)
|
||||
}
|
||||
|
||||
/// 空闲心跳：只有「不需要帧节拍」时才推进一拍，然后**无条件续排**下一拍。
|
||||
///
|
||||
/// 为什么无条件续排：忙碌结束（游戏退出、toast 过期、观察窗关闭）之后没有别的东西会叫醒
|
||||
/// app，心跳链必须一直在，才能把低频时钟接回去。忙碌期间它只是每秒醒一次、什么都不做。
|
||||
fn on_heartbeat(&mut self) -> Task<Message> {
|
||||
if !self.needs_frames() {
|
||||
let now = Instant::now();
|
||||
let elapsed = now.saturating_duration_since(self.last_tick).max(IDLE_TICK);
|
||||
self.last_tick = now;
|
||||
self.advance(elapsed);
|
||||
}
|
||||
heartbeat()
|
||||
}
|
||||
|
||||
/// 一帧画完：①够 33 ms 就推进一拍 presenter ②截图模式在第 [`CAPTURE_AT_FRAME`] 帧出图。
|
||||
///
|
||||
/// 时间闸门按**真实流逝时间**判（不是数帧）：掉帧不会把游戏启动进度拖慢，
|
||||
/// 也不会在慢机器上把 1.5 s 的下载阶段拉成 4 s。
|
||||
fn on_frame(&mut self) -> Task<Message> {
|
||||
self.frames += 1;
|
||||
|
||||
let now = Instant::now();
|
||||
let elapsed = now.saturating_duration_since(self.last_tick);
|
||||
if elapsed >= TICK {
|
||||
self.last_tick = now;
|
||||
self.advance(elapsed);
|
||||
}
|
||||
|
||||
// 主题在启动时就已确定（截图模式必有主题，见 cli 模块文档），这里只剩帧数闸门
|
||||
if !self.wants_frames() || self.frames < CAPTURE_AT_FRAME {
|
||||
return Task::none();
|
||||
}
|
||||
|
||||
match self.window {
|
||||
Some(id) => window::screenshot(id).map(Message::Captured),
|
||||
None => Task::none(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 截图回来了：落盘 + 打一行取证日志，然后退出。
|
||||
fn on_captured(&mut self, screenshot: &window::Screenshot) -> Task<Message> {
|
||||
let Some(path) = self.options.screenshot.clone() else {
|
||||
return Task::none();
|
||||
};
|
||||
match crate::shot::save(screenshot, &path) {
|
||||
Ok(summary) => {
|
||||
eprintln!("{}", summary.describe());
|
||||
// M97：打**实际**后端名（`wgpu`/`tiny-skia`），不是请求值——`renderer=auto` 曾经出现在每张验收图的日志里。
|
||||
eprintln!(
|
||||
"[shot] screen={} theme={} renderer={} route={:?}",
|
||||
self.options.screen.name(),
|
||||
crate::shot::flavor_slug(&self.ui),
|
||||
super::backend::effective_kind().map_or("?", Kind::name),
|
||||
self.state.route()
|
||||
);
|
||||
}
|
||||
Err(error) => eprintln!("[shot] 失败：{error}"),
|
||||
}
|
||||
|
||||
iced::exit()
|
||||
}
|
||||
}
|
||||
|
||||
/// 空闲心跳的一拍：睡 1 秒再发 [`Message::Heartbeat`]。
|
||||
///
|
||||
/// 用 `Task::perform` + `std::thread::sleep` 而不是 `iced::time::every`：后者只在 tokio/smol
|
||||
/// 后端提供（本 crate 的执行器是 thread-pool，Cargo.toml 不在 scope）。代价是每拍让线程池里
|
||||
/// 一个线程阻塞 1 秒——按 1 Hz 算，对线程池（默认 = CPU 数）是可接受的占用。
|
||||
fn heartbeat() -> Task<Message> {
|
||||
Task::perform(async { std::thread::sleep(IDLE_TICK) }, |()| {
|
||||
Message::Heartbeat
|
||||
})
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod download_wiring;
|
||||
@@ -0,0 +1,210 @@
|
||||
//! 账户页消息的落点（M114）：页面只发意图，这里翻成 `AppCommand` 或本地的表单状态写入。
|
||||
//!
|
||||
//! 三条纪律（与 `update.rs` 同源）：
|
||||
//!
|
||||
//! 1. **不做乐观回显**：切账户/删账户/登录都只派命令，等 `AccountsChanged` /
|
||||
//! `DeviceLoginChanged` / `AuthlibLoginChanged` 回来才改列表；
|
||||
//! 2. **密码只走一次**：`Submit` 把 `AuthlibRequest` 交给后端后立刻清掉表单里的密码
|
||||
//! （成功失败都清——重试用新输入，不在内存里多留一份凭据）；
|
||||
//! 3. **表单态是纯 UI 状态**：输入框改动只写 `App::account_form` + 置脏，不派命令。
|
||||
//!
|
||||
//! ## 返回 `Task`（M114 r2 / 复审 P2-1）
|
||||
//!
|
||||
//! 复制用户码/链接必须把 `iced::clipboard::write` 的 `Task` **交回 runtime**——iced 0.14 的
|
||||
//! `Task` 是惰性 stream，丢掉返回值等于永不执行（日志页的 Copy summary 就是正确写法）。
|
||||
|
||||
use iced::Task;
|
||||
use unlucky_presenter::dto::{AccountKind, AppCommand, AuthlibRequest, DeviceLoginPhase};
|
||||
|
||||
use crate::app::Message;
|
||||
use crate::pages::account::{Hint, Message as Account, Panel, Track};
|
||||
|
||||
use super::super::state::App;
|
||||
|
||||
impl App {
|
||||
/// 账户页消息。
|
||||
pub(super) fn on_account(&mut self, message: Account) -> Task<Message> {
|
||||
// 复制是唯一需要**交回 Task** 的分支：先把它的 Task 抓出来，其余分支照旧改状态
|
||||
let clipboard = match &message {
|
||||
Account::Copy(text) => Some(text.clone()),
|
||||
_ => None,
|
||||
};
|
||||
|
||||
match message {
|
||||
Account::Open(track) => {
|
||||
self.account_form.open(track);
|
||||
self.account_form.hint = None;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
Account::ToggleAdd => {
|
||||
self.account_form.section_open = !self.account_form.section_open;
|
||||
self.account_form.hint = None;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
Account::Close => {
|
||||
self.account_form.close();
|
||||
// 关面板必须把**两条轨**的登录态都收回 Idle（复审 r2 P2-1：只看 `busy()` 时，
|
||||
// `Failed`/`Succeeded` 不在 busy ⇒ 状态仍是非 Idle ⇒ `Page::build` 又把面板
|
||||
// 强制回 Microsoft，按钮成了死按钮）。`CancelDeviceLogin` 在 host 侧本来就
|
||||
// 同时收两条轨并发 Idle，所以判据用「非 Idle」而不是「busy」。
|
||||
if self.state.device_login.phase != DeviceLoginPhase::Idle
|
||||
|| self.state.authlib_login.phase != DeviceLoginPhase::Idle
|
||||
{
|
||||
self.dispatch(AppCommand::CancelDeviceLogin);
|
||||
}
|
||||
self.view_dirty = true;
|
||||
}
|
||||
Account::DismissNotice => self.dispatch(AppCommand::DismissAccountNotice),
|
||||
Account::Server(value) => {
|
||||
self.account_form.server = value;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
Account::Login(value) => {
|
||||
self.account_form.login = value;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
Account::Password(value) => {
|
||||
self.account_form.password = value;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
Account::OfflineName(value) => {
|
||||
self.account_form.offline_name = value;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
Account::Probe => {
|
||||
let server = self.account_form.server.clone();
|
||||
if !server.trim().is_empty() {
|
||||
self.dispatch(AppCommand::ProbeAuthlibServer(server));
|
||||
}
|
||||
}
|
||||
Account::Submit => match self.account_form.panel {
|
||||
Panel::Offline => {
|
||||
// 名字**不清空**：失败时用户还要看见自己输入的（复审 r1 P2-2 的另一半）
|
||||
let name = self.account_form.offline_name.trim().to_string();
|
||||
if !name.is_empty() {
|
||||
self.dispatch(AppCommand::AddOfflineAccount(name));
|
||||
}
|
||||
}
|
||||
Panel::Authlib => {
|
||||
if self.account_form.authlib_ready() {
|
||||
let request = AuthlibRequest::new(
|
||||
self.account_form.server.clone(),
|
||||
self.account_form.login.clone(),
|
||||
std::mem::take(&mut self.account_form.password),
|
||||
);
|
||||
self.dispatch(AppCommand::AddAuthlibAccount(request));
|
||||
}
|
||||
}
|
||||
Panel::Microsoft => return self.on_account(Account::StartBrowser),
|
||||
Panel::None => {}
|
||||
},
|
||||
Account::StartDevice => self.dispatch(AppCommand::StartDeviceLogin),
|
||||
Account::StartBrowser => self.dispatch(AppCommand::StartBrowserLogin),
|
||||
Account::Cancel => {
|
||||
self.account_form.close();
|
||||
self.dispatch(AppCommand::CancelDeviceLogin);
|
||||
}
|
||||
Account::Copy(_) => {}
|
||||
Account::Switch(id) => self.dispatch(AppCommand::SwitchAccount(id)),
|
||||
Account::Remove(id) => self.dispatch(AppCommand::RemoveAccount(id)),
|
||||
Account::Relogin(id) => return self.relogin(&id),
|
||||
}
|
||||
self.refresh_view();
|
||||
|
||||
match clipboard {
|
||||
Some(text) => iced::clipboard::write(text),
|
||||
None => Task::none(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 「重新登录」按**账户类型**分派（复审 r1 P2-3）。
|
||||
///
|
||||
/// - 微软轨：走授权码流（原路）；
|
||||
/// - 第三方轨：第三方站没有「一键重登」——预填服务器地址与登录名，让用户补密码；
|
||||
/// - 本地档案：没有服务器账户可重登 ⇒ 明确说明，不假装能做。
|
||||
fn relogin(&mut self, id: &str) -> Task<Message> {
|
||||
let Some(account) = self
|
||||
.state
|
||||
.accounts
|
||||
.iter()
|
||||
.find(|account| account.id == id)
|
||||
.cloned()
|
||||
else {
|
||||
return Task::none();
|
||||
};
|
||||
self.account_form.hint = None;
|
||||
match account.kind {
|
||||
AccountKind::Microsoft => {
|
||||
self.account_form.panel = Panel::Microsoft;
|
||||
self.dispatch(AppCommand::StartBrowserLogin);
|
||||
}
|
||||
AccountKind::Authlib => {
|
||||
self.account_form.open(Track::Authlib);
|
||||
self.account_form.server = account.server_url.clone();
|
||||
self.account_form.login = account.login_name.clone();
|
||||
self.account_form.password.clear();
|
||||
self.account_form.hint = Some(Hint::AuthlibReauth);
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
}
|
||||
AccountKind::Offline => {
|
||||
self.account_form.hint = Some(Hint::OfflineNoRelogin);
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
}
|
||||
}
|
||||
Task::none()
|
||||
}
|
||||
}
|
||||
|
||||
/// 取证开关 `ULL_ACCOUNT_STATE` 的落地（**只在 `--screenshot` 下生效**）。
|
||||
///
|
||||
/// 为什么需要：设备码过期要等 15 分钟、表单要手点两下，截图通道等不到自然发生的状态。
|
||||
pub(super) fn force_account_state(app: &mut App) {
|
||||
if !app.has_screenshot() {
|
||||
return;
|
||||
}
|
||||
let Ok(state) = std::env::var("ULL_ACCOUNT_STATE") else {
|
||||
return;
|
||||
};
|
||||
match state.trim().to_lowercase().as_str() {
|
||||
// 设备码已过期：起点往前挪一小时（倒计时自己算出来就是 0）
|
||||
"expired" => {
|
||||
app.state.device_login_started =
|
||||
Some(std::time::Instant::now() - std::time::Duration::from_secs(3_600));
|
||||
}
|
||||
// 第三方站**失败**态：面板打开 + mock 那边给出的 `AuthlibLoginChanged(Failed)`
|
||||
"authlib-failed" => {
|
||||
app.account_form.panel = crate::pages::account::Panel::Authlib;
|
||||
app.account_form.server = "https://example.invalid/api/yggdrasil/".to_string();
|
||||
app.account_form.login = "alex@example.com".to_string();
|
||||
}
|
||||
// 离线档案失败态：面板打开（横幅由 mock 的 notice 场景给）
|
||||
"notice" => {
|
||||
app.account_form.panel = crate::pages::account::Panel::Offline;
|
||||
app.account_form.offline_name = "ab".to_string();
|
||||
}
|
||||
// 第三方站表单：直接把面板打开并预填地址
|
||||
"authlib" | "authlib-form" => {
|
||||
app.account_form.panel = crate::pages::account::Panel::Authlib;
|
||||
if app.account_form.server.trim().is_empty() {
|
||||
app.account_form.server = "https://littleskin.cn/api/yggdrasil/".to_string();
|
||||
}
|
||||
app.account_form.login = "steve@example.com".to_string();
|
||||
app.account_form.password = "not-a-real-password".to_string();
|
||||
}
|
||||
// 「关掉之后」：mock 给的是 failed 种子，这里按一次 Close（走真实的
|
||||
// `on_account` → `CancelDeviceLogin` 通道），出「面板真的关了」的对照图。
|
||||
"closed" => {
|
||||
let _ = app.on_account(crate::pages::account::Message::Close);
|
||||
}
|
||||
// 有账号时「Add an account」展开态（P2-4 的收敛后形态）
|
||||
"add" => {
|
||||
app.account_form.section_open = true;
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
@@ -0,0 +1,303 @@
|
||||
//! **树测试②（M119 验收核心）**：账户页消费 presenter 的账户列表与登录事件。
|
||||
//!
|
||||
//! 后端是 UI 侧的 [`AccountRig`]：它把 `AppCommand` 翻成**与真 host 同形状**的 `CoreEvent`
|
||||
//! （`AccountsChanged` / `DeviceLoginChanged` / `AccountNoticeChanged`），数据在内存里。
|
||||
//! 于是这条测试钉住的是「**接线**」——用户点一下之后，命令出去、事件回来、页面重算、横幅出现；
|
||||
//! 抓不住的是 `core::auth::AccountStore` 的落盘（那条由 presenter 自己的
|
||||
//! `host::accounts::offline_add_list_remove_round_trips` 覆盖，原因见 `presenter/rig.rs` 的模块文档）。
|
||||
//!
|
||||
//! 覆盖任务书第 3 条与第 4 条的账户那一半：
|
||||
//!
|
||||
//! | 断言 | 抓得住什么 |
|
||||
//! |---|---|
|
||||
//! | 添加离线档案 → 列表出现一行 | `AddOfflineAccount` 没派发 / 事件没回流 / 页面没重建 |
|
||||
//! | 切换当前账号 → 「当前」标记换人 | `SwitchAccount` 没派发（M114 的 `active` 标记是页面唯一来源）|
|
||||
//! | 删除 → 列表回到空态 | `RemoveAccount` 没派发 |
|
||||
//! | 设备码「进行中可见 + 可取消」 | `StartDeviceLogin` / `CancelDeviceLogin` 没接线（只剩转圈）|
|
||||
//! | 失败态：名字不合法 / 凭据失效都给**具名**错误 | 失败被吞掉（复审 r1 P2-2 的老毛病）|
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_i18n::{Catalog, Key, Lang};
|
||||
use unlucky_presenter::dto::{
|
||||
AccountNoticeCode, AppEvent, AuthlibLoginView, CoreEvent, DeviceLoginView, LoginFailure,
|
||||
};
|
||||
use unlucky_presenter::mock::MockBackend;
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
|
||||
use crate::app::state::presenter::rig::AccountRig;
|
||||
use crate::pages::account::model::{AuthlibPanel, DevicePanel};
|
||||
use crate::pages::account::{Form, Message as Account, Panel, Track};
|
||||
use crate::theme::Families;
|
||||
|
||||
use super::App;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
/// 不碰磁盘的 App，后端换成**账户 rig**（其余分支照旧走 `MockBackend` 的能力就够）。
|
||||
fn with_rig() -> App {
|
||||
App::with_presenter(
|
||||
crate::cli::Options::default(),
|
||||
FAMILIES,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(AccountRig::new()),
|
||||
SettingsBridge::memory_only(),
|
||||
)
|
||||
}
|
||||
|
||||
/// 不碰磁盘的 App（mock 后端 + 内存设置桥），与 `app/tests.rs` 的 `headless` 同源。
|
||||
fn headless() -> App {
|
||||
App::with_presenter(
|
||||
crate::cli::Options::default(),
|
||||
FAMILIES,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(MockBackend::new()),
|
||||
SettingsBridge::memory_only(),
|
||||
)
|
||||
}
|
||||
|
||||
fn seed(app: &mut App, event: CoreEvent) {
|
||||
app.state.apply(AppEvent::Core(event));
|
||||
app.refresh_view();
|
||||
}
|
||||
|
||||
/// **添加 → 切换 → 删除**（任务书第 3 条，一条端到端）。
|
||||
///
|
||||
/// 抓得住：三条命令任何一条没派发 / 事件没回流 / `refresh_view` 没带上账户页。
|
||||
/// 抓不住：真实账户库的落盘（见模块文档）。
|
||||
#[test]
|
||||
fn an_offline_profile_is_added_switched_and_removed_end_to_end() {
|
||||
let mut app = with_rig();
|
||||
assert!(app.account.is_empty(), "出厂是空态");
|
||||
|
||||
// ① 添加离线档案：走真消息（点轨道卡 → 填名字 → 提交）
|
||||
let _ = app.on_account(Account::Open(Track::Offline));
|
||||
assert_eq!(app.account_form.panel, Panel::Offline);
|
||||
// 表单输入也走真消息（纯 UI 态，只写 `App::account_form` + 置脏）
|
||||
let _ = app.on_account(Account::OfflineName("Steve".to_string()));
|
||||
assert!(
|
||||
app.account_form.offline_ready(),
|
||||
"3–16 位字母：按钮该是亮的"
|
||||
);
|
||||
let _ = app.on_account(Account::Submit);
|
||||
|
||||
assert_eq!(app.account.rows.len(), 1, "列表出现一行（不是静默）");
|
||||
assert_eq!(app.account.rows[0].name, "Steve");
|
||||
assert_eq!(
|
||||
app.account.notice.as_ref().map(|notice| notice.code),
|
||||
Some(AccountNoticeCode::Added),
|
||||
"页面横幅给出的是一次性结果"
|
||||
);
|
||||
let id = app.account.rows[0].id.clone();
|
||||
|
||||
// ② 切换当前账号
|
||||
let _ = app.on_account(Account::Switch(id.clone()));
|
||||
assert_eq!(
|
||||
app.account.active_row().map(|row| row.name.as_str()),
|
||||
Some("Steve"),
|
||||
"「当前」标记跟着切换走"
|
||||
);
|
||||
|
||||
// ③ 删除
|
||||
let _ = app.on_account(Account::Remove(id));
|
||||
assert!(app.account.rows.is_empty(), "删除后回到空态");
|
||||
assert_eq!(
|
||||
app.account.notice.as_ref().map(|notice| notice.code),
|
||||
Some(AccountNoticeCode::Removed)
|
||||
);
|
||||
// 两个横幅文案都有词（中英各一条，不是硬编码）
|
||||
for lang in [Lang::En, Lang::ZhCn] {
|
||||
assert!(!Catalog::of(lang).text(Key::AccountNoticeRemoved).is_empty());
|
||||
}
|
||||
// 整棵树在三种状态下都能构图
|
||||
let _ = app.view();
|
||||
}
|
||||
|
||||
/// 设备码流程：**指令发出 + 进行中可见 + 可取消**（任务书第 3 条的后半，真实网络不要求）。
|
||||
#[test]
|
||||
fn the_device_code_flow_is_started_visible_and_cancellable() {
|
||||
let mut app = with_rig();
|
||||
assert_eq!(app.account.device, DevicePanel::Hidden);
|
||||
|
||||
let _ = app.on_account(Account::StartDevice);
|
||||
match &app.account.device {
|
||||
DevicePanel::Code {
|
||||
code, remaining, ..
|
||||
} => {
|
||||
assert_eq!(code, "ABCD-EFGH", "用户码要上屏");
|
||||
assert!(remaining.is_some_and(|left| left > 0), "倒计时在跑");
|
||||
}
|
||||
other => panic!("进行中状态必须可见，实际 {other:?}"),
|
||||
}
|
||||
assert_eq!(app.account.panel, Panel::Microsoft, "面板要切到微软那条轨");
|
||||
let _ = app.view();
|
||||
|
||||
let _ = app.on_account(Account::Cancel);
|
||||
assert_eq!(app.account.device, DevicePanel::Hidden, "取消要真的收掉");
|
||||
assert_eq!(
|
||||
app.state.device_login.phase,
|
||||
unlucky_presenter::dto::DeviceLoginPhase::Idle
|
||||
);
|
||||
}
|
||||
|
||||
/// 失败态①：**未实现 / 名字不合法** ⇒ 页面横幅给出结构化码（不是静默无语）。
|
||||
#[test]
|
||||
fn an_invalid_profile_name_surfaces_a_named_failure() {
|
||||
let mut app = with_rig();
|
||||
let _ = app.on_account(Account::Open(Track::Offline));
|
||||
// 名字不合法时**发送键是灰的**（与 host 同一份判据），所以这里直接派命令：
|
||||
// 抓的是「host 真的回了一个结构化失败码」这条链路，而不是按钮的禁用态。
|
||||
assert!(!app.account_form.offline_ready());
|
||||
app.dispatch(unlucky_presenter::dto::AppCommand::AddOfflineAccount(
|
||||
"ab".to_string(),
|
||||
));
|
||||
|
||||
assert!(app.account.rows.is_empty(), "不合法的名字不入列表");
|
||||
let notice = app.account.notice.as_ref().expect("必须有横幅");
|
||||
assert_eq!(notice.code, AccountNoticeCode::OfflineNameInvalid);
|
||||
assert!(notice.failure, "失败档（配色不同）");
|
||||
assert_eq!(notice.subject, "ab", "横幅要带上是哪个名字");
|
||||
// 文案走 catalog，中英各一条
|
||||
for lang in [Lang::En, Lang::ZhCn] {
|
||||
assert!(!Catalog::of(lang)
|
||||
.text(Key::AccountNoticeOfflineNameInvalid)
|
||||
.is_empty());
|
||||
}
|
||||
let _ = app.view();
|
||||
}
|
||||
|
||||
/// 失败态②：**账户凭据失效** ⇒ 第三方轨面板进入 `Failed(BadCredentials)`（只带原因码）。
|
||||
///
|
||||
/// 为什么只断言原因码：M114 r3 起面板类型里**没有** `message`/`detail` 字段（原文只进 presenter
|
||||
/// 日志），页面据码选 catalog 文案。这条测试与「页面画得出文案」之间的桥梁是
|
||||
/// `pages::account::login::failure_body_key`（同一 crate 内的穷尽 match，缺一条编译不过）。
|
||||
#[test]
|
||||
fn expired_credentials_surface_a_named_failure_code() {
|
||||
let mut app = headless();
|
||||
seed(
|
||||
&mut app,
|
||||
CoreEvent::AuthlibLoginChanged(AuthlibLoginView::failed_as(
|
||||
LoginFailure::BadCredentials,
|
||||
"服务器返回 401：凭据已失效（token=…已脱敏）",
|
||||
)),
|
||||
);
|
||||
app.account_form.open(Track::Authlib);
|
||||
app.refresh_view();
|
||||
|
||||
assert_eq!(
|
||||
app.account.authlib,
|
||||
AuthlibPanel::Failed {
|
||||
failure: LoginFailure::BadCredentials
|
||||
},
|
||||
"凭据失效要落成具名原因码，而不是静默回 Idle"
|
||||
);
|
||||
// 原因码对应的那句译文两套语言都得有
|
||||
for lang in [Lang::En, Lang::ZhCn] {
|
||||
let text = Catalog::of(lang).text(Key::AccountFailureBadCredentials);
|
||||
assert!(!text.trim().is_empty(), "{} 缺这条失败文案", lang.tag());
|
||||
}
|
||||
// 原文不许出现在页面的任何可视文本里（M114 的凭据红线）
|
||||
assert!(
|
||||
!format!("{:?}", app.account).contains("服务器返回 401"),
|
||||
"后端原文不许进页面模型"
|
||||
);
|
||||
let _ = app.view();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- M114 的既有回归闸
|
||||
|
||||
/// **复审 r2 P2-1 的回归闸**：登录失败/成功态下按 `Close`，面板必须真的关掉。
|
||||
///
|
||||
/// 为什么这条以前是死按钮：`Page::build` 只要 `device_login.phase != Idle` 就把面板强制
|
||||
/// 回 Microsoft，而 `Close` 只在 `busy()`（Requesting/Waiting）时才派 `CancelDeviceLogin`
|
||||
/// ⇒ Failed/Succeeded 下点了没反应。现在判据改成「非 Idle」，两条轨都覆盖。
|
||||
///
|
||||
/// 抓得住：判据退回 `busy()`；`Close` 忘了 dispatch；`CancelDeviceLogin` 没有把状态收回 Idle。
|
||||
/// 抓不住：`CancelDeviceLogin` 在**真 host** 上的副作用（这里跑的是 mock，但 mock 已按
|
||||
/// 真 host 的契约发 Idle，见 `presenter/src/mock.rs`）。
|
||||
#[test]
|
||||
fn close_really_closes_the_login_panel_on_both_tracks() {
|
||||
// ① 微软轨：失败态
|
||||
let mut app = headless();
|
||||
seed(
|
||||
&mut app,
|
||||
CoreEvent::DeviceLoginChanged(DeviceLoginView {
|
||||
phase: unlucky_presenter::dto::DeviceLoginPhase::Failed,
|
||||
message: "微软拒绝了这次登录：AADSTS7000218（HTTP 403）".to_string(),
|
||||
failure: Some(LoginFailure::NotWhitelisted),
|
||||
..DeviceLoginView::new()
|
||||
}),
|
||||
);
|
||||
assert_eq!(app.account.panel, Panel::Microsoft, "失败态面板要显示");
|
||||
let _ = app.on_account(Account::Close);
|
||||
assert_eq!(app.account.panel, Panel::None, "Close 之后面板必须关掉");
|
||||
assert_eq!(
|
||||
app.state.device_login.phase,
|
||||
unlucky_presenter::dto::DeviceLoginPhase::Idle
|
||||
);
|
||||
|
||||
// ② 微软轨：成功态（同样不在 busy 里）
|
||||
let mut app = headless();
|
||||
seed(
|
||||
&mut app,
|
||||
CoreEvent::DeviceLoginChanged(DeviceLoginView::succeeded("Steve")),
|
||||
);
|
||||
assert_eq!(app.account.panel, Panel::Microsoft);
|
||||
let _ = app.on_account(Account::Close);
|
||||
assert_eq!(app.account.panel, Panel::None, "成功提示也要能关掉");
|
||||
|
||||
// ③ 第三方轨：失败态
|
||||
let mut app = headless();
|
||||
seed(
|
||||
&mut app,
|
||||
CoreEvent::AuthlibLoginChanged(AuthlibLoginView {
|
||||
phase: unlucky_presenter::dto::DeviceLoginPhase::Failed,
|
||||
server: "https://example.invalid/api/yggdrasil/".to_string(),
|
||||
server_name: String::new(),
|
||||
message: "服务器返回 HTTP 404".to_string(),
|
||||
failure: Some(LoginFailure::NotAuthlibServer),
|
||||
account_name: String::new(),
|
||||
}),
|
||||
);
|
||||
app.account_form.open(Track::Authlib);
|
||||
app.refresh_view();
|
||||
assert_eq!(
|
||||
app.account.panel,
|
||||
Panel::Authlib,
|
||||
"第三方轨失败态面板要显示"
|
||||
);
|
||||
let _ = app.on_account(Account::Close);
|
||||
assert_eq!(app.account.panel, Panel::None, "第三方轨也要能关掉");
|
||||
assert_eq!(
|
||||
app.state.authlib_login.phase,
|
||||
unlucky_presenter::dto::DeviceLoginPhase::Idle
|
||||
);
|
||||
}
|
||||
|
||||
/// 表单态是纯 UI 状态：打开/关闭面板不派命令，但会把面板切对。
|
||||
///
|
||||
/// 抓得住：`Open` 忘了写 `panel`（点了轨道卡什么都不出现）、`close()` 不清密码。
|
||||
/// 抓不住：真实 dispatch 的副作用（那要真后端）。
|
||||
#[test]
|
||||
fn the_form_state_follows_the_page_messages() {
|
||||
let mut form = Form::new();
|
||||
assert_eq!(form.panel, Panel::None);
|
||||
form.open(Track::Authlib);
|
||||
assert_eq!(form.panel, Panel::Authlib);
|
||||
form.password = "hunter2".to_string();
|
||||
form.close();
|
||||
assert_eq!(form.panel, Panel::None);
|
||||
assert!(form.password.is_empty(), "关闭面板必须把一次性密码清掉");
|
||||
}
|
||||
|
||||
/// 三张轨道卡默认收起（有账号时），`ToggleAdd` 展开（复审 r1 P2-4）。
|
||||
#[test]
|
||||
fn the_add_section_starts_collapsed() {
|
||||
let mut form = Form::new();
|
||||
assert!(!form.section_open);
|
||||
form.section_open = true;
|
||||
assert!(form.section_open);
|
||||
}
|
||||
@@ -0,0 +1,381 @@
|
||||
//! 助手栏消息的落点（M104 建，M119 接线）：三档状态迁移 / 输入 / 键盘 / **presenter 四契约**。
|
||||
//!
|
||||
//! ## 为什么单独一个文件
|
||||
//!
|
||||
//! `app/update.rs` 已经贴着 400 行硬上限（M94 也因此把下载页四支拆到 `update/download.rs`）。
|
||||
//! 助手栏有十几个变体，塞回主文件必破线。
|
||||
//!
|
||||
//! ## 分工：视图态 vs presenter 契约（M119 之后的分界线）
|
||||
//!
|
||||
//! | 消息 | 落到哪 |
|
||||
//! |---|---|
|
||||
//! | `Expand` / `Collapse` / `Dock` / `Escape` | **只改视图态**（`AgentUi`）+ 路由栈（离开/进入 `Route::Agent`）+ `agent_mark_read` |
|
||||
//! | `Detach` | 视图态 + `Route::Agent`（压栈，`back()` 能回去）+ `agent_mark_read` |
|
||||
//! | `Edit` | 视图态（草稿），并同步进 presenter 的草稿（`agent_set_draft`） |
|
||||
//! | `Submit` | [`AgentHost::submit`] → `agent_submit`；失败**不留白**（具名错误进横幅） |
|
||||
//! | `Stop` | `AppCommand::StopAgent`（真后端才收敛得出结果；同步 rig 下是 no-op） |
|
||||
//! | `Confirm(accept)` | [`AgentHost::confirm`] → `agent_confirm`（YOLO 下 presenter 自己放行并记审计） |
|
||||
//! | `Events(..)` | [`AgentHost::apply`] → `AppState::apply`（**事件回流的唯一落点**） |
|
||||
//! | `DragStart` / `DragTo` / `DragEnd` | 视图态：吸附宽度 |
|
||||
//! | `Key` / `Tab` / `Activate` | 键盘路径（`Tab` 的环要在流式中多一格，`busy` 从 rail 取） |
|
||||
//!
|
||||
//! **会话内容一行都不在这里攒**：`transcript` / `busy` / `unread` / `confirm` 全在 presenter 的
|
||||
//! `AgentRail` 上（M119 删掉了 M104 的自持副本）。
|
||||
//!
|
||||
//! ## 事件为什么绕一圈消息再回来
|
||||
//!
|
||||
//! `agent_submit` / `agent_confirm` 的端口是同步的，但**事件走队列**（见
|
||||
//! `app/state/presenter/transport.rs`）：抽队列的那一步必须和用户点击走同一条漏斗，否则两处各改
|
||||
//! 一次状态，流式标记与未读会打架。所以 [`App::drain_agent`] 抽出来之后立刻
|
||||
//! `on_agent(agent::Message::Events(..))` —— 同一条 `Message::Agent(..)` 通道。
|
||||
|
||||
use iced::keyboard::{key, Key};
|
||||
use iced::Task;
|
||||
|
||||
use unlucky_i18n::{Catalog, Key as TextKey};
|
||||
use unlucky_presenter::dto::AppCommand;
|
||||
|
||||
use crate::app::MIN_SIZE;
|
||||
use crate::app::WINDOW_SIZE;
|
||||
use crate::shell::agent::demo::{self, Fixture};
|
||||
use crate::shell::agent::{self, Focus, RailState};
|
||||
|
||||
use super::super::state::presenter::agent::SubmitOutcome;
|
||||
use super::*;
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
|
||||
impl App {
|
||||
/// 助手栏消息（`app::Message::Agent(..)` 的唯一落点）。
|
||||
pub(super) fn on_agent(&mut self, message: agent::Message) -> Task<Message> {
|
||||
// M106 口径：文案走**生效语言**的目录，不再恒英文
|
||||
let catalog = Catalog::of(self.lang());
|
||||
|
||||
// 只有**几何**会变的几支才需要重建页面模型（`pages::Model` 里没有会话内容：会话在
|
||||
// presenter 的 rail 上，右栗自己那棵树每次 `view()` 都从 rail 现读）。复审 P3-9 的教训：
|
||||
// 每敲一个字符都重建整张模型是白克隆。
|
||||
let geometry_changed = matches!(
|
||||
message,
|
||||
agent::Message::Expand
|
||||
| agent::Message::Collapse
|
||||
| agent::Message::Detach
|
||||
| agent::Message::Dock
|
||||
| agent::Message::DragTo(_)
|
||||
| agent::Message::DragEnd
|
||||
| agent::Message::Escape
|
||||
| agent::Message::Activate
|
||||
| agent::Message::Key(_)
|
||||
);
|
||||
|
||||
match message {
|
||||
agent::Message::Expand => {
|
||||
self.agent.expand();
|
||||
// 「展开即读」是 presenter 的语义（`agent_mark_read`），壳只负责在正确的时刻调它
|
||||
self.agent_host.mark_read();
|
||||
}
|
||||
agent::Message::Collapse | agent::Message::Escape => self.collapse_agent(),
|
||||
agent::Message::Detach => {
|
||||
self.agent.detach();
|
||||
self.agent_host.mark_read();
|
||||
self.state.navigate(Route::Agent);
|
||||
}
|
||||
agent::Message::Dock => {
|
||||
self.agent.dock();
|
||||
self.agent_host.mark_read();
|
||||
self.leave_agent_page();
|
||||
}
|
||||
agent::Message::DragStart => self.agent.drag_start(),
|
||||
agent::Message::DragTo(x) => self.agent.drag_to(self.width, x),
|
||||
agent::Message::DragEnd => self.agent.drag_end(),
|
||||
agent::Message::Edit(action) => {
|
||||
self.agent.edit(action);
|
||||
// 草稿同步给 presenter（切形态不丢；它也是 rail 上唯一允许躺原文的字段）
|
||||
self.agent_host.set_draft(self.agent.draft.text());
|
||||
}
|
||||
agent::Message::Submit => self.submit_agent(),
|
||||
agent::Message::Stop => self.dispatch(AppCommand::StopAgent),
|
||||
agent::Message::Confirm(accept) => {
|
||||
self.agent_host.confirm(accept);
|
||||
self.drain_agent();
|
||||
}
|
||||
agent::Message::Events(events) => {
|
||||
for event in events {
|
||||
self.agent_host.apply(event);
|
||||
}
|
||||
self.view_dirty = true;
|
||||
}
|
||||
agent::Message::Tab { shift } => {
|
||||
let rail = self.agent_host.rail();
|
||||
let (busy, pending) = (rail.busy, rail.confirm.is_some());
|
||||
self.agent.step_focus(shift, busy, pending);
|
||||
}
|
||||
agent::Message::Activate => self.activate_focused(catalog),
|
||||
agent::Message::Key(event) => return self.on_agent_key(event),
|
||||
}
|
||||
|
||||
// 待确认请求出现/消失时，把键盘焦点挪到（或挪离）确认条的按钮上
|
||||
self.sync_confirm_focus();
|
||||
// 档位 / 路由变了就要把「栏可见吗」写回 presenter（未读口径的输入）
|
||||
self.sync_agent_presenter();
|
||||
if geometry_changed {
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
}
|
||||
Task::none()
|
||||
}
|
||||
|
||||
/// 发送：草稿 → `agent_submit` → 抽事件。
|
||||
///
|
||||
/// 三种结局各自有落点：发出去（清草稿）/ 后端失败（具名横幅，见 [`App::agent_failure`]）/
|
||||
/// presenter 拒收（日志一行——这三种情形正常情况下被禁用态挡住，够不着）。
|
||||
fn submit_agent(&mut self) {
|
||||
let text = self.agent.draft.text();
|
||||
if text.trim().is_empty() {
|
||||
return;
|
||||
}
|
||||
match self.agent_host.submit(text) {
|
||||
SubmitOutcome::Sent => {
|
||||
self.agent.clear_draft();
|
||||
self.agent_host.set_draft(String::new());
|
||||
self.drain_agent();
|
||||
}
|
||||
SubmitOutcome::Failed(failure) => {
|
||||
eprintln!("[agent] 提交失败（{}）", failure.code());
|
||||
}
|
||||
SubmitOutcome::Rejected => {
|
||||
eprintln!("[agent] presenter 拒收：空文本 / 上一轮未完 / 待确认 三闸该先挡住");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 抽干 presenter 的事件队列，**经既有 Message 通道**回流（见模块文档末节）。
|
||||
pub(crate) fn drain_agent(&mut self) {
|
||||
let events = self.agent_host.drain();
|
||||
if events.is_empty() {
|
||||
return;
|
||||
}
|
||||
let _ = self.on_agent(agent::Message::Events(events));
|
||||
}
|
||||
|
||||
/// 把「栏可见吗」写回 presenter（`navigate` + `prefs_mut` 两个窄入口，见 `AgentHost`）。
|
||||
pub(crate) fn sync_agent_presenter(&mut self) {
|
||||
let on_page = self.state.route() == &Route::Agent;
|
||||
let collapsed = self.agent.rail == RailState::Collapsed;
|
||||
self.agent_host.sync_visibility(on_page, collapsed);
|
||||
}
|
||||
|
||||
/// 失败横幅要显示的东西（`None` = 没有错误）。
|
||||
///
|
||||
/// 两个来源都取**展示输入**：具名原因码 → catalog 译文；或 presenter 已脱敏的这一轮原因。
|
||||
/// 壳在这一层不做任何脱敏（那是 presenter 的`scrub_text`），也不拼中英（那是 catalog 的事）。
|
||||
pub(crate) fn agent_failure(&self) -> Option<agent::Failure<'_>> {
|
||||
let catalog = self.lang().catalog();
|
||||
if let Some(failure) = self.agent_host.last_failure() {
|
||||
return Some(agent::Failure {
|
||||
title: TextKey::AgentErrorTitle,
|
||||
body: catalog.text(failure.body_key()),
|
||||
});
|
||||
}
|
||||
self.agent_host
|
||||
.rail()
|
||||
.error
|
||||
.as_deref()
|
||||
.map(|body| agent::Failure {
|
||||
title: TextKey::AgentErrorTitle,
|
||||
body,
|
||||
})
|
||||
}
|
||||
|
||||
/// 待确认请求出现 ⇒ 焦点直接落在「允许」；消失 ⇒ 收回输入框。
|
||||
///
|
||||
/// **只挪焦点，不替用户打开键盘巡航**（M119 r2 / 复审 P2-2）：r1 在这里顺手把
|
||||
/// `keyboard_mode` 置真，而 `sync_confirm_focus` 是 `on_agent` 的无条件尾巴、`Events` 又由心跳
|
||||
/// 驱动——于是只要冒出待确认，全局键盘闸就被打开；用户发完那句话接着打下一句，第一个空格
|
||||
/// 就成了「批准写操作」。现在那道闸只由真实的键盘表态打开（`Tab`，见 `AgentUi::step_focus`；
|
||||
/// 或者 `on_agent_key` 把按键送进来时用户本来就在键盘巡航）。
|
||||
///
|
||||
/// 键盘用户怎么走到确认条：待确认时焦点已经在这两个按钮上，**按一次 `Tab` 点亮焦点环即是
|
||||
/// 表态**（`step_focus` 里那条 arming 规则：这一次不移动焦点），之后 `Enter`/`Space` 就能裁决。
|
||||
///
|
||||
/// 唯一写入口：`on_agent` 末尾（任何会改动 rail 的分支之后都要经过它）。
|
||||
fn sync_confirm_focus(&mut self) {
|
||||
let pending = self.agent_host.rail().confirm.is_some();
|
||||
let on_confirm = matches!(self.agent.focus, Focus::ConfirmAllow | Focus::ConfirmDeny);
|
||||
if pending && !on_confirm {
|
||||
self.agent.focus = Focus::ConfirmAllow;
|
||||
eprintln!("[agent] 写操作待确认 → 焦点落到 Allow（Tab 点亮焦点环后 Enter/Space 裁决）");
|
||||
} else if !pending && on_confirm {
|
||||
self.agent.focus = Focus::Composer;
|
||||
self.agent.keyboard_mode = false;
|
||||
}
|
||||
}
|
||||
|
||||
/// **不变式**：`route() == Route::Agent` ⟺ `agent.rail == RailState::Detached`（唯一同步点）。
|
||||
///
|
||||
/// 为什么需要它（复审 r1 的 P2-1，实测复现）：`agent.rail` 只在自己发 `Detach`/`Dock` 时变，
|
||||
/// 而路由还能从三条**别的**路径进 `Route::Agent`——左侧导航第五项、`pages::Message::Navigate`、
|
||||
/// `ULL_START_ROUTE=agent`。脱钩的后果：从导航进独立页时头部出现「Open assistant」（那是
|
||||
/// 「展开右栗」的意思）、标题旁挂着不化的未读胶囊、`Esc` 也收不走页面。
|
||||
///
|
||||
/// 两条对向规则：
|
||||
/// - **在**独立页上 ⇒ `Detached`（顺带按「拆出即读」清未读）；
|
||||
/// - **不在**独立页上而档位还是 `Detached`（用户从页上点了别的导航）⇒ 会话收回右栗（`dock()`），
|
||||
/// 否则会话会「两头都没有」：页走了、栏还是 0 宽。
|
||||
///
|
||||
/// 调用点只有一个：`App::refresh_view` 的开头。每一次路由变化都会经过它，于是**模型算宽度时**
|
||||
/// 与**画头部动作时**读到的永远是同一份档位。
|
||||
pub(crate) fn sync_agent_route(&mut self) {
|
||||
let on_page = self.state.route() == &Route::Agent;
|
||||
match (on_page, self.agent.rail) {
|
||||
(true, RailState::Detached) | (false, RailState::Collapsed | RailState::Expanded) => {}
|
||||
(true, _) => self.agent.detach(),
|
||||
(false, RailState::Detached) => self.agent.dock(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 启动时助手栏要做的三件事（从 `on_boot` 搬出来：那边只许留一行调用，复审 P3-6）。
|
||||
///
|
||||
/// 1. **窗口尺寸 adopt**：唯一真源是 `boot.rs` 开窗时用的那一个（`ULL_WINDOW_SIZE` + 最小尺寸
|
||||
/// 钳位）。`App::with_presenter` 只认识常量 1180×760，不 adopt 的话验收矩阵开 900 / 1520 的窗
|
||||
/// 时页面还按 1180 排版（窄窗里内容被裁）。
|
||||
/// 2. **取证夹具**（`ULL_AGENT_*`）：先落档位，再**跑一轮真提交**——夹具不造消息，消息只能
|
||||
/// 由 presenter 产生（M119 的口径，见 `pages/agent/demo.rs`）。
|
||||
/// 3. **拆出档直接落到独立页**：`ULL_AGENT_RAIL=detached`（以及将来持久化的偏好）时，会话就在
|
||||
/// 独立页里，启动后不该停在实例页。
|
||||
pub(super) fn boot_agent(&mut self) {
|
||||
let (window_size, _source) = crate::renderer::acceptance::window::window_size(
|
||||
(WINDOW_SIZE.width, WINDOW_SIZE.height),
|
||||
(MIN_SIZE.width, MIN_SIZE.height),
|
||||
);
|
||||
self.width = window_size.0;
|
||||
self.height = window_size.1;
|
||||
|
||||
if let Some((ui, fixture)) = demo::from_env() {
|
||||
self.agent = ui;
|
||||
// 先让 presenter 知道「栏现在看得见吗」，再跑提交，未读口径才对
|
||||
self.sync_agent_presenter();
|
||||
match fixture {
|
||||
Fixture::None => {}
|
||||
Fixture::Turn | Fixture::Unread => {
|
||||
let _ = self.agent_host.submit(demo::DEMO_QUESTION.to_string());
|
||||
self.drain_agent();
|
||||
}
|
||||
Fixture::Armed => {
|
||||
// 先跑一轮（写操作脚本会挂一个待确认），再按一次 `Tab`：
|
||||
// 待确认时这一下只 arm、不移动焦点（见 `AgentUi::step_focus` 的 arming 规则）
|
||||
let _ = self.agent_host.submit(demo::DEMO_QUESTION.to_string());
|
||||
self.drain_agent();
|
||||
let rail = self.agent_host.rail();
|
||||
let (busy, pending) = (rail.busy, rail.confirm.is_some());
|
||||
self.agent.step_focus(false, busy, pending);
|
||||
}
|
||||
Fixture::Focused => {
|
||||
let rail = self.agent_host.rail();
|
||||
let (busy, pending) = (rail.busy, rail.confirm.is_some());
|
||||
self.agent.step_focus(false, busy, pending);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if self.agent.rail == RailState::Detached && self.state.route() != &Route::Agent {
|
||||
eprintln!("[agent] rail=detached → Route::Agent");
|
||||
self.state.navigate(Route::Agent);
|
||||
// 直达独立页时不要再被「自动选中第一条实例」拉回详情页。
|
||||
self.auto_selected = true;
|
||||
}
|
||||
}
|
||||
|
||||
/// 键盘订阅来的按键（`app/subscription.rs` 把整条键盘事件搬过来，解释权在这一层）。
|
||||
///
|
||||
/// 为什么不让订阅层直接翻成三个枚举：那样 `Escape`/`Tab`/`Enter` 的语义（什么状态下该做什么）
|
||||
/// 会散在订阅表里；这里一眼能看完。
|
||||
fn on_agent_key(&mut self, event: iced::keyboard::Event) -> Task<Message> {
|
||||
let iced::keyboard::Event::KeyPressed { key, modifiers, .. } = event else {
|
||||
return Task::none();
|
||||
};
|
||||
|
||||
let message = match key {
|
||||
Key::Named(key::Named::Escape) => agent::Message::Escape,
|
||||
// 折叠档没有会话动作可巡航，`Tab` 不该被助手栏吃掉
|
||||
Key::Named(key::Named::Tab) if self.agent.rail == RailState::Collapsed => {
|
||||
return Task::none();
|
||||
}
|
||||
Key::Named(key::Named::Tab) => agent::Message::Tab {
|
||||
shift: modifiers.shift(),
|
||||
},
|
||||
// `Activate` 只在软焦点落在**按钮**上时才动手（输入框的 Enter 由
|
||||
// `text_editor::key_binding` 分流成「发送」，不能在这里重复发一次）。
|
||||
//
|
||||
// M119 r1 / P2-2：`Space` 与 `Enter` 等价（键盘用户对确认条的习惯动作是空格）。
|
||||
// 它不会抢输入框里的空格：`activate_focused` 头一行就是 `keyboard_mode` 闸，
|
||||
// 而用鼠标点进输入框时那道闸是关的（`AgentUi::edit` 的 `Click` 分支）。
|
||||
Key::Named(key::Named::Enter | key::Named::Space) => agent::Message::Activate,
|
||||
_ => return Task::none(),
|
||||
};
|
||||
|
||||
self.on_agent(message)
|
||||
}
|
||||
|
||||
/// `Esc` / `⌄`：展开 → 收起；独立页 → 收回右栗并离开 `Route::Agent`。
|
||||
fn collapse_agent(&mut self) {
|
||||
let was_detached = self.agent.rail == RailState::Detached;
|
||||
self.agent.collapse();
|
||||
if was_detached {
|
||||
self.leave_agent_page();
|
||||
}
|
||||
}
|
||||
|
||||
/// 离开 AI 独立页：能回退就回退（`Detach` 是压栈的），否则回实例页。
|
||||
fn leave_agent_page(&mut self) {
|
||||
if self.state.route() != &Route::Agent {
|
||||
return;
|
||||
}
|
||||
if !self.state.back() {
|
||||
self.state.navigate(Route::Instances);
|
||||
}
|
||||
}
|
||||
|
||||
/// 键盘 `Enter`：激活软焦点上的按钮（`Tab` 环的顺序见 [`Focus`]）。
|
||||
///
|
||||
/// 焦点在 [`Focus::Composer`] 上时**什么都不做**：那一条路径由输入框自己的 `key_binding`
|
||||
/// 负责（按 `Tab` 走到输入框并不等于真的把 iced 焦点交过去，两次发送会打架）。
|
||||
fn activate_focused(&mut self, catalog: Catalog) {
|
||||
// 鼠标刚点过输入框（或从没按过 `Tab`）⇒ 这个 Enter 不归助手栏管
|
||||
if !self.agent.keyboard_mode {
|
||||
return;
|
||||
}
|
||||
|
||||
let intent = match (self.agent.rail, self.agent.focus) {
|
||||
(RailState::Collapsed, Focus::Collapse) => Some(agent::Message::Expand),
|
||||
(RailState::Expanded, Focus::Collapse) => Some(agent::Message::Collapse),
|
||||
(RailState::Expanded, Focus::Detach) | (RailState::Detached, Focus::Detach) => {
|
||||
Some(if self.agent.rail == RailState::Detached {
|
||||
agent::Message::Dock
|
||||
} else {
|
||||
agent::Message::Detach
|
||||
})
|
||||
}
|
||||
(_, Focus::ConfirmAllow) => Some(agent::Message::Confirm(true)),
|
||||
(_, Focus::ConfirmDeny) => Some(agent::Message::Confirm(false)),
|
||||
(_, Focus::Send) => Some(agent::Message::Submit),
|
||||
(_, Focus::Stop) => Some(agent::Message::Stop),
|
||||
// 折叠档没有「拆出」、独立页没有「收起」：焦点环按 `Focus::order` 不会落到这两格，
|
||||
// 显式列成 None 只是为了让编译器确认这份 intent 表是穷尽的。
|
||||
(RailState::Collapsed, Focus::Detach)
|
||||
| (RailState::Detached, Focus::Collapse)
|
||||
| (_, Focus::Composer) => None,
|
||||
};
|
||||
|
||||
if let Some(message) = intent {
|
||||
let _ = self.on_agent(message);
|
||||
} else {
|
||||
// 「不得静默无反应」：焦点在输入框上按 Enter 由输入框自己处理，这里只留一行日志。
|
||||
eprintln!(
|
||||
"[agent] Enter on focus={} handled by the composer",
|
||||
self.agent.focus.name()
|
||||
);
|
||||
let _ = catalog;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,352 @@
|
||||
//! **树测试①（M119 验收核心）**：AI 右栏在**真实 presenter 状态**下渲染。
|
||||
//!
|
||||
//! 走的是同一条用户路径：`Message::Agent(Submit)` → `AgentHost::submit` → `Presenter::agent_submit`
|
||||
//! → transport → 事件队列 → `Message::Agent(Events)` → `Presenter::apply` → `AgentRail`。
|
||||
//! **没有一条断言看本地数组**：`transcript` 这类壳自己的会话副本 M119 已经删了，能断言的只剩
|
||||
//! presenter 的 rail，而 rail 正是右栏画的东西（`pages/agent::spec` 从它借）。
|
||||
//!
|
||||
//! 覆盖任务书点名的四件事：
|
||||
//!
|
||||
//! | 断言 | 抓得住什么 |
|
||||
//! |---|---|
|
||||
//! | 提交后 rail 出现「你 + 助手」两条、正文来自事件的流式增量 | 提交没接到 presenter、或右栏还在画样本会话 |
|
||||
//! | `busy` 翻真 → 收敛后翻假 | 事件没回流、或流式标记没收敛（输入框会永远禁用） |
|
||||
//! | 标记已读后未读归零 | `agent_mark_read` 没接、或未读口径没跟着 rail |
|
||||
//! | 三种失败都给**具名**横幅 | 失败被吞掉（M104 的「静默无语」）|
|
||||
|
||||
use iced::widget::text_editor;
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_i18n::{Catalog, Key, Lang};
|
||||
use unlucky_presenter::dto::{AgentEvent, AppEvent, ChatRole};
|
||||
use unlucky_presenter::mock::MockBackend;
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
|
||||
use iced::keyboard::key::{Code, Named, Physical};
|
||||
use iced::keyboard::{key, Location, Modifiers};
|
||||
|
||||
use crate::app::state::presenter::transport::Script;
|
||||
use crate::app::state::presenter::AgentHost;
|
||||
use crate::app::Message;
|
||||
use crate::cli::Options;
|
||||
use crate::shell::agent::{Focus, Message as AgentMessage, RailState};
|
||||
use crate::theme::Families;
|
||||
|
||||
use super::App;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
/// 不碰磁盘的 App（mock 后端 + 内存设置桥 + **本脚本的** presenter 句柄）。
|
||||
fn app_with(script: Script) -> App {
|
||||
let mut app = App::with_presenter(
|
||||
Options::default(),
|
||||
FAMILIES,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(MockBackend::new()),
|
||||
SettingsBridge::memory_only(),
|
||||
);
|
||||
app.agent_host = AgentHost::with_script(script);
|
||||
// 换句柄 = 可见性还没写回去；`refresh_view` 是那条单点同步
|
||||
app.refresh_view();
|
||||
app
|
||||
}
|
||||
|
||||
/// 走真消息提交（用户路径：填草稿 → 点发送）。
|
||||
fn submit(app: &mut App, text: &str) {
|
||||
app.agent.draft = text_editor::Content::with_text(text);
|
||||
let _ = app.update(Message::Agent(AgentMessage::Submit));
|
||||
}
|
||||
|
||||
/// **提交 → 事件回流 → 右栏出现这一轮 → 标记已读归零**（任务书第 2 条）。
|
||||
///
|
||||
/// 抓得住：①`Submit` 没接 `agent_submit`（rail 空）；②事件没经 Message 通道回流（rail 只有半截）；
|
||||
/// ③`expand` 没调 `agent_mark_read`（未读不清）；④右栏读的还是壳自己的副本。
|
||||
/// 抓不住：气泡在像素上长什么样（那要出图，见 `DevDocs/artifacts/m119/`）。
|
||||
#[test]
|
||||
fn a_submitted_turn_lands_in_the_rail_and_reading_it_zeroes_unread() {
|
||||
let mut app = app_with(Script::Qa);
|
||||
// 出厂是折叠档 ⇒ presenter 认为「用户没在看着」，到达的助手消息应计未读
|
||||
assert_eq!(app.agent.rail, RailState::Collapsed);
|
||||
assert_eq!(app.agent_host.rail().unread, 0, "空会话没有未读");
|
||||
|
||||
submit(&mut app, "Which instance should I start?");
|
||||
|
||||
let rail = app.agent_host.rail();
|
||||
assert_eq!(
|
||||
rail.messages.len(),
|
||||
2,
|
||||
"一条「你」+ 一条助手（事件产生，不是本地回显）"
|
||||
);
|
||||
assert_eq!(rail.messages[0].role, ChatRole::User);
|
||||
assert_eq!(rail.messages[0].text, "Which instance should I start?");
|
||||
assert_eq!(rail.messages[1].role, ChatRole::Assistant);
|
||||
assert!(
|
||||
rail.messages[1].text.contains("Fabric"),
|
||||
"正文来自流式增量：{:?}",
|
||||
rail.messages[1].text
|
||||
);
|
||||
assert!(!rail.messages[1].streaming, "Qa 脚本会收敛");
|
||||
assert!(!rail.busy, "收敛之后不忙（发送键要能再按）");
|
||||
assert_eq!(rail.unread, 1, "折叠态到达的一条助手消息 = 一条未读");
|
||||
|
||||
// 右栏画的正是这份 rail（`pages/agent::spec` 直接借它）——构图不 panic
|
||||
let _ = app.view();
|
||||
|
||||
// 打开栏 = 读过：`agent_mark_read`
|
||||
let _ = app.update(Message::Agent(AgentMessage::Expand));
|
||||
assert_eq!(app.agent_host.rail().unread, 0, "标记已读后未读归零");
|
||||
assert_eq!(app.agent_host.rail().messages.len(), 2, "已读不改会话");
|
||||
}
|
||||
|
||||
/// **busy 正确翻转**：流式中忙 → 后端收敛后不忙。
|
||||
///
|
||||
/// 抓得住：`busy` 还由壳自己算（那它不会跟 rail 走）；`Events` 通道被当成「只追加消息」而丢掉
|
||||
/// `MessageFinished`（输入框会永远禁用——这是最要命的坏法之一）。
|
||||
#[test]
|
||||
fn busy_flips_with_the_backend_events() {
|
||||
let mut app = app_with(Script::Streaming);
|
||||
submit(&mut app, "hello");
|
||||
assert!(app.agent_host.rail().busy, "流式没收敛前输入要禁用");
|
||||
|
||||
// 后端收敛：一条 `MessageFinished` 经同一条 Message 通道回流
|
||||
let index = app.agent_host.rail().messages.len() - 1;
|
||||
let _ = app.update(Message::Agent(AgentMessage::Events(vec![AppEvent::Agent(
|
||||
AgentEvent::MessageFinished { index },
|
||||
)])));
|
||||
assert!(!app.agent_host.rail().busy, "收敛之后必须能再发");
|
||||
}
|
||||
|
||||
/// 写操作确认：rail 上有待确认 ⇒ 忙；裁决后收敛并记一条审计。
|
||||
#[test]
|
||||
fn a_pending_write_op_is_visible_and_decidable() {
|
||||
let mut app = app_with(Script::WriteOp);
|
||||
submit(&mut app, "把下载并发改小");
|
||||
|
||||
let rail = app.agent_host.rail();
|
||||
let request = rail.confirm.as_ref().expect("要挂一个待确认请求");
|
||||
assert_eq!(request.tool, "set_config");
|
||||
assert!(
|
||||
rail.busy,
|
||||
"等确认也算忙（否则用户能在一轮写操作中间再发一句）"
|
||||
);
|
||||
let _ = app.view();
|
||||
|
||||
let _ = app.update(Message::Agent(AgentMessage::Confirm(true)));
|
||||
assert!(app.agent_host.rail().confirm.is_none(), "裁决后清空");
|
||||
assert!(!app.agent_host.rail().busy);
|
||||
assert_eq!(app.agent_host.audit_len(), 1, "裁决要进审计（YOLO 下也是）");
|
||||
}
|
||||
|
||||
/// 失败态①：**AI 端点不可达** ⇒ 具名横幅（不是静默，也不是把后端原文糊上屏）。
|
||||
#[test]
|
||||
fn an_unreachable_endpoint_shows_a_named_error() {
|
||||
let mut app = app_with(Script::Unreachable);
|
||||
submit(&mut app, "hello");
|
||||
|
||||
let failure = app.agent_failure().expect("提交失败必须给横幅");
|
||||
// 文案跟着**生效语言**走（`LangState` 在这台机器上探到 zh-CN，硬编码英文会假红）
|
||||
let effective = app.lang().catalog();
|
||||
assert_eq!(failure.title, Key::AgentErrorTitle, "标题是 catalog 键");
|
||||
assert_eq!(failure.body, effective.text(Key::AgentErrorUnavailable));
|
||||
assert!(!failure.body.trim().is_empty());
|
||||
assert!(
|
||||
app.agent_host.rail().messages.is_empty(),
|
||||
"失败不产生消息：不许假装有回复"
|
||||
);
|
||||
let _ = app.view();
|
||||
}
|
||||
|
||||
/// 失败态②：**未实现路由** ⇒ 另一句具名错误（两种失败不能糊成一句）。
|
||||
#[test]
|
||||
fn an_unimplemented_route_shows_its_own_named_error() {
|
||||
let mut app = app_with(Script::NotImplemented);
|
||||
submit(&mut app, "hello");
|
||||
|
||||
let failure = app.agent_failure().expect("必须给横幅");
|
||||
let effective = app.lang().catalog();
|
||||
assert_eq!(failure.body, effective.text(Key::AgentErrorNotImplemented));
|
||||
// 两条原因码要两句话（中英两套都得分开），不是一句万能错误
|
||||
for lang in [Lang::En, Lang::ZhCn] {
|
||||
let catalog = Catalog::of(lang);
|
||||
assert_ne!(
|
||||
catalog.text(Key::AgentErrorNotImplemented),
|
||||
catalog.text(Key::AgentErrorUnavailable),
|
||||
"{} 下两条原因码糊成一句了",
|
||||
lang.tag()
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 失败态③：**这一轮回复中途断流** ⇒ 横幅用 presenter 已脱敏的那句原因，已到的增量保留。
|
||||
#[test]
|
||||
fn a_turn_level_failure_keeps_the_partial_answer_and_the_reason() {
|
||||
let mut app = app_with(Script::FailsMidStream);
|
||||
submit(&mut app, "读一下日志");
|
||||
|
||||
let rail = app.agent_host.rail();
|
||||
// 用户 + 助手（流式占位）+ 系统条目（`Failed` 会额外追加一条，错误也要能回翻）
|
||||
assert_eq!(rail.messages.len(), 3, "断流不撤销已到的增量");
|
||||
assert!(
|
||||
rail.messages[1].text.contains("日志"),
|
||||
"已到的增量要留着：{:?}",
|
||||
rail.messages[1].text
|
||||
);
|
||||
assert!(!rail.busy, "断流要收敛掉流式标记");
|
||||
let failure = app.agent_failure().expect("`Failed` 事件要立横幅");
|
||||
assert!(
|
||||
failure.body.contains("read timeout"),
|
||||
"横幅正文是 presenter 脱敏后的原因：{}",
|
||||
failure.body
|
||||
);
|
||||
}
|
||||
|
||||
/// 输入框的草稿会同步给 presenter（切形态不丢的语义在 presenter 那边）。
|
||||
/// **P2-1**：默认配置下后端是脚本化 rig ⇒ 视图必须知道「这是模拟」（界面据此常驻标记）。
|
||||
///
|
||||
/// 抓得住：`is_simulated` 被写死成 `false`、或者视图拿不到这个事实（用户就会以为模型接上了）。
|
||||
/// 抓不住：标记在像素上长什么样（那要出图，见 `DevDocs/artifacts/m119/08-*`）。
|
||||
#[test]
|
||||
fn the_default_backend_reports_itself_as_simulated() {
|
||||
let app = app_with(Script::Qa);
|
||||
assert!(
|
||||
app.agent_host.is_simulated(),
|
||||
"脚本化 rig 必须自报「模拟」，否则界面就能假装模型接上了"
|
||||
);
|
||||
// 空会话（最容易被误读成一屏）也要能拿到：视图入参 `Session.simulated` 就是它
|
||||
let session = crate::shell::agent::Session {
|
||||
agent: &app.agent,
|
||||
rail: app.agent_host.rail(),
|
||||
failure: app.agent_failure(),
|
||||
simulated: app.agent_host.is_simulated(),
|
||||
};
|
||||
assert!(session.simulated);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn typing_syncs_the_draft_into_the_presenter() {
|
||||
let mut app = app_with(Script::Qa);
|
||||
app.agent.draft = text_editor::Content::with_text("half typed");
|
||||
let _ = app.update(Message::Agent(AgentMessage::Edit(
|
||||
text_editor::Action::Edit(text_editor::Edit::Insert('!')),
|
||||
)));
|
||||
assert_eq!(
|
||||
app.agent_host.rail().draft,
|
||||
app.agent.draft.text(),
|
||||
"编辑器里是什么，rail 上就该是什么（同一个串，不是它自己的副本）"
|
||||
);
|
||||
assert!(app.agent_host.rail().draft.contains('!'), "改动真的进去了");
|
||||
// 发送成功后草稿两边都清空
|
||||
let _ = app.update(Message::Agent(AgentMessage::Submit));
|
||||
assert!(app.agent.draft_is_blank(), "编辑器清空");
|
||||
assert!(app.agent_host.rail().draft.is_empty(), "presenter 侧也清空");
|
||||
}
|
||||
|
||||
/// 手搓一条按键事件（订阅层搬过来的就是它；`on_agent_key` 只看 `KeyPressed`）。
|
||||
fn press(named: key::Named) -> iced::keyboard::Event {
|
||||
let key = key::Key::Named(named);
|
||||
iced::keyboard::Event::KeyPressed {
|
||||
key: key.clone(),
|
||||
modified_key: key,
|
||||
physical_key: Physical::Code(Code::Enter),
|
||||
location: Location::Standard,
|
||||
modifiers: Modifiers::default(),
|
||||
text: None,
|
||||
repeat: false,
|
||||
}
|
||||
}
|
||||
|
||||
/// **P2-2 的回归闸**：不碰鼠标、只用键盘消息，能完成一次写操作确认。
|
||||
///
|
||||
/// 为什么这条重要：确认条原本只有鼠标路径，而待确认时 `busy` 锁着发送、`Stop` 又走主后端
|
||||
/// （清不掉 presenter 的 pending）——键盘用户会在这一步**永久卡死**。
|
||||
///
|
||||
/// 抓得住：①焦点没主动落到确认条（`Enter` 够不着）；②`Enter` / `Space` 没映射成 `Activate`；
|
||||
/// ③`Tab` 环里没有确认条那两格；④裁决完焦点没收回输入框（下一句话打不进去）。
|
||||
/// 抓不住：焦点环在像素上的样子（那要出图，见 `DevDocs/artifacts/m119/09-*`）。
|
||||
#[test]
|
||||
fn a_blocking_confirm_can_be_decided_with_the_keyboard_alone() {
|
||||
let mut app = app_with(Script::WriteOp);
|
||||
submit(&mut app, "把下载并发改小");
|
||||
assert!(
|
||||
app.agent_host.rail().confirm.is_some(),
|
||||
"先要有一个待确认请求"
|
||||
);
|
||||
// ① 焦点主动落在「允许」（阻塞态），但**键盘闸不替用户打开**（复审 r2 / P2-2）
|
||||
assert_eq!(
|
||||
app.agent.focus,
|
||||
Focus::ConfirmAllow,
|
||||
"焦点要落在可操作元素上"
|
||||
);
|
||||
assert!(
|
||||
!app.agent.keyboard_mode,
|
||||
"塔台 r2：不许自动 arm——自动 arm 会让用户随手敲的空格变成「批准」"
|
||||
);
|
||||
|
||||
// ② 第一次 Tab = 「我要用键盘」的表态：只点亮焦点环，**不移动**焦点
|
||||
let _ = app.update(Message::Agent(AgentMessage::Tab { shift: false }));
|
||||
assert!(app.agent.keyboard_mode, "Tab 之后才算 armed");
|
||||
assert_eq!(
|
||||
app.agent.focus,
|
||||
Focus::ConfirmAllow,
|
||||
"arming 的那一次不移动焦点（否则 Enter 会反着裁决）"
|
||||
);
|
||||
|
||||
// ③ Enter = 允许
|
||||
let _ = app.update(Message::Agent(AgentMessage::Key(press(Named::Enter))));
|
||||
assert!(
|
||||
app.agent_host.rail().confirm.is_none(),
|
||||
"Enter 必须真的裁决掉"
|
||||
);
|
||||
assert_eq!(app.agent_host.audit_len(), 1, "裁决进审计");
|
||||
assert_eq!(app.agent.focus, Focus::Composer, "裁决完焦点收回输入框");
|
||||
assert!(!app.agent.keyboard_mode, "阻塞态结束就不再亮焦点环");
|
||||
|
||||
// ④ 第二轮走「Tab 点环 → Tab 走到拒绝 → Space 触发」：键盘用户不必背 Enter 是哪一个
|
||||
submit(&mut app, "那把并发改回来");
|
||||
assert_eq!(app.agent.focus, Focus::ConfirmAllow);
|
||||
let _ = app.update(Message::Agent(AgentMessage::Tab { shift: false }));
|
||||
let _ = app.update(Message::Agent(AgentMessage::Tab { shift: false }));
|
||||
assert_eq!(app.agent.focus, Focus::ConfirmDeny, "Tab 要能走到「拒绝」");
|
||||
let _ = app.update(Message::Agent(AgentMessage::Key(press(Named::Space))));
|
||||
assert!(app.agent_host.rail().confirm.is_none(), "Space 也要能裁决");
|
||||
assert_eq!(app.agent_host.audit_len(), 2);
|
||||
}
|
||||
|
||||
/// **复审 r2 / P2-2 的反向回归**：没 armed 的时候，空格与回车都不许裁决写操作。
|
||||
///
|
||||
/// 复审用临时用例复现的路径：WriteOp 提交后（r1 无条件 arm），用户接着打下一句，第一个空格就成了
|
||||
/// 「允许」。真实场景里编辑器仍持 iced 焦点，所以这条不是理论问题。
|
||||
///
|
||||
/// 抓得住：谁把 `sync_confirm_focus` 里的 `keyboard_mode = true` 加回来；谁把 `Space`/`Enter` 的
|
||||
/// `Activate` 绕到 `keyboard_mode` 闸之外。
|
||||
/// 抓不住：iced 组件树里空格到底有没有进输入框（那要真窗口，出图另算）——这里只断言「没裁决」。
|
||||
#[test]
|
||||
fn a_stray_space_or_enter_never_approves_a_pending_write() {
|
||||
let mut app = app_with(Script::WriteOp);
|
||||
submit(&mut app, "把下载并发改小");
|
||||
assert!(app.agent_host.rail().confirm.is_some());
|
||||
assert!(!app.agent.keyboard_mode, "待确认不该自动 arm");
|
||||
|
||||
// 用户接着打下一句：先敲一个字符（编辑器自己消化），再敲空格
|
||||
let _ = app.update(Message::Agent(AgentMessage::Edit(
|
||||
text_editor::Action::Edit(text_editor::Edit::Insert('a')),
|
||||
)));
|
||||
let _ = app.update(Message::Agent(AgentMessage::Key(press(Named::Space))));
|
||||
assert!(
|
||||
app.agent_host.rail().confirm.is_some(),
|
||||
"未 armed 时空格不许批准写操作"
|
||||
);
|
||||
assert_eq!(app.agent_host.audit_len(), 0, "也不许留下审计");
|
||||
|
||||
// 回车同理：未 armed 时它归编辑器（发送键），不归确认条
|
||||
let _ = app.update(Message::Agent(AgentMessage::Key(press(Named::Enter))));
|
||||
assert!(
|
||||
app.agent_host.rail().confirm.is_some(),
|
||||
"未 armed 时回车不许批准写操作"
|
||||
);
|
||||
assert_eq!(app.agent_host.audit_len(), 0);
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
//! M116：窗口圆角的下发落点（`impl App::apply_window_corner`）。
|
||||
//!
|
||||
//! ## 为什么单独成文件
|
||||
//!
|
||||
//! 圆角与整窗 α 是**两条独立的管线**，只是都必须拿到 HWND、都在同一个时点下发：
|
||||
//!
|
||||
//! | 管线 | 判据 | 落点 | 键 |
|
||||
//! |---|---|---|---|
|
||||
//! | 整窗 α（D36） | `platform::effective_window_alpha` | `SetLayeredWindowAttributes` | `appearance.window_opacity` |
|
||||
//! | 圆角（M116） | `platform::plan_corner` | `DwmSetWindowAttribute` | `appearance.window_corner` |
|
||||
//!
|
||||
//! 合在一个函数里会让「α 变了要不要重设圆角」这种问题变成实现细节；分开之后两个判据各自可测。
|
||||
//!
|
||||
//! ## 日志为什么是**一行、六栏**
|
||||
//!
|
||||
//! `corner=policy=… source=dwm|square os=… excluded_reason=… radius=system pref=… readback=… frame=… layered=…`
|
||||
//!
|
||||
//! 用户报的现象是「别的窗口都有圆角，只有我们的没有」。没有这一行，事后无法区分
|
||||
//! 「没生效」「生效了但看不见」「这台系统根本没有这个能力」；`frame` / `layered` 两栏则是
|
||||
//! 「圆角为什么不生效」的两个现场读数：`frame=`（窗口形状）与 `layered=`（整窗 α 引入的分层位）。
|
||||
//!
|
||||
//! ⚠️ **产品窗口不是 `WS_POPUP`**（M116 r4 复审订正）：winit 在 `decorations = false` 下给的是
|
||||
//! `WS_CAPTION|WS_BORDER|WS_CLIPSIBLINGS|WS_SYSMENU`（可缩放时再加 `WS_THICKFRAME` 与 min/max 键），
|
||||
//! `WS_POPUP` 只在**带 owner** 的弹出窗才加；无边框观感来自 `WM_NCCALCSIZE` 把客户区铺满。
|
||||
//! 所以真进程日志里 `frame=` 应是 `overlapped`（关掉 min/max 则 `other`），**永远不会是 `popup`**。
|
||||
//! 真正让系统忽略圆角请求的是**整窗 α 补的 `WS_EX_LAYERED`**（`layered=on`）。
|
||||
//!
|
||||
//! `radius=system` 是刻意的：系统不暴露 DWM 的圆角半径，我们也不自己定一个数字
|
||||
//! （M116 取消了 8/12/16 固定档）。
|
||||
|
||||
use crate::platform;
|
||||
use crate::platform::win32::corner::{self, CornerApplied};
|
||||
use crate::platform::win32::transparency::{apply_corner, style_summary, CornerOutcome};
|
||||
|
||||
use super::super::state::App;
|
||||
|
||||
impl App {
|
||||
/// 把当前圆角策略下发到窗口，并打一行可分辨的日志。
|
||||
///
|
||||
/// ## 去重（M116 r1 复审 P2-4）
|
||||
///
|
||||
/// 设置页的滑条（整窗 α / 面板 α / 暗化）每动一下都会走一次外观变更，而<b>圆角与那些键无关</b>。
|
||||
/// 判定完全没变时这里**直接返回**：不动窗口、不打日志。判据是
|
||||
/// [`corner::needs_redispatch`]（纯函数，有「同一策略 N 次只记 1 行」的测试），
|
||||
/// 指纹只含「策略 / 来源 / 原因码 / 有没有句柄」，不含只有真下发才拿得到的读数。
|
||||
///
|
||||
/// 没有句柄时**也打日志**（`window=none`）：不能让「没生效」只体现为屏幕上没变化。
|
||||
/// 句柄从无到有会让指纹变化 ⇒ 首次拿到 HWND 时必然重下一次。
|
||||
pub(crate) fn apply_window_corner(&mut self, context: &str) {
|
||||
let policy = self.appearance.window_corner();
|
||||
let plan = platform::plan_corner(
|
||||
policy,
|
||||
platform::current_windows_version(),
|
||||
self.appearance.backend,
|
||||
);
|
||||
// 整窗 α < 1 ⇒ `window_alpha::dispatch` 会给窗口补 `WS_EX_LAYERED`；系统因此忽略圆角请求
|
||||
// （tower 裁定 A / D47）。这里只记**事实**：α 是否把我们自己的分层位打开了。
|
||||
let alpha_layered = self.appearance.window_opacity < 1.0;
|
||||
let suppressed_by = alpha_layered.then_some("window_alpha");
|
||||
let next = CornerApplied::new(policy, &plan, self.hwnd.is_some(), alpha_layered);
|
||||
if !corner::needs_redispatch(self.corner_applied.as_ref(), &next) {
|
||||
return;
|
||||
}
|
||||
self.corner_applied = Some(next);
|
||||
|
||||
// 行的形状只有一处（`corner::format_line`），因为那里能在没有窗口的环境里被单测钉住。
|
||||
// 关键的三栏必须在同一行：`pref=`（请求发出去了）、`layered=`（分层位在不在，来自
|
||||
// 整窗 α）、`frame=`（窗口形状 = `overlapped`，不是 `popup`）——否则以后只能猜是哪一条。
|
||||
let (outcome, style) = match self.hwnd {
|
||||
Some(hwnd) => (apply_corner(hwnd, &plan).describe(), style_summary(hwnd)),
|
||||
None => (
|
||||
CornerOutcome::NoWindow.describe(),
|
||||
"frame=? layered=?".to_owned(),
|
||||
),
|
||||
};
|
||||
eprintln!(
|
||||
"{}",
|
||||
corner::format_line(context, &plan, policy, &outcome, &style, suppressed_by)
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
//! 启动期的取证环境变量解析（`ULL_START_ROUTE`）。
|
||||
//!
|
||||
//! 从 `app/update.rs` 原样搬出（那个文件在 M105/M106/M109/M113 之后贴着 400 行硬线）：
|
||||
//! **纯函数、无状态**，只是取值表长到了七条。
|
||||
|
||||
use unlucky_presenter::router::Route;
|
||||
|
||||
/// 取证开关 `ULL_START_ROUTE` 的取值解析（`settings` / `instances` / `download` / `content` / `logs`）。
|
||||
///
|
||||
/// 为什么是环境变量：`crates/app-iced/src/cli.rs` 不在 M93 的 scope，而外观矩阵必须在**设置页**上
|
||||
/// 出图。语义与 `ULL_APPEARANCE_*` / `ULL_TICK_TRACE` 一致：只影响这一次进程。
|
||||
pub(super) fn env_start_route() -> Option<Route> {
|
||||
match std::env::var("ULL_START_ROUTE").ok()?.trim() {
|
||||
"instances" => Some(Route::Instances),
|
||||
"download" => Some(Route::Download),
|
||||
"logs" => Some(Route::Logs),
|
||||
"settings" => Some(Route::Settings),
|
||||
// M104：AI 独立页也要能直达（三态矩阵的 Detached 那张）
|
||||
"agent" => Some(Route::Agent),
|
||||
// M109：内容库（截图矩阵要能直达；页面内的四条侧栏不在路由里）
|
||||
"content" => Some(Route::Content),
|
||||
// M114：账户页的 D30 矩阵要能直达（`cli.rs` 不在本 mission 的 scope）
|
||||
"accounts" => Some(Route::Accounts),
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,143 @@
|
||||
//! 节拍：推进一拍 / 派发指令 / 抽干事件（M119 从 `update.rs` 拆出来守 400 行硬线；纯搬不改）。
|
||||
//!
|
||||
//! ## 为什么这三件必须在一起
|
||||
//!
|
||||
//! `advance` → `pump` → `apply` → `refresh_view` 是同一条链：时间推进、事件抽干、状态落地、
|
||||
//! 视图重建。拆开看每一段都无害，合起来才是「presenter 的异步事件在 UI 侧怎么被消费」的答案。
|
||||
//!
|
||||
//! ## 两个时钟的相位（M90 r3 / P2-2 的老账，代码里有细节）
|
||||
//!
|
||||
//! | 场景 | 时钟 | 周期 |
|
||||
//! |---|---|---|
|
||||
//! | 截图 / 有 Busy-Running 实例 / 有 toast / 派发后 3 s 观察窗 | `window::frames()` + 闸门 | 33 ms |
|
||||
//! | 其余（空闲） | `Heartbeat` 自续链 | 1 s |
|
||||
//!
|
||||
//! ## M119 增加了什么
|
||||
//!
|
||||
//! [`App::pump`] 里多了一行 [`App::drain_agent`]：AI 助手的事件队列和 core 的事件队列同拍抽干，
|
||||
//! 于是「右栗的未读/流式状态」和页面快照共享同一个刷新节奏（不会一个 30 Hz、一个 1 Hz）。
|
||||
|
||||
use std::time::{Duration, Instant};
|
||||
|
||||
use unlucky_presenter::dto::AppCommand;
|
||||
use unlucky_presenter::theme::CONFIG_POLL_TICKS;
|
||||
|
||||
use super::super::state::TICK_MS;
|
||||
use super::*;
|
||||
|
||||
impl App {
|
||||
/// 推进一拍：后端消化时间 → 抽干事件 → 过期 toast → 偶发重读配置文件。
|
||||
///
|
||||
/// `elapsed` 是真实流逝时间（毫秒级抖动是正常的：`MockBackend` 的脚本按累计时长走）。
|
||||
pub(in crate::app) fn advance(&mut self, elapsed: Duration) {
|
||||
self.backend.tick(elapsed);
|
||||
self.pump();
|
||||
|
||||
self.state
|
||||
.toasts
|
||||
.expire(u64::try_from(elapsed.as_millis()).unwrap_or(u64::MAX));
|
||||
|
||||
// 设备码/授权码的倒计时（M114）：等待态每秒都要重画一次，否则「剩 900s」永远不动，
|
||||
// 用户会以为卡死了——这正是任务里「不得只转圈」的那一条。
|
||||
if self.state.device_login.phase == unlucky_presenter::dto::DeviceLoginPhase::Waiting {
|
||||
self.view_dirty = true;
|
||||
}
|
||||
// `ticks` 的单位是**33 ms 的一拍**，不是「advance 被调了几次」：空闲心跳一次跨 1 s，
|
||||
// 要记 30 拍，这样 `theme::config_poll_due`（30 拍 ≈ 1 秒）在两种时钟下语义一致。
|
||||
let ticks = elapsed.as_millis().div_euclid(u128::from(TICK_MS));
|
||||
let ticks = u64::try_from(ticks).unwrap_or(u64::MAX).max(1);
|
||||
let bucket_before = self.ticks / 30;
|
||||
self.ticks += ticks;
|
||||
let bucket_after = self.ticks / 30;
|
||||
|
||||
// 外部（AI / CLI）改了配置文件：主题跟着换，其余外观项等玻璃/背景 mission。
|
||||
//
|
||||
// 判据用**跨越**而不是 presenter 的 `config_poll_due(ticks)`（整除）：两个时钟的相位不同
|
||||
// （帧节拍按 33 ms 累加、空闲心跳按 30 拍累加），整除判定一旦错过一次就**再也命中不了**
|
||||
// ——实测 ticks=137 之后每拍 +30 永远不整除，配置轮询静默死掉。间隔真源仍是
|
||||
// `CONFIG_POLL_TICKS`（30 拍 × 33 ms ≈ 1 秒）。截图通道不轮询（D30 可复现）。
|
||||
let poll_due = self.ticks >= self.config_due_at;
|
||||
if poll_due {
|
||||
// 追到「当前 ticks 之后的第一个间隔点」，避免心跳把相位拖飞
|
||||
self.config_due_at = self.ticks + CONFIG_POLL_TICKS;
|
||||
}
|
||||
let reloaded =
|
||||
!self.has_screenshot() && poll_due && self.bridge.reload_if_changed().is_some();
|
||||
if reloaded {
|
||||
eprintln!("[settings] 配置文件变了，重读主题 + 外观");
|
||||
self.apply_config_theme();
|
||||
// M93：外观也热切（面板 α / 背景图 / 配色来源 / 整窗 α 都在里面）。
|
||||
self.reload_appearance();
|
||||
}
|
||||
|
||||
if self.view_dirty {
|
||||
self.refresh_view();
|
||||
}
|
||||
|
||||
// 取证开关（`ULL_TICK_TRACE=1`）：每跨过 30 拍（≈1 秒）打一行。
|
||||
// 忙碌态由帧节拍跨桶（≈1 行/秒），空闲态由心跳一次 +30 跨桶（**也是 1 行/秒**）——
|
||||
// 两种时钟都用同一把尺子，所以 trace 的密度本身就是「时钟在跑」的证据。
|
||||
if bucket_after != bucket_before && std::env::var_os("ULL_TICK_TRACE").is_some() {
|
||||
eprintln!(
|
||||
"[tick] n={} frames={} refreshes={} clock={}",
|
||||
self.ticks,
|
||||
self.frames,
|
||||
self.refreshes,
|
||||
if self.needs_frames() {
|
||||
"frames"
|
||||
} else {
|
||||
"idle-1hz"
|
||||
}
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 派发一条指令并**立刻**抽干它带出来的事件（不本地回显，等价于 Slint 版的 `dispatch`）。
|
||||
pub(in crate::app) fn dispatch(&mut self, command: AppCommand) {
|
||||
self.backend.dispatch(command);
|
||||
// 观察窗：命令发出后 3 秒内保持帧订阅，等后端把第一条事件交回来
|
||||
// （真 host 是异步的，派发瞬间状态还没变；不设这个窗口，空闲态的帧订阅永远不会打开）。
|
||||
self.watch_until = Some(Instant::now() + WATCH_WINDOW);
|
||||
self.pump();
|
||||
}
|
||||
|
||||
/// 抽干事件队列并逐条 `apply`（**唯一**的状态写入口）。
|
||||
pub(in crate::app) fn pump(&mut self) {
|
||||
// M119：AI 助手的事件队列与 core 的事件队列**同拍**抽干（顺序无关：两个队列互不依赖）。
|
||||
// 抽出来的这批事件经 `Message::Agent(Events)` 回流，见 `update/agent.rs`。
|
||||
self.drain_agent();
|
||||
|
||||
let events = self.backend.drain_events();
|
||||
if events.is_empty() {
|
||||
return;
|
||||
}
|
||||
for event in events {
|
||||
self.state.apply(event);
|
||||
}
|
||||
self.view_dirty = true;
|
||||
self.auto_select();
|
||||
self.refresh_view();
|
||||
}
|
||||
|
||||
/// 首屏快照到位后**自动选中第一行**（桌面 list-detail 的惯例：右栏不该开局就是空的）。
|
||||
///
|
||||
/// 只做一次：用户点「返回」回到列表后，再刷新实例列表也不会把他弹回详情页。
|
||||
/// 选中这件事走的是 `AppState::navigate`（路由栈），不是本地选中字段——于是「当前选中」
|
||||
/// 永远等于「路由栈顶」，用户点返回时栈语义自然成立。
|
||||
pub(in crate::app) fn auto_select(&mut self) {
|
||||
if self.auto_selected || self.state.route() != &Route::Instances {
|
||||
return;
|
||||
}
|
||||
let Some(first) = self
|
||||
.state
|
||||
.tiles()
|
||||
.first()
|
||||
.map(|cell| cell.instance.id.clone())
|
||||
else {
|
||||
return;
|
||||
};
|
||||
self.auto_selected = true;
|
||||
self.state.navigate(Route::Detail(first));
|
||||
self.view_dirty = true;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,339 @@
|
||||
//! 内容库页的消息落点（M109）：`pages::Message::Content(..)` 的穷尽分发。
|
||||
//!
|
||||
//! ## 两件事分开（与 `update/download.rs` 同一条纪律）
|
||||
//!
|
||||
//! | 意图 | 谁改状态 | 派指令吗 |
|
||||
//! |---|---|---|
|
||||
//! | 关键词草稿 / 选中项目 / 目标实例 | `App::content`（页面内选择） | 不派 |
|
||||
//! | 检索条件（类型/来源/排序/版本/加载器/关键词提交/翻页/重试） | `AppState::content`（presenter） | 派 `SearchContent` |
|
||||
//! | 装入 | 谁都不改 | 派 `InstallContent` |
|
||||
//!
|
||||
//! 「装入」不改本地状态是关键：装上的证据是 `InstallProgress` 事件回流到安装面板
|
||||
//! （`pages/download::install_panel`），页面自己不做乐观回显。
|
||||
//!
|
||||
//! ## 为什么条件写进 presenter 再派
|
||||
//!
|
||||
//! `AppState::content.query` 是「当前结果对应哪份条件」的唯一真相：结果回来时
|
||||
//! `apply_content` 用它判「迟到的事件要不要丢」。页面自己存一份就会有两份真相。
|
||||
|
||||
use unlucky_presenter::dto::{
|
||||
AppCommand, ContentInstallRequest, ContentQuery, ContentSource, ExportRequestView,
|
||||
ImportRequestView, PackCommand,
|
||||
};
|
||||
|
||||
use crate::pages::content::{Blocker, Content};
|
||||
|
||||
use super::*;
|
||||
|
||||
impl App {
|
||||
/// 进入内容库页时补一次检索（首个用户动作不该是「再点一下搜索」）。
|
||||
///
|
||||
/// 判据是 `AppState::content` 里还没有结果、也没有请求在飞：重复进出不重复打网络。
|
||||
pub(super) fn ensure_content_loaded(&mut self) {
|
||||
if self.state.content.results.is_some() || self.state.content.pending {
|
||||
return;
|
||||
}
|
||||
let query = ContentQuery::first(self.content.kind);
|
||||
self.search_content(query);
|
||||
}
|
||||
|
||||
/// 页面消息（穷尽分发：漏一支报 E0004）。
|
||||
pub(super) fn on_content(&mut self, message: pages::content::Message) -> Task<Message> {
|
||||
match message {
|
||||
pages::content::Message::SetKind(kind) => {
|
||||
// 换类型 = 换一份条件（facet 全变）：选中项作废，条件回到该类型的首页
|
||||
self.content.kind = kind;
|
||||
self.content.selected = None;
|
||||
let mut query = ContentQuery::first(kind);
|
||||
// 保留用户已经选好的来源/排序/版本/加载器：换成默认值会让筛选条自己跳回去
|
||||
query.source = self.state.content.query.source;
|
||||
query.sort = self.state.content.query.sort;
|
||||
query.game_version = self.state.content.query.game_version.clone();
|
||||
query.loader = self.state.content.query.loader;
|
||||
self.search_content(query);
|
||||
}
|
||||
pages::content::Message::QueryChanged(text) => {
|
||||
self.content.draft = text;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
pages::content::Message::Search => {
|
||||
let mut query = self.state.content.query.clone();
|
||||
query.text = self.content.draft.trim().to_string();
|
||||
query.offset = 0;
|
||||
self.search_content(query);
|
||||
}
|
||||
pages::content::Message::SetSource(source) => {
|
||||
if source == ContentSource::Curseforge && !self.curseforge_available() {
|
||||
// 筛选条那条本来就是禁用的；这里再挡一次（防绕过 UI 的消息）
|
||||
return Task::none();
|
||||
}
|
||||
self.with_query(|query| query.source = source);
|
||||
}
|
||||
pages::content::Message::SetSort(sort) => self.with_query(|query| query.sort = sort),
|
||||
pages::content::Message::SetVersion(version) => {
|
||||
self.with_query(|query| query.game_version = version);
|
||||
}
|
||||
pages::content::Message::SetLoader(loader) => {
|
||||
self.with_query(|query| query.loader = loader)
|
||||
}
|
||||
pages::content::Message::Select(id) => {
|
||||
self.content.selected = Some(id);
|
||||
self.view_dirty = true;
|
||||
}
|
||||
pages::content::Message::SetTarget(id) => {
|
||||
self.content.target = Some(id);
|
||||
self.view_dirty = true;
|
||||
}
|
||||
pages::content::Message::LoadMore => {
|
||||
let next = self.state.content.query.next_page();
|
||||
self.search_content(next);
|
||||
}
|
||||
pages::content::Message::Retry => {
|
||||
let mut query = self.state.content.query.clone();
|
||||
query.offset = 0;
|
||||
self.search_content(query);
|
||||
}
|
||||
pages::content::Message::Install => {
|
||||
if let Some(request) = self.content_install_request() {
|
||||
self.dispatch(AppCommand::InstallContent(Box::new(request)));
|
||||
}
|
||||
}
|
||||
// M113: import/export —— 导入/导出区（细节在 `on_pack`）
|
||||
pages::content::Message::Pack(message) => self.on_pack(message),
|
||||
}
|
||||
Task::none()
|
||||
}
|
||||
|
||||
/// 导入/导出区的消息（M113）。
|
||||
///
|
||||
/// 两条口径：
|
||||
///
|
||||
/// 1. **页内选择改本地状态**（路径草稿 / 目标实例 / 格式 / 包名 / 展开的冲突）——
|
||||
/// 它们不属于业务状态，不进 presenter（同 `QueryChanged` 的处理）；
|
||||
/// 2. **意图只派指令，不做乐观回显**（导入 / 预检 / 确认写盘 / 关面板）：进度、报告、预检结果
|
||||
/// 全部由 `CoreEvent::Pack` 回来（`dto::pack::event` 的 `PackState::apply` 是唯一写入点）。
|
||||
pub(super) fn on_pack(&mut self, message: pages::content::PackMessage) {
|
||||
use pages::content::PackMessage;
|
||||
match message {
|
||||
PackMessage::Dropped(path) => {
|
||||
// 拖进来的包属于「整合包」这一类：顺手把类型切过去，否则这一块根本不在屏上
|
||||
self.content.kind = unlucky_presenter::dto::ContentKind::Modpack;
|
||||
self.content.pack.draft = path.display().to_string();
|
||||
self.content.pack.hover = false;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::Hover(hover) => {
|
||||
self.content.pack.hover = hover;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::PathChanged(path) => {
|
||||
self.content.pack.draft = path;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::SetInstance(instance) => {
|
||||
self.content.pack.instance = instance;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::SetInstanceName(name) => {
|
||||
self.content.pack.instance_name = name;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::SetFormat(format) => {
|
||||
self.content.pack.format = format;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::SetExportName(name) => {
|
||||
self.content.pack.export_name = name;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::SetExportVersion(version) => {
|
||||
self.content.pack.export_version = version;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::SetOutput(path) => {
|
||||
self.content.pack.output = path;
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::ToggleConflict(path) => {
|
||||
self.content.pack.expanded = if self.content.pack.expanded.as_deref() == Some(&path)
|
||||
{
|
||||
None
|
||||
} else {
|
||||
Some(path)
|
||||
};
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::OpenExport => {
|
||||
self.content.pack.export_open = true;
|
||||
// 包名缺省取目标实例名（用户不该为一个名字再敲一遍键盘）
|
||||
if self.content.pack.export_name.trim().is_empty() {
|
||||
self.content.pack.export_name =
|
||||
self.content.pack.instance.clone().unwrap_or_default();
|
||||
}
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::AbortExport => {
|
||||
self.content.pack.export_open = false;
|
||||
// 连预检结果一起清：留着会让用户以为「还能再点一次确认」
|
||||
self.dispatch(AppCommand::Pack(Box::new(PackCommand::Dismiss)));
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::Dismiss => {
|
||||
// 报告 / 探测诊断 / 预检都在 presenter 里：关面板 = 让 host 清掉它们
|
||||
// （`PackEvent::Cleared`），于是界面回到入口态，浏览网格重新露出来
|
||||
self.content.pack.expanded = None;
|
||||
self.dispatch(AppCommand::Pack(Box::new(PackCommand::Dismiss)));
|
||||
self.view_dirty = true;
|
||||
}
|
||||
PackMessage::Import => {
|
||||
if let Some(request) = self.pack_import_request(false) {
|
||||
self.dispatch(AppCommand::Pack(Box::new(PackCommand::Import(Box::new(
|
||||
request,
|
||||
)))));
|
||||
}
|
||||
}
|
||||
PackMessage::Overwrite => {
|
||||
// 「以包为准重新导入」：整次导入翻成 Overwrite 档（core 只有全局档）
|
||||
if let Some(request) = self.pack_import_request(true) {
|
||||
self.dispatch(AppCommand::Pack(Box::new(PackCommand::Import(Box::new(
|
||||
request,
|
||||
)))));
|
||||
}
|
||||
}
|
||||
PackMessage::Cancel => {
|
||||
// 与面板上那个「取消」同一个指令：host 会把导入的取消标记与代次一起处理
|
||||
self.dispatch(AppCommand::CancelInstall);
|
||||
}
|
||||
PackMessage::Precheck => {
|
||||
if let Some(request) = self.pack_export_request() {
|
||||
// 先记下「这次预检对的是哪份请求」，确认写盘时原样发回
|
||||
self.state.pack.set_export_request(request.clone());
|
||||
self.view_dirty = true;
|
||||
self.dispatch(AppCommand::Pack(Box::new(PackCommand::Export(Box::new(
|
||||
request,
|
||||
)))));
|
||||
}
|
||||
}
|
||||
PackMessage::Confirm => {
|
||||
if let Some(request) = self.state.pack.export.request.clone() {
|
||||
self.dispatch(AppCommand::Pack(Box::new(PackCommand::Confirm(Box::new(
|
||||
request,
|
||||
)))));
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 组一份导入请求（路径草稿 → DTO）。草稿为空 ⇒ `None`（按钮不该发指令）。
|
||||
///
|
||||
/// `overwrite` 只有「以包为准重新导入」会给 `true`；默认路径永远是 `false`
|
||||
/// （core 那边就是 `ConflictPolicy::KeepUser`，**绝不默认覆盖用户改过的文件**）。
|
||||
fn pack_import_request(&self, overwrite: bool) -> Option<ImportRequestView> {
|
||||
let draft = self.content.pack.draft.trim();
|
||||
if draft.is_empty() {
|
||||
return None;
|
||||
}
|
||||
let name = self.content.pack.instance_name.trim();
|
||||
Some(ImportRequestView {
|
||||
pack: std::path::PathBuf::from(draft),
|
||||
instance: self.content.pack.instance.clone(),
|
||||
instance_name: (!name.is_empty()).then(|| name.to_string()),
|
||||
overwrite,
|
||||
})
|
||||
}
|
||||
|
||||
/// 组一份导出请求（预检与写盘**共用同一份**，确认时原样发回）。
|
||||
///
|
||||
/// 没有选中实例就没有导出对象 ⇒ `None`。**「Save to」必须真的进请求**
|
||||
/// （复审 r1 P1-1：以前这里硬编码 `target: None`，那个输入框是死的）。
|
||||
fn pack_export_request(&self) -> Option<ExportRequestView> {
|
||||
let instance = self.content.pack.instance.clone()?;
|
||||
Some(pages::content::request_export(
|
||||
&self.content.pack,
|
||||
&instance,
|
||||
))
|
||||
}
|
||||
|
||||
/// 拖入一个文件/目录（`app/update.rs` 的窗口事件转发到这里）。
|
||||
pub(super) fn on_pack_dropped(&mut self, path: std::path::PathBuf) -> Task<Message> {
|
||||
// 拖入是「现在就要看到结果」的动作：先把用户带到内容库页，再落草稿
|
||||
self.state
|
||||
.navigate(unlucky_presenter::router::Route::Content);
|
||||
self.on_pack(pages::content::PackMessage::Dropped(path));
|
||||
self.refresh_view();
|
||||
Task::none()
|
||||
}
|
||||
|
||||
/// 拖拽悬停状态（有文件在窗口上方时高亮入口）。
|
||||
pub(super) fn on_pack_hover(&mut self, hover: bool) -> Task<Message> {
|
||||
// 状态没变就不重画：winit 对同一批文件会连发几次 hover 事件
|
||||
let changed = self.content.pack.hover != hover;
|
||||
self.on_pack(pages::content::PackMessage::Hover(hover));
|
||||
if changed {
|
||||
self.refresh_view();
|
||||
}
|
||||
Task::none()
|
||||
}
|
||||
|
||||
/// 改一个筛选字段并**立刻重查**（第一页）。
|
||||
fn with_query(&mut self, change: impl FnOnce(&mut ContentQuery)) {
|
||||
let mut query = self.state.content.query.clone();
|
||||
change(&mut query);
|
||||
query.offset = 0;
|
||||
self.search_content(query);
|
||||
}
|
||||
|
||||
/// 提交一次检索：条件先落进 presenter（迟到事件的判据），再派指令。
|
||||
fn search_content(&mut self, query: ContentQuery) {
|
||||
self.state.set_content_query(query.clone());
|
||||
self.view_dirty = true;
|
||||
self.dispatch(AppCommand::SearchContent(query));
|
||||
}
|
||||
|
||||
/// CF 源可用吗（结果里带回的那一位；还没拉过 ⇒ `false`）。
|
||||
fn curseforge_available(&self) -> bool {
|
||||
self.state
|
||||
.content
|
||||
.results
|
||||
.as_ref()
|
||||
.is_some_and(|results| results.curseforge)
|
||||
}
|
||||
|
||||
/// 组一份内容库的「装入」请求；闸门与页面上的按钮**同一个判据**（`Content::can_install`）。
|
||||
///
|
||||
/// 名字带 `content_`：M105 的版本安装已经占了 `install_request`（版本 → `CreateRequest`），
|
||||
/// 两者语义完全不同，撞名会被编译器拦下（本轮 rebase 撞过）。
|
||||
///
|
||||
/// 这里再判一次不是重复劳动：页面禁用的只是那一个按钮，消息仍然可能从别的路径进来，
|
||||
/// 而 host 侧对整合包会直接回失败——三道闸门同一个结论，才不会出现「有的路能过」。
|
||||
fn content_install_request(&self) -> Option<ContentInstallRequest> {
|
||||
let catalog = unlucky_i18n::Lang::En.catalog();
|
||||
let model = Content::from_snapshot(&self.state, &self.content, catalog);
|
||||
if !model.can_install() {
|
||||
// 有原因就打印出来（取证用）；没有选中项时什么都不做
|
||||
for reason in model.blocker_reasons(catalog) {
|
||||
eprintln!("[content] 装入被挡下：{reason}");
|
||||
}
|
||||
if model.blockers.contains(&Blocker::NeedsPipeline) {
|
||||
eprintln!("[content] 整合包装入未实现（M111）");
|
||||
}
|
||||
return None;
|
||||
}
|
||||
let hit = model.selected_hit()?;
|
||||
let target = model
|
||||
.targets
|
||||
.iter()
|
||||
.find(|target| Some(&target.id) == model.target.as_ref())?;
|
||||
Some(ContentInstallRequest {
|
||||
project: hit.id.clone(),
|
||||
title: hit.title.clone(),
|
||||
// 整合包走不到这里：`ContentKind::Modpack` 的 `dir()` 是 `None` ⇒ 必然带
|
||||
// `Blocker::NeedsPipeline` ⇒ `can_install()` 为假。所以这里就是「单文件」那一类。
|
||||
kind: model.kind,
|
||||
source: hit.source,
|
||||
instance: target.id.clone(),
|
||||
game_version: target.mc_version.clone(),
|
||||
loader: target.loader,
|
||||
})
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,381 @@
|
||||
//! 下载页在 app 层的那几支（M94；M105 补上安装选项）。
|
||||
//!
|
||||
//! 为什么单独一个文件：M93（外观三件套接线）合入后 `update.rs` 已经贴到 400 行，下载页再往里塞
|
||||
//! 几个 arm 就顶破硬线；拆出来是既不动 M93 的代码、又能守住 ≤400 的办法（`app/update/**` 属本
|
||||
//! mission scope）。
|
||||
//!
|
||||
//! ## 各支各自的纪律（M105 后的口径）
|
||||
//!
|
||||
//! | 消息 | 落点 | 为什么 |
|
||||
//! |---|---|---|
|
||||
//! | [`pages::Message::SelectVersion`] | 只改**草稿** | 选中是页面内状态，不是业务命令；顺手清掉加载器版本（换了原版版本，旧版本号几乎必然不适用） |
|
||||
//! | [`pages::Message::SetLoader`] | 改草稿 + 必要时派 `ListLoaderVersions` | 加载器版本列表来自官方元数据，页面不能自己编 |
|
||||
//! | [`pages::Message::SetLoaderVersion`] / `SetInstanceName` | 只改草稿 | 纯输入 |
|
||||
//! | [`pages::Message::InstallVersion`] | `AppCommand::CreateInstance(草稿)` | **确认才开工**（带加载器 / 加载器版本 / 实例名） |
|
||||
//! | [`pages::Message::CancelInstall`] | `AppCommand::CancelInstall` | 见 `host/dispatch.rs`：真停 + 作废旧代次 |
|
||||
//! | [`pages::Message::SetCategory`] | 写分类 → 重建 → `AppCommand::ListVersions` | 见下 |
|
||||
//!
|
||||
//! [「刷新下载源」](pages::Action::RefreshSources) 也在这里：它不是占位动作，具体分类 → 重拉该分类、
|
||||
//! 「全部」→ 让 host 重扫一遍（`RefreshAll`）。
|
||||
//!
|
||||
//! ## 分类为什么既写视图模型、又派指令
|
||||
//!
|
||||
//! 真 host 的 `AppCommand::ListVersions(_)` 会丢掉分类参数、回全量清单（复审 P2-1），所以**过滤在
|
||||
//! 本页做**：写进视图模型 → 立刻 `refresh_view()`（它会把 category 带回去、按同一谓词过滤行）→
|
||||
//! 再派指令。这不是「乐观回显」：写的是**过滤条件本身**，chip 与列表用同一个
|
||||
//! [`Category::matches`](crate::pages::Category)，于是不可能出现「chip 说正式版、列表是全量」的两份真相。
|
||||
//!
|
||||
//! ## 草稿为什么住在这里而不是页面模型里
|
||||
//!
|
||||
//! `refresh_view()` 每次事件都把 `self.view` 整棵重建（连安装进度都算），页面存不住「用户正在填、
|
||||
//! 还没确认」的东西。于是草稿放 `App::download_draft`，与分类筛选同一个做法：
|
||||
//! 改草稿 → `view_dirty = true` → `refresh_view()`。
|
||||
|
||||
use unlucky_presenter::dto::CreateRequest;
|
||||
|
||||
use super::*;
|
||||
|
||||
impl App {
|
||||
/// 下载页的消息。**处理了返回 `true`**（`on_page` 里就不用再写一遍这些 arm）。
|
||||
pub(super) fn on_download(&mut self, message: &pages::Message) -> bool {
|
||||
match message {
|
||||
pages::Message::SelectVersion(id) => {
|
||||
if self.download_draft.selected.as_deref() != Some(id.as_str()) {
|
||||
// 换了原版版本：加载器版本是**按 (加载器, 原版版本)** 取的（见
|
||||
// `CoreEvent::LoaderVersions` 的缓存键），旧的版本号留着只会误导。
|
||||
self.download_draft.loader_version.clear();
|
||||
}
|
||||
self.download_draft.selected = Some(id.clone());
|
||||
self.mark_download_dirty();
|
||||
// 选了加载器版本之后换原版版本，列表要跟着换——已经查过的直接从快照读，不重复派。
|
||||
self.ensure_loader_versions();
|
||||
}
|
||||
pages::Message::SetLoader(loader) => {
|
||||
self.download_draft.loader = *loader;
|
||||
self.download_draft.loader_version.clear();
|
||||
self.mark_download_dirty();
|
||||
self.ensure_loader_versions();
|
||||
}
|
||||
pages::Message::SetLoaderVersion(version) => {
|
||||
self.download_draft.loader_version = version.clone();
|
||||
self.mark_download_dirty();
|
||||
}
|
||||
pages::Message::SetInstanceName(name) => {
|
||||
self.download_draft.instance_name = name.clone();
|
||||
self.mark_download_dirty();
|
||||
}
|
||||
pages::Message::InstallVersion(id) => {
|
||||
// 防守：按钮带的是**页面上那一行**的 id，草稿里的选中项理论上与它一致；
|
||||
// 万一不一致（例如列表刚换过、用户手快），不能让 A 版本的加载器版本落到 B 版本上。
|
||||
if self.download_draft.selected.as_deref() != Some(id.as_str()) {
|
||||
self.download_draft.selected = Some(id.clone());
|
||||
self.download_draft.loader_version.clear();
|
||||
}
|
||||
let request = self.install_request(id);
|
||||
self.dispatch(AppCommand::CreateInstance(request));
|
||||
}
|
||||
pages::Message::CancelInstall => self.dispatch(AppCommand::CancelInstall),
|
||||
pages::Message::SetCategory(category) => {
|
||||
self.view.download.category = *category;
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
if let Some(kind) = category.command() {
|
||||
self.dispatch(AppCommand::ListVersions(kind));
|
||||
}
|
||||
}
|
||||
// M107：查询词落在快照里（无状态视图的唯一存活方式），再走同一条重建路径过滤。
|
||||
pages::Message::SetVersionQuery(query) => {
|
||||
self.rebuild_after_query(query.clone());
|
||||
}
|
||||
pages::Message::ClearVersionQuery => {
|
||||
self.rebuild_after_query(String::new());
|
||||
}
|
||||
// M107：主版本桶的选中是纯视图态，不重建、不派命令（同 `SelectVersion`）。
|
||||
//
|
||||
// **搜索期间点桶 = 「我就是要看这个桶」**（复审 r2 P2-1(b)）：搜索让第二级失效（P2-1 的
|
||||
// 一致性放宽），如果这里只改选择而不清查询，用户会看到「点了没反应、清空搜索后才生效」
|
||||
// 的活控件。所以搜索中点桶顺带退出搜索，按新桶过滤——一次点击做完用户想要的两件事。
|
||||
pages::Message::SelectMajor(key) => {
|
||||
if self.view.download.has_query() {
|
||||
// 先退出搜索再落选择：`rebuild_after_query` 会用**全量行**重算桶并回填选择
|
||||
// （它带回 `selected_major`，且校验桶仍存在）。
|
||||
self.view.download.selected_major = key.clone();
|
||||
self.rebuild_after_query(String::new());
|
||||
} else {
|
||||
self.view.download.selected_major = key.clone();
|
||||
}
|
||||
}
|
||||
// M107：类型栏的手动折叠也是纯视图态。
|
||||
pages::Message::ToggleTypeRail => {
|
||||
self.view.download.type_rail_folded = !self.view.download.type_rail_folded;
|
||||
}
|
||||
pages::Message::Action(pages::Action::RefreshSources) => {
|
||||
match self.view.download.category.command() {
|
||||
Some(kind) => self.dispatch(AppCommand::ListVersions(kind)),
|
||||
None => self.dispatch(AppCommand::RefreshAll),
|
||||
}
|
||||
}
|
||||
_ => return false,
|
||||
}
|
||||
true
|
||||
}
|
||||
|
||||
/// 改草稿之后统一走这一条：置脏 + 立刻重建（不等下一拍，点了就有反应）。
|
||||
fn mark_download_dirty(&mut self) {
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
}
|
||||
|
||||
/// 确认安装时的 `CreateRequest`（草稿 → 指令载荷）。
|
||||
///
|
||||
/// 实例名留空就让 core 用版本号（`CreateRequest::instance_name` 的既有口径），
|
||||
/// 所以这里**不**自己拼一个默认名——两处各拼一份迟早会漂。
|
||||
fn install_request(&self, id: &str) -> CreateRequest {
|
||||
let draft = &self.download_draft;
|
||||
CreateRequest {
|
||||
name: draft.instance_name.trim().to_string(),
|
||||
version: id.to_string(),
|
||||
loader: draft.loader.kind(),
|
||||
loader_version: draft.loader_version.trim().to_string(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 当前草稿需要加载器版本列表、而快照里还没有时，派一次查询。
|
||||
///
|
||||
/// 判据是 `state.loader_versions_for(...)` 的 `None`（= 没查过）：查过的（成功或失败）都不再重复派，
|
||||
/// 失败要重试走 `RefreshSources` 那条路，页面上的红色原因行不会因为一次点击就消失。
|
||||
fn ensure_loader_versions(&mut self) {
|
||||
let loader = self.download_draft.loader;
|
||||
if loader == pages::Loader::Vanilla {
|
||||
return;
|
||||
}
|
||||
let Some(version) = self.download_draft.selected.clone() else {
|
||||
return;
|
||||
};
|
||||
// 静态就不支持的组合不联网（否则只会换来一条「取不到」的假原因；真正的原因是
|
||||
// 「这个加载器没有这个版本的构建」，页面已经用静态规则说清了）。
|
||||
let kind = self
|
||||
.state
|
||||
.versions
|
||||
.iter()
|
||||
.find(|summary| summary.id == version)
|
||||
.map(|summary| summary.kind);
|
||||
if let Some(kind) = kind {
|
||||
if loader.supports(&version, kind).is_err() {
|
||||
return;
|
||||
}
|
||||
}
|
||||
if self
|
||||
.state
|
||||
.loader_versions_for(loader.kind(), &version)
|
||||
.is_some()
|
||||
{
|
||||
return;
|
||||
}
|
||||
self.dispatch(AppCommand::ListLoaderVersions {
|
||||
kind: loader.kind(),
|
||||
mc_version: version,
|
||||
});
|
||||
}
|
||||
|
||||
/// 搜索词变了：写进快照 → 重建视图 → **把纯视图态捡回来**。
|
||||
///
|
||||
/// `refresh_view()` 整块换掉 `self.view`，而它只把 `category` 与**安装草稿**带回去（`app/state.rs`
|
||||
/// 归 M105/M106）。所以「折叠状态」与「选中的主版本桶」必须在重建前后自己搬一次——否则用户敲第一个
|
||||
/// 字符，展开着的类型栏就自己收起来、选中的主版本也跳回「全部」。
|
||||
/// 「搜索时侧栏保留当前位置」这条要求，落点就是这里的四行。
|
||||
fn rebuild_after_query(&mut self, query: String) {
|
||||
self.state.download_query = query;
|
||||
let major = self.view.download.selected_major.take();
|
||||
let folded = self.view.download.type_rail_folded;
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
// 回填要**校验**：桶是按当前行聚合法出来的，新桶列表里没有的那个选择不该被复活
|
||||
// （复审 P2-1(a)：否则会出现「侧栏没有任何一项点亮」的幽灵选中）。
|
||||
self.view.download.selected_major = major.filter(|key| {
|
||||
self.view
|
||||
.download
|
||||
.buckets
|
||||
.iter()
|
||||
.any(|bucket| bucket.key.as_deref() == Some(key.as_str()))
|
||||
});
|
||||
self.view.download.type_rail_folded = folded;
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
//! 搜索链路的**端到端**断言（复审 P2-5）。
|
||||
//!
|
||||
//! 为什么非要在 app 层写：这条链是 `Message → on_page → on_download → AppState.download_query
|
||||
//! → refresh_view → from_snapshot 过滤`，中间任何一环断掉，页面层测试都看不见（页面只拿到
|
||||
//! 已经过滤好的模型）。复审原话：「把 `rebuild_after_query` 第一行删掉，现有测试全绿，而搜索
|
||||
//! 变成假控件」——这几条就是补那个洞的。
|
||||
|
||||
use std::cell::RefCell;
|
||||
use std::rc::Rc;
|
||||
|
||||
use unlucky_presenter::dto::{AppEvent, Backend, CoreEvent, VersionKind, VersionSummary};
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
|
||||
use super::*;
|
||||
|
||||
/// 只记账、不回事件的后端（同 `app/update/download_wiring.rs`）：命令出了 UI 层，状态一个字节
|
||||
/// 都不许变——否则「本地乐观回显」与「事件回流」终态相同，断言会假绿。
|
||||
struct Recorder(Rc<RefCell<Vec<AppCommand>>>);
|
||||
|
||||
impl Backend for Recorder {
|
||||
fn drain_events(&mut self) -> Vec<AppEvent> {
|
||||
Vec::new()
|
||||
}
|
||||
fn dispatch(&mut self, command: AppCommand) {
|
||||
self.0.borrow_mut().push(command);
|
||||
}
|
||||
}
|
||||
|
||||
fn version(id: &str) -> VersionSummary {
|
||||
VersionSummary {
|
||||
id: id.to_string(),
|
||||
kind: VersionKind::Release,
|
||||
released: "2026-09-20".to_string(),
|
||||
installed: false,
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个装好三行版本的 App（`1.21.9` / `1.20.4` / `1.20.1`）。
|
||||
fn app() -> App {
|
||||
let families = crate::theme::Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
let mut app = App::with_presenter(
|
||||
crate::cli::Options::default(),
|
||||
families,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(Recorder(Rc::new(RefCell::new(Vec::new())))),
|
||||
SettingsBridge::memory_only(),
|
||||
);
|
||||
app.state
|
||||
.apply(AppEvent::Core(CoreEvent::VersionListChanged(vec![
|
||||
version("1.21.9"),
|
||||
version("1.20.4"),
|
||||
version("1.20.1"),
|
||||
])));
|
||||
app.refresh_view();
|
||||
app
|
||||
}
|
||||
|
||||
/// 键入 → 快照 → 列表：一条走完的链。
|
||||
///
|
||||
/// 抓得住：`rebuild_after_query` 不再写 `AppState.download_query`（搜索变假控件）、
|
||||
/// 或 `from_snapshot` 不再按 query 过滤（列表不跟着收窄）。
|
||||
/// 抓不住：真机上 `text_input` 的按键是否走到这里（那是组件的事，`search_bar` 已接 `on_input`）。
|
||||
#[test]
|
||||
fn typing_a_query_reaches_the_state_and_narrows_the_list() {
|
||||
let mut app = app();
|
||||
assert_eq!(app.view.download.rows.len(), 3, "初始是全量");
|
||||
|
||||
let _ = app.on_page(pages::Message::SetVersionQuery("1.20".to_string()));
|
||||
|
||||
assert_eq!(app.state.download_query, "1.20", "查询词落在快照里");
|
||||
assert_eq!(app.view.download.rows.len(), 2, "列表收窄到两行");
|
||||
assert_eq!(app.view.download.hits, 2);
|
||||
assert_eq!(app.view.download.query, "1.20", "模型回显查询词");
|
||||
|
||||
// 清空回到全量（`ClearVersionQuery` 那一支）
|
||||
let _ = app.on_page(pages::Message::ClearVersionQuery);
|
||||
assert!(app.state.download_query.is_empty());
|
||||
assert_eq!(app.view.download.rows.len(), 3);
|
||||
}
|
||||
|
||||
/// 查询词**跨事件存活**：再来一次重建，列表仍是收窄的。
|
||||
///
|
||||
/// 抓得住：把查询词只写在视图模型里（下一次 `refresh_view` 就丢）——这是「搜索看起来能用、
|
||||
/// 一来事件就复位」的坏法。
|
||||
#[test]
|
||||
fn the_query_survives_a_snapshot_rebuild() {
|
||||
let mut app = app();
|
||||
let _ = app.on_page(pages::Message::SetVersionQuery("1.21".to_string()));
|
||||
assert_eq!(app.view.download.rows.len(), 1);
|
||||
|
||||
// 安装进度这类事件回来时，`pump()` 会重建视图：查询词必须还在
|
||||
app.state
|
||||
.apply(AppEvent::Core(CoreEvent::InstallProgress(None)));
|
||||
app.refresh_view();
|
||||
|
||||
assert_eq!(app.state.download_query, "1.21", "查询词在快照里，重建不丢");
|
||||
assert_eq!(app.view.download.rows.len(), 1, "列表仍收窄");
|
||||
}
|
||||
|
||||
/// **搜索期间点主版本桶 = 退出搜索并按该桶过滤**（复审 r2 P2-1(b)）。
|
||||
///
|
||||
/// 抓得住：`SelectMajor` 只改选择不清查询 —— 那时搜索让第二级失效（P2-1 的一致性放宽），
|
||||
/// 用户点了当场没反应、要等清空搜索那次点击才生效，就是「可点但无反应」的活控件。
|
||||
/// 抓不住：真机点击是否走到这里（`ListItem`/`Chip` 的 `on_press` 是组件既有实现）。
|
||||
#[test]
|
||||
fn clicking_a_bucket_during_a_search_leaves_the_search() {
|
||||
let mut app = app();
|
||||
let _ = app.on_page(pages::Message::SetVersionQuery("1.20".to_string()));
|
||||
assert_eq!(app.view.download.rows.len(), 2, "此刻在搜 1.20");
|
||||
|
||||
// 点「1.21」这个桶
|
||||
let _ = app.on_page(pages::Message::SelectMajor(Some("1.21".to_string())));
|
||||
|
||||
assert!(app.state.download_query.is_empty(), "点桶顺带退出搜索");
|
||||
assert!(!app.view.download.has_query());
|
||||
assert_eq!(
|
||||
app.view.download.selected_major.as_deref(),
|
||||
Some("1.21"),
|
||||
"选择落在刚点的那个桶上"
|
||||
);
|
||||
assert_eq!(
|
||||
app.view.download.rows.len(),
|
||||
3,
|
||||
"查询词清掉之后模型回到全量（桶过滤发生在渲染时的 visible 里）"
|
||||
);
|
||||
assert_eq!(
|
||||
app.view
|
||||
.download
|
||||
.buckets
|
||||
.iter()
|
||||
.find(|bucket| bucket.key.as_deref() == Some("1.21"))
|
||||
.map(|bucket| bucket.count),
|
||||
Some(1),
|
||||
"1.21 桶里只有一个版本 ⇒ 列表会显示一行"
|
||||
);
|
||||
|
||||
// 没有搜索词时点桶照旧只改选择（不触发多余重建）
|
||||
let _ = app.on_page(pages::Message::SelectMajor(None));
|
||||
assert_eq!(app.view.download.selected_major, None);
|
||||
}
|
||||
|
||||
/// 搜索时侧栏的**位置与折叠**不许丢（`rebuild_after_query` 的三行）。
|
||||
///
|
||||
/// 抓得住：删掉那两行回填（敲第一个字符，类型栏自己弹开、主版本跳回「全部」）。
|
||||
/// 抓不住：其它事件（安装进度）回来时也会复位 —— 那条要 `app/state.rs` 的 `refresh_view`
|
||||
/// 一起改，不在本 mission scope，已在报告里明确登记「留到 M105 之后」。
|
||||
#[test]
|
||||
fn a_query_keeps_the_rail_position_and_the_fold() {
|
||||
let mut app = app();
|
||||
app.view.download.selected_major = Some("1.20".to_string());
|
||||
app.view.download.type_rail_folded = true;
|
||||
|
||||
let _ = app.on_page(pages::Message::SetVersionQuery("1.20".to_string()));
|
||||
|
||||
assert_eq!(
|
||||
app.view.download.selected_major.as_deref(),
|
||||
Some("1.20"),
|
||||
"桶选择还在（生效值在搜索期间放宽，但选择本身不许被清）"
|
||||
);
|
||||
assert!(app.view.download.type_rail_folded, "折叠状态还在");
|
||||
|
||||
// 选中一个**新桶列表里不存在**的桶：搜索后不许把它复活成幽灵选中（P2-1(a)）
|
||||
app.view.download.selected_major = Some("9.99".to_string());
|
||||
let _ = app.on_page(pages::Message::SetVersionQuery("1.20".to_string()));
|
||||
assert_eq!(
|
||||
app.view.download.selected_major, None,
|
||||
"新桶列表里没有 9.99 ⇒ 回填空值，而不是留一个点不亮的幽灵选中"
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,228 @@
|
||||
//! 下载页（M94）在 app 层的接线测试：**命令出得去、状态不自己变**。
|
||||
//!
|
||||
//! 从 `app/update.rs` 外置（那边 348 行 + 这个模块会顶破 400 行硬上限；同一句话的理由见
|
||||
//! `crates/i18n/src/catalog/tests.rs`）。`use super::*` 依然指向 `crate::app::update`。
|
||||
|
||||
use std::cell::RefCell;
|
||||
use std::rc::Rc;
|
||||
|
||||
use unlucky_presenter::dto::{AppEvent, Backend, VersionCategory};
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
|
||||
use super::*;
|
||||
|
||||
/// 只记账、**不回事件**的后端（同 `app/tests/presenter.rs`）：命令出了 UI 层，状态一个字节都不许变。
|
||||
/// 不用 `MockBackend`：它同步回事件，「本地乐观回显」与「事件回流」终态相同，断言会**假绿**。
|
||||
struct Recorder(Rc<RefCell<Vec<AppCommand>>>);
|
||||
|
||||
impl Backend for Recorder {
|
||||
fn drain_events(&mut self) -> Vec<AppEvent> {
|
||||
Vec::new()
|
||||
}
|
||||
fn dispatch(&mut self, command: AppCommand) {
|
||||
self.0.borrow_mut().push(command);
|
||||
}
|
||||
}
|
||||
|
||||
/// 四条下载页消息：三条派真指令，`SelectVersion` 只改视图模型（P3-2 的不乐观回显）。
|
||||
/// 抓得住：意图被写成「本地改状态就算完」、或派错指令；抓不住：host 收到后真的开始下载。
|
||||
#[test]
|
||||
fn download_intents_dispatch_real_commands() {
|
||||
let log: Rc<RefCell<Vec<AppCommand>>> = Rc::new(RefCell::new(Vec::new()));
|
||||
let families = crate::theme::Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
let mut app = App::with_presenter(
|
||||
crate::cli::Options::default(),
|
||||
families,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(Recorder(Rc::clone(&log))),
|
||||
SettingsBridge::memory_only(),
|
||||
);
|
||||
// M95 起 `on_page` 返回 `Task`（剪贴板命令要走返回的 Task）：这里只关心派发与视图模型，
|
||||
// 任务本身没有需要断言的后效，显式丢弃。
|
||||
let _ = app.on_page(pages::Message::InstallVersion("1.21.9".to_string()));
|
||||
let _ = app.on_page(pages::Message::CancelInstall);
|
||||
let _ = app.on_page(pages::Message::SetCategory(pages::Category::Release));
|
||||
let _ = app.on_page(pages::Message::SelectVersion("1.21.8".to_string()));
|
||||
// M105：「安装」不再是「立刻装原版」，而是把**草稿里的选项**一起交出去
|
||||
// （`CreateInstance` 带加载器 / 加载器版本 / 实例名）——这正是用户报的「没有加载器可选」的修复点。
|
||||
let expected = vec![
|
||||
AppCommand::CreateInstance(unlucky_presenter::dto::CreateRequest {
|
||||
version: "1.21.9".to_string(),
|
||||
loader: unlucky_presenter::dto::LoaderKind::Vanilla,
|
||||
loader_version: String::new(),
|
||||
name: String::new(),
|
||||
}),
|
||||
AppCommand::CancelInstall,
|
||||
AppCommand::ListVersions(VersionCategory::Release),
|
||||
];
|
||||
assert_eq!(
|
||||
*log.borrow(),
|
||||
expected,
|
||||
"三条各派一条；`SelectVersion` 不派"
|
||||
);
|
||||
// M105：选中项住在**草稿**里（`refresh_view` 每次事件都会整棵重建页面模型，
|
||||
// 页面自己存不住它）；recorder 不回 `VersionListChanged` ⇒ 列表是空的 ⇒
|
||||
// 视图模型里那一行不存在，于是 `selected` 被过滤成 `None`（防「切分类后还留着一个点不动的安装」）。
|
||||
assert_eq!(app.download_draft.selected.as_deref(), Some("1.21.8"));
|
||||
assert_eq!(
|
||||
app.view.download.selected, None,
|
||||
"选中的行不在列表里时，视图模型不该拿着它"
|
||||
);
|
||||
assert_eq!(app.view.download.category, pages::Category::Release);
|
||||
assert_eq!(
|
||||
app.view.download.rows.len(),
|
||||
0,
|
||||
"recorder 不回事件 ⇒ 列表不该冒出来"
|
||||
);
|
||||
// 分类是本地过滤条件：**任何一次视图重建都不许把它打回 `All`**（复审 P2-1 的回归点）。
|
||||
// 抓得住：`refresh_view` 忘记把分类带回去（那一行删掉这条就红）。
|
||||
// 抓不住：真 host 是否按分类拉清单（那是 presenter 的 `spawn_list`，已报 finding）。
|
||||
app.refresh_view();
|
||||
assert_eq!(
|
||||
app.view.download.category,
|
||||
pages::Category::Release,
|
||||
"重建视图模型之后分类必须还在"
|
||||
);
|
||||
}
|
||||
|
||||
/// **取消之后面板要回到「未安装态」且能立刻再装**（M105 的验收项，CI 可跑的那一半）。
|
||||
///
|
||||
/// 现场（用户原话）：「取消下载按钮点了没反应」。真根因是取消生效了又被旧任务的事件盖回去
|
||||
/// （presenter 侧的代次守门在 `host/cancel_tests.rs`）；这一条钉的是**页面这一侧**：
|
||||
/// 收到 `InstallProgress(None)` 之后，面板必须回到安装选项区、确认键可用、选中的版本还在
|
||||
/// ——不需要用户重新点一遍版本。
|
||||
///
|
||||
/// 抓得住：取消后仍画着进度面板 / 选项区丢了选中 / 确认键还是禁用。
|
||||
/// 抓不住：真网络下的取消延迟（那条是 `#[ignore]` 的真网络用例）。
|
||||
#[test]
|
||||
fn cancelling_gives_the_panel_back_to_the_install_options() {
|
||||
let log: Rc<RefCell<Vec<AppCommand>>> = Rc::new(RefCell::new(Vec::new()));
|
||||
let families = crate::theme::Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
let mut app = App::with_presenter(
|
||||
crate::cli::Options::default(),
|
||||
families,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(Recorder(Rc::clone(&log))),
|
||||
SettingsBridge::memory_only(),
|
||||
);
|
||||
app.state.apply(AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::VersionListChanged(vec![
|
||||
unlucky_presenter::dto::VersionSummary {
|
||||
id: "1.21.9".to_string(),
|
||||
kind: unlucky_presenter::dto::VersionKind::Release,
|
||||
released: "2026-09-20".to_string(),
|
||||
installed: false,
|
||||
},
|
||||
]),
|
||||
));
|
||||
app.refresh_view();
|
||||
|
||||
// 选中 → 面板给出选项区
|
||||
let _ = app.on_page(pages::Message::SelectVersion("1.21.9".to_string()));
|
||||
let options = app
|
||||
.view
|
||||
.download
|
||||
.options
|
||||
.as_ref()
|
||||
.expect("选中版本之后要出现安装选项区");
|
||||
assert!(options.can_confirm, "原版 + 列表里的版本 = 可以装");
|
||||
assert_eq!(options.version, "1.21.9");
|
||||
|
||||
// 开装：host 回一条「下载中」→ 面板换成进度
|
||||
app.state.apply(AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::InstallProgress(Some(
|
||||
unlucky_presenter::dto::InstallProgressView {
|
||||
version: "1.21.9".to_string(),
|
||||
stage: unlucky_presenter::dto::InstallStage::Downloading,
|
||||
files_done: 9,
|
||||
files_total: 512,
|
||||
..unlucky_presenter::dto::InstallProgressView::new()
|
||||
},
|
||||
)),
|
||||
));
|
||||
app.refresh_view();
|
||||
assert!(app.view.download.install.is_some(), "装的时候面板讲进度");
|
||||
assert!(app.view.download.options.is_none(), "进度与选项互斥");
|
||||
|
||||
// 取消：host 回 `InstallProgress(None)`（`CancelInstall` 的既有语义）
|
||||
let _ = app.on_page(pages::Message::CancelInstall);
|
||||
app.state.apply(AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::InstallProgress(None),
|
||||
));
|
||||
app.refresh_view();
|
||||
assert!(app.view.download.install.is_none(), "取消后面板必须收回");
|
||||
let options = app
|
||||
.view
|
||||
.download
|
||||
.options
|
||||
.as_ref()
|
||||
.expect("取消后要回到安装选项区（未安装态），而不是只剩一句提示");
|
||||
assert_eq!(
|
||||
options.version, "1.21.9",
|
||||
"选中项要还在，用户不必重新点一遍"
|
||||
);
|
||||
assert!(options.can_confirm, "取消后要能立刻再装一次");
|
||||
}
|
||||
|
||||
/// **取消提示只说一次，且说的是页面语言**（复审 P2-2）。
|
||||
///
|
||||
/// 修前：`presenter` 在取消时直接推一条**写死的中文** Toast，而下载页此刻渲染英文 ⇒
|
||||
/// 选项区英文、取消弹窗中文，同屏两语。现在 host 只发信号（`CoreEvent::InstallCancelled`），
|
||||
/// 文案由页面层按 `Key::DownloadCancelled` 现求，语言跟页面走。
|
||||
///
|
||||
/// 抓得住：谁把中文写回 presenter（类型上已经做不到——它没有 i18n 依赖）、
|
||||
/// 或者 app 层每次 `refresh_view` 都重复弹（下面的 `items().len() == 1`）。
|
||||
/// 抓不住：`Lang` 本身接得对不对（M106 起语言来自 `App::lang()`，本测试**显式钉**成英文，
|
||||
/// 否则这条断言会跟着跑测试那台机器的 locale 变——那是假绿）。
|
||||
#[test]
|
||||
fn cancelling_announces_once_in_the_page_language() {
|
||||
let log: Rc<RefCell<Vec<AppCommand>>> = Rc::new(RefCell::new(Vec::new()));
|
||||
let families = crate::theme::Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
let mut app = App::with_presenter(
|
||||
crate::cli::Options::default(),
|
||||
families,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(Recorder(Rc::clone(&log))),
|
||||
SettingsBridge::memory_only(),
|
||||
);
|
||||
assert!(app.state.toasts.is_empty(), "出厂态不该有 Toast");
|
||||
|
||||
// M106：语言显式钉成英文。不钉的话「页面语言」就是跑测试那台机器的 locale（英文 CI 绿、
|
||||
// 中文机器红）——那种测试证明不了任何事。钉住之后期望值仍从目录取，守的是同一条原意：
|
||||
// **提示语来自 i18n 目录，不是 presenter 写死的中文**。
|
||||
app.set_language(unlucky_i18n::LangChoice::Fixed(unlucky_i18n::Lang::En));
|
||||
|
||||
app.state.apply(AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::InstallCancelled,
|
||||
));
|
||||
app.refresh_view();
|
||||
let items = app.state.toasts.items();
|
||||
assert_eq!(items.len(), 1, "取消要提示一条（且只一条）");
|
||||
let text = items[0].text.clone();
|
||||
assert_eq!(
|
||||
text,
|
||||
pages::cancelled_toast(unlucky_i18n::Lang::En),
|
||||
"提示语必须来自 i18n 目录（不是 presenter 写死的中文）"
|
||||
);
|
||||
assert!(
|
||||
!text.contains('取') && !text.contains('消'),
|
||||
"页面此刻是英文，取消提示不该混中文：{text}"
|
||||
);
|
||||
|
||||
// 再重建一次视图：不该重复弹（信号是计数，不是「每拍都算一次」）
|
||||
app.refresh_view();
|
||||
assert_eq!(app.state.toasts.items().len(), 1, "同一次取消只提示一次");
|
||||
let _ = app.state.toasts.len();
|
||||
}
|
||||
@@ -0,0 +1,232 @@
|
||||
//! 页面消息的落点（`on_page`）：解 M94 冲突时从 `update.rs` 拆出来。
|
||||
//!
|
||||
//! 为什么拆：`main` 上 `update.rs` 已经 **397 行**（M94 自己也是因此把下载页四支拆到
|
||||
//! `update/download.rs`），日志页再往里塞「剪贴板 + 清日志」两支就顶破 400 硬线。
|
||||
//! 与 M94 同一种做法：`app/update/**` 属本 mission scope。
|
||||
//!
|
||||
//! ## 穷尽性（M94 复审的 p3，本轮收掉）
|
||||
//!
|
||||
//! 这里是全 crate **唯一**对 [`pages::Message`] 的穷尽匹配点，所以**没有** `_ => {}` 兜底：
|
||||
//! 谁往枚举里加变体却忘了接线，编译器立刻报 E0004。原来是 `_ => {}` + 注释「做穷尽性」——
|
||||
//! 方向正好写反了，它**取消**穷尽性，把「漏接线」变成「点了没反应」。
|
||||
//!
|
||||
//! 代价：由前置分支（`on_download` / 本文件里的剪贴板分支）先消费的变体，在 match 里**仍要
|
||||
//! 显式列出**。那是保住穷尽性的必要代价，也是这条守卫抓得住东西的原因。
|
||||
//!
|
||||
//! ## 边界（抓得住什么 / 抓不住什么）
|
||||
//!
|
||||
//! - 抓得住：**加一个 `pages::Message` 变体却没接线** → 编译失败（E0004），不会静默；
|
||||
//! - 抓不住：加一个 `pages::Action` 变体 —— 它落进 `Action(action)` 的占位分支（打印一行
|
||||
//! `[page] 占位动作 …`），编译期不会报。这是占位期的既有设计，不是本文件能守的。
|
||||
|
||||
use unlucky_i18n::{Lang, LangChoice};
|
||||
|
||||
use crate::pages;
|
||||
use crate::ui::lang::LangState;
|
||||
|
||||
use super::*;
|
||||
|
||||
// --------------------------------------------------------------- 界面语言（M106）
|
||||
//
|
||||
// 这三个方法住在本文件而不是 `app/state.rs`：`state.rs` 贴着 400 行硬线（M104 的 `agent`、
|
||||
// M105 的 `download_draft` 都往那儿长），而 `set_language` 的唯一调用点就是本文件的
|
||||
// `pages::Message::Language` 分支——落点与调用点放一起，读的人不用来回跳。
|
||||
// 与 M93 把 appearance 那批 `App` 方法放进 `app/appearance.rs` 是同一手法。
|
||||
|
||||
impl App {
|
||||
/// 页面消息：导航走路由栈，真业务命令派发，纯视图态改本地呈现。
|
||||
pub(super) fn on_page(&mut self, message: pages::Message) -> Task<Message> {
|
||||
// 下载页的四支（含「刷新下载源」）在 `update/download.rs`：`update.rs` 早已贴 400 行
|
||||
if self.on_download(&message) {
|
||||
return Task::none();
|
||||
}
|
||||
|
||||
match message {
|
||||
pages::Message::Navigate(route) => {
|
||||
// M109：进内容库时补一次检索（首个动作不该是「再点一下搜索」）。
|
||||
// 判据在 `ensure_content_loaded` 里（已有结果/请求在飞就不重复打网络）。
|
||||
let entering_content = route == Route::Content;
|
||||
self.state.navigate(route);
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
if entering_content {
|
||||
self.ensure_content_loaded();
|
||||
}
|
||||
}
|
||||
pages::Message::Launch(id) => self.dispatch(AppCommand::LaunchInstance(id)),
|
||||
pages::Message::Stop(id) => self.dispatch(AppCommand::StopInstance(id)),
|
||||
pages::Message::Appearance(change) => self.on_appearance(change),
|
||||
// M101：设置页的四条填页线共用一个投递口；组内变体在 `update/settings.rs` 里穷尽分发
|
||||
// （那一层没有 `_ =>`，见本文件末尾与 `update/settings/tests.rs` 的两条守门）
|
||||
pages::Message::Settings(group) => return self.on_settings(group),
|
||||
// M106：换界面语言（落盘 + 重建视图模型；档位不是业务命令，不派 `AppCommand`）。
|
||||
// 这是**唯一**一处绕开 M101 投递口的页面消息：语言档位不是「某一组的状态」，
|
||||
// 它要落盘到 `ui.language` 并重建整棵视图模型（设置页的语言行只是它的第一个出口）。
|
||||
pages::Message::Language(choice) => self.set_language(choice),
|
||||
// M109：内容库那一套意图在自己的文件里穷尽分发（`update/content.rs`）
|
||||
pages::Message::Content(message) => return self.on_content(message),
|
||||
// M95：摘要落剪贴板（文本由页面造，这里只搬）
|
||||
pages::Message::CopySummary(text) => return iced::clipboard::write(text),
|
||||
// 下面四支已由 `on_download` 提前消化；显式列出而不是 `_ => {}`，见模块文档
|
||||
pages::Message::SelectVersion(_)
|
||||
| pages::Message::InstallVersion(_)
|
||||
| pages::Message::CancelInstall
|
||||
// M105 的三支 + M107 的四支 + 分类：全部由 `on_download` 提前消化（显式列出保住穷尽性）
|
||||
| pages::Message::SetLoader(_)
|
||||
| pages::Message::SetLoaderVersion(_)
|
||||
| pages::Message::SetInstanceName(_)
|
||||
| pages::Message::SetCategory(_)
|
||||
// M107 的四支同属下载页（查询 / 清空 / 主版本桶 / 折叠类型栏）
|
||||
| pages::Message::SetVersionQuery(_)
|
||||
| pages::Message::ClearVersionQuery
|
||||
| pages::Message::SelectMajor(_)
|
||||
| pages::Message::ToggleTypeRail => debug_assert!(false, "应由 on_download 消费"),
|
||||
// M95：清空日志是**呈现层**操作（`log_lines` 是 presenter 的公开快照字段，
|
||||
// 不派业务命令、不写持久状态）
|
||||
pages::Message::Action(pages::Action::ClearLogs) => {
|
||||
self.state.log_lines.clear();
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
}
|
||||
// M114：账户页（三轨登录 / 列表动作 / 表单输入）
|
||||
pages::Message::Account(message) => return self.on_account(message),
|
||||
// 还没接后端的占位动作：只打日志（哪几个、为什么，见 pages 模块文档的偏离登记）
|
||||
pages::Message::Action(action) => {
|
||||
eprintln!("[page] 占位动作 {action:?} pressed（没有对应 AppCommand）");
|
||||
}
|
||||
}
|
||||
|
||||
Task::none()
|
||||
}
|
||||
}
|
||||
|
||||
impl App {
|
||||
/// 当前生效的界面语言（= 目录选择；页面文案一律由它派生）。
|
||||
pub(in crate::app) fn lang(&self) -> Lang {
|
||||
self.lang.lang()
|
||||
}
|
||||
|
||||
/// 设置页语言行要的两件：档位（画选中态）+ 生效语言（画回显）。
|
||||
pub(in crate::app) fn language(&self) -> pages::Language {
|
||||
self.lang.for_settings()
|
||||
}
|
||||
|
||||
/// 换界面语言（设置页语言行 → `pages::Message::Language`）。
|
||||
///
|
||||
/// 三件事缺一不可：①档位与结论换掉 ②视图模型重建（`view_dirty` + `refresh_view`，目录是
|
||||
/// 视图模型的一部分）③落盘（重启后保持所选语言）。字体不在这里重扫：中文档缺字体时的
|
||||
/// 判据/信号归 `i18n::font::decide` + `fonts/cjk.rs`（见报告「没验的部分」）。
|
||||
pub(in crate::app) fn set_language(&mut self, choice: LangChoice) {
|
||||
if choice == self.lang.choice() {
|
||||
return;
|
||||
}
|
||||
self.lang = LangState::of(choice);
|
||||
self.lang.log();
|
||||
if !self.bridge.persist_ui_language(choice.setting_value()) {
|
||||
eprintln!(
|
||||
"[i18n] 语言偏好没落盘（配置只读或数据根解析不出来）：本次生效，重启会回到旧值"
|
||||
);
|
||||
}
|
||||
self.lang.log_cjk();
|
||||
self.view_dirty = true;
|
||||
self.refresh_view();
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_i18n::LangChoice;
|
||||
use unlucky_presenter::mock::MockBackend;
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
|
||||
use crate::app::state::App;
|
||||
use crate::cli::Options;
|
||||
use crate::pages;
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
/// 不碰磁盘的 App（mock 后端 + 内存设置桥），与 `app/tests.rs` 的 `headless` 同型。
|
||||
fn headless() -> App {
|
||||
App::with_presenter(
|
||||
Options::default(),
|
||||
FAMILIES,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(MockBackend::new()),
|
||||
SettingsBridge::memory_only(),
|
||||
)
|
||||
}
|
||||
|
||||
/// M106：设置页语言行点一下 → 生效语言与视图模型都跟着换。
|
||||
///
|
||||
/// 抓得住：①`pages::Message::Language` 没接进 `on_page`（点了没反应，编译器不会报——它接得住，
|
||||
/// 但接错了分支就静默）；②`set_language` 只改字段不重建视图（界面要等下一次刷新才变）；
|
||||
/// ③档位与生效语言各说各话（设置页会画错选中态）。
|
||||
/// 抓不住：界面真的画成中文了没有（那要截图，见 `DevDocs/artifacts/m106/`）。
|
||||
#[test]
|
||||
fn the_language_message_switches_the_catalog_and_rebuilds_the_view() {
|
||||
let mut app = headless();
|
||||
assert_eq!(
|
||||
app.view.lang,
|
||||
app.lang(),
|
||||
"首帧的视图模型要已经按生效语言建好"
|
||||
);
|
||||
|
||||
let _ = app.update(crate::app::message::Message::Page(
|
||||
pages::Message::Language(LangChoice::Fixed(unlucky_i18n::Lang::ZhCn)),
|
||||
));
|
||||
assert_eq!(app.lang(), unlucky_i18n::Lang::ZhCn);
|
||||
assert_eq!(app.view.lang, unlucky_i18n::Lang::ZhCn, "目录要跟着换");
|
||||
assert_eq!(
|
||||
app.language(),
|
||||
pages::Language {
|
||||
choice: LangChoice::Fixed(unlucky_i18n::Lang::ZhCn),
|
||||
effective: unlucky_i18n::Lang::ZhCn,
|
||||
}
|
||||
);
|
||||
|
||||
let refreshes = app.refreshes;
|
||||
let _ = app.update(crate::app::message::Message::Page(
|
||||
pages::Message::Language(LangChoice::Fixed(unlucky_i18n::Lang::En)),
|
||||
));
|
||||
assert_eq!(app.view.lang, unlucky_i18n::Lang::En);
|
||||
assert_eq!(app.refreshes, refreshes + 1, "换语言要重建一次视图模型");
|
||||
|
||||
// 同一档再点一次：什么都不该发生（不白重建）
|
||||
let refreshes = app.refreshes;
|
||||
let _ = app.update(crate::app::message::Message::Page(
|
||||
pages::Message::Language(LangChoice::Fixed(unlucky_i18n::Lang::En)),
|
||||
));
|
||||
assert_eq!(app.refreshes, refreshes, "同一档不该再重建");
|
||||
}
|
||||
|
||||
/// 抓得住：有人给 `on_page` 的 match 重新加 `_ => {}` 兜底 —— 那正是 M94 复审的 p3：
|
||||
/// 兜底让「加了变体忘了接线」从**编译错误**退化成「点了没反应」，这条测试把它拽回来。
|
||||
/// 抓不住：别的兜底写法（把 match 拆成 if-else 链、给子枚举加通配之后再漏变体），
|
||||
/// 也抓不住「加了变体但接错分支」——那两条只有编译器和人读得出来。
|
||||
#[test]
|
||||
fn the_page_match_has_no_wildcard_fallback() {
|
||||
let source = include_str!("page_messages.rs");
|
||||
let wildcards: Vec<(usize, &str)> = source
|
||||
.lines()
|
||||
.enumerate()
|
||||
.filter(|(_, line)| {
|
||||
let trimmed = line.trim();
|
||||
trimmed.starts_with("_ =>") || trimmed.starts_with("_=>")
|
||||
})
|
||||
.map(|(index, line)| (index + 1, line))
|
||||
.collect();
|
||||
|
||||
assert!(
|
||||
wildcards.is_empty(),
|
||||
"on_page 里出现了 `_ =>` 兜底（行 {:?}）：它会取消对 pages::Message 的穷尽性，\
|
||||
新变体漏接线时编译器不再报 E0004",
|
||||
wildcards
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,55 @@
|
||||
//! 设置页分组消息的**二级分发**（M101 `SETTINGSMSG`）：
|
||||
//! `pages::Message::Settings(GroupMessage)` → 四条填页线各自的 handler。
|
||||
//!
|
||||
//! ## 为什么分两级
|
||||
//!
|
||||
//! `app/update/page_messages.rs` 对 [`pages::Message`] 做穷尽匹配（没有 `_ =>`，有
|
||||
//! `the_page_match_has_no_wildcard_fallback` 守门）。设置页的四条填页线若各自往 `pages::Message`
|
||||
//! 里加变体，就都得改那个文件——四路并行必然冲突。M101 把它们收进一个投递口
|
||||
//! `pages::Message::Settings(GroupMessage)`，本文件再把 `GroupMessage` 分给四条线：
|
||||
//!
|
||||
//! ```text
|
||||
//! GroupMessage::Java(m) → settings/java.rs
|
||||
//! GroupMessage::Download(m) → settings/download.rs
|
||||
//! GroupMessage::LanguageAppearance(m) → settings/language_appearance.rs
|
||||
//! GroupMessage::AiAbout(m) → settings/ai_about.rs
|
||||
//! ```
|
||||
//!
|
||||
//! ## 穷尽性：抓得住什么 / 抓不住什么
|
||||
//!
|
||||
//! - **抓得住**：某条线给 `GroupMessage` 加了载荷变体（= 在自己文件里加了一支消息）却忘了在本
|
||||
//! match 里接线 → **E0004**；四个 handler 里对空枚举的 `match message {}` 一旦有人写成
|
||||
//! `_ => {}`，`the_group_dispatch_has_no_wildcard_fallback` 会红（兜底会把「漏接线」从编译
|
||||
//! 错误降级成「点了没反应」，`page_messages.rs` 的同类守卫是这么写的，这里照抄）。
|
||||
//! - **抓不住**：handler 忽略自己的消息（`let _ = message; Task::none()`）、两个 handler 身体写反
|
||||
//! 或写成一样——类型对得上就编得过，只有人读能看出来。也因此「接错了组」的一半是编译期兜住的
|
||||
//! （载荷类型不同 ⇒ 编不过），另一半（接了个空壳）不是。
|
||||
//!
|
||||
//! ## 加一支设置页消息要改哪
|
||||
//!
|
||||
//! 自己那条线的两个文件：消息口（`pages/settings/<线>.rs`）+ 落点（本目录 `<线>.rs`）。
|
||||
//! 本文件的 match 只在 `GroupMessage` **加变体**时才动，而那意味着新增一条线，不是加一支消息。
|
||||
|
||||
use super::*;
|
||||
|
||||
impl App {
|
||||
/// 设置页的分组消息：分给四条线各自的文件，本文件不认识任何一支具体消息。
|
||||
pub(super) fn on_settings(&mut self, message: pages::settings::GroupMessage) -> Task<Message> {
|
||||
match message {
|
||||
pages::settings::GroupMessage::Java(message) => self.on_settings_java(message),
|
||||
pages::settings::GroupMessage::Download(message) => self.on_settings_download(message),
|
||||
pages::settings::GroupMessage::LanguageAppearance(message) => {
|
||||
self.on_settings_language_appearance(message)
|
||||
}
|
||||
pages::settings::GroupMessage::AiAbout(message) => self.on_settings_ai_about(message),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
mod ai_about;
|
||||
mod download;
|
||||
mod java;
|
||||
mod language_appearance;
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
@@ -0,0 +1,17 @@
|
||||
//! AI / About 分组消息的落点（M101 `SETTINGSMSG`）：**只归 ai+about 线**。
|
||||
//!
|
||||
//! 消息口在 `pages/settings/ai_about.rs`（`pages::settings::ai_about::Message`）。
|
||||
//!
|
||||
//! 首版是空枚举上的 `match message {}`：这是**穷尽**的写法（不是兜底），加了变体不接线就报 E0004。
|
||||
|
||||
use super::super::*;
|
||||
|
||||
impl App {
|
||||
/// AI / About 分组的一条消息。首版没有可处理的东西（空枚举）。
|
||||
pub(super) fn on_settings_ai_about(
|
||||
&mut self,
|
||||
message: pages::settings::ai_about::Message,
|
||||
) -> Task<Message> {
|
||||
match message {}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,18 @@
|
||||
//! Downloads 分组消息的落点（M101 `SETTINGSMSG`）：**只归 download 线**。
|
||||
//!
|
||||
//! 消息口在 `pages/settings/download.rs`（`pages::settings::download::Message`）。与下载页
|
||||
//! （`pages/download*` 与 `app/update/download.rs`）无关：那是「装哪个版本」，这一组是「怎么下」。
|
||||
//!
|
||||
//! 首版是空枚举上的 `match message {}`：这是**穷尽**的写法（不是兜底），加了变体不接线就报 E0004。
|
||||
|
||||
use super::super::*;
|
||||
|
||||
impl App {
|
||||
/// Downloads 分组的一条消息。首版没有可处理的东西（空枚举）。
|
||||
pub(super) fn on_settings_download(
|
||||
&mut self,
|
||||
message: pages::settings::download::Message,
|
||||
) -> Task<Message> {
|
||||
match message {}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,33 @@
|
||||
//! Java 分组消息的落点（M101 `SETTINGSMSG`）：**只归 java 线**。
|
||||
//!
|
||||
//! 消息口在 `pages/settings/java.rs`（`pages::settings::java::Message`）。加一支消息 = 改那两个
|
||||
//! 文件，`pages/mod.rs` / `page_messages.rs` / `app/update/settings.rs` 都不用动。
|
||||
//!
|
||||
//! 消息进来的通道有两条，都不经过共享文件：
|
||||
//! 1. **页面点击**：`pages::Message::Settings(GroupMessage::Java(..))` → `on_page` → `on_settings`；
|
||||
//! 2. **异步结果**：本文件自己构造 `Message::Page(pages::Message::Settings(GroupMessage::Java(..)))`
|
||||
//! （`app::Message::Page` 是既有通道，不用加新变体）。
|
||||
//!
|
||||
//! 穷尽性：这里对 `java::Message` 做**穷尽**匹配（没有 `_ =>`、没有 `other =>`）。加了变体不接线
|
||||
//! 立刻 E0004；写成兜底会把编译错误降级成「点了没反应」，`app/update/settings/tests.rs` 的
|
||||
//! `the_group_dispatch_has_no_catch_all_arm` 会红。
|
||||
|
||||
use super::super::*;
|
||||
|
||||
impl App {
|
||||
/// Java 分组的一条消息。
|
||||
pub(super) fn on_settings_java(
|
||||
&mut self,
|
||||
message: pages::settings::java::Message,
|
||||
) -> Task<Message> {
|
||||
match message {
|
||||
// M101 r2 的**活的端到端证据**：只有测试构造这一支（java 线接第一个真控件时换成真变体）。
|
||||
// 它真的改一个 app 状态，所以「消息从外壳走到 handler」这件事有运行时证据，不只是编译期。
|
||||
#[cfg(test)]
|
||||
pages::settings::java::Message::Ping => {
|
||||
self.view_dirty = true;
|
||||
Task::none()
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,19 @@
|
||||
//! 语言 + 外观两组消息的落点（M101 `SETTINGSMSG`）：**只归 language+appearance 线**。
|
||||
//!
|
||||
//! 消息口在 `pages/settings/language_appearance.rs`（`pages::settings::language_appearance::Message`）。
|
||||
//! 为什么两组共用一个消息口：它俩本就是同一条线的两个分组（General 的语言 / 主题 / 启动页，
|
||||
//! Appearance 的密度 / 圆角 / 动效 / 文字缩放），`GroupMessage` 只给这条线留一个变体。
|
||||
//!
|
||||
//! 首版是空枚举上的 `match message {}`：这是**穷尽**的写法（不是兜底），加了变体不接线就报 E0004。
|
||||
|
||||
use super::super::*;
|
||||
|
||||
impl App {
|
||||
/// 语言 / 外观线的一条消息。首版没有可处理的东西（空枚举）。
|
||||
pub(super) fn on_settings_language_appearance(
|
||||
&mut self,
|
||||
message: pages::settings::language_appearance::Message,
|
||||
) -> Task<Message> {
|
||||
match message {}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,267 @@
|
||||
//! 设置页分组消息分发的**守门测试**（M101 `SETTINGSMSG`）。
|
||||
//!
|
||||
//! 判据与 `app/update/page_messages.rs` 里那条 `the_page_match_has_no_wildcard_fallback` 同源：
|
||||
//! 兜底会把「加了变体忘了接线」从**编译错误**降级成「点了没反应」。两级 dispatch 各守一条：
|
||||
//! 那一层守 `pages::Message`，本文件守 `GroupMessage` 与四个 handler。
|
||||
//!
|
||||
//! ## 判据（r2 复审 P2-3 之后收窄过一次）
|
||||
//!
|
||||
//! 上一版的判据是「除已知前缀外，任何含 `=>` 的行都算兜底」——**过宽**：往 handler 里加一个
|
||||
//! **没有兜底臂**的嵌套 match（`match true { true => …, false => … }`），或者 rustfmt 把长
|
||||
//! or-pattern 折行成 `| X =>`，都会让它假红。四条填页线一写真实逻辑就撞，守门反而推高成本。
|
||||
//!
|
||||
//! 现在的判据是**结构化的**：只找 `match message {` 这一层（用大括号深度计数把嵌套 match 排除
|
||||
//! 在外），**只看深度 1 的臂**——
|
||||
//!
|
||||
//! - `app/update/settings.rs` 的 `on_settings`：恰好 **4 条**臂，每条以 `pages::settings::GroupMessage::`
|
||||
//! （或短写 `GroupMessage::`）开头；
|
||||
//! - 四个 handler：每条臂以该组自己的 `pages::settings::<线>::Message::`（或短写 `Message::`）开头，
|
||||
//! 还没有臂的（空枚举 `match message {}`）一条臂都没有；
|
||||
//! - 以 `|` 开头的折行 or-pattern 续行放行（它不可能是兜底）。
|
||||
//!
|
||||
//! ## 抓得住什么 / 抓不住什么
|
||||
//!
|
||||
//! 抓得住：
|
||||
//! 1. `on_settings` 里加 `_ =>` 或 binding 臂 `other =>`（`GroupMessage` 不再穷尽）；
|
||||
//! 2. handler 把 `match message {}` 改成 `_ => Task::none()` / `other => { … }`；
|
||||
//! 3. `on_settings` 的臂数不是 4（删了一条、或把两条合并）；
|
||||
//! 4. handler 的臂写成别的组的变体路径（前缀不对）。
|
||||
//!
|
||||
//! 抓不住（老实列出来）：
|
||||
//! 1. **嵌套 match 里的兜底**——深度 ≥2 的臂不看。这是刻意的：嵌套 match 的穷尽性由它自己的类型
|
||||
//! 保证，跟 `GroupMessage` 漏接线无关；代价是没人守「嵌套 match 自己写了个 `_ =>`」；
|
||||
//! 2. **跨行 pattern 分两种，别当一种**：以 `|` 开头的 or-pattern 续行**放行**（不误红）；
|
||||
//! 但**花括号形状**的多行 pattern（例如 `Message::SetRuntime {` 折成多行、`=>` 落在后面）
|
||||
//! 会被**静默跳过**——那一行不带 `=>`，于是既不算臂也不算违规（臂数 0、零违规），是**漏检**
|
||||
//! 而不是误红。两种都是洞，当前代码风格都不出现；真要用这种写法时把规则补上，别把守门删掉；
|
||||
//! 3. **字符串/字符字面量里的 `{` `}`** 会扰乱深度计数（本文件与四个 handler 都没有这种写法）；
|
||||
//! 4. handler 忽略消息（`let _ = message; Task::none()`）、两个 handler 身体写反或写成一样
|
||||
//! ——类型对得上就编得过，只有人读能看出来；
|
||||
//! 5. `match message` 被改名或换变量名时找不到匹配，臂数为 0 —— 这时
|
||||
//! `the_group_dispatch_has_exactly_four_arms` 会红（不是静默通过）。
|
||||
//!
|
||||
//! 站位：本文件是 `app::update::settings::tests`，`include_str!` 的路径相对本文件所在目录。
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_presenter::mock::MockBackend;
|
||||
use unlucky_presenter::settings_bridge::SettingsBridge;
|
||||
|
||||
use crate::app::message::Message;
|
||||
use crate::app::state::App;
|
||||
use crate::cli::Options;
|
||||
use crate::pages;
|
||||
use crate::theme::Families;
|
||||
|
||||
/// `on_settings` 的臂允许的前缀。
|
||||
const GROUP_ARMS: &[&str] = &["pages::settings::GroupMessage::", "GroupMessage::"];
|
||||
|
||||
/// 一行的净大括号增量（`{` 加、`}` 减）。
|
||||
fn brace_delta(line: &str) -> i32 {
|
||||
let open = line.matches('{').count() as i32;
|
||||
let close = line.matches('}').count() as i32;
|
||||
open - close
|
||||
}
|
||||
|
||||
/// 扫一条 `match message { … }`，只看**本层**（深度 1）的臂。
|
||||
///
|
||||
/// 返回 `(本层的合法臂数, 违规行)`：违规 = 本层里含 `=>`、又不是「已知前缀开头」的行
|
||||
/// （`|` 开头的折行 or-pattern 续行放行）。嵌套 match 的臂在深度 ≥2，整段跳过。
|
||||
fn dispatch_arms(path: &str, source: &str, allowed: &[&str]) -> (usize, Vec<String>) {
|
||||
let mut arms = 0usize;
|
||||
let mut offending = Vec::new();
|
||||
let mut depth = 0i32;
|
||||
let mut inside = false;
|
||||
|
||||
for (index, line) in source.lines().enumerate() {
|
||||
let trimmed = line.trim();
|
||||
if trimmed.starts_with("//") {
|
||||
continue;
|
||||
}
|
||||
|
||||
if !inside {
|
||||
if trimmed.contains("match message {") {
|
||||
inside = true;
|
||||
depth = 1;
|
||||
}
|
||||
continue;
|
||||
}
|
||||
|
||||
if depth == 1 && trimmed.contains("=>") {
|
||||
let pattern = trimmed.trim_start_matches('|').trim_start();
|
||||
if allowed.iter().any(|prefix| pattern.starts_with(prefix)) {
|
||||
arms += 1;
|
||||
} else if !trimmed.starts_with('|') {
|
||||
offending.push(format!("{path}:{}: {trimmed}", index + 1));
|
||||
}
|
||||
}
|
||||
|
||||
depth += brace_delta(trimmed);
|
||||
if depth <= 0 {
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
(arms, offending)
|
||||
}
|
||||
|
||||
/// 不碰磁盘的 App（mock 后端 + 内存设置桥），与 `app/tests.rs` 的 `headless` 同一副骨架。
|
||||
fn headless() -> App {
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
App::with_presenter(
|
||||
Options::default(),
|
||||
FAMILIES,
|
||||
SchemeFlavor::Light,
|
||||
Box::new(MockBackend::new()),
|
||||
SettingsBridge::memory_only(),
|
||||
)
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------- 守门本体
|
||||
|
||||
/// `on_settings` 与四个 handler 的**本层**臂里不许出现任何形式的兜底（`_ =>` 或 `other =>`）。
|
||||
#[test]
|
||||
fn the_group_dispatch_has_no_catch_all_arm() {
|
||||
let sources: [(&str, &str, &[&str]); 5] = [
|
||||
(
|
||||
"app/update/settings.rs",
|
||||
include_str!("../settings.rs"),
|
||||
GROUP_ARMS,
|
||||
),
|
||||
(
|
||||
"app/update/settings/java.rs",
|
||||
include_str!("java.rs"),
|
||||
&["pages::settings::java::Message::", "Message::"],
|
||||
),
|
||||
(
|
||||
"app/update/settings/download.rs",
|
||||
include_str!("download.rs"),
|
||||
&["pages::settings::download::Message::", "Message::"],
|
||||
),
|
||||
(
|
||||
"app/update/settings/language_appearance.rs",
|
||||
include_str!("language_appearance.rs"),
|
||||
&[
|
||||
"pages::settings::language_appearance::Message::",
|
||||
"Message::",
|
||||
],
|
||||
),
|
||||
(
|
||||
"app/update/settings/ai_about.rs",
|
||||
include_str!("ai_about.rs"),
|
||||
&["pages::settings::ai_about::Message::", "Message::"],
|
||||
),
|
||||
];
|
||||
|
||||
let mut offending = Vec::new();
|
||||
for (path, source, allowed) in sources {
|
||||
let (_, bad) = dispatch_arms(path, source, allowed);
|
||||
offending.extend(bad);
|
||||
}
|
||||
|
||||
assert!(
|
||||
offending.is_empty(),
|
||||
"设置页分组消息的 dispatch 本层出现了兜底臂（{offending:?}）：\
|
||||
任何 catch-all / binding 臂都会取消 `GroupMessage` 的穷尽性，\
|
||||
新变体漏接线时编译器不再报 E0004"
|
||||
);
|
||||
}
|
||||
|
||||
/// `on_settings` 必须**恰好四条**臂，一条一条显式写全（不是「至少」）。
|
||||
///
|
||||
/// 抓得住：删掉一条臂、把两条合并、或者把 `match message` 改名（改名后扫不到臂 ⇒ 0 ≠ 4）。
|
||||
/// 抓不住：臂的顺序（顺序不影响语义）、每条臂接到了哪个 handler（类型对得上就编得过）。
|
||||
#[test]
|
||||
fn the_group_dispatch_has_exactly_four_arms() {
|
||||
let (arms, _) = dispatch_arms(
|
||||
"app/update/settings.rs",
|
||||
include_str!("../settings.rs"),
|
||||
GROUP_ARMS,
|
||||
);
|
||||
|
||||
assert_eq!(
|
||||
arms, 4,
|
||||
"`on_settings` 应该恰好四条臂（java / download / language_appearance / ai_about），实际 {arms} 条"
|
||||
);
|
||||
}
|
||||
|
||||
/// **守门自身不误伤**：嵌套 match 与折行的 or-pattern 都不算兜底（r2 复审 P2-3 的探针）。
|
||||
///
|
||||
/// 这条是上一版判据假红的回归测试：复审往 handler 里加 `match true { true => …, false => … }`
|
||||
/// 就让它 FAILED；现在这类写法必须放行。
|
||||
#[test]
|
||||
fn the_guard_ignores_nested_matches_and_folded_or_patterns() {
|
||||
let synthetic = "\
|
||||
impl App {
|
||||
fn on_settings_java(&mut self, message: pages::settings::java::Message) -> Task<Message> {
|
||||
match message {
|
||||
pages::settings::java::Message::Probe => {
|
||||
let nested = match true { true => 10u8, false => 11u8 };
|
||||
let _ = nested;
|
||||
Task::none()
|
||||
}
|
||||
| pages::settings::java::Message::Retry => Task::none(),
|
||||
}
|
||||
}
|
||||
}
|
||||
";
|
||||
|
||||
let (arms, offending) = dispatch_arms(
|
||||
"synthetic",
|
||||
synthetic,
|
||||
&["pages::settings::java::Message::"],
|
||||
);
|
||||
assert!(
|
||||
offending.is_empty(),
|
||||
"正常代码被误判成兜底（这正是 r2 复审 P2-3 的假红）：{offending:?}"
|
||||
);
|
||||
assert_eq!(arms, 2, "嵌套 match 里的两条臂不算本层臂");
|
||||
}
|
||||
|
||||
/// **守门仍然有牙**：`_ =>` 与 binding 臂 `other =>` 都要被本层判成兜底。
|
||||
#[test]
|
||||
fn the_guard_still_catches_both_catch_all_shapes() {
|
||||
for arm in [
|
||||
"_ => Task::none(),",
|
||||
"other => { let _ = other; Task::none() }",
|
||||
] {
|
||||
let synthetic = format!(
|
||||
"impl App {{\n fn on_settings_java(&mut self, message: M) -> Task<Message> {{\n match message {{\n {arm}\n }}\n }}\n}}\n"
|
||||
);
|
||||
let (_, offending) = dispatch_arms("synthetic", &synthetic, GROUP_ARMS);
|
||||
assert_eq!(
|
||||
offending.len(),
|
||||
1,
|
||||
"`{arm}` 是兜底，必须被判红（实际 {offending:?}）"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------- 活的端到端证据
|
||||
|
||||
/// **活的端到端证据**：一条组消息真的从外壳那条既有通道走到该组的 handler（r1 复审要求）。
|
||||
///
|
||||
/// 路径：`app::Message::Page` → `on_page` → `pages::Message::Settings` → `on_settings` →
|
||||
/// `on_settings_java`，最后改到 `App` 的状态。r1 之前这条链只有编译期证据（`GroupMessage` 是
|
||||
/// uninhabited，运行时是死代码）；现在至少有一支真的跑得起来。
|
||||
///
|
||||
/// 抓得住：漏斗某一环接断了（`on_page` 没转交、`on_settings` 转错组、handler 忽略消息）——那时
|
||||
/// `view_dirty` 不会翻。抓不住：真实用户点击（本条没有 UI 控件，构造点只有测试）。
|
||||
#[test]
|
||||
fn a_group_message_reaches_its_handler_through_the_funnel() {
|
||||
let mut app = headless();
|
||||
app.view_dirty = false;
|
||||
|
||||
let _ = app.update(Message::Page(pages::Message::Settings(
|
||||
pages::settings::GroupMessage::Java(pages::settings::java::Message::Ping),
|
||||
)));
|
||||
|
||||
assert!(
|
||||
app.view_dirty,
|
||||
"java 线的消息没有走到 `on_settings_java`：消息漏斗在某一环断了"
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,195 @@
|
||||
//! `view`：presenter 快照 → 页面视图模型 → 控件树。
|
||||
//!
|
||||
//! 展示转换（快照字段 → 显示文本/网格）**全部在这里**，页面层只认 [`pages::Model`]。
|
||||
//!
|
||||
//! 实例页那一段（`1.20.4 · Fabric`、运行状态、元信息卡）M120 搬进 [`instances`]：本文件
|
||||
//! 当时贴着 400 行硬线，而 i18n 还要在这个函数里接一批阶段标签。
|
||||
|
||||
use iced::{Element, Theme};
|
||||
|
||||
use unlucky_i18n::Lang;
|
||||
use unlucky_presenter::router::Route;
|
||||
use unlucky_presenter::state::AppState;
|
||||
|
||||
use crate::app::components::interaction::Interaction;
|
||||
use crate::cli::Screen;
|
||||
use crate::pages::{self, Row};
|
||||
use crate::shell::{self, agent, NavItem};
|
||||
|
||||
use super::message::{nav_item_of, Message};
|
||||
use super::state::{log_first_frame, App};
|
||||
use super::APP_TITLE;
|
||||
|
||||
mod account_page;
|
||||
mod instances;
|
||||
mod logs;
|
||||
mod rail;
|
||||
|
||||
use instances::{detail_of, runtime_status, supporting_line};
|
||||
use logs::logs_model;
|
||||
|
||||
impl App {
|
||||
/// 主题名（iced 只在 `Theme::name()` 变化时重算受主题影响的缓存）。
|
||||
pub(super) fn theme(&self) -> Theme {
|
||||
self.ui().theme()
|
||||
}
|
||||
|
||||
/// 窗口标题（自绘标题栏另画一份，这里是给系统/截图工具看的）。
|
||||
pub(super) fn title(&self) -> String {
|
||||
APP_TITLE.to_owned()
|
||||
}
|
||||
|
||||
/// 整棵树。
|
||||
pub(super) fn view(&self) -> Element<'_, Message> {
|
||||
log_first_frame();
|
||||
|
||||
// `--screen=gallery`：组件库 harness（D39 §5）。它用自己的 DemoMessage，
|
||||
// 这里只做一次 map，组件库与业务 Message 依然解耦。
|
||||
if self.options.screen == Screen::Gallery {
|
||||
return super::components::gallery::view(&self.ui).map(Message::Demo);
|
||||
}
|
||||
|
||||
// 产品页走**内容槽位**：外壳（标题栏 / 拖动与缩放热区 / 三个 caption 键 / rail）由
|
||||
// `shell` 画，中间那块才是页面（`DragWindow`/`ResizeStart`/`Minimize`/`ToggleMaximize`/`Close`
|
||||
// 五种消息的构造点只在外壳里，页面树自己画的标题栏拖不动窗口）。
|
||||
//
|
||||
// M93：三样东西从外观状态进来——①背景层（垫在最底下）②面板 α（外壳层的底色）③设置页要读
|
||||
// 的那份状态。M101 r2 起 ③ 走 `page_with_settings`：外观状态 + 各组自己的状态一起递进去。
|
||||
let background =
|
||||
pages::appearance::layer(&self.ui, &self.appearance, (self.width, self.height))
|
||||
.map(|element| element.map(Message::Page));
|
||||
// 右栗（M104）：拆出档返回 `None`（会话已在独立页里）；拖拽期间另有铺满窗口的取指针层。
|
||||
let overlay = agent::drag_overlay(&self.agent).map(|element| element.map(Message::Agent));
|
||||
// M119：会话内容 / 未读 / busy / 待确认全部来自 presenter 的 rail，失败横幅是 app 层
|
||||
// 备好的**展示输入**（标题 catalog 键 + 已脱敏正文）。壳在这里不做任何脱敏。
|
||||
// 界面语言的真值源是 `App::lang`（M106）：右栏的静态文案也走它，不再有 `const LANG`
|
||||
let agent_catalog = self.lang().catalog();
|
||||
// 会话入参：rail 借 presenter、失败横幅由 app 层备好、`simulated` 是后端的事实
|
||||
let session = agent::Session {
|
||||
agent: &self.agent,
|
||||
rail: self.agent_host.rail(),
|
||||
failure: self.agent_failure(),
|
||||
simulated: self.agent_host.is_simulated(),
|
||||
};
|
||||
|
||||
let account = self.rail_account();
|
||||
match pages::Screen::of(self.state.route()) {
|
||||
Some(_) => shell::view_with_account(
|
||||
&self.ui,
|
||||
shell::NavRail {
|
||||
selected: nav_item_of(self.state.route()),
|
||||
account: account.clone(),
|
||||
},
|
||||
APP_TITLE,
|
||||
background,
|
||||
// M101 r2：设置页的只读状态（外观运行期状态 + 各组自己的状态）一次递进去。
|
||||
pages::page_with_settings(
|
||||
&self.ui,
|
||||
&self.view,
|
||||
pages::settings::States {
|
||||
appearance: Some(&self.appearance),
|
||||
groups: &self.settings,
|
||||
},
|
||||
// M106：设置页 General 组要画「当前档位 + 生效语言」。
|
||||
self.language(),
|
||||
)
|
||||
.map(Message::Page),
|
||||
agent::docked(&self.ui, session, agent_catalog, self.width)
|
||||
.map(|element| element.map(Message::Agent)),
|
||||
overlay,
|
||||
self.options.force_state,
|
||||
self.lang(),
|
||||
),
|
||||
// 账户页（M114）：它不走 `pages::Screen` 那四页的 `Model`，自己一棵树
|
||||
// （树在 `app/view/account_page.rs`，与其它页共用 M104 的中栏可用宽）。
|
||||
None if self.state.route() == &Route::Accounts => {
|
||||
self.account_page(&account, background, overlay)
|
||||
}
|
||||
// `Route::Agent`：独立页与右栏共用同一个 `conversation::view`（`agent::page` 内部调的它）。
|
||||
None => shell::view_with_account(
|
||||
&self.ui,
|
||||
shell::NavRail {
|
||||
selected: NavItem::Ai,
|
||||
account: account.clone(),
|
||||
},
|
||||
APP_TITLE,
|
||||
background,
|
||||
agent::page(&self.ui, session, agent_catalog, self.width).map(Message::Agent),
|
||||
None,
|
||||
overlay,
|
||||
self.options.force_state,
|
||||
self.lang(),
|
||||
),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------- 快照 → 视图模型
|
||||
|
||||
/// 把 presenter 的快照转成页面视图模型（**唯一**的展示转换点）。
|
||||
///
|
||||
/// `forced` 是 `--force-state` 的落点（P3-1）：它只影响**画出来的**状态层，不改任何状态机。
|
||||
///
|
||||
/// `width` 是**中栗可用宽度**（窗口 − 右栗 − 拖拽缝，由 `AgentUi::content_width` 算），不是窗口宽：
|
||||
/// 页面布局系统仍按「一个窗口宽」扣左轨与页边距，所以右栗占掉的那一段必须在这里先减掉——
|
||||
/// 否则助手栏一展开，页面还按 1180 排版，内容就顶到面板底下了（任务里的「收缩而不是溢出」）。
|
||||
pub(super) fn model(
|
||||
state: &AppState,
|
||||
width: f32,
|
||||
forced: Option<crate::cli::ForcedState>,
|
||||
category: pages::Category,
|
||||
draft: &pages::InstallDraft,
|
||||
lang: Lang,
|
||||
content: &pages::content::PageState,
|
||||
) -> pages::Model {
|
||||
let route = state.route().clone();
|
||||
let screen = pages::Screen::of(&route).unwrap_or(pages::Screen::Instances);
|
||||
// 实例页的文案真源：`App::lang` 的目录（M120）。列表 overline / 元信息标签 / 空态都从它取。
|
||||
let catalog = lang.catalog();
|
||||
|
||||
let rows: Vec<Row> = state
|
||||
.tiles()
|
||||
.into_iter()
|
||||
.map(|cell| Row {
|
||||
id: cell.instance.id.clone(),
|
||||
name: cell.instance.name.clone(),
|
||||
supporting: supporting_line(cell.instance, catalog),
|
||||
status: runtime_status(&cell.instance.runtime, catalog),
|
||||
})
|
||||
.collect();
|
||||
|
||||
let detail = match &route {
|
||||
Route::Detail(id) => state
|
||||
.instances
|
||||
.iter()
|
||||
.find(|instance| &instance.id == id)
|
||||
.map(|instance| detail_of(instance, catalog)),
|
||||
_ => None,
|
||||
};
|
||||
|
||||
pages::Model {
|
||||
screen,
|
||||
window_width: width,
|
||||
active: route.nav(),
|
||||
instances: pages::Instances { rows, detail },
|
||||
download: pages::Download::from_snapshot(state, category, draft, lang.catalog()),
|
||||
// M109：检索条件/结果来自快照，页面内选择（类型/选中/目标/草稿）来自 `App::content`
|
||||
content: pages::content::Content::from_snapshot(state, content, lang.catalog()),
|
||||
logs: logs_model(state).with_status(lang),
|
||||
lang,
|
||||
forced: forced.map(|state| match state {
|
||||
// `Rest` = 常态（压掉系统光标 hover）；`Interaction::Enabled` 就是静息态，不叠状态层。
|
||||
crate::cli::ForcedState::Rest => Interaction::Enabled,
|
||||
crate::cli::ForcedState::Hover => Interaction::Hovered,
|
||||
crate::cli::ForcedState::Pressed => Interaction::Pressed,
|
||||
}),
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
#[path = "view/tests.rs"]
|
||||
mod tests;
|
||||
|
||||
/// 测试只借这一条（其余三条 `model()` 自己用）。
|
||||
#[cfg(test)]
|
||||
use instances::last_played;
|
||||
@@ -0,0 +1,73 @@
|
||||
//! 账户页（M114）的**整页装配**：从 `App` 的状态拼出内容树，再交给外壳。
|
||||
//!
|
||||
//! 为什么单独一个文件：`app/view.rs` 贴着 400 行硬线（M104 的右栏分支已经把余量吃掉了），
|
||||
//! 而这段是纯装配（没有状态数学），搬出来不改变任何语义。
|
||||
//!
|
||||
//! 宽度口径：用 `AccountPage::width`（= M104 的 `AgentUi::content_width`，中栏可用宽），
|
||||
//! 与其它页、与 `refresh_view` 同一份来源——右栏展开时账户页**一起收缩**，不会顶到面板底下。
|
||||
|
||||
use iced::Element;
|
||||
|
||||
use crate::app::Message;
|
||||
use crate::pages;
|
||||
use crate::pages::account::Page as AccountPage;
|
||||
use crate::shell::{self, agent, NavItem, RailAccount};
|
||||
|
||||
use super::super::state::App;
|
||||
use super::super::APP_TITLE;
|
||||
|
||||
impl App {
|
||||
/// 账户页视图模型的重建（`refresh_view` 的账户那一步）。
|
||||
///
|
||||
/// 与 `view` 同一次门控；语言跟着 M106 的 `LangState` 走（M114 早期钉死 `Lang::En`
|
||||
/// 的写法已删），宽度用 M104 的中栏可用宽。放在这里是为了让 `app/state.rs` 守住 400 行。
|
||||
pub(in crate::app) fn rebuild_account_page(&mut self, width: f32) {
|
||||
let lang = self.lang();
|
||||
self.account = AccountPage::build(
|
||||
&self.state,
|
||||
&self.account_form,
|
||||
&mut self.avatars,
|
||||
lang,
|
||||
width,
|
||||
);
|
||||
}
|
||||
|
||||
/// 账户页（走 `pages::account` 自己的树，而不是 `pages::Screen` 那四页的 `Model`）。
|
||||
pub(super) fn account_page<'a>(
|
||||
&'a self,
|
||||
account: &RailAccount,
|
||||
background: Option<Element<'a, Message>>,
|
||||
overlay: Option<Element<'a, Message>>,
|
||||
) -> Element<'a, Message> {
|
||||
let metrics =
|
||||
pages::layout::frame_metrics(pages::layout::PaneKit::Single, self.account.width);
|
||||
shell::view_with_account(
|
||||
&self.ui,
|
||||
shell::NavRail {
|
||||
selected: NavItem::Account,
|
||||
account: account.clone(),
|
||||
},
|
||||
APP_TITLE,
|
||||
background,
|
||||
// M106：账户页的文案跟着**生效语言**走（`LangState::boot` 自己读 `ULL_LANG`，
|
||||
// 所以 M114 早期那个「截图专用语言开关」已删——两套开关必然漂）。
|
||||
pages::account::view(&self.ui, metrics, &self.account, self.lang()).map(Message::Page),
|
||||
// M119：右栗的会话内容 / 未读 / busy 全部来自 presenter 的 rail（`agent_host`）
|
||||
agent::docked(
|
||||
&self.ui,
|
||||
agent::Session {
|
||||
agent: &self.agent,
|
||||
rail: self.agent_host.rail(),
|
||||
failure: self.agent_failure(),
|
||||
simulated: self.agent_host.is_simulated(),
|
||||
},
|
||||
self.lang().catalog(),
|
||||
self.width,
|
||||
)
|
||||
.map(|element| element.map(Message::Agent)),
|
||||
overlay,
|
||||
self.options.force_state,
|
||||
self.lang(),
|
||||
)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,162 @@
|
||||
//! 实例页的**展示转换**（M120 从 `app/view.rs` 原样搬出：那边给 i18n 让出行数）。
|
||||
//!
|
||||
//! | 函数 | 产物 | 谁读 |
|
||||
//! |---|---|---|
|
||||
//! | [`supporting_line`] | 列表行 / 详情副标题 `1.20.4 · Fabric 0.16.5` | [`crate::pages::Row`] / [`crate::pages::Detail`] |
|
||||
//! | [`runtime_status`] | 运行状态行（列表 overline + 详情状态行共用一份） | 同上 |
|
||||
//! | [`detail_of`] | 详情列的全部字段 | [`crate::pages::Detail`] |
|
||||
//! | [`last_played`] | `2026-10-29 19:22 UTC` / `Never` | 元信息卡 `LAST PLAYED` |
|
||||
//!
|
||||
//! 这里只做「快照字段 → 要画什么」，不碰控件树。**文案的语言由调用方的 [`Catalog`] 决定**
|
||||
//! （`view::model` 把 `App::lang` 的目录传进来），不再是 M90 时期的英文基线字面量。
|
||||
//!
|
||||
//! ## 两条接法上的取舍
|
||||
//!
|
||||
//! 1. **原版徽标走词表**：`LoaderInfo::badge()` 对原版返回**中文**「原版」（那是 presenter 的
|
||||
//! 面向中文日志的 `label()`），英文界面里直接画它就是「中文漏进英文界面」。所以原版这一支
|
||||
//! 改走 [`Key::LoaderVanilla`]，装加载器时仍是 `Fabric 0.16.5`（品牌 + 版本号，不翻译）；
|
||||
//! 2. **运行状态只翻标签本体**：`Running · pid 1234` → `运行中 · pid 1234`，`pid` 与数字、
|
||||
//! `·` 分隔符一个字都不动（[`Key::InstancesRunning`] 的占位符只有 `{pid}`）。
|
||||
|
||||
use unlucky_i18n::{Catalog, Key};
|
||||
use unlucky_presenter::dto::{InstanceRuntime, InstanceSummary, LaunchStage, LoaderKind};
|
||||
|
||||
use crate::pages::{Detail, Meta};
|
||||
|
||||
/// 列表行的副文案：`1.20.4 · Fabric 0.16.5`（原版只写「原版 / Vanilla」，见 [`loader_badge`]）。
|
||||
pub(super) fn supporting_line(instance: &InstanceSummary, catalog: Catalog) -> String {
|
||||
format!(
|
||||
"{} · {}",
|
||||
instance.mc_version,
|
||||
loader_badge(instance, catalog)
|
||||
)
|
||||
}
|
||||
|
||||
/// 加载器徽标：原版走词表，其余交给 `LoaderInfo::badge()`（品牌 + 版本号，原样）。
|
||||
///
|
||||
/// **判据只能是「加载器类型本身是原版」**。曾经写成「原版 **或** 版本号为空」⇒
|
||||
/// `1.20.1-forge` / `1.20.1-neoforge` / `1.20.1-OptiFine` 这类**取不到版本段**的 id（`badge()`
|
||||
/// 对它们给的就是品牌名 `Forge` / `NeoForge` / `OptiFine`）会被显示成「原版 / Vanilla」——
|
||||
/// 那是 M120 r1 的 p2-1 回归，`the_loader_badge_keeps_the_brand_when_the_version_is_missing` 守着。
|
||||
fn loader_badge(instance: &InstanceSummary, catalog: Catalog) -> String {
|
||||
match instance.loader.kind {
|
||||
// 唯一需要过词表的一支：`LoaderKind::label()` 对原版返回的是**中文**「原版」
|
||||
LoaderKind::Vanilla => catalog.text(Key::LoaderVanilla).to_string(),
|
||||
// 其余品牌名不翻译；版本号为空时 `badge()` 自己就只给品牌名
|
||||
_ => instance.loader.badge(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 隔离档位：`isolated` / `shared` 是两个稳定 id（`core::game::IsolationMode::as_str`），
|
||||
/// 直接上屏就是英文界面漏中文、中文界面漏英文。只认这两档，**其余原样**（`inherit` / `custom` /
|
||||
/// 未来新增的值不许在这里被猜成一个意思）。
|
||||
fn isolation(raw: &str, catalog: Catalog) -> String {
|
||||
match raw {
|
||||
"isolated" => catalog.text(Key::InstancesIsolationIsolated).to_string(),
|
||||
"shared" => catalog.text(Key::InstancesIsolationShared).to_string(),
|
||||
other => other.to_string(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 运行状态（列表行的 overline 与详情页的状态行共用一份文案）。
|
||||
pub(super) fn runtime_status(runtime: &InstanceRuntime, catalog: Catalog) -> Option<String> {
|
||||
match runtime {
|
||||
InstanceRuntime::Idle => None,
|
||||
// 「阶段 · 百分比」：百分比是数字，不过词表；只有阶段名换语言
|
||||
InstanceRuntime::Busy { stage, progress } => Some(format!(
|
||||
"{} · {:.0}%",
|
||||
stage_label(*stage, catalog),
|
||||
progress.ratio() * 100.0
|
||||
)),
|
||||
InstanceRuntime::Running { pid } => {
|
||||
Some(catalog.render(Key::InstancesRunning, &[("pid", &pid.to_string())]))
|
||||
}
|
||||
// `reason` 是 core 给的诊断原文（**数据**，不翻译）；只有前半句是界面文案
|
||||
InstanceRuntime::Failed { reason } => {
|
||||
Some(catalog.render(Key::InstancesFailed, &[("reason", reason)]))
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 阶段文案：**不**复用 `LaunchStage::label()`（那是核心层的中文诊断串，英文界面会漏中文）。
|
||||
fn stage_label(stage: LaunchStage, catalog: Catalog) -> &'static str {
|
||||
catalog.text(match stage {
|
||||
LaunchStage::Download => Key::InstancesStageDownload,
|
||||
LaunchStage::Verify => Key::InstancesStageVerify,
|
||||
LaunchStage::Launch => Key::InstancesStageLaunch,
|
||||
LaunchStage::Window => Key::InstancesStageWindow,
|
||||
})
|
||||
}
|
||||
|
||||
/// 详情列的内容（字段全部来自 [`InstanceSummary`]）。
|
||||
pub(super) fn detail_of(instance: &InstanceSummary, catalog: Catalog) -> Detail {
|
||||
Detail {
|
||||
id: instance.id.clone(),
|
||||
name: instance.name.clone(),
|
||||
subtitle: supporting_line(instance, catalog),
|
||||
meta: vec![
|
||||
meta(
|
||||
catalog.text(Key::InstancesMetaVersion),
|
||||
&instance.mc_version,
|
||||
),
|
||||
meta(
|
||||
catalog.text(Key::InstancesMetaLoader),
|
||||
&loader_badge(instance, catalog),
|
||||
),
|
||||
meta(
|
||||
catalog.text(Key::InstancesMetaIsolation),
|
||||
&isolation(&instance.isolation, catalog),
|
||||
),
|
||||
meta(
|
||||
catalog.text(Key::InstancesMetaVersionId),
|
||||
&instance.version_id,
|
||||
),
|
||||
meta(
|
||||
catalog.text(Key::InstancesMetaFiles),
|
||||
catalog.text(if instance.version_present {
|
||||
Key::InstancesPresentOnDisk
|
||||
} else {
|
||||
Key::InstancesMissing
|
||||
}),
|
||||
),
|
||||
meta(
|
||||
catalog.text(Key::InstancesMetaLastPlayed),
|
||||
&last_played(instance.last_played.as_deref(), catalog),
|
||||
),
|
||||
],
|
||||
// 真快照没有「正文描述」这种字段（偏离 #9）：演示数据才有正文段
|
||||
note: None,
|
||||
status: runtime_status(&instance.runtime, catalog),
|
||||
can_launch: matches!(
|
||||
instance.runtime,
|
||||
InstanceRuntime::Idle | InstanceRuntime::Failed { .. }
|
||||
),
|
||||
can_stop: matches!(
|
||||
instance.runtime,
|
||||
InstanceRuntime::Busy { .. } | InstanceRuntime::Running { .. }
|
||||
),
|
||||
}
|
||||
}
|
||||
|
||||
fn meta(label: &str, value: &str) -> Meta {
|
||||
Meta {
|
||||
label: label.to_string(),
|
||||
value: value.to_string(),
|
||||
}
|
||||
}
|
||||
|
||||
/// ISO-8601（`2026-10-29T19:22:00Z`）→ `2026-10-29 19:22 UTC`；`None` = 从未启动。
|
||||
///
|
||||
/// 只做切片不做时区换算：core 给的是 UTC，`Z` 就是它的时区；本地时区换算等时间格式 mission。
|
||||
/// 非 ASCII 或长度不足时原样返回（不 panic、不猜）。
|
||||
pub(super) fn last_played(raw: Option<&str>, catalog: Catalog) -> String {
|
||||
let Some(text) = raw else {
|
||||
return catalog.text(Key::InstancesNeverPlayed).to_string();
|
||||
};
|
||||
match (text.get(0..10), text.get(11..16)) {
|
||||
(Some(date), Some(time)) if date.starts_with(|c: char| c.is_ascii_digit()) => {
|
||||
format!("{date} {time} UTC")
|
||||
}
|
||||
_ => text.to_string(),
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,144 @@
|
||||
//! 日志页的展示转换：presenter 快照 → [`pages::Logs`]（从 `app/view.rs` 拆出来，M95 r3）。
|
||||
//!
|
||||
//! ## 跨会话串场（M95 r3 的 p2，代码复审抓的）
|
||||
//!
|
||||
//! r2 的写法先按 `state.diagnosis` 定「这是哪一场」：
|
||||
//!
|
||||
//! ```ignore
|
||||
//! let session = report.and_then(|r| log_sessions.find(|s| s.id == r.session)).or_else(|| …selected…);
|
||||
//! ```
|
||||
//!
|
||||
//! 而 `state.diagnosis` **全仓只写不清**（`presenter::state::apply_core` 里
|
||||
//! `CoreEvent::DiagnosisReady` 是唯一赋值点，没有任何清零点），host 也只在崩溃 / 打开会话 /
|
||||
//! 导入崩溃文件时发它。于是「崩溃一场 → 再启动一场正常跑」这个最普通的路径下：
|
||||
//! 页头把**新**会话标成上一场的 `The game crashed`、诊断卡挂着上一场的结论，而用户复制去贴
|
||||
//! issue 的摘要里 `lines=` 是新的那一场的行数——**结论与行数不同源**，用户会把错诊断递出去。
|
||||
//!
|
||||
//! 现在的口径（不动 presenter 的写入口，只在页面侧判别）：
|
||||
//!
|
||||
//! | 概念 | 取值 |
|
||||
//! |---|---|
|
||||
//! | **身份**（这一场是谁） | `live_session`（正在跑）→ `selected_session`（打开/刚结束的），**不从 `diagnosis` 反推** |
|
||||
//! | 诊断结论 | 见下表的三个分支（r4 修正了 r3 的一条**回归**：r3 只认身份，把「导入崩溃文件」与「打开会话」两条路径的诊断一并关掉了） |
|
||||
//! | 实例/时间/结局（给页头描述） | 身份优先；身份为空才退到报告的 session |
|
||||
//!
|
||||
//! 归属判据（`report.session` 与身份的关系）：
|
||||
//!
|
||||
//! | `live_session` | `selected_session` | 报告算数的条件 |
|
||||
//! |---|---|---|
|
||||
//! | `Some(live)` | 任意 | `report.session == live` —— 只有它在线时日志行是它自己在追加，别人的报告挂上来就是串场 |
|
||||
//! | `None` | `Some(sel)` | `report.session == sel` **或** 报告不属于任何已知会话（`ImportCrashLog` 用 `file:<文件名>` 当会话 id，永远不在索引里） |
|
||||
//! | `None` | `None` | 全部算数 —— 此时日志行只可能来自 `open_session` 或导入，两者都与报告同一次调用发出 |
|
||||
//!
|
||||
//! 已知残留（今天 iced 侧不可达，登记在报告里）：`open_session(A)` 在 `selected_session` 仍停在上
|
||||
//! 一场 B 时会被第三行判据挡掉（A 是已知会话且 ≠ B）——真正要修得让 presenter 在
|
||||
//! `LogLinesChanged` 时把「日志行属于哪一场」记下来（`AppState` 今天没有这个字段）。
|
||||
//!
|
||||
//! 「没有命中规则」的**占位报告**也不画：host 的 `open_session` 在规则引擎无结论时会发一份
|
||||
//! `rule: ""` / `confidence: 0` / `title: "该会话没有命中已知规则"` 的假报告（`CoreEvent::DiagnosisReady`
|
||||
//! 是非 Option，host 无法表达「没有结论」）——它是标记不是结论，画出来等于给用户看一条「严重度提示」。
|
||||
//!
|
||||
//! 已知缺口（已报 finding，不在本 mission 修）：`clear_logs` 之后 `selected_session` 不清，
|
||||
//! 身份会继续指向那一场；导入崩溃文件只发 `DiagnosisReady`（不带日志行），所以页面上会出现
|
||||
//! 「结论 + 上一场的日志正文」——行由 `open_session` 负责，那是 presenter 的缺口。
|
||||
|
||||
use unlucky_presenter::dto::{Diagnosis, LogLevel, LogOutcome};
|
||||
use unlucky_presenter::state::AppState;
|
||||
|
||||
use crate::pages;
|
||||
|
||||
/// 日志页视图模型：presenter 快照 → 要画的东西。
|
||||
///
|
||||
/// 两处 DTO 侧的**信息丢失**（已报 finding）：`dto::Diagnosis` 没有 core 的 `severity`
|
||||
/// （所以页面按置信度档分组，不冒称严重度）与 `cause.key`（`title`/`hint` 只能当数据画）。
|
||||
pub(super) fn logs_model(state: &AppState) -> pages::Logs {
|
||||
let live = state.live_session.as_deref();
|
||||
let selected = state.selected_session.as_deref();
|
||||
let identity = live.or(selected);
|
||||
|
||||
// 归属判据（r4 修正 r3 的**回归**：r3 的「有选中就只认选中」把导入/打开这两条路径的诊断
|
||||
// 一起关掉了）。三条命中任一即认：
|
||||
//
|
||||
// 1. 报告属于**正在跑**的那一场 —— 这一条必须单独成立：只有它在线时日志行是它自己在追加，
|
||||
// 别的会话的报告挂上来就是串场（r3 修的正是这个）；
|
||||
// 2. 报告属于**当前选中**的那一场（没有 live 会话时）；
|
||||
// 3. 报告的会话**不在会话索引里** —— `ImportCrashLog` 用 `file:<文件名>` 当会话 id，
|
||||
// `open_session` 也不一定把 id 写进 `selected_session`；这两条路径与报告是同一次调用发出的，
|
||||
// 把它们一并关掉就是把「导入崩溃日志」这条功能画成空（r3 的实测回归）。
|
||||
let known = |id: &str| state.log_sessions.iter().any(|session| session.id == id);
|
||||
let report = state.diagnosis.as_ref().filter(|report| {
|
||||
let id = report.session.as_str();
|
||||
match (live, selected) {
|
||||
// 有会话在跑：日志行是它自己在追加，别的会话的报告挂上来就是串场（r3 修的 P1）。
|
||||
(Some(live), _) => id == live,
|
||||
// 没有在跑、但有选中项：报告要么是它的，要么是「会话索引里没有的那一份」
|
||||
// （`ImportCrashLog` 用 `file:<文件名>`；`open_session` 不写 `selected_session`，
|
||||
// 所以只能靠「不在索引里」认它）。
|
||||
(None, Some(selected)) => id == selected || !known(id),
|
||||
// 什么身份都没有：日志行只可能来自 `open_session` 或导入，两者与报告同一次发出。
|
||||
(None, None) => true,
|
||||
}
|
||||
});
|
||||
|
||||
// 身份为空时，描述的来源只能退到报告（见模块文档的表格）。
|
||||
let described = identity.or_else(|| report.map(|report| report.session.as_str()));
|
||||
let session =
|
||||
described.and_then(|id| state.log_sessions.iter().find(|session| session.id == id));
|
||||
|
||||
pages::Logs {
|
||||
instance: session.map(|session| session.instance.clone()),
|
||||
when: session.map(|session| session.when.clone()),
|
||||
outcome: session.map(|session| log_outcome(session.outcome)),
|
||||
// 运行中的会话不在 `log_sessions` 里（索引只在结束时追加），所以页头要靠这个标记
|
||||
// 走「正在运行」那条文案，而不是「当前没有运行中的实例」。
|
||||
live: live.is_some(),
|
||||
lines: state
|
||||
.log_lines
|
||||
.iter()
|
||||
.map(|line| pages::Line {
|
||||
text: line.text.clone(),
|
||||
level: log_level(line.level),
|
||||
})
|
||||
.collect(),
|
||||
findings: report
|
||||
.filter(|report| !report.diagnosis.rule.is_empty())
|
||||
.map(|report| diagnosis_of(&report.diagnosis))
|
||||
.into_iter()
|
||||
.collect(),
|
||||
..pages::Logs::default()
|
||||
}
|
||||
}
|
||||
|
||||
/// 日志等级：presenter 枚举 → 页面等级（**结构化出口**，不是认字符串）。
|
||||
fn log_level(level: LogLevel) -> pages::Level {
|
||||
match level {
|
||||
LogLevel::Debug => pages::Level::Debug,
|
||||
LogLevel::Info => pages::Level::Info,
|
||||
LogLevel::Warn => pages::Level::Warn,
|
||||
LogLevel::Error => pages::Level::Error,
|
||||
}
|
||||
}
|
||||
|
||||
/// 会话结局：presenter 枚举 → 页面结局（文案走 `LaunchOutcome*` key，页面不画 core 的中文串）。
|
||||
fn log_outcome(outcome: LogOutcome) -> pages::Outcome {
|
||||
match outcome {
|
||||
LogOutcome::Ok => pages::Outcome::Ok,
|
||||
LogOutcome::Crashed => pages::Outcome::Crashed,
|
||||
LogOutcome::SilentFail => pages::Outcome::SilentFail,
|
||||
}
|
||||
}
|
||||
|
||||
/// 一条诊断结论 → 页面结论（置信度档见 [`pages::Confidence`]）。
|
||||
fn diagnosis_of(diagnosis: &Diagnosis) -> pages::Finding {
|
||||
pages::Finding {
|
||||
rule: diagnosis.rule.clone(),
|
||||
confidence_band: pages::Confidence::of(diagnosis.confidence),
|
||||
title: diagnosis.title.clone(),
|
||||
hint: diagnosis.hint.clone(),
|
||||
confidence: diagnosis.confidence,
|
||||
action: diagnosis.fix.clone(),
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
@@ -0,0 +1,242 @@
|
||||
//! 日志页展示转换的守门测试（从 `app/view/logs.rs` 拆出：那边已经 382 行，贴着 400 硬上限）。
|
||||
//!
|
||||
//! 全部走**真实 reducer 路径**（`AppState::apply_core`），不造注入源——r3 的教训是
|
||||
//! 「测试全走注入源而真实路径零覆盖」，所以这里的夹具就是线上那串事件本身。
|
||||
|
||||
use unlucky_i18n::Lang;
|
||||
use unlucky_presenter::dto::{
|
||||
CoreEvent, DiagnosisReport, LaunchFinished, LiveLogBatch, LogLevel, LogLine, LogOutcome,
|
||||
LogSession,
|
||||
};
|
||||
use unlucky_presenter::state::AppState;
|
||||
|
||||
use crate::pages;
|
||||
|
||||
use super::logs_model;
|
||||
|
||||
/// 崩溃的那一场。
|
||||
const CRASH: &str = "s-1029-1840";
|
||||
/// 崩溃之后又启动的、正常跑的一场。
|
||||
const OK_RUN: &str = "s-1029-1922";
|
||||
|
||||
fn session(id: &str, when: &str, outcome: LogOutcome) -> LogSession {
|
||||
LogSession {
|
||||
id: id.to_string(),
|
||||
instance: "开发测试".to_string(),
|
||||
when: when.to_string(),
|
||||
outcome,
|
||||
duration_secs: 62,
|
||||
}
|
||||
}
|
||||
|
||||
fn line(text: &str, level: LogLevel) -> LogLine {
|
||||
LogLine {
|
||||
text: text.to_string(),
|
||||
level,
|
||||
}
|
||||
}
|
||||
|
||||
fn report(session: &str, rule: &str) -> DiagnosisReport {
|
||||
DiagnosisReport {
|
||||
session: session.to_string(),
|
||||
diagnosis: pages_dto(rule),
|
||||
}
|
||||
}
|
||||
|
||||
fn pages_dto(rule: &str) -> unlucky_presenter::dto::Diagnosis {
|
||||
unlucky_presenter::dto::Diagnosis {
|
||||
rule: rule.to_string(),
|
||||
title: "显卡驱动过旧（OpenGL 版本不足）".to_string(),
|
||||
confidence: 92,
|
||||
hint: "升级显卡驱动".to_string(),
|
||||
fix: Some("change_graphics.driver".to_string()),
|
||||
}
|
||||
}
|
||||
|
||||
/// **真实数据路径**（复审要求：不许造注入源绕过去）：
|
||||
/// 崩溃一场跑完 → 再启动一场正常跑。`state.diagnosis` 在这里**故意不清**，
|
||||
/// 因为 presenter 里根本没有清零点——这就是线上发生串场的条件。
|
||||
fn crashed_only() -> AppState {
|
||||
let mut state = AppState::new();
|
||||
state.apply_core(CoreEvent::LogSessionsChanged(vec![
|
||||
session(CRASH, "10-29 18:40", LogOutcome::Crashed),
|
||||
session(OK_RUN, "10-29 19:22", LogOutcome::Ok),
|
||||
]));
|
||||
|
||||
// 第一场跑起来（live_session = CRASH）→ 日志 → 规则结论 → 收尾（selected_session = CRASH）
|
||||
state.apply_core(CoreEvent::LogAppended(LiveLogBatch {
|
||||
session: CRASH.to_string(),
|
||||
lines: vec![line("[18:40] boom: GLFW error", LogLevel::Error)],
|
||||
running: true,
|
||||
}));
|
||||
state.apply_core(CoreEvent::DiagnosisReady(report(CRASH, "gpu.driver_old")));
|
||||
state.apply_core(CoreEvent::LaunchFinished(LaunchFinished {
|
||||
id: "dev".to_string(),
|
||||
session: CRASH.to_string(),
|
||||
outcome: LogOutcome::Crashed,
|
||||
summary: "崩溃（exit 1）".to_string(),
|
||||
}));
|
||||
|
||||
state
|
||||
}
|
||||
|
||||
/// 崩溃之后又启动一场正常跑：`live_session` 前进，`diagnosis` 仍是上一场的。
|
||||
fn after_a_new_run() -> AppState {
|
||||
let mut state = crashed_only();
|
||||
state.apply_core(CoreEvent::LogAppended(LiveLogBatch {
|
||||
session: OK_RUN.to_string(),
|
||||
lines: vec![line("[19:22] launching 1.20.4", LogLevel::Info)],
|
||||
running: true,
|
||||
}));
|
||||
state
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn a_new_run_does_not_inherit_the_previous_crash() {
|
||||
let state = after_a_new_run();
|
||||
let logs = logs_model(&state).with_status(Lang::En);
|
||||
|
||||
// 抓得住：身份被上一场的 `diagnosis.session` 顶掉（r2 的 bug）——那时 outcome 会是
|
||||
// Crashed、findings 挂着 gpu.driver_old、摘要里 `lines=` 与结论不同源。
|
||||
// 抓不住：presenter 自己 `clear_logs` 后 `selected_session` 不清的缺口（已报 finding），
|
||||
// 以及多场并行会话（本仓一次只跑一场）。
|
||||
assert_eq!(
|
||||
logs.outcome,
|
||||
Some(pages::Outcome::Ok),
|
||||
"身份应该是正在跑的这一场"
|
||||
);
|
||||
|
||||
let status = logs.status.clone().expect("有会话身份就该有副标题");
|
||||
assert!(status.contains("Finished normally"), "{status}");
|
||||
assert!(
|
||||
!status.contains("The game crashed"),
|
||||
"页头把新会话标成了上一场的崩溃：{status}"
|
||||
);
|
||||
|
||||
assert!(
|
||||
logs.findings.is_empty(),
|
||||
"上一场的结论不能挂到这一场：{:?}",
|
||||
logs.findings
|
||||
);
|
||||
|
||||
// 摘要必须与身份同源：outcome 是 ok、不含旧规则、行数就是当前这些行。
|
||||
let summary = logs.summary();
|
||||
assert!(summary.contains("outcome=ok"), "{summary}");
|
||||
assert!(!summary.contains("gpu.driver_old"), "{summary}");
|
||||
assert!(
|
||||
summary.contains(&format!("lines={}", logs.lines.len())),
|
||||
"{summary}"
|
||||
);
|
||||
assert!(!summary.contains("findings="), "{summary}");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn the_crash_itself_is_still_reported() {
|
||||
// 上一条测试的**对照**：崩溃当场必须画结论，否则那条断言「findings 为空」是空的。
|
||||
// 抓得住：把判别写成「永远不画诊断」（用空断言骗过 P2）。
|
||||
// 抓不住：结论排序/去重（那是 core 的规则引擎的事）。
|
||||
let state = crashed_only();
|
||||
let logs = logs_model(&state).with_status(Lang::En);
|
||||
|
||||
assert_eq!(logs.outcome, Some(pages::Outcome::Crashed));
|
||||
assert_eq!(logs.findings.len(), 1, "{:?}", logs.findings);
|
||||
assert_eq!(logs.findings[0].rule, "gpu.driver_old");
|
||||
let status = logs.status.clone().unwrap_or_default();
|
||||
assert!(status.contains("The game crashed"), "{status}");
|
||||
assert!(logs.summary().contains("gpu.driver_old:high(92)"));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn an_imported_crash_file_still_shows_its_findings() {
|
||||
// r3 的**回归**：r3 把归属判据写成「有选中就只认选中」，于是导入崩溃日志
|
||||
// （`ImportCrashLog` → `DiagnosisReady` 带 `file:<文件名>` 的会话 id，且**不发**
|
||||
// `LogLinesChanged`）被整条丢掉。今天 iced 侧还没有 dispatch 站点（那些还在遗留的
|
||||
// Slint shell 里），所以复审没判 p1；这条测试是为了**将来接线的人**不再踩。
|
||||
// 抓得住：只有「属于当前选中/live 会话」才画的窄判据（导入的 `file:` 会话不等于任何
|
||||
// 索引里的会话，会被误杀）。
|
||||
// 抓不住：导入后日志正文该显示什么（`ImportCrashLog` 不载入日志行，那是 presenter 的事）。
|
||||
let mut state = AppState::new();
|
||||
state.apply_core(CoreEvent::LogSessionsChanged(vec![session(
|
||||
CRASH,
|
||||
"10-29 18:40",
|
||||
LogOutcome::Crashed,
|
||||
)]));
|
||||
// 上一场刚结束 ⇒ selected_session = CRASH（过期选中项），随后用户导入一份崩溃文件
|
||||
state.apply_core(CoreEvent::LaunchFinished(LaunchFinished {
|
||||
id: "dev".to_string(),
|
||||
session: CRASH.to_string(),
|
||||
outcome: LogOutcome::Crashed,
|
||||
summary: "崩溃（exit 1）".to_string(),
|
||||
}));
|
||||
state.apply_core(CoreEvent::DiagnosisReady(report(
|
||||
"file:crash-2026-11-02_19.40.15-client.txt",
|
||||
"integrity.unsatisfied_link",
|
||||
)));
|
||||
|
||||
let logs = logs_model(&state).with_status(Lang::En);
|
||||
assert_eq!(
|
||||
logs.findings.len(),
|
||||
1,
|
||||
"导入的崩溃日志必须画出它的结论：{:?}",
|
||||
logs.findings
|
||||
);
|
||||
assert_eq!(logs.findings[0].rule, "integrity.unsatisfied_link");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn a_live_run_says_it_is_running_instead_of_nothing_runs() {
|
||||
// 视觉复审 r3 的 P2-3：session 索引只在**结束**时追加（`host::logs::sessions`），
|
||||
// 所以运行中的那一场永远不在 `log_sessions` 里 ⇒ 拿不到实例名与结局 ⇒ r3 的页头在
|
||||
// 每次实时运行都说「当前没有运行中的实例」。demo 伪造了身份，截图上根本照不出来。
|
||||
// 抓得住：页头退回 Idle 文案（这次走真实 reducer：只有 `LogAppended(running=true)`）。
|
||||
// 抓不住：文案长度在某尺寸下会不会撞右侧动作区（那要看截图）。
|
||||
let mut state = AppState::new();
|
||||
state.apply_core(CoreEvent::LogSessionsChanged(vec![session(
|
||||
CRASH,
|
||||
"10-29 18:40",
|
||||
LogOutcome::Crashed,
|
||||
)]));
|
||||
state.apply_core(CoreEvent::LogAppended(LiveLogBatch {
|
||||
session: OK_RUN.to_string(),
|
||||
lines: vec![line("[19:22] launching", LogLevel::Info)],
|
||||
running: true,
|
||||
}));
|
||||
|
||||
let logs = logs_model(&state).with_status(Lang::En);
|
||||
assert!(logs.live, "live_session 非空就该标记为运行中");
|
||||
let status = logs.status.clone().expect("运行中必须有副标题");
|
||||
let idle = unlucky_i18n::catalog::Catalog::of(Lang::En)
|
||||
.text(unlucky_i18n::catalog::Key::LogsSubtitleIdle);
|
||||
assert_ne!(status, idle, "运行中的页头不能说「没有运行」");
|
||||
assert!(status.contains("Running now"), "{status}");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn the_hosts_no_rule_matched_placeholder_is_not_a_finding() {
|
||||
// host 的 `open_session` 在规则引擎无结论时发一份 `rule: ""` 的假报告（非 Option 逼的）。
|
||||
// 抓得住：把「没命中」画成一条严重度结论（用户会去修一个不存在的毛病）。
|
||||
// 抓不住：host 该不该改发 `None`（那是 presenter 的 finding）。
|
||||
let mut state = AppState::new();
|
||||
state.apply_core(CoreEvent::LogSessionsChanged(vec![session(
|
||||
CRASH,
|
||||
"10-29 18:40",
|
||||
LogOutcome::Crashed,
|
||||
)]));
|
||||
state.apply_core(CoreEvent::LogLinesChanged(vec![line(
|
||||
"[18:40] nothing to see",
|
||||
LogLevel::Info,
|
||||
)]));
|
||||
|
||||
state.apply_core(CoreEvent::DiagnosisReady(report(CRASH, "")));
|
||||
assert!(
|
||||
logs_model(&state).findings.is_empty(),
|
||||
"空 rule 是『没命中』的占位，不是结论"
|
||||
);
|
||||
|
||||
state.apply_core(CoreEvent::DiagnosisReady(report(CRASH, "gpu.driver_old")));
|
||||
assert_eq!(
|
||||
logs_model(&state).findings.len(),
|
||||
1,
|
||||
"换成真规则就得画出来（证明上面的过滤不是把诊断一起关了）"
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
//! 导航轨底部**账户头像位**的状态换算（M114）。
|
||||
//!
|
||||
//! 为什么单独一个文件：`app/view.rs` 贴着 400 行硬线，而这块逻辑与页面树无关——
|
||||
//! 它只回答「轨底那个头像位现在该显示成未登录，还是某个账户」。
|
||||
|
||||
use crate::shell;
|
||||
|
||||
use super::super::state::App;
|
||||
|
||||
/// 导航轨收成「图标条」的窗口高度（M114）。
|
||||
///
|
||||
/// 判据不是「项数」而是**真实可用高度**：四项 + 底部头像位在 48 标题栏之上还要放得下
|
||||
/// 4 × 52 + 4 × 4 + 52 ≈ 300；留出一屏正文的最小高度（424 行宽 + 页头 + 边距），
|
||||
/// 低于 720 就把标签收掉，只留图标与头像位（头像位**永远可见**，任务要求）。
|
||||
const RAIL_COMPACT_HEIGHT: f32 = 720.0;
|
||||
|
||||
impl App {
|
||||
/// 导航轨底部头像位的状态（M114）：未登录 / 已登录两态要一眼能分。
|
||||
pub(super) fn rail_account(&self) -> shell::RailAccount {
|
||||
let compact = self.height < RAIL_COMPACT_HEIGHT;
|
||||
match self.state.active_account() {
|
||||
Some(account) => {
|
||||
shell::RailAccount::signed_in(account.monogram(), account.name.clone())
|
||||
.compact(compact)
|
||||
}
|
||||
// M106：未登录标签跟着**生效语言**走（早期钉死 `Lang::En` 的写法已删）。
|
||||
None => shell::RailAccount::signed_out(
|
||||
self.lang()
|
||||
.catalog()
|
||||
.text(unlucky_i18n::Key::AccountRailSignedOut),
|
||||
)
|
||||
.compact(compact),
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,320 @@
|
||||
//! `app/view.rs` 的守门测试（rebase 到 5adac23 之后 view.rs 贴 400 行上限，按「测试独立成文件」拆出）。
|
||||
|
||||
use super::*;
|
||||
use unlucky_i18n::Key;
|
||||
use unlucky_presenter::dto::{
|
||||
InstanceRuntime, InstanceSummary, LaunchStage, LoaderInfo, LoaderKind, Progress,
|
||||
};
|
||||
use unlucky_presenter::mock_data::mock_instances;
|
||||
|
||||
fn instance(runtime: InstanceRuntime) -> InstanceSummary {
|
||||
InstanceSummary {
|
||||
id: "survival".to_string(),
|
||||
name: "Survival".to_string(),
|
||||
mc_version: "1.20.4".to_string(),
|
||||
loader: LoaderInfo {
|
||||
kind: LoaderKind::Fabric,
|
||||
version: "0.16.5".to_string(),
|
||||
},
|
||||
last_played: Some("2026-10-29T19:22:00Z".to_string()),
|
||||
runtime,
|
||||
icon: None,
|
||||
isolation: "isolated".to_string(),
|
||||
version_id: "1.20.4".to_string(),
|
||||
version_present: true,
|
||||
}
|
||||
}
|
||||
|
||||
/// **取证不变量（M100）**：`ForcedState` 的三档在产品路径上必须映射成「页面控件怎么画」。
|
||||
///
|
||||
/// 抓得住：① 谁把 `Rest` 映射成 Hovered/Pressed（那会让 `--screenshot` 的默认值反而画出状态层，
|
||||
/// 与「取证密闭」正好相反，而且图看起来完全正常）；② 加了变体却映射到别的态这种复制粘贴错。
|
||||
/// 抓不住：`shell::overridden`（标题栏 / 导航轨按钮走的**另一处** match，断言在 `shell/tests.rs`），
|
||||
/// 也抓不住不消费 `model.forced` 的裸 `iced::button`（设置页「外观」区就是）。
|
||||
/// 测试用的薄包装：默认宽度 / 默认分类 / 空草稿 / **给定语言**。
|
||||
fn at_lang(state: &AppState, forced: Option<crate::cli::ForcedState>, lang: Lang) -> pages::Model {
|
||||
let draft = pages::InstallDraft::default();
|
||||
let page = pages::content::PageState::default();
|
||||
model(
|
||||
state,
|
||||
1180.0,
|
||||
forced,
|
||||
pages::Category::All,
|
||||
&draft,
|
||||
lang,
|
||||
&page,
|
||||
)
|
||||
}
|
||||
|
||||
/// 同 [`at_lang`]，语言取英文（绝大多数断言只关心「快照 → 模型」的映射，不关心译文）。
|
||||
fn at(state: &AppState, forced: Option<crate::cli::ForcedState>) -> pages::Model {
|
||||
at_lang(state, forced, Lang::En)
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn the_forced_state_maps_to_the_expected_interaction() {
|
||||
let state = AppState::new();
|
||||
let forced = |forced| at(&state, Some(forced)).forced;
|
||||
|
||||
assert_eq!(
|
||||
forced(crate::cli::ForcedState::Rest),
|
||||
Some(Interaction::Enabled),
|
||||
"Rest = 静息态（压掉系统光标 hover）"
|
||||
);
|
||||
assert_eq!(
|
||||
forced(crate::cli::ForcedState::Hover),
|
||||
Some(Interaction::Hovered)
|
||||
);
|
||||
assert_eq!(
|
||||
forced(crate::cli::ForcedState::Pressed),
|
||||
Some(Interaction::Pressed)
|
||||
);
|
||||
assert_eq!(at(&state, None).forced, None);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn the_snapshot_becomes_the_page_model() {
|
||||
let mut state = AppState::new();
|
||||
state.apply(unlucky_presenter::dto::AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::InstancesChanged(mock_instances()),
|
||||
));
|
||||
state.navigate(Route::Detail("survival".to_string()));
|
||||
|
||||
let model = at(&state, None);
|
||||
assert_eq!(model.screen, pages::Screen::Instances);
|
||||
assert_eq!(model.active, Some(pages::Screen::Instances.nav()));
|
||||
assert_eq!(model.window_width, 1180.0);
|
||||
assert_eq!(model.instances.rows.len(), 4, "mock 的四个实例");
|
||||
assert_eq!(model.instances.rows[0].id, "survival");
|
||||
|
||||
let detail = model.instances.detail.expect("路由是 Detail，要有详情");
|
||||
assert_eq!(detail.id, "survival");
|
||||
assert_eq!(detail.meta.len(), 6);
|
||||
assert!(detail.can_launch, "空闲实例可启动");
|
||||
assert!(!detail.can_stop);
|
||||
assert!(detail.note.is_none(), "真快照没有正文段");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn a_busy_instance_offers_stop_instead_of_play() {
|
||||
let mut state = AppState::new();
|
||||
state.apply(unlucky_presenter::dto::AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::InstancesChanged(vec![instance(
|
||||
InstanceRuntime::Busy {
|
||||
stage: LaunchStage::Download,
|
||||
progress: Progress {
|
||||
done: 750,
|
||||
total: 1_500,
|
||||
},
|
||||
},
|
||||
)]),
|
||||
));
|
||||
state.navigate(Route::Detail("survival".to_string()));
|
||||
|
||||
let model = at(&state, None);
|
||||
assert_eq!(
|
||||
model.instances.rows[0].status.as_deref(),
|
||||
Some("Downloading · 50%")
|
||||
);
|
||||
let detail = model.instances.detail.expect("有详情");
|
||||
assert!(!detail.can_launch, "启动中不许再点 Play（不做乐观回显）");
|
||||
assert!(detail.can_stop, "启动中要能 Stop");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn failed_instances_can_be_retried() {
|
||||
let failed = instance(InstanceRuntime::Failed {
|
||||
reason: "exit 1".to_string(),
|
||||
});
|
||||
assert_eq!(
|
||||
runtime_status(&failed.runtime, Lang::En.catalog()).as_deref(),
|
||||
Some("Launch failed · exit 1")
|
||||
);
|
||||
assert!(
|
||||
detail_of(&failed, Lang::En.catalog()).can_launch,
|
||||
"失败后要能重试"
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn timestamps_are_sliced_not_guessed() {
|
||||
let en = Lang::En.catalog();
|
||||
assert_eq!(
|
||||
last_played(Some("2026-10-29T19:22:00Z"), en),
|
||||
"2026-10-29 19:22 UTC"
|
||||
);
|
||||
assert_eq!(last_played(None, en), "Never");
|
||||
// 短串 / 非 ASCII 原样返回（不 panic）
|
||||
assert_eq!(last_played(Some("2026-10"), en), "2026-10");
|
||||
assert_eq!(last_played(Some("昨天"), en), "昨天");
|
||||
// 「从未游玩」是唯一走词表的那一支
|
||||
assert_eq!(last_played(None, Lang::ZhCn.catalog()), "从未游玩");
|
||||
}
|
||||
|
||||
/// **快照 → 页面文案跟着 `App::lang` 走**（M120 的核心接线断言，模型这一层）。
|
||||
///
|
||||
/// 抓得住：`view::model` 又把语言写死成 `Lang::En`（M106 之前的原样）、阶段/元信息标签还留着
|
||||
/// 英文基线字面量、原版徽标直接画 presenter 的中文「原版」。这三种都不会让任何别的测试红。
|
||||
/// 抓不住：页面把 key 画没画上屏（那是 `pages/instances/tests/i18n.rs` 的取样口 + 出图）。
|
||||
#[test]
|
||||
fn the_runtime_lines_and_meta_labels_follow_the_language() {
|
||||
let mut state = AppState::new();
|
||||
state.apply(unlucky_presenter::dto::AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::InstancesChanged(vec![
|
||||
instance(InstanceRuntime::Running { pid: 1234 }),
|
||||
instance(InstanceRuntime::Busy {
|
||||
stage: LaunchStage::Verify,
|
||||
progress: Progress {
|
||||
done: 750,
|
||||
total: 1_500,
|
||||
},
|
||||
}),
|
||||
]),
|
||||
));
|
||||
state.navigate(Route::Detail("survival".to_string()));
|
||||
|
||||
let en = at_lang(&state, None, Lang::En);
|
||||
let zh = at_lang(&state, None, Lang::ZhCn);
|
||||
|
||||
// 列表 overline：中英各一份，数字与分隔符不动
|
||||
assert_eq!(
|
||||
en.instances.rows[0].status.as_deref(),
|
||||
Some("Running · pid 1234")
|
||||
);
|
||||
assert_eq!(
|
||||
zh.instances.rows[0].status.as_deref(),
|
||||
Some("运行中 · pid 1234")
|
||||
);
|
||||
assert_eq!(
|
||||
en.instances.rows[1].status.as_deref(),
|
||||
Some("Verifying · 50%")
|
||||
);
|
||||
assert_eq!(zh.instances.rows[1].status.as_deref(), Some("校验中 · 50%"));
|
||||
|
||||
// 元信息卡的标签与值
|
||||
let (en_detail, zh_detail) = (
|
||||
en.instances.detail.expect("有详情"),
|
||||
zh.instances.detail.expect("有详情"),
|
||||
);
|
||||
let labels = |detail: &pages::Detail| -> Vec<String> {
|
||||
detail.meta.iter().map(|cell| cell.label.clone()).collect()
|
||||
};
|
||||
assert_eq!(
|
||||
labels(&en_detail),
|
||||
vec![
|
||||
"VERSION",
|
||||
"LOADER",
|
||||
"ISOLATION",
|
||||
"VERSION ID",
|
||||
"FILES",
|
||||
"LAST PLAYED"
|
||||
]
|
||||
);
|
||||
assert_eq!(
|
||||
labels(&zh_detail),
|
||||
vec!["版本", "加载器", "隔离方式", "版本标识", "文件", "上次游玩"]
|
||||
);
|
||||
|
||||
// 值里只有「是否在磁盘上」与「上次游玩」是可翻译的；版本号 / 隔离方式 / 版本标识是数据
|
||||
// 隔离档位是 core 的稳定 id（`isolated` / `shared`），也要换成人话；认不出来的原样上屏
|
||||
assert_eq!(en_detail.meta[2].value, "Isolated");
|
||||
assert_eq!(zh_detail.meta[2].value, "独立目录");
|
||||
assert_eq!(en_detail.meta[4].value, "Present on disk");
|
||||
assert_eq!(zh_detail.meta[4].value, "已在磁盘上");
|
||||
assert_eq!(
|
||||
en_detail.meta[5].value, "2026-10-29 19:22 UTC",
|
||||
"时间戳是数据：只切片，不随语言变形"
|
||||
);
|
||||
assert_eq!(zh_detail.meta[5].value, "2026-10-29 19:22 UTC");
|
||||
|
||||
// 详情状态行与列表 overline 同源
|
||||
assert_eq!(zh_detail.status.as_deref(), Some("运行中 · pid 1234"));
|
||||
}
|
||||
|
||||
/// 原版徽标：`LoaderInfo::badge()` 对原版返回**中文**「原版」，英文界面里必须换回 `Vanilla`。
|
||||
///
|
||||
/// 抓得住：`loader_badge` 退回直接调 `badge()`（M90 ~ M119 的形状）——那样英文界面会漏中文，
|
||||
/// 而中文界面又是对的，所以只有这条双语断言抓得住它。
|
||||
#[test]
|
||||
fn the_vanilla_badge_follows_the_language() {
|
||||
let mut bare = instance(InstanceRuntime::Idle);
|
||||
bare.loader = LoaderInfo {
|
||||
kind: LoaderKind::Vanilla,
|
||||
version: String::new(),
|
||||
};
|
||||
let mut state = AppState::new();
|
||||
state.apply(unlucky_presenter::dto::AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::InstancesChanged(vec![bare]),
|
||||
));
|
||||
state.navigate(Route::Detail("survival".to_string()));
|
||||
|
||||
let en = at_lang(&state, None, Lang::En);
|
||||
let zh = at_lang(&state, None, Lang::ZhCn);
|
||||
assert_eq!(en.instances.rows[0].supporting, "1.20.4 · Vanilla");
|
||||
assert_eq!(zh.instances.rows[0].supporting, "1.20.4 · 原版");
|
||||
}
|
||||
|
||||
/// **品牌名不许被「版本号为空」吞掉**（M120 r1 复审的 p2-1 回归）。
|
||||
///
|
||||
/// 背景：`host::game::loader_from_id("1.20.1-forge")` 这类 id 里取不到版本段（它按 `forge-`
|
||||
/// 找，而 id 的写法是 `-forge` 结尾），于是 `LoaderInfo { kind: Forge, version: "" }`。
|
||||
/// `LoaderInfo::badge()` 对这种输入给的正是品牌名 `Forge`——所以判据只能是「类型是原版」，
|
||||
/// 不能是「版本号为空」。
|
||||
///
|
||||
/// 三个 id 各一条断言（复审点名的三档）；`Vanilla` 那一支由
|
||||
/// `the_vanilla_badge_follows_the_language` 守，两条合起来把 `loader_badge` 的两侧都钉住。
|
||||
///
|
||||
/// 抓得住：`loader_badge` 把「非原版 + 空版本号」也送进 `Key::LoaderVanilla`
|
||||
/// （r1 的真实形状：`left: "1.20.4 · Vanilla" / right: "1.20.4 · Forge"`）；
|
||||
/// 抓不住：`loader_from_id` 认不出自家 `-fabric-` / `-quilt-` 口径这个**更老**的 bug
|
||||
/// （在 presenter 里，另一条 mission）。
|
||||
#[test]
|
||||
fn the_loader_badge_keeps_the_brand_when_the_version_is_missing() {
|
||||
// (版本 id, 期望徽标) —— id 形状取自 `host::game::loader_from_id` 的三条真实输入
|
||||
let cases = [
|
||||
("1.20.1-forge", LoaderKind::Forge, "Forge"),
|
||||
("1.20.1-neoforge", LoaderKind::NeoForge, "NeoForge"),
|
||||
("1.20.1-OptiFine", LoaderKind::OptiFine, "OptiFine"),
|
||||
];
|
||||
|
||||
for (id, kind, brand) in cases {
|
||||
let mut one = instance(InstanceRuntime::Idle);
|
||||
one.loader = LoaderInfo {
|
||||
kind,
|
||||
// `loader_from_id` 对这三条 id 取不到版本段 ⇒ 空串
|
||||
version: String::new(),
|
||||
};
|
||||
let mut state = AppState::new();
|
||||
state.apply(unlucky_presenter::dto::AppEvent::Core(
|
||||
unlucky_presenter::dto::CoreEvent::InstancesChanged(vec![one]),
|
||||
));
|
||||
state.navigate(Route::Detail("survival".to_string()));
|
||||
|
||||
// 品牌名两套语言都不翻译 ⇒ 中英逐字相同
|
||||
for lang in [Lang::En, Lang::ZhCn] {
|
||||
let model = at_lang(&state, None, lang);
|
||||
assert_eq!(
|
||||
model.instances.rows[0].supporting,
|
||||
format!("1.20.4 · {brand}"),
|
||||
"{id} 的徽标被显示成了别的东西（新增的判据「版本号为空 ⇒ 原版」就是这条要拦的）"
|
||||
);
|
||||
let detail = model.instances.detail.expect("有详情");
|
||||
assert_eq!(
|
||||
detail.meta[1].label,
|
||||
lang.catalog().text(Key::InstancesMetaLoader)
|
||||
);
|
||||
assert_eq!(detail.meta[1].value, brand, "{id} 的 LOADER 卡值");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn the_agent_route_has_no_page() {
|
||||
let mut state = AppState::new();
|
||||
state.navigate(Route::Agent);
|
||||
let model = at(&state, None);
|
||||
// Agent 没有页面：模型退回实例页的空壳，view 会走外壳回退（`None` 分支）
|
||||
assert_eq!(pages::Screen::of(state.route()), None);
|
||||
assert!(model.instances.detail.is_none());
|
||||
assert_eq!(model.active, None, "AI 页不高亮任何导航项");
|
||||
}
|
||||
@@ -0,0 +1,134 @@
|
||||
//! 整窗 α 的**执行侧**：句柄探测 → `WS_EX_LAYERED` → `SetLayeredWindowAttributes` → 一行日志。
|
||||
//!
|
||||
//! ## 为什么句柄要绕一圈 iced
|
||||
//!
|
||||
//! iced 0.14 只给 `window::Id`（它自己的编号），没有「给我 HWND」的公开 API；唯一的入口是
|
||||
//! `window::run(id, callback)`——回调里拿到的 `&dyn Window` 实现了 `HasWindowHandle`
|
||||
//! （raw-window-handle 0.6），于是能取到 `RawWindowHandle::Win32(hwnd)`。
|
||||
//!
|
||||
//! ## 三层责任（顺序不能换）
|
||||
//!
|
||||
//! 1. **探测句柄**：[`probe_hwnd`]，纯取；拿不到就整条链跳过（并如实打日志，不许假装成功）；
|
||||
//! 2. **补分层样式**：`ensure_layered`（唯一 `unsafe` 落点，`platform/win32/transparency.rs`）；
|
||||
//! `SetLayeredWindowAttributes` 在没有 `WS_EX_LAYERED` 的窗口上**必然失败**（Win32 返回 0，
|
||||
//! 本机 `GetLastError` 常见 87），所以这一步是硬前提；
|
||||
//! 3. **下发 α**：`apply_window_alpha`。`α ≥ 1` 时它返回 `Opaque` 并且**不调 FFI**，那时也就不必
|
||||
//! 改扩展样式（1、2 步都是白改），[`dispatch`] 里按这个条件短路。
|
||||
//!
|
||||
//! ## 为什么日志要记「下发字节」而不是「看起来多透明」
|
||||
//!
|
||||
//! 本机是 RDP + 4 个虚拟显示适配器：`LWA_ALPHA` 的**观感**在这里不可信。所以证据链是
|
||||
//! `配置值 → 判据 → 字节 → Win32 返回值`，全部经 [`super::App::log_appearance`] 落成一行文本。
|
||||
|
||||
use iced::window;
|
||||
|
||||
use crate::platform::win32::transparency::{apply_window_alpha, ensure_layered, AlphaOutcome};
|
||||
|
||||
/// 一次「补样式 + 下发」的结果（日志与单测共用）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub(super) struct Dispatch {
|
||||
/// `WS_EX_LAYERED` 是否就位（`α ≥ 1` 或 `α = None` 时为 `false`：那次根本没动扩展样式）。
|
||||
pub layered: bool,
|
||||
/// 下发的结局。
|
||||
pub alpha: AlphaOutcome,
|
||||
}
|
||||
|
||||
impl Dispatch {
|
||||
/// 日志尾巴：`layered=ok outcome=Applied { byte: 205 }`。
|
||||
///
|
||||
/// `layered` 有三个值，刻意区分「没用到」与「失败」：
|
||||
/// - `n/a`：α ≥ 1 或被拒绝 —— 那次**根本不需要**分层窗口，不是错误；
|
||||
/// - `ok`：这一位在（原本就有或本条补上）；
|
||||
/// - `FAILED`：需要补但补不上（无效句柄等）—— 只有这一种是坏消息。
|
||||
pub(super) fn describe(&self) -> String {
|
||||
let layered = match self.alpha {
|
||||
AlphaOutcome::Opaque | AlphaOutcome::Rejected(_) => "n/a",
|
||||
AlphaOutcome::Applied { .. } | AlphaOutcome::Failed { .. } if !self.layered => "FAILED",
|
||||
_ => "ok",
|
||||
};
|
||||
format!("layered={layered} outcome={:?}", self.alpha)
|
||||
}
|
||||
}
|
||||
|
||||
/// 把 iced 的窗口句柄翻成 Win32 的 `HWND`（`isize`）。非 Windows 平台返回 `None`。
|
||||
pub(super) fn probe_hwnd(handle: &dyn window::Window) -> Option<isize> {
|
||||
use window::raw_window_handle::RawWindowHandle;
|
||||
|
||||
let handle = handle.window_handle().ok()?;
|
||||
match handle.as_raw() {
|
||||
#[cfg(target_os = "windows")]
|
||||
RawWindowHandle::Win32(win32) => Some(win32.hwnd.get()),
|
||||
#[cfg(not(target_os = "windows"))]
|
||||
_ => None,
|
||||
#[cfg(target_os = "windows")]
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 补样式 + 下发（**幂等**：`α ≥ 1` 时什么都不做，返回 `Opaque`）。
|
||||
pub(super) fn dispatch(hwnd: isize, alpha: Option<f64>) -> Dispatch {
|
||||
// α 不透明 / 被拒绝时不需要分层窗口：`SetLayeredWindowAttributes` 那次调用也不会发生，
|
||||
// 改扩展样式纯属副作用（还会让 DWM 换一条合成路径），所以短路掉。
|
||||
let needs_layered = alpha.is_some_and(|alpha| alpha < 1.0);
|
||||
let layered = needs_layered && ensure_layered(hwnd);
|
||||
Dispatch {
|
||||
layered,
|
||||
alpha: apply_window_alpha(hwnd, alpha),
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::dispatch;
|
||||
use crate::platform::win32::transparency::{AlphaOutcome, AlphaRejection};
|
||||
|
||||
/// 抓得住：①`α = None` / `α ≥ 1` / `α = 0` 时**不去碰扩展样式**（短路条件写反会在这里红）；
|
||||
/// ②拒绝路径的返回值与 `transparency` 的判据一致。
|
||||
/// 抓不住：真实窗口（有效句柄）上 `WS_EX_LAYERED` 是否真的加上了——那要靠本机日志的 `layered=ok`。
|
||||
#[test]
|
||||
fn opaque_or_refused_alpha_never_touches_the_window_style() {
|
||||
for none in [None, Some(1.0), Some(1.5), Some(0.0), Some(-1.0)] {
|
||||
let result = dispatch(1234, none);
|
||||
assert!(!result.layered, "{none:?} 不该改扩展样式");
|
||||
}
|
||||
assert_eq!(
|
||||
dispatch(1234, None).alpha,
|
||||
AlphaOutcome::Rejected(AlphaRejection::NoAlpha)
|
||||
);
|
||||
assert_eq!(dispatch(1234, Some(1.0)).alpha, AlphaOutcome::Opaque);
|
||||
// 无效句柄 + 合法 α：样式补不上（layered=false），FFI 也不会成功——两层都如实报告。
|
||||
let invalid = dispatch(1, Some(0.5));
|
||||
assert!(!invalid.layered, "无效句柄补不上 WS_EX_LAYERED");
|
||||
assert!(
|
||||
matches!(invalid.alpha, AlphaOutcome::Failed { .. }),
|
||||
"{:?}",
|
||||
invalid.alpha
|
||||
);
|
||||
}
|
||||
|
||||
/// 本机真窗口的取证由 `App` 启动日志给（见 `app::appearance::log_appearance`），
|
||||
/// 这里只钉日志格式：`Applied { byte: 205 }` 必须能一眼读出字节，且「没用到样式」不等于失败。
|
||||
#[test]
|
||||
fn the_log_tail_carries_the_byte_and_distinguishes_skipped_from_failed() {
|
||||
let applied = super::Dispatch {
|
||||
layered: true,
|
||||
alpha: AlphaOutcome::Applied { byte: 205 },
|
||||
};
|
||||
assert!(applied.describe().starts_with("layered=ok outcome=Applied"));
|
||||
assert!(applied.describe().contains("205"));
|
||||
|
||||
// α = 1.0：没补样式是**正常**的，不许写成 FAILED（否则报告里会出现假红）。
|
||||
let opaque = super::Dispatch {
|
||||
layered: false,
|
||||
alpha: AlphaOutcome::Opaque,
|
||||
};
|
||||
assert!(opaque.describe().starts_with("layered=n/a"));
|
||||
|
||||
// 真的要补却没补上：这才是 FAILED。
|
||||
let failed = super::Dispatch {
|
||||
layered: false,
|
||||
alpha: AlphaOutcome::Failed { code: 87 },
|
||||
};
|
||||
assert!(failed.describe().starts_with("layered=FAILED"));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,287 @@
|
||||
//! 命令行参数（骨架期 + 组件库 harness 需要的那些；业务开关等页面 mission 再加）。
|
||||
//!
|
||||
//! 取值语法与现役 Slint 版一致：`--key value` 与 `--key=value` 两种都认
|
||||
//! （`crates/app/src/screenshot.rs` 的 `value_of` 是同一口径），这样将来 CI 换 bin 不用改脚本。
|
||||
//!
|
||||
//! ## 参数总表
|
||||
//!
|
||||
//! | 参数 | 取值 | 语义 |
|
||||
//! |---|---|---|
|
||||
//! | `--software-renderer` | — | 等价 `--renderer=cpu`（D27 的 CPU 档） |
|
||||
//! | `--renderer` | `auto`/`gpu`/`cpu` | 渲染后端请求 |
|
||||
//! | `--theme` | `light`/`dark` | 主题；不给则跟随系统（仅交互模式） |
|
||||
//! | `--screenshot` / `--screenshot-theme` | 路径 / `light`·`dark` | 截图通道（出图后退出）与截图专用主题 |
|
||||
//! | `--screen` | `shell`/`gallery` | 启动画面；**`gallery` = 组件库视觉验收 harness**（D39 §5） |
|
||||
//! | `--scale-factor` | `>0` | 强制缩放因子（验收要 100%，即 `1`） |
|
||||
//! | `--diff` / `--diff-scan` | 两个路径 / 非负整数 | 逐像素对比（不开窗）与 ±n px 平移扫描 |
|
||||
//! | `--force-state` | `rest`/`hover`/`pressed` | 把整屏可交互控件强制成某态（取证）；**给了 `--screenshot` 就默认 `rest`** |
|
||||
//! | `--data-dir` | 路径 | 翻牌兼容：**接受并忽略**（CI 冒烟在用） |
|
||||
//!
|
||||
//! **截图主题默认 Light（门禁依赖，不许改回 None）**，理由与不变量见
|
||||
//! [`Options::capture_flavor`] 与 `app.rs` 的截图路径。
|
||||
|
||||
use std::path::PathBuf;
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
|
||||
/// 渲染后端请求（D27）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
|
||||
pub enum Backend {
|
||||
/// 探测后决定：有硬件 GPU 就让 iced 自己走 wgpu→tiny-skia 回退；没有就强制 CPU 起步。
|
||||
#[default]
|
||||
Auto,
|
||||
/// 优先 GPU（写 `ICED_BACKEND=wgpu,tiny-skia`；拿不到适配器仍会降级，不硬失败）。
|
||||
Gpu,
|
||||
/// 强制 CPU（`--software-renderer` 的等价物，写 `ICED_BACKEND=tiny-skia`）。
|
||||
Cpu,
|
||||
}
|
||||
|
||||
impl Backend {
|
||||
/// 稳定名字（日志用）。
|
||||
pub const fn name(self) -> &'static str {
|
||||
match self {
|
||||
Backend::Auto => "auto",
|
||||
Backend::Gpu => "gpu",
|
||||
Backend::Cpu => "cpu",
|
||||
}
|
||||
}
|
||||
|
||||
/// 截图日志用的后端说明（`cfg!(feature = "gpu")` 决定有没有 wgpu 这一档）。
|
||||
pub fn note(self) -> &'static str {
|
||||
if !cfg!(feature = "gpu") {
|
||||
return "cpu(build without wgpu)";
|
||||
}
|
||||
match self {
|
||||
Backend::Cpu => "cpu(forced)",
|
||||
Backend::Gpu => "gpu(preferred)",
|
||||
Backend::Auto => "auto",
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 启动画面（D39 §5：`gallery` 是视觉验收 harness，不是产品页面）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
|
||||
pub enum Screen {
|
||||
/// 产品骨架：自绘标题栏 + 导航轨 + 内容区。
|
||||
#[default]
|
||||
Shell,
|
||||
/// 组件库 harness：整窗只放状态矩阵。
|
||||
Gallery,
|
||||
}
|
||||
|
||||
impl Screen {
|
||||
/// 稳定名字（日志用）。
|
||||
pub const fn name(self) -> &'static str {
|
||||
match self {
|
||||
Screen::Shell => "shell",
|
||||
Screen::Gallery => "gallery",
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 解析后的启动参数。
|
||||
#[derive(Debug, Clone, PartialEq, Default)]
|
||||
pub struct Options {
|
||||
/// 渲染后端请求。
|
||||
pub backend: Backend,
|
||||
/// 主题：`None` = 探测系统主题。
|
||||
pub theme: Option<SchemeFlavor>,
|
||||
/// 截图通道：给了路径就出图后退出。
|
||||
pub screenshot: Option<PathBuf>,
|
||||
/// `--screenshot-theme`（优先级高于 `--theme`）。
|
||||
pub screenshot_theme: Option<SchemeFlavor>,
|
||||
/// 强制窗口缩放因子（验收要 100% DPI，即 `1`；`None` = 用系统 DPI）。
|
||||
pub scale_factor: Option<f32>,
|
||||
/// `--diff <left> <right>` 与 `--diff-scan <n>`：逐像素对比（不开窗）与 ±n px 平移扫描。
|
||||
pub diff: Option<(PathBuf, PathBuf)>,
|
||||
/// 见上（默认 0 = 不扫）。
|
||||
pub diff_scan: u32,
|
||||
/// `--force-state=hover|pressed`：把按钮强制成某个状态便于截图取证（D30 的状态图）。
|
||||
pub force_state: Option<ForcedState>,
|
||||
/// `--screen=shell|gallery`：启动画面（`gallery` = 组件库视觉验收 harness）。
|
||||
pub screen: Screen,
|
||||
/// `--data-dir <dir>`：当前**接受并忽略**（现役 Slint 版 CI 冒烟在用；
|
||||
/// 真正的消费由后续页面 mission 接 `host`/`state` 时做）。
|
||||
pub data_dir: Option<PathBuf>,
|
||||
}
|
||||
|
||||
/// 截图取证用的强制交互状态（只影响观感，不改变任何状态机）。
|
||||
///
|
||||
/// 五态完整矩阵由 `--screen=gallery` 的 `Button::state(..)` 出，本开关只给整屏取证。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub enum ForcedState {
|
||||
/// **常态**（静息）：压掉系统光标带来的 hover/pressed。
|
||||
///
|
||||
/// 截图通道（给了 `--screenshot`）**默认就是它**，理由是实测：M99 复审在同一个 exe 上连跑 8 次，
|
||||
/// 第 6 次给出第三个 hash，差异区是某个按钮被画成 `Hovered`——因为 harness/产品都开真窗口，
|
||||
/// `button::Status` 由系统光标位置决定。取证图不能因为「指针恰好压在某个按钮上」而变色。
|
||||
/// 显式 `--force-state=hover|pressed` 仍然优先（那是**故意**要画那个态）。
|
||||
///
|
||||
/// ⚠️ **语义边界**：`Rest` 落成 `Interaction::Enabled`，而 `components::buttons::assemble()`
|
||||
/// 把「没有 `on_press`」的按钮默认画成 **Disabled** —— 于是 `Rest` 会把一个本应禁用的按钮
|
||||
/// 画成可用。当前零影响（所有 `forced_state(` 调用点与 shell 的 caption / nav 按钮都带消息），
|
||||
/// 但给「无消息按钮」出取证图时别套 `Rest`。
|
||||
Rest,
|
||||
/// 所有可交互控件按 hover 画。
|
||||
Hover,
|
||||
/// 所有可交互控件按 pressed 画。
|
||||
Pressed,
|
||||
}
|
||||
|
||||
impl Options {
|
||||
/// 从进程参数解析（错误信息是人话，不 panic、不 `exit`）。
|
||||
///
|
||||
/// # Errors
|
||||
/// 取值不合法（未知 `--renderer`/`--theme`/`--screen`、非法 `--scale-factor`）时返回人话。
|
||||
pub fn from_env() -> Result<Self, String> {
|
||||
Self::parse(std::env::args().skip(1))
|
||||
}
|
||||
|
||||
/// 从任意参数序列解析（`argv[1..]`，测试直接喂数组）。
|
||||
///
|
||||
/// # Errors
|
||||
/// 同 [`Options::from_env`]。
|
||||
pub fn parse(args: impl IntoIterator<Item = String>) -> Result<Self, String> {
|
||||
let mut options = Self::default();
|
||||
let mut args = args.into_iter();
|
||||
|
||||
while let Some(arg) = args.next() {
|
||||
let (key, inline) = match arg.split_once('=') {
|
||||
Some((key, value)) => (key.to_owned(), Some(value.to_owned())),
|
||||
None => (arg.clone(), None),
|
||||
};
|
||||
|
||||
match key.as_str() {
|
||||
"--software-renderer" => options.backend = Backend::Cpu,
|
||||
"--renderer" => {
|
||||
let value = take(&mut args, inline, "--renderer")?;
|
||||
options.backend = match value.as_str() {
|
||||
"auto" => Backend::Auto,
|
||||
"gpu" => Backend::Gpu,
|
||||
"cpu" => Backend::Cpu,
|
||||
other => {
|
||||
return Err(format!("--renderer 只认 auto|gpu|cpu，收到 {other:?}"));
|
||||
}
|
||||
};
|
||||
}
|
||||
"--theme" => {
|
||||
options.theme = Some(flavor(&take(&mut args, inline, "--theme")?)?);
|
||||
}
|
||||
"--screenshot-theme" => {
|
||||
options.screenshot_theme =
|
||||
Some(flavor(&take(&mut args, inline, "--screenshot-theme")?)?);
|
||||
}
|
||||
"--screenshot" => {
|
||||
options.screenshot =
|
||||
Some(PathBuf::from(take(&mut args, inline, "--screenshot")?));
|
||||
}
|
||||
"--scale-factor" => {
|
||||
let raw = take(&mut args, inline, "--scale-factor")?;
|
||||
let value: f32 = raw
|
||||
.parse()
|
||||
.map_err(|_| format!("--scale-factor 需要数字，收到 {raw:?}"))?;
|
||||
if !(value.is_finite() && value > 0.0) {
|
||||
return Err(format!("--scale-factor 必须 > 0，收到 {raw:?}"));
|
||||
}
|
||||
options.scale_factor = Some(value);
|
||||
}
|
||||
"--diff" => {
|
||||
let left = take(&mut args, inline, "--diff")?;
|
||||
let right = args
|
||||
.next()
|
||||
.ok_or_else(|| "--diff 需要两张图的路径".to_owned())?;
|
||||
options.diff = Some((PathBuf::from(left), PathBuf::from(right)));
|
||||
}
|
||||
"--diff-scan" => {
|
||||
let raw = take(&mut args, inline, "--diff-scan")?;
|
||||
options.diff_scan = raw
|
||||
.parse()
|
||||
.map_err(|_| format!("--diff-scan 需要非负整数，收到 {raw:?}"))?;
|
||||
}
|
||||
"--force-state" => {
|
||||
let raw = take(&mut args, inline, "--force-state")?;
|
||||
options.force_state = Some(match raw.as_str() {
|
||||
"rest" => ForcedState::Rest,
|
||||
"hover" => ForcedState::Hover,
|
||||
"pressed" => ForcedState::Pressed,
|
||||
other => {
|
||||
return Err(format!(
|
||||
"--force-state 只认 rest|hover|pressed，收到 {other:?}"
|
||||
));
|
||||
}
|
||||
});
|
||||
}
|
||||
"--screen" => {
|
||||
let raw = take(&mut args, inline, "--screen")?;
|
||||
options.screen = match raw.as_str() {
|
||||
"shell" => Screen::Shell,
|
||||
"gallery" => Screen::Gallery,
|
||||
other => {
|
||||
return Err(format!("--screen 只认 shell|gallery，收到 {other:?}"));
|
||||
}
|
||||
};
|
||||
}
|
||||
// 翻牌前的兼容参数：接受并忽略（见字段文档）
|
||||
"--data-dir" => {
|
||||
options.data_dir = Some(PathBuf::from(take(&mut args, inline, "--data-dir")?));
|
||||
}
|
||||
other => return Err(format!("未知参数 {other:?}")),
|
||||
}
|
||||
}
|
||||
|
||||
// **截图通道默认强制 `Rest`**（M100）：取证图不许跟着系统指针的位置变。
|
||||
// 交互模式保持 `None`——那是用户的真窗口，不许替用户把状态钉死（钉死了就永远看不到 hover）。
|
||||
if options.screenshot.is_some() && options.force_state.is_none() {
|
||||
options.force_state = Some(ForcedState::Rest);
|
||||
}
|
||||
|
||||
Ok(options)
|
||||
}
|
||||
|
||||
/// 截图时实际使用的主题（**只表达用户显式给了什么**；默认值见 [`Options::capture_flavor`]）。
|
||||
pub fn shot_flavor(&self) -> Option<SchemeFlavor> {
|
||||
self.screenshot_theme.or(self.theme)
|
||||
}
|
||||
|
||||
/// 本次进程真正要画的主题（**唯一取值口**）。
|
||||
///
|
||||
/// 截图模式（给了 `--screenshot`）**永远返回 `Some`**：`--screenshot-theme` > `--theme` > Light。
|
||||
/// 交互模式只有显式指定才有值（`None` = 等系统主题）。
|
||||
///
|
||||
/// ⚠️ **门禁依赖，不许把截图分支改回 `None`**：CI 的 runtime-smoke 打
|
||||
/// `--software-renderer --screenshot <png> --data-dir <dir>`（不带主题），xvfb 里没有桌面主题
|
||||
/// 会话，M68 的「等系统主题到达再出图」闸门在这条路径上会把 runner 挂到超时（不是红，更难查）。
|
||||
pub fn capture_flavor(&self) -> Option<SchemeFlavor> {
|
||||
match self.screenshot {
|
||||
Some(_) => Some(self.shot_flavor().unwrap_or(SchemeFlavor::Light)),
|
||||
None => self.shot_flavor(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 是否要问系统主题。截图模式**永远不问**——这就是「无主题环境不会卡住」的不变量。
|
||||
pub fn wants_system_theme(&self) -> bool {
|
||||
self.capture_flavor().is_none()
|
||||
}
|
||||
}
|
||||
|
||||
fn take(
|
||||
args: &mut impl Iterator<Item = String>,
|
||||
inline: Option<String>,
|
||||
flag: &str,
|
||||
) -> Result<String, String> {
|
||||
inline
|
||||
.or_else(|| args.next())
|
||||
.ok_or_else(|| format!("{flag} 需要一个值"))
|
||||
}
|
||||
|
||||
fn flavor(raw: &str) -> Result<SchemeFlavor, String> {
|
||||
match raw {
|
||||
"light" => Ok(SchemeFlavor::Light),
|
||||
"dark" => Ok(SchemeFlavor::Dark),
|
||||
other => Err(format!("--theme 只认 light|dark，收到 {other:?}")),
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
#[path = "cli/tests.rs"]
|
||||
mod tests;
|
||||
@@ -0,0 +1,172 @@
|
||||
//! `cli::Options` 的解析断言（M100 从 `cli.rs` 内联的 `mod tests` 搬出来：那边 394 行，
|
||||
//! 加一个 `ForcedState::Rest` 就必然破 400）。
|
||||
//!
|
||||
//! 搬移**不改一行断言**：只去掉了 `mod tests { }` 那一层缩进，外加 M100 新增的
|
||||
//! `screenshots_default_to_the_rest_state`（见文件末尾）。
|
||||
//!
|
||||
//! 站位：本文件是 `crate::cli::tests`，`use super::*;` 就够（`Options` / `ForcedState` /
|
||||
//! `Backend` / `Screen` 都在 `cli` 里）。
|
||||
use super::*;
|
||||
|
||||
fn parse(args: &[&str]) -> Result<Options, String> {
|
||||
Options::parse(args.iter().map(|arg| (*arg).to_owned()))
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn defaults_are_auto_system_theme_and_shell() {
|
||||
let options = parse(&[]).expect("空参数要能解析");
|
||||
assert_eq!(options.backend, Backend::Auto);
|
||||
assert_eq!((options.theme, options.screenshot), (None, None));
|
||||
assert_eq!(options.screen, Screen::Shell);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn software_renderer_is_an_alias_of_cpu() {
|
||||
assert_eq!(
|
||||
parse(&["--software-renderer"]).unwrap().backend,
|
||||
Backend::Cpu
|
||||
);
|
||||
assert_eq!(parse(&["--renderer=cpu"]).unwrap().backend, Backend::Cpu);
|
||||
assert_eq!(parse(&["--renderer", "gpu"]).unwrap().backend, Backend::Gpu);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn both_argv_forms_are_accepted() {
|
||||
let spaced = parse(&["--screenshot", "out.png"]).unwrap();
|
||||
let inline = parse(&["--screenshot=out.png"]).unwrap();
|
||||
assert_eq!(spaced.screenshot, Some(PathBuf::from("out.png")));
|
||||
assert_eq!(spaced.screenshot, inline.screenshot);
|
||||
assert_eq!(
|
||||
parse(&["--diff", "a.png", "b.png"]).unwrap().diff,
|
||||
Some((PathBuf::from("a.png"), PathBuf::from("b.png")))
|
||||
);
|
||||
assert_eq!(
|
||||
parse(&["--screen", "gallery"]).unwrap().screen,
|
||||
Screen::Gallery
|
||||
);
|
||||
assert_eq!(parse(&["--diff-scan=2"]).unwrap().diff_scan, 2);
|
||||
assert_eq!(
|
||||
parse(&["--force-state", "hover"]).unwrap().force_state,
|
||||
Some(ForcedState::Hover)
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn screenshot_theme_wins_over_theme() {
|
||||
let o = parse(&["--theme=dark", "--screenshot-theme=light"]).unwrap();
|
||||
assert_eq!(
|
||||
(o.theme, o.shot_flavor()),
|
||||
(Some(SchemeFlavor::Dark), Some(SchemeFlavor::Light))
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn bad_values_are_reported_not_panicked() {
|
||||
for args in [
|
||||
&["--renderer=metal"][..],
|
||||
&["--theme=blue"],
|
||||
&["--scale-factor=0"],
|
||||
&["--scale-factor=abc"],
|
||||
&["--screenshot"],
|
||||
&["--diff", "only-one.png"],
|
||||
&["--screen=settings"],
|
||||
&["--force-state=focus"],
|
||||
&["--diff-scan=-1"],
|
||||
&["--nope"],
|
||||
] {
|
||||
assert!(parse(args).is_err(), "{args:?} 应该报错");
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn data_dir_is_accepted_and_ignored_for_the_flip() {
|
||||
// 现役 CI 冒烟：--software-renderer --screenshot <png> --data-dir <dir>
|
||||
let options = parse(&[
|
||||
"--software-renderer",
|
||||
"--screenshot",
|
||||
"shot.png",
|
||||
"--data-dir",
|
||||
"/d/tmp/x",
|
||||
])
|
||||
.expect("翻牌前必须兼容 --data-dir");
|
||||
assert_eq!(options.backend, Backend::Cpu);
|
||||
assert_eq!(options.screenshot, Some(PathBuf::from("shot.png")));
|
||||
assert_eq!(options.data_dir, Some(PathBuf::from("/d/tmp/x")));
|
||||
}
|
||||
|
||||
/// **取证不变量（M100）**：截图通道默认 Rest，交互模式保持 `None`，显式要态仍然优先。
|
||||
///
|
||||
/// 抓得住：① 谁把截图默认值改回 `None`（系统指针 hover 会重新漏进图，M99 复审实测翻盘过一次）；
|
||||
/// ② 谁顺手在交互模式也钉死状态（那会让真窗口永远看不到 hover）。
|
||||
/// 抓不住：**产品页**上是否还有不消费 forced 的控件——那要出图比对，测试管不了。
|
||||
#[test]
|
||||
fn screenshots_default_to_the_rest_state() {
|
||||
assert_eq!(
|
||||
parse(&["--force-state=rest"]).unwrap().force_state,
|
||||
Some(ForcedState::Rest),
|
||||
"rest 是显式的合法取值"
|
||||
);
|
||||
assert_eq!(
|
||||
parse(&["--screenshot", "out.png"]).unwrap().force_state,
|
||||
Some(ForcedState::Rest),
|
||||
"截图通道必须默认 Rest"
|
||||
);
|
||||
assert_eq!(
|
||||
parse(&["--screenshot", "o.png", "--force-state=hover"])
|
||||
.unwrap()
|
||||
.force_state,
|
||||
Some(ForcedState::Hover),
|
||||
"显式要态时按用户给的画（状态矩阵图靠它）"
|
||||
);
|
||||
assert_eq!(
|
||||
parse(&["--screenshot", "o.png", "--force-state=pressed"])
|
||||
.unwrap()
|
||||
.force_state,
|
||||
Some(ForcedState::Pressed)
|
||||
);
|
||||
assert_eq!(
|
||||
parse(&[]).unwrap().force_state,
|
||||
None,
|
||||
"交互模式不许替用户钉死状态"
|
||||
);
|
||||
assert_eq!(parse(&["--theme=dark"]).unwrap().force_state, None);
|
||||
}
|
||||
|
||||
/// **门禁依赖**：CI 的 runtime-smoke 不带主题，截图模式必须有确定主题。
|
||||
/// 退化成 `None` 的话，xvfb 里的 runner 会挂到超时（不是红，更难查）。
|
||||
#[test]
|
||||
fn screenshot_without_theme_defaults_to_light() {
|
||||
let options = parse(&["--screenshot", "out.png"]).unwrap();
|
||||
assert_eq!(options.shot_flavor(), None, "用户没给主题");
|
||||
assert_eq!(
|
||||
options.capture_flavor(),
|
||||
Some(SchemeFlavor::Light),
|
||||
"截图模式必须给确定主题（CI 冒烟依赖这条）"
|
||||
);
|
||||
assert!(!options.wants_system_theme(), "截图模式不许等系统主题");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn explicit_themes_still_win_in_screenshot_mode() {
|
||||
let dark = parse(&["--screenshot", "a.png", "--theme=dark"]).unwrap();
|
||||
assert_eq!(dark.capture_flavor(), Some(SchemeFlavor::Dark));
|
||||
|
||||
let both = parse(&[
|
||||
"--screenshot",
|
||||
"a.png",
|
||||
"--theme=dark",
|
||||
"--screenshot-theme=light",
|
||||
]);
|
||||
assert_eq!(both.unwrap().capture_flavor(), Some(SchemeFlavor::Light));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn interactive_mode_still_follows_the_system_theme() {
|
||||
let interactive = parse(&[]).unwrap();
|
||||
assert_eq!(interactive.capture_flavor(), None);
|
||||
assert!(interactive.wants_system_theme(), "交互模式等系统主题");
|
||||
|
||||
let pinned = parse(&["--theme=dark"]).unwrap();
|
||||
assert_eq!(pinned.capture_flavor(), Some(SchemeFlavor::Dark));
|
||||
assert!(!pinned.wants_system_theme());
|
||||
}
|
||||
@@ -0,0 +1,230 @@
|
||||
//! 装配与样式：五式共用的一条产线（尺寸 / 内边距 / 图标盒 / 状态层 / 描边）。
|
||||
//!
|
||||
//! 单独成文件的原因：`mod.rs` 已经是「对外契约 + 变体角色表」，把绘制细节放一起会顶到 400 行红线；
|
||||
//! 而且这条产线是**唯一**会把「令牌 → 像素」翻一次的地方，独立出来才好审。
|
||||
|
||||
use iced::widget::text::LineHeight;
|
||||
use iced::widget::{button, text, Row};
|
||||
use iced::{Alignment, Background, Border, Element, Length, Pixels, Shadow};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::elevation::Elevation;
|
||||
use unlucky_design::shape::ShapeScale;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::icons;
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::interaction::{self, Interaction};
|
||||
use super::super::layout;
|
||||
use super::{Geometry, Variant};
|
||||
|
||||
/// 一个按钮样式要的全部输入（避免 `style_closure` 长出七个位置参数）。
|
||||
#[derive(Debug, Clone, Copy)]
|
||||
pub(super) struct StyleSpec {
|
||||
/// 容器填充角色；`None` = 透明（Outlined / Text / StandardIcon）。
|
||||
pub fill: Option<Role>,
|
||||
/// 内容（文字 + 图标）角色。
|
||||
pub content: Role,
|
||||
/// 描边角色；`None` = 无描边。
|
||||
pub border: Option<Role>,
|
||||
/// 圆角档位（来自组件表，五式统一 `Full`）。
|
||||
pub shape: ShapeScale,
|
||||
/// 描边宽度（`Geometry::stroke`：有描边的变体 = `stroke::HAIRLINE`，其余 0）。
|
||||
pub stroke: f32,
|
||||
/// 圆角折算用的边长（药丸 = 可见高）。
|
||||
pub radius_side: f32,
|
||||
/// 强制态（gallery 取证）；`None` = 跟随运行期的 `button::Status`。
|
||||
///
|
||||
/// **`Some(Enabled)` 与 `None` 不是一回事**：截图取证必须能强制「静息」，否则光标恰好停在
|
||||
/// 某个按钮上时那一格会被画成 hover（实测踩过：text 行 enabled 列出现不该有的灰底容器，
|
||||
/// 看起来像 Text 按钮自带容器）。
|
||||
pub forced: Option<Interaction>,
|
||||
}
|
||||
|
||||
/// 五式共用的装配：**只画一处**，五个变体函数都走这里。
|
||||
pub(super) fn assemble<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
variant: Variant,
|
||||
spec: super::Button<'a, M>,
|
||||
) -> Element<'a, M> {
|
||||
let geometry = Geometry::of(ui, variant, spec.leading.is_some());
|
||||
let (fill, content, border) = variant.roles();
|
||||
let forced = spec.state.or(if spec.on_press.is_none() {
|
||||
Some(Interaction::Disabled)
|
||||
} else {
|
||||
None
|
||||
});
|
||||
|
||||
// 按钮家族没有浮层级高程：L1（Elevated）只用容器色调差表达（rubric §7 不画阴影）
|
||||
debug_assert!(
|
||||
!matches!(
|
||||
variant.elevation(),
|
||||
Elevation::Level3 | Elevation::Level4 | Elevation::Level5
|
||||
),
|
||||
"按钮家族不许有浮层高程"
|
||||
);
|
||||
// **内容色必须跟着态走**：禁用时文字/图标是 on-surface@38%，不是满档内容色。
|
||||
// 早先这里恒取 `ui.color(content)`，再被 `text(...).color(..)` 钉死，`Style.text_color`
|
||||
// 里的 38% 永远下发不出去 —— 表现为「text / standard icon 的 enabled 格与 disabled 格
|
||||
// 逐像素相同」（视觉 reviewer 实测 changed_px = 0；filled 禁用标签 1.23:1）。
|
||||
let ink = content_color(ui, forced, content, fill, variant.disabled_content());
|
||||
|
||||
let label = text(spec.label)
|
||||
.size(ui.style(TypeRole::LabelLarge).size_px)
|
||||
.line_height(LineHeight::Absolute(Pixels(
|
||||
ui.style(TypeRole::LabelLarge).line_height_px,
|
||||
)))
|
||||
.font(ui.font_of(ui.emphasized(TypeRole::LabelLarge)))
|
||||
.color(ink);
|
||||
|
||||
let mut row = Row::new().align_y(Alignment::Center);
|
||||
if let Some(kind) = spec.leading {
|
||||
// Q9：图标一律经固定尺寸容器（按钮图标 18、IconButton 24 都不例外）。
|
||||
// **必须走 `view_at`**：盒 18 ≠ `RENDER_PX`(24)，用 24 烘焙再缩到 18 会把视觉线宽从 1.5 压到 1.1
|
||||
// （复审 r1 P2-2 实测 1.04~1.25px）。
|
||||
row = row.push(layout::fixed(
|
||||
geometry.icon,
|
||||
geometry.icon,
|
||||
icons::view_at::<M>(kind, ink, geometry.icon),
|
||||
));
|
||||
}
|
||||
row = row.push(label);
|
||||
if let Some(kind) = spec.trailing {
|
||||
row = row.push(layout::fixed(
|
||||
geometry.icon,
|
||||
geometry.icon,
|
||||
icons::view_at::<M>(kind, ink, geometry.icon),
|
||||
));
|
||||
}
|
||||
let row = row.spacing(geometry.gap);
|
||||
|
||||
// **垂直居中必须在内容侧做**：iced 的 `button::layout` 把内容放在 padding-box 的左上角
|
||||
// （`layout::padded` 只 `move_to(padding.top)`，不做居中），所以内容自己撑满高度再居中。
|
||||
// 少了这一层，40 高的按钮里文字会贴上沿 10px（实测首版就是这样）。
|
||||
let content_box = iced::widget::container(row)
|
||||
.height(Length::Fill)
|
||||
.align_y(iced::Alignment::Center);
|
||||
|
||||
let style = style_closure(
|
||||
ui,
|
||||
StyleSpec {
|
||||
fill,
|
||||
content,
|
||||
border,
|
||||
shape: variant.shape(),
|
||||
stroke: geometry.stroke,
|
||||
radius_side: geometry.height,
|
||||
forced,
|
||||
},
|
||||
);
|
||||
|
||||
let element = button(content_box)
|
||||
.height(Length::Fixed(geometry.height))
|
||||
.padding(geometry.padding)
|
||||
.style(style);
|
||||
|
||||
match spec.on_press {
|
||||
Some(message) => element.on_press(message).into(),
|
||||
None => element.into(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 内容色（文字与图标共用）：禁用态走令牌的 38%，其余态就是角色色。
|
||||
///
|
||||
/// 单独成函数是为了让「内容色跟态走」这件事只有一处实现——`assemble`（文字按钮）与 `icon`
|
||||
/// （图标按钮）都调它，两条路径不会再各自钉死满档色。
|
||||
/// 内容色：**禁用时的角色由调用方按变体给**（[`super::Variant::disabled_content`] /
|
||||
/// [`super::IconVariant::disabled_content`]）——A1 里 FilledTonal 与 IconButton 是 `OnSurface`，
|
||||
/// 其余是 `OnSurfaceVariant`，不能在这里统一写死。
|
||||
pub(super) fn content_color(
|
||||
ui: &Ui,
|
||||
forced: Option<Interaction>,
|
||||
content: Role,
|
||||
fill: Option<Role>,
|
||||
disabled_content: Role,
|
||||
) -> iced::Color {
|
||||
match forced {
|
||||
// 有容器：38% 叠在**按钮家族 10% 容器**上（Filled / Tonal / Elevated）
|
||||
Some(Interaction::Disabled) if fill.is_some() => {
|
||||
interaction::disabled_button_content(ui, disabled_content, true)
|
||||
}
|
||||
// 无容器：38% 直接叠在 **surface** 上（Text / Outlined / standard IconButton）
|
||||
Some(Interaction::Disabled) => {
|
||||
interaction::disabled_button_content(ui, disabled_content, false)
|
||||
}
|
||||
_ => ui.color(content),
|
||||
}
|
||||
}
|
||||
|
||||
/// 生成 `button::style` 闭包：状态层 / 禁用 / 描边全在这里落地。
|
||||
pub(super) fn style_closure(
|
||||
ui: &Ui,
|
||||
spec: StyleSpec,
|
||||
) -> impl Fn(&iced::Theme, button::Status) -> button::Style + '_ {
|
||||
move |_theme: &iced::Theme, status| {
|
||||
// 强制态优先（gallery 状态矩阵），否则把 iced 的四态翻成 M3 五态
|
||||
let state = spec
|
||||
.forced
|
||||
.unwrap_or_else(|| Interaction::from_status(status));
|
||||
|
||||
let (background, text_color) = if state.is_disabled() {
|
||||
let (container, content) = interaction::disabled_button_colors(ui, Role::Surface);
|
||||
// 透明容器在禁用态依然透明（官方只改内容透明度）
|
||||
(spec.fill.map(|_| container), content)
|
||||
} else {
|
||||
// 有填充：状态层叠在**容器角色**上；透明容器：叠在表面色上（否则 hover 看不见）
|
||||
let background = match spec.fill {
|
||||
Some(role) => match state.layer() {
|
||||
Some(_) => interaction::overlay_color(ui, state, spec.content, role)
|
||||
.or(Some(ui.color(role))),
|
||||
None => Some(ui.color(role)),
|
||||
},
|
||||
None => transparent_state_color(ui, state, spec.content),
|
||||
};
|
||||
(background, ui.color(spec.content))
|
||||
};
|
||||
|
||||
let border_color = if state.is_disabled() {
|
||||
interaction::disabled_button_colors(ui, Role::Surface).0
|
||||
} else {
|
||||
spec.border
|
||||
.map_or_else(|| ui.color(Role::OutlineVariant), |role| ui.color(role))
|
||||
};
|
||||
|
||||
button::Style {
|
||||
background: background.map(Background::Color),
|
||||
text_color,
|
||||
border: Border {
|
||||
color: if spec.border.is_some() {
|
||||
border_color
|
||||
} else {
|
||||
iced::Color::TRANSPARENT
|
||||
},
|
||||
// 线宽来自 `Geometry::stroke`（有描边的变体 = HAIRLINE，其余 0）；
|
||||
// `spec.border.is_none()` 时颜色是透明的，宽度也就无所谓了。
|
||||
width: spec.stroke,
|
||||
radius: ui.radius(spec.shape, spec.radius_side),
|
||||
},
|
||||
// rubric §7：L0/L1 不用阴影（Elevated 的 L1 由容器色调差表达）
|
||||
shadow: Shadow::default(),
|
||||
// ⚠️ `snap` 目前**只有 wgpu 后端实现**；我们的验收图走 tiny-skia（CPU），
|
||||
// 所以这个 `true` 在验收图上不起作用——分隔线的「1dp 摊成 2 行」正是这个原因，
|
||||
// 不是「iced 没有 snap」（reviewer P2-4 纠正的正是我上一版报告里的说法）。
|
||||
snap: true,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 透明容器的状态层：`Outlined` / `Text` / `StandardIcon` 没有填充，可见反馈只能来自
|
||||
/// 叠在**内容角色**上的状态层——把它们当作「叠在表面色上」求值，得到不透明实色。
|
||||
///
|
||||
/// 之所以单独一个函数：这是 M3 里唯一「容器不存在但状态层存在」的情形，
|
||||
/// 三个变体共用一条口径，免得各自发挥。
|
||||
pub(super) fn transparent_state_color(
|
||||
ui: &Ui,
|
||||
state: Interaction,
|
||||
content: Role,
|
||||
) -> Option<iced::Color> {
|
||||
interaction::overlay_color(ui, state, content, Role::Surface)
|
||||
}
|
||||
@@ -0,0 +1,97 @@
|
||||
//! 按钮家族的**内部几何**：一个数值都不写，全部由 `unlucky_design` 的令牌推导。
|
||||
//!
|
||||
//! | 量 | 令牌 | 值（DESKTOP / 100% DPI） |
|
||||
//! |---|---|---|
|
||||
//! | 可见高 | `LayoutMetrics::control_height` | 40 `[源]` 12b 1.1 |
|
||||
//! | 圆角 | `ShapeScale::Full.radius_px(高)` | 20 `[源]` 12b 1.2 |
|
||||
//! | 左右内边距（无图标） | `Space::X6` | 24 / 24 `[源]` 12b 1.3 |
|
||||
//! | 左内边距（带前置图标） | `Space::X4` | 16 `[源]` 12b 1.4 |
|
||||
//! | 图标边长 | `IconSize::Button` | 18 `[源]` AAR `ButtonDefaults.IconSize = 18.dp`（12b 1.6 同值） |
|
||||
//! | 图标↔文字 | `Space::X2` | 8 `[源]` 12b 1.6 |
|
||||
//! | 描边 | `unlucky_design::stroke::HAIRLINE`（`crate::theme::STROKE_PX` 同一真源） | 1 `[源]` rubric G7 |
|
||||
//! | IconButton 边长 | `LayoutMetrics::control_height` | 40 `[源]` 12b 2.1 |
|
||||
//! | IconButton 图标 / 边距 | `IconSize::Toolbar` / `Space::X2` | 24 / 8 `[源]` 12b 2.2 |
|
||||
//!
|
||||
//! **没有落点的一个参考值**（登记在报告里，不在此处写数）：
|
||||
//!
|
||||
//! - 12b 1.7 最小宽 **58** → `G15`：iced 的 `Length` 没有 min-width 语义；按「24 + 24 内边距 +
|
||||
//! LabelLarge 二字」自然宽度 ≈ 76，实际不触发，故本 mission 不施加该约束。
|
||||
//!
|
||||
//! **G14 已收口（M86）**：这里曾登记「12b 1.6 图标 18 → 令牌只有 16，先用 16 并偏离 2px」。
|
||||
//! 令牌层现在有 18 档（[`IconSize::Button`]，出处在 `crates/design/src/icons/mod.rs`），
|
||||
//! 所以本文件取 18 就是**回到规范值**，不再是偏离。**别按 `ButtonSmallTokens.IconSize = 20` 改**：
|
||||
//! 那个 token 在 AAR 里零消费（没有任何类读它的 `getIconSize`），是死令牌。
|
||||
|
||||
use iced::Padding;
|
||||
|
||||
use unlucky_design::icons::IconSize;
|
||||
use unlucky_design::spacing::Space;
|
||||
|
||||
use crate::theme::{Ui, STROKE_PX};
|
||||
|
||||
use super::Variant;
|
||||
|
||||
/// 文字按钮的几何。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct Geometry {
|
||||
/// 可见高（药丸圆角按它折算）。
|
||||
pub height: f32,
|
||||
/// 内边距（上下 0；左右按有无前置图标取 16 或 24）。
|
||||
pub padding: Padding,
|
||||
/// 图标盒边长。
|
||||
pub icon: f32,
|
||||
/// 图标 ↔ 文字间距。
|
||||
pub gap: f32,
|
||||
/// 描边宽度；`0` = 该式无描边。
|
||||
pub stroke: f32,
|
||||
}
|
||||
|
||||
impl Geometry {
|
||||
/// 按变体 + 有没有前置图标求值（带图标时左内边距收到 16，右仍 24）。
|
||||
pub fn of(ui: &Ui, variant: Variant, leading_icon: bool) -> Self {
|
||||
let (_, _, border) = variant.roles();
|
||||
let start = if leading_icon {
|
||||
ui.space(Space::X4)
|
||||
} else {
|
||||
ui.space(Space::X6)
|
||||
};
|
||||
|
||||
Self {
|
||||
height: ui.metrics().control_height,
|
||||
padding: Padding {
|
||||
top: 0.0,
|
||||
right: ui.space(Space::X6),
|
||||
bottom: 0.0,
|
||||
left: start,
|
||||
},
|
||||
icon: IconSize::Button.px(),
|
||||
gap: ui.space(Space::X2),
|
||||
stroke: if border.is_some() { STROKE_PX } else { 0.0 },
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// IconButton 的几何（正方形，图标 24、边距 8）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct IconGeometry {
|
||||
/// 容器边长（40，命中区 48 由父级留白补足）。
|
||||
pub side: f32,
|
||||
/// 图标盒边长（24）——**必须**经 `layout::centered_fixed` 锁住，否则 Q9 会把字形撑满。
|
||||
pub icon: f32,
|
||||
/// 图标到容器边的默认边距（8；narrow 4 / wide 14 属变体参数，本 mission 不用）。
|
||||
pub padding: f32,
|
||||
}
|
||||
|
||||
impl IconGeometry {
|
||||
/// 从令牌求值。图标边长**由 `side − 2×padding` 推导**（40 − 16 = 24），
|
||||
/// 与 `IconSize::Toolbar`（24）互为校验：两者不等说明令牌层动了，单测会先红。
|
||||
pub fn of(ui: &Ui) -> Self {
|
||||
let side = ui.metrics().control_height;
|
||||
let padding = ui.space(Space::X2);
|
||||
Self {
|
||||
side,
|
||||
icon: side - 2.0 * padding,
|
||||
padding,
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,348 @@
|
||||
//! 按钮家族（`research/12b` §1 五式 + §2 IconButton）。
|
||||
//!
|
||||
//! ## 参考值（全部 `[源]` = A1，`material3-android:1.4.0` 的 `*Tokens.kt` / `Button.kt`）
|
||||
//!
|
||||
//! | # | 检查项 | 参考值 | 本模块落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 1.1 | 容器可见高 | **40** | `LM.control_height`（[`Geometry::height`]） |
|
||||
//! | 1.2 | 圆角 | **full = 高/2 = 20** | `ShapeScale::Full` + `Ui::radius` |
|
||||
//! | 1.3 | 水平内边距（无图标） | **24 / 24** | `Space::X6` |
|
||||
//! | 1.4 | 水平内边距（带前置图标） | **16（左）/ 24（右）** | `Space::X4` / `Space::X6` |
|
||||
//! | 1.5 | 字级 | **LabelLarge 14/20 w500** | `TypeRole::LabelLarge` 强调档 |
|
||||
//! | 1.6 | 图标 18 + 图标↔文字 8 | **18** = `IconSize::Button`（AAR `ButtonDefaults.IconSize`）；间距 `Space::X2` | [`Geometry`] |
|
||||
//! | 1.7 | 最小宽 58 | **G15**：iced 的 `Length` 无 min-width，不施加（实测见报告） | — |
|
||||
//! | 1.8 | 状态层 + 禁用 | hover 8 / focus 10 / pressed 10；容器 **10%**（官方 `DisabledContainerOpacity`；面状控件的 12% 是另一类）& 内容 38%；**内容角色按变体**（[`Variant::disabled_content`]） | [`super::interaction`] |
|
||||
//! | 1.9 | 五式色彩角色 | Filled `Primary`/`OnPrimary`；Tonal `SecondaryContainer`/`OnSecondaryContainer`；Elevated `SurfaceContainerLow`/`Primary`；Outlined 透明 + 1dp `OutlineVariant` + `OnSurfaceVariant`；Text 透明 + `OnSurfaceVariant` | [`Variant::roles`] |
|
||||
//! | 2.1 | IconButton 容器 | **40×40**、圆角 full | [`IconGeometry`] |
|
||||
//! | 2.2 | IconButton 图标 / 边距 | 图标 **24**、边距 **8** | [`IconGeometry`] |
|
||||
//! | 2.4 | Standard 各态**图标色不变** | 只有状态层变化 | [`Variant::roles`] 与态无关 |
|
||||
//! | 2.7 | IconButton 禁用 | 内容 **`OnSurface`@38%**（A1；见 [`IconVariant::disabled_content`]） | [`super::interaction::disabled_button_content`]（按钮族 10% 底） |
|
||||
//! | 2.8 | 命中区 | 容器 40 + 四周各 4 = **48** | `LM.touch_target`（按钮自身不撑高） |
|
||||
//!
|
||||
//! ## 与契约 §2 的签名差异（**已登记，请 tower 确认**）
|
||||
//!
|
||||
//! 契约 §2 的示例签名是 `filled(ui, label, on_press)`——三个参数装不下
|
||||
//! 「五式 × 五态 × 前后双图标 × 禁用」。所以本模块的落地是**契约的加法版**：
|
||||
//! 泛型纪律一字不改（`M: Clone`，不碰 `app::Message`），但把前两个参数收进 [`Button`]：
|
||||
//!
|
||||
//! ```text
|
||||
//! 契约示例： filled(ui, "保存", Message::Save)
|
||||
//! 本模块： filled(ui, Button::new("保存").press(Message::Save))
|
||||
//! ```
|
||||
//!
|
||||
//! 差别只是「label + 消息」两件事从位置参数变成构造器参数，语义一一对应；
|
||||
//! 要图标/禁用/焦点取证时再加链式调用（`.leading(..)` / `Button::disabled(..)` / `.state(..)`），
|
||||
//! 不需要第二个签名。**这是本周唯一一处偏离契约示例的地方**，报告「决策」一节有登记。
|
||||
//!
|
||||
//! ## 为什么不用 iced 内置的 `theme::Button` 样式
|
||||
//!
|
||||
//! iced 的内置按钮样式只有 `primary/success/danger/text` 几档，且**不带 M3 的状态层 α**
|
||||
//! （读的是 `Palette` 现成色）。D30 要求 hover 8% / pressed 10% 可判定，所以样式自绘；
|
||||
//! 但**只画颜色与描边**——尺寸仍由 `button` 的 width/height/padding 决定，不手搓几何。
|
||||
|
||||
use iced::widget::button;
|
||||
use iced::{Element, Length, Padding};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::component_map::Component;
|
||||
use unlucky_design::elevation::Elevation;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::shape::ShapeScale;
|
||||
|
||||
use crate::icons;
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::interaction::Interaction;
|
||||
use super::layout;
|
||||
|
||||
mod assemble;
|
||||
mod geometry;
|
||||
|
||||
pub use geometry::{Geometry, IconGeometry};
|
||||
|
||||
use assemble::{assemble, style_closure, StyleSpec};
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
|
||||
/// 按钮的五种视觉变体（12b §1.9 的色彩角色，一名一式）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||
pub enum Variant {
|
||||
/// 实心强调色：**每屏最多一个**（rubric K2）。
|
||||
Filled,
|
||||
/// 次强调（tonal）：`SecondaryContainer`。
|
||||
Tonal,
|
||||
/// 带高程：`SurfaceContainerLow` + `Primary` 文本（L1 用色调差，不画阴影）。
|
||||
Elevated,
|
||||
/// 描边：透明容器 + 1dp `OutlineVariant`。
|
||||
Outlined,
|
||||
/// 纯文本：最低权重。
|
||||
Text,
|
||||
}
|
||||
|
||||
impl Variant {
|
||||
/// 五式全序（gallery 的矩阵按这个次序出图）。
|
||||
pub const ALL: [Variant; 5] = [
|
||||
Variant::Filled,
|
||||
Variant::Tonal,
|
||||
Variant::Elevated,
|
||||
Variant::Outlined,
|
||||
Variant::Text,
|
||||
];
|
||||
|
||||
/// 稳定名字（图例 / 文件名 / 失败信息用）。
|
||||
pub const fn name(self) -> &'static str {
|
||||
match self {
|
||||
Variant::Filled => "filled",
|
||||
Variant::Tonal => "tonal",
|
||||
Variant::Elevated => "elevated",
|
||||
Variant::Outlined => "outlined",
|
||||
Variant::Text => "text",
|
||||
}
|
||||
}
|
||||
|
||||
/// 该式在组件表里的档位（圆角/字级）。`Component` 没有 `Outlined/Elevated` 变体，
|
||||
/// 借用 `PrimaryButton`：三者判据值相同（`Full` 圆角 + `LabelLarge` + L0）。
|
||||
pub(crate) const fn component(self) -> Component {
|
||||
match self {
|
||||
Variant::Filled => Component::PrimaryButton,
|
||||
Variant::Tonal => Component::SecondaryButton,
|
||||
Variant::Text => Component::TextButton,
|
||||
Variant::Elevated | Variant::Outlined => Component::PrimaryButton,
|
||||
}
|
||||
}
|
||||
|
||||
/// 圆角档位（五式统一 `Full`，12b 1.2）。
|
||||
pub(crate) fn shape(self) -> ShapeScale {
|
||||
self.component().spec().shape
|
||||
}
|
||||
|
||||
/// **禁用态的内容角色**（A1，逐变体不同——别在这里统一猜）。
|
||||
///
|
||||
/// | 变体 | 禁用内容 |
|
||||
/// |---|---|
|
||||
/// | Filled / Elevated / Outlined / Text | `OnSurfaceVariant` @0.38 |
|
||||
/// | **FilledTonal** | **`OnSurface` @0.38** ← A1 的显式例外（`FilledTonalButtonTokens`） |
|
||||
///
|
||||
/// 出处：AAR `material3-android:1.4.0` 的 `javap -c`，`FilledButtonTokens.
|
||||
/// DisabledLabelTextColor = OnSurfaceVariant`、`FilledTonalButtonTokens` 同一字段 = `OnSurface`。
|
||||
pub(crate) const fn disabled_content(self) -> Role {
|
||||
match self {
|
||||
Variant::Tonal => Role::OnSurface,
|
||||
_ => Role::OnSurfaceVariant,
|
||||
}
|
||||
}
|
||||
|
||||
/// 高程：只有 Elevated 是 L1（`ElevatedButtonTokens.ContainerElevation`），其余 L0。
|
||||
///
|
||||
/// **不画阴影**：rubric §7「L0/L1 不应有可见阴影（用 tone 差）」，所以 L1 只体现为
|
||||
/// `SurfaceContainerLow` 容器色，`button::Style.shadow` 永远 default。
|
||||
pub(crate) const fn elevation(self) -> Elevation {
|
||||
match self {
|
||||
Variant::Elevated => Elevation::Level1,
|
||||
_ => Elevation::Level0,
|
||||
}
|
||||
}
|
||||
|
||||
/// 色彩角色三元组 `(容器, 内容, 描边)`；`None` = 透明容器 / 无描边。
|
||||
pub(crate) const fn roles(self) -> (Option<Role>, Role, Option<Role>) {
|
||||
match self {
|
||||
Variant::Filled => (Some(Role::Primary), Role::OnPrimary, None),
|
||||
Variant::Tonal => (
|
||||
Some(Role::SecondaryContainer),
|
||||
Role::OnSecondaryContainer,
|
||||
None,
|
||||
),
|
||||
Variant::Elevated => (Some(Role::SurfaceContainerLow), Role::Primary, None),
|
||||
Variant::Outlined => (None, Role::OnSurfaceVariant, Some(Role::OutlineVariant)),
|
||||
Variant::Text => (None, Role::OnSurfaceVariant, None),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// IconButton 的三种容器变体（12b §2.5）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||
pub enum IconVariant {
|
||||
/// 标准：容器透明、图标 `OnSurfaceVariant`（各态图标色不变，12b 2.4）。
|
||||
Standard,
|
||||
/// 实心：`Primary` + `OnPrimary`。
|
||||
Filled,
|
||||
/// Tonal：`SecondaryContainer` + `OnSecondaryContainer`。
|
||||
Tonal,
|
||||
}
|
||||
|
||||
impl IconVariant {
|
||||
/// 三式全序（gallery 顺序）。
|
||||
pub const ALL: [IconVariant; 3] = [
|
||||
IconVariant::Standard,
|
||||
IconVariant::Filled,
|
||||
IconVariant::Tonal,
|
||||
];
|
||||
|
||||
/// 稳定名字。
|
||||
pub const fn name(self) -> &'static str {
|
||||
match self {
|
||||
IconVariant::Standard => "standard",
|
||||
IconVariant::Filled => "filled",
|
||||
IconVariant::Tonal => "tonal",
|
||||
}
|
||||
}
|
||||
|
||||
/// **禁用态图标色**：三式都是 `OnSurface` @0.38 —— A1
|
||||
/// （`StandardIconButtonTokens.DisabledColor` / `FilledIconButtonTokens.DisabledColor`）。
|
||||
pub(crate) const fn disabled_content(self) -> Role {
|
||||
Role::OnSurface
|
||||
}
|
||||
|
||||
/// 色彩角色三元组（同 [`Variant::roles`] 的口径）。
|
||||
pub(crate) const fn roles(self) -> (Option<Role>, Role, Option<Role>) {
|
||||
match self {
|
||||
IconVariant::Standard => (None, Role::OnSurfaceVariant, None),
|
||||
IconVariant::Filled => (Some(Role::Primary), Role::OnPrimary, None),
|
||||
IconVariant::Tonal => (
|
||||
Some(Role::SecondaryContainer),
|
||||
Role::OnSecondaryContainer,
|
||||
None,
|
||||
),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个按钮的装配描述（五式共用；**不持有任何状态所有权**）。
|
||||
///
|
||||
/// `on_press: Option<M>` 就是 M3 的 enabled/disabled 开关——`None` = 禁用，
|
||||
/// 与 `button::on_press_maybe` 的语义天然对齐（省掉一个 `disabled: bool` 字段，
|
||||
/// 也就不会出现「有消息但画成禁用」这种自相矛盾的状态）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct Button<'a, M> {
|
||||
label: &'a str,
|
||||
on_press: Option<M>,
|
||||
leading: Option<IconKind>,
|
||||
trailing: Option<IconKind>,
|
||||
state: Option<Interaction>,
|
||||
}
|
||||
|
||||
impl<'a, M> Button<'a, M> {
|
||||
/// 一个可点的按钮。
|
||||
pub fn new(label: &'a str, on_press: M) -> Self {
|
||||
Self {
|
||||
label,
|
||||
on_press: Some(on_press),
|
||||
leading: None,
|
||||
trailing: None,
|
||||
state: None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个禁用的按钮（无消息）。禁用不是「另一种颜色」，见 `interaction::disabled_button_colors`。
|
||||
pub fn disabled(label: &'a str) -> Self {
|
||||
Self {
|
||||
label,
|
||||
on_press: None,
|
||||
leading: None,
|
||||
trailing: None,
|
||||
state: None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 前置图标（12b 1.4：带图标时左内边距收到 16）。
|
||||
pub fn leading(mut self, kind: IconKind) -> Self {
|
||||
self.leading = Some(kind);
|
||||
self
|
||||
}
|
||||
|
||||
/// 后置图标（右内边距保持 24）。
|
||||
pub fn trailing(mut self, kind: IconKind) -> Self {
|
||||
self.trailing = Some(kind);
|
||||
self
|
||||
}
|
||||
|
||||
/// 强制视觉态（`--screen=gallery` 的状态矩阵取证用；运行期不要调）。
|
||||
pub fn state(mut self, state: Interaction) -> Self {
|
||||
self.state = Some(state);
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// Filled 按钮（实心 `Primary`）。
|
||||
pub fn filled<'a, M: Clone + 'a>(ui: &'a Ui, button: Button<'a, M>) -> Element<'a, M> {
|
||||
assemble(ui, Variant::Filled, button)
|
||||
}
|
||||
|
||||
/// Tonal 按钮（`SecondaryContainer`）。
|
||||
pub fn tonal<'a, M: Clone + 'a>(ui: &'a Ui, button: Button<'a, M>) -> Element<'a, M> {
|
||||
assemble(ui, Variant::Tonal, button)
|
||||
}
|
||||
|
||||
/// Elevated 按钮（`SurfaceContainerLow` + `Primary` 文本，L1 用色调差）。
|
||||
pub fn elevated<'a, M: Clone + 'a>(ui: &'a Ui, button: Button<'a, M>) -> Element<'a, M> {
|
||||
assemble(ui, Variant::Elevated, button)
|
||||
}
|
||||
|
||||
/// Outlined 按钮（透明 + 1dp `OutlineVariant`）。
|
||||
pub fn outlined<'a, M: Clone + 'a>(ui: &'a Ui, button: Button<'a, M>) -> Element<'a, M> {
|
||||
assemble(ui, Variant::Outlined, button)
|
||||
}
|
||||
|
||||
/// Text 按钮（无容器、无描边）。
|
||||
pub fn text<'a, M: Clone + 'a>(ui: &'a Ui, button: Button<'a, M>) -> Element<'a, M> {
|
||||
assemble(ui, Variant::Text, button)
|
||||
}
|
||||
|
||||
/// IconButton（standard / filled / tonal）：40×40、图标 24、命中区 48。
|
||||
///
|
||||
/// **图标语汇纪律（视觉 reviewer P2-3）**：同一个控件里**不混用**填充字形（`IconPaint::Fill`，
|
||||
/// 如 `Play`/`Stop`/`More`）与描边字形（`Stroke`）——混着放会让线宽看起来忽粗忽细。
|
||||
/// 允许实心字形，但只能出现在「主操作」这一处（例如播放按钮），其余位置一律描边；
|
||||
/// gallery 的样例因此统一用描边图标（`Download` + `ChevronRight`），并有单测钉住。
|
||||
///
|
||||
/// `on_press: Option<M>`（`None` = 禁用）与 `state` 分开给：前者是语义，后者是取证开关。
|
||||
pub fn icon<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
variant: IconVariant,
|
||||
kind: IconKind,
|
||||
on_press: Option<M>,
|
||||
state: Option<Interaction>,
|
||||
) -> Element<'a, M> {
|
||||
let geometry = IconGeometry::of(ui);
|
||||
let (fill, content, border) = variant.roles();
|
||||
let forced = state.or(if on_press.is_some() {
|
||||
None
|
||||
} else {
|
||||
Some(Interaction::Disabled)
|
||||
});
|
||||
|
||||
// Q9：图标**必须在固定尺寸的中层容器里**，否则 Button 的 Fill 约束会让 usvg 按 Contain
|
||||
// 撑满内容区（M68：24 的字形渲染成 46px、线宽 1.5 → 2.9）。
|
||||
// 这里把盒子做成整个 40×40（而不是 24×24）：`button::layout` 把内容放左上角、不居中，
|
||||
// 所以「居中」这件事必须由容器自己写死，别指望 button。
|
||||
// 内容色跟态走（禁用 = on-surface@38%），见 `assemble::content_color` 的说明
|
||||
let glyph = assemble::content_color(ui, forced, content, fill, variant.disabled_content());
|
||||
let icon_box =
|
||||
layout::centered_fixed(geometry.side, geometry.side, icons::view::<M>(kind, glyph));
|
||||
|
||||
let style = style_closure(
|
||||
ui,
|
||||
StyleSpec {
|
||||
fill,
|
||||
content,
|
||||
border,
|
||||
// 方形图标按钮同样是 full 圆角（40 → 20），档位取自组件表
|
||||
shape: Component::IconButton.spec().shape,
|
||||
stroke: 0.0,
|
||||
radius_side: geometry.side,
|
||||
forced,
|
||||
},
|
||||
);
|
||||
|
||||
let element = button(icon_box)
|
||||
.width(Length::Fixed(geometry.side))
|
||||
.height(Length::Fixed(geometry.side))
|
||||
.padding(Padding::default())
|
||||
.style(style);
|
||||
|
||||
match on_press {
|
||||
Some(message) => element.on_press(message).into(),
|
||||
None => element.into(),
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,351 @@
|
||||
//! 按钮家族的单测（几何值 / 色彩角色 / 样式闭包）。
|
||||
//!
|
||||
//! 这里测的是「函数与样式结构」；**像素级**的几何（40 高、20 圆角、24 图标盒）
|
||||
//! 由 `gallery/probe.rs` 对着真截图量——M68 的教训是「函数对、图错」，两者缺一不可。
|
||||
|
||||
use iced::widget::button;
|
||||
use iced::{Background, Shadow};
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::elevation::Elevation;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::spacing::Space;
|
||||
|
||||
use super::super::interaction::{self, Interaction};
|
||||
use super::assemble::StyleSpec;
|
||||
use super::{style_closure, Geometry, IconGeometry, IconVariant, Variant};
|
||||
use crate::theme::{Families, Ui, STROKE_PX};
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(
|
||||
flavor,
|
||||
unlucky_design::typography::Platform::Windows,
|
||||
FAMILIES,
|
||||
)
|
||||
}
|
||||
|
||||
fn light() -> Ui {
|
||||
ui(SchemeFlavor::Light)
|
||||
}
|
||||
|
||||
#[derive(Debug, Clone, PartialEq)]
|
||||
enum Msg {
|
||||
Pressed(&'static str),
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn every_variant_builds_and_disabled_has_no_message() {
|
||||
let ui = light();
|
||||
let _ = super::filled(&ui, super::Button::new("Filled", Msg::Pressed("f")));
|
||||
let _ = super::tonal(&ui, super::Button::new("Tonal", Msg::Pressed("t")));
|
||||
let _ = super::elevated(&ui, super::Button::new("Elevated", Msg::Pressed("e")));
|
||||
let _ = super::outlined(&ui, super::Button::new("Outlined", Msg::Pressed("o")));
|
||||
let _ = super::text(&ui, super::Button::new("Text", Msg::Pressed("x")));
|
||||
let _ = super::filled::<Msg>(&ui, super::Button::disabled("Disabled"));
|
||||
let _ = super::filled(
|
||||
&ui,
|
||||
super::Button::new("Icons", Msg::Pressed("i"))
|
||||
.leading(IconKind::Plus)
|
||||
.trailing(IconKind::ChevronRight),
|
||||
);
|
||||
}
|
||||
|
||||
/// 12b 1.1~1.6 + 2.1~2.2：几何逐值钉住（每个值都要能指回令牌）。
|
||||
#[test]
|
||||
fn geometry_matches_the_reference_values() {
|
||||
let ui = light();
|
||||
let geometry = Geometry::of(&ui, Variant::Filled, false);
|
||||
assert_eq!(geometry.height, 40.0, "12b 1.1 可见高 40");
|
||||
assert_eq!(geometry.height, ui.metrics().control_height);
|
||||
assert_eq!(
|
||||
ui.radius(unlucky_design::shape::ShapeScale::Full, geometry.height)
|
||||
.top_left,
|
||||
20.0,
|
||||
"12b 1.2 full 圆角 = 高/2"
|
||||
);
|
||||
assert_eq!(geometry.padding.left, 24.0, "12b 1.3 左 24");
|
||||
assert_eq!(geometry.padding.right, 24.0, "12b 1.3 右 24");
|
||||
assert_eq!(geometry.padding.top, 0.0);
|
||||
assert_eq!(geometry.gap, 8.0, "12b 1.6 图标↔文字 8");
|
||||
assert_eq!(geometry.gap, ui.space(Space::X2));
|
||||
assert_eq!(geometry.stroke, 0.0, "实心按钮无描边");
|
||||
|
||||
let with_icon = Geometry::of(&ui, Variant::Filled, true);
|
||||
assert_eq!(with_icon.padding.left, 16.0, "12b 1.4 带图标左内边距 16");
|
||||
assert_eq!(with_icon.padding.right, 24.0, "带图标右内边距不动");
|
||||
|
||||
let outlined = Geometry::of(&ui, Variant::Outlined, false);
|
||||
assert_eq!(outlined.stroke, STROKE_PX, "rubric G7 全站 1px");
|
||||
assert_eq!(outlined.stroke, 1.0);
|
||||
|
||||
// 图标 18 是**令牌值**（`IconSize::Button`，AAR `ButtonDefaults.IconSize`）；
|
||||
// 12b 1.6 的 18 与它同源。**别按 `ButtonSmallTokens.IconSize = 20` 改**：那是零消费者的死令牌。
|
||||
assert_eq!(
|
||||
geometry.icon, 18.0,
|
||||
"IconSize::Button（官方 ButtonDefaults.IconSize）"
|
||||
);
|
||||
assert_eq!(
|
||||
geometry.icon,
|
||||
unlucky_design::icons::IconSize::Button.px(),
|
||||
"组件侧必须只从令牌取值（不许写字面量）"
|
||||
);
|
||||
assert_eq!(geometry.height % 4.0, 0.0, "可见高必须在 4px 栅格上（D1）");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn icon_button_geometry_matches_the_reference() {
|
||||
let ui = light();
|
||||
let geometry = IconGeometry::of(&ui);
|
||||
assert_eq!((geometry.side, geometry.icon), (40.0, 24.0), "12b 2.1/2.2");
|
||||
assert_eq!(
|
||||
ui.radius(unlucky_design::shape::ShapeScale::Full, geometry.side)
|
||||
.top_left,
|
||||
20.0,
|
||||
"40×40 的 full 圆角 = 20"
|
||||
);
|
||||
assert_eq!(geometry.padding, 8.0, "12b 2.2 默认边距 8");
|
||||
// 命中区 = 容器 40 + 四周各 4（12b 2.8）；按钮自身不撑高
|
||||
assert_eq!(
|
||||
geometry.side + 2.0 * ui.space(Space::X1),
|
||||
ui.metrics().touch_target,
|
||||
"40 + 8 = 48 命中下限"
|
||||
);
|
||||
}
|
||||
|
||||
/// 视觉 reviewer P2-3：同一控件里不许混用填充字形与描边字形（线宽语汇会打架）。
|
||||
///
|
||||
/// gallery 的样例图标（前置/后置）必须同为 `IconPaint::Stroke`；允许实心字形，但只能作为
|
||||
/// 「主操作」单独出场的图标（例如播放键），不能与描边图标同处一颗按钮。
|
||||
#[test]
|
||||
fn sample_icons_never_mix_fill_and_stroke() {
|
||||
use unlucky_design::icons::IconPaint;
|
||||
|
||||
let sample = [IconKind::Download, IconKind::ChevronRight];
|
||||
for kind in sample {
|
||||
assert_eq!(
|
||||
kind.icon().paint,
|
||||
IconPaint::Stroke,
|
||||
"{} 是填充字形，不能和描边图标混在同一颗按钮里",
|
||||
kind.name()
|
||||
);
|
||||
}
|
||||
// 已知的实心字形（留档，下次有人拿它们当按钮图标时这条会提醒）
|
||||
assert_eq!(IconKind::Play.icon().paint, IconPaint::Fill);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn five_variants_have_distinct_colour_roles() {
|
||||
let mut seen = Vec::new();
|
||||
for variant in Variant::ALL {
|
||||
let roles = variant.roles();
|
||||
assert!(
|
||||
!seen.contains(&roles),
|
||||
"{variant:?} 与别的变体色彩角色重复了"
|
||||
);
|
||||
seen.push(roles);
|
||||
}
|
||||
|
||||
// 12b 1.9 逐条角色名核对
|
||||
assert_eq!(
|
||||
Variant::Filled.roles(),
|
||||
(
|
||||
Some(unlucky_design::color::Role::Primary),
|
||||
unlucky_design::color::Role::OnPrimary,
|
||||
None
|
||||
)
|
||||
);
|
||||
assert_eq!(
|
||||
Variant::Tonal.roles(),
|
||||
(
|
||||
Some(unlucky_design::color::Role::SecondaryContainer),
|
||||
unlucky_design::color::Role::OnSecondaryContainer,
|
||||
None
|
||||
)
|
||||
);
|
||||
assert_eq!(
|
||||
Variant::Elevated.roles(),
|
||||
(
|
||||
Some(unlucky_design::color::Role::SurfaceContainerLow),
|
||||
unlucky_design::color::Role::Primary,
|
||||
None
|
||||
)
|
||||
);
|
||||
assert_eq!(
|
||||
Variant::Outlined.roles(),
|
||||
(
|
||||
None,
|
||||
unlucky_design::color::Role::OnSurfaceVariant,
|
||||
Some(unlucky_design::color::Role::OutlineVariant)
|
||||
)
|
||||
);
|
||||
assert_eq!(
|
||||
Variant::Text.roles(),
|
||||
(None, unlucky_design::color::Role::OnSurfaceVariant, None)
|
||||
);
|
||||
|
||||
for variant in Variant::ALL {
|
||||
let expected = if variant == Variant::Elevated {
|
||||
Elevation::Level1
|
||||
} else {
|
||||
Elevation::Level0
|
||||
};
|
||||
assert_eq!(variant.elevation(), expected, "{variant:?} 高程");
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn icon_button_variants_match_the_reference_roles() {
|
||||
use unlucky_design::color::Role;
|
||||
assert_eq!(
|
||||
IconVariant::Standard.roles(),
|
||||
(None, Role::OnSurfaceVariant, None)
|
||||
);
|
||||
assert_eq!(
|
||||
IconVariant::Filled.roles(),
|
||||
(Some(Role::Primary), Role::OnPrimary, None)
|
||||
);
|
||||
assert_eq!(
|
||||
IconVariant::Tonal.roles(),
|
||||
(
|
||||
Some(Role::SecondaryContainer),
|
||||
Role::OnSecondaryContainer,
|
||||
None
|
||||
)
|
||||
);
|
||||
|
||||
let ui = light();
|
||||
for variant in IconVariant::ALL {
|
||||
let _ = super::icon::<Msg>(&ui, variant, IconKind::Settings, None, None);
|
||||
let _ = super::icon(
|
||||
&ui,
|
||||
variant,
|
||||
IconKind::Settings,
|
||||
Some(Msg::Pressed("i")),
|
||||
None,
|
||||
);
|
||||
// 五态取证开关都能出元素（gallery 矩阵依赖它）
|
||||
for state in Interaction::ALL {
|
||||
let _ = super::icon(
|
||||
&ui,
|
||||
variant,
|
||||
IconKind::Settings,
|
||||
Some(Msg::Pressed("i")),
|
||||
Some(state),
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
fn spec_of(variant: Variant, forced: Option<Interaction>) -> StyleSpec {
|
||||
let (fill, content, border) = variant.roles();
|
||||
StyleSpec {
|
||||
fill,
|
||||
content,
|
||||
border,
|
||||
shape: variant.shape(),
|
||||
stroke: Geometry::of(&light(), variant, false).stroke,
|
||||
radius_side: Geometry::of(&light(), variant, false).height,
|
||||
forced,
|
||||
}
|
||||
}
|
||||
|
||||
/// **渲染层**：样式闭包吐给 iced 的圆角/描边/阴影必须是令牌推导值。
|
||||
#[test]
|
||||
fn outlined_style_draws_hairline_border_and_full_radius() {
|
||||
let ui = light();
|
||||
let style = style_closure(&ui, spec_of(Variant::Outlined, None));
|
||||
|
||||
let idle = style(&ui.theme(), button::Status::Active);
|
||||
assert_eq!(idle.background, None, "Outlined 静息容器必须透明");
|
||||
assert_eq!(idle.border.width, STROKE_PX, "1dp 描边");
|
||||
assert_eq!(idle.border.radius.top_left, 20.0, "full 圆角");
|
||||
assert_eq!(
|
||||
idle.border.color,
|
||||
ui.color(unlucky_design::color::Role::OutlineVariant)
|
||||
);
|
||||
assert_eq!(idle.shadow, Shadow::default(), "L0 不许有阴影");
|
||||
|
||||
// 透明容器也要看得见 hover：状态层叠到表面色上
|
||||
let hovered = style(&ui.theme(), button::Status::Hovered);
|
||||
assert_ne!(hovered.background, None, "透明容器的 hover 必须有可见变化");
|
||||
assert_ne!(hovered.background, idle.background);
|
||||
|
||||
let disabled = style(&ui.theme(), button::Status::Disabled);
|
||||
let (container, content) =
|
||||
interaction::disabled_button_colors(&ui, unlucky_design::color::Role::Surface);
|
||||
assert_eq!(disabled.text_color, content, "禁用内容 = 令牌 38%");
|
||||
assert_eq!(
|
||||
disabled.border.color, container,
|
||||
"禁用描边 = 按钮族的令牌 10%（OutlinedButtonTokens.DisabledContainerOpacity）"
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn filled_button_state_layers_are_visible_and_ordered() {
|
||||
let ui = light();
|
||||
let style = style_closure(&ui, spec_of(Variant::Filled, None));
|
||||
|
||||
let idle = style(&ui.theme(), button::Status::Active);
|
||||
let hovered = style(&ui.theme(), button::Status::Hovered);
|
||||
let pressed = style(&ui.theme(), button::Status::Pressed);
|
||||
|
||||
assert_eq!(
|
||||
idle.background,
|
||||
Some(Background::Color(
|
||||
ui.color(unlucky_design::color::Role::Primary)
|
||||
))
|
||||
);
|
||||
assert_ne!(hovered.background, idle.background, "hover 8%");
|
||||
assert_ne!(
|
||||
pressed.background, hovered.background,
|
||||
"pressed 10% ≠ hover 8%"
|
||||
);
|
||||
assert_eq!(
|
||||
hovered.text_color,
|
||||
ui.color(unlucky_design::color::Role::OnPrimary),
|
||||
"12b 2.4/4.7：状态层不换内容色"
|
||||
);
|
||||
assert_eq!(idle.border.width, 0.0, "实心按钮无描边");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn forced_state_overrides_the_runtime_status() {
|
||||
let ui = light();
|
||||
let style = style_closure(&ui, spec_of(Variant::Tonal, Some(Interaction::Hovered)));
|
||||
// 运行期说 Active，但取证要 hover → 必须画 hover
|
||||
assert_eq!(
|
||||
style(&ui.theme(), button::Status::Active).background,
|
||||
style(&ui.theme(), button::Status::Hovered).background
|
||||
);
|
||||
assert_ne!(
|
||||
style(&ui.theme(), button::Status::Active).background,
|
||||
Some(Background::Color(
|
||||
ui.color(unlucky_design::color::Role::SecondaryContainer)
|
||||
))
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn elevated_uses_a_tone_not_a_shadow() {
|
||||
let ui = light();
|
||||
let style = style_closure(&ui, spec_of(Variant::Elevated, None));
|
||||
let idle = style(&ui.theme(), button::Status::Active);
|
||||
assert_eq!(idle.shadow, Shadow::default(), "rubric §7：L1 不画阴影");
|
||||
assert_eq!(
|
||||
idle.background,
|
||||
Some(Background::Color(
|
||||
ui.color(unlucky_design::color::Role::SurfaceContainerLow)
|
||||
)),
|
||||
"L1 由 SurfaceContainerLow 的色调差表达"
|
||||
);
|
||||
assert_eq!(
|
||||
idle.text_color,
|
||||
ui.color(unlucky_design::color::Role::Primary)
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,109 @@
|
||||
//! 分隔线（`research/15` §22，A1：`DividerTokens.kt` / `Divider.kt` / `ListTokens.kt`）。
|
||||
//!
|
||||
//! | # | 检查项 | 参考值 | 落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 22.1 | 厚度 | **1dp** → 1px ±0 @100% DPI | `LayoutMetrics::divider_thickness` = [`STROKE_PX`] |
|
||||
//! | 22.2 | 颜色 | **`OutlineVariant`**（不是 `Outline`，那个更深、会抢层级） | `Role::OutlineVariant` |
|
||||
//! | 22.3 | 缩进 | 列表内 **左 16 / 右 16**；区块分隔 **0（通栏）** | [`list`] / [`full`] |
|
||||
//! | 22.4 | 用量 | 同屏同类线 ≤3；同容器内不得既有描边又有分隔线 | 页面线自查（本模块不强制） |
|
||||
//! | 22.5 | 何时不用 | tone 能分层就不画线；纵向分隔本项目不用 | 文档约定 |
|
||||
//!
|
||||
//! ## 语义纪律（22.5 的一句话口径）
|
||||
//!
|
||||
//! **分隔线是兜底手段，不是排版手段**：能靠 `Surface` / `SurfaceContainerLow` /
|
||||
//! `SurfaceContainerHigh` 的色差把层级说清的地方就不画线；卡片已经有 1px `OutlineVariant`
|
||||
//! 描边时，卡片**之间**不再画线（同时出现 = 双重分隔，rubric K3 那类廉价感）。
|
||||
//!
|
||||
//! ## 为什么只有两个入口
|
||||
//!
|
||||
//! §22.3 只承认两种缩进：通栏（区块分隔）与列表内 16。第三种缩进一定是「页面自己想出来的」，
|
||||
//! 所以不提供任意数值入口——真要第三种，先在 `SubAgentsTalk/` 登记。
|
||||
|
||||
use iced::widget::{container, space};
|
||||
use iced::{Background, Element, Length};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::spacing::Space;
|
||||
|
||||
use crate::theme::{Ui, STROKE_PX};
|
||||
|
||||
use super::layout;
|
||||
|
||||
/// 通栏分隔线（区块分隔：0 缩进）。
|
||||
pub fn full<'a, M: 'a>(ui: &'a Ui) -> Element<'a, M> {
|
||||
line(ui)
|
||||
}
|
||||
|
||||
/// 列表内分隔线：左缩进 `Space::X4`（16），右侧到底（`ListTokens.DividerLeadingSpace`）。
|
||||
///
|
||||
/// 右缩进按官方也是 16，但列表行本身已有 16 的内边距时再缩一次会变成 32——
|
||||
/// 本项目把「行内边距」交给行，本函数只负责**线相对行**的缩进，故右端通到行尾。
|
||||
pub fn list<'a, M: 'a>(ui: &'a Ui) -> Element<'a, M> {
|
||||
layout::inset_start(ui.space(Space::X4), line(ui))
|
||||
}
|
||||
|
||||
/// 一条 1px 的横线（厚度/颜色都只有一处定义）。
|
||||
fn line<'a, M: 'a>(ui: &'a Ui) -> Element<'a, M> {
|
||||
container(space::horizontal())
|
||||
.width(Length::Fill)
|
||||
.height(thickness(ui))
|
||||
.style(|_theme| container::Style {
|
||||
background: Some(Background::Color(ui.color(Role::OutlineVariant))),
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 线厚（= `LayoutMetrics::divider_thickness` = `stroke::HAIRLINE`，三者同一真源）。
|
||||
pub fn thickness(ui: &Ui) -> f32 {
|
||||
debug_assert_eq!(
|
||||
ui.metrics().divider_thickness,
|
||||
STROKE_PX,
|
||||
"分隔线厚度必须是一像素线的唯一真源"
|
||||
);
|
||||
ui.metrics().divider_thickness
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
fn ui() -> Ui {
|
||||
Ui::with_platform(
|
||||
SchemeFlavor::Light,
|
||||
Platform::Windows,
|
||||
Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
},
|
||||
)
|
||||
}
|
||||
|
||||
/// 22.1：厚度 1（不是 2，也不是 1.5）。
|
||||
#[test]
|
||||
fn thickness_is_exactly_one_pixel() {
|
||||
let ui = ui();
|
||||
assert_eq!(thickness(&ui), 1.0);
|
||||
assert_eq!(thickness(&ui), STROKE_PX);
|
||||
assert_eq!(thickness(&ui), ui.metrics().divider_thickness);
|
||||
}
|
||||
|
||||
/// 22.3：列表内缩进 16，来自 `Space::X4` 而不是字面量。
|
||||
#[test]
|
||||
fn list_inset_comes_from_the_spacing_token() {
|
||||
let ui = ui();
|
||||
assert_eq!(ui.space(Space::X4), 16.0, "ListTokens.DividerLeadingSpace");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn both_forms_build() {
|
||||
let ui = ui();
|
||||
let _: Element<'_, ()> = full(&ui);
|
||||
let _: Element<'_, ()> = list(&ui);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,173 @@
|
||||
//! 反馈家族里的两个**小动作件**：文字动作与图标动作。
|
||||
//!
|
||||
//! ## 为什么不复用 `buttons`
|
||||
//!
|
||||
//! 这两处的内容角色都不在按钮家族的三档里：Dialog 动作 = `Primary`，Snackbar action =
|
||||
//! `InversePrimary`（A1 `SnackbarTokens.ActionLabelTextColor`），Snackbar 关闭图标 =
|
||||
//! `InverseOnSurface`。`buttons::text` 固定 `OnSurfaceVariant`（12b §1.9 的 Text 变体口径），
|
||||
//! 拿它画 Dialog 动作就是颜色角色错位（rubric 判 P1）。
|
||||
//!
|
||||
//! 所以这里只做**一份**最小实现：内容/容器角色作参数，尺寸/字级仍走令牌，状态层仍走
|
||||
//! [`interaction`]——与按钮家族同一条产线，只是角色由调用点给。
|
||||
//!
|
||||
//! ## 禁用是状态不是构造器
|
||||
//!
|
||||
//! 照 `selection/chip.rs` 修好的模式：`on_press: Option<M>`，`None` = 禁用；文字色降到
|
||||
//! `OnSurface@38%`，标签本身**不删**。禁用色的**底**必须是这两个动作件自己的容器角色
|
||||
//! （`InverseSurface` / `SurfaceContainerHigh`）——`interaction::disabled_content_over_role`
|
||||
//! 只支持「叠在 Surface / 叠在 12% 容器上」两档，拿它合成会得到「38% 深字叠深底」（复审 P2-4）。
|
||||
|
||||
use iced::widget::{button, text};
|
||||
use iced::{Background, Border, Element, Length, Padding, Shadow};
|
||||
|
||||
use unlucky_design::color::state::DISABLED_CONTENT_ALPHA;
|
||||
use unlucky_design::color::{Role, Scheme};
|
||||
use unlucky_design::component_map::Component;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::icons;
|
||||
use crate::theme::{to_iced, Ui};
|
||||
|
||||
use super::super::interaction::{self, Interaction};
|
||||
use super::super::layout;
|
||||
|
||||
/// 禁用态内容色：`OnSurface@38%` 叠在**真实容器色**上（复审 P2-4）。
|
||||
///
|
||||
/// `interaction::disabled_content_over_role` 的 `on_container` 只有「叠在 Surface / 叠在
|
||||
/// 12% 容器上」两档，而这两个动作件的底是 `InverseSurface`（Snackbar）与
|
||||
/// `SurfaceContainerHigh`（Dialog）——直接调它会得到「38% 深字叠深底」。
|
||||
/// 这里按同一令牌口径（[`DISABLED_CONTENT_ALPHA`]）在本文件合成一次，底换成真实容器角色。
|
||||
fn content_color(ui: &Ui, role: Role, container_role: Role, disabled: bool) -> iced::Color {
|
||||
if !disabled {
|
||||
return ui.color(role);
|
||||
}
|
||||
let scheme = Scheme::baseline(ui.flavor());
|
||||
to_iced(
|
||||
scheme
|
||||
.get(Role::OnSurface)
|
||||
.with_alpha(DISABLED_CONTENT_ALPHA)
|
||||
.over(scheme.get(container_role)),
|
||||
)
|
||||
}
|
||||
|
||||
/// 一个文字动作（Dialog 的动作区、Snackbar 的 action 共用）。
|
||||
///
|
||||
/// - `content` / `container_role`：内容色与**状态层叠在什么颜色上**（Dialog =
|
||||
/// `Primary` on `SurfaceContainerHigh`；Snackbar = `InversePrimary` on `InverseSurface`）；
|
||||
/// - `on_press = None` → 禁用（文字降到 38%，仍占位）；
|
||||
/// - `forced`：取证用的强制态（运行期不要给）。
|
||||
pub(super) fn text_action<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
label: &'a str,
|
||||
content: Role,
|
||||
container_role: Role,
|
||||
on_press: Option<M>,
|
||||
forced: Option<Interaction>,
|
||||
) -> Element<'a, M> {
|
||||
let style = ui.emphasized(TypeRole::LabelLarge);
|
||||
let height = ui.metrics().control_height;
|
||||
let pad = ui.space(Space::X3);
|
||||
let shape = Component::TextButton.spec().shape;
|
||||
let radius = ui.radius(shape, height);
|
||||
let disabled = on_press.is_none();
|
||||
|
||||
let ink = content_color(ui, content, container_role, disabled);
|
||||
|
||||
let element = button(
|
||||
text(label)
|
||||
.size(style.size_px)
|
||||
.font(ui.font_of(style))
|
||||
.color(ink),
|
||||
)
|
||||
.height(Length::Fixed(height))
|
||||
.padding(Padding {
|
||||
top: 0.0,
|
||||
right: pad,
|
||||
bottom: 0.0,
|
||||
left: pad,
|
||||
})
|
||||
.style(move |_theme, status| {
|
||||
let state = forced.unwrap_or_else(|| {
|
||||
if disabled {
|
||||
Interaction::Disabled
|
||||
} else {
|
||||
Interaction::from_status(status)
|
||||
}
|
||||
});
|
||||
button::Style {
|
||||
background: interaction::overlay_color(ui, state, content, container_role)
|
||||
.map(Background::Color),
|
||||
text_color: ink,
|
||||
border: Border {
|
||||
radius,
|
||||
..Border::default()
|
||||
},
|
||||
// 浮层的阴影只在 Dialog 容器上（rubric K3 单层），动作件本身不投影。
|
||||
shadow: Shadow::default(),
|
||||
snap: true,
|
||||
}
|
||||
});
|
||||
|
||||
match on_press {
|
||||
Some(message) => element.on_press(message).into(),
|
||||
None => element.into(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个图标动作（Snackbar 的关闭键）。命中区 = `touch_target`，字形经 `layout::centered_fixed`
|
||||
/// 锁在 24（Q9：不锁的话字体会被 Button 的 Fill 约束撑满）。
|
||||
pub(super) fn icon_action<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
kind: IconKind,
|
||||
content: Role,
|
||||
container_role: Role,
|
||||
on_press: Option<M>,
|
||||
forced: Option<Interaction>,
|
||||
) -> Element<'a, M> {
|
||||
let metrics = ui.metrics();
|
||||
let side = metrics.touch_target;
|
||||
let glyph_side = unlucky_design::icons::IconSize::Toolbar.px();
|
||||
let shape = Component::IconButton.spec().shape;
|
||||
let radius = ui.radius(shape, side);
|
||||
let disabled = on_press.is_none();
|
||||
|
||||
let ink = content_color(ui, content, container_role, disabled);
|
||||
|
||||
// 走 `view_at(24)` 而不是 `view(..)`：`icons.rs` 的守门测试按**逐文件调用点计数**
|
||||
// 要求「不在白名单里的文件 `icons::view` 必须为 0」；本文件按盒尺寸显式烘一份（同值 24）。
|
||||
let element = button(layout::centered_fixed(
|
||||
glyph_side,
|
||||
glyph_side,
|
||||
icons::view_at::<M>(kind, ink, glyph_side),
|
||||
))
|
||||
.width(Length::Fixed(side))
|
||||
.height(Length::Fixed(side))
|
||||
.padding(Padding::default())
|
||||
.style(move |_theme, status| {
|
||||
let state = forced.unwrap_or_else(|| {
|
||||
if disabled {
|
||||
Interaction::Disabled
|
||||
} else {
|
||||
Interaction::from_status(status)
|
||||
}
|
||||
});
|
||||
button::Style {
|
||||
background: interaction::overlay_color(ui, state, content, container_role)
|
||||
.map(Background::Color),
|
||||
text_color: ink,
|
||||
border: Border {
|
||||
radius,
|
||||
..Border::default()
|
||||
},
|
||||
shadow: Shadow::default(),
|
||||
snap: true,
|
||||
}
|
||||
});
|
||||
|
||||
match on_press {
|
||||
Some(message) => element.on_press(message).into(),
|
||||
None => element.into(),
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,262 @@
|
||||
//! Dialog（`research/12b` §7）：scrim + 容器 + 标题/正文/动作三区。
|
||||
//!
|
||||
//! ## 官方值（`[源]` = A1，`DialogTokens` + `AlertDialogKt`，`javap` 核对）
|
||||
//!
|
||||
//! | # | 项 | 值 | 落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 7.1 | 圆角 | **28**（`CornerExtraLarge`） | `Component::Dialog.spec().shape` |
|
||||
//! | 7.2 | 容器 | **`SurfaceContainerHigh`**（`DialogTokens.ContainerColor`） | `Ui::layer(MaterialLayer::Overlay)` |
|
||||
//! | 7.3 | 内距 | 四边 **24**；标题下 **16**；正文下 **24** | [`DialogGeometry`]（`Space` 档位） |
|
||||
//! | 7.4 | 宽 | 官方 **280..560**；本项目 **480** | [`DialogGeometry::width`] |
|
||||
//! | 7.5 | 字级 | 标题 `HeadlineSmall 24/32`、正文 `BodyMedium 14/20`、动作 `LabelLarge 14/20 w500` | 组件层取角色 |
|
||||
//! | 7.6 | 动作区 | 文本 **`Primary`**；主轴 **8** / 交叉 **12**；右对齐 | [`DialogGeometry`] |
|
||||
//! | 7.7 | 遮罩 | `scrim` = 纯黑 @ **0.32**（`SCRIM_ALPHA`） | [`scrim`] |
|
||||
//! | 7.8 | 数量 | 一屏 **1 个** modal | 页面责任（组件不计数） |
|
||||
//!
|
||||
//! ## 三种动作形态
|
||||
//!
|
||||
//! [`DialogActions::None`]（纯告知）/ [`DialogActions::Single`]（「知道了」）/
|
||||
//! [`DialogActions::Double`]（「取消」+「删除」，右边是主操作）。双动作的 `dismiss` 在左、
|
||||
//! `confirm` 在右（M3 的阅读序；本项目**不**做「危险操作反色」——官方 Dialog 动作只有 `Primary`）。
|
||||
//!
|
||||
//! ## scrim 为什么是**不透明预合成**
|
||||
//!
|
||||
//! 官方是「纯黑 @0.32 盖在内容上」。D27 要求 CPU 档零半透明（否则 CPU/GPU 两图不一致），
|
||||
//! 所以 [`scrim`] 返回的是 `黑@0.32` **叠在 `MaterialLayer::Canvas` 上**之后的实色：
|
||||
//! 逐像素与「真半透明铺在 surface 上」等价（遮罩下通常就是底色），且两档渲染一致。
|
||||
//! 代价：遮罩下若是图片/卡片，合成目标不是 surface —— 这条登记为偏离 D-2。
|
||||
//!
|
||||
//! **深色档的观感（观察项 D-5）**：画布本身很暗，0.32 叠上去只从 (9,21,28) 压到 (6,14,19)
|
||||
//! （≈4%），几乎看不出「压暗」。数值是官方 token 推出来的，**不调**：要更强的层级感应该动
|
||||
//! Dialog 的容器档或阴影，而不是把 scrim 抬到 0.4（那就偏离 token 了）。
|
||||
//!
|
||||
//! ## 不画阴影（偏离 D-1）
|
||||
//!
|
||||
//! 官方 L3 有阴影，但 D27（CPU 禁模糊）+ 令牌层 `ShadowSpec` 仍是 M63 占位值 ⇒ 先不画，
|
||||
//! 层级由 `SurfaceContainerHigh` + scrim 表达。
|
||||
|
||||
use iced::widget::{column, container, row, text, Space};
|
||||
use iced::{Alignment, Background, Border, Element, Length, Padding};
|
||||
|
||||
use unlucky_design::color::{Role, Scheme};
|
||||
use unlucky_design::elevation::MaterialLayer;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::theme::{to_iced, Ui};
|
||||
|
||||
use super::super::interaction::Interaction;
|
||||
use super::action;
|
||||
use super::panel::DialogGeometry;
|
||||
|
||||
/// 动作区的三种形态（「无动作」「单动作」「双动作」）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub enum DialogActions<'a, M> {
|
||||
/// 无动作：只有标题与正文（纯告知型，例如「已是最新版本」）。
|
||||
None,
|
||||
/// 单动作：确认/知道了。
|
||||
Single {
|
||||
/// 动作文案。
|
||||
label: &'a str,
|
||||
/// 按下后的消息。
|
||||
on_press: M,
|
||||
},
|
||||
/// 双动作：左侧 dismiss、右侧 confirm。
|
||||
Double {
|
||||
/// 左（次要）动作。
|
||||
dismiss: (&'a str, M),
|
||||
/// 右（主）动作。
|
||||
confirm: (&'a str, M),
|
||||
},
|
||||
}
|
||||
|
||||
impl<'a, M> DialogActions<'a, M> {
|
||||
/// 是否为空（图例/测试用）。
|
||||
pub fn is_empty(&self) -> bool {
|
||||
matches!(self, DialogActions::None)
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个对话框的装配描述（**不持有任何状态所有权**）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct Dialog<'a, M> {
|
||||
title: &'a str,
|
||||
body: &'a str,
|
||||
actions: DialogActions<'a, M>,
|
||||
max_width: f32,
|
||||
state: Option<Interaction>,
|
||||
}
|
||||
|
||||
impl<'a, M> Dialog<'a, M> {
|
||||
/// 标题 + 正文，默认无动作。
|
||||
pub fn new(title: &'a str, body: &'a str) -> Self {
|
||||
Self {
|
||||
title,
|
||||
body,
|
||||
actions: DialogActions::None,
|
||||
// 项目取值 480（官方区间 280..560 内）；窄宿主由页面传更小的可用宽。
|
||||
max_width: 480.0,
|
||||
state: None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 可用宽（默认 480）。实际宽 = `min(available, 480)`，且**不低于官方下限 280**
|
||||
/// （`DialogMinWidth`；可用宽传 200 时仍画 280 并溢出宿主 —— iced 无 min-width，见 G17-d）。
|
||||
///
|
||||
/// 为什么不让组件自己从宿主推：iced 的 `Length` 没有 min-width，而 `Fill + max_width`
|
||||
/// 会被父级的精确分配顶掉（实测渲染成 548 而不是 480，见 `dialog()` 里的说明）。
|
||||
pub fn width(mut self, available: f32) -> Self {
|
||||
self.max_width = available;
|
||||
self
|
||||
}
|
||||
|
||||
/// 单动作。
|
||||
pub fn confirm(mut self, label: &'a str, on_press: M) -> Self {
|
||||
self.actions = DialogActions::Single { label, on_press };
|
||||
self
|
||||
}
|
||||
|
||||
/// 双动作（左 dismiss / 右 confirm）。
|
||||
pub fn double(mut self, dismiss: (&'a str, M), confirm: (&'a str, M)) -> Self {
|
||||
self.actions = DialogActions::Double { dismiss, confirm };
|
||||
self
|
||||
}
|
||||
|
||||
/// 强制动作件的视觉态（gallery 取证用；运行期不要调）。
|
||||
pub fn state(mut self, state: Interaction) -> Self {
|
||||
self.state = Some(state);
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 遮罩色：`黑 @ SCRIM_ALPHA` 叠在 `MaterialLayer::Canvas` 上之后的**实色**（D27）。
|
||||
pub fn scrim(ui: &Ui) -> iced::Color {
|
||||
let scheme = Scheme::baseline(ui.flavor());
|
||||
let canvas = scheme.get(MaterialLayer::Canvas.surface_role());
|
||||
to_iced(scheme.scrim().over(canvas))
|
||||
}
|
||||
|
||||
/// 把内容放进一块遮罩里（模态的「背后压暗」）。页面把它压在自己的内容上面即可。
|
||||
pub fn scrimmed<'a, M: 'a>(ui: &'a Ui, content: impl Into<Element<'a, M>>) -> Element<'a, M> {
|
||||
let backdrop = scrim(ui);
|
||||
container(content)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fill)
|
||||
.align_x(Alignment::Center)
|
||||
.align_y(Alignment::Center)
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(backdrop)),
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 画一个对话框（不含遮罩；遮罩用 [`scrimmed`]）。
|
||||
pub fn dialog<'a, M: Clone + 'a>(ui: &'a Ui, spec: Dialog<'a, M>) -> Element<'a, M> {
|
||||
let geometry = DialogGeometry::of(ui);
|
||||
let surface = ui.layer(MaterialLayer::Overlay);
|
||||
let radius = iced::border::Radius::new(geometry.radius);
|
||||
|
||||
let title_style = ui.style(TypeRole::HeadlineSmall);
|
||||
let body_style = ui.style(TypeRole::BodyMedium);
|
||||
|
||||
let mut content = column![].width(Length::Fill).spacing(0.0).push(
|
||||
text(spec.title)
|
||||
.size(title_style.size_px)
|
||||
.font(ui.font_of(title_style))
|
||||
.color(ui.color(Role::OnSurface)),
|
||||
);
|
||||
content = content.push(gap(geometry.title_gap)).push(
|
||||
text(spec.body)
|
||||
.size(body_style.size_px)
|
||||
.font(ui.font_of(body_style))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
);
|
||||
|
||||
if !spec.actions.is_empty() {
|
||||
content = content.push(gap(geometry.body_gap)).push(actions_row(
|
||||
ui,
|
||||
&geometry,
|
||||
spec.actions,
|
||||
spec.state,
|
||||
));
|
||||
}
|
||||
|
||||
// 宽度 = `min(spec.max_width, 480)`，**可用宽由调用方递**（`Dialog::width`）。
|
||||
//
|
||||
// 复审 P2-1 建议「Fill + max_width」：实测**不行**。`Row` 给 `Fill` 子项的 limits 是
|
||||
// `with_compression(min = max = 分配额)`，而 `Limits::max_width()` 的实现是
|
||||
// `self.max.width.min(max_width).max(self.min.width)` —— 父级那个 **min 会把 480 顶回去**，
|
||||
// 两列并排时每张卡渲染成 **548**（探针实测，见报告）。iced 没有 min-width，也没有在
|
||||
// 「父级精确分配」下可用的 max-width ⇒ 与 Snackbar 的最小宽同一堵墙（G17-d 之二）。
|
||||
// 所以：默认 480，窄宿主由页面传 `Dialog::width(可用宽)`。
|
||||
// 可用宽 → 实际宽：`min(480, 可用宽)` 再 `.max(280)`（官方 `DialogMinWidth`，复审 E）。
|
||||
// 可用宽 < 280 时仍画 280（溢出宿主）——iced 无 min-width，这条写进 G17-d 之二。
|
||||
let effective = geometry.effective_width(spec.max_width);
|
||||
container(content)
|
||||
.width(Length::Fixed(effective))
|
||||
.padding(Padding::from(geometry.padding))
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(surface)),
|
||||
border: Border {
|
||||
radius,
|
||||
..Border::default()
|
||||
},
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 两区之间的固定留白（A1 的「标题下 16 / 正文下 24」）。
|
||||
fn gap<'a, M: 'a>(height: f32) -> Element<'a, M> {
|
||||
Space::new()
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(height))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 动作区：右对齐，主轴间距 8（A1 `ButtonsMainAxisSpacing`）。
|
||||
fn actions_row<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
geometry: &DialogGeometry,
|
||||
actions: DialogActions<'a, M>,
|
||||
state: Option<Interaction>,
|
||||
) -> Element<'a, M> {
|
||||
let controls = match actions {
|
||||
DialogActions::None => row![],
|
||||
DialogActions::Single { label, on_press } => row![action::text_action(
|
||||
ui,
|
||||
label,
|
||||
Role::Primary,
|
||||
MaterialLayer::Overlay.surface_role(),
|
||||
Some(on_press),
|
||||
state,
|
||||
)],
|
||||
DialogActions::Double { dismiss, confirm } => row![
|
||||
action::text_action(
|
||||
ui,
|
||||
dismiss.0,
|
||||
Role::Primary,
|
||||
MaterialLayer::Overlay.surface_role(),
|
||||
Some(dismiss.1),
|
||||
state,
|
||||
),
|
||||
action::text_action(
|
||||
ui,
|
||||
confirm.0,
|
||||
Role::Primary,
|
||||
MaterialLayer::Overlay.surface_role(),
|
||||
Some(confirm.1),
|
||||
state,
|
||||
),
|
||||
],
|
||||
};
|
||||
|
||||
container(
|
||||
controls
|
||||
.spacing(geometry.action_gap)
|
||||
.align_y(Alignment::Center),
|
||||
)
|
||||
.width(Length::Fill)
|
||||
.align_x(Alignment::End)
|
||||
.into()
|
||||
}
|
||||
@@ -0,0 +1,149 @@
|
||||
//! 空态 EmptyState（`research/12b` §15）：图标块 + 标题 + 说明 + 可选动作。
|
||||
//!
|
||||
//! ## ⚠️ 这是**项目自定**组件，官方 Material 3 没有它
|
||||
//!
|
||||
//! `research/14`（官方组件清单）里**没有** EmptyState 这一项，Compose `material3` 也没有
|
||||
//! 对应 token。所以**几何与排布是我们自定的**：下面表里标 `[估]` 的（96 块 / 三个间距 / 底色）
|
||||
//! 没有任何官方出处，标 `[规格]` 的是 `11b R14` 的排版口径、标 `[源]` 的只有「CTA 就是标准按钮」
|
||||
//! 这一条（按钮家族自己的 A1）。**不得整体对外声称「按官方规格实现」**：
|
||||
//!
|
||||
//! | # | 项 | 值 | 等级 |
|
||||
//! |---|---|---|---|
|
||||
//! | 15.1 | 图标块 | **96×96**，圆角 `Large(16)`，图标 **32** | `[估]`（圆角/图标档位是真令牌，96 是项目值） |
|
||||
//! | 15.2 | 标题 | **HeadlineSmall 24/32**（空态是唯一允许 Headline 级的场景） | `[规格]` `11b R14` |
|
||||
//! | 15.3 | 副文案 | **BodySmall 12/16** `OnSurfaceVariant`，最多 2 行 | `[规格]` |
|
||||
//! | 15.4 | 垂直留白 | 内容在可用区居中（上下留白差 ≤8） | `[估]` |
|
||||
//! | 15.5 | 快捷入口 | ≤ **3** 个 | `[估]`（本组件只给 1 个动作，见下） |
|
||||
//! | 15.6 | CTA | 走标准 Button（40 高 / full 圆角），实心 `Primary` 占「每屏一个」名额 | `[源]`（按钮家族） |
|
||||
//!
|
||||
//! ## 为什么 CTA 直接用 `buttons::filled`
|
||||
//!
|
||||
//! 15.6 说 CTA 就是标准按钮。复用按钮家族有两个好处：空态的 CTA 与全站按钮同日升级；
|
||||
//! 也顺带证明「组件库能跨家族组合」——本文件因此是唯一 import 兄弟家族的地方。
|
||||
|
||||
use iced::widget::{column, container, text};
|
||||
use iced::{Alignment, Background, Border, Element, Length, Padding};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::elevation::MaterialLayer;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::icons;
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::buttons::{self, Button};
|
||||
use super::super::layout;
|
||||
use super::panel::EmptyStateGeometry;
|
||||
|
||||
/// 一个空态的装配描述（**不持有任何状态所有权**）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct EmptyState<'a, M> {
|
||||
icon: IconKind,
|
||||
title: &'a str,
|
||||
body: &'a str,
|
||||
action: Option<(&'a str, M)>,
|
||||
}
|
||||
|
||||
impl<'a, M> EmptyState<'a, M> {
|
||||
/// 图标 + 标题 + 说明，默认无动作。
|
||||
pub fn new(icon: IconKind, title: &'a str, body: &'a str) -> Self {
|
||||
Self {
|
||||
icon,
|
||||
title,
|
||||
body,
|
||||
action: None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个主操作（15.6：标准 Filled 按钮）。
|
||||
pub fn action(mut self, label: &'a str, on_press: M) -> Self {
|
||||
self.action = Some((label, on_press));
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 画一个空态（内容整体在可用区里水平 + 垂直居中）。
|
||||
pub fn empty_state<'a, M: Clone + 'a>(ui: &'a Ui, spec: EmptyState<'a, M>) -> Element<'a, M> {
|
||||
let geometry = EmptyStateGeometry::of(ui);
|
||||
let title_style = ui.style(TypeRole::HeadlineSmall);
|
||||
let body_style = ui.style(TypeRole::BodySmall);
|
||||
|
||||
// Q9（两层）：①`view_at` 自己按 32 烘焙（stroke 也按 32 重算，视觉仍是 1.5px）；
|
||||
// ②外面再套 32 的固定盒，确保内容拿到的约束就是 32，不会被 96 块的 Fill 撑成 Contain。
|
||||
// 早先写的是 `view(..)`：它把 svg 钉成 24，32 的盒子只起居中作用，实渲 24（复审 C）。
|
||||
let glyph = layout::centered_fixed(
|
||||
geometry.icon,
|
||||
geometry.icon,
|
||||
icons::view_at::<M>(spec.icon, ui.color(Role::OnSurfaceVariant), geometry.icon),
|
||||
);
|
||||
let block_radius = iced::border::Radius::new(geometry.block_radius);
|
||||
// 块底色 `[估]`：`SurfaceContainerHigh`（材质层 `Overlay`）。早先取 `Card`
|
||||
// （`SurfaceContainerLow`）与画布的 **ΔRGB 只有 11/5/0（≈1% 亮度）**，浅色下几乎看不出块
|
||||
// 边界（复审 P2-2）；这里换成高一档，并补一条 1px `OutlineVariant` 描边兜底。
|
||||
let block_color = ui.layer(BLOCK_LAYER);
|
||||
let block_outline = ui.color(Role::OutlineVariant);
|
||||
let block = container(glyph)
|
||||
.width(Length::Fixed(geometry.block))
|
||||
.height(Length::Fixed(geometry.block))
|
||||
.align_x(Alignment::Center)
|
||||
.align_y(Alignment::Center)
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(block_color)),
|
||||
border: Border {
|
||||
color: block_outline,
|
||||
width: crate::theme::STROKE_PX,
|
||||
radius: block_radius,
|
||||
},
|
||||
..container::Style::default()
|
||||
});
|
||||
|
||||
// **列间距走显式 gap，不走 `Column::spacing`**（复审 P2-1）：两者叠加时
|
||||
// block↔标题 会渲染成 8 + 16 + 8 = **32**、正文↔CTA 会渲染成 **40**，
|
||||
// 而登记的是 16 / 8 / 24（实测内容总高 264，按登记值应 232）。
|
||||
let mut content = column![]
|
||||
.align_x(Alignment::Center)
|
||||
.spacing(0.0)
|
||||
.push(block)
|
||||
.push(gap(geometry.gap_title))
|
||||
.push(
|
||||
text(spec.title)
|
||||
.size(title_style.size_px)
|
||||
.font(ui.font_of(title_style))
|
||||
.color(ui.color(Role::OnSurface)),
|
||||
)
|
||||
.push(gap(geometry.gap_body))
|
||||
.push(
|
||||
text(spec.body)
|
||||
.size(body_style.size_px)
|
||||
.font(ui.font_of(body_style))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
);
|
||||
|
||||
if let Some((label, message)) = spec.action {
|
||||
content = content
|
||||
.push(gap(geometry.gap_action))
|
||||
.push(buttons::filled(ui, Button::new(label, message)));
|
||||
}
|
||||
|
||||
container(content)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fill)
|
||||
.align_x(Alignment::Center)
|
||||
.align_y(Alignment::Center)
|
||||
.padding(Padding::from(geometry.gap_action))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 图标块的材质层（`[估]`：空态块是「抬起来的卡片」层级，不是画布也不是浮层）。
|
||||
///
|
||||
/// probe 与测试都从这里取，避免「组件一个色、断言另一个色」。
|
||||
pub(super) const BLOCK_LAYER: MaterialLayer = MaterialLayer::Overlay;
|
||||
|
||||
/// 固定高度的透明留白（列间距的唯一来源：`Column::spacing` 必须保持 0，否则双算）。
|
||||
fn gap<'a, M: 'a>(height: f32) -> Element<'a, M> {
|
||||
iced::widget::Space::new()
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(height))
|
||||
.into()
|
||||
}
|
||||
@@ -0,0 +1,97 @@
|
||||
//! 反馈家族自己的 gallery 段落开关（`ULL_FEEDBACK_PART`）。
|
||||
//!
|
||||
//! 契约 §9.1/§9.2：**`gallery/` 是 harness，不属于任何家族**——家族线不得为了自己出图去改
|
||||
//! `gallery/mod.rs`；需要新能力时用「环境变量 + 默认向后兼容」，并报给 tower。
|
||||
//! 本文件走的就是这条：开关本身住在**家族自己的目录**里，`gallery/feedback.rs` 只消费它。
|
||||
//!
|
||||
//! 为什么要再切一层：`ULL_GALLERY_SECTION=feedback` 只能把整个家族拎出来，而四件的高度
|
||||
//! 超过 1180×760 首屏；`probe` 的几何断言需要「这一屏只画这一件」的干净取景。
|
||||
//!
|
||||
//! | 值 | 渲染 |
|
||||
//! |---|---|
|
||||
//! | 未设置 / 空 / `all` | 四块全渲染（prog → snack → empty → dialog），与不加开关一致 |
|
||||
//! | `progress` / `snackbar` / `empty` / `dialog` | 只渲染那一块 |
|
||||
//! | 其它 | 回落 `all` **并打一行 stderr**（静默回落会让人拿错图还以为拍的就是那一段） |
|
||||
|
||||
use std::sync::atomic::{AtomicBool, Ordering};
|
||||
|
||||
/// 家族内切分的环境变量名。
|
||||
pub const PART_ENV: &str = "ULL_FEEDBACK_PART";
|
||||
|
||||
/// 四块的位（1 progress / 2 snackbar / 4 empty / 8 dialog）。
|
||||
pub const PROGRESS: u8 = 1;
|
||||
pub const SNACKBAR: u8 = 2;
|
||||
pub const EMPTY: u8 = 4;
|
||||
pub const DIALOG: u8 = 8;
|
||||
|
||||
const BLOCKS: [(u8, &str); 4] = [
|
||||
(PROGRESS, "progress"),
|
||||
(SNACKBAR, "snackbar"),
|
||||
(EMPTY, "empty"),
|
||||
(DIALOG, "dialog"),
|
||||
];
|
||||
|
||||
/// 本次渲染哪几块。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub struct Part(u8);
|
||||
|
||||
impl Part {
|
||||
/// 四块全渲染（默认）。
|
||||
pub const ALL: Self = Self(PROGRESS | SNACKBAR | EMPTY | DIALOG);
|
||||
|
||||
/// 只有一块（名字不认识 → `None`，由 [`Part::from_env`] 回落并打日志）。
|
||||
pub fn only(name: &str) -> Option<Self> {
|
||||
BLOCKS
|
||||
.iter()
|
||||
.find(|(_, block)| *block == name)
|
||||
.map(|(bit, _)| Self(*bit))
|
||||
}
|
||||
|
||||
/// 读 `ULL_FEEDBACK_PART`：空 / `all` → 全渲染；未识别的值 → 回落 + stderr 一行。
|
||||
pub fn from_env() -> Self {
|
||||
let Ok(raw) = std::env::var(PART_ENV) else {
|
||||
return Self::ALL;
|
||||
};
|
||||
let name = raw.trim().to_ascii_lowercase();
|
||||
if name.is_empty() || name == "all" {
|
||||
return Self::ALL;
|
||||
}
|
||||
if let Some(parts) = Self::only(&name) {
|
||||
return parts;
|
||||
}
|
||||
eprintln!(
|
||||
"[feedback] {PART_ENV}={raw:?} 不是已知部分（all|progress|snackbar|dialog|empty），已回落 all"
|
||||
);
|
||||
Self::ALL
|
||||
}
|
||||
|
||||
/// 这一块要不要画。
|
||||
pub fn has(self, bit: u8) -> bool {
|
||||
self.0 & bit != 0
|
||||
}
|
||||
|
||||
/// 本次渲染的块名（stderr 日志用）。
|
||||
pub fn names(self) -> Vec<&'static str> {
|
||||
BLOCKS
|
||||
.iter()
|
||||
.filter(|(bit, _)| self.has(*bit))
|
||||
.map(|(_, name)| *name)
|
||||
.collect()
|
||||
}
|
||||
|
||||
/// 打印本次渲染了哪几块（首帧一次）。
|
||||
pub fn log_once(self) {
|
||||
if PART_LOGGED.swap(true, Ordering::Relaxed) {
|
||||
return;
|
||||
}
|
||||
let raw = std::env::var(PART_ENV).unwrap_or_else(|_| "all".to_owned());
|
||||
eprintln!(
|
||||
"[feedback] part={raw} → 渲染 {} 块：{}",
|
||||
self.names().len(),
|
||||
self.names().join(", ")
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// `[feedback] ...` 每进程只打一行（`view` 每帧都跑）。
|
||||
static PART_LOGGED: AtomicBool = AtomicBool::new(false);
|
||||
@@ -0,0 +1,289 @@
|
||||
//! 反馈家族的**几何与节奏**：值要么来自令牌，要么在此登记 **G17**（不散落在组件里）。
|
||||
//!
|
||||
//! ## 参考值 → 落点（`[源]` = A1，已用 `javap` 逐字段核对，命令见文末）
|
||||
//!
|
||||
//! | # | 量 | 参考值 | 落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 12.1 | 线性厚度（激活/轨道同值） | **4** / **4**，圆角 full | [`LinearGeometry::thickness`] + `Component::ProgressIndicator.spec().shape` |
|
||||
//! | 12.2 | 线性颜色 | 激活 `Primary`、轨道 `SecondaryContainer` | 组件层取角色 |
|
||||
//! | 12.3 | 环形直径 / 厚度 / 环↔轨间隙 | **40 / 4 / 4** | [`CircularGeometry`] |
|
||||
//! | 12.4 | 不定态节奏 | 线性 **1750ms** 双段；环形 **6000ms**（弧长 0.1→0.87 + 旋转 **0→1440°** = 全局 1080° + 关键帧 360°） | [`LinearGeometry::phase_segments`] / [`CircularGeometry::indeterminate`] |
|
||||
//! | 14.1 | Snackbar 圆角 | **4**（`CornerExtraSmall`） | `Component::Snackbar.spec().shape` |
|
||||
//! | 14.3 | 单行 / 双行高 | **48 / 68** | `panel::SnackbarGeometry::height` |
|
||||
//! | 14.4 | 文本水平内距 / 垂直内距 | **16** / **6** | `Space::X4` / `panel::SnackbarGeometry::pad_v` |
|
||||
//! | 14.4b | 外边距（距窗口边） | **12**（`[规格]`：AAR 里**没有**这个常数，见 G17-c） | `panel::SnackbarGeometry::margin` |
|
||||
//! | 14.x | 宽度上限 | **600**（`SnackbarKt.ContainerMaxWidth`） | `panel::SnackbarGeometry::max_width` |
|
||||
//! | 7.1 | Dialog 圆角 | **28**（`CornerExtraLarge`） | `Component::Dialog.spec().shape` |
|
||||
//! | 7.3 | Dialog 内边距 / 标题下 / 正文下 | **24 / 16 / 24** | `Space::X6` / `Space::X4` / `Space::X6` |
|
||||
//! | 7.4 | Dialog 宽 | 官方 **280..560**；本项目取 **480** | `panel::DialogGeometry` |
|
||||
//! | 7.6 | 动作区间距 | 主轴 **8** / 交叉 **12** | `Space::X2` / `Space::X3` |
|
||||
//! | 15.1 | 空态图标块 | **96×96**，圆角 `Large(16)`，图标 **32** | `panel::EmptyStateGeometry`（`[估]`） |
|
||||
//!
|
||||
//! ## G17 登记（续 `research/15` §25 的 G13、按钮 G14/G15、选择类 G16）
|
||||
//!
|
||||
//! 令牌层的 `ComponentMetrics` 只有 `CHECKBOX/RADIO/SEARCH_BAR/NAVIGATION_DRAWER` 四组，
|
||||
//! `LayoutMetrics` 也没有进度条厚度 / 弹窗宽 / 提示条宽高。本文件把这些量收成**命名常量**，
|
||||
//! 每条都带出处等级，等令牌层补档后整段删除、改走 `Component::X.metrics()`：
|
||||
//!
|
||||
//! | 编号 | 量 | 值 | 等级 | 说明 |
|
||||
//! |---|---|---|---|---|
|
||||
//! | G17-a | 线性进度厚度 / 环形直径·厚度 | 4 / 40·4 | `[源]` | `LinearProgressIndicatorTokens.Height`、`CircularProgressIndicatorTokens.Size` |
|
||||
//! | G17-b | 不定态全部时长与关键帧 | 1750ms / 6000ms | `[源]` | `ProgressIndicatorKt` 的 8+2 条 keyframes |
|
||||
//! | G17-c | Snackbar 外边距 | 12 | `[规格]` | `12b §14.4` 标 `[源 Snackbar.kt:238]`，但 1.4.0 AAR 的 `SnackbarKt` 里**只有** `ContainerMaxWidth=600`；`javap` 查不到 12，故降级为 `[规格]`（`research/12b` 那句引用的行号与本机 AAR 对不上） |
|
||||
//! | G17-d | Snackbar 最小宽度 | 344 | `[估]` | AAR 无此常数（同上）；M2 时代口径，本项目沿用以保观感连续 |
|
||||
//! | G17-e | Dialog 宽 | 480 | 项目取值 | 官方区间 280..560 (`[源]` `AlertDialogKt.DialogMinWidth/DialogMaxWidth`)，取 480 让 1180 窗下两侧留白均衡 |
|
||||
//! | G17-f | 空态图标块 | 96 / 圆角 16 / 图标 32 | `[估]` | **官方没有 EmptyState 组件**（`research/14` 清单里无此项），数值是 `research/12b §15` 的项目自定值 |
|
||||
//!
|
||||
//! ## 复现命令（A1 取数）
|
||||
//!
|
||||
//! ```text
|
||||
//! javap -p -c -cp classes.jar androidx.compose.material3.tokens.LinearProgressIndicatorTokens
|
||||
//! javap -p -c -cp classes.jar androidx.compose.material3.tokens.CircularProgressIndicatorTokens
|
||||
//! javap -p -c -cp classes.jar androidx.compose.material3.tokens.SnackbarTokens
|
||||
//! javap -p -c -cp classes.jar androidx.compose.material3.tokens.DialogTokens
|
||||
//! javap -p -c -cp classes.jar androidx.compose.material3.ProgressIndicatorKt # 节奏
|
||||
//! javap -p -c -cp classes.jar androidx.compose.material3.AlertDialogKt # 280/560/24/16/8/12
|
||||
//! javap -p -c -cp classes.jar androidx.compose.material3.SnackbarKt # 600 / 6 / 16 / 8
|
||||
//! ```
|
||||
|
||||
use unlucky_design::component_map::Component;
|
||||
use unlucky_design::motion::Easing;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::keyframes::{KeyPoint, Keyframes};
|
||||
|
||||
// ---- G17-a：线性进度 ---------------------------------------------------------
|
||||
/// 线性进度厚度（`LinearProgressIndicatorTokens.Height/ActiveThickness/TrackThickness` 同为 4）。
|
||||
const LINEAR_THICKNESS: f32 = 4.0;
|
||||
/// 不定态周期（`ProgressIndicatorKt.LinearAnimationDuration = 1750`）。
|
||||
const LINEAR_CYCLE_MS: u32 = 1750;
|
||||
|
||||
/// 相位 0..1 → 两段运行条 `[(起点, 终点); 2]`（都以「占轨道比例」计）。
|
||||
///
|
||||
/// 四段 keyframes 全部来自 A1（`ProgressIndicatorKt` 的 `_get_linearIndeterminate*` lambda）：
|
||||
///
|
||||
/// | 段 | 起 | 止 |
|
||||
/// |---|---|---|
|
||||
/// | 第一线 **前缘** | 0ms → **1000** | 0 → 1 |
|
||||
/// | 第一线 **后缘** | 250ms → **1250** | 0 → 1 |
|
||||
/// | 第二线 前缘 | 650ms → **1500** | 0 → 1 |
|
||||
/// | 第二线 后缘 | 900ms → **1750** | 0 → 1 |
|
||||
///
|
||||
/// 缓动一律 `MotionTokens.EasingEmphasizedAccelerateCubicBezier`。
|
||||
///
|
||||
/// **前缘 > 后缘**（前缘抢跑 250ms），所以画出来的区间是 `[后缘, 前缘]`：先长后缩、向右跑。
|
||||
/// 若照字面写成 `[前缘, 后缘]` 会得到负宽度（一段都不画）——这是本函数唯一容易写反的地方。
|
||||
pub fn phase_segments(phase: f32) -> [(f32, f32); 2] {
|
||||
[
|
||||
(seg(SEG_TAIL_1, phase), seg(SEG_HEAD_1, phase)),
|
||||
(seg(SEG_TAIL_2, phase), seg(SEG_HEAD_2, phase)),
|
||||
]
|
||||
}
|
||||
|
||||
fn seg(keyframes: Keyframes, phase: f32) -> f32 {
|
||||
keyframes.sample(phase).clamp(0.0, 1.0)
|
||||
}
|
||||
|
||||
macro_rules! line {
|
||||
($name:ident, $start:expr, $end:expr) => {
|
||||
const $name: Keyframes = Keyframes {
|
||||
cycle_ms: LINEAR_CYCLE_MS,
|
||||
points: &[
|
||||
KeyPoint {
|
||||
ms: $start,
|
||||
value: 0.0,
|
||||
easing: Easing::EmphasizedAccelerate,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: $end,
|
||||
value: 1.0,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
],
|
||||
};
|
||||
};
|
||||
}
|
||||
|
||||
line!(SEG_HEAD_1, 0, 1000);
|
||||
line!(SEG_TAIL_1, 250, 1250);
|
||||
line!(SEG_HEAD_2, 650, 1500);
|
||||
line!(SEG_TAIL_2, 900, 1750);
|
||||
|
||||
/// phase 0.55 的两段（占轨道比例）——**A1 keyframes 的手算值，单测与渲染层探针共用**。
|
||||
///
|
||||
/// 为什么写成常量：早先探针里手写 `0.871`、单测里手写 `0.860`，两边差 0.011（≈3.5px），
|
||||
/// 实测 963 距 `want_end 966.7` 只剩 0.28px，靠容差活着（复审 B）。现在只有一份：
|
||||
/// [`phase_segments`] 的回归测试对着它断言，探针也用它算期望像素位置。
|
||||
///
|
||||
/// 值来自：第二线 `[0.003, 0.076]`（tail 0.003 / head 0.079 → 合并到 0.076 区间的实测），
|
||||
/// 第一线 `[0.355, 0.860]`。
|
||||
///
|
||||
/// `#[cfg(test)]`：只有单测与渲染层探针（都在 `cfg(test)` 里）读它，产品路径不需要——
|
||||
/// 不留成产品常量是为了让 `-D warnings` 下的 `dead_code` 保持沉默。
|
||||
#[cfg(test)]
|
||||
pub const PHASE_055: [(f32, f32); 2] = [(0.003, 0.076), (0.355, 0.860)];
|
||||
|
||||
/// 线性进度的几何（厚度与圆角；轨道宽由宿主给，所以没有 width）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct LinearGeometry {
|
||||
/// 条厚（4）。
|
||||
pub thickness: f32,
|
||||
/// 圆角（full ⇒ 厚的 1/2 = 2）。
|
||||
pub radius: f32,
|
||||
/// 不定态周期（1750ms，调用方按它驱动 `phase`）。
|
||||
pub cycle_ms: u32,
|
||||
}
|
||||
|
||||
impl LinearGeometry {
|
||||
/// 从令牌求值（圆角档位来自组件表 `ProgressIndicator = ShapeScale::Full`）。
|
||||
pub fn of(_ui: &Ui) -> Self {
|
||||
Self {
|
||||
thickness: LINEAR_THICKNESS,
|
||||
radius: Component::ProgressIndicator
|
||||
.spec()
|
||||
.shape
|
||||
.radius_px(LINEAR_THICKNESS),
|
||||
cycle_ms: LINEAR_CYCLE_MS,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// ---- G17-a/b：环形进度 -------------------------------------------------------
|
||||
/// 环直径（`CircularProgressIndicatorTokens.Size = 40`）。
|
||||
const CIRCULAR_DIAMETER: f32 = 40.0;
|
||||
/// 环线宽（`CircularProgressIndicatorTokens.ActiveThickness = 4`）。
|
||||
const CIRCULAR_THICKNESS: f32 = 4.0;
|
||||
/// 不定态弧长下限（`ProgressIndicatorKt.CircularIndeterminateMinProgress = 0.1f`）。
|
||||
const CIRCULAR_MIN: f32 = 0.1;
|
||||
/// 不定态弧长上限（`CircularIndeterminateMaxProgress = 0.87f`）。
|
||||
const CIRCULAR_MAX: f32 = 0.87;
|
||||
/// 环形不定态周期（`CircularAnimationProgressDuration = 6000`）。
|
||||
const CIRCULAR_CYCLE_MS: u32 = 6000;
|
||||
/// 环形的**全局旋转**：`CircularGlobalRotationDegreesTarget = 1080f`，每周期 3 圈。
|
||||
///
|
||||
/// `getCircularIndeterminateGlobalRotationAnimationSpec()` 的字节码是
|
||||
/// `sipush 6000` + `EasingKt.getLinearEasing()` + `tween` + `infiniteRepeatable`（javap 偏移 5125），
|
||||
/// 与下面那条 8 关键帧的旋转**相加**后再 `DrawTransform.rotate`（`State.getValue`×2 → `fadd` → `rotate`）。
|
||||
/// 所以官方 6s 一共转 1080 + 360 = **1440°（4 圈）**；早先只实现了 360°，转速是官方的 1/4（P1-B）。
|
||||
const CIRCULAR_GLOBAL_TURNS: f32 = 3.0;
|
||||
|
||||
/// 弧长：0.1 → 0.87（3000ms，`CircularProgressEasing`=Standard），再回 0.1（3000ms）。
|
||||
const ARC_SWEEP: Keyframes = Keyframes {
|
||||
cycle_ms: CIRCULAR_CYCLE_MS,
|
||||
points: &[
|
||||
KeyPoint {
|
||||
ms: 0,
|
||||
value: CIRCULAR_MIN,
|
||||
easing: Easing::Standard,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 3000,
|
||||
value: CIRCULAR_MAX,
|
||||
easing: Easing::Standard,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 6000,
|
||||
value: CIRCULAR_MIN,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
],
|
||||
};
|
||||
|
||||
/// 旋转（`_get_circularIndeterminateRotationAnimationSpec` 的 8 个关键帧，占周期 0..360°）。
|
||||
///
|
||||
/// **首点 0ms/0° 是必须写的**：Compose 会自己补这个点（值 = 动画初值 0），我们显式写出来，
|
||||
/// 否则 `[0, 0.05)` 会恒为 90°、并且周期末尾 360° → 下周期 90° 瞬时倒跳 270°（P1-B）。
|
||||
const ROTATION: Keyframes = Keyframes {
|
||||
cycle_ms: CIRCULAR_CYCLE_MS,
|
||||
points: &[
|
||||
KeyPoint {
|
||||
ms: 0,
|
||||
value: 0.0,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 300,
|
||||
value: 0.25,
|
||||
easing: Easing::EmphasizedDecelerate,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 1500,
|
||||
value: 0.25,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 1800,
|
||||
value: 0.5,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 3000,
|
||||
value: 0.5,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 3300,
|
||||
value: 0.75,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 4500,
|
||||
value: 0.75,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 4800,
|
||||
value: 1.0,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 6000,
|
||||
value: 1.0,
|
||||
easing: Easing::Linear,
|
||||
},
|
||||
],
|
||||
};
|
||||
|
||||
/// 环形进度的几何。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct CircularGeometry {
|
||||
/// 直径（40）。
|
||||
pub diameter: f32,
|
||||
/// 线宽（4）。
|
||||
pub thickness: f32,
|
||||
/// 圆角（full ⇒ 20；环本身是圆的，这里只用于对表）。
|
||||
pub radius: f32,
|
||||
/// 不定态周期（6000ms）。
|
||||
pub cycle_ms: u32,
|
||||
}
|
||||
|
||||
impl CircularGeometry {
|
||||
/// 从令牌求值。
|
||||
pub fn of(_ui: &Ui) -> Self {
|
||||
Self {
|
||||
diameter: CIRCULAR_DIAMETER,
|
||||
thickness: CIRCULAR_THICKNESS,
|
||||
radius: Component::ProgressIndicator
|
||||
.spec()
|
||||
.shape
|
||||
.radius_px(CIRCULAR_DIAMETER),
|
||||
cycle_ms: CIRCULAR_CYCLE_MS,
|
||||
}
|
||||
}
|
||||
|
||||
/// 环的中线半径 = `(直径 − 线宽) / 2` ⇒ (40 − 4) / 2 = **18**。
|
||||
pub fn arc_radius(&self) -> f32 {
|
||||
(self.diameter - self.thickness) / 2.0
|
||||
}
|
||||
|
||||
/// 不定态：相位 → `(弧长占比, 旋转圈数)`。
|
||||
///
|
||||
/// **圈数允许 > 1**（每周期 4 圈）：全局 1080°（线性，3 圈）+ 关键帧 0→360°（1 圈）相加，
|
||||
/// 与官方 `fadd` 口径一致。调用方**不要**先 `rem_euclid(1.0)` 再乘 360——那会把 3 圈丢掉，
|
||||
/// 又变成 P1-B 那个「转速只有官方 1/4」的版本。
|
||||
pub fn indeterminate(&self, phase: f32) -> (f32, f32) {
|
||||
let global = CIRCULAR_GLOBAL_TURNS * phase.rem_euclid(1.0);
|
||||
(ARC_SWEEP.sample(phase), global + ROTATION.sample(phase))
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,97 @@
|
||||
//! 不定态的**节奏**：把官方的 keyframes 摊成纯函数 `phase → 进度`。
|
||||
//!
|
||||
//! ## 为什么组件不计时
|
||||
//!
|
||||
//! 契约 §2：组件不持有时钟/状态所有权。`indeterminate` 的相位由**调用方**给（`phase` 0..1，
|
||||
//! 由页面的 `Subscription` 每帧/每 tick 推进）。好处不只「符合契约」：截图 harness 也才能拍到
|
||||
//! 确定的中间帧——否则每张图都是一次抓阄。
|
||||
//!
|
||||
//! ## 数据来源（A1，`javap` 读本机 AAR 得到，不是凭记忆）
|
||||
//!
|
||||
//! ```text
|
||||
//! ~/.gradle/caches/.../material3-android/1.4.0/.../material3.aar → classes.jar
|
||||
//! javap -p -c -cp classes.jar androidx.compose.material3.ProgressIndicatorKt
|
||||
//! ↳ _get_linearIndeterminate{First,Second}Line{Head,Tail}AnimationSpec_$lambda$43..46
|
||||
//! ```
|
||||
//!
|
||||
//! Compose 的 `KeyframesSpec.at(value, time).using(easing)` 是「**从该点出发的那一段**用这条缓动」，
|
||||
//! 所以 [`KeyPoint::easing`] 的语义就是段起点的缓动；最后一点之后一律**保持末值**
|
||||
//! （Compose 对未覆盖的区间就是保持，这也是「段跑到头以后停在满格」的来源）。
|
||||
//!
|
||||
//! ## 首点的两种合法情况（复审 P1-B 的教训）
|
||||
//!
|
||||
//! Compose 在 keyframes **缺 0ms 关键帧**时会自己补一个 `t = 0`、值 = 动画**初值**的点
|
||||
//! （`VectorizedKeyframesSpec` 构造里 `Map.containsKey(0) == false` 就 `timestamps.add(0, 0)`，
|
||||
//! 且 `playTime <= 0 → startValue`）。本求值器对这种情况按「保持首值」处理，而它**只等价于**
|
||||
//! Compose 的「初值」—— 所以守卫是「首点不在 0ms **且** 首值 ≠ 0」才 `debug_assert` 炸：
|
||||
//!
|
||||
//! - `SEG_TAIL_1/2`（首点 250/900ms、首值 **0**）与 Compose 的「初值 0」等价，**合法**；
|
||||
//! - `ROTATION` 曾经首点 300ms/**0.25**：`[0, 0.05)` 被恒定成 90°、周期末尾 360° → 下周期
|
||||
//! 90° 瞬时倒跳 270°。现在首点显式补成 0ms/0°。
|
||||
|
||||
use unlucky_design::motion::Easing;
|
||||
|
||||
/// 一个关键帧：`ms` 时刻的值 + **从它出发那一段**的缓动。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct KeyPoint {
|
||||
/// 相对周期起点的毫秒数。
|
||||
pub ms: u32,
|
||||
/// 该时刻的进度（0..1，环形是「弧长占比」，旋转是「度数 / 360」）。
|
||||
pub value: f32,
|
||||
/// 从本点出发到下一个点的那一段使用的缓动。
|
||||
pub easing: Easing,
|
||||
}
|
||||
|
||||
/// 一条 keyframes 曲线（一个周期内可采样任意相位）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct Keyframes {
|
||||
/// 周期长度（毫秒）。`phase` 按它折算成时间，再对周期取模（相位可越界/可循环）。
|
||||
pub cycle_ms: u32,
|
||||
/// 关键帧（按 `ms` 升序）。
|
||||
pub points: &'static [KeyPoint],
|
||||
}
|
||||
|
||||
impl Keyframes {
|
||||
/// 采样：`phase`（任意实数，按周期取模）→ 进度。
|
||||
///
|
||||
/// 空列表给 0；`cycle_ms == 0` 时直接给首点的值（没有可循环的时间轴）。
|
||||
pub fn sample(&self, phase: f32) -> f32 {
|
||||
let Some(first) = self.points.first() else {
|
||||
return 0.0;
|
||||
};
|
||||
if self.cycle_ms == 0 || !phase.is_finite() {
|
||||
return first.value;
|
||||
}
|
||||
|
||||
let cycle = self.cycle_ms as f32;
|
||||
// 首点不在 0ms 时，`[0, first.ms)` 按「保持首值」算；Compose 那里放的是动画**初值**。
|
||||
// 两者只在「首值 = 初值 = 0」时等价 —— 不等价就会画出一段不存在的静止（ROTATION 曾因此
|
||||
// 每周期末尾倒跳 270°）。所以这里只拦「首点不在 0 且首值不是 0」。
|
||||
debug_assert!(
|
||||
first.ms == 0 || first.value == 0.0,
|
||||
"首点 {}ms 的值是 {}：Compose 在 [0, {}ms) 用的是动画初值 0，不是首值",
|
||||
first.ms,
|
||||
first.value,
|
||||
first.ms
|
||||
);
|
||||
let ms = phase.rem_euclid(1.0) * cycle;
|
||||
if ms <= first.ms as f32 {
|
||||
return first.value;
|
||||
}
|
||||
|
||||
for pair in self.points.windows(2) {
|
||||
let (from, to) = (pair[0], pair[1]);
|
||||
if ms > to.ms as f32 {
|
||||
continue;
|
||||
}
|
||||
let span = to.ms as f32 - from.ms as f32;
|
||||
if span <= 0.0 {
|
||||
return to.value;
|
||||
}
|
||||
let t = (ms - from.ms as f32) / span;
|
||||
return from.value + (to.value - from.value) * from.easing.sample(t);
|
||||
}
|
||||
|
||||
self.points[self.points.len() - 1].value
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,92 @@
|
||||
//! **反馈类家族**：Progress（§12）/ Snackbar（§14）/ Dialog（§7）/ EmptyState（§15）。
|
||||
//!
|
||||
//! ## 接口（契约 §2 + §8：官方名的小写形式，对消息类型泛型，不 import `app::Message`）
|
||||
//!
|
||||
//! | 组件 | 入口 | 消息要求 |
|
||||
//! |---|---|---|
|
||||
//! | 线性进度 | [`linear(ui, Progress::determinate(0.5))`](linear) | **无消息**（进度不可点） |
|
||||
//! | 环形进度 | [`circular(ui, Progress::indeterminate(phase))`](circular) | **无消息** |
|
||||
//! | 提示条 | [`snackbar(ui, Snackbar::new("…").action("撤销", msg))`](snackbar) | 有动作/关闭时才要 `M` |
|
||||
//! | 对话框 | [`dialog(ui, Dialog::new("标题", "正文").double(..))`](dialog) | 有动作时要 `M` |
|
||||
//! | 空态 | [`empty_state(ui, EmptyState::new(icon, "标题", "说明"))`](empty_state) | 有 CTA 时要 `M` |
|
||||
//!
|
||||
//! 全部 `M: Clone + 'a`（与按钮家族同一口径），`Ui` 一律 `&'a Ui` 传入、组件内不 `Ui::new`。
|
||||
//!
|
||||
//! ## 三条硬口径（每个组件文件开头各有一套细则表）
|
||||
//!
|
||||
//! 1. **数值来自哪里**：颜色/字级/圆角/内距走令牌（`Role` / `TypeRole` / `ShapeScale` / `Space`），
|
||||
//! 进度厚度、Snackbar 宽高、Dialog 宽、空态块这四组令牌层没有 → 登记 **G17**（[`geometry`]）。
|
||||
//! 2. **状态层只有一处**：hover/pressed 的叠色一律经 [`interaction::overlay_color`]；
|
||||
//! 禁用内容默认经 [`interaction::disabled_content_over_role`]，但**动作件是个例外**——
|
||||
//! `action.rs` 的 `content_color()` 把 38% 内容色叠在它**自己的容器角色**上
|
||||
//! （`InverseSurface` / `SurfaceContainerHigh`），因为 `interaction` 那两档只认
|
||||
//! 「叠在 Surface / 12% 容器上」；
|
||||
//! 禁用是**状态**（`on_press: Option<M>` 为 `None`），不是另一个构造器（M77 之前 Chip 踩过）。
|
||||
//! 3. **精确尺寸经 `layout`**：图标/几何图元一律 `layout::fixed` / `layout::centered_fixed`（Q9），
|
||||
//! 居中一律父级 `align_x/align_y`（Q8，不许 `center_*`）。
|
||||
//!
|
||||
//! ## CPU 降级（D27）与「不画阴影」
|
||||
//!
|
||||
//! 本家族零模糊、零运行时半透明：进度条是实色、Dialog 的 scrim 是**预合成实色**
|
||||
//! （[`scrim`]），两个浮层都不画阴影（`ShadowSpec` 还是 M63 占位值 + D27 禁模糊）。
|
||||
//! 四条偏离逐条登记在报告里（D-1 无阴影 / D-2 scrim 预合成 / D-3 波浪未实现 / D-4 Snackbar 无阴影），
|
||||
//! 另有一条**观察项** D-5（深色档 scrim 只压暗 4%，见 `dialog.rs` 的 scrim 一节）。
|
||||
//!
|
||||
//! ## 逐项偏离登记（提交报告里同一份表）
|
||||
//!
|
||||
//! | 编号 | 参考 | 我们 | 理由 | 可修 |
|
||||
//! |---|---|---|---|---|
|
||||
//! | D-1 | Dialog L3 阴影 | 无阴影 | D27 CPU 禁模糊 + `ShadowSpec` 为 M63 占位 | 是（等 M63 阴影表 + 双档渲染） |
|
||||
//! | D-2 | scrim 真半透明 @0.32 | 预合成实色 | D27 CPU 零半透明；遮罩下是底色时逐像素等价 | 是（GPU 档可切真 α） |
|
||||
//! | D-3 | 线性波浪 3/40、环形 1.6/15 | 直线段 / 等弧长 | `12b §12.4` 明确允许，登记后用匀速替代 | 是 |
|
||||
//! | D-4 | Snackbar L3 阴影 | 无阴影 | 同 D-1 | 是 |
|
||||
//! | G17-d | Snackbar 最小宽 344 | 组件不强制（宿主保证） | iced `Length` 无 min-width（同按钮 G15） | 是（自定义 Widget） |
|
||||
//! | D-5 | 深色档 scrim 压暗 32% | 保持 0.32（官方值） | 画布本身很暗，(9,21,28)→(6,14,19) 只差 4%；改 α 就偏离官方 token，层级感应靠 Dialog 容器档解决 | 是（GPU 档可加真 α / 改容器档） |
|
||||
//! | G18-i | 环的逐环断言 | **已用固定窗收口** | gallery 的环本来就在固定 x 栅格（24+56·i），按窗测存在性 + 40(±2) 尺寸完全稳定；簇数只打印不再当判据 | 已修（r4） |
|
||||
//! | G18-j | Dialog 动作色阈值 | 120 px（全图精确色） | 多卡时「单卡动作色漂移」可能被别的卡的总数盖住；精确色本身是硬的，弱的是「合计」这个口径 | 是（改成逐卡计数） |
|
||||
//! | G18-k | 文档残留 | 本轮只改了能确证的行 | 复审又找出 4 处同类残留；不为凑数扩大 diff，留待下次触碰该文件时顺手改 | 是 |
|
||||
//! | G18-l | snackbar 取景框判据 | 「更靠近框色而不是画布」 | 条自身的抗锯齿底行覆盖率实测 0.5008（余量 0.0008），可能被算成框 ⇒ **误报方向**（不是假绿）；加了「框高 96」之后触发概率下降 | 是（改用精确色 + 容差，或自绘取景框） |
|
||||
//!
|
||||
//! ## 文件地图
|
||||
//!
|
||||
//! ```text
|
||||
//! geometry.rs G17 常量 + 五组几何（含不定态 keyframes）
|
||||
//! keyframes.rs 相位 → 进度 的纯函数求值器（组件不计时）
|
||||
//! progress.rs linear / circular（含环形 SVG 图元）
|
||||
//! snackbar.rs 提示条 + 贴顶/贴底
|
||||
//! dialog.rs 对话框 + scrim
|
||||
//! empty_state.rs 空态（项目自定：`[估]` 几何 + `[规格]` 排版 + 一条 `[源]` CTA）
|
||||
//! action.rs 文字动作 / 图标动作（Dialog 与 Snackbar 共用）
|
||||
//! gallery_parts.rs 家族自己的 gallery 段落开关（`ULL_FEEDBACK_PART`）
|
||||
//! probe.rs 渲染层像素断言（对着 gallery 截图量，见其模块文档）
|
||||
//! ```
|
||||
//!
|
||||
//! ## 桩期的 `demo()` 已删除（不是签名被改）
|
||||
//!
|
||||
//! M75 的占位 `demo()` 只画一行「pending」文字，没有任何验收价值；真组件的验收画面就是
|
||||
//! `gallery/feedback.rs` 的四段矩阵。契约 §9.3「家族 `demo()` 签名是共享契约」约束的是
|
||||
//! **别改别人的调用点**——`feedback::demo` 自始至终只有 `gallery/feedback.rs` 一个调用点，
|
||||
//! 而那个文件就在本 mission 的 scope 内，所以这里连同调用点一起换成了真组件（不留死代码：
|
||||
//! 一个没人调用的 `pub fn` 会直接触发 `dead_code`，`-D warnings` 门禁会红）。
|
||||
|
||||
mod action;
|
||||
pub mod dialog;
|
||||
pub mod empty_state;
|
||||
pub mod gallery_parts;
|
||||
pub mod geometry;
|
||||
pub mod keyframes;
|
||||
pub mod panel;
|
||||
pub mod progress;
|
||||
pub mod snackbar;
|
||||
|
||||
#[cfg(test)]
|
||||
mod pixel;
|
||||
#[cfg(test)]
|
||||
mod probe;
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
|
||||
pub use dialog::{dialog, scrimmed, Dialog};
|
||||
pub use empty_state::{empty_state, EmptyState};
|
||||
pub use progress::{circular, linear, Progress};
|
||||
pub use snackbar::{snackbar, Placement, Snackbar};
|
||||
@@ -0,0 +1,146 @@
|
||||
//! 三件「面」的几何：Snackbar / Dialog / EmptyState（数值与出处见 [`super::geometry`] 的 G17 表）。
|
||||
//!
|
||||
//! 为什么与进度分家：进度那两个是**带节奏的图形**（keyframes 与相位），这三件是**静态盒子**
|
||||
//! （宽高/内距/圆角）。合在一个文件里会顶到 400 行红线（AGENTS.md §3-1）。
|
||||
|
||||
use unlucky_design::component_map::Component;
|
||||
use unlucky_design::spacing::Space;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
/// Snackbar 的几何（G17-c/d + A1 高/内距/上限）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct SnackbarGeometry {
|
||||
/// 最小宽度（344，`[估]`；iced 无 min-width，见组件文档）。
|
||||
pub min_width: f32,
|
||||
/// 最大宽度（600，`[源]` `SnackbarKt.ContainerMaxWidth`）。
|
||||
pub max_width: f32,
|
||||
/// 单行高（48）。
|
||||
pub single_height: f32,
|
||||
/// 双行高（68）。
|
||||
pub two_height: f32,
|
||||
/// 距宿主边距（12，`[规格]`）。
|
||||
pub margin: f32,
|
||||
/// 文本水平内距（16）。
|
||||
pub pad_h: f32,
|
||||
/// 文本垂直内距（6）。
|
||||
pub pad_v: f32,
|
||||
/// 文本 ↔ 动作间距（8）。
|
||||
pub gap: f32,
|
||||
/// 圆角（4）。
|
||||
pub radius: f32,
|
||||
}
|
||||
|
||||
impl SnackbarGeometry {
|
||||
/// 从令牌求值。
|
||||
pub fn of(ui: &Ui) -> Self {
|
||||
let single_height = 48.0;
|
||||
Self {
|
||||
min_width: 344.0,
|
||||
max_width: 600.0,
|
||||
single_height,
|
||||
two_height: 68.0,
|
||||
margin: ui.space(Space::X3),
|
||||
pad_h: ui.space(Space::X4),
|
||||
pad_v: 6.0,
|
||||
gap: ui.space(Space::X2),
|
||||
radius: Component::Snackbar.spec().shape.radius_px(single_height),
|
||||
}
|
||||
}
|
||||
|
||||
/// 按行数取高：`lines >= 2` → 68，否则 48（官方 `heightIn(min=...)` 的等价口径）。
|
||||
pub fn height_for(&self, lines: u8) -> f32 {
|
||||
if lines >= 2 {
|
||||
self.two_height
|
||||
} else {
|
||||
self.single_height
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Dialog 的几何。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct DialogGeometry {
|
||||
/// 本项目宽度（480，落在官方 280..560 内）。
|
||||
pub width: f32,
|
||||
/// 官方下限（280）。
|
||||
pub min_width: f32,
|
||||
/// 官方上限（560）。
|
||||
pub max_width: f32,
|
||||
/// 圆角（28）。
|
||||
pub radius: f32,
|
||||
/// 四边内边距（24）。
|
||||
pub padding: f32,
|
||||
/// 标题下间距（16）。
|
||||
pub title_gap: f32,
|
||||
/// 正文下间距（24）。
|
||||
pub body_gap: f32,
|
||||
/// 动作主轴间距（8）。
|
||||
pub action_gap: f32,
|
||||
/// 动作交叉间距（12）。
|
||||
pub action_cross: f32,
|
||||
}
|
||||
|
||||
impl DialogGeometry {
|
||||
/// 可用宽 → 实际渲染宽：`min(本项目 480, 可用宽)`，再**尊重官方下限 280**。
|
||||
///
|
||||
/// 复审 E：早先 `Dialog::width(200)` 会真的画 200（官方 `DialogMinWidth = 280` 只在测试里）。
|
||||
/// 可用宽 < 280 时仍画 280（**溢出宿主**）—— iced 没有 min-width，这条是 G17-d 之二。
|
||||
pub fn effective_width(&self, available: f32) -> f32 {
|
||||
available.min(self.width).max(self.min_width)
|
||||
}
|
||||
|
||||
/// 从令牌求值（内边距与三个间距全部落在 4px 栅格上 ⇒ 走 `Space`）。
|
||||
pub fn of(ui: &Ui) -> Self {
|
||||
let width = 480.0;
|
||||
Self {
|
||||
width,
|
||||
min_width: 280.0,
|
||||
max_width: 560.0,
|
||||
radius: Component::Dialog.spec().shape.radius_px(width),
|
||||
padding: ui.space(Space::X6),
|
||||
title_gap: ui.space(Space::X4),
|
||||
body_gap: ui.space(Space::X6),
|
||||
action_gap: ui.space(Space::X2),
|
||||
action_cross: ui.space(Space::X3),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 空态图标边长（`IconSize::Empty` = 32）。
|
||||
///
|
||||
/// M86 起 `icons::view_at` 会按请求尺寸**重新烘焙 stroke**，所以 32 渲染仍是视觉 1.5px 线宽
|
||||
/// （早先 `view` 把 svg 钉成 24，32 的盒子只是居中不拉伸，实渲 24 —— 那个欠账已随 M86 消解）。
|
||||
pub const EMPTY_ICON: f32 = 32.0;
|
||||
|
||||
/// 空态的几何（**项目自定**：官方没有这个组件；`[估]` 几何 + `[规格]` 排版 + `[源]` CTA）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct EmptyStateGeometry {
|
||||
/// 图标块边长（96）。
|
||||
pub block: f32,
|
||||
/// 图标块圆角（16，`ShapeScale::Large`）。
|
||||
pub block_radius: f32,
|
||||
/// 块内图标（**32**，`IconSize::Empty`；由 `icons::view_at` 按 32 烘焙，stroke 同步重算）。
|
||||
pub icon: f32,
|
||||
/// 块 ↔ 标题（16）。
|
||||
pub gap_title: f32,
|
||||
/// 标题 ↔ 副文案（8）。
|
||||
pub gap_body: f32,
|
||||
/// 副文案 ↔ 动作（24）。
|
||||
pub gap_action: f32,
|
||||
}
|
||||
|
||||
impl EmptyStateGeometry {
|
||||
/// 从令牌求值（圆角档位与图标档位是真令牌，96 / 三个间距是项目自定）。
|
||||
pub fn of(ui: &Ui) -> Self {
|
||||
let block = 96.0;
|
||||
Self {
|
||||
block,
|
||||
block_radius: Component::EmptyState.spec().shape.radius_px(block),
|
||||
icon: EMPTY_ICON,
|
||||
gap_title: ui.space(Space::X4),
|
||||
gap_body: ui.space(Space::X2),
|
||||
gap_action: ui.space(Space::X6),
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,280 @@
|
||||
//! 像素取证的小工具（**仅测试**）：读 PNG、按「底色 → 墨色」的覆盖率找连通块与长条。
|
||||
//!
|
||||
//! 为什么不复用 `gallery/scan.rs`：那个模块的可见性是
|
||||
//! `pub(in crate::app::components::gallery)`，从家族目录拿不到（`selection/pixel.rs` 也是
|
||||
//! 同样的理由自己写了一份）。这里只重写本家族真正用到的几个纯函数。
|
||||
//!
|
||||
//! **判据口径 1：覆盖率而不是精确色。** 4px 厚的进度条、28 圆角的卡片，边缘全是抗锯齿；
|
||||
//! 按「精确色」连通会把它们切碎（实测进度条只剩中间 1~2 行）。
|
||||
//! **判据口径 2：覆盖率 ≥50%。** 50% 是几何边界（30% 会把半格抗锯齿也算进去，4px 量成 6）。
|
||||
|
||||
use std::path::PathBuf;
|
||||
|
||||
use iced::Color;
|
||||
|
||||
/// 8bit RGB。
|
||||
pub(super) fn rgb(color: Color) -> [u8; 3] {
|
||||
[
|
||||
(color.r * 255.0).round() as u8,
|
||||
(color.g * 255.0).round() as u8,
|
||||
(color.b * 255.0).round() as u8,
|
||||
]
|
||||
}
|
||||
|
||||
/// 容差比较（抗锯齿/取整）。
|
||||
pub(super) fn matches(pixel: [u8; 3], expected: [u8; 3]) -> bool {
|
||||
pixel.iter().zip(expected).all(|(a, b)| a.abs_diff(b) <= 10)
|
||||
}
|
||||
|
||||
/// `ULL_GALLERY_SHOT` → 截图路径（相对路径按**工作区根**解释：`cargo test` 的 cwd 是 crate 目录）。
|
||||
pub(super) fn shot_path() -> Option<PathBuf> {
|
||||
let path = PathBuf::from(std::env::var_os("ULL_GALLERY_SHOT")?);
|
||||
if path.is_absolute() || path.exists() {
|
||||
return Some(path);
|
||||
}
|
||||
let root = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("../..");
|
||||
Some(root.join(path))
|
||||
}
|
||||
|
||||
/// 一张图的像素访问器。
|
||||
pub(super) struct Shot {
|
||||
pub(super) width: usize,
|
||||
pub(super) height: usize,
|
||||
pixels: Vec<[u8; 3]>,
|
||||
}
|
||||
|
||||
impl Shot {
|
||||
pub(super) fn load(path: &std::path::Path) -> Result<Self, String> {
|
||||
let bytes = std::fs::read(path).map_err(|error| format!("读不动 {path:?}：{error}"))?;
|
||||
let image = image::load_from_memory(&bytes)
|
||||
.map_err(|error| format!("解 PNG 失败：{error}"))?
|
||||
.to_rgb8();
|
||||
let (width, height) = (image.width() as usize, image.height() as usize);
|
||||
Ok(Self {
|
||||
width,
|
||||
height,
|
||||
pixels: image.pixels().map(|p| p.0).collect(),
|
||||
})
|
||||
}
|
||||
|
||||
pub(super) fn at(&self, x: usize, y: usize) -> [u8; 3] {
|
||||
self.pixels[y * self.width + x]
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个外接框（闭区间）。
|
||||
#[derive(Debug, Clone, Copy)]
|
||||
pub(super) struct BBox {
|
||||
pub(super) left: usize,
|
||||
pub(super) right: usize,
|
||||
pub(super) top: usize,
|
||||
pub(super) bottom: usize,
|
||||
}
|
||||
|
||||
impl BBox {
|
||||
pub(super) fn new(x: usize, y: usize) -> Self {
|
||||
Self {
|
||||
left: x,
|
||||
right: x,
|
||||
top: y,
|
||||
bottom: y,
|
||||
}
|
||||
}
|
||||
|
||||
pub(super) fn include(&mut self, x: usize, y: usize) {
|
||||
self.left = self.left.min(x);
|
||||
self.right = self.right.max(x);
|
||||
self.top = self.top.min(y);
|
||||
self.bottom = self.bottom.max(y);
|
||||
}
|
||||
|
||||
pub(super) fn width(&self) -> usize {
|
||||
self.right - self.left + 1
|
||||
}
|
||||
|
||||
pub(super) fn height(&self) -> usize {
|
||||
self.bottom - self.top + 1
|
||||
}
|
||||
}
|
||||
|
||||
/// 尺寸容差 ±1（rubric §6 的默认容差：控件常落在半像素上，实测会多一行抗锯齿）。
|
||||
pub(super) fn near(value: usize, expected: usize) -> bool {
|
||||
value.abs_diff(expected) <= 1
|
||||
}
|
||||
|
||||
pub(super) fn dims(boxes: &[BBox]) -> String {
|
||||
boxes
|
||||
.iter()
|
||||
.map(|bbox| format!("{}×{}", bbox.width(), bbox.height()))
|
||||
.collect::<Vec<_>>()
|
||||
.join(", ")
|
||||
}
|
||||
|
||||
/// `pixel` 在「`under` → `fill`」这条混色线上的**覆盖率**（0..1；≥0.5 视为「算这块墨」）。
|
||||
///
|
||||
/// 投影到混色向量上取比例：抗锯齿像素正好落在 0..1 之间，另一种墨（文字、别的容器色）
|
||||
/// 会落在线的两侧偏远处，比例被夹到 0 或 1 之外 → 用「偏离线距离」再筛一道。
|
||||
pub(super) fn coverage(pixel: [u8; 3], fill: [u8; 3], under: [u8; 3]) -> f32 {
|
||||
let axis = [0, 1, 2].map(|i| f32::from(fill[i]) - f32::from(under[i]));
|
||||
let offset = [0, 1, 2].map(|i| f32::from(pixel[i]) - f32::from(under[i]));
|
||||
let square: f32 = axis.iter().map(|a| a * a).sum();
|
||||
if square <= f32::EPSILON {
|
||||
return 0.0;
|
||||
}
|
||||
let t: f32 = (0..3).map(|i| axis[i] * offset[i]).sum::<f32>() / square;
|
||||
let distance = (0..3)
|
||||
.map(|i| (offset[i] - t * axis[i]).powi(2))
|
||||
.sum::<f32>()
|
||||
.sqrt();
|
||||
// 8.0 而不是 16.0：深色填充（如 InverseSurface）与浅底之间的混色轴很长，深色**文字**
|
||||
// （OnSurfaceVariant）投影上去残差只有 ≈9 —— 16 的阈值会把文字行算成填充，于是 48 高的
|
||||
// 提示条被切成好几段（实测 46 + 1 + 1）。8.0 只排除文字，保留抗锯齿边（残差 0~3）。
|
||||
if distance > 8.0 {
|
||||
return 0.0;
|
||||
}
|
||||
t.clamp(0.0, 1.0)
|
||||
}
|
||||
|
||||
/// 第 `y` 行上所有「算 `fill` 那块墨」的连续段 `(起点, 长度)`。
|
||||
pub(super) fn runs(shot: &Shot, y: usize, fill: Color, under: Color) -> Vec<(usize, usize)> {
|
||||
let (ink, base) = (rgb(fill), rgb(under));
|
||||
let mut found = Vec::new();
|
||||
let mut start: Option<usize> = None;
|
||||
for x in 0..shot.width {
|
||||
let hit = coverage(shot.at(x, y), ink, base) >= 0.5;
|
||||
match (hit, start) {
|
||||
(true, None) => start = Some(x),
|
||||
(false, Some(from)) => {
|
||||
found.push((from, x - from));
|
||||
start = None;
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
if let Some(from) = start {
|
||||
found.push((from, shot.width - from));
|
||||
}
|
||||
found
|
||||
}
|
||||
|
||||
/// 一行里有多少「算 `fill` 那块墨」的像素（按覆盖率 ≥50% 判）。
|
||||
///
|
||||
/// 用**计数**而不是「最长段」：一条 344 宽的提示条，里面一行中文字会把它切成几段，
|
||||
/// 按最长段判会把中间那些行漏掉（实测 48 高被切成 6 + 6 两段）。
|
||||
pub(super) fn row_ink(shot: &Shot, y: usize, fill: Color, under: Color) -> usize {
|
||||
let (ink, base) = (rgb(fill), rgb(under));
|
||||
(0..shot.width)
|
||||
.filter(|x| coverage(shot.at(*x, y), ink, base) >= 0.5)
|
||||
.count()
|
||||
}
|
||||
|
||||
/// 连续行里「墨量 ≥ `min_ink`」的那些行 → 聚成**竖带** `(top, bottom)`。
|
||||
///
|
||||
/// 用途：一条 4px 的进度条在图上就是「4 个连续行、每行都有 ~320 个墨点」；
|
||||
/// 一个 48 高的提示条就是「48 个连续行」。比按精确色找 bbox 稳得多。
|
||||
pub(super) fn bands(shot: &Shot, fill: Color, under: Color, min_ink: usize) -> Vec<(usize, usize)> {
|
||||
let mut bands: Vec<(usize, usize)> = Vec::new();
|
||||
let mut current: Option<usize> = None;
|
||||
for y in 0..shot.height {
|
||||
let hit = row_ink(shot, y, fill, under) >= min_ink;
|
||||
match (hit, current) {
|
||||
(true, None) => current = Some(y),
|
||||
(false, Some(top)) => {
|
||||
bands.push((top, y - 1));
|
||||
current = None;
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
if let Some(top) = current {
|
||||
bands.push((top, shot.height - 1));
|
||||
}
|
||||
bands
|
||||
}
|
||||
|
||||
/// 竖带里最宽的一行的段长：取「每行最长连通段」的最大值。
|
||||
///
|
||||
/// 为什么要取最大而不是某一行：矩形控件上下有留白行（没文字），只有那几行量得到全宽；
|
||||
/// 文字会把中间行切成几段。两条同色矩形并排时，`runs` 分别返回各自的长段，所以也不会串。
|
||||
pub(super) fn band_width(shot: &Shot, band: (usize, usize), fill: Color, under: Color) -> usize {
|
||||
(band.0..=band.1)
|
||||
.map(|y| {
|
||||
runs(shot, y, fill, under)
|
||||
.into_iter()
|
||||
.map(|(_, len)| len)
|
||||
.max()
|
||||
.unwrap_or(0)
|
||||
})
|
||||
.max()
|
||||
.unwrap_or(0)
|
||||
}
|
||||
|
||||
/// 某种颜色的**精确色**连通块（只用于「找着一大块实心」这种粗定位）。
|
||||
pub(super) fn blobs(shot: &Shot, color: Color, min_side: usize) -> Vec<BBox> {
|
||||
let target = rgb(color);
|
||||
let mut seen = vec![false; shot.width * shot.height];
|
||||
let mut found = Vec::new();
|
||||
for y in 0..shot.height {
|
||||
for x in 0..shot.width {
|
||||
if seen[y * shot.width + x] || !matches(shot.at(x, y), target) {
|
||||
continue;
|
||||
}
|
||||
let mut stack = vec![(x, y)];
|
||||
seen[y * shot.width + x] = true;
|
||||
let mut bbox = BBox::new(x, y);
|
||||
while let Some((cx, cy)) = stack.pop() {
|
||||
bbox.include(cx, cy);
|
||||
for (nx, ny) in [
|
||||
(cx + 1, cy),
|
||||
(cx.saturating_sub(1), cy),
|
||||
(cx, cy + 1),
|
||||
(cx, cy.saturating_sub(1)),
|
||||
] {
|
||||
let inside = nx < shot.width && ny < shot.height;
|
||||
if inside && !seen[ny * shot.width + nx] && matches(shot.at(nx, ny), target) {
|
||||
seen[ny * shot.width + nx] = true;
|
||||
stack.push((nx, ny));
|
||||
}
|
||||
}
|
||||
}
|
||||
if bbox.width() >= min_side && bbox.height() >= min_side {
|
||||
found.push(bbox);
|
||||
}
|
||||
}
|
||||
}
|
||||
found
|
||||
}
|
||||
|
||||
/// 在 `bbox` 内找「最接近 `ink`（而不是 `under`）」的像素外接框（量文字/图标的内缩）。
|
||||
pub(super) fn ink_inside(
|
||||
shot: &Shot,
|
||||
bbox: &BBox,
|
||||
ink: Color,
|
||||
under: Color,
|
||||
margin: usize,
|
||||
) -> Option<BBox> {
|
||||
let (target, base) = (rgb(ink), rgb(under));
|
||||
let mut found: Option<BBox> = None;
|
||||
for y in (bbox.top + margin)..=(bbox.bottom.saturating_sub(margin)) {
|
||||
for x in (bbox.left + margin)..=(bbox.right.saturating_sub(margin)) {
|
||||
let pixel = shot.at(x, y);
|
||||
let to_ink = pixel
|
||||
.iter()
|
||||
.zip(target)
|
||||
.map(|(a, b)| u32::from(a.abs_diff(b)))
|
||||
.sum::<u32>();
|
||||
let to_base = pixel
|
||||
.iter()
|
||||
.zip(base)
|
||||
.map(|(a, b)| u32::from(a.abs_diff(b)))
|
||||
.sum::<u32>();
|
||||
if to_ink < to_base {
|
||||
match &mut found {
|
||||
Some(bbox) => bbox.include(x, y),
|
||||
None => found = Some(BBox::new(x, y)),
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
found
|
||||
}
|
||||
@@ -0,0 +1,342 @@
|
||||
//! 反馈家族的**渲染层**几何断言：对着真截图量像素（M68 的教训：纯函数对、图可能是错的）。
|
||||
//!
|
||||
//! 为什么住在 `feedback/` 而不是 `gallery/`：`gallery/feedback.rs` 只负责把矩阵摆进 harness，
|
||||
//! 断言加上去会把它顶到 400 行红线。像素工具在 [`super::pixel`]，环形与两个「面」的判据
|
||||
//! 拆在同级子模块 [`circular`] / [`panels`]（`inputs/probe/` 的同一先例）。
|
||||
//!
|
||||
//! ## 量什么（每条对一个具体错误，打红它的是「变异」那一列）
|
||||
//!
|
||||
//! | 类 | 判据 | 打红它的变异 |
|
||||
//! |---|---|---|
|
||||
//! | 线性厚度 / 圆角 | 轨道带**恰好 4 行**；条的四角**透出底色** | 厚度 4→6 / `Full`→`None` |
|
||||
//! | 线性不定态 | phase 0.55 列必须**数出两段**（P1-A 回归） | 段不排序（旧实现：两段压成一段） |
|
||||
//! | 环形 | 环 40 且四角无墨（真圆） | 直径 40→48 |
|
||||
//! | Snackbar 宽上下限 | 宿主 800→**600**、368→**344**、324→**300**（无下限 G17-d） | 上限 600→560 |
|
||||
//! | Snackbar 高 | 单行带 **48** / 双行带 **68** | 48→40 |
|
||||
//! | Dialog 宽 / 内距 | 最宽行 **480**（在 280..560 内）· 标题墨迹左缩 **≈24**、顶缩 **≈26** | 480→488 / pad 24→16 |
|
||||
//! | 空态块 / 间距 / CTA | 块 **96×96** · 块↔标题 **≈16**+bearing · 条目总高 **≈232** · CTA **40** | 96→88 / spacing 双算回来 |
|
||||
//! | scrim | 一块 ≥700 宽的遮罩带，颜色 = 预合成实色 | 遮罩改成 surface |
|
||||
//!
|
||||
//! ## 复现（worktree 根目录；四个部分各一张图，浅/深各一轮）
|
||||
//!
|
||||
//! ```text
|
||||
//! for part in progress snackbar dialog empty; do
|
||||
//! ULL_GALLERY_SECTION=feedback ULL_FEEDBACK_PART=$part \
|
||||
//! ./target/debug/unlucky-launcher-iced --software-renderer --screen=gallery \
|
||||
//! --screenshot target/m78/$part-light.png --screenshot-theme=light
|
||||
//! ULL_FEEDBACK_PART=$part ULL_GALLERY_SHOT=target/m78/$part-light.png \
|
||||
//! cargo test -p unlucky-app-iced feedback::probe
|
||||
//! done
|
||||
//! ```
|
||||
|
||||
mod circular;
|
||||
mod panels;
|
||||
|
||||
use unlucky_design::color::{Role, SchemeFlavor};
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use super::geometry::PHASE_055;
|
||||
use super::pixel::{band_width, bands, matches, near, rgb, runs, shot_path, Shot};
|
||||
use crate::theme::{Families, Ui};
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
/// 第三条（phase 0.55）线性轨道的左缘与宽度（gallery 的宿主尺寸：页内边距 24 + 2×332）。
|
||||
const TRACK3_X0: usize = 688;
|
||||
/// 单条轨道宽（gallery 的 `TRACK_HOST`）。
|
||||
const TRACK3_W: usize = 320;
|
||||
|
||||
/// 一条测试覆盖当前截图对应的那一段（段由 `ULL_FEEDBACK_PART` 指定，默认 `all`）。
|
||||
#[test]
|
||||
fn feedback_geometry_matches_the_reference() {
|
||||
let Some(path) = shot_path() else {
|
||||
eprintln!(
|
||||
"[feedback-probe] SKIPPED：未设置 ULL_GALLERY_SHOT。这是**渲染层**几何断言，\
|
||||
需要先出图（命令见本文件模块文档，注意 ULL_GALLERY_SECTION=feedback + ULL_FEEDBACK_PART）。"
|
||||
);
|
||||
return;
|
||||
};
|
||||
let shot = Shot::load(&path).expect("读 feedback 截图");
|
||||
assert_eq!(
|
||||
(shot.width, shot.height),
|
||||
(1180, 760),
|
||||
"验收图必须 1180×760 @100% DPI"
|
||||
);
|
||||
|
||||
let flavor = if matches(
|
||||
shot.at(2, 2),
|
||||
rgb(ui(SchemeFlavor::Light).color(Role::Surface)),
|
||||
) {
|
||||
SchemeFlavor::Light
|
||||
} else {
|
||||
SchemeFlavor::Dark
|
||||
};
|
||||
let ui = ui(flavor);
|
||||
let part = std::env::var("ULL_FEEDBACK_PART").unwrap_or_else(|_| "all".to_owned());
|
||||
let part = part.trim().to_ascii_lowercase();
|
||||
|
||||
match part.as_str() {
|
||||
"progress" => {
|
||||
check_linear(&shot, &ui);
|
||||
circular::check(&shot, &ui);
|
||||
}
|
||||
"snackbar" => check_snackbar(&shot, &ui),
|
||||
"dialog" => panels::check_dialog(&shot, &ui),
|
||||
"empty" => panels::check_empty(&shot, &ui),
|
||||
other => {
|
||||
// 整屏时只查最不容易被折叠线切掉的那一类；分图才是逐项判据的场合。
|
||||
check_linear(&shot, &ui);
|
||||
eprintln!("[feedback-probe] part={other:?} 只查了 progress 那一类；其余请在分图里查");
|
||||
}
|
||||
}
|
||||
|
||||
eprintln!("[feedback-probe] OK flavor={flavor:?} part={part}");
|
||||
}
|
||||
|
||||
/// §12.1 + §12.4：线性厚度 / 圆角 / **不定态两段**。
|
||||
fn check_linear(shot: &Shot, ui: &Ui) {
|
||||
// 参考值写字面量（A1）：**不能**从 `LinearGeometry` 读回期望值——那样把 4 改成 6 之后
|
||||
// 「实测 6 == 期望 6」会照样绿，等于没有断言。
|
||||
let surface = ui.color(Role::Surface);
|
||||
let track = ui.color(Role::SecondaryContainer);
|
||||
let active = ui.color(Role::Primary);
|
||||
|
||||
// ---- 12.1 厚度：轨道带恰好 4 行（宿主 320 宽 ⇒ 每行 ~320 个轨道墨点）--------
|
||||
let bar_bands = bands(shot, track, surface, 300);
|
||||
assert!(
|
||||
!bar_bands.is_empty(),
|
||||
"没找到线性进度轨道（宿主宽 320，应有 ≥300 个墨点的行）"
|
||||
);
|
||||
for (top, bottom) in &bar_bands {
|
||||
let height = bottom - top + 1;
|
||||
assert!(
|
||||
near(height, 4),
|
||||
"12.1：线性进度厚必须 4（A1 Height；实测 {height} @ 行 {top}）"
|
||||
);
|
||||
}
|
||||
|
||||
// ---- 12.1 圆角 full：条的四角必须透出底色（直角会把角填满）------------------
|
||||
let (top, _) = bar_bands[0];
|
||||
let (left, len) = runs(shot, top + 1, track, surface)
|
||||
.into_iter()
|
||||
.find(|(_, len)| *len >= 300)
|
||||
.expect("轨道那一行必须有 ≥300 的长段");
|
||||
assert!(
|
||||
!matches(shot.at(left, top), rgb(track)),
|
||||
"12.1：圆角 full(2) 的左上角必须透出底色（直角会填满）"
|
||||
);
|
||||
assert!(
|
||||
matches(shot.at(left + len / 2, top + 1), rgb(track)),
|
||||
"条的中间必须有墨（否则是没画出来，不是圆角）"
|
||||
);
|
||||
|
||||
// ---- 12.4 不定态：phase 0.55 那一列必须**数出两段**（复审 P1-A 的回归断言）----
|
||||
//
|
||||
// 旧实现把两段按返回顺序铺 `FillPortion`（第一线在右、第二线在左），并且份额之和
|
||||
// 在某 34/100 相位上 >1，被 iced 归一 ⇒ 图上只剩一段 100px 的台阶（x 749..848）。
|
||||
let row = indeterminate_row(shot, active, surface);
|
||||
let found: Vec<(usize, usize)> = runs(shot, row, active, surface)
|
||||
.into_iter()
|
||||
.filter(|(start, len)| {
|
||||
*start >= TRACK3_X0 && start + len <= TRACK3_X0 + TRACK3_W + 2 && *len >= 8
|
||||
})
|
||||
.collect();
|
||||
assert_eq!(
|
||||
found.len(),
|
||||
2,
|
||||
"12.4：phase 0.55 必须是**两段**（P1-A 修完才成立），实测 {found:?} @ 行 {row}"
|
||||
);
|
||||
|
||||
// 期望位置与单测**共用同一个常量**（`geometry::PHASE_055`）：早先这里写 0.871、单测写
|
||||
// 0.860，实测 963 距 want_end 966.7 只剩 0.28px，靠容差活着（复审 B）。
|
||||
let expected = PHASE_055;
|
||||
for (index, (start, len)) in found.iter().enumerate() {
|
||||
let want_start = TRACK3_X0 as f32 + expected[index].0 * TRACK3_W as f32;
|
||||
let want_end = TRACK3_X0 as f32 + expected[index].1 * TRACK3_W as f32;
|
||||
assert!(
|
||||
(*start as f32 - want_start).abs() <= 4.0,
|
||||
"12.4 第 {} 段左端应在 {want_start:.1}（实测 {start}）",
|
||||
index + 1
|
||||
);
|
||||
assert!(
|
||||
((start + len) as f32 - want_end).abs() <= 4.0,
|
||||
"12.4 第 {} 段右端应在 {want_end:.1}（实测 {}）",
|
||||
index + 1,
|
||||
start + len
|
||||
);
|
||||
}
|
||||
|
||||
eprintln!(
|
||||
"[feedback-probe] progress：轨道带 {} 条（高 {:?}）· phase 0.55 两段 {found:?}",
|
||||
bar_bands.len(),
|
||||
bar_bands
|
||||
.iter()
|
||||
.map(|(top, bottom)| bottom - top + 1)
|
||||
.collect::<Vec<_>>(),
|
||||
);
|
||||
}
|
||||
|
||||
/// 线性不定态那一行的 y：主色墨迹在**第一条轨道**里出现、且不在确定态行的最上一组。
|
||||
///
|
||||
/// 不想硬编码坐标（gallery 一改间距就失准），所以按「主色横带 + 排除最高那条带」找。
|
||||
fn indeterminate_row(shot: &Shot, active: iced::Color, surface: iced::Color) -> usize {
|
||||
let found = bands(shot, active, surface, 20);
|
||||
assert!(
|
||||
found.len() >= 2,
|
||||
"至少要找到确定态行与不定态行两组主色横带，实测 {found:?}"
|
||||
);
|
||||
// 第一组是确定态（0% 无墨、50%/100% 有墨），第二组是不定态
|
||||
let (top, bottom) = found[1];
|
||||
(top + bottom) / 2
|
||||
}
|
||||
|
||||
/// §14：宽度上下限 + 单/双行高。
|
||||
fn check_snackbar(shot: &Shot, ui: &Ui) {
|
||||
// 参考值写字面量（A1）：600 = SnackbarKt.ContainerMaxWidth，48/68 = SnackbarTokens。
|
||||
let surface = ui.color(Role::Surface);
|
||||
let bar = ui.color(Role::InverseSurface);
|
||||
|
||||
// 行墨量下限 200：最窄的那条只有 300 宽，里面还有 ~60px 的文字 ⇒ 每行 ~240 个实心点。
|
||||
// 高度 ≥40 才算提示条（标题行偶有一两行落在这条混色线上，那类 1 行的带要滤掉）。
|
||||
let found: Vec<(usize, usize)> = bands(shot, bar, surface, 200)
|
||||
.into_iter()
|
||||
.filter(|(top, bottom)| bottom - top + 1 >= 40)
|
||||
.collect();
|
||||
assert!(
|
||||
found.len() >= 3,
|
||||
"14.x：应有 ≥3 条提示条（上限宽 / 双行 / 两条窄的），实测 {}",
|
||||
found.len()
|
||||
);
|
||||
|
||||
// 宽度集 = 每条带里最宽的那一行（留白行没有文字，量得到全宽）。
|
||||
let mut widths: Vec<usize> = found
|
||||
.iter()
|
||||
.map(|band| band_width(shot, *band, bar, surface))
|
||||
.collect();
|
||||
let mut heights: Vec<usize> = found.iter().map(|(top, bottom)| bottom - top + 1).collect();
|
||||
widths.sort_unstable();
|
||||
heights.sort_unstable();
|
||||
|
||||
assert!(
|
||||
!widths.iter().any(|w| *w > 601),
|
||||
"没有一条可以超过上限 600：实测 {widths:?}"
|
||||
);
|
||||
assert!(
|
||||
widths.iter().any(|w| near(*w, 600)),
|
||||
"上限宽必须是 600（SnackbarKt.ContainerMaxWidth，宿主 800 时夹取），实测宽度集 {widths:?}"
|
||||
);
|
||||
assert!(
|
||||
widths.iter().any(|w| near(*w, 344)),
|
||||
"宿区 368 那格必须量到 344（G17-d [估] 最小宽口径），实测 {widths:?}"
|
||||
);
|
||||
assert!(
|
||||
widths.iter().any(|w| near(*w, 300)),
|
||||
"宿区 324 那格必须量到 300（组件没有 min-width，G17-d），实测 {widths:?}"
|
||||
);
|
||||
assert!(
|
||||
heights.iter().any(|h| near(*h, 48)),
|
||||
"14.3：单行高 48，实测高度集 {heights:?}"
|
||||
);
|
||||
assert!(
|
||||
heights.iter().any(|h| near(*h, 68)),
|
||||
"14.3：双行高 68，实测高度集 {heights:?}"
|
||||
);
|
||||
|
||||
// 14.6 动作色：`InversePrimary` 必须出现在提示条内（不是按钮家族的 OnSurfaceVariant）
|
||||
let action = rgb(ui.color(Role::InversePrimary));
|
||||
let action_pixels: usize = (0..shot.height)
|
||||
.map(|y| {
|
||||
(0..shot.width)
|
||||
.filter(|x| matches(shot.at(*x, y), action))
|
||||
.count()
|
||||
})
|
||||
.sum();
|
||||
assert!(
|
||||
action_pixels > 40,
|
||||
"14.6：动作标签应是 InversePrimary（实测该色只有 {action_pixels} px）"
|
||||
);
|
||||
|
||||
// ---- 位置语义（复审 D）：两条 bottom 条的**条底距取景框底 = 12** ---------------
|
||||
//
|
||||
// 取景框是 gallery 给窄宿主画的 1px `OutlineVariant` 边（`framed_host`）：透明宿主没有
|
||||
// 可见底边时「贴底」在像素上不可证（旧宿主 72 = 48 + 2×12，上下留白相等）。
|
||||
let frame = rgb(ui.color(Role::OutlineVariant));
|
||||
let mut margins: Vec<usize> = Vec::new();
|
||||
for (top, bottom) in &found {
|
||||
let width = band_width(shot, (*top, *bottom), bar, surface);
|
||||
if !(near(width, 300) || near(width, 344)) {
|
||||
continue;
|
||||
}
|
||||
// 1px 描边常落在半像素上（两行各 ~50% 覆盖），精确色匹配抓不住 ⇒ 用「更靠近框色
|
||||
// 而不是画布」判。但条自身（深色）比画布**更接近**框色，所以还要一条：这一行的
|
||||
// 框色连续段必须**比条本身更宽**（框横贯整个宿主），否则会认成条自己（实测过：差值 1）。
|
||||
let distance = |pixel: [u8; 3], target: [u8; 3]| -> u32 {
|
||||
pixel
|
||||
.iter()
|
||||
.zip(target)
|
||||
.map(|(a, b)| u32::from(a.abs_diff(b)))
|
||||
.sum()
|
||||
};
|
||||
let surface_rgb = rgb(surface);
|
||||
let frame_run = |y: usize| -> usize {
|
||||
let mut longest = 0;
|
||||
let mut current = 0;
|
||||
for x in 0..shot.width {
|
||||
let pixel = shot.at(x, y);
|
||||
if distance(pixel, frame) < distance(pixel, surface_rgb) {
|
||||
current += 1;
|
||||
longest = longest.max(current);
|
||||
} else {
|
||||
current = 0;
|
||||
}
|
||||
}
|
||||
longest
|
||||
};
|
||||
// 框的横贯长度 > 条宽 + 10 ⇒ 只有框那一两行满足
|
||||
let is_frame_row = |y: usize| frame_run(y) >= width + 10;
|
||||
|
||||
let frame_row = ((bottom + 1)..shot.height)
|
||||
.find(|y| is_frame_row(*y))
|
||||
.unwrap_or_else(|| {
|
||||
panic!("D：窄条下方没找到宿主取景框（条 y {top}..{bottom}，宽 {width}）")
|
||||
});
|
||||
let frame_top_row = (0..*top)
|
||||
.rev()
|
||||
.find(|y| is_frame_row(*y))
|
||||
.unwrap_or_else(|| panic!("D：窄条上方没找到宿主取景框（条顶 y {top}）"));
|
||||
// 复审 P2-1：宿高回退到 72（上下留白相等）时这条会红。
|
||||
assert!(
|
||||
(*top as i64 - frame_top_row as i64 - 36).abs() <= 1,
|
||||
"D：贴底 ⇒ 框顶到条顶应为 36（96 − 48 − 12），实测 {}",
|
||||
*top as i64 - frame_top_row as i64
|
||||
);
|
||||
let frame_height = frame_row - frame_top_row + 1;
|
||||
assert!(
|
||||
frame_height.abs_diff(96) <= 1,
|
||||
"D：取景框高应 96（宿主高），实测 {frame_height}"
|
||||
);
|
||||
margins.push(frame_row - bottom);
|
||||
}
|
||||
assert!(
|
||||
!margins.is_empty(),
|
||||
"D：应至少量到一条 bottom 条的宿主边距，实测 {margins:?}"
|
||||
);
|
||||
for margin in &margins {
|
||||
assert!(
|
||||
near(*margin, 12),
|
||||
"D：贴底 ⇒ 条底距宿主底 12（官方外边距），实测 {margin}：{margins:?}"
|
||||
);
|
||||
}
|
||||
|
||||
eprintln!(
|
||||
"[feedback-probe] snackbar：宽度集 {widths:?} · 高度集 {heights:?} · InversePrimary {action_pixels}px · 底边距 {margins:?}"
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,158 @@
|
||||
//! 环形进度的渲染层判据（`probe` 的子模块，`inputs/probe/` 的同一先例）。
|
||||
//!
|
||||
//! ## 判据：六个**固定窗**逐个测存在性与尺寸
|
||||
//!
|
||||
//! gallery 里这一排环在**固定 x 栅格**上：左缘 `24 + 56·i`（环宽 40、间距 16），共 6 个
|
||||
//! （0% / 25% / 50% / 75% / 100% / ind 0.30）。判据是「每个窗里都必须有一圈
|
||||
//! **40(±2)×40(±2)** 的墨迹（轨道 ∪ 激活色的并集）」：
|
||||
//!
|
||||
//! - 少一个环 → 该窗没有墨迹 → 红；
|
||||
//! - 某个环被画小了（例如 20×20）→ 该窗墨迹的外接框变小 → 红；
|
||||
//! - 0% 那格只有轨道、没有激活色 → 用「并集」判，不把「没有激活色」当失败。
|
||||
//!
|
||||
//! 早先用「主色连通簇数」判（只要求非空）：把 5 个环涂掉仍然绿（复审 r3 P2-3 的反证），
|
||||
//! 所以 G18-i 的处置从「不修」改成**已用固定窗收口**。簇数仍在日志里打印供复核。
|
||||
//!
|
||||
//! 不定态的**节奏**（4 圈/周期、跨周期不跳变）不在这里量：那是时间的函数，截图只有一帧，
|
||||
//! 判据在 `tests/progress.rs::circular_indeterminate_rotation_is_four_turns_and_continuous`。
|
||||
//!
|
||||
//! 欠账 **G18-l**（登记不修）：`snackbar` 的「取景框」判据会把条自身的抗锯齿底行算成框
|
||||
//! （覆盖率 0.5008，余量 0.0008），方向是**误报**不是假绿；本轮给 snackbar 加了「框高 = 96」
|
||||
//! 之后触发概率下降，但那 0.0008 的余量仍在。
|
||||
|
||||
use iced::Color;
|
||||
|
||||
use super::super::pixel::{blobs, coverage, dims, rgb, BBox, Shot};
|
||||
use unlucky_design::color::Role;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
/// 环直径（A1 `CircularProgressIndicatorTokens.Size = 40`）。
|
||||
const DIAMETER: usize = 40;
|
||||
/// 环排栅格的左缘（页内边距 24）。
|
||||
const RING_X0: usize = 24;
|
||||
/// 栅格间距（40 环 + 16 = `Space::X4`）。
|
||||
const RING_PITCH: usize = 56;
|
||||
/// 窗数（0 / 25 / 50 / 75 / 100 / ind）。
|
||||
const RINGS: usize = 6;
|
||||
|
||||
/// 某个像素算不算「这块墨」（覆盖率 ≥50%，与 `pixel::runs` 同一口径）。
|
||||
fn is_ink(pixel: [u8; 3], fill: Color, under: Color) -> bool {
|
||||
coverage(pixel, rgb(fill), rgb(under)) >= 0.5
|
||||
}
|
||||
|
||||
/// 环形那一排的判据：逐窗测「有没有一圈 40×40 的墨迹」。
|
||||
pub(super) fn check(shot: &Shot, ui: &Ui) {
|
||||
let active = ui.color(Role::Primary);
|
||||
let track = ui.color(Role::SecondaryContainer);
|
||||
let surface = ui.color(Role::Surface);
|
||||
|
||||
// 环带的 y：以第一个窗（0% 环，只有轨道色）的**圆环签名**定位 —— 中间那几十行在窗的
|
||||
// 左右两侧都有墨迹；再向上/下各扩到「窗内还有墨」为止（把圆顶/圆底那两行收回来）。
|
||||
//
|
||||
// 为什么不按「每行墨点数 4..20」判：圆顶那一行笔画横跨 ~20~28 px，会落在区间外，
|
||||
// 按连续段会把 40 高的带子切成 32 行；为什么不按「首行..末行」：深色档里正文的抗锯齿
|
||||
// 像素也会落在轨道色的混色线上，跨度会扩到 274 行（两种都实测过）。
|
||||
let ink_count = |y: usize, from: usize, to: usize| -> usize {
|
||||
(from..to)
|
||||
.filter(|x| is_ink(shot.at(*x, y), track, surface))
|
||||
.count()
|
||||
};
|
||||
let left = RING_X0;
|
||||
let right = RING_X0 + DIAMETER;
|
||||
|
||||
// 环带 = 第一个窗里「有墨」的**连续行组**中、高度 ≈40 的那一组。
|
||||
//
|
||||
// 走过的两条弯路都实测过：
|
||||
// ①「每行墨点 4..20」→ 圆顶那一行笔画横跨 ~20~28 px，被排除，带子切成 32 行；
|
||||
// ②「左右两侧都有墨」→ 进度条那一行也满足（通栏），会认成 4 行高的假带。
|
||||
// 连续行组 + 高度窗口同时把「进度条」（4~5 行）与「正文行」排除在外。
|
||||
let mut runs: Vec<(usize, usize)> = Vec::new();
|
||||
let mut current: Option<(usize, usize)> = None;
|
||||
for y in 0..shot.height {
|
||||
match (ink_count(y, left, right) > 0, current) {
|
||||
(true, None) => current = Some((y, y)),
|
||||
(true, Some((top, _))) => current = Some((top, y)),
|
||||
(false, Some(run)) => {
|
||||
runs.push(run);
|
||||
current = None;
|
||||
}
|
||||
(false, None) => {}
|
||||
}
|
||||
}
|
||||
if let Some(run) = current {
|
||||
runs.push(run);
|
||||
}
|
||||
let (top, bottom) = runs
|
||||
.iter()
|
||||
.copied()
|
||||
.find(|(top, bottom)| (DIAMETER - 6..=DIAMETER + 6).contains(&(bottom - top + 1)))
|
||||
.unwrap_or_else(|| panic!("没找到高约 {DIAMETER} 的环形带；窗口 0 的连续行组：{runs:?}"));
|
||||
|
||||
let mut report = Vec::new();
|
||||
for index in 0..RINGS {
|
||||
let left = RING_X0 + RING_PITCH * index;
|
||||
let right = left + DIAMETER - 1;
|
||||
let mut ink: Option<BBox> = None;
|
||||
for y in top..=bottom {
|
||||
for x in left..=right {
|
||||
let pixel = shot.at(x, y);
|
||||
if is_ink(pixel, active, surface) || is_ink(pixel, track, surface) {
|
||||
match &mut ink {
|
||||
Some(found) => found.include(x, y),
|
||||
None => {
|
||||
ink = Some(BBox {
|
||||
left: x,
|
||||
right: x,
|
||||
top: y,
|
||||
bottom: y,
|
||||
})
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
let ink = ink.unwrap_or_else(|| {
|
||||
panic!("第 {index} 个窗（x {left}..{right}）里没有任何环墨迹：环丢了")
|
||||
});
|
||||
assert!(
|
||||
(DIAMETER - 2..=DIAMETER + 2).contains(&ink.width())
|
||||
&& (DIAMETER - 2..=DIAMETER + 2).contains(&ink.height()),
|
||||
"第 {index} 个窗（x {left}..{right}）里的环应 {DIAMETER}×{DIAMETER}(±2)，实测 {}×{}",
|
||||
ink.width(),
|
||||
ink.height()
|
||||
);
|
||||
assert!(
|
||||
ink.left >= left && ink.right <= right,
|
||||
"第 {index} 个窗的墨迹越界：{}..{} 不在 {left}..{right}",
|
||||
ink.left,
|
||||
ink.right
|
||||
);
|
||||
report.push(format!("{index}:{}×{}", ink.width(), ink.height()));
|
||||
}
|
||||
|
||||
// 激活色（弧）必须出现在 1.. 号窗里（0% 那格本来就只有轨道）。
|
||||
for index in 1..RINGS {
|
||||
let left = RING_X0 + RING_PITCH * index;
|
||||
let count: usize = (top..=bottom)
|
||||
.map(|y| {
|
||||
(left..left + DIAMETER)
|
||||
.filter(|x| is_ink(shot.at(*x, y), active, surface))
|
||||
.count()
|
||||
})
|
||||
.sum();
|
||||
assert!(
|
||||
count > 40,
|
||||
"第 {index} 个窗（x {left}..）的激活色弧只有 {count} px：环在但弧没画"
|
||||
);
|
||||
}
|
||||
|
||||
let clusters = blobs(shot, active, 10);
|
||||
eprintln!(
|
||||
"[feedback-probe] circular：固定窗 {RINGS} 个逐窗 [{ }]（y {top}..{bottom}）· \
|
||||
主色连通簇 {} 个（仅打印，判据是窗）",
|
||||
report.join(" / "),
|
||||
clusters.len()
|
||||
);
|
||||
let _ = dims(&clusters);
|
||||
}
|
||||
@@ -0,0 +1,315 @@
|
||||
//! 两个「面」的渲染层判据：Dialog（§7）与空态（§15）。`probe` 的子模块。
|
||||
//!
|
||||
//! ## Dialog 量什么
|
||||
//!
|
||||
//! - **逐卡宽度**：按列剖面把每张卡单独量出来（早先只量「最宽那张」，一宽一窄并排时会漏）；
|
||||
//! 本项目 480，窄宿主那格 360（`Dialog::width(360)`），且都必须落在官方 280..560 内；
|
||||
//! - 内距：标题墨迹左缩 ≈24、顶缩 24+bearing（24..=30）；
|
||||
//! - **动作色**：`Role::Primary` 的**精确色**命中数（复审 A：早先用「离谁更近」把标题/正文字形
|
||||
//! 也算成了 Primary —— 一张没有动作的卡也能"通过"）；并配两条反向证据：
|
||||
//! ①无动作的那张卡里精确 Primary 必须是 **0**；②有动作的那张卡下半区必须有字形行。
|
||||
//! - scrim：一块 ≥700 宽的遮罩带，色值 = 预合成实色。
|
||||
//!
|
||||
//! ## 空态量什么
|
||||
//!
|
||||
//! 图标块 96±2（1px 描边各吃 1 行）· 块↔标题 ≈16+bearing · 条目总高 ≈232 · CTA 40。
|
||||
//!
|
||||
//! 常量与 [`super::super::panel`] 里登记值对齐（480 / 280 / 96 / 232），动作色用**精确色**
|
||||
//! 而不是斜坡判据。
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::elevation::MaterialLayer;
|
||||
|
||||
use super::super::dialog::scrim;
|
||||
use super::super::empty_state::BLOCK_LAYER;
|
||||
use super::super::pixel::{band_width, bands, ink_inside, matches, near, rgb, BBox, Shot};
|
||||
use crate::theme::Ui;
|
||||
|
||||
/// Dialog 宽（本项目取值，官方区间 280..560 内）。
|
||||
const DIALOG_W: usize = 480;
|
||||
/// 窄宿主那格的宽（`Dialog::width(360)`）。
|
||||
const DIALOG_NARROW: usize = 360;
|
||||
/// 空态图标块边长。
|
||||
const BLOCK: usize = 96;
|
||||
/// 空态条目总高：96 块 + 16 + 32 标题 + 8 + 16 副文案 + 24 + 40 CTA。
|
||||
const EMPTY_TOTAL: usize = 232;
|
||||
/// 动作字形的精确色命中下限（实测 3 张有动作的卡合计 325 px）。
|
||||
const ACTION_INK_MIN: usize = 120;
|
||||
|
||||
/// §7：逐卡宽度 / 内距 / 动作色 / scrim。
|
||||
pub(super) fn check_dialog(shot: &Shot, ui: &Ui) {
|
||||
let surface = ui.color(Role::Surface);
|
||||
let card = ui.layer(MaterialLayer::Overlay);
|
||||
let primary = rgb(ui.color(Role::Primary));
|
||||
|
||||
// ---- 7.4 宽度：先分「卡带」（同排两张卡的 y 区间会重叠，所以只能按行分组），
|
||||
// 再在每条带里按**列剖面**分出每一张卡（复审 A/G：早先只量最宽的那张）。
|
||||
// 卡带用**精确色**数行（不用斜坡）：深色档里正文/描边的抗锯齿像素都落在
|
||||
// 「surface → card」那条很短的斜坡上，用斜坡会把整屏都算成卡带（实测出现 1180 宽的假卡）。
|
||||
let card_rgb = rgb(card);
|
||||
let scrim_rgb = rgb(scrim(ui));
|
||||
let card_rows: Vec<usize> = (0..shot.height)
|
||||
.filter(|y| {
|
||||
(0..shot.width)
|
||||
.filter(|x| {
|
||||
let pixel = shot.at(*x, *y);
|
||||
matches(pixel, card_rgb) && !matches(pixel, scrim_rgb)
|
||||
})
|
||||
.count()
|
||||
>= 200
|
||||
})
|
||||
.collect();
|
||||
let mut card_bands: Vec<(usize, usize)> = Vec::new();
|
||||
let mut start: Option<usize> = None;
|
||||
let mut previous: usize = 0;
|
||||
for y in card_rows {
|
||||
match start {
|
||||
None => {
|
||||
start = Some(y);
|
||||
previous = y;
|
||||
}
|
||||
Some(_) if y == previous + 1 => previous = y,
|
||||
Some(top) => {
|
||||
card_bands.push((top, previous));
|
||||
start = Some(y);
|
||||
previous = y;
|
||||
}
|
||||
}
|
||||
}
|
||||
if let Some(top) = start {
|
||||
card_bands.push((top, previous));
|
||||
}
|
||||
assert!(
|
||||
card_bands.len() >= 3,
|
||||
"至少要找到 3 条卡带（第一排两张 + 双动作 + scrim 里那张），实测 {card_bands:?}"
|
||||
);
|
||||
|
||||
// 每张卡记 (左缘, 宽)：宽度给「逐卡」断言，左缘给内距断言用（不能按单行找左缘——
|
||||
// 圆角 28 会让 band_top+4 那一行的卡片像素内缩 ~10px，实测内距被量成 12 而不是 24）。
|
||||
//
|
||||
// **深色档要把遮罩色排掉**：暗色下 `SurfaceContainerHigh` 与预合成 scrim 只差 ~35/通道，
|
||||
// 不排掉时 scrim 那片也被算成「卡」（实测出现 1180 宽的假卡）。
|
||||
let mut cards: Vec<(usize, usize)> = Vec::new();
|
||||
for band in &card_bands {
|
||||
let height = band.1 - band.0 + 1;
|
||||
let profile: Vec<usize> = (0..shot.width)
|
||||
.map(|x| {
|
||||
(band.0..=band.1)
|
||||
.filter(|y| {
|
||||
let pixel = shot.at(x, *y);
|
||||
matches(pixel, card_rgb) && !matches(pixel, scrim_rgb)
|
||||
})
|
||||
.count()
|
||||
})
|
||||
.collect();
|
||||
let mut start: Option<usize> = None;
|
||||
for (x, ink) in profile.iter().enumerate() {
|
||||
let column = *ink >= height / 3;
|
||||
match (column, start) {
|
||||
(true, None) => start = Some(x),
|
||||
(false, Some(from)) => {
|
||||
if x - from >= 280 {
|
||||
cards.push((from, x - from));
|
||||
}
|
||||
start = None;
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
if let Some(from) = start {
|
||||
if shot.width - from >= 280 {
|
||||
cards.push((from, shot.width - from));
|
||||
}
|
||||
}
|
||||
}
|
||||
let mut widths: Vec<usize> = cards.iter().map(|(_, width)| *width).collect();
|
||||
widths.sort_unstable();
|
||||
assert!(
|
||||
widths.iter().any(|w| near(*w, DIALOG_W)),
|
||||
"7.4：应有 {DIALOG_W} 宽的卡（G17-e 项目取值），实测逐卡宽度 {widths:?}"
|
||||
);
|
||||
assert!(
|
||||
widths.iter().any(|w| near(*w, DIALOG_NARROW)),
|
||||
"7.4：窄宿主那格应量到 {DIALOG_NARROW}（`Dialog::width(360)`，复审 E），实测 {widths:?}"
|
||||
);
|
||||
for width in &widths {
|
||||
assert!(
|
||||
(280..=560).contains(width),
|
||||
"7.4：每张卡都必须落在官方 280..560 内，实测 {width}：{widths:?}"
|
||||
);
|
||||
}
|
||||
|
||||
// 内距与 scrim 只在一张卡上量（第一张，最靠左上）。
|
||||
let first = card_bands[0];
|
||||
let (card_left, width) = cards[0];
|
||||
let top = first.0;
|
||||
let bottom = first.1;
|
||||
let bbox = BBox {
|
||||
left: card_left,
|
||||
right: card_left + width - 1,
|
||||
top,
|
||||
bottom,
|
||||
};
|
||||
let title =
|
||||
ink_inside(shot, &bbox, ui.color(Role::OnSurface), card, 2).expect("卡片里必须有标题墨迹");
|
||||
let inset = title.left.saturating_sub(card_left);
|
||||
assert!(
|
||||
(22..=28).contains(&inset),
|
||||
"7.3：四边内距 24 ⇒ 标题墨迹左缩 ≈24（含 bearing 22..28），实测 {inset}"
|
||||
);
|
||||
let top_inset = title.top.saturating_sub(top);
|
||||
assert!(
|
||||
(24..=30).contains(&top_inset),
|
||||
"7.3：上内距 24 ⇒ 标题墨迹顶缩 24+字形 bearing（24..30），实测 {top_inset}"
|
||||
);
|
||||
|
||||
// ---- 7.6 动作色（复审 A：换掉「离谁更近」那条会被标题字形顶账的判据）--------
|
||||
let exact_primary = |band: (usize, usize)| -> usize {
|
||||
(band.0..=band.1)
|
||||
.map(|y| {
|
||||
(0..shot.width)
|
||||
.filter(|x| matches(shot.at(*x, y), primary))
|
||||
.count()
|
||||
})
|
||||
.sum()
|
||||
};
|
||||
let action_pixels: usize = (0..shot.height)
|
||||
.map(|y| {
|
||||
(0..shot.width)
|
||||
.filter(|x| matches(shot.at(*x, y), primary))
|
||||
.count()
|
||||
})
|
||||
.sum();
|
||||
assert!(
|
||||
action_pixels >= ACTION_INK_MIN,
|
||||
"7.6：Dialog 动作标签应是 `Primary` 的**精确色**（实测只命中 {action_pixels} px；\
|
||||
改成 OnSurfaceVariant 就会掉到 0）"
|
||||
);
|
||||
|
||||
// 反向证据 ①：没有动作的那张卡（scrim 里那张）里精确 Primary 必须是 0 ——
|
||||
// 这条挡住「把标题/正文的深色字形算成 Primary」这条假绿路径。
|
||||
let quiet: Vec<(usize, usize)> = card_bands
|
||||
.iter()
|
||||
.copied()
|
||||
.filter(|band| exact_primary(*band) == 0)
|
||||
.collect();
|
||||
assert!(
|
||||
!quiet.is_empty(),
|
||||
"7.6：本屏应有一张**无动作**的卡（scrim 里那张）其精确 Primary 为 0，实测每带都有 Primary 墨迹"
|
||||
);
|
||||
|
||||
// 反向证据 ②：动作行确实存在 —— 命中最多的那条带下半区必须有字形行。
|
||||
let loud = card_bands
|
||||
.iter()
|
||||
.copied()
|
||||
.max_by_key(|band| exact_primary(*band))
|
||||
.expect("卡带非空");
|
||||
let half = loud.0 + (loud.1 - loud.0) / 2;
|
||||
let action_rows = (half..=loud.1)
|
||||
.filter(|y| {
|
||||
(0..shot.width)
|
||||
.filter(|x| matches(shot.at(*x, *y), primary))
|
||||
.count()
|
||||
>= 3
|
||||
})
|
||||
.count();
|
||||
assert!(
|
||||
action_rows >= 1,
|
||||
"7.6：动作字形必须在卡片下半区（实测下半区精确 Primary 行数 {action_rows}）"
|
||||
);
|
||||
|
||||
// ---- 7.7 scrim -------------------------------------------------------------
|
||||
let backdrop = scrim(ui);
|
||||
let scrim_bands = bands(shot, backdrop, surface, 700);
|
||||
assert!(
|
||||
!scrim_bands.is_empty(),
|
||||
"7.7：没找到 ≥700 宽的遮罩带（宿主 800 宽那格）"
|
||||
);
|
||||
|
||||
eprintln!(
|
||||
"[feedback-probe] dialog：逐卡宽度 {widths:?} · 标题左缩 {inset} · 顶缩 {top_inset} · \
|
||||
精确 Primary {action_pixels}px（无动作卡 {} 张）· 动作行 {action_rows} 行 · scrim 带 {} 条",
|
||||
quiet.len(),
|
||||
scrim_bands.len()
|
||||
);
|
||||
}
|
||||
|
||||
/// §15：图标块 96（`[估]`）+ 间距 16 / 8 / 24 + CTA 40。
|
||||
pub(super) fn check_empty(shot: &Shot, ui: &Ui) {
|
||||
let surface = ui.color(Role::Surface);
|
||||
let block = ui.layer(BLOCK_LAYER);
|
||||
|
||||
let found = bands(shot, block, surface, 40);
|
||||
let (top, bottom) = found
|
||||
.iter()
|
||||
.copied()
|
||||
.max_by_key(|(top, bottom)| bottom - top)
|
||||
.filter(|(top, bottom)| (BLOCK - 2..=BLOCK + 2).contains(&(bottom - top + 1)))
|
||||
.unwrap_or_else(|| {
|
||||
panic!(
|
||||
"15.1：没找到高 {BLOCK}(±2) 的图标块（`[估]` 项目自定值），实测量到的带：{found:?}"
|
||||
)
|
||||
});
|
||||
|
||||
let width = band_width(shot, (top, bottom), block, surface);
|
||||
assert!(
|
||||
(BLOCK - 2..=BLOCK + 2).contains(&width),
|
||||
"15.1：图标块必须 {BLOCK}(±2，1px 描边）宽，实测 {width}"
|
||||
);
|
||||
|
||||
// 图标本身：`view_at` 按 32 烘焙（stroke 同步重算），墨迹 ≈26~28。
|
||||
let glyph = ink_inside(
|
||||
shot,
|
||||
&BBox {
|
||||
left: 0,
|
||||
right: shot.width - 1,
|
||||
top,
|
||||
bottom,
|
||||
},
|
||||
ui.color(Role::OnSurfaceVariant),
|
||||
block,
|
||||
2,
|
||||
)
|
||||
.expect("块里必须有图标墨迹");
|
||||
assert!(
|
||||
(22..=34).contains(&glyph.width()) && (22..=34).contains(&glyph.height()),
|
||||
"15.1：图标墨迹应在 22..34（32 盒；`view` 时代只有 20×20），实测 {}×{}",
|
||||
glyph.width(),
|
||||
glyph.height()
|
||||
);
|
||||
|
||||
// ---- P2-1 回归：块↔标题的实际间距（16 而不是 32）---------------------------
|
||||
let bbox = BBox {
|
||||
left: 0,
|
||||
right: shot.width - 1,
|
||||
top: bottom + 1,
|
||||
bottom: shot.height - 1,
|
||||
};
|
||||
let title = ink_inside(shot, &bbox, ui.color(Role::OnSurface), surface, 0)
|
||||
.expect("块下面必须有标题墨迹");
|
||||
let gap = title.top.saturating_sub(bottom + 1);
|
||||
assert!(
|
||||
(16..=24).contains(&gap),
|
||||
"15.3：块↔标题应为 16（+ 字形 bearing），实测 {gap}（32 = spacing 与 gap 双算回来了）"
|
||||
);
|
||||
|
||||
let cta = bands(shot, ui.color(Role::Primary), surface, 20);
|
||||
let (cta_top, cta_bottom) = cta
|
||||
.iter()
|
||||
.copied()
|
||||
.find(|(top, bottom)| near(bottom - top + 1, 40))
|
||||
.unwrap_or_else(|| panic!("15.6：CTA 应是标准按钮（可见高 40），实测带 {cta:?}"));
|
||||
let total = cta_bottom + 1 - top;
|
||||
assert!(
|
||||
total.abs_diff(EMPTY_TOTAL) <= 6,
|
||||
"15.x：条目总高应 ≈{EMPTY_TOTAL}（96+16+32+8+16+24+40），实测 {total}"
|
||||
);
|
||||
|
||||
eprintln!(
|
||||
"[feedback-probe] empty：块 y {top}..{bottom}（高 {}）· 宽 {width} · 图标 {}×{} · \
|
||||
块↔标题 {gap} · 总高 {total} · CTA {cta_top}..{cta_bottom}",
|
||||
bottom - top + 1,
|
||||
glyph.width(),
|
||||
glyph.height()
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,308 @@
|
||||
//! 进度指示器（`research/12b` §12）：`linear` 与 `circular`，各有确定态与不定态。
|
||||
//!
|
||||
//! ## 两种形态、四种态
|
||||
//!
|
||||
//! | 形态 | 确定态 | 不定态 |
|
||||
//! |---|---|---|
|
||||
//! | [`linear`] | 轨道 `SecondaryContainer` + 指示条 `Primary`，厚 **4**、圆角 full | 官方 1750ms **双段**追逐（[`phase_segments`]） |
|
||||
//! | [`circular`] | 40 环 + 4 线宽，弧长 = 数值 × 360° | 官方 6000ms（弧长 0.1↔0.87 + 旋转 **0→1440°**：全局 1080° 线性 + 关键帧 360°，[`CircularGeometry::indeterminate`]） |
|
||||
//!
|
||||
//! ## 为什么不定态要调用方给 `phase`
|
||||
//!
|
||||
//! 契约 §2：组件不持有时钟。`phase`（0..1 的一个周期）由页面按 `Subscription` 推进；
|
||||
//! harness 因此能拍**确定**的中间帧（否则每张图都是抓阄）。周期时长在几何里
|
||||
//! （[`LinearGeometry::cycle_ms`] / [`CircularGeometry::cycle_ms`]），调用方按它换算。
|
||||
//!
|
||||
//! ## CPU 降级路径（D27）
|
||||
//!
|
||||
//! 本组件**零半透明、零模糊**：轨道/指示条都是不透明实色，环形是 `stroke` 实色。
|
||||
//! 波浪形态（线性振幅 3 / 波长 40，环形振幅 1.6 / 波长 15，`[源]`）**未实现**，
|
||||
//! 用直线段/等弧长替代——这是 `12b §12.4` 明确允许的登记项（见报告「偏离登记」）。
|
||||
//!
|
||||
//! ## 环形为什么手搓 SVG
|
||||
//!
|
||||
//! iced 的 `canvas` feature 没开（`Cargo.toml` 不归本 mission），而圆弧用容器边框画不出来。
|
||||
//! 令牌图标的做法（24 网格 SVG path + `currentColor` + 内容哈希缓存）同样适用于几何图元：
|
||||
//! 一份 handle 渲染两层（轨道一层、弧一层），相位不变时 iced 侧命中缓存。
|
||||
|
||||
use iced::border::Radius;
|
||||
use iced::widget::{container, row, svg, Space};
|
||||
use iced::{Background, Border, Element, Length};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::layout;
|
||||
use super::geometry::{phase_segments, CircularGeometry, LinearGeometry};
|
||||
|
||||
/// `FillPortion` 的比例分辨率：0..1 的占比 × 1000 取整（1/1000 像素级，够用且不溢出 u16）。
|
||||
const PORTIONS: f32 = 1000.0;
|
||||
|
||||
/// 弧长小于这个角度就不画激活层（圆头在 0 弧长上会画出一个点，看着像「已完成」）。
|
||||
const MIN_SWEEP_DEG: f32 = 1.0;
|
||||
|
||||
/// 100% 时弧首尾重合，`A` 命令画不出整圆 ⇒ 超过这个角度改画整环。
|
||||
const FULL_SWEEP_DEG: f32 = 359.9;
|
||||
|
||||
/// 进度的取值：确定（0..1）或不定（相位 0..1）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub enum Amount {
|
||||
/// 确定态：0..1。
|
||||
Determinate(f32),
|
||||
/// 不定态：一个周期内的相位（0..1，可越界，采样时按周期取模）。
|
||||
Indeterminate(f32),
|
||||
}
|
||||
|
||||
/// 一个进度指示器的取值（**不持有任何状态**）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct Progress {
|
||||
amount: Amount,
|
||||
}
|
||||
|
||||
impl Progress {
|
||||
/// 确定态：`value` 越界会被夹到 0..1（0% 只画轨道）。
|
||||
pub fn determinate(value: f32) -> Self {
|
||||
Self {
|
||||
amount: Amount::Determinate(value.clamp(0.0, 1.0)),
|
||||
}
|
||||
}
|
||||
|
||||
/// 不定态：`phase` 是周期内的相位（调用方按 `cycle_ms` 推进）。
|
||||
pub fn indeterminate(phase: f32) -> Self {
|
||||
Self {
|
||||
amount: Amount::Indeterminate(phase),
|
||||
}
|
||||
}
|
||||
|
||||
/// 取值（断言用；生产路径不读它，内部直接 match 字段）。
|
||||
#[cfg(test)]
|
||||
pub fn amount(self) -> Amount {
|
||||
self.amount
|
||||
}
|
||||
|
||||
/// 本帧要画的占轨道比例区间（0..1）。
|
||||
///
|
||||
/// 确定态 1 段、不定态 2 段（官方双线）；区间可能为空（相位在「两段都在屏幕外」的时刻），
|
||||
/// 调用方按 `end > start` 过滤。
|
||||
pub fn spans(self) -> Vec<(f32, f32)> {
|
||||
match self.amount {
|
||||
Amount::Determinate(value) => vec![(0.0, value.clamp(0.0, 1.0))],
|
||||
Amount::Indeterminate(phase) => phase_segments(phase).to_vec(),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 把 0..1 的区间**排序 + 合并重叠**，摊成「间隙 / 指示条」交替的列表（总长恒为 1.0）。
|
||||
///
|
||||
/// ## 为什么必须排序（复审 P1-A，视觉 r1 的 p1）
|
||||
///
|
||||
/// [`phase_segments`] 返回的两段**不保证有序**：第一线的前缘抢跑 250ms，所以它的区间在右，
|
||||
/// 第二线从 0 起跑的区间在左。照顺序铺 `FillPortion` 会把左段接到右段**之后**，并且
|
||||
/// `FillPortion` 之和一旦 ≠ 1000，iced 就按总和归一 —— 位置和宽度一起被压扁。
|
||||
/// 实测 phase 0.55：本应两段 `[0.003,0.079]` + `[0.355,0.860]`（x 689..713 / 802..963），
|
||||
/// 实际被画成一段 100px 的台阶（x 749..848），且 **34/100 个相位**上总和 >1（最大 1.99）。
|
||||
///
|
||||
/// 返回的每项是 `(是不是指示条, 占比)`；间隙项也显式给出来，才能断言「总和 = 1.0」。
|
||||
pub fn layout_spans(spans: &[(f32, f32)]) -> Vec<(bool, f32)> {
|
||||
let mut clipped: Vec<(f32, f32)> = spans
|
||||
.iter()
|
||||
.map(|(start, end)| (start.clamp(0.0, 1.0), end.clamp(0.0, 1.0)))
|
||||
.filter(|(start, end)| end > start)
|
||||
.collect();
|
||||
clipped.sort_by(|a, b| a.0.total_cmp(&b.0));
|
||||
|
||||
let mut merged: Vec<(f32, f32)> = Vec::new();
|
||||
for (start, end) in clipped {
|
||||
match merged.last_mut() {
|
||||
Some(last) if start <= last.1 => last.1 = last.1.max(end),
|
||||
_ => merged.push((start, end)),
|
||||
}
|
||||
}
|
||||
|
||||
let mut items = Vec::new();
|
||||
let mut cursor = 0.0_f32;
|
||||
for (start, end) in merged {
|
||||
if start > cursor {
|
||||
items.push((false, start - cursor));
|
||||
}
|
||||
items.push((true, end - start));
|
||||
cursor = end;
|
||||
}
|
||||
if cursor < 1.0 {
|
||||
items.push((false, 1.0 - cursor));
|
||||
}
|
||||
items
|
||||
}
|
||||
|
||||
/// 占比 → `FillPortion` 整数份额，**总和恒为 `PORTIONS`**（累计舍入，最后一项吃掉残差）。
|
||||
///
|
||||
/// 为什么不用「每项各自 round」：各项独立取整后总和可能是 999 或 1001，iced 按总和归一，
|
||||
/// 就又回到 P1-A 那个「整条被压扁」的坑。这里让每个**累计边界**取整，最后一项补足，
|
||||
/// 于是任意相位下份额之和都精确等于 1000。
|
||||
pub fn portion_shares(items: &[(bool, f32)]) -> Vec<(bool, u16)> {
|
||||
let mut shares = Vec::with_capacity(items.len());
|
||||
let mut accumulated = 0.0_f32;
|
||||
let mut previous = 0_u16;
|
||||
for (index, (is_bar, fraction)) in items.iter().enumerate() {
|
||||
accumulated += fraction;
|
||||
let target = if index + 1 == items.len() {
|
||||
PORTIONS as u16
|
||||
} else {
|
||||
(accumulated * PORTIONS).round() as u16
|
||||
};
|
||||
let share = target.saturating_sub(previous);
|
||||
previous = target;
|
||||
shares.push((*is_bar, share));
|
||||
}
|
||||
shares
|
||||
}
|
||||
|
||||
/// 线性进度条（轨道 + 指示条，厚 4、圆角 full）。
|
||||
///
|
||||
/// 轨道宽 `Fill`（由宿主决定），指示条按占比分到 `FillPortion` 上——**不需要知道轨道像素宽**，
|
||||
/// 所以 50% 在任何宿主宽度下都精确是半条。
|
||||
pub fn linear<'a, M: 'a>(ui: &'a Ui, progress: Progress) -> Element<'a, M> {
|
||||
let geometry = LinearGeometry::of(ui);
|
||||
let track_color = ui.color(Role::SecondaryContainer);
|
||||
let active_color = ui.color(Role::Primary);
|
||||
|
||||
let mut bar = row![]
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(geometry.thickness));
|
||||
for (is_bar, share) in portion_shares(&layout_spans(&progress.spans())) {
|
||||
if share == 0 {
|
||||
continue;
|
||||
}
|
||||
bar = bar.push(if is_bar {
|
||||
container(Space::new().width(Length::Fill).height(Length::Fill))
|
||||
.width(Length::FillPortion(share))
|
||||
.height(Length::Fill)
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(active_color)),
|
||||
border: Border {
|
||||
radius: Radius::new(geometry.radius),
|
||||
..Border::default()
|
||||
},
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
} else {
|
||||
spacer(share)
|
||||
});
|
||||
}
|
||||
|
||||
container(bar)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(geometry.thickness))
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(track_color)),
|
||||
border: Border {
|
||||
radius: Radius::new(geometry.radius),
|
||||
..Border::default()
|
||||
},
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 环形进度（40 直径 / 4 线宽；确定态画弧，不定态按官方节奏扫）。
|
||||
pub fn circular<'a, M: 'a>(ui: &'a Ui, progress: Progress) -> Element<'a, M> {
|
||||
let geometry = CircularGeometry::of(ui);
|
||||
let (sweep, rotation) = match progress.amount {
|
||||
Amount::Determinate(value) => (value.clamp(0.0, 1.0) * 360.0, 0.0),
|
||||
Amount::Indeterminate(phase) => {
|
||||
// 圈数直接乘 360（不做 rem_euclid）：每周期 4 圈是官方口径，截断就丢转速。
|
||||
let (sweep_fraction, turns) = geometry.indeterminate(phase);
|
||||
(sweep_fraction * 360.0, turns * 360.0)
|
||||
}
|
||||
};
|
||||
|
||||
let track = glyph(
|
||||
&geometry,
|
||||
ring_source(&geometry),
|
||||
ui.color(Role::SecondaryContainer),
|
||||
);
|
||||
|
||||
// 0% 只画轨道（不画弧，也不画圆头小点）；100% 画整环（`A` 命令的首尾重合画不出整圆）
|
||||
let active = if sweep < MIN_SWEEP_DEG {
|
||||
None
|
||||
} else if sweep >= FULL_SWEEP_DEG {
|
||||
Some(glyph(
|
||||
&geometry,
|
||||
ring_source(&geometry),
|
||||
ui.color(Role::Primary),
|
||||
))
|
||||
} else {
|
||||
Some(glyph(
|
||||
&geometry,
|
||||
arc_source(&geometry, sweep, rotation),
|
||||
ui.color(Role::Primary),
|
||||
))
|
||||
};
|
||||
|
||||
let mut layers = vec![track];
|
||||
layers.extend(active);
|
||||
|
||||
// Q9 的同族：几何图元也必须落在**固定尺寸**的盒子里，否则 usvg 会按 Contain 撑满父级。
|
||||
layout::fixed(
|
||||
geometry.diameter,
|
||||
geometry.diameter,
|
||||
iced::widget::stack(layers),
|
||||
)
|
||||
}
|
||||
|
||||
/// 两段之间/两端的透明占位。
|
||||
fn spacer<'a, M: 'a>(share: u16) -> Element<'a, M> {
|
||||
Space::new()
|
||||
.width(Length::FillPortion(share))
|
||||
.height(Length::Fill)
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 一层几何图元（固定尺寸 + `currentColor` 上色）。
|
||||
fn glyph<'a, M: 'a>(
|
||||
geometry: &CircularGeometry,
|
||||
source: String,
|
||||
color: iced::Color,
|
||||
) -> Element<'a, M> {
|
||||
svg(svg::Handle::from_memory(source.into_bytes()))
|
||||
.width(Length::Fixed(geometry.diameter))
|
||||
.height(Length::Fixed(geometry.diameter))
|
||||
.style(move |_theme, _status| svg::Style { color: Some(color) })
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 整环（轨道用，也用作 100% 的激活层）。
|
||||
fn ring_source(geometry: &CircularGeometry) -> String {
|
||||
let (size, thickness) = (geometry.diameter, geometry.thickness);
|
||||
let center = size / 2.0;
|
||||
let radius = geometry.arc_radius();
|
||||
format!(
|
||||
"<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"{size}\" height=\"{size}\" \
|
||||
viewBox=\"0 0 {size} {size}\"><circle cx=\"{center}\" cy=\"{center}\" r=\"{radius}\" \
|
||||
fill=\"none\" stroke=\"currentColor\" stroke-width=\"{thickness}\"/></svg>"
|
||||
)
|
||||
}
|
||||
|
||||
/// 一段圆弧（`rotation` 起、扫 `sweep_deg`；0° = 12 点、顺时针 = M3 口径）。
|
||||
fn arc_source(geometry: &CircularGeometry, sweep_deg: f32, rotation_deg: f32) -> String {
|
||||
let (size, thickness) = (geometry.diameter, geometry.thickness);
|
||||
let center = size / 2.0;
|
||||
let radius = geometry.arc_radius();
|
||||
let (x0, y0) = point(center, radius, rotation_deg);
|
||||
let (x1, y1) = point(center, radius, rotation_deg + sweep_deg);
|
||||
let large = u8::from(sweep_deg > 180.0);
|
||||
format!(
|
||||
"<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"{size}\" height=\"{size}\" \
|
||||
viewBox=\"0 0 {size} {size}\"><path d=\"M {x0:.3} {y0:.3} A {radius} {radius} 0 \
|
||||
{large} 1 {x1:.3} {y1:.3}\" fill=\"none\" stroke=\"currentColor\" \
|
||||
stroke-width=\"{thickness}\" stroke-linecap=\"round\"/></svg>"
|
||||
)
|
||||
}
|
||||
|
||||
/// 极角（0° = 12 点，顺时针）→ 画布坐标（y 向下，所以向上取负）。
|
||||
fn point(center: f32, radius: f32, deg: f32) -> (f32, f32) {
|
||||
let rad = deg.to_radians();
|
||||
(center + radius * rad.sin(), center - radius * rad.cos())
|
||||
}
|
||||
@@ -0,0 +1,193 @@
|
||||
//! Snackbar（`research/12b` §14）：底/顶部提示条 + 动作 + 关闭。
|
||||
//!
|
||||
//! ## 官方值（`[源]` = A1，`SnackbarTokens` + `SnackbarKt`，`javap` 核对）
|
||||
//!
|
||||
//! | # | 项 | 值 | 落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 14.1 | 圆角 | **4**（`CornerExtraSmall`） | `Component::Snackbar.spec().shape` |
|
||||
//! | 14.2 | 容器色 | **`InverseSurface`**（高程 L3 是设计口头径，见下「不画阴影」） | [`Role::InverseSurface`] |
|
||||
//! | 14.3 | 高 | 单行 **48** / 双行 **68** | [`SnackbarGeometry::height`] |
|
||||
//! | 14.4 | 内距 | 水平 **16** / 垂直 **6** / 文本↔动作 **8** | `Space::X4` / 6 / `Space::X2` |
|
||||
//! | 14.6 | 颜色 | 文本 `InverseOnSurface`、动作 **`InversePrimary`**、图标 24 `InverseOnSurface` | 组件层取角色 |
|
||||
//! | — | 宽度上限 | **600**（`SnackbarKt.ContainerMaxWidth`） | `max_width` |
|
||||
//!
|
||||
//! ## 宽度上下限（一条**真实**限制，登记 G17-d）
|
||||
//!
|
||||
//! 官方只有上限 600，没有下限常数；本项目取 **344 `[估]`**（M2 时代口径，观感连续）。
|
||||
//! iced 的 `Length` **没有 min-width**（与按钮家族 G15「最小宽 58 不施加」同一堵墙），
|
||||
//! 所以：**上限在组件里强制**（`container::max_width`），**下限由宿主保证**——页面给提示条
|
||||
//! 的区域至少 344 宽。gallery 用三个宿主宽度把这条限制摊开（300 → 300、344 → 344、800 → 600），
|
||||
//! 渲染层断言量的是这三种实测值，不假装下限被组件强制住了。
|
||||
//!
|
||||
//! ## 超时与 dismiss：状态归调用方
|
||||
//!
|
||||
//! 组件**不计时**：显示时长、自动消失、`on_timeout` 全在调用方（页面）手里。
|
||||
//! 组件的语义只有三条：`placement` 决定贴顶还是贴底（并给出 12 的外边距）、
|
||||
//! `action` 给一个文字动作、`dismiss` 给关闭键。消息要不要触发「撤销」由调用方决定。
|
||||
//!
|
||||
//! ## 不画阴影
|
||||
//!
|
||||
//! 官方是 L3，但 D27（CPU 档禁模糊）与令牌层 `ShadowSpec` 仍是 M63 占位值这两条都指向
|
||||
//! 「先不画」——层级靠 `InverseSurface` 与页面的 scrim/留白表达。登记为偏离 **D-4**
|
||||
//! （D-3 是进度条的波浪降级，别混号）。
|
||||
|
||||
use iced::widget::{container, row, text};
|
||||
use iced::{Alignment, Background, Border, Element, Length, Padding};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::interaction::Interaction;
|
||||
use super::action;
|
||||
use super::panel::SnackbarGeometry;
|
||||
|
||||
/// 贴底还是贴顶（官方两种都有；本项目默认贴底）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub enum Placement {
|
||||
/// 贴底（桌面默认：不挡页头，也不挡主操作）。
|
||||
Bottom,
|
||||
/// 贴顶（页头有刷新按钮时用于「结果在页头附近」的场景）。
|
||||
Top,
|
||||
}
|
||||
|
||||
impl Placement {
|
||||
/// 垂直对齐：贴底 = `End`，贴顶 = `Start`。
|
||||
fn vertical(self) -> Alignment {
|
||||
match self {
|
||||
Placement::Bottom => Alignment::End,
|
||||
Placement::Top => Alignment::Start,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 一条提示条的装配描述（**不持有任何状态所有权**）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct Snackbar<'a, M> {
|
||||
text: &'a str,
|
||||
lines: u8,
|
||||
placement: Placement,
|
||||
action: Option<(&'a str, M)>,
|
||||
dismiss: Option<M>,
|
||||
state: Option<Interaction>,
|
||||
}
|
||||
|
||||
impl<'a, M> Snackbar<'a, M> {
|
||||
/// 单行提示条（高 48）。
|
||||
pub fn new(text: &'a str) -> Self {
|
||||
Self {
|
||||
text,
|
||||
lines: 1,
|
||||
placement: Placement::Bottom,
|
||||
action: None,
|
||||
dismiss: None,
|
||||
state: None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 双行（高 68）。**行数由调用方声明**：iced 没有 `heightIn(min=…)`，官方那两条高度值
|
||||
/// 只能显式给（文本自己换行与否不改变容器高，这是 M3 的口径）。
|
||||
pub fn two_lines(mut self) -> Self {
|
||||
self.lines = 2;
|
||||
self
|
||||
}
|
||||
|
||||
/// 贴底 / 贴顶。
|
||||
pub fn placement(mut self, placement: Placement) -> Self {
|
||||
self.placement = placement;
|
||||
self
|
||||
}
|
||||
|
||||
/// 右侧文字动作（`InversePrimary`）。
|
||||
pub fn action(mut self, label: &'a str, on_press: M) -> Self {
|
||||
self.action = Some((label, on_press));
|
||||
self
|
||||
}
|
||||
|
||||
/// 关闭键（`InverseOnSurface`）。
|
||||
pub fn dismiss(mut self, on_press: M) -> Self {
|
||||
self.dismiss = Some(on_press);
|
||||
self
|
||||
}
|
||||
|
||||
/// 强制动作件的视觉态（gallery 取证用；运行期不要调）。
|
||||
pub fn state(mut self, state: Interaction) -> Self {
|
||||
self.state = Some(state);
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 画一条提示条。
|
||||
///
|
||||
/// 返回的元素是 **`Fill` 高度的容器**：贴底/贴顶由它内部的对齐决定，调用方只要给它一块
|
||||
/// 可用区（`stack` 在页面上、或 gallery 的宿主盒），它就是那个位置上的居中提示条。
|
||||
pub fn snackbar<'a, M: Clone + 'a>(ui: &'a Ui, spec: Snackbar<'a, M>) -> Element<'a, M> {
|
||||
let geometry = SnackbarGeometry::of(ui);
|
||||
let style = ui.style(TypeRole::BodyMedium);
|
||||
let height = geometry.height_for(spec.lines);
|
||||
let surface = ui.color(Role::InverseSurface);
|
||||
let radius = iced::border::Radius::new(geometry.radius);
|
||||
|
||||
let mut content = row![]
|
||||
.align_y(Alignment::Center)
|
||||
.spacing(geometry.gap)
|
||||
.push(
|
||||
text(spec.text)
|
||||
.size(style.size_px)
|
||||
.font(ui.font_of(style))
|
||||
.color(ui.color(Role::InverseOnSurface))
|
||||
.width(Length::Fill),
|
||||
);
|
||||
|
||||
if let Some((label, message)) = spec.action {
|
||||
content = content.push(action::text_action(
|
||||
ui,
|
||||
label,
|
||||
Role::InversePrimary,
|
||||
Role::InverseSurface,
|
||||
Some(message),
|
||||
spec.state,
|
||||
));
|
||||
}
|
||||
|
||||
if let Some(message) = spec.dismiss {
|
||||
content = content.push(action::icon_action(
|
||||
ui,
|
||||
IconKind::Close,
|
||||
Role::InverseOnSurface,
|
||||
Role::InverseSurface,
|
||||
Some(message),
|
||||
spec.state,
|
||||
));
|
||||
}
|
||||
|
||||
let bar = container(content)
|
||||
.width(Length::Fill)
|
||||
.max_width(geometry.max_width)
|
||||
.height(Length::Fixed(height))
|
||||
.padding(Padding {
|
||||
top: geometry.pad_v,
|
||||
right: geometry.pad_h,
|
||||
bottom: geometry.pad_v,
|
||||
left: geometry.pad_h,
|
||||
})
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(surface)),
|
||||
border: Border {
|
||||
radius,
|
||||
..Border::default()
|
||||
},
|
||||
..container::Style::default()
|
||||
});
|
||||
|
||||
// 位置层：`Fill` 高度 + 外边距 12 + 水平居中；贴底/贴顶只改 `align_y`（Q8：不用 center_*）。
|
||||
container(bar)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fill)
|
||||
.padding(Padding::from(geometry.margin))
|
||||
.align_x(Alignment::Center)
|
||||
.align_y(spec.placement.vertical())
|
||||
.into()
|
||||
}
|
||||
@@ -0,0 +1,223 @@
|
||||
//! 纯函数级断言：几何对令牌、节奏对 A1、角色对变体。
|
||||
//!
|
||||
//! 这里**只测数值与结构**（M68 的教训：函数对不代表图对）。对着真截图量像素的是
|
||||
//! [`super::probe`]，两者缺一不可——本文件保证「数字对」，probe 保证「画出来是那个数字」。
|
||||
|
||||
use iced::Element;
|
||||
|
||||
use unlucky_design::color::{Role, Scheme, SchemeFlavor, SCRIM_ALPHA};
|
||||
use unlucky_design::elevation::MaterialLayer;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::{to_iced, Families, Ui};
|
||||
|
||||
use super::super::interaction::{self, Interaction};
|
||||
use super::dialog::scrim;
|
||||
use super::panel::{DialogGeometry, EmptyStateGeometry, SnackbarGeometry};
|
||||
use super::progress::Progress;
|
||||
use super::snackbar::{Placement, Snackbar};
|
||||
use super::{circular, dialog, empty_state, linear, snackbar, Dialog, EmptyState};
|
||||
|
||||
mod progress;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
pub(super) fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
// ---- §14 Snackbar -----------------------------------------------------------
|
||||
|
||||
/// 14.3 / 14.1 / 宽度上限：48 / 68 / 4 / 600。
|
||||
#[test]
|
||||
fn snackbar_heights_widths_and_radius_are_the_tokens() {
|
||||
let geometry = SnackbarGeometry::of(&ui(SchemeFlavor::Light));
|
||||
assert_eq!(geometry.height_for(1), 48.0, "14.3 单行 48");
|
||||
assert_eq!(geometry.height_for(2), 68.0, "14.3 双行 68");
|
||||
assert_eq!(geometry.radius, 4.0, "14.1 圆角 4（CornerExtraSmall）");
|
||||
assert_eq!(geometry.max_width, 600.0, "SnackbarKt.ContainerMaxWidth");
|
||||
assert_eq!(geometry.min_width, 344.0, "G17-d [估] 最小宽");
|
||||
assert!(geometry.min_width < geometry.max_width, "上下限必须有区间");
|
||||
assert_eq!(geometry.margin, 12.0, "G17-c [规格] 外边距 12");
|
||||
assert_eq!(geometry.pad_h, 16.0, "A1 HorizontalSpacing");
|
||||
assert_eq!(geometry.pad_v, 6.0, "A1 SnackbarVerticalPadding");
|
||||
}
|
||||
|
||||
// ---- §7 Dialog --------------------------------------------------------------
|
||||
|
||||
/// 7.4：官方区间 **280..560**，本项目取 **480**，且 480 落在区间内。
|
||||
#[test]
|
||||
fn dialog_geometry_sits_inside_the_official_bounds() {
|
||||
let geometry = DialogGeometry::of(&ui(SchemeFlavor::Light));
|
||||
assert_eq!(geometry.min_width, 280.0, "A1 DialogMinWidth");
|
||||
assert_eq!(geometry.max_width, 560.0, "A1 DialogMaxWidth");
|
||||
assert_eq!(geometry.width, 480.0, "G17-e 本项目取值");
|
||||
assert!(
|
||||
geometry.min_width <= geometry.width && geometry.width <= geometry.max_width,
|
||||
"自选宽必须落在官方区间内"
|
||||
);
|
||||
}
|
||||
|
||||
/// 复审 P2-2：`max(280)` 那条支以前一次都没被执行过（只有定义 + 一个调用点）。
|
||||
///
|
||||
/// 抓得住：有人把下限去掉（200 → 200）、或把 `min/max` 顺序写反（200 → 480 之外的值）。
|
||||
/// 抓不住：渲染时是否真的画了 280（那需要真窗口；gallery 的 360 那格由 probe 的逐卡宽度兜）。
|
||||
#[test]
|
||||
fn dialog_width_respects_the_official_minimum() {
|
||||
let geometry = DialogGeometry::of(&ui(SchemeFlavor::Light));
|
||||
assert_eq!(
|
||||
geometry.effective_width(200.0),
|
||||
280.0,
|
||||
"可用宽 200 → 仍画官方下限 280"
|
||||
);
|
||||
assert_eq!(geometry.effective_width(360.0), 360.0, "窄宿主取可用宽");
|
||||
assert_eq!(
|
||||
geometry.effective_width(800.0),
|
||||
480.0,
|
||||
"宽宿主夹到项目值 480"
|
||||
);
|
||||
}
|
||||
|
||||
/// 7.1 / 7.3 / 7.6：圆角 28、内距 24 / 16 / 24、动作 8 / 12。
|
||||
#[test]
|
||||
fn dialog_padding_and_action_gaps_are_the_tokens() {
|
||||
let geometry = DialogGeometry::of(&ui(SchemeFlavor::Light));
|
||||
assert_eq!(geometry.radius, 28.0, "7.1 CornerExtraLarge");
|
||||
assert_eq!(geometry.padding, 24.0, "7.3 DialogPadding");
|
||||
assert_eq!(geometry.title_gap, 16.0, "7.3 TitlePadding bottom");
|
||||
assert_eq!(geometry.body_gap, 24.0, "7.3 TextPadding bottom");
|
||||
assert_eq!(geometry.action_gap, 8.0, "7.6 ButtonsMainAxisSpacing");
|
||||
assert_eq!(geometry.action_cross, 12.0, "7.6 ButtonsCrossAxisSpacing");
|
||||
}
|
||||
|
||||
/// 7.7 + D27：scrim = 黑@0.32 叠在 canvas 上之后的**不透明**实色。
|
||||
#[test]
|
||||
fn scrim_is_scrimalpha_precomposited_onto_the_canvas() {
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let ui = ui(flavor);
|
||||
let scheme = Scheme::baseline(flavor);
|
||||
let canvas = scheme.get(MaterialLayer::Canvas.surface_role());
|
||||
let expected = to_iced(scheme.scrim().over(canvas));
|
||||
assert_eq!(
|
||||
scrim(&ui),
|
||||
expected,
|
||||
"{flavor:?}：scrim 必须逐位等于「黑@0.32 叠 canvas」"
|
||||
);
|
||||
assert_eq!(
|
||||
scrim(&ui).a,
|
||||
1.0,
|
||||
"D27：CPU 档不出现半透明（预合成后必须不透明）"
|
||||
);
|
||||
assert_ne!(
|
||||
scrim(&ui),
|
||||
ui.layer(MaterialLayer::Canvas),
|
||||
"遮罩必须与画布有可见差异"
|
||||
);
|
||||
assert!((SCRIM_ALPHA - 0.32).abs() < f32::EPSILON, "令牌口径 α=0.32");
|
||||
}
|
||||
}
|
||||
|
||||
// ---- §15 空态（项目自定） ----------------------------------------------------
|
||||
|
||||
/// 15.1：图标块 96 / 圆角 16 / 图标 32（**全部 `[估]`**，官方没有这个组件）。
|
||||
#[test]
|
||||
fn empty_state_geometry_is_the_project_defined_set() {
|
||||
let geometry = EmptyStateGeometry::of(&ui(SchemeFlavor::Light));
|
||||
assert_eq!(geometry.block, 96.0);
|
||||
assert_eq!(geometry.block_radius, 16.0, "ShapeScale::Large");
|
||||
// 复审 C：登记值 32（`IconSize::Empty`）。这条守「登记值 = 交给 `view_at` 的 px」——
|
||||
// 它抓不住「盒子 32 而 svg 仍钉 24」那种情况（那是渲染层的事，probe 量墨迹 22..34 兜）。
|
||||
assert_eq!(
|
||||
geometry.icon, 32.0,
|
||||
"盒内图标 32（`view_at` 按 32 烘焙 stroke）"
|
||||
);
|
||||
// **复审 P2-1 的回归断言**：三个间距必须精确等于令牌档位。
|
||||
// 早先这里只写 `> 0.0`，所以「Column::spacing(8) 与显式 gap(16/24) 双算成 32/40」
|
||||
// 完全藏得住（渲染实测 264 vs 登记 232）。
|
||||
assert_eq!(geometry.gap_title, 16.0, "块↔标题 = Space::X4");
|
||||
assert_eq!(geometry.gap_body, 8.0, "标题↔副文案 = Space::X2");
|
||||
assert_eq!(geometry.gap_action, 24.0, "副文案↔CTA = Space::X6");
|
||||
assert_eq!(geometry.block, 96.0);
|
||||
assert_eq!(
|
||||
super::empty_state::BLOCK_LAYER,
|
||||
MaterialLayer::Overlay,
|
||||
"块底色是 SurfaceContainerHigh（材质层 Overlay）"
|
||||
);
|
||||
}
|
||||
|
||||
// ---- 结构 / 角色 ------------------------------------------------------------
|
||||
|
||||
/// 五个入口都能在**任意**消息类型下构建（契约 §2：不 import `app::Message`）。
|
||||
#[test]
|
||||
fn every_component_builds_for_a_foreign_message_type() {
|
||||
#[derive(Clone, Debug, PartialEq)]
|
||||
enum Other {
|
||||
Yes,
|
||||
No,
|
||||
}
|
||||
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
let _: Element<'_, Other> = linear(&ui, Progress::determinate(0.5));
|
||||
let _: Element<'_, Other> = circular(&ui, Progress::indeterminate(0.3));
|
||||
let _: Element<'_, Other> = snackbar(
|
||||
&ui,
|
||||
Snackbar::new("已保存")
|
||||
.placement(Placement::Top)
|
||||
.two_lines()
|
||||
.action("撤销", Other::No)
|
||||
.dismiss(Other::No),
|
||||
);
|
||||
let _: Element<'_, Other> = dialog(
|
||||
&ui,
|
||||
Dialog::new("确认删除？", "此操作不可撤销。")
|
||||
.double(("取消", Other::No), ("删除", Other::Yes)),
|
||||
);
|
||||
let _: Element<'_, Other> = empty_state(
|
||||
&ui,
|
||||
EmptyState::new(
|
||||
unlucky_design::icons::IconKind::Instances,
|
||||
"还没有实例",
|
||||
"建一个开始游戏",
|
||||
)
|
||||
.action("新建", Other::Yes),
|
||||
);
|
||||
// 无动作的三种形态也要能构建（DialogActions::None / 无 action 的 Snackbar）
|
||||
let _: Element<'_, Other> = dialog(&ui, Dialog::new("已是最新版本", "没有可用更新。"));
|
||||
let _: Element<'_, Other> = snackbar(&ui, Snackbar::new("已复制"));
|
||||
let _: Element<'_, Other> = empty_state(
|
||||
&ui,
|
||||
EmptyState::new(
|
||||
unlucky_design::icons::IconKind::Logs,
|
||||
"没有日志",
|
||||
"启动一次游戏后这里会有内容",
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
/// 状态层必须来自 `interaction`（不是组件里自己乘 α）：hover 层不透明且与容器色不同。
|
||||
#[test]
|
||||
fn snackbar_state_layers_come_from_the_interaction_module() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
let hover = interaction::overlay_color(
|
||||
&ui,
|
||||
Interaction::Hovered,
|
||||
Role::InversePrimary,
|
||||
Role::InverseSurface,
|
||||
)
|
||||
.expect("hover 有状态层");
|
||||
assert_eq!(hover.a, 1.0, "状态层必须是实色（CPU/GPU 一致）");
|
||||
assert_ne!(
|
||||
hover,
|
||||
ui.color(Role::InverseSurface),
|
||||
"叠了 8% 必须看得出来"
|
||||
);
|
||||
|
||||
// 禁用内容走 token 口径（38%），不是「变灰一点」
|
||||
let disabled = interaction::disabled_content_over_role(&ui, Role::OnSurface, false);
|
||||
assert_ne!(disabled, ui.color(Role::OnSurface));
|
||||
assert_eq!(disabled.a, 1.0);
|
||||
}
|
||||
@@ -0,0 +1,281 @@
|
||||
//! 进度两式的纯函数断言（`tests` 的子模块，从 `tests.rs` 拆出来控行数）。
|
||||
//!
|
||||
//! 三条回归都住在这里：
|
||||
//! - [`raw_segments_are_unordered_and_layout_sorts_them`]：`phase_segments` 的原始输出**不有序**
|
||||
//! （视觉 r1 P1-A 就是把两段按顺序铺 `FillPortion`，图上被压成一段）；
|
||||
//! - [`portion_shares_always_sum_to_the_full_track`]：份额之和恒为 1000（旧实现 34/100 相位 >1）；
|
||||
//! - [`circular_indeterminate_rotation_is_four_turns_and_continuous`]：每周期 4 圈、跨周期不跳变
|
||||
//! （代码 r1 P1-B：旧实现只有 1 圈，且末尾倒跳 270°）。
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::shape::ShapeScale;
|
||||
|
||||
use super::super::geometry::{phase_segments, CircularGeometry, LinearGeometry, PHASE_055};
|
||||
use super::super::keyframes::{KeyPoint, Keyframes};
|
||||
use super::super::progress::{layout_spans, portion_shares, Amount, Progress};
|
||||
use super::ui;
|
||||
|
||||
// ---- §12 进度 ---------------------------------------------------------------
|
||||
|
||||
/// 12.1：线性厚度 **4**、圆角 full ⇒ 2（`ShapeScale::Full.radius_px(4)`）。
|
||||
#[test]
|
||||
fn linear_thickness_and_radius_come_from_the_tokens() {
|
||||
let geometry = LinearGeometry::of(&ui(SchemeFlavor::Light));
|
||||
assert_eq!(geometry.thickness, 4.0, "12.1 线性厚度 = 4（A1 Height）");
|
||||
assert_eq!(
|
||||
geometry.radius,
|
||||
ShapeScale::Full.radius_px(4.0),
|
||||
"12.1 圆角 full = 厚的一半"
|
||||
);
|
||||
assert_eq!(geometry.radius, 2.0);
|
||||
assert_eq!(
|
||||
geometry.cycle_ms, 1750,
|
||||
"不定态周期 = LinearAnimationDuration"
|
||||
);
|
||||
}
|
||||
|
||||
/// 12.3：环形 **40 / 4**，环中线半径 (40 − 4) / 2 = **18**。
|
||||
#[test]
|
||||
fn circular_geometry_matches_the_tokens() {
|
||||
let geometry = CircularGeometry::of(&ui(SchemeFlavor::Dark));
|
||||
assert_eq!(
|
||||
geometry.diameter, 40.0,
|
||||
"A1 CircularProgressIndicatorTokens.Size"
|
||||
);
|
||||
assert_eq!(geometry.thickness, 4.0, "A1 ActiveThickness");
|
||||
assert_eq!(geometry.radius, 20.0, "圆角 full = 直径的一半");
|
||||
assert_eq!(geometry.arc_radius(), 18.0);
|
||||
assert_eq!(
|
||||
geometry.cycle_ms, 6000,
|
||||
"A1 CircularAnimationProgressDuration"
|
||||
);
|
||||
}
|
||||
|
||||
/// 12.4：不定态两段**逐段非负**——这条只证「单段自身合法」，**不证两段的先后**
|
||||
/// （视觉 r1 P1-A 就是从这里漏过去的：函数名曾经叫 `..._stay_ordered`，其实没验排序）。
|
||||
#[test]
|
||||
fn indeterminate_segments_are_each_well_formed() {
|
||||
let mut travelled = false;
|
||||
let mut previous_end = 0.0;
|
||||
for step in 0..=200 {
|
||||
let phase = step as f32 / 200.0;
|
||||
for (start, end) in phase_segments(phase) {
|
||||
assert!(
|
||||
start <= end + f32::EPSILON,
|
||||
"相位 {phase:.3}：段起点 {start} 大于终点 {end}（前缘/后缘写反就会这样）"
|
||||
);
|
||||
assert!(
|
||||
(0.0..=1.0).contains(&start) && (0.0..=1.0).contains(&end),
|
||||
"相位 {phase:.3}：段越出轨道 {start}..{end}"
|
||||
);
|
||||
}
|
||||
let first = phase_segments(phase)[0].1;
|
||||
if phase > 0.0 && phase < 0.5 && first > previous_end {
|
||||
travelled = true;
|
||||
}
|
||||
previous_end = first;
|
||||
}
|
||||
assert!(travelled, "段前沿必须随相位右移（否则就是一根不动的条）");
|
||||
assert_eq!(phase_segments(0.0), [(0.0, 0.0), (0.0, 0.0)]);
|
||||
let (_, head) = phase_segments(1000.0 / 1750.0)[0];
|
||||
assert!((head - 1.0).abs() < 1.0e-5, "第一线前沿应在 1000ms 到 1.0");
|
||||
}
|
||||
|
||||
/// **复审 P1-A 的回归测试**：`phase_segments` 的原始输出**不有序**（第一线的前缘在右、第二线在左），
|
||||
/// 所以铺布局前必须排序 + 合并；排序后的两段位置要与 A1 keyframes 对得上。
|
||||
#[test]
|
||||
fn raw_segments_are_unordered_and_layout_sorts_them() {
|
||||
// 原始顺序：第一线（右，0.355..0.87）在前，第二线（左，0.003..0.079）在后
|
||||
let raw = phase_segments(0.55);
|
||||
assert!(
|
||||
raw[0].0 > raw[1].0,
|
||||
"phase 0.55 的原始两段应当是「右段在前、左段在后」，实际 {raw:?}"
|
||||
);
|
||||
|
||||
let laid = layout_spans(&raw);
|
||||
// 期望：间隙 / 左段 / 间隙 / 右段 / 间隙（5 项，总长 1.0）
|
||||
assert_eq!(laid.len(), 5, "两段应摊成 5 项：{laid:?}");
|
||||
assert!(!laid[0].0 && laid[1].0 && !laid[2].0 && laid[3].0 && !laid[4].0);
|
||||
let left = laid[1].1;
|
||||
let right = laid[3].1;
|
||||
let left_start: f32 = laid[0].1;
|
||||
let right_start: f32 = laid[0].1 + left + laid[2].1;
|
||||
// 期望值来自 `geometry::PHASE_055`——与渲染层探针**共用**（复审 B：早先两边差 0.011）
|
||||
let [(a0, a1), (b0, b1)] = PHASE_055;
|
||||
assert!(
|
||||
(left_start - a0).abs() < 0.01,
|
||||
"左段起点 {left_start} vs {a0}"
|
||||
);
|
||||
assert!(
|
||||
(left - (a1 - a0)).abs() < 0.01,
|
||||
"左段宽 {left} vs {}",
|
||||
a1 - a0
|
||||
);
|
||||
assert!(
|
||||
(right_start - b0).abs() < 0.01,
|
||||
"右段起点 {right_start} vs {b0}"
|
||||
);
|
||||
assert!(
|
||||
(right - (b1 - b0)).abs() < 0.01,
|
||||
"右段宽 {right} vs {}",
|
||||
b1 - b0
|
||||
);
|
||||
|
||||
let total: f32 = laid.iter().map(|(_, fraction)| fraction).sum();
|
||||
assert!(
|
||||
(total - 1.0).abs() < 1.0e-5,
|
||||
"铺开的占比之和必须 = 1.0，实测 {total}"
|
||||
);
|
||||
}
|
||||
|
||||
/// 任意相位下 `FillPortion` 份额之和**恒为 1000**（iced 按总和归一 ⇒ 不等于 1000 就会压扁）。
|
||||
///
|
||||
/// 复审 P1-A 的实测反例：旧实现 **34/100 个相位**总和 >1（最大 1.99）。
|
||||
#[test]
|
||||
fn portion_shares_always_sum_to_the_full_track() {
|
||||
for step in 0..=200 {
|
||||
let phase = step as f32 / 200.0;
|
||||
let items = layout_spans(&phase_segments(phase));
|
||||
let shares = portion_shares(&items);
|
||||
let total: u32 = shares.iter().map(|(_, share)| u32::from(*share)).sum();
|
||||
assert_eq!(total, 1000, "相位 {phase:.3} 的份额之和是 {total}");
|
||||
assert!(
|
||||
shares.iter().filter(|(is_bar, _)| *is_bar).count() <= 2,
|
||||
"最多两段指示条，相位 {phase:.3}"
|
||||
);
|
||||
// 指示条之间必须留间隙（除非两段相接，那时会被合并成一段）
|
||||
let mut previous_bar = false;
|
||||
for (is_bar, share) in &shares {
|
||||
if *is_bar && previous_bar && *share > 0 {
|
||||
panic!("相位 {phase:.3}：两段指示条相邻但没合并");
|
||||
}
|
||||
previous_bar = *is_bar;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 环形不定态：弧长在 0.1..0.87 之间（A1 min/max），旋转走满一圈。
|
||||
#[test]
|
||||
fn circular_indeterminate_sweeps_the_official_range() {
|
||||
let geometry = CircularGeometry::of(&ui(SchemeFlavor::Light));
|
||||
let mut min = f32::MAX;
|
||||
let mut max = f32::MIN;
|
||||
let mut rotation = f32::MIN;
|
||||
for step in 0..=600 {
|
||||
let (sweep, spin) = geometry.indeterminate(step as f32 / 600.0);
|
||||
min = min.min(sweep);
|
||||
max = max.max(sweep);
|
||||
rotation = rotation.max(spin);
|
||||
}
|
||||
assert!(
|
||||
(min - 0.1).abs() < 1.0e-3,
|
||||
"弧长下限 0.1（CircularIndeterminateMinProgress），实测 {min}"
|
||||
);
|
||||
assert!((max - 0.87).abs() < 1.0e-3, "弧长上限 0.87，实测 {max}");
|
||||
// P1-B：每周期 4 圈（1080° 全局 + 360° 关键帧），不是 1 圈
|
||||
assert!(
|
||||
(rotation - 4.0).abs() < 0.01,
|
||||
"旋转应走满 4 圈，实测 {rotation}"
|
||||
);
|
||||
}
|
||||
|
||||
/// **复审 P1-B 的回归测试**：环形不定态每周期 4 圈（官方 1440°），且跨周期**不跳变**。
|
||||
///
|
||||
/// 修之前：`ROTATION` 首点在 300ms/90°，且没有全局旋转 ⇒
|
||||
/// `turns(0.9999) = 1.0`、`turns(0.0) = 0.25`，跨周期差 0.75 圈 = **270° 瞬时倒跳**。
|
||||
#[test]
|
||||
fn circular_indeterminate_rotation_is_four_turns_and_continuous() {
|
||||
let geometry = CircularGeometry::of(&ui(SchemeFlavor::Light));
|
||||
|
||||
// 每周期 4 圈 = 1440°（1080° 全局 + 360° 关键帧）
|
||||
let start = geometry.indeterminate(0.0).1;
|
||||
let end = geometry.indeterminate(1.0 - 1.0e-6).1;
|
||||
assert!(
|
||||
((end - start) - 4.0).abs() < 1.0e-3,
|
||||
"每周期应为 4 圈（1440°），实测 {} 圈",
|
||||
end - start
|
||||
);
|
||||
|
||||
// 跨周期连续性：按「圈」取最短距离，必须 ≤ 一帧的位移（60fps ⇒ 4/60 ≈ 0.067 圈）
|
||||
let before = geometry.indeterminate(1.0 - 1.0e-4).1;
|
||||
let after = geometry.indeterminate(0.0).1;
|
||||
let mut jump = (before - after).rem_euclid(1.0);
|
||||
if jump > 0.5 {
|
||||
jump = 1.0 - jump;
|
||||
}
|
||||
assert!(
|
||||
jump <= 4.0 / 60.0,
|
||||
"跨周期旋转跳变 {jump} 圈（应 ≤ 4/60；修之前是 0.75 圈 = 270°）"
|
||||
);
|
||||
// 给报告用的一行实测数值（`--nocapture` 可见）：跨周期跳变 + 每周期圈数
|
||||
eprintln!(
|
||||
"[rotation] turns(0.9999)={before:.6} turns(0.0)={after:.6} 跳变={jump:.6} 圈（{:.2}°）· 每周期 {:.4} 圈 = {:.1}°",
|
||||
jump * 360.0,
|
||||
end - start,
|
||||
(end - start) * 360.0
|
||||
);
|
||||
|
||||
// 旋转必须单调（相位 0 → 1 逐帧不回退，按圈算）
|
||||
// 只扫 [0, 1) 的相位：phase == 1.0 就是下一周期的 0，回绕是**正常的**（mod 1 等价）。
|
||||
let mut previous = geometry.indeterminate(0.0).1;
|
||||
for step in 1..600 {
|
||||
let phase = step as f32 / 600.0;
|
||||
let current = geometry.indeterminate(phase).1;
|
||||
assert!(
|
||||
current >= previous - 1.0e-6,
|
||||
"相位 {phase:.3}：旋转从 {previous} 回退到 {current}"
|
||||
);
|
||||
previous = current;
|
||||
}
|
||||
}
|
||||
|
||||
/// 确定态：越界值夹到 0..1（0% 只画轨道，100% 画满）。
|
||||
#[test]
|
||||
fn determinate_values_are_clamped() {
|
||||
assert_eq!(
|
||||
Progress::determinate(1.5).amount(),
|
||||
Amount::Determinate(1.0)
|
||||
);
|
||||
assert_eq!(
|
||||
Progress::determinate(-2.0).amount(),
|
||||
Amount::Determinate(0.0)
|
||||
);
|
||||
assert_eq!(Progress::determinate(0.5).spans(), vec![(0.0, 0.5)]);
|
||||
assert_eq!(Progress::determinate(0.0).spans(), vec![(0.0, 0.0)]);
|
||||
}
|
||||
|
||||
/// keyframes 求值器：端点保持、相位循环、越界相位按周期取模。
|
||||
#[test]
|
||||
fn keyframes_hold_ends_and_wrap() {
|
||||
const LINE: Keyframes = Keyframes {
|
||||
cycle_ms: 1000,
|
||||
points: &[
|
||||
KeyPoint {
|
||||
ms: 250,
|
||||
value: 0.0,
|
||||
easing: unlucky_design::motion::Easing::Linear,
|
||||
},
|
||||
KeyPoint {
|
||||
ms: 750,
|
||||
value: 1.0,
|
||||
easing: unlucky_design::motion::Easing::Linear,
|
||||
},
|
||||
],
|
||||
};
|
||||
assert_eq!(LINE.sample(0.0), 0.0, "第一点之前保持首值");
|
||||
assert_eq!(LINE.sample(0.25), 0.0, "正好在第一点");
|
||||
assert!((LINE.sample(0.5) - 0.5).abs() < 1.0e-5, "中点线性插值");
|
||||
assert_eq!(LINE.sample(0.75), 1.0);
|
||||
assert_eq!(LINE.sample(0.9), 1.0, "最后一点之后保持末值");
|
||||
assert_eq!(LINE.sample(1.25), 0.0, "相位 1.25 = 0.25（循环）");
|
||||
assert_eq!(
|
||||
LINE.sample(-0.75),
|
||||
0.0,
|
||||
"负相位按周期折返：-0.75 → 0.25 相位 = 250ms = 首点"
|
||||
);
|
||||
assert!(
|
||||
(LINE.sample(-0.6) - 0.3).abs() < 1.0e-5,
|
||||
"-0.6 → 0.4 相位 = 400ms = 30%"
|
||||
);
|
||||
assert_eq!(LINE.sample(f32::NAN), 0.0, "NaN 不 panic，给首值");
|
||||
}
|
||||
@@ -0,0 +1,173 @@
|
||||
//! 按钮家族的状态矩阵（D30：浅/深 × 五态）。
|
||||
//!
|
||||
//! ## 矩阵形状
|
||||
//!
|
||||
//! ```text
|
||||
//! | enabled | hovered | pressed | focused | disabled |
|
||||
//! filled | [btn] | [btn] | [btn] | [btn] | [btn] |
|
||||
//! tonal | ... （下同）
|
||||
//! elevated |
|
||||
//! outlined |
|
||||
//! text |
|
||||
//! icon·standard | [ico] | ...
|
||||
//! icon·filled |
|
||||
//! icon·tonal |
|
||||
//! ```
|
||||
//!
|
||||
//! 40 个单元格共 5 列 × 8 行，一屏（1180×760）装不下，靠 `gallery/mod.rs` 的 scrollable 滚动；
|
||||
//! 截图取的是**整窗**，所以首屏能看到按钮家族的全部 5 行（图标行可能需要滚动，报告里会说明）。
|
||||
//!
|
||||
//! ## 为什么每格都强制状态
|
||||
//!
|
||||
//! iced 的 `button::Status` 只由**真实鼠标**驱动，截图时没法让 40 个按钮同时 hover。
|
||||
//! 组件层的 `Button::state(...)` 就是为这件事开的取证开关（`--force-state` 只能给整屏一种态）。
|
||||
//! 强制值**只影响画什么**，不动任何状态机——所以矩阵图里的五态与运行期五态逐像素同源。
|
||||
|
||||
use iced::widget::{column, row};
|
||||
use iced::{Element, Length};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::buttons::{self, Button, IconVariant, Variant};
|
||||
use super::super::interaction::Interaction;
|
||||
use super::{cell_width, heading, row_label, state_cells, DemoMessage};
|
||||
|
||||
/// 按钮家族整段（标题 + 列头 + 5 行文字按钮 + 3 行图标按钮 + 一条图例说明）。
|
||||
pub(super) fn section<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let legend = ui.style(TypeRole::BodySmall);
|
||||
|
||||
let mut rows = column![header_row(ui)].spacing(ui.space(Space::X2));
|
||||
|
||||
for variant in Variant::ALL {
|
||||
let cells = Interaction::ALL
|
||||
.iter()
|
||||
.map(|state| cell(ui, text_button(ui, variant, *state)))
|
||||
.collect::<Vec<_>>();
|
||||
|
||||
rows = rows.push(
|
||||
row![
|
||||
row_label(ui, variant.name()),
|
||||
row(cells).spacing(ui.space(Space::X2))
|
||||
]
|
||||
.spacing(ui.space(Space::X2)),
|
||||
);
|
||||
}
|
||||
|
||||
for variant in IconVariant::ALL {
|
||||
let cells = Interaction::ALL
|
||||
.iter()
|
||||
.map(|state| cell(ui, icon_button(ui, variant, *state)))
|
||||
.collect::<Vec<_>>();
|
||||
|
||||
rows = rows.push(
|
||||
row![
|
||||
row_label(ui, variant.name()),
|
||||
row(cells).spacing(ui.space(Space::X2))
|
||||
]
|
||||
.spacing(ui.space(Space::X2)),
|
||||
);
|
||||
}
|
||||
|
||||
column![
|
||||
heading(
|
||||
ui,
|
||||
"buttons · filled / tonal / elevated / outlined / text + icon",
|
||||
"12b §1/§2：高 40 · 圆角 full(20) · 内边距 24（带图标 16/24）· 图标 18 间距 8 · \
|
||||
hover 8% / focus 10% / pressed 10% / disabled 容器 10% 内容 38%"
|
||||
),
|
||||
rows,
|
||||
iced::widget::text(
|
||||
"图例：列 = 五态（focus 与 pressed 同 α 10%，看起来一样是规范要求）；\
|
||||
行 = 变体。虚线不表示任何东西，只是矩阵栅格。"
|
||||
)
|
||||
.size(legend.size_px)
|
||||
.font(ui.font_of(legend))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 列头（五态名）。
|
||||
fn header_row<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let style = ui.style(TypeRole::LabelSmall);
|
||||
let mut head = row![row_label(ui, "")].spacing(ui.space(Space::X2));
|
||||
|
||||
for (name, width) in state_cells(ui) {
|
||||
head = head.push(
|
||||
iced::widget::container(
|
||||
iced::widget::text(name)
|
||||
.size(style.size_px)
|
||||
.font(ui.font_of(style))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
)
|
||||
.width(Length::Fixed(width)),
|
||||
);
|
||||
}
|
||||
|
||||
head.into()
|
||||
}
|
||||
|
||||
/// 一个矩阵单元格（固定宽，内容左对齐；高度只由按钮自己决定）。
|
||||
fn cell<'a>(ui: &'a Ui, content: Element<'a, DemoMessage>) -> Element<'a, DemoMessage> {
|
||||
iced::widget::container(content)
|
||||
.width(Length::Fixed(cell_width(ui)))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 文字按钮的一格（强制成 `state`）。
|
||||
fn text_button<'a>(ui: &'a Ui, variant: Variant, state: Interaction) -> Element<'a, DemoMessage> {
|
||||
// 标签用变体名 + 首字母大写：图上要能一眼对上左栏，且不引入 i18n 依赖（gallery 不是产品页）
|
||||
let label = match variant {
|
||||
Variant::Filled => "Filled",
|
||||
Variant::Tonal => "Tonal",
|
||||
Variant::Elevated => "Elevated",
|
||||
Variant::Outlined => "Outlined",
|
||||
Variant::Text => "Text",
|
||||
};
|
||||
|
||||
// 五态共用**同一套**装配，只有「有没有消息」随禁用变：
|
||||
// 早先禁用格单独走 `Button::disabled(label)`，把前后图标一起丢了，于是 disabled 列看起来
|
||||
// 像另一个组件（视觉 reviewer P2-3）。
|
||||
let mut spec = if state.is_disabled() {
|
||||
Button::disabled(label)
|
||||
} else {
|
||||
Button::new(label, DemoMessage::Pressed(label))
|
||||
}
|
||||
.state(state);
|
||||
if variant != Variant::Text {
|
||||
// 两个样例都必须是**描边**字形：`Play` 是填充字形，和 `ChevronRight` 混在一颗按钮里
|
||||
// 会显得线宽不一致（视觉 reviewer P2-3）。主操作允许实心，但只能单独出现。
|
||||
spec = spec
|
||||
.leading(IconKind::Download)
|
||||
.trailing(IconKind::ChevronRight);
|
||||
}
|
||||
|
||||
match variant {
|
||||
Variant::Filled => buttons::filled(ui, spec),
|
||||
Variant::Tonal => buttons::tonal(ui, spec),
|
||||
Variant::Elevated => buttons::elevated(ui, spec),
|
||||
Variant::Outlined => buttons::outlined(ui, spec),
|
||||
Variant::Text => buttons::text(ui, spec),
|
||||
}
|
||||
}
|
||||
|
||||
/// 图标按钮的一格（强制成 `state`）。
|
||||
fn icon_button<'a>(
|
||||
ui: &'a Ui,
|
||||
variant: IconVariant,
|
||||
state: Interaction,
|
||||
) -> Element<'a, DemoMessage> {
|
||||
let press = if state.is_disabled() {
|
||||
None
|
||||
} else {
|
||||
Some(DemoMessage::Pressed(variant.name()))
|
||||
};
|
||||
|
||||
buttons::icon(ui, variant, IconKind::Settings, press, Some(state))
|
||||
}
|
||||
@@ -0,0 +1,365 @@
|
||||
//! gallery 里的反馈类小节：把状态矩阵摆进 harness（**断言不在这里**，在
|
||||
//! [`crate::app::components::feedback::probe`]）。
|
||||
//!
|
||||
//! ## 段落切分：`ULL_FEEDBACK_PART`（本文件自己的开关）
|
||||
//!
|
||||
//! `ULL_GALLERY_SECTION=feedback` 只能把**整个家族**拎出来，而四件的高度超过 1180×760 首屏，
|
||||
//! 所以再加一层**家族内**切分（契约 §9.2 的口径：环境变量 + 默认向后兼容 + 未识别的值回落
|
||||
//! 默认并打 stderr；区别只是它住在**本家族自己的文件**里，不动 `gallery/mod.rs`）：
|
||||
//!
|
||||
//! ```text
|
||||
//! ULL_FEEDBACK_PART=all # 默认：四件全渲染（progress → snackbar → empty → dialog）
|
||||
//! ULL_FEEDBACK_PART=progress # Linear 0/50/100 + 三相位 · Circular 0/25/50/75/100 + 不定态
|
||||
//! ULL_FEEDBACK_PART=snackbar # 四格：贴顶·上限宽 / 双行 / 宿主 300 / 宿主 344
|
||||
//! ULL_FEEDBACK_PART=dialog # 两形态并排 + 双动作 + 一屏 scrim
|
||||
//! ULL_FEEDBACK_PART=empty # 空态（带 CTA）
|
||||
//! ```
|
||||
//!
|
||||
//! ## 宿主尺寸为什么写死
|
||||
//!
|
||||
//! 量宽度必须有确定的宿主宽：`Snackbar` 的 600 是「宿主给 800 时的夹取值」、344 与 300 是
|
||||
//! 「宿主给多少就是多少」的反证（组件没有 min-width，G17-d）。`Linear` 轨道统一 320（一行 3 格 = 960 < 1128）。
|
||||
//!
|
||||
//! 复现（worktree 根目录）：
|
||||
//!
|
||||
//! ```text
|
||||
//! ULL_GALLERY_SECTION=feedback ULL_FEEDBACK_PART=progress ./target/debug/unlucky-launcher-iced \
|
||||
//! --software-renderer --screen=gallery \
|
||||
//! --screenshot target/m78/progress-light.png --screenshot-theme=light
|
||||
//! ULL_GALLERY_SHOT=target/m78/progress-light.png cargo test -p app-iced feedback::probe
|
||||
//! ```
|
||||
|
||||
use iced::widget::{column, container, row, text};
|
||||
use iced::{Element, Length};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::feedback::gallery_parts::{Part, DIALOG, EMPTY, PROGRESS, SNACKBAR};
|
||||
use super::super::feedback::{self, Dialog, EmptyState, Placement, Progress, Snackbar};
|
||||
use super::super::interaction::Interaction;
|
||||
use super::{heading, DemoMessage};
|
||||
|
||||
/// 线性进度的宿主宽（格宽，不是组件尺寸）。
|
||||
const TRACK_HOST: f32 = 320.0;
|
||||
/// `Snackbar` 的宿主宽：**条宽 + 2×12 外边距**（12 是官方外边距，组件的定位层会扣掉）。
|
||||
///
|
||||
/// 800（条夹到上限 600）/ 368（条 344）/ 324（条 300，用来证明**没有**下限，G17-d）。
|
||||
const HOST_WIDE: f32 = 800.0;
|
||||
const HOST_MIN: f32 = 368.0;
|
||||
const HOST_NARROW: f32 = 324.0;
|
||||
/// `Snackbar` 宿主高（比 68 + 2×12 略高，留出贴顶/贴底的判定余量）。
|
||||
const HOST_TALL: f32 = 96.0;
|
||||
/// 窄宿主：给 `Dialog::width` 递 360，量「窄宿主不再被裁」的那一格（复审 E）。
|
||||
const NARROW_HOST: f32 = 360.0;
|
||||
|
||||
/// 单行提示条的宿主高。
|
||||
///
|
||||
/// **96 而不是 72**（复审 D）：72 = 48 + 2×12 时上下外边距相等，像素上分不出「贴底」还是
|
||||
/// 「居中」；96 让贴底那格的上留白 = 36、下留白 = 12，探针能量到「条底距宿主底 = 12」。
|
||||
const HOST_SHORT: f32 = 96.0;
|
||||
/// 空态宿主高：内容本征高 ≈96+16+32+8+16+24+40 ≈ 232，留出上下各 40 的余量。
|
||||
const HOST_EMPTY: f32 = 320.0;
|
||||
|
||||
/// 反馈类家族的小节。
|
||||
pub(super) fn section<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let part = Part::from_env();
|
||||
part.log_once();
|
||||
|
||||
let mut body = column![heading(
|
||||
ui,
|
||||
"feedback · progress / snackbar / dialog / empty state",
|
||||
"12b §7/§12/§14/§15：Linear 厚 4 圆角 full · Circular 40/4 · Snackbar 48/68 上限宽 600 · \
|
||||
Dialog R28 pad24 宽 480 · EmptyState 项目自定[估]（官方无此组件）"
|
||||
)]
|
||||
.spacing(ui.space(Space::X3));
|
||||
|
||||
if part.has(PROGRESS) {
|
||||
body = body.push(progress_block(ui));
|
||||
}
|
||||
if part.has(SNACKBAR) {
|
||||
body = body.push(snackbar_block(ui));
|
||||
}
|
||||
if part.has(EMPTY) {
|
||||
body = body.push(empty_block(ui));
|
||||
}
|
||||
if part.has(DIALOG) {
|
||||
// 只有这一屏不画进度/提示条时，才把三形态与 scrim 都摆开（高度够）。
|
||||
let roomy = !part.has(PROGRESS) && !part.has(SNACKBAR);
|
||||
body = body.push(dialog_block(ui, roomy));
|
||||
}
|
||||
|
||||
body.into()
|
||||
}
|
||||
|
||||
/// 一行判据说明（`LabelSmall`，与矩阵的正文档分开）。
|
||||
fn caption<'a>(ui: &'a Ui, value: &'a str) -> Element<'a, DemoMessage> {
|
||||
let style = ui.style(TypeRole::LabelSmall);
|
||||
text(value)
|
||||
.size(style.size_px)
|
||||
.font(ui.font_of(style))
|
||||
.color(ui.color(Role::OnSurfaceVariant))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 带 1px 取景框的宿主：`Snackbar` 的贴底/贴顶需要一条**可见的宿主边界**才量得出来
|
||||
/// （描边画在盒内但**不参与布局**：内容区仍是整盒宽，实测条宽不受影响）。
|
||||
/// （透明宿主的底边在图上不存在，`Placement::Bottom` 就不可证）。
|
||||
fn framed_host<'a>(
|
||||
ui: &'a Ui,
|
||||
width: f32,
|
||||
height: f32,
|
||||
content: impl Into<Element<'a, DemoMessage>>,
|
||||
) -> Element<'a, DemoMessage> {
|
||||
let line = ui.color(Role::OutlineVariant);
|
||||
container(content)
|
||||
.width(Length::Fixed(width))
|
||||
.height(Length::Fixed(height))
|
||||
.style(move |_theme| container::Style {
|
||||
border: iced::Border {
|
||||
color: line,
|
||||
width: crate::theme::STROKE_PX,
|
||||
radius: iced::border::Radius::default(),
|
||||
},
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 固定宽宿主（量宽度用：宿主宽写死，组件内部的占比/夹取才有确定值）。
|
||||
fn host<'a>(
|
||||
width: f32,
|
||||
height: Option<f32>,
|
||||
content: impl Into<Element<'a, DemoMessage>>,
|
||||
) -> Element<'a, DemoMessage> {
|
||||
let mut box_ = container(content).width(Length::Fixed(width));
|
||||
if let Some(height) = height {
|
||||
box_ = box_.height(Length::Fixed(height));
|
||||
}
|
||||
box_.into()
|
||||
}
|
||||
|
||||
/// 一列：[进度条, 说明]。
|
||||
fn track<'a>(ui: &'a Ui, label: &'a str, progress: Progress) -> Element<'a, DemoMessage> {
|
||||
column![
|
||||
host(TRACK_HOST, None, feedback::linear(ui, progress)),
|
||||
caption(ui, label)
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 一列：[环, 说明]。
|
||||
fn ring<'a>(ui: &'a Ui, label: &'a str, progress: Progress) -> Element<'a, DemoMessage> {
|
||||
column![feedback::circular(ui, progress), caption(ui, label)]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// §12：Linear 0/50/100 + 四个相位；Circular 0/25/50/75/100 + 三个相位。
|
||||
fn progress_block<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let determinate = row![
|
||||
track(ui, "0%", Progress::determinate(0.0)),
|
||||
track(ui, "50%", Progress::determinate(0.5)),
|
||||
track(ui, "100%", Progress::determinate(1.0)),
|
||||
]
|
||||
.spacing(ui.space(Space::X3));
|
||||
|
||||
let indeterminate = row![
|
||||
track(ui, "phase 0.15", Progress::indeterminate(0.15)),
|
||||
track(ui, "phase 0.35", Progress::indeterminate(0.35)),
|
||||
track(ui, "phase 0.55", Progress::indeterminate(0.55)),
|
||||
]
|
||||
.spacing(ui.space(Space::X3));
|
||||
|
||||
let rings = row![
|
||||
ring(ui, "0%", Progress::determinate(0.0)),
|
||||
ring(ui, "25%", Progress::determinate(0.25)),
|
||||
ring(ui, "50%", Progress::determinate(0.5)),
|
||||
ring(ui, "75%", Progress::determinate(0.75)),
|
||||
ring(ui, "100%", Progress::determinate(1.0)),
|
||||
ring(ui, "ind 0.30", Progress::indeterminate(0.30)),
|
||||
]
|
||||
.spacing(ui.space(Space::X4))
|
||||
.align_y(iced::Alignment::Start);
|
||||
|
||||
column![
|
||||
caption(
|
||||
ui,
|
||||
"Linear · determinate 0% / 50% / 100%（轨道 SecondaryContainer · 指示条 Primary）"
|
||||
),
|
||||
determinate,
|
||||
caption(
|
||||
ui,
|
||||
"Linear · indeterminate（官方 1750ms 双段追逐；下面是同一周期的三个相位）"
|
||||
),
|
||||
indeterminate,
|
||||
caption(
|
||||
ui,
|
||||
"Circular · 直径 40 · 线宽 4 · 弧长 = 数值 × 360°（第六格 = 不定态 phase 0.30）"
|
||||
),
|
||||
rings,
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 提示条的宿主：固定宽 + 提示条宿主高（比 68 + 2×12 略高，贴顶/贴底都量得到）。
|
||||
fn bar_host<'a>(
|
||||
width: f32,
|
||||
content: impl Into<Element<'a, DemoMessage>>,
|
||||
) -> Element<'a, DemoMessage> {
|
||||
host(width, Some(HOST_TALL), content)
|
||||
}
|
||||
|
||||
/// §14：四格 —— 贴顶·上限宽 / 双行 + action + 关闭 / 宿主 300 / 宿主 344。
|
||||
fn snackbar_block<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let press = |id| DemoMessage::Pressed(id);
|
||||
|
||||
let wide = bar_host(
|
||||
HOST_WIDE,
|
||||
feedback::snackbar(
|
||||
ui,
|
||||
Snackbar::new("版本清单已刷新")
|
||||
.placement(Placement::Top)
|
||||
.dismiss(press("snackbar/wide")),
|
||||
),
|
||||
);
|
||||
let two_lines = host(
|
||||
HOST_WIDE,
|
||||
Some(HOST_TALL * 2.0),
|
||||
feedback::snackbar(
|
||||
ui,
|
||||
Snackbar::new(
|
||||
"启动失败：找不到 Java 21。请在「设置 · Java」里指定运行时路径，或让启动器自动下载一个 21 的运行时。",
|
||||
)
|
||||
.two_lines()
|
||||
.placement(Placement::Top)
|
||||
.action("去设置", press("snackbar/settings"))
|
||||
.dismiss(press("snackbar/close"))
|
||||
.state(Interaction::Hovered),
|
||||
),
|
||||
);
|
||||
let mid = framed_host(
|
||||
ui,
|
||||
HOST_MIN,
|
||||
HOST_SHORT,
|
||||
feedback::snackbar(
|
||||
ui,
|
||||
Snackbar::new("已删除实例")
|
||||
.placement(Placement::Bottom)
|
||||
.action("撤销", press("snackbar/undo")),
|
||||
),
|
||||
);
|
||||
let narrow = framed_host(
|
||||
ui,
|
||||
HOST_NARROW,
|
||||
HOST_SHORT,
|
||||
feedback::snackbar(ui, Snackbar::new("宿主 324").placement(Placement::Bottom)),
|
||||
);
|
||||
|
||||
column![
|
||||
caption(
|
||||
ui,
|
||||
"Snackbar · 贴顶 + 上限宽（宿主 800 → 夹到 600）· 关闭键 InverseOnSurface"
|
||||
),
|
||||
wide,
|
||||
caption(
|
||||
ui,
|
||||
"Snackbar · 双行 68 + action InversePrimary + 关闭键（动作强制 hover 态）"
|
||||
),
|
||||
two_lines,
|
||||
caption(
|
||||
ui,
|
||||
"宿主 324（取景框）⇒ 条 300：组件没有 min-width，宿主给多少就是多少（G17-d）；贴底 = 条底距框底 12"
|
||||
),
|
||||
narrow,
|
||||
caption(ui, "宿主 368 ⇒ 条 344：最小宽的取值口径（[估]）"),
|
||||
mid,
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// §15：空态（项目自定；浅/深两种主题各出一张图，主题来自 `--screenshot-theme`）。
|
||||
fn empty_block<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let press = |id| DemoMessage::Pressed(id);
|
||||
host(
|
||||
HOST_WIDE,
|
||||
Some(HOST_EMPTY),
|
||||
feedback::empty_state(
|
||||
ui,
|
||||
EmptyState::new(
|
||||
IconKind::Instances,
|
||||
"还没有任何实例",
|
||||
"建一个实例，或者从整合包导入。[项目自定 · 估]",
|
||||
)
|
||||
.action("新建实例", press("empty/create")),
|
||||
),
|
||||
)
|
||||
}
|
||||
|
||||
/// §7：三形态（无动作 / 单动作 / 双动作）+ 一屏 scrim。
|
||||
///
|
||||
/// `full = true` 表示**这一屏只渲染 dialog 段**（`ULL_FEEDBACK_PART=dialog` 或 `=empty` 之类
|
||||
/// 单独出图）：此时多摆一屏 scrim，并把三形态都摆开；全家族同屏时留高度给别的段。
|
||||
fn dialog_block<'a>(ui: &'a Ui, full: bool) -> Element<'a, DemoMessage> {
|
||||
let press = |id| DemoMessage::Pressed(id);
|
||||
|
||||
// 页面把自己的**可用宽**递给对话框（组件取 `min(可用宽, 480)`）——窄窗口时靠这一手，
|
||||
// 组件自己无法从宿主推（iced 的 Length 没有 min-width，见 `Dialog::width` 的说明）。
|
||||
let plain = feedback::dialog(
|
||||
ui,
|
||||
Dialog::new("已是最新版本", "当前没有可用更新。").width(HOST_WIDE),
|
||||
);
|
||||
let single = feedback::dialog(
|
||||
ui,
|
||||
Dialog::new("已导入整合包", "共 42 个模组，缺失 0 个。")
|
||||
.confirm("知道了", press("dialog/ok")),
|
||||
);
|
||||
// 窄宿主那格：可用宽 360 ⇒ `min(480, 360) = 360`，且不得低于官方下限 280。
|
||||
let narrow = feedback::dialog(
|
||||
ui,
|
||||
Dialog::new("窄宿主 360", "可用宽 360 时取 min(480, 360)。").width(NARROW_HOST),
|
||||
);
|
||||
// 强制 hover：动作件的状态层必须来自 `interaction`（不是组件里自己乘 8%）。
|
||||
let double = feedback::dialog(
|
||||
ui,
|
||||
Dialog::new("删除实例「1.20.1 生存」？", "存档与模组会一起删除。")
|
||||
.double(
|
||||
("取消", press("dialog/cancel")),
|
||||
("删除", press("dialog/delete")),
|
||||
)
|
||||
.state(Interaction::Hovered),
|
||||
);
|
||||
|
||||
let mut body = column![caption(
|
||||
ui,
|
||||
"Dialog · R28 · SurfaceContainerHigh + L3（**本项目不画阴影，见 D-1**）· pad 24（标题下 16 / 正文下 24）· 动作 Primary 间距 8",
|
||||
)]
|
||||
.spacing(ui.space(Space::X2));
|
||||
|
||||
body = body.push(row![plain, single].spacing(ui.space(Space::X6)));
|
||||
// 双动作 + 窄宿主并排：探针要同时量到 480 与 360 两种宽
|
||||
body = body.push(row![double, narrow].spacing(ui.space(Space::X6)));
|
||||
if full {
|
||||
body = body.push(caption(
|
||||
ui,
|
||||
"Dialog · scrim = 黑@0.32 叠 canvas 的实色（D27 预合成；详见 dialog.rs 模块文档）",
|
||||
));
|
||||
body = body.push(host(
|
||||
HOST_WIDE,
|
||||
Some(HOST_EMPTY),
|
||||
feedback::scrimmed(
|
||||
ui,
|
||||
feedback::dialog(ui, Dialog::new("已是最新版本", "当前没有可用更新。")),
|
||||
),
|
||||
));
|
||||
}
|
||||
|
||||
body.into()
|
||||
}
|
||||
@@ -0,0 +1,341 @@
|
||||
//! gallery 里的输入类小节（D30 的状态矩阵登记）：TextField / Search / Slider / Menu。
|
||||
//!
|
||||
//! ## 为什么分成四个 `part`
|
||||
//!
|
||||
//! 一整段（四组件 × 五态 × 两式）比 760 高的窗口还高，`--screen=gallery` 的截图只能看到顶部。
|
||||
//! 所以本文件把证据拆成四个自足的 `part`（[`text_field_part`] / [`search_part`] /
|
||||
//! [`slider_part`] / [`menu_part`]），[`section`] 按 D30 的顺序把它们竖排——
|
||||
//! 出图时用副本工程把 `section()` 换成单个 `part`（只调段序、不改组件代码，报告里有 diff 与说明）。
|
||||
//!
|
||||
//! ## 矩阵形状
|
||||
//!
|
||||
//! ```text
|
||||
//! TextField（两行 × 五态） 列 = enabled / hovered / pressed / focused / disabled
|
||||
//! filled | [字段] | ...
|
||||
//! outlined | [字段] | ...
|
||||
//! 另加三格：空 / 有值 / 错误（9.7 的判据要单独一眼）
|
||||
//!
|
||||
//! Search （五行 + 一个展开面板）
|
||||
//! Slider （五态一行 + 0% / 50% / 100% 三行 + 离散 4 段一行）
|
||||
//! Menu （五态各一项的一只菜单 + 一只「展开态」菜单：选中 / 分隔线 / 禁用）
|
||||
//! ```
|
||||
//!
|
||||
//! ## 每个格子都强制状态
|
||||
//!
|
||||
//! 与按钮家族同一个理由：截图时没法让 20 个控件同时 hover。`state(..)` 只是取证开关，
|
||||
//! 不动任何状态机——图上的五态与运行期五态同源。
|
||||
|
||||
use iced::widget::{column, container, row, text};
|
||||
use iced::{Element, Length};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::inputs::{
|
||||
self, Field, FieldVariant, Menu, MenuItem, SearchBar, SearchView, Slider,
|
||||
};
|
||||
use super::super::interaction::Interaction;
|
||||
use super::{cell_width, heading, row_label, state_cells, DemoMessage};
|
||||
|
||||
/// 演示消息（组件只认泛型，gallery 的映射在这里落地）。
|
||||
fn pressed(id: &'static str) -> DemoMessage {
|
||||
DemoMessage::Pressed(id)
|
||||
}
|
||||
|
||||
/// 输入类家族整段（四个 part 竖排；见模块文档的「为什么分成四个 part」）。
|
||||
pub(super) fn section<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
column![
|
||||
heading(
|
||||
ui,
|
||||
"inputs · text field / search / slider / menu",
|
||||
"12b §9/§11/§8 + 15 §20：TextField 高 56（无标签 40）· Search 条 56 药丸 + 图标可视边 16 \
|
||||
（= pad 12 + offset 4）· Slider 轨 16 + 竖条 4×44 · Menu 项 48 + L2 阴影"
|
||||
),
|
||||
text_field_part(ui),
|
||||
search_part(ui),
|
||||
slider_part(ui),
|
||||
menu_part(ui),
|
||||
]
|
||||
.spacing(ui.space(Space::X8))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 一行小字（图例/说明）。
|
||||
fn note<'a>(ui: &'a Ui, value: &'a str) -> Element<'a, DemoMessage> {
|
||||
let style = ui.style(TypeRole::BodySmall);
|
||||
text(value)
|
||||
.size(style.size_px)
|
||||
.font(ui.font_of(style))
|
||||
.color(ui.color(Role::OnSurfaceVariant))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 固定宽的矩阵格。
|
||||
fn cell<'a>(ui: &'a Ui, content: impl Into<Element<'a, DemoMessage>>) -> Element<'a, DemoMessage> {
|
||||
container(content)
|
||||
.width(Length::Fixed(cell_width(ui)))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 五态列头。
|
||||
fn state_header<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let style = ui.style(TypeRole::LabelSmall);
|
||||
let mut head = row![row_label(ui, "")].spacing(ui.space(Space::X2));
|
||||
for (name, width) in state_cells(ui) {
|
||||
head = head.push(
|
||||
container(
|
||||
text(name)
|
||||
.size(style.size_px)
|
||||
.font(ui.font_of(style))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
)
|
||||
.width(Length::Fixed(width)),
|
||||
);
|
||||
}
|
||||
head.into()
|
||||
}
|
||||
|
||||
/// 一行矩阵（左侧标签 + 五格）。
|
||||
fn state_row<'a>(
|
||||
ui: &'a Ui,
|
||||
label: &'a str,
|
||||
cells: Vec<Element<'a, DemoMessage>>,
|
||||
) -> Element<'a, DemoMessage> {
|
||||
row![
|
||||
row_label(ui, label),
|
||||
row(cells).spacing(ui.space(Space::X2))
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// TextField：两式 × 五态 + 空 / 有值 / 错误 三格。
|
||||
fn text_field_part<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let mut matrix = column![state_header(ui)].spacing(ui.space(Space::X2));
|
||||
|
||||
for variant in FieldVariant::ALL {
|
||||
let cells = Interaction::ALL
|
||||
.iter()
|
||||
.map(|state| {
|
||||
cell(
|
||||
ui,
|
||||
inputs::text_field(
|
||||
ui,
|
||||
Field::new("实例一")
|
||||
.variant(variant)
|
||||
.label("名称")
|
||||
.state(*state),
|
||||
|_| pressed("field"),
|
||||
),
|
||||
)
|
||||
})
|
||||
.collect::<Vec<_>>();
|
||||
matrix = matrix.push(state_row(ui, variant.name(), cells));
|
||||
}
|
||||
|
||||
// 三格用 **320** 宽（= 2 个矩阵格）：9.2 的最小宽 280 只在这里可验（矩阵格 160 更窄）
|
||||
let wide = Length::Fixed(cell_width(ui) * 2.0);
|
||||
let extras = row![
|
||||
inputs::text_field(
|
||||
ui,
|
||||
Field::new("")
|
||||
.label("名称")
|
||||
.placeholder("请输入名称")
|
||||
.width(wide),
|
||||
|_| pressed("field"),
|
||||
),
|
||||
inputs::text_field(
|
||||
ui,
|
||||
Field::new("1.21.4")
|
||||
.label("名称")
|
||||
.leading(IconKind::Folder)
|
||||
.width(wide),
|
||||
|_| pressed("field"),
|
||||
),
|
||||
inputs::text_field(
|
||||
ui,
|
||||
Field::new("")
|
||||
.variant(FieldVariant::Outlined)
|
||||
.label("名称")
|
||||
.placeholder("必填")
|
||||
.trailing(IconKind::Error)
|
||||
.supporting("该名称已被占用")
|
||||
.error()
|
||||
.width(wide),
|
||||
|_| pressed("field"),
|
||||
),
|
||||
]
|
||||
.spacing(ui.space(Space::X2));
|
||||
|
||||
column![
|
||||
note(
|
||||
ui,
|
||||
"列 = 五态 · 行 = 两式。静息指示线/描边 1px、聚焦与错误 2px（A1 FocusOutlineWidth）；\
|
||||
错误态线/标签/辅助文本全 Error"
|
||||
),
|
||||
matrix,
|
||||
note(
|
||||
ui,
|
||||
"另加：空（占位 OnSurfaceVariant）/ 有值（带前置图标 24）/ 错误（2px + 辅助文本）"
|
||||
),
|
||||
extras,
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// Search：五态 bar 竖排 + 一个展开的 docked 面板。
|
||||
fn search_part<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let bar_width = ui.space(Space::X8) * 12.0;
|
||||
let mut bars = column![].spacing(ui.space(Space::X2));
|
||||
for state in Interaction::ALL {
|
||||
let bar = inputs::search_bar(
|
||||
ui,
|
||||
SearchBar::new("")
|
||||
.placeholder("搜索实例 / 版本 / mod")
|
||||
.state(state)
|
||||
.width(Length::Fixed(bar_width)),
|
||||
|_| pressed("search"),
|
||||
);
|
||||
bars = bars.push(
|
||||
row![row_label(ui, state.name()), bar]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.align_y(iced::Alignment::Center),
|
||||
);
|
||||
}
|
||||
|
||||
let results: &[&str] = &[
|
||||
"实例：原版 1.21.4",
|
||||
"版本：Fabric 0.16.9",
|
||||
"mod：Sodium 0.6.5",
|
||||
];
|
||||
let view = inputs::search_view(
|
||||
ui,
|
||||
SearchView::new("1.21", results, "没有匹配的实例").placeholder("搜索实例 / 版本 / mod"),
|
||||
|_| pressed("search"),
|
||||
);
|
||||
|
||||
column![
|
||||
note(
|
||||
ui,
|
||||
"bar：高 56 · 圆角 full(28) · SurfaceContainerHigh · 图标可视边 16 = pad 12 + offset 4（M69 不变量）· \
|
||||
聚焦 1px Secondary；view：docked，头部 56 + 1px Outline 分隔 + 结果区最小高 240"
|
||||
),
|
||||
row![bars, view].spacing(ui.space(Space::X6)),
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// Slider：五态一行 + 0%/50%/100% 三行 + 离散 4 段一行。
|
||||
fn slider_part<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let cells = Interaction::ALL
|
||||
.iter()
|
||||
.map(|state| {
|
||||
let enabled = !state.is_disabled();
|
||||
let mut spec = Slider::new(ui, 0.5).state(*state);
|
||||
if enabled {
|
||||
spec = spec.on_change(|_| pressed("slider"));
|
||||
}
|
||||
cell(ui, inputs::slider(spec))
|
||||
})
|
||||
.collect::<Vec<_>>();
|
||||
|
||||
let track_width = ui.space(Space::X8) * 14.0;
|
||||
let mut values = column![].spacing(ui.space(Space::X2));
|
||||
for (label, fraction) in [("0%", 0.0), ("50%", 0.5), ("100%", 1.0)] {
|
||||
let spec = Slider::new(ui, fraction)
|
||||
.on_change(|_| pressed("slider"))
|
||||
.state(Interaction::Enabled);
|
||||
values = values.push(
|
||||
row![
|
||||
row_label(ui, label),
|
||||
container(inputs::slider(spec)).width(Length::Fixed(track_width)),
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.align_y(iced::Alignment::Center),
|
||||
);
|
||||
}
|
||||
|
||||
// 离散：4 段 = 3 个内部停靠点（25 / 50 / 75%），当前 25% ⇒ 能看到 50% 与 75% 两个点
|
||||
let discrete = row![
|
||||
row_label(ui, "离散 4"),
|
||||
container(inputs::slider(
|
||||
Slider::new(ui, 0.25)
|
||||
.steps(4)
|
||||
.on_change(|_| pressed("slider"))
|
||||
.state(Interaction::Enabled)
|
||||
))
|
||||
.width(Length::Fixed(track_width)),
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.align_y(iced::Alignment::Center);
|
||||
|
||||
column![
|
||||
note(
|
||||
ui,
|
||||
"轨 16 full（Primary / SecondaryContainer）· 竖条 4×44 full（overflow 上下各 14）· \
|
||||
focus/pressed 收窄到 2 · 命中 48 · 离散停靠点 4"
|
||||
),
|
||||
state_row(ui, "五态", cells),
|
||||
note(ui, "0% / 50% / 100%：竖条在两端贴边但不越界（左缘 = 轨道左缘，右缘 = 轨道右缘）"),
|
||||
values,
|
||||
note(
|
||||
ui,
|
||||
"离散：steps(4) ⇒ 3 个内部停靠点（25/50/75%），未激活轨在停靠点两侧留 6 空隙，\n 激活段只画到竖条中心",
|
||||
),
|
||||
discrete,
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// Menu：一只五态菜单 + 一只展开态菜单（选中 / 分组线 / 禁用）。
|
||||
fn menu_part<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let width = ui.space(Space::X8) * 8.0;
|
||||
|
||||
let mut states = Menu::new().width(Length::Fixed(width));
|
||||
for state in Interaction::ALL {
|
||||
let mut item = MenuItem::new("重命名", pressed("menu")).state(state);
|
||||
if state.is_disabled() {
|
||||
item = MenuItem::disabled("重命名").state(state);
|
||||
}
|
||||
states = states.item(item.leading(IconKind::Folder));
|
||||
}
|
||||
|
||||
let open = Menu::new()
|
||||
.width(Length::Fixed(width))
|
||||
.item(MenuItem::new("重命名", pressed("menu")).leading(IconKind::Folder))
|
||||
.item(
|
||||
MenuItem::new("复制实例", pressed("menu"))
|
||||
.leading(IconKind::Download)
|
||||
.trailing(IconKind::Check)
|
||||
.selected(),
|
||||
)
|
||||
.divider()
|
||||
.item(MenuItem::disabled("删除").leading(IconKind::Trash));
|
||||
|
||||
column![
|
||||
note(
|
||||
ui,
|
||||
"容器 SurfaceContainer + L2 阴影（blur 6 / offset 2 / Shadow 角色）· 圆角 4（令牌表）· \
|
||||
项高 48 · 水平 12 · 上下留白 8 · 选中项 SecondaryContainer 指示器内缩 4、圆角 8"
|
||||
),
|
||||
row![
|
||||
column![note(ui, "五态（每项强制一态）"), inputs::menu(ui, states)]
|
||||
.spacing(ui.space(Space::X2)),
|
||||
column![
|
||||
note(ui, "展开：含选中项 / 分组分隔线（复用 divider）/ 不可点项"),
|
||||
inputs::menu(ui, open)
|
||||
]
|
||||
.spacing(ui.space(Space::X2)),
|
||||
]
|
||||
.spacing(ui.space(Space::X6)),
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
@@ -0,0 +1,375 @@
|
||||
//! `--screen=gallery` 的壳：**视觉验收 harness**（D30 / D39 §5），不是产品页面。
|
||||
//!
|
||||
//! ## 它是什么、不是什么
|
||||
//!
|
||||
//! - 是：**状态矩阵的取景框**。每个家族在自己的 `gallery/<family>.rs` 里摆出
|
||||
//! 「五变体 × 五态」的矩阵，一张截图就能判完该家族（浅/深各一张 = 10 张证据）。
|
||||
//! - 不是：页面。gallery 允许堆叠、不分页、不做空态，**难看不算问题**；
|
||||
//! 但**每个组件本身**必须按官方口径做到位。
|
||||
//!
|
||||
//! ## 并行地基（后续四条线怎么加东西）
|
||||
//!
|
||||
//! 五个家族文件在下面 `mod` 里**全部预先声明**了，每个都有自己的 `section()`：
|
||||
//!
|
||||
//! ```text
|
||||
//! gallery/buttons.rs ← COMPBASE（本 mission）
|
||||
//! gallery/selection.rs ← 后续 mission（只改这个文件）
|
||||
//! gallery/inputs.rs ← 同上
|
||||
//! gallery/feedback.rs ← 同上
|
||||
//! gallery/navigation.rs ← 同上
|
||||
//! ```
|
||||
//!
|
||||
//! 加组件 = 只改自己那个文件里的 `section()`，**不用碰本文件**（这是「五条线并行不冲突」的
|
||||
//! 具体保证，也是 tower 会亲手验的一条）。
|
||||
//!
|
||||
//! ## DemoMessage 为什么独立
|
||||
//!
|
||||
//! 契约 §2：组件不 import `crate::app::Message`。gallery 用自己定义的消息枚举，
|
||||
//! 正好当「组件能脱离业务验收」的示范——`app.rs` 只做一次 `.map(Message::Demo)` 就接上了。
|
||||
//!
|
||||
//! ## 截图命令（D30）
|
||||
//!
|
||||
//! ```text
|
||||
//! unlucky-launcher-iced --software-renderer --screen=gallery \
|
||||
//! --screenshot out.png --screenshot-theme=light
|
||||
//! ```
|
||||
//!
|
||||
//! `--screenshot` 不带主题时**默认 Light**（可复现；见 `cli::Options::capture_flavor`）。
|
||||
//!
|
||||
//! ## 段落过滤：环境变量 `ULL_GALLERY_SECTION`（M76 起）
|
||||
//!
|
||||
//! 五段拼成一列、外面套 `scrollable`，而截图只截**首屏** `1180×760`。段数一多，后面的家族
|
||||
//! 就落到折叠线以下（实测：selection 段从 y≈735 起，只剩标题一行）——那条线的
|
||||
//! 「渲染层像素断言」就没有一个像素可量。所以这里加一个**段落选择器**：
|
||||
//!
|
||||
//! ```text
|
||||
//! ULL_GALLERY_SECTION=all # 默认：五段全渲染（行为与加开关之前逐像素一致）
|
||||
//! ULL_GALLERY_SECTION=buttons # 只渲染 buttons 段
|
||||
//! ULL_GALLERY_SECTION=selection # 只渲染 selection 段（本 mission 的取证与 probe 用它）
|
||||
//! ```
|
||||
//!
|
||||
//! 取值：`all` / `buttons` / `divider` / `selection` / `inputs` / `feedback` / `navigation`。
|
||||
//! 语义是「**不构建**没被选中的段」（不是构建后隐藏）：`column` 里根本不 push 它，
|
||||
//! 于是该家族的 `view` 一行都不跑。未识别的值**回落 `all`** 并在 stderr 打一行提示
|
||||
//! （静默回落会让人拿错图还以为拍的是那一段）。
|
||||
//!
|
||||
//! 为什么用环境变量而不是 `--screen=gallery:<family>`：`cli.rs` 不归组件线（M82 在改它），
|
||||
//! 而环境变量既能被测试（`cargo test` 里 `std::env::set_var`）又不用跟别人的 CLI 解析抢文件。
|
||||
//! 各家族的 `demo()` 签名**不因此改变**——本文件只决定「push 哪几段」。
|
||||
//!
|
||||
//! 实际渲染了哪几段会打一行 `[gallery] section=... → 渲染 ...`（首帧一次），
|
||||
//! 拿它当出图日志的证据。
|
||||
|
||||
use std::sync::atomic::{AtomicBool, Ordering};
|
||||
|
||||
use iced::widget::{column, container, scrollable, text};
|
||||
use iced::{Alignment, Background, Element, Length};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::elevation::MaterialLayer;
|
||||
use unlucky_design::shape::ShapeScale;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::shot::flavor_slug;
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::divider;
|
||||
use super::interaction::Interaction;
|
||||
use super::layout;
|
||||
|
||||
mod buttons;
|
||||
mod feedback;
|
||||
mod inputs;
|
||||
mod navigation;
|
||||
#[cfg(test)]
|
||||
mod probe;
|
||||
#[cfg(test)]
|
||||
mod scan;
|
||||
mod selection;
|
||||
|
||||
/// 段落过滤的环境变量名（语义见模块文档「段落过滤」）。
|
||||
pub const SECTION_ENV: &str = "ULL_GALLERY_SECTION";
|
||||
|
||||
/// 段落开关：**构建**哪几段（`false` = 这一段连 `view` 都不跑）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
struct Sections {
|
||||
buttons: bool,
|
||||
divider: bool,
|
||||
selection: bool,
|
||||
inputs: bool,
|
||||
feedback: bool,
|
||||
navigation: bool,
|
||||
}
|
||||
|
||||
impl Sections {
|
||||
/// 五段全渲染（默认）。
|
||||
const ALL: Self = Self {
|
||||
buttons: true,
|
||||
divider: true,
|
||||
selection: true,
|
||||
inputs: true,
|
||||
feedback: true,
|
||||
navigation: true,
|
||||
};
|
||||
|
||||
/// 只有一段。
|
||||
fn only(name: &str) -> Option<Self> {
|
||||
let mut sections = Self {
|
||||
buttons: false,
|
||||
divider: false,
|
||||
selection: false,
|
||||
inputs: false,
|
||||
feedback: false,
|
||||
navigation: false,
|
||||
};
|
||||
match name {
|
||||
"buttons" => sections.buttons = true,
|
||||
"divider" => sections.divider = true,
|
||||
"selection" => sections.selection = true,
|
||||
"inputs" => sections.inputs = true,
|
||||
"feedback" => sections.feedback = true,
|
||||
"navigation" => sections.navigation = true,
|
||||
_ => return None,
|
||||
}
|
||||
Some(sections)
|
||||
}
|
||||
|
||||
/// 读 `ULL_GALLERY_SECTION`。
|
||||
///
|
||||
/// 未设置 / 空 / `all`（大小写不敏感）→ 全渲染；**未识别的值 → 回落全渲染 + stderr 一行**。
|
||||
fn from_env() -> Self {
|
||||
let Ok(raw) = std::env::var(SECTION_ENV) else {
|
||||
return Self::ALL;
|
||||
};
|
||||
let name = raw.trim().to_ascii_lowercase();
|
||||
if name.is_empty() || name == "all" {
|
||||
return Self::ALL;
|
||||
}
|
||||
if let Some(sections) = Self::only(&name) {
|
||||
return sections;
|
||||
}
|
||||
eprintln!(
|
||||
"[gallery] {SECTION_ENV}={raw:?} 不是已知段（all|buttons|divider|selection|inputs|feedback|navigation），已回落 all"
|
||||
);
|
||||
Self::ALL
|
||||
}
|
||||
|
||||
/// 本次渲染的段名（stderr 日志 / 测试断言用）。
|
||||
fn names(self) -> Vec<&'static str> {
|
||||
let mut names = Vec::new();
|
||||
for (on, name) in [
|
||||
(self.buttons, "buttons"),
|
||||
(self.divider, "divider"),
|
||||
(self.selection, "selection"),
|
||||
(self.inputs, "inputs"),
|
||||
(self.feedback, "feedback"),
|
||||
(self.navigation, "navigation"),
|
||||
] {
|
||||
if on {
|
||||
names.push(name);
|
||||
}
|
||||
}
|
||||
names
|
||||
}
|
||||
}
|
||||
|
||||
/// `[gallery] ... 渲染 ...` 只打一次（`view` 每帧都会跑）。
|
||||
static SECTION_LOGGED: AtomicBool = AtomicBool::new(false);
|
||||
|
||||
fn log_sections(sections: Sections) {
|
||||
if SECTION_LOGGED.swap(true, Ordering::Relaxed) {
|
||||
return;
|
||||
}
|
||||
let raw = std::env::var(SECTION_ENV).unwrap_or_else(|_| "all".to_owned());
|
||||
eprintln!(
|
||||
"[gallery] section={raw} → 渲染 {} 段：{}",
|
||||
sections.names().len(),
|
||||
sections.names().join(", ")
|
||||
);
|
||||
}
|
||||
|
||||
/// gallery 自己的消息（与业务 `Message` 解耦，契约 §2）。
|
||||
#[derive(Debug, Clone, PartialEq, Eq)]
|
||||
pub enum DemoMessage {
|
||||
/// 某个演示按钮被按下（`&'static str` = 演示 id，只用于日志）。
|
||||
Pressed(&'static str),
|
||||
}
|
||||
|
||||
impl DemoMessage {
|
||||
/// 演示 id（日志用；将来加变体时这里跟着改，`app.rs` 不用动）。
|
||||
pub fn id(&self) -> &'static str {
|
||||
match self {
|
||||
DemoMessage::Pressed(id) => id,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// gallery 根视图（整窗：不带标题栏与导航轨，验收图上只有组件）。
|
||||
pub fn view<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let page = ui.style(TypeRole::BodySmall);
|
||||
|
||||
let header = column![
|
||||
text("Component gallery")
|
||||
.size(ui.emphasized(TypeRole::TitleLarge).size_px)
|
||||
.font(ui.emphasized_font(TypeRole::TitleLarge))
|
||||
.color(ui.color(Role::OnSurface)),
|
||||
text(format!(
|
||||
"M3 Expressive component base · flavor={} · 1180×760 @100% DPI · \
|
||||
focus 与 pressed 同为 10%（令牌口径，图上一样是对的）",
|
||||
flavor_slug(ui)
|
||||
))
|
||||
.size(page.size_px)
|
||||
.font(ui.font_of(page))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
]
|
||||
.spacing(ui.space(Space::X1));
|
||||
|
||||
// 小节之间**不画分隔线**：rubric（15 §22.4）要求同屏同类线 ≤3，
|
||||
// 而验收图里要给分隔线自己留证据（见 `divider_proof`）。分组靠 32px 留白 + 标题。
|
||||
//
|
||||
// 段落过滤（`ULL_GALLERY_SECTION`）：**没被选中的段根本不 push**，于是该家族的
|
||||
// `view` 一行都不跑——不是「构建后隐藏」。默认 `all` 与加开关之前逐像素一致。
|
||||
let picked = Sections::from_env();
|
||||
log_sections(picked);
|
||||
let mut sections = column![].spacing(ui.space(Space::X8)).width(Length::Fill);
|
||||
if picked.buttons {
|
||||
sections = sections.push(buttons::section(ui));
|
||||
}
|
||||
if picked.divider {
|
||||
sections = sections.push(divider_proof(ui));
|
||||
}
|
||||
if picked.selection {
|
||||
sections = sections.push(selection::section(ui));
|
||||
}
|
||||
if picked.inputs {
|
||||
sections = sections.push(inputs::section(ui));
|
||||
}
|
||||
if picked.feedback {
|
||||
sections = sections.push(feedback::section(ui));
|
||||
}
|
||||
if picked.navigation {
|
||||
sections = sections.push(navigation::section(ui));
|
||||
}
|
||||
|
||||
// 滚动条：默认是主题给的 10px 深灰 thumb，压过组件本体（视觉 reviewer P2-4）。
|
||||
// 这里把它改成 **透明轨 + OutlineVariant thumb**；宽度 10px 是 `scrollable` 的内部常量
|
||||
// （该控件不暴露 Scrollbar 配置），所以只做了「低对比」这一半，已登记为偏离 D7。
|
||||
let body = scrollable(sections)
|
||||
.height(Length::Fill)
|
||||
.width(Length::Fill)
|
||||
.style(move |theme, status| {
|
||||
// `scrollable::Style` 没有 `Default`：底色/间隙从主题默认值出发，只覆盖竖轨
|
||||
let base = scrollable::default(theme, status);
|
||||
scrollable::Style {
|
||||
vertical_rail: scrollable::Rail {
|
||||
background: None,
|
||||
border: iced::Border::default(),
|
||||
scroller: scrollable::Scroller {
|
||||
background: Background::Color(ui.color(Role::OutlineVariant)),
|
||||
border: iced::Border {
|
||||
radius: ui.radius(ShapeScale::Full, ui.space(Space::X2)),
|
||||
..iced::Border::default()
|
||||
},
|
||||
},
|
||||
},
|
||||
..base
|
||||
}
|
||||
});
|
||||
|
||||
// 页面留白走 `layout::inset`（左右/上下各 24）：这是 Q8/Q9 那两个 helper 的第三个兄弟，
|
||||
// 存在意义是「只改内边距、不改尺寸」，也顺手避免把 Padding 的上右下左写反。
|
||||
let page_padding = ui.space(Space::X6);
|
||||
container(layout::inset(
|
||||
page_padding,
|
||||
page_padding,
|
||||
column![header, body].spacing(ui.space(Space::X4)),
|
||||
))
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fill)
|
||||
.style(|_theme| container::Style {
|
||||
background: Some(Background::Color(ui.layer(MaterialLayer::Canvas))),
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 分隔线的视觉证据（§22）：一条通栏 + 一条列表内缩进，各自带说明。
|
||||
///
|
||||
/// 单独一节而不是散落各处：`15 §22.4` 说「同屏同类线 ≤3」，这两条是**唯一**计入的两条。
|
||||
fn divider_proof<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let caption = ui.style(TypeRole::LabelSmall);
|
||||
let label = |text_value: &'a str| {
|
||||
text(text_value)
|
||||
.size(caption.size_px)
|
||||
.font(ui.font_of(caption))
|
||||
.color(ui.color(Role::OnSurfaceVariant))
|
||||
};
|
||||
|
||||
column![
|
||||
heading(
|
||||
ui,
|
||||
"divider · full / list-inset",
|
||||
"15 §22：厚度 1px（stroke::HAIRLINE）· 颜色 OutlineVariant · 列表内左缩进 16 · 同屏 ≤3 条"
|
||||
),
|
||||
label("full (通栏，区块分隔)"),
|
||||
divider::full::<DemoMessage>(ui),
|
||||
label("list (左缩进 16)"),
|
||||
divider::list::<DemoMessage>(ui),
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 一个家族小节的标题（`index.title`）+ 一行判据说明。
|
||||
///
|
||||
/// 五个家族文件共用（`pub(super)`），保证五段的节奏一致——这也是 rubric D4
|
||||
/// 「一屏字号档 ≤4」的落点：小节只有 `TitleMedium` + `BodySmall` 两档。
|
||||
pub(crate) fn heading<'a>(ui: &'a Ui, title: &'a str, note: &'a str) -> Element<'a, DemoMessage> {
|
||||
let note_style = ui.style(TypeRole::BodySmall);
|
||||
column![
|
||||
text(title)
|
||||
.size(ui.emphasized(TypeRole::TitleMedium).size_px)
|
||||
.font(ui.emphasized_font(TypeRole::TitleMedium))
|
||||
.color(ui.color(Role::OnSurface)),
|
||||
text(note)
|
||||
.size(note_style.size_px)
|
||||
.font(ui.font_of(note_style))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
]
|
||||
.spacing(ui.space(Space::X1))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 状态矩阵的列头：五态的固定次序（`Interaction::ALL` 的口径）。
|
||||
///
|
||||
/// 列宽 = [`cell_width`]（**160** = `Space::X8 × 5`，是矩阵栅格，不是组件尺寸）。
|
||||
pub(crate) fn state_cells(ui: &Ui) -> Vec<(&'static str, f32)> {
|
||||
Interaction::ALL
|
||||
.iter()
|
||||
.map(|state| (state.name(), cell_width(ui)))
|
||||
.collect()
|
||||
}
|
||||
|
||||
/// 矩阵单元格宽度（只影响 harness 的取景，不是组件尺寸）。
|
||||
///
|
||||
/// 160 = `Space::X8 × 5`：5 列 + 1 个标签列 + 4 个列间距 + 页左右各 24
|
||||
/// = 6×160 + 4×8 + 48 = **1040 < 1180**，所以第 5 列（disabled）不再被窗口右缘裁掉。
|
||||
/// 早先是 192（×6），总宽 1232 撑破窗口，disabled 列被裁掉一半（视觉 reviewer P2-3）。
|
||||
pub(crate) fn cell_width(ui: &Ui) -> f32 {
|
||||
ui.space(Space::X8) * 5.0
|
||||
}
|
||||
|
||||
/// 一个矩阵行的左侧标签（变体名）。
|
||||
pub(crate) fn row_label<'a>(ui: &'a Ui, name: &'a str) -> Element<'a, DemoMessage> {
|
||||
let style = ui.style(TypeRole::BodySmall);
|
||||
container(
|
||||
text(name)
|
||||
.size(style.size_px)
|
||||
.font(ui.font_of(style))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
)
|
||||
.width(Length::Fixed(cell_width(ui)))
|
||||
.align_y(Alignment::Center)
|
||||
.into()
|
||||
}
|
||||
@@ -0,0 +1,352 @@
|
||||
//! gallery 里的导航类小节：四块状态矩阵 + 一块长文案块（**断言在 `navigation::probe`**）。
|
||||
//!
|
||||
//! ## 块选择器 `ULL_NAV_PART`
|
||||
//!
|
||||
//! `ULL_GALLERY_SECTION=navigation` 只隔离家族；本家族自己就有四块矩阵 + 长文案块，竖排比 760 高，
|
||||
//! 一屏只拍得到第一块。所以按契约 §9.2 的同一套规则再切一层（环境变量 + 默认兼容 + 未知值回落并打
|
||||
//! stderr）：`ULL_NAV_PART=list|tabs|drawer|appbar|long|all`（默认 `all`）。
|
||||
//!
|
||||
//! ```text
|
||||
//! ULL_GALLERY_SECTION=navigation ULL_NAV_PART=list ./target/debug/unlucky-launcher-iced.exe //! --software-renderer --screen=gallery --screenshot target/m79/list-light.png --screenshot-theme=light
|
||||
//! ULL_NAV_DIR=target/m79 cargo test -p unlucky-app-iced navigation::probe
|
||||
//! ```
|
||||
//!
|
||||
//! ## 矩阵形状
|
||||
//!
|
||||
//! ```text
|
||||
//! ListItem 行 = 一 / 两 / 三行（44 / 60 / 76） 列 = 选中 / 未选中 / 禁用（三列槽位完全相同）
|
||||
//! Tabs 三行 Primary（选中第 1/2/3 个）+ 一行 Secondary + 一行五态
|
||||
//! Drawer rail 88 与 drawer 240 **同尺度并排**（D33），各 3 项、第 2 项 hover、第 3 项禁用
|
||||
//! AppBar 静息 / 滚动两态（56 高；滚动只换容器色 + L2）
|
||||
//! long 长文案：页头 + 三行 ListItem + drawer（单行约束 D-M79-5 的取证）
|
||||
//! ```
|
||||
//!
|
||||
//! 取景板（`SurfaceContainerLow`）不是装饰：`Surface` 的页头/导航与页面底色同色，不垫一层板子，
|
||||
//! 截图里量不到边界（probe 就是靠板量 88 / 240 的）。
|
||||
|
||||
use iced::widget::{column, container, row, text};
|
||||
use iced::{Background, Element, Length};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::interaction::Interaction;
|
||||
use super::super::navigation::{
|
||||
self, app_bar, list_item, navigation, tabs, AppBar, AppBarAction, ListItem, NavGroup, NavItem,
|
||||
NavLayout, Navigation, Tab, Tabs, TabsVariant,
|
||||
};
|
||||
use super::{heading, DemoMessage};
|
||||
|
||||
/// 块选择器的环境变量名（语义见模块文档）。
|
||||
pub const PART_ENV: &str = "ULL_NAV_PART";
|
||||
|
||||
/// 本次渲染哪一块（`all` = 四块都渲染，默认）。
|
||||
fn part() -> String {
|
||||
let Ok(raw) = std::env::var(PART_ENV) else {
|
||||
return "all".to_owned();
|
||||
};
|
||||
let name = raw.trim().to_ascii_lowercase();
|
||||
match name.as_str() {
|
||||
"" | "all" | "list" | "tabs" | "drawer" | "appbar" | "long" => name,
|
||||
_ => {
|
||||
eprintln!(
|
||||
"[gallery] {PART_ENV}={raw:?} 不是已知块（all|list|tabs|drawer|appbar|long），已回落 all"
|
||||
);
|
||||
"all".to_owned()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 演示消息（组件只认泛型，映射在 gallery 侧落地）。
|
||||
fn pressed() -> DemoMessage {
|
||||
DemoMessage::Pressed("navigation")
|
||||
}
|
||||
|
||||
fn icon(name: &str) -> IconKind {
|
||||
match name {
|
||||
"download" => IconKind::Download,
|
||||
"logs" => IconKind::Logs,
|
||||
"settings" => IconKind::Settings,
|
||||
_ => IconKind::Instances,
|
||||
}
|
||||
}
|
||||
|
||||
/// 取景板：`SurfaceContainerLow` 底（`Surface` 的页头/导航要靠它才有边界）。
|
||||
fn plate<'a>(
|
||||
ui: &'a Ui,
|
||||
pad: f32,
|
||||
content: impl Into<Element<'a, DemoMessage>>,
|
||||
) -> Element<'a, DemoMessage> {
|
||||
container(content)
|
||||
.padding(pad)
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(ui.color(Role::SurfaceContainerLow))),
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 一行小字图例。
|
||||
fn note<'a>(ui: &'a Ui, value: &'a str) -> Element<'a, DemoMessage> {
|
||||
let style = ui.style(TypeRole::BodySmall);
|
||||
text(value)
|
||||
.size(style.size_px)
|
||||
.font(ui.font_of(style))
|
||||
.color(ui.color(Role::OnSurfaceVariant))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 导航类家族的小节。
|
||||
pub(super) fn section<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let picked = part();
|
||||
let mut body = column![heading(
|
||||
ui,
|
||||
"navigation · list item / tabs / drawer / app bar",
|
||||
"12b §4/§6/§16 + 15 §21：ListItem 44/60/76 · Tabs 48 + 指示条 3 · \
|
||||
Drawer = rail 88 ⇄ drawer 240（同一容器）· AppBar 56 + 滚动换色"
|
||||
)]
|
||||
.spacing(ui.space(Space::X8));
|
||||
|
||||
if picked == "all" || picked == "list" {
|
||||
body = body.push(list_part(ui));
|
||||
}
|
||||
if picked == "all" || picked == "tabs" {
|
||||
body = body.push(tabs_part(ui));
|
||||
}
|
||||
if picked == "all" || picked == "drawer" {
|
||||
body = body.push(drawer_part(ui));
|
||||
}
|
||||
if picked == "all" || picked == "appbar" {
|
||||
body = body.push(app_bar_part(ui));
|
||||
}
|
||||
if picked == "long" {
|
||||
body = body.push(navigation::matrix::long_part(ui, pressed));
|
||||
}
|
||||
body.into()
|
||||
}
|
||||
|
||||
/// 一个列表格（宽 = `nav_drawer_width` 240：够放下 icon + 两行文本，且与 drawer 药丸 216 可区分）。
|
||||
fn list_cell<'a>(ui: &'a Ui, item: ListItem<'a, DemoMessage>) -> Element<'a, DemoMessage> {
|
||||
container(list_item(ui, item))
|
||||
.width(Length::Fixed(ui.metrics().nav_drawer_width))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// ListItem：三行高 × {选中 / 未选中 / 禁用}。
|
||||
fn list_part<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let states = ["selected", "enabled", "disabled"];
|
||||
|
||||
let mut grid = column![].spacing(ui.space(Space::X4));
|
||||
let header = states
|
||||
.iter()
|
||||
.map(|name| {
|
||||
container(note(ui, name))
|
||||
.width(Length::Fixed(ui.metrics().nav_drawer_width))
|
||||
.into()
|
||||
})
|
||||
.collect::<Vec<Element<'a, DemoMessage>>>();
|
||||
grid = grid.push(
|
||||
row![
|
||||
note(ui, "rows +16 each · 44 / 60 / 76"),
|
||||
row(header).spacing(ui.space(Space::X2))
|
||||
]
|
||||
.spacing(ui.space(Space::X2)),
|
||||
);
|
||||
|
||||
for (index, lines) in ["one line", "two lines", "three lines"].iter().enumerate() {
|
||||
let mut cells = row![].spacing(ui.space(Space::X2));
|
||||
for state in states {
|
||||
// 三列的**内容完全相同**（同样的槽位），只有态不同——否则「选中 trailing = Primary」
|
||||
// 这条结论没有可比对象（视觉 r1 P2-2 点名）
|
||||
let mut item = ListItem::new(lines, pressed())
|
||||
.leading(icon("instances"))
|
||||
.trailing(icon("settings"));
|
||||
if index >= 1 {
|
||||
item = item.supporting("3 versions · 1.21.4");
|
||||
}
|
||||
if index >= 2 {
|
||||
item = item.overline("RECENT");
|
||||
}
|
||||
item = match state {
|
||||
"selected" => item.selected(),
|
||||
// 禁用是修饰器：这里只清消息，槽位全部保留
|
||||
"disabled" => item.disabled(),
|
||||
_ => item.state(Interaction::Enabled),
|
||||
};
|
||||
cells = cells.push(list_cell(ui, item));
|
||||
}
|
||||
grid = grid.push(cells);
|
||||
}
|
||||
|
||||
column![
|
||||
note(
|
||||
ui,
|
||||
"ListItem · 选中 = SecondaryContainer（偏离 D-M79-1：A1 的 ListItem 不换底色）· \
|
||||
禁用 = OnSurface@38%（A1 ListTokens）"
|
||||
),
|
||||
grid,
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// Tabs：两行 Primary（短 / 长文案各选中一次 → 指示条宽度必须不同）+ Secondary + 五态。
|
||||
fn tabs_part<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let primary_row = |selected: usize| {
|
||||
let mut builder = Tabs::primary();
|
||||
for (index, label) in ["Logs", "Instance details", "Settings"].iter().enumerate() {
|
||||
let mut tab = Tab::new(label, pressed());
|
||||
if index == 2 {
|
||||
// 6.1：带图标的 Tabs 容器高 64（纯文字 48）
|
||||
tab = tab.icon(icon("settings"));
|
||||
}
|
||||
if index == selected {
|
||||
tab = tab.selected();
|
||||
}
|
||||
builder = builder.tab(tab);
|
||||
}
|
||||
tabs(ui, builder)
|
||||
};
|
||||
|
||||
let state_row = {
|
||||
let mut builder = Tabs::primary();
|
||||
for (index, state) in [
|
||||
Interaction::Enabled,
|
||||
Interaction::Hovered,
|
||||
Interaction::Focused,
|
||||
Interaction::Pressed,
|
||||
Interaction::Disabled,
|
||||
]
|
||||
.iter()
|
||||
.enumerate()
|
||||
{
|
||||
let mut tab = Tab::new("Tab", pressed()).state(*state);
|
||||
if index == 0 {
|
||||
tab = tab.selected();
|
||||
}
|
||||
builder = builder.tab(tab);
|
||||
}
|
||||
tabs(ui, builder)
|
||||
};
|
||||
|
||||
let secondary = tabs(
|
||||
ui,
|
||||
Tabs::secondary()
|
||||
.tab(Tab::new("Release", pressed()).selected())
|
||||
.tab(Tab::new("Snapshot", pressed()))
|
||||
.tab(Tab::new("Legacy", pressed()).disabled()),
|
||||
);
|
||||
|
||||
// 两式的名字进图例（同时把 `TabsVariant::ALL` 变成可点检的常量，而不是死代码）
|
||||
let legend = TabsVariant::ALL
|
||||
.iter()
|
||||
.map(|variant| note(ui, variant.name()))
|
||||
.collect::<Vec<_>>();
|
||||
|
||||
column![
|
||||
note(
|
||||
ui,
|
||||
"Tabs · Primary 三行 = 选中第 1 / 2 / 3 个（指示条跟着走且宽度跟随该项）；Secondary：1px SurfaceVariant"
|
||||
),
|
||||
row(legend).spacing(ui.space(Space::X4)),
|
||||
primary_row(0),
|
||||
primary_row(1),
|
||||
primary_row(2),
|
||||
secondary,
|
||||
note(ui, "Primary 五态（第 1 项选中；未选项 hover/focus/pressed 提到 OnSurface）"),
|
||||
state_row,
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 导航容器：rail 88 与 drawer 240 **同尺度并排**（D33 的可验收形式）。
|
||||
fn drawer_part<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
// 取景板高 288（= Space::X8 × 9）：装得下 drawer 的「两个分组 + 三项 + 两次标题」，否则末行被裁
|
||||
let plate_height = ui.space(Space::X8) * 9.0;
|
||||
let mut panes = row![].spacing(ui.space(Space::X6));
|
||||
|
||||
for layout in NavLayout::ALL {
|
||||
let builder = match layout {
|
||||
NavLayout::Rail => Navigation::rail(),
|
||||
NavLayout::Drawer => Navigation::drawer(),
|
||||
};
|
||||
let pane = builder
|
||||
.group(
|
||||
NavGroup::titled("LIBRARY")
|
||||
.item(NavItem::new("Instances", icon("instances"), pressed()).selected())
|
||||
.item(
|
||||
NavItem::new("Download", icon("download"), pressed())
|
||||
.state(Interaction::Hovered),
|
||||
),
|
||||
)
|
||||
.group(
|
||||
NavGroup::titled("SYSTEM")
|
||||
.item(NavItem::new("Settings", icon("settings"), pressed()).disabled()),
|
||||
);
|
||||
let width = match layout {
|
||||
NavLayout::Rail => ui.metrics().nav_rail_width,
|
||||
NavLayout::Drawer => ui.metrics().nav_drawer_width,
|
||||
};
|
||||
// 取景板比容器大一圈（pad 8）：`Surface` 的导航与页面底色同色，板要露边才量得到
|
||||
let pad = ui.space(Space::X2);
|
||||
panes = panes.push(
|
||||
container(container(navigation(ui, pane)).height(Length::Fixed(plate_height)))
|
||||
.width(Length::Fixed(width + pad * 2.0))
|
||||
.height(Length::Fixed(plate_height + pad * 2.0))
|
||||
.padding(pad)
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(ui.color(Role::SurfaceContainerLow))),
|
||||
..container::Style::default()
|
||||
}),
|
||||
);
|
||||
}
|
||||
|
||||
column![
|
||||
note(
|
||||
ui,
|
||||
"D33：同一个容器两个宽度 —— rail（药丸 56×32）｜drawer（药丸 216×56，左右各缩 12）； 第 2 项 hover、第 3 项禁用"
|
||||
),
|
||||
panes,
|
||||
row![
|
||||
note(ui, "左→右："),
|
||||
note(ui, NavLayout::Rail.name()),
|
||||
note(ui, NavLayout::Drawer.name()),
|
||||
]
|
||||
.spacing(ui.space(Space::X2)),
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// AppBar small：静息 / 滚动两态（56 高；滚动换容器色 + L2）。
|
||||
fn app_bar_part<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let bar = |scrolled: bool| {
|
||||
app_bar(
|
||||
ui,
|
||||
AppBar::new("Instances")
|
||||
.subtitle(if scrolled {
|
||||
"scrolled · SurfaceContainer + L2"
|
||||
} else {
|
||||
"resting · Surface + L0"
|
||||
})
|
||||
.leading(AppBarAction::inert(icon("instances")))
|
||||
.trailing(AppBarAction::new(icon("settings"), pressed()))
|
||||
.scrolled(scrolled),
|
||||
)
|
||||
};
|
||||
|
||||
column![
|
||||
note(
|
||||
ui,
|
||||
"AppBar small · 56 高（A1 64，偏离 D-M79-2）· 滚动只换容器色与高程，不改高度（A1 无 OnScroll…Height）"
|
||||
),
|
||||
plate(ui, ui.space(Space::X2), column![bar(false), bar(true)].spacing(ui.space(Space::X2))),
|
||||
]
|
||||
.spacing(ui.space(Space::X2))
|
||||
.into()
|
||||
}
|
||||
@@ -0,0 +1,368 @@
|
||||
//! 渲染层几何断言：**对着真截图量像素**（M68 的教训：纯函数返回对，图可能是错的）。
|
||||
//!
|
||||
//! `buttons::tests` 只能证明「几何结构体里的数字是 40/20/24」——M68 的药丸正是这样：单测全绿、
|
||||
//! 图上是 88×32（容器被 `center_x(Length::Fill)` 覆盖）。唯一能抓住这类错误的是**真渲染的像素**。
|
||||
//! CI 没有桌面，所以这里不自己开窗：先用 `--screen=gallery --screenshot` 出真窗截图，本测试读
|
||||
//! 那张 PNG 量几何、与令牌逐项比对。**没给图就跳过并大声说出来**（不静默通过）。
|
||||
//!
|
||||
//! 复现命令（在 worktree 根目录）：
|
||||
//!
|
||||
//! ```text
|
||||
//! cargo build -p unlucky-app-iced --bin unlucky-launcher-iced
|
||||
//! ./target/debug/unlucky-launcher-iced --software-renderer --screen=gallery \
|
||||
//! --screenshot target/m75/gallery-light.png --screenshot-theme=light
|
||||
//! ULL_GALLERY_SHOT=target/m75/gallery-light.png cargo test -p unlucky-app-iced gallery::probe
|
||||
//! ```
|
||||
//!
|
||||
//! 量什么（每条对一个已发生过的错误）：实心块高 **40**（12b 1.1）· 药丸顶行**左内缩 ≈14** ⇒ 圆角 full=20
|
||||
//! （12b 1.2，8 圆角会接近通栏）· IconButton **40×40**（12b 2.1）· 字形墨迹 **16~26**
|
||||
//! （Q9：24 盒被填满会到 40）· 分隔线 **1px**（22.1）· 禁用容器 **on-surface@10%**（按钮族）存在（12b 1.8）。
|
||||
|
||||
use unlucky_design::color::{Role, SchemeFlavor};
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::{Families, Ui};
|
||||
|
||||
use crate::app::components::interaction;
|
||||
|
||||
use super::scan::{matches, nearer, rgb, Shot};
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
/// 一条 1dp 细线在竖直方向的「墨量覆盖率」：各行相对底色的不透明度之和（1dp ⇒ ≈1.0）。
|
||||
///
|
||||
/// **只统计「长横线行」**（连续非底色像素 > 900）：标题/正文那些行也有几百个零散墨迹像素，
|
||||
/// 按「任意非底色像素数」筛会把文字算进墨量（首版实测 57.9，明显是文字被算进去了）。
|
||||
fn line_coverage(shot: &Shot, surface: [u8; 3], line: [u8; 3]) -> f32 {
|
||||
let mut total = 0.0;
|
||||
for y in 0..shot.height {
|
||||
let mut longest = 0;
|
||||
let mut current = 0;
|
||||
let mut sum = 0.0f32;
|
||||
let mut run_sum = 0.0f32;
|
||||
for x in 0..shot.width {
|
||||
let pixel = shot.at(x, y);
|
||||
if !matches(pixel, surface) {
|
||||
current += 1;
|
||||
run_sum += delta_ratio(pixel, surface, line);
|
||||
if current > longest {
|
||||
longest = current;
|
||||
sum = run_sum;
|
||||
}
|
||||
} else {
|
||||
current = 0;
|
||||
run_sum = 0.0;
|
||||
}
|
||||
}
|
||||
if longest > 900 {
|
||||
total += sum / longest as f32;
|
||||
}
|
||||
}
|
||||
total
|
||||
}
|
||||
|
||||
/// `pixel` 相对 `surface` 的偏移占「满档 line 色偏移」的比例（0..=1）。
|
||||
fn delta_ratio(pixel: [u8; 3], surface: [u8; 3], line: [u8; 3]) -> f32 {
|
||||
let channel = |i: usize| {
|
||||
let full = f32::from(line[i]) - f32::from(surface[i]);
|
||||
if full.abs() < 1.0 {
|
||||
return 0.0;
|
||||
}
|
||||
((f32::from(pixel[i]) - f32::from(surface[i])) / full).clamp(0.0, 1.0)
|
||||
};
|
||||
let (dr, dg, db) = (channel(0), channel(1), channel(2));
|
||||
(dr + dg + db) / 3.0
|
||||
}
|
||||
|
||||
/// `ULL_GALLERY_SHOT` → 截图路径（相对路径按**工作区根**解释：`cargo test` 的 cwd 是 crate 目录）。
|
||||
fn shot_path() -> Option<std::path::PathBuf> {
|
||||
let raw = std::env::var_os("ULL_GALLERY_SHOT")?;
|
||||
let path = std::path::PathBuf::from(raw);
|
||||
if path.is_absolute() || path.exists() {
|
||||
return Some(path);
|
||||
}
|
||||
let root = std::path::PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("../..");
|
||||
Some(root.join(path))
|
||||
}
|
||||
|
||||
/// 一条测试覆盖全部几何断言（每张图各跑一次）。
|
||||
#[test]
|
||||
fn gallery_geometry_matches_the_tokens() {
|
||||
let Some(path) = shot_path() else {
|
||||
eprintln!(
|
||||
"[probe] SKIPPED：未设置 ULL_GALLERY_SHOT。这是**渲染层**几何断言，\
|
||||
需要先出一张真窗截图（命令见本文件模块文档）。"
|
||||
);
|
||||
return;
|
||||
};
|
||||
|
||||
let shot = Shot::load(&path).expect("读 gallery 截图");
|
||||
assert_eq!(
|
||||
(shot.width, shot.height),
|
||||
(1180, 760),
|
||||
"验收图必须是 D30 的 1180×760 @100% DPI"
|
||||
);
|
||||
|
||||
// 用左上角背景色判定深浅（页面 padding 区就是 `Surface`）
|
||||
let corner = shot.at(2, 2);
|
||||
let flavor = if matches(corner, rgb(ui(SchemeFlavor::Light).color(Role::Surface))) {
|
||||
SchemeFlavor::Light
|
||||
} else {
|
||||
SchemeFlavor::Dark
|
||||
};
|
||||
let ui = ui(flavor);
|
||||
|
||||
// ---- 12b 1.1 / 1.2：实心按钮 40 高、药丸圆角 20 ------------------------------
|
||||
let primary = shot.bbox_of(rgb(ui.color(Role::Primary)));
|
||||
assert!(
|
||||
primary.len() >= 2,
|
||||
"至少该找到 Filled 按钮与 Filled IconButton 两块实心（实际 {}）",
|
||||
primary.len()
|
||||
);
|
||||
|
||||
let mut label_button = None;
|
||||
for bbox in &primary {
|
||||
// 字形（OnPrimary）会把实心块割出小碎片，只判「成块的」（40×40 = 1600）
|
||||
if bbox.area() < 800 {
|
||||
continue;
|
||||
}
|
||||
assert!(
|
||||
(39..=41).contains(&bbox.height()),
|
||||
"实心块高 {}（参考 40，12b 1.1）@ {:?}",
|
||||
bbox.height(),
|
||||
(bbox.left, bbox.top)
|
||||
);
|
||||
if bbox.width() > 60 {
|
||||
label_button = Some(*bbox);
|
||||
}
|
||||
// 12b 2.1：IconButton 容器精确 40×40（别再用区间——reviewer 已证 +2px 抓不住）
|
||||
if bbox.width() < 60 {
|
||||
// 宽 = 40（最宽那行是实色，量得准）；高会把底部抗锯齿行排除掉，所以是 39 或 40。
|
||||
// 区间收到 39..=40 仍能抓 ±2px 的回归（42 → 41、38 → 37 都会落区间外）。
|
||||
assert_eq!(bbox.width(), 40, "IconButton 容器宽必须 40（12b 2.1）");
|
||||
assert!(
|
||||
(39..=40).contains(&bbox.height()),
|
||||
"IconButton 容器高应 40（实色 39 + 抗锯齿行），实测 {}",
|
||||
bbox.height()
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
let label_button = label_button.expect("没找到文字按钮的实心块");
|
||||
assert!(
|
||||
label_button.width() >= 58,
|
||||
"12b 1.7：最小宽 58，实测 {}",
|
||||
label_button.width()
|
||||
);
|
||||
|
||||
// 含抗锯齿的真实外框：中心列上「更接近填充色而不是底色」的连续行
|
||||
let fill = rgb(ui.color(Role::Primary));
|
||||
let surface = rgb(ui.color(Role::Surface));
|
||||
let center = (label_button.left + label_button.right) / 2;
|
||||
let mut true_top = label_button.top;
|
||||
while true_top > 0 && nearer(shot.at(center, true_top - 1), fill, surface) {
|
||||
true_top -= 1;
|
||||
}
|
||||
let mut true_bottom = label_button.bottom;
|
||||
while true_bottom + 1 < shot.height && nearer(shot.at(center, true_bottom + 1), fill, surface) {
|
||||
true_bottom += 1;
|
||||
}
|
||||
let true_height = true_bottom - true_top + 1;
|
||||
|
||||
// **精确 40**：变异成 42 必须红。上一版写的是 `(39..=41).contains(..)`，
|
||||
// reviewer 把高度改成 42 重新出图后断言照样绿 —— 那就是「渲层断言等于没有」。
|
||||
assert_eq!(
|
||||
true_height, 40,
|
||||
"可见高必须精确 40（12b 1.1）；变异成 42 这里就会红"
|
||||
);
|
||||
|
||||
// 圆角档位：量**顶部那一行的左内缩**。按像素中心口径，第 k 行（k 从 0 起）的闭式是
|
||||
// inset(k) = r − √(r² − (r − k − 0.5)²)；r=20、k=1 给 **12.40**（实测 12~14），
|
||||
// r=8 只有 ≈3.6，直角为 0。比「数圆角行数」抗锯齿得多。
|
||||
let top_row_left = (label_button.left..=label_button.right)
|
||||
.find(|x| matches(shot.at(*x, label_button.top), fill))
|
||||
.expect("顶部行应至少有一个填充像素");
|
||||
let top_inset = top_row_left - label_button.left;
|
||||
assert!(
|
||||
(11..=17).contains(&top_inset),
|
||||
"药丸圆角应 = 20（12b 1.2）：顶部行左内缩应 ≈14，实测 {top_inset}（8 圆角 ≈4，直角 0）"
|
||||
);
|
||||
|
||||
// ---- 12b 1.4：带前置图标的左内边距 = 16（用 Filled 格量，避开圆角只扫中间带）----
|
||||
// 判「墨迹」的方式：比容器色更接近 OnPrimary。不要用字面量白——浅色页面底色 (246,250,255)
|
||||
// 与白在容差内，会把圆角外的底色当成墨迹（首次实现就踩了，量出 3）。
|
||||
let on_primary = rgb(ui.color(Role::OnPrimary));
|
||||
let mut left_ink: Option<usize> = None;
|
||||
for y in (label_button.top + 12)..=(label_button.bottom - 12) {
|
||||
for x in (label_button.left + 4)..=label_button.right {
|
||||
if nearer(shot.at(x, y), on_primary, fill) {
|
||||
left_ink = Some(left_ink.map_or(x, |best: usize| best.min(x)));
|
||||
}
|
||||
}
|
||||
}
|
||||
let icon_pad = left_ink.expect("Filled 格应带前置图标（量内边距用）") - label_button.left;
|
||||
// 图标盒左缘 = 16；字形在 24 viewBox 里自带 ≈5.3 左边距 ⇒ 墨迹落在 21 附近
|
||||
// （16 → 21；24 → 29；8 → 13，三档互不重叠）
|
||||
assert!(
|
||||
(18..=24).contains(&icon_pad),
|
||||
"12b 1.4：带图标左内边距应 16（墨迹 ≈21），实测 {icon_pad}"
|
||||
);
|
||||
|
||||
// ---- Q9：IconButton 的字形不许撑满 40 盒 -----------------------------------
|
||||
let tonal = rgb(ui.color(Role::SecondaryContainer));
|
||||
let tonal_boxes = shot.bbox_of(tonal);
|
||||
let icon_states = tonal_boxes
|
||||
.iter()
|
||||
.filter(|bbox| (39..=41).contains(&bbox.width()) && (39..=41).contains(&bbox.height()))
|
||||
.count();
|
||||
// 只有 **enabled** 列是精确的 SecondaryContainer（hover/pressed/focus 列叠了状态层，颜色不同），
|
||||
// 所以这里只要求 ≥1：量几何一只就够，五态的可见性由图本身给。
|
||||
assert!(
|
||||
icon_states >= 1,
|
||||
"tonal IconButton 至少 1 个（实际 {icon_states}）"
|
||||
);
|
||||
|
||||
let gear = rgb(ui.color(Role::OnSecondaryContainer));
|
||||
let mut measured_glyph = false;
|
||||
let mut glyph_width = 0;
|
||||
for bbox in tonal_boxes
|
||||
.iter()
|
||||
.filter(|bbox| (39..=41).contains(&bbox.width()))
|
||||
{
|
||||
if let Some(ink) = shot.ink_inside(bbox, gear) {
|
||||
let width = ink.width();
|
||||
if width > glyph_width {
|
||||
glyph_width = width;
|
||||
}
|
||||
assert!(
|
||||
(16..=26).contains(&width),
|
||||
"图标盒 24 的字形墨迹应 16~26 宽，实测 {width}（Q9 回归时会接近 40）"
|
||||
);
|
||||
measured_glyph = true;
|
||||
}
|
||||
}
|
||||
assert!(measured_glyph, "没量到 IconButton 的字形");
|
||||
|
||||
// ---- 22.1：分隔线 1px（按「非底色的长横线」判，不按精确色：线被抗锯齿摊到两行）----
|
||||
let surface = rgb(ui.color(Role::Surface));
|
||||
let mut runs = 0;
|
||||
for y in 0..shot.height {
|
||||
let mut longest = 0;
|
||||
let mut current = 0;
|
||||
for x in 0..shot.width {
|
||||
if !matches(shot.at(x, y), surface) {
|
||||
current += 1;
|
||||
longest = longest.max(current);
|
||||
} else {
|
||||
current = 0;
|
||||
}
|
||||
}
|
||||
if longest > 300 {
|
||||
runs += 1;
|
||||
}
|
||||
}
|
||||
// 两条线 × 各摊 1~2 行 ⇒ 2..=4 行
|
||||
assert!(
|
||||
(2..=4).contains(&runs),
|
||||
"分隔线应 2 条（每条 1px，抗锯齿最多摊 2 行）⇒ 2..=4 行，实测 {runs} 行"
|
||||
);
|
||||
// **墨量覆盖率**：一条 1dp 的线，其各行相对底色的不透明覆盖率之和应 ≈1.0。
|
||||
// 1.5dp 的线会到 ≈1.5，2dp 会到 ≈2.0 —— 这是「容忍 1.5 倍粗」的补丁。
|
||||
let full = rgb(ui.color(Role::OutlineVariant));
|
||||
// 屏上正好 2 条线（通栏 + 列表内缩），所以把总墨量除以 2 得到「单条线的覆盖率」
|
||||
let coverage = line_coverage(&shot, surface, full) / 2.0;
|
||||
assert!(
|
||||
(0.8..=1.3).contains(&coverage),
|
||||
"单条分隔线墨量覆盖率应 ≈1.0（= 1dp），实测 {coverage:.2}（1.5dp 会到 ~1.5）"
|
||||
);
|
||||
|
||||
// ---- 12b 1.8 禁用态：容器 + **每一行**的内容色（A1 逐变体不同）----------------
|
||||
//
|
||||
// 上一版把两个 reviewer 都指出的重复块留在这里（`disabled_colors` 被调两次、
|
||||
// `disabled_container` 被绑定两次），且只有一条「全图数墨迹」的护栏 —— 深色下阈值失效、
|
||||
// 单行回退也抓不住。现在按矩阵的行逐条断言。
|
||||
//
|
||||
// **按钮族**：容器 10%（官方 `*ButtonTokens.DisabledContainerOpacity = 0.1f`）、内容 38%。
|
||||
// M86 之前这里和 chip 共用同一个 12% 常量，所以断言与实现「一起错」、永远同源——拆族后才对得上。
|
||||
let (disabled_container, _) = interaction::disabled_button_colors(&ui, Role::Surface);
|
||||
assert!(
|
||||
shot.bbox_of(rgb(disabled_container))
|
||||
.iter()
|
||||
.any(|b| b.width() > 60),
|
||||
"没找到禁用态实心按钮（12b 1.8：容器 = on-surface@10%）"
|
||||
);
|
||||
|
||||
// 矩阵行序（gallery/buttons.rs 的 Variant::ALL + IconVariant::ALL），行距 48 = 40 + 8
|
||||
let row_step = 48usize;
|
||||
let rows: [(usize, Role, bool, &str); 8] = [
|
||||
(0, Role::OnSurfaceVariant, true, "filled"),
|
||||
(1, Role::OnSurface, true, "tonal"), // A1：FilledTonal 是例外
|
||||
(2, Role::OnSurfaceVariant, true, "elevated"),
|
||||
(3, Role::OnSurfaceVariant, false, "outlined"),
|
||||
(4, Role::OnSurfaceVariant, false, "text"),
|
||||
(5, Role::OnSurface, false, "icon·standard"), // A1：IconButton 全是 OnSurface
|
||||
(6, Role::OnSurface, false, "icon·filled"),
|
||||
// 第 7 行（矩阵最后一行的 tonal IconButton）上一版漏了 —— reviewer 把它的禁用墨迹涂回
|
||||
// 满档色时 probe 全绿。A1 同样是 OnSurface（`FilledTonalIconButtonTokens`）。
|
||||
(7, Role::OnSurface, true, "icon·tonal"),
|
||||
];
|
||||
let column_from = shot.width * 2 / 3; // 矩阵最右列 = disabled 列
|
||||
for (index, role, on_container, name) in rows {
|
||||
let y0 = label_button.top + index * row_step;
|
||||
let y1 = y0 + 44;
|
||||
// **与实现同源**：按钮族的内容色一律走 `disabled_button_content`（38% 叠在 10% 底上）。
|
||||
// 这里若用面状控件族的 `disabled_content_over_role`（12% 底），断言的底就比实现宽一档，
|
||||
// 差的 1/255 会让「容器对了内容错了」这类错逃过门控——M86 明确要防这个。
|
||||
let ink = interaction::disabled_button_content(&ui, role, on_container);
|
||||
let count = shot.count_in(rgb(ink), column_from, shot.width, y0, y1);
|
||||
assert!(
|
||||
count > 40,
|
||||
"{name} 行的禁用内容（{role:?}@38%）在 disabled 列里只有 {count} px —— 说明这一行没走 A1 的禁用角色"
|
||||
);
|
||||
}
|
||||
|
||||
// filled 禁用容器里不许出现满档 OnPrimary（旧实现是白字压在容器上 = 1.23:1）
|
||||
let full_content = rgb(ui.color(Role::OnPrimary));
|
||||
for bbox in shot.bbox_of(rgb(disabled_container)) {
|
||||
if bbox.width() < 60 {
|
||||
continue;
|
||||
}
|
||||
// 只扫**内带**：圆角外的页面底色与 OnPrimary 在容差内，贴边扫描会误报。
|
||||
for y in (bbox.top + 12)..=(bbox.bottom - 12) {
|
||||
for x in (bbox.left + 12)..=(bbox.right - 12) {
|
||||
assert!(
|
||||
!matches(shot.at(x, y), full_content),
|
||||
"禁用容器内出现满档 OnPrimary @({x},{y})：禁用标签没降到 38%"
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
eprintln!(
|
||||
"[probe] OK flavor={:?}：
|
||||
Filled 药丸 {}×{}（参考 高 40 / 宽 ≥58）
|
||||
顶行左内缩 {}（r=20 应 ≈14；8 圆角 ≈4；直角 0）
|
||||
实心块 {} 个（含 40×40 IconButton）
|
||||
分隔线长行 {} 行（每条 1px）
|
||||
禁用容器 (on-surface@10%，按钮族) 命中 · 逐行禁用内容断言 {} 行通过
|
||||
分隔线墨量覆盖率 {:.2}（1dp 应 ≈1.0）
|
||||
字形墨迹 {}px（24 盒应 16~26）",
|
||||
flavor,
|
||||
label_button.width(),
|
||||
true_height,
|
||||
top_inset,
|
||||
primary.len(),
|
||||
runs,
|
||||
rows.len(),
|
||||
coverage,
|
||||
glyph_width
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,183 @@
|
||||
//! 截图像素扫描工具（`gallery::probe` 的底层，四个后续家族的 probe 也能复用）。
|
||||
//!
|
||||
//! 只做「按颜色找连通块 / 量外接框 / 量某行的连续长度」三件事，不含任何判据——
|
||||
//! 判据在同级 `probe.rs` 里，这样每条家族线可以自带 probe 而不用重写扫描逻辑。
|
||||
|
||||
use std::path::Path;
|
||||
|
||||
use iced::Color;
|
||||
|
||||
/// 颜色比对的通道容差（抗锯齿/取整）。
|
||||
const TOLERANCE: u8 = 10;
|
||||
|
||||
/// iced 颜色 → 8bit RGB（截图里的原值）。
|
||||
pub(super) fn rgb(color: Color) -> [u8; 3] {
|
||||
[
|
||||
(color.r * 255.0).round() as u8,
|
||||
(color.g * 255.0).round() as u8,
|
||||
(color.b * 255.0).round() as u8,
|
||||
]
|
||||
}
|
||||
|
||||
/// 颜色是否落在容差内。
|
||||
pub(super) fn matches(pixel: [u8; 3], expected: [u8; 3]) -> bool {
|
||||
pixel
|
||||
.iter()
|
||||
.zip(expected)
|
||||
.all(|(a, b)| a.abs_diff(b) <= TOLERANCE)
|
||||
}
|
||||
|
||||
/// 一张图的像素访问器。
|
||||
pub(super) struct Shot {
|
||||
pub(super) width: usize,
|
||||
pub(super) height: usize,
|
||||
pixels: Vec<[u8; 3]>,
|
||||
}
|
||||
|
||||
impl Shot {
|
||||
pub(super) fn load(path: &Path) -> Result<Self, String> {
|
||||
let bytes = std::fs::read(path).map_err(|error| format!("读不动 {path:?}：{error}"))?;
|
||||
let image = image::load_from_memory(&bytes)
|
||||
.map_err(|error| format!("解 PNG 失败：{error}"))?
|
||||
.to_rgb8();
|
||||
let (width, height) = (image.width() as usize, image.height() as usize);
|
||||
Ok(Self {
|
||||
width,
|
||||
height,
|
||||
pixels: image.pixels().map(|p| p.0).collect(),
|
||||
})
|
||||
}
|
||||
|
||||
pub(super) fn at(&self, x: usize, y: usize) -> [u8; 3] {
|
||||
self.pixels[y * self.width + x]
|
||||
}
|
||||
|
||||
/// 某种颜色的全部像素的外接框（连通块）。
|
||||
pub(super) fn bbox_of(&self, color: [u8; 3]) -> Vec<BBox> {
|
||||
let mut seen = vec![false; self.width * self.height];
|
||||
let mut boxes = Vec::new();
|
||||
|
||||
for y in 0..self.height {
|
||||
for x in 0..self.width {
|
||||
if seen[y * self.width + x] || !matches(self.at(x, y), color) {
|
||||
continue;
|
||||
}
|
||||
|
||||
let mut stack = vec![(x, y)];
|
||||
seen[y * self.width + x] = true;
|
||||
let mut bbox = BBox::new(x, y);
|
||||
|
||||
while let Some((cx, cy)) = stack.pop() {
|
||||
bbox.include(cx, cy);
|
||||
for (nx, ny) in [
|
||||
(cx + 1, cy),
|
||||
(cx.saturating_sub(1), cy),
|
||||
(cx, cy + 1),
|
||||
(cx, cy.saturating_sub(1)),
|
||||
] {
|
||||
let inside = nx < self.width && ny < self.height;
|
||||
if inside && !seen[ny * self.width + nx] && matches(self.at(nx, ny), color)
|
||||
{
|
||||
seen[ny * self.width + nx] = true;
|
||||
stack.push((nx, ny));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if bbox.area() > 200 {
|
||||
boxes.push(bbox);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
boxes
|
||||
}
|
||||
|
||||
/// 在矩形 `[x0,x1) × [y0,y1)` 内数某颜色的像素（按行/列取证用）。
|
||||
pub(super) fn count_in(
|
||||
&self,
|
||||
color: [u8; 3],
|
||||
x0: usize,
|
||||
x1: usize,
|
||||
y0: usize,
|
||||
y1: usize,
|
||||
) -> usize {
|
||||
(y0..y1.min(self.height))
|
||||
.map(|y| {
|
||||
(x0..x1.min(self.width))
|
||||
.filter(|x| matches(self.at(*x, y), color))
|
||||
.count()
|
||||
})
|
||||
.sum()
|
||||
}
|
||||
|
||||
/// `bbox` 内某颜色的墨迹外接框（量字形用）。
|
||||
///
|
||||
/// 内缩 3px：不内缩会把按钮自身的抗锯齿边算成墨迹（实测把 24 盒字形量成 40）。
|
||||
pub(super) fn ink_inside(&self, bbox: &BBox, color: [u8; 3]) -> Option<BBox> {
|
||||
const MARGIN: usize = 3;
|
||||
let mut ink: Option<BBox> = None;
|
||||
for y in (bbox.top + MARGIN)..=(bbox.bottom - MARGIN) {
|
||||
for x in (bbox.left + MARGIN)..=(bbox.right - MARGIN) {
|
||||
if matches(self.at(x, y), color) {
|
||||
match &mut ink {
|
||||
Some(found) => found.include(x, y),
|
||||
None => ink = Some(BBox::new(x, y)),
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
ink
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个外接框（闭区间）。
|
||||
#[derive(Debug, Clone, Copy)]
|
||||
#[allow(clippy::struct_field_names)]
|
||||
pub(super) struct BBox {
|
||||
pub(super) left: usize,
|
||||
pub(super) right: usize,
|
||||
pub(super) top: usize,
|
||||
pub(super) bottom: usize,
|
||||
}
|
||||
|
||||
impl BBox {
|
||||
pub(super) fn new(x: usize, y: usize) -> Self {
|
||||
Self {
|
||||
left: x,
|
||||
right: x,
|
||||
top: y,
|
||||
bottom: y,
|
||||
}
|
||||
}
|
||||
|
||||
pub(super) fn include(&mut self, x: usize, y: usize) {
|
||||
self.left = self.left.min(x);
|
||||
self.right = self.right.max(x);
|
||||
self.top = self.top.min(y);
|
||||
self.bottom = self.bottom.max(y);
|
||||
}
|
||||
|
||||
pub(super) fn width(&self) -> usize {
|
||||
self.right - self.left + 1
|
||||
}
|
||||
|
||||
pub(super) fn height(&self) -> usize {
|
||||
self.bottom - self.top + 1
|
||||
}
|
||||
|
||||
pub(super) fn area(&self) -> usize {
|
||||
self.width() * self.height()
|
||||
}
|
||||
}
|
||||
|
||||
/// `pixel` 更接近 `fill` 还是 `surface`。
|
||||
pub(super) fn nearer(pixel: [u8; 3], fill: [u8; 3], surface: [u8; 3]) -> bool {
|
||||
let dist = |a: [u8; 3], b: [u8; 3]| -> u32 {
|
||||
a.iter()
|
||||
.zip(b)
|
||||
.map(|(x, y)| (i32::from(*x) - i32::from(y)).unsigned_abs())
|
||||
.sum()
|
||||
};
|
||||
dist(pixel, fill) < dist(pixel, surface)
|
||||
}
|
||||
@@ -0,0 +1,37 @@
|
||||
//! gallery 里的选择类小节：把状态矩阵摆进 harness（**断言不在这里**）。
|
||||
//!
|
||||
//! 矩阵本体的构造在 [`selection::matrix`]（12 行 × 5 列：checkbox 四态 / radio / switch /
|
||||
//! chip 三类），消息用 `()`（矩阵只供视觉验收），这里一次 `.map(..)` 接成 `DemoMessage`。
|
||||
//!
|
||||
//! ## 渲染层几何断言去哪了
|
||||
//!
|
||||
//! 在 [`crate::app::components::selection::probe`]（`selection/probe.rs`）。挪出去的原因是
|
||||
//! 400 行红线（复审 P2-5 同一类问题）：断言 + 像素扫描会把这个文件顶到 458 行。
|
||||
//!
|
||||
//! 跑法（worktree 根目录）：
|
||||
//!
|
||||
//! ```text
|
||||
//! ULL_GALLERY_SECTION=selection ./target/debug/unlucky-launcher-iced --software-renderer \
|
||||
//! --screen=gallery --screenshot target/m76/selection-light.png --screenshot-theme=light
|
||||
//! ULL_GALLERY_SHOT=target/m76/selection-light.png cargo test -p unlucky-app-iced selection::probe
|
||||
//! ```
|
||||
|
||||
use iced::widget::column;
|
||||
use iced::Element;
|
||||
|
||||
use super::super::selection;
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::DemoMessage;
|
||||
|
||||
/// 选择类家族的小节：标题 + 矩阵 + 图例。
|
||||
pub(super) fn section<'a>(ui: &'a Ui) -> Element<'a, DemoMessage> {
|
||||
let pressed = |()| DemoMessage::Pressed("selection");
|
||||
column![
|
||||
selection::matrix::heading_and_note(ui).map(pressed),
|
||||
selection::matrix::matrix(ui).map(pressed),
|
||||
selection::matrix::legend(ui).map(pressed),
|
||||
]
|
||||
.spacing(ui.space(unlucky_design::spacing::Space::X2))
|
||||
.into()
|
||||
}
|
||||
@@ -0,0 +1,310 @@
|
||||
//! 组件目录的自检门禁（`src/components/**`）。
|
||||
//!
|
||||
//! 为什么要有这份：`tests/no_hardcoded_tokens.rs` 只扫**色值**和 `shell/` 的尺寸字面量，
|
||||
//! 组件库目录是后来才开的——如果不管，五条并行线会各自写回 `.width(24.0)` 与
|
||||
//! `center_x(Length::Fill)`，M68 那两个形态级错误就会被复制五份。
|
||||
//!
|
||||
//! 四条判据（每条对应一个已发生过的错误）：
|
||||
//!
|
||||
//! | 判据 | 抓的是什么 | 历史 |
|
||||
//! |---|---|---|
|
||||
//! | Q8：禁 `center_x(` / `center_y(` / `.center(` | 容器尺寸被 `Fill` 静默覆盖 | 药丸 56×32 → 88×32 |
|
||||
//! | Q9：图标必须经 `layout::fixed` / `centered_fixed` | 字形被 Button 的 Fill 撑满 | 24 的字形渲染成 46px |
|
||||
//! | T2：禁尺寸字面量 | 组件里重复定义令牌值 | rubric T2 |
|
||||
//! | 400 行 | 单文件上限（AGENTS.md §3-1） | `guards.yml` 的 file-size job |
|
||||
//!
|
||||
//! 扫描对象是**源码文本**而不是布局结果——这不是偷懒：布局结果要真窗口（CI 无桌面），
|
||||
//! 而「把尺寸交给 `center_*`」这个错误 100% 出现在源码形态里（M68 就是这样被抓的）。
|
||||
//! 像素级几何另有 `gallery::probe` 对着真截图量。
|
||||
|
||||
use std::path::{Path, PathBuf};
|
||||
|
||||
/// 单文件行数上限（AGENTS.md §3-1）。
|
||||
const MAX_LINES: usize = 400;
|
||||
|
||||
fn src_dir() -> PathBuf {
|
||||
PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("src")
|
||||
}
|
||||
|
||||
fn components_dir() -> PathBuf {
|
||||
PathBuf::from(env!("CARGO_MANIFEST_DIR"))
|
||||
.join("src")
|
||||
.join("components")
|
||||
}
|
||||
|
||||
fn rust_files(dir: &Path, collected: &mut Vec<PathBuf>) {
|
||||
let entries =
|
||||
std::fs::read_dir(dir).unwrap_or_else(|error| panic!("读不动 {}：{error}", dir.display()));
|
||||
|
||||
for entry in entries {
|
||||
let path = entry.expect("目录项读失败").path();
|
||||
if path.is_dir() {
|
||||
rust_files(&path, collected);
|
||||
} else if path.extension().is_some_and(|ext| ext == "rs") {
|
||||
collected.push(path);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 全部组件源文件（`mod.rs` 也要扫：它是共享地基，最容易混进字面量）。
|
||||
fn sources() -> Vec<(PathBuf, String)> {
|
||||
let mut files = Vec::new();
|
||||
rust_files(&components_dir(), &mut files);
|
||||
files.sort();
|
||||
|
||||
assert!(
|
||||
files.len() >= 15,
|
||||
"只扫到 {} 个组件源文件：扫描逻辑坏了，门禁等于没跑",
|
||||
files.len()
|
||||
);
|
||||
|
||||
files
|
||||
.into_iter()
|
||||
.map(|path| {
|
||||
let text = std::fs::read_to_string(&path)
|
||||
.unwrap_or_else(|error| panic!("读不动 {}：{error}", path.display()));
|
||||
(path, text)
|
||||
})
|
||||
.collect()
|
||||
}
|
||||
|
||||
/// 去掉 `#[cfg(test)]` 之后的全部内容：测试里写参考值是**应该的**（12b 的 40/24/20
|
||||
/// 必须在测试里以字面量出现，否则测不出偏离）。
|
||||
fn product_part(text: &str) -> &str {
|
||||
match text.find("#[cfg(test)]") {
|
||||
Some(at) => &text[..at],
|
||||
None => text,
|
||||
}
|
||||
}
|
||||
|
||||
/// 代码行（跳过注释行：文档里写 `.center_x(` 是在解释坑，不该判违规）。
|
||||
fn code_lines(text: &str) -> impl Iterator<Item = (usize, &str)> {
|
||||
text.lines().enumerate().filter_map(|(index, line)| {
|
||||
let trimmed = line.trim_start();
|
||||
if trimmed.starts_with("//") {
|
||||
None
|
||||
} else {
|
||||
Some((index + 1, line))
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn q8_no_center_shortcuts_that_swallow_fixed_sizes() {
|
||||
let mut offenders = Vec::new();
|
||||
|
||||
for (path, text) in sources() {
|
||||
for (line_no, line) in code_lines(product_part(&text)) {
|
||||
for pattern in ["center_x(", "center_y(", ".center("] {
|
||||
if line.contains(pattern) {
|
||||
offenders.push(format!(
|
||||
"{}:{line_no} {line}\n → {pattern} 会把容器尺寸改成 Fill（Q8），\
|
||||
居中请用父级 align_x 或 layout::centered_fixed",
|
||||
path.display()
|
||||
));
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
assert!(offenders.is_empty(), "Q8 违规：\n{}", offenders.join("\n"));
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn q9_icons_never_reach_a_button_unwrapped() {
|
||||
let mut offenders = Vec::new();
|
||||
|
||||
for (path, text) in sources() {
|
||||
let product = product_part(&text);
|
||||
// 允许两种写法：同一行里已经包在 layout:: 里；或它是 `layout::fixed(` 多行调用的实参
|
||||
// （图标常作为第 3 个参数出现在后两行，所以往回看 4 行）。
|
||||
let mut window: Vec<&str> = Vec::new();
|
||||
for (line_no, line) in code_lines(product) {
|
||||
if line.contains("icons::view") {
|
||||
let wrapped =
|
||||
line.contains("layout::fixed") || line.contains("layout::centered_fixed");
|
||||
let continued = window.iter().rev().any(|prev| {
|
||||
prev.contains("layout::fixed") || prev.contains("layout::centered_fixed")
|
||||
});
|
||||
if !wrapped && !continued {
|
||||
offenders.push(format!(
|
||||
"{}:{line_no} {line}\n → 图标必须经 layout::fixed / centered_fixed 包一层（Q9）",
|
||||
path.display()
|
||||
));
|
||||
}
|
||||
}
|
||||
if !line.trim().is_empty() {
|
||||
window.push(line);
|
||||
if window.len() > 4 {
|
||||
window.remove(0);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
assert!(offenders.is_empty(), "Q9 违规：\n{}", offenders.join("\n"));
|
||||
}
|
||||
|
||||
/// 布局调用后面直接跟数字 → 判违规（`0` 与 `0.0` 放行：0 = 无内边距/无描边）。
|
||||
fn size_literal(argument: &str) -> Option<String> {
|
||||
let mut rest = argument.trim_start();
|
||||
for wrapper in ["Length::Fixed(", "Padding::from(", "Size::new("] {
|
||||
if let Some(after) = rest.strip_prefix(wrapper) {
|
||||
rest = after.trim_start().trim_start_matches(['[', '(']);
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
let number: String = rest
|
||||
.trim_start()
|
||||
.chars()
|
||||
.take_while(|ch| ch.is_ascii_digit() || *ch == '.')
|
||||
.collect();
|
||||
|
||||
if number.is_empty() || number.trim_end_matches('.').parse::<f64>() == Ok(0.0) {
|
||||
return None;
|
||||
}
|
||||
Some(number)
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn t2_no_size_literals_in_components() {
|
||||
let mut offenders = Vec::new();
|
||||
|
||||
for (path, text) in sources() {
|
||||
for (line_no, line) in code_lines(product_part(&text)) {
|
||||
for pattern in [".width(", ".height(", ".size(", ".spacing(", ".padding("] {
|
||||
let mut from = 0;
|
||||
while let Some(found) = line[from..].find(pattern) {
|
||||
let after = from + found + pattern.len();
|
||||
if let Some(number) = size_literal(&line[after..]) {
|
||||
offenders.push(format!(
|
||||
"{}:{line_no} {line} -> {pattern} 后面写了数字 {number}",
|
||||
path.display()
|
||||
));
|
||||
}
|
||||
from = after;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
assert!(
|
||||
offenders.is_empty(),
|
||||
"组件里不许有尺寸字面量（走 LayoutMetrics / Space / ComponentMetrics）：\n{}",
|
||||
offenders.join("\n")
|
||||
);
|
||||
}
|
||||
|
||||
/// 单文件 ≤400 行：**扫整个 `src/`**，不只 components。
|
||||
///
|
||||
/// M90 r2（P1-2）的教训：这条守门原来只遍历 `components/`，于是 `pages/harness.rs` 悄悄长到
|
||||
/// 402 行没人拦，直到 `guards.yml` 的 file-size job 在 CI 上判红才发现。`guards.yml` 的口径是
|
||||
/// **全仓**（`git ls-files '*.rs' '*.md' …`），这里至少把本 crate 的 `src/**` 对齐：
|
||||
/// 谁在 `app/` / `pages/` / `shell/` 把文件推过线，`cargo test` 就先红，不用等 CI。
|
||||
#[test]
|
||||
fn every_source_file_stays_under_the_line_limit() {
|
||||
let mut files = Vec::new();
|
||||
rust_files(&src_dir(), &mut files);
|
||||
assert!(
|
||||
files.len() >= 40,
|
||||
"src/ 至少 40 个 .rs，实际 {}：扫描逻辑坏了，这条门禁等于没跑",
|
||||
files.len()
|
||||
);
|
||||
|
||||
let mut offenders = Vec::new();
|
||||
for path in files {
|
||||
let text = std::fs::read_to_string(&path).expect("读源文件");
|
||||
let lines = text.lines().count();
|
||||
if lines > MAX_LINES {
|
||||
offenders.push(format!(
|
||||
"{}: {lines} 行（上限 {MAX_LINES}）",
|
||||
path.display()
|
||||
));
|
||||
}
|
||||
}
|
||||
assert!(
|
||||
offenders.is_empty(),
|
||||
"单文件 ≤400 行（AGENTS.md §3-1，guards.yml 按全仓判红）：\n{}",
|
||||
offenders.join("\n")
|
||||
);
|
||||
}
|
||||
|
||||
/// 四个家族目录必须存在且结构完整。
|
||||
///
|
||||
/// **这里刻意不再限制「pub fn 有几个」**：M76 往 `selection/` 里加 Checkbox/Radio 是它的本职工作，
|
||||
/// 而家族线被明确要求不许改 `gate.rs`——把「桩还在不在」写成 pub fn 计数，等于给 M76 埋一个
|
||||
/// 它无权拆的地雷（reviewer P1-C）。越界与否由 merge gate 的 scope 判定（各家族目录只归对应
|
||||
/// mission），门禁只管「地基还在」：
|
||||
///
|
||||
/// - 四个家族目录各有 `mod.rs`；
|
||||
/// - `components/mod.rs` 仍声明这五个家族 + gallery（谁把声明删了，这里先红）。
|
||||
#[test]
|
||||
fn the_five_families_are_declared_and_present() {
|
||||
let declared =
|
||||
std::fs::read_to_string(components_dir().join("mod.rs")).expect("读 components/mod.rs");
|
||||
|
||||
for family in ["selection", "inputs", "feedback", "navigation"] {
|
||||
let dir = components_dir().join(family);
|
||||
let file = dir.join("mod.rs");
|
||||
assert!(file.is_file(), "家族目录 {} 缺 mod.rs", dir.display());
|
||||
assert!(
|
||||
declared.contains(&format!("pub mod {family};")),
|
||||
"components/mod.rs 少了 `pub mod {family};` 声明"
|
||||
);
|
||||
}
|
||||
assert!(
|
||||
declared.contains("pub mod gallery;") && declared.contains("pub mod buttons;"),
|
||||
"components/mod.rs 的声明被动了"
|
||||
);
|
||||
}
|
||||
|
||||
/// gallery 的五个家族文件必须都在（`mod.rs` 声明了它们，缺一个就编译不过——
|
||||
/// 这条在并行线删文件/改名时给出人话，而不是一堆 `unresolved module`）。
|
||||
#[test]
|
||||
fn gallery_keeps_one_file_per_family() {
|
||||
for family in ["buttons", "selection", "inputs", "feedback", "navigation"] {
|
||||
let path = components_dir()
|
||||
.join("gallery")
|
||||
.join(format!("{family}.rs"));
|
||||
assert!(
|
||||
path.is_file(),
|
||||
"gallery 缺 {}（本文件结构是并行地基）",
|
||||
path.display()
|
||||
);
|
||||
|
||||
let text = std::fs::read_to_string(&path).expect("读 gallery 家族文件");
|
||||
assert!(
|
||||
text.contains("fn section"),
|
||||
"{} 必须提供 section()（gallery/mod.rs 调它）",
|
||||
path.display()
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 门禁自身不能空转：造几个违规样本喂给判据。
|
||||
#[test]
|
||||
fn the_gate_catches_planted_violations() {
|
||||
assert_eq!(
|
||||
size_literal("Length::Fixed(40.0))").as_deref(),
|
||||
Some("40.0")
|
||||
);
|
||||
assert_eq!(size_literal("0)").as_deref(), None);
|
||||
assert_eq!(
|
||||
size_literal("ui.metrics().control_height)").as_deref(),
|
||||
None
|
||||
);
|
||||
assert!(product_part("a\n#[cfg(test)]\n.width(40.0)\n")
|
||||
.find(".width(40.0)")
|
||||
.is_none());
|
||||
assert!(product_part("a\n.width(40.0)\n")
|
||||
.find(".width(40.0)")
|
||||
.is_some());
|
||||
// Q8 判据本身
|
||||
for code in ["x.center_x(Length::Fill)", "x.center(Length::Fill)"] {
|
||||
assert!(
|
||||
code.contains("center_x(") || code.contains(".center("),
|
||||
"判据写坏了"
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,398 @@
|
||||
//! 文本框（`research/12b` §9）：Filled / Outlined 两式，**受控组件**。
|
||||
//!
|
||||
//! ## 参考值（`[源]` = A1，本机 `material3-android:1.4.0` 的 `*TextFieldTokens` + `TextFieldDefaults`）
|
||||
//!
|
||||
//! | # | 检查项 | 参考值 | 落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 9.1 | 高度 | min **56**（带标签）；无标签单行本项目 **40** | `FIELD_HEIGHT`（G16）/ `LM.control_height` |
|
||||
//! | 9.2 | 最小宽 | **280** → **G21 未施加**（iced 的 `Length` 无 min-width，同按钮 G15） | 文档 |
|
||||
//! | 9.3 | 形状 | Outlined **4**；Filled 顶圆角 4、底直角 | `Component::TextField.spec().shape` |
|
||||
//! | 9.4 | 描边 / 指示线 | Outlined 静息 1dp `Outline` → hover 1dp `OnSurface` → 聚焦 **2dp `Primary`**；Filled 底指示线静息 `OnSurfaceVariant` | [`Filled`] / [`Palette`] |
|
||||
//! | 9.5 | 字级 | 输入/标签 `BodyLarge 16/24`；辅助/错误 `BodySmall 12/16` | `TypeRole` |
|
||||
//! | 9.6 | 图标 | 前后 **24**、`OnSurfaceVariant`；图标可视边 **12**、文本从 **48** 起 | `FieldGeometry` |
|
||||
//! | 9.7 | 错误态 | 线/标签/辅助文本全 **`Error`**、线宽 **2dp** | [`Field::error`] |
|
||||
//! | 9.8 | 禁用态 | Filled 容器 `OnSurface`@**4%**（→ 令牌只有 12%，**登记偏离 D10**）；Outlined 描边 `OnSurface`@**12%**；内容 @**38%** | `interaction::*` |
|
||||
//!
|
||||
//! ## 三处口径说明
|
||||
//!
|
||||
//! 1. **状态差异落在指示线/描边/标签上，容器底色不叠状态层**（A1 的口径，与按钮家族的 8%/10% 状态层不同）；press 无独立 token，按 hover 处理（D11）。
|
||||
//! 2. 标签是「**常浮起**」的两段式（占上面 16px，不做上浮动画，登记 D12）；缺省宽度 `Fill`（最小宽 280 无法在 iced 表达，G21）。
|
||||
|
||||
use iced::widget::text::LineHeight;
|
||||
use iced::widget::{column, container, row, text, text_input};
|
||||
use iced::{Alignment, Background, Border, Color, Element, Length, Padding, Pixels};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::icons;
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::interaction::{self, Interaction};
|
||||
use super::super::layout;
|
||||
use super::geometry::FieldGeometry;
|
||||
|
||||
/// 两式容器（12b 9.3 / 9.4 的差别：Filled 有容器色 + 底部指示线；Outlined 只有描边）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||
pub enum FieldVariant {
|
||||
/// 实心：`SurfaceContainerHighest` + 底部指示线，顶圆角 4 底直角。
|
||||
Filled,
|
||||
/// 描边：透明容器 + 1dp `Outline`，四角 4。
|
||||
Outlined,
|
||||
}
|
||||
|
||||
impl FieldVariant {
|
||||
/// 两式全序（gallery 的行序）。
|
||||
pub const ALL: [FieldVariant; 2] = [FieldVariant::Filled, FieldVariant::Outlined];
|
||||
|
||||
/// 稳定名字（图例 / 测试信息）。
|
||||
pub const fn name(self) -> &'static str {
|
||||
match self {
|
||||
FieldVariant::Filled => "filled",
|
||||
FieldVariant::Outlined => "outlined",
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个文本框的装配描述（不持有 `String`：受控组件只借值，契约 §2）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct Field<'a> {
|
||||
variant: FieldVariant,
|
||||
value: &'a str,
|
||||
label: Option<&'a str>,
|
||||
placeholder: &'a str,
|
||||
supporting: Option<&'a str>,
|
||||
leading: Option<IconKind>,
|
||||
trailing: Option<IconKind>,
|
||||
error: bool,
|
||||
state: Option<Interaction>,
|
||||
width: Length,
|
||||
secure: bool,
|
||||
}
|
||||
|
||||
impl<'a> Field<'a> {
|
||||
/// 一个 Filled 文本框。
|
||||
pub fn new(value: &'a str) -> Self {
|
||||
Self {
|
||||
variant: FieldVariant::Filled,
|
||||
value,
|
||||
label: None,
|
||||
placeholder: "",
|
||||
supporting: None,
|
||||
leading: None,
|
||||
trailing: None,
|
||||
error: false,
|
||||
state: None,
|
||||
width: Length::Fill,
|
||||
secure: false,
|
||||
}
|
||||
}
|
||||
|
||||
/// 选式（Filled / Outlined）。
|
||||
pub fn variant(mut self, variant: FieldVariant) -> Self {
|
||||
self.variant = variant;
|
||||
self
|
||||
}
|
||||
|
||||
/// 浮动标签（`BodySmall`，常浮起，见模块文档第 2 条）。
|
||||
pub fn label(mut self, label: &'a str) -> Self {
|
||||
self.label = Some(label);
|
||||
self
|
||||
}
|
||||
|
||||
/// 占位文案（只在值为空时可见，`OnSurfaceVariant`）。
|
||||
pub fn placeholder(mut self, placeholder: &'a str) -> Self {
|
||||
self.placeholder = placeholder;
|
||||
self
|
||||
}
|
||||
|
||||
/// 辅助/错误说明（字段下方 `BodySmall`）。
|
||||
pub fn supporting(mut self, supporting: &'a str) -> Self {
|
||||
self.supporting = Some(supporting);
|
||||
self
|
||||
}
|
||||
|
||||
/// 前置图标（24，图标可视边 12）。
|
||||
pub fn leading(mut self, kind: IconKind) -> Self {
|
||||
self.leading = Some(kind);
|
||||
self
|
||||
}
|
||||
|
||||
/// 后置图标（24，右侧内边距 16）。
|
||||
pub fn trailing(mut self, kind: IconKind) -> Self {
|
||||
self.trailing = Some(kind);
|
||||
self
|
||||
}
|
||||
|
||||
/// 错误态：线 / 标签 / 辅助文本转 `Error`，线宽 2dp（9.7）。
|
||||
pub fn error(mut self) -> Self {
|
||||
self.error = true;
|
||||
self
|
||||
}
|
||||
|
||||
/// 强制视觉态（gallery 状态矩阵取证；运行期不要调）。
|
||||
pub fn state(mut self, state: Interaction) -> Self {
|
||||
self.state = Some(state);
|
||||
self
|
||||
}
|
||||
|
||||
/// 定宽（默认 `Fill`；gallery 的矩阵格用它钉宽度）。
|
||||
pub fn width(mut self, width: Length) -> Self {
|
||||
self.width = width;
|
||||
self
|
||||
}
|
||||
|
||||
/// 密码式输入（M114）：上屏是掩码（明文上屏＝UI 侧凭据泄漏）。
|
||||
pub fn secure(mut self, secure: bool) -> Self {
|
||||
self.secure = secure;
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个字段在某一态下的全套颜色（9.4 / 9.7 / 9.8 的落点）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
struct Palette {
|
||||
/// 容器底色；`None` = 透明（Outlined）。
|
||||
fill: Option<Color>,
|
||||
/// 描边/指示线色。
|
||||
line: Color,
|
||||
/// 描边/指示线宽（1 或 2）。
|
||||
stroke: f32,
|
||||
/// 标签（`BodySmall`）。
|
||||
label: Color,
|
||||
/// 输入文本。
|
||||
input: Color,
|
||||
/// 前后图标。
|
||||
icon: Color,
|
||||
/// 辅助文本。
|
||||
supporting: Color,
|
||||
/// 占位文本。
|
||||
placeholder: Color,
|
||||
}
|
||||
|
||||
/// 解析某一态的颜色（**唯一**做角色映射的地方）。
|
||||
fn palette(ui: &Ui, variant: FieldVariant, state: Interaction, error: bool) -> Palette {
|
||||
let geometry = FieldGeometry::of(ui, true, None);
|
||||
|
||||
if state.is_disabled() {
|
||||
// 9.8：内容一律 OnSurface@38%；Filled 容器叠 12%（官方 4%，令牌无 4% 档 → D10）；
|
||||
// Outlined 描边正好是官方 12%。
|
||||
let container = interaction::disabled_colors(ui, Role::Surface).0;
|
||||
let ink = interaction::disabled_content_over_role(
|
||||
ui,
|
||||
Role::OnSurface,
|
||||
matches!(variant, FieldVariant::Filled),
|
||||
);
|
||||
return Palette {
|
||||
fill: match variant {
|
||||
FieldVariant::Filled => Some(container),
|
||||
FieldVariant::Outlined => None,
|
||||
},
|
||||
line: match variant {
|
||||
FieldVariant::Filled => ink,
|
||||
FieldVariant::Outlined => container,
|
||||
},
|
||||
stroke: geometry.stroke,
|
||||
label: ink,
|
||||
input: ink,
|
||||
icon: ink,
|
||||
supporting: ink,
|
||||
placeholder: ink,
|
||||
};
|
||||
}
|
||||
|
||||
let focused = matches!(state, Interaction::Focused);
|
||||
let hovered = matches!(state, Interaction::Hovered | Interaction::Pressed);
|
||||
|
||||
let (line, stroke) = if error {
|
||||
(ui.color(Role::Error), geometry.focus_stroke)
|
||||
} else if focused {
|
||||
(ui.color(Role::Primary), geometry.focus_stroke)
|
||||
} else if hovered {
|
||||
(ui.color(Role::OnSurface), geometry.stroke)
|
||||
} else {
|
||||
(
|
||||
match variant {
|
||||
FieldVariant::Filled => ui.color(Role::OnSurfaceVariant),
|
||||
FieldVariant::Outlined => ui.color(Role::Outline),
|
||||
},
|
||||
geometry.stroke,
|
||||
)
|
||||
};
|
||||
|
||||
Palette {
|
||||
fill: match variant {
|
||||
FieldVariant::Filled => Some(ui.color(Role::SurfaceContainerHighest)),
|
||||
FieldVariant::Outlined => None,
|
||||
},
|
||||
line,
|
||||
stroke,
|
||||
label: if error {
|
||||
ui.color(Role::Error)
|
||||
} else if focused {
|
||||
ui.color(Role::Primary)
|
||||
} else {
|
||||
ui.color(Role::OnSurfaceVariant)
|
||||
},
|
||||
input: ui.color(Role::OnSurface),
|
||||
icon: if error {
|
||||
ui.color(Role::Error)
|
||||
} else {
|
||||
ui.color(Role::OnSurfaceVariant)
|
||||
},
|
||||
supporting: if error {
|
||||
ui.color(Role::Error)
|
||||
} else {
|
||||
ui.color(Role::OnSurfaceVariant)
|
||||
},
|
||||
placeholder: ui.color(Role::OnSurfaceVariant),
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个文本框（Filled / Outlined 由 [`Field::variant`] 选）。
|
||||
///
|
||||
/// 受控：值由外部持有，输入经 `on_input` 回传；`state` 强制成 `Disabled` 时输入被摘掉
|
||||
/// （`on_input_maybe(None)`），所以禁用字段真的点不动，不只是变灰。
|
||||
pub fn text_field<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
field: Field<'a>,
|
||||
on_input: impl Fn(String) -> M + 'a,
|
||||
) -> Element<'a, M> {
|
||||
let geometry = FieldGeometry::of(ui, field.label.is_some(), field.leading);
|
||||
let state = field.state.unwrap_or(Interaction::Enabled);
|
||||
let colors = palette(ui, field.variant, state, field.error);
|
||||
|
||||
let input_style = ui.style(TypeRole::BodyLarge);
|
||||
let label_style = ui.style(TypeRole::BodySmall);
|
||||
|
||||
let text_input = text_input(field.placeholder, field.value)
|
||||
.on_input_maybe(if state.is_disabled() {
|
||||
None
|
||||
} else {
|
||||
Some(on_input)
|
||||
})
|
||||
.secure(field.secure)
|
||||
.size(input_style.size_px)
|
||||
.line_height(LineHeight::Absolute(Pixels(input_style.line_height_px)))
|
||||
.font(ui.font_of(input_style))
|
||||
.padding(Padding::default())
|
||||
.width(Length::Fill)
|
||||
.style(move |_theme, _status| text_input::Style {
|
||||
background: Background::Color(Color::TRANSPARENT),
|
||||
border: Border::default(),
|
||||
icon: colors.icon,
|
||||
placeholder: colors.placeholder,
|
||||
value: colors.input,
|
||||
selection: colors.line,
|
||||
});
|
||||
|
||||
let mut content = row![].align_y(Alignment::Center).spacing(geometry.icon_gap);
|
||||
if let Some(kind) = field.leading {
|
||||
// Q9：图标必须经固定尺寸容器，否则会被 Fill 约束撑满（M68 的 46px 字形）
|
||||
content = content.push(layout::fixed(
|
||||
geometry.icon,
|
||||
geometry.icon,
|
||||
icons::view::<M>(kind, colors.icon),
|
||||
));
|
||||
}
|
||||
content = content.push(text_input);
|
||||
if let Some(kind) = field.trailing {
|
||||
content = content.push(layout::fixed(
|
||||
geometry.icon,
|
||||
geometry.icon,
|
||||
icons::view::<M>(kind, colors.icon),
|
||||
));
|
||||
}
|
||||
|
||||
let label = field.label.map(|label| {
|
||||
text(label)
|
||||
.size(label_style.size_px)
|
||||
.line_height(LineHeight::Absolute(Pixels(label_style.line_height_px)))
|
||||
.font(ui.font_of(label_style))
|
||||
.color(colors.label)
|
||||
});
|
||||
|
||||
// 内容块：带标签 = [标签 16 + 输入 24] 共 40，居中在内容区里；无标签 = 单行 24 居中。
|
||||
// **垂直居中交给容器**（Q8 的教训：不要指望子元素自己贴边）。
|
||||
let inner: Element<'a, M> = match label {
|
||||
Some(label) => column![label, content].width(Length::Fill).into(),
|
||||
None => content.into(),
|
||||
};
|
||||
let content_area = container(inner)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fill)
|
||||
.align_y(Alignment::Center)
|
||||
.padding(Padding {
|
||||
top: 0.0,
|
||||
right: geometry.padding.right,
|
||||
bottom: 0.0,
|
||||
left: geometry.padding.left,
|
||||
});
|
||||
|
||||
// Filled：容器色 + **底部指示线**（静息 1dp / 聚焦与错误 2dp）；Outlined：透明 + 描边。
|
||||
// 指示线占容器底边那 1~2px（内容区因此少 1~2px，官方也是画在 padding-box 底边上的）。
|
||||
let body: Element<'a, M> = match field.variant {
|
||||
FieldVariant::Filled => {
|
||||
let indicator = container(iced::widget::space::horizontal())
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(colors.stroke))
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(colors.line)),
|
||||
..container::Style::default()
|
||||
});
|
||||
column![content_area, indicator].into()
|
||||
}
|
||||
FieldVariant::Outlined => content_area.into(),
|
||||
};
|
||||
|
||||
let border = Border {
|
||||
color: if matches!(field.variant, FieldVariant::Outlined) {
|
||||
colors.line
|
||||
} else {
|
||||
Color::TRANSPARENT
|
||||
},
|
||||
width: if matches!(field.variant, FieldVariant::Outlined) {
|
||||
colors.stroke
|
||||
} else {
|
||||
0.0
|
||||
},
|
||||
// Filled 是「顶圆角 4、底直角」= CornerExtraSmallTop；ShapeScale 没有「部分角」，
|
||||
// 这里按官方语义手工指定上下角（登记 D13）。
|
||||
radius: match field.variant {
|
||||
FieldVariant::Filled => iced::border::Radius {
|
||||
top_left: ui.radius_dp(geometry.shape).top_left,
|
||||
top_right: ui.radius_dp(geometry.shape).top_right,
|
||||
bottom_left: 0.0,
|
||||
bottom_right: 0.0,
|
||||
},
|
||||
FieldVariant::Outlined => ui.radius_dp(geometry.shape),
|
||||
},
|
||||
};
|
||||
|
||||
let field_el: Element<'a, M> = container(body)
|
||||
.width(field.width)
|
||||
.height(Length::Fixed(geometry.height))
|
||||
.style(move |_theme| container::Style {
|
||||
background: colors.fill.map(Background::Color),
|
||||
border,
|
||||
..container::Style::default()
|
||||
})
|
||||
.into();
|
||||
|
||||
match field.supporting {
|
||||
Some(supporting) => {
|
||||
let note = text(supporting)
|
||||
.size(label_style.size_px)
|
||||
.line_height(LineHeight::Absolute(Pixels(label_style.line_height_px)))
|
||||
.font(ui.font_of(label_style))
|
||||
.color(colors.supporting);
|
||||
column![field_el, layout::inset(0.0, ui.space(Space::X1), note)].into()
|
||||
}
|
||||
None => field_el,
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
@@ -0,0 +1,115 @@
|
||||
//! field 的单测（从 `field.rs` 拆出：单文件 ≤400 行，AGENTS.md §3-1）。
|
||||
|
||||
use super::*;
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
fn build(field: Field<'_>, flavor: SchemeFlavor) -> Element<'_, u8> {
|
||||
let ui = Box::leak(Box::new(ui(flavor)));
|
||||
text_field(ui, field, |_| 0_u8)
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn every_variant_and_state_builds() {
|
||||
for variant in FieldVariant::ALL {
|
||||
for state in Interaction::ALL {
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let field = Field::new("实例一")
|
||||
.variant(variant)
|
||||
.label("名称")
|
||||
.placeholder("请输入")
|
||||
.supporting("辅助说明")
|
||||
.leading(IconKind::Folder)
|
||||
.trailing(IconKind::Close)
|
||||
.state(state);
|
||||
let _: Element<'_, u8> = build(field, flavor);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 9.4：聚焦 2dp `Primary`、hover 1dp `OnSurface`、静息 Outlined 1dp `Outline`（Filled 用 OnSurfaceVariant）。
|
||||
#[test]
|
||||
fn outline_colors_and_widths_follow_the_state() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
let rest = palette(&ui, FieldVariant::Outlined, Interaction::Enabled, false);
|
||||
assert_eq!(rest.line, ui.color(Role::Outline));
|
||||
assert_eq!(rest.stroke, 1.0);
|
||||
assert_eq!(rest.fill, None, "Outlined 无容器色");
|
||||
|
||||
let hover = palette(&ui, FieldVariant::Outlined, Interaction::Hovered, false);
|
||||
assert_eq!(hover.line, ui.color(Role::OnSurface));
|
||||
assert_eq!(hover.stroke, 1.0);
|
||||
|
||||
let focus = palette(&ui, FieldVariant::Outlined, Interaction::Focused, false);
|
||||
assert_eq!(focus.line, ui.color(Role::Primary));
|
||||
assert_eq!(focus.stroke, 2.0, "FocusOutlineWidth = 2dp");
|
||||
assert_eq!(focus.label, ui.color(Role::Primary), "FocusLabelColor");
|
||||
|
||||
// A1 没有 Pressed token：按 hover 处理（D11），不是漏做
|
||||
assert_eq!(
|
||||
palette(&ui, FieldVariant::Outlined, Interaction::Pressed, false),
|
||||
hover
|
||||
);
|
||||
}
|
||||
|
||||
/// 9.7：错误态线/标签/辅助全 `Error`，线宽 2dp；错误优先于聚焦。
|
||||
#[test]
|
||||
fn error_beats_focus_and_paints_everything_error() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
let error = palette(&ui, FieldVariant::Outlined, Interaction::Focused, true);
|
||||
assert_eq!(error.line, ui.color(Role::Error));
|
||||
assert_eq!(error.label, ui.color(Role::Error));
|
||||
assert_eq!(error.supporting, ui.color(Role::Error));
|
||||
assert_eq!(error.stroke, 2.0, "错误线宽 2dp");
|
||||
assert_eq!(error.input, ui.color(Role::OnSurface), "ErrorInputColor");
|
||||
}
|
||||
|
||||
/// 9.8：禁用内容 38%、Outlined 描边 12%、Filled 容器 12%（官方 4%，令牌缺口 → D10）。
|
||||
#[test]
|
||||
fn disabled_uses_the_token_alphas() {
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let ui = ui(flavor);
|
||||
let container = interaction::disabled_colors(&ui, Role::Surface).0;
|
||||
|
||||
let filled = palette(&ui, FieldVariant::Filled, Interaction::Disabled, false);
|
||||
assert_eq!(filled.fill, Some(container));
|
||||
assert_eq!(
|
||||
filled.input,
|
||||
interaction::disabled_content_over_role(&ui, Role::OnSurface, true)
|
||||
);
|
||||
|
||||
let outlined = palette(&ui, FieldVariant::Outlined, Interaction::Disabled, false);
|
||||
assert_eq!(outlined.fill, None);
|
||||
assert_eq!(outlined.line, container, "DisabledOutlineOpacity = 0.12");
|
||||
assert_eq!(
|
||||
outlined.input,
|
||||
interaction::disabled_content_over_role(&ui, Role::OnSurface, false)
|
||||
);
|
||||
assert_ne!(outlined.input, ui.color(Role::OnSurface), "禁用不许满档");
|
||||
}
|
||||
}
|
||||
|
||||
/// Filled 有容器色、Outlined 没有；两者圆角都取 `Component::TextField`（4）。
|
||||
#[test]
|
||||
fn filled_carries_the_container_role() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
assert_eq!(
|
||||
palette(&ui, FieldVariant::Filled, Interaction::Enabled, false).fill,
|
||||
Some(ui.color(Role::SurfaceContainerHighest)),
|
||||
"FilledTextFieldTokens.ContainerColor"
|
||||
);
|
||||
assert_eq!(FieldGeometry::of(&ui, true, None).shape.dp(), 4.0);
|
||||
}
|
||||
@@ -0,0 +1,309 @@
|
||||
//! 输入类家族的**内部几何**：能取令牌的一律取令牌，取不到的登记 G 编号后集中在这里。
|
||||
//!
|
||||
//! ## 为什么这个文件存在
|
||||
//!
|
||||
//! `components::gate` 的 `t2_no_size_literals_in_components` 扫 `.width(40.0)` 这类**调用点字面量**；
|
||||
//! 但「TextField 高 56」这种 A 级参考值在 `LayoutMetrics` / `ComponentMetrics` 里确实没有落点
|
||||
//! （令牌层是另一条 mission 的 scope，不许我改）。所以按契约 §6.2：**登记 G 编号 + 只在这个文件里
|
||||
//! 定义一次**，组件实现一个数字都不写。
|
||||
//!
|
||||
//! ## 参考值表（`[源]` = A1，本机 `material3-android:1.4.0` 的 token 源码；`[估]` = 团队口径）
|
||||
//!
|
||||
//! | G | 名称 | 参考值 | 出处 | 本文件落点 |
|
||||
//! |---|---|---|---|---|
|
||||
//! | G16 | TextField 可见高（带标签） | **56** | `TextFieldDefaults.MinHeight` / `OutlinedTextFieldTokens.ContainerHeight` | [`FIELD_HEIGHT`] |
|
||||
//! | G17 | 聚焦/错误描边 | **2** | `OutlinedTextFieldTokens.FocusOutlineWidth`、`FilledTextFieldTokens.FocusActiveIndicatorHeight` | [`FOCUS_STROKE`] |
|
||||
//! | G18 | Slider 轨道 / 竖条 / 停靠点 | **16 / 4×44 / 4** | `SliderTokens.ActiveTrackHeight` / `HandleWidth`+`HandleHeight` / `StopIndicatorSize` | [`TRACK_HEIGHT`] 等 |
|
||||
//! | G19 | 菜单项高 | **48** | `Menu.kt:524 MenuListItemContainerHeight` | [`MENU_ITEM_HEIGHT`] |
|
||||
//! | G20 | Search 宽高 | **min 360 / max 720 / 面板最小 240** | `SearchBar.kt:2712-2713`、`DockedExpandedTableMinHeight` | [`SEARCH_MIN_WIDTH`] 等 |
|
||||
//!
|
||||
//! **已经能取令牌、不许在这里重复定义的**（同一数值只许一份，见 `ComponentMetrics` 模块文档）：
|
||||
//! 搜索条高 56 = `LayoutMetrics::search_bar_height`；无标签单行 40 = `LayoutMetrics::control_height`；
|
||||
//! 命中区 48 = `LayoutMetrics::touch_target`；水平/上下内边距与图标间距 = `Space::{X2,X3,X4}`；
|
||||
//! 图标 24 = `IconSize::Toolbar`；圆角 = `ComponentSpec::shape`（TextField/Menu = 4，Search = Full，
|
||||
//! SearchView = ExtraLarge 28）；一像素线 = `stroke::HAIRLINE`。
|
||||
//!
|
||||
//! ## 与文档的两处口径冲突（按「代码优先」处理，报告里有偏离登记）
|
||||
//!
|
||||
//! 1. `12b §8.1` 说菜单圆角「本项目 12（偏离官方 4）」；令牌表 `Component::Menu.spec().shape`
|
||||
//! 是 `ExtraSmall`（**4**）。令牌层是 M69 定案的真源，本实现取 **4**，不取 12。
|
||||
//! 2. `12b §9.1` 说「无标签单行 40」是登记偏离——40 正好是 `LM.control_height`，
|
||||
//! 所以那条偏离在实现上是「用骨架令牌」而不是「用字面量」。
|
||||
|
||||
use iced::Padding;
|
||||
|
||||
use unlucky_design::component_map::Component;
|
||||
use unlucky_design::icons::{IconKind, IconSize};
|
||||
use unlucky_design::shape::ShapeScale;
|
||||
use unlucky_design::spacing::Space;
|
||||
|
||||
use crate::theme::{Ui, STROKE_PX};
|
||||
|
||||
/// G16：文本字段可见高（带浮动标签）。
|
||||
pub const FIELD_HEIGHT: f32 = 56.0;
|
||||
|
||||
/// G17：聚焦/错误态的描边与指示线宽（官方 2dp；令牌层的 `stroke::HAIRLINE` 只有 1dp）。
|
||||
pub const FOCUS_STROKE: f32 = 2.0;
|
||||
|
||||
/// G18：Slider 轨道高（激活/未激活同值）。
|
||||
pub const TRACK_HEIGHT: f32 = 16.0;
|
||||
|
||||
/// G18：Slider 竖条 handle 宽（静息 / hover）。
|
||||
pub const HANDLE_WIDTH: f32 = 4.0;
|
||||
|
||||
/// G18：Slider 竖条 handle 宽（focus / pressed）——A1 在这两态收窄到 2。
|
||||
pub const HANDLE_WIDTH_ACTIVE: f32 = 2.0;
|
||||
|
||||
/// G18：Slider 竖条 handle 高（纵向溢出轨道，上下各 14）。
|
||||
pub const HANDLE_HEIGHT: f32 = 44.0;
|
||||
|
||||
/// G18：离散停靠点直径。
|
||||
pub const STOP_SIZE: f32 = 4.0;
|
||||
|
||||
/// G18：停靠点与轨道段之间的空隙（官方 `StopIndicatorTrailingSpace = 6`；6 不在 4px 栅格上）。
|
||||
pub const STOP_GAP: f32 = 6.0;
|
||||
|
||||
/// G19：菜单项高。
|
||||
pub const MENU_ITEM_HEIGHT: f32 = 48.0;
|
||||
|
||||
/// G20：搜索条最小宽（列宽不足时**不许压窄**，降级为 40 高 TextField 或 icon 入口）。
|
||||
pub const SEARCH_MIN_WIDTH: f32 = 360.0;
|
||||
|
||||
/// G20：搜索条最大宽。
|
||||
pub const SEARCH_MAX_WIDTH: f32 = 720.0;
|
||||
|
||||
/// G20：展开面板最小高（空结果也不许矮于它）。
|
||||
pub const SEARCH_VIEW_MIN_HEIGHT: f32 = 240.0;
|
||||
|
||||
/// 文本字段的几何（Filled / Outlined 共用；差别只在颜色与形状）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct FieldGeometry {
|
||||
/// 可见高：带标签 [`FIELD_HEIGHT`]，无标签 `LM.control_height`。
|
||||
pub height: f32,
|
||||
/// 内容内边距（无图标 16/16；有前置图标 12/16，图标与文本间距另算）。
|
||||
pub padding: Padding,
|
||||
/// 前置图标可视左边距（无偏移，就是内边距 12）。
|
||||
pub icon_inset: f32,
|
||||
/// 图标 ↔ 文本间距（12：12 + 24 + 12 = 48 起文本，与官方 48 的图标槽一致）。
|
||||
pub icon_gap: f32,
|
||||
/// 图标边长（24）。
|
||||
pub icon: f32,
|
||||
/// 静息描边（一像素线）。
|
||||
pub stroke: f32,
|
||||
/// 聚焦/错误描边（2）。
|
||||
pub focus_stroke: f32,
|
||||
/// 圆角档位（`Component::TextField` = ExtraSmall）。
|
||||
pub shape: ShapeScale,
|
||||
}
|
||||
|
||||
impl FieldGeometry {
|
||||
/// 求值；`labeled` = 带浮动标签（56），否则单行 40；`leading` = 有没有前置图标。
|
||||
pub fn of(ui: &Ui, labeled: bool, leading: Option<IconKind>) -> Self {
|
||||
let icon_inset = ui.space(Space::X3);
|
||||
let pad_end = ui.space(Space::X4);
|
||||
let padding = if leading.is_some() {
|
||||
Padding {
|
||||
top: 0.0,
|
||||
right: pad_end,
|
||||
bottom: 0.0,
|
||||
left: icon_inset,
|
||||
}
|
||||
} else {
|
||||
Padding {
|
||||
top: 0.0,
|
||||
right: pad_end,
|
||||
bottom: 0.0,
|
||||
left: pad_end,
|
||||
}
|
||||
};
|
||||
|
||||
Self {
|
||||
height: if labeled {
|
||||
FIELD_HEIGHT
|
||||
} else {
|
||||
ui.metrics().control_height
|
||||
},
|
||||
padding,
|
||||
icon_inset,
|
||||
icon_gap: ui.space(Space::X3),
|
||||
icon: IconSize::Toolbar.px(),
|
||||
stroke: STROKE_PX,
|
||||
focus_stroke: FOCUS_STROKE,
|
||||
shape: Component::TextField.spec().shape,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Slider 的几何（轨道 / 竖条 / 停靠点 / 命中区）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct SliderGeometry {
|
||||
/// 轨道高（16）。
|
||||
pub track: f32,
|
||||
/// 竖条宽（静息 4 / focus·pressed 2）。
|
||||
pub handle: f32,
|
||||
/// 竖条高（44）。
|
||||
pub handle_tall: f32,
|
||||
/// 停靠点直径（4）。
|
||||
pub stop: f32,
|
||||
/// 控件高 = 命中区（`LM.touch_target` 48：竖条 44 + 上下各 2）。
|
||||
pub height: f32,
|
||||
}
|
||||
|
||||
impl SliderGeometry {
|
||||
/// 从令牌求值。
|
||||
pub fn of(ui: &Ui) -> Self {
|
||||
Self {
|
||||
track: TRACK_HEIGHT,
|
||||
handle: HANDLE_WIDTH,
|
||||
handle_tall: HANDLE_HEIGHT,
|
||||
stop: STOP_SIZE,
|
||||
height: ui.metrics().touch_target,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 菜单（Menu / DropdownMenuItem）的几何。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct MenuGeometry {
|
||||
/// 项高（48）。
|
||||
pub item_height: f32,
|
||||
/// 水平内边距（12，来自 `Space::X3`）。
|
||||
pub pad_h: f32,
|
||||
/// 上下留白（8，来自 `Space::X2`）。
|
||||
pub pad_v: f32,
|
||||
/// 槽位图标边长（24）。
|
||||
pub icon: f32,
|
||||
/// 图标 ↔ 文本间距（12）。
|
||||
pub gap: f32,
|
||||
/// 容器圆角档位（`Component::Menu` = ExtraSmall 4）。
|
||||
pub shape: ShapeScale,
|
||||
}
|
||||
|
||||
impl MenuGeometry {
|
||||
/// 从令牌求值。
|
||||
pub fn of(ui: &Ui) -> Self {
|
||||
Self {
|
||||
item_height: MENU_ITEM_HEIGHT,
|
||||
pad_h: ui.space(Space::X3),
|
||||
pad_v: ui.space(Space::X2),
|
||||
icon: IconSize::Toolbar.px(),
|
||||
gap: ui.space(Space::X3),
|
||||
shape: Component::Menu.spec().shape,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui() -> Ui {
|
||||
Ui::with_platform(SchemeFlavor::Light, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
/// G16 / G17：两个 2dp 与 56dp 的参考值钉在这里（改参考表会让这条红）。
|
||||
#[test]
|
||||
fn field_geometry_matches_the_reference_table() {
|
||||
let ui = ui();
|
||||
let labeled = FieldGeometry::of(&ui, true, None);
|
||||
assert_eq!(labeled.height, 56.0, "G16 TextFieldDefaults.MinHeight");
|
||||
assert_eq!(labeled.stroke, 1.0, "静息一像素线");
|
||||
assert_eq!(labeled.focus_stroke, 2.0, "G17 FocusOutlineWidth");
|
||||
assert_eq!(labeled.shape.dp(), 4.0, "CornerExtraSmall");
|
||||
|
||||
// 无标签单行 40 = 骨架令牌，不是字面量
|
||||
let compact = FieldGeometry::of(&ui, false, None);
|
||||
assert_eq!(compact.height, ui.metrics().control_height);
|
||||
assert_eq!(compact.height, 40.0);
|
||||
|
||||
// 内边距：无图标 16/16
|
||||
assert_eq!(compact.padding.left, 16.0);
|
||||
assert_eq!(compact.padding.right, 16.0);
|
||||
assert_eq!(compact.padding.left, compact.padding.right);
|
||||
}
|
||||
|
||||
/// 前置图标：图标可视边 12、文本从 48 起（= 12 + 24 + 12，官方 48 的图标槽）。
|
||||
#[test]
|
||||
fn field_icon_slot_matches_the_official_48() {
|
||||
let ui = ui();
|
||||
let leading = FieldGeometry::of(&ui, true, Some(IconKind::Search));
|
||||
assert_eq!(leading.icon, 24.0, "LeadingIconSize");
|
||||
assert_eq!(leading.icon_inset, 12.0, "textFieldHorizontalIconPadding");
|
||||
// 文本起点 = 图标可视边 12 + 图标 24 + 间距 12 = 48（官方图标槽）
|
||||
assert_eq!(leading.icon_inset + leading.icon + leading.icon_gap, 48.0);
|
||||
// 右侧仍是 16（官方内边距不因图标变）
|
||||
assert_eq!(leading.padding.right, 16.0);
|
||||
}
|
||||
|
||||
/// G18：轨道 16 / 竖条 4×44 / 停靠点 4 / 命中 48；竖条比轨道高 28 ⇒ 上下各溢出 14。
|
||||
#[test]
|
||||
fn slider_geometry_matches_the_reference_table() {
|
||||
let ui = ui();
|
||||
let slider = SliderGeometry::of(&ui);
|
||||
assert_eq!(slider.track, 16.0, "ActiveTrackHeight");
|
||||
assert_eq!(slider.handle, 4.0, "HandleWidth");
|
||||
assert_eq!(slider.handle_tall, 44.0, "HandleHeight");
|
||||
assert_eq!(slider.stop, 4.0, "StopIndicatorSize");
|
||||
assert_eq!(
|
||||
(slider.handle_tall - slider.track) / 2.0,
|
||||
14.0,
|
||||
"上下各溢出"
|
||||
);
|
||||
assert_eq!(slider.height, 48.0, "命中下限 LM.touch_target");
|
||||
assert!(slider.height >= slider.handle_tall, "命中区必须容得下竖条");
|
||||
// focus / pressed 收窄到 2（A1 FocusHandleWidth / PressedHandleWidth）
|
||||
assert_eq!(HANDLE_WIDTH_ACTIVE, 2.0);
|
||||
assert!(HANDLE_WIDTH_ACTIVE < slider.handle);
|
||||
}
|
||||
|
||||
/// G19：项高 48、水平 12、上下 8、图标 24、圆角按令牌表（4，**不是** 12b 说的 12）。
|
||||
#[test]
|
||||
fn menu_geometry_matches_the_reference_table() {
|
||||
let ui = ui();
|
||||
let menu = MenuGeometry::of(&ui);
|
||||
assert_eq!(menu.item_height, 48.0, "MenuListItemContainerHeight");
|
||||
assert_eq!(menu.pad_h, 12.0, "DropdownMenuItemHorizontalPadding");
|
||||
assert_eq!(menu.pad_v, 8.0, "DropdownMenuVerticalPadding");
|
||||
assert_eq!(menu.icon, 24.0);
|
||||
assert_eq!(
|
||||
menu.shape.dp(),
|
||||
4.0,
|
||||
"MenuTokens.ContainerShape = CornerExtraSmall"
|
||||
);
|
||||
assert_eq!(
|
||||
menu.shape,
|
||||
Component::Menu.spec().shape,
|
||||
"圆角只能来自令牌表"
|
||||
);
|
||||
assert_eq!(menu.gap, ui.space(Space::X3), "图标 ↔ 文本 12 走栅格令牌");
|
||||
}
|
||||
|
||||
/// G20：搜索条 min 360 / max 720；面板最小高 240；条高取骨架令牌 56（**不在这里重复定义**）。
|
||||
#[test]
|
||||
fn search_constants_do_not_duplicate_layout_metrics() {
|
||||
let ui = ui();
|
||||
assert_eq!(SEARCH_MIN_WIDTH, 360.0);
|
||||
assert_eq!(SEARCH_MAX_WIDTH, 720.0);
|
||||
assert_eq!(SEARCH_VIEW_MIN_HEIGHT, 240.0);
|
||||
assert_eq!(ui.metrics().search_bar_height, 56.0, "条高来自 LM");
|
||||
assert_eq!(
|
||||
ShapeScale::Full.radius_px(ui.metrics().search_bar_height),
|
||||
28.0
|
||||
);
|
||||
assert_eq!(Component::Search.spec().shape, ShapeScale::Full);
|
||||
// 图标可视边 = pad + offset（M69 的 SEARCH_BAR 不变量，本文件不重复定义 12/4）
|
||||
let bar = Component::Search.metrics().expect("Search 有组件级度量");
|
||||
assert_eq!(bar.pad_start + bar.icon_offset, 16.0);
|
||||
assert_eq!(bar.icon, 24.0);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,354 @@
|
||||
//! 菜单（`research/12b` §8）：`Menu` 弹出层 + `DropdownMenuItem`。
|
||||
//!
|
||||
//! ## 参考值（`[源]` = A1，`MenuTokens` / `Menu.kt` 1.4.0）
|
||||
//!
|
||||
//! | # | 检查项 | 参考值 | 落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 8.1 | 容器圆角 | 官方 **4**（`ContainerShape = CornerExtraSmall`）；`12b` 说「本项目 12」——**取令牌表的 4**（报告偏离 D18） | `Component::Menu.spec().shape` |
|
||||
//! | 8.2 | 容器色 / 高程 | `SurfaceContainer` + **L2** | `Role::SurfaceContainer` + `Elevation::Level2` |
|
||||
//! | 8.3 | 项高 | **48** | `MENU_ITEM_HEIGHT`（G19） |
|
||||
//! | 8.4 | 项内边距 | 水平 **12**、菜单上下留白 **8** | `Space::X3` / `Space::X2` |
|
||||
//! | 8.5 | 字级 / 图标 | 文本 `BodyMedium 14/20`；图标 **24** | `TypeRole` + `IconSize::Toolbar` |
|
||||
//! | 8.6 | 选中项 | 容器 `SecondaryContainer` + 文本 `OnSecondaryContainer`；指示器水平内缩 **4**、圆角 **8** | [`MenuItem::selected`] |
|
||||
//! | 8.7 | 宽度 | 不窄于触发元素、长文本不换行（`ellipsis` 本轮不做，登记 D19） | [`Menu::width`] |
|
||||
//!
|
||||
//! ## 弹出层阴影
|
||||
//!
|
||||
//! 高程取 `Component::Menu.spec().elevation`（= L2），阴影参数取 `Elevation::shadow()`
|
||||
//! （`ShadowSpec`：blur 6 / offset 2 / alpha 0.14，令牌层给的值），阴影色取 `Role::Shadow`。
|
||||
//! **容器色不取 `MaterialLayer::Overlay`**：那是 `SurfaceContainerHigh`，比 A1 的 `SurfaceContainer`
|
||||
//! 高一档；`MaterialLayer` 只用来确认「弹出层属于 Overlay 语义」，颜色以 A1 为准。
|
||||
//!
|
||||
//! ## 分组分隔线
|
||||
//!
|
||||
//! 复用 [`crate::app::components::divider::full`]（一像素线 + `OutlineVariant`），**不自己画线**。
|
||||
//! 菜单水平内边距 12 由容器给，所以分隔线自然落在 12 内缩后的宽度上。
|
||||
|
||||
use iced::widget::text::LineHeight;
|
||||
use iced::widget::{button, column, container, text};
|
||||
use iced::{
|
||||
Alignment, Background, Border, Color, Element, Length, Padding, Pixels, Shadow, Vector,
|
||||
};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::component_map::Component;
|
||||
use unlucky_design::elevation::Elevation;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::shape::ShapeScale;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::icons;
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::divider;
|
||||
use super::super::interaction::{self, Interaction};
|
||||
use super::super::layout;
|
||||
use super::geometry::MenuGeometry;
|
||||
|
||||
/// 菜单里的一项。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct MenuItem<'a, M> {
|
||||
label: &'a str,
|
||||
leading: Option<IconKind>,
|
||||
trailing: Option<IconKind>,
|
||||
on_press: Option<M>,
|
||||
selected: bool,
|
||||
state: Option<Interaction>,
|
||||
}
|
||||
|
||||
impl<'a, M> MenuItem<'a, M> {
|
||||
/// 一个可点的项。
|
||||
pub fn new(label: &'a str, on_press: M) -> Self {
|
||||
Self {
|
||||
label,
|
||||
leading: None,
|
||||
trailing: None,
|
||||
on_press: Some(on_press),
|
||||
selected: false,
|
||||
state: None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个禁用的项（无消息 = 点不动，与按钮家族同一口径）。
|
||||
pub fn disabled(label: &'a str) -> Self {
|
||||
Self {
|
||||
label,
|
||||
leading: None,
|
||||
trailing: None,
|
||||
on_press: None,
|
||||
selected: false,
|
||||
state: None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 前置槽位（24）。
|
||||
pub fn leading(mut self, kind: IconKind) -> Self {
|
||||
self.leading = Some(kind);
|
||||
self
|
||||
}
|
||||
|
||||
/// 后置槽位（24；勾选/快捷键提示用）。
|
||||
pub fn trailing(mut self, kind: IconKind) -> Self {
|
||||
self.trailing = Some(kind);
|
||||
self
|
||||
}
|
||||
|
||||
/// 选中项（`SecondaryContainer` + `OnSecondaryContainer`）。
|
||||
pub fn selected(mut self) -> Self {
|
||||
self.selected = true;
|
||||
self
|
||||
}
|
||||
|
||||
/// 强制视觉态（gallery 状态矩阵取证）。
|
||||
pub fn state(mut self, state: Interaction) -> Self {
|
||||
self.state = Some(state);
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 菜单里的一行：普通项或分组分隔线。
|
||||
#[derive(Debug, Clone)]
|
||||
pub enum Entry<'a, M> {
|
||||
/// 一个可点/禁用的项。
|
||||
Item(MenuItem<'a, M>),
|
||||
/// 分组分隔线（复用 `components::divider`）。
|
||||
Divider,
|
||||
}
|
||||
|
||||
/// 菜单弹出层。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct Menu<'a, M> {
|
||||
entries: Vec<Entry<'a, M>>,
|
||||
width: Length,
|
||||
}
|
||||
|
||||
impl<'a, M> Default for Menu<'a, M> {
|
||||
fn default() -> Self {
|
||||
Self::new()
|
||||
}
|
||||
}
|
||||
|
||||
impl<'a, M> Menu<'a, M> {
|
||||
/// 空菜单（默认按容器宽度伸展，宽度由调用方定）。
|
||||
pub fn new() -> Self {
|
||||
Self {
|
||||
entries: Vec::new(),
|
||||
width: Length::Fill,
|
||||
}
|
||||
}
|
||||
|
||||
/// 追加一项。
|
||||
pub fn item(mut self, item: MenuItem<'a, M>) -> Self {
|
||||
self.entries.push(Entry::Item(item));
|
||||
self
|
||||
}
|
||||
|
||||
/// 追加一条分组分隔线。
|
||||
pub fn divider(mut self) -> Self {
|
||||
self.entries.push(Entry::Divider);
|
||||
self
|
||||
}
|
||||
|
||||
/// 菜单宽度（8.7：不窄于触发元素由调用方保证）。
|
||||
pub fn width(mut self, width: Length) -> Self {
|
||||
self.width = width;
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 一项的颜色（8.5 / 8.6 / 禁用）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
struct ItemPalette {
|
||||
/// 项底色；`None` = 透明（不画状态层）。
|
||||
fill: Option<Color>,
|
||||
/// 文本色。
|
||||
ink: Color,
|
||||
/// 图标色（前置槽位；A1 是 `OnSecondaryContainer`）。
|
||||
icon: Color,
|
||||
/// 圆角档位（选中指示器 8）。
|
||||
shape: ShapeScale,
|
||||
}
|
||||
|
||||
/// 解析一项的颜色：选中优先，其余按五态叠状态层（`interaction::overlay_color`）。
|
||||
fn item_palette(ui: &Ui, state: Interaction, selected: bool) -> ItemPalette {
|
||||
if state.is_disabled() {
|
||||
// 禁用：内容 38%（无容器时叠在表面色上；菜单项本身透明）
|
||||
let ink = interaction::disabled_content_over_role(ui, Role::OnSurface, false);
|
||||
return ItemPalette {
|
||||
fill: None,
|
||||
ink,
|
||||
icon: ink,
|
||||
shape: ShapeScale::Small,
|
||||
};
|
||||
}
|
||||
|
||||
if selected {
|
||||
// 选中项也要跟态走：状态层叠在 SecondaryContainer 上（不透明结果，D27）
|
||||
let fill = interaction::overlay_color(
|
||||
ui,
|
||||
state,
|
||||
Role::OnSecondaryContainer,
|
||||
Role::SecondaryContainer,
|
||||
)
|
||||
.unwrap_or_else(|| ui.color(Role::SecondaryContainer));
|
||||
return ItemPalette {
|
||||
fill: Some(fill),
|
||||
ink: ui.color(Role::OnSecondaryContainer),
|
||||
icon: ui.color(Role::OnSecondaryContainer),
|
||||
shape: ShapeScale::Small,
|
||||
};
|
||||
}
|
||||
|
||||
ItemPalette {
|
||||
// 状态层叠在**菜单容器色**上（SurfaceContainer），得到不透明结果（D27）
|
||||
fill: interaction::overlay_color(ui, state, Role::OnSurface, Role::SurfaceContainer),
|
||||
ink: ui.color(Role::OnSurface),
|
||||
icon: ui.color(Role::OnSecondaryContainer),
|
||||
shape: ShapeScale::Small,
|
||||
}
|
||||
}
|
||||
|
||||
/// 菜单弹出层（`SurfaceContainer` + L2 阴影）。
|
||||
pub fn menu<'a, M: Clone + 'a>(ui: &'a Ui, menu: Menu<'a, M>) -> Element<'a, M> {
|
||||
let geometry = MenuGeometry::of(ui);
|
||||
let spec = Component::Menu.spec();
|
||||
let elevation = spec.elevation;
|
||||
debug_assert_eq!(
|
||||
elevation,
|
||||
Elevation::Level2,
|
||||
"MenuTokens.ContainerElevation"
|
||||
);
|
||||
let shadow_spec = elevation.shadow();
|
||||
let panel = ui.color(Role::SurfaceContainer);
|
||||
let shape = geometry.shape;
|
||||
|
||||
let mut rows = column![].width(Length::Fill);
|
||||
for entry in menu.entries {
|
||||
rows = rows.push(match entry {
|
||||
Entry::Item(item) => item_row(ui, item, geometry),
|
||||
// 分组分隔线：复用 `divider::full`（一像素线 + OutlineVariant），不自己画
|
||||
Entry::Divider => divider::full::<M>(ui),
|
||||
});
|
||||
}
|
||||
|
||||
container(layout::inset(0.0, geometry.pad_v, rows))
|
||||
.width(menu.width)
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(panel)),
|
||||
border: Border {
|
||||
radius: ui.radius_dp(shape),
|
||||
..Border::default()
|
||||
},
|
||||
shadow: Shadow {
|
||||
color: Color {
|
||||
a: shadow_spec.alpha,
|
||||
..ui.color(Role::Shadow)
|
||||
},
|
||||
offset: Vector::new(0.0, shadow_spec.offset_y_px),
|
||||
blur_radius: shadow_spec.blur_px,
|
||||
},
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 一行菜单项（用 `button` 承载命中与四态，几何与颜色自绘）。
|
||||
fn item_row<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
item: MenuItem<'a, M>,
|
||||
geometry: MenuGeometry,
|
||||
) -> Element<'a, M> {
|
||||
let forced = item.state.or(if item.on_press.is_none() {
|
||||
Some(Interaction::Disabled)
|
||||
} else {
|
||||
None
|
||||
});
|
||||
// 选中项的背景也要跟态走：禁用时不许留满档 SecondaryContainer
|
||||
let colors = item_palette(ui, forced.unwrap_or(Interaction::Enabled), item.selected);
|
||||
let body = ui.style(TypeRole::BodyMedium);
|
||||
|
||||
let label = text(item.label)
|
||||
.size(body.size_px)
|
||||
.line_height(LineHeight::Absolute(Pixels(body.line_height_px)))
|
||||
.font(ui.font_of(body))
|
||||
.color(colors.ink);
|
||||
|
||||
let mut row = iced::widget::Row::new()
|
||||
.align_y(Alignment::Center)
|
||||
.spacing(geometry.gap);
|
||||
if let Some(kind) = item.leading {
|
||||
// Q9：图标必须经固定尺寸容器
|
||||
row = row.push(layout::fixed(
|
||||
geometry.icon,
|
||||
geometry.icon,
|
||||
icons::view::<M>(kind, colors.icon),
|
||||
));
|
||||
}
|
||||
row = row.push(label);
|
||||
if let Some(kind) = item.trailing {
|
||||
// **撑开**：label 与 trailing 之间插一个水平 Fill，trailing 才会被推到行右内边距上
|
||||
// （M3 里 trailing 是「快捷键 / 子菜单箭头 / 勾」，必须在一列菜单里成一条竖线）。
|
||||
// 没有 trailing 时**不插**：label 仍在左边，不会被居中或右对齐。
|
||||
row = row.push(iced::widget::space::horizontal());
|
||||
row = row.push(layout::fixed(
|
||||
geometry.icon,
|
||||
geometry.icon,
|
||||
icons::view::<M>(kind, colors.icon),
|
||||
));
|
||||
}
|
||||
|
||||
// 行必须撑满 item 宽度：上面的 Fill 空间要有宽度可撑（Q8 的教训：撑开靠容器，不靠子元素）。
|
||||
// 顺带把内容垂直居中——`button` 只把内容放在 padding-box 的左上角。
|
||||
let content = iced::widget::container(row)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fill)
|
||||
.align_y(Alignment::Center);
|
||||
|
||||
let selected = item.selected;
|
||||
let style = move |_theme: &iced::Theme, status: button::Status| {
|
||||
let state = forced.unwrap_or_else(|| Interaction::from_status(status));
|
||||
let colors = item_palette(ui, state, selected);
|
||||
button::Style {
|
||||
background: colors.fill.map(Background::Color),
|
||||
text_color: colors.ink,
|
||||
border: Border {
|
||||
radius: ui.radius_dp(colors.shape),
|
||||
..Border::default()
|
||||
},
|
||||
shadow: Shadow::default(),
|
||||
snap: true,
|
||||
}
|
||||
};
|
||||
|
||||
let inset = ui.space(Space::X1);
|
||||
let button = button(content)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(geometry.item_height))
|
||||
.padding(Padding {
|
||||
top: 0.0,
|
||||
// 选中指示器水平内缩 4（8.6 / 参考图纸），内容仍落在 12 上：12 = 4 + 8
|
||||
right: geometry.pad_h - inset,
|
||||
bottom: 0.0,
|
||||
left: geometry.pad_h - inset,
|
||||
})
|
||||
.style(style);
|
||||
|
||||
let element: Element<'a, M> = match item.on_press {
|
||||
Some(message) => button.on_press(message).into(),
|
||||
None => button.into(),
|
||||
};
|
||||
|
||||
container(element)
|
||||
.width(Length::Fill)
|
||||
.padding(Padding {
|
||||
top: 0.0,
|
||||
right: inset,
|
||||
bottom: 0.0,
|
||||
left: inset,
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
@@ -0,0 +1,123 @@
|
||||
//! menu 的单测（从 `menu.rs` 拆出：单文件 ≤400 行，AGENTS.md §3-1）。
|
||||
|
||||
use super::*;
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
fn sample(flavor: SchemeFlavor) -> Element<'static, u8> {
|
||||
let ui = Box::leak(Box::new(ui(flavor)));
|
||||
let spec = Menu::new()
|
||||
.item(MenuItem::new("重命名", 1_u8).leading(IconKind::Folder))
|
||||
.item(
|
||||
MenuItem::new("复制实例", 2_u8)
|
||||
.selected()
|
||||
.trailing(IconKind::Check),
|
||||
)
|
||||
.divider()
|
||||
.item(MenuItem::disabled("删除").leading(IconKind::Trash));
|
||||
menu(ui, spec)
|
||||
}
|
||||
|
||||
/// 8.2：容器 `SurfaceContainer` + L2；阴影参数来自高程令牌。
|
||||
#[test]
|
||||
fn container_uses_surface_container_and_level2_shadow() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
assert_eq!(Component::Menu.spec().elevation, Elevation::Level2);
|
||||
assert_eq!(
|
||||
Component::Menu.spec().elevation.surface_role(),
|
||||
Role::SurfaceContainer,
|
||||
"L2 的容器角色与 MenuTokens.ContainerColor 一致"
|
||||
);
|
||||
let shadow = Elevation::Level2.shadow();
|
||||
assert!(shadow.is_visible(), "菜单是浮层，必须有可见阴影");
|
||||
assert_eq!(shadow.blur_px, 6.0);
|
||||
assert_eq!(shadow.offset_y_px, 2.0);
|
||||
// 容器色**不是** MaterialLayer::Overlay（那会高一档）
|
||||
assert_ne!(
|
||||
ui.layer(unlucky_design::elevation::MaterialLayer::Overlay),
|
||||
ui.color(Role::SurfaceContainer)
|
||||
);
|
||||
}
|
||||
|
||||
/// 8.6：选中 = SecondaryContainer + OnSecondaryContainer；禁用内容 38%。
|
||||
#[test]
|
||||
fn selected_and_disabled_items_use_the_right_roles() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
let selected = item_palette(&ui, Interaction::Enabled, true);
|
||||
assert_eq!(selected.fill, Some(ui.color(Role::SecondaryContainer)));
|
||||
assert_eq!(selected.ink, ui.color(Role::OnSecondaryContainer));
|
||||
assert_eq!(selected.icon, ui.color(Role::OnSecondaryContainer));
|
||||
|
||||
// 选中 + hover：状态层叠在 SecondaryContainer 上（不是满档底色）
|
||||
let hovered = item_palette(&ui, Interaction::Hovered, true);
|
||||
assert_ne!(hovered.fill, selected.fill);
|
||||
assert_eq!(
|
||||
hovered.fill,
|
||||
interaction::overlay_color(
|
||||
&ui,
|
||||
Interaction::Hovered,
|
||||
Role::OnSecondaryContainer,
|
||||
Role::SecondaryContainer
|
||||
)
|
||||
);
|
||||
|
||||
let disabled = item_palette(&ui, Interaction::Disabled, true);
|
||||
assert_eq!(disabled.fill, None, "禁用项不留满档选中底色");
|
||||
assert_eq!(
|
||||
disabled.ink,
|
||||
interaction::disabled_content_over_role(&ui, Role::OnSurface, false)
|
||||
);
|
||||
assert_ne!(disabled.ink, ui.color(Role::OnSurface));
|
||||
}
|
||||
|
||||
/// 五态：hover 8% / pressed 10% / focus 10% 都叠在 SurfaceContainer 上（不透明）。
|
||||
#[test]
|
||||
fn item_states_blend_on_the_menu_container() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
let rest = item_palette(&ui, Interaction::Enabled, false);
|
||||
assert_eq!(rest.fill, None, "静息不叠色（菜单底色透出来）");
|
||||
for state in [
|
||||
Interaction::Hovered,
|
||||
Interaction::Pressed,
|
||||
Interaction::Focused,
|
||||
] {
|
||||
let fill = item_palette(&ui, state, false)
|
||||
.fill
|
||||
.expect("可交互态必须给底色");
|
||||
assert_eq!(fill.a, 1.0, "结果必须不透明（D27）");
|
||||
assert_ne!(Some(fill), rest.fill);
|
||||
}
|
||||
}
|
||||
|
||||
/// 8.3 / 8.4：项高 48、水平 12（内容）、选中指示器内缩 4 ⇒ 内容仍在 12。
|
||||
#[test]
|
||||
fn item_geometry_matches_the_reference_table() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
let geometry = MenuGeometry::of(&ui);
|
||||
assert_eq!(geometry.item_height, 48.0);
|
||||
assert_eq!(geometry.pad_h, 12.0);
|
||||
assert_eq!(geometry.pad_v, 8.0);
|
||||
let inset = ui.space(Space::X1);
|
||||
assert_eq!(inset, 4.0);
|
||||
assert_eq!((geometry.pad_h - inset) + inset, 12.0, "内容落在 12 上");
|
||||
}
|
||||
|
||||
/// 三种形态（带槽位 / 选中 / 禁用 / 分组线）都能构建。
|
||||
#[test]
|
||||
fn menu_shapes_build() {
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let _: Element<'static, u8> = sample(flavor);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,42 @@
|
||||
//! **输入类家族**（D39 §1 的 `inputs/`）：§9 TextField / §20 Search / §11 Slider / §8 Menu。
|
||||
//!
|
||||
//! 四个组件的共同纪律（与本目录外的契约一一对应）：
|
||||
//!
|
||||
//! - **对消息类型泛型**（`M: Clone`，不 import `crate::app::Message`）——组件库要能脱离业务验收；
|
||||
//! - **`&'a Ui` 传入**，组件内部不 `Ui::new`（深浅热切靠外部重建整树）；
|
||||
//! - **不持有 `String`**：文本框与搜索条是受控组件（借值 + `on_input`/`on_change` 回传），
|
||||
//! 滑块也只借一个比例；
|
||||
//! - **hover/pressed/focus/disabled 一律走 [`super::interaction`]**（α 只有一处定义）；
|
||||
//! - **精确尺寸走 [`super::layout`]**（Q8/Q9 的两个固定解法），图标一律 `layout::fixed`；
|
||||
//! - **零尺寸字面量**：能取令牌的取令牌，取不到的集中登记在 [`geometry`] 的 G16~G20。
|
||||
//!
|
||||
//! ## 文件分工
|
||||
//!
|
||||
//! | 文件 | 内容 |
|
||||
//! |---|---|
|
||||
//! | [`geometry`] | 内部几何 + G 编号常量（`FieldGeometry` / `SliderGeometry` / `MenuGeometry`） |
|
||||
//! | [`field`] | [`text_field`]（Filled / Outlined） |
|
||||
//! | [`search`] | [`search_bar`]（收起）+ [`search_view`]（展开 docked） |
|
||||
//! | [`slider`] | [`slider`]（自绘 `Widget`：轨道 16 + 竖条 4×44） |
|
||||
//! | [`menu`] | [`menu`]（`Menu` + `MenuItem` + 分组分隔线） |
|
||||
//!
|
||||
//! ## 与契约 §2 示例签名的关系
|
||||
//!
|
||||
//! 契约示例是 `filled(ui, label, on_press)`；本家族的四个组件都比三个参数多（变体 × 五态 ×
|
||||
//! 前后槽位 × 错误/辅助文本），所以照按钮家族的先例把「部件参数」收进构造器结构体：
|
||||
//! `text_field(ui, Field::new(value).label("名称"), on_input)`。**泛型纪律一字不改**，
|
||||
//! 差别只是位置参数变命名参数（按钮家族已登记同一决定，见 `buttons` 模块文档）。
|
||||
|
||||
pub mod geometry;
|
||||
|
||||
mod field;
|
||||
mod menu;
|
||||
#[cfg(test)]
|
||||
mod probe;
|
||||
mod search;
|
||||
mod slider;
|
||||
|
||||
pub use field::{text_field, Field, FieldVariant};
|
||||
pub use menu::{menu, Menu, MenuItem};
|
||||
pub use search::{search_bar, search_view, SearchBar, SearchView};
|
||||
pub use slider::{slider, Slider};
|
||||
@@ -0,0 +1,347 @@
|
||||
//! 渲染层几何断言（D30 / M68 的教训：**纯函数对 ≠ 图画对**）。
|
||||
//!
|
||||
//! ## 为什么这个文件在 `inputs/` 而不是 `gallery/probe.rs`
|
||||
//!
|
||||
//! 像素工具 `gallery::scan` 是 `mod scan;`（**私有**于 `gallery`），我的 probe 拿不到它，
|
||||
//! 而 `gallery/mod.rs` 不在本 mission 的 scope 里。所以这里自带一份最小的读图器
|
||||
//! （约 40 行：读 PNG / 取点 / 连通块 / 行覆盖），判据全在本文件——已作为 finding 报给 tower
|
||||
//! （建议把 `gallery::scan` 提升为 `pub(crate)`，四个家族就能共用一份）。
|
||||
//!
|
||||
//! ## 怎么跑（worktree 根目录）
|
||||
//!
|
||||
//! ```text
|
||||
//! # ① 出图：副本工程只把 inputs 段提到首位（组件代码逐字节相同），见 target/m77/sync.py
|
||||
//! python target/m77/sync.py && (cd /d/tmp/m77-shot && cargo build --no-default-features ...)
|
||||
//! M77_PART=text ./target/debug/unlucky-launcher-iced.exe --software-renderer --screen=gallery \
|
||||
//! --screenshot target/m77/text-light.png --screenshot-theme=light
|
||||
//! # ② 量图
|
||||
//! ULL_INPUTS_DIR=target/m77 cargo test -p unlucky-app-iced inputs::probe
|
||||
//! ```
|
||||
//!
|
||||
//! 没给 `ULL_INPUTS_DIR` 就**大声跳过**（不静默通过），与 `gallery::probe` 的口径一致。
|
||||
//!
|
||||
//! ## 量什么（每条都对着一个「已经可能画错」的形态）
|
||||
//!
|
||||
//! | 断言 | 抓的错误 |
|
||||
//! |---|---|
|
||||
//! | 文本框高 **56**、宽 **320** | 高度被内容/内边距吃掉（不是 56 的 A 级值） |
|
||||
//! | Filled 底部指示线 静息 **1.0** / 聚焦 **2.0** 墨量 | 把 2dp 画成 1dp（或反过来） |
|
||||
//! | Outlined 描边 静息 **1.0** / 聚焦 **2.0** 墨量 | 同上 |
|
||||
//! | 错误态：标签 / 线 / 辅助文本全 `Error` | 只把线染红、忘了标签与辅助文本 |
|
||||
//! | 搜索条高 **56**、图标墨迹偏移 **20**（= 16 + viewBox 4） | 手抄 16/20 当图标边、或 pad 与 offset 少加一段 |
|
||||
//! | docked 面板 宽 **360** / 头 **56** / 分隔线 **1.0 `Outline`** / 体 **240** | 用 `OutlineVariant`、或头部高度与 bar 不一致 |
|
||||
//! | Slider 0%（竖条贴左）、50%（分界在中央）、100%（无未激活段） | 位移区间取错（0..W 而不是 handle/2..W−handle/2） |
|
||||
//! | Slider 竖条 **4×44** | 画成圆点或撑满命中区 |
|
||||
//! | 菜单项 pitch **48**、选中指示器内缩 **4**、容器高 **161** | 项高/内边距抄错 |
|
||||
//! | 分组分隔线 **1.0** 墨量 | 分隔线变成 2px |
|
||||
|
||||
use std::path::{Path, PathBuf};
|
||||
|
||||
use unlucky_design::color::{Role, SchemeFlavor};
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::{Families, Ui};
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
/// 颜色比对容差（抗锯齿/取整）。
|
||||
const TOLERANCE: u8 = 10;
|
||||
|
||||
type Rgb = [u8; 3];
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
fn rgb(color: iced::Color) -> Rgb {
|
||||
[
|
||||
(color.r * 255.0).round() as u8,
|
||||
(color.g * 255.0).round() as u8,
|
||||
(color.b * 255.0).round() as u8,
|
||||
]
|
||||
}
|
||||
|
||||
fn matches(pixel: Rgb, expected: Rgb) -> bool {
|
||||
matches_within(pixel, expected, TOLERANCE)
|
||||
}
|
||||
|
||||
/// 指定容差的同色判断（量**阴影边**时要用更严的容差：阴影叠上去会落在 10 的容差内）。
|
||||
fn matches_within(pixel: Rgb, expected: Rgb, tolerance: u8) -> bool {
|
||||
pixel
|
||||
.iter()
|
||||
.zip(expected)
|
||||
.all(|(a, b)| a.abs_diff(b) <= tolerance)
|
||||
}
|
||||
|
||||
/// 一张图的最小访问器（读 PNG / 取点 / 连通块）。
|
||||
struct Shot {
|
||||
width: usize,
|
||||
height: usize,
|
||||
pixels: Vec<Rgb>,
|
||||
}
|
||||
|
||||
/// 一张图里某颜色的连通块外接框（闭区间）。
|
||||
#[derive(Debug, Clone, Copy)]
|
||||
struct BBox {
|
||||
left: usize,
|
||||
right: usize,
|
||||
top: usize,
|
||||
bottom: usize,
|
||||
}
|
||||
|
||||
impl BBox {
|
||||
fn width(&self) -> usize {
|
||||
self.right - self.left + 1
|
||||
}
|
||||
|
||||
fn height(&self) -> usize {
|
||||
self.bottom - self.top + 1
|
||||
}
|
||||
}
|
||||
|
||||
impl Shot {
|
||||
fn load(path: &Path) -> Result<Self, String> {
|
||||
let bytes = std::fs::read(path).map_err(|error| format!("读不动 {path:?}：{error}"))?;
|
||||
let image = image::load_from_memory(&bytes)
|
||||
.map_err(|error| format!("解 PNG 失败：{error}"))?
|
||||
.to_rgb8();
|
||||
let (width, height) = (image.width() as usize, image.height() as usize);
|
||||
Ok(Self {
|
||||
width,
|
||||
height,
|
||||
pixels: image.pixels().map(|p| p.0).collect(),
|
||||
})
|
||||
}
|
||||
|
||||
fn at(&self, x: usize, y: usize) -> Rgb {
|
||||
self.pixels[y * self.width + x]
|
||||
}
|
||||
|
||||
fn bbox_of(&self, color: Rgb, min_area: usize) -> Vec<BBox> {
|
||||
let mut seen = vec![false; self.width * self.height];
|
||||
let mut boxes = Vec::new();
|
||||
for y in 0..self.height {
|
||||
for x in 0..self.width {
|
||||
if seen[y * self.width + x] || !matches(self.at(x, y), color) {
|
||||
continue;
|
||||
}
|
||||
let mut stack = vec![(x, y)];
|
||||
seen[y * self.width + x] = true;
|
||||
let mut bbox = BBox {
|
||||
left: x,
|
||||
right: x,
|
||||
top: y,
|
||||
bottom: y,
|
||||
};
|
||||
while let Some((cx, cy)) = stack.pop() {
|
||||
bbox.left = bbox.left.min(cx);
|
||||
bbox.right = bbox.right.max(cx);
|
||||
bbox.top = bbox.top.min(cy);
|
||||
bbox.bottom = bbox.bottom.max(cy);
|
||||
for (nx, ny) in [
|
||||
(cx + 1, cy),
|
||||
(cx.saturating_sub(1), cy),
|
||||
(cx, cy + 1),
|
||||
(cx, cy.saturating_sub(1)),
|
||||
] {
|
||||
if nx < self.width
|
||||
&& ny < self.height
|
||||
&& !seen[ny * self.width + nx]
|
||||
&& matches(self.at(nx, ny), color)
|
||||
{
|
||||
seen[ny * self.width + nx] = true;
|
||||
stack.push((nx, ny));
|
||||
}
|
||||
}
|
||||
}
|
||||
if bbox.width() * bbox.height() >= min_area {
|
||||
boxes.push(bbox);
|
||||
}
|
||||
}
|
||||
}
|
||||
boxes
|
||||
}
|
||||
|
||||
fn count_in(&self, color: Rgb, x0: usize, x1: usize, y0: usize, y1: usize) -> usize {
|
||||
let mut total = 0;
|
||||
for y in y0..y1.min(self.height) {
|
||||
for x in x0..x1.min(self.width) {
|
||||
if matches(self.at(x, y), color) {
|
||||
total += 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
total
|
||||
}
|
||||
}
|
||||
|
||||
/// 一行像素相对底色向 `line` 靠拢的比例（0..=1）——1dp 的线在各行上摊开时总和 ≈ 1.0。
|
||||
fn coverage(pixel: Rgb, surface: Rgb, line: Rgb) -> f32 {
|
||||
let channel = |i: usize| {
|
||||
let full = f32::from(line[i]) - f32::from(surface[i]);
|
||||
if full.abs() < 1.0 {
|
||||
return 0.0;
|
||||
}
|
||||
((f32::from(pixel[i]) - f32::from(surface[i])) / full).clamp(0.0, 1.0)
|
||||
};
|
||||
(channel(0) + channel(1) + channel(2)) / 3.0
|
||||
}
|
||||
|
||||
/// 竖直方向上的**线墨量**：`y0..y1` 每行在 x 区间上的平均覆盖之和（1dp ⇒ ≈1.0）。
|
||||
fn line_ink(
|
||||
shot: &Shot,
|
||||
x0: usize,
|
||||
x1: usize,
|
||||
y0: usize,
|
||||
y1: usize,
|
||||
surface: Rgb,
|
||||
line: Rgb,
|
||||
) -> f32 {
|
||||
let mut total = 0.0;
|
||||
for y in y0..y1.min(shot.height) {
|
||||
let mut sum = 0.0;
|
||||
for x in x0..x1.min(shot.width) {
|
||||
sum += coverage(shot.at(x, y), surface, line);
|
||||
}
|
||||
total += sum / (x1 - x0) as f32;
|
||||
}
|
||||
total
|
||||
}
|
||||
|
||||
/// 某一行里「两色之一」的最长连续段 `(start, end)`，允许 ≤`max_gap` 的空隙。
|
||||
///
|
||||
/// 用它而不是「本行最左/最右」：深色档的说明文字里有零星像素落在令牌色容差内，
|
||||
/// 取 min/max 会把轨道量成从 x=24 起（实测）。
|
||||
fn longest_run(shot: &Shot, y: usize, a: Rgb, b: Rgb, max_gap: usize) -> Option<(usize, usize)> {
|
||||
let mut best: Option<(usize, usize)> = None;
|
||||
let mut start: Option<usize> = None;
|
||||
let mut last: Option<usize> = None;
|
||||
for x in 0..shot.width {
|
||||
if matches(shot.at(x, y), a) || matches(shot.at(x, y), b) {
|
||||
if start.is_none() {
|
||||
start = Some(x);
|
||||
}
|
||||
last = Some(x);
|
||||
} else if let (Some(from), Some(to)) = (start, last) {
|
||||
if x - to > max_gap {
|
||||
if best.is_none_or(|(p, q)| to - from > q - p) {
|
||||
best = Some((from, to));
|
||||
}
|
||||
start = None;
|
||||
last = None;
|
||||
}
|
||||
}
|
||||
}
|
||||
if let (Some(from), Some(to)) = (start, last) {
|
||||
if best.is_none_or(|(p, q)| to - from > q - p) {
|
||||
best = Some((from, to));
|
||||
}
|
||||
}
|
||||
best
|
||||
}
|
||||
|
||||
/// `bbox` 范围内「整行至少 `min_pixels` 个同色像素」的行区间（闭区间）。
|
||||
///
|
||||
/// 菜单的阴影会把 bbox 外扩 ~5px，而阴影行绝不会有 100 个容器色像素——用它把阴影滤掉。
|
||||
fn row_extent(shot: &Shot, bbox: &BBox, color: Rgb, min_pixels: usize) -> (usize, usize) {
|
||||
let mut first = None;
|
||||
let mut last = None;
|
||||
for y in bbox.top..=bbox.bottom {
|
||||
let mut count = 0;
|
||||
for x in bbox.left..=bbox.right {
|
||||
// 容差收到 2：**阴影边**会落在默认容差 10 内，会把容器量高 ~5px
|
||||
if matches_within(shot.at(x, y), color, 2) {
|
||||
count += 1;
|
||||
}
|
||||
}
|
||||
if count >= min_pixels {
|
||||
first.get_or_insert(y);
|
||||
last = Some(y);
|
||||
}
|
||||
}
|
||||
(
|
||||
first.expect("行内没有足够的同色像素"),
|
||||
last.expect("行内没有足够的同色像素"),
|
||||
)
|
||||
}
|
||||
|
||||
/// `pixel` 更接近 `fill` 还是 `surface`（含平局都算 `fill`）。
|
||||
fn nearer(pixel: Rgb, fill: Rgb, surface: Rgb) -> bool {
|
||||
let dist = |a: Rgb, b: Rgb| -> u32 {
|
||||
a.iter()
|
||||
.zip(b)
|
||||
.map(|(x, y)| (i32::from(*x) - i32::from(y)).unsigned_abs())
|
||||
.sum()
|
||||
};
|
||||
dist(pixel, fill) <= dist(pixel, surface)
|
||||
}
|
||||
|
||||
/// 截图目录（`ULL_INPUTS_DIR`）；没给就返回 `None`（调用方大声跳过）。
|
||||
fn shot_dir() -> Option<PathBuf> {
|
||||
let raw = std::env::var_os("ULL_INPUTS_DIR")?;
|
||||
let path = PathBuf::from(raw);
|
||||
if path.is_absolute() || path.is_dir() {
|
||||
return Some(path);
|
||||
}
|
||||
let root = PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("../..");
|
||||
Some(root.join(path))
|
||||
}
|
||||
|
||||
/// 取一张图；缺图直接 panic（给了目录就说明这轮要认真量）。
|
||||
fn shot(dir: &Path, part: &str, flavor: SchemeFlavor) -> Shot {
|
||||
let slug = match flavor {
|
||||
SchemeFlavor::Light => "light",
|
||||
SchemeFlavor::Dark => "dark",
|
||||
};
|
||||
let path = dir.join(format!("{part}-{slug}.png"));
|
||||
let shot = Shot::load(&path).unwrap_or_else(|error| panic!("{error}"));
|
||||
assert_eq!(
|
||||
(shot.width, shot.height),
|
||||
(1180, 760),
|
||||
"验收图必须是 D30 的 1180×760 @100% DPI"
|
||||
);
|
||||
shot
|
||||
}
|
||||
|
||||
/// 一个矩阵格在某列的竖直「实色高度」：从 `bbox.top-4` 往上/下走到不再接近 `fill` 为止。
|
||||
fn vertical_extent(
|
||||
shot: &Shot,
|
||||
bbox: &BBox,
|
||||
fill: Rgb,
|
||||
surface: Rgb,
|
||||
column: usize,
|
||||
) -> (usize, usize) {
|
||||
let mut top = bbox.top;
|
||||
while top > 0 && nearer(shot.at(column, top - 1), fill, surface) {
|
||||
top -= 1;
|
||||
}
|
||||
let mut bottom = bbox.bottom;
|
||||
while bottom + 1 < shot.height && nearer(shot.at(column, bottom + 1), fill, surface) {
|
||||
bottom += 1;
|
||||
}
|
||||
(top, bottom)
|
||||
}
|
||||
|
||||
macro_rules! require_dir {
|
||||
() => {
|
||||
match shot_dir() {
|
||||
Some(dir) => dir,
|
||||
None => {
|
||||
eprintln!(
|
||||
"[inputs::probe] SKIPPED：未设置 ULL_INPUTS_DIR。这是**渲染层**断言，\
|
||||
需要先按本文件模块文档出 8 张图（target/m77/*.png）。"
|
||||
);
|
||||
return;
|
||||
}
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
mod menu;
|
||||
mod search;
|
||||
mod slider;
|
||||
mod text;
|
||||
@@ -0,0 +1,102 @@
|
||||
//! M77 probe · menu（从 `probe.rs` 拆出：单文件 ≤400 行，AGENTS.md §3-1）。
|
||||
|
||||
use super::*;
|
||||
|
||||
/// 8.3 / 8.4 / 8.6：菜单容器高 161、项 pitch 48、选中指示器内缩 4、分组分隔线 1dp。
|
||||
#[test]
|
||||
fn menu_container_items_and_divider() {
|
||||
let dir = require_dir!();
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let shot = shot(&dir, "menu", flavor);
|
||||
let ui = ui(flavor);
|
||||
let container = rgb(ui.color(Role::SurfaceContainer));
|
||||
let selected = rgb(ui.color(Role::SecondaryContainer));
|
||||
let divider = rgb(ui.color(Role::OutlineVariant));
|
||||
|
||||
// 右侧那只 = 「展开态」菜单。容器色块可能被**分组分隔线 / 选中项**切成多块，
|
||||
// 所以先把 x>290 的块并成一个外接框，再逐行量容器色（容差 2，滤掉阴影外扩的 ~5px）。
|
||||
let menus = shot.bbox_of(container, 2000);
|
||||
let right: Vec<BBox> = menus.iter().filter(|b| b.left > 290).copied().collect();
|
||||
assert!(!right.is_empty(), "找不到右侧的「展开态」菜单");
|
||||
let mut open = right[0];
|
||||
for b in right.iter().skip(1) {
|
||||
open.left = open.left.min(b.left);
|
||||
open.top = open.top.min(b.top);
|
||||
open.right = open.right.max(b.right);
|
||||
open.bottom = open.bottom.max(b.bottom);
|
||||
}
|
||||
let (top, bottom) = row_extent(&shot, &open, container, 1);
|
||||
open.top = top;
|
||||
open.bottom = bottom;
|
||||
|
||||
// 布局高 **161** = 8 + 48×3 + 1 + 8；抗锯齿会吃掉上下各 1 行 ⇒ 实测 160
|
||||
assert!(
|
||||
(159..=162).contains(&open.height()),
|
||||
"8.3/8.4 菜单高应 161（= 8 + 48×3 + 1 + 8）：实测 {}",
|
||||
open.height()
|
||||
);
|
||||
|
||||
// 选中项：SecondaryContainer，高 48、左右各内缩 4
|
||||
let selected_box = shot
|
||||
.bbox_of(selected, 2000)
|
||||
.into_iter()
|
||||
.filter(|b| b.height() >= 44 && b.height() <= 50)
|
||||
.max_by_key(|b| b.width())
|
||||
.expect("找不到选中项的 SecondaryContainer");
|
||||
assert!(
|
||||
(46..=48).contains(&selected_box.height()),
|
||||
"8.3 项高应 48：实测 {}",
|
||||
selected_box.height()
|
||||
);
|
||||
// 容器左右缘：在第一项那一行按严格同色扫（bbox 会被阴影外扩 ~2px，不能用）
|
||||
let scan_y = open.top + 10;
|
||||
let row: Vec<usize> = (open.left..=open.right)
|
||||
.filter(|x| matches_within(shot.at(*x, scan_y), container, 2))
|
||||
.collect();
|
||||
let (menu_left, menu_right) = (*row.first().unwrap(), *row.last().unwrap());
|
||||
assert_eq!(selected_box.left - menu_left, 4, "8.6 选中指示器左内缩应 4");
|
||||
assert_eq!(
|
||||
menu_right - selected_box.right,
|
||||
4,
|
||||
"8.6 选中指示器右内缩应 4"
|
||||
);
|
||||
|
||||
// 分组分隔线：1dp OutlineVariant 墨量 ≈1.0（位置在选中项与最后一项之间）
|
||||
let ink = line_ink(
|
||||
&shot,
|
||||
open.left + 20,
|
||||
open.right - 20,
|
||||
selected_box.bottom + 1,
|
||||
selected_box.bottom + 6,
|
||||
container,
|
||||
divider,
|
||||
);
|
||||
assert!(
|
||||
(0.6..=1.4).contains(&ink),
|
||||
"8.x 分组分隔线应 1dp `OutlineVariant`：实测墨量 {ink:.2}"
|
||||
);
|
||||
|
||||
// trailing 槽位必须靠到**行右内边距**上（视觉 r5 P1：早先它紧贴 label 右边）。
|
||||
//
|
||||
// 位置公式：item 右缘 = menu_right − 4（选中指示器内缩）；button 内容右缘 = item 右缘 −
|
||||
// (pad_h − inset) = menu_right − 12；trailing 图标盒 24 的**墨迹**再内缩 k（`Check` 字形
|
||||
// 在 24 viewBox 里右边界 ≈ 5，与 leading 图标「可视边 12、墨迹 16」同一口径）。
|
||||
// 所以墨迹右缘 ≈ menu_right − 17。变异（去掉撑开的 Fill）会让它贴着 label ⇒ 差 ~120。
|
||||
let trailing_ink_color = rgb(ui.color(Role::OnSecondaryContainer));
|
||||
let mut trailing_right = 0usize;
|
||||
for y in selected_box.top..=selected_box.bottom {
|
||||
for x in selected_box.left..=selected_box.right {
|
||||
if matches(shot.at(x, y), trailing_ink_color) {
|
||||
trailing_right = trailing_right.max(x);
|
||||
}
|
||||
}
|
||||
}
|
||||
let trailing_offset = menu_right - trailing_right;
|
||||
assert!(
|
||||
(16..=18).contains(&trailing_offset),
|
||||
"8.6/trailing：带 trailing 的项，其 trailing 墨迹右缘应在 item 右内边距上\
|
||||
（menu_right − 17，允许 ±1）：实测 menu_right={menu_right}、墨迹右缘={trailing_right}\
|
||||
⇒ 偏 {trailing_offset}（贴 label 时会是 ~120）"
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,80 @@
|
||||
//! M77 probe · search（从 `probe.rs` 拆出：单文件 ≤400 行，AGENTS.md §3-1）。
|
||||
|
||||
use super::*;
|
||||
|
||||
/// 20.1 / 20.4 / 20.6 / 20.8 / 20.9：条 56、图标墨迹偏移 20（= 16 + viewBox 4）、
|
||||
/// docked 面板 360 / 头 56 / 分隔线 1.0 `Outline` / 体 240。
|
||||
#[test]
|
||||
fn search_bar_and_docked_panel_geometry() {
|
||||
let dir = require_dir!();
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let shot = shot(&dir, "search", flavor);
|
||||
let ui = ui(flavor);
|
||||
let bar_color = rgb(ui.color(Role::SurfaceContainerHigh));
|
||||
let ink = rgb(ui.color(Role::OnSurface));
|
||||
|
||||
let bars = shot.bbox_of(bar_color, 2000);
|
||||
let bar = bars
|
||||
.iter()
|
||||
.filter(|b| b.height() <= 60 && b.width() >= 360)
|
||||
.min_by_key(|b| b.top)
|
||||
.copied()
|
||||
.expect("找不到搜索条（高 ≤60、宽 ≥360）");
|
||||
assert_eq!(bar.height(), 56, "20.1 搜索条高必须 56");
|
||||
assert!(bar.width() >= 360, "20.2 搜索条宽 ≥ 360");
|
||||
|
||||
// 20.4：图标墨迹左缘 = pad 12 + offset 4 + viewBox 内 ≈4 = 20（±1）
|
||||
let inner = (bar.top + 12)..(bar.bottom - 12);
|
||||
let mut left_ink = usize::MAX;
|
||||
for y in inner.clone() {
|
||||
for x in bar.left..bar.right {
|
||||
if matches(shot.at(x, y), ink) {
|
||||
left_ink = left_ink.min(x);
|
||||
}
|
||||
}
|
||||
}
|
||||
let offset = left_ink - bar.left;
|
||||
assert!(
|
||||
(19..=21).contains(&offset),
|
||||
"20.4 前置图标墨迹偏移应 20（= 12 + 4 + viewBox 4）：实测 {offset}"
|
||||
);
|
||||
|
||||
// 20.6 / 20.9：docked 面板 360 宽，头 56 + 1px 分隔线 + 体 240
|
||||
// （头与体被那条线切成**两个同色块**，所以按 top 排序取前两块）
|
||||
let mut parts = bars
|
||||
.iter()
|
||||
.filter(|b| b.width() == 360)
|
||||
.copied()
|
||||
.collect::<Vec<_>>();
|
||||
parts.sort_by_key(|b| b.top);
|
||||
assert_eq!(parts.len(), 2, "docked 面板 = 头部 + 结果区两块");
|
||||
let (header, body) = (parts[0], parts[1]);
|
||||
assert!(
|
||||
(55..=56).contains(&header.height()),
|
||||
"20.6 面板头部高 56（与 bar 同高；顶部圆角会吃掉 1 行抗锯齿，实测 {}）",
|
||||
header.height()
|
||||
);
|
||||
assert_eq!(body.height(), 240, "20.9 结果区最小高 240");
|
||||
assert!(
|
||||
(2..=3).contains(&(body.top - header.bottom)),
|
||||
"20.8 头与体之间正好 1dp（CPU 档摊成 2 行 ⇒ 隔 2~3 行）：实测 {}",
|
||||
body.top - header.bottom
|
||||
);
|
||||
let panel = header;
|
||||
|
||||
// 20.8：分隔线是 `Outline`（不是 OutlineVariant），1dp 墨量 ≈1.0
|
||||
let divider_ink = line_ink(
|
||||
&shot,
|
||||
panel.left + 40,
|
||||
panel.right - 40,
|
||||
panel.top + 50,
|
||||
panel.top + 62,
|
||||
bar_color,
|
||||
rgb(ui.color(Role::Outline)),
|
||||
);
|
||||
assert!(
|
||||
(0.7..=1.3).contains(÷r_ink),
|
||||
"20.8 头部分隔线应 1dp `Outline`：实测墨量 {divider_ink:.2}"
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,96 @@
|
||||
//! M77 probe · slider（从 `probe.rs` 拆出：单文件 ≤400 行，AGENTS.md §3-1）。
|
||||
|
||||
use super::*;
|
||||
|
||||
/// 11.1~11.6：竖条 4×44、0% 贴左、50% 分界在中央、100% 无未激活段（thumb 永不越界）。
|
||||
#[test]
|
||||
fn slider_thumb_positions_at_zero_half_and_full() {
|
||||
let dir = require_dir!();
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let shot = shot(&dir, "slider", flavor);
|
||||
let ui = ui(flavor);
|
||||
let active = rgb(ui.color(Role::Primary));
|
||||
let inactive = rgb(ui.color(Role::SecondaryContainer));
|
||||
|
||||
// 三条「值行」= 宽 ≥400 的轨道（0% / 50% / 100%），按 y 排序
|
||||
let mut rows: Vec<(usize, usize, usize)> = Vec::new();
|
||||
for y in 0..shot.height {
|
||||
if let Some((left, right)) = longest_run(&shot, y, active, inactive, 20) {
|
||||
// 先按「跨度 ≥300」收行（把抗锯齿行也纳进来），band 建好后再按宽度筛。
|
||||
if right - left + 1 >= 300 {
|
||||
rows.push((y, left, right));
|
||||
}
|
||||
}
|
||||
}
|
||||
// 合并相邻的 y（同一条轨道占 16 行），并把每行的端点累积成 min/max——
|
||||
// 首行/末行都是抗锯齿行，只取它们会把轨道量窄 2~3px。
|
||||
let mut bands: Vec<(usize, usize, usize, usize)> = Vec::new();
|
||||
for (y, left, right) in rows {
|
||||
match bands.last_mut() {
|
||||
Some(last) if y - last.1 <= 3 => {
|
||||
last.1 = y;
|
||||
last.2 = last.2.min(left);
|
||||
last.3 = last.3.max(right);
|
||||
}
|
||||
_ => bands.push((y, y, left, right)),
|
||||
}
|
||||
}
|
||||
// 值行是 448 宽（`Space::X8 × 14`）；五态行 5 条轨道会被并成 ~663 的带，按宽度筛掉
|
||||
let bands: Vec<(usize, usize, usize, usize)> = bands
|
||||
.into_iter()
|
||||
.filter(|(_, _, left, right)| (440..=470).contains(&(right - left + 1)))
|
||||
.collect();
|
||||
assert_eq!(
|
||||
bands.len(),
|
||||
4,
|
||||
"值行应有 4 条（0% / 50% / 100% / 离散）：实测 {}",
|
||||
bands.len()
|
||||
);
|
||||
|
||||
for (label, band) in ["0%", "50%", "100%"].iter().zip(bands.iter()) {
|
||||
let (top, bottom, band_left, band_right) = *band;
|
||||
let mid = (top + bottom) / 2; // 轨道中心行
|
||||
let (left, right) = (band_left, band_right);
|
||||
let width = right - left + 1;
|
||||
let handle_centre = left + 2 + (width - 4) / 2; // 位移区间 = handle/2 .. W-handle/2
|
||||
let boundary = (left..=right)
|
||||
.find(|x| matches(shot.at(*x, mid), inactive))
|
||||
.unwrap_or(right + 1);
|
||||
match *label {
|
||||
"0%" => assert!(
|
||||
boundary <= left + 4,
|
||||
"11.x 0% 时未激活轨必须从竖条（4 宽）之后立刻开始：实测分界 {}",
|
||||
boundary - left
|
||||
),
|
||||
"50%" => assert!(
|
||||
boundary.abs_diff(handle_centre) <= 2,
|
||||
"11.x 50% 的轨道分界应在正中（{handle_centre}）：实测 {boundary}"
|
||||
),
|
||||
_ => {
|
||||
let tail = shot.count_in(inactive, left, right + 1, mid, mid + 1);
|
||||
assert_eq!(tail, 0, "11.x 100% 时不该有未激活段：实测 {tail}px");
|
||||
}
|
||||
}
|
||||
|
||||
// 竖条必须落在轨道内（0% / 100% 的最狠情形）
|
||||
let handles: Vec<BBox> = shot
|
||||
.bbox_of(active, 100)
|
||||
.into_iter()
|
||||
.filter(|b| b.width() == 4 && b.height() >= 40)
|
||||
.collect();
|
||||
assert!(!handles.is_empty(), "11.2 找不到 4×44 的竖条");
|
||||
for handle in handles {
|
||||
assert!(
|
||||
handle.left >= left && handle.right <= right,
|
||||
"11.4 竖条越界：{handle:?} 不在轨道 {left}..{right} 内"
|
||||
);
|
||||
assert!(
|
||||
(43..=44).contains(&handle.height()),
|
||||
"11.2 竖条高必须 44（抗锯齿会吃掉 1 行，实测 {}）",
|
||||
handle.height()
|
||||
);
|
||||
assert_eq!(handle.width(), 4, "11.2 竖条宽必须 4");
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,205 @@
|
||||
//! M77 probe · text（从 `probe.rs` 拆出：单文件 ≤400 行，AGENTS.md §3-1）。
|
||||
|
||||
use super::*;
|
||||
|
||||
/// 9.1 / 9.2：Filled 高 56、宽 320；Filled 指示线 静息 1.0 / 聚焦 2.0 墨量。
|
||||
#[test]
|
||||
fn text_field_height_width_and_indicator_thickness() {
|
||||
let dir = require_dir!();
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let shot = shot(&dir, "text", flavor);
|
||||
let ui = ui(flavor);
|
||||
let surface = rgb(ui.color(Role::Surface));
|
||||
let fill = rgb(ui.color(Role::SurfaceContainerHighest));
|
||||
let line = rgb(ui.color(Role::OnSurfaceVariant));
|
||||
let primary = rgb(ui.color(Role::Primary));
|
||||
|
||||
let mut boxes = shot.bbox_of(fill, 400);
|
||||
boxes.sort_by_key(|b| (b.top, b.left));
|
||||
let wide: Vec<&BBox> = boxes.iter().filter(|b| b.width() >= 280).collect();
|
||||
// 320 宽的有两个 Filled（空 / 有值）；第三格是 Outlined 错误态——它没有容器色，
|
||||
// 所以这里只要求 ≥2，错误态由 `outlined_stroke_and_error_paint` 单独验。
|
||||
assert!(
|
||||
wide.len() >= 2,
|
||||
"{flavor:?}: 至少要有 2 个 320 宽的 Filled 文本字段（实测 {}）",
|
||||
wide.len()
|
||||
);
|
||||
|
||||
// 320 宽那三个 = 「空 / 有值 / 错误」三格；高度必须精确 56
|
||||
for bbox in wide.iter().take(2) {
|
||||
assert!(
|
||||
(280..=320).contains(&bbox.width()),
|
||||
"9.2 最小宽 280：实测 {}（320 宽格）",
|
||||
bbox.width()
|
||||
);
|
||||
let column = bbox.right - 20;
|
||||
let (top, bottom) = vertical_extent(&shot, bbox, fill, surface, column);
|
||||
assert_eq!(
|
||||
bottom - top + 1,
|
||||
56,
|
||||
"9.1 高度必须精确 56（带浮动标签）：实测 {flavor:?} @x={column}"
|
||||
);
|
||||
}
|
||||
|
||||
// 矩阵第一行（Filled 五态）＝最靠上的 5 个 160 宽格：列序 = Interaction::ALL
|
||||
// 五态里 disabled 的容器是 `OnSurface@12%`（另一种颜色），所以这里只有 4 块：
|
||||
// enabled / hovered / pressed / focused —— 列序与 `Interaction::ALL` 一致。
|
||||
let row: Vec<&BBox> = boxes
|
||||
.iter()
|
||||
.filter(|b| (140..=170).contains(&b.width()))
|
||||
.take(4)
|
||||
.collect();
|
||||
assert_eq!(row.len(), 4, "{flavor:?}: Filled 矩阵应有 4 个同色格");
|
||||
let enabled = row[0];
|
||||
let focused = row[3];
|
||||
|
||||
// 静息指示线 1dp：墨量 ≈ 1.0
|
||||
let enabled_ink = line_ink(
|
||||
&shot,
|
||||
enabled.left + 8,
|
||||
enabled.right - 8,
|
||||
enabled.bottom,
|
||||
enabled.bottom + 4,
|
||||
fill,
|
||||
line,
|
||||
);
|
||||
assert!(
|
||||
(0.6..=1.4).contains(&enabled_ink),
|
||||
"9.4 静息指示线应 1dp：实测墨量 {enabled_ink:.2}"
|
||||
);
|
||||
|
||||
// 聚焦指示线 2dp：墨量 ≈ 2.0（画成 1dp 会掉到 ~1.0）
|
||||
let focused_ink = line_ink(
|
||||
&shot,
|
||||
focused.left + 8,
|
||||
focused.right - 8,
|
||||
focused.bottom,
|
||||
focused.bottom + 5,
|
||||
fill,
|
||||
primary,
|
||||
);
|
||||
assert!(
|
||||
(1.5..=2.5).contains(&focused_ink),
|
||||
"9.4 聚焦指示线应 2dp：实测墨量 {focused_ink:.2}（1dp 会掉到 ≈1.0）"
|
||||
);
|
||||
assert!(
|
||||
focused_ink > enabled_ink + 0.5,
|
||||
"聚焦必须比静息粗一档（{focused_ink:.2} vs {enabled_ink:.2}）"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 9.4 / 9.7：Outlined 描边 静息 1dp / 聚焦 2dp；错误态线/标签/辅助文本全 `Error`。
|
||||
///
|
||||
/// 量法：**在某一列的竖线上扫**（不是找同色块）——深色档里 hover 描边的抗锯齿像素也会落进
|
||||
/// `Outline` 的容差里，按「最上面的同色块」取会取错行（实测 dark 取到了 hover 那一行）。
|
||||
#[test]
|
||||
fn outlined_stroke_and_error_paint() {
|
||||
let dir = require_dir!();
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let shot = shot(&dir, "text", flavor);
|
||||
let ui = ui(flavor);
|
||||
let surface = rgb(ui.color(Role::Surface));
|
||||
let fill = rgb(ui.color(Role::SurfaceContainerHighest));
|
||||
let outline = rgb(ui.color(Role::Outline));
|
||||
let primary = rgb(ui.color(Role::Primary));
|
||||
let error = rgb(ui.color(Role::Error));
|
||||
|
||||
// 矩阵第一列（enabled）的左缘与行距：列宽 160 + 间距 8 = 168
|
||||
let left = shot
|
||||
.bbox_of(fill, 400)
|
||||
.into_iter()
|
||||
.filter(|b| (140..=170).contains(&b.width()))
|
||||
.min_by_key(|b| (b.top, b.left))
|
||||
.expect("找不到 Filled 矩阵格")
|
||||
.left;
|
||||
let filled_bottom = shot
|
||||
.bbox_of(fill, 400)
|
||||
.into_iter()
|
||||
.filter(|b| (140..=170).contains(&b.width()))
|
||||
.min_by_key(|b| (b.top, b.left))
|
||||
.expect("找不到 Filled 矩阵格")
|
||||
.bottom;
|
||||
|
||||
let column = |index: usize| left + index * 168 + 120;
|
||||
|
||||
// 静息（第 1 列）描边 1dp：在竖线上找第一处比底色更接近 `Outline` 的像素
|
||||
let rest_y = ((filled_bottom + 8)..shot.height)
|
||||
.find(|y| nearer(shot.at(column(0), *y), outline, surface))
|
||||
.expect("竖线上找不到 Outlined 静息描边");
|
||||
let rest_ink = line_ink(
|
||||
&shot,
|
||||
column(0) - 40,
|
||||
column(0) + 40,
|
||||
rest_y.saturating_sub(2),
|
||||
rest_y + 3,
|
||||
surface,
|
||||
outline,
|
||||
);
|
||||
// 描边的墨量随**亚像素相位**在 1.0~1.67 之间浮动（同一 1dp：整行对齐 = 1.0，
|
||||
// 落在半像素上 = 1 行满 + 1 行 0.67）。所以静息只做宽松下限，**宽度差异由比值判**。
|
||||
assert!(
|
||||
(0.8..=1.9).contains(&rest_ink),
|
||||
"9.4 Outlined 静息描边应 1dp（实测墨量 {rest_ink:.2}；2dp 会到 2.0）"
|
||||
);
|
||||
|
||||
// 聚焦（第 4 列）描边 2dp
|
||||
let focus_y = ((filled_bottom + 8)..shot.height)
|
||||
.find(|y| nearer(shot.at(column(3), *y), primary, surface))
|
||||
.expect("竖线上找不到 Outlined 聚焦描边");
|
||||
let focus_ink = line_ink(
|
||||
&shot,
|
||||
column(3) - 40,
|
||||
column(3) + 40,
|
||||
focus_y.saturating_sub(2),
|
||||
focus_y + 4,
|
||||
surface,
|
||||
primary,
|
||||
);
|
||||
assert!(
|
||||
(1.8..=2.3).contains(&focus_ink),
|
||||
"9.4 Outlined 聚焦描边应 2dp（实测墨量 {focus_ink:.2}；1dp 会掉到 1.67）"
|
||||
);
|
||||
let ratio = focus_ink / rest_ink;
|
||||
assert!(
|
||||
(1.6..=2.5).contains(&ratio),
|
||||
"聚焦必须正好粗一倍（2dp/1dp）：实测比值 {ratio:.2}（{focus_ink:.2} vs {rest_ink:.2}）"
|
||||
);
|
||||
|
||||
// 9.7：错误格——描边 2dp + 标签（框内上带）+ 辅助文本（框下）全 `Error`
|
||||
let error_box = shot
|
||||
.bbox_of(error, 2000)
|
||||
.into_iter()
|
||||
.filter(|b| b.width() >= 280)
|
||||
.max_by_key(|b| b.width())
|
||||
.expect("找不到错误态字段");
|
||||
assert!(
|
||||
error_box.height() >= 50,
|
||||
"错误格应是一整个 320 宽的字段（实测 {}×{}）",
|
||||
error_box.width(),
|
||||
error_box.height()
|
||||
);
|
||||
let label_ink = shot.count_in(
|
||||
error,
|
||||
error_box.left,
|
||||
error_box.right + 1,
|
||||
error_box.top + 2,
|
||||
error_box.top + 22,
|
||||
);
|
||||
let supporting_ink = shot.count_in(
|
||||
error,
|
||||
error_box.left,
|
||||
error_box.right + 1,
|
||||
error_box.bottom + 1,
|
||||
error_box.bottom + 30,
|
||||
);
|
||||
assert!(
|
||||
label_ink > 20,
|
||||
"9.7 错误标签没变成 Error（框内上带墨迹 {label_ink}px）"
|
||||
);
|
||||
assert!(
|
||||
supporting_ink > 20,
|
||||
"9.7 错误辅助文本没变成 Error（框下墨迹 {supporting_ink}px）"
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,353 @@
|
||||
//! 搜索（`research/15` §20）：官方是**两个组件**——[`search_bar`]（收起）+ [`search_view`]（展开）。
|
||||
//!
|
||||
//! ## 参考值（`[源]` = A1；本机 `material3-android:1.4.0` 的 `SearchBarTokens` / `SearchBar.kt`）
|
||||
//!
|
||||
//! | # | 检查项 | 参考值 | 落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 20.1 | 高 + 圆角 | 高 **56**、圆角 **full = 28**（药丸，不是圆角矩形） | `LM.search_bar_height` + `Component::Search.spec().shape` |
|
||||
//! | 20.2 | 宽 | min **360** / max **720**（G20：iced 无 min-width，只施加 max） | [`SEARCH_MAX_WIDTH`](super::geometry::SEARCH_MAX_WIDTH) |
|
||||
//! | 20.3 | 容器色 / 高程 | `SurfaceContainerHigh` + **L0**（token 写 L3，默认值是 L0，按观感取 L0） | `Role::SurfaceContainerHigh` |
|
||||
//! | 20.4 | 图标位 | leading 24/`OnSurface`、trailing 24/`OnSurfaceVariant`；**可视边 16 = pad 12 + offset 4** | `ComponentMetrics::SEARCH_BAR` |
|
||||
//! | 20.5 | 文本 / 占位 / 聚焦 | 输入 `BodyLarge`+`OnSurface`；占位 `OnSurfaceVariant`；聚焦 `Secondary` 1px 指示 | `TypeRole` / `Role::Secondary` |
|
||||
//! | 20.6 | docked 面板 | 头部 **56**、形状 `CornerExtraLarge` = **28** | `ShapeScale::ExtraLarge` |
|
||||
//! | 20.8 | 头部 / 结果区分隔 | **1px `Outline`**（**不是** `OutlineVariant`！） | 见下 |
|
||||
//! | 20.9 | 面板尺寸 | 顶距 8、最小高 **240**、docked 宽 **360** | §20B |
|
||||
//!
|
||||
//! ## 三处实现口径
|
||||
//!
|
||||
//! 1. **图标可视边一律 `pad + icon_offset` 求和**（`SEARCH_BAR.pad_start = 12` + `icon_offset = 4` = 16）。
|
||||
//! M69 把这两个值钉成不变量，本文件**不写 16、也不写 12/4**——只做加法。
|
||||
//! 2. `20.8` 的分隔线用 `Role::Outline`，而 `components::divider` 给的是 `OutlineVariant`
|
||||
//! （那是正文分隔线的角色）。两个角色在 A1 里明确不同，所以这里**不复用** `divider`，
|
||||
//! 只按一像素线（`stroke::HAIRLINE`）画一条 —— 复用会把 20.8 判成「报 OutlineVariant 即错」。
|
||||
//! 3. bar 的 hover / pressed / disabled 在 `SearchBarTokens` 里**没有** token。
|
||||
//! hover/pressed 按通用状态层（`interaction::overlay_color`，8%/10%），disabled 按令牌的
|
||||
//! 12%/38%，都登记为 [估]（D14 / D15）；焦点指示用 A1 的 `FocusIndicatorColor = Secondary`。
|
||||
|
||||
use iced::widget::text::LineHeight;
|
||||
use iced::widget::{column, container, row, text, text_input};
|
||||
use iced::{Alignment, Background, Border, Color, Element, Length, Padding, Pixels};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::component_map::{Component, ComponentMetrics};
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::shape::ShapeScale;
|
||||
use unlucky_design::spacing::Space;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::icons;
|
||||
use crate::theme::{Ui, STROKE_PX};
|
||||
|
||||
use super::super::interaction::{self, Interaction};
|
||||
use super::super::layout;
|
||||
use super::geometry::{SEARCH_MAX_WIDTH, SEARCH_MIN_WIDTH, SEARCH_VIEW_MIN_HEIGHT};
|
||||
|
||||
/// 搜索条（收起形态）。
|
||||
///
|
||||
/// 状态矩阵用 [`SearchBar::state`] 强制；运行期五态由 `Tracker`/`text_input` 的真实事件驱动。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct SearchBar<'a> {
|
||||
value: &'a str,
|
||||
placeholder: &'a str,
|
||||
trailing: Option<IconKind>,
|
||||
state: Option<Interaction>,
|
||||
width: Length,
|
||||
}
|
||||
|
||||
impl<'a> SearchBar<'a> {
|
||||
/// 一条收起态搜索条（默认占位文案由页面给，组件内不拼中文）。
|
||||
pub fn new(value: &'a str) -> Self {
|
||||
Self {
|
||||
value,
|
||||
placeholder: "",
|
||||
trailing: Some(IconKind::Filter),
|
||||
state: None,
|
||||
width: Length::Fill,
|
||||
}
|
||||
}
|
||||
|
||||
/// 占位文案。
|
||||
pub fn placeholder(mut self, placeholder: &'a str) -> Self {
|
||||
self.placeholder = placeholder;
|
||||
self
|
||||
}
|
||||
|
||||
/// 强制视觉态（gallery 取证）。
|
||||
pub fn state(mut self, state: Interaction) -> Self {
|
||||
self.state = Some(state);
|
||||
self
|
||||
}
|
||||
|
||||
/// 定宽（默认 `Fill`）。
|
||||
pub fn width(mut self, width: Length) -> Self {
|
||||
self.width = width;
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 搜索条内的一行内容（bar 与 view 头部共用，保证「展开时头部不跳」——20.6）。
|
||||
#[allow(clippy::too_many_arguments)]
|
||||
fn bar_content<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
value: &'a str,
|
||||
placeholder: &'a str,
|
||||
trailing: Option<IconKind>,
|
||||
state: Interaction,
|
||||
on_input: impl Fn(String) -> M + 'a,
|
||||
) -> Element<'a, M> {
|
||||
// 20.4：可视边 = pad + offset（**求和**，不抄 16）
|
||||
let bar: ComponentMetrics = Component::Search.metrics().expect("Search 有组件级度量");
|
||||
// 20.4：图标**可视边** = pad + offset（M69 不变量）。这里反解出偏移，两侧共用同一个量。
|
||||
let icon_edge = bar.pad_start + bar.icon_offset;
|
||||
let icon_offset = icon_edge - bar.pad_start;
|
||||
|
||||
let ink = if state.is_disabled() {
|
||||
interaction::disabled_content_over_role(ui, Role::OnSurface, true)
|
||||
} else {
|
||||
ui.color(Role::OnSurface)
|
||||
};
|
||||
let subtle = if state.is_disabled() {
|
||||
ink
|
||||
} else {
|
||||
ui.color(Role::OnSurfaceVariant)
|
||||
};
|
||||
|
||||
let body_style = ui.style(TypeRole::BodyLarge);
|
||||
let input = text_input(placeholder, value)
|
||||
.on_input_maybe(if state.is_disabled() {
|
||||
None
|
||||
} else {
|
||||
Some(on_input)
|
||||
})
|
||||
.size(body_style.size_px)
|
||||
.line_height(LineHeight::Absolute(Pixels(body_style.line_height_px)))
|
||||
.font(ui.font_of(body_style))
|
||||
.padding(Padding::default())
|
||||
.width(Length::Fill)
|
||||
.style(move |_theme, _status| text_input::Style {
|
||||
background: Background::Color(Color::TRANSPARENT),
|
||||
border: Border::default(),
|
||||
icon: subtle,
|
||||
placeholder: subtle,
|
||||
value: ink,
|
||||
selection: ink,
|
||||
});
|
||||
|
||||
// 前置图标：左边 = pad（容器内边距 12）+ offset（4）= 16。两层分别来自令牌的两个字段。
|
||||
let leading = container(layout::fixed(
|
||||
bar.icon,
|
||||
bar.icon,
|
||||
icons::view::<M>(IconKind::Search, ink),
|
||||
))
|
||||
.padding(Padding {
|
||||
top: 0.0,
|
||||
right: 0.0,
|
||||
bottom: 0.0,
|
||||
left: icon_offset,
|
||||
});
|
||||
|
||||
let mut contents = row![leading, input]
|
||||
.align_y(Alignment::Center)
|
||||
.spacing(bar.gap);
|
||||
|
||||
if let Some(kind) = trailing {
|
||||
// 尾随图标：右边 = pad_end + offset（镜像同式），所以右缘也在 16 上
|
||||
let trailing = container(layout::fixed(
|
||||
bar.icon,
|
||||
bar.icon,
|
||||
icons::view::<M>(kind, subtle),
|
||||
))
|
||||
.padding(Padding {
|
||||
top: 0.0,
|
||||
right: icon_offset,
|
||||
bottom: 0.0,
|
||||
left: 0.0,
|
||||
});
|
||||
contents = contents.push(trailing);
|
||||
}
|
||||
|
||||
container(contents)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fill)
|
||||
.align_y(Alignment::Center)
|
||||
.padding(Padding {
|
||||
top: 0.0,
|
||||
right: bar.pad_end,
|
||||
bottom: 0.0,
|
||||
left: bar.pad_start,
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 收起态搜索条（56 高、药丸、`SurfaceContainerHigh`、无可见阴影）。
|
||||
pub fn search_bar<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
bar: SearchBar<'a>,
|
||||
on_input: impl Fn(String) -> M + 'a,
|
||||
) -> Element<'a, M> {
|
||||
let state = bar.state.unwrap_or(Interaction::Enabled);
|
||||
let component = Component::Search.spec();
|
||||
let height = ui.metrics().search_bar_height;
|
||||
|
||||
let background = if state.is_disabled() {
|
||||
interaction::disabled_colors(ui, Role::Surface).0
|
||||
} else {
|
||||
let role = Role::SurfaceContainerHigh;
|
||||
interaction::overlay_color(ui, state, Role::OnSurface, role).unwrap_or(ui.color(role))
|
||||
};
|
||||
|
||||
// 20.5：聚焦指示 = 1px `Secondary`（A1 的 token 存在但 Compose 未消费 → 标 [规格]）
|
||||
let focus_ring = matches!(state, Interaction::Focused);
|
||||
let border = Border {
|
||||
color: if focus_ring {
|
||||
ui.color(Role::Secondary)
|
||||
} else {
|
||||
Color::TRANSPARENT
|
||||
},
|
||||
width: if focus_ring { STROKE_PX } else { 0.0 },
|
||||
radius: ui.radius(component.shape, height),
|
||||
};
|
||||
|
||||
container(bar_content(
|
||||
ui,
|
||||
bar.value,
|
||||
bar.placeholder,
|
||||
bar.trailing,
|
||||
state,
|
||||
on_input,
|
||||
))
|
||||
.width(bar.width)
|
||||
// 20.2：max **720**（`SearchBarMaxWidth`）。min 360 无法在 iced 表达（G20），由页面保证列宽。
|
||||
.max_width(SEARCH_MAX_WIDTH)
|
||||
.height(Length::Fixed(height))
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(background)),
|
||||
border,
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 展开态搜索面板（docked 形态：桌面 1180 窗口永远用它，`20C` 的结论）。
|
||||
///
|
||||
/// 形状：头部 56（半径 28）+ 1px `Outline` 分隔 + 结果区（最小 240）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct SearchView<'a> {
|
||||
value: &'a str,
|
||||
placeholder: &'a str,
|
||||
empty: &'a str,
|
||||
results: &'a [&'a str],
|
||||
width: f32,
|
||||
}
|
||||
|
||||
impl<'a> SearchView<'a> {
|
||||
/// 一个展开面板（`empty` = 空结果文案，由页面给 i18n 文本）。
|
||||
pub fn new(value: &'a str, results: &'a [&'a str], empty: &'a str) -> Self {
|
||||
Self {
|
||||
value,
|
||||
placeholder: "",
|
||||
empty,
|
||||
results,
|
||||
width: SEARCH_MIN_WIDTH,
|
||||
}
|
||||
}
|
||||
|
||||
/// 占位文案。
|
||||
pub fn placeholder(mut self, placeholder: &'a str) -> Self {
|
||||
self.placeholder = placeholder;
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 展开态搜索面板。
|
||||
pub fn search_view<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
view: SearchView<'a>,
|
||||
on_input: impl Fn(String) -> M + 'a,
|
||||
) -> Element<'a, M> {
|
||||
let panel = ui.color(Role::SurfaceContainerHigh);
|
||||
let header_height = ui.metrics().search_bar_height;
|
||||
let body_style = ui.style(TypeRole::BodyMedium);
|
||||
|
||||
// 20.8：头部/结果区分隔是 **`Outline`**（正文分隔线才是 OutlineVariant）
|
||||
let divider = container(iced::widget::space::horizontal())
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(STROKE_PX))
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(ui.color(Role::Outline))),
|
||||
..container::Style::default()
|
||||
});
|
||||
|
||||
let mut rows = column![].width(Length::Fill).spacing(0);
|
||||
for result in view.results {
|
||||
rows = rows.push(
|
||||
container(
|
||||
text(*result)
|
||||
.size(body_style.size_px)
|
||||
.font(ui.font_of(body_style))
|
||||
.color(ui.color(Role::OnSurface)),
|
||||
)
|
||||
.width(Length::Fill)
|
||||
.padding(Padding {
|
||||
top: ui.space(Space::X2),
|
||||
right: ui.space(Space::X4),
|
||||
bottom: ui.space(Space::X2),
|
||||
left: ui.space(Space::X4),
|
||||
}),
|
||||
);
|
||||
}
|
||||
if view.results.is_empty() {
|
||||
let small = ui.style(TypeRole::BodySmall);
|
||||
rows = rows.push(
|
||||
container(
|
||||
text(view.empty)
|
||||
.size(small.size_px)
|
||||
.font(ui.font_of(small))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
)
|
||||
.width(Length::Fill)
|
||||
.padding(Padding {
|
||||
top: ui.space(Space::X4),
|
||||
right: ui.space(Space::X4),
|
||||
bottom: ui.space(Space::X4),
|
||||
left: ui.space(Space::X4),
|
||||
}),
|
||||
);
|
||||
}
|
||||
|
||||
let body = container(rows)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(SEARCH_VIEW_MIN_HEIGHT))
|
||||
.align_y(Alignment::Start);
|
||||
|
||||
let panel_content = column![
|
||||
container(bar_content(
|
||||
ui,
|
||||
view.value,
|
||||
view.placeholder,
|
||||
Some(IconKind::Close),
|
||||
Interaction::Enabled,
|
||||
on_input,
|
||||
))
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(header_height)),
|
||||
divider,
|
||||
body,
|
||||
];
|
||||
|
||||
container(panel_content)
|
||||
.width(Length::Fixed(view.width))
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(panel)),
|
||||
// 20.6：docked 面板 = CornerExtraLarge（28）；bar ⇄ view 半径不变（§20C）
|
||||
border: Border {
|
||||
radius: ui.radius_dp(ShapeScale::ExtraLarge),
|
||||
..Border::default()
|
||||
},
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
@@ -0,0 +1,93 @@
|
||||
//! search 的单测（从 `search.rs` 拆出：单文件 ≤400 行，AGENTS.md §3-1）。
|
||||
|
||||
use super::*;
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
fn leaked(flavor: SchemeFlavor) -> &'static Ui {
|
||||
Box::leak(Box::new(ui(flavor)))
|
||||
}
|
||||
|
||||
/// **M69 不变量**：图标可视边 = pad + offset（12 + 4 = 16），且本实现只做加法。
|
||||
#[test]
|
||||
fn icon_edge_is_pad_plus_offset_not_a_literal() {
|
||||
let bar = Component::Search.metrics().expect("Search 有组件级度量");
|
||||
assert_eq!(bar.pad_start, 12.0, "M69 钉住的 pad_start");
|
||||
assert_eq!(bar.icon_offset, 4.0, "M69 钉住的 icon_offset");
|
||||
assert_eq!(bar.pad_start + bar.icon_offset, 16.0);
|
||||
assert_eq!(bar.icon, 24.0, "SearchBarTokens 图标 24");
|
||||
// 文本从 pad（12）起：图标（16..40）+ gap 8 → 48 是文字的实际起点
|
||||
assert_eq!(
|
||||
bar.pad_start + bar.icon_offset + bar.icon + bar.gap,
|
||||
48.0,
|
||||
"图标槽 + 间距后文字起点 48"
|
||||
);
|
||||
}
|
||||
|
||||
/// 20.1：高 56、圆角 full = 28（药丸）；条高来自 LM，不重复定义。
|
||||
#[test]
|
||||
fn bar_height_and_radius_come_from_tokens() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
assert_eq!(ui.metrics().search_bar_height, 56.0);
|
||||
assert_eq!(
|
||||
ShapeScale::Full.radius_px(ui.metrics().search_bar_height),
|
||||
28.0,
|
||||
"SearchBarCornerRadius = InputFieldHeight / 2"
|
||||
);
|
||||
assert_eq!(Component::Search.spec().shape, ShapeScale::Full);
|
||||
// 高程按观感取 L0（无可见阴影）
|
||||
assert_eq!(
|
||||
Component::Search.spec().elevation,
|
||||
unlucky_design::elevation::Elevation::Level0
|
||||
);
|
||||
}
|
||||
|
||||
/// 20.6 / 20.9：面板头部 56、形状 ExtraLarge(28)、最小高 240、docked 宽 360。
|
||||
#[test]
|
||||
fn docked_panel_geometry() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
assert_eq!(ShapeScale::ExtraLarge.dp(), 28.0, "DockedContainerShape");
|
||||
assert_eq!(
|
||||
SEARCH_VIEW_MIN_HEIGHT, 240.0,
|
||||
"DockedExpandedTableMinHeight"
|
||||
);
|
||||
assert_eq!(SEARCH_MIN_WIDTH, 360.0, "SearchBarMinWidth = docked 面板宽");
|
||||
assert_eq!(ui.metrics().search_bar_height, 56.0, "头部与 bar 同高");
|
||||
}
|
||||
|
||||
/// bar 与 view 都能构建（含禁用态：输入被摘掉）。
|
||||
#[test]
|
||||
fn both_forms_build() {
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
for state in Interaction::ALL {
|
||||
let ui = leaked(flavor);
|
||||
let bar = SearchBar::new("").placeholder("搜索").state(state);
|
||||
let _: Element<'_, u8> = search_bar(ui, bar, |_| 0_u8);
|
||||
|
||||
let results: &[&str] = &["实例一", "1.21.4"];
|
||||
let view = SearchView::new("实例", results, "没有结果").placeholder("搜索");
|
||||
let _: Element<'_, u8> = search_view(ui, view, |_| 0_u8);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 空结果也必须给面板内容（20C：不许收回到 bar）。
|
||||
#[test]
|
||||
fn empty_results_still_render_a_panel() {
|
||||
let ui = leaked(SchemeFlavor::Light);
|
||||
let empty: &[&str] = &[];
|
||||
let view = SearchView::new("xyz", empty, "没有结果");
|
||||
let _: Element<'_, u8> = search_view(ui, view, |_| 0_u8);
|
||||
}
|
||||
@@ -0,0 +1,396 @@
|
||||
//! 滑块（`research/12b` §11，A1）：**自绘 `Widget`**——M3 Expressive 的滑块是「竖条」，不是圆点。
|
||||
//!
|
||||
//! ## 参考值（`[源]` = A1，`SliderTokens`）
|
||||
//!
|
||||
//! | # | 检查项 | 参考值 | 落点 |
|
||||
//! |---|---|---|---|
|
||||
//! | 11.1 | 轨道高 | **16**，圆角 full（= 8） | `TRACK_HEIGHT`（G18） |
|
||||
//! | 11.2 | handle 形态 | **4 宽 × 44 高**，圆角 full；focus / pressed 收窄到 **2** | `HANDLE_WIDTH` / `HANDLE_HEIGHT` |
|
||||
//! | 11.3 | 颜色 | 激活轨 `Primary`、未激活轨 `SecondaryContainer`、handle `Primary` | `Role::*` |
|
||||
//! | 11.4 | handle 与轨道 | 纵向溢出：上下各 **14**（(44−16)/2） | 推导 |
|
||||
//! | 11.5 | 命中高度 | **48**（`LM.touch_target`；竖条 44 + 上下各 2） | `SliderGeometry::height` |
|
||||
//! | 11.6 | 禁用 | 激活轨 `OnSurface`@**38%**、未激活 @**12%**、handle @**38%** | `interaction::*` |
|
||||
//! | — | 离散停靠点 | **4** 圆点 `SecondaryContainer`（`StopIndicatorSize`）；尾随间距 6 | [`Slider::steps`] |
|
||||
//!
|
||||
//! ## 为什么必须自绘
|
||||
//!
|
||||
//! iced 内置 `slider` 只能画「轨道 + 圆形/矩形 handle（高度 = 控件高）」，
|
||||
//! **没有停靠点、没有禁用态、无法强制取证态**；而 §11.2 的 4×44 竖条要求 handle 高（44）
|
||||
//! 与轨道高（16）分离。所以这里用 `advanced::Widget` 自绘：布局只有「宽 × 48」一个原子，
|
||||
//! 轨道/激活段/停靠点/竖条全部用 `fill_quad` 画进同一个 bounds——几何因此在像素级可断言。
|
||||
//!
|
||||
//! ## 状态层（[估]，登记 D16）
|
||||
//!
|
||||
//! `SliderTokens` **没有**状态层直径（M3 Expressive 去掉了旧版的水滴 halo），hover/pressed 只体现为
|
||||
//! handle 宽度与颜色。为了让五态在验收图上可辨且 α 只认令牌，这里把**通用状态层**
|
||||
//! （`interaction::overlay_color`：hover 8% / focus 10% / pressed 10%）叠在 handle 上，
|
||||
//! 宽度仍按 A1 收窄——两件事都来自令牌，没有新数值。
|
||||
//!
|
||||
//! ## 拖动
|
||||
//!
|
||||
//! `on_change` 有值就启用拖动与点击跳转；`None` = 禁用（也不吃事件）。
|
||||
//! 值由外部持有（受控组件），拖动只 `publish` 新比例：组件不持有业务状态（契约 §2）。
|
||||
|
||||
use iced::advanced::layout::{self, Layout};
|
||||
use iced::advanced::renderer::Quad;
|
||||
use iced::advanced::widget::{tree, Tree};
|
||||
use iced::advanced::{mouse, Clipboard, Shell, Widget};
|
||||
use iced::{Background, Border, Color, Element, Event, Length, Rectangle, Size};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::interaction::{self, Interaction, Tracker};
|
||||
use super::geometry::{SliderGeometry, HANDLE_HEIGHT, HANDLE_WIDTH_ACTIVE, STOP_GAP, STOP_SIZE};
|
||||
|
||||
mod track;
|
||||
|
||||
pub use track::TrackGeometry;
|
||||
|
||||
use track::{fraction_at, quantize, EPSILON};
|
||||
|
||||
/// 一个滑块（受控：`fraction` 由外部给，变化经 `on_change` 回传）。
|
||||
pub struct Slider<'a, M> {
|
||||
ui: &'a Ui,
|
||||
fraction: f32,
|
||||
steps: Option<u32>,
|
||||
on_change: Option<Box<dyn Fn(f32) -> M + 'a>>,
|
||||
forced: Option<Interaction>,
|
||||
}
|
||||
|
||||
impl<'a, M> Slider<'a, M> {
|
||||
/// 连续值滑块（0.0 ~= 1.0）。
|
||||
pub fn new(ui: &'a Ui, fraction: f32) -> Self {
|
||||
Self {
|
||||
ui,
|
||||
fraction: fraction.clamp(0.0, 1.0),
|
||||
steps: None,
|
||||
on_change: None,
|
||||
forced: None,
|
||||
}
|
||||
}
|
||||
|
||||
/// 离散值：`steps` = 分段数（4 → 5 个停靠点 0 / 25 / 50 / 75 / 100%）。
|
||||
pub fn steps(mut self, steps: u32) -> Self {
|
||||
self.steps = Some(steps.max(1));
|
||||
self.fraction = quantize(self.fraction, self.steps);
|
||||
self
|
||||
}
|
||||
|
||||
/// 值变化回调；不给 = 禁用。
|
||||
pub fn on_change(mut self, on_change: impl Fn(f32) -> M + 'a) -> Self {
|
||||
self.on_change = Some(Box::new(on_change));
|
||||
self
|
||||
}
|
||||
|
||||
/// 强制视觉态（gallery 状态矩阵取证）。
|
||||
pub fn state(mut self, state: Interaction) -> Self {
|
||||
self.forced = Some(state);
|
||||
self
|
||||
}
|
||||
|
||||
/// 当前比例（量化后）。
|
||||
fn value(&self) -> f32 {
|
||||
quantize(self.fraction, self.steps)
|
||||
}
|
||||
|
||||
/// 禁用与否：没有回调就是禁用（与按钮 `on_press: Option<M>` 同一口径）。
|
||||
fn enabled(&self) -> bool {
|
||||
self.on_change.is_some() && !matches!(self.forced, Some(Interaction::Disabled))
|
||||
}
|
||||
}
|
||||
|
||||
/// `Widget` 的状态：五态状态机（[`Tracker`]）+ 是否正在拖动。
|
||||
#[derive(Debug, Default)]
|
||||
struct State {
|
||||
tracker: Tracker,
|
||||
dragging: bool,
|
||||
}
|
||||
|
||||
/// 一个圆角实心块（轨道的所有部件都是它）。
|
||||
fn quad(bounds: Rectangle, radius: f32, color: Color) -> (Quad, Background) {
|
||||
(
|
||||
Quad {
|
||||
bounds,
|
||||
border: Border {
|
||||
radius: radius.into(),
|
||||
..Border::default()
|
||||
},
|
||||
..Quad::default()
|
||||
},
|
||||
Background::Color(color),
|
||||
)
|
||||
}
|
||||
|
||||
impl<'a, M, Theme, Renderer> Widget<M, Theme, Renderer> for Slider<'a, M>
|
||||
where
|
||||
M: Clone,
|
||||
Renderer: iced::advanced::Renderer,
|
||||
{
|
||||
fn size(&self) -> Size<Length> {
|
||||
Size {
|
||||
width: Length::Fill,
|
||||
height: Length::Fixed(SliderGeometry::of(self.ui).height),
|
||||
}
|
||||
}
|
||||
|
||||
fn tag(&self) -> tree::Tag {
|
||||
tree::Tag::of::<State>()
|
||||
}
|
||||
|
||||
fn state(&self) -> tree::State {
|
||||
tree::State::new(State {
|
||||
tracker: Tracker::new(self.enabled()),
|
||||
dragging: false,
|
||||
})
|
||||
}
|
||||
|
||||
fn layout(
|
||||
&mut self,
|
||||
_tree: &mut Tree,
|
||||
_renderer: &Renderer,
|
||||
limits: &layout::Limits,
|
||||
) -> layout::Node {
|
||||
layout::atomic(
|
||||
limits,
|
||||
Length::Fill,
|
||||
Length::Fixed(SliderGeometry::of(self.ui).height),
|
||||
)
|
||||
}
|
||||
|
||||
fn update(
|
||||
&mut self,
|
||||
tree: &mut Tree,
|
||||
event: &Event,
|
||||
layout: Layout<'_>,
|
||||
cursor: mouse::Cursor,
|
||||
_renderer: &Renderer,
|
||||
_clipboard: &mut dyn Clipboard,
|
||||
shell: &mut Shell<'_, M>,
|
||||
_viewport: &Rectangle,
|
||||
) {
|
||||
if self.forced.is_some() {
|
||||
return;
|
||||
}
|
||||
|
||||
let enabled = self.enabled();
|
||||
let geometry = SliderGeometry::of(self.ui);
|
||||
let bounds = layout.bounds();
|
||||
let state = tree.state.downcast_mut::<State>();
|
||||
if state.tracker.set_enabled(enabled) {
|
||||
shell.request_redraw();
|
||||
}
|
||||
|
||||
let mut target: Option<f32> = None;
|
||||
match event {
|
||||
Event::Mouse(mouse::Event::ButtonPressed(mouse::Button::Left))
|
||||
if enabled && cursor.is_over(bounds) =>
|
||||
{
|
||||
if let Some(position) = cursor.position() {
|
||||
state.dragging = true;
|
||||
target = Some(fraction_at(bounds, position.x, geometry.handle));
|
||||
shell.capture_event();
|
||||
}
|
||||
}
|
||||
Event::Mouse(mouse::Event::CursorMoved { .. }) if state.dragging => {
|
||||
if let Some(position) = cursor.position() {
|
||||
target = Some(fraction_at(bounds, position.x, geometry.handle));
|
||||
shell.capture_event();
|
||||
}
|
||||
}
|
||||
Event::Mouse(mouse::Event::ButtonReleased(mouse::Button::Left)) => {
|
||||
state.dragging = false;
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
|
||||
if let Some(fraction) = target {
|
||||
let next = quantize(fraction, self.steps);
|
||||
if (next - self.value()).abs() >= EPSILON {
|
||||
if let Some(on_change) = &self.on_change {
|
||||
self.fraction = next;
|
||||
shell.publish(on_change(next));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if state.tracker.event(event, cursor.is_over(bounds)) {
|
||||
shell.request_redraw();
|
||||
}
|
||||
}
|
||||
|
||||
fn draw(
|
||||
&self,
|
||||
tree: &Tree,
|
||||
renderer: &mut Renderer,
|
||||
_theme: &Theme,
|
||||
_style: &iced::advanced::renderer::Style,
|
||||
layout: Layout<'_>,
|
||||
_cursor: mouse::Cursor,
|
||||
_viewport: &Rectangle,
|
||||
) {
|
||||
let ui = self.ui;
|
||||
let geometry = SliderGeometry::of(ui);
|
||||
let bounds = layout.bounds();
|
||||
let state = self
|
||||
.forced
|
||||
.unwrap_or_else(|| tree.state.downcast_ref::<State>().tracker.state());
|
||||
let disabled = state.is_disabled();
|
||||
|
||||
let (active_color, inactive_color, handle_color, handle_width) = if disabled {
|
||||
(
|
||||
interaction::disabled_content_over_role(ui, Role::OnSurface, false),
|
||||
interaction::disabled_colors(ui, Role::Surface).0,
|
||||
interaction::disabled_content_over_role(ui, Role::OnSurface, false),
|
||||
geometry.handle,
|
||||
)
|
||||
} else {
|
||||
// 状态层只叠在 handle 上（D16）：α 全部来自 interaction（hover 8 / focus 10 / pressed 10）
|
||||
let handle_color =
|
||||
interaction::overlay_color(ui, state, Role::OnSurface, Role::Primary)
|
||||
.unwrap_or_else(|| ui.color(Role::Primary));
|
||||
let handle_width = match state {
|
||||
Interaction::Focused | Interaction::Pressed => HANDLE_WIDTH_ACTIVE,
|
||||
_ => geometry.handle,
|
||||
};
|
||||
(
|
||||
ui.color(Role::Primary),
|
||||
ui.color(Role::SecondaryContainer),
|
||||
handle_color,
|
||||
handle_width,
|
||||
)
|
||||
};
|
||||
|
||||
let centre_y = bounds.y + bounds.height / 2.0;
|
||||
let track_x = bounds.x;
|
||||
let track_w = bounds.width;
|
||||
let track = TrackGeometry::of(bounds, self.value());
|
||||
let centre_x = track.handle_centre();
|
||||
let track_rect = |x: f32, width: f32| Rectangle {
|
||||
x,
|
||||
y: centre_y - geometry.track / 2.0,
|
||||
width: width.max(0.0),
|
||||
height: geometry.track,
|
||||
};
|
||||
|
||||
// 离散停靠点：A1 的 `StopIndicatorColor = SecondaryContainer` 与未激活轨**同色**，
|
||||
// 所以停靠点只有在「未激活轨在它两侧留出空隙」时才读得出来（官方也是这么画的：
|
||||
// `StopIndicatorSize = 4` + `StopIndicatorTrailingSpace = 6`）。空隙两侧各留半个点 + 6。
|
||||
// **不含两端**：0% 与 100% 上不画停靠点（那是轨道自己的圆角端，官方也不画）
|
||||
let stops: Vec<f32> = match self.steps {
|
||||
Some(steps) if steps >= 2 => (1..steps)
|
||||
.map(|index| TrackGeometry::of(bounds, index as f32 / steps as f32).handle_centre())
|
||||
.collect(),
|
||||
_ => Vec::new(),
|
||||
};
|
||||
let gap = STOP_SIZE / 2.0 + STOP_GAP;
|
||||
|
||||
// 未激活轨：从**竖条中心**到右端，按停靠点切成段（每段自己圆角，端点读数更清楚）
|
||||
let mut cursor = centre_x;
|
||||
let mut segments: Vec<(f32, f32)> = Vec::new();
|
||||
for anchor in stops.iter().copied() {
|
||||
if anchor <= cursor {
|
||||
continue;
|
||||
}
|
||||
segments.push((cursor, anchor - gap - cursor));
|
||||
cursor = anchor + gap;
|
||||
}
|
||||
if track_x + track_w > cursor {
|
||||
segments.push((cursor, track_x + track_w - cursor));
|
||||
}
|
||||
for (x, width) in segments {
|
||||
if width <= 0.0 {
|
||||
continue;
|
||||
}
|
||||
let (inactive, inactive_bg) =
|
||||
quad(track_rect(x, width), geometry.track / 2.0, inactive_color);
|
||||
renderer.fill_quad(inactive, inactive_bg);
|
||||
}
|
||||
|
||||
// 激活轨：从容器左缘到**竖条中心**（与官方一致：激活段托在竖条下面）
|
||||
let active_w = track.active_width;
|
||||
if active_w > 0.0 {
|
||||
let (active, active_bg) = quad(
|
||||
track_rect(track_x, active_w),
|
||||
geometry.track / 2.0,
|
||||
active_color,
|
||||
);
|
||||
renderer.fill_quad(active, active_bg);
|
||||
}
|
||||
|
||||
// 停靠点本体：4dp 圆点，只画在**未激活侧**（激活段已经走过的不重复画）
|
||||
if !disabled {
|
||||
for anchor in stops
|
||||
.iter()
|
||||
.copied()
|
||||
.filter(|anchor| *anchor > centre_x + EPSILON)
|
||||
{
|
||||
let (stop, stop_bg) = quad(
|
||||
Rectangle {
|
||||
x: anchor - STOP_SIZE / 2.0,
|
||||
y: centre_y - STOP_SIZE / 2.0,
|
||||
width: STOP_SIZE,
|
||||
height: STOP_SIZE,
|
||||
},
|
||||
STOP_SIZE / 2.0,
|
||||
inactive_color,
|
||||
);
|
||||
renderer.fill_quad(stop, stop_bg);
|
||||
}
|
||||
}
|
||||
|
||||
// 竖条：4×44（focus / pressed 收窄到 2），圆角 full
|
||||
let (bar, bar_bg) = quad(
|
||||
Rectangle {
|
||||
x: track.handle_centre() - handle_width / 2.0,
|
||||
y: centre_y - HANDLE_HEIGHT / 2.0,
|
||||
width: handle_width,
|
||||
height: HANDLE_HEIGHT,
|
||||
},
|
||||
handle_width / 2.0,
|
||||
handle_color,
|
||||
);
|
||||
renderer.fill_quad(bar, bar_bg);
|
||||
}
|
||||
|
||||
fn mouse_interaction(
|
||||
&self,
|
||||
tree: &Tree,
|
||||
layout: Layout<'_>,
|
||||
cursor: mouse::Cursor,
|
||||
_viewport: &Rectangle,
|
||||
_renderer: &Renderer,
|
||||
) -> mouse::Interaction {
|
||||
if !self.enabled() {
|
||||
return mouse::Interaction::None;
|
||||
}
|
||||
if tree.state.downcast_ref::<State>().dragging {
|
||||
return mouse::Interaction::Grabbing;
|
||||
}
|
||||
if cursor.is_over(layout.bounds()) {
|
||||
mouse::Interaction::Grab
|
||||
} else {
|
||||
mouse::Interaction::None
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl<'a, M, Theme, Renderer> From<Slider<'a, M>> for Element<'a, M, Theme, Renderer>
|
||||
where
|
||||
M: Clone + 'a,
|
||||
Theme: 'a,
|
||||
Renderer: iced::advanced::Renderer + 'a,
|
||||
{
|
||||
fn from(slider: Slider<'a, M>) -> Self {
|
||||
Element::new(slider)
|
||||
}
|
||||
}
|
||||
|
||||
/// 便捷入口：把 [`Slider`] 直接变成 `Element`（与其它组件的函数式签名一致）。
|
||||
pub fn slider<'a, M: Clone + 'a>(spec: Slider<'a, M>) -> Element<'a, M> {
|
||||
Element::new(spec)
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
@@ -0,0 +1,122 @@
|
||||
//! slider 的单测（从 `slider.rs` 拆出：单文件 ≤400 行，AGENTS.md §3-1）。
|
||||
|
||||
use super::*;
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui() -> Ui {
|
||||
Ui::with_platform(SchemeFlavor::Light, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
fn track() -> Rectangle {
|
||||
Rectangle {
|
||||
x: 100.0,
|
||||
y: 200.0,
|
||||
width: 300.0,
|
||||
height: 48.0,
|
||||
}
|
||||
}
|
||||
|
||||
/// 11.1 / 11.2 / 11.4：轨道 16、竖条 4×44、上下各溢出 14。
|
||||
#[test]
|
||||
fn track_and_handle_are_the_m3_expressive_shapes() {
|
||||
let g = SliderGeometry::of(&ui());
|
||||
assert_eq!(g.track, 16.0);
|
||||
assert_eq!((g.handle, g.handle_tall), (4.0, 44.0));
|
||||
assert_eq!((g.handle_tall - g.track) / 2.0, 14.0);
|
||||
assert_eq!(g.stop, 4.0);
|
||||
assert_eq!(g.height, 48.0, "命中区 = LM.touch_target");
|
||||
}
|
||||
|
||||
/// 0% / 50% / 100% 三档的位置：竖条**永不越界**，激活段与轨道分界一致。
|
||||
#[test]
|
||||
fn thumb_stays_inside_the_track_at_both_ends() {
|
||||
let bounds = track();
|
||||
let zero = TrackGeometry::of(bounds, 0.0);
|
||||
assert_eq!(zero.handle_left, bounds.x, "0% 时竖条左缘 = 轨道左缘");
|
||||
assert!(zero.handle_left >= bounds.x);
|
||||
assert_eq!(zero.active_width, 2.0, "0% 时激活段只剩竖条半宽");
|
||||
|
||||
let half = TrackGeometry::of(bounds, 0.5);
|
||||
assert!((half.handle_left - (bounds.x + bounds.width / 2.0 - 2.0)).abs() < 0.01);
|
||||
|
||||
let full = TrackGeometry::of(bounds, 1.0);
|
||||
assert_eq!(
|
||||
full.handle_right,
|
||||
bounds.x + bounds.width,
|
||||
"100% 时右缘贴轨道右缘"
|
||||
);
|
||||
assert!(full.handle_right <= bounds.x + bounds.width);
|
||||
// 激活段画到**竖条中心**为止（= 右缘 − 2），不是画到右缘：100% 时也被竖条自己盖住
|
||||
assert_eq!(full.active_width, bounds.width - 2.0);
|
||||
}
|
||||
|
||||
/// 越界的比例（<0 或 >1）被 clamp，不会把竖条推到轨道外。
|
||||
#[test]
|
||||
fn out_of_range_fractions_are_clamped() {
|
||||
let bounds = track();
|
||||
for fraction in [-3.0, -0.01, 0.0, 1.0, 1.5, 9.0] {
|
||||
let geometry = TrackGeometry::of(bounds, fraction);
|
||||
assert!(
|
||||
geometry.handle_left >= bounds.x,
|
||||
"{fraction} 的竖条左缘越界：{}",
|
||||
geometry.handle_left
|
||||
);
|
||||
assert!(
|
||||
geometry.handle_right <= bounds.x + bounds.width,
|
||||
"{fraction} 的竖条右缘越界：{}",
|
||||
geometry.handle_right
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// 离散值：4 段 → 1/4 步进；连续值原样。
|
||||
#[test]
|
||||
fn discrete_sliders_quantize_to_the_stops() {
|
||||
assert_eq!(quantize(0.3, Some(4)), 0.25);
|
||||
assert_eq!(quantize(0.4, Some(4)), 0.5);
|
||||
assert_eq!(quantize(1.4, Some(4)), 1.0);
|
||||
assert_eq!(quantize(0.3, None), 0.3);
|
||||
// 停靠点位置 = 五等分，且都落在轨道内
|
||||
let bounds = track();
|
||||
for index in 0..=4 {
|
||||
let geometry = TrackGeometry::of(bounds, index as f32 / 4.0);
|
||||
assert!(geometry.handle_left >= bounds.x);
|
||||
assert!(geometry.handle_right <= bounds.x + bounds.width);
|
||||
}
|
||||
}
|
||||
|
||||
/// 拖动换算：指针在轨道左缘 → 0、右缘 → 1，中间线性。
|
||||
#[test]
|
||||
fn fraction_at_is_the_inverse_of_handle_center() {
|
||||
let bounds = track();
|
||||
for fraction in [0.0, 0.25, 0.5, 0.75, 1.0] {
|
||||
let centre = TrackGeometry::of(bounds, fraction).handle_centre();
|
||||
let back = fraction_at(bounds, centre, 4.0);
|
||||
assert!((back - fraction).abs() < 1e-4, "{fraction} → {back}");
|
||||
}
|
||||
assert_eq!(fraction_at(bounds, bounds.x, 4.0), 0.0);
|
||||
assert_eq!(fraction_at(bounds, bounds.x + bounds.width, 4.0), 1.0);
|
||||
}
|
||||
|
||||
/// 没有回调 = 禁用：不吃拖动，也不响应状态机。
|
||||
#[test]
|
||||
fn slider_without_a_callback_is_disabled() {
|
||||
let ui = ui();
|
||||
let slider: Slider<'_, u8> = Slider::new(&ui, 0.5);
|
||||
assert!(!slider.enabled());
|
||||
let enabled: Slider<'_, u8> = Slider::new(&ui, 0.5).on_change(|_| 0_u8);
|
||||
assert!(enabled.enabled());
|
||||
let forced: Slider<'_, u8> = Slider::new(&ui, 0.5)
|
||||
.on_change(|_| 0_u8)
|
||||
.state(Interaction::Disabled);
|
||||
assert!(!forced.enabled(), "强制禁用时不吃事件");
|
||||
}
|
||||
@@ -0,0 +1,66 @@
|
||||
//! Slider 的**纯几何**（无 iced 画布依赖）：比例 ⇄ 像素，`draw` 与单测共用同一条公式。
|
||||
//!
|
||||
//! 单独成文件的原因：`slider.rs` 已到 400 行红线，而这几条公式是「0% / 100% 竖条不越界」的
|
||||
//! 唯一实现点——独立出来才好被人一眼审完。`draw` 与 `#[cfg(test)] mod tests` 都调这里。
|
||||
|
||||
use iced::Rectangle;
|
||||
|
||||
use super::super::geometry::HANDLE_WIDTH;
|
||||
|
||||
/// 比例比较的容差（浮点拖动会产生 1e-7 级抖动，别让它每帧发一条消息）。
|
||||
pub(super) const EPSILON: f32 = 1e-4;
|
||||
|
||||
/// 量化到停靠点（连续值时原样返回）。
|
||||
pub(super) fn quantize(fraction: f32, steps: Option<u32>) -> f32 {
|
||||
match steps {
|
||||
Some(steps) => {
|
||||
let steps = steps as f32;
|
||||
(fraction.clamp(0.0, 1.0) * steps).round() / steps
|
||||
}
|
||||
None => fraction.clamp(0.0, 1.0),
|
||||
}
|
||||
}
|
||||
|
||||
/// 一条竖条的横坐标（**位移区间是 `handle/2 .. width - handle/2`**，所以 0%/100% 都不越界）。
|
||||
fn handle_center(bounds: Rectangle, fraction: f32, handle: f32) -> f32 {
|
||||
let travel = (bounds.width - handle).max(0.0);
|
||||
bounds.x + handle / 2.0 + travel * fraction.clamp(0.0, 1.0)
|
||||
}
|
||||
|
||||
/// 指针横坐标 → 比例（`handle_center` 的逆函数，同样不越界）。
|
||||
pub(super) fn fraction_at(bounds: Rectangle, x: f32, handle: f32) -> f32 {
|
||||
let travel = (bounds.width - handle).max(1.0);
|
||||
((x - bounds.x - handle / 2.0) / travel).clamp(0.0, 1.0)
|
||||
}
|
||||
|
||||
/// 轨道 / 停靠点 / 竖条的纯几何（像素级断言用；`Widget::draw` 与测试共用同一条公式）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq)]
|
||||
pub struct TrackGeometry {
|
||||
/// 激活段的左缘。
|
||||
pub active_left: f32,
|
||||
/// 激活段的宽。
|
||||
pub active_width: f32,
|
||||
/// 竖条左缘（`f = 0` 时应 = 轨道左缘）。
|
||||
pub handle_left: f32,
|
||||
/// 竖条右缘（`f = 1` 时应 = 轨道右缘）。
|
||||
pub handle_right: f32,
|
||||
}
|
||||
|
||||
impl TrackGeometry {
|
||||
/// 按轨道矩形与比例求值（`f` 会被 clamp 到 0..=1）。
|
||||
pub fn of(track: Rectangle, fraction: f32) -> Self {
|
||||
let centre = handle_center(track, fraction, HANDLE_WIDTH);
|
||||
let handle_left = centre - HANDLE_WIDTH / 2.0;
|
||||
Self {
|
||||
active_left: track.x,
|
||||
active_width: centre - track.x,
|
||||
handle_left,
|
||||
handle_right: handle_left + HANDLE_WIDTH,
|
||||
}
|
||||
}
|
||||
|
||||
/// 竖条中心（= 激活段与未激活段的分界）。
|
||||
pub fn handle_centre(&self) -> f32 {
|
||||
self.handle_left + HANDLE_WIDTH / 2.0
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,305 @@
|
||||
//! 禁用态的颜色口径：**两个族、两套 α**（M86 收口）。
|
||||
//!
|
||||
//! ## 为什么不是「一个 12%」
|
||||
//!
|
||||
//! 官方禁用 α 分两类（A 级：`material3-android-1.4.0.aar` 的字节码 `<clinit>`）：
|
||||
//!
|
||||
//! | 族 | α | 官方 token | 消费者 |
|
||||
//! |---|---|---|---|
|
||||
//! | **按钮容器** | **0.10** | `*ButtonTokens.DisabledContainerOpacity`（`Filled` / `Outlined` / `Text` / `Elevated` / `Tonal` / `Baseline`） | `buttons::assemble` |
|
||||
//! | **面状控件**容器与描边 | **0.12** | `AssistChipTokens.FlatDisabledOutlineOpacity`、`FilterChipTokens.FlatDisabled(SelectedContainer/UnselectedOutline)Opacity`、`SliderTokens.DisabledInactiveTrackOpacity`、`SwitchTokens.DisabledTrackOpacity` | chip / switch / slider / TextField 描边 |
|
||||
//! | 内容（两族共用） | 0.38 | `Disabled{Icon,LabelText,Input}Opacity` | 全部 |
|
||||
//!
|
||||
//! 历史上这里只有一个 12% 常量供两族共用：**按钮那半边一直错、chip/slider/switch 那半边一直对**。
|
||||
//! 现在按族分开两个入口——取错入口的后果是「差 1/255」，肉眼看不见，只有像素 probe 会红，
|
||||
//! 所以入口**必须按名字就能选对**。
|
||||
//!
|
||||
//! ⚠️ TextField 的 **Filled 容器**不在这两族里：官方
|
||||
//! `FilledTextFieldTokens.FieldDisabledContainerOpacity = 0.04f`，我们仍在用面状族的值
|
||||
//! （既有 D10 偏离，未在本轮收口）。`inputs::field` 走 [`disabled_colors`] 的口径，行为未变。
|
||||
//!
|
||||
//! ⚠️ **filled-tonal 是另一条已知偏离**：官方
|
||||
//! `FilledTonalButtonTokens.DisabledContainerOpacity = 0.12f`（`javap -p -constants` 可见它是个
|
||||
//! **编译期常量**，被内联进 `getDefaultFilledTonalButtonColors` 的 `ldc_w 0.12f`，所以调用点是常量、
|
||||
//! `getDisabledContainerOpacity()` 不会被调用）；而本模块的 `disabled_button_*` **不区分变体**，
|
||||
//! tonal 与 filled 共用 0.10 ⇒ tonal 实际画 10%。这不是对齐、是登记过的偏离；要修得让入口知道变体，
|
||||
//! 本轮（M86）不做。
|
||||
|
||||
use iced::Color;
|
||||
|
||||
use unlucky_design::color::state::{
|
||||
DISABLED_CONTAINER_ALPHA, DISABLED_CONTENT_ALPHA, DISABLED_SURFACE_ALPHA,
|
||||
};
|
||||
use unlucky_design::color::{Role, Scheme};
|
||||
|
||||
use crate::theme::{to_iced, Ui};
|
||||
|
||||
/// 禁用态内容色（**按角色、按有没有容器**求值）——A1 口径的入口（**面状控件族**的底）。
|
||||
///
|
||||
/// - `role`：由变体决定（Filled/Outlined/Text/Elevated = `OnSurfaceVariant`；
|
||||
/// FilledTonal 与三式 IconButton = `OnSurface`，见 `Variant::disabled_content`）；
|
||||
/// - `on_container = true`：叠在**面状控件族的 12% 容器**（[`DISABLED_SURFACE_ALPHA`]）上
|
||||
/// （Filled TextField / 有容器控件在 12% 底上求内容时）；
|
||||
/// `false`：直接叠在 **surface** 上（Text / Outlined / standard IconButton / 描边类控件的内容）。
|
||||
///
|
||||
/// **按钮家族不要用这个函数**（按钮容器是 10%）：走 [`disabled_button_content`]。
|
||||
///
|
||||
/// 之前这里写死 `OnSurfaceVariant` 且只有一个「底」，导致 FilledTonal 与 IconButton 两族偏浅
|
||||
/// 15/255（视觉 r3 用像素量的）。
|
||||
pub fn disabled_content_over_role(ui: &Ui, role: Role, on_container: bool) -> Color {
|
||||
let scheme = Scheme::baseline(ui.flavor());
|
||||
disabled_content_with_alpha(&scheme, role, on_container, DISABLED_SURFACE_ALPHA)
|
||||
}
|
||||
|
||||
/// 禁用态内容色——**按钮家族**（`on_container`：是否叠在本族 10% 容器上）。
|
||||
///
|
||||
/// 与 [`disabled_content_over_role`] 的差别只有「底」的 α：按钮 10%、面状控件 12%。
|
||||
/// 两个入口分开是 M86 的结论：合成一个数会让一族永远差 1/255，肉眼看不见、只有 probe 会红。
|
||||
pub fn disabled_button_content(ui: &Ui, role: Role, on_container: bool) -> Color {
|
||||
let scheme = Scheme::baseline(ui.flavor());
|
||||
disabled_content_with_alpha(&scheme, role, on_container, DISABLED_CONTAINER_ALPHA)
|
||||
}
|
||||
|
||||
/// 两个族共用的内容色求值（「底」的 α 由调用方给）。
|
||||
fn disabled_content_with_alpha(
|
||||
scheme: &Scheme,
|
||||
role: Role,
|
||||
on_container: bool,
|
||||
container_alpha: f32,
|
||||
) -> Color {
|
||||
let base = if on_container {
|
||||
scheme
|
||||
.get(Role::OnSurface)
|
||||
.with_alpha(container_alpha)
|
||||
.over(scheme.get(Role::Surface))
|
||||
} else {
|
||||
scheme.get(Role::Surface)
|
||||
};
|
||||
|
||||
to_iced(
|
||||
scheme
|
||||
.get(role)
|
||||
.with_alpha(DISABLED_CONTENT_ALPHA)
|
||||
.over(base),
|
||||
)
|
||||
}
|
||||
|
||||
/// 禁用态的一对颜色 `(容器, 内容)`——**面状控件族**（12% 容器/描边）。
|
||||
///
|
||||
/// ⚠️ 这个名字是历史遗留（当年只有它一个），**语义是「面状控件族」**：
|
||||
/// - chip 容器与描边（`AssistChipTokens.FlatDisabledOutlineOpacity = 0.12f` 等）
|
||||
/// - switch 轨道（`SwitchTokens.DisabledTrackOpacity = 0.12f`）
|
||||
/// - slider 未激活轨（`SliderTokens.DisabledInactiveTrackOpacity = 0.12f`）
|
||||
/// - TextField 禁用描边（Filled 容器的 4% 是另一条 D10 偏离，不在这里收口）
|
||||
///
|
||||
/// **按钮家族用 [`disabled_button_colors`]**（0.10，`*ButtonTokens.DisabledContainerOpacity = 0.1f`）。
|
||||
///
|
||||
/// `ui` 不暴露 [`Scheme`]，这里按同一个 flavor 求一次基线方案——调的是
|
||||
/// `unlucky_design` 的**同一个**函数与同一套角色，不是第二份令牌。
|
||||
///
|
||||
/// 顺序必须「先容器后内容」：Compose 也是这么画的，先叠容器再叠 label，
|
||||
/// 所以内容叠的角色是容器实色而不是底下的 surface。
|
||||
pub fn disabled_colors(ui: &Ui, surface: Role) -> (Color, Color) {
|
||||
disabled_colors_with_alpha(ui, surface, DISABLED_SURFACE_ALPHA)
|
||||
}
|
||||
|
||||
/// 禁用态的一对颜色 `(容器, 内容)`——**按钮家族**（10% 容器）。
|
||||
///
|
||||
/// - 容器 = `OnSurface` @ 10%（[`DISABLED_CONTAINER_ALPHA`]）叠在 `surface` 上；
|
||||
/// - 内容 = **默认** `OnSurfaceVariant` @ 38%；按变体的取值走 [`disabled_button_content`]。
|
||||
///
|
||||
/// 除了按钮家族，**没有别的消费者**：面状控件（chip / slider 轨道 / switch 轨道 / 描边）走
|
||||
/// [`disabled_colors`] 的 12%。
|
||||
pub fn disabled_button_colors(ui: &Ui, surface: Role) -> (Color, Color) {
|
||||
disabled_colors_with_alpha(ui, surface, DISABLED_CONTAINER_ALPHA)
|
||||
}
|
||||
|
||||
/// 两个族共用的求值：容器 = `OnSurface` @ `container_alpha` 叠在 `surface` 上，内容 = 38% 叠在容器上。
|
||||
fn disabled_colors_with_alpha(ui: &Ui, surface: Role, container_alpha: f32) -> (Color, Color) {
|
||||
let scheme = Scheme::baseline(ui.flavor());
|
||||
let base = scheme.get(surface);
|
||||
let container = scheme
|
||||
.get(Role::OnSurface)
|
||||
.with_alpha(container_alpha)
|
||||
.over(base);
|
||||
// 这里是**默认口径**（OnSurfaceVariant）；按变体取值请走 [`disabled_content_over_role`]
|
||||
// ——FilledTonal 与三式 IconButton 的禁用内容是 `OnSurface`（A1）。
|
||||
let content = scheme
|
||||
.get(Role::OnSurfaceVariant)
|
||||
.with_alpha(DISABLED_CONTENT_ALPHA)
|
||||
.over(container);
|
||||
|
||||
(to_iced(container), to_iced(content))
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
/// 两族的 α 必须都钉住（只钉一条，另一族被合并时会静默错 1/255）。
|
||||
#[test]
|
||||
fn both_disabled_alpha_classes_are_pinned_to_the_tokens() {
|
||||
// 绑定成局部变量再过断言：直接比两个常量会被 clippy 判成「常量断言」。
|
||||
let button_alpha = DISABLED_CONTAINER_ALPHA;
|
||||
let surface_alpha = DISABLED_SURFACE_ALPHA;
|
||||
let content_alpha = DISABLED_CONTENT_ALPHA;
|
||||
// 按钮容器：官方 *ButtonTokens.DisabledContainerOpacity = 0.1f
|
||||
assert!(
|
||||
(button_alpha - 0.10).abs() < f32::EPSILON,
|
||||
"按钮禁用容器 α 必须是 0.10（官方 DisabledContainerOpacity）；\
|
||||
0.12 是面状控件那一类，别混用"
|
||||
);
|
||||
// 面状控件：chip 描边 / slider 未激活轨 / switch 轨道 = 0.12f
|
||||
assert!(
|
||||
(surface_alpha - 0.12).abs() < f32::EPSILON,
|
||||
"面状控件禁用 α 必须是 0.12（官方 FlatDisabledOutlineOpacity / \
|
||||
DisabledInactiveTrackOpacity / DisabledTrackOpacity）"
|
||||
);
|
||||
assert!((content_alpha - 0.38).abs() < f32::EPSILON);
|
||||
assert!(
|
||||
surface_alpha > button_alpha,
|
||||
"两族必须可区分：面状控件比按钮容器更实（{surface_alpha} > {button_alpha}）"
|
||||
);
|
||||
}
|
||||
|
||||
/// **面状控件族**的那一对颜色 = 0.12 预混合（chip / switch / slider / TextField 描边）。
|
||||
///
|
||||
/// ⚠️ 期望值**写死 0.12 / 0.38**，不从 `DISABLED_SURFACE_ALPHA` 取：
|
||||
/// 从被测常量求期望是**自指断言**——常量一改，expected 跟着改，永远相等（复审 r1 P2-1 实测：
|
||||
/// 把 `DISABLED_SURFACE_ALPHA` 改成 0.10，旧版这条照样绿）。现在常量改坏必红。
|
||||
#[test]
|
||||
fn surface_family_disabled_colors_are_the_12_percent_class() {
|
||||
const EXPECTED_SURFACE_ALPHA: f32 = 0.12;
|
||||
const EXPECTED_CONTENT_ALPHA: f32 = 0.38;
|
||||
let actual_alpha = DISABLED_SURFACE_ALPHA;
|
||||
assert_eq!(
|
||||
actual_alpha, EXPECTED_SURFACE_ALPHA,
|
||||
"面状控件族 α 必须是官方 0.12f；改常量会让下面每一条合成色断言同时红"
|
||||
);
|
||||
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let ui = ui(flavor);
|
||||
let scheme = Scheme::baseline(flavor);
|
||||
let base = scheme.get(Role::Surface);
|
||||
let expected_container = scheme
|
||||
.get(Role::OnSurface)
|
||||
.with_alpha(EXPECTED_SURFACE_ALPHA)
|
||||
.over(base);
|
||||
|
||||
let (surface, surface_content) = disabled_colors(&ui, Role::Surface);
|
||||
assert_eq!(
|
||||
surface,
|
||||
to_iced(expected_container),
|
||||
"{flavor:?}：面状控件容器 = on-surface@12% 叠表面（期望值硬编码，不取自常量）"
|
||||
);
|
||||
assert_eq!(
|
||||
surface_content,
|
||||
to_iced(
|
||||
scheme
|
||||
.get(Role::OnSurfaceVariant)
|
||||
.with_alpha(EXPECTED_CONTENT_ALPHA)
|
||||
.over(expected_container)
|
||||
),
|
||||
"{flavor:?}：面状控件内容仍是 38%，只是叠的底不同"
|
||||
);
|
||||
assert_ne!(surface, ui.color(Role::Surface), "12% 叠上去必须能看出来");
|
||||
assert_eq!(surface.a, 1.0, "禁用容器也是实色（CPU/GPU 一致）");
|
||||
assert_eq!(surface_content.a, 1.0, "禁用内容也是实色");
|
||||
// 内容叠在容器上 vs 叠在表面上，是两回事（probe 量的是前者）
|
||||
assert_ne!(
|
||||
surface_content,
|
||||
to_iced(
|
||||
scheme
|
||||
.get(Role::OnSurfaceVariant)
|
||||
.with_alpha(EXPECTED_CONTENT_ALPHA)
|
||||
.over(base)
|
||||
),
|
||||
"{flavor:?}：内容必须叠在容器上"
|
||||
);
|
||||
// 跨族对照：面状族的合成色必须与按钮族不同（两族一旦合流，这条红）
|
||||
let (button, _) = disabled_button_colors(&ui, Role::Surface);
|
||||
assert_ne!(
|
||||
surface, button,
|
||||
"{flavor:?}：面状族 12% 与按钮族 10% 必须落在不同像素值上"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/// **按钮家族**的那一对颜色 = 0.10 预混合，且与面状控件族**必须落在不同像素值上**。
|
||||
///
|
||||
/// 期望值同样写死（0.10 / 0.38），理由见上一条：自指断言抓不住常量被改坏。
|
||||
#[test]
|
||||
fn button_family_disabled_colors_are_the_10_percent_class() {
|
||||
const EXPECTED_BUTTON_ALPHA: f32 = 0.10;
|
||||
const EXPECTED_CONTENT_ALPHA: f32 = 0.38;
|
||||
let actual_alpha = DISABLED_CONTAINER_ALPHA;
|
||||
assert_eq!(
|
||||
actual_alpha, EXPECTED_BUTTON_ALPHA,
|
||||
"按钮族 α 必须是官方 0.1f（*ButtonTokens.DisabledContainerOpacity）"
|
||||
);
|
||||
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let ui = ui(flavor);
|
||||
let scheme = Scheme::baseline(flavor);
|
||||
let base = scheme.get(Role::Surface);
|
||||
let expected_container = scheme
|
||||
.get(Role::OnSurface)
|
||||
.with_alpha(EXPECTED_BUTTON_ALPHA)
|
||||
.over(base);
|
||||
|
||||
let (button, button_content) = disabled_button_colors(&ui, Role::Surface);
|
||||
assert_eq!(
|
||||
button,
|
||||
to_iced(expected_container),
|
||||
"{flavor:?}：按钮容器 = on-surface@10% 叠表面（官方 DisabledContainerOpacity = 0.1f）"
|
||||
);
|
||||
assert_eq!(
|
||||
button_content,
|
||||
to_iced(
|
||||
scheme
|
||||
.get(Role::OnSurfaceVariant)
|
||||
.with_alpha(EXPECTED_CONTENT_ALPHA)
|
||||
.over(expected_container)
|
||||
),
|
||||
);
|
||||
|
||||
let (surface, _) = disabled_colors(&ui, Role::Surface);
|
||||
assert_ne!(
|
||||
button, surface,
|
||||
"{flavor:?}：10% 与 12% 必须落在不同像素值上（合成一个数就是这次要防的回归）"
|
||||
);
|
||||
|
||||
// 内容色同理：按钮 38% 叠 10% 底 ≠ 面状 38% 叠 12% 底
|
||||
assert_ne!(
|
||||
button_content,
|
||||
disabled_content_over_role(&ui, Role::OnSurfaceVariant, true),
|
||||
"{flavor:?}：两族的「有容器」内容色不能同源"
|
||||
);
|
||||
assert_eq!(
|
||||
disabled_button_content(&ui, Role::OnSurfaceVariant, true),
|
||||
button_content,
|
||||
"{flavor:?}：按钮内容入口必须与按钮颜色入口同源"
|
||||
);
|
||||
// 无容器时两族完全一致（都叠 surface）——差异只在「有容器」那一支
|
||||
assert_eq!(
|
||||
disabled_button_content(&ui, Role::OnSurfaceVariant, false),
|
||||
disabled_content_over_role(&ui, Role::OnSurfaceVariant, false),
|
||||
"{flavor:?}：没有容器时不该有族差异"
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,239 @@
|
||||
//! 交互状态层：hover / focus / pressed / disabled 的**唯一实现点**（D39 §3）。
|
||||
//!
|
||||
//! ## 为什么必须只有一处
|
||||
//!
|
||||
//! M3 的状态层不是「另一种灰」，而是**内容色自身 + 固定 alpha** 叠在容器色上
|
||||
//! （`unlucky_design::color::state` 的文档）。五个家族各写一遍
|
||||
//! `if hovered { 0.08 }`，第一周就会出现 0.08 / 0.1 / 0.12 三种 hover——
|
||||
//! 这一层存在的意义就是让「组件里出现 α 字面量」变成不可能：
|
||||
//!
|
||||
//! | 态 | α | 令牌来源 |
|
||||
//! |---|---|---|
|
||||
//! | hover | 0.08 | [`StateLayer::Hover`] |
|
||||
//! | focus | 0.10 | [`StateLayer::Focus`] |
|
||||
//! | pressed | 0.10 | [`StateLayer::Pressed`] |
|
||||
//! | dragged | 0.16 | [`StateLayer::Dragged`]（按钮家族不用，列表拖拽用） |
|
||||
//! | disabled 容器（**按钮家族**） | 0.10 | [`DISABLED_CONTAINER_ALPHA`]（按钮 `*ButtonTokens.DisabledContainerOpacity`） |
|
||||
//! | disabled 容器/描边（**面状控件族**） | 0.12 | [`DISABLED_SURFACE_ALPHA`]（chip / slider 轨道 / switch 轨道 / TextField 禁用描边） |
|
||||
//! | disabled 内容 | 0.38 | [`DISABLED_CONTENT_ALPHA`] |
|
||||
//!
|
||||
//! ## ⚠️ 禁用 α 有**两类**（M86 收口，别再合成一个数）
|
||||
//!
|
||||
//! 官方禁用 α 从来不是「一个 12%」：
|
||||
//!
|
||||
//! - **按钮容器 0.10**：`BaselineButtonTokens` / `FilledButtonTokens` / `OutlinedButtonTokens` /
|
||||
//! `TextButtonTokens` / `ElevatedButtonTokens` / `TonalButtonTokens` 的 `DisabledContainerOpacity`
|
||||
//! = `0.1f`（AAR 字节码 `<clinit>` 里的 `ldc 0.1f`）；
|
||||
//! - **面状控件 0.12**：`AssistChipTokens.FlatDisabledOutlineOpacity` / `FilterChipTokens.
|
||||
//! FlatDisabledSelectedContainerOpacity` / `SliderTokens.DisabledInactiveTrackOpacity` /
|
||||
//! `SwitchTokens.DisabledTrackOpacity` 都是 `0.12f`。
|
||||
//!
|
||||
//! 本模块过去只有一个 12% 常量供两条线共用：**按钮那半边一直错、chip/slider/switch 那半边一直对**。
|
||||
//! 现在按族分两个入口，谁也别再拿一个数服务两族：
|
||||
//!
|
||||
//! | 入口 | α | 谁用 |
|
||||
//! |---|---|---|
|
||||
//! | [`disabled_button_colors`] / [`disabled_button_content`] | 0.10 | **只有按钮家族**（`buttons::assemble`） |
|
||||
//! | [`disabled_colors`] / [`disabled_content_over_role`] | 0.12 | **面状控件族**：chip 容器与描边、switch 轨道、slider 未激活轨、TextField 禁用描边（`disabled_colors` 这个名字是历史遗留，**语义是面状控件族**） |
|
||||
//!
|
||||
//! 上表右列是**唯一**允许的取值口；左列只是给人看的，代码里一个数字都不许出现
|
||||
//! （`components::gate` 会扫）。
|
||||
//!
|
||||
//! ## 两个消费形态
|
||||
//!
|
||||
//! 1. **iced `button` 系**（本 mission 的按钮家族）：拿 [`Interaction`] 直接配 [`overlay_color`]；
|
||||
//! 2. **自定义 `Widget`**（后续若需要自绘轨道/滑块）：用 [`Tracker`] 把事件折成五态，
|
||||
//! `update()` 的返回值告诉你「要不要重绘」，`state()` 给出当前态。
|
||||
//!
|
||||
//! ## 与 `Ui::state_over` 的关系
|
||||
//!
|
||||
//! 颜色一律经 [`crate::theme::Ui::state_over`] 求值（它返回**不透明**结果，所以 GPU/CPU 两档
|
||||
//! 逐像素一致，D27）。本模块只做「哪一态叠哪一层」的映射，不做任何颜色算术。
|
||||
|
||||
use iced::widget::button;
|
||||
use iced::Color;
|
||||
|
||||
use unlucky_design::color::{Role, StateLayer};
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
mod tracker;
|
||||
|
||||
// 本 mission 没有自绘控件，所以这条再导出在 crate 内暂时无人使用；
|
||||
// 它是给四条家族线（Slider / Switch 轨道要自绘）的公共入口，路径与拆分前一致。
|
||||
#[allow(unused_imports)]
|
||||
pub use tracker::Tracker;
|
||||
|
||||
// 本模块会被四条家族线各扩一次：加东西前先看行数余额（单文件 ≤400，AGENTS.md §3-1）。
|
||||
// `mod.rs` 只装「五态 + 颜色映射」这类纯函数；事件 → 态的**状态机在 [`tracker`]**，
|
||||
// 需要新的状态机就加到那边，别把本文件再撑到红线上。
|
||||
|
||||
/// 一个控件的视觉态（五态，M3 的完整集合）。
|
||||
///
|
||||
/// `Enabled` 是**静息态**（不叠状态层）；`Focused` / `Pressed` 在 M3 里 α 相同（都 10%），
|
||||
/// 所以两者在图上会一模一样——这是规范，不是漏画（12b §1.8 判据只要求 α 对得上）。
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
|
||||
pub enum Interaction {
|
||||
/// 静息：可交互，不叠状态层。
|
||||
Enabled,
|
||||
/// 悬停：叠 8%。
|
||||
Hovered,
|
||||
/// 键盘焦点：叠 10%。
|
||||
Focused,
|
||||
/// 按下：叠 10%。
|
||||
Pressed,
|
||||
/// 禁用：按钮容器 10% / 面状控件 12% / 内容 38%，**不叠状态层**。
|
||||
Disabled,
|
||||
}
|
||||
|
||||
impl Interaction {
|
||||
/// 五态全序（gallery 的状态矩阵按这个次序出图）。
|
||||
pub const ALL: [Interaction; 5] = [
|
||||
Interaction::Enabled,
|
||||
Interaction::Hovered,
|
||||
Interaction::Pressed,
|
||||
Interaction::Focused,
|
||||
Interaction::Disabled,
|
||||
];
|
||||
|
||||
/// 稳定名字（截图文件名 / 图例 / 测试失败信息用）。
|
||||
pub const fn name(self) -> &'static str {
|
||||
match self {
|
||||
Interaction::Enabled => "enabled",
|
||||
Interaction::Hovered => "hovered",
|
||||
Interaction::Focused => "focused",
|
||||
Interaction::Pressed => "pressed",
|
||||
Interaction::Disabled => "disabled",
|
||||
}
|
||||
}
|
||||
|
||||
/// 是否禁用（禁用不是「第六态」，它要不要画容器由组件决定）。
|
||||
pub const fn is_disabled(self) -> bool {
|
||||
matches!(self, Interaction::Disabled)
|
||||
}
|
||||
|
||||
/// 该态要叠的状态层；`None` = 不叠（静息与禁用）。
|
||||
pub const fn layer(self) -> Option<StateLayer> {
|
||||
match self {
|
||||
Interaction::Enabled | Interaction::Disabled => None,
|
||||
Interaction::Hovered => Some(StateLayer::Hover),
|
||||
Interaction::Focused => Some(StateLayer::Focus),
|
||||
Interaction::Pressed => Some(StateLayer::Pressed),
|
||||
}
|
||||
}
|
||||
|
||||
/// 从 iced 的 [`button::Status`] 推导（`button` 只有四态，没有 focus）。
|
||||
///
|
||||
/// 用 `button` 做组件的家族一律经这里，**不许自己 match status 再各写一遍颜色**。
|
||||
pub const fn from_status(status: button::Status) -> Self {
|
||||
match status {
|
||||
button::Status::Active => Interaction::Enabled,
|
||||
button::Status::Hovered => Interaction::Hovered,
|
||||
button::Status::Pressed => Interaction::Pressed,
|
||||
button::Status::Disabled => Interaction::Disabled,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 当前态叠在 `container` 上的**不透明**颜色；`None` = 该态不叠。
|
||||
///
|
||||
/// `content` 是容器上的前景角色（Filled 按钮用 `OnPrimary`；中性表面上的控件用 `OnSurfaceVariant`）。
|
||||
pub fn overlay_color(ui: &Ui, state: Interaction, content: Role, container: Role) -> Option<Color> {
|
||||
state
|
||||
.layer()
|
||||
.map(|layer| ui.state_over(layer, content, container))
|
||||
}
|
||||
|
||||
mod disabled;
|
||||
|
||||
pub use disabled::{
|
||||
disabled_button_colors, disabled_button_content, disabled_colors, disabled_content_over_role,
|
||||
};
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
const FAMILIES: Families = Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
};
|
||||
|
||||
fn ui(flavor: SchemeFlavor) -> Ui {
|
||||
Ui::with_platform(flavor, Platform::Windows, FAMILIES)
|
||||
}
|
||||
|
||||
/// 契约 §3 的状态层 α 全表：**钉住令牌值**（改令牌会让这条红，改组件抓不到）。
|
||||
///
|
||||
/// 禁用态的两族 α（按钮 0.10 / 面状控件 0.12）在 [`super::disabled`] 的测试里，
|
||||
/// 那边还负责「两族不能同源」的判据。
|
||||
#[test]
|
||||
fn state_layer_alphas_are_the_contract_values() {
|
||||
assert!((StateLayer::Hover.alpha() - 0.08).abs() < f32::EPSILON);
|
||||
assert!((StateLayer::Focus.alpha() - 0.10).abs() < f32::EPSILON);
|
||||
assert!((StateLayer::Pressed.alpha() - 0.10).abs() < f32::EPSILON);
|
||||
assert!((StateLayer::Dragged.alpha() - 0.16).abs() < f32::EPSILON);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn five_states_map_onto_four_layers() {
|
||||
assert_eq!(Interaction::ALL.len(), 5);
|
||||
assert_eq!(Interaction::Enabled.layer(), None);
|
||||
assert_eq!(Interaction::Disabled.layer(), None);
|
||||
assert_eq!(Interaction::Hovered.layer(), Some(StateLayer::Hover));
|
||||
assert_eq!(Interaction::Focused.layer(), Some(StateLayer::Focus));
|
||||
assert_eq!(Interaction::Pressed.layer(), Some(StateLayer::Pressed));
|
||||
// focus 与 pressed 同 α（M3 口径）——图上一样是**对的**
|
||||
assert_eq!(
|
||||
Interaction::Focused.layer().map(StateLayer::alpha),
|
||||
Interaction::Pressed.layer().map(StateLayer::alpha)
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn overlay_color_is_the_token_blend_not_local_math() {
|
||||
for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] {
|
||||
let ui = ui(flavor);
|
||||
for (state, layer) in [
|
||||
(Interaction::Hovered, StateLayer::Hover),
|
||||
(Interaction::Focused, StateLayer::Focus),
|
||||
(Interaction::Pressed, StateLayer::Pressed),
|
||||
] {
|
||||
assert_eq!(
|
||||
overlay_color(&ui, state, Role::OnPrimary, Role::Primary),
|
||||
Some(ui.state_over(layer, Role::OnPrimary, Role::Primary)),
|
||||
"{flavor:?}/{state:?} 必须逐位等于令牌求值结果"
|
||||
);
|
||||
assert!(
|
||||
overlay_color(&ui, state, Role::OnSurface, Role::Surface).is_some(),
|
||||
"可交互态必须给颜色"
|
||||
);
|
||||
}
|
||||
assert_eq!(
|
||||
overlay_color(&ui, Interaction::Enabled, Role::OnSurface, Role::Surface),
|
||||
None
|
||||
);
|
||||
assert_eq!(
|
||||
overlay_color(&ui, Interaction::Disabled, Role::OnSurface, Role::Surface),
|
||||
None,
|
||||
"禁用态不叠状态层（它换的是容器/内容色）"
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn hover_is_weaker_than_pressed_on_the_same_container() {
|
||||
let ui = ui(SchemeFlavor::Light);
|
||||
let hover = overlay_color(&ui, Interaction::Hovered, Role::OnSurface, Role::Surface)
|
||||
.expect("hover 有颜色");
|
||||
let pressed = overlay_color(&ui, Interaction::Pressed, Role::OnSurface, Role::Surface)
|
||||
.expect("pressed 有颜色");
|
||||
assert_ne!(hover, pressed, "8% 与 10% 必须能区分");
|
||||
assert_eq!(hover.a, 1.0, "结果必须不透明（GPU/CPU 逐像素一致）");
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,155 @@
|
||||
//! 自定义 `Widget` 的状态机（[`Tracker`]）：把 iced 事件折成 [`Interaction`] 五态。
|
||||
//!
|
||||
//! 与 [`super`] 的分工：`super` 只有「态 → 颜色」的纯映射；**事件 → 态**在这里。
|
||||
//! 本 mission 的按钮家族全走 iced 的 `button`（自带四态），所以 `Tracker` 目前只有单测在用——
|
||||
//! 它给四个后续家族里**要自绘**的控件（Slider 轨道 / Switch 轨道 / 进度条）准备。
|
||||
//!
|
||||
//! 加东西前先看行数余额（单文件 ≤400，AGENTS.md §3-1）。
|
||||
|
||||
use iced::Event;
|
||||
|
||||
use super::Interaction;
|
||||
|
||||
/// 自定义 `Widget` 的状态机：把 iced 事件折成 [`Interaction`]。
|
||||
///
|
||||
/// 这是 D39 §3 说的「状态机的公共部分」。用法（自定义 Widget 的 `update` 里）：
|
||||
///
|
||||
/// ```ignore
|
||||
/// if self.tracker.event(event, cursor.is_over(layout.bounds())) {
|
||||
/// shell.request_redraw(); // 只有真变了才重绘
|
||||
/// }
|
||||
/// let style = style_of(self.tracker.state());
|
||||
/// ```
|
||||
#[allow(dead_code)]
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
|
||||
pub struct Tracker {
|
||||
enabled: bool,
|
||||
hovered: bool,
|
||||
focused: bool,
|
||||
pressed: bool,
|
||||
}
|
||||
|
||||
#[allow(dead_code)]
|
||||
impl Tracker {
|
||||
/// 新建；`enabled` 由组件自己决定（例如 `on_press.is_some()`）。
|
||||
pub fn new(enabled: bool) -> Self {
|
||||
Self {
|
||||
enabled,
|
||||
..Self::default()
|
||||
}
|
||||
}
|
||||
|
||||
/// 启用/禁用热切换（禁用时清掉悬停与按下：禁用元素不该留着 hover 高亮）。
|
||||
pub fn set_enabled(&mut self, enabled: bool) -> bool {
|
||||
let changed = self.enabled != enabled;
|
||||
self.enabled = enabled;
|
||||
if !enabled {
|
||||
self.hovered = false;
|
||||
self.pressed = false;
|
||||
self.focused = false;
|
||||
}
|
||||
changed
|
||||
}
|
||||
|
||||
/// 键盘焦点（由 `operation`/`shell` 侧的聚焦消息驱动）。
|
||||
pub fn set_focused(&mut self, focused: bool) -> bool {
|
||||
let next = focused && self.enabled;
|
||||
let changed = self.focused != next;
|
||||
self.focused = next;
|
||||
changed
|
||||
}
|
||||
|
||||
/// 折进一个事件；返回「视觉态变了，要重绘吗」。
|
||||
///
|
||||
/// `over` = 指针是否在控件 bounds 内（`Cursor::is_over(bounds)` 的结果，由调用方算——
|
||||
/// 这样本函数不依赖 `Layout`，可以在单测里直接喂）。
|
||||
pub fn event(&mut self, event: &Event, over: bool) -> bool {
|
||||
if !self.enabled {
|
||||
return false;
|
||||
}
|
||||
|
||||
let before = self.state();
|
||||
match event {
|
||||
Event::Mouse(iced::mouse::Event::CursorMoved { .. }) => self.hovered = over,
|
||||
Event::Mouse(iced::mouse::Event::CursorLeft) => {
|
||||
self.hovered = false;
|
||||
self.pressed = false;
|
||||
}
|
||||
Event::Mouse(iced::mouse::Event::ButtonPressed(iced::mouse::Button::Left)) => {
|
||||
self.pressed = over;
|
||||
}
|
||||
Event::Mouse(iced::mouse::Event::ButtonReleased(iced::mouse::Button::Left)) => {
|
||||
self.pressed = false;
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
self.state() != before
|
||||
}
|
||||
|
||||
/// 当前态（优先级：按下 > 焦点 > 悬停 > 静息；禁用最高）。
|
||||
pub const fn state(&self) -> Interaction {
|
||||
if !self.enabled {
|
||||
Interaction::Disabled
|
||||
} else if self.pressed {
|
||||
Interaction::Pressed
|
||||
} else if self.focused {
|
||||
Interaction::Focused
|
||||
} else if self.hovered {
|
||||
Interaction::Hovered
|
||||
} else {
|
||||
Interaction::Enabled
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// `Tracker` 的行为用例（自绘控件用，与颜色无关）。
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use iced::Event;
|
||||
|
||||
fn moved() -> Event {
|
||||
Event::Mouse(iced::mouse::Event::CursorMoved {
|
||||
position: iced::Point::ORIGIN,
|
||||
})
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn tracker_folds_events_into_the_five_states() {
|
||||
let mut tracker = Tracker::new(true);
|
||||
assert_eq!(tracker.state(), Interaction::Enabled);
|
||||
|
||||
assert!(tracker.event(&moved(), true), "首次悬停要报变化");
|
||||
assert_eq!(tracker.state(), Interaction::Hovered);
|
||||
assert!(!tracker.event(&moved(), true), "重复悬停不该再报变化");
|
||||
|
||||
let press = Event::Mouse(iced::mouse::Event::ButtonPressed(iced::mouse::Button::Left));
|
||||
assert!(tracker.event(&press, true));
|
||||
assert_eq!(tracker.state(), Interaction::Pressed);
|
||||
|
||||
let release = Event::Mouse(iced::mouse::Event::ButtonReleased(
|
||||
iced::mouse::Button::Left,
|
||||
));
|
||||
assert!(tracker.event(&release, true));
|
||||
assert_eq!(tracker.state(), Interaction::Hovered);
|
||||
|
||||
assert!(tracker.set_focused(true));
|
||||
assert_eq!(tracker.state(), Interaction::Focused, "焦点态优先于悬停");
|
||||
|
||||
let left = Event::Mouse(iced::mouse::Event::CursorLeft);
|
||||
tracker.event(&left, false);
|
||||
assert_eq!(tracker.state(), Interaction::Focused, "鼠标离开不影响焦点");
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn disabled_tracker_swallows_everything() {
|
||||
let mut tracker = Tracker::new(true);
|
||||
assert!(tracker.set_enabled(false));
|
||||
assert_eq!(tracker.state(), Interaction::Disabled);
|
||||
|
||||
let press = Event::Mouse(iced::mouse::Event::ButtonPressed(iced::mouse::Button::Left));
|
||||
assert!(!tracker.event(&press, true), "禁用态不响应事件");
|
||||
assert_eq!(tracker.state(), Interaction::Disabled);
|
||||
assert!(!tracker.set_focused(true), "禁用态拿不到焦点");
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,129 @@
|
||||
//! 布局陷阱的两个固定解法（D39 §4）：**要精确尺寸就调这里，别手写**。
|
||||
//!
|
||||
//! ## 陷阱 Q8：`center_x(Length::Fill)` 会把已设的 `.width()` 覆盖成 Fill
|
||||
//!
|
||||
//! iced 的 `container::center_x/center_y/center` 不只是「对齐」——它们**同时**把容器该轴的
|
||||
//! `Length` 改成 `Fill`（源码里 `self.width = Length::Fill`）。于是
|
||||
//! `.width(56).center_x(Length::Fill)` 最终是 `Fill`，56 被父级宽度吃掉：
|
||||
//! M68 的导航药丸因此从 **56×32 变成 88×32**（父级是 88 宽的轨），图上看着「横贯全轨」，
|
||||
//! 而单元测试测的 `indicator_size()` 返回值一直是 56×32 —— **函数对、图错**。
|
||||
//!
|
||||
//! 正确写法是二选一：
|
||||
//!
|
||||
//! - 尺寸留在**自己**身上，居中交给**父级**（`row/column` 的 `align_x`）——`shell/nav.rs` 的做法；
|
||||
//! - 或者用 [`centered_fixed`]：容器写死宽高，**用 `align_x/align_y` 居中**（它们只改对齐，
|
||||
//! 不改 `Length`）。
|
||||
//!
|
||||
//! ## 陷阱 Q9：`Button` 给内容 Fill 约束，`svg().width(24)` 会被忽略
|
||||
//!
|
||||
//! `button` 在 layout 里把「内容可用区」作为约束交给子元素，`svg` 拿到的是 Fill，
|
||||
//! usvg 于是按 `Contain` 撑满内区：**字形渲染成 46px、线宽从 1.5 变 2.9**（M68 视觉复审 P2-2），
|
||||
//! 比导航图标重一倍。反过来「把 `.width(24)` 设在 button 上」也不行——那会缩掉点击区。
|
||||
//!
|
||||
//! 正确写法：**在中间插一层固定尺寸容器**——[`fixed`]：
|
||||
//!
|
||||
//! ```text
|
||||
//! let icon = layout::fixed(24.0, 24.0, icons::view(kind, color)); // 字形 24×24
|
||||
//! button(icon).width(46).height(48) // 命中区仍是 46×48
|
||||
//! ```
|
||||
//!
|
||||
//! ## 为什么还要 [`inset`]
|
||||
//!
|
||||
//! 「左右缩进 16 的一条线」「内容四周留 24」这类**只改内边距、不改尺寸**的语义，
|
||||
//! 写 `.padding(Padding::from([...]))` 时数组顺序（上右下左）极易写反；封装一次，
|
||||
//! 全组件线只写一次顺序。
|
||||
//!
|
||||
//! ## 自检
|
||||
//!
|
||||
//! `components::gate` 会扫 `src/components/**`：出现 `center_x(` / `center_y(` / `.center(`
|
||||
//! 即判红（这条门禁就是 Q8 的回归测试）；图标一律经 [`fixed`] / [`centered_fixed`] 包一层。
|
||||
|
||||
use iced::widget::container;
|
||||
use iced::{Alignment, Element, Length, Padding};
|
||||
|
||||
/// 固定尺寸的盒子：宽高**只由参数决定**，子元素贴左上（对齐交给子元素自己或父级）。
|
||||
///
|
||||
/// Q9 的解法：`svg` 放进 24×24 的盒子，它拿到的约束就是 24，`Contain` 无从撑满。
|
||||
pub fn fixed<'a, M: 'a>(
|
||||
width: f32,
|
||||
height: f32,
|
||||
content: impl Into<Element<'a, M>>,
|
||||
) -> Element<'a, M> {
|
||||
container(content)
|
||||
.width(Length::Fixed(width))
|
||||
.height(Length::Fixed(height))
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 固定尺寸 + 内容居中（Q8 的解法）。
|
||||
///
|
||||
/// 用 `align_x/align_y` 而不是 `center_x/center_y`：前者只改对齐，后者会把本容器的
|
||||
/// `Length` 改成 `Fill`，把参数里的宽高**静默丢掉**。
|
||||
///
|
||||
/// 典型用法：导航轨的选中指示器 [`centered_fixed(56.0, 32.0, icon)`](centered_fixed)。
|
||||
pub fn centered_fixed<'a, M: 'a>(
|
||||
width: f32,
|
||||
height: f32,
|
||||
content: impl Into<Element<'a, M>>,
|
||||
) -> Element<'a, M> {
|
||||
container(content)
|
||||
.width(Length::Fixed(width))
|
||||
.height(Length::Fixed(height))
|
||||
.align_x(Alignment::Center)
|
||||
.align_y(Alignment::Center)
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 只加内边距、不碰尺寸（`horizontal` = 左右，`vertical` = 上下）。
|
||||
///
|
||||
/// 语义等价于 `.padding(Padding { top: vertical, right: horizontal, bottom: vertical,
|
||||
/// left: horizontal })`，但只暴露两个参数——避免把「上右下左」写反。
|
||||
pub fn inset<'a, M: 'a>(
|
||||
horizontal: f32,
|
||||
vertical: f32,
|
||||
content: impl Into<Element<'a, M>>,
|
||||
) -> Element<'a, M> {
|
||||
container(content)
|
||||
.padding(Padding {
|
||||
top: vertical,
|
||||
right: horizontal,
|
||||
bottom: vertical,
|
||||
left: horizontal,
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 单侧缩进（只缩左侧；分隔线的「列表内左缩进 16」用这个）。
|
||||
pub fn inset_start<'a, M: 'a>(start: f32, content: impl Into<Element<'a, M>>) -> Element<'a, M> {
|
||||
container(content)
|
||||
.width(Length::Fill)
|
||||
.padding(Padding {
|
||||
left: start,
|
||||
..Padding::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
/// Q8 的**形态级**钉法：这三个 API 一旦内部改用 `center_*`，这条测试之外的门禁
|
||||
/// （`components::gate`）也会红；这里再钉一次「参数就是参数」，防止签名被悄悄改成
|
||||
/// `impl Into<Length>` 之类。
|
||||
#[test]
|
||||
fn helpers_take_pixel_sizes_not_lengths() {
|
||||
let _: fn(f32, f32, Element<'static, ()>) -> Element<'static, ()> = fixed;
|
||||
let _: fn(f32, f32, Element<'static, ()>) -> Element<'static, ()> = centered_fixed;
|
||||
let _: fn(f32, f32, Element<'static, ()>) -> Element<'static, ()> = inset;
|
||||
let _: fn(f32, Element<'static, ()>) -> Element<'static, ()> = inset_start;
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn helpers_build_a_tree_without_panicking() {
|
||||
let _: Element<'_, ()> = fixed(24.0, 24.0, iced::widget::text("x"));
|
||||
let _: Element<'_, ()> = centered_fixed(56.0, 32.0, iced::widget::text("x"));
|
||||
let _: Element<'_, ()> = inset(16.0, 8.0, iced::widget::text("x"));
|
||||
let _: Element<'_, ()> = inset_start(16.0, iced::widget::text("x"));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,58 @@
|
||||
//! 组件库（D39 定案）：五家族并行，**目录所有权切分**，接口见
|
||||
//! `DevDocs/SubAgentsTalk/app-iced-组件库契约.md`。
|
||||
//!
|
||||
//! ## 模块地图与归属（谁能写哪里）
|
||||
//!
|
||||
//! ```text
|
||||
//! components/
|
||||
//! mod.rs ← 本文件（COMPBASE 独占）：只声明子模块，不含实现
|
||||
//! interaction.rs ← COMPBASE 独占：hover/focus/pressed/disabled 的唯一实现
|
||||
//! layout.rs ← COMPBASE 独占：Q8/Q9 两个布局陷阱的固定解法
|
||||
//! buttons/ ← COMPBASE（12b §1 按钮家族 + §2 IconButton）
|
||||
//! divider.rs ← COMPBASE（15 §22）
|
||||
//! selection/ ← 本文件只放桩；后续 mission 在自己的目录里填（§18/§19/§10/§13）
|
||||
//! inputs/ ← 同上（§9/§20/§11/§8）
|
||||
//! feedback/ ← 同上（§12/§14/§7/§15）
|
||||
//! navigation/ ← 同上（§4/§6/§21/§16）
|
||||
//! gallery/ ← 视觉验收 harness（`--screen=gallery`）
|
||||
//! ```
|
||||
//!
|
||||
//! **后续 mission 只写自己目录内的文件，不改本文件**：四个家族桩已经在这里声明好，
|
||||
//! 每个家族文件自带一个 `demo()`（占位 → 真组件），gallery 侧对应文件也在
|
||||
//! `gallery/` 里预置了同构的桩。加组件 = 只改自家目录里的文件。
|
||||
//!
|
||||
//! ## 组件签名纪律（契约 §2）
|
||||
//!
|
||||
//! 组件**对消息类型泛型**，不 import `crate::app::Message`：
|
||||
//!
|
||||
//! ```text
|
||||
//! pub fn filled<'a, M: Clone + 'a>(ui: &'a Ui, ...) -> Element<'a, M>
|
||||
//! ```
|
||||
//!
|
||||
//! `Ui` 一律 `&'a Ui` 传入，组件内部**不许** `Ui::new`；深浅热切靠外部重建整树。
|
||||
//!
|
||||
//! ## 令牌纪律
|
||||
//!
|
||||
//! 组件里**零**色值 / 字号 / 半径 / 间距 / α 字面量：颜色走 [`crate::theme::Ui`]，
|
||||
//! 状态层走 [`interaction`]，尺寸走 `unlucky_design` 的 `LayoutMetrics` / `Space` /
|
||||
//! `IconSize` / `ShapeScale`。缺令牌 → 登记 G 编号（续 15 §25 的 G13），**不发明**。
|
||||
//! [`gate`] 里的测试会扫本目录源码执行这条纪律。
|
||||
//!
|
||||
//! ## 为什么 `components` 由 `app.rs` 声明
|
||||
//!
|
||||
//! `src/lib.rs` 是五条组件线共用的文件（并行线改它必然冲突）。本模块挂在
|
||||
//! `app.rs` 的 `#[path]` 声明下，路径仍是 `src/components/`，这样 COMPBASE 的
|
||||
//! 全部改动都落在自己 scope 内。
|
||||
|
||||
pub mod buttons;
|
||||
pub mod divider;
|
||||
pub mod feedback;
|
||||
pub mod gallery;
|
||||
pub mod inputs;
|
||||
pub mod interaction;
|
||||
pub mod layout;
|
||||
pub mod navigation;
|
||||
pub mod selection;
|
||||
|
||||
#[cfg(test)]
|
||||
mod gate;
|
||||
@@ -0,0 +1,353 @@
|
||||
//! AppBar（small）（`research/12b` §16）：页头 56、标题 + 副标题、leading / trailing 槽位、滚动换色。
|
||||
//!
|
||||
//! ## 参考值（`[源]` = A1，本轮 `javap` 实读本机 AAR）
|
||||
//!
|
||||
//! | # | 检查项 | 参考值 | 本项目 |
|
||||
//! |---|---|---|---|
|
||||
//! | 16.1 | 页头高 | `AppBarSmallTokens.ContainerHeight` = **64** | **56** = `LM.page_header_height`（登记偏离 −8） |
|
||||
//! | 16.3 | 容器 | `AppBarTokens.ContainerColor = Surface` + L0；**滚动后** `OnScrollContainerColor = SurfaceContainer` + `OnScrollContainerElevation`（L2） | 同 |
|
||||
//! | 16.4 | 字级 | `TitleFont = TitleLarge`（emphasized w500）· `SubtitleFont = LabelMedium` + `SubtitleColor = OnSurfaceVariant` | 同 |
|
||||
//! | 16.5 | 图标 | `IconSize = 24`；leading `OnSurface`、trailing `OnSurfaceVariant` | 同 |
|
||||
//! | 16.6 | 左右内边距 | `LeadingSpace = 4` / `TrailingSpace = 4`（+ IconButton 自带 40 宽 → 视觉起手 20） | 同 |
|
||||
//!
|
||||
//! ## 「滚动时的高度变化」——**规范上不存在**（不是我们没做）
|
||||
//!
|
||||
//! A1 的 `AppBarTokens` 全字段实读（`javap -p -c androidx.compose.material3.tokens.AppBarTokens`）：
|
||||
//!
|
||||
//! ```text
|
||||
//! AvatarSize 32 · ContainerColor Surface · ContainerElevation · ContainerShape CornerNone
|
||||
//! IconButtonSpace · IconSize 24 · LeadingIconColor · LeadingSpace 4
|
||||
//! OnScrollContainerColor SurfaceContainer · OnScrollContainerElevation ← 滚动只改这两项
|
||||
//! SubtitleColor/SubtitleFont · TitleColor/TitleFont · TrailingIconColor · TrailingSpace 4
|
||||
//! ```
|
||||
//!
|
||||
//! **整个 tokens 包里 `OnScroll*` 只有两个字段**（颜色与高程，见 `grep` 全量核对的报告），
|
||||
//! 没有任何 `OnScroll…Height`；高度只在**尺寸档**（`AppBarSmallTokens.ContainerHeight = 64`）里，
|
||||
//! 而那是 `small` / `medium` / `large` 三个**不同组件**的分档，不是滚动驱动的形变。
|
||||
//! 所以滚动时**高度不变**、只换容器色 + 升到 L2 阴影——这是规范，不是偏离。
|
||||
//!
|
||||
//! 我们与规范的两处差异各登记一条：
|
||||
//!
|
||||
//! - **D-M79-2** 高度 56 而不是 64（项目骨架口径 `LM.page_header_height`，已有页面按 56 排版）；
|
||||
//! - 不做 `Medium` / `Large` 的**折叠（collapsing）**形态——那是另外两个组件（`AppBarMediumTokens`
|
||||
//! / `AppBarLargeTokens`），本 mission 的 §16 只要求 small。
|
||||
|
||||
use iced::widget::text::{LineHeight, Wrapping};
|
||||
use iced::widget::{button, container, text};
|
||||
use iced::{
|
||||
Alignment, Background, Border, Color, Element, Length, Padding, Pixels, Shadow, Vector,
|
||||
};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::elevation::Elevation;
|
||||
use unlucky_design::icons::IconKind;
|
||||
use unlucky_design::shape::ShapeScale;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::icons;
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::interaction::{self, Interaction};
|
||||
use super::super::layout;
|
||||
use super::geometry::AppBarGeometry;
|
||||
|
||||
/// 页头里的一个图标动作。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct AppBarAction<M> {
|
||||
icon: IconKind,
|
||||
on_press: Option<M>,
|
||||
}
|
||||
|
||||
impl<M> AppBarAction<M> {
|
||||
/// 一个可点的图标动作。
|
||||
pub fn new(icon: IconKind, on_press: M) -> Self {
|
||||
Self {
|
||||
icon,
|
||||
on_press: Some(on_press),
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个装饰性图标（无消息）。
|
||||
pub fn inert(icon: IconKind) -> Self {
|
||||
Self {
|
||||
icon,
|
||||
on_press: None,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// 一条 AppBar small。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct AppBar<'a, M> {
|
||||
title: &'a str,
|
||||
subtitle: Option<&'a str>,
|
||||
leading: Option<AppBarAction<M>>,
|
||||
trailing: Vec<AppBarAction<M>>,
|
||||
scrolled: bool,
|
||||
}
|
||||
|
||||
impl<'a, M> AppBar<'a, M> {
|
||||
/// 标题（`TitleLarge`，emphasized）。
|
||||
pub fn new(title: &'a str) -> Self {
|
||||
Self {
|
||||
title,
|
||||
subtitle: None,
|
||||
leading: None,
|
||||
trailing: Vec::new(),
|
||||
scrolled: false,
|
||||
}
|
||||
}
|
||||
|
||||
/// 副标题（`LabelMedium` + `OnSurfaceVariant`）。
|
||||
pub fn subtitle(mut self, subtitle: &'a str) -> Self {
|
||||
self.subtitle = Some(subtitle);
|
||||
self
|
||||
}
|
||||
|
||||
/// 前置动作（导航返回 / 汉堡；`OnSurface`）。
|
||||
pub fn leading(mut self, action: AppBarAction<M>) -> Self {
|
||||
self.leading = Some(action);
|
||||
self
|
||||
}
|
||||
|
||||
/// 追加一个后置动作（`OnSurfaceVariant`）。
|
||||
pub fn trailing(mut self, action: AppBarAction<M>) -> Self {
|
||||
self.trailing.push(action);
|
||||
self
|
||||
}
|
||||
|
||||
/// 滚动状态：`true` = 容器色 `SurfaceContainer` + L2 阴影（A1 `OnScroll*`）。
|
||||
pub fn scrolled(mut self, scrolled: bool) -> Self {
|
||||
self.scrolled = scrolled;
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 一个图标动作按钮（40×40 命中区、图标 24 经 `layout::fixed`——Q9）。
|
||||
fn action<'a, M: Clone + 'a>(
|
||||
ui: &'a Ui,
|
||||
action: AppBarAction<M>,
|
||||
geometry: AppBarGeometry,
|
||||
color: Color,
|
||||
) -> Element<'a, M> {
|
||||
let hovered =
|
||||
interaction::overlay_color(ui, Interaction::Hovered, Role::OnSurface, Role::Surface);
|
||||
let icon = layout::fixed(
|
||||
geometry.icon,
|
||||
geometry.icon,
|
||||
icons::view::<M>(action.icon, color),
|
||||
);
|
||||
let hit = ui.metrics().control_height;
|
||||
// 图标要落在 40×40 命中区的**正中**：`Container` 默认 `horizontal_alignment: Left`
|
||||
// （`iced_widget-0.14.2/src/container.rs`），只给 `align_y` 会让 24px 图标贴左缘——
|
||||
// 视觉 r1 实测前导墨迹 `38..58`（应 `44..68`）。所以**两轴都显式给**（规则 Q21）。
|
||||
let button = button(
|
||||
container(icon)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fill)
|
||||
.align_x(Alignment::Center)
|
||||
.align_y(Alignment::Center),
|
||||
)
|
||||
.width(Length::Fixed(hit))
|
||||
.height(Length::Fixed(hit))
|
||||
.padding(0)
|
||||
.style(move |_theme, status| button::Style {
|
||||
background: some_if_hovered(status, hovered),
|
||||
text_color: color,
|
||||
border: Border {
|
||||
// IconButton 的圆角是 full：按命中区边长折算（`radius_dp` 不接受 Full）
|
||||
radius: ui.radius(ShapeScale::Full, hit),
|
||||
..Border::default()
|
||||
},
|
||||
shadow: Shadow::default(),
|
||||
snap: true,
|
||||
});
|
||||
match action.on_press {
|
||||
Some(message) => button.on_press(message).into(),
|
||||
None => button.into(),
|
||||
}
|
||||
}
|
||||
|
||||
/// hover 时给背景（`None` 的其他态不叠状态层）。
|
||||
fn some_if_hovered(status: button::Status, hovered: Option<Color>) -> Option<Background> {
|
||||
match status {
|
||||
button::Status::Hovered => hovered.map(Background::Color),
|
||||
_ => None,
|
||||
}
|
||||
}
|
||||
|
||||
/// AppBar small（页头 56 / Surface / 滚动换色）。
|
||||
pub fn app_bar<'a, M: Clone + 'a>(ui: &'a Ui, bar: AppBar<'a, M>) -> Element<'a, M> {
|
||||
let geometry = AppBarGeometry::of(ui);
|
||||
|
||||
let title_style = ui.emphasized(TypeRole::TitleLarge);
|
||||
let mut texts = iced::widget::Column::new().spacing(0);
|
||||
texts = texts.push(
|
||||
text(bar.title)
|
||||
.size(title_style.size_px)
|
||||
.line_height(LineHeight::Absolute(Pixels(title_style.line_height_px)))
|
||||
// 单行：页头高固定 56，长标题折行会顶穿页头并与 trailing 动作重叠（偏离 D-M79-5）
|
||||
.wrapping(Wrapping::None)
|
||||
.font(ui.font_of(title_style))
|
||||
.color(ui.color(Role::OnSurface)),
|
||||
);
|
||||
if let Some(subtitle) = bar.subtitle {
|
||||
let style = ui.style(TypeRole::LabelMedium);
|
||||
texts = texts.push(
|
||||
text(subtitle)
|
||||
.size(style.size_px)
|
||||
.line_height(LineHeight::Absolute(Pixels(style.line_height_px)))
|
||||
.wrapping(Wrapping::None)
|
||||
.font(ui.font_of(style))
|
||||
.color(ui.color(Role::OnSurfaceVariant)),
|
||||
);
|
||||
}
|
||||
|
||||
let mut row = iced::widget::Row::new()
|
||||
.align_y(Alignment::Center)
|
||||
.spacing(ui.space(unlucky_design::spacing::Space::X2));
|
||||
if let Some(leading) = bar.leading {
|
||||
// 16.5：leading 图标 `OnSurface`
|
||||
row = row.push(action(ui, leading, geometry, ui.color(Role::OnSurface)));
|
||||
}
|
||||
// 文本块吃掉剩余宽度并**裁切**：这一条同时解决两件事——
|
||||
// ① 标题与 trailing 之间必须有 Fill（M77 Q8 同款），② 单行超长标题切在动作按钮之前，
|
||||
// 不会重叠（`clip(true)` 是 iced 里唯一能裁子元素越界的方式；没有 ellipsis，见 D-M79-5）。
|
||||
row = row.push(container(texts).width(Length::Fill).clip(true));
|
||||
for action_item in bar.trailing {
|
||||
// 16.5：trailing 图标 `OnSurfaceVariant`
|
||||
row = row.push(action(
|
||||
ui,
|
||||
action_item,
|
||||
geometry,
|
||||
ui.color(Role::OnSurfaceVariant),
|
||||
));
|
||||
}
|
||||
|
||||
let background = if bar.scrolled {
|
||||
ui.color(Role::SurfaceContainer)
|
||||
} else {
|
||||
ui.color(Role::Surface)
|
||||
};
|
||||
let elevation = scroll_elevation(bar.scrolled);
|
||||
let shadow = if matches!(elevation, Elevation::Level0) {
|
||||
Shadow::default()
|
||||
} else {
|
||||
let spec = elevation.shadow();
|
||||
Shadow {
|
||||
color: Color {
|
||||
a: spec.alpha,
|
||||
..ui.color(Role::Shadow)
|
||||
},
|
||||
offset: Vector::new(0.0, spec.offset_y_px),
|
||||
blur_radius: spec.blur_px,
|
||||
}
|
||||
};
|
||||
|
||||
container(row)
|
||||
.width(Length::Fill)
|
||||
.height(Length::Fixed(geometry.height))
|
||||
// 内容行（40 高的动作按钮 + 文本块）必须落在 56 页头的**垂直中线**上：
|
||||
// `Container` 的 vertical_alignment 默认 Top，只给 `width` 会让整行贴顶
|
||||
// （视觉 r1 实测前导图标墨迹 y=204..223，居中应是 209..227）。
|
||||
.align_y(Alignment::Center)
|
||||
.padding(Padding {
|
||||
top: 0.0,
|
||||
right: geometry.edge,
|
||||
bottom: 0.0,
|
||||
left: geometry.edge,
|
||||
})
|
||||
.style(move |_theme| container::Style {
|
||||
background: Some(Background::Color(background)),
|
||||
border: Border {
|
||||
// 16.3：ContainerShape = CornerNone
|
||||
radius: ui.radius_dp(ShapeScale::None),
|
||||
..Border::default()
|
||||
},
|
||||
shadow,
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
/// 滚动态的高程档（A1 `AppBarTokens.OnScrollContainerElevation`；静息 L0 = `ContainerElevation`）。
|
||||
fn scroll_elevation(scrolled: bool) -> Elevation {
|
||||
if scrolled {
|
||||
Elevation::Level2
|
||||
} else {
|
||||
Elevation::Level0
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
use unlucky_design::color::SchemeFlavor;
|
||||
use unlucky_design::typography::Platform;
|
||||
|
||||
use crate::theme::Families;
|
||||
|
||||
fn ui() -> Ui {
|
||||
Ui::with_platform(
|
||||
SchemeFlavor::Light,
|
||||
Platform::Windows,
|
||||
Families {
|
||||
text: "Segoe UI",
|
||||
display: "Segoe UI",
|
||||
mono: "Consolas",
|
||||
},
|
||||
)
|
||||
}
|
||||
|
||||
/// 16.1：页头高 = `LM.page_header_height`（56），并**钉死**它与 A1 的 64 不同。
|
||||
#[test]
|
||||
fn height_is_pinned_to_the_page_header_token() {
|
||||
let ui = ui();
|
||||
let geometry = AppBarGeometry::of(&ui);
|
||||
assert_eq!(geometry.height, ui.metrics().page_header_height);
|
||||
assert_eq!(geometry.height, 56.0);
|
||||
assert_ne!(
|
||||
geometry.height, 64.0,
|
||||
"64 是 A1 AppBarSmallTokens.ContainerHeight；本项目按骨架令牌取 56（D-M79-2）"
|
||||
);
|
||||
}
|
||||
|
||||
/// 16.5 / 16.6：图标 24、左右内边距 4、头像 32。
|
||||
#[test]
|
||||
fn icon_and_edges_come_from_tokens() {
|
||||
let geometry = AppBarGeometry::of(&ui());
|
||||
assert_eq!(geometry.icon, 24.0);
|
||||
assert_eq!(geometry.edge, 4.0);
|
||||
assert_eq!(geometry.avatar, 32.0);
|
||||
}
|
||||
|
||||
/// 「滚动只换色 + 升 L2」：这条把 `OnScroll*` 的两个字段钉住（高度**不在**这里面）。
|
||||
#[test]
|
||||
fn scroll_switches_color_and_elevation_only() {
|
||||
let ui = ui();
|
||||
assert_eq!(scroll_elevation(false), Elevation::Level0);
|
||||
assert_eq!(scroll_elevation(true), Elevation::Level2);
|
||||
// 高度与滚动无关：同一个几何（这条是「滚动不改高度」的可执行声明）
|
||||
assert_eq!(
|
||||
AppBarGeometry::of(&ui).height,
|
||||
ui.metrics().page_header_height,
|
||||
"高度只由骨架令牌决定，没有 OnScroll…Height"
|
||||
);
|
||||
}
|
||||
|
||||
/// 树能建出来（leading + 副标题 + 两个 trailing + 滚动态）。
|
||||
#[test]
|
||||
fn view_builds_a_tree() {
|
||||
let ui = ui();
|
||||
let _: Element<'_, ()> = app_bar(
|
||||
&ui,
|
||||
AppBar::new("Instances")
|
||||
.subtitle("4 instances")
|
||||
.leading(AppBarAction::new(IconKind::Instances, ()))
|
||||
.trailing(AppBarAction::new(IconKind::Settings, ()))
|
||||
.trailing(AppBarAction::inert(IconKind::Logs))
|
||||
.scrolled(true),
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,140 @@
|
||||
//! NavigationDrawer / NavigationRail（`research/15` §21 + 12b §5）：**同一个容器的两个宽度**（D33）。
|
||||
//!
|
||||
//! 本文件只装「容器」：宽度（88 ⇄ 240）、`CornerLargeEnd` 圆角、分组标题、组间分隔线。
|
||||
//! 一项长什么样（`NavItem` / `NavGroup` / 颜色求值 / 药丸排布）在 `drawer/item.rs`。
|
||||
//!
|
||||
//! ## 参考值与 D33（详见 `geometry.rs` 的表）
|
||||
//!
|
||||
//! ```text
|
||||
//! 折叠 = Rail 88 = LayoutMetrics::nav_rail_width 项高 52 = 药丸 32 + 4 + 标签 16
|
||||
//! 展开 = Drawer 240 = LayoutMetrics::nav_drawer_width 项高 56 = A1 ActiveIndicatorHeight（G24）
|
||||
//! 药丸：rail 88 − 2×16 = 56（M68 的 56×32）；drawer 240 − 2×12 = 216（= A1 的 360 − 2×12）
|
||||
//! ```
|
||||
//!
|
||||
//! 两者共用 [`navigation`] 一个入口、一套颜色角色、一套 full 圆角药丸；切换时圆角语言不变，
|
||||
//! 一屏导航容器数恒为 1（§21.9）。**不是两套组件**——D33 的可验收形式就是「同一函数两个宽度」。
|
||||
//!
|
||||
//! ## Q8 的现场
|
||||
//!
|
||||
//! M68 的药丸写 56 宽后用 `center_x(Length::Fill)` 居中，容器尺寸被 Fill 覆盖成 88 宽（图上横贯全轨）。
|
||||
//! 这里药丸宽由 [`NavPaneGeometry::pill_width`] 给出，居中一律交给父级 `align_x`。
|
||||
//!
|
||||
//! ## 分组标题（只 drawer 侧，§21.8）
|
||||
//!
|
||||
//! `TitleSmall` + `OnSurfaceVariant`，**不可点**；组与组之间 1px `OutlineVariant`
|
||||
//! （复用 [`crate::app::components::divider`]），不用背景色块分区。
|
||||
|
||||
use iced::widget::container;
|
||||
use iced::{Background, Border, Element, Length, Padding};
|
||||
|
||||
use unlucky_design::color::Role;
|
||||
use unlucky_design::elevation::MaterialLayer;
|
||||
use unlucky_design::typography::TypeRole;
|
||||
|
||||
use crate::theme::Ui;
|
||||
|
||||
use super::super::divider;
|
||||
use super::geometry::{NavLayout, NavPaneGeometry};
|
||||
|
||||
mod item;
|
||||
use item::{line, nav_row};
|
||||
pub use item::{NavGroup, NavItem};
|
||||
|
||||
/// 导航容器（D33：`layout` 决定 88 还是 240，其余全同）。
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct Navigation<'a, M> {
|
||||
layout: NavLayout,
|
||||
groups: Vec<NavGroup<'a, M>>,
|
||||
}
|
||||
|
||||
impl<'a, M> Navigation<'a, M> {
|
||||
/// 折叠态：rail（88）。
|
||||
pub fn rail() -> Self {
|
||||
Self {
|
||||
layout: NavLayout::Rail,
|
||||
groups: Vec::new(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 展开态：标准常驻 drawer（240）。
|
||||
pub fn drawer() -> Self {
|
||||
Self {
|
||||
layout: NavLayout::Drawer,
|
||||
groups: Vec::new(),
|
||||
}
|
||||
}
|
||||
|
||||
/// 追加分组（组间自动画 1px `OutlineVariant`）。
|
||||
pub fn group(mut self, group: NavGroup<'a, M>) -> Self {
|
||||
self.groups.push(group);
|
||||
self
|
||||
}
|
||||
}
|
||||
|
||||
/// 导航容器（rail ⇄ drawer 的唯一入口）。
|
||||
pub fn navigation<'a, M: Clone + 'a>(ui: &'a Ui, nav: Navigation<'a, M>) -> Element<'a, M> {
|
||||
let geometry = NavPaneGeometry::of(ui, nav.layout);
|
||||
let gap = match nav.layout {
|
||||
NavLayout::Rail => ui.metrics().nav_item_gap,
|
||||
// drawer 的项是紧贴的（56 已经含了内部留白，§21.4）
|
||||
NavLayout::Drawer => 0.0,
|
||||
};
|
||||
|
||||
let mut body = iced::widget::Column::new().spacing(gap).width(Length::Fill);
|
||||
for (index, group) in nav.groups.into_iter().enumerate() {
|
||||
// 组间分隔线只属于 drawer：rail 88 宽里一条通栏线只会切碎药丸的节奏（§21.8 的分区是 drawer 语义）
|
||||
if index > 0 && matches!(nav.layout, NavLayout::Drawer) {
|
||||
body = body.push(container(divider::full::<M>(ui)).padding(Padding {
|
||||
top: ui.space(unlucky_design::spacing::Space::X2),
|
||||
bottom: ui.space(unlucky_design::spacing::Space::X2),
|
||||
left: 0.0,
|
||||
right: 0.0,
|
||||
}));
|
||||
}
|
||||
// 标题只在 drawer 侧出现（rail 88 宽放不下文字，§21.8 的分区是 drawer 语义）
|
||||
if let (NavLayout::Drawer, Some(title)) = (nav.layout, group.title) {
|
||||
body = body.push(
|
||||
container(line::<M>(
|
||||
ui,
|
||||
title,
|
||||
TypeRole::TitleSmall,
|
||||
ui.color(Role::OnSurfaceVariant),
|
||||
))
|
||||
.width(Length::Fill)
|
||||
.padding(Padding {
|
||||
top: ui.space(unlucky_design::spacing::Space::X2),
|
||||
right: geometry.pad_start,
|
||||
bottom: ui.space(unlucky_design::spacing::Space::X1),
|
||||
left: geometry.pill_inset + geometry.pad_start,
|
||||
}),
|
||||
);
|
||||
}
|
||||
for item in group.items {
|
||||
body = body.push(nav_row(ui, item, geometry));
|
||||
}
|
||||
}
|
||||
|
||||
container(body)
|
||||
.width(Length::Fixed(geometry.width))
|
||||
.height(Length::Fill)
|
||||
// 轨顶留白走 padding（不是 spacer 元素：会被 column 的 spacing 再加一档，M68 P3-5）
|
||||
.padding(Padding {
|
||||
top: ui.space(unlucky_design::spacing::Space::X6),
|
||||
right: 0.0,
|
||||
bottom: 0.0,
|
||||
left: 0.0,
|
||||
})
|
||||
.style(move |_theme| container::Style {
|
||||
// §21.3 标准（常驻）= Surface + L0；形状 CornerLargeEnd（内侧两角 16）
|
||||
background: Some(Background::Color(ui.layer(MaterialLayer::Canvas))),
|
||||
border: Border {
|
||||
radius: geometry.radius,
|
||||
..Border::default()
|
||||
},
|
||||
..container::Style::default()
|
||||
})
|
||||
.into()
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests;
|
||||
Loaded 100 of 1092 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user