namespace AcDream.UI.Abstractions.Panels.Settings;

/// <summary>
/// The five CLIENT-LOCAL preferences retail's "Use Mouse Turning Settings"
/// Gameplay-tab button (<c>gmConfigUI::SetMouseTurningDefaults @0x0049E8F0</c>)
/// writes alongside the one server-synced bit
/// (<c>PlayerOption.UseMouseTurning</c>, carried through
/// <c>RuntimeCharacterOptionsState</c> / <c>SetSingleCharacterOption (0x0005)</c>
/// — NOT stored here). Persisted to <c>settings.json</c> the same way
/// <see cref="AudioSettings"/>/<see cref="DisplaySettings"/> are; this is the
/// forward-compatible home Campaign OP slice OP6's full Config tab (27 rows)
/// re-homes into its own preference groups without a storage-shape change —
/// these five keys ARE four of that tab's Camera/Input rows
/// (<c>Camera_Stiffness</c>, <c>Camera_AdjustmentSpeed</c>,
/// <c>Camera_AlignToSlope</c>, <c>Input_MouseLookSensitivity</c>,
/// <c>Input_InvertMouseLookYAxis</c> — research doc
/// <c>2026-08-10-options-panel-structure.md</c> §4).
/// </summary>
public sealed record CameraTurningSettings(
    float Stiffness,
    float AdjustmentSpeed,
    float MouseLookSensitivity,
    bool AlignToSlope,
    bool InvertMouseLookYAxis)
{
    /// <summary>
    /// Retail's ORDINARY Config-tab defaults (NOT the mouse-turning macro's
    /// targets — <c>gmConfigUI::InitOptions @0x0049E400</c>, research doc §4):
    /// Stiffness 0.45 (<c>0x3EE66666</c>), AdjustmentSpeed 40.0
    /// (<c>0x42200000</c>), MouseLookSensitivity 0.55 (<c>0x3F0CCCCD</c>),
    /// AlignToSlope on, InvertMouseLookYAxis off.
    /// </summary>
    public static CameraTurningSettings Default { get; } = new(
        Stiffness: 0.45f,
        AdjustmentSpeed: 40.0f,
        MouseLookSensitivity: 0.55f,
        AlignToSlope: true,
        InvertMouseLookYAxis: false);

    /// <summary>
    /// The mouse-turning macro's recommended targets
    /// (<c>SetMouseTurningDefaults</c>, research doc §4.4): Stiffness 0.95,
    /// AdjustmentSpeed 50.0, MouseLookSensitivity 0.7, AlignToSlope OFF,
    /// InvertMouseLookYAxis ON.
    /// </summary>
    public static CameraTurningSettings MouseTurningTarget { get; } = new(
        Stiffness: 0.95f,
        AdjustmentSpeed: 50.0f,
        MouseLookSensitivity: 0.7f,
        AlignToSlope: false,
        InvertMouseLookYAxis: true);
}