From b748986aaec77346cd5059a9426f3dcb9f469704 Mon Sep 17 00:00:00 2001 From: AskaEth Date: Mon, 2 Nov 2026 11:19:06 +0800 Subject: [PATCH] =?UTF-8?q?test(design):=20=E9=92=89=E4=BD=8F=20D43=20?= =?UTF-8?q?=E7=9A=84=E5=9B=BA=E5=AE=9A=E4=B8=AD=E6=80=A7=E8=89=B2=E7=9B=B8?= =?UTF-8?q?=EF=BC=88=E5=85=AB=E5=8D=A1=E5=90=8C=E5=BA=95=E8=89=B2=20/=20?= =?UTF-8?q?=E5=A4=A9=E8=93=9D=E4=B8=8D=E5=8A=A8=20/=20=E5=8A=A8=E6=80=81?= =?UTF-8?q?=E8=B7=AF=E5=BE=84=E4=B8=8D=E9=80=80=E5=8C=96=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `tests/card_neutral.rs`（新文件，8 条用例）： 1. `sky_card_is_bit_identical_to_the_product_baseline`：默认档天蓝的 49 个角色 == `Scheme::baseline`，两套模式逐值相等（M88 的 p1 级硬约束）。 2. `preset_cards_share_one_neutral_hue_and_chroma`：八张卡 surface 的 CAM16 色相 一致（±1°）、实测彩度落在 ±1.5 带宽内，且更强的一条——八张卡的 surface 是同一个 hex（实测差 0.00° / 0.00）。 3. `the_old_per_card_tinting_really_was_a_ninefold_gap`：反证，证明上面的带宽量得出 问题——改前浅色档彩度差 9.3 倍（rose 1.29 / teal 12.03），改后 1.0 倍；深色档改前 彩度本来就一致（tone 6 装得下 12），问题在色相横跨 285°，改后色相跨度 0。 4. `cards_only_change_the_accent_families`：强调族不靠手抄清单，而是实测「换强调色会 变的角色」（深色 26 个 / 浅色 23 个——浅色 on-primary/secondary/tertiary 的 tone 是 100，任何色相都是纯白），其余角色必须逐值留在基线。 5. `card_scheme_matches_from_accent_when_chroma_is_the_default`：色卡方案 == `Scheme::from_accent(卡种子)`，把 D43 接到 `tests/official_accent.rs` 的官方对账上。 6. `image_scheme_ignores_the_preset_neutral_hue`：动态路径的守护测试——同一张图在 sky / teal 卡下强调色相同，中性调色板色相来自图像种子（精确口径查 `Palettes::neutral`， 另加一条观感口径），且远离 `NEUTRAL_HUE_DEG`；谁把取色也改成固定中性就会红。 7. `every_card_scheme_meets_wcag_aa_under_the_fixed_neutral`：8 卡 × 浅/深 × 26 对全部 ≥ 4.5:1（`palette::wcag::check` 全表），并把 on-surface/surface 钉在实测量级。 8. `dump_card_palette_for_the_color_card`：出图数据（`CARD|…` 行，改前/改后并排）， 渲染脚本只做排版。 实测：8 卡 surface 改前 `#EBFEF8`~`#FFF8F4`（浅）/`#061613`~`#1F0F10`（深）→ 改后统一 `#F6FAFF` / `#09151C`；全表最差比值浅 5.44 / 深 4.98，均远高于 AA 的 4.5。 门禁：`cargo test -p unlucky-design` 231 条全绿（216+5 doc → 226+5 doc，+10 条增量： 本文件 8 条 + `color::palettes` 2 条）。 --- crates/design/tests/card_neutral.rs | 399 ++++++++++++++++++++++++++++ 1 file changed, 399 insertions(+) create mode 100644 crates/design/tests/card_neutral.rs diff --git a/crates/design/tests/card_neutral.rs b/crates/design/tests/card_neutral.rs new file mode 100644 index 0000000..b5a8ffd --- /dev/null +++ b/crates/design/tests/card_neutral.rs @@ -0,0 +1,399 @@ +//! D43：内置色卡的**固定中性色相**——切卡只换强调色，窗口底色的冷暖不跟着换。 +//! +//! ## 这条测试要钉住的四件事 +//! +//! 1. **天蓝卡（出厂默认）逐值不变**：固定的中性色相等于天蓝档的中性色相，所以天蓝卡必须与 +//! [`Scheme::baseline`] 的 49 个角色**逐个相等**（M70 定案的不动点，p1 级硬约束）。 +//! 2. **八张卡的表面色完全相同**：`surface` 的 CAM16 色相一致（±1°）、实测彩度落在窄带内 +//! （±1.5），且改前那条「9 倍差」被同时量出来当反证（见 `the_old_per_card_tinting...`）。 +//! 3. **动态路径不许被顺手改成固定中性**：同一张图在两张不同卡下必须生成**同一套强调色**， +//! 而底色由图像种子的色相决定（Monet 体验，D38）。 +//! 4. **WCAG 不因换中性色相而掉档**：8 张卡 × 浅/深两套 × 26 对文字/图标对全部 ≥ 4.5:1。 +//! +//! ## 实测表（2026-11，本文件 `dump_card_palette_for_the_color_card` 的输出） +//! +//! | 卡 | 改前 `surface`(浅) | 改后 `surface`(浅) | 改前 HCT(浅) | 改后 HCT(浅) | +//! |---|---|---|---|---| +//! | sky | `#F6FAFF` | `#F6FAFF` | 236.86° / 6.41 | 236.86° / 6.41 | +//! | lavender | `#FDF7FF` | `#F6FAFF` | 298.10° / 5.87 | 236.86° / 6.41 | +//! | forest | `#EEFDEE` | `#F6FAFF` | 157.01° / 11.77 | 236.86° / 6.41 | +//! | amber | `#FFF8F4` | `#F6FAFF` | 71.48° / 1.89 | 236.86° / 6.41 | +//! | rose | `#FFF8F7` | `#F6FAFF` | 22.09° / 1.29 | 236.86° / 6.41 | +//! | teal | `#EBFEF8` | `#F6FAFF` | 182.42° / 12.03 | 236.86° / 6.41 | +//! | dusk | `#FBF8FF` | `#F6FAFF` | 280.31° / 5.44 | 236.86° / 6.41 | +//! | olive | `#F9FBE1` | `#F6FAFF` | 120.99° / 11.84 | 236.86° / 6.41 | +//! +//! 深色档同理：改前 `#09151C`~`#1F0F10`、彩度 11.63~12.45，改后八张卡统一 `#09151C` +//! （235.70° / 11.70）。 +//! +//! ## 为什么容差是这个带宽（不是随手取整） +//! +//! - **色相 ±1°**：八张卡现在共用一个中性调色板，`surface` 是**同一个 hex**，跨卡差实测 0.00°。 +//! 容差留 1° 是为了挡住「将来某张卡偷偷换回 TonalSpot」——那种回退的最小偏离是 **43°** +//! （dusk 280.31° vs 236.86°），1° 的带宽足以把 0 与 43° 分开，同时不误报 8 bit 量化。 +//! - **彩度 ±1.5（CAM16，单位与请求值 12 同刻度）**：tone 98 的 8 bit 量化会把「请求 12」 +//! 读回成 6.41（浅）/11.70（深），这层压缩是**同一个 hex 的常数偏移**，跨卡比较时抵消； +//! 真正的危险是暖相回退——rose 1.29、amber 1.89，比基线低 4.5~5.1，远超 1.5 的带宽； +//! 紫相（lavender 5.87）只低 0.54，靠上面的色相断言抓（298° 偏 61°）。带宽取 1.5 = 请求 +//! 彩度的 1/8，比「改前最小的一张卡偏离基线」还小，所以「9 倍差回来了」一定红。 + +use unlucky_design::color::{ + Hct, Role, Scheme, SchemeFlavor, DEFAULT_NEUTRAL_CHROMA, NEUTRAL_HUE_DEG, +}; +use unlucky_design::palette::card::card_scheme_is_readable; +use unlucky_design::palette::{Card, CardKey, CARDS, DEFAULT_CARD, TEXT_PAIRS}; + +/// 改前的路径（M87 及之前）：中性调色板跟着种子染色（官方 TonalSpot）。 +/// +/// 产品代码已经不用它了，但公开 API 仍在（取色路径就靠它逐色染色），所以这里能原样复现「改前」。 +fn before_d43(card: Card, flavor: SchemeFlavor) -> Scheme { + Scheme::from_palettes( + &unlucky_design::color::Palettes::from_seed_with_neutral_chroma( + card.seed, + card.neutral_chroma, + ), + flavor, + ) +} + +fn flavors() -> [SchemeFlavor; 2] { + [SchemeFlavor::Light, SchemeFlavor::Dark] +} + +/// 色相环上的最短距离（度）。 +fn hue_gap(a: f64, b: f64) -> f64 { + let raw = (a - b).abs(); + raw.min(360.0 - raw) +} + +/// 天蓝卡就是产品默认色：固定的中性色相**沿用**它，所以 49 个角色必须一位不差。 +/// +/// 这条是 M88 的 p1 级硬约束。它红了只说明一件事：把「沿用天蓝的中性」实现成了「另选一个中性」。 +#[test] +fn sky_card_is_bit_identical_to_the_product_baseline() { + for flavor in flavors() { + let baseline = Scheme::baseline(flavor); + let sky = DEFAULT_CARD.scheme(flavor); + for (role, got) in sky.iter() { + assert_eq!( + got, + baseline.get(role), + "天蓝卡（出厂默认）的 {} / {} 变了：{} → {}", + role.name(), + flavor.name(), + baseline.get(role).to_hex(), + got.to_hex() + ); + } + } +} + +/// 八张卡的 `surface` 共用同一个中性调色板：色相一致（±1°）、彩度落在窄带（±1.5）。 +#[test] +fn preset_cards_share_one_neutral_hue_and_chroma() { + for flavor in flavors() { + let hcts: Vec<(&str, Hct)> = CARDS + .iter() + .map(|card| { + ( + card.key, + Hct::from_color(card.scheme(flavor).get(Role::Surface)), + ) + }) + .collect(); + let reference = hcts[0].1; + for (key, hct) in &hcts { + assert!( + hue_gap(hct.hue, reference.hue) <= 1.0, + "{key} / {} 的 surface 色相 {:.2}° 偏离基线 {:.2}° 超过 ±1°", + flavor.name(), + hct.hue, + reference.hue + ); + assert!( + (hct.chroma - reference.chroma).abs() <= 1.5, + "{key} / {} 的 surface 实测彩度 {:.2} 偏离基线 {:.2} 超过 ±1.5", + flavor.name(), + hct.chroma, + reference.chroma + ); + } + // 更强的口径：八张卡的 surface 是**同一个色值**（不只是「相近」）。 + let surfaces: Vec = CARDS + .iter() + .map(|card| card.scheme(flavor).get(Role::Surface).to_hex()) + .collect(); + assert!( + surfaces.iter().all(|hex| hex == &surfaces[0]), + "{} 模式下八张卡的 surface 不再逐值相同：{surfaces:?}", + flavor.name() + ); + } +} + +/// 反证：上面那条断言**量得出**问题。改前的路径浅色档彩度差 9 倍，改成固定中性后只剩 1 倍。 +/// +/// 没有这条的话，「±1.5 的带宽」只是一句自我声明：谁把断言写松（比如改成 ±20）， +/// `preset_cards_share_one_neutral_hue_and_chroma` 照样绿，而窗口又开始逐卡染色。 +/// +/// ⚠️ **9 倍差只出现在浅色档**：tone 98（近白）的暖相色域装不下彩度 12，rose 只兑现到 1.29； +/// 深色档的 tone 6 反而每张卡都装得下（11.63~12.45，只差 1.07 倍）。深色档的问题不是彩度， +/// 而是**色相**（14.66°~300.57°，整整一个色环）——它在深底上表现为「有的卡偏紫、有的偏绿」。 +/// 所以两个模式的反证分开断言，别用一条 `> 8` 覆盖两个模式（那样深色档会红，且说不清为什么）。 +#[test] +fn the_old_per_card_tinting_really_was_a_ninefold_gap() { + let surface_hct = |scheme: &dyn Fn(Card) -> Scheme| { + CARDS + .iter() + .map(|card| Hct::from_color(scheme(*card).get(Role::Surface))) + .collect::>() + }; + let chroma_ratio = |hcts: &[Hct]| { + let max = hcts.iter().map(|h| h.chroma).fold(f64::MIN, f64::max); + let min = hcts.iter().map(|h| h.chroma).fold(f64::MAX, f64::min); + max / min + }; + let hue_span = |hcts: &[Hct]| { + // 色相是环：这里只关心「跨了多少」，用最大凸包跨度（简单排序后首尾差）就够粗判。 + let mut hues: Vec = hcts.iter().map(|h| h.hue).collect(); + hues.sort_by(|a, b| a.partial_cmp(b).expect("有限色相")); + hues[hues.len() - 1] - hues[0] + }; + + // 浅色档：彩度 9 倍差（改前）→ 1 倍（改后）。 + let old_light = surface_hct(&|card| before_d43(card, SchemeFlavor::Light)); + assert!( + chroma_ratio(&old_light) > 8.0, + "改前（浅色）的 surface 彩度差应当能量出「9 倍级」跳变，实测 {:.2} 倍——\ + 这条反证已经失效，上面的 ±1.5 带宽就不可信了", + chroma_ratio(&old_light) + ); + let new_light = surface_hct(&|card| card.scheme(SchemeFlavor::Light)); + assert!( + chroma_ratio(&new_light) < 1.5, + "固定中性后（浅色）八张卡的 surface 彩度差还有 {:.2} 倍", + chroma_ratio(&new_light) + ); + + // 深色档：彩度本来就一致，问题是色相跨了整个环 → 改后色相跨度收敛到 0。 + let old_dark = surface_hct(&|card| before_d43(card, SchemeFlavor::Dark)); + assert!( + hue_span(&old_dark) > 180.0, + "改前（深色）的 surface 色相应当横跨大半个色环，实测 {:.2}°", + hue_span(&old_dark) + ); + assert!( + chroma_ratio(&old_dark) < 1.5, + "改前（深色）的彩度本来就一致（tone 6 装得下彩度 12），实测 {:.2} 倍", + chroma_ratio(&old_dark) + ); + let new_dark = surface_hct(&|card| card.scheme(SchemeFlavor::Dark)); + assert!( + hue_span(&new_dark) < 1.0, + "改后（深色）色相跨度 {:.2}°", + hue_span(&new_dark) + ); + assert!(chroma_ratio(&new_dark) < 1.5); +} + +/// 换卡只换强调族：不随强调色变的角色必须逐值相同，强调族必须真的换。 +/// +/// 「哪些角色属于强调族」不靠手抄清单，而是**实测**：拿另一个强调色再生成一套方案，值会变的 +/// 那些角色就是强调族（primary/secondary/tertiary 全族 + `surface-tint` + `inverse-primary` + +/// 12 个 `*-fixed*` = 26 个），不随强调色变的 23 个（中性表面、描边、error、shadow/scrim） +/// 则必须留在基线——这样将来往 tone 表里加角色也不会漏掉分类。 +/// +/// ⚠️ 浅色档只有 **23** 个会变：`on-primary` / `on-secondary` / `on-tertiary` 的 tone 是 100， +/// 任何色相都解析成纯白，所以强调色换了它们也不变（深色档的 tone 是 20，会变）。 +#[test] +fn cards_only_change_the_accent_families() { + for flavor in flavors() { + let baseline = Scheme::baseline(flavor); + let recolored = Scheme::from_accent(flavor, CardKey::Teal.card().seed); + let (mut accent_roles, mut neutral_roles) = (Vec::new(), Vec::new()); + for role in Role::ALL { + if recolored.get(role) == baseline.get(role) { + neutral_roles.push(role); + } else { + accent_roles.push(role); + } + } + assert_eq!( + (accent_roles.len(), neutral_roles.len()), + if flavor.is_dark() { (26, 23) } else { (23, 26) }, + "强调族 / 中性族的划分变了（{} 模式下换强调色会动 {} 个）", + flavor.name(), + accent_roles.len() + ); + + let sky = DEFAULT_CARD.scheme(flavor); + for card in CARDS { + let scheme = card.scheme(flavor); + for role in &neutral_roles { + assert_eq!( + scheme.get(*role), + sky.get(*role), + "{} / {} 的 {}（不随强调色变的角色）不该跟着卡变", + card.key, + flavor.name(), + role.name() + ); + } + if card.key != DEFAULT_CARD.key { + assert_ne!( + scheme.get(Role::Primary), + sky.get(Role::Primary), + "{} / {} 的主色与天蓝卡相同：卡没生效", + card.key, + flavor.name() + ); + } + } + } +} + +/// 卡方案 = 用该卡种子做「自定义强调色」：中性表面留在基线，强调族与官方 `from_seed` 对得上。 +/// +/// 这条把 D43 接到已有的 `tests/official_accent.rs`（192 项官方对账）上：色卡的强调族不是 +/// 另一套算法，就是那条已经对过账的路径。 +#[test] +fn card_scheme_matches_from_accent_when_chroma_is_the_default() { + for card in CARDS { + if card.neutral_chroma != DEFAULT_NEUTRAL_CHROMA { + continue; // 将来的卡可以带别的中性彩度；那时它的表面色与 baseline 不同是有意的 + } + for flavor in flavors() { + assert_eq!( + card.scheme(flavor), + Scheme::from_accent(flavor, card.seed), + "{} / {} 的色卡方案与 from_accent 不一致", + card.key, + flavor.name() + ); + } + } +} + +/// 动态路径的守护测试（D38/D43）：同一张图，**两张不同色卡下强调色相同、底色由图像 seed 决定**。 +/// +/// 谁把取色路径也改成固定中性，这条立刻红：那时两张卡的 `surface` 会变成同一个冷白色， +/// 而图像种子的色相（红相 ~22°）会从表面色上消失。 +#[test] +fn image_scheme_ignores_the_preset_neutral_hue() { + // 4×4 纯 `#B23A48`（rose 卡的种子色）——色相远离固定的 239.5°，好坏都能分辨。 + let pixels = [0xB2u8, 0x3A, 0x48, 0xFF].repeat(16); + let seed = unlucky_design::palette::seed_from_rgba(&pixels, 4, 4).expect("纯色图有种子"); + + let cards = [CardKey::Sky.card(), CardKey::Teal.card()]; + let schemes: Vec = cards + .iter() + .map(|card| seed.scheme(SchemeFlavor::Light, card.neutral_chroma)) + .collect(); + + assert_eq!( + schemes[0].get(Role::Primary), + schemes[1].get(Role::Primary), + "取色方案的主色只由图像种子决定，不该跟着当前色卡变" + ); + assert_eq!( + schemes[0].get(Role::Surface), + schemes[1].get(Role::Surface), + "取色方案的底色由图像种子决定（当前八张卡的中性彩度相同，所以两套方案的表面色相同）" + ); + let surface_hue = Hct::from_color(schemes[0].get(Role::Surface)).hue; + // 精确口径：中性**调色板**的色相必须来自图像种子（不是量化后的表面色——tone 98 的 + // 8 bit 量化会让实测色相漂 2.7°~7°，见模块文档；拿它做等式断言只会引入假红）。 + for card in cards { + let neutral_hue = seed.palettes(card.neutral_chroma).neutral.hue_deg(); + assert!( + (neutral_hue - seed.hue).abs() < 1.0e-9, + "取色路径的中性色相 {neutral_hue:.2}° 没有跟着图像种子 {:.2}° 走", + seed.hue + ); + assert!( + hue_gap(neutral_hue, NEUTRAL_HUE_DEG) > 100.0, + "取色路径的中性色相被拉到了色卡的固定中性色相——动态路径的逐色染色被弄丢了（D43 保留它）" + ); + } + // 观感层：实测的表面色相明显靠近图像种子，而不是靠色卡的冷调中性色相。 + assert!( + hue_gap(surface_hue, seed.hue) < hue_gap(surface_hue, NEUTRAL_HUE_DEG), + "取色方案的 surface 色相 {surface_hue:.2}° 更接近色卡中性色相而不是图像种子 {:.2}°", + seed.hue + ); + for card in cards { + assert_ne!( + schemes[0].get(Role::Surface), + card.scheme(SchemeFlavor::Light).get(Role::Surface), + "取色方案的表面色与色卡路径相同，说明取色路径没在按图染色" + ); + } +} + +/// 8 张卡 × 浅/深 × 26 对：换中性色相后仍全部过 WCAG AA（`wcag::check` 全表）， +/// 并把最受中性色相影响的一对（on-surface / surface）钉在实测量级上。 +#[test] +fn every_card_scheme_meets_wcag_aa_under_the_fixed_neutral() { + for card in CARDS { + for flavor in flavors() { + let scheme = card.scheme(flavor); + assert!( + card_scheme_is_readable(card, flavor), + "{} / {} 未过 WCAG AA 全表（{} 对逐对断言在 `palette::wcag::check`）", + card.key, + flavor.name(), + TEXT_PAIRS.len() + ); + // 中性色相变了，最受影响的一对是 on-surface / surface（改前逐卡 16.23~16.44 浅 / + // 14.30~14.42 深）。改后八张卡同一个底色，这一对也逐卡相同，钉住量级免得漂移。 + let body = scheme.contrast(Role::OnSurface, Role::Surface); + assert!( + (16.30..=16.40).contains(&body) || (14.28..=14.36).contains(&body), + "{} / {}：on-surface/surface = {body:.3}，超出实测区间 \ + （浅 16.30~16.40 / 深 14.28~14.36）", + card.key, + flavor.name() + ); + } + } +} + +/// 出图脚本读的 hex 行（改前 + 改后并排），跑法： +/// `cargo test -p unlucky-design --test card_neutral -- --nocapture`。 +/// +/// 格式 `CARD|key|flavor|before|role=hex;role=hex;…`（承接那张「8 张卡 surface 色块并排 + +/// 切 sky→teal 窗口底色」的验收图；渲染脚本 `/d/tmp/m88/render.py` 只做排版，数据全在这里）。 +#[test] +fn dump_card_palette_for_the_color_card() { + const SHOWN: [Role; 10] = [ + Role::Surface, + Role::OnSurface, + Role::OnSurfaceVariant, + Role::SurfaceVariant, + Role::SurfaceContainer, + Role::SurfaceContainerHigh, + Role::Outline, + Role::Primary, + Role::OnPrimary, + Role::PrimaryContainer, + ]; + for card in CARDS { + for flavor in flavors() { + for (tag, scheme) in [ + ("before", before_d43(card, flavor)), + ("after", card.scheme(flavor)), + ] { + let pairs: Vec = SHOWN + .iter() + .map(|role| format!("{}={}", role.name(), scheme.get(*role).to_hex())) + .collect(); + println!( + "CARD|{}|{}|{tag}|{}", + card.key, + flavor.name(), + pairs.join(";") + ); + } + } + } +}