AnswerValidator.hpp

#ifndef ANSWERVALIDATOR_HPP
#define ANSWERVALIDATOR_HPP

#include <cstdint>
#include <string>
#include <vector>

/**
 * @brief Classe AnswerValidator
 *
 * Cette classe fournit des methodes pour valider des notes et accords musicaux.
 * Elle permet de comparer des notes jouees avec des notes attendues et de
 * verifier la validite d'accords, y compris avec renversements.
 */
class AnswerValidator {
  public:
    /**
     * @brief Valide une note jouee par rapport a une note attendue.
     *
     * @param noteJouee La note jouee (ex: "C4").
     * @param noteAttendue La note attendue (ex: "C4").
     * @return true si la note jouee correspond a la note attendue, false sinon.
     */
    static bool valider(const std::string& noteJouee,
                        const std::string& noteAttendue);

    /**
     * @brief Valide un accord sans prendre en compte le renversement.
     *
     * Compare les accords joues et attendus, en ignorant l'ordre des notes.
     *
     * @param accordJoue Vecteur de notes jouees (ex: {"C4", "E4", "G4"}).
     * @param accordAttendu Vecteur de notes attendues (ex: {"C4", "E4", "G4"}).
     * @return true si les deux accords contiennent les memes notes, false
     * sinon.
     */
    static bool validerAccordSR(const std::vector<std::string>& accordJoue,
                                const std::vector<std::string>& accordAttendu);

    /**
     * @brief Valide un accord avec prise en compte d'un renversement
     * specifique.
     *
     * Compare les accords joues et attendus en recalibrant les notes selon le
     * renversement specifie.
     *
     * @param accordJoue Vecteur de notes jouees (ex: {"E4", "G4", "C5"}).
     * @param accordAttendu Vecteur de notes attendues (ex: {"C4", "E4", "G4"}).
     * @param renversement Numero du renversement+1 attendu (2 = premier
     * renversement, etc.).ATTENTION renversement = 1 => Pas de renversement,
     * renversement = 2 => 1er renversement et renversement = 3 => 2eme
     * renversement
     * @return true si l'accord joue correspond a l'accord attendu pour le
     * renversement donne, false sinon.
     */
    static bool
    validerAccordRenversement(const std::vector<std::string>& accordJoue,
                              const std::vector<std::string>& accordAttendu,
                              uint32_t renversement);

  private:
    /**
     * @brief Convertit un nom de note en valeur MIDI modulo 12
     * @param note Nom de la note (ex: "C", "Gb", "D#")
     * @return Valeur MIDI (0-11) ou -1 si invalide
     */
    static int getNoteValue(std::string noteName);

    /**
     * @brief Convertit une note avec octave en valeur MIDI absolue
     * @param note Str de la note (ex: "C4")
     * @return Valeur MIDI absolue ou -1 si invalide
     */
    static int getAbsoluteMidiValue(const std::string& noteStr);
};

#endif // ANSWERVALIDATOR_HPP