Repl.Spectre 0.9.2-dev.73

Repl.Spectre

Spectre.Console integration for Repl Toolkit. Provides rich interactive prompts, injectable IAnsiConsole, and beautiful table rendering.

Features

• Rich prompts — SelectionPrompt, MultiSelectionPrompt, ConfirmationPrompt, TextPrompt, and secret input via Spectre.Console
• IAnsiConsole injection — use IAnsiConsole as a command parameter to render tables, trees, panels, and other Spectre renderables
• Table output — the "spectre" output format renders collections as bordered Spectre tables with [Display] attribute support
• Banner support — inject IAnsiConsole into WithBanner() callbacks for rich startup banners (FigletText, Markup, etc.)
• Configurable capabilities — SpectreConsoleOptions to control Unicode rendering for different terminal environments

Setup

var app = ReplApp.Create(services =>
{
    services.AddSpectreConsole(); // DI: IAnsiConsole + SpectreInteractionHandler
})
.UseSpectreConsole(); // Output transformer + banner format + UTF-8 encoding

Two calls, two concerns:

Usage

Auto-rendered tables

Return a collection from a command — the output transformer renders it as a bordered Spectre table:

app.Map("list", (IContactStore store) => store.All());

Column headers are derived from [Display] attributes. No rendering code needed.

Direct IAnsiConsole injection

Inject IAnsiConsole to use any Spectre renderable:

app.Map("report", (IAnsiConsole console) =>
{
    var table = new Table().AddColumn("Name").AddColumn("Value");
    table.AddRow("Item", "42");
    console.Write(table);
});

Works with all Spectre renderables: Table, Tree, Panel, BarChart, Calendar, FigletText, Progress, Status, and more.

Transparent prompt upgrade

IReplInteractionChannel calls are automatically rendered as Spectre prompts:

No Spectre-specific code in handlers — the same handler works with or without the Spectre package.

Banner with IAnsiConsole

Use IAnsiConsole in banner callbacks for rich startup output:

app.WithBanner((IAnsiConsole console) =>
{
    console.Write(new FigletText("My App").Color(Color.Blue));
    console.MarkupLine("[grey]Type 'help' to get started[/]");
});

Configuration

UseSpectreConsole() accepts an optional callback to configure capabilities:

// Default: Unicode enabled
.UseSpectreConsole()

// Disable Unicode for limited terminals
.UseSpectreConsole(o => o.Unicode = false)

SpectreConsoleOptions

When Unicode is enabled, UseSpectreConsole() sets Console.OutputEncoding to UTF-8 to ensure Unicode characters (progress bars, spinners, box-drawing) render correctly on Windows.

Sample

See sample 07-spectre for a comprehensive demo covering 21 Spectre features across 14 commands.