supercode-frontend-tui 0.5.49

Attachable terminal frontend primitives for Volter Harness SDK runtimes.
Documentation 
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

// Derived from OpenAI Codex: codex-rs/tui/src/tui/event_stream.rs
// Pinned source: 8604689ec5e3437eb79802d8d72249b7722fbf5b
// Copyright 2025 OpenAI
// Licensed under the Apache License, Version 2.0.
// Modified by the Supercode contributors; see docs/legal/codex-frontend-extraction.toml.

//! Runtime-neutral mapping of Crossterm input, focus, and resize events.

use crossterm::event::Event;
use crossterm::event::KeyEvent;

/// Terminal input the frontend may translate into SDK actions.
#[derive(Clone, Debug, Eq, PartialEq)]
pub enum TerminalEvent {
    Key(KeyEvent),
    Paste(String),
    Resize { width: u16, height: u16 },
    FocusChanged(bool),
}

/// Map one Crossterm event without introducing app/session behavior.
pub fn map_crossterm_event(event: Event) -> Option<TerminalEvent> {
    match event {
        Event::Key(key) => Some(TerminalEvent::Key(key)),
        Event::Paste(text) => Some(TerminalEvent::Paste(text)),
        Event::Resize(width, height) => Some(TerminalEvent::Resize { width, height }),
        Event::FocusGained => Some(TerminalEvent::FocusChanged(true)),
        Event::FocusLost => Some(TerminalEvent::FocusChanged(false)),
        Event::Mouse(_) => None,
    }
}

/// Focus and viewport state used by render scheduling and notifications.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct TerminalState {
    pub width: u16,
    pub height: u16,
    pub focused: bool,
}

impl TerminalState {
    pub const fn new(width: u16, height: u16) -> Self {
        Self {
            width,
            height,
            focused: true,
        }
    }

    /// Apply focus/resize state and report whether a redraw is required.
    pub fn apply(&mut self, event: &TerminalEvent) -> bool {
        match event {
            TerminalEvent::Resize { width, height } => {
                let changed = self.width != *width || self.height != *height;
                self.width = *width;
                self.height = *height;
                changed
            }
            TerminalEvent::FocusChanged(focused) => {
                let changed = self.focused != *focused;
                self.focused = *focused;
                changed
            }
            TerminalEvent::Key(_) | TerminalEvent::Paste(_) => false,
        }
    }
}