TUI 组件系统

组件与焦点

Pi TUI 组件实现 render(width) 并返回终端行。Focusable 组件还处理输入焦点和 IME。容器负责组合子组件，Overlay 可以覆盖主界面。

终端宽度按可见字符计算，ANSI 转义和宽字符需要专用工具处理。不要直接用字符串 length 做布局。

• Text、Box、Container、Spacer 提供基础布局。
• Markdown 与 Image 处理富内容。
• 选择列表和设置列表提供常用交互。
• BorderedLoader 适合可取消异步操作。
• 自定义 Editor 可实现 Vim 等模式。

性能与 invalidation

TUI 使用差异渲染。组件状态变化后需要正确 invalidation，主题变化时重建依赖颜色的缓存内容。

大型列表应减少重复计算，长任务用增量状态而不是每次重建整个树。