feat(intro): font dedicada (CaesarDressing) i separació vertical entre línies

Nova font del rètol de transició de sala (ROOM_INTRO i ROOM_OUTRO):
CaesarDressing-Regular, vista com a fonts.room_text al data/ui.yaml i
exposada per UiConfig::roomTextFont(). Director la preloda al costat
de la del HUD i la del placeholder; GameScene construeix
room_text_font_ paral·lel a pause_font_ i renderRoomText l'usa per a
les dues línies de l'INTRO i el text de l'OUTRO. La pausa segueix
amb la font placeholder antiga — no es barregen.

Espai vertical configurable: nova clau room_intro.line_gap_px al
data/scenes/game.yaml (default 8 px). El gap es suma al lineHeight
natural del font i es reparteix simètricament cap amunt i cap avall
del CENTER_Y, deixant el bloc de dues línies sempre centrat. Es
poden afinar des del YAML sense recompilar.

source/core/system/director.cpp

@@ -122,6 +122,14 @@ Director::Director() {
     const std::string PLACEHOLDER_FONT_GIF_KEY = UiConfig::get().placeholderFont().name + ".gif";
     Resource::Cache::get().loadSurface(PLACEHOLDER_FONT_GIF_KEY, UiConfig::get().placeholderFont().gif);
     Resource::Cache::get().getSurface(PLACEHOLDER_FONT_GIF_KEY)->setPalette(Resource::Cache::get().getPalette("ui"));
+    // Font del rètol de transició de sala (la consumeix `GameScene`
+    // tant per la línia "Piràmide N / Sala M" de l'INTRO com pel
+    // "Fase completada" de l'OUTRO). Es preloda ací per consistència
+    // amb la resta de fonts d'UI; sense això, la primera entrada a
+    // GAME aniria a disc.
+    const std::string ROOM_TEXT_FONT_GIF_KEY = UiConfig::get().roomTextFont().name + ".gif";
+    Resource::Cache::get().loadSurface(ROOM_TEXT_FONT_GIF_KEY, UiConfig::get().roomTextFont().gif);
+    Resource::Cache::get().getSurface(ROOM_TEXT_FONT_GIF_KEY)->setPalette(Resource::Cache::get().getPalette("ui"));
 
     // Música de la piràmide 1 (primer i únic track de moment). Carreguem ací
     // perquè forma part del preload d'assets, com la font i la paleta.

source/core/ui/ui_config.cpp

@@ -96,6 +96,7 @@ UiConfig::UiConfig()
       pause_exit_curve_(curveByName(Defaults::UI::PAUSE_EXIT_CURVE)),
       hud_font_{.name = Defaults::UI::Font::HUD_NAME, .gif = Defaults::UI::Font::HUD_GIF, .fnt = Defaults::UI::Font::HUD_FNT, .kerning = Defaults::UI::Font::HUD_KERNING},
       placeholder_font_{.name = Defaults::UI::Font::PLACEHOLDER_NAME, .gif = Defaults::UI::Font::PLACEHOLDER_GIF, .fnt = Defaults::UI::Font::PLACEHOLDER_FNT, .kerning = Defaults::UI::Font::PLACEHOLDER_KERNING},
+      room_text_font_{.name = Defaults::UI::Font::ROOM_TEXT_NAME, .gif = Defaults::UI::Font::ROOM_TEXT_GIF, .fnt = Defaults::UI::Font::ROOM_TEXT_FNT, .kerning = Defaults::UI::Font::ROOM_TEXT_KERNING},
       menu_title_font_{.name = Defaults::UI::Font::MENU_TITLE_NAME, .gif = Defaults::UI::Font::MENU_TITLE_GIF, .fnt = Defaults::UI::Font::MENU_TITLE_FNT, .kerning = Defaults::UI::Font::MENU_TITLE_KERNING},
       menu_items_font_{.name = Defaults::UI::Font::MENU_ITEMS_NAME, .gif = Defaults::UI::Font::MENU_ITEMS_GIF, .fnt = Defaults::UI::Font::MENU_ITEMS_FNT, .kerning = Defaults::UI::Font::MENU_ITEMS_KERNING} {
 }
@@ -159,6 +160,7 @@ void UiConfig::load(const std::string& file_path) {
             const auto& f = yaml["fonts"];
             readFont(f, "hud", hud_font_);
             readFont(f, "placeholder", placeholder_font_);
+            readFont(f, "room_text", room_text_font_);
             readFont(f, "menu_title", menu_title_font_);
             readFont(f, "menu_items", menu_items_font_);
         }

source/core/ui/ui_config.hpp

@@ -77,6 +77,7 @@ class UiConfig {
     // Fonts de UI.
     [[nodiscard]] auto hudFont() const -> const Font& { return hud_font_; }
     [[nodiscard]] auto placeholderFont() const -> const Font& { return placeholder_font_; }
+    [[nodiscard]] auto roomTextFont() const -> const Font& { return room_text_font_; }
     [[nodiscard]] auto menuTitleFont() const -> const Font& { return menu_title_font_; }
     [[nodiscard]] auto menuItemsFont() const -> const Font& { return menu_items_font_; }
 
@@ -118,6 +119,7 @@ class UiConfig {
 
     Font hud_font_;
     Font placeholder_font_;
+    Font room_text_font_;
     Font menu_title_font_;
     Font menu_items_font_;
 

source/game/scenes/game_scene.cpp

@@ -436,6 +436,13 @@ GameScene::GameScene(Config config)
     pause_font_ = std::make_shared<Text>(pause_surface, UiConfig::get().placeholderFont().fnt);
     pause_font_->setDefaultKerning(UiConfig::get().placeholderFont().kerning);
 
+    // Font del rètol de transició de sala. Mateixa convenció que la pausa
+    // (Surface preloaded pel Director, només construïm el `Text` ací).
+    const std::string ROOM_TEXT_FONT_KEY = UiConfig::get().roomTextFont().name + ".gif";
+    auto room_text_surface = Resource::Cache::get().getSurface(ROOM_TEXT_FONT_KEY);
+    room_text_font_ = std::make_shared<Text>(room_text_surface, UiConfig::get().roomTextFont().fnt);
+    room_text_font_->setDefaultKerning(UiConfig::get().roomTextFont().kerning);
+
     // 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);
@@ -627,10 +634,10 @@ void GameScene::renderRoomFade() {
 }
 
 void GameScene::renderRoomText() {
-    // Text de la transició de sala. Reusa la font cachejada per a la
-    // pausa (mateix tipus de lletra, mateix índex de color), i fa el
-    // mateix patró esquerra → centre → dreta que el text de pausa però
-    // amb les durades pròpies de la transició.
+    // Text de la transició de sala. Font dedicada (`room_text_font_`,
+    // CaesarDressing per defecte) — la pausa té la seua i no es barregen.
+    // Patró esquerra → centre → dreta amb les durades pròpies de la
+    // transició.
     //
     // Mapatge per estat (només els estats amb text actiu hi entren):
     //   ROOM_INTRO: phases 2..4 → enter / hold / exit; dues línies
@@ -639,7 +646,7 @@ void GameScene::renderRoomText() {
     //               per deixar la porta oberta a desacoblar-les.
     //   ROOM_OUTRO: phases 0..2 → enter / hold / exit; una línia
     //               ("fase completada").
-    if (!pause_font_) { return; }
+    if (!room_text_font_) { return; }
 
     constexpr int KERNING = 0;
     constexpr Uint8 OUTLINE_WHITE = 255;
@@ -671,7 +678,7 @@ void GameScene::renderRoomText() {
     };
 
     auto draw_line = [&](const std::string& text, int x, int y) {
-        pause_font_->writeDX(Text::CENTER_FLAG | Text::COLOR_FLAG | Text::STROKE4_FLAG,
+        room_text_font_->writeDX(Text::CENTER_FLAG | Text::COLOR_FLAG | Text::STROKE4_FLAG,
             x,
             y,
             text,
@@ -685,25 +692,28 @@ void GameScene::renderRoomText() {
         const auto& mgr = Levels::LevelManager::get();
         const std::string LINE_PYRAMID = RoomFsm::formatIntroPyramidLine(mgr.currentPyramid());
         const std::string LINE_ROOM = RoomFsm::formatIntroRoomLine(mgr.currentRoom());
-        const int W_PYRAMID = pause_font_->length(LINE_PYRAMID, KERNING);
-        const int W_ROOM = pause_font_->length(LINE_ROOM, KERNING);
+        const int W_PYRAMID = room_text_font_->length(LINE_PYRAMID, KERNING);
+        const int W_ROOM = room_text_font_->length(LINE_ROOM, KERNING);
         const int DUR_ENTER = transition_config_.intro_text_enter_ms;
         const int DUR_EXIT = transition_config_.intro_text_exit_ms;
         const int X_PYRAMID = compute_x(W_PYRAMID, 2, 4, DUR_ENTER, DUR_EXIT);
         const int X_ROOM = compute_x(W_ROOM, 2, 4, DUR_ENTER, DUR_EXIT);
-        // Bloc de dues línies centrat al voltant de CENTER_Y: la
-        // piràmide ocupa la línia de damunt, la sala la de davall. Si
-        // un dia el font canvia d'alçada, `getLineHeight` ho reflecteix.
-        const int LINE_HEIGHT = pause_font_->getLineHeight();
-        const int Y_PYRAMID = GameCanvas::CENTER_Y - LINE_HEIGHT;
-        const int Y_ROOM = GameCanvas::CENTER_Y;
+        // Bloc de dues línies centrat al voltant de CENTER_Y. Entre
+        // les dues línies hi posem `intro_text_line_gap_px` extra (a
+        // més del lineHeight natural) per donar-los aire visual; la
+        // meitat la traiem cap amunt de la piràmide i la meitat la
+        // sumem cap avall a la sala, mantenint el centre del bloc fix.
+        const int LINE_HEIGHT = room_text_font_->getLineHeight();
+        const int GAP = transition_config_.intro_text_line_gap_px;
+        const int Y_PYRAMID = GameCanvas::CENTER_Y - LINE_HEIGHT - (GAP / 2);
+        const int Y_ROOM = GameCanvas::CENTER_Y + (GAP / 2);
         draw_line(LINE_PYRAMID, X_PYRAMID, Y_PYRAMID);
         draw_line(LINE_ROOM, X_ROOM, Y_ROOM);
     } else if (state_ == RoomFsm::State::ROOM_OUTRO && transition_.phase >= 0 && transition_.phase <= 2) {
         const std::string TEXT = Locale::get().text("game.room_complete");
-        const int W = pause_font_->length(TEXT, KERNING);
+        const int W = room_text_font_->length(TEXT, KERNING);
         const int X = compute_x(W, 0, 2, transition_config_.outro_text_enter_ms, transition_config_.outro_text_exit_ms);
-        const int Y = GameCanvas::CENTER_Y - (pause_font_->getLineHeight() / 2);
+        const int Y = GameCanvas::CENTER_Y - (room_text_font_->getLineHeight() / 2);
         draw_line(TEXT, X, Y);
     }
 }

source/game/scenes/game_scene.hpp

@@ -153,6 +153,13 @@ class GameScene : public Scene {
     // abans — ja cachejada al Director.
     std::shared_ptr<Text> pause_font_;
 
+    // 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
+    // placeholder.
+    std::shared_ptr<Text> room_text_font_;
+
     enum class PauseState : std::uint8_t {
         IDLE,      // Joc corrent; cap transició en marxa. scale == 1.
         ENTERING,  // Frenant cap a la pausa. scale decreix a 0.

source/game/scenes/room_fsm.cpp

@@ -43,6 +43,7 @@ namespace RoomFsm {
             cfg.intro_text_hold_ms = readChildInt(n, "text_hold_ms", cfg.intro_text_hold_ms);
             cfg.intro_text_exit_ms = readChildInt(n, "text_exit_ms", cfg.intro_text_exit_ms);
             cfg.player_spawn_delay_ms = readChildInt(n, "player_spawn_delay_ms", cfg.player_spawn_delay_ms);
+            cfg.intro_text_line_gap_px = readChildInt(n, "line_gap_px", cfg.intro_text_line_gap_px);
         }
         if (yaml.contains("room_outro")) {
             const auto& n = yaml["room_outro"];

source/game/scenes/room_fsm.hpp

@@ -49,6 +49,13 @@ namespace RoomFsm {
         // moment en què el fade-in acaba i el text encara no ha entrat.
         int player_spawn_delay_ms{500};
 
+        // Píxels extra entre les dues línies del text d'INTRO (piràmide
+        // damunt, sala davall). Es sumen al `lineHeight` natural del
+        // font per separar visualment les dues línies. 0 = stack
+        // immediat (com l'antic single-line). El YAML pot afinar-lo
+        // sense recompilar.
+        int intro_text_line_gap_px{8};
+
         UiConfig::CurveFn text_enter_curve{nullptr};
         UiConfig::CurveFn text_exit_curve{nullptr};
     };

source/utils/defaults.hpp

@@ -130,6 +130,15 @@ namespace Defaults {
             constexpr const char* PLACEHOLDER_FNT = "data/fonts/ari-w9500-condensed-display.fnt";
             constexpr int PLACEHOLDER_KERNING = 1;
 
+            // Text de transició de sala (ROOM_INTRO "Piràmide N / Sala M" i
+            // ROOM_OUTRO "Fase completada"). Font temàtica diferenciada de la
+            // del HUD i de la dels placeholders perquè el rètol de fase tinga
+            // pes visual propi. La pausa segueix amb la PLACEHOLDER.
+            constexpr const char* ROOM_TEXT_NAME = "CaesarDressing-Regular";
+            constexpr const char* ROOM_TEXT_GIF = "data/fonts/CaesarDressing-Regular.gif";
+            constexpr const char* ROOM_TEXT_FNT = "data/fonts/CaesarDressing-Regular.fnt";
+            constexpr int ROOM_TEXT_KERNING = 1;
+
             // Menú de servei (F9): títol en display normal, items en la
             // variant condensed-display (més compacta, perquè caben més
             // files sense encongir la caixa). Kerning 0 a totes dues perquè