fix(resources): resoldre rutes de data/ respecte a SDL_GetBasePath

Abans el binari només arrencava si la CWD era la que contenia data/
(típicament build/). Executat des de qualsevol altra carpeta no trobava
keys.yaml, paletes, etc. i es moria al carregar el primer recurs.

Patró seguit de ../aee: Resource::Helper guarda un data root absolut
i resolve(rel) el prefixa davant de rutes no absolutes. Director fa
setDataRoot(SDL_GetBasePath()) com a primera acció del ctor, així tots
els loaders posteriors hi passen sense canvis al call site.

Migrats a Resource::Helper::resolve els loaders que obrien std::ifstream
directament amb el path rebut: Locale, KeyConfig, Player, Map, Tilemap
i EntityLoader. Els que ja usaven Resource::Helper::loadFile
(Resource::Cache, PaletteLoader) hereten el fix automàticament.

Els fitxers de system_folder_ (config.yaml, debug.yaml, postfx.yaml,
crtpi.yaml) es passen com a rutes absolutes i resolve() les deixa
intactes, així no es veuen afectats.

Test targets (test_entities_smoke, test_scene_flow) enllacen ara
resource_helper.cpp perquè el seu codi passa per Helper::resolve. Els
tests corren amb CWD = repo root, on les rutes "data/..." funcionen
amb data root buit sense canviar cap assert.

Verificat executant el binari des de build/, /tmp i / — tots tres
troben els recursos i arrenquen correctament, tant en debug com en
release (release sempre arranca a LOGO).

source/core/input/key_config.cpp

@@ -4,6 +4,7 @@
 #include <iostream>
 #include <string>
 
+#include "core/resources/resource_helper.hpp"
 #include "external/fkyaml_node.hpp"
 
 auto KeyConfig::get() -> KeyConfig& {
@@ -12,16 +13,17 @@ auto KeyConfig::get() -> KeyConfig& {
 }
 
 void KeyConfig::load(const std::string& file_path) {
-    std::ifstream file(file_path);
+    const auto FULL = Resource::Helper::resolve(file_path);
+    std::ifstream file(FULL);
     if (!file.is_open()) {
-        std::cerr << "KeyConfig: no s'ha pogut obrir " << file_path << '\n';
+        std::cerr << "KeyConfig: no s'ha pogut obrir " << FULL << '\n';
         return;
     }
 
     try {
         auto yaml = fkyaml::node::deserialize(file);
         if (!yaml.contains("keys") || !yaml["keys"].is_sequence()) {
-            std::cerr << "KeyConfig: falta la secció 'keys' a " << file_path << '\n';
+            std::cerr << "KeyConfig: falta la secció 'keys' a " << FULL << '\n';
             return;
         }
         bindings_.clear();
@@ -36,9 +38,9 @@ void KeyConfig::load(const std::string& file_path) {
             }
             bindings_[ID] = SC;
         }
-        std::cout << "KeyConfig: " << bindings_.size() << " bindings des de " << file_path << '\n';
+        std::cout << "KeyConfig: " << bindings_.size() << " bindings des de " << FULL << '\n';
     } catch (const std::exception& e) {
-        std::cerr << "KeyConfig: error parsejant " << file_path << ": " << e.what() << '\n';
+        std::cerr << "KeyConfig: error parsejant " << FULL << ": " << e.what() << '\n';
     }
 }
 

source/core/locale/locale.cpp

@@ -4,6 +4,7 @@
 #include <iostream>
 #include <string>
 
+#include "core/resources/resource_helper.hpp"
 #include "external/fkyaml_node.hpp"
 
 namespace {
@@ -33,9 +34,10 @@ auto Locale::get() -> Locale& {
 }
 
 void Locale::load(const std::string& file_path) {
-    std::ifstream file(file_path);
+    const auto FULL = Resource::Helper::resolve(file_path);
+    std::ifstream file(FULL);
     if (!file.is_open()) {
-        std::cerr << "Locale: no s'ha pogut obrir " << file_path << '\n';
+        std::cerr << "Locale: no s'ha pogut obrir " << FULL << '\n';
         return;
     }
 
@@ -43,9 +45,9 @@ void Locale::load(const std::string& file_path) {
         auto yaml = fkyaml::node::deserialize(file);
         strings_.clear();
         flatten(yaml, "", strings_);
-        std::cout << "Locale: " << strings_.size() << " traduccions des de " << file_path << '\n';
+        std::cout << "Locale: " << strings_.size() << " traduccions des de " << FULL << '\n';
     } catch (const std::exception& e) {
-        std::cerr << "Locale: error parsejant " << file_path << ": " << e.what() << '\n';
+        std::cerr << "Locale: error parsejant " << FULL << ": " << e.what() << '\n';
     }
 }
 

source/core/resources/resource_helper.cpp

@@ -2,20 +2,41 @@
 
 #include <fstream>
 #include <iostream>
+#include <string>
 
 namespace Resource::Helper {
 
+    namespace {
+
+        std::string g_data_root;
+
+    }  // namespace
+
+    void setDataRoot(const std::string& absolute_path) {
+        g_data_root = absolute_path;
+        if (!g_data_root.empty() && g_data_root.back() != '/') {
+            g_data_root += '/';
+        }
+    }
+
+    auto resolve(const std::string& filepath) -> std::string {
+        if (filepath.empty() || filepath.front() == '/') { return filepath; }
+        if (g_data_root.empty()) { return filepath; }
+        return g_data_root + filepath;
+    }
+
     auto loadFile(const std::string& filepath) -> std::vector<std::uint8_t> {
-        std::ifstream file(filepath, std::ios::binary | std::ios::ate);
+        const auto FULL = resolve(filepath);
+        std::ifstream file(FULL, std::ios::binary | std::ios::ate);
         if (!file) {
-            std::cerr << "Resource::Helper: cannot open " << filepath << '\n';
+            std::cerr << "Resource::Helper: cannot open " << FULL << '\n';
             return {};
         }
         std::streamsize size = file.tellg();
         file.seekg(0, std::ios::beg);
         std::vector<std::uint8_t> data(static_cast<std::size_t>(size));
         if (!file.read(reinterpret_cast<char*>(data.data()), size)) {
-            std::cerr << "Resource::Helper: failed to read " << filepath << '\n';
+            std::cerr << "Resource::Helper: failed to read " << FULL << '\n';
             return {};
         }
         return data;

source/core/resources/resource_helper.hpp

@@ -6,7 +6,23 @@
 
 namespace Resource::Helper {
 
+    // Estableix el prefix absolut des d'on es resolen totes les rutes
+    // relatives passades a `loadFile`/`resolve`. Pensat per a cridar-se una
+    // sola vegada al primer pas del Director amb `SDL_GetBasePath()`: així el
+    // binari troba `data/` sense dependre del CWD des d'on s'ha llançat (és
+    // obligatori per a .app de macOS i útil a Linux per no haver d'estar
+    // dins de `build/`).
+    void setDataRoot(const std::string& absolute_path);
+
+    // Resol una ruta relativa contra el data root. Si la ruta ja és absoluta
+    // (comença per '/') la retorna sense modificar — així els fitxers de
+    // config (system_folder_ + "config.yaml") segueixen funcionant sense
+    // canvis al call site.
+    [[nodiscard]] auto resolve(const std::string& filepath) -> std::string;
+
     // Carga un fitxer del filesystem (a aquesta fase encara no hi ha pack).
+    // Les rutes relatives es resolen via `resolve()`; les absolutes s'obrin
+    // directament.
     auto loadFile(const std::string& filepath) -> std::vector<std::uint8_t>;
 
 }  // namespace Resource::Helper

source/core/system/director.cpp

@@ -19,6 +19,7 @@
 #include "core/rendering/surface.hpp"
 #include "core/rendering/text.hpp"
 #include "core/resources/resource_cache.hpp"
+#include "core/resources/resource_helper.hpp"
 #include "core/scene/scene.hpp"
 #include "core/system/event_buffer.hpp"
 #include "game/debug_config.hpp"
@@ -35,6 +36,15 @@ Director::Director() {
         std::fprintf(stderr, "SDL_Init failed: %s\n", SDL_GetError());
     }
 
+    // Rutes dels recursos relatives a l'executable, no al CWD. SDL_GetBasePath
+    // retorna la carpeta del binari al desplegament portable i Contents/
+    // Resources/ dins d'un .app a macOS. Ha de fer-se abans de qualsevol
+    // loader que passi per Resource::Helper::resolve (Locale, KeyConfig,
+    // Resource::Cache, PaletteLoader, etc.).
+    if (const char* base = SDL_GetBasePath()) {
+        Resource::Helper::setDataRoot(base);
+    }
+
     // Prepara la carpeta de sistema (~/.config/jailgames/aee_2026/) i carrega
     // les opcions; si no existeix config.yaml el crea amb els defaults.
     createSystemFolder();