diff --git a/crates/design/src/color/mod.rs b/crates/design/src/color/mod.rs index 4e14e9d..c0309d4 100644 --- a/crates/design/src/color/mod.rs +++ b/crates/design/src/color/mod.rs @@ -51,27 +51,37 @@ //! tertiary 三族，中性色与 error 保持基线。强调族的色值与官方 `from_seed(accent)` 逐个对得上 //! （`tests/official_accent.rs`，8 个种子 × 12 个强调族角色 × 2 模式 = 192 项）。 //! -//! ## 出厂默认色（M70：浅冷天蓝）——含一处**有意偏离** +//! ## 出厂默认色（M70：浅冷天蓝）——含**两处**有意偏离（同一处偏离的两半） //! //! 产品默认不走官方紫，而是「浅冷天蓝」。默认值收在两个常量里，**换默认只改这两行** //! （用户 2026-11-01 拍板采用候选 **④ 天蓝**；③ 浅冷天蓝 `#87CEEB` 留作备选，值仍 pin 在 //! `tests/skyseed_candidates.rs`）： //! -//! | 常量 | 当前值 | 官方值 | 说明 | +//! | 项 | 当前值 | 官方值 | 说明 | //! |---|---|---|---| //! | [`palettes::DEFAULT_SEED`] | `#3C8DBC`（CAM16 hue ≈ 240°） | `#6750A4`（[`palettes::BASELINE_SEED`]） | 种子只贡献**色相**（CAM16 240°）；种子彩度会被 Tonal Spot 丢掉 | -//! | [`palettes::DEFAULT_NEUTRAL_CHROMA`] | `12` | `6` | 让 surface / surface-container-* 带淡蓝调 | +//! | [`palettes::DEFAULT_NEUTRAL_CHROMA`]（neutral） | `12` | `6` | 让 surface / surface-container-* 带淡蓝调 | +//! | 联动的 neutral-variant | `14` | `8`（**绝对值**；官方不是「neutral + 2」） | `outline` / `outline-variant` / `surface-variant` 一起偏蓝（light `outline` = `#6A7985` 就是 14 彩度的口径） | //! //! **定位（D38）**：这套默认只是「**莫奈关闭时的出厂预选色卡**」（首次启动、用户还没选过色卡时 //! 用的那一套），**不是唯一的配色来源**。用户的配色来源有三级优先：① 启动器背景图取色（Monet） //! → ② 桌面壁纸取色 → ③ 莫奈关闭（默认）时从内置多套色卡里选。取色与「内置色卡库」都不在本 crate， //! 也还没实现；本模块只负责「给定一个种子 + 中性彩度，派生出 49 个角色」。 //! -//! > ⚠️ **有意偏离登记**：中性彩度 6 → 12 是对官方 Tonal Spot 的偏离，理由＝产品要「浅冷」的冷调表面。 -//! > 官方 6 的表面几乎无色，单靠换种子做不到「浅」——因为 primary 的 tone 被官方钉在 40， -//! > 种子再浅主色也还是中蓝；**「浅」只能落在中性色上**。除这一处外全部走官方常数 -//! > （primary 36 / secondary 16 / tertiary 24 且色相 +60° / neutral-variant = neutral + 2 / -//! > error 25°·84），tone 表与 gamut 映射一行未动。 +//! > ⚠️ **有意偏离登记（两处，同一处偏离的两半）**： +//! > +//! > 1. **neutral 彩度 `6 → 12`**。理由＝产品要「浅冷」的冷调表面：官方 6 的表面几乎无色，单靠换 +//! > 种子做不到「浅」——primary 的 tone 被官方钉在 40，种子再浅主色也还是中蓝，所以「浅」只能 +//! > 落在中性色上。 +//! > 2. **neutral-variant 彩度 `8 → 14`**。这是第 1 条的连带结果：官方 +//! > `getNeutralVariantPalette` 写死的是**绝对值 8**（不是「neutral + 2」这种相对式）， +//! > 本实现为了让层次不倒挂，让它跟着 neutral 联动（`nv = neutral + 2`）。若把 nv 钉回 8， +//! > 表面（12）会比中性变体（8）更「有色」，破坏官方的「neutral < neutral-variant」层次。 +//! > 影响面不只表面：`outline` / `outline-variant` / `surface-variant` 三个角色一起偏蓝。 +//! > +//! > 除这两处外全部走官方常数（primary 36 / secondary 16 / tertiary 24 且色相 +60° / +//! > error 25°·84），tone 表与 gamut 映射一行未动；[`Scheme::official_baseline`] 仍是官方的 +//! > 6（neutral）/ 8（neutral-variant）口径。 //! //! 官方口径的锚点仍然完整保留：[`Scheme::official_baseline`]（种子 `#6750A4` + 中性 6） //! 是 `tests/official_baseline.rs` 的对账入口，98 项仍是每通道 ≤1； @@ -86,7 +96,7 @@ //! - 所有 `on-*` 与其承载色（`*-container`、`primary`、`surface`）都满足 **≥ 4.5:1**； //! 这一条由 `tests/contrast_aa.rs` 全表验证，且因为 tone 轴固定，**换任何种子色都成立** //! （WCAG 对比度只取决于相对亮度，而 tone 直接钉住 `L*`；中性彩度同理， -//! `sky_seed_candidates_meet_wcag_aa` 逐档验证了 M70 的三档候选）。 +//! `sky_seed_candidates_meet_wcag_aa` 逐档验证了 M70 的四档候选：4 档 × 2 模式 × 26 对 = 208 项）。 //! - 例外（显式登记，非缺陷）： //! - [`Role::Outline`] 对 [`Role::Surface`]：M3 定义的**非文字**元素（输入框描边）， //! 目标 3:1，实测 light 4.26:1 / dark 5.89:1； diff --git a/crates/design/src/color/palettes.rs b/crates/design/src/color/palettes.rs index 818da50..6b78e49 100644 --- a/crates/design/src/color/palettes.rs +++ b/crates/design/src/color/palettes.rs @@ -48,8 +48,11 @@ pub const DEFAULT_SEED: Color = Color::rgb(0x3C, 0x8D, 0xBC); /// /// 官方 6 让表面几乎无色；12 让 surface / surface-container-* 带一层淡蓝调， /// 这是「浅冷天蓝」唯一能落在表面上的手段（primary 的 tone 被官方钉在 40， -/// 种子再浅也变不成浅蓝）。安全区间 6..=12：neutral-variant = neutral + 2， -/// 超过 13 会顶到 secondary 的 16，破坏「neutral < neutral-variant < secondary」。 +/// 种子再浅也变不成浅蓝）。 +/// +/// **数值安全区间 `6..=13`，产品取 12**：neutral-variant 跟 neutral 联动（`nv = neutral + 2`）， +/// 13 时 nv = 15 仍低于 secondary 的 16；**14 才会撞上**（nv = 16 = secondary），届时要一并改 +/// `NEUTRAL_VARIANT_OFFSET`（私有常量）的规则。nv 的那一半偏离见 `color` 模块文档的偏离登记。 /// /// 同样只服务于「出厂预选色卡」（D38 第三级），不约束将来的取色结果。将来若做「内置多套色卡」， /// 每套色卡各带自己的中性彩度更合适——本常量到时候会退化成「默认那套的取值」。 @@ -80,7 +83,12 @@ const SECONDARY_CHROMA: f64 = 16.0; const TERTIARY_CHROMA: f64 = 24.0; /// 官方 Tonal Spot 的 neutral 彩度（几乎是灰）。产品默认用 [`DEFAULT_NEUTRAL_CHROMA`]。 const TONAL_SPOT_NEUTRAL_CHROMA: f64 = 6.0; -/// neutral-variant 相对 neutral 的彩度偏移（官方 6 → 8，即 +2）。 +/// neutral-variant 相对 neutral 的彩度偏移。 +/// +/// ⚠️ 官方 `getNeutralVariantPalette` 写死的是**绝对值 8**，**不是**「neutral + 2」这种相对式； +/// 本实现选择让 neutral-variant 随 neutral 联动，于是产品默认（neutral 12）取到 **14**。 +/// 这是**有意偏离**的另一半（见 `color` 模块文档的偏离登记），不是官方口径—— +/// 官方的 6 / 8 由 [`Palettes::official_baseline`] 原样保留。 const NEUTRAL_VARIANT_OFFSET: f64 = 2.0; /// error 的色相（HCT 红相）。 const ERROR_HUE_DEG: f64 = 25.0; @@ -128,9 +136,17 @@ impl Palettes { /// 从一个种子色派生，并显式指定中性调色板彩度（`6.0` 即官方 Tonal Spot）。 /// - /// 除 neutral 外**全部走官方常数**：primary 恒定 36、secondary 16、tertiary 24（色相 +60°）、 - /// neutral-variant = neutral + 2、error 固定 25°/84。所以这条入口不绕算法， - /// 只是把「官方写死在 `getNeutralPalette` 里的那一个数」变成参数。 + /// ⚠️ **调用方负责传 `6.0..=13.0`（产品取 12）**。本函数**不做范围校验**，越界的表现是 + /// 静默退化而不是 panic： + /// - `neutral_chroma < 0` 或 `NaN` → 彩度被夹到 0（`TonalPalette::new` 里 `.max(0.0)`）， + /// 得到一套纯灰的表面（surface ≈ `#F9F9F9`），**不报错**； + /// - `neutral_chroma >= 14` → neutral-variant（= neutral + 2）够到甚至超过 secondary 的 16， + /// 「中性 < 中性变体 < 次色」的层次被破坏（描边会明显发蓝）。 + /// + /// 除 neutral / neutral-variant 外**全部走官方常数**：primary 恒定 36、secondary 16、 + /// tertiary 24（色相 +60°）、error 固定 25°/84。所以这条入口不绕算法，只是把「官方写死在 + /// `getNeutralPalette` / `getNeutralVariantPalette` 里的那两个数」变成可调入参 + /// （neutral-variant 这里取相对式 `neutral + 2`，属**有意偏离**，见 `NEUTRAL_VARIANT_OFFSET`）。 pub fn from_seed_with_neutral_chroma(seed: Color, neutral_chroma: f64) -> Self { let hue = super::Hct::from_color(seed).hue; Self::tonal_spot(hue, neutral_chroma) @@ -231,6 +247,28 @@ mod tests { } } + #[test] + fn product_default_neutral_chroma_is_a_registered_deviation() { + // 官方 neutral / neutral-variant 是 6 / 8；产品默认是 12 / 14。 + // 这**不是官方口径**，是「有意偏离」（见 `color` 模块文档的偏离登记）。 + // 想把 nv 拉回官方绝对值 8 的人，请先改登记再改这里：直接钉成 8 会让表面（12） + // 比中性变体（8）更「有色」，破坏官方的 neutral < neutral-variant 层次。 + let product = Palettes::baseline(); + assert_eq!(product.neutral.chroma(), 12.0, "产品默认 neutral 彩度"); + assert_eq!( + product.neutral_variant.chroma(), + 14.0, + "产品默认的 neutral-variant 彩度 14 是**有意偏离**（官方绝对值 8），改前先更新偏离登记" + ); + let official = Palettes::official_baseline(); + assert_eq!(official.neutral.chroma(), 6.0, "官方锚点仍是 6"); + assert_eq!( + official.neutral_variant.chroma(), + 8.0, + "官方锚点仍是绝对值 8（不是 neutral + 2 的相对式）" + ); + } + #[test] fn baseline_hue_comes_from_the_seed() { let palettes = Palettes::official_baseline(); diff --git a/crates/design/src/lib.rs b/crates/design/src/lib.rs index c4c2388..0eeb1de 100644 --- a/crates/design/src/lib.rs +++ b/crates/design/src/lib.rs @@ -112,7 +112,11 @@ pub struct DesignTokens { } impl DesignTokens { - /// 按模式给一套出厂令牌（baseline seed `#6750A4`，等价 M3 baseline 调色板）。 + /// 按模式给一套**产品默认**令牌：种子 `#3C8DBC`（M70 ④ 天蓝，用户 2026-11-01 拍板） + /// + 中性彩度 12，即 `color::palettes::DEFAULT_SEED` / `DEFAULT_NEUTRAL_CHROMA`。 + /// + /// 想要**官方 M3 baseline** 口径（种子 `#6750A4` + 中性彩度 6 / neutral-variant 8）请走 + /// `color::Scheme::official_baseline(flavor)`——两条路径的算法完全相同，只差入参。 pub fn baseline(flavor: SchemeFlavor) -> Self { Self { flavor, diff --git a/crates/design/tests/skyseed_candidates.rs b/crates/design/tests/skyseed_candidates.rs index 4c78944..22744f3 100644 --- a/crates/design/tests/skyseed_candidates.rs +++ b/crates/design/tests/skyseed_candidates.rs @@ -246,21 +246,50 @@ fn the_candidates_are_actually_distinguishable() { fn product_default_is_the_adopted_candidate() { // 用户 2026-11-01 拍板采用 **④ 天蓝**。这条用例就是「默认值 ↔ 候选表」的绑定器： // 谁改了 `DEFAULT_SEED`/`DEFAULT_NEUTRAL_CHROMA` 却没同步这里（或反过来），它会立刻红。 + // 断言一律比 **hex / 数值**，这样失败信息里直接能读到「期望 ④、实测几」。 let adopted = &CANDIDATES[3]; assert_eq!( - DEFAULT_SEED, - Color::from_hex(adopted.seed_hex).expect("合法 hex"), - "DEFAULT_SEED 与已采用的档 {}", - adopted.tag + DEFAULT_SEED.to_hex(), + "#3C8DBC", + "DEFAULT_SEED 必须仍是已采用的 ④ 天蓝：期望 #3C8DBC（④），实测 {}（{}）", + DEFAULT_SEED.to_hex(), + if DEFAULT_SEED.to_hex() == CANDIDATES[2].seed_hex { + "③ 浅冷蓝——要改回 ③ 请连偏离登记与 pin 一起改" + } else { + "不是候选表里的任何一个种子" + } + ); + assert_eq!( + DEFAULT_SEED.to_hex(), + adopted.seed_hex, + "DEFAULT_SEED（{}）与已采用档 {} 的种子（{}）不一致", + DEFAULT_SEED.to_hex(), + adopted.tag, + adopted.seed_hex + ); + assert_eq!( + DEFAULT_NEUTRAL_CHROMA, 12.0, + "DEFAULT_NEUTRAL_CHROMA 必须仍是已采用的 12，实测 {}", + DEFAULT_NEUTRAL_CHROMA + ); + assert_eq!( + DEFAULT_NEUTRAL_CHROMA, adopted.neutral_chroma, + "DEFAULT_NEUTRAL_CHROMA（{}）与已采用档 {} 的中性彩度（{}）不一致", + DEFAULT_NEUTRAL_CHROMA, adopted.tag, adopted.neutral_chroma ); - assert_eq!(DEFAULT_NEUTRAL_CHROMA, adopted.neutral_chroma); for flavor in [SchemeFlavor::Light, SchemeFlavor::Dark] { - assert_eq!( - Scheme::baseline(flavor), - scheme(adopted, flavor), - "产品默认（Scheme::baseline）必须等于已采用档的派生结果（{}）", - flavor.name() - ); + let product = Scheme::baseline(flavor); + let expected = scheme(adopted, flavor); + for (role, got) in product.iter() { + assert_eq!( + got.to_hex(), + expected.get(role).to_hex(), + "产品默认与已采用档 {} 的 {}（{} 模式）不一致", + adopted.tag, + role.name(), + flavor.name() + ); + } } }