feat(mummy): SPAWN dirigit per l'animació raise

source/game/entities/concrete/mummy.cpp

@@ -106,7 +106,8 @@ Mummy::Mummy(const fkyaml::node& yaml)
     : anim_walk_south_(buildAnimation(yaml, "walk_south")),
       anim_walk_north_(buildAnimation(yaml, "walk_north")),
       anim_walk_east_(buildAnimation(yaml, "walk_east")),
-      anim_walk_west_(buildAnimation(yaml, "walk_west")) {
+      anim_walk_west_(buildAnimation(yaml, "walk_west")),
+      anim_raise_(buildAnimation(yaml, "raise")) {
     name_ = yaml.contains("name") ? yaml["name"].get_value<std::string>() : std::string("mummy");
     collides_ = true;
     interactable_ = false;
@@ -141,16 +142,18 @@ Mummy::Mummy(const fkyaml::node& yaml)
         changeDirection(0.0F, 1.0F);
     }
 
-    // Estat SPAWN inicial: la mòmia naix visible i quieta, esperant que el
-    // GameScene li armi el comptador via `triggerSpawnExit()` (cridat al
-    // final de la subfase text-exit de ROOM_INTRO). Si el YAML no declara
-    // `spawn.duration_s`, default 0 ⇒ al primer update post-trigger passa
-    // directament a ACTIVE.
-    float spawn_duration_s = 0.0F;
-    if (yaml.contains("spawn") && yaml["spawn"].contains("duration_s")) {
-        spawn_duration_s = yaml["spawn"]["duration_s"].get_value<float>();
+    // Estat SPAWN inicial: la mòmia naix en SPAWNING amb l'animació
+    // `raise` activa (16 frames @ 8fps, no-loop). La duració del SPAWN
+    // la marca la pròpia animació — `Mummy::update` la tickeja, i quan
+    // `completed()`, crida `endSpawn()` i restaura la `walk_*` per la
+    // direcció actual. Passem 0 al countdown del DynamicHazard perquè
+    // no s'utilitza en aquest cas (el nostre `update` retorna abans).
+    enterSpawn(0.0F);
+    anim_ = anim_raise_;
+    if (anim_.has_value()) {
+        anim_->reset();
+        flip_ = anim_->flipMode();
     }
-    enterSpawn(spawn_duration_s);
 
     // Configuració de l'estat HURT: opcional. Si el bloc no apareix, la
     // mòmia no entrarà mai a HURT efectiu (defensiu); el WhipAttack la
@@ -692,6 +695,21 @@ void Mummy::hurtStep(float delta_time) {
 }
 
 void Mummy::update(float delta_time) {
+    if (isSpawning()) {
+        // SPAWN dirigit per animació: la `raise` és no-loop, així que
+        // `completed()` ens marca el final. Mentre dura, NO cridem
+        // `DynamicHazard::update`: la base hi té el countdown i ja
+        // hauria saltat a ACTIVE (passem `enterSpawn(0)`), i el `step()`
+        // d'IA mouria la mòmia abans de "aixecar-se". En completar,
+        // tornem a la `walk_*` que toca segons la direcció ja triada
+        // al ctor (initial_direction de l'IA).
+        if (anim_.has_value()) { anim_->tick(delta_time); }
+        if (anim_.has_value() && anim_->completed()) {
+            endSpawn();
+            changeDirection(getDirX(), getDirY());
+        }
+        return;
+    }
     if (state_ == State::HURT) {
         // Avancem l'animació inline (no podem cridar `Entity::update` ni
         // `DynamicHazard::update`: el primer salta una capa virtual i el

source/game/entities/concrete/mummy.hpp

@@ -177,6 +177,12 @@ class Mummy : public DynamicHazard {
     AnimationComponent anim_walk_east_;
     AnimationComponent anim_walk_west_;
 
+    // Animació d'aparició (no-loop). Mentre `isSpawning()`, `update()`
+    // la tickeja sense moure la mòmia; quan `completed()`, la mòmia
+    // transita a ACTIVE via `endSpawn()` i conmuta a la walk_* que
+    // toca segons direcció.
+    AnimationComponent anim_raise_;
+
     // 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).

source/game/entities/hazard.hpp

@@ -96,6 +96,11 @@ class DynamicHazard : public Hazard {
     // Arma el comptador del SPAWN. A partir d'aquí, cada `update(dt)`
     // descompta `dt` fins arribar a 0 i transitar a ACTIVE.
     void triggerSpawnExit() { spawn_exit_armed_ = true; }
+    // Transició directa a ACTIVE, sense passar pel countdown. Pensat
+    // per a subclasses amb SPAWN dirigit per animació: gestionen el
+    // seu propi `update()` mentre `isSpawning()` i criden ací quan la
+    // seua animació d'aparició ha completat.
+    void endSpawn() { spawn_state_ = SpawnState::ACTIVE; }
     [[nodiscard]] auto isSpawning() const -> bool { return spawn_state_ == SpawnState::SPAWNING; }
     [[nodiscard]] auto getSpawnDurationS() const -> float { return spawn_duration_s_; }