gui-cs.Terminal.Gui/Terminal.Gui/App/Timeout/LogarithmicTimeout.cs

#nullable disable
namespace Terminal.Gui.App;

/// <summary>Implements a logarithmic increasing timeout.</summary>
public class LogarithmicTimeout : Timeout
{
    /// <summary>
    ///     Creates a new instance where stages are the logarithm multiplied by the
    ///     <paramref name="baseDelay"/> (starts fast then slows).
    /// </summary>
    /// <param name="baseDelay">Multiple for the logarithm</param>
    /// <param name="callback">Method to invoke</param>
    public LogarithmicTimeout (TimeSpan baseDelay, Func<bool> callback)
    {
        _baseDelay = baseDelay;
        Callback = callback;
    }

    private readonly TimeSpan _baseDelay;
    private int _stage;

    /// <summary>Increments the stage to increase the timeout.</summary>
    public void AdvanceStage () { _stage++; }

    /// <summary>Resets the stage back to zero.</summary>
    public void Reset () { _stage = 0; }

    /// <summary>Gets the current calculated Span based on the stage.</summary>
    public override TimeSpan Span
    {
        get
        {
            // Calculate logarithmic increase
            double multiplier = Math.Log (_stage + 1); // ln(stage + 1)

            return TimeSpan.FromMilliseconds (_baseDelay.TotalMilliseconds * multiplier);
        }
    }
}