Unlucky-Launcher/crates/design/src/component_map/tests.rs

//! `component_map` 的守门测试：表槽位 ↔ 枚举次序、官方高程/形状、圆角分层（D32）、微度量入口。
//!
//! 拆成独立文件是为了让 `mod.rs` 留出文档空间（项目硬约束：单文件 ≤400 行）。

use super::*;

#[test]
fn table_matches_component_order() {
    for (i, spec) in table::SPECS.iter().enumerate() {
        assert_eq!(
            spec.component as usize, i,
            "SPECS 第 {i} 行顺序与枚举不一致"
        );
    }
}

#[test]
fn every_component_resolves() {
    assert_eq!(Component::ALL.len(), table::SPECS.len());
    for component in Component::ALL {
        let spec = component.spec();
        assert_eq!(spec.component, component);
        assert!(spec.text.style().size_px >= 11.0);
    }
}

#[test]
fn names_are_unique() {
    let mut seen = std::collections::BTreeSet::new();
    for component in Component::ALL {
        assert!(
            seen.insert(component.name()),
            "组件名重复：{}",
            component.name()
        );
    }
}

#[test]
fn elevation_matches_official_component_tokens() {
    // A 级来源（androidx.compose.material3.tokens）：
    //   FilledCardTokens/OutlinedCardTokens.ContainerElevation = Level0
    //   MenuTokens.ContainerElevation = Level2
    //   DialogTokens.ContainerElevation = Level3
    //   SnackbarTokens.ContainerElevation = Level3
    //   AppBarTokens = Level0、ListTokens.ItemContainerElevation = Level0
    // 偏离只允许出现在有登记的地方（Tooltip 是 B 级：token 文件里没有 Elevation 行）。
    for (component, expect) in [
        (Component::FilledCard, Elevation::Level0),
        (Component::OutlinedCard, Elevation::Level0),
        (Component::Menu, Elevation::Level2),
        (Component::Dialog, Elevation::Level3),
        (Component::Snackbar, Elevation::Level3),
        (Component::TopAppBar, Elevation::Level0),
        (Component::ListItem, Elevation::Level0),
        (Component::TextField, Elevation::Level0),
    ] {
        assert_eq!(
            component.spec().elevation,
            expect,
            "{} 的高程与官方组件令牌不一致",
            component.name()
        );
    }
    // R4「全屏都在飘」的守门：一屏常见元素里带阴影（>Level0）的只允许是浮层。
    for component in Component::ALL {
        if component.spec().elevation > Elevation::Level0 {
            assert!(
                matches!(
                    component,
                    Component::Menu | Component::Dialog | Component::Snackbar | Component::Tooltip
                ),
                "{} 不该有阴影（只有浮层允许）",
                component.name()
            );
        }
    }
}

#[test]
fn shapes_match_official_component_tokens() {
    // 官方：卡片 CornerMedium(12)、对话框 CornerExtraLarge(28)、菜单 CornerExtraSmall(4)、
    // 按钮/导航指示条 CornerFull、chip CornerSmall(8)。
    assert_eq!(Component::FilledCard.spec().shape, ShapeScale::Medium);
    assert_eq!(Component::OutlinedCard.spec().shape, ShapeScale::Medium);
    assert_eq!(Component::Dialog.spec().shape, ShapeScale::ExtraLarge);
    assert_eq!(Component::Menu.spec().shape, ShapeScale::ExtraSmall);
    assert_eq!(Component::PrimaryButton.spec().shape, ShapeScale::Full);
    assert_eq!(Component::Chip.spec().shape, ShapeScale::Small);
}

#[test]
fn only_primary_actions_use_filled_emphasis_and_one_dialog_layer() {
    // 契约 §1：状态色不复用 accent、每屏最多一个实心 accent → 只有 primary-button 是
    // 「实心强调」，其余按钮的形态由页面决定但不能是 Full + Level0 + Emphasized 的组合。
    let primary = Component::PrimaryButton.spec();
    assert_eq!(primary.shape, ShapeScale::Full);
    assert_eq!(primary.text, TypeRole::LabelLarge);
    // 浮层类必须比卡片层高。
    assert!(Component::Dialog.spec().elevation > Component::OutlinedCard.spec().elevation);
    assert!(Component::Menu.spec().elevation > Component::FilledCard.spec().elevation);
}

#[test]
fn morphs_always_expand_upwards() {
    for component in Component::ALL {
        if let Some(morph) = component.spec().morph {
            assert_ne!(
                morph.from,
                morph.to,
                "{} 的形变起止不能相同",
                component.name()
            );
            // 方向必须「沿阶梯胀开」（morph 对 `Full` 也没问题，rank 把它排在末尾），
            // 不比较像素跨度：`Full` 的半径依赖边长，用固定边长比会被 `None` 之外的大档拉爆。
            assert!(
                morph.from.rank() < morph.to.rank(),
                "{} 的形变方向反了：{:?} → {:?}",
                component.name(),
                morph.from,
                morph.to
            );
        }
    }
}

#[test]
fn appended_variants_keep_the_frozen_order() {
    // 枚举冻结为「只可末尾追加」：前 20 个的次序不能动（M69 只在末尾加 5 个）。
    assert_eq!(Component::ALL.len(), 25);
    assert_eq!(Component::ALL[0], Component::TopAppBar);
    assert_eq!(Component::ALL[19], Component::EmptyState);
    assert_eq!(Component::ALL[20], Component::Checkbox);
    assert_eq!(Component::ALL[24], Component::Divider);
    for (i, component) in Component::ALL.iter().enumerate() {
        assert_eq!(*component as usize, i, "ALL 的次序与枚举判别值不一致");
    }
}

#[test]
fn micro_radius_only_on_micro_controls() {
    // D32：微半径只能给 ≤24dp 的微控件，且此时 `shape` 必须是占位 None（不参与渲染）。
    let mut owners = Vec::new();
    for component in Component::ALL {
        let spec = component.spec();
        let Some(radius) = spec.micro_radius else {
            continue;
        };
        owners.push(component);
        assert_eq!(radius, ComponentRadius::Micro, "白名单外的微半径不许过表");
        assert_eq!(
            spec.shape,
            ShapeScale::None,
            "{} 有微半径时 shape 必须占位 None（2dp 不在刻度里）",
            component.name()
        );
        let metrics = component
            .metrics()
            .expect("带微半径的组件必须有 ComponentMetrics");
        assert!(
            metrics.width <= crate::shape::MICRO_CONTROL_MAX_SIZE
                && metrics.height <= crate::shape::MICRO_CONTROL_MAX_SIZE,
            "{} 超出微控件尺寸上限",
            component.name()
        );
        assert_eq!(
            radius.radius_px(metrics.width),
            Some(radius.dp()),
            "{} 的微半径按自身尺寸取不到",
            component.name()
        );
    }
    assert_eq!(
        owners,
        vec![Component::Checkbox],
        "当前只允许 Checkbox 用微半径"
    );
}

#[test]
fn metrics_resolve_only_for_controls_with_inner_geometry() {
    for component in [
        Component::Checkbox,
        Component::Radio,
        Component::Search,
        Component::NavigationDrawer,
    ] {
        assert!(
            component.metrics().is_some(),
            "{} 缺 ComponentMetrics",
            component.name()
        );
    }
    // Divider 只有厚度，而厚度是一像素线（LM），不该出现在 CM 里。
    assert!(Component::Divider.metrics().is_none());
    // 骨架级尺寸不许在 CM 里重复一份（Single Source of Truth）。
    for component in [Component::Search, Component::NavigationDrawer] {
        let metrics = component.metrics().unwrap();
        assert_eq!(metrics.width, 0.0, "{} 的宽度属骨架级", component.name());
        assert_eq!(metrics.height, 0.0, "{} 的高度属骨架级", component.name());
    }
}