refactor(data): reorganitza data/ i centralitza paths a defaults.hpp

source/game/editor/editor.cpp

@@ -234,7 +234,7 @@ void Editor::ensureEditableEntities() {
         // llança si no troba — provem primer i, en cas de miss, carreguem.
         const auto REL = sp["path"].get_value<std::string>();
         const std::string KEY = std::filesystem::path(REL).filename().string();
-        std::string full = "data/entities/";
+        std::string full = Defaults::Paths::ENTITIES_DIR;
         full += name;
         full += '/';
         full += REL;

source/game/editor/editor_config.hpp

@@ -6,7 +6,7 @@
 #include <string>
 
 // Configuració visual de l'editor de tilemap (Debug-only). Carregada des
-// de data/editor/editor.yaml; les claus absents cauen als valors compilats
+// de data/config/editor.yaml; les claus absents cauen als valors compilats
 // a Defaults::Editor. Mateix patró que UiConfig (Meyers singleton + load).
 class EditorConfig {
    public:

source/game/entities/entity_loader.cpp

@@ -6,6 +6,7 @@
 #include "core/resources/resource_helper.hpp"
 #include "game/entities/entity.hpp"
 #include "game/entities/entity_factory.hpp"
+#include "utils/defaults.hpp"
 
 namespace EntityLoader {
 
@@ -20,7 +21,7 @@ namespace EntityLoader {
         }
 
         auto templatePath(const std::string& name) -> std::string {
-            return "data/entities/" + name + "/" + name + ".yaml";
+            return std::string{Defaults::Paths::ENTITIES_DIR} + name + "/" + name + ".yaml";
         }
 
     }  // namespace

source/game/entities/entity_manager_loadlevel.cpp

@@ -21,6 +21,7 @@
 #include "game/entities/entity_manager.hpp"
 #include "game/entities/player.hpp"
 #include "game/map/map.hpp"
+#include "utils/defaults.hpp"
 
 // Render centralitzat al manager per confinar la dependència cap a
 // `Surface`. Les entitats exposen `getSurface()` + `getPixelRect()` i el
@@ -124,7 +125,7 @@ namespace {
         if (s.contains("path")) {
             const auto REL = s["path"].get_value<std::string>();
             info.key = std::filesystem::path(REL).filename().string();
-            info.full_path = "data/entities/" + type + "/" + REL;
+            info.full_path = std::string{Defaults::Paths::ENTITIES_DIR} + type + "/" + REL;
             info.valid = true;
         }
         if (s.contains("size")) {

source/game/entities/player.cpp

@@ -179,16 +179,16 @@ void Player::readJumpBlock(const fkyaml::node& yaml) {
     if (j.contains("gravity")) { jump_config.gravity_px_per_s2 = j["gravity"].get_value<float>(); }
     if (j.contains("landing_stun_ms")) { jump_config.landing_stun_ms = j["landing_stun_ms"].get_value<int>(); }
     if (j.contains("shadow_y_offset")) { jump_config.shadow_y_offset = j["shadow_y_offset"].get_value<int>(); }
-    // Sons opcionals: el nom del fitxer (relatiu a data/sounds/) val tant
-    // de clau al Resource::Cache com de basename per a la càrrega. Si el
-    // camp manca, la clau queda buida i `playSound` no es crida.
+    // Sons opcionals: el nom del fitxer (relatiu a Defaults::Paths::AUDIO_SOUNDS_DIR)
+    // val tant de clau al Resource::Cache com de basename per a la càrrega.
+    // Si el camp manca, la clau queda buida i `playSound` no es crida.
     if (j.contains("sound")) {
         jump_config.sound_key = j["sound"].get_value<std::string>();
-        Resource::Cache::get().loadSound(jump_config.sound_key, "data/sounds/" + jump_config.sound_key);
+        Resource::Cache::get().loadSound(jump_config.sound_key, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + jump_config.sound_key);
     }
     if (j.contains("land_sound")) {
         jump_config.land_sound_key = j["land_sound"].get_value<std::string>();
-        Resource::Cache::get().loadSound(jump_config.land_sound_key, "data/sounds/" + jump_config.land_sound_key);
+        Resource::Cache::get().loadSound(jump_config.land_sound_key, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + jump_config.land_sound_key);
     }
 }
 
@@ -201,7 +201,7 @@ void Player::readHurtBlock(const fkyaml::node& yaml) {
     // So d'entrada a HURT — mateix patró que `jump.sound` i `whip.sound`.
     if (h.contains("sound")) {
         hurt_config.sound_key = h["sound"].get_value<std::string>();
-        Resource::Cache::get().loadSound(hurt_config.sound_key, "data/sounds/" + hurt_config.sound_key);
+        Resource::Cache::get().loadSound(hurt_config.sound_key, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + hurt_config.sound_key);
     }
 }
 
@@ -220,10 +220,11 @@ void Player::readImmunityBlock(const fkyaml::node& yaml) {
     if (im.contains("duration_ms")) { immunity_config.duration_ms = im["duration_ms"].get_value<float>(); }
     if (im.contains("blink_period_ms")) { immunity_config.blink_period_ms = im["blink_period_ms"].get_value<int>(); }
     // Paleta del blink: el basename val tant de clau al Resource::Cache
-    // com de path (`data/player/<key>.pal`). Mateix patró que els sons.
+    // com de path (`Defaults::Paths::PLAYER_DIR + key + .pal`). Mateix patró
+    // que els sons.
     if (im.contains("palette")) {
         immunity_config.palette_key = im["palette"].get_value<std::string>();
-        Resource::Cache::get().loadPalette(immunity_config.palette_key, "data/player/" + immunity_config.palette_key + ".pal");
+        Resource::Cache::get().loadPalette(immunity_config.palette_key, std::string{Defaults::Paths::PLAYER_DIR} + immunity_config.palette_key + ".pal");
     }
 }
 
@@ -239,7 +240,7 @@ void Player::readWhipBlock(const fkyaml::node& yaml) {
     // clau al cache i de path. Si manca, queda buit i no es dispara.
     if (w.contains("sound")) {
         whip_config.sound_key = w["sound"].get_value<std::string>();
-        Resource::Cache::get().loadSound(whip_config.sound_key, "data/sounds/" + whip_config.sound_key);
+        Resource::Cache::get().loadSound(whip_config.sound_key, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + whip_config.sound_key);
     }
 }
 

source/game/entities/player.hpp

@@ -91,7 +91,7 @@ class Player : public AnimatedSprite {
         DYING,
     };
 
-    // Geometria carregada des del YAML del player (p.ex. `data/player/sam.yaml`).
+    // Geometria carregada des del YAML del player (p.ex. `data/entities/player/sam.yaml`).
     // `sprite_*` són
     // la mida del frame (sprite 12×24 amb perspectiva falsa: visualment, els
     // 12 píxels superiors són el cap i els 12 inferiors la base).
@@ -362,7 +362,7 @@ class Player : public AnimatedSprite {
     // al respawn post-mort: mateixa entrada cinemàtica.
     void spawnFromAir(float x, float y);
 
-    // Arma un preset de reverb (catàleg a `data/sounds.yaml`) per al
+    // Arma un preset de reverb (catàleg a `data/config/sounds.yaml`) per al
     // pròxim aterratge d'aquest jugador. Pensat per a la cinemàtica
     // d'INTRO de sala: GameScene crida aquesta funció just després de
     // `spawnFromAir`, i el primer LAND consumeix el preset (queda buit
@@ -529,7 +529,7 @@ class Player : public AnimatedSprite {
     // gestiona `intended_vx_/vy_` escalats pel resolver.
     bool being_pushed_{false};
 
-    // Preset de reverb (catàleg de `data/sounds.yaml`) que el pròxim
+    // Preset de reverb (catàleg de `data/config/sounds.yaml`) que el pròxim
     // LAND ha de fer servir; buit = so sec. L'arma `armNextLandReverb`
     // (cridada per GameScene al spawn aeri d'INTRO) i el consumeix
     // `integrateJump` quan el jugador toca terra. Cap altre punt
@@ -636,7 +636,7 @@ class Player : public AnimatedSprite {
     struct HurtConfig {
         float initial_speed_px_per_s{0.0F};  // Velocitat amb què surt projectat (px/s).
         int brake_time_ms{0};                // Temps en que la velocitat decau a 0.
-        // Fitxer .wav reproduït en entrar a HURT (relatiu a `data/sounds/`).
+        // Fitxer .wav reproduït en entrar a HURT (relatiu a `data/audio/sounds/`).
         // Mateixa convenció que la resta de sons del jugador: el basename val
         // de clau al Resource::Cache i de path. Buit o absent = entrada
         // silenciosa.
@@ -660,7 +660,7 @@ class Player : public AnimatedSprite {
         int cooldown_ms{0};
         int damage{0};
         // Fitxer .wav reproduït al moment de disparar el swing (relatiu a
-        // `data/sounds/`). Convenció: el basename val tant de clau al
+        // `data/audio/sounds/`). Convenció: el basename val tant de clau al
         // Resource::Cache com de path. Buit o absent = swing silenciós.
         std::string sound_key;
     };
@@ -697,7 +697,7 @@ class Player : public AnimatedSprite {
         float duration_ms{0.0F};
         int blink_period_ms{0};
         // Clau al Resource::Cache de la paleta plana usada al blink (basename
-        // del .pal a `data/player/`). Buida = no hi ha alternança visual,
+        // del .pal a `data/entities/player/`). Buida = no hi ha alternança visual,
         // només la finestra lògica d'immunitat (que sense feedback visual
         // pot ser confusa, però no és incorrecte).
         std::string palette_key;
@@ -706,7 +706,7 @@ class Player : public AnimatedSprite {
 
     // Llig el bloc `immunity:` del YAML i n'omple `immunity_config`. Si
     // hi ha `palette`, registra la paleta corresponent al Resource::Cache
-    // (path: `data/player/<palette_key>.pal`). Mateix patró que els altres
+    // (path: `data/entities/player/<palette_key>.pal`). Mateix patró que els altres
     // readers — `loadFrom` el crida al final.
     static void readImmunityBlock(const fkyaml::node& yaml);
 

source/game/scenes/game_scene.cpp

@@ -229,10 +229,10 @@ auto GameScene::defaultConfig() -> Config {
     // concret de sala — només cap a on apunta la progressió ara mateix.
     return {
         .map_yaml = Levels::LevelManager::get().currentPath(),
-        .player_sprite = Defaults::Pyramid::PLAYER_SPRITE,
-        .player_yaml = Defaults::Pyramid::PLAYER_YAML,
-        .player2_sprite = Defaults::Pyramid::PLAYER_SPRITE_P2,
-        .player2_yaml = Defaults::Pyramid::PLAYER_YAML_P2,
+        .player_sprite = Defaults::Pyramid::PLAYER_SAM_GIF,
+        .player_yaml = Defaults::Pyramid::PLAYER_SAM_YAML,
+        .player2_sprite = Defaults::Pyramid::PLAYER_MORCUS_GIF,
+        .player2_yaml = Defaults::Pyramid::PLAYER_MORCUS_YAML,
         .music_track = Defaults::Pyramid::MUSIC_TRACK,
         .starting_players = DebugConfig::StartingPlayers::BOTH,
     };
@@ -312,7 +312,7 @@ GameScene::GameScene(Config config)
     // També ens subscrivim a `player_jumped` i `player_landed` per
     // spawnejar el polvet de despegue / aterratge a la posició dels
     // peus que el Player ens dóna al payload.
-    Resource::Cache::get().loadSurface("dust.gif", "data/entities/dust/dust.gif");
+    Resource::Cache::get().loadSurface("dust.gif", Defaults::Paths::DUST_GIF);
     entity_manager_.getBus().subscribe("player_jumped", [this](const Event& ev) {
         const auto* pos = std::get_if<WorldPos>(&ev.payload);
         if (pos != nullptr) { spawnDust(pos->x, pos->y, false); }
@@ -325,10 +325,10 @@ GameScene::GameScene(Config config)
     // Whip: precarreguem les 4 surfaces (una per cardinal) abans del
     // primer spawn perquè el Player no facte disc al primer atac.
     // Subscriu `whip_spawn` per crear el `WhipAttack` corresponent.
-    Resource::Cache::get().loadSurface("whip_east.gif", "data/entities/whip_attack/whip_east.gif");
-    Resource::Cache::get().loadSurface("whip_west.gif", "data/entities/whip_attack/whip_west.gif");
-    Resource::Cache::get().loadSurface("whip_north.gif", "data/entities/whip_attack/whip_north.gif");
-    Resource::Cache::get().loadSurface("whip_south.gif", "data/entities/whip_attack/whip_south.gif");
+    Resource::Cache::get().loadSurface("whip_east.gif", Defaults::Paths::WHIP_EAST_GIF);
+    Resource::Cache::get().loadSurface("whip_west.gif", Defaults::Paths::WHIP_WEST_GIF);
+    Resource::Cache::get().loadSurface("whip_north.gif", Defaults::Paths::WHIP_NORTH_GIF);
+    Resource::Cache::get().loadSurface("whip_south.gif", Defaults::Paths::WHIP_SOUTH_GIF);
     entity_manager_.getBus().subscribe("whip_spawn", [this](const Event& ev) {
         const auto* p = std::get_if<WhipSpawnPayload>(&ev.payload);
         if (p != nullptr) { spawnWhip(*p); }
@@ -479,7 +479,7 @@ GameScene::GameScene(Config config)
 
     // Timings i corbes de la FSM de sala. Llegits del YAML una sola
     // vegada; canvis requereixen reiniciar el joc.
-    transition_config_ = RoomFsm::loadConfig(Defaults::GameScene::CONFIG_YAML);
+    transition_config_ = RoomFsm::loadConfig(Defaults::GameScene::GAME_YAML);
 
     // Cinemàtica d'entrada de la primera sala: arrenca la pista
     // `room_intro.ogg` i arma el callback de fi que farà spawn + salt
@@ -856,7 +856,7 @@ void GameScene::renderRoomText() {
     // l'antic GameCanvas::CENTER_Y per descomptar la franja del marcador
     // i tenir el rètol equilibrat sobre el playfield.
     const int PLAY_CENTER_Y = (GameCanvas::HEIGHT + Map::hud_h) / 2;
-    // Colors del rètol via UiConfig (`data/ui.yaml > colors.room_text` i
+    // Colors del rètol via UiConfig (`data/config/ui.yaml > colors.room_text` i
     // `room_text_outline`). Independents dels colors de notificació.
     const Uint8 FILL = UiConfig::get().roomText();
     const Uint8 OUTLINE = UiConfig::get().roomTextOutline();

source/game/scenes/game_scene.hpp

@@ -202,7 +202,7 @@ class GameScene : public Scene {
     // Font del rètol de transició de sala (ROOM_INTRO i ROOM_OUTRO).
     // Distinta de `pause_font_` perquè el rètol de fase té estètica
     // pròpia (CaesarDressing per defecte, configurable via
-    // `data/ui.yaml > fonts.room_text`). La pausa segueix amb la
+    // `data/config/ui.yaml > fonts.room_text`). La pausa segueix amb la
     // placeholder.
     std::shared_ptr<Text> room_text_font_;
 
@@ -224,7 +224,7 @@ class GameScene : public Scene {
     } pause_;
 
     // Configuració de la FSM de sala (intro/outro). Carregada al ctor des
-    // de `data/scenes/game.yaml`; valors per defecte si manca el YAML.
+    // de `data/scenes/game/game.yaml`; valors per defecte si manca el YAML.
     RoomFsm::Config transition_config_{};
 
     // Estat actual de la FSM de sala. S'inicialitza a ROOM_INTRO al ctor

source/game/scenes/placeholder_input.hpp

@@ -8,7 +8,7 @@
 namespace Placeholder {
 
     // Retorna true si el scancode coincideix amb alguna tecla declarada al
-    // KeyConfig::get() (les carregades de data/input/keys.yaml). Si KeyConfig
+    // KeyConfig::get() (les carregades de data/config/input.yaml). Si KeyConfig
     // no s'ha carregat, totes les consultes retornaran SDL_SCANCODE_UNKNOWN i
     // aquesta funció tornarà false, de manera que el test/smoke no depèn de
     // l'estat global de la configuració.

source/game/scenes/room_fsm.hpp

@@ -35,7 +35,7 @@ namespace RoomFsm {
         int elapsed_ms{0};
     };
 
-    // Timings i corbes carregats de `data/scenes/game.yaml`. Els valors
+    // Timings i corbes carregats de `data/scenes/game/game.yaml`. Els valors
     // per defecte coincideixen amb els del YAML versionat: si manca el
     // fitxer, la FSM funciona igualment amb aquests fallbacks.
     struct Config {
@@ -94,7 +94,7 @@ namespace RoomFsm {
         UiConfig::CurveFn text_enter_curve{nullptr};
         UiConfig::CurveFn text_exit_curve{nullptr};
 
-        // Preset de reverb (catàleg a `data/sounds.yaml`) que GameScene
+        // Preset de reverb (catàleg a `data/config/sounds.yaml`) que GameScene
         // arma al jugador al spawn aeri d'INTRO. Es consumeix al primer
         // aterratge cinemàtic; els salts posteriors del joc i els
         // respawns post-mort cauen al so sec. Buit = sense reverb (la

source/game/scenes/title_scene.hpp

@@ -17,7 +17,7 @@ class Text;
 // Escena TITLE provisional. Pinta dos blocs de text sobre un fons gairebé
 // negre i un prompt "press start" intermitent fins que apareix l'artwork
 // real. Tota la cosmètica (colors, durada, ritme del parpadeig) viu a
-// data/ui.yaml secció `title:` per poder afinar-la sense recompilar.
+// data/config/ui.yaml secció `title:` per poder afinar-la sense recompilar.
 class TitleScene : public Scene {
    public:
     // Fases de l'escena.

source/game/ui/hud.cpp

@@ -22,7 +22,7 @@
 
 namespace {
 
-    // Els colors del HUD viuen a data/ui.yaml (colors.hud_label/value/flash)
+    // Els colors del HUD viuen a data/config/ui.yaml (colors.hud_label/value/flash)
     // via UiConfig. Les etiquetes ("P1", "V", "T") usen un to apagat per
     // crear jerarquia visual respecte als valors; el flash temporal usa un
     // to càlid que contrasta amb el valor normal.
@@ -73,7 +73,7 @@ Hud::Hud(EventBus& bus, std::shared_ptr<Text> font)
     : bus_(bus),
       font_(std::move(font)) {
     // Geometria fixa dels tres blocs. Sumen exactament GameCanvas::WIDTH.
-    // La durada de l'animació d'entrada ve de data/ui.yaml via UiConfig.
+    // La durada de l'animació d'entrada ve de data/config/ui.yaml via UiConfig.
     const int ENTRY_MS = UiConfig::get().hudEntryMs();
     blocks_[0] = Block{
         .x = 0,

source/game/ui/hud.hpp

@@ -104,7 +104,7 @@ class Hud {
 
         // Animació d'entrada: ms restants fins a quedar-se a la posició
         // final. Quan val 0 el bloc està quiet. El Hud ctor l'inicialitza
-        // amb la durada viva a data/ui.yaml (hud.entry_ms).
+        // amb la durada viva a data/config/ui.yaml (hud.entry_ms).
         int entry_ms_left{0};
         // Vector inicial des d'on entra: {-LEFT_W,0} per al bloc esquerre,
         // {0,-HEIGHT_PX} per al central i {+RIGHT_W,0} per al dret.