gui-cs.Terminal.Gui/Terminal.Gui/App/Toplevel/IToplevelTransitionManager.cs

namespace Terminal.Gui.App;

/// <summary>
///     Interface for class that handles bespoke behaviours that occur when application
///     top level changes.
/// </summary>
public interface IToplevelTransitionManager
{
    /// <summary>
    ///     Raises the <see cref="Toplevel.Ready"/> event on tahe current top level
    ///     if it has not been raised before now.
    /// </summary>
    /// <param name="app"></param>
    void RaiseReadyEventIfNeeded (IApplication? app);

    /// <summary>
    ///     Handles any state change needed when the application top changes e.g.
    ///     setting redraw flags
    /// </summary>
    /// <param name="app"></param>
    void HandleTopMaybeChanging (IApplication? app);
}