feat(tui-rs): add support for mousewheel scrolling (#641)

It is intuitive to try to scroll the conversation history using the
mouse in the TUI, but prior to this change, we only supported scrolling
via keyboard events.

This PR enables mouse capture upon initialization (and disables it on
exit) such that we get `ScrollUp` and `ScrollDown` events in
`codex-rs/tui/src/app.rs`. I initially mapped each event to scrolling by
one line, but that felt sluggish. I decided to introduce
`ScrollEventHelper` so we could debounce scroll events and measure the
number of scroll events in a 100ms window to determine the "magnitude"
of the scroll event. I put in a basic heuristic to start, but perhaps
someone more motivated can play with it over time.

`ScrollEventHelper` takes care of handling the atomic fields and thread
management to ensure an `AppEvent::Scroll` event is pumped back through
the event loop at the appropriate time with the accumulated delta.

codex-rs/tui/src/app.rs

@@ -2,6 +2,7 @@ use crate::app_event::AppEvent;
 use crate::chatwidget::ChatWidget;
 use crate::git_warning_screen::GitWarningOutcome;
 use crate::git_warning_screen::GitWarningScreen;
+use crate::scroll_event_helper::ScrollEventHelper;
 use crate::tui;
 use codex_core::protocol::AskForApproval;
 use codex_core::protocol::Event;
@@ -10,6 +11,8 @@ use codex_core::protocol::SandboxPolicy;
 use color_eyre::eyre::Result;
 use crossterm::event::KeyCode;
 use crossterm::event::KeyEvent;
+use crossterm::event::MouseEvent;
+use crossterm::event::MouseEventKind;
 use std::sync::mpsc::channel;
 use std::sync::mpsc::Receiver;
 use std::sync::mpsc::Sender;
@@ -39,6 +42,7 @@ impl App<'_> {
         model: Option<String>,
     ) -> Self {
         let (app_event_tx, app_event_rx) = channel();
+        let scroll_event_helper = ScrollEventHelper::new(app_event_tx.clone());
 
         // Spawn a dedicated thread for reading the crossterm event loop and
         // re-publishing the events as AppEvents, as appropriate.
@@ -49,10 +53,21 @@ impl App<'_> {
                     let app_event = match event {
                         crossterm::event::Event::Key(key_event) => AppEvent::KeyEvent(key_event),
                         crossterm::event::Event::Resize(_, _) => AppEvent::Redraw,
-                        crossterm::event::Event::FocusGained
-                        | crossterm::event::Event::FocusLost
-                        | crossterm::event::Event::Mouse(_)
-                        | crossterm::event::Event::Paste(_) => {
+                        crossterm::event::Event::Mouse(MouseEvent {
+                            kind: MouseEventKind::ScrollUp,
+                            ..
+                        }) => {
+                            scroll_event_helper.scroll_up();
+                            continue;
+                        }
+                        crossterm::event::Event::Mouse(MouseEvent {
+                            kind: MouseEventKind::ScrollDown,
+                            ..
+                        }) => {
+                            scroll_event_helper.scroll_down();
+                            continue;
+                        }
+                        _ => {
                             continue;
                         }
                     };
@@ -125,6 +140,9 @@ impl App<'_> {
                         }
                     };
                 }
+                AppEvent::Scroll(scroll_delta) => {
+                    self.dispatch_scroll_event(scroll_delta);
+                }
                 AppEvent::CodexEvent(event) => {
                     self.dispatch_codex_event(event);
                 }
@@ -184,6 +202,14 @@ impl App<'_> {
         }
     }
 
+    fn dispatch_scroll_event(&mut self, scroll_delta: i32) {
+        if matches!(self.app_state, AppState::Chat) {
+            if let Err(e) = self.chat_widget.handle_scroll_delta(scroll_delta) {
+                tracing::error!("SendError: {e}");
+            }
+        }
+    }
+
     fn dispatch_codex_event(&mut self, event: Event) {
         if matches!(self.app_state, AppState::Chat) {
             if let Err(e) = self.chat_widget.handle_codex_event(event) {