feat(attack): esquelet WhipAttack + canal d'spawn via EventBus

source/game/entities/event_bus.hpp

@@ -12,6 +12,7 @@
 // Forward: els events poden dur un punter a `Entity` (p. ex. quin sarcòfag
 // s'ha obert). No cal incloure el header complet aquí.
 class Entity;
+class Player;
 
 // Event pub/sub minimalista. Hi ha un únic `EventBus` per mundus (propietat
 // de l'`EntityManager`); les entitats que el necessiten en reben un punter
@@ -49,9 +50,28 @@ struct WorldPos {
     float y{0.0F};
 };
 
+// Payload de `whip_spawn`: el `Player` el publica quan entra a ATTACKING
+// i el `GameScene` el consumeix per crear un `WhipAttack` via
+// `EntityManager::add`. Així el Player no depèn ni de `EntityManager` ni de
+// `WhipAttack`, i el contracte queda dins del bus.
+//   - `owner`     : Player que ha llançat l'atac (no rep dany propi).
+//   - `direction` : Player::Cardinal castat a int (1=N, 2=S, 3=E, 4=W) per
+//                   evitar dependència cíclica al header.
+//   - `spawn_x/y` : cantonada superior-esquerra de la hitbox màxima
+//                   (sense retallar) en píxels.
+//   - `range_px`  : longitud de la hitbox abans de retallar contra murs i
+//                   sarcòfags. Llegida del YAML del jugador.
+struct WhipSpawnPayload {
+    Player* owner{nullptr};
+    int direction{0};
+    float spawn_x{0.0F};
+    float spawn_y{0.0F};
+    float range_px{0.0F};
+};
+
 struct Event {
     std::string name;
-    using Payload = std::variant<std::monostate, int, std::string, Entity*, TilePos, PaintedTile, WorldPos>;
+    using Payload = std::variant<std::monostate, int, std::string, Entity*, TilePos, PaintedTile, WorldPos, WhipSpawnPayload>;
     Payload payload;
     // Jugador que ha originat (o provocat) l'event. -1 = sense jugador
     // associat (events del món, com `sarcophagus_opened` des de la pròpia
@@ -101,6 +121,9 @@ class EventBus {
     void publish(const std::string& name, WorldPos pos) {
         publish(Event{.name = name, .payload = pos});
     }
+    void publish(const std::string& name, const WhipSpawnPayload& whip) {
+        publish(Event{.name = name, .payload = whip});
+    }
 
    private:
     struct Subscription {