Ordo UI
组件Foundations

Tone

@mox-hub/ui 组件 · Foundations · canonical

tone@mox-hub/uiFoundationscanonicalsrc/components/tone.ts
变体演示tone
demo 待补(demos map 未注册)

Props API

未解析到 Props(内部组件或纯静态导出,以源码为准)。

源码

packages/ui/src/components/tone.ts
/**
 * 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 /translator props,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。
  • 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。

用法说明

非可视色彩工具(.ts),提供语义 tone 映射;无 demo,按源码与主题页使用。