/*
 * 模块名称：UI Design Tokens (UI 设计令牌层 L0)
 * 模块功能：UI 视觉骨架的唯一取值来源——屏幕几何、内容页骨架（标题/页脚/文本
 *           条带/选中带内缩）、列表页原型（首行顶/行距/带高/两列 x/每页行数）、
 *           滚动条宽、文本缓冲长度、1bpp 语义色、UI 任务节拍与待机阈值；
 *           各页面/框架文件只引用本头令牌，不再自带同值字面量
 *           （治理背景见 docs/问题记录/项目审查与优化建议报告.md §6.3 L0）；
 *           纯取值定义，不含任何逻辑；改一处即全局生效，改前必须跑 ui-verify 像素回归
 * 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
 * 作者：王建锋
 * 创建日期：2026-10-15
 * 修改记录：
 *     v1.0  2026-10-15  王建锋  创建初始版本（收编散落各 UI 文件的布局/颜色/缓冲魔数，
 *                               纯替换、零行为变化；像素与替换前逐位一致）
 */
#ifndef UI_TOKENS_H
#define UI_TOKENS_H

/*
 * 依赖说明：
 * 1. 屏幕几何（UI_SCREEN_W / UI_SCREEN_H / UI_FB_SIZE）的**权威定义在 ui_port.h**
 *    （显示端口，MCU 与模拟器两端共用），本头复用而不重复定义——避免同名宏二次定义。
 * 2. 语义色宏展开为 LVGL 取色函数调用，故引用方须已包含 "lvgl.h"
 *    （UI 各 .c 均经 ui_content_page.h / ui_menu_view.h 等间接包含）。
 */
#include "ui_port.h"

/* ── 内容页骨架（框架 ui_content_page.c 与各自绘页共用）────────────────────── */

#define UI_TITLE_Y             2      /* 标题放置 y（居中；CJK 字形顶距 +1 → 墨迹自 y=3 起） */
#define UI_PAGE_LINE_Y         143    /* 页脚"第 X 页，共 Y 页"放置 y */
#define UI_TEXT_BAND_H         15     /* 单行文本条带下延量（字体行高 13 + 余量）：y2 = y + 本值 */
#define UI_BUF_STRLEN          32     /* 动态行 / 页脚文本缓冲长度（含 NUL；超出行带即被裁切） */
#define UI_SEL_BAND_INSET_L    2      /* 选中白带左内缩（x1 = 本值） */
#define UI_SEL_BAND_INSET_R    3      /* 选中白带右内缩（x2 = 屏宽 - 本值，即止于 x=156） */
#define UI_FOOTER_X            6      /* 页脚文本左起 x（左对齐留白，与实机一致） */

/* ── 列表页原型（交流量/直流量/运行记录/自检记录/网口设置共用一套骨架）──────── */

#define UI_LIST_TOP            24     /* 首行槽顶 y */
#define UI_ROW_PITCH           14     /* 行距（相邻行槽顶间距） */
#define UI_ROW_BAND_H          13     /* 选中白带高（= 字体行高；selectable 页须 >0 否则选中行不可见） */
#define UI_LIST_LEFT_X         7      /* 左列 x（名） */
#define UI_LIST_RIGHT_X        101    /* 右列 x（值） */
#define UI_LIST_ROWS           8u     /* 每页可见行数 */

/* ── 菜单显示层 ───────────────────────────────────────────────────────────── */

#define UI_SCROLLBAR_W         4      /* 自动滚动条宽（px；行超框高时出现） */

/* ── 1bpp 语义色（LV_COLOR_FORMAT_I1）─────────────────────────────────────── */

/*
 * 本屏只有黑白两值，但保留语义名：换色深时只改本段即可平移，不必回改各绘制点。
 * 极性（实测，勿凭直觉改）：文本/分隔线/边框一律取 white（1bpp 下即"暗墨"），
 * black 是底；选中行反显 = 白底黑字，故 SEL 前景取 black、SEL 背景取 white。
 */
#define UI_COL_FG              lv_color_white()     /* 墨：文本 / 分隔线 / 边框 / 滚动条 */
#define UI_COL_BG              lv_color_black()     /* 底：黑 */
#define UI_COL_SEL_FG          lv_color_black()     /* 选中行字色（反显后为黑字） */
#define UI_COL_SEL_BG          lv_color_white()     /* 选中行带底色（反显后为白带） */

/* ── UI 任务与待机策略 ────────────────────────────────────────────────────── */

#define UI_TASK_TICK_MS        10     /* uiTask 主循环周期：LVGL 推进步长 = osDelay 时长 */
#define UI_STANDBY_IDLE_MS     60000u /* 无操作进入待机屏的阈值（ms） */

#endif /* UI_TOKENS_H */