Mosaic 0.17.0 发布：终端UI开发框架的重大升级

Mosaic 是一个基于 Kotlin 的终端 UI 开发框架，它借鉴了 Jetpack Compose 的声明式 UI 理念，让开发者可以用现代化的方式构建命令行界面。最新发布的 0.17.0 版本带来了多项重要改进和新特性，显著提升了终端 UI 的开发体验和功能表现。

核心架构升级

本次版本最重大的变化是 Mosaic 切换到了自主研发的终端集成和解析库。这一底层架构的革新为框架带来了更强大的终端能力支持，包括实时终端状态监测、更精确的尺寸控制以及更丰富的样式表现。开发者现在可以构建更加动态和响应式的终端应用。

终端状态管理增强

框架对终端状态的管理进行了全面重构：

• 原有的 Terminal 和 LocalTerminal 被重命名为 TerminalState 和 LocalTerminalState，更准确地反映了其状态管理的本质
• 新增了 focused 属性，可以实时监测终端窗口的焦点状态变化
• 引入了 theme 属性，支持检测终端配色方案是浅色还是深色模式
• 尺寸属性现在同时支持字符单元格和像素单位的测量

这些状态属性为构建自适应终端 UI 提供了坚实基础，开发者可以根据终端环境的变化动态调整界面表现。

生命周期集成

新版本将终端焦点状态与 Lifecycle 系统绑定，并通过 LocalLifecycleOwner 暴露给组合函数。这意味着开发者现在可以在终端 UI 中使用 Compose 风格的生命周期感知效果，如 LifecycleResumeEffect 等，大大简化了基于生命周期的逻辑处理。

文本样式增强

0.17.0 版本引入了对多种下划线样式的支持，包括：

• 单线下划线
• 双线下划线
• 虚线样式
• 点状样式
• 曲线样式

每种样式都可以自定义颜色，为终端文本提供了更丰富的视觉表现手段。这些样式可以通过 AnnotatedString 的 span 应用到特定文本范围。

日志记录改进

新增的 LocalStaticLogger 组合局部变量提供了 StaticLogger 的访问能力，允许开发者在效果、回调或状态类中记录普通字符串日志。这些日志会被收集并在下一帧渲染时显示，为调试和状态追踪提供了便利。

API 优化与调整

框架对部分 API 进行了优化和重命名：

• Static 函数更名为 StaticEffect，更明确地表达了其只渲染一次内容的特性
• 新增 runMosaicMain 函数专门用于 fun main() 或类似的主程序场景
• runMosaic 和 runMosaicBlocking 现在接受 NonInteractivePolicy 参数，用于控制在无法直接连接 TTY 时的行为

性能与兼容性改进

新版本在渲染性能和终端兼容性方面也有显著提升：

• 优化了行尾处理，避免在每行末尾绘制不必要的空白字符
• 改进了最后一列字符的渲染，防止被意外擦除
• 智能检测终端功能支持，只在终端支持的情况下禁用光标和发送同步渲染标记
• 在颜色禁用场景(如测试环境)下不再发送 ANSI 样式重置转义序列

总结

Mosaic 0.17.0 通过底层架构革新和丰富的功能增强，为终端 UI 开发带来了更专业、更强大的工具集。从精确的终端状态管理到丰富的文本样式，从生命周期集成到改进的渲染性能，这一版本标志着框架在成熟度和功能性上的重要里程碑。对于需要构建现代化命令行工具的 Kotlin 开发者来说，Mosaic 正成为一个越来越有吸引力的选择。