namespace ProjectM.Simulation
{
    /// <summary>
    /// Shared tick helpers for the project-wide convention that a stored raw "next tick" value of <c>0</c> means
    /// "ready / nothing pending". A computed absolute tick (<c>ServerTick + delay</c>) can legitimately equal 0 at
    /// <see cref="uint"/> wraparound, which would be misread as "ready"; <see cref="NonZero"/> coerces it to 1 (a
    /// 1-tick error only at the single wrap instant). Mirrors the guard already inlined in
    /// <see cref="RespawnMath.RespawnTick"/>, applied consistently at every cooldown/spawn "next tick" write
    /// (<c>AbilityCooldown.NextFireTick</c>, <c>EnemyAttackCooldown.NextAttackTick</c>,
    /// <c>EnemySpawner.NextSpawnTick</c>).
    /// </summary>
    public static class TickUtil
    {
        /// <summary>Coerce a computed raw tick of 0 to 1 so it never collides with the "0 = ready" sentinel.</summary>
        public static uint NonZero(uint tick) => tick == 0u ? 1u : tick;
    }
}