dragon-parchment

What problem does it solve?

Floating UI panels in terminal-based agent extensions are hard to position, focus, and manage across sessions; dragon-parchment centralizes panel lifecycle, positioning, focus cycling, collision avoidance, and render invalidation so extensions can add panels reliably without reimplementing layout logic.

Core Features & Use Cases

• Centralized panel lifecycle: create, list, focus, cycle, and dispose panels with consistent behavior across extensions.
• Smart placement & anchors: auto-placement, suggested layouts for multiple panels, and panel-relative anchoring for contextual detail views.
• Focus & key hint integration: built-in focus cycling, configurable hotkeys, and key hint metadata so components don't conflict with global controls.
• TUI-friendly rendering: cached render patterns, width-aware line rendering, and invalidation hooks to keep panels performant.
• Use Case: Add a contextual detail panel to a list view that opens anchored to the selected item, stacks correctly with other panels, and participates in global focus cycling.

Quick Start

Ask the agent to createPanel with an id and factory, set anchor to right-center and width to 30% and focusOnOpen to true to open a new floating panel.