class_name SoundCatalog
extends RefCounted
## Identifiants des effets sonores et des musiques, resolus vers un fichier
## d'un repertoire fixe (jamais de chemin libre : voir CLAUDE.md). Code pur.

const SFX_DIR := "res://assets/audio/sfx"
const MUSIC_DIR := "res://assets/audio/music"

const SFX_IDS: Array[String] = ["click", "success", "try_again", "star", "fanfare"]
const MUSIC_IDS: Array[String] = ["forest", "marsh", "meadow", "river", "night"]

## Choix « automatique » : la musique du decor du tableau (BackdropKinds).
const MUSIC_AUTO := "auto"


static func sfx_path(sfx_id: String) -> String:
    if not SFX_IDS.has(sfx_id):
        return ""
    return "%s/%s.ogg" % [SFX_DIR, sfx_id]


static func music_path(music_id: String) -> String:
    if not MUSIC_IDS.has(music_id):
        return ""
    return "%s/%s.ogg" % [MUSIC_DIR, music_id]


## Choix possibles dans les reglages : automatique puis chaque morceau.
static func music_choices() -> Array[String]:
    var choices: Array[String] = [MUSIC_AUTO]
    choices.append_array(MUSIC_IDS)
    return choices


## Morceau a jouer pour le choix de l'utilisateur et le decor du tableau :
## un morceau choisi vaut partout ; « automatique » suit le decor.
static func resolve_music(choice: String, backdrop_kind: String) -> String:
    if MUSIC_IDS.has(choice):
        return choice
    return BackdropKinds.music_for(backdrop_kind)