using Unity.Entities;
using Unity.NetCode;

namespace ProjectM.Simulation
{
    /// <summary>
    /// Long-arc progress toward the goal ("reach THEM"). Lives on the GLOBAL CycleDirector ghost (relevant in
    /// every region, alongside CycleState + the resource ledger), so it is visible to all players regardless
    /// of region. Sole PRODUCTION writer (DR-042): <c>ExpeditionGateSystem</c> increments <see cref="Charge"/> by
    /// one per cleared EXPEDITION (on the player's return). <c>GoalReachedSystem</c> only READS the Charge==Target
    /// edge to arm the climactic final siege. (<c>DebugCommandReceiveSystem</c> is a manual dev-op writer.) The HUD
    /// observes it for a progress bar.
    /// </summary>
    public struct GoalProgress : IComponentData
    {
        /// <summary>Accumulated progress.</summary>
        [GhostField] public int Charge;

        /// <summary>Charge required to reach the goal.</summary>
        [GhostField] public int Target;
    }
}