namespace ytLive.Services.Audio;

/// <summary>Seam over the TRAX background-music player (<see cref="MusicPlayer"/>) so the
/// toggle/status-light logic is testable without a real audio device.</summary>
public interface ITraxPlayer : IDisposable
{
    event Action<Exception?>? PlaybackEnded;
    string? TrackName { get; }
    bool IsPlaying { get; }

    /// <summary>The player's OWN measured output level (0…1). A play glyph can lie — an open file
    /// with a dead decoder still says "playing" — so the dock's TRAX ladder shows sound, not state.</summary>
    float Level { get; }
    float LocalGain { get; set; }

    /// <summary>The creator's TRAX level (1 = the bed's fixed design level). Separate from
    /// <see cref="LocalGain"/>, which follows the desktop mute; the dock's fader moves this.</summary>
    float UserGain { get; set; }
    void Load(string path);
    void Play();
    void Pause();
}