[TASK] Mark many parsing-related methods as @internal

The only parsing method that is expected to be called from outside
of this library is `Parser::parse()`.

Author: oliverklee

CHANGELOG.md

@@ -21,6 +21,7 @@ Please also have a look at our
 
 ### Changed
 
+- Mark parsing-related methods of most CSS elements as `@internal` (#907)
 - Mark `OutputFormat::nextLevel()` as `@internal` (#901)
 - Only allow `string` for some `OutputFormat` properties (#885)
 - Make all non-private properties `@internal` (#886)

src/CSSList/CSSList.php

@@ -67,6 +67,8 @@ public function __construct($lineNumber = 0)
     /**
      * @throws UnexpectedTokenException
      * @throws SourceException
+     *
+     * @internal since V8.8.0
      */
     public static function parseList(ParserState $parserState, CSSList $list): void
     {

src/CSSList/Document.php

@@ -28,6 +28,8 @@ public function __construct($lineNumber = 0)
 
     /**
      * @throws SourceException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState): Document
     {

src/Parsing/ParserState.php

@@ -136,6 +136,8 @@ public function setPosition($iPosition): void
      * @return string
      *
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public function parseIdentifier($bIgnoreCase = true)
     {
@@ -167,6 +169,8 @@ public function parseIdentifier($bIgnoreCase = true)
      *
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public function parseCharacter($bIsForIdentifier)
     {

src/Rule/Rule.php

@@ -79,6 +79,8 @@ public function __construct($sRule, $lineNumber = 0, $iColNo = 0)
     /**
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState): Rule
     {

src/RuleSet/DeclarationBlock.php

@@ -45,6 +45,8 @@ public function __construct($lineNumber = 0)
      *
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState, $list = null)
     {

src/RuleSet/RuleSet.php

@@ -56,6 +56,8 @@ public function __construct($lineNumber = 0)
     /**
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
+     *
+     * @internal since V8.8.0
      */
     public static function parseRuleSet(ParserState $parserState, RuleSet $ruleSet): void
     {

src/Value/CSSFunction.php

@@ -44,6 +44,8 @@ public function __construct($sName, $aArguments, $sSeparator = ',', $lineNumber
      * @throws SourceException
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState, bool $bIgnoreCase = false): CSSFunction
     {

src/Value/CSSString.php

@@ -36,6 +36,8 @@ public function __construct($sString, $lineNumber = 0)
      * @throws SourceException
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState): CSSString
     {

src/Value/CalcFunction.php

@@ -23,6 +23,8 @@ class CalcFunction extends CSSFunction
     /**
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState, bool $bIgnoreCase = false): CSSFunction
     {

src/Value/Color.php

@@ -27,6 +27,8 @@ public function __construct(array $colorValues, $lineNumber = 0)
     /**
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState, bool $ignoreCase = false): CSSFunction
     {

src/Value/LineName.php

@@ -23,6 +23,8 @@ public function __construct(array $aComponents = [], $lineNumber = 0)
     /**
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState): LineName
     {

src/Value/Size.php

@@ -86,6 +86,8 @@ public function __construct($fSize, $sUnit = null, $bIsColorComponent = false, $
      *
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState, $bIsColorComponent = false): Size
     {

src/Value/URL.php

@@ -33,6 +33,8 @@ public function __construct(CSSString $oURL, $lineNumber = 0)
      * @throws SourceException
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $parserState): URL
     {

src/Value/Value.php

@@ -38,6 +38,8 @@ public function __construct($lineNumber = 0)
      *
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
+     *
+     * @internal since V8.8.0
      */
     public static function parseValue(ParserState $parserState, array $aListDelimiters = [])
     {
@@ -114,6 +116,8 @@ public static function parseValue(ParserState $parserState, array $aListDelimite
      *
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parseIdentifierOrFunction(ParserState $parserState, $bIgnoreCase = false)
     {
@@ -144,6 +148,8 @@ public static function parseIdentifierOrFunction(ParserState $parserState, $bIgn
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
      * @throws SourceException
+     *
+     * @internal since V8.8.0
      */
     public static function parsePrimitiveValue(ParserState $parserState)
     {