Cell Widget State and Presentation

状态与主题

• focused 是逻辑焦点，selected 是持久选择；二者可共存。
• pressActive 是共享控制器通过 PressManager 管理的离散瞬时按压；activationFlash 是 command 已接受后的离散确认；manipulating 是 GestureManager 管理的连续 pointer 操控。三者均不进入业务 state。
• Button、Checkbox、Select、ComboboxItem、Toggle、RadioItem、List、Menu、Tree、Grid 共用反色高亮：鼠标与 keyboard/AT 采用最近输入来源，逻辑 focus 独立保留；pointer 移出撤销高亮，键盘恢复同一套高亮。Slider 的单值与双端模式同样投影输入来源，但仅强调目标 thumb。Tabs 的选中态由 variant 独立控制。
• Checkbox checked/mixed、Select selected、Toggle pressed、Radio checked、List/Tree/Grid selected 使用独立字符标记；Tabs 默认 underline，在当前标签文字下方绘制 ⎺；solid 保留单行反色选择背景。
• TextInput、ComboboxInput 与 TextArea 的编辑活动由 Runtime 比对 focusedId === activeFocusId 后投影为 focusActive，不依赖输入来源、hover 或正文变化。TextInput 默认 surface，活动时整行 highlight；ghost 与 ComboboxInput 保留背景。三者仅在活动时以相对底色反差显示文字选区；选区 token 与底色撞色时反转当前前景／背景。原生 textarea 的 selectionchange 经 set-selection 同步到 Cell 状态，并保留反向选区。输入法组合文字保留下划线，插入点使用反色 Cell Cursor。TextArea 活动时 highlight 覆盖边框内的文字、padding 与空白，边框保持未激活样式；失焦撤去选区外观，并从内容起点展示，同时保留编辑视口与 selection。失焦期间滚动只改变展示视口；键盘／语义再聚焦恢复编辑视口，鼠标点入则从可见位置定位光标。Surface 空白只接管浏览器焦点并保留导航锚点，不激活编辑器。readOnly 可聚焦，disabled 无活动强调。
• Cursor 默认反转所在 Cell 的最终颜色，不重新解释编辑状态；形状、fixed 模式、CSS token 与底图恢复由 cursor-appearance.ts 和测试验证。
• Surface 失去实际焦点时保留逻辑 focusedId，但撤去焦点外观与 Canvas Cursor；selection 和编辑状态保留。
• CellUiTheme 是颜色与字符主题入口；CellFeedbackConfig 是反馈入口，classic 默认闪烁 2 次，instant 为 0 次。两者共享 hover、focus、press 规则。
• CellUiRecipe.defaultControlVariant 只为 Button、Select、Combobox、TextInput 提供省略 variant 时的默认值；显式 variant 优先。Box、ScrollArea、TextArea、Overlay、Dialog 保留各自内建默认。浏览器 CSS adapter 从 --cell-default-control-variant 读取同一配置，headless 不依赖 CSS。
• 公开主题用法分别定义 variant 与 frame；后代状态消费最近的实际 surface substrate。背景不进入字符、语义或 Range Copy；边框会进入。
• Select、Combobox 与 TextInput 使用共享的 surface | ghost recipe；默认 surface 使用 elevatedSurfaceStyle，ghost 沿用最近父层底色，无父层时使用 theme.background。Select/Combobox Content 的 frame 独立控制下拉层边框。ComboboxInput 与 ghost TextInput 活动时保留背景；SelectTrigger 的 focus 与 press 沿用反色规则，disabled 保留 recipe 并使用禁用文字色。
• Select／Combobox 未指定宽度时从完整 Item 列表测量稳定的自然宽度，Trigger／Input 与 Content 共用该宽度；显式宽度优先。Content 的 open 只控制可见性，ComboboxItem 的 hidden 只控制过滤结果，两者都不移除 Item 的测量信息；SelectTrigger 的 placeholder 可为更长的空值文案预留宽度。
• widget-capabilities.ts 拥有能力表；状态投影与外观配方分离，painter 只绘制解析结果。局部 textStyle 不重定义状态语言；底座契约拥有模块边界。
• 统一控件的按压与高亮最多反色一次；确认阶段独占颜色，相对进入时的有效颜色对执行反色／恢复，disabled 拒绝全部临时强调。solid Button 使用 buttonSolidStyle，surface 使用 elevatedSurfaceStyle 与普通文字色，outline 保留字符边框，ghost 静止时填充当前层底色。
• 解析后的状态背景覆盖 Widget 完整布局矩形，包括空白 Cell；透明状态不填充。
• inline-control-chrome.ts 统一行内 spacing recipe：Button、Badge 与 TextInput 默认左右各留 1 个 content Cell，Button/Badge 可通过 style.paddingLeft/Right 覆盖；Checkbox、RadioItem、Toggle、Select 与 Combobox 提供固定 guard、状态标记和间隔；guard 是 owner-aware 空 Cell。border、collection disclosure、Tab underline 和 scrollbar 保持独立 chrome 职责。
• Badge 默认是只读状态文字；interactive 才加入共享焦点、按压、确认和 activate 命令。tone 从主题的成对前景／背景色中取值，文字和语义不依赖颜色；不自动作为 live region 播报。
• Field 可选地包裹一个 TextInput、TextArea、Select 或 Combobox，以同一行文契约显示 label 与 ! 错误文字。非空 error 将 invalid 传给实际获焦的控件，并以错误节点关联 aria-describedby；无错误时不改写输入状态。Button 的 tone="danger" 使用共享 danger token，variant 仍只控制外观。

双呈现

presentation 在 CellSurface／Runtime 级别选择，默认 rich；切换不改变值、焦点、命令或语义。text 仍消费共享 hover、focus、press、blink 和编辑光标，不等于无样式快照。Button 使用 [ Label ]；Alert、Dialog、Tooltip、TextArea、Select 弹层、Table 和 surface Box／ScrollArea 用方角字符边框；Progress 使用 [//--]；Tabs 使用 ⎺。TextArea 省略 variant／frame 时，Rich 为无框 surface，Text 保留同一底色并使用方角字符边框；显式 variant 仍决定底色，Rich 的显式 frame／borderShape 决定边框，Text 始终使用方角字符框。Select／Combobox、List／Menu／Tree／Grid 的 > 表示当前导航项，✓ 表示已提交或持久选中。其余字符原生组件沿用现有 glyph。显式边框不叠加第二层；ghost Box／ScrollArea 填充当前层底色。公开 variant 保持兼容，text 字符配方优先于纯视觉 variant；旧 Button outline 在 rich 中继续可用。

组件 Playground 独立切换呈现。Config 在 text 下隐藏被固定字符配方覆盖的外观项，保留仍影响颜色或字符的选项（包括 surface/ghost）；隐藏项的 Rich 选择不丢失，切回 Rich 后恢复。配置弹层若在切换时失效会关闭，焦点回到 presentation 控件。

Toast 内容由 Toast descriptor 持有 tone、variant 和 Rich 的 frame／borderShape；通知队列与位置仍由 browser host 持有。tone 复用 Badge 语义色，非 neutral 显示对应字符；Text 固定方角字符框。Toast 本身不创建第二个 live region，外层通知容器以 status 播报。

Primitive 快照

此表包含内部 Widget 契约，不等同于公开组件目录。List、Menu、Tree、Overlay 和双端 Slider 的底层 descriptor 仍服务内部 fixture 与共享机制，但不再作为独立组件分发。

Button、Badge、Checkbox、Toggle、RadioItem、Select Trigger／Item、Combobox Item 和 Tab 的标签共用单行文本规则：可用 Cell 不足时在内容区以 … 截断，先保护组件 chrome；原文与语义标签不变。普通 Text 仍按 Cell 换行。