RemSound/src/RemSound.App/CheckSoundService.cs

using RemSound.Core;

namespace RemSound.App;

/// <summary>
/// Plays a short tick / untick sound whenever the user checks or unchecks a checkbox anywhere in
/// RemSound - instant audible feedback of which way a box just went, which matters most in the busy
/// inputs/outputs lists. Two normal machine-wide cues: CheckboxOn (check.wav) and CheckboxOff
/// (uncheck.wav), each with numbered variants + an off option in Preferences, like any other cue.
///
/// Wired from <see cref="AccessibleCheckBox"/> and the device <c>LiveCheckedListBox</c>, both gated
/// on the control being focused - so a genuine user toggle clicks, but the bulk programmatic
/// checking done on profile load or by "uncheck all" stays silent.
/// </summary>
internal static class CheckSoundService
{
    private static CuePlayer? checkSound;
    private static CuePlayer? uncheckSound;

    /// <summary>When true, <see cref="Play"/> is a no-op. MainForm sets this around bulk programmatic
    /// control updates (profile load, "uncheck all", device-list refresh). The per-call Focused gate
    /// already silences MOST programmatic ticks, but it leaks when the box we tick in code happens to
    /// be the focused control on launch — which is exactly what made loading a profile blast a
    /// checkbox click. This flag closes that gap: only genuine user toggles ever click.</summary>
    public static bool Suppressed { get; set; }

    /// <summary>(Re)load the tick/untick sounds from the current cue configuration. Call at startup
    /// and whenever cue settings change.</summary>
    public static void Reload()
    {
        var cfg = AppConfig.Load();
        checkSound = LoadCue(MainForm.CueId.CheckboxOn, "check.wav", cfg);
        uncheckSound = LoadCue(MainForm.CueId.CheckboxOff, "uncheck.wav", cfg);
    }

    public static void Play(bool isChecked)
    {
        if (Suppressed) return;
        var cfg = AppConfig.Load();
        if (isChecked) { if (cfg.EnableCheckboxOnCue) checkSound?.Play(); }
        else { if (cfg.EnableCheckboxOffCue) uncheckSound?.Play(); }
    }

    private static CuePlayer? LoadCue(string cueId, string defaultFile, AppConfig cfg)
    {
        try
        {
            string? path = cfg.MachineCueCustomPaths.TryGetValue(cueId, out var custom) && File.Exists(custom)
                ? custom
                : CueSounds.ResolveDefaultPath(cueId, defaultFile, cfg);
            return path is not null && File.Exists(path) ? new CuePlayer(path) : null;
        }
        catch { return null; }
    }
}