[TASK] Mark parsing-internal classes and methods as @internal

Code that uses this library is not expected to call internal parsing
functionality. Communicate this with the corresponding `@internal`
annotation.

This allows us to boldly refactor the parser code.

Part of #668

Author: oliverklee

CHANGELOG.md

@@ -15,6 +15,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Changed
 
+- Mark parsing-internal classes and methods as `@internal` (#674)
 - Block installations on unsupported higher PHP versions (#691)
 - Improve performance of `Value::parseValue` with many delimiters by refactoring
   to remove `array_search()` (#413)

src/Parsing/Anchor.php

@@ -4,6 +4,9 @@
 
 namespace Sabberworm\CSS\Parsing;
 
+/**
+ * @internal
+ */
 class Anchor
 {
     /**

src/Parsing/OutputException.php

@@ -6,6 +6,8 @@
 
 /**
  * Thrown if the CSS parser attempts to print something invalid.
+ *
+ * @internal
  */
 class OutputException extends SourceException
 {

src/Parsing/ParserState.php

@@ -7,6 +7,9 @@
 use Sabberworm\CSS\Comment\Comment;
 use Sabberworm\CSS\Settings;
 
+/**
+ * @internal
+ */
 class ParserState
 {
     /**

src/Parsing/SourceException.php

@@ -4,6 +4,9 @@
 
 namespace Sabberworm\CSS\Parsing;
 
+/**
+ * @internal
+ */
 class SourceException extends \Exception
 {
     /**

src/Parsing/UnexpectedEOFException.php

@@ -8,5 +8,7 @@
  * Thrown if the CSS parser encounters end of file it did not expect.
  *
  * Extends `UnexpectedTokenException` in order to preserve backwards compatibility.
+ *
+ * @internal
  */
 class UnexpectedEOFException extends UnexpectedTokenException {}

src/Parsing/UnexpectedTokenException.php

@@ -6,6 +6,8 @@
 
 /**
  * Thrown if the CSS parser encounters a token it did not expect.
+ *
+ * @internal
  */
 class UnexpectedTokenException extends SourceException
 {