ArcadeGliderFlightModel.h

#pragma once
 
#include <glm/glm.hpp>
 
namespace Engine::Components
{
    struct ArcadeGliderTuning
    {
        float momentumDrag = 0.12f;  
        float highSpeedDrag = 0.005f;  
        float minGlideSink = 0.65f;  
        float maxClimbRate = 6.0f;  
        float climbMomentumCost = 0.48f;  
        float diveSinkRate = 7.0f;  
        float diveMomentumGain = 0.72f;  
        float windMomentumGain = 0.72f;  
        float windDiminishingSpeed = 12.0f;  
        float windAlignmentPower = 1.6f;  
        float crosswindTurnRate = 0.06f;  
        float headwindPenalty = 0.55f;  
        float glideTurnRate = 7.0f;  
        float stallSpeed = 3.5f;  
        float stallRecoverySpeed = 4.7f;  
        float stallSinkSpeed = 6.0f;  
        float stallDiveSinkScale = 0.35f;  
        float stallExtraDrag = 0.12f;  
        float stallRecoveryDelay = 0.18f;  
        float emergencyMaxSpeed = 80.0f;  
    };

    struct ArcadeGliderState
    {
        bool stalled = false;

        float stallRecoveryTimer = 0.0f;
    };

    struct ArcadeGliderInput
    {
        glm::vec3 velocity{ 0.0f };

        glm::vec3 glideDirection{ 0.0f, 0.0f, -1.0f };

        glm::vec3 windVelocity{ 0.0f };

        float palmTilt = 0.0f;

        float deltaTime = 0.0f;

        ArcadeGliderState state{};
    };

    struct ArcadeGliderStep
    {
        glm::vec3 velocity{ 0.0f };

        glm::vec3 glideDirection{ 0.0f, 0.0f, -1.0f };

        float momentum = 0.0f;

        float verticalVelocity = 0.0f;

        float climbDemand = 0.0f;

        float diveDemand = 0.0f;

        float windAlignment = 0.0f;

        float windMomentumDelta = 0.0f;

        float dragDelta = 0.0f;

        float climbMomentumDelta = 0.0f;

        bool stalled = false;

        bool enteredStall = false;

        bool recoveredStall = false;

        float stallRecoveryTimer = 0.0f;
    };

    [[nodiscard]] ArcadeGliderStep stepArcadeGliderFlight(
        const ArcadeGliderTuning & tuning,
        const ArcadeGliderInput & input
    );
}  // namespace Engine::Components