amr/cl-tty
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.4.0: Theme engine — semantic colors, presets, dark/light #5

Merged
amr merged 5 commits from feature/v0.4.0-theme-engine into main 2026-05-11 22:02:45 -04:00
Conversation 0 Commits 5 Files Changed 14 +4453 -6
amr commented 2026-05-11 11:27:56 -04:00
Owner
Copy Link

Implements: v0.4.0 from ROADMAP.org

Adds:

  • Theme class with role→hex hash table, dark/light mode
  • theme-color reader/writer (setf-able)
  • define-preset macro with keyword check and dark/light variants
  • load-preset function with warning for unknown presets
  • 2 built-in presets: default (gold) and nord
  • 30+ semantic roles per preset (primary, error, syntax-*, etc.)

Tests: 58 assertions, 100% GREEN

Previous PRs: #2 (backend+layout), #3 (Box/Text), #4 (rendering pipeline)

**Implements:** v0.4.0 from ROADMAP.org **Adds:** - Theme class with role→hex hash table, dark/light mode - theme-color reader/writer (setf-able) - define-preset macro with keyword check and dark/light variants - load-preset function with warning for unknown presets - 2 built-in presets: default (gold) and nord - 30+ semantic roles per preset (primary, error, syntax-*, etc.) **Tests:** 58 assertions, 100% GREEN **Previous PRs:** #2 (backend+layout), #3 (Box/Text), #4 (rendering pipeline)
amr added 8 commits 2026-05-11 11:27:56 -04:00
v0.2.0: Box renderable — border, background, and title a5f8e6c9d4 
- Box class with border-style, title, fg/bg slots
- render-box dispatches through backend protocol
- draw-border for borders, draw-rect for background
- draw-text for title below top border
- 7 tests: defaults, border, background, title, no-border,
  zero-size, minimum-size
- 13 assertions, 100% GREEN
- ASDF updated with src/components module
- modern-backend now accepts :output-stream initarg
v0.2.0: Text renderable with word-wrap and inline spans 5672aaf3fd 
- Text class with content, fg/bg, wrap-mode (:word or :none)
- Span class for inline styled segments (bold, italic, etc.)
- render-text dispatches through backend's draw-text
- word-wrap function splits text at word boundaries
- split-string utility for whitespace tokenization
- 9 new tests: creation, content, empty, truncation, word-wrap,
  single-word, span creation, span storage
- modern-backend now accepts :output-stream
- ASDF updated with text component
- 28 total component tests, 100% GREEN
v0.2.0: Dirty tracking — dirty-mixin, mark-clean, mark-dirty a1b1352d10 
- dirty-mixin class with dirty slot (initform t)
- mark-clean clears dirty flag
- mark-dirty sets dirty flag
- 3 tests: default-dirty, clean, dirty-cycle
- ROADMAP.org: v0.2.0 all tasks DONE
- 31 component tests, 100% GREEN
review fixes: word-wrap hard-break, title-align, ASDF fix, edge cases 88c576a6b9 
Fixes from subagent review:
- Word-wrap now hard-breaks words exceeding max-width (was returning
  un-truncated overflow strings)
- Box zero-size guard now catches any zero/single dimension (was only
  catching both zero together)
- Title-align now respected (:left/:center/:right) with proper positioning
- render-text declares (ignore spans) to suppress unused warning
- ASDF test-op fixed: run! → run-tests (symbol didn't exist)
- New test: box-single-column (width=1 renders nothing)
- Tightened word-wrap test: verifies hard-break produces both chunks
- Simplified word-wrap with cond instead of nested if/progn (avoided
  recurring paren-balance issue)
v0.3.0: Rendering pipeline — render dispatch, tree walk, dirty propagation b0e5c18257 
- render generic function dispatches per component type
- render-screen entry point with sync wrapper
- render-node walks tree, computes layout, calls render
- component-layout-node generic (box/text methods)
- component-children/component-parent generics
- propagate-dirty marks component + ancestors dirty
- box and text now inherit from dirty-mixin
- 6 new tests: render dispatch, layout-node accessor, children,
  dirty propagation, available-width defaults
- 42 component tests, 100% GREEN
review fixes: in-suite, version bump, default children method 6ba69f4610 
Fixes from subagent review:
- render-tests.lisp: added (in-suite box-suite) — tests were registered
  to default suite, never executed by runner
- dirty-tests.lisp: same fix
- cl-tui.asd: version 0.2.0 → 0.3.0
- render.lisp: component-children default method (c t) nil for
  protocol completeness (component-parent already had this)
v0.4.0: Theme engine — semantic colors, presets, dark/light variants 0851311c3d 
- Theme class with role→hex hash table, mode (dark/light)
- theme-color reader/writer (gethash based)
- define-preset macro with dark and light variants
- load-preset function with keyword lookup
- 2 built-in presets: default (gold) and nord
- 30+ semantic roles per preset (primary, accent, error, syntax-*, etc.)
- 9 theme tests: create, set/get, unknown, dark/light presets,
  nord, unknown-warn, switch-mode
- 57 total component tests, 100% GREEN
review fixes: version bump, keyword check, warning assertion 2d3227aaf1 
Fixes from subagent review:
- ASDF version 0.3.0 → 0.4.0
- define-preset now checks (check-type name keyword) at macro-expand time
- load-preset-unknown-warns test now uses (signals warning ...) to
  actually verify the warning fires (was false-positive before)
amr added 1 commit 2026-05-11 11:27:57 -04:00
review fixes: version bump, keyword check, warning assertion 2d3227aaf1 
Fixes from subagent review:
- ASDF version 0.3.0 → 0.4.0
- define-preset now checks (check-type name keyword) at macro-expand time
- load-preset-unknown-warns test now uses (signals warning ...) to
  actually verify the warning fires (was false-positive before)
amr added 1 commit 2026-05-11 12:31:08 -04:00
v0.5.0: Text input + keybinding system f07cb65186 
Four new modules:
- input.lisp: terminal raw mode, escape sequence parser, key/mouse event
  structs, read-event backend integration
- text-input.lisp: single-line text input with cursor, insertion,
  deletion, ctrl-A/E/W/U/K, on-submit callback, max-length
- textarea.lisp: multi-line text input with cursor up/down, newline,
  backspace joins lines, delete, undo/redo stack
- keybindings.lisp: layered keymap dispatch (global/local/focused),
  defkeymap macro, key spec matching with modifier prefixes

60 test assertions, 100% GREEN:
  RED: 0/12, 0/27, 0/30 — no tests existed
  GREEN: 60/60 across backend (27), box (58), input (60)

Dependencies: sb-posix for terminal raw mode (tcgetattr/tcsetattr)
Test files: 30 input tests covering all widgets and keybinding system
amr added 1 commit 2026-05-11 12:39:05 -04:00
docs: sync org file with working code c55f1773fb 
The .lisp files were edited directly during REPL-driven development.
Pushed all fixes back into the org source of truth:

- Fixed defstruct positional constructor wrappers
- Fixed case+string eql trap (cond+string=)
- Fixed CL string escape sequences (multiline literals)
- Fixed FiveAM closure capture (list boxing)
- Fixed textarea format calls (%join-lines helper)
- Fixed tangle paths for all 5 code blocks
- Consolidated all tests into single test block
- Updated key-match-p, dispatch-key-event, defkeymap macro

All 60 tests pass (100% GREEN).
amr added 1 commit 2026-05-11 12:51:09 -04:00
docs: restructure org for per-function literate prose 3b0410b088 
37 per-function code blocks with prose explaining design reasoning,
edge cases, and CL traps. Combined tangle blocks at end for actual
compilation.

New scripts/tangle.py: reliable Python tangler (emacs --batch failed).
Added: %split-string, %join-lines, tangle helper.

CL traps documented in org prose:
- defstruct generates keyword constructors (no :constructor needed)
- case with strings uses EQL — use cond + string=
- CL strings: no \n escape — use (string #\Newline)
- FiveAM closure capture — use list boxing
- read-byte is package-locked — use read-raw-byte
- ASDF compile-file stricter than LOAD — debug with LOAD

60 tests, 100% GREEN.
amr merged commit 915e4f9d2c into main 2026-05-11 22:02:45 -04:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
amr
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: amr/cl-tty#5
Delete Branch "feature/v0.4.0-theme-engine"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?