#pragma once

#include <cstdint>
#include <memory>

#include "core/rendering/effects/scan_reveal.hpp"
#include "core/rendering/transitions/fade_to_black.hpp"
#include "core/scene/scene.hpp"

class Surface;

// Escena del logotip de l'editora. FSM amb tres fases visibles:
//   `SCAN`     — revelat tipus scanline CRT (durada YAML, ~1500 ms)
//   `MIDDLE`   — logo estable (`MIDDLE_MS`, 5 s)
//   `FADE_OUT` — fade lineal a negre (`FADE_OUT_MS`, 500 ms)
// I una terminal `DONE` que dispara la transició cap a TITLE. A 2,5 s
// dins de `MIDDLE` arrenca la música del títol perquè entri al cor de
// l'escena i continue cap a TitleScene sense talls (Audio ja és
// idempotent quan es demana la mateixa pista que ja sona).
//
// Skip: qualsevol tecla no reservada salta directament a la transició
// (sense fade-out) — el TitleScene té el seu propi `intro.fade_in_ms`,
// així que la transició queda visualment continua igualment.
//
// Si arriba amb `reset=true` (acció "Reiniciar" del menú de servei),
// atura música i tots els sons al constructor — el següent LOGO arrenca
// silenciós encara que veníssem del joc en marxa.
class LogoScene : public Scene {
   public:
    static constexpr int MIDDLE_MS = 5000;
    static constexpr int FADE_OUT_MS = 500;
    // Offset dins de MIDDLE en què comença a sonar la pista del títol;
    // triat perquè quedi clarament al cor de la fase central (logo
    // estable) i prou abans del fade-out per donar continuïtat sonora a
    // TitleScene.
    static constexpr int MUSIC_TRIGGER_MS = 2500;

    LogoScene(std::shared_ptr<Surface> logo, bool reset);
    ~LogoScene() override;

    void update(int delta_ms) override;
    void render() override;

   private:
    enum class Phase : std::uint8_t { SCAN,
        MIDDLE,
        FADE_OUT,
        DONE };

    void enterMiddle();
    void enterFadeOut();
    void enterDone();
    [[nodiscard]] static auto wantsSkip() -> bool;

    std::shared_ptr<Surface> logo_;
    Phase phase_{Phase::SCAN};
    int phase_elapsed_ms_{0};
    bool music_started_{false};
    // Capa de fosa per al FADE_OUT cap a TITLE. El FADE_IN inicial s'ha
    // substituït per `scan_` (revelat CRT amb glitch).
    Transitions::FadeToBlack fade_;
    Effects::ScanReveal scan_;
};