repository·main·Indexed 42 days ago
https://github.com/xenoatom/xenoatom.terminal.uiA reactive, retained-mode terminal user interface framework for .NET 10 (C# 14). It enables the creation of inline terminal widgets and complex fullscreen applications using a binding-first UI model. Features include a rich set of over 60 built-in controls (such as DataGridControl, CodeEditor, and various layout stacks), support for Nerd Font glyphs, and a Brush API for linear gradients. Built on top of XenoAtom.Terminal for ANSI/markup output and input events.
The XenoAtom.Terminal.UI.Text module provides the core text model and editing infrastructure required for text-oriented controls in the terminal. It is designed to handle complex text editing scenarios by providing abstractions for:
The XenoAtom.Terminal.UI namespace is the core of the retained-mode terminal UI framework. It provides the fundamental primitives required to build terminal interfaces, including:
XenoAtom.Terminal.UI.Templating infrastructure provides the tools necessary to build terminal-based visuals from bound data. It allows developers to define how data structures should be rendered into the UI using a combination of template delegates, context objects, and role-aware item templating.XenoAtom.Terminal serves as the core terminal abstraction layer for the ecosystem. It provides the fundamental host-facing primitives required for managing I/O, detecting terminal capabilities, handling input events, and performing atomic output operations. This layer acts as the foundation upon which XenoAtom.Terminal.UI is built.The XenoAtom.Terminal.UI.Extensions.Markdown package provides a markdown integration layer for XenoAtom.Terminal.UI. It enables the parsing of Markdown content and its conversion into the terminal UI's internal document-flow model.
Key capabilities include:
DocumentFlow, Paragraph, and other terminal UI controls.The extension is built on top of the Markdig library and supports CommonMark along with selected extensions, optimized for efficient rendering within a terminal environment.
The XenoAtom.Terminal.UI.Styling system provides a framework for customizing the visual appearance of terminal controls. It is built around three core pillars:
XenoAtom.Terminal.UI is a modern retained-mode terminal UI framework built on top of XenoAtom.Terminal. It provides two primary modes of operation:
Terminal.Write or Terminal.Live.DataGridControl and TabControl.The XenoAtom.Terminal.UI.Controls namespace provides the built-in library of controls and visual components used to compose terminal user interfaces. It offers a range of components from low-level layout containers to high-level interactive widgets.
Available component categories include:
XenoAtom.Terminal.UI.Figlet extension provides support for FIGlet font parsing, metadata management, and text rendering. It is primarily used to provide predefined fonts and utilities for large text banner controls within the terminal UI ecosystem.The XenoAtom.Terminal.UI.Prompts library provides high-level, reusable prompt abstractions built on top of standard terminal UI controls. Instead of manually managing low-level controls, you can use these specialized prompt types to handle common user interaction patterns:
These prompts are designed to be integrated into terminal applications to provide a consistent and intuitive user experience.
The xenoatom.terminal.ui library provides a comprehensive set of controls categorized by their functional purpose. You can find detailed specifications for each control in the documentation to understand their behavior, properties, and usage patterns.
TextBox, TextArea, MaskedInput, NumberBox, ColorPicker).Button, CheckBox, RadioButton, Switch, Link).ListBox, TreeView, Select, Slider).VStack, HStack, Grid, DockLayout, Border, Group).ScrollViewer, ScrollBar).TabControl, MenuBar, CommandPalette, StatusBar).Table, DataGridControl, TextBlock, MarkdownControl, ProgressBar, Charts).Popup, Dialog, Tooltip, Toast).Menu System (combining MenuBar and context menus).