[FEATURE] Add comsumeWhitespaceWithComments and redirect comsumeWhitespace (MyIntervals#670)

Having comsumeWhitespace also consume comments and returning them was unexpected.

Signed-off-by: Daniel Ziegenberg <[email protected]>

Author: ziegenberg

CHANGELOG.md

@@ -7,8 +7,12 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Added
 
+- Add `ParserState::comsumeWhitespaceWithComments()` method (#670)
+
 ### Changed
 
+- Redirect `ParserState::comsumeWhitespace()` to `ParserState::comsumeWhitespaceWithComments()` (#670)
+
 ### Deprecated
 
 ### Removed

src/Parsing/ParserState.php

@@ -226,12 +226,27 @@ public function parseCharacter($bIsForIdentifier)
     }
 
     /**
-     * @return array<int, Comment>|void
+     * Consumes whitespace and comments and returns a list of comments.
+     *
+     * @return list<Comment> List of comments.
+     *
+     * @throws UnexpectedEOFException
+     * @throws UnexpectedTokenException
+     */
+    public function comsumeWhitespace()
+    {
+        return $this->comsumeWhitespaceWithComments();
+    }
+
+    /**
+     * Consumes whitespace and comments and returns a list of comments.
+     *
+     * @return list<Comment> List of comments.
      *
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
      */
-    public function consumeWhiteSpace()
+    public function comsumeWhitespaceWithComments()
     {
         $aComments = [];
         do {