[TASK] Mark many parsing-related methods as @internal (#913)

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

This is the V8.x backport of #908.

Author: oliverklee

CHANGELOG.md

@@ -11,6 +11,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Changed
 
+- Mark parsing-related methods of most CSS elements as `@internal` (#90)
 - Mark `OutputFormat::nextLevel()` as `@internal` (#901)
 - Make all non-private properties `@internal` (#886)
 

src/CSSList/CSSList.php

@@ -67,6 +67,8 @@ public function __construct($iLineNo = 0)
      *
      * @throws UnexpectedTokenException
      * @throws SourceException
+     *
+     * @internal since V8.8.0
      */
     public static function parseList(ParserState $oParserState, CSSList $oList)
     {

src/CSSList/Document.php

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

src/Parsing/ParserState.php

@@ -141,6 +141,8 @@ public function setPosition($iPosition)
      * @return string
      *
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public function parseIdentifier($bIgnoreCase = true)
     {
@@ -172,6 +174,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, $iLineNo = 0, $iColNo = 0)
      *
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $oParserState)
     {

src/RuleSet/DeclarationBlock.php

@@ -49,6 +49,8 @@ public function __construct($iLineNo = 0)
      *
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $oParserState, $oList = null)
     {

src/RuleSet/RuleSet.php

@@ -56,6 +56,8 @@ public function __construct($iLineNo = 0)
      *
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
+     *
+     * @internal since V8.8.0
      */
     public static function parseRuleSet(ParserState $oParserState, RuleSet $oRuleSet)
     {

src/Value/CSSFunction.php

@@ -47,6 +47,8 @@ public function __construct($sName, $aArguments, $sSeparator = ',', $iLineNo = 0
      * @throws SourceException
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $oParserState, $bIgnoreCase = false)
     {

src/Value/CSSString.php

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

src/Value/CalcFunction.php

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

src/Value/Color.php

@@ -30,6 +30,8 @@ public function __construct(array $aColor, $iLineNo = 0)
      *
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parse(ParserState $oParserState, $bIgnoreCase = false)
     {

src/Value/LineName.php

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

src/Value/Size.php

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

src/Value/URL.php

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

src/Value/Value.php

@@ -36,6 +36,8 @@ public function __construct($iLineNo = 0)
      *
      * @throws UnexpectedTokenException
      * @throws UnexpectedEOFException
+     *
+     * @internal since V8.8.0
      */
     public static function parseValue(ParserState $oParserState, array $aListDelimiters = [])
     {
@@ -112,6 +114,8 @@ public static function parseValue(ParserState $oParserState, array $aListDelimit
      *
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
+     *
+     * @internal since V8.8.0
      */
     public static function parseIdentifierOrFunction(ParserState $oParserState, $bIgnoreCase = false)
     {
@@ -142,6 +146,8 @@ public static function parseIdentifierOrFunction(ParserState $oParserState, $bIg
      * @throws UnexpectedEOFException
      * @throws UnexpectedTokenException
      * @throws SourceException
+     *
+     * @internal since V8.8.0
      */
     public static function parsePrimitiveValue(ParserState $oParserState)
     {