bubblezone:Bubble Tea 终端 UI 鼠标区域检测库
为 Bubble Tea/lipgloss 应用注入零宽标记并扫描区域,让嵌套组件能判断鼠标事件是否落在自身边界内。
bubblezone 是一个 Go 库,解决 Bubble Tea 与 lipgloss 应用中组件层级变深后难以判断鼠标点击落在哪个组件的问题。它用零可打印宽度的标记包裹组件区域,在根模型的 View() 输出上调用 zone.Scan() 记录各标记的偏移并从输出中剥离;子组件在 Update() 中用 zone.Get(id).InBounds(mouseMsg) 判断事件是否落在自身边界内,从而实现聚焦、点击按钮等交互。标记不影响 lipgloss.Width() 计算,提供全局与非全局管理器,以及 NewPrefix() 生成唯一前缀避免 ID 冲突。注意事项:MaxHeight/MaxWidth 硬裁剪会破坏区域标记,Scan() 只应在根模型调用,InBounds 基于矩形区域判断。README 提示 Bubble Tea v2 用户可考虑其后继项目 bloom,bubblezone v1 仍适用于 v1 程序。