using Unity.Entities;

namespace ProjectM.Simulation
{
    /// <summary>
    /// SERVER-ONLY homing reel on a Husk hit by a Reel-flagged (HookPull) projectile — the Harpooner's signature
    /// verb. A sibling of <see cref="KnockbackState"/>/<see cref="LungeState"/> (NOT a <c>[GhostField]</c>: the
    /// reeled position replicates via the stock LocalTransform variant, so it adds no replicated surface). Unlike
    /// the frozen-Dir pull flag, this HOMES: <c>ReelSystem</c> re-aims the Husk's <see cref="KnockbackState"/>
    /// toward the caster's CURRENT position every server tick until the target is within release range or
    /// <see cref="ExpireTick"/> elapses — <c>EnemyAISystem</c> stays the SOLE Position writer (it drives the
    /// re-aimed knockback; ReelSystem only writes the Dir/Speed/UntilTick). Baked inert on Husk variants
    /// (EnemyAuthoring). Stores the caster's <see cref="Unity.NetCode.NetworkId"/> (not an Entity) so ReelSystem
    /// resolves the live caster position via a per-tick player-by-NetworkId gather. Ticks via
    /// <see cref="TickUtil.NonZero"/>; compared with <see cref="Unity.NetCode.NetworkTick"/> only.
    /// </summary>
    public struct ReelState : IComponentData
    {
        /// <summary>NetworkId of the reeling caster; ReelSystem homes toward this player's live position.</summary>
        public int CasterNetworkId;

        /// <summary>Reel pull speed (world units/sec) written into KnockbackState.Speed each tick.</summary>
        public float Speed;

        /// <summary>Raw tick the reel leash ends (NonZero). <c>0</c> = not reeling; active while .IsNewerThan(serverTick).</summary>
        public uint ExpireTick;
    }
}