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

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

Merged
amr merged 2 commits from feature/v0.3.0-rendering-engine into main 2026-05-11 22:02:33 -04:00
Conversation 0 Commits 2 Files Changed 7 +128 -6
amr commented 2026-05-11 11:17:07 -04:00
Owner
Copy Link

Implements: v0.3.0 from ROADMAP.org

Adds:

  • render/1 generic function dispatching per component type
  • render-screen entry point with begin-sync/end-sync wrapper
  • render-node tree walker (layout → render → recurse children)
  • component-layout-node protocol generic (box/text methods)
  • component-children/component-parent protocol generics
  • propagate-dirty marks component + ancestors dirty
  • Box and Text now inherit from dirty-mixin

Tests: 42 assertions, 100% GREEN

Previous PRs: #2 (v0.0.1-v0.0.3: backend + layout), #3 (v0.2.0: Box/Text renderables)

**Implements:** v0.3.0 from ROADMAP.org **Adds:** - render/1 generic function dispatching per component type - render-screen entry point with begin-sync/end-sync wrapper - render-node tree walker (layout → render → recurse children) - component-layout-node protocol generic (box/text methods) - component-children/component-parent protocol generics - propagate-dirty marks component + ancestors dirty - Box and Text now inherit from dirty-mixin **Tests:** 42 assertions, 100% GREEN **Previous PRs:** #2 (v0.0.1-v0.0.3: backend + layout), #3 (v0.2.0: Box/Text renderables)
amr added 6 commits 2026-05-11 11:17:08 -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)
amr merged commit 5271f5a2ab into main 2026-05-11 22:02:33 -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#4
Delete Branch "feature/v0.3.0-rendering-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?