Increase performance of GetAnnotatedLine

This switches getting the first endOfLine to a new dedicated extension that takes as much shortcuts as possible.

Author: MDoerner

Rubberduck.Parsing/Annotations/AnnotationBase.cs

@@ -36,7 +36,7 @@ protected AnnotationBase(AnnotationType annotationType, QualifiedSelection quali
             //Annotations on the same line as non-whitespace statements do not scope to anything.
             if (enclosingEndOfStatement.Start.TokenIndex != 0)
             {
-                var firstEndOfLine = enclosingEndOfStatement.GetDescendent<VBAParser.EndOfLineContext>();
+                var firstEndOfLine = enclosingEndOfStatement.GetFirstEndOfLine();
                 var parentEndOfLine = Context.GetAncestor<VBAParser.EndOfLineContext>();
                 if (firstEndOfLine.Equals(parentEndOfLine))
                 {

Rubberduck.Parsing/ParserRuleContextExtensions.cs

@@ -221,6 +221,25 @@ public static bool TryGetChildContext<TContext>(this ParserRuleContext ctxt, out
             return opCtxt != null;
         }
 
+        /// <summary>
+        /// Returns the endOfStatementContext's first endOfLine context.
+        /// </summary>
+        public static VBAParser.EndOfLineContext GetFirstEndOfLine(this VBAParser.EndOfStatementContext endOfStatement)
+        {
+            //This dedicated method exists for performance reasons on hot-paths.
+            var individualEndOfStatements = endOfStatement.individualNonEOFEndOfStatement();
+            foreach (var individualEndOfStatement in individualEndOfStatements)
+            {
+                var endOfLine = individualEndOfStatement.endOfLine();
+                if (endOfLine != null)
+                {
+                    return endOfLine;
+                }
+            }
+            //The only remaining alternative is whitespace followed by an EOF.
+            return null;
+        }
+
         /// <summary>
         /// Determines if the context's module declares or defaults to 
         /// Option Compare Binary