//! 左侧导航轨（M3 `NavigationRail`）。
//!
//! 判据来源 `research/12b-component-fidelity.md` §5：
//!
//! | 项 | 参考值 | 令牌落点 |
//! |---|---|---|
//! | 轨宽 | 5.1 官方 96（narrow 80）；本项目 **88** | [`nav_rail_width`]（`LayoutMetrics` 骨架值，详见该函数文档的 M69 迁移说明） |
//! | 轨容器 | 5.3 形状 None / L0 / `Surface` | `MaterialLayer::Canvas` |
//! | 选中指示器 | 5.4 **56×32**、圆角 full、`SecondaryContainer` | [`indicator_size`]（令牌推导） |
//! | 图标 | 5.5 24px | `IconSize::Toolbar` |
//! | 标签 | 5.5 `LabelMedium 12/16` | `TypeRole::LabelMedium` |
//! | 颜色 | 5.6 选中图标 `OnSecondaryContainer` / 选中标签 `Secondary` / 未选中 `OnSurfaceVariant` | `Ui::color` |
//! | 项间距 | 5.7 **4** | `LayoutMetrics::nav_item_gap` |

use iced::widget::{button, column, container};
use iced::{
    Alignment, Background, Border, Color, Element, Length, Padding, Shadow, Theme as IcedTheme,
};

use unlucky_design::color::Role;
use unlucky_design::elevation::MaterialLayer;
use unlucky_design::icons::IconKind;
use unlucky_design::shape::ShapeScale;
use unlucky_design::spacing::{LayoutMetrics, Space};
use unlucky_design::typography::TypeRole;
use unlucky_i18n::{Key, Lang};

mod account;

pub use account::RailAccount;

use account::account_item;

use crate::app::components::interaction::{self, Interaction};
use crate::app::Message;
use crate::cli::ForcedState;
use crate::icons;
use crate::shell::{filled, label, overridden};
use crate::theme::Ui;

/// 导航占位项（任务要求 4~6 个；真正的页面由后续 mission 接管）。
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum NavItem {
    /// 实例列表。
    Instances,
    /// 版本管理（显示名；变体名按用户令「只改显示层」不改，标识符改名后置）。
    Download,
    /// 日志。
    Logs,
    /// 设置。
    Settings,
    /// AI 助手。
    Ai,
    /// 账户页（**不进主序列**：入口是轨底的头像位，见 [`RailAccount`]）。
    Account,
}

impl NavItem {
    /// 全部**主序列**项（顺序 = 导航栏自上而下）。账户不在其中：它固定贴在轨底。
    pub const ALL: [NavItem; 5] = [
        NavItem::Instances,
        NavItem::Download,
        NavItem::Logs,
        NavItem::Settings,
        NavItem::Ai,
    ];

    /// 显示名的 key（M106 起走 catalog；两套目录都有词由 `catalog` 的完整性测试守）。
    pub const fn label_key(self) -> Key {
        match self {
            NavItem::Instances => Key::NavInstances,
            NavItem::Download => Key::NavDownload,
            NavItem::Logs => Key::NavLogs,
            NavItem::Settings => Key::NavSettings,
            NavItem::Ai => Key::NavAi,
            // M114：轨底头像位的可访问名（不在主序列里，但 `router` 的 `nav()` 会问到它）。
            NavItem::Account => Key::AccountTitle,
        }
    }

    /// 显示名（按当前界面语言）。
    ///
    /// 为什么带 `lang` 而不是读全局：这个函数要被单测与 harness 调，全局状态会让「同一份代码在
    /// 不同语言下画什么」不可断言。
    pub fn label(self, lang: Lang) -> &'static str {
        lang.catalog().text(self.label_key())
    }

    /// 令牌图标。
    pub const fn icon(self) -> IconKind {
        match self {
            NavItem::Instances => IconKind::Instances,
            NavItem::Download => IconKind::Download,
            NavItem::Logs => IconKind::Logs,
            NavItem::Settings => IconKind::Settings,
            NavItem::Ai => IconKind::Ai,
            NavItem::Account => IconKind::User,
        }
    }
}

/// 整条导航轨。
pub(super) fn rail<'a>(
    ui: &'a Ui,
    selected: NavItem,
    account: &RailAccount,
    forced: Option<ForcedState>,
    lang: Lang,
) -> Element<'a, Message> {
    let metrics = ui.metrics();
    let indicator = indicator_size(metrics);
    let compact = account.compact;

    let items = NavItem::ALL
        .iter()
        // `ALL` 本来就不含 `Account`（它固定在轨底），filter 只是把这条意图写明。
        .filter(|item| **item != NavItem::Account)
        .map(|item| rail_item(ui, *item, *item == selected, compact, forced, lang))
        .collect::<Vec<_>>();

    // 轨顶留白走 container padding，而不是「先塞一个 spacer 元素」：后者会被 column 的
    // spacing（4）再加一档，实测变 28（视觉复审 P3-5）。
    //
    // 轨底色与其它面板同源（M93）：`ui.layer` 已含面板 α，导航轨是面板层的一部分。
    //
    // 账户头像位**固定贴在轨底**（M114）：主序列四项在上，中间一段 Fill 把头像顶到底部——
    // 于是「账户」不是第 6 个导航项，轨的长度也不会随页数增长。
    container(
        column![
            column(items).spacing(metrics.nav_item_gap),
            iced::widget::space::vertical(),
            account_item(ui, selected, account, indicator, forced),
        ]
        .height(Length::Fill),
    )
    .width(nav_rail_width(metrics))
    .height(Length::Fill)
    .padding(Padding::from([ui.space(Space::X6), 0.0]))
    .style(move |_theme| filled(ui.layer(MaterialLayer::Canvas)))
    .into()
}

fn rail_item<'a>(
    ui: &'a Ui,
    item: NavItem,
    selected: bool,
    compact: bool,
    forced: Option<ForcedState>,
    lang: Lang,
) -> Element<'a, Message> {
    // 状态层（hover / pressed / 过渡帧）落在**药丸**上，与选中指示器同一块几何（M283）。
    let (pill_width, pill_height) = state_layer_box(ui.metrics());
    // 取证态与运行期态是**同一个** `Interaction`：强制态由 `overridden` 直接推（`None` → `Active`
    // → `Enabled`），运行期的真态由 `interaction::tracked` 的取样层在 draw 里给。
    let state = Interaction::from_status(overridden(forced, button::Status::Active));

    let icon_color = if selected {
        ui.color(Role::OnSecondaryContainer)
    } else {
        ui.color(Role::OnSurfaceVariant)
    };
    // 12b 5.6：选中标签用 `Secondary`，未选中 `OnSurfaceVariant`
    let label_color = if selected {
        ui.color(Role::Secondary)
    } else {
        ui.color(Role::OnSurfaceVariant)
    };

    // **不要用 `center_x/center_y(Fill)`**：那会把容器自己的 width/height 改成 Fill，
    // 于是 56 被父级（button 宽 88）覆盖成 88、32 靠布局凑巧（视觉复审 P2-1）。
    // 尺寸只认令牌推导值，居中交给父 column 的 `align_x`。
    let pill = container(icons::view::<Message>(item.icon(), icon_color))
        .width(pill_width)
        .height(pill_height)
        .align_x(Alignment::Center)
        .align_y(Alignment::Center)
        .style(move |_theme| container::Style {
            // 状态层画在**药丸**上（M283）：hover / pressed / 过渡帧都只这一块 56×32。
            // 之前它摊在 88×52 的按钮上（`Border::default()` ⇒ r=0），同一个元素并存两种形状。
            background: pill_color(ui, state, selected).map(Background::Color),
            border: Border {
                radius: ui.radius(ShapeScale::Full, pill_height),
                ..Border::default()
            },
            ..container::Style::default()
        });

    let item_height = nav_item_height(ui, pill_height);
    let height = if compact { pill_height } else { item_height };
    // 列必须显式占满轨宽，否则它会 shrink 到 56，`align_x(Center)` 就变成空操作，
    // 药丸会贴左缘（x=0..55 而不是 16..71）——r1 实测踩到的第二个坑。
    let mut stack = column![pill]
        .width(nav_rail_width(ui.metrics()))
        .align_x(Alignment::Center)
        .height(height);
    if !compact {
        // M114 的「窄高收成图标条」+ M106 的「按语言取词」并存。
        stack = stack.push(label(
            ui,
            TypeRole::LabelMedium,
            false,
            item.label(lang),
            label_color,
        ));
    }
    stack = stack.spacing(ui.space(Space::X1));

    let clickable: Element<'a, Message> = button(stack)
        .width(nav_rail_width(ui.metrics()))
        .height(height)
        .padding(0)
        .style(move |_theme: &IcedTheme, _status| button::Style {
            // 底色**恒为 `None`**：状态层由药丸给（M283，同一个元素不许并存两种形状）。
            background: None,
            text_color: label_color,
            border: Border::default(),
            shadow: Shadow::default(),
            snap: true,
        })
        .on_press(Message::Select(item))
        .into();
    // A8：运行期态套状态取样控件（强制态 = 取证，**不套**：取证图不许有过渡中间帧）。
    if forced.is_none() {
        interaction::tracked(clickable, true)
    } else {
        clickable
    }
}

/// 导航轨宽度（M69 起是令牌层的 `nav_rail_width`）。
///
/// M69（`141e9b1`）把 `LayoutMetrics` 的 nav 字段做了语义纠正：
///
/// | 旧 | 新 |
/// |---|---|
/// | `nav_expanded_width = 88` | **`nav_rail_width = 88`**（值不变，名字从「展开」改成「轨」） |
/// | `nav_collapsed_width = 48` | 删除（48 连 56 宽的选中指示器都放不下） |
/// | —（缺） | `nav_drawer_width = 240`（D33 的展开态抽屉，本 crate 未用） |
///
/// 三处调用点都走这里：将来令牌再改名，仍然只改这一行。
fn nav_rail_width(metrics: LayoutMetrics) -> f32 {
    metrics.nav_rail_width
}

/// 选中指示器尺寸（12b 5.4 参考 56×32），全部由令牌推导、不写死：
///
/// - 宽 = [`nav_rail_width`] − 2 × `Space::X4` = 88 − 32 = **56**（轨的左右内边距 16）
/// - 高 = `control_height − Space::X2` = 40 − 8 = **32**（可见高度上下各让 4）
pub fn indicator_size(metrics: LayoutMetrics) -> (f32, f32) {
    (
        nav_rail_width(metrics) - Space::X4.dp() * 2.0,
        metrics.control_height - Space::X2.dp(),
    )
}

/// 状态层（hover / pressed / 过渡帧）画在**哪块矩形**上：药丸，与选中指示器同一块几何（M283）。
///
/// 这是那块矩形的唯一定义点——`rail_item` 用它定尺寸，`shell::tests` 的几何判据钉住它。
/// 它**不是**按钮的 `nav_rail_width × 项高`（88×52）：那正是用户点名的「父容器整个方形区域加深」。
pub(super) fn state_layer_box(metrics: LayoutMetrics) -> (f32, f32) {
    indicator_size(metrics)
}

/// 药丸底色（**几何**的唯一实现点）：hover / pressed / 过渡帧都画在这块 56×32 上。
///
/// **颜色**只有一个来源：选中支走 [`interaction::selected_fill`]（全仓唯一的选中底色入口，
/// M299 收口了这里的私有拷贝），未选中支走 [`interaction::layer_color`]。选中/未选中**两条分支
/// 不许合并**：选中项静息是实色 `SecondaryContainer`（`selected_fill` 的兜底），未选中项静息
/// 不画药丸（`layer_color` 给 `None`）。两条都经状态层求值 ⇒ 没有取样控件时**逐位**等于原来的
/// `state_over(..)` / `ui.color(..)`（`--force-state=rest` 的取证图因此一字不变）。
fn pill_color(ui: &Ui, state: Interaction, selected: bool) -> Option<Color> {
    if selected {
        // 选中项走**全仓唯一的**选中底色入口（M299）：静息 = 实色 `SecondaryContainer`，
        // hover / pressed / 过渡帧叠在它上面。此前这里有一份私有拷贝，M296 的变异实验证明
        // 它不跟助手一起动。
        Some(interaction::selected_fill(
            ui,
            state,
            Role::OnSecondaryContainer,
            Role::SecondaryContainer,
        ))
    } else {
        // 导航轨自己画的就是 `MaterialLayer::Canvas`（见 [`rail`] 的 `.style(..)`）：状态层要叠在
        // **同一个**角色上，否则 hover 色与轨底色对不上。
        interaction::layer_color(
            ui,
            state,
            Role::OnSurface,
            MaterialLayer::Canvas.surface_role(),
        )
    }
}

/// 导航项高度 = 指示器 + 4 + 标签行高 = 32 + 4 + 16 = 52（`LM.nav_item_height` 是列表行节奏，
/// 药丸 + 标签的轨项放不进 44，偏差登记在交接文档里）。
pub fn nav_item_height(ui: &Ui, indicator_height: f32) -> f32 {
    indicator_height + ui.space(Space::X1) + ui.style(TypeRole::LabelMedium).line_height_px
}

#[cfg(test)]
mod tests;