Home Esplora Aiuto
Accedi
eric
/
Tigr-m2
1
0
Forka 0
File Problemi 0 Pull Requests 0 Wiki
Albero (Tree): b4b1ecbb96
Rami (Branch) Tag
Tigr-m2
/
tvision-m2
/
SUMMARY.md

SUMMARY.md 4.5 KB
Cronologia Originale

tvision-m2 - milestone summary (2026-09-16)

A TVision/Turbo-Vision style character-cell UI toolkit written in ISO GNU Modula-2 (gm2 -fiso) for the terminal, developed alongside the tigr and microui bindings in this repository. No C source and no graphics dependency; the only non-Modula-2 part is the libc binding tvtty.def.

Status

Working milestone: a retained view tree with clipping and z-order, a diffed ANSI screen, keyboard + mouse input, widgets and modal dialogs. Builds warning-free and was exercised by driving a real pty (frames reconstructed from the captured terminal stream).

Files

file role
tvtty.def libc binding: raw mode, winsize, read/write
tv.def / tv.mod screen, view tree, widgets, events, modal dialog
demo.mod demo application (two windows, all widgets, mouse)
ttysize.mod diagnostic for the tty binding
Makefile build
README.md build/run + API + GM2 notes

Implemented

  • Alternate screen, hidden/show cursor, terminal restore on exit.
  • 16-colour fg/bg, explicit blink on/off, UTF-8 box drawing, clipping stack.
  • Diffed redraw: only changed cells are written.
  • View tree: groups and windows own children; per-window clipping; z-order with click-to-front; windows draggable by the title row (any direction) and clamped so the title stays on screen; X close box.
  • Widgets: static text, frame, input line (insert/backspace/delete/Home/End/ arrows), push button, check box, radio buttons, list box (selection, wheel scroll) and vertical scroll bar.
  • Focus chain (Tab / Shift-Tab / up-down); hardware cursor in the focused input; Enter/Space activate.
  • Keyboard decoding: printable UTF-8, arrows, Home/End, PgUp/PgDn, Ins/Del, F1-F12, Enter, Space, Backspace, Esc, Ctrl-C.
  • Mouse: xterm SGR reporting (mode 1002/1006) - click to focus/press, drag titles, click list rows, wheel scroll.
  • Generic modal dialog builder (Dialog/Dlg*/DlgRun) with inputs, check boxes (self-exclusive radio groups) and tagged buttons; MessageBox (OK / OK-Cancel / Yes-No) and the Message shorthand.
  • SIGWINCH-driven resize detection via a libc signal handler.
  • Multi-line editor widget (VEditor) with insert/overwrite, navigation, Tab indent, mouse positioning, a Ln/Col/Insert/Modified status row and file load/save; syntax highlighting for Modula-2/Pascal/Oberon and automatic keyword up-casing and auto-indentation for Modula-2/Oberon (indent after open keywords, dedent on close keywords); demo examples/edit (with a Syntax menu to switch language).
  • Example programs (empty, window, dialog, menus, edit, gfx); API reference (API.md) and tutorial (TUTORIAL.md).
  • tigr graphics backend (tvg): the same view tree rendered in a window. Text uses a bundled 8x16 monospaced VGA font (tvfont, public-domain IBM VGA glyphs) so no system font is needed; box drawing is line segments; tigr keyboard/mouse are mapped to tv events. tv.InitVirtual lets any driver set the virtual screen size without touching the terminal.
  • Menu bar with drop-down menus: click or F10 to open, Left/Right switch menus, Up/Down move, Enter/Space or click selects (returns the item tag); separators supported.

Verified

Driving the demo through a pty and reconstructing the screen:

  • initial layout (Editor + About windows, list, radios, check box, buttons, status bar) renders correctly;
  • clicking OK with the mouse opens the modal Info box;
  • dragging the title moves the window in every direction and clamps at the top-left so the title stays visible;
  • clicking the File title opens the drop-down (New/Open/Sep/Quit), F10
    • Enter selects the first item (status shows the command tag), and clicking Quit exits the program.

Known limitations / next steps

  • Menu items have no hotkeys; no check/radio menu items.
  • No form validation or file/directory dialog.
  • The graphics window uses integer scaling (TIGR_FIXED); no per-window font size or resizable grid yet.
  • Windows are not resizable; no hover highlight.
  • Terminal size is polled (no SIGWINCH-driven relayout).
  • Nested clipping groups beyond windows are untested.

GNU Modula-2 notes

See README.md: value-returning no-arg procedures need () in the .def; pointer fields need ^; a BEGIN...END block cannot be a CASE branch; INTEGER vs HIGH() comparisons need VAL; termios/winsize use fixed Linux offsets. A subtle runtime bug was found and fixed in the ANSI output: SGR attributes accumulate, so blink must be emitted explicitly as ;5/;25 or it leaks into every following cell.