CombatTransition.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once

 
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
#include "Core/Combat/Encounter.h"
#include "Core/Levels/GridPosition.h"
#include "Core/Levels/MapEntity.h"
#include "Core/Math/Vector2.h"
 
namespace core {
 
class WorldFlags;

struct ExplorationSnapshot {
    Vector2 playerPosition{};
    Vector2 playerFacing{1.0F, 0.0F};
    Vector2 cameraPosition{};
    bool captured = false;
};

enum class CombatOutcome {
    Victory,
    Flight,
    Defeat,
};

struct EncounterRun {
    ExplorationSnapshot exploration;
    std::string encounterId;
    std::string defeatFlagKey;
    std::vector<CombatantPlacement> placements;
    bool escapable = true;
};

[[nodiscard]] EncounterRun beginEncounter(const Encounter& encounter,
                                          const ExplorationSnapshot& exploration,
                                          GridPosition trigger, std::string defeatFlagKey);

[[nodiscard]] ExplorationSnapshot endEncounter(const EncounterRun& run, CombatOutcome outcome,
                                               WorldFlags& flags);

[[nodiscard]] bool encounterAlreadyCleared(const WorldFlags& flags, std::string_view defeatFlagKey);

inline constexpr std::string_view ENCOUNTER_ENTITY_TYPE = "encounter";

struct EncounterTrigger {
    std::string encounterId;
    GridPosition position;
    std::string defeatFlagKey;
};

[[nodiscard]] std::optional<EncounterTrigger> encounterTriggerFor(const MapEntity& entity,
                                                                  std::string_view mapName);
 
}  // namespace core