spectre.console/src/Spectre.Console/Cli/Internal/Composer.cs

namespace Spectre.Console.Cli;

internal sealed class Composer : IRenderable
{
    private readonly StringBuilder _content;

    public Composer()
    {
        _content = new StringBuilder();
    }

    public Composer Text(string text)
    {
        _content.Append(text);
        return this;
    }

    public Composer Style(string style, string text)
    {
        _content.Append('[').Append(style).Append(']');
        _content.Append(text.EscapeMarkup());
        _content.Append("[/]");
        return this;
    }

    public Composer Style(string style, Action<Composer> action)
    {
        _content.Append('[').Append(style).Append(']');
        action(this);
        _content.Append("[/]");
        return this;
    }

    public Composer Space()
    {
        return Spaces(1);
    }

    public Composer Spaces(int count)
    {
        return Repeat(' ', count);
    }

    public Composer Tab()
    {
        return Tabs(1);
    }

    public Composer Tabs(int count)
    {
        return Spaces(count * 4);
    }

    public Composer Repeat(char character, int count)
    {
        _content.Append(new string(character, count));
        return this;
    }

    public Composer LineBreak()
    {
        return LineBreaks(1);
    }

    public Composer LineBreaks(int count)
    {
        for (var i = 0; i < count; i++)
        {
            _content.Append(Environment.NewLine);
        }

        return this;
    }

    public Composer Join(string separator, IEnumerable<string> composers)
    {
        if (composers != null)
        {
            Space();
            Text(string.Join(separator, composers));
        }

        return this;
    }

    public Measurement Measure(RenderContext context, int maxWidth)
    {
        return ((IRenderable)new Markup(_content.ToString())).Measure(context, maxWidth);
    }

    public IEnumerable<Segment> Render(RenderContext context, int maxWidth)
    {
        return ((IRenderable)new Markup(_content.ToString())).Render(context, maxWidth);
    }

    public override string ToString()
    {
        return _content.ToString();
    }
}