Files
cl-tty/demo.lisp
Hermes Agent 47094c48e5 restructure: move backend/ and layout/ into src/; convert README to org syntax; fix demo package conflict and alien-sap ioctl; update ROADMAP with v0.15.0; remove stale files
- Move backend/ and layout/ directories into src/
- Update all path references in ASD, scripts, docs
- Convert README.org from Markdown syntax to proper Org-mode
- Fix demo.lisp use-package conflict (both backend and input export #:read-event)
- Fix modern-backend TIOCGWINSZ ioctl alien type (alien-sap wrapper)
- Add v0.15.0 section to ROADMAP, update line count to 5760
- Add known gaps (suspend/resume-backend, slot modes) to v1.0.0 checklist
- Remove docs/plans/, debug-layout.lisp, system-index.txt, ci-watchdog.sh
- Move tangle.py to Hermes skill (org-babel-tangle)
- Add .gitignore for fasl files
2026-05-12 16:57:19 +00:00

217 lines
10 KiB
Common Lisp

;;; demo.lisp — cl-tty interactive demo
;;; Run: sbcl --script demo.lisp
;; Load cl-tty directly via ASDF (no Quicklisp dependency needed —
;; sb-posix is built into SBCL, no external libraries required).
(require "asdf")
(push (truename ".") asdf:*central-registry*)
(asdf:load-system :cl-tty)
;; Symbols use explicit package prefixes to avoid read-event
;; conflict between cl-tty.backend and cl-tty.input.
;; Short aliases for readability
(import '(cl-tty.input:make-text-input
cl-tty.input:text-input-value
cl-tty.input:handle-text-input
cl-tty.input:make-textarea
cl-tty.input:textarea-lines
cl-tty.input:handle-textarea-input))
;;; ─── Application state ───────────────────────────────────────────────────────
(defvar *app* nil "Application state plist")
(defvar *log* nil "Circular log buffer")
(defun log-append (fmt &rest args)
(let* ((msg (apply #'format nil fmt args))
(ts (multiple-value-bind (h m s) (get-decoded-time)
(format nil "~2,'0d:~2,'0d:~2,'0d" h m s))))
(push (format nil "[~a] ~a" ts msg) *log*)
(when (> (length *log*) 100) (setf *log* (subseq *log* 0 100)))))
(defun init-app-state ()
(setf *log* nil)
(setf *app* (list :tab 0
:input (make-text-input :placeholder "Type here...")
:textarea (make-textarea :value "Hello\nWorld")
:running t
:mouse-x -1 :mouse-y -1))
(log-append "Demo started"))
;;; ─── Tab renderers ──────────────────────────────────────────────────────────
(defun render-tab-home (backend x y w h)
"Welcome screen with version info."
(declare (ignore h))
(cl-tty.backend:draw-border backend x y w 18 :style :double :title " Welcome ")
(cl-tty.backend:draw-text backend (+ x 2) (+ y 2)
"cl-tty — Pure CL Terminal UI Framework" :bright-white nil :bold t)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 4)
" components: Box, Text, TextInput, TextArea, Select," nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 5)
" ScrollBox, TabBar, Dialog, Toast, Markdown" nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 6)
" features: 24-bit truecolor, OSC 8 links, SGR mouse," nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 7)
" DECICM sync, kitty keyboard, framebuffer" nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 8)
" backend: modern-backend | simple-backend (pipe-safe)" nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 9)
" tests: 483, 100% passing" :green nil :bold t)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 10)
" deps: zero FFI, zero ncurses, pure CL" :bright-cyan nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 12)
"Controls" :bright-white nil :bold t)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 13)
" Tab / arrows switch tabs" nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 14)
" Ctrl+C / Esc quit" nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 15)
" mouse click/drag select text (test SGR mouse)" nil nil))
(defun render-tab-widgets (backend x y w h input ta)
"Interactive widget demo."
(declare (ignore h))
(cl-tty.backend:draw-border backend x y w 12 :style :single :title " Text Input ")
(let ((val (text-input-value input)))
(cl-tty.backend:draw-text backend (+ x 2) (+ y 1) "Value: " :text-muted nil)
(cl-tty.backend:draw-text backend (+ x 10) (+ y 1)
(if (plusp (length val)) val "(empty)") :text nil))
(cl-tty.backend:draw-text backend (+ x 2) (+ y 3)
"Placeholder: \"Type here...\"" :text-muted nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 5)
"Keys: type to insert, arrows to move," nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 6)
"Enter to submit, Backspace to delete," nil nil)
(cl-tty.backend:draw-text backend (+ x 2) (+ y 7)
"Ctrl+A/E for home/end" nil nil)
(when (plusp (length (text-input-value input)))
(cl-tty.backend:draw-text backend (+ x 2) (+ y 9)
(format nil "Submitted: ~a" (text-input-value input)) :accent nil))
(let ((y2 (+ y 13)))
(cl-tty.backend:draw-border backend x y2 w 10 :style :single :title " TextArea ")
(cl-tty.backend:draw-text backend (+ x 2) (+ y2 1) "Value:" :text-muted nil)
(let ((lines (textarea-lines ta)))
(loop for line in lines
for row from 0 below (min (length lines) 6)
do (cl-tty.backend:draw-text backend (+ x 2) (+ y2 2 row)
(subseq (or line "") 0 (min (length line) (- w 4))) nil nil)))))
(defun render-tab-console (backend x y w h)
"Event log / debug console."
(cl-tty.backend:draw-border backend x y w h :style :single :title " Event Log ")
(cl-tty.backend:draw-text backend (+ x 2) (+ y 1)
"Last 50 keyboard and mouse events:" :text-muted nil)
(let ((lines *log*)
(max-rows (- h 3)))
(loop for line in (subseq lines 0 (min (length lines) max-rows))
for row from 0 below max-rows
do (cl-tty.backend:draw-text backend (+ x 2) (+ y 3 row)
(subseq (or line "") 0 (min (length line) (- w 4))) nil nil))))
;;; ─── Main loop ──────────────────────────────────────────────────────────────
(defun handle-event (event)
"Process a key-event or mouse-event, returning t if consumed."
(typecase event
(cl-tty.input:key-event
(let ((key (cl-tty.input:key-event-key event))
(ctrl (cl-tty.input:key-event-ctrl event)))
(log-append "Key: ~a (ctrl=~a alt=~a shift=~a)" key ctrl
(cl-tty.input:key-event-alt event)
(cl-tty.input:key-event-shift event))
(cond
((or (and ctrl (eql key :|C|)) (eql key :escape))
(setf (getf *app* :running) nil) t)
((eql key :tab)
(incf (getf *app* :tab))
(when (> (getf *app* :tab) 2) (setf (getf *app* :tab) 0)) t)
;; Only arrow keys switch tabs when NOT on the Widgets tab.
;; On the Widgets tab (tab=1), Left/Right are forwarded to widgets
;; for cursor navigation in text inputs.
((and (not (= (getf *app* :tab) 1))
(eql key :left))
(decf (getf *app* :tab))
(when (minusp (getf *app* :tab)) (setf (getf *app* :tab) 2)) t)
((and (not (= (getf *app* :tab) 1))
(eql key :right))
(incf (getf *app* :tab))
(when (> (getf *app* :tab) 2) (setf (getf *app* :tab) 0)) t)
;; Forward key to widgets only when on the Widgets tab
(t (when (= (getf *app* :tab) 1)
(handle-text-input (getf *app* :input) event)
(handle-textarea-input (getf *app* :textarea) event))
t))))
(cl-tty.input:mouse-event
(log-append "Mouse: ~a btn=~a pos=(~d,~d)"
(cl-tty.input:mouse-event-type event)
(cl-tty.input:mouse-event-button event)
(cl-tty.input:mouse-event-x event)
(cl-tty.input:mouse-event-y event))
(setf (getf *app* :mouse-x) (cl-tty.input:mouse-event-x event)
(getf *app* :mouse-y) (cl-tty.input:mouse-event-y event))
t)))
(defun run-demo ()
"Run the demo. Raw terminal mode should already be set by the
./demo.sh shell wrapper."
(init-app-state)
(let* ((backend (cl-tty.backend:detect-backend))
(w (multiple-value-bind (cols rows) (cl-tty.backend:backend-size backend)
(declare (ignore rows))
cols))
(h (multiple-value-bind (cols rows) (cl-tty.backend:backend-size backend)
(declare (ignore cols))
rows)))
(cl-tty.backend:initialize-backend backend)
(unwind-protect
(loop while (getf *app* :running)
do
(cl-tty.backend:backend-clear backend)
;; Title bar
(cl-tty.backend:draw-border backend 2 1 (- w 4) 3
:style :double :title " cl-tty v0.15.0 ")
(cl-tty.backend:draw-text backend 4 2
"arrows/tab: tabs type: test input mouse: test SGR Esc/Ctrl+C: quit"
:bright-white nil)
;; Tab bar
(loop for (label . idx) in '((" Home " . 0) (" Widgets " . 1) (" Console " . 2))
for x-pos = 4 then (+ x-pos label-len 2)
for label-len = (length label)
do (let ((active (eql idx (getf *app* :tab))))
(if active
(cl-tty.backend:draw-text backend x-pos 4 label
:bright-white :accent :bold t)
(cl-tty.backend:draw-text backend x-pos 4 label
:text-muted nil))))
;; Content area
(case (getf *app* :tab)
(0 (render-tab-home backend 4 6 (- w 4) (- h 8)))
(1 (render-tab-widgets backend 4 6 (- w 4) (- h 8)
(getf *app* :input)
(getf *app* :textarea)))
(2 (render-tab-console backend 4 6 (- w 4) (- h 8))))
;; Mouse cursor indicator
(let ((mx (getf *app* :mouse-x))
(my (getf *app* :mouse-y)))
(when (and (>= mx 0) (>= my 0))
(cl-tty.backend:draw-text backend mx my "@" :bright-cyan nil)))
;; Status bar
(cl-tty.backend:draw-rect backend 2 (- h 2) (- w 4) 1 :bg :blue)
(cl-tty.backend:draw-text backend 4 (- h 2)
(format nil " Tab ~d/3 | ~d events "
(1+ (getf *app* :tab)) (length *log*))
:bright-white :blue :bold t)
(finish-output *standard-output*)
;; Read event — blocks until a key or mouse event arrives
(let ((event (cl-tty.input:read-event backend)))
(cond
((eq event :eof) (setf (getf *app* :running) nil))
(event (handle-event event)))))
(cl-tty.backend:shutdown-backend backend))))
(run-demo)
(uiop:quit 0)