IBKRTrader/src/IBKRTrader.Core/Modularity/ModuleView.cs

namespace IBKRTrader.Core.Modularity;

/// <summary>
/// Eine vom Core oder einem Modul beigesteuerte Fenster-Ansicht. Die Shell zeigt je View höchstens
/// eine Instanz und holt ein offenes Fenster wieder nach vorne.
///
/// <para><b>Bewusst toolkit-neutral:</b> <see cref="CreateView"/> liefert ein <see cref="object"/>,
/// keinen konkreten Fenstertyp, und <see cref="IconKey"/> ist ein Schlüssel statt eines Bildes.
/// Dadurch trägt der Core keine UI-Abhängigkeit und bleibt plattformneutral – Voraussetzung für den
/// kopflosen Linux-Betrieb. Insbesondere hängt hier kein <c>System.Drawing.Image</c> mehr:
/// <c>System.Drawing.Common</c> ist seit .NET 7 Windows-only und wirft auf Linux. Die jeweilige
/// Shell kennt ihr Toolkit und castet – die WinForms-Shell auf <c>Form</c>, die Avalonia-Shell
/// auf <c>Window</c>.</para>
/// </summary>
public sealed class ModuleView
{
    /// <summary>Stabile ID für Einzelinstanz-Handling (nur ein Fenster je View).</summary>
    public string Id { get; init; } = Guid.NewGuid().ToString();

    /// <summary>Titel (Fallback-Fenstertitel, falls das Fenster keinen eigenen setzt).</summary>
    public string Title { get; init; } = "Fenster";

    /// <summary>Optionale Gruppierung (z. B. "Core", "CongressTrading").</summary>
    public string? Group { get; init; }

    /// <summary>Optionale Sortierreihenfolge in Menü/Buttons.</summary>
    public int Order { get; init; } = 0;

    /// <summary>
    /// Logischer Schlüssel des Symbols für Menü/Buttons (z. B. "dashboard", "logs"). Die Shell löst
    /// ihn gegen ihre eigenen Bildressourcen auf. Settable, damit die Shell den von Modulen
    /// registrierten Views zentral ein Symbol zuweisen kann – Module kennen die Shell-Ressourcen nicht.
    /// </summary>
    public string? IconKey { get; set; }

    /// <summary>
    /// Erzeugt das anzuzeigende Fenster (frische Instanz je Öffnung). Rückgabetyp ist
    /// <see cref="object"/> – siehe Klassen-Doku zur Toolkit-Neutralität.
    /// </summary>
    public Func<object> CreateView { get; init; } = () => new object();
}

/// <summary>
/// Wird der Shell beim Start übergeben; Core und Module registrieren hier ihre Ansichten.
/// Über die Navigations-Mitglieder kann JEDES Fenster (auch Modul-Fenster, die nur den Core kennen)
/// das gemeinsame „Fenster"-Menü bauen.
/// </summary>
public interface IModuleUiHost
{
    void RegisterView(ModuleView view);

    /// <summary>Alle registrierten Ansichten (Core + Module).</summary>
    IReadOnlyList<ModuleView> Views { get; }

    /// <summary>Ist das Fenster dieser View gerade offen?</summary>
    bool IsOpen(string viewId);

    /// <summary>Öffnet die View bzw. holt ein bereits offenes Fenster in den Vordergrund.</summary>
    void OpenView(string viewId);

    /// <summary>Holt das Hauptfenster (Launcher) in den Vordergrund.</summary>
    void ActivateMain();

    /// <summary>Leitet das (bestätigte) Herunterfahren der App ein. Aus jedem Fenster aufrufbar.</summary>
    void RequestShutdown();

    /// <summary>Feuert, wenn sich der Offen-Status irgendeiner View ändert.</summary>
    event Action? OpenStateChanged;
}