using Unity.Entities;

namespace ProjectM.Simulation
{
    /// <summary>
    /// SERVER-ONLY working state for the expedition BOSS (a scaled Charger that <see cref="Server"/>'s
    /// RoomEnemyDirectorSystem tags at spawn). NOT replicated and NOT baked — added at runtime via ECB on the boss
    /// entity, so it needs no ghost-hash change (a runtime-added replicated component would not replicate anyway;
    /// this one is deliberately server-only, like <see cref="LungeState"/>/<see cref="KnockbackState"/>).
    /// <para>
    /// Component PRESENCE is the boss discriminator: BossAISystem is the SOLE mover/attacker of
    /// <c>.WithAll&lt;EnemyTag, BossState&gt;()</c>, and EnemyAISystem's Charger MOVE pass excludes it via
    /// <c>.WithNone&lt;BossState&gt;()</c> so exactly one system writes the boss's Position/AttackWindup. The boss does
    /// NOT use LungeState (its signature move is a telegraphed radial SLAM, not a lunge) — so EnemyAISystem's
    /// IsLunging derive visits it but sees <c>LungeState.UntilTick==0</c> and derives the bit off (harmless single
    /// writer). <see cref="Phase"/> is a byte (never a C# enum on a Bursted path — the cross-assembly-enum ICE rule).
    /// All tick fields route through <c>TickUtil.NonZero</c> and compare with <see cref="Unity.NetCode.NetworkTick"/>.
    /// </para>
    /// </summary>
    public struct BossState : IComponentData
    {
        /// <summary>1 = phase one (heavy Charger + slam), 2 = phase two (&lt;50% HP: faster + summons adds). Byte, not enum.</summary>
        public byte Phase;

        /// <summary>Earliest raw tick the boss may begin its next radial SLAM wind-up (NonZero; 0 = ready).</summary>
        public uint SlamReadyTick;

        /// <summary>Earliest raw tick the boss may summon its next add pack (phase two only; NonZero; 0 = ready).</summary>
        public uint SummonReadyTick;

        /// <summary>Earliest raw tick the boss may begin its next LUNGE wind-up (B4; NonZero; 0 = ready).</summary>
        public uint LungeReadyTick;

        /// <summary>Which attack the live AttackWindup belongs to: 0 = radial slam, 1 = lunge (B4 — slam and lunge
        /// share the one replicated windup field; this server-only byte disambiguates the elapse branch). The client
        /// distinguishes via the IsLunging ghost bit instead (BossAISystem holds LungeState.UntilTick through the
        /// lunge wind-up + travel, so EnemyAISystem's derive turns the bit on).</summary>
        public byte PendingAttack;
    }
}