feat(mummy): estat HURT amb fugida en línia recta i recuperació al timer

source/game/entities/concrete/mummy.hpp

@@ -21,6 +21,21 @@ class Mummy : public DynamicHazard {
         LEFT,
         RIGHT };
 
+    // Estat d'alt nivell. ROAMING = IA normal (corridor_wanderer); HURT =
+    // post-fuetada, fugint en línia recta durant `hurt_config_.duration_s`.
+    // Mentre dura el HURT no decideix a creuaments ni canvia de direcció;
+    // si topa amb mur o sarc, surt del HURT abans de l'expiració del timer.
+    enum class State : std::uint8_t { ROAMING,
+        HURT };
+
+    // Configuració de l'estat HURT, llegida del bloc `hurt:` del YAML.
+    // Si `duration_s == 0` la mòmia mai entra a HURT efectiu (defensiu).
+    // `speed_px_per_s == 0` ⇒ s'usa la velocitat normal de la mòmia.
+    struct HurtConfig {
+        float duration_s{0.0F};
+        float speed_px_per_s{0.0F};
+    };
+
     explicit Mummy(const fkyaml::node& yaml);
 
     // Hook d'IA. Donat un conjunt de direccions admissibles, decideix la
@@ -39,9 +54,22 @@ class Mummy : public DynamicHazard {
     // En ambdós casos el frame de gir no consumeix avenç extra.
     void step(float delta_time) override;
 
+    // Update sencer: afegim la branca HURT (avanç del timer + step recta).
+    // En estat ROAMING delega a `step()` com sempre via la base.
+    void update(float delta_time) override;
+
     // Contacte amb el jugador: publica `player_hit` amb el dany.
     void onPlayerContact(Player* player) override;
 
+    // Activa l'estat HURT amb la direcció de fuga preferida `flee_dir`.
+    // Si està bloquejada, prova perpendiculars; si totes estan bloquejades,
+    // la mòmia queda quieta però en HURT durant tot el timer.
+    void enterHurt(Direction flee_dir);
+
+    [[nodiscard]] auto getState() const -> State { return state_; }
+    [[nodiscard]] auto isWhippable() const -> bool { return whippable_; }
+    [[nodiscard]] auto getHurtRemainingS() const -> float { return hurt_remaining_s_; }
+
    private:
     // Caixa de col·lisió candidata si l'entitat es desplaçara (dx, dy).
     [[nodiscard]] auto candidateBox(float dx, float dy) const -> SDL_FRect;
@@ -90,9 +118,28 @@ class Mummy : public DynamicHazard {
     // S'usa al pool de creuament per afegir la recta com a candidata.
     [[nodiscard]] auto currentDirection() const -> Direction;
 
+    // Avança recta a `hurt_speed_ * delta_time`. Si la caixa candidata
+    // sortiria del playfield o trepitjaria un sarc, marca la sortida del
+    // HURT abans de l'expiració del timer (la mòmia no rebota).
+    void hurtStep(float delta_time);
+
+    // Tria la direcció definitiva del HURT donada la preferida (la del
+    // whip). Si la preferida està bloquejada, prova perpendiculars; si
+    // totes ho estan, retorna `NONE` (la mòmia queda quieta en HURT).
+    [[nodiscard]] auto chooseHurtDirection(Direction preferred) const -> Direction;
+
     // Animacions carregades del YAML, una per cada facing. Per a horitzontal
     // només en cal una (`walk`) i el flip ja diferencia esquerra/dreta.
     AnimationComponent anim_walk_down_;
     AnimationComponent anim_walk_up_;
     AnimationComponent anim_walk_lateral_;
+
+    // Estat HURT i la seua configuració. `hurt_speed_` és l'efectiva
+    // (resultat d'aplicar el `speed` del bloc `hurt:` o, si val 0, la
+    // velocitat normal de la mòmia).
+    State state_{State::ROAMING};
+    HurtConfig hurt_config_;
+    bool whippable_{true};
+    float hurt_remaining_s_{0.0F};
+    float hurt_speed_{0.0F};
 };