linear-tui 0.12.0

A TUI client for Linear.app — manage issues, projects, and cycles from your terminal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

//! Terminal events, routed: keys to the binding table, clicks and the wheel
//! to what the last frame drew.

use std::time::Duration;

use anyhow::Result;
use crossterm::event::{self, Event, KeyEventKind, MouseButton, MouseEventKind};

use crate::interface::tui::app::{App, Popup};
use crate::interface::tui::keys::handle_key;
use crate::interface::tui::palette;

/// How long to block waiting for input before returning to redraw.
const POLL_INTERVAL: Duration = Duration::from_millis(50);

/// Drain all pending terminal events. Returns true if anything changed and the
/// frame should be redrawn.
pub fn poll_and_handle(app: &mut App) -> Result<bool> {
    let mut dirty = false;

    // Block briefly so an idle TUI doesn't spin the CPU, then drain whatever
    // arrived without blocking again — this keeps held-down keys responsive.
    let mut timeout = POLL_INTERVAL;
    while event::poll(timeout)? {
        timeout = Duration::ZERO;
        dirty |= handle(app, event::read()?);
        if app.should_quit {
            break;
        }
    }

    Ok(dirty)
}

/// Route one event — from the terminal, or pressed by an agent. Returns
/// whether it may have changed the frame.
pub fn handle(app: &mut App, event: Event) -> bool {
    match event {
        Event::Key(key) if key.kind == KeyEventKind::Press => {
            app.cancel_restore();
            handle_key(app, key);
            true
        }
        Event::Mouse(mouse) => {
            if let MouseEventKind::Down(_) = mouse.kind {
                app.cancel_restore();
            }
            // The palette's rows come from the binding table, which the
            // app does not know about, so its clicks are routed here.
            let palette = app.view.popup == Popup::Palette;
            match mouse.kind {
                MouseEventKind::ScrollDown if palette => palette::wheel(app, 1),
                MouseEventKind::ScrollUp if palette => palette::wheel(app, -1),
                MouseEventKind::Down(MouseButton::Left) if palette => {
                    palette::click(app, mouse.column, mouse.row)
                }
                MouseEventKind::ScrollDown => app.wheel(mouse.column, mouse.row, 1),
                MouseEventKind::ScrollUp => app.wheel(mouse.column, mouse.row, -1),
                MouseEventKind::Down(MouseButton::Left) => app.click(mouse.column, mouse.row),
                _ => return false,
            }
            true
        }
        Event::Resize(_, _) => true,
        _ => false,
    }
}