组件Foundations
Tone
@mox-hub/ui 组件 · Foundations · canonical
tone@mox-hub/uiFoundationscanonicalsrc/components/tone.ts变体演示tone
demo 待补(demos map 未注册)
Props API
未解析到 Props(内部组件或纯静态导出,以源码为准)。
源码
/**
* tone.ts —— 视觉层 tone 词表(tone → class)
*
* E 类方案 §19.5「状态色唯一映射」的**下层**。全库有且仅有一条状态色链路:
*
* 业务状态(task.status / project.status / run.status …)
* │ ① 业务层映射(知道业务语义)
* ▼
* src/shared/status/status-visuals.ts → status ──► tone
* │
* │ ② 视觉层映射(只知道 tone,不知道业务)
* ▼
* src/components/ui/tone.ts → tone ──► { text, dot, light, bg, border }
* │
* ▼
* StatusPill / StatusIconFrame / 甘特条 / 看板卡 …
*
* 分层(§19.1):本文件属**原子层**,只依赖已注册的 `--color-*` token,
* 不 import 任何 `modules/*` 或 `shared/*`。消费方向只能是
* `shared/status/` → `components/ui/tone.ts`,反向即分层倒置。
*
* ## 取值来源(2026-09-28 批 0b 抽取,纯重构、零视觉变更)
*
* - `text` / `dot` / `light` 三槽:**逐字**取自抽取前的两份重复映射
* (`status-pill.tsx` 的 `toneClass`、`status-visuals.ts` 的
* `TONE_TEXT_CLASS` / `TONE_DOT_CLASS` / `TONE_LIGHT_CLASS`)。
* 两份实测**零差异**(同 tone 同槽逐字相同),故本次未做任何取值裁决。
* - `bg` / `border` 两槽:**新增槽**。抽取前两份映射中并无对应项,
* 取值沿用仓内既有 tone→描边 / tone→实心底写法
* (`page-header.tsx` 的 `METRIC_TONE_CLASS`、`segmented-control.tsx` 的
* `TONE_CLASS`),**未引入任何新色 token、未新增任何未注册色名**。
* 两槽当前**零消费方**,属性可供后续批次接线;取值待人工确认。
*/
/** 五档语义 tone(§19.4 封闭词表:default / info / warning / success / danger) */
export type Tone = 'default' | 'info' | 'warning' | 'success' | 'danger';
/** tone 的五个视觉槽位 */
export interface ToneClass {
/** 文字色(前景) */
text: string;
/** 色点 / 进度条填充(实心点) */
dot: string;
/** 浅底胶囊(浅底 + 配套文字色) */
light: string;
/** 实心 tone 底 */
bg: string;
/** tone 描边 */
border: string;
}
/**
* tone → class 唯一词表(§19.5 视觉层唯一真相源)。
*
* ⚠️ 修改本词表 = 全库状态视觉变更,须按 §11.2 走宪法修订,不得在页面上另写映射覆盖。
*/
export const TONE_CLASS: Record<Tone, ToneClass> = {
default: {
text: 'text-muted-foreground',
dot: 'bg-muted-foreground',
light: 'bg-muted/50 text-muted-foreground',
bg: 'bg-muted',
border: 'border-border',
},
info: {
text: 'text-accent-blue',
dot: 'bg-accent-blue',
light: 'bg-accent-blue-light text-accent-blue',
bg: 'bg-accent-blue',
border: 'border-accent-blue/40',
},
warning: {
text: 'text-accent-yellow',
dot: 'bg-accent-yellow',
light: 'bg-accent-yellow-light text-accent-yellow',
bg: 'bg-accent-yellow',
border: 'border-accent-yellow/50',
},
success: {
text: 'text-accent-green',
dot: 'bg-accent-green',
light: 'bg-accent-green-light text-accent-green',
bg: 'bg-accent-green',
border: 'border-accent-green/40',
},
danger: {
// 审计 P2-08:危险色统一到 --destructive(与 Badge destructive / 计数角标同源),
// 不再让 StatusPill 的 accent-red 与 Badge 的 destructive 同屏出现两套红。
text: 'text-destructive',
dot: 'bg-destructive',
light: 'bg-destructive/10 text-destructive',
bg: 'bg-destructive',
border: 'border-destructive/40',
},
};
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
非可视色彩工具(.ts),提供语义 tone 映射;无 demo,按源码与主题页使用。