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

source/core/audio/audio.hpp

@@ -80,7 +80,7 @@ class Audio {
     // --- Control de sons ---
     void playSound(const std::string& name, Group group = Group::GAME);  // Reproduir so puntual per nom (muta globals de Ja)
     void playSound(Ja::Sound* sound, Group group = Group::GAME);         // Reproduir so puntual per punter (muta globals de Ja)
-    // Reprodueix un so processat per un efecte definit a data/sounds.yaml
+    // Reprodueix un so processat per un efecte definit a data/config/sounds.yaml
     // (preset_name busca a SoundEffectsConfig). Si el preset no existeix
     // o el motor està al cap de canals amb efecte, fa fallback a playSound
     // sec — l'usuari sent el so igualment, sense la cua.

source/core/audio/sound_effects_config.hpp

@@ -5,7 +5,7 @@
 
 #include "core/audio/jail_audio.hpp"  // Per a Ja::EchoParams / Ja::ReverbParams
 
-// Catàleg de presets d'efectes carregat des de data/sounds.yaml. La capa
+// Catàleg de presets d'efectes carregat des de data/config/sounds.yaml. La capa
 // Audio (playSoundWithEcho/playSoundWithReverb) hi accedeix per nom: si el
 // preset no existeix, el so es reprodueix sec amb un avís a stderr.
 //

source/core/input/global_inputs.cpp

@@ -26,7 +26,7 @@ namespace GlobalInputs {
         // La lliguem a la durada de la notificació EXIT perquè el missatge i
         // la confirmació expiren alhora — si no, l'usuari podria veure el
         // text però ja no ser dins del rang de confirmació (o al revés).
-        // El valor concret viu a data/ui.yaml (timings.exit_ms) via UiConfig.
+        // El valor concret viu a data/config/ui.yaml (timings.exit_ms) via UiConfig.
         constexpr int MIN_ZOOM = 1;
         constexpr int MAX_ZOOM = 6;
 
@@ -161,7 +161,7 @@ namespace GlobalInputs {
         // Debug helper: dispara una notificació prou llarga perquè
         // `wrapToWidth` la parteixi en (almenys) dues línies. Útil per a
         // verificar visualment el padding asimètric, el line_gap i la caixa
-        // multilinia després de tocar la geometria a `data/ui.yaml`.
+        // multilinia després de tocar la geometria a `data/config/ui.yaml`.
         void onDebugLongNotification() {
             Notification::notify("Notificació de prova llarga per a comprovar que el text es parteix correctament en dues línies dins la caixa.");
         }

source/core/input/key_config.hpp

@@ -5,7 +5,7 @@
 #include <string>
 #include <unordered_map>
 
-// Mapeig id → SDL_Scancode carregat des de data/input/keys.yaml. Consumit
+// Mapeig id → SDL_Scancode carregat des de data/config/input.yaml. Consumit
 // per GlobalInputs i (en el futur) per menús de remapat. No té cap cost
 // global: si la clau no existeix, retorna SDL_SCANCODE_UNKNOWN i GlobalInputs
 // ignora l'acció. D'aquesta manera podem afegir nous bindings al YAML sense

source/core/rendering/notification_presets.hpp

@@ -9,7 +9,7 @@
 
 // Temes per a les notificacions de pantalla. Un "preset" captura els dos
 // colors (text i fons, índexs sobre la paleta "ui") i el temps de visibilitat
-// en mil·lisegons. Els valors concrets viuen a data/ui.yaml (carregat per
+// en mil·lisegons. Els valors concrets viuen a data/config/ui.yaml (carregat per
 // UiConfig); per llançar una notificació amb un preset concret, cridar
 // Notification::notify(text, preset). Sense preset s'usa el DEFAULT.
 namespace Notification {
@@ -22,7 +22,7 @@ namespace Notification {
 
     // Preset per defecte: text clar sobre fons fosc. Es construeix en cada
     // crida a partir d'UiConfig perquè els valors no són constexpr: viuen a
-    // data/ui.yaml i es carreguen a l'arrencada.
+    // data/config/ui.yaml i es carreguen a l'arrencada.
     [[nodiscard]] inline auto defaultPreset() -> Preset {
         return {
             .text_color = UiConfig::get().notificationText(),

source/core/resources/resource_helper.cpp

@@ -6,6 +6,7 @@
 #include <string_view>
 
 #include "core/resources/resource_pack.hpp"
+#include "utils/defaults.hpp"
 
 namespace Resource::Helper {
 
@@ -92,7 +93,7 @@ namespace Resource::Helper {
         // carpeta `data/`).
         const auto FROM_PACK = [&filepath]() -> std::vector<std::uint8_t> {
             if (!g_pack_loaded) { return {}; }
-            constexpr std::string_view PREFIX = "data/";
+            const std::string_view PREFIX{Defaults::Paths::DATA_ROOT};
             std::string key = filepath;
             if (key.starts_with(PREFIX)) { key.erase(0, PREFIX.size()); }
             if (g_pack.hasResource(key)) { return g_pack.getResource(key); }

source/core/system/director.cpp

@@ -118,22 +118,29 @@ Director::Director() {
     Locale::get().load(std::string(Defaults::I18n::LOCALE_DIR) + Options::locale() + ".yaml");
 
     // Hotkeys globals. GlobalInputs::update() les consumirà a cada frame.
-    KeyConfig::get().load("data/input/keys.yaml");
+    KeyConfig::get().load(Defaults::Paths::INPUT_YAML);
 
     // Tema d'UI (colors, timings, fonts, flags). Qualsevol clau absent a
-    // data/ui.yaml cau al valor compilat a Defaults::UI.
-    UiConfig::get().load("data/ui.yaml");
+    // data/config/ui.yaml cau al valor compilat a Defaults::UI.
+    UiConfig::get().load(Defaults::Paths::UI_YAML);
+    // Configuració específica de les escenes TITLE i LOGO. Es carreguen
+    // additivament sobre el mateix UiConfig: cada fitxer només conté la
+    // seua subclau (`title:` o `logo:`), i les claus absents a la base
+    // (ui.yaml) o als yamls d'escena cauen al valor compilat a
+    // Defaults::UI::Title / Defaults::UI::Logo.
+    UiConfig::get().load(Defaults::Paths::TITLE_YAML);
+    UiConfig::get().load(Defaults::Paths::LOGO_YAML);
 
 #ifdef _DEBUG
     // Tema visual de l'editor de tilemap (Debug-only). Claus absents
     // cauen als valors compilats a Defaults::Editor.
-    EditorConfig::get().load("data/editor/editor.yaml");
+    EditorConfig::get().load(Defaults::Paths::EDITOR_YAML);
 #endif
 
     // Recursos compartits d'UI (paleta + fonts). Es carreguen abans que els
     // overlays perquè tots els reaprofiten sense duplicar la lògica. Els
-    // noms de font viuen al fitxer data/ui.yaml via UiConfig.
-    Resource::Cache::get().loadPalette("ui", "data/palettes/uzebox.pal");
+    // noms de font viuen al fitxer data/config/ui.yaml via UiConfig.
+    Resource::Cache::get().loadPalette("ui", Defaults::Paths::UI_PALETTE);
     const std::string HUD_FONT_GIF_KEY = UiConfig::get().hudFont().name + ".gif";
     Resource::Cache::get().loadSurface(HUD_FONT_GIF_KEY, UiConfig::get().hudFont().gif);
     Resource::Cache::get().getSurface(HUD_FONT_GIF_KEY)->setPalette(Resource::Cache::get().getPalette("ui"));
@@ -152,33 +159,33 @@ Director::Director() {
     // Pistes de música del cicle de sala (intro/playing/outro). Es preloden
     // ací perquè formen part del preload d'assets, com la font i la paleta;
     // la lògica de quina sona en cada estat viu a `GameScene`.
-    Resource::Cache::get().loadMusic("room_intro.ogg", "data/music/room_intro.ogg");
-    Resource::Cache::get().loadMusic("playing.ogg", "data/music/playing.ogg");
-    Resource::Cache::get().loadMusic("room_outro.ogg", "data/music/room_outro.ogg");
+    Resource::Cache::get().loadMusic("room_intro.ogg", Defaults::Paths::MUSIC_ROOM_INTRO);
+    Resource::Cache::get().loadMusic("playing.ogg", Defaults::Paths::MUSIC_PLAYING);
+    Resource::Cache::get().loadMusic("room_outro.ogg", Defaults::Paths::MUSIC_ROOM_OUTRO);
     // Música de la TITLE: arrenca al constructor de l'escena i es fa
     // fade-out quan l'escena entra a STARTING.
-    Resource::Cache::get().loadMusic("title.ogg", "data/music/title.ogg");
+    Resource::Cache::get().loadMusic("title.ogg", Defaults::Paths::MUSIC_TITLE);
 
-    // Sons del menú de servei. Els noms venen de `data/ui.yaml` (amb
+    // Sons del menú de servei. Els noms venen de `data/config/ui.yaml` (amb
     // fallback a `Defaults::UI::MENU_*_SOUND`); el ServiceMenu els
     // dispara via Audio::Group::INTERFACE.
     const auto& menu_select = UiConfig::get().menuSelectSound();
     const auto& menu_accept = UiConfig::get().menuAcceptSound();
-    Resource::Cache::get().loadSound(menu_select, "data/sounds/" + menu_select);
-    Resource::Cache::get().loadSound(menu_accept, "data/sounds/" + menu_accept);
+    Resource::Cache::get().loadSound(menu_select, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + menu_select);
+    Resource::Cache::get().loadSound(menu_accept, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + menu_accept);
     // So del START a la TITLE: el dispara TitleScene quan un jugador
     // prem START (vore enterStarting i el reset del segon jugador).
     const auto& player_start = UiConfig::get().playerStartSound();
-    Resource::Cache::get().loadSound(player_start, "data/sounds/" + player_start);
+    Resource::Cache::get().loadSound(player_start, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + player_start);
     // Soroll de LogoScene (scanline reveal). El dispara LogoScene al
     // ctor; amb fallback al nom de Defaults si la clau YAML no hi és.
     const auto& logo_glitch = UiConfig::get().logoGlitchSound();
-    Resource::Cache::get().loadSound(logo_glitch, "data/sounds/" + logo_glitch);
+    Resource::Cache::get().loadSound(logo_glitch, std::string{Defaults::Paths::AUDIO_SOUNDS_DIR} + logo_glitch);
 
     // Catàleg de presets d'efectes per als sons. Es carrega abans d'Audio
     // perquè els primers playSoundWith* (al començament del joc) ja
     // troben els presets disponibles.
-    SoundEffectsConfig::get().load("data/sounds.yaml");
+    SoundEffectsConfig::get().load(Defaults::Paths::SOUNDS_YAML);
 
     // Audio: singleton manual propietari d'un SDL audio device. Es destrueix
     // explícitament a ~Director abans que Resource::Cache (Meyers) buide els
@@ -216,7 +223,7 @@ Director::Director() {
 
     // Font del menú de servei (F9). El títol va amb la variant `display`
     // i els items amb `condensed-display` (més compacte perquè caben més
-    // files). Els dos noms i kernings viuen a data/ui.yaml via UiConfig.
+    // files). Els dos noms i kernings viuen a data/config/ui.yaml via UiConfig.
     auto load_menu_font = [&](const UiConfig::Font& font) {
         const std::string KEY = font.name + ".gif";
         Resource::Cache::get().loadSurface(KEY, font.gif);
@@ -233,7 +240,7 @@ Director::Director() {
     // sobreescrivim amb la "ui" perquè el GIF ja porta els colors finals
     // del logo).
     constexpr const char* MINI_LOGO_KEY = "logo_jailgames_mini.gif";
-    Resource::Cache::get().loadSurface(MINI_LOGO_KEY, "data/logo/logo_jailgames_mini.gif");
+    Resource::Cache::get().loadSurface(MINI_LOGO_KEY, Defaults::Paths::LOGO_MINI_GIF);
     auto mini_logo_surface = Resource::Cache::get().getSurface(MINI_LOGO_KEY);
     mini_logo_surface_ = mini_logo_surface;
 
@@ -241,20 +248,20 @@ Director::Director() {
     // conserva la seua paleta nadiua: els colors finals del logo viuen
     // dins del propi GIF i no han de passar per la paleta UI.
     constexpr const char* LOGO_FULL_KEY = "logo_jailgames.gif";
-    Resource::Cache::get().loadSurface(LOGO_FULL_KEY, "data/logo/logo_jailgames.gif");
+    Resource::Cache::get().loadSurface(LOGO_FULL_KEY, Defaults::Paths::LOGO_FULL_GIF);
     logo_full_surface_ = Resource::Cache::get().getSurface(LOGO_FULL_KEY);
 
     // Logotip del joc per a la TITLE (substitueix el text "Aventures en
     // Egipte ARCADE"). Igual que la resta de logos, paleta nadiua —
     // l'art ja porta els colors finals i no passa per la UI.
     constexpr const char* GAME_LOGO_KEY = "game_logo.gif";
-    Resource::Cache::get().loadSurface(GAME_LOGO_KEY, "data/title/game_logo.gif");
+    Resource::Cache::get().loadSurface(GAME_LOGO_KEY, Defaults::Paths::TITLE_GAME_LOGO_GIF);
     game_logo_surface_ = Resource::Cache::get().getSurface(GAME_LOGO_KEY);
 
     // Fons sencer de la TITLE (320×240). Igual que el minilogo, conserva
     // la seua paleta nadiua perquè el GIF ja porta els colors finals.
     constexpr const char* TITLE_BG_KEY = "title_bg.gif";
-    Resource::Cache::get().loadSurface(TITLE_BG_KEY, "data/title/title_bg.gif");
+    Resource::Cache::get().loadSurface(TITLE_BG_KEY, Defaults::Paths::TITLE_BG_GIF);
     auto title_bg_surface = Resource::Cache::get().getSurface(TITLE_BG_KEY);
     title_bg_surface_ = title_bg_surface;
     ServiceMenu::get().init(menu_title_text, menu_items_text, ui_palette);

source/core/ui/ui_config.hpp

@@ -5,7 +5,7 @@
 #include <string>
 
 // Configuració del tema UI (índexs de paleta, timings, fonts i flags)
-// carregada des de data/ui.yaml. Cada camp s'inicialitza amb el valor
+// carregada des de data/config/ui.yaml. Cada camp s'inicialitza amb el valor
 // de Defaults::UI com a fallback: si el fitxer falta o li manca una
 // clau, el joc s'executa amb el tema compilat.
 //
@@ -21,12 +21,12 @@ class UiConfig {
     };
 
     // Signatura d'una funció d'easing: t ∈ [0, 1] → valor ∈ [0, 1].
-    // Permet triar corbes des de data/ui.yaml per nom (cadena) i guardar
+    // Permet triar corbes des de data/config/ui.yaml per nom (cadena) i guardar
     // el punter a la corresponent funció de `utils/easing.hpp`.
     using CurveFn = auto (*)(float) -> float;
 
     // Geometria del Notifier (popup superior). Carregada des de
-    // data/ui.yaml secció `notifier:`; els valors per defecte vénen de
+    // data/config/ui.yaml secció `notifier:`; els valors per defecte vénen de
     // Defaults::UI::Notifier. El moviment és per temps (slide_ms) i no per
     // velocitat, perquè una caixa més gran no triga més a entrar/eixir.
     struct Notifier {
@@ -170,7 +170,7 @@ class UiConfig {
     [[nodiscard]] static auto curveByName(const std::string& name) -> CurveFn;
 
     // Sons del menú de servei. Claus de Resource::Cache::loadSound (els
-    // fitxers viuen a `data/sounds/`).
+    // fitxers viuen a `data/audio/sounds/`).
     [[nodiscard]] auto menuSelectSound() const -> const std::string& { return menu_select_sound_; }
     [[nodiscard]] auto menuAcceptSound() const -> const std::string& { return menu_accept_sound_; }
     [[nodiscard]] auto playerStartSound() const -> const std::string& { return player_start_sound_; }