namespace Flaro.Core.Playback;

/// <summary>Wann ein Titel angefangen ist und wann er als gesehen gilt.</summary>
///
/// <remarks>
/// <para>
/// <b>Zwei Zahlen, die niemand raten kann.</b> Wie lange man hineinschauen
/// muss, damit es zählt, und ab welchem Anteil ein Film durch ist — das hängt
/// davon ab, wie jemand schaut, nicht davon, was technisch richtig wäre. Beide
/// standen als Konstante im Quelltext; jetzt stehen sie in den Einstellungen.
/// </para>
/// <para>
/// <b>Als Wert, nicht als Abfrage.</b> <see cref="ProgressRule"/> bleibt damit
/// ein reiner Typ: er rechnet, er liest nichts. Prüfbar ohne Datenbank, und
/// derselbe Satz Regeln gilt für eine Meldung und für die Neubewertung aller
/// vorhandenen Zeilen.
/// </para>
/// </remarks>
///
/// <param name="FortsetzenAb">
/// Wie weit man gekommen sein muss, damit ein Titel in „Weiterschauen" steht.
/// <see cref="TimeSpan.Zero"/> heisst: jede angefangene Sekunde zählt.
/// </param>
/// <param name="GesehenAnteil">Ab welchem Anteil der Laufzeit ein Titel gesehen ist.</param>
public readonly record struct Wiedergaberegeln(TimeSpan FortsetzenAb, double GesehenAnteil)
{
    /// <summary>Was gilt, solange niemand etwas anderes eingestellt hat.</summary>
    ///
    /// <remarks>
    /// <b>Neunzig Sekunden, nicht null.</b> Ohne Untergrenze genügte ein
    /// einziger Tick: wer im Aufmacher eine Sekunde hineinschaute, fand den
    /// Titel danach in „Weiterschauen" wieder. Eineinhalb Minuten sind lang
    /// genug, dass niemand aus Versehen hineinfällt, und kurz genug, dass eine
    /// abgebrochene Folge noch zählt.
    /// </remarks>
    public static readonly Wiedergaberegeln Vorgabe = new(TimeSpan.FromSeconds(90), 0.90);

    /// <summary>Dieselben Regeln mit geprüften Werten.</summary>
    ///
    /// <remarks>
    /// Was aus der Datenbank kommt, hat dort irgendwann jemand hineingeschrieben.
    /// Ein Anteil von 0 hiesse „alles ist gesehen", einer von 2 „nichts".
    /// </remarks>
    public Wiedergaberegeln Geprueft() => new(
        FortsetzenAb < TimeSpan.Zero ? TimeSpan.Zero : FortsetzenAb,
        Math.Clamp(GesehenAnteil, 0.5, 1.0));
}