Check.h

Go to the documentation of this file.

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

 
#include <span>
#include <string>
#include <string_view>
#include <vector>
 
#include "Core/Math/DeterministicRandom.h"
 
namespace core {

inline constexpr int D20_FACES = 20;

enum class RollStance {
    Normal,
    Advantage,
    Disadvantage,
};

[[nodiscard]] constexpr RollStance rollStance(int advantageSources,
                                              int disadvantageSources) noexcept {
    const bool avantage = advantageSources > 0;
    const bool desavantage = disadvantageSources > 0;
    if (avantage == desavantage) {
        return RollStance::Normal;  // aucun des deux, ou les deux : ils s'annulent.
    }
    return avantage ? RollStance::Advantage : RollStance::Disadvantage;
}

struct Modifier {
    std::string source;
    int value = 0;
};

struct CheckResult {
    std::vector<int> dice;
    int keptDie = 0;
    std::vector<Modifier> modifiers;
    int total = 0;
    int target = 0;
    RollStance stance = RollStance::Normal;

    [[nodiscard]] constexpr bool isNaturalTwenty() const noexcept {
        return keptDie == D20_FACES;
    }

    [[nodiscard]] constexpr bool isNaturalOne() const noexcept {
        return keptDie == 1;
    }

    [[nodiscard]] constexpr bool succeeded() const noexcept {
        return total >= target;
    }

    [[nodiscard]] std::string describe() const;
};

[[nodiscard]] CheckResult rollCheck(int target, std::span<const Modifier> modifiers,
                                    RollStance stance, DeterministicRandom& random);

[[nodiscard]] std::string_view rollStanceName(RollStance stance) noexcept;
 
}  // namespace core