TimeWarp.Terminal 1.0.0-beta.1

TimeWarp.Terminal

Terminal abstractions and widgets for console applications - IConsole, ITerminal, panels, tables, rules, and ANSI color support.

Interfaces

IConsole

Basic console I/O abstraction for testable console applications.

public interface IConsole
{
    void Write(string message);
    void WriteLine(string? message = null);
    void WriteErrorLine(string? message = null);
    string? ReadLine();
}

ITerminal

Extended terminal interface with cursor control, colors, and hyperlinks.

public interface ITerminal : IConsole
{
    ConsoleKeyInfo ReadKey(bool intercept);
    void SetCursorPosition(int left, int top);
    (int Left, int Top) GetCursorPosition();
    int WindowWidth { get; }
    bool IsInteractive { get; }
    bool SupportsColor { get; }
    bool SupportsHyperlinks { get; }
    void Clear();
}

Implementations

Testing Example

var terminal = new TestTerminal();
terminal.QueueInput("user input");

// Run code that uses ITerminal
myCommand.Execute(terminal);

// Verify output
Assert.Contains("expected text", terminal.GetOutput());

Widgets

Panel

Bordered panel with title and content.

terminal.WritePanel(panel => panel
    .WithTitle("Status")
    .WithContent("All systems operational")
    .WithBorder(BorderStyle.Rounded));

Table

Formatted table with columns and rows.

terminal.WriteTable(table => table
    .AddColumn("Name")
    .AddColumn("Value")
    .AddRow("CPU", "45%")
    .AddRow("Memory", "2.1 GB"));

Rule

Horizontal rule with optional title.

terminal.WriteRule(rule => rule
    .WithTitle("Section")
    .WithStyle(LineStyle.Double));

ANSI Colors

Extension methods for colored console output.

terminal.WriteLine("Success!".Green());
terminal.WriteLine("Warning!".Yellow().Bold());
terminal.WriteLine("Error!".Red().OnWhite());

Available Colors

Black, Red, Green, Yellow, Blue, Magenta, Cyan, White

Bright variants: BrightRed, BrightGreen, etc.

Styles

Bold(), Dim(), Italic(), Underline(), Strikethrough()

Background Colors

OnRed(), OnGreen(), OnBlue(), etc.

Hyperlinks

Terminal hyperlinks (OSC 8) for supported terminals.

terminal.WriteHyperlink("Click here", "https://example.com");

// Or using extension method
terminal.WriteLine("Visit ".WithHyperlink("our site", "https://example.com"));