view release on metacpan or  search on metacpan

bundled/tools/include/tui_term.h  view on Meta::CPAN

/*
 * Terminal control, raw mode, ANSI escape parsing, and double-buffered render.
 */

#ifndef HISTO_TUI_TERM_H
#define HISTO_TUI_TERM_H

#include <stdio.h>
#include <stdlib.h>
#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef enum {
    TUI_KEY_NONE = 0,
    TUI_KEY_CHAR,
    TUI_KEY_UP,
    TUI_KEY_DOWN,
    TUI_KEY_LEFT,
    TUI_KEY_RIGHT,
    TUI_KEY_ENTER,
    TUI_KEY_ESC,
    TUI_KEY_TAB,
    TUI_KEY_BACKSPACE,
    TUI_KEY_PAGE_UP,
    TUI_KEY_PAGE_DOWN,
    TUI_KEY_HOME,
    TUI_KEY_END,
    TUI_KEY_CTRL_C,
    TUI_KEY_RESIZE,
    TUI_KEY_MOUSE_CLICK,
    TUI_KEY_MOUSE_SCROLL_UP,
    TUI_KEY_MOUSE_SCROLL_DOWN
} tui_key_type_t;

typedef struct {
    tui_key_type_t type;
    int ch;
    int mouse_x;
    int mouse_y;
    int mouse_btn;
} tui_key_event_t;

/* Double-buffered frame buffer */
typedef struct {
    char *buf;
    size_t len;
    size_t cap;
} tui_frame_t;

/* Terminal state lifecycle */
bool tui_term_init(void);
void tui_term_restore(void);
bool tui_term_raw_enter(void);
void tui_term_raw_leave(void);
void tui_term_get_size(int *out_cols, int *out_rows);
int  tui_term_get_tty_fd(void);