mirror of
https://github.com/fluffos/fluffos
synced 2026-08-12 18:26:06 -04:00
5f7be1008f
* Char-mode input: deliver real keystrokes (BS/DEL, whole UTF-8, raw ESC); fix NAWS lost at logon Five input-path fixes that make raw-keystroke (get_char) applications viable, found by building the LPC TUI library on top of them: - comm.cc: char mode delivered "" for Backspace/Delete (the byte was zeroed before delivery, making BS/DEL/NUL indistinguishable). The literal byte is now delivered; line-mode in-buffer editing unchanged. - comm.cc: char mode delivered one *byte* per callback, splitting a multi-byte UTF-8 character into 2-4 invalid one-byte strings. Extraction is now UTF-8 aware: a complete sequence arrives as one callback carrying one valid character; malformed bytes still go byte-at-a-time (no stalls). - comm.cc: the "no ansi" + "strip before process input" ESC->space rewrite (both default on) also applied to char mode, so arrow keys arrived as literal "[A". The rewrite is an anti-ANSI-injection protection for line-mode commands; char mode now always passes ESC through. - net/telnet.cc: each received chunk was u8_sanitize()d independently, so a UTF-8 character split across TCP segments became U+FFFD in any input mode. An incomplete trailing sequence (new u8_incomplete_tail(), GTest-covered) is now carried over in interactive_t and prepended to the next chunk. - net/telnet.cc + comm.cc: fast clients answer the initial DO NAWS while ip->ob is still the master object, so the window_size apply fired on the wrong object and the size was lost until the next resize. The last report is cached and replayed on the user object at logon. docs/efun/interactive/get_char.md documents the delivery contract. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RpXv4yGCWpkzbkifyZy9EE * Add /std/tui: an LPC TUI library (readline + ncurses for the prompt line and full-screen apps) A terminal-UI toolkit in pure LPC, strictly layered (design + rationale in testsuite/std/tui/DESIGN.md; user docs in docs/concepts/general/tui.md): - ansi.lpc: escape builders plus the width toolkit the driver lacks (visible_width/wslice/wpad are ANSI-blind and wide-char aware). - keys.lpc: keystroke decoder state machine: the get_char byte stream -> key events (CSI/SS3 with xterm modifiers, Alt prefixes, bracketed paste as one event, SGR mouse, UTF-8, lone-ESC via caller-driven flush()). - readline.lpc: the line editor: emacs keymap (motion/kill/yank/ transpose), Up/Down history, C-r/C-s incremental search, Tab completion, masked mode, horizontal scrolling with wide-char aware viewport; repaints only its own line so it works at any scroll position. - screen.lpc: virtual cell grid + minimal-diff frame renderer with copy-on-write rows (frame cost tracks touched rows, not W x H); wide chars own two cells, boxes/fills/attrs as SGR param strings. - widget.lpc + w/ (label, list, textfield) + app.lpc: widget protocol, focus cycling, event routing; textfield embeds a readline engine. - terminal.lpc: the one impure module, inherited by the user object: get_char re-arm loop (I_NOECHO across re-arms), NAWS/TTYPE caching via the window_size/terminal_type applies, lone-ESC walltime timeout, guaranteed teardown. tui_readline() is a drop-in input_to() replacement; tui_open() runs full-screen apps on the alt screen. Everything below terminal.lpc is a pure state machine: 194 checks in single/tests/std/tui/ cover the decoder, editor sessions, history search, screen diffing and widgets headlessly. `tuidemo` / `tuidemo app` (command/tuidemo.lpc) demo both modes over any telnet client; the whole stack was verified end-to-end over a live connection including split-packet UTF-8, modifier keys, paste, resize and alternate-screen teardown. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RpXv4yGCWpkzbkifyZy9EE * /std/tui v2: pterm/blessed-inspired widgets, inline printers and prompts, showcases Reviewed the pterm (Go) and blessed widget catalogs and ported what earns its keep in a MUD; DESIGN.md is renamed to README.md and documents the full set (including what was deliberately not ported). New layers: - print.lpc — pterm-style printers that compose with plain write(): p_table (boxed, width-aware, header rule), p_tree, p_bars, p_spark, p_panel, p_bullets, p_header, p_progress, p_info/success/warn/error, and p_bigtext via the existing /std/bitmap_font. - menu.lpc + terminal glue — inline interactive prompts in the normal output flow: tui_select(), tui_multiselect() (Space toggles, list windows by height, collapses to a "? prompt: answer" line) and tui_confirm() (y/n with a default). New widgets (/std/tui/w/): table (columns + header + selection), tree (collapsible, arrows fold), checklist, radiolist, button, progress, spinner (app-driven tick()), and log (bottom-anchored scrollback pane). Showcases (command/tuidemo.lpc): `tuidemo select` (prompt chain), `tuidemo print` (all printers), `tuidemo dashboard` (animated spinner, progress bars, sparkline, live table and log on a call_out tick), and `tuidemo form` (textfield, radio group, checkboxes, buttons). Coverage: three new test files (print exact-output, menu sessions, widgets2) bring /std/tui to 8 files in the suite; the live-connection e2e run now drives all six showcases end-to-end (52 checks), including the select->multiselect->confirm chain, unattended dashboard animation, and full form entry. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RpXv4yGCWpkzbkifyZy9EE * /std/tui: charts — braille canvas, line charts, vertical bars, heatmap Fills the chart gap left by v2 (only the horizontal p_bars existed): - canvas.lpc: a braille dot canvas (each cell is a 2x4 dot grid from the U+2800 block — the blessed-contrib/drawille technique), giving sub-cell resolution: c_set/c_unset/c_get, Bresenham c_line, and c_plot (scale a value series across the canvas), with per-cell colour. Renders as a string, per-row strings, or per-cell ({ ch, attr }) pairs for blitting into a screen. - print.lpc: p_chart (multi-series braille line chart with y-axis gutter and coloured legend), p_vbars (vertical bar chart with eighth-block partial tops and optional value row), p_heatmap (2D matrix as 256-colour cells, cool-to-hot ramp, optional axis labels). - w/chart.lpc: the live line-chart widget — add_series()/add_point() rolling history sized to the widget, auto or fixed y-range; replaces the dashboard's sparkline label with a real animating graph. - `tuidemo charts` showcase; chart docs in README.md and the docs page (heatmap removed from the not-ported list). Tests: single/tests/std/tui/charts.lpc pins the braille bit math with exact glyphs, line drawing, plot endpoints, exact p_vbars output, chart/heatmap structure, and the widget's rolling window. The live e2e run verifies `tuidemo charts` output and braille frames streaming from the dashboard chart. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RpXv4yGCWpkzbkifyZy9EE * docs: move the TUI page from Concepts to STDLIB /std/tui is a mudlib library like base64/break_string/json, so its page belongs under docs/stdlib/ with the rest of the /std modules, not under Concepts. Registered in stdlib/index.md; README file-layout pointer updated. (Concepts' sidebar is autogenerated, so the old entry disappears with the file.) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RpXv4yGCWpkzbkifyZy9EE --------- Co-authored-by: Claude <noreply@anthropic.com>
82 lines
3.3 KiB
C
82 lines
3.3 KiB
C
#ifndef TUI_H
|
|
#define TUI_H
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// /std/tui — public contract. See /std/tui/DESIGN.md.
|
|
//
|
|
// Key events are ints (special keys / modified keys) or strings (printable
|
|
// text; a whole bracketed paste arrives as one string). Mouse reports are
|
|
// arrays: ({ TUI_EV_MOUSE, button, x, y, pressed }).
|
|
// ---------------------------------------------------------------------------
|
|
|
|
// Object paths (extension-less: the driver resolves .lpc/.c)
|
|
#define TUI_DIR "/std/tui"
|
|
#define TUI_ANSI "/std/tui/ansi"
|
|
#define TUI_KEYS "/std/tui/keys"
|
|
#define TUI_READLINE "/std/tui/readline"
|
|
#define TUI_SCREEN "/std/tui/screen"
|
|
#define TUI_WIDGET "/std/tui/widget"
|
|
#define TUI_APP "/std/tui/app"
|
|
#define TUI_TERMINAL "/std/tui/terminal"
|
|
#define TUI_PRINT "/std/tui/print"
|
|
#define TUI_MENU "/std/tui/menu"
|
|
#define TUI_CANVAS "/std/tui/canvas"
|
|
|
|
// Special keys sit just above the Unicode range (max codepoint 0x10FFFF),
|
|
// so they can never collide with a real character.
|
|
#define TUI_KEY_SPECIAL 0x110000
|
|
#define TUI_KEY_UP (TUI_KEY_SPECIAL + 1)
|
|
#define TUI_KEY_DOWN (TUI_KEY_SPECIAL + 2)
|
|
#define TUI_KEY_RIGHT (TUI_KEY_SPECIAL + 3)
|
|
#define TUI_KEY_LEFT (TUI_KEY_SPECIAL + 4)
|
|
#define TUI_KEY_HOME (TUI_KEY_SPECIAL + 5)
|
|
#define TUI_KEY_END (TUI_KEY_SPECIAL + 6)
|
|
#define TUI_KEY_PGUP (TUI_KEY_SPECIAL + 7)
|
|
#define TUI_KEY_PGDN (TUI_KEY_SPECIAL + 8)
|
|
#define TUI_KEY_INSERT (TUI_KEY_SPECIAL + 9)
|
|
#define TUI_KEY_DELETE (TUI_KEY_SPECIAL + 10)
|
|
#define TUI_KEY_ENTER (TUI_KEY_SPECIAL + 11)
|
|
#define TUI_KEY_TAB (TUI_KEY_SPECIAL + 12)
|
|
#define TUI_KEY_BACKSPACE (TUI_KEY_SPECIAL + 13)
|
|
#define TUI_KEY_ESC (TUI_KEY_SPECIAL + 14)
|
|
#define TUI_KEY_F1 (TUI_KEY_SPECIAL + 21)
|
|
#define TUI_KEY_F2 (TUI_KEY_SPECIAL + 22)
|
|
#define TUI_KEY_F3 (TUI_KEY_SPECIAL + 23)
|
|
#define TUI_KEY_F4 (TUI_KEY_SPECIAL + 24)
|
|
#define TUI_KEY_F5 (TUI_KEY_SPECIAL + 25)
|
|
#define TUI_KEY_F6 (TUI_KEY_SPECIAL + 26)
|
|
#define TUI_KEY_F7 (TUI_KEY_SPECIAL + 27)
|
|
#define TUI_KEY_F8 (TUI_KEY_SPECIAL + 28)
|
|
#define TUI_KEY_F9 (TUI_KEY_SPECIAL + 29)
|
|
#define TUI_KEY_F10 (TUI_KEY_SPECIAL + 30)
|
|
#define TUI_KEY_F11 (TUI_KEY_SPECIAL + 31)
|
|
#define TUI_KEY_F12 (TUI_KEY_SPECIAL + 32)
|
|
#define TUI_KEY_UNKNOWN (TUI_KEY_SPECIAL + 63)
|
|
|
|
// Modifier bits, above the special-key range.
|
|
#define TUI_MOD_SHIFT 0x200000
|
|
#define TUI_MOD_ALT 0x400000
|
|
#define TUI_MOD_CTRL 0x800000
|
|
#define TUI_MODS (TUI_MOD_SHIFT | TUI_MOD_ALT | TUI_MOD_CTRL)
|
|
|
|
// Convenience: TUI_CTRL('a') is what Ctrl-A decodes to.
|
|
#define TUI_CTRL(c) (TUI_MOD_CTRL | (c))
|
|
#define TUI_ALT(c) (TUI_MOD_ALT | (c))
|
|
|
|
// Array-event kinds (first element of an array event)
|
|
#define TUI_EV_MOUSE 1
|
|
#define TUI_EV_CPR 2 /* cursor position report: ({ kind, row, col }) */
|
|
|
|
// readline engine states (rl_feed() return / rl_state())
|
|
#define TUI_RL_MORE 0 /* still editing */
|
|
#define TUI_RL_DONE 1 /* line accepted (Enter) */
|
|
#define TUI_RL_ABORT 2 /* Ctrl-C */
|
|
#define TUI_RL_EOF 3 /* Ctrl-D on an empty line */
|
|
|
|
// Box styles for scr_box()
|
|
#define TUI_BOX_SINGLE 0
|
|
#define TUI_BOX_DOUBLE 1
|
|
#define TUI_BOX_ROUND 2
|
|
#define TUI_BOX_ASCII 3
|
|
|
|
#endif
|