v0.0.1: Backend Protocol — abstraction layer + simple backend #2

amr · 2026-05-11T08:45:37-04:00

amr commented

2026-05-11 08:45:37 -04:00

Implements: v0.0.1 from ROADMAP.org

Backend protocol — 18 generic functions for terminal rendering. Two backend classes: backend (abstract base) and simple-backend (ASCII, universal compatibility). Modern backend (raw escape sequences) deferred to a follow-up.

9 FiveAM tests, all GREEN.

Adds:

org/backend-protocol.org — literate source file
docs/ARCHITECTURE.org — full architecture doc
cl-tui.asd — ASDF system definitions
backend/package.lisp, backend/classes.lisp, backend/simple.lisp, backend/tests.lisp

To review: Check the generic function signatures in classes.lisp and the simple backend implementation in simple.lisp. The protocol is meant to be minimal — every function is something a real TUI needs. If anything looks missing or wrong, I can adjust before merging.

Next up: modern-backend (raw escape sequences, truecolor, DECICM sync).

**Implements:** v0.0.1 from ROADMAP.org **Backend protocol** — 18 generic functions for terminal rendering. Two backend classes: `backend` (abstract base) and `simple-backend` (ASCII, universal compatibility). Modern backend (raw escape sequences) deferred to a follow-up. **9 FiveAM tests, all GREEN.** **Adds:** - `org/backend-protocol.org` — literate source file - `docs/ARCHITECTURE.org` — full architecture doc - `cl-tui.asd` — ASDF system definitions - `backend/package.lisp`, `backend/classes.lisp`, `backend/simple.lisp`, `backend/tests.lisp` **To review:** Check the generic function signatures in `classes.lisp` and the simple backend implementation in `simple.lisp`. The protocol is meant to be minimal — every function is something a real TUI needs. If anything looks missing or wrong, I can adjust before merging. Next up: modern-backend (raw escape sequences, truecolor, DECICM sync).

amr added 2 commits 2026-05-11 08:45:37 -04:00

test: check token permissions bd22f1a43d

v0.0.1: backend protocol — abstraction layer + simple backend db59fa4f55

Implement the backend protocol with two backends (modern planned,
simple done). Includes package definitions, CLOS generic protocol,
simple-backend with ASCII borders, and 9 FiveAM tests.

RED: 9/9 tests failing (no implementation)
GREEN: 9/9 tests passing

- backend/package.lisp — defpackage, exports
- backend/classes.lisp — backend base class, 18 generics
- backend/simple.lisp — simple-backend implementation
- backend/tests.lisp — 9 FiveAM test cases
- org/backend-protocol.org — literate source

amr added 1 commit 2026-05-11 08:53:56 -04:00

v0.0.2: modern backend — raw escape sequences 0397d1de2c

Implements the modern-backend with truecolor SGR, Unicode box-drawing
(rounded/double/single), DECICM synchronized updates, OSC 8 hyperlinks,
cursor style control, and hex color parsing.

RED: 32 checks, 5 fail (class forward-ref + test bug)
GREEN: 32/32 checks passing (100%)

- backend/modern.lisp — escape generators + modern-backend class
- backend/modern-tests.lisp — 16 test cases, 32 assertions
- backend/package.lisp — updated exports
- org/modern-backend.org — literate source

amr added 1 commit 2026-05-11 09:12:36 -04:00

v0.0.3: layout engine — pure CL Flexbox constraint solver and push 5e17e3d509

amr added 1 commit 2026-05-11 09:39:28 -04:00

v0.0.3: layout engine — pure CL Flexbox solver, 35/35 tests GREEN 2231fb6647

Fixes during debugging:
- Variable scope: loop's closing parens closed the let* prematurely,
  making children/is-row/pr/pb undefined in own-size calculation
- gap NIL bug: make-layout-node passed :gap nil (from &key default)
  to make-instance, overriding :initform 0 → (* nil ...) crash
- Child order: push (LIFO) in add-child reversed children order;
  changed to nconc (FIFO), removed the compensating reverse
- Fixed distribute-sizes to base all children from their fixed size
  then apply grow/shrink on top, instead of treating fixed-size
  children as non-participating

amr added 1 commit 2026-05-11 10:08:53 -04:00

review fixes: 3 blocking bugs + 2 improvements 2b6fc32425

B1: modern-backend now inherits from backend (was standalone class)
B2: draw-rect y-position bug — loop now tracks row offset
B3: Layout module added to ASDF system definition
I1: 6 smoke tests replaced with behavioral tests (captured output)
I3: 6 edge case tests: empty, single-child, zero-size, deep
    nesting, large padding, negative grow

Also fixed:
- Added missing make-simple-backend constructor to simple.lisp
- Added in-package to classes.lisp and simple.lisp (SBCL's load
  restores *package* after each load, breaking batch-mode loading)

amr merged commit 76f4477313 into main

2026-05-11 10:30:54 -04:00

amr referenced this issue from a commit

2026-05-11 10:30:55 -04:00

Merge pull request 'v0.0.1: Backend Protocol — abstraction layer + simple backend' (#2) from feature/v0.0.1-backend-protocol into main

amr referenced this pull request

2026-05-11 10:49:13 -04:00

v0.2.0: Box and Text renderables + dirty tracking #3

amr referenced this pull request

2026-05-11 11:17:07 -04:00

v0.3.0: Rendering pipeline — render dispatch, tree walk, dirty propagation #4

amr referenced this pull request