namespace AcDream.Core.Physics;

/// <summary>
/// Retail <c>EncumbranceSystem</c> (named-retail decomp
/// <c>docs/research/named-retail/acclient_2013_pseudo_c.txt</c> pc 256393),
/// the pure load/capacity math consumed by <see cref="MovementSystem"/> and
/// <see cref="PlayerWeenie"/>'s <c>InqLoad</c>-equivalent chain.
///
/// <para>
/// These are the SAME three formulas <c>AcDream.Core.Items.BurdenMath</c>
/// already ports (verified against the identical retail addresses, used by
/// the burden HUD / character sheet / indicator bar). Rather than re-derive
/// them a second time under a different name, this class delegates —
/// P1 (2026-07-30, Campaign P) needs the retail-named surface next to
/// <see cref="MovementSystem"/> for citation clarity, but a single formula
/// implementation keeps the burden HUD and movement physics from drifting
/// apart. See <c>docs/research/2026-07-30-stat-coupled-movement-pseudocode.md</c>
/// §2 and §6.
/// </para>
/// </summary>
public static class EncumbranceSystem
{
    /// <summary>
    /// <c>EncumbranceSystem::EncumbranceCapacity</c> 0x004fcc00:
    /// <c>strength &lt;= 0 ? 0 : strength*150 + clamp(aug*30, 0, 150)*strength</c>.
    /// </summary>
    public static int EncumbranceCapacity(int strength, int aug) =>
        AcDream.Core.Items.BurdenMath.EncumbranceCapacity(strength, aug);

    /// <summary>
    /// <c>EncumbranceSystem::Load</c> 0x004fcc40: <c>burden / capacity</c>
    /// (1.0 = at capacity). Returns 0 when capacity &lt;= 0 (no-data).
    /// </summary>
    public static float Load(int capacity, int burden) =>
        AcDream.Core.Items.BurdenMath.LoadRatio(capacity, burden);

    /// <summary>
    /// <c>EncumbranceSystem::LoadMod</c> 0x004fcc70: full effectiveness
    /// through 100% load, linear falloff to zero at 200%, zero above it.
    /// </summary>
    public static float LoadMod(float load) =>
        AcDream.Core.Items.BurdenMath.LoadModifier(load);
}