选项选单画面撕裂

[ElainaRoxy]

打开选项选单以及command execution bar会出现画面撕裂
终端模拟器：alacritty
系统：ubuntu 24.04

[github-actions]

👋 Hi there, and welcome to superfile!

Thanks for opening your first issue. We really appreciate your interest and involvement.

A maintainer might ask you for more details or clarification to better understand the issue.
That’s totally normal and helps us solve the problem more effectively.

If you plan to submit a PR, make sure to check our Contribution Guide

[cschanhniem]

The screen tearing in the option menu and command execution bar when using Alacritty is likely a double-buffering issue in the Bubble Tea render cycle. Bubble Tea v2 uses the termenv terminal abstraction for output, and the rendering model relies on the Program.Send(msg) → Update(msg) → View() loop being atomic per frame.

Two likely causes:

1. Mid-frame terminal resize: If Alacritty fires a SIGWINCH (resize signal) while the options menu is painting, Bubble Tea receives a tea.WindowSizeMsg mid-frame. If the Update() handler for this message re-renders the parent viewport without first completing the menu view, the partially-drawn frame gets flushed to the terminal before the menu overlay is layered on. The fix: in the menu's Update() handler, check msg.(tea.WindowSizeMsg) and return early with cmd only (no model mutation), deferring the resize to the parent's next tick.

2. Non-atomic View() output: If the menu's View() concatenates strings from multiple lipgloss.Style.Render() calls without wrapping the final result in a single \x1b[?25l (hide cursor) / \x1b[?25h (show cursor) pair, the terminal may flush partial frames between style renders. Since Alacritty uses a damage-tracking renderer (like Kitty), it may only redraw changed cells — meaning a half-painted menu frame has visible artifacts where the new and old content overlap. Wrapping the entire menu output in lipgloss.Place(...) with explicit width/height ensures atomic placement.

For debugging, you can enable Bubble Tea's tea.WithRenderer(tea.ANSICompressor) which logs every frame to stderr — compare the frame sequence before and during tearing.