namespace Flaro.Api;

/// <summary>Wie hoch der Aufmacher auf der Startseite steht.</summary>
///
/// <remarks>
/// <para>
/// <b>Vier Stufen, keine Zahl.</b> Eine Pixelzahl einzustellen hiesse, sie
/// für jeden Bildschirm neu einzustellen — der Aufmacher misst sich an der
/// Fensterhöhe, nicht an einer festen Grösse. Vier Wörter sind das, was man
/// dazu zu sagen hat.
/// </para>
/// <para>
/// <b>Was die Stufen bedeuten, steht im Regelwerk</b>, nicht hier: der Server
/// weiss nichts von Bildpunkten, er merkt sich nur die Wahl. Nachzulesen bei
/// <c>.hero</c> in <c>style.css</c>.
/// </para>
/// <para>
/// <b>Serverweit.</b> Dieselbe Linie wie bei den Wiedergaberegeln: eine
/// Entscheidung des Gastgebers, nicht des Gastes.
/// </para>
/// </remarks>
public static class Aufmacherhoehe
{
    public const string Schlüssel = "darstellung.aufmacher.hoehe";

    /// <summary>Die Mitte — das, was vorher fest verdrahtet war.</summary>
    public const string Vorgabe = "mittel";

    /// <remarks>
    /// <b>Die fünfte kam nach.</b> Am Telefon war selbst „sehr hoch" zu
    /// flach — dort überschrieb eine feste Regel die Einstellung ganz. Das
    /// ist behoben; die zusätzliche Stufe gibt darüber hinaus Luft.
    /// </remarks>
    private static readonly string[] Stufen = ["niedrig", "mittel", "hoch", "sehrhoch", "voll"];

    /// <summary>Macht aus dem Gespeicherten eine der vier Stufen.</summary>
    ///
    /// <remarks>
    /// Unbekanntes wird zur Vorgabe statt zu einem Fehler: in der Spalte
    /// steht, was irgendwann einmal hineingeschrieben wurde, und eine
    /// Startseite, die daran scheitert, wäre die schlechtere Antwort.
    /// </remarks>
    public static string Lesen(string? wert)
    {
        var blank = wert?.Trim().ToLowerInvariant() ?? "";
        return Stufen.Contains(blank) ? blank : Vorgabe;
    }

    /// <summary>Ob das eine Stufe ist, die es gibt.</summary>
    public static bool Kennt(string? wert) =>
        wert is not null && Stufen.Contains(wert.Trim().ToLowerInvariant());
}