Cell Primitives
Input, behavior, feedback, appearance, and rendering ownership.
HEAD a63778e| 本页适用于 | 修改 Cell primitive 的输入、行为、反馈、外观或渲染归属时。 |
|---|---|
| 首要结论 | Browser adapter、interaction controller、primitive behavior、theme 和 renderer 各自持有不同职责。 |
| 边界 | 本页描述职责边界，不复制公开类型或具体 Widget 状态流程。 |
| 下一步 | 先读 Widget 状态规范，再沿表格中的 authority 和测试追踪。 |
所有权
| 模块 | 权威职责 | 禁止依赖 |
|---|---|---|
| Browser adapter | DOM 焦点、坐标换算、遮挡、指针捕获、原生编辑 | 不私有化确认计时与按压编排 |
CellInteractionController | 共享焦点、按压、手势、输入命令、确认调度；Browser 与 TestPilot 共用 | Theme、Canvas、DOM |
| Primitive behavior | Select 命令解释与延迟关闭、Menu 延迟执行与菜单归属；业务值由受控调用方／React adapter 持有 | 外观、Theme、Canvas |
ConfirmationSequence | 纯闪烁阶段；ActivationFeedbackManager 适配目标和完成策略 | Widget、命令、Theme、宿主 |
| State projection / appearance | 从状态派生导航高亮与编辑活动，消费主题输出内容及边框最终样式；不持有第二份业务值 | 命令派发、输入副作用 |
| Runtime / Scene | 布局、裁剪、浮层与同次提交的 Buffer／SemanticSnapshot | 不把 Canvas 作为状态来源 |
统一外观覆盖 Button、Checkbox、Select、Toggle、RadioGroup/RadioItem、Slider 单值与双端模式、Tabs、Grid、TextInput/TextArea；List、Menu、Tree 保留为内部 fixture 机制。能力表区分整控件反色、thumb 字符强调与编辑区域；编辑器在同一外观出口消费实际焦点，规则由 Widget 规范拥有，painter 不再覆盖边框颜色。collection-chrome.ts 统一选择标记、树展开列和内容缩进。grid-navigation.ts 拥有坐标导航与入口选择，FocusManager 保存 Grid 入口 ID。TestPilot 代表活跃宿主，Browser adapter 提供真实宿主焦点，两者独立投影输入来源。底座仍属于同一个包，内部控制器不是新的公开插件 API。
生命周期
Dialog 描述归一为 Overlay／Text／Box，补充对话框身份与语义关联，不增加渲染器或业务状态机。FocusManager 拥有入口、模态循环及恢复，外部关闭策略由共享输入路由消费；Semantic DOM 的 focus 只处理节点自身事件，不把后代 focus 重新解释为父容器 focus。
Accordion 复用共享按压与反色；accordion.ts 仅拥有标题归属、隐藏判定与焦点恢复候选。Item 的展开值由调用方持有；折叠保留 Tree，Layout/Scene 排除内容子树，交互和语义消费同一隐藏边界。展开命令即时执行，不进入确认序列。
- 业务提交保持原时机；物理按压结束才播放确认，keyup 不重启会话；AT 直接激活立即播放。Select 关闭是行为策略，绘制和闪烁阶段不得选择业务值。
- Menu 例外：
activate保留至完整确认结束才派发一次；0即时执行。确认期间锁定同菜单导航及激活；外部点击、外部焦点、Escape、失活、配置／主题变化、目标禁用或卸载取消待执行动作。取消不得补执行，完成时重新验证目标。Menu 不自动关闭祖先 Overlay，调用方在onAction中决定关闭或导航。 - 确认会话具有唯一 ID，等待释放与播放分离；参照颜色从已解析的 CellBuffer 取得有效前景／背景，不读取 Canvas 像素。内容和标记继续使用最新业务状态。
- 每次 blink 为相对参照颜色的反色／恢复两个完整阶段；每阶段呈现后保持 80ms。默认两次共四阶段，最后一次恢复结束后才交还 hover／focus；
0跳过等待、呈现和计时。 - Browser 在 base/overlay Canvas 提交后、TestPilot 在 Buffer 提交后确认对应 session/phase，之后才启动可注入时钟。重复／过期确认与回调无效；延迟呈现不会跳过阶段。
- 取消、配置／主题变更、失活与目标失效清理挂起计时。完成策略仅消费一次，已卸载 scope 不接收关闭命令。
confirmation快照携带 session、phase、target 与参照颜色；activationTargetId／activationFlashId从播放会话派生。它们不表示绝对背景颜色，恢复阶段同样拥有视觉控制权。- Browser 的输入归属事实仍由呈现节点注册表与 Surface focus 提供；TestPilot 不模拟浏览器遮挡、IME 或真实焦点。
验证
控制器测试 · 视觉状态测试 · 真实浮层 hover · 依赖边界检查
Editor viewport contract
ScrollArea accepts axis="x" | "y" | "both"; the disabled axis has no rail or offset. cellAutoScrollRequest derives signed edge velocity from the nearest Cell viewport and keeps both axes at corners. Browser hosts own the resulting scroll command and may keep fractional residual motion outside document history. The reusable contract is implemented in viewport.ts, scroll.ts, and browser.tsx; regressions are in scroll-axis.test.tsx and browser.dom.test.tsx.