feat(debug): starting_level a debug.yaml

Nova clau opcional al debug.yaml:
    starting_level: { pyramid: 2, room: 3 }
DebugConfig::resolveStartingLevel retorna optional<StartingLevel>; el
Director, abans de crear el GameScene, demana al LevelManager
setStartingPoint(pyramid, room) — que cerca l'entrada al levels.yaml
i hi posiciona l'índex. Si la clau no està (cas habitual) o
(pyramid, room) no existeix, la progressió arrenca a la primera sala
amb un avís a stderr. createDefaultIfMissing documenta la nova clau
sense escriure-la (la deixem opcional).

Drive-by: NOLINT puntual al capture de STARTING_PLAYERS al Director.
És pre-existent i s'ha activat ara perquè el commit toca director.cpp;
la captura és imprescindible en Debug (valor runtime), clang la veu
redundant en Release on és constexpr literal.
This commit is contained in:
JailDesigner committed 2026-04-26 15:07:34 +02:00
1 parent b147590a39
commit 738cde12bb
5 files changed
+81 -1

No files matched your search

+13
View File
@@ -1,6 +1,7 @@
#pragma once
#include <cstdint>
#include <optional>
#include <string>
// Configuració personal de desenvolupament, carregada de `debug.yaml` dins la
@@ -37,6 +38,18 @@ namespace DebugConfig {
[[nodiscard]] auto parseStartingPlayers(const std::string& yaml_content) -> StartingPlayers;
[[nodiscard]] auto resolveStartingPlayers(const std::string& file_path) -> StartingPlayers;
// Punt d'arrencada dins de la progressió de sales (consumit pel
// `Levels::LevelManager`). YAML:
// starting_level: { pyramid: 2, room: 3 }
// L'absència de la clau és el cas habitual i deixa la progressió a
// la primera entrada del `levels.yaml`.
struct StartingLevel {
int pyramid{0};
int room{0};
};
[[nodiscard]] auto parseStartingLevel(const std::string& yaml_content) -> std::optional<StartingLevel>;
[[nodiscard]] auto resolveStartingLevel(const std::string& file_path) -> std::optional<StartingLevel>;
// Nom canònic de l'enum (útil per a logs): "LOGO" / "TITLE" / "INTRO" / "GAME".
[[nodiscard]] auto toString(StartScene scene) -> const char*;
[[nodiscard]] auto toString(StartingPlayers players) -> const char*;